@bridgething/updater 0.1.4

package/dist/driver.js

@@ -0,0 +1,240 @@
+import { newUuid } from '@bridgething/lib/uuid';
+import { AckRegistry } from './ack-window';
+import { DEFAULT_FRAGMENT_BYTES, streamSourceFragments } from './fragments';
+import { serveOtaAssetRanges } from './range-serve';
+import { sha256Hex } from './source';
+const OTA_IDLE_DEADLINE_MS = 60_000;
+const OTA_IDLE_CHECK_INTERVAL_MS = 15_000;
+export class OtaDriver {
+    device;
+    registry;
+    unsubscribeAck;
+    unsubscribeRangeServer = null;
+    constructor(gateway, deviceId, ackWindowOptions = {}) {
+        this.device = gateway.device(deviceId);
+        this.registry = new AckRegistry(ackWindowOptions);
+        this.unsubscribeAck = this.device.transfer.onAck(ack => this.registry.note(ack.transferId, ack.received));
+    }
+    serveAssetRanges(zcks) {
+        this.unsubscribeRangeServer?.();
+        this.unsubscribeRangeServer = serveOtaAssetRanges(this.device, this.registry, zcks);
+    }
+    stopServingAssetRanges() {
+        this.unsubscribeRangeServer?.();
+        this.unsubscribeRangeServer = null;
+    }
+    close() {
+        this.unsubscribeAck();
+        this.stopServingAssetRanges();
+    }
+    async pushImage(opts) {
+        if (opts.zcks)
+            this.serveAssetRanges(opts.zcks);
+        const { snapshot } = await this.driveOta({
+            kind: 'image',
+            source: opts.source,
+            updateUrlBase: opts.updateUrlBase,
+            mode: 'full',
+            onProgress: opts.onProgress,
+        });
+        return snapshot;
+    }
+    async pushDaemon(source, onProgress) {
+        return this.applyBandaidBatch([{ kind: 'daemon', source }], onProgress);
+    }
+    async pushBuiltinWebapp(source, onProgress) {
+        return this.applyBandaidBatch([{ kind: 'builtinWebapp', source }], onProgress);
+    }
+    async pushBandaidBatch(artifacts, onProgress) {
+        return this.applyBandaidBatch(artifacts, onProgress);
+    }
+    async installWebapp(source) {
+        const totalSize = source.size;
+        const sha256 = await sha256Hex(source);
+        const transferId = newUuid();
+        const beginResult = await this.device.system.otaBegin({
+            kind: 'installedWebapp',
+            updateId: sha256,
+            updateUrlBase: null,
+            transfer: { id: transferId, totalSize, sha256 },
+        });
+        if (!beginResult.ok) {
+            return { ok: false, reason: describeBeginFailure(beginResult) };
+        }
+        const resumeFromOffset = beginResult.response.resumeFromOffset;
+        const outcome = new Promise(resolve => {
+            let settled = false;
+            const finish = (result) => {
+                if (settled)
+                    return;
+                settled = true;
+                unsubInstalled();
+                unsubError();
+                resolve(result);
+            };
+            const unsubInstalled = this.device.webapp.onWebappInstalled(info => finish({ ok: true, info }));
+            const unsubError = this.device.system.onOtaError(err => finish({ ok: false, reason: `[${err.code}] ${err.msg}` }));
+        });
+        const window = this.registry.register(transferId, resumeFromOffset);
+        try {
+            await streamSourceFragments({
+                device: this.device,
+                transferId,
+                source,
+                startOffset: resumeFromOffset,
+                totalSize,
+                chunkSize: DEFAULT_FRAGMENT_BYTES,
+                priority: 'background',
+                window,
+            });
+        }
+        catch (err) {
+            this.registry.deregister(transferId);
+            return { ok: false, reason: `chunk stream failed: ${errorMessage(err)}` };
+        }
+        const result = await outcome;
+        this.registry.deregister(transferId);
+        return result;
+    }
+    async applyBandaidBatch(artifacts, onProgress) {
+        const stagedIds = [];
+        for (const artifact of artifacts) {
+            const { snapshot, updateId } = await this.driveOta({
+                kind: artifact.kind,
+                source: artifact.source,
+                updateUrlBase: undefined,
+                mode: 'stage',
+                onProgress,
+            });
+            if (snapshot.phase !== 'staged')
+                return snapshot;
+            stagedIds.push(updateId);
+        }
+        return this.commitBandaid(stagedIds, onProgress);
+    }
+    async commitBandaid(expected, onProgress) {
+        const terminal = this.awaitTerminal('full', onProgress);
+        try {
+            await this.device.system.otaActivate({ expected });
+        }
+        catch (err) {
+            terminal.cancel();
+            return { phase: 'failed', reason: `OtaActivate send failed: ${errorMessage(err)}` };
+        }
+        return terminal.promise;
+    }
+    async driveOta(args) {
+        const totalSize = args.source.size;
+        const sha256 = await sha256Hex(args.source);
+        const transferId = newUuid();
+        const beginResult = await this.device.system.otaBegin({
+            kind: args.kind,
+            updateId: sha256,
+            updateUrlBase: args.updateUrlBase ?? null,
+            transfer: { id: transferId, totalSize, sha256 },
+        });
+        if (!beginResult.ok) {
+            return { snapshot: { phase: 'failed', reason: describeBeginFailure(beginResult) }, updateId: sha256 };
+        }
+        const resumeFromOffset = beginResult.response.resumeFromOffset;
+        args.onProgress?.({ phase: 'streaming', percent: percentOf(resumeFromOffset, totalSize) });
+        const window = this.registry.register(transferId, resumeFromOffset);
+        const terminal = this.awaitTerminal(args.mode, args.onProgress);
+        const abort = new AbortController();
+        const snapshot = await new Promise(resolve => {
+            let settled = false;
+            const finish = (s) => {
+                if (settled)
+                    return;
+                settled = true;
+                resolve(s);
+            };
+            void terminal.promise.then(finish);
+            void (async () => {
+                try {
+                    await streamSourceFragments({
+                        device: this.device,
+                        transferId,
+                        source: args.source,
+                        startOffset: resumeFromOffset,
+                        totalSize,
+                        chunkSize: DEFAULT_FRAGMENT_BYTES,
+                        priority: 'background',
+                        window,
+                        signal: abort.signal,
+                    });
+                }
+                catch (err) {
+                    if (!abort.signal.aborted)
+                        finish({ phase: 'failed', reason: `chunk stream failed: ${errorMessage(err)}` });
+                }
+            })();
+        });
+        abort.abort();
+        terminal.cancel();
+        this.registry.deregister(transferId);
+        if (snapshot.phase === 'failed') {
+            await this.device.transfer.abandon({ transferId, reason: 'attempt ended' }).catch(() => { });
+        }
+        return { snapshot, updateId: sha256 };
+    }
+    awaitTerminal(mode, onProgress) {
+        const success = mode === 'full' ? { phase: 'completed' } : { phase: 'staged' };
+        let settle;
+        const promise = new Promise(resolve => {
+            settle = resolve;
+        });
+        let lastProgressAt = Date.now();
+        let finished = false;
+        const finish = (s) => {
+            if (finished)
+                return;
+            finished = true;
+            cleanup();
+            settle(s);
+        };
+        const unsubProgress = this.device.system.onOtaProgress(ev => {
+            lastProgressAt = Date.now();
+            onProgress?.({ phase: 'applying', otaPhase: ev.phase, percent: ev.percent });
+            const done = mode === 'full' ? ev.phase === 'reboot' : ev.phase === 'writing' && ev.percent >= 100;
+            if (done)
+                finish(success);
+        });
+        const unsubError = this.device.system.onOtaError(ev => finish({ phase: 'failed', reason: `[${ev.code}] ${ev.msg}` }));
+        const idleTimer = setInterval(() => {
+            if (Date.now() - lastProgressAt > OTA_IDLE_DEADLINE_MS) {
+                finish({ phase: 'failed', reason: `ota stalled: no progress within ${OTA_IDLE_DEADLINE_MS / 1000}s` });
+            }
+        }, OTA_IDLE_CHECK_INTERVAL_MS);
+        function cleanup() {
+            unsubProgress();
+            unsubError();
+            clearInterval(idleTimer);
+        }
+        return {
+            promise,
+            cancel: () => {
+                if (finished)
+                    return;
+                finished = true;
+                cleanup();
+            },
+        };
+    }
+}
+function percentOf(n, d) {
+    if (d === 0)
+        return 100;
+    return Math.min(100, Math.floor((n * 100) / d));
+}
+function describeBeginFailure(result) {
+    if (result.kind === 'domain') {
+        const err = result.error;
+        return `daemon rejected OtaBegin: ${err.reason ?? 'unknown reason'}`;
+    }
+    return `OtaBegin protocol error: ${JSON.stringify(result.error)}`;
+}
+function errorMessage(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=driver.js.map

package/dist/driver.js.map

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

package/dist/fragments.d.ts

@@ -0,0 +1,29 @@
+import type { Priority, RangePart } from '@bridgething/lib';
+import type { AckWindow } from './ack-window';
+import type { GatewayDevice } from './gateway-device';
+import type { ArtifactSource } from './source';
+export declare const DEFAULT_FRAGMENT_BYTES: number;
+export type StreamSourceOptions = {
+    device: GatewayDevice;
+    transferId: string;
+    source: ArtifactSource;
+    startOffset: number;
+    totalSize: number;
+    chunkSize: number;
+    priority: Priority;
+    window: AckWindow;
+    signal?: AbortSignal;
+};
+export declare function streamSourceFragments(opts: StreamSourceOptions): Promise<void>;
+export type StreamRangeOptions = {
+    device: GatewayDevice;
+    transferId: string;
+    source: ArtifactSource;
+    ranges: RangePart[];
+    chunkSize: number;
+    priority: Priority;
+    window: AckWindow;
+    signal?: AbortSignal;
+};
+export declare function streamRangeFragments(opts: StreamRangeOptions): Promise<void>;
+//# sourceMappingURL=fragments.d.ts.map

package/dist/fragments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fragments.d.ts","sourceRoot":"","sources":["../src/fragments.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,eAAO,MAAM,sBAAsB,QAAY,CAAC;AAEhD,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBpF;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBlF"}

package/dist/fragments.js

@@ -0,0 +1,45 @@
+import { TransferStalledError } from './ack-window';
+export const DEFAULT_FRAGMENT_BYTES = 64 * 1024;
+export async function streamSourceFragments(opts) {
+    let offset = opts.startOffset;
+    while (offset < opts.totalSize) {
+        if (opts.signal?.aborted)
+            return;
+        const ok = await opts.window.waitForRoom(offset);
+        if (opts.signal?.aborted)
+            return;
+        if (!ok)
+            throw new TransferStalledError(offset, opts.totalSize);
+        const want = Math.min(opts.chunkSize, opts.totalSize - offset);
+        const bytes = await opts.source.read(offset, want);
+        if (bytes.byteLength === 0) {
+            throw new Error(`unexpected EOF at offset ${offset}/${opts.totalSize}`);
+        }
+        await opts.device.transfer.fragment({ transferId: opts.transferId, offset, bytes }, { priority: opts.priority });
+        offset += bytes.byteLength;
+    }
+}
+export async function streamRangeFragments(opts) {
+    let streamOffset = 0;
+    for (const range of opts.ranges) {
+        let produced = 0;
+        while (produced < range.length) {
+            if (opts.signal?.aborted)
+                return;
+            const ok = await opts.window.waitForRoom(streamOffset);
+            if (opts.signal?.aborted)
+                return;
+            if (!ok)
+                throw new TransferStalledError(streamOffset, streamOffset + (range.length - produced));
+            const want = Math.min(opts.chunkSize, range.length - produced);
+            const bytes = await opts.source.read(range.start + produced, want);
+            if (bytes.byteLength === 0) {
+                throw new Error(`unexpected EOF reading range at offset ${range.start + produced}`);
+            }
+            await opts.device.transfer.fragment({ transferId: opts.transferId, offset: streamOffset, bytes }, { priority: opts.priority });
+            produced += bytes.byteLength;
+            streamOffset += bytes.byteLength;
+        }
+    }
+}
+//# sourceMappingURL=fragments.js.map

package/dist/fragments.js.map

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

package/dist/gateway-device.d.ts

@@ -0,0 +1,3 @@
+import type { GatewaySurfaces } from '@bridgething/gateway';
+export type GatewayDevice = ReturnType<GatewaySurfaces['device']>;
+//# sourceMappingURL=gateway-device.d.ts.map

package/dist/gateway-device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-device.d.ts","sourceRoot":"","sources":["../src/gateway-device.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC,CAAC"}

package/dist/gateway-device.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=gateway-device.js.map

package/dist/gateway-device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gateway-device.js","sourceRoot":"","sources":["../src/gateway-device.ts"],"names":[],"mappings":""}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export type { OtaKind, OtaPhase } from '@bridgething/gateway';
+export { AckRegistry, AckWindow, TransferStalledError } from './ack-window';
+export type { AckWindowOptions } from './ack-window';
+export { OtaDriver } from './driver';
+export type { OtaProgressSnapshot, ProgressListener, WebappInstallResult } from './driver';
+export { DEFAULT_FRAGMENT_BYTES, streamRangeFragments, streamSourceFragments } from './fragments';
+export type { StreamRangeOptions, StreamSourceOptions } from './fragments';
+export type { GatewayDevice } from './gateway-device';
+export { serveOtaAssetRanges } from './range-serve';
+export { blobArtifactSource, bytesArtifactSource, sha256Hex } from './source';
+export type { ArtifactSource } from './source';
+//# 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,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC5E,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAC3F,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAClG,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC3E,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC9E,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+export { AckRegistry, AckWindow, TransferStalledError } from './ack-window';
+export { OtaDriver } from './driver';
+export { DEFAULT_FRAGMENT_BYTES, streamRangeFragments, streamSourceFragments } from './fragments';
+export { serveOtaAssetRanges } from './range-serve';
+export { blobArtifactSource, bytesArtifactSource, sha256Hex } from './source';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAE5E,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAErC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGlG,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,50 @@
+export type OtaManifestChannel = {
+    name: string;
+    stability: string;
+    isDefault: boolean;
+    latest: string;
+    releases: string[];
+};
+export type OtaManifestRelease = {
+    version: string;
+    channel: string;
+    yanked: string | null;
+    deprecated: boolean;
+    builtinWebapps: Record<string, string>;
+};
+export type OtaDiscoverManifest = {
+    manifestVersion: number;
+    updatedAt: string;
+    channels: Record<string, OtaManifestChannel>;
+    releases: Record<string, OtaManifestRelease>;
+};
+export declare class ManifestFetchError extends Error {
+    readonly status?: number | undefined;
+    constructor(message: string, status?: number | undefined);
+}
+export declare function fetchManifest(rootURL: string): Promise<OtaDiscoverManifest>;
+export type OtaCompositeVersion = {
+    daemon: string;
+    image: string;
+};
+export declare function parseCompositeVersion(raw: string): OtaCompositeVersion | null;
+export type OtaArtifactURLs = {
+    daemonBinary: string;
+    imageSwu: string;
+    imageZck: string;
+    imageBootZck: string;
+};
+export declare function otaArtifactUrls(opts: {
+    rootURL: string;
+    channel: string;
+    daemonVersion: string;
+    imageVersion: string;
+    imageVariant: string;
+}): OtaArtifactURLs;
+export declare function builtinWebappUrl(opts: {
+    rootURL: string;
+    channel: string;
+    name: string;
+    version: string;
+}): string;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,EAAE,OAAO,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;CAC9C,CAAC;AAyBF,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,MAAM,CAAC,EAAE,MAAM;gBAD/B,OAAO,EAAE,MAAM,EACC,MAAM,CAAC,EAAE,MAAM,YAAA;CAKlC;AAED,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,CA4BjF;AAED,MAAM,MAAM,mBAAmB,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEpE,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAU7E;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,eAAe,CASlB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAElH"}

package/dist/manifest.js

@@ -0,0 +1,61 @@
+export class ManifestFetchError extends Error {
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+        this.name = 'ManifestFetchError';
+    }
+}
+export async function fetchManifest(rootURL) {
+    const response = await fetch(`${rootURL}/manifest.json`, { cache: 'no-store' });
+    if (!response.ok) {
+        throw new ManifestFetchError(`manifest fetch returned HTTP ${response.status}`, response.status);
+    }
+    const raw = (await response.json());
+    return {
+        manifestVersion: raw.manifest_version,
+        updatedAt: raw.updated_at,
+        channels: Object.fromEntries(Object.entries(raw.channels).map(([id, c]) => [
+            id,
+            { name: c.name, stability: c.stability, isDefault: c.default, latest: c.latest, releases: c.releases },
+        ])),
+        releases: Object.fromEntries(Object.entries(raw.releases).map(([version, r]) => [
+            version,
+            {
+                version: r.version,
+                channel: r.channel,
+                yanked: r.yanked,
+                deprecated: r.deprecated,
+                builtinWebapps: r.builtin_webapps ?? {},
+            },
+        ])),
+    };
+}
+export function parseCompositeVersion(raw) {
+    const plus = raw.indexOf('+');
+    if (plus < 0)
+        return null;
+    const daemon = raw.slice(0, plus);
+    const suffix = raw.slice(plus + 1);
+    const prefix = 'image.';
+    if (!suffix.startsWith(prefix))
+        return null;
+    const image = suffix.slice(prefix.length);
+    if (daemon.length === 0 || image.length === 0)
+        return null;
+    return { daemon, image };
+}
+export function otaArtifactUrls(opts) {
+    const imageName = `bridgething-${opts.imageVariant}-image`;
+    const imagesDir = `${opts.rootURL}/images/${opts.channel}/${opts.imageVersion}`;
+    return {
+        daemonBinary: `${opts.rootURL}/daemon/${opts.channel}/${opts.daemonVersion}/bridgething`,
+        imageSwu: `${imagesDir}/${imageName}.swu`,
+        imageZck: `${imagesDir}/${imageName}.zck`,
+        imageBootZck: `${imagesDir}/${imageName}-boot.zck`,
+    };
+}
+export function builtinWebappUrl(opts) {
+    return `${opts.rootURL}/webapps/${opts.channel}/${opts.name}/${opts.version}/${opts.name}.zip`;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/manifest.js.map

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

package/dist/node.d.ts

@@ -0,0 +1,3 @@
+import type { ArtifactSource } from './source';
+export declare function fileArtifactSource(path: string): Promise<ArtifactSource>;
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAY9E"}

package/dist/node.js

@@ -0,0 +1,15 @@
+import { open } from 'node:fs/promises';
+export async function fileArtifactSource(path) {
+    const handle = await open(path, 'r');
+    const stat = await handle.stat();
+    return {
+        size: stat.size,
+        async read(offset, length) {
+            const buf = new Uint8Array(length);
+            const { bytesRead } = await handle.read(buf, 0, length, offset);
+            return buf.subarray(0, bytesRead);
+        },
+        close: () => handle.close(),
+    };
+}
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAIxC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;IACjC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM;YACvB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;YACnC,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;YAChE,OAAO,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACpC,CAAC;QACD,KAAK,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,KAAK,EAAE;KAC5B,CAAC;AACJ,CAAC"}

package/dist/range-serve.d.ts

@@ -0,0 +1,5 @@
+import type { AckRegistry } from './ack-window';
+import type { GatewayDevice } from './gateway-device';
+import type { ArtifactSource } from './source';
+export declare function serveOtaAssetRanges(device: GatewayDevice, registry: AckRegistry, zcks: Map<string, ArtifactSource>): () => void;
+//# sourceMappingURL=range-serve.d.ts.map

package/dist/range-serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"range-serve.d.ts","sourceRoot":"","sources":["../src/range-serve.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAK/C,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,WAAW,EACrB,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,GAChC,MAAM,IAAI,CA8CZ"}

package/dist/range-serve.js

@@ -0,0 +1,58 @@
+import { streamRangeFragments } from './fragments';
+const RANGE_INLINE_MAX_BYTES = 16 * 1024;
+const RANGE_CHUNK_BYTES = 64 * 1024;
+export function serveOtaAssetRanges(device, registry, zcks) {
+    return device.system.onOtaAssetRange(async (handle, req) => {
+        const source = zcks.get(req.asset);
+        if (!source) {
+            await handle.respondErr({ reason: `no local .zck for asset ${req.asset}` });
+            return;
+        }
+        for (const r of req.ranges) {
+            if (r.start + r.length > source.size) {
+                await handle.respondErr({ reason: `range ${r.start}+${r.length} exceeds zck size ${source.size}` });
+                return;
+            }
+        }
+        const parts = req.ranges.map(r => ({ start: r.start, length: r.length }));
+        const streamLen = parts.reduce((sum, p) => sum + p.length, 0);
+        if (streamLen <= RANGE_INLINE_MAX_BYTES) {
+            const pieces = [];
+            for (const part of parts)
+                pieces.push(await source.read(part.start, part.length));
+            await handle.respond({ totalSize: source.size, parts, body: { type: 'inline', data: concat(pieces) } });
+            return;
+        }
+        await handle.respond({
+            totalSize: source.size,
+            parts,
+            body: { type: 'stream', data: { id: handle.requestId, totalSize: streamLen, sha256: null } },
+        });
+        const window = registry.register(handle.requestId, 0);
+        try {
+            await streamRangeFragments({
+                device,
+                transferId: handle.requestId,
+                source,
+                ranges: parts,
+                chunkSize: RANGE_CHUNK_BYTES,
+                priority: 'background',
+                window,
+            });
+        }
+        finally {
+            registry.deregister(handle.requestId);
+        }
+    });
+}
+function concat(pieces) {
+    const total = pieces.reduce((sum, p) => sum + p.byteLength, 0);
+    const out = new Uint8Array(total);
+    let offset = 0;
+    for (const piece of pieces) {
+        out.set(piece, offset);
+        offset += piece.byteLength;
+    }
+    return out;
+}
+//# sourceMappingURL=range-serve.js.map

package/dist/range-serve.js.map

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

package/dist/source.d.ts

@@ -0,0 +1,9 @@
+export type ArtifactSource = {
+    readonly size: number;
+    read(offset: number, length: number): Promise<Uint8Array>;
+    close?(): Promise<void> | void;
+};
+export declare function bytesArtifactSource(bytes: Uint8Array): ArtifactSource;
+export declare function blobArtifactSource(blob: Blob): ArtifactSource;
+export declare function sha256Hex(source: ArtifactSource): Promise<string>;
+//# sourceMappingURL=source.d.ts.map

package/dist/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../src/source.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1D,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAChC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAOrE;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,cAAc,CAQ7D;AAED,wBAAsB,SAAS,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAMvE"}