@stacksjs/launchpad/dist/types.d.ts

Like Homebrew, but faster.

import type { aliases, packages } from 'ts-pkgx';
/**
 * Configuration for the package manager
 */
export declare const DISTRIBUTION_CONFIG: {
  baseUrl: 'https://dist.pkgx.dev';
  // Future: unknown
};
/**
 * Cache metadata structure
 */
export declare interface CacheMetadata {
  version: string
  packages: Record<string, {
    domain: string
    version: string
    format: string
    downloadedAt: string
    size: number
    checksum?: string
    lastAccessed: string
  }>
}
/**
 * Launchpad configuration interface
 */
export declare interface LaunchpadConfig {
  installPath?: string
  forceReinstall?: boolean
  autoAddToPath?: boolean
  shellMessages?: {
    activation?: string
    deactivation?: string
  }
  sudoPassword?: string
  devAware?: boolean
  maxRetries?: number
  timeout?: number
  symlinkVersions?: boolean
  shimPath?: string
  showShellMessages?: boolean
  shellActivationMessage?: string
  shellDeactivationMessage?: string
  useRegistry?: boolean
  installMethod?: string
  postSetup?: {
    enabled?: boolean
    commands?: PostSetupCommand[]
  }
  preSetup?: {
    enabled?: boolean
    commands?: PostSetupCommand[]
  }
  preActivation?: {
    enabled?: boolean
    commands?: PostSetupCommand[]
  }
  postActivation?: {
    enabled?: boolean
    commands?: PostSetupCommand[]
  }
  services?: {
    enabled?: boolean
    autoStart?: boolean
    dataDir?: string
    logDir?: string
    configDir?: string
    autoRestart?: boolean
    startupTimeout?: number
    shutdownTimeout?: number
    /** Infer services to auto-start from framework config (e.g., Laravel/Stacks .env) */
    infer?: boolean
    database?: {
      username?: string
      password?: string
      authMethod?: 'trust' | 'md5' | 'scram-sha-256'
    }
    frameworks?: {
      enabled?: boolean
      laravel?: {
        enabled?: boolean
        autoDetect?: boolean
      }
      stacks?: {
        enabled?: boolean
        autoDetect?: boolean
      }
    }
    php?: {
      enabled?: boolean
      strategy?: 'auto-detect'
      version?: string
      autoDetect?: {
        enabled?: boolean
        includeAllDatabases?: boolean
        includeEnterprise?: boolean
      }
      configuration?: 'laravel-mysql' | 'laravel-postgres' | 'laravel-sqlite' | 'api-only' | 'enterprise' | 'wordpress' | 'full-stack'
    }
  }
  verbose?: boolean
}
/**
 * GitHub release interface
 */
export declare interface GitHubRelease {
  tag_name: string
  assets?: Array<{
    name: string
    browser_download_url: string
  }>
}
/**
 * Service-related types
 */
export declare interface ServiceDefinition {
  name?: string
  displayName?: string
  description?: string
  packageDomain?: string
  executable: string
  args?: string[]
  env?: Record<string, string>
  dataDirectory?: string
  configFile?: string
  logFile?: string
  pidFile?: string
  port?: number
  workingDirectory?: string
  dependencies?: string[]
  postStartCommands?: string[][]
  healthCheck?: ServiceHealthCheck
  initCommand?: string[]
  supportsGracefulShutdown?: boolean
  config?: Record<string, any>
  extensions?: Record<string, any>
}
export declare interface ServiceHealthCheck {
  command: string | string[]
  interval: number
  timeout: number
  retries: number
  expectedExitCode?: number
}
export declare interface ServiceInstance {
  name: string
  status: ServiceStatus
  pid?: number
  startTime?: Date
  lastHealthCheck?: Date
  lastCheckedAt?: Date
  startedAt?: Date
  enabled?: boolean
  definition?: ServiceDefinition
  logFile?: string
  dataDir?: string
  configFile?: string
  config?: Record<string, any>
}
export declare interface ServiceManagerState {
  services: Map<string, ServiceInstance>
  operations: ServiceOperation[]
  config?: Record<string, any>
  lastScanTime?: Date
}
export declare interface ServiceOperation {
  action: 'start' | 'stop' | 'restart' | 'enable' | 'disable'
  serviceName: string
  timestamp: Date
  status: 'pending' | 'running' | 'completed' | 'failed'
  result?: any
  duration?: number
  error?: string
}
export declare interface ServiceConfig {
  name: string
  definition: ServiceDefinition
  instances: ServiceInstance[]
}
export declare interface LaunchdPlist {
  Label: string
  ProgramArguments: string[]
  RunAtLoad: boolean
  KeepAlive?: boolean | {
    SuccessfulExit?: boolean
    NetworkState?: boolean
  }
  StandardOutPath?: string
  StandardErrorPath?: string
  WorkingDirectory?: string
  EnvironmentVariables?: Record<string, string>
  UserName?: string
}
export declare interface SystemdService {
  Unit: {
    Description: string
    After?: string[]
    Wants?: string[]
  }
  Service: {
    Type: string
    ExecStart: string
    ExecStop?: string
    WorkingDirectory?: string
    Environment?: string[]
    User?: string
    Restart?: string
    RestartSec?: number
    TimeoutStartSec?: number
    TimeoutStopSec?: number
    PIDFile?: string
  }
  Install: {
    WantedBy: string[]
  }
}
/**
 * PHP configuration interface
 */
export declare interface PHPConfig {
  version?: string
  extensions?: string[] | {
    core?: string[]
    database?: string[]
    web?: string[]
    utility?: string[]
    optional?: string[]
  }
  iniSettings?: Record<string, string>
  enabled?: boolean
}
/**
 * Post-setup command interface
 */
export declare interface PostSetupCommand {
  name?: string
  command: string
  args?: string[]
  description?: string
  condition?: string
  runInBackground?: boolean
  required?: boolean
}
// Extract all package alias names from ts-pkgx
export type PackageAlias = keyof typeof aliases
// Extract all package domain names from ts-pkgx packages
export type PackageDomain = keyof typeof packages
// Union type of all valid package identifiers (aliases + domains)
export type PackageName = PackageAlias | PackageDomain
// Type for package with optional version (allowing string for flexibility)
export type PackageSpec = string
// Supported distribution formats
export type SupportedFormat = 'tar.xz' | 'tar.gz'
export type SupportedPlatform = 'darwin' | 'linux' | 'windows'
export type SupportedArchitecture = 'x86-64' | 'aarch64' | 'armv7l'
export type ServiceStatus = 'running' | 'stopped' | 'starting' | 'stopping' | 'failed' | 'unknown'