@tilt-launcher/sdk 1.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Matthew Eric
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# @tilt-launcher/sdk
+
+SDK for managing [Tilt](https://tilt.dev) dev environments — start, stop, monitor, and control resources programmatically.
+
+## Install
+
+```bash
+bun add @tilt-launcher/sdk
+# or
+npm install @tilt-launcher/sdk
+```
+
+## Quick Start
+
+```ts
+import { TiltManagerSDK } from '@tilt-launcher/sdk';
+import type { Config, StatusUpdate, LogDelta } from '@tilt-launcher/sdk';
+
+const config: Config = {
+  environments: [
+    {
+      id: 'my-app',
+      name: 'My App',
+      repoDir: '/path/to/repo',
+      tiltfile: 'Tiltfile',
+      tiltPort: 10350,
+      selectedResources: [],
+      cachedResources: [],
+    },
+  ],
+};
+
+const sdk = new TiltManagerSDK(config, {
+  onStatusUpdate: (update: StatusUpdate) => {
+    console.log('Status:', update.envs);
+  },
+  onLogDelta: (delta: LogDelta) => {
+    console.log('Logs:', delta);
+  },
+});
+
+// Start polling the Tilt API
+sdk.startPolling(5000);
+
+// Start an environment
+await sdk.startEnv('my-app');
+
+// Get current status
+const status = sdk.currentStatusUpdate();
+
+// Control resources
+await sdk.triggerResource('my-app', 'web-server');
+await sdk.disableResource('my-app', 'slow-service');
+await sdk.enableResource('my-app', 'slow-service');
+
+// Stop
+await sdk.stopEnv('my-app');
+sdk.stopPolling();
+```
+
+## API
+
+### `TiltManagerSDK`
+
+| Method                         | Description                        |
+| ------------------------------ | ---------------------------------- |
+| `startEnv(envId)`              | Start a Tilt environment           |
+| `stopEnv(envId)`               | Stop a running environment         |
+| `restartEnv(envId)`            | Kill and restart an environment    |
+| `triggerResource(envId, name)` | Manually trigger a resource update |
+| `enableResource(envId, name)`  | Re-enable a disabled resource      |
+| `disableResource(envId, name)` | Disable a resource                 |
+| `getEnvLogs(envId)`            | Get env + resource log lines       |
+| `currentStatusUpdate()`        | Get latest status snapshot         |
+| `setConfig(config)`            | Update config at runtime           |
+| `discoverResources(input)`     | Discover resources from a Tiltfile |
+| `startPolling(intervalMs)`     | Start polling Tilt APIs            |
+| `stopPolling()`                | Stop polling                       |
+
+### Types
+
+- `Config` — app configuration with environment list
+- `Environment` — a single Tilt environment definition
+- `StatusUpdate` — full status snapshot (all envs + resources)
+- `ResourceRow` — individual resource status (health, pid, labels, etc.)
+- `LogDelta` — incremental log update
+- `DiscoverResult` — result of resource discovery
+- `LauncherBridge` — abstract UI bridge interface
+
+### Callbacks
+
+| Callback          | Fires when                                               |
+| ----------------- | -------------------------------------------------------- |
+| `onStatusUpdate`  | Tilt API poll returns new data                           |
+| `onLogDelta`      | New log lines arrive via WebSocket                       |
+| `onConfigMutated` | SDK internally modifies config (e.g., caching resources) |
+
+## Requirements
+
+- `tilt` must be on `$PATH`
+- Node.js ≥ 18 or Bun
+
+## License
+
+MIT

package/dist/bridge.d.ts

@@ -0,0 +1,43 @@
+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 {
+    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>;
+    onStatusUpdate(listener: (update: StatusUpdate) => void): () => void;
+    onLogDelta(listener: (delta: LogDelta) => void): () => void;
+    onConfigUpdated(listener: (config: Config) => void): () => void;
+}
+export {};

package/dist/index.d.ts

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