@tilt-launcher/sdk 1.2.0

package/dist/types.d.ts

@@ -0,0 +1,159 @@
+export type ResourceKind = 'serve' | 'cmd' | 'unknown';
+export interface CachedResource {
+    name: string;
+    label: string;
+    category?: string | undefined;
+    type?: string | undefined;
+    endpoint?: string | undefined;
+    port?: number | undefined;
+    path?: string | undefined;
+    runtimeStatus?: string | undefined;
+    isDisabled?: boolean | undefined;
+    resourceKind?: ResourceKind | undefined;
+    updateStatus?: string | undefined;
+    waitingReason?: string | undefined;
+    waitingOn?: string[] | undefined;
+    lastDeployTime?: string | undefined;
+    lastBuildDuration?: number | undefined;
+    lastBuildError?: string | undefined;
+    hasPendingChanges?: boolean | undefined;
+    triggerMode?: number | undefined;
+    queued?: boolean | undefined;
+    order?: number | undefined;
+    pid?: number | undefined;
+    conditions?: Array<{
+        type: string;
+        status: string;
+        lastTransitionTime?: string;
+    }> | undefined;
+}
+export interface ServiceGroup {
+    id: string;
+    label: string;
+    resourceNames: string[];
+}
+export interface SubServiceMapping {
+    parentName: string;
+    childName: string;
+}
+export interface ServiceMapping {
+    groups: ServiceGroup[];
+    subServices: SubServiceMapping[];
+    labelOverrides: Record<string, string>;
+    resourceOrder: string[];
+    hiddenResources: string[];
+}
+export interface Environment {
+    id: string;
+    name: string;
+    /** True when this environment is an externally-managed Tilt process (port-only). */
+    external?: boolean | undefined;
+    repoDir: string;
+    tiltfile: string;
+    tiltPort: number;
+    description?: string | undefined;
+    isSymlink?: boolean | undefined;
+    selectedResources?: string[] | undefined;
+    cachedResources?: CachedResource[] | undefined;
+    serviceMapping?: ServiceMapping | undefined;
+}
+export interface PickedTiltfile {
+    path: string;
+    isSymlink: boolean;
+    /** Resolved real path (absolute) when isSymlink is true */
+    realPath?: string | undefined;
+}
+export interface Config {
+    themeMode?: 'dark' | 'light' | 'system' | undefined;
+    environments: Environment[];
+}
+export interface EnvStatus {
+    status: 'stopped' | 'starting' | 'running';
+    logs: string[];
+    resourceLogs?: Record<string, string[]> | undefined;
+    tiltPort: number;
+    uptime: number | null;
+    newResources?: number | undefined;
+    resources?: ResourceRow[] | undefined;
+}
+export type HealthStatus = 'up' | 'down' | 'unknown' | 'missing';
+export interface ResourceRow {
+    key: string;
+    name: string;
+    label: string;
+    category: string;
+    endpoint?: string | undefined;
+    port?: number | undefined;
+    path?: string | undefined;
+    runtimeStatus: string;
+    isDisabled: boolean;
+    health: HealthStatus;
+    exists: boolean;
+    error?: string | undefined;
+    resourceKind: ResourceKind;
+    updateStatus?: string | undefined;
+    waitingReason?: string | undefined;
+    waitingOn?: string[] | undefined;
+    lastDeployTime?: string | undefined;
+    lastBuildDuration?: number | undefined;
+    lastBuildError?: string | undefined;
+    hasPendingChanges?: boolean | undefined;
+    triggerMode?: number | undefined;
+    queued?: boolean | undefined;
+    order?: number | undefined;
+    pid?: number | undefined;
+    conditions?: Array<{
+        type: string;
+        status: string;
+        lastTransitionTime?: string;
+    }> | undefined;
+}
+/** Log-free status for a single environment (used in delta IPC) */
+export interface EnvStatusUpdate {
+    status: 'stopped' | 'starting' | 'running';
+    tiltPort: number;
+    uptime: number | null;
+    newResources?: number | undefined;
+    resources?: ResourceRow[] | undefined;
+}
+/** Status push — resources + env state, NO logs */
+export interface StatusUpdate {
+    envs: Record<string, EnvStatusUpdate>;
+}
+/** Incremental log append — only new lines since last push */
+export interface LogDelta {
+    /** New launcher log lines per env (envId → lines) */
+    envLogs: Record<string, string[]>;
+    /** New resource log lines ("envId:resourceName" → lines) */
+    resourceLogs: Record<string, string[]>;
+}
+/** @deprecated Use StatusUpdate for push updates. Kept for initial full-fetch. */
+export interface StatusResponse {
+    envs: Record<string, EnvStatus>;
+    health?: Record<string, HealthStatus>;
+}
+export interface DiscoverResult {
+    ok: boolean;
+    resources: CachedResource[];
+    logs: string[];
+    error?: string;
+}
+export interface LoginItemSettings {
+    openAtLogin: boolean;
+}
+export interface DirEntry {
+    name: string;
+    isDirectory: boolean;
+    isFile: boolean;
+    isSymlink: boolean;
+    /** Raw link target as returned by readlink (may be relative) */
+    symlinkTarget?: string | undefined;
+    /** Absolute resolved path when isSymlink is true */
+    realPath?: string | undefined;
+}
+export interface ReadDirResult {
+    ok: boolean;
+    path: string;
+    entries: DirEntry[];
+    error?: string | undefined;
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@tilt-launcher/sdk",
+  "version": "1.2.0",
+  "description": "SDK for managing Tilt dev environments — start, stop, monitor, and control resources",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "src",
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "bun build src/index.ts src/types.ts src/bridge.ts src/tiltManagerSDK.ts --outdir dist --target node && tsc -p tsconfig.build.json",
+    "check": "tsc --noEmit -p tsconfig.json",
+    "prepublishOnly": "bun run check && bun run build"
+  },
+  "keywords": [
+    "tilt",
+    "tiltfile",
+    "devtools",
+    "sdk",
+    "launcher"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/m4ttheweric/tilt-launcher",
+    "directory": "packages/sdk"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/bridge.ts

@@ -0,0 +1,45 @@
+import type {
+  Config,
+  DiscoverResult,
+  LoginItemSettings,
+  LogDelta,
+  PickedTiltfile,
+  ReadDirResult,
+  StatusUpdate,
+} from './types.ts';
+
+type Result = { ok: boolean; error?: string };
+
+/**
+ * Abstract bridge interface between the UI and the host shell.
+ *
+ * Each shell (Electron, Tauri, etc.) provides its own implementation.
+ * The UI layer consumes this interface exclusively — it never imports
+ * from Electron, Tauri, or any other shell-specific API directly.
+ */
+export interface LauncherBridge {
+  // ── Request / Response commands ─────────────────────────────────────
+  getConfig(): Promise<Config>;
+  getStatus(): Promise<StatusUpdate>;
+  getLogs(envId: string): Promise<{ envLogs: string[]; resourceLogs: Record<string, string[]> }>;
+  startEnv(envId: string): Promise<Result>;
+  stopEnv(envId: string): Promise<Result>;
+  restartEnv(envId: string): Promise<Result>;
+  triggerResource(envId: string, resourceName: string): Promise<Result>;
+  enableResource(envId: string, resourceName: string): Promise<Result>;
+  disableResource(envId: string, resourceName: string): Promise<Result>;
+  saveConfig(config: Config): Promise<Result>;
+  pickTiltfile(): Promise<PickedTiltfile | null>;
+  classifyTiltfilePath(filePath: string): Promise<PickedTiltfile>;
+  openExternal(url: string): Promise<void>;
+  getHomeDir(): Promise<string>;
+  readDir(dirPath: string): Promise<ReadDirResult>;
+  discoverResources(input: { tiltfilePath: string; tiltPort: number; timeoutMs?: number }): Promise<DiscoverResult>;
+  getLoginItemSettings(): Promise<LoginItemSettings>;
+  setLoginItemSettings(openAtLogin: boolean): Promise<Result>;
+
+  // ── Event subscriptions ─────────────────────────────────────────────
+  onStatusUpdate(listener: (update: StatusUpdate) => void): () => void;
+  onLogDelta(listener: (delta: LogDelta) => void): () => void;
+  onConfigUpdated(listener: (config: Config) => void): () => void;
+}

package/src/index.ts

@@ -0,0 +1,3 @@
+export * from './types.ts';
+export { type LauncherBridge } from './bridge.ts';
+export { TiltManagerSDK } from './tiltManagerSDK.ts';