@otakit/capacitor-updater 2.1.2 → 2.2.0

package/dist/esm/web.d.ts

@@ -1,5 +1,5 @@
 import { WebPlugin } from '@capacitor/core';
-import type { OtaKitBridgePlugin, BundleInfo, CheckResult, DownloadResult, OtaKitState } from './definitions';
+import type { OtaKitBridgePlugin, BundleInfo, ChannelInfo, CheckResult, DownloadResult, OtaKitState } from './definitions';
 /**
  * Web implementation of the native bridge.
  * Most methods are no-ops since OTA updates don't apply to web.
@@ -13,5 +13,11 @@ export declare class OtaKitWeb extends WebPlugin implements OtaKitBridgePlugin {
     update(): Promise<void>;
     notifyAppReady(): Promise<void>;
     getLastFailure(): Promise<BundleInfo | null>;
+    private static readonly OVERRIDE_CHANNEL_KEY;
+    private static isValidChannelName;
+    setChannel(options: {
+        channel: string | null;
+    }): Promise<void>;
+    getChannel(): Promise<ChannelInfo>;
 }
 //# sourceMappingURL=web.d.ts.map

package/dist/esm/web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EAEV,WAAW,EACX,cAAc,EACd,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB;;;GAGG;AACH,qBAAa,SAAU,SAAQ,SAAU,YAAW,kBAAkB;IACpE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAI7B;IAEI,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAShC,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAK7B,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAKnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAGnD"}
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,KAAK,EACV,kBAAkB,EAClB,UAAU,EAEV,WAAW,EACX,WAAW,EACX,cAAc,EACd,WAAW,EACZ,MAAM,eAAe,CAAC;AAEvB;;;GAGG;AACH,qBAAa,SAAU,SAAQ,SAAU,YAAW,kBAAkB;IACpE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAI7B;IAEI,QAAQ,IAAI,OAAO,CAAC,WAAW,CAAC;IAShC,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAK7B,QAAQ,IAAI,OAAO,CAAC,cAAc,CAAC;IAKnC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,cAAc,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIlD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAA6B;IAEzE,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAQ3B,UAAU,CAAC,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9D,UAAU,IAAI,OAAO,CAAC,WAAW,CAAC;CAOzC"}

package/dist/esm/web.js

@@ -38,5 +38,30 @@ export class OtaKitWeb extends WebPlugin {
     async getLastFailure() {
         return null;
     }
+    static OVERRIDE_CHANNEL_KEY = 'otakit_override_channel';
+    static isValidChannelName(name) {
+        if (!/^[A-Za-z0-9._-]{1,64}$/.test(name) || name.includes('..') || name === '.') {
+            return false;
+        }
+        const lower = name.toLowerCase();
+        return lower !== 'base' && lower !== 'default';
+    }
+    async setChannel(options) {
+        if (options.channel === null) {
+            window.localStorage.removeItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY);
+            return;
+        }
+        if (!OtaKitWeb.isValidChannelName(options.channel)) {
+            throw new Error(`Invalid channel name '${options.channel}': use 1-64 letters, numbers, '.', '_' or '-' (reserved names: base, default)`);
+        }
+        window.localStorage.setItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY, options.channel);
+    }
+    async getChannel() {
+        const override = window.localStorage.getItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY);
+        if (override !== null) {
+            return { channel: override, source: 'override' };
+        }
+        return { channel: null, source: 'config' };
+    }
 }
 //# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -1 +1 @@
-{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAW5C;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,SAAS;IACrB,cAAc,GAAe;QAC5C,EAAE,EAAE,SAAS;QACb,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,SAAyB;KAClC,CAAC;IAEF,KAAK,CAAC,QAAQ;QACZ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,cAAc;YAC5B,QAAQ,EAAE,IAAI,CAAC,cAAc;YAC7B,MAAM,EAAE,IAAI;YACZ,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO;SAC5C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,uEAAuE;IACzE,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}
+{"version":3,"file":"web.js","sourceRoot":"","sources":["../../src/web.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAY5C;;;GAGG;AACH,MAAM,OAAO,SAAU,SAAQ,SAAS;IACrB,cAAc,GAAe;QAC5C,EAAE,EAAE,SAAS;QACb,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE,SAAyB;KAClC,CAAC;IAEF,KAAK,CAAC,QAAQ;QACZ,OAAO;YACL,OAAO,EAAE,IAAI,CAAC,cAAc;YAC5B,QAAQ,EAAE,IAAI,CAAC,cAAc;YAC7B,MAAM,EAAE,IAAI;YACZ,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,OAAO;SAC5C,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACvD,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAC/B,CAAC;IAED,KAAK,CAAC,KAAK;QACT,OAAO,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;QACvD,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,IAAI,CAAC,QAAQ,EAAE,CAAC;IACxB,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,uEAAuE;IACzE,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,MAAM,CAAU,oBAAoB,GAAG,yBAAyB,CAAC;IAEjE,MAAM,CAAC,kBAAkB,CAAC,IAAY;QAC5C,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,GAAG,EAAE,CAAC;YAChF,OAAO,KAAK,CAAC;QACf,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QACjC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,SAAS,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,OAAmC;QAClD,IAAI,OAAO,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YAC7B,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;YAC/D,OAAO;QACT,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,yBAAyB,OAAO,CAAC,OAAO,+EAA+E,CACxH,CAAC;QACJ,CAAC;QACD,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,oBAAoB,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/E,CAAC;IAED,KAAK,CAAC,UAAU;QACd,MAAM,QAAQ,GAAG,MAAM,CAAC,YAAY,CAAC,OAAO,CAAC,SAAS,CAAC,oBAAoB,CAAC,CAAC;QAC7E,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;QACnD,CAAC;QACD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC7C,CAAC"}

package/dist/plugin.cjs.js

@@ -43,6 +43,12 @@ const OtaKit = {
     update: () => NativeOtaKit.update(),
     notifyAppReady: () => NativeOtaKit.notifyAppReady(),
     getLastFailure: async () => normalizeNullable(await NativeOtaKit.getLastFailure()),
+    setChannel: (options) => NativeOtaKit.setChannel(options),
+    getChannel: () => NativeOtaKit.getChannel(),
+    // NativeOtaKit is the registerPlugin proxy, which implements Capacitor's
+    // listener API; this plain-object wrapper must forward it explicitly.
+    addListener: ((eventName, listenerFunc) => NativeOtaKit.addListener(eventName, listenerFunc)),
+    removeAllListeners: () => NativeOtaKit.removeAllListeners(),
 };
 
 /**
@@ -84,6 +90,31 @@ class OtaKitWeb extends core.WebPlugin {
     async getLastFailure() {
         return null;
     }
+    static OVERRIDE_CHANNEL_KEY = 'otakit_override_channel';
+    static isValidChannelName(name) {
+        if (!/^[A-Za-z0-9._-]{1,64}$/.test(name) || name.includes('..') || name === '.') {
+            return false;
+        }
+        const lower = name.toLowerCase();
+        return lower !== 'base' && lower !== 'default';
+    }
+    async setChannel(options) {
+        if (options.channel === null) {
+            window.localStorage.removeItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY);
+            return;
+        }
+        if (!OtaKitWeb.isValidChannelName(options.channel)) {
+            throw new Error(`Invalid channel name '${options.channel}': use 1-64 letters, numbers, '.', '_' or '-' (reserved names: base, default)`);
+        }
+        window.localStorage.setItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY, options.channel);
+    }
+    async getChannel() {
+        const override = window.localStorage.getItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY);
+        if (override !== null) {
+            return { channel: override, source: 'override' };
+        }
+        return { channel: null, source: 'config' };
+    }
 }
 
 var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/**\n * Bundle status enum.\n */\nexport var BundleStatus;\n(function (BundleStatus) {\n    /** Factory-installed bundle */\n    BundleStatus[\"BUILTIN\"] = \"builtin\";\n    /** Downloaded and staged, awaiting activation */\n    BundleStatus[\"PENDING\"] = \"pending\";\n    /** Active but not yet confirmed */\n    BundleStatus[\"TRIAL\"] = \"trial\";\n    /** Confirmed working */\n    BundleStatus[\"SUCCESS\"] = \"success\";\n    /** Failed (hash mismatch, extraction error, rollback) */\n    BundleStatus[\"ERROR\"] = \"error\";\n})(BundleStatus || (BundleStatus = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst NativeOtaKit = registerPlugin('OtaKit', {\n    web: () => import('./web').then((m) => new m.OtaKitWeb()),\n});\n/**\n * Check if result is an empty object (iOS returns {} instead of null)\n */\nfunction isEmptyObject(obj) {\n    return obj !== null && typeof obj === 'object' && Object.keys(obj).length === 0;\n}\n/**\n * Wrapped plugin that normalizes null returns from native code.\n * iOS call.resolve() without arguments returns {} instead of null.\n */\nfunction normalizeNullable(value) {\n    return isEmptyObject(value) ? null : value;\n}\nconst OtaKit = {\n    getState: () => NativeOtaKit.getState(),\n    check: () => NativeOtaKit.check(),\n    download: () => NativeOtaKit.download(),\n    apply: () => NativeOtaKit.apply(),\n    update: () => NativeOtaKit.update(),\n    notifyAppReady: () => NativeOtaKit.notifyAppReady(),\n    getLastFailure: async () => normalizeNullable(await NativeOtaKit.getLastFailure()),\n};\nexport * from './definitions';\nexport { OtaKit };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the native bridge.\n * Most methods are no-ops since OTA updates don't apply to web.\n */\nexport class OtaKitWeb extends WebPlugin {\n    BUILTIN_BUNDLE = {\n        id: 'builtin',\n        version: '0.0.0',\n        status: 'builtin',\n    };\n    async getState() {\n        return {\n            current: this.BUILTIN_BUNDLE,\n            fallback: this.BUILTIN_BUNDLE,\n            staged: null,\n            builtinVersion: this.BUILTIN_BUNDLE.version,\n        };\n    }\n    async check() {\n        console.warn('OtaKit.check() is not supported on web');\n        return { kind: 'no_update' };\n    }\n    async download() {\n        console.warn('OtaKit.download() is not supported on web');\n        return { kind: 'no_update' };\n    }\n    async apply() {\n        console.warn('OtaKit.apply() is not supported on web');\n        throw new Error('OtaKit.apply() is not supported on web');\n    }\n    async update() {\n        await this.download();\n    }\n    async notifyAppReady() {\n        // No-op on web, but don't warn - apps should call this unconditionally\n    }\n    async getLastFailure() {\n        return null;\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["BundleStatus","registerPlugin","WebPlugin"],"mappings":"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"}
+{"version":3,"file":"plugin.cjs.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/**\n * Bundle status enum.\n */\nexport var BundleStatus;\n(function (BundleStatus) {\n    /** Factory-installed bundle */\n    BundleStatus[\"BUILTIN\"] = \"builtin\";\n    /** Downloaded and staged, awaiting activation */\n    BundleStatus[\"PENDING\"] = \"pending\";\n    /** Active but not yet confirmed */\n    BundleStatus[\"TRIAL\"] = \"trial\";\n    /** Confirmed working */\n    BundleStatus[\"SUCCESS\"] = \"success\";\n    /** Failed (hash mismatch, extraction error, rollback) */\n    BundleStatus[\"ERROR\"] = \"error\";\n})(BundleStatus || (BundleStatus = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst NativeOtaKit = registerPlugin('OtaKit', {\n    web: () => import('./web').then((m) => new m.OtaKitWeb()),\n});\n/**\n * Check if result is an empty object (iOS returns {} instead of null)\n */\nfunction isEmptyObject(obj) {\n    return obj !== null && typeof obj === 'object' && Object.keys(obj).length === 0;\n}\n/**\n * Wrapped plugin that normalizes null returns from native code.\n * iOS call.resolve() without arguments returns {} instead of null.\n */\nfunction normalizeNullable(value) {\n    return isEmptyObject(value) ? null : value;\n}\nconst OtaKit = {\n    getState: () => NativeOtaKit.getState(),\n    check: () => NativeOtaKit.check(),\n    download: () => NativeOtaKit.download(),\n    apply: () => NativeOtaKit.apply(),\n    update: () => NativeOtaKit.update(),\n    notifyAppReady: () => NativeOtaKit.notifyAppReady(),\n    getLastFailure: async () => normalizeNullable(await NativeOtaKit.getLastFailure()),\n    setChannel: (options) => NativeOtaKit.setChannel(options),\n    getChannel: () => NativeOtaKit.getChannel(),\n    // NativeOtaKit is the registerPlugin proxy, which implements Capacitor's\n    // listener API; this plain-object wrapper must forward it explicitly.\n    addListener: ((eventName, listenerFunc) => NativeOtaKit.addListener(eventName, listenerFunc)),\n    removeAllListeners: () => NativeOtaKit.removeAllListeners(),\n};\nexport * from './definitions';\nexport { OtaKit };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the native bridge.\n * Most methods are no-ops since OTA updates don't apply to web.\n */\nexport class OtaKitWeb extends WebPlugin {\n    BUILTIN_BUNDLE = {\n        id: 'builtin',\n        version: '0.0.0',\n        status: 'builtin',\n    };\n    async getState() {\n        return {\n            current: this.BUILTIN_BUNDLE,\n            fallback: this.BUILTIN_BUNDLE,\n            staged: null,\n            builtinVersion: this.BUILTIN_BUNDLE.version,\n        };\n    }\n    async check() {\n        console.warn('OtaKit.check() is not supported on web');\n        return { kind: 'no_update' };\n    }\n    async download() {\n        console.warn('OtaKit.download() is not supported on web');\n        return { kind: 'no_update' };\n    }\n    async apply() {\n        console.warn('OtaKit.apply() is not supported on web');\n        throw new Error('OtaKit.apply() is not supported on web');\n    }\n    async update() {\n        await this.download();\n    }\n    async notifyAppReady() {\n        // No-op on web, but don't warn - apps should call this unconditionally\n    }\n    async getLastFailure() {\n        return null;\n    }\n    static OVERRIDE_CHANNEL_KEY = 'otakit_override_channel';\n    static isValidChannelName(name) {\n        if (!/^[A-Za-z0-9._-]{1,64}$/.test(name) || name.includes('..') || name === '.') {\n            return false;\n        }\n        const lower = name.toLowerCase();\n        return lower !== 'base' && lower !== 'default';\n    }\n    async setChannel(options) {\n        if (options.channel === null) {\n            window.localStorage.removeItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY);\n            return;\n        }\n        if (!OtaKitWeb.isValidChannelName(options.channel)) {\n            throw new Error(`Invalid channel name '${options.channel}': use 1-64 letters, numbers, '.', '_' or '-' (reserved names: base, default)`);\n        }\n        window.localStorage.setItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY, options.channel);\n    }\n    async getChannel() {\n        const override = window.localStorage.getItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY);\n        if (override !== null) {\n            return { channel: override, source: 'override' };\n        }\n        return { channel: null, source: 'config' };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["BundleStatus","registerPlugin","WebPlugin"],"mappings":"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"}

package/dist/plugin.js

@@ -42,6 +42,12 @@ var capacitorUpdater = (function (exports, core) {
         update: () => NativeOtaKit.update(),
         notifyAppReady: () => NativeOtaKit.notifyAppReady(),
         getLastFailure: async () => normalizeNullable(await NativeOtaKit.getLastFailure()),
+        setChannel: (options) => NativeOtaKit.setChannel(options),
+        getChannel: () => NativeOtaKit.getChannel(),
+        // NativeOtaKit is the registerPlugin proxy, which implements Capacitor's
+        // listener API; this plain-object wrapper must forward it explicitly.
+        addListener: ((eventName, listenerFunc) => NativeOtaKit.addListener(eventName, listenerFunc)),
+        removeAllListeners: () => NativeOtaKit.removeAllListeners(),
     };
 
     /**
@@ -83,6 +89,31 @@ var capacitorUpdater = (function (exports, core) {
         async getLastFailure() {
             return null;
         }
+        static OVERRIDE_CHANNEL_KEY = 'otakit_override_channel';
+        static isValidChannelName(name) {
+            if (!/^[A-Za-z0-9._-]{1,64}$/.test(name) || name.includes('..') || name === '.') {
+                return false;
+            }
+            const lower = name.toLowerCase();
+            return lower !== 'base' && lower !== 'default';
+        }
+        async setChannel(options) {
+            if (options.channel === null) {
+                window.localStorage.removeItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY);
+                return;
+            }
+            if (!OtaKitWeb.isValidChannelName(options.channel)) {
+                throw new Error(`Invalid channel name '${options.channel}': use 1-64 letters, numbers, '.', '_' or '-' (reserved names: base, default)`);
+            }
+            window.localStorage.setItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY, options.channel);
+        }
+        async getChannel() {
+            const override = window.localStorage.getItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY);
+            if (override !== null) {
+                return { channel: override, source: 'override' };
+            }
+            return { channel: null, source: 'config' };
+        }
     }
 
     var web = /*#__PURE__*/Object.freeze({

package/dist/plugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/**\n * Bundle status enum.\n */\nexport var BundleStatus;\n(function (BundleStatus) {\n    /** Factory-installed bundle */\n    BundleStatus[\"BUILTIN\"] = \"builtin\";\n    /** Downloaded and staged, awaiting activation */\n    BundleStatus[\"PENDING\"] = \"pending\";\n    /** Active but not yet confirmed */\n    BundleStatus[\"TRIAL\"] = \"trial\";\n    /** Confirmed working */\n    BundleStatus[\"SUCCESS\"] = \"success\";\n    /** Failed (hash mismatch, extraction error, rollback) */\n    BundleStatus[\"ERROR\"] = \"error\";\n})(BundleStatus || (BundleStatus = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst NativeOtaKit = registerPlugin('OtaKit', {\n    web: () => import('./web').then((m) => new m.OtaKitWeb()),\n});\n/**\n * Check if result is an empty object (iOS returns {} instead of null)\n */\nfunction isEmptyObject(obj) {\n    return obj !== null && typeof obj === 'object' && Object.keys(obj).length === 0;\n}\n/**\n * Wrapped plugin that normalizes null returns from native code.\n * iOS call.resolve() without arguments returns {} instead of null.\n */\nfunction normalizeNullable(value) {\n    return isEmptyObject(value) ? null : value;\n}\nconst OtaKit = {\n    getState: () => NativeOtaKit.getState(),\n    check: () => NativeOtaKit.check(),\n    download: () => NativeOtaKit.download(),\n    apply: () => NativeOtaKit.apply(),\n    update: () => NativeOtaKit.update(),\n    notifyAppReady: () => NativeOtaKit.notifyAppReady(),\n    getLastFailure: async () => normalizeNullable(await NativeOtaKit.getLastFailure()),\n};\nexport * from './definitions';\nexport { OtaKit };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the native bridge.\n * Most methods are no-ops since OTA updates don't apply to web.\n */\nexport class OtaKitWeb extends WebPlugin {\n    BUILTIN_BUNDLE = {\n        id: 'builtin',\n        version: '0.0.0',\n        status: 'builtin',\n    };\n    async getState() {\n        return {\n            current: this.BUILTIN_BUNDLE,\n            fallback: this.BUILTIN_BUNDLE,\n            staged: null,\n            builtinVersion: this.BUILTIN_BUNDLE.version,\n        };\n    }\n    async check() {\n        console.warn('OtaKit.check() is not supported on web');\n        return { kind: 'no_update' };\n    }\n    async download() {\n        console.warn('OtaKit.download() is not supported on web');\n        return { kind: 'no_update' };\n    }\n    async apply() {\n        console.warn('OtaKit.apply() is not supported on web');\n        throw new Error('OtaKit.apply() is not supported on web');\n    }\n    async update() {\n        await this.download();\n    }\n    async notifyAppReady() {\n        // No-op on web, but don't warn - apps should call this unconditionally\n    }\n    async getLastFailure() {\n        return null;\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["BundleStatus","registerPlugin","WebPlugin"],"mappings":"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"}
+{"version":3,"file":"plugin.js","sources":["esm/definitions.js","esm/index.js","esm/web.js"],"sourcesContent":["/**\n * Bundle status enum.\n */\nexport var BundleStatus;\n(function (BundleStatus) {\n    /** Factory-installed bundle */\n    BundleStatus[\"BUILTIN\"] = \"builtin\";\n    /** Downloaded and staged, awaiting activation */\n    BundleStatus[\"PENDING\"] = \"pending\";\n    /** Active but not yet confirmed */\n    BundleStatus[\"TRIAL\"] = \"trial\";\n    /** Confirmed working */\n    BundleStatus[\"SUCCESS\"] = \"success\";\n    /** Failed (hash mismatch, extraction error, rollback) */\n    BundleStatus[\"ERROR\"] = \"error\";\n})(BundleStatus || (BundleStatus = {}));\n//# sourceMappingURL=definitions.js.map","import { registerPlugin } from '@capacitor/core';\nconst NativeOtaKit = registerPlugin('OtaKit', {\n    web: () => import('./web').then((m) => new m.OtaKitWeb()),\n});\n/**\n * Check if result is an empty object (iOS returns {} instead of null)\n */\nfunction isEmptyObject(obj) {\n    return obj !== null && typeof obj === 'object' && Object.keys(obj).length === 0;\n}\n/**\n * Wrapped plugin that normalizes null returns from native code.\n * iOS call.resolve() without arguments returns {} instead of null.\n */\nfunction normalizeNullable(value) {\n    return isEmptyObject(value) ? null : value;\n}\nconst OtaKit = {\n    getState: () => NativeOtaKit.getState(),\n    check: () => NativeOtaKit.check(),\n    download: () => NativeOtaKit.download(),\n    apply: () => NativeOtaKit.apply(),\n    update: () => NativeOtaKit.update(),\n    notifyAppReady: () => NativeOtaKit.notifyAppReady(),\n    getLastFailure: async () => normalizeNullable(await NativeOtaKit.getLastFailure()),\n    setChannel: (options) => NativeOtaKit.setChannel(options),\n    getChannel: () => NativeOtaKit.getChannel(),\n    // NativeOtaKit is the registerPlugin proxy, which implements Capacitor's\n    // listener API; this plain-object wrapper must forward it explicitly.\n    addListener: ((eventName, listenerFunc) => NativeOtaKit.addListener(eventName, listenerFunc)),\n    removeAllListeners: () => NativeOtaKit.removeAllListeners(),\n};\nexport * from './definitions';\nexport { OtaKit };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/**\n * Web implementation of the native bridge.\n * Most methods are no-ops since OTA updates don't apply to web.\n */\nexport class OtaKitWeb extends WebPlugin {\n    BUILTIN_BUNDLE = {\n        id: 'builtin',\n        version: '0.0.0',\n        status: 'builtin',\n    };\n    async getState() {\n        return {\n            current: this.BUILTIN_BUNDLE,\n            fallback: this.BUILTIN_BUNDLE,\n            staged: null,\n            builtinVersion: this.BUILTIN_BUNDLE.version,\n        };\n    }\n    async check() {\n        console.warn('OtaKit.check() is not supported on web');\n        return { kind: 'no_update' };\n    }\n    async download() {\n        console.warn('OtaKit.download() is not supported on web');\n        return { kind: 'no_update' };\n    }\n    async apply() {\n        console.warn('OtaKit.apply() is not supported on web');\n        throw new Error('OtaKit.apply() is not supported on web');\n    }\n    async update() {\n        await this.download();\n    }\n    async notifyAppReady() {\n        // No-op on web, but don't warn - apps should call this unconditionally\n    }\n    async getLastFailure() {\n        return null;\n    }\n    static OVERRIDE_CHANNEL_KEY = 'otakit_override_channel';\n    static isValidChannelName(name) {\n        if (!/^[A-Za-z0-9._-]{1,64}$/.test(name) || name.includes('..') || name === '.') {\n            return false;\n        }\n        const lower = name.toLowerCase();\n        return lower !== 'base' && lower !== 'default';\n    }\n    async setChannel(options) {\n        if (options.channel === null) {\n            window.localStorage.removeItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY);\n            return;\n        }\n        if (!OtaKitWeb.isValidChannelName(options.channel)) {\n            throw new Error(`Invalid channel name '${options.channel}': use 1-64 letters, numbers, '.', '_' or '-' (reserved names: base, default)`);\n        }\n        window.localStorage.setItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY, options.channel);\n    }\n    async getChannel() {\n        const override = window.localStorage.getItem(OtaKitWeb.OVERRIDE_CHANNEL_KEY);\n        if (override !== null) {\n            return { channel: override, source: 'override' };\n        }\n        return { channel: null, source: 'config' };\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["BundleStatus","registerPlugin","WebPlugin"],"mappings":"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"}

package/ios/Sources/UpdaterPlugin/BundleCrypto.swift

@@ -0,0 +1,91 @@
+import CryptoKit
+import Foundation
+
+enum BundleCryptoError: Error, LocalizedError {
+  case noMatchingKey(String)
+  case invalidParameter(String)
+  case decryptionFailed(String)
+
+  var errorDescription: String? {
+    switch self {
+    case let .noMatchingKey(kid):
+      return "no matching bundle key (kid \(kid))"
+    case let .invalidParameter(name):
+      return "invalid bundle encryption parameter: \(name)"
+    case let .decryptionFailed(detail):
+      return "bundle decryption failed: \(detail)"
+    }
+  }
+}
+
+/// AES-256-GCM bundle decryption.
+///
+/// The CLI encrypts the zip with a random per-bundle DEK and wraps the DEK
+/// under the app KEK; both ciphertexts carry the 16-byte GCM tag appended.
+enum BundleCrypto {
+  private static let tagLength = 16
+  private static let keyLength = 32
+
+  static func unwrapDek(
+    kek: Data,
+    wrapNonceB64: String,
+    wrappedDekB64: String
+  ) throws -> Data {
+    guard kek.count == keyLength else {
+      throw BundleCryptoError.invalidParameter("bundle key length")
+    }
+    guard let wrapNonce = Data(base64Encoded: wrapNonceB64) else {
+      throw BundleCryptoError.invalidParameter("wrapNonce")
+    }
+    guard let wrappedDek = Data(base64Encoded: wrappedDekB64),
+          wrappedDek.count == keyLength + tagLength else {
+      throw BundleCryptoError.invalidParameter("wrappedDek")
+    }
+
+    let dek: Data
+    do {
+      let sealedBox = try AES.GCM.SealedBox(
+        nonce: AES.GCM.Nonce(data: wrapNonce),
+        ciphertext: wrappedDek.prefix(keyLength),
+        tag: wrappedDek.suffix(tagLength)
+      )
+      dek = try AES.GCM.open(sealedBox, using: SymmetricKey(data: kek))
+    } catch {
+      throw BundleCryptoError.decryptionFailed("DEK unwrap: \(error.localizedDescription)")
+    }
+    guard dek.count == keyLength else {
+      throw BundleCryptoError.decryptionFailed("unwrapped DEK has unexpected length")
+    }
+    return dek
+  }
+
+  static func decryptFile(
+    dek: Data,
+    nonceB64: String,
+    input: URL,
+    output: URL
+  ) throws {
+    guard let nonce = Data(base64Encoded: nonceB64) else {
+      throw BundleCryptoError.invalidParameter("nonce")
+    }
+
+    let ciphertextWithTag = try Data(contentsOf: input)
+    guard ciphertextWithTag.count > tagLength else {
+      throw BundleCryptoError.invalidParameter("ciphertext too short")
+    }
+
+    do {
+      let sealedBox = try AES.GCM.SealedBox(
+        nonce: AES.GCM.Nonce(data: nonce),
+        ciphertext: ciphertextWithTag.prefix(ciphertextWithTag.count - tagLength),
+        tag: ciphertextWithTag.suffix(tagLength)
+      )
+      let plaintext = try AES.GCM.open(sealedBox, using: SymmetricKey(data: dek))
+      try plaintext.write(to: output, options: .atomic)
+    } catch let error as BundleCryptoError {
+      throw error
+    } catch {
+      throw BundleCryptoError.decryptionFailed(error.localizedDescription)
+    }
+  }
+}

package/ios/Sources/UpdaterPlugin/BundleStore.swift

@@ -7,6 +7,7 @@ final class BundleStore {
     static let stagedBundleId = "otakit_staged_bundle_id"
     static let lastFailedBundleInfo = "otakit_last_failed_bundle_info"
     static let lastResolvedRuntimeKey = "otakit_last_resolved_runtime_key"
+    static let overrideChannel = "otakit_override_channel"
   }
 
   private let defaults = UserDefaults.standard
@@ -206,6 +207,18 @@ final class BundleStore {
     return try? decoder.decode(BundleInfo.self, from: data)
   }
 
+  func getOverrideChannel() -> String? {
+    defaults.string(forKey: Keys.overrideChannel)
+  }
+
+  func setOverrideChannel(_ channel: String?) {
+    if let channel {
+      defaults.set(channel, forKey: Keys.overrideChannel)
+    } else {
+      defaults.removeObject(forKey: Keys.overrideChannel)
+    }
+  }
+
   func getLastResolvedRuntimeKey() -> String? {
     defaults.string(forKey: Keys.lastResolvedRuntimeKey)
   }

package/ios/Sources/UpdaterPlugin/ManifestClient.swift

@@ -3,6 +3,14 @@ import Foundation
 private let baseChannelKey = "__base__"
 private let defaultRuntimeKey = "__default__"
 
+struct ManifestEncryption {
+  let alg: String
+  let kid: String
+  let wrapNonce: String
+  let wrappedDek: String
+  let nonce: String
+}
+
 struct LatestManifest {
   let version: String
   let url: String
@@ -10,6 +18,9 @@ struct LatestManifest {
   let size: Int
   let runtimeVersion: String?
   let releaseId: String
+  let strategy: String
+  let forceImmediate: Bool
+  let encryption: ManifestEncryption?
 }
 
 struct ManifestSignature {
@@ -112,6 +123,12 @@ enum ManifestClient {
       throw ManifestClientError.invalidResponse
     }
 
+    let strategy = (object["strategy"] as? String)?
+      .trimmingCharacters(in: .whitespacesAndNewlines)
+      .nilIfEmpty ?? "zip"
+    let forceImmediate = object["forceImmediate"] as? Bool ?? false
+    let encryption = try parseEncryption(object["encryption"])
+
     guard let dlURL = URL(string: downloadUrl) else {
       throw ManifestClientError.invalidURL
     }
@@ -133,6 +150,9 @@ enum ManifestClient {
         sha256: sha256,
         size: size,
         runtimeVersion: runtimeVersion,
+        strategy: strategy,
+        forceImmediate: forceImmediate,
+        encryption: encryption,
         signature: signature,
         trustedKeys: manifestKeys
       )
@@ -144,7 +164,31 @@ enum ManifestClient {
       sha256: sha256,
       size: size,
       runtimeVersion: runtimeVersion,
-      releaseId: releaseId
+      releaseId: releaseId,
+      strategy: strategy,
+      forceImmediate: forceImmediate,
+      encryption: encryption
+    )
+  }
+
+  private static func parseEncryption(_ rawValue: Any?) throws -> ManifestEncryption? {
+    guard let rawValue, !(rawValue is NSNull) else {
+      return nil
+    }
+    guard let object = rawValue as? [String: Any],
+          let alg = object["alg"] as? String,
+          let kid = object["kid"] as? String,
+          let wrapNonce = object["wrapNonce"] as? String,
+          let wrappedDek = object["wrappedDek"] as? String,
+          let nonce = object["nonce"] as? String else {
+      throw ManifestClientError.invalidResponse
+    }
+    return ManifestEncryption(
+      alg: alg,
+      kid: kid,
+      wrapNonce: wrapNonce,
+      wrappedDek: wrappedDek,
+      nonce: nonce
     )
   }
 

package/ios/Sources/UpdaterPlugin/ManifestVerifier.swift

@@ -31,6 +31,9 @@ enum ManifestVerifier {
     sha256: String,
     size: Int,
     runtimeVersion: String?,
+    strategy: String,
+    forceImmediate: Bool,
+    encryption: ManifestEncryption?,
     signature: ManifestSignature,
     trustedKeys: [ManifestKey]
   ) throws {
@@ -41,6 +44,9 @@ enum ManifestVerifier {
       sha256: sha256,
       size: size,
       runtimeVersion: runtimeVersion,
+      strategy: strategy,
+      forceImmediate: forceImmediate,
+      encryption: encryption,
       kid: signature.kid,
       iat: signature.iat,
       exp: signature.exp
@@ -78,6 +84,23 @@ enum ManifestVerifier {
     }
   }
 
+  /// Encode the encryption block for the canonical payload.
+  /// Must match the server's `encodeEncryptionForPayload` exactly.
+  private static func encodeEncryptionForPayload(_ encryption: ManifestEncryption?) -> String {
+    guard let encryption else {
+      return "null"
+    }
+    return [
+      encryption.alg,
+      encryption.kid,
+      encryption.wrapNonce,
+      encryption.wrappedDek,
+      encryption.nonce,
+    ].joined(separator: "|")
+  }
+
+  /// Canonical payload v2 — must match the server's `buildCanonicalPayload`
+  /// (console/lib/manifest-signing.ts) and the Android mirror byte-for-byte.
   private static func buildCanonicalPayload(
     appId: String,
     channel: String?,
@@ -85,6 +108,9 @@ enum ManifestVerifier {
     sha256: String,
     size: Int,
     runtimeVersion: String?,
+    strategy: String,
+    forceImmediate: Bool,
+    encryption: ManifestEncryption?,
     kid: String,
     iat: Int,
     exp: Int
@@ -97,6 +123,9 @@ enum ManifestVerifier {
       "sha256:\(sha256)",
       "size:\(size)",
       "runtimeVersion:\(runtimeVersion ?? "null")",
+      "strategy:\(strategy)",
+      "forceImmediate:\(forceImmediate ? "true" : "false")",
+      "encryption:\(encodeEncryptionForPayload(encryption))",
       "kid:\(kid)",
       "iat:\(iat)",
       "exp:\(exp)",