@cats-inc/cats-platform 0.1.1 → 0.1.5

package/build/desktop/releaseDescriptor.js

@@ -0,0 +1,246 @@
+import { readFile } from 'node:fs/promises';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+/**
+ * Provenance emitted by the tag-gated release workflow
+ * (`scripts/generate-desktop-release-descriptor.mjs`). SPEC-111 requires
+ * official update capability to depend on this file rather than on
+ * `app.isPackaged`, which is also true for locally packaged and unofficial
+ * builds.
+ *
+ * Nothing in this module reads the environment. Requirement 1.9 states that no
+ * environment variable may promote a development or unofficial package into an
+ * official update client, and the cheapest way to guarantee that is to give the
+ * resolver no access to one.
+ */
+export const DESKTOP_RELEASE_DESCRIPTOR_SCHEMA_VERSION = 1;
+export const DESKTOP_RELEASE_DESCRIPTOR_FILENAME = 'release-descriptor.json';
+export const DESKTOP_RELEASE_PLATFORMS = ['windows', 'macos', 'linux'];
+/**
+ * What kind of build the workflow produced.
+ *
+ * `official` is a signed stable release. `preview` is an unsigned prerelease
+ * from the same guarded workflow: it may self-update so the upgrade path is
+ * testable before signing exists, but it resolves to its own distribution mode
+ * and is never presented as official.
+ */
+export const DESKTOP_RELEASE_KINDS = ['official', 'preview'];
+const SEMVER_CORE = /^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)$/u;
+const COMMIT_SHA = /^[0-9a-f]{40}$/iu;
+const GITHUB_REPOSITORY = /^[A-Za-z0-9._-]+\/[A-Za-z0-9._-]+$/u;
+function isObjectRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+function readString(record, key) {
+    const value = record[key];
+    return typeof value === 'string' && value.trim() !== '' ? value.trim() : null;
+}
+export function resolveDesktopReleasePlatform(nodePlatform) {
+    if (nodePlatform === 'win32') {
+        return 'windows';
+    }
+    if (nodePlatform === 'darwin') {
+        return 'macos';
+    }
+    if (nodePlatform === 'linux') {
+        return 'linux';
+    }
+    return null;
+}
+export function resolveDesktopReleaseDescriptorPath(moduleDir = dirname(fileURLToPath(import.meta.url))) {
+    // The descriptor is generated into build/desktop next to the compiled host,
+    // so the same relative lookup works for a dev run and inside the asar.
+    return join(moduleDir, DESKTOP_RELEASE_DESCRIPTOR_FILENAME);
+}
+export function parseDesktopReleaseDescriptor(raw) {
+    if (!isObjectRecord(raw)) {
+        return { ok: false, reason: 'descriptor_malformed', detail: 'Descriptor is not an object.' };
+    }
+    if (raw.schemaVersion !== DESKTOP_RELEASE_DESCRIPTOR_SCHEMA_VERSION) {
+        return {
+            ok: false,
+            reason: 'descriptor_schema_unsupported',
+            detail: `Unsupported descriptor schemaVersion: ${String(raw.schemaVersion)}`,
+        };
+    }
+    // Required. A descriptor without a kind is not something this workflow
+    // produced, so it fails closed rather than defaulting to official.
+    const kind = readString(raw, 'kind');
+    if (kind === null || !DESKTOP_RELEASE_KINDS.includes(kind)) {
+        return {
+            ok: false,
+            reason: 'descriptor_malformed',
+            detail: `Descriptor kind is not official or preview: ${String(raw.kind)}`,
+        };
+    }
+    const version = readString(raw, 'version');
+    if (version === null || !SEMVER_CORE.test(version)) {
+        return {
+            ok: false,
+            reason: 'descriptor_malformed',
+            detail: 'Descriptor version is not a MAJOR.MINOR.PATCH string.',
+        };
+    }
+    const tag = readString(raw, 'tag');
+    if (tag === null || tag !== `v${version}`) {
+        return {
+            ok: false,
+            reason: 'descriptor_malformed',
+            detail: 'Descriptor tag does not match its version.',
+        };
+    }
+    const commit = readString(raw, 'commit');
+    if (commit === null || !COMMIT_SHA.test(commit)) {
+        return {
+            ok: false,
+            reason: 'descriptor_malformed',
+            detail: 'Descriptor commit is not a full 40-character sha.',
+        };
+    }
+    const platform = readString(raw, 'platform');
+    if (platform === null
+        || !DESKTOP_RELEASE_PLATFORMS.includes(platform)) {
+        return {
+            ok: false,
+            reason: 'descriptor_malformed',
+            detail: 'Descriptor platform is not windows, macos, or linux.',
+        };
+    }
+    // Phase 1 publishes stable only, and Requirement 1.7 pins the production
+    // channel to the descriptor. Any other channel means the file was not
+    // produced by the current release workflow.
+    if (raw.channel !== 'stable') {
+        return {
+            ok: false,
+            reason: 'descriptor_malformed',
+            detail: `Descriptor channel is not stable: ${String(raw.channel)}`,
+        };
+    }
+    if (raw.provider !== 'github_release') {
+        return {
+            ok: false,
+            reason: 'descriptor_malformed',
+            detail: `Descriptor provider is not github_release: ${String(raw.provider)}`,
+        };
+    }
+    const repository = readString(raw, 'repository');
+    if (repository === null || !GITHUB_REPOSITORY.test(repository)) {
+        return {
+            ok: false,
+            reason: 'descriptor_malformed',
+            detail: 'Descriptor repository is not in owner/name form.',
+        };
+    }
+    const runtimeCommit = readString(raw, 'runtimeCommit');
+    if (runtimeCommit === null || !COMMIT_SHA.test(runtimeCommit)) {
+        return {
+            ok: false,
+            reason: 'descriptor_malformed',
+            detail: 'Descriptor runtimeCommit is not a full 40-character sha.',
+        };
+    }
+    return {
+        ok: true,
+        descriptor: {
+            schemaVersion: DESKTOP_RELEASE_DESCRIPTOR_SCHEMA_VERSION,
+            kind: kind,
+            tag,
+            version,
+            commit: commit.toLowerCase(),
+            platform: platform,
+            channel: 'stable',
+            provider: 'github_release',
+            repository,
+            runtimeCommit: runtimeCommit.toLowerCase(),
+            generatedAt: readString(raw, 'generatedAt'),
+        },
+    };
+}
+function unofficial(currentVersion, reason) {
+    return {
+        distribution: 'unofficial_packaged',
+        provider: 'none',
+        channel: 'stable',
+        currentVersion,
+        repository: null,
+        commit: null,
+        unavailableReason: reason,
+    };
+}
+export function resolveDesktopDistributionIdentity(input) {
+    const { isPackaged, currentVersion, nodePlatform, descriptor } = input;
+    if (!isPackaged) {
+        return {
+            distribution: 'development',
+            provider: 'none',
+            channel: 'stable',
+            currentVersion,
+            repository: null,
+            commit: null,
+            unavailableReason: 'development_build',
+        };
+    }
+    if (descriptor === null) {
+        return unofficial(currentVersion, 'descriptor_missing');
+    }
+    if (!descriptor.ok) {
+        return unofficial(currentVersion, descriptor.reason);
+    }
+    if (descriptor.descriptor.version !== currentVersion) {
+        return unofficial(currentVersion, 'descriptor_version_mismatch');
+    }
+    if (descriptor.descriptor.platform !== resolveDesktopReleasePlatform(nodePlatform)) {
+        return unofficial(currentVersion, 'descriptor_platform_mismatch');
+    }
+    return {
+        distribution: descriptor.descriptor.kind === 'preview'
+            ? 'preview_packaged'
+            : 'official_packaged',
+        provider: 'github_release',
+        channel: descriptor.descriptor.channel,
+        currentVersion,
+        repository: descriptor.descriptor.repository,
+        commit: descriptor.descriptor.commit,
+        unavailableReason: null,
+    };
+}
+/**
+ * Returns null when the descriptor is absent, which is the expected state for a
+ * development run and for a locally packaged build. A present but unreadable or
+ * invalid file is reported as a parse failure so the reason reaches diagnostics
+ * instead of silently degrading to "missing".
+ */
+export async function loadDesktopReleaseDescriptor(descriptorPath = resolveDesktopReleaseDescriptorPath(), dependencies = {}) {
+    const readFileImpl = dependencies.readFileImpl
+        ?? ((path) => readFile(path, 'utf8'));
+    let contents;
+    try {
+        contents = await readFileImpl(descriptorPath);
+    }
+    catch (error) {
+        if (isMissingFileError(error)) {
+            return null;
+        }
+        return {
+            ok: false,
+            reason: 'descriptor_unreadable',
+            detail: error instanceof Error ? error.message : String(error),
+        };
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(contents);
+    }
+    catch (error) {
+        return {
+            ok: false,
+            reason: 'descriptor_malformed',
+            detail: error instanceof Error ? error.message : String(error),
+        };
+    }
+    return parseDesktopReleaseDescriptor(parsed);
+}
+function isMissingFileError(error) {
+    return isObjectRecord(error) && error.code === 'ENOENT';
+}
+//# sourceMappingURL=releaseDescriptor.js.map

package/build/desktop/releaseDescriptor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"releaseDescriptor.js","sourceRoot":"","sources":["../../desktop/host/releaseDescriptor.ts"],"names":[],"mappings":"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"}

package/build/desktop/tray.d.ts

@@ -14,6 +14,7 @@ interface CreateDesktopTrayControllerOptions {
     onRunAction: (actionId: DesktopHostActionId) => Promise<void>;
     onQuit: () => void;
     canInteract?: () => boolean;
+    onCheckForUpdates?: () => Promise<void>;
 }
 export declare function runDesktopTrayShowWindow(onShowWindow: () => Promise<void>): void;
 export declare function createDesktopTrayController(options: CreateDesktopTrayControllerOptions): Promise<DesktopTrayController>;

package/build/desktop/tray.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tray.d.ts","sourceRoot":"","sources":["../../desktop/host/tray.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAyB,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGjF,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,qBAAqB;IACpC,UAAU,IAAI,IAAI,CAAC;IACnB,gBAAgB,IAAI,IAAI,CAAC;IACzB,UAAU,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC9C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,UAAU,kCAAkC;IAC1C,SAAS,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;IACtC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B;AAuFD,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAEhF;AA+FD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,qBAAqB,CAAC,CA0EhC"}
+{"version":3,"file":"tray.d.ts","sourceRoot":"","sources":["../../desktop/host/tray.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EAGd,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAyB,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGjF,OAAO,EAGL,KAAK,oBAAoB,EAC1B,MAAM,eAAe,CAAC;AAEvB,MAAM,WAAW,qBAAqB;IACpC,UAAU,IAAI,IAAI,CAAC;IACnB,gBAAgB,IAAI,IAAI,CAAC;IACzB,UAAU,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAC9C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,UAAU,kCAAkC;IAC1C,SAAS,EAAE,MAAM,aAAa,GAAG,IAAI,CAAC;IACtC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,EAAE,CAAC,QAAQ,EAAE,mBAAmB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;IAG5B,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC;AAuFD,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAEhF;AA0HD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,kCAAkC,GAC1C,OAAO,CAAC,qBAAqB,CAAC,CA0EhC"}

package/build/desktop/tray.js

@@ -122,6 +122,32 @@ function buildDesktopTrayMenuTemplate(state, options, showWindow) {
             });
         }
     }
+    // SPEC-111 section 5: the update entry sits before Settings and Quit, and is
+    // absent entirely when the build has no update capability.
+    if (state.updateItem) {
+        pushSeparator();
+        template.push({
+            label: state.updateItem.label,
+            enabled: state.updateItem.enabled,
+            click: () => {
+                const item = state.updateItem;
+                if (!item?.enabled) {
+                    return;
+                }
+                runTrayAction(async () => {
+                    if (options.canInteract?.() === false) {
+                        return;
+                    }
+                    if (item.intent === 'check') {
+                        await options.onCheckForUpdates?.();
+                        return;
+                    }
+                    await options.onNavigate('/settings/desktop');
+                    showWindow();
+                });
+            },
+        });
+    }
     if (state.setupCompleteAt) {
         pushSeparator();
         template.push({

package/build/desktop/tray.js.map

@@ -1 +1 @@
-{"version":3,"file":"tray.js","sourceRoot":"","sources":["../../desktop/host/tray.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAQxD,OAAO,EAAE,mCAAmC,EAAE,MAAM,4BAA4B,CAAC;AACjF,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EACL,0BAA0B,GAG3B,MAAM,eAAe,CAAC;AAkBvB,SAAS,sBAAsB,CAAC,IAAY;IAC1C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,WAAW,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;YACvB,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+CAA+C;IACjD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,wBAAwB;IAC/B,IAAI,CAAC;QACH,OAAO,0BAA0B,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CACvB,KAAwC,EACxC,OAAe,EACf,MAAyB;IAEzB,IAAI,KAAK,KAAK,mBAAmB,EAAE,CAAC;QAClC,OAAO,MAAM,KAAK,OAAO;YACvB,CAAC,CAAC,iBAAiB;YACnB,CAAC,CAAC,2BAA2B,CAAC;IAClC,CAAC;IACD,IAAI,KAAK,KAAK,wBAAwB,EAAE,CAAC;QACvC,OAAO,MAAM,KAAK,OAAO;YACvB,CAAC,CAAC,mBAAmB;YACrB,CAAC,CAAC,4BAA4B,CAAC;IACnC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,sBAAsB,CAC7B,KAA0B,EAC1B,MAAyB;IAEzB,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;QACvB,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC;IACpD,CAAC;IACD,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5C,CAAC;AAED,KAAK,UAAU,cAAc;IAC3B,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,QAAQ,GAAG,sBAAsB,CAAC,uBAAuB,CAAC,CAAC;QACjE,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;YAChC,OAAO,QAAQ,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,sBAAsB,CAAC,eAAe,CAAC,CAAC;IACxD,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QACnD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,+DAA+D;IACjE,CAAC;IACD,OAAO,WAAW,CAAC,WAAW,EAAE,CAAC;AACnC,CAAC;AAED,SAAS,aAAa,CAAC,MAA2B;IAChD,KAAK,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;QAC5B,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,+BAA+B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAC1F,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,YAAiC;IACxE,aAAa,CAAC,YAAY,CAAC,CAAC;AAC9B,CAAC;AAED,SAAS,4BAA4B,CACnC,KAA2B,EAC3B,OAGC,EACD,UAAsB;IAEtB,MAAM,MAAM,GAAG,wBAAwB,EAAE,CAAC;IAC1C,IAAI,KAAK,CAAC,WAAW,EAAE,CAAC;QACtB,OAAO,CAAC;gBACN,KAAK,EAAE,KAAK,CAAC,WAAW;gBACxB,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAClD,MAAM,aAAa,GAAG,GAAG,EAAE;QACzB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,KAAK,WAAW,EAAE,CAAC;YACjE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;QACvC,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,GAAG,EAAE;gBACV,aAAa,CAAC,KAAK,IAAI,EAAE;oBACvB,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,KAAK,EAAE,CAAC;wBACtC,OAAO;oBACT,CAAC;oBACD,MAAM,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBACrC,UAAU,EAAE,CAAC;gBACf,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,aAAa,EAAE,CAAC;QAChB,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;YACrC,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,OAAO,CAAC,KAAK;gBACpB,KAAK,EAAE,GAAG,EAAE;oBACV,aAAa,CAAC,KAAK,IAAI,EAAE;wBACvB,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,KAAK,EAAE,CAAC;4BACtC,OAAO;wBACT,CAAC;wBACD,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;wBACvC,UAAU,EAAE,CAAC;oBACf,CAAC,CAAC,CAAC;gBACL,CAAC;aACF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,eAAe,EAAE,CAAC;QAC1B,aAAa,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,sBAAsB,CAAC,UAAU,EAAE,MAAM,CAAC;YACjD,KAAK,EAAE,GAAG,EAAE;gBACV,aAAa,CAAC,KAAK,IAAI,EAAE;oBACvB,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,KAAK,EAAE,CAAC;wBACtC,OAAO;oBACT,CAAC;oBACD,MAAM,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;oBACtC,UAAU,EAAE,CAAC;gBACf,CAAC,CAAC,CAAC;YACL,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC;YACZ,KAAK,EAAE,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC;YAC3D,OAAO,EAAE,KAAK;SACf,CAAC,CAAC;IACL,CAAC;IAED,aAAa,EAAE,CAAC;IAChB,QAAQ,CAAC,IAAI,CAAC;QACZ,KAAK,EAAE,sBAAsB,CAAC,MAAM,EAAE,MAAM,CAAC;QAC7C,KAAK,EAAE,GAAG,EAAE;YACV,IAAI,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,KAAK,EAAE,CAAC;gBACtC,OAAO;YACT,CAAC;YACD,OAAO,CAAC,MAAM,EAAE,CAAC;QACnB,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAA2C;IAE3C,MAAM,IAAI,GAAG,MAAM,cAAc,EAAE,CAAC;IACpC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5B,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;IAExB,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,KAAK,KAAK,CAAC;IAC5D,MAAM,UAAU,GAAG,GAAG,EAAE;QACtB,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,wBAAwB,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IACjD,CAAC,CAAC;IAEF,MAAM,iBAAiB,GAAG,mCAAmC,EAAE,CAAC;IAChE,IAAI,WAAW,GAAwB,IAAI,CAAC;IAE5C,MAAM,aAAa,GAAG,0BAA0B,CAAuB;QACrE,KAAK,CAAC,KAAK;YACT,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,aAAa,IAAI,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC,CAAC;YACpE,WAAW,GAAG,IAAI,CAAC,iBAAiB,CAClC,4BAA4B,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CACzD,CAAC;YACF,IAAI,iBAAiB,CAAC,kBAAkB,KAAK,qBAAqB,EAAE,CAAC;gBACnE,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;QACD,OAAO;YACL,WAAW,GAAG,IAAI,CAAC;YACnB,IAAI,CAAC,OAAO,EAAE,CAAC;QACjB,CAAC;KACF,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,CAAC,KAA2B,EAAE,EAAE;QACjD,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,CAAC,CAAC;IAEF,UAAU,CAAC;QACT,KAAK,EAAE,mBAAmB;QAC1B,OAAO,EAAE,yBAAyB;QAClC,eAAe,EAAE,IAAI;QACrB,OAAO,EAAE,EAAE;QACX,QAAQ,EAAE,EAAE;KACb,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE;QACpB,UAAU,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;QAC3B,UAAU,EAAE,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,IAAI,iBAAiB,CAAC,kBAAkB,KAAK,0BAA0B,EAAE,CAAC;QACxE,IAAI,CAAC,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;YAC1B,IAAI,WAAW,EAAE,CAAC;gBAChB,IAAI,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC;YACrC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,UAAU;QACV,gBAAgB;YACd,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,MAAM,CAAC,IAAI,EAAE,CAAC;QAChB,CAAC;QACD,UAAU;QACV,OAAO;YACL,aAAa,CAAC,OAAO,EAAE,CAAC;QAC1B,CAAC;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"tray.js","sourceRoot":"","sources":["../../desktop/host/tray.ts"],"names":[],"mappings":"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"}

package/build/desktop/trayMenu.d.ts

@@ -1,4 +1,4 @@
-import type { DesktopBootstrapPhase, DesktopHostAction } from './contracts.js';
+import type { DesktopBootstrapPhase, DesktopHostAction, DesktopUpdateSnapshot } from './contracts.js';
 export interface DesktopTrayProductDescriptor {
     id?: string;
     productName?: string;
@@ -9,6 +9,17 @@ export interface DesktopTrayProductDescriptor {
         disabledReason?: string;
     } | null;
 }
+/**
+ * Tray update entry. Absent entirely when the build has no update capability,
+ * so an unofficial or development package never shows a command it cannot
+ * honour.
+ */
+export interface DesktopTrayUpdateItem {
+    label: string;
+    enabled: boolean;
+    /** What activating the item should do. */
+    intent: 'check' | 'open_settings';
+}
 export interface DesktopTrayMenuState {
     phase?: DesktopBootstrapPhase;
     summary: string;
@@ -21,6 +32,7 @@ export interface DesktopTrayMenuState {
     }>;
     lockedLabel?: string;
     lockedTooltip?: string;
+    updateItem?: DesktopTrayUpdateItem | null;
 }
 export type DesktopTrayLocale = 'en' | 'zh-TW';
 interface BuildDesktopTrayMenuStateOptions {
@@ -31,8 +43,17 @@ interface BuildDesktopTrayMenuStateOptions {
     actions: ReadonlyArray<Pick<DesktopHostAction, 'id' | 'label' | 'primary'>>;
     products: ReadonlyArray<DesktopTrayProductDescriptor> | null | undefined;
     locale?: string | null;
+    updates?: DesktopUpdateSnapshot | null;
 }
 export declare function normalizeDesktopTrayLocale(locale: string | null | undefined): DesktopTrayLocale;
+/**
+ * Derives the tray update entry from the host-owned snapshot.
+ *
+ * Labels stay truthful about what the host is doing, and every state that has
+ * an operation in flight is disabled so a second request cannot be started
+ * from the tray.
+ */
+export declare function buildDesktopTrayUpdateItem(snapshot: DesktopUpdateSnapshot | null | undefined, localeInput?: string | null): DesktopTrayUpdateItem | null;
 export declare function buildDesktopTrayMenuState(options: BuildDesktopTrayMenuStateOptions): DesktopTrayMenuState;
 export declare function buildDesktopTrayQuittingMenuState(localeInput?: string | null): DesktopTrayMenuState;
 export {};

package/build/desktop/trayMenu.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trayMenu.d.ts","sourceRoot":"","sources":["../../desktop/host/trayMenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,iBAAiB,EAElB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,4BAA4B;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,oBAAoB;IAKnC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC;IACpE,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IAKH,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC;AAE/C,UAAU,gCAAgC;IACxC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5E,QAAQ,EAAE,aAAa,CAAC,4BAA4B,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACzE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAuDD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,iBAAiB,CAQnB;AAqDD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,oBAAoB,CAyBtB;AAED,wBAAgB,iCAAiC,CAC/C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,oBAAoB,CAWtB"}
+{"version":3,"file":"trayMenu.d.ts","sourceRoot":"","sources":["../../desktop/host/trayMenu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,iBAAiB,EAEjB,qBAAqB,EACtB,MAAM,gBAAgB,CAAC;AAExB,MAAM,WAAW,4BAA4B;IAC3C,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE;QACN,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI,CAAC;CACV;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,MAAM,EAAE,OAAO,GAAG,eAAe,CAAC;CACnC;AAED,MAAM,WAAW,oBAAoB;IAKnC,KAAK,CAAC,EAAE,qBAAqB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC;IACpE,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IAKH,WAAW,CAAC,EAAE,MAAM,CAAC;IAIrB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,UAAU,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CAC3C;AAED,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC;AAE/C,UAAU,gCAAgC;IACxC,KAAK,EAAE,qBAAqB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,uBAAuB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5E,QAAQ,EAAE,aAAa,CAAC,4BAA4B,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;IACzE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,qBAAqB,GAAG,IAAI,CAAC;CACxC;AAuDD,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAChC,iBAAiB,CAQnB;AAwED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,qBAAqB,GAAG,IAAI,GAAG,SAAS,EAClD,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,qBAAqB,GAAG,IAAI,CAmB9B;AAwBD,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,gCAAgC,GACxC,oBAAoB,CA0BtB;AAED,wBAAgB,iCAAiC,CAC/C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAC1B,oBAAoB,CAWtB"}

package/build/desktop/trayMenu.js

@@ -89,6 +89,66 @@ function toTrayProductLabel(productName, locale) {
         ? `Open ${trimmed.slice('Cats '.length)}`
         : `Open ${trimmed}`;
 }
+const TRAY_UPDATE_LABELS = {
+    en: {
+        check: 'Check for Updates…',
+        checking: 'Checking for Updates…',
+        available: 'Update Available…',
+        downloading: 'Downloading Update…',
+        downloaded: 'Restart to Update…',
+        installing: 'Installing Update…',
+    },
+    'zh-TW': {
+        check: '檢查更新…',
+        checking: '正在檢查更新…',
+        available: '有可用更新…',
+        downloading: '正在下載更新…',
+        downloaded: '重新啟動以更新…',
+        installing: '正在安裝更新…',
+    },
+};
+/**
+ * Derives the tray update entry from the host-owned snapshot.
+ *
+ * Labels stay truthful about what the host is doing, and every state that has
+ * an operation in flight is disabled so a second request cannot be started
+ * from the tray.
+ */
+export function buildDesktopTrayUpdateItem(snapshot, localeInput) {
+    if (!snapshot?.capability.canCheck) {
+        return null;
+    }
+    const locale = normalizeDesktopTrayLocale(localeInput);
+    const labels = TRAY_UPDATE_LABELS[locale];
+    // A preview build self-updates, so the tray has to say what it is or a
+    // tester cannot tell it apart from a supported release.
+    const suffix = snapshot.capability.distribution === 'preview_packaged'
+        ? (locale === 'zh-TW' ? '（預覽）' : ' (preview)')
+        : '';
+    const withSuffix = (item) => ({
+        ...item,
+        label: `${item.label}${suffix}`,
+    });
+    return withSuffix(resolveTrayUpdateItem(snapshot, labels));
+}
+function resolveTrayUpdateItem(snapshot, labels) {
+    switch (snapshot.status) {
+        case 'checking':
+            return { label: labels.checking, enabled: false, intent: 'check' };
+        case 'update_available':
+            return { label: labels.available, enabled: true, intent: 'open_settings' };
+        case 'downloading': {
+            const percent = Math.round(snapshot.progress?.percent ?? 0);
+            return { label: `${labels.downloading} ${percent}%`, enabled: false, intent: 'check' };
+        }
+        case 'downloaded':
+            return { label: labels.downloaded, enabled: true, intent: 'open_settings' };
+        case 'installing':
+            return { label: labels.installing, enabled: false, intent: 'check' };
+        default:
+            return { label: labels.check, enabled: true, intent: 'check' };
+    }
+}
 export function buildDesktopTrayMenuState(options) {
     const effectiveSetupCompleteAt = options.setupCompleteAt ?? options.fallbackSetupCompleteAt ?? null;
     const locale = normalizeDesktopTrayLocale(options.locale);
@@ -112,6 +172,7 @@ export function buildDesktopTrayMenuState(options) {
             label: localizeTrayActionLabel(action, locale),
         })),
         products,
+        updateItem: buildDesktopTrayUpdateItem(options.updates, options.locale),
     };
 }
 export function buildDesktopTrayQuittingMenuState(localeInput) {

package/build/desktop/trayMenu.js.map

@@ -1 +1 @@
-{"version":3,"file":"trayMenu.js","sourceRoot":"","sources":["../../desktop/host/trayMenu.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"trayMenu.js","sourceRoot":"","sources":["../../desktop/host/trayMenu.ts"],"names":[],"mappings":"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"}

package/build/desktop/updateInstallHandoff.d.ts

@@ -0,0 +1,30 @@
+import type { DesktopUpdaterAdapter } from './updateManager.js';
+/**
+ * Managed-service drain around the installer handoff.
+ *
+ * `quitAndInstall` ends the process, so without this the Cats runtime and
+ * platform sidecars are killed mid-flight rather than drained. On Windows that
+ * is not merely untidy: the upgrade runs the previous uninstaller before
+ * installing, and a sidecar still holding files in the install directory can
+ * make that uninstall or the install that follows fail, which is how an update
+ * leaves a broken installation behind.
+ *
+ * This is a decorator rather than a manager feature so the update state machine
+ * stays a state machine, and so the ordering is testable without Electron.
+ */
+export interface DesktopInstallHandoffHooks {
+    /**
+     * Brings managed services down. Resolves once they are stopped, including the
+     * forced path when a graceful stop times out.
+     */
+    drainManagedServices: () => Promise<void>;
+    /**
+     * Brings managed services back after a handoff that failed while the process
+     * was still alive. Without it the app would still be running but with dead
+     * sidecars, which is a worse state than the one the user started in.
+     */
+    restartManagedServices: () => Promise<void>;
+    logger?: (message: string) => void;
+}
+export declare function withDesktopInstallHandoff(adapter: DesktopUpdaterAdapter, hooks: DesktopInstallHandoffHooks): DesktopUpdaterAdapter;
+//# sourceMappingURL=updateInstallHandoff.d.ts.map

package/build/desktop/updateInstallHandoff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateInstallHandoff.d.ts","sourceRoot":"","sources":["../../desktop/host/updateInstallHandoff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAEhE;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,0BAA0B;IACzC;;;OAGG;IACH,oBAAoB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1C;;;;OAIG;IACH,sBAAsB,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,wBAAgB,yBAAyB,CACvC,OAAO,EAAE,qBAAqB,EAC9B,KAAK,EAAE,0BAA0B,GAChC,qBAAqB,CA0CvB"}

package/build/desktop/updateInstallHandoff.js

@@ -0,0 +1,39 @@
+export function withDesktopInstallHandoff(adapter, hooks) {
+    const log = hooks.logger ?? (() => { });
+    async function restoreAfterFailedHandoff(stage) {
+        try {
+            await hooks.restartManagedServices();
+        }
+        catch (restartError) {
+            // Nothing further can be done from here. The manager still reports a
+            // recoverable state, and the log says why the app may be degraded.
+            log(`[desktop-update] managed services did not restart after a failed ${stage}: `
+                + `${restartError instanceof Error ? restartError.message : String(restartError)}`);
+        }
+    }
+    return {
+        checkForUpdates: adapter.checkForUpdates.bind(adapter),
+        downloadUpdate: adapter.downloadUpdate.bind(adapter),
+        async quitAndInstall() {
+            try {
+                await hooks.drainManagedServices();
+            }
+            catch (drainError) {
+                // Handing off now would point the installer at files a surviving
+                // sidecar may still hold, so the install is abandoned instead.
+                log('[desktop-update] managed services failed to drain; abandoning the installer handoff: '
+                    + `${drainError instanceof Error ? drainError.message : String(drainError)}`);
+                await restoreAfterFailedHandoff('drain');
+                throw drainError;
+            }
+            try {
+                await adapter.quitAndInstall();
+            }
+            catch (handoffError) {
+                await restoreAfterFailedHandoff('handoff');
+                throw handoffError;
+            }
+        },
+    };
+}
+//# sourceMappingURL=updateInstallHandoff.js.map

package/build/desktop/updateInstallHandoff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateInstallHandoff.js","sourceRoot":"","sources":["../../desktop/host/updateInstallHandoff.ts"],"names":[],"mappings":"AA+BA,MAAM,UAAU,yBAAyB,CACvC,OAA8B,EAC9B,KAAiC;IAEjC,MAAM,GAAG,GAAG,KAAK,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAEvC,KAAK,UAAU,yBAAyB,CAAC,KAAa;QACpD,IAAI,CAAC;YACH,MAAM,KAAK,CAAC,sBAAsB,EAAE,CAAC;QACvC,CAAC;QAAC,OAAO,YAAY,EAAE,CAAC;YACtB,qEAAqE;YACrE,mEAAmE;YACnE,GAAG,CACD,oEAAoE,KAAK,IAAI;kBACzE,GAAG,YAAY,YAAY,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CACrF,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO;QACL,eAAe,EAAE,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC;QACtD,cAAc,EAAE,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC;QAEpD,KAAK,CAAC,cAAc;YAClB,IAAI,CAAC;gBACH,MAAM,KAAK,CAAC,oBAAoB,EAAE,CAAC;YACrC,CAAC;YAAC,OAAO,UAAU,EAAE,CAAC;gBACpB,iEAAiE;gBACjE,+DAA+D;gBAC/D,GAAG,CACD,uFAAuF;sBACnF,GAAG,UAAU,YAAY,KAAK,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAC/E,CAAC;gBACF,MAAM,yBAAyB,CAAC,OAAO,CAAC,CAAC;gBACzC,MAAM,UAAU,CAAC;YACnB,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;YACjC,CAAC;YAAC,OAAO,YAAY,EAAE,CAAC;gBACtB,MAAM,yBAAyB,CAAC,SAAS,CAAC,CAAC;gBAC3C,MAAM,YAAY,CAAC;YACrB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/build/desktop/updateIpc.d.ts

@@ -0,0 +1,42 @@
+import type { DesktopUpdateSnapshot } from './contracts.js';
+import type { DesktopUpdateManager } from './updateManager.js';
+/**
+ * Bounded IPC surface for the host-owned update manager.
+ *
+ * SPEC-111 section 3: every command takes no arguments, so a renderer cannot
+ * supply a feed URL, filesystem destination, shell command, executable path, or
+ * installer flag. Every handler also verifies the sender is the current Cats
+ * main window before touching the manager.
+ */
+export declare const DESKTOP_UPDATE_IPC_CHANNELS: {
+    readonly snapshot: "cats-host:update-get-snapshot";
+    readonly check: "cats-host:update-check";
+    readonly download: "cats-host:update-download";
+    readonly install: "cats-host:update-install";
+    readonly event: "cats-host:update-event";
+};
+export interface DesktopUpdateIpcEvent {
+    sender: unknown;
+}
+export interface DesktopUpdateWebContentsLike {
+    isDestroyed?: () => boolean;
+    send: (channel: string, payload: unknown) => void;
+}
+export declare function isDesktopUpdateIpcSenderTrusted(event: DesktopUpdateIpcEvent, mainWindowWebContents: unknown): boolean;
+export interface CreateDesktopUpdateIpcHandlersInput {
+    manager: DesktopUpdateManager;
+    resolveMainWindowWebContents: () => unknown;
+    logger?: (message: string) => void;
+}
+export type DesktopUpdateIpcHandlers = Record<string, (event: DesktopUpdateIpcEvent) => Promise<DesktopUpdateSnapshot | void>>;
+export declare function createDesktopUpdateIpcHandlers(input: CreateDesktopUpdateIpcHandlersInput): DesktopUpdateIpcHandlers;
+export interface CreateDesktopUpdateSnapshotBroadcastInput {
+    manager: DesktopUpdateManager;
+    resolveMainWindowWebContents: () => DesktopUpdateWebContentsLike | null;
+}
+/**
+ * Streams manager snapshots to the main window. Returns the unsubscribe
+ * function so the caller can detach deterministically during shutdown.
+ */
+export declare function createDesktopUpdateSnapshotBroadcast(input: CreateDesktopUpdateSnapshotBroadcastInput): () => void;
+//# sourceMappingURL=updateIpc.d.ts.map

package/build/desktop/updateIpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateIpc.d.ts","sourceRoot":"","sources":["../../desktop/host/updateIpc.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAE/D;;;;;;;GAOG;AAEH,eAAO,MAAM,2BAA2B;;;;;;CAM9B,CAAC;AAEX,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,4BAA4B;IAC3C,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;IAC5B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACnD;AAED,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,qBAAqB,EAC5B,qBAAqB,EAAE,OAAO,GAC7B,OAAO,CAKT;AAED,MAAM,WAAW,mCAAmC;IAClD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4BAA4B,EAAE,MAAM,OAAO,CAAC;IAC5C,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpC;AAED,MAAM,MAAM,wBAAwB,GAAG,MAAM,CAC3C,MAAM,EACN,CAAC,KAAK,EAAE,qBAAqB,KAAK,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CACxE,CAAC;AAEF,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,mCAAmC,GACzC,wBAAwB,CAgC1B;AAED,MAAM,WAAW,yCAAyC;IACxD,OAAO,EAAE,oBAAoB,CAAC;IAC9B,4BAA4B,EAAE,MAAM,4BAA4B,GAAG,IAAI,CAAC;CACzE;AAED;;;GAGG;AACH,wBAAgB,oCAAoC,CAClD,KAAK,EAAE,yCAAyC,GAC/C,MAAM,IAAI,CAaZ"}