@sigx/lynx-updates 0.6.1

package/dist/events.js

@@ -0,0 +1,61 @@
+/**
+ * Native → JS event channel for the Updates module (same GlobalEventEmitter
+ * pattern as `@sigx/lynx-background`'s `__sigxBackgroundFire`).
+ *
+ * Wire shape:
+ *   { kind: 'progress', receivedBytes: number, totalBytes: number | null }
+ *   { kind: 'foreground' }
+ */
+const EVENT_CHANNEL = '__sigxUpdatesEvent';
+function emitter() {
+    if (typeof lynx === 'undefined')
+        return undefined;
+    return lynx.getJSModule?.('GlobalEventEmitter');
+}
+function safeParse(s) {
+    try {
+        return JSON.parse(s);
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalize(raw) {
+    const event = (typeof raw === 'string' ? safeParse(raw) : raw);
+    if (!event || typeof event !== 'object')
+        return undefined;
+    if (event.kind === 'foreground')
+        return { kind: 'foreground' };
+    if (event.kind === 'progress' && typeof event.receivedBytes === 'number') {
+        return {
+            kind: 'progress',
+            receivedBytes: event.receivedBytes,
+            totalBytes: typeof event.totalBytes === 'number' && event.totalBytes >= 0
+                ? event.totalBytes
+                : null,
+        };
+    }
+    return undefined;
+}
+export function addNativeUpdatesListener(cb) {
+    const e = emitter();
+    if (!e) {
+        // Web / test fallback — no native bridge; real delivery is on-device.
+        return () => { };
+    }
+    const wrapped = (raw) => {
+        const event = normalize(raw);
+        if (!event)
+            return;
+        try {
+            cb(event);
+        }
+        catch (err) {
+            console.warn(`[updates] listener for ${EVENT_CHANNEL} threw:`, err);
+        }
+    };
+    e.addListener(EVENT_CHANNEL, wrapped);
+    return () => e.removeListener(EVENT_CHANNEL, wrapped);
+}
+export const __EVENT_CHANNEL_FOR_TESTS = EVENT_CHANNEL;
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAiB3C,SAAS,OAAO;IACZ,IAAI,OAAO,IAAI,KAAK,WAAW;QAAE,OAAO,SAAS,CAAC;IAClD,OAAQ,IAAiB,CAAC,WAAW,EAAE,CAAC,oBAAoB,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,SAAS,CAAC,CAAS;IACxB,IAAI,CAAC;QAAC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,SAAS,CAAC;IAAC,CAAC;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,GAAY;IAC3B,MAAM,KAAK,GAAG,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAE9C,CAAC;IAChB,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC1D,IAAI,KAAK,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;IAC/D,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,KAAK,CAAC,aAAa,KAAK,QAAQ,EAAE,CAAC;QACvE,OAAO;YACH,IAAI,EAAE,UAAU;YAChB,aAAa,EAAE,KAAK,CAAC,aAAa;YAClC,UAAU,EAAE,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,IAAI,KAAK,CAAC,UAAU,IAAI,CAAC;gBACrE,CAAC,CAAC,KAAK,CAAC,UAAU;gBAClB,CAAC,CAAC,IAAI;SACb,CAAC;IACN,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACpC,EAAuC;IAEvC,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;IACpB,IAAI,CAAC,CAAC,EAAE,CAAC;QACL,sEAAsE;QACtE,OAAO,GAAG,EAAE,GAAE,CAAC,CAAC;IACpB,CAAC;IACD,MAAM,OAAO,GAAG,CAAC,GAAY,EAAE,EAAE;QAC7B,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,IAAI,CAAC;YACD,EAAE,CAAC,KAAK,CAAC,CAAC;QACd,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,0BAA0B,aAAa,SAAS,EAAE,GAAG,CAAC,CAAC;QACxE,CAAC;IACL,CAAC,CAAC;IACF,CAAC,CAAC,WAAW,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,GAAG,EAAE,CAAC,CAAC,CAAC,cAAc,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,aAAa,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { Updates } from './updates.js';
+export { useUpdates } from './use-updates.js';
+export { StaticManifestProvider, validateUpdatesManifest, type StaticManifestDocument, type StaticManifestEntry, type StaticManifestProviderOptions, } from './provider/static-manifest.js';
+export { UpdatesError, type UpdatesErrorCode, type CurrentUpdateInfo, type DownloadProgress, type DownloadSpec, type UpdateCheckContext, type UpdateCheckResult, type UpdateManifest, type UpdateMode, type UpdatePlatform, type UpdateProvider, type UpdatesConfig, type UpdatesEvent, type UpdatesState, type UpdateStatus, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACH,sBAAsB,EACtB,uBAAuB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,6BAA6B,GACrC,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACH,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,UAAU,EACf,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,YAAY,GACpB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { Updates } from './updates.js';
+export { useUpdates } from './use-updates.js';
+export { StaticManifestProvider, validateUpdatesManifest, } from './provider/static-manifest.js';
+export { UpdatesError, } from './types.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EACH,sBAAsB,EACtB,uBAAuB,GAI1B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACH,YAAY,GAef,MAAM,YAAY,CAAC"}

package/dist/native.d.ts

@@ -0,0 +1,41 @@
+/**
+ * JS side of the `Updates` native module — thin promise wrappers over the
+ * callback-based bridge, plus the build-time defines baked by
+ * `@sigx/lynx-plugin`.
+ *
+ * Every wrapper degrades gracefully when the module is absent (web preview,
+ * tests, app built without the package): reads return inert defaults,
+ * mutations reject with `native-unavailable`.
+ */
+import { type CurrentUpdateInfo, type DownloadSpec } from './types.js';
+export declare function nativeAvailable(): boolean;
+/** Default channel baked at build time ('production' when unset). */
+export declare function bakedChannel(): string;
+/**
+ * The installed binary's runtime fingerprint. Native (BuildConfig /
+ * Info.plist) is authoritative; the build define is an informational
+ * fallback for environments without the module (web preview).
+ */
+export declare function getInstalledRuntimeVersion(): string;
+export declare function getPlatform(): 'android' | 'ios';
+export declare function getCurrentUpdate(): Promise<CurrentUpdateInfo>;
+/**
+ * Stream the bundle to the native staging slot and verify its SHA-256.
+ * Resolves when the update is fully staged for apply; progress arrives on
+ * the `__sigxUpdatesEvent` channel (see `events.ts`).
+ */
+export declare function nativeDownload(spec: DownloadSpec, updateId: string, runtimeVersion: string, manifestJson: string): Promise<void>;
+/** Stage the downloaded update to load on the next cold launch. */
+export declare function nativeApplyOnNextLaunch(updateId: string): Promise<void>;
+/**
+ * Stage + reload the LynxView in place. On success the JS context is torn
+ * down, so the returned promise only ever settles on FAILURE.
+ */
+export declare function nativeApplyNow(updateId: string): Promise<void>;
+/** Commit the pending update as healthy (idempotent). */
+export declare function nativeMarkReady(): Promise<void>;
+/** Configure rollback tuning for subsequent launches. */
+export declare function nativeSetRollbackOptions(maxFailedLaunches: number): Promise<void>;
+/** Drop every downloaded update; the baked bundle loads on next launch. */
+export declare function nativeClearUpdates(): Promise<void>;
+//# sourceMappingURL=native.d.ts.map

package/dist/native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAgB,KAAK,iBAAiB,EAAE,KAAK,YAAY,EAAE,MAAM,YAAY,CAAC;AAWrF,wBAAgB,eAAe,IAAI,OAAO,CAEzC;AAED,qEAAqE;AACrE,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,IAAI,MAAM,CASnD;AAED,wBAAgB,WAAW,IAAI,SAAS,GAAG,KAAK,CAM/C;AAyCD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAyBnE;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAChC,IAAI,EAAE,YAAY,EAClB,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC,CAaf;AAED,mEAAmE;AACnE,wBAAsB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM7E;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMpE;AAED,yDAAyD;AACzD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAIrD;AAED,yDAAyD;AACzD,wBAAsB,wBAAwB,CAAC,iBAAiB,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIvF;AAED,2EAA2E;AAC3E,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC,CAIxD"}

package/dist/native.js

@@ -0,0 +1,161 @@
+/**
+ * JS side of the `Updates` native module — thin promise wrappers over the
+ * callback-based bridge, plus the build-time defines baked by
+ * `@sigx/lynx-plugin`.
+ *
+ * Every wrapper degrades gracefully when the module is absent (web preview,
+ * tests, app built without the package): reads return inert defaults,
+ * mutations reject with `native-unavailable`.
+ */
+import { callAsync, callSync, isModuleAvailable } from '@sigx/lynx-core';
+import { UpdatesError } from './types.js';
+const MODULE = 'Updates';
+export function nativeAvailable() {
+    return isModuleAvailable(MODULE);
+}
+/** Default channel baked at build time ('production' when unset). */
+export function bakedChannel() {
+    return typeof __SIGX_UPDATES_CHANNEL__ === 'string' ? __SIGX_UPDATES_CHANNEL__ : 'production';
+}
+/**
+ * The installed binary's runtime fingerprint. Native (BuildConfig /
+ * Info.plist) is authoritative; the build define is an informational
+ * fallback for environments without the module (web preview).
+ */
+export function getInstalledRuntimeVersion() {
+    if (nativeAvailable()) {
+        const v = callSync(MODULE, 'getInstalledRuntimeVersion');
+        if (typeof v === 'string' && v.length > 0)
+            return v;
+    }
+    if (typeof __SIGX_RUNTIME_VERSIONS__ === 'object' && __SIGX_RUNTIME_VERSIONS__) {
+        return __SIGX_RUNTIME_VERSIONS__.android ?? __SIGX_RUNTIME_VERSIONS__.ios ?? 'unknown';
+    }
+    return 'unknown';
+}
+export function getPlatform() {
+    if (nativeAvailable()) {
+        const p = callSync(MODULE, 'getPlatform');
+        if (p === 'android' || p === 'ios')
+            return p;
+    }
+    return 'android';
+}
+const EMBEDDED_INFO = {
+    updateId: null,
+    version: '',
+    embeddedVersion: '',
+    runtimeVersion: 'unknown',
+    isEmbedded: true,
+    isFirstLaunchAfterUpdate: false,
+    didRollBack: false,
+    rolledBackUpdateId: null,
+};
+/**
+ * Normalize native-side codes (E_* prefixed) to the public
+ * {@link UpdatesErrorCode} union so consumers never see an out-of-contract
+ * code. Unknown codes collapse to the call site's fallback.
+ */
+function normalizeCode(raw, fallback) {
+    switch (raw) {
+        case 'E_DOWNLOAD_IN_PROGRESS': return 'download-in-progress';
+        case 'E_RUNTIME_MISMATCH': return 'runtime-mismatch';
+        case 'E_NO_VIEW': return 'no-view';
+        case 'hash-mismatch': return 'hash-mismatch';
+        case 'apply-failed': return 'apply-failed';
+        default: return fallback;
+    }
+}
+function throwIfNativeError(result, code) {
+    const err = result;
+    if (err && typeof err === 'object' && typeof err.error === 'string') {
+        throw new UpdatesError(normalizeCode(err.code, code), err.error);
+    }
+}
+export async function getCurrentUpdate() {
+    if (!nativeAvailable())
+        return EMBEDDED_INFO;
+    const raw = await callAsync(MODULE, 'getCurrentUpdate');
+    // Reads surface native failures too — callAsync resolves error maps.
+    throwIfNativeError(raw, 'native-error');
+    if (!raw || typeof raw !== 'object')
+        return EMBEDDED_INFO;
+    const embeddedVersion = typeof raw.embeddedVersion === 'string' ? raw.embeddedVersion : '';
+    const isEmbedded = raw.isEmbedded !== false && typeof raw.updateId !== 'string';
+    return {
+        updateId: typeof raw.updateId === 'string' ? raw.updateId : null,
+        // The embedded bundle carries no update.json — its version IS the
+        // store-shipped app version.
+        version: typeof raw.version === 'string' && raw.version.length > 0
+            ? raw.version
+            : (isEmbedded ? embeddedVersion : ''),
+        embeddedVersion,
+        runtimeVersion: typeof raw.runtimeVersion === 'string' ? raw.runtimeVersion : getInstalledRuntimeVersion(),
+        isEmbedded,
+        isFirstLaunchAfterUpdate: raw.isFirstLaunchAfterUpdate === true,
+        didRollBack: raw.didRollBack === true,
+        rolledBackUpdateId: typeof raw.rolledBackUpdateId === 'string' && raw.rolledBackUpdateId.length > 0
+            ? raw.rolledBackUpdateId
+            : null,
+    };
+}
+/**
+ * Stream the bundle to the native staging slot and verify its SHA-256.
+ * Resolves when the update is fully staged for apply; progress arrives on
+ * the `__sigxUpdatesEvent` channel (see `events.ts`).
+ */
+export async function nativeDownload(spec, updateId, runtimeVersion, manifestJson) {
+    if (!nativeAvailable()) {
+        throw new UpdatesError('native-unavailable', 'Updates native module is not available');
+    }
+    const result = await callAsync(MODULE, 'downloadUpdate', {
+        url: spec.url,
+        sha256: spec.sha256,
+        headers: spec.headers ?? {},
+        updateId,
+        runtimeVersion,
+        manifestJson,
+    });
+    throwIfNativeError(result, 'download-failed');
+}
+/** Stage the downloaded update to load on the next cold launch. */
+export async function nativeApplyOnNextLaunch(updateId) {
+    if (!nativeAvailable()) {
+        throw new UpdatesError('native-unavailable', 'Updates native module is not available');
+    }
+    const result = await callAsync(MODULE, 'applyOnNextLaunch', updateId);
+    throwIfNativeError(result, 'apply-failed');
+}
+/**
+ * Stage + reload the LynxView in place. On success the JS context is torn
+ * down, so the returned promise only ever settles on FAILURE.
+ */
+export async function nativeApplyNow(updateId) {
+    if (!nativeAvailable()) {
+        throw new UpdatesError('native-unavailable', 'Updates native module is not available');
+    }
+    const result = await callAsync(MODULE, 'applyNow', updateId);
+    throwIfNativeError(result, 'apply-failed');
+}
+/** Commit the pending update as healthy (idempotent). */
+export async function nativeMarkReady() {
+    if (!nativeAvailable())
+        return;
+    const result = await callAsync(MODULE, 'markReady');
+    throwIfNativeError(result, 'native-error');
+}
+/** Configure rollback tuning for subsequent launches. */
+export async function nativeSetRollbackOptions(maxFailedLaunches) {
+    if (!nativeAvailable())
+        return;
+    const result = await callAsync(MODULE, 'setRollbackOptions', { maxFailedLaunches });
+    throwIfNativeError(result, 'native-error');
+}
+/** Drop every downloaded update; the baked bundle loads on next launch. */
+export async function nativeClearUpdates() {
+    if (!nativeAvailable())
+        return;
+    const result = await callAsync(MODULE, 'clearUpdates');
+    throwIfNativeError(result, 'native-error');
+}
+//# sourceMappingURL=native.js.map

package/dist/native.js.map

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

package/dist/provider/static-manifest.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Built-in static-manifest backend: a JSON document on any static host/CDN.
+ *
+ * Document shape (one URL can serve every channel/runtime-version — old
+ * binaries keep matching their entry while new binaries pick up new ones):
+ *
+ * ```json
+ * {
+ *   "schemaVersion": 1,
+ *   "updates": [{
+ *     "id": "a1b2c3d4e5f60718",
+ *     "version": "1.4.2",
+ *     "channel": "production",
+ *     "platforms": ["android"],
+ *     "runtimeVersion": "fp1-3aa01b2c44de9921",
+ *     "bundleUrl": "updates/a1b2c3d4e5f60718/main.lynx.bundle",
+ *     "sha256": "<64-hex>",
+ *     "mandatory": false,
+ *     "createdAt": "2026-06-12T10:00:00Z",
+ *     "metadata": { "releaseNotes": "Bug fixes." }
+ *   }]
+ * }
+ * ```
+ *
+ * `sigx updates:publish` emits this document; relative `bundleUrl`s resolve
+ * against the manifest URL so the output directory can be dropped onto any
+ * static host unchanged.
+ */
+import { type UpdateCheckContext, type UpdateCheckResult, type UpdateManifest, type UpdateProvider } from '../types.js';
+export interface StaticManifestEntry extends Omit<UpdateManifest, 'id' | 'mandatory'> {
+    id?: string;
+    mandatory?: boolean;
+    /** Platforms this entry serves. Default: both. */
+    platforms?: string[];
+    /** Release channel. Default 'production'. */
+    channel?: string;
+}
+export interface StaticManifestDocument {
+    schemaVersion: number;
+    updates: StaticManifestEntry[];
+}
+export interface StaticManifestProviderOptions {
+    /** Absolute URL of the manifest JSON. */
+    url: string;
+    /** Extra headers sent with the manifest request AND bundle download. */
+    headers?: Record<string, string>;
+    /** Injectable fetch for tests. Defaults to `globalThis.fetch`. */
+    fetchImpl?: typeof globalThis.fetch;
+}
+/**
+ * Validate a parsed manifest document. Returns human-readable errors
+ * (empty array = valid). Exported for `sigx updates:publish` and tests.
+ */
+export declare function validateUpdatesManifest(doc: unknown): string[];
+export declare class StaticManifestProvider implements UpdateProvider {
+    private readonly options;
+    readonly name = "static-manifest";
+    constructor(options: StaticManifestProviderOptions);
+    checkForUpdate(ctx: UpdateCheckContext): Promise<UpdateCheckResult>;
+    resolveDownload(manifest: UpdateManifest): Promise<{
+        url: string;
+        sha256: string;
+        headers: Record<string, string> | undefined;
+    }>;
+}
+//# sourceMappingURL=static-manifest.d.ts.map

package/dist/provider/static-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"static-manifest.d.ts","sourceRoot":"","sources":["../../src/provider/static-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAEH,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,cAAc,EACtB,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,cAAc,EAAE,IAAI,GAAG,WAAW,CAAC;IACjF,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,kDAAkD;IAClD,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACnC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,6BAA6B;IAC1C,yCAAyC;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kEAAkE;IAClE,SAAS,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;CACvC;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,EAAE,CAwC9D;AA0CD,qBAAa,sBAAuB,YAAW,cAAc;IAG7C,OAAO,CAAC,QAAQ,CAAC,OAAO;IAFpC,QAAQ,CAAC,IAAI,qBAAqB;IAElC,YAA6B,OAAO,EAAE,6BAA6B,EAAI;IAEjE,cAAc,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA8CxE;IAEK,eAAe,CAAC,QAAQ,EAAE,cAAc;;;;OAM7C;CACJ"}

package/dist/provider/static-manifest.js

@@ -0,0 +1,173 @@
+/**
+ * Built-in static-manifest backend: a JSON document on any static host/CDN.
+ *
+ * Document shape (one URL can serve every channel/runtime-version — old
+ * binaries keep matching their entry while new binaries pick up new ones):
+ *
+ * ```json
+ * {
+ *   "schemaVersion": 1,
+ *   "updates": [{
+ *     "id": "a1b2c3d4e5f60718",
+ *     "version": "1.4.2",
+ *     "channel": "production",
+ *     "platforms": ["android"],
+ *     "runtimeVersion": "fp1-3aa01b2c44de9921",
+ *     "bundleUrl": "updates/a1b2c3d4e5f60718/main.lynx.bundle",
+ *     "sha256": "<64-hex>",
+ *     "mandatory": false,
+ *     "createdAt": "2026-06-12T10:00:00Z",
+ *     "metadata": { "releaseNotes": "Bug fixes." }
+ *   }]
+ * }
+ * ```
+ *
+ * `sigx updates:publish` emits this document; relative `bundleUrl`s resolve
+ * against the manifest URL so the output directory can be dropped onto any
+ * static host unchanged.
+ */
+import { UpdatesError, } from '../types.js';
+/**
+ * Validate a parsed manifest document. Returns human-readable errors
+ * (empty array = valid). Exported for `sigx updates:publish` and tests.
+ */
+export function validateUpdatesManifest(doc) {
+    const errors = [];
+    if (!doc || typeof doc !== 'object')
+        return ['Manifest must be a JSON object'];
+    const d = doc;
+    if (d.schemaVersion !== 1)
+        errors.push('Unsupported or missing "schemaVersion" (expected 1)');
+    if (!Array.isArray(d.updates)) {
+        errors.push('Missing "updates" array');
+        return errors;
+    }
+    d.updates.forEach((entry, i) => {
+        if (!entry || typeof entry !== 'object') {
+            errors.push(`updates[${i}] must be an object`);
+            return;
+        }
+        const e = entry;
+        for (const field of ['version', 'runtimeVersion', 'bundleUrl', 'sha256']) {
+            if (typeof e[field] !== 'string' || e[field].length === 0) {
+                errors.push(`updates[${i}].${field} must be a non-empty string`);
+            }
+        }
+        if (typeof e.sha256 === 'string' && !/^[0-9a-f]{64}$/i.test(e.sha256)) {
+            errors.push(`updates[${i}].sha256 must be 64 hex characters`);
+        }
+        // Optional fields must still be well-typed — selection logic calls
+        // .includes()/string compares on them, and a malformed value must
+        // surface as check-failed, not a TypeError.
+        if (e.platforms !== undefined &&
+            (!Array.isArray(e.platforms) || !e.platforms.every((p) => p === 'android' || p === 'ios'))) {
+            errors.push(`updates[${i}].platforms must be an array of 'android' | 'ios'`);
+        }
+        for (const field of ['channel', 'id', 'createdAt']) {
+            if (e[field] !== undefined && typeof e[field] !== 'string') {
+                errors.push(`updates[${i}].${field} must be a string when present`);
+            }
+        }
+        if (e.mandatory !== undefined && typeof e.mandatory !== 'boolean') {
+            errors.push(`updates[${i}].mandatory must be a boolean when present`);
+        }
+    });
+    return errors;
+}
+/** Default id derivation: content-addressed prefix of the bundle hash. */
+function entryId(entry) {
+    return entry.id ?? entry.sha256.slice(0, 16);
+}
+/** Resolve a possibly-relative bundle URL against the manifest URL. */
+function resolveBundleUrl(bundleUrl, manifestUrl) {
+    if (/^https?:\/\//i.test(bundleUrl))
+        return bundleUrl;
+    // Manual resolution — the Lynx BG runtime has no global URL constructor.
+    const base = manifestUrl.replace(/[^/]*$/, '');
+    return base + bundleUrl.replace(/^\.\//, '');
+}
+function toManifest(entry, manifestUrl) {
+    return {
+        id: entryId(entry),
+        version: entry.version,
+        runtimeVersion: entry.runtimeVersion,
+        bundleUrl: resolveBundleUrl(entry.bundleUrl, manifestUrl),
+        sha256: entry.sha256.toLowerCase(),
+        mandatory: entry.mandatory === true,
+        createdAt: entry.createdAt,
+        metadata: entry.metadata,
+    };
+}
+/** Newest entry wins: by createdAt when present, else last in array order. */
+function newest(entries) {
+    if (entries.length === 0)
+        return undefined;
+    const sorted = [...entries].sort((a, b) => {
+        const ta = a.createdAt ? Date.parse(a.createdAt) : Number.NaN;
+        const tb = b.createdAt ? Date.parse(b.createdAt) : Number.NaN;
+        if (Number.isNaN(ta) && Number.isNaN(tb))
+            return 0; // stable → array order
+        if (Number.isNaN(ta))
+            return -1;
+        if (Number.isNaN(tb))
+            return 1;
+        return ta - tb;
+    });
+    return sorted[sorted.length - 1];
+}
+export class StaticManifestProvider {
+    constructor(options) {
+        this.options = options;
+        this.name = 'static-manifest';
+    }
+    async checkForUpdate(ctx) {
+        const fetchImpl = this.options.fetchImpl ?? globalThis.fetch;
+        if (typeof fetchImpl !== 'function') {
+            throw new UpdatesError('check-failed', 'No fetch implementation available — import @sigx/lynx (or @sigx/lynx-http) before checking for updates');
+        }
+        let doc;
+        try {
+            const res = await fetchImpl(this.options.url, { headers: this.options.headers });
+            if (!res.ok) {
+                throw new UpdatesError('check-failed', `Manifest request failed: HTTP ${res.status}`);
+            }
+            doc = await res.json();
+        }
+        catch (err) {
+            if (err instanceof UpdatesError)
+                throw err;
+            throw new UpdatesError('check-failed', `Manifest request failed: ${err?.message ?? err}`);
+        }
+        const errors = validateUpdatesManifest(doc);
+        if (errors.length > 0) {
+            throw new UpdatesError('check-failed', `Invalid updates manifest: ${errors.join('; ')}`);
+        }
+        const channel = ctx.channel ?? 'production';
+        const candidates = doc.updates.filter((e) => (e.platforms ?? ['android', 'ios']).includes(ctx.platform) &&
+            (e.channel ?? 'production') === channel);
+        const compatible = candidates.filter((e) => e.runtimeVersion === ctx.runtimeVersion);
+        const best = newest(compatible);
+        if (best) {
+            const manifest = toManifest(best, this.options.url);
+            return manifest.id === ctx.currentUpdateId
+                ? { type: 'up-to-date' }
+                : { type: 'update-available', manifest };
+        }
+        // No compatible entry — surface the newest INCOMPATIBLE one (if any)
+        // so the app can tell "you're current" apart from "a newer release
+        // exists but needs a store update".
+        const incompatible = newest(candidates);
+        if (incompatible) {
+            return { type: 'incompatible', manifest: toManifest(incompatible, this.options.url) };
+        }
+        return { type: 'up-to-date' };
+    }
+    async resolveDownload(manifest) {
+        return {
+            url: manifest.bundleUrl,
+            sha256: manifest.sha256,
+            headers: this.options.headers,
+        };
+    }
+}
+//# sourceMappingURL=static-manifest.js.map

package/dist/provider/static-manifest.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Global reactive store + event fan-out for the updates state machine.
+ * The controller is the only writer; UI reads via `useUpdates()` or
+ * `Updates.getState()`, imperative code subscribes via `Updates.addListener`.
+ */
+import type { UpdatesEvent, UpdatesState } from './types.js';
+/** The store — a deeply reactive proxy (object signal). @internal */
+export declare const store: import("@sigx/reactivity").Signal<UpdatesState>;
+type Listener = (event: UpdatesEvent) => void;
+export declare function addListener(fn: Listener): () => void;
+/** Emit an event to subscribers (never throws). @internal */
+export declare function emit(event: UpdatesEvent): void;
+/**
+ * Fully detached manifest copy — `metadata` is the only nested field, so
+ * cloning it makes the snapshot deep. @internal
+ */
+export declare function cloneManifest(manifest: UpdatesState['manifest']): UpdatesState['manifest'];
+/** Snapshot of the current state (plain object, detached from the proxy). */
+export declare function getStateSnapshot(): UpdatesState;
+/** Test-only: reset the store and drop all listeners. @internal */
+export declare function __resetForTests(): void;
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAqB,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAwBhF,qEAAqE;AACrE,eAAO,MAAM,KAAK,iDAAuC,CAAC;AAE1D,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AAG9C,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,GAAG,MAAM,IAAI,CAGpD;AAED,6DAA6D;AAC7D,wBAAgB,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI,CAQ9C;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,CAAC,UAAU,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAM1F;AAED,6EAA6E;AAC7E,wBAAgB,gBAAgB,IAAI,YAAY,CAS/C;AAED,mEAAmE;AACnE,wBAAgB,eAAe,IAAI,IAAI,CAGtC"}