@otakit/capacitor-updater 1.0.0

package/android/src/main/java/com/updatekit/updater/ZipUtils.java

@@ -0,0 +1,72 @@
+package com.updatekit.updater;
+
+import java.io.File;
+import java.io.FileInputStream;
+import java.io.FileOutputStream;
+import java.util.zip.ZipEntry;
+import java.util.zip.ZipInputStream;
+
+final class ZipUtils {
+
+  private static final int MAX_FILES = 10_000;
+  private static final long MAX_TOTAL_SIZE = 500_000_000L; // 500MB
+
+  void extractSecurely(File zipFile, File destination) throws Exception {
+    String canonicalDestination = destination.getCanonicalPath();
+    String destinationPrefix = canonicalDestination.endsWith(File.separator)
+      ? canonicalDestination
+      : canonicalDestination + File.separator;
+
+    int fileCount = 0;
+    long totalSize = 0L;
+
+    try (ZipInputStream zis = new ZipInputStream(new FileInputStream(zipFile))) {
+      ZipEntry entry;
+      while ((entry = zis.getNextEntry()) != null) {
+        String name = entry.getName();
+        if (name.contains("..") || name.startsWith("/") || name.startsWith("\\")) {
+          throw new SecurityException("Zip path traversal attempt: " + name);
+        }
+
+        File outFile = new File(destination, name);
+        String outPath = outFile.getCanonicalPath();
+        if (!(outPath.equals(canonicalDestination) || outPath.startsWith(destinationPrefix))) {
+          throw new SecurityException("Zip entry escapes destination: " + name);
+        }
+
+        if (entry.isDirectory()) {
+          if (!outFile.exists() && !outFile.mkdirs()) {
+            throw new IllegalStateException(
+              "Cannot create directory: " + outFile.getAbsolutePath()
+            );
+          }
+          continue;
+        }
+
+        fileCount++;
+        if (fileCount > MAX_FILES) {
+          throw new SecurityException("Zip contains too many files");
+        }
+
+        File parent = outFile.getParentFile();
+        if (parent != null && !parent.exists() && !parent.mkdirs()) {
+          throw new IllegalStateException("Cannot create parent: " + parent.getAbsolutePath());
+        }
+
+        long entrySize = 0;
+        try (FileOutputStream output = new FileOutputStream(outFile)) {
+          byte[] buffer = new byte[8192];
+          int read;
+          while ((read = zis.read(buffer)) > 0) {
+            output.write(buffer, 0, read);
+            entrySize += read;
+            if (totalSize + entrySize > MAX_TOTAL_SIZE) {
+              throw new SecurityException("Zip extracted content exceeds max size");
+            }
+          }
+        }
+        totalSize += entrySize;
+      }
+    }
+  }
+}

package/dist/esm/definitions.d.ts

@@ -0,0 +1,229 @@
+import type { PluginListenerHandle } from '@capacitor/core';
+/**
+ * Bundle status enum.
+ */
+export declare enum BundleStatus {
+    /** Factory-installed bundle */
+    BUILTIN = "builtin",
+    /** Downloaded and staged, awaiting activation */
+    PENDING = "pending",
+    /** Active but not yet confirmed */
+    TRIAL = "trial",
+    /** Confirmed working */
+    SUCCESS = "success",
+    /** Failed (hash mismatch, extraction error, rollback) */
+    ERROR = "error"
+}
+export interface BundleInfo {
+    /** Unique bundle identifier */
+    id: string;
+    /** Semantic version string */
+    version: string;
+    /** Current status of the bundle */
+    status: BundleStatus;
+    /** ISO timestamp when bundle was downloaded */
+    downloadedAt?: string;
+    /** SHA-256 hash of the bundle */
+    sha256?: string;
+    /** Channel this bundle was released to (if known) */
+    channel?: string;
+    /** Release history ID associated with this bundle (if known) */
+    releaseId?: string;
+}
+export interface LatestVersion {
+    /** Version string */
+    version: string;
+    /** Download URL */
+    url: string;
+    /** SHA-256 checksum */
+    sha256: string;
+    /** Bundle size in bytes */
+    size: number;
+    /** True when this exact update is already staged locally. */
+    downloaded?: boolean;
+    /** Release history ID associated with this manifest */
+    releaseId?: string;
+    /** Minimum native build required */
+    minNativeBuild?: number;
+}
+export interface BundleListResult {
+    bundles: BundleInfo[];
+}
+export interface OtaKitState {
+    current: BundleInfo;
+    staged: BundleInfo | null;
+    builtinVersion: string;
+}
+export interface OtaKitDebugState extends OtaKitState {
+    fallback: BundleInfo;
+}
+export type OtaKitUpdateMode = 'manual' | 'next-launch' | 'immediate';
+export interface OtaKitManifestKey {
+    kid: string;
+    key: string;
+}
+/**
+ * Plugin configuration for capacitor.config.ts.
+ */
+export interface OtaKitConfig {
+    /** OtaKit app ID used for manifest and stats requests. */
+    appId: string;
+    /** Optional named release track. Omit to use the base channel. */
+    channel?: string;
+    /** Overall update behavior. Defaults to next-launch. */
+    updateMode?: OtaKitUpdateMode;
+    /** Milliseconds to wait for notifyAppReady(). Defaults to 10000. */
+    appReadyTimeout?: number;
+    /** Custom API base URL for self-hosted or custom servers. */
+    serverUrl?: string;
+    /** Custom manifest verification keys for self-hosted or custom trust. */
+    manifestKeys?: OtaKitManifestKey[];
+    /** Allow HTTP only for localhost development. Defaults to false. */
+    allowInsecureUrls?: boolean;
+}
+export interface OtaKitDebugApi {
+    /**
+     * Check the server for a newer version without downloading it.
+     * You can optionally pass { channel } for a one-off debug override.
+     */
+    check(options?: {
+        channel?: string;
+    }): Promise<LatestVersion | null>;
+    /**
+     * Check the server and download the latest bundle if available.
+     * Ensures the latest bundle is staged for later activation.
+     */
+    download(options?: {
+        channel?: string;
+    }): Promise<BundleInfo | null>;
+    /**
+     * Reset to the builtin bundle and reload the WebView.
+     *
+     * **WARNING: TERMINAL OPERATION**
+     * Code after this call may not execute. The WebView will reload.
+     */
+    reset(): Promise<void>;
+    /**
+     * List downloaded OTA bundles stored on the device.
+     */
+    listBundles(): Promise<BundleListResult>;
+    /**
+     * Delete a downloaded bundle that is not active or protected by rollback.
+     */
+    deleteBundle(options: {
+        bundleId: string;
+    }): Promise<void>;
+    /**
+     * Get the most recent failed update information for diagnostics.
+     */
+    getLastFailure(): Promise<BundleInfo | null>;
+}
+export type OtaKitEvent = 'downloadStarted' | 'downloadComplete' | 'downloadFailed' | 'updateAvailable' | 'noUpdateAvailable' | 'appReady' | 'rollback';
+export interface OtaKitPlugin {
+    /**
+     * Inspect the current updater state needed by normal app code.
+     */
+    getState(): Promise<OtaKitState>;
+    /**
+     * Check the configured channel for a newer version without downloading it.
+     * When `downloaded` is true, the latest update is already staged locally.
+     */
+    check(): Promise<LatestVersion | null>;
+    /**
+     * Check the configured channel and download the latest bundle if available.
+     * The latest bundle is staged for later activation. If it is already staged,
+     * the existing staged bundle is returned without re-downloading it.
+     */
+    download(): Promise<BundleInfo | null>;
+    /**
+     * Activate the currently staged bundle and reload the WebView.
+     *
+     * **WARNING: TERMINAL OPERATION**
+     * Code after this call may not execute. The WebView will reload.
+     */
+    apply(): Promise<void>;
+    /**
+     * Friendly manual-mode helper.
+     * Bring the app to the newest available update now.
+     * If the newest update is already staged, apply it.
+     * Otherwise download it and apply it.
+     *
+     * **WARNING: TERMINAL OPERATION**
+     * Code after this call may not execute if an update is applied.
+     */
+    update(): Promise<void>;
+    /**
+     * **CRITICAL**: Call this when your app has successfully started.
+     * Must be called within appReadyTimeout (default 10s) or rollback occurs.
+     *
+     * This confirms the current bundle is working and:
+     * - Marks the bundle as SUCCESS
+     * - Updates the fallback bundle pointer
+     * - Removes the older fallback bundle once the new bundle proves healthy
+     */
+    notifyAppReady(): Promise<void>;
+    /**
+     * Manual inspection and control methods intended for debugging and support.
+     */
+    debug: OtaKitDebugApi;
+    /**
+     * Add listener for update events
+     */
+    addListener(event: 'downloadStarted', callback: (data: {
+        version: string;
+    }) => void): Promise<PluginListenerHandle>;
+    addListener(event: 'downloadComplete', callback: (data: BundleInfo) => void): Promise<PluginListenerHandle>;
+    addListener(event: 'downloadFailed', callback: (data: {
+        version: string;
+        error: string;
+    }) => void): Promise<PluginListenerHandle>;
+    addListener(event: 'updateAvailable', callback: (data: LatestVersion) => void): Promise<PluginListenerHandle>;
+    addListener(event: 'noUpdateAvailable', callback: () => void): Promise<PluginListenerHandle>;
+    addListener(event: 'appReady', callback: (data: BundleInfo) => void): Promise<PluginListenerHandle>;
+    addListener(event: 'rollback', callback: (data: {
+        from: BundleInfo;
+        to: BundleInfo;
+        reason?: string;
+    }) => void): Promise<PluginListenerHandle>;
+    /**
+     * Remove all listeners for this plugin
+     */
+    removeAllListeners(): Promise<void>;
+}
+export interface OtaKitBridgePlugin {
+    check(): Promise<LatestVersion | null>;
+    download(): Promise<BundleInfo | null>;
+    apply(): Promise<void>;
+    notifyAppReady(): Promise<void>;
+    debugGetState(): Promise<OtaKitDebugState>;
+    debugCheck(options?: {
+        channel?: string;
+    }): Promise<LatestVersion | null>;
+    debugDownload(options?: {
+        channel?: string;
+    }): Promise<BundleInfo | null>;
+    debugReset(): Promise<void>;
+    debugListBundles(): Promise<BundleListResult>;
+    debugDeleteBundle(options: {
+        bundleId: string;
+    }): Promise<void>;
+    debugGetLastFailure(): Promise<BundleInfo | null>;
+    addListener(event: 'downloadStarted', callback: (data: {
+        version: string;
+    }) => void): Promise<PluginListenerHandle>;
+    addListener(event: 'downloadComplete', callback: (data: BundleInfo) => void): Promise<PluginListenerHandle>;
+    addListener(event: 'downloadFailed', callback: (data: {
+        version: string;
+        error: string;
+    }) => void): Promise<PluginListenerHandle>;
+    addListener(event: 'updateAvailable', callback: (data: LatestVersion) => void): Promise<PluginListenerHandle>;
+    addListener(event: 'noUpdateAvailable', callback: () => void): Promise<PluginListenerHandle>;
+    addListener(event: 'appReady', callback: (data: BundleInfo) => void): Promise<PluginListenerHandle>;
+    addListener(event: 'rollback', callback: (data: {
+        from: BundleInfo;
+        to: BundleInfo;
+        reason?: string;
+    }) => void): Promise<PluginListenerHandle>;
+    removeAllListeners(): Promise<void>;
+}
+//# sourceMappingURL=definitions.d.ts.map

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

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

package/dist/esm/definitions.js

@@ -0,0 +1,17 @@
+/**
+ * Bundle status enum.
+ */
+export var BundleStatus;
+(function (BundleStatus) {
+    /** Factory-installed bundle */
+    BundleStatus["BUILTIN"] = "builtin";
+    /** Downloaded and staged, awaiting activation */
+    BundleStatus["PENDING"] = "pending";
+    /** Active but not yet confirmed */
+    BundleStatus["TRIAL"] = "trial";
+    /** Confirmed working */
+    BundleStatus["SUCCESS"] = "success";
+    /** Failed (hash mismatch, extraction error, rollback) */
+    BundleStatus["ERROR"] = "error";
+})(BundleStatus || (BundleStatus = {}));
+//# sourceMappingURL=definitions.js.map

package/dist/esm/definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definitions.js","sourceRoot":"","sources":["../../src/definitions.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAN,IAAY,YAWX;AAXD,WAAY,YAAY;IACtB,+BAA+B;IAC/B,mCAAmB,CAAA;IACnB,iDAAiD;IACjD,mCAAmB,CAAA;IACnB,mCAAmC;IACnC,+BAAe,CAAA;IACf,wBAAwB;IACxB,mCAAmB,CAAA;IACnB,yDAAyD;IACzD,+BAAe,CAAA;AACjB,CAAC,EAXW,YAAY,KAAZ,YAAY,QAWvB"}

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+import type { OtaKitPlugin } from './definitions';
+declare const OtaKit: OtaKitPlugin;
+export * from './definitions';
+export { OtaKit };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,YAAY,EAKb,MAAM,eAAe,CAAC;AA6EvB,QAAA,MAAM,MAAM,EAAE,YAoBb,CAAC;AAEF,cAAc,eAAe,CAAC;AAC9B,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,85 @@
+import { registerPlugin } from '@capacitor/core';
+const NativeOtaKit = registerPlugin('OtaKit', {
+    web: () => import('./web').then((m) => new m.OtaKitWeb()),
+});
+/**
+ * Check if result is an empty object (iOS returns {} instead of null)
+ */
+function isEmptyObject(obj) {
+    return obj !== null && typeof obj === 'object' && Object.keys(obj).length === 0;
+}
+/**
+ * Wrapped plugin that normalizes null returns from native code.
+ * iOS call.resolve() without arguments returns {} instead of null.
+ */
+function normalizeNullable(value) {
+    return isEmptyObject(value) ? null : value;
+}
+function toPublicState(value) {
+    return {
+        current: value.current,
+        staged: value.staged,
+        builtinVersion: value.builtinVersion,
+    };
+}
+async function getState() {
+    return toPublicState(await NativeOtaKit.debugGetState());
+}
+async function check() {
+    return normalizeNullable(await NativeOtaKit.check());
+}
+async function download() {
+    return normalizeNullable(await NativeOtaKit.download());
+}
+function apply() {
+    return NativeOtaKit.apply();
+}
+async function update() {
+    const state = await getState();
+    let latest;
+    try {
+        latest = await check();
+    }
+    catch (error) {
+        if (state.staged) {
+            await apply();
+            return;
+        }
+        throw error;
+    }
+    if (latest) {
+        if (latest.downloaded) {
+            await apply();
+            return;
+        }
+        const bundle = await download();
+        if (bundle) {
+            await apply();
+        }
+        return;
+    }
+    if (state.staged) {
+        await apply();
+    }
+}
+const OtaKit = {
+    getState,
+    check,
+    download,
+    apply,
+    update,
+    notifyAppReady: () => NativeOtaKit.notifyAppReady(),
+    debug: {
+        check: async (options) => normalizeNullable(await NativeOtaKit.debugCheck(options)),
+        download: async (options) => normalizeNullable(await NativeOtaKit.debugDownload(options)),
+        reset: () => NativeOtaKit.debugReset(),
+        listBundles: () => NativeOtaKit.debugListBundles(),
+        deleteBundle: (options) => NativeOtaKit.debugDeleteBundle(options),
+        getLastFailure: async () => normalizeNullable(await NativeOtaKit.debugGetLastFailure()),
+    },
+    addListener: NativeOtaKit.addListener.bind(NativeOtaKit),
+    removeAllListeners: () => NativeOtaKit.removeAllListeners(),
+};
+export * from './definitions';
+export { OtaKit };
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

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

package/dist/esm/web.d.ts

@@ -0,0 +1,25 @@
+import { WebPlugin } from '@capacitor/core';
+import type { OtaKitBridgePlugin, BundleInfo, BundleListResult, LatestVersion, OtaKitDebugState } from './definitions';
+/**
+ * Web implementation of the native bridge.
+ * Most methods are no-ops since OTA updates don't apply to web
+ */
+export declare class OtaKitWeb extends WebPlugin implements OtaKitBridgePlugin {
+    private readonly BUILTIN_BUNDLE;
+    debugGetState(): Promise<OtaKitDebugState>;
+    check(): Promise<LatestVersion | null>;
+    download(): Promise<BundleInfo | null>;
+    apply(): Promise<void>;
+    debugCheck(): Promise<LatestVersion | null>;
+    debugDownload(_options?: {
+        channel?: string;
+    }): Promise<BundleInfo | null>;
+    notifyAppReady(): Promise<void>;
+    debugReset(): Promise<void>;
+    debugListBundles(): Promise<BundleListResult>;
+    debugDeleteBundle(_options: {
+        bundleId: string;
+    }): Promise<void>;
+    debugGetLastFailure(): Promise<BundleInfo | null>;
+}
+//# sourceMappingURL=web.d.ts.map

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

@@ -0,0 +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,EACV,gBAAgB,EAChB,aAAa,EAEb,gBAAgB,EACjB,MAAM,eAAe,CAAC;AAEvB;;;GAGG;AACH,qBAAa,SAAU,SAAQ,SAAU,YAAW,kBAAkB;IACpE,OAAO,CAAC,QAAQ,CAAC,cAAc,CAI7B;IAEI,aAAa,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAS1C,KAAK,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAKtC,QAAQ,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAKtC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAKtB,UAAU,IAAI,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAK3C,aAAa,CAAC,QAAQ,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAK1E,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI/B,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,gBAAgB,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAI7C,iBAAiB,CAAC,QAAQ,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE,mBAAmB,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;CAGxD"}

package/dist/esm/web.js

@@ -0,0 +1,56 @@
+import { WebPlugin } from '@capacitor/core';
+/**
+ * Web implementation of the native bridge.
+ * Most methods are no-ops since OTA updates don't apply to web
+ */
+export class OtaKitWeb extends WebPlugin {
+    BUILTIN_BUNDLE = {
+        id: 'builtin',
+        version: '0.0.0',
+        status: 'builtin',
+    };
+    async debugGetState() {
+        return {
+            current: this.BUILTIN_BUNDLE,
+            fallback: this.BUILTIN_BUNDLE,
+            staged: null,
+            builtinVersion: this.BUILTIN_BUNDLE.version,
+        };
+    }
+    async check() {
+        console.warn('OtaKit.check() is not supported on web');
+        return null;
+    }
+    async download() {
+        console.warn('OtaKit.download() is not supported on web');
+        return null;
+    }
+    async apply() {
+        console.warn('OtaKit.apply() is not supported on web');
+        throw new Error('OtaKit.apply() is not supported on web');
+    }
+    async debugCheck() {
+        console.warn('OtaKit.debug.check() is not supported on web');
+        return null;
+    }
+    async debugDownload(_options) {
+        console.warn('OtaKit.debug.download() is not supported on web');
+        return null;
+    }
+    async notifyAppReady() {
+        // No-op on web, but don't warn - apps should call this unconditionally
+    }
+    async debugReset() {
+        console.warn('OtaKit.debug.reset() is not supported on web');
+    }
+    async debugListBundles() {
+        return { bundles: [] };
+    }
+    async debugDeleteBundle(_options) {
+        console.warn('OtaKit.debug.deleteBundle() is not supported on web');
+    }
+    async debugGetLastFailure() {
+        return null;
+    }
+}
+//# sourceMappingURL=web.js.map

package/dist/esm/web.js.map

@@ -0,0 +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,aAAa;QACjB,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,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,OAAO,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC;IACd,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,UAAU;QACd,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,QAA+B;QACjD,OAAO,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;QAChE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,cAAc;QAClB,uEAAuE;IACzE,CAAC;IAED,KAAK,CAAC,UAAU;QACd,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;IAC/D,CAAC;IAED,KAAK,CAAC,gBAAgB;QACpB,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,QAA8B;QACpD,OAAO,CAAC,IAAI,CAAC,qDAAqD,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,mBAAmB;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}