@kaitranntt/ccs 8.1.4 → 8.2.0-dev.10

package/dist/commands/bar/install-subcommand.d.ts

@@ -0,0 +1,92 @@
+/**
+ * `ccs bar install` — download the CCS Bar app from the floating
+ * `ccs-bar-latest` GitHub release tag and install to ~/Applications.
+ *
+ * Intentionally uses a FLOATING tag (not the exact CLI version) so the
+ * Swift app can be rebuilt and published independently. After extraction,
+ * the real app version is read from the bundle's Contents/Info.plist
+ * (CFBundleShortVersionString) and pinned to ~/.ccs/bar/.version.
+ *
+ * Post-install compat check: single GET {baseUrl}/api/bar/summary.
+ * 200 = server serves the bar API (compatible).
+ * 404 = server too old (actionable warning).
+ * Other / unreachable = soft-warn, never hard-fail install.
+ *
+ * Mirrors the download/version-pin pattern in src/cliproxy/binary-manager.ts.
+ */
+export interface ReleaseAssetResult {
+    downloadUrl: string;
+}
+export interface CompatResult {
+    compatible: boolean;
+    reason: 'ok' | 'no-bar-api' | 'unreachable';
+}
+export interface InstallDeps {
+    /**
+     * Resolve the asset download URL from a GitHub release tag.
+     * Production: calls GitHub API releases/tags/{tag}.
+     * Test: mock that returns a fake URL.
+     */
+    fetchReleaseAsset: (tag: string, asset: string) => Promise<ReleaseAssetResult>;
+    /**
+     * Download the zip archive and extract the .app bundle into dest/.
+     * Production: uses undici to stream + extract (with redirect + status check).
+     */
+    downloadAndExtract: (url: string, dest: string) => Promise<void>;
+    /**
+     * GET {baseUrl}/api/bar/summary — capability handshake.
+     * 200 → compatible; 404 → no-bar-api; else/unreachable → unreachable.
+     * Never hard-fails install.
+     */
+    verifyCompat: (baseUrl: string) => Promise<CompatResult>;
+    /**
+     * Read CFBundleShortVersionString from {appPath}/Contents/Info.plist.
+     * Returns null if the file is absent or unreadable.
+     */
+    readAppBundleVersion: (appPath: string) => string | null;
+    /** Returns path to ~/.ccs (respects CCS_HOME). */
+    getCcsDir: () => string;
+    /** Destination directory for the .app bundle (~/Applications by default). */
+    getAppsDir: () => string;
+    /**
+     * Clear the macOS Gatekeeper quarantine attribute from the installed app.
+     * Run via `/usr/bin/xattr -dr com.apple.quarantine <appPath>` (execFile, not shell-string).
+     * Returns true on success, false if xattr is unavailable or the call fails (non-fatal).
+     * Injectable for tests — avoids touching the real system.
+     */
+    clearQuarantine: (appPath: string) => Promise<boolean>;
+    /**
+     * Invoke handleBarLaunch after a successful install when the user consents.
+     * Injectable so tests can assert invocation without starting a real server.
+     */
+    launchBar: (args: string[]) => Promise<void>;
+    /**
+     * Ask the user whether to launch CCS Bar now (stdin-TTY-only).
+     * Returns true on yes/default, false on no or non-TTY stdin.
+     * Injectable for tests.
+     */
+    promptLaunch: () => Promise<boolean>;
+    /**
+     * Detect whether CCS Bar is already running.
+     * Production: uses /usr/bin/pgrep -x CCSBar (exit 0 = running, exit 1 = not found).
+     * Returns false on any error (treat pgrep failure as not running).
+     * Injectable for tests — avoids touching the real process table.
+     */
+    isBarRunning: () => Promise<boolean>;
+    /**
+     * Remove an existing app bundle before extraction so a malformed archive
+     * cannot silently leave the old version in place.
+     * Production: fs.rmSync(appPath, { recursive: true, force: true }).
+     * Injectable for tests — avoids real filesystem side-effects.
+     * Throws on failure; caller catches and aborts install.
+     */
+    removeExistingApp: (appPath: string) => void;
+}
+/**
+ * Validate that a download URL is https and its hostname is in the allowlist
+ * (exact match or *.githubusercontent.com wildcard).
+ * Throws a descriptive Error if validation fails.
+ */
+export declare function validateDownloadUrl(url: string): void;
+export declare function handleBarInstall(args: string[], deps?: Partial<InstallDeps>): Promise<void>;
+//# sourceMappingURL=install-subcommand.d.ts.map

package/dist/commands/bar/install-subcommand.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-subcommand.d.ts","sourceRoot":"","sources":["../../../src/commands/bar/install-subcommand.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAoCH,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,IAAI,GAAG,YAAY,GAAG,aAAa,CAAC;CAC7C;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,iBAAiB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC/E;;;OAGG;IACH,kBAAkB,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE;;;;OAIG;IACH,YAAY,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACzD;;;OAGG;IACH,oBAAoB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IACzD,kDAAkD;IAClD,SAAS,EAAE,MAAM,MAAM,CAAC;IACxB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,MAAM,CAAC;IACzB;;;;;OAKG;IACH,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD;;;OAGG;IACH,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C;;;;OAIG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC;;;;;OAKG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC;;;;;;OAMG;IACH,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9C;AAMD;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAuBrD;AA0TD,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,OAAO,CAAC,WAAW,CAAM,GAC9B,OAAO,CAAC,IAAI,CAAC,CAoOf"}