@chipctx/cli-updater 0.1.0

package/dist/interceptor.d.ts

@@ -0,0 +1,6 @@
+export interface CriticalSignal {
+    target: string | null;
+    reason: string | null;
+}
+export declare function interpretResponseHeaders(headers: Headers): CriticalSignal | null;
+export declare function attachResponseInterceptor(onCritical: (signal: CriticalSignal) => void): (res: Response) => Response;

package/dist/runner/npm.d.ts

@@ -0,0 +1,22 @@
+import type { DistConfigNpm } from "../types.js";
+export type SpawnFn = (cmd: [string, string[]]) => Promise<{
+    exitCode: number;
+    stdout: string;
+    stderr: string;
+}>;
+export interface NpmRunDeps {
+    spawn: SpawnFn;
+    lastInstalledFile: string;
+    writeLastInstalled(version: string): Promise<void>;
+    readLastInstalled?: () => Promise<string | null>;
+    packageName?: string;
+}
+export interface NpmRunInput {
+    target: string;
+    dist: DistConfigNpm;
+}
+export interface NpmRunner {
+    run(input: NpmRunInput): Promise<void>;
+    rollback(): Promise<void>;
+}
+export declare function createNpmRunner(deps: NpmRunDeps): NpmRunner;

package/dist/runner/tarball.d.ts

@@ -0,0 +1,15 @@
+import type { DistConfigTarball } from "../types.js";
+export interface TarballRunDeps {
+    installDir: string;
+    fetchBuffer(url: string): Promise<Buffer>;
+    extractTarball(buf: Buffer, targetDir: string): Promise<void>;
+}
+export interface TarballRunInput {
+    target: string;
+    dist: DistConfigTarball;
+}
+export interface TarballRunner {
+    run(input: TarballRunInput): Promise<void>;
+    rollback(): Promise<void>;
+}
+export declare function createTarballRunner(deps: TarballRunDeps): TarballRunner;

package/dist/types.d.ts

@@ -0,0 +1,71 @@
+export type Severity = "none" | "recommended" | "critical";
+export type DistType = "tarball" | "npm";
+export type Mode = "interactive" | "non-interactive";
+export interface DistConfigTarball {
+    url_r2: string;
+    url_gh: string | null;
+    sha256: string;
+    size_bytes: number;
+}
+export interface DistConfigNpm {
+    package: string;
+    version: string;
+    registry: string;
+}
+export type DistConfig = DistConfigTarball | DistConfigNpm;
+export interface VersionResponse {
+    app: string;
+    latest: string;
+    min_required: string;
+    severity: Severity;
+    dist_type: DistType;
+    dist: DistConfig;
+    release_notes_url: string | null;
+}
+export interface UpdateState {
+    version: 1;
+    app: string;
+    current: string;
+    last_check_at: number;
+    ttl_expires_at: number;
+    latest: string | null;
+    min_required: string | null;
+    severity: Severity;
+    dist_type: DistType | null;
+    dist: DistConfig | null;
+    last_prompted_by_target: Record<string, number>;
+}
+export interface AppAdapter {
+    app_id: "hardawa" | "chipctx";
+    channel: string;
+    currentVersion(): string;
+    os(): "linux" | "darwin" | "win32";
+    arch(): "x64" | "arm64";
+    isNonInteractive(): boolean;
+    runnerBackend: "tarball" | "npm";
+    baseUrl: string;
+    confirmUpgrade(opts: {
+        target: string;
+        current: string;
+        severity: Severity;
+        notesUrl: string | null;
+    }): Promise<boolean>;
+}
+export type Action = {
+    kind: "silent";
+} | {
+    kind: "banner";
+    target: string;
+    notesUrl: string | null;
+} | {
+    kind: "prompt_block";
+    target: string;
+    reason: string | null;
+} | {
+    kind: "stderr_warn";
+    target: string;
+    reason: string | null;
+} | {
+    kind: "auto_update";
+    target: string;
+};

package/dist/updateManager.d.ts

@@ -0,0 +1,25 @@
+import type { CacheStore } from "./cache.js";
+import type { CriticalSignal } from "./interceptor.js";
+import type { AppAdapter, Mode, VersionResponse } from "./types.js";
+export interface UpdateManagerDeps {
+    adapter: AppAdapter;
+    cache: CacheStore;
+    renderBanner(opts: {
+        target: string;
+        current: string;
+        notesUrl: string | null;
+    }): Promise<void>;
+    runUpgrade(target: string, mode: Mode): Promise<void>;
+    writeStderr(s: string): void;
+    autoUpdateEnv?: boolean;
+}
+export declare class UpdateManager {
+    private deps;
+    private handledCritical;
+    constructor(deps: UpdateManagerDeps);
+    private mode;
+    handleResponse(resp: VersionResponse): Promise<void>;
+    handleCritical(signal: CriticalSignal): Promise<void>;
+    private dispatch;
+    private emptyState;
+}

package/dist/versionClient.d.ts

@@ -0,0 +1,15 @@
+import type { VersionResponse } from "./types.js";
+export interface QueryInput {
+    current: string;
+    os: "linux" | "darwin" | "win32";
+    arch: "x64" | "arm64";
+    userAgent: string;
+    signal?: AbortSignal;
+}
+export declare class VersionClient {
+    readonly baseUrl: string;
+    readonly app: "hardawa" | "chipctx";
+    readonly channel: string;
+    constructor(baseUrl: string, app: "hardawa" | "chipctx", channel?: string);
+    query(input: QueryInput): Promise<VersionResponse>;
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@chipctx/cli-updater",
+  "version": "0.1.0",
+  "description": "Shared CLI updater for ChipCloud products (hardawa, chipctx)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": ["dist/"],
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "build": "bun build src/index.ts --outdir dist --target node && tsc --emitDeclarationOnly --outDir dist",
+    "test": "bun test",
+    "type-check": "tsc --noEmit"
+  },
+  "dependencies": {
+    "proper-lockfile": "^4.1.2",
+    "semver": "^7.5.4"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@types/semver": "^7.5.0",
+    "@types/proper-lockfile": "^4.1.4",
+    "typescript": "^5.3.0",
+    "msw": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}