@hot-updater/react-native 1.0.0-rc.16 → 1.0.0-rc.17

package/lib/typescript/commonjs/plugins/insights/sender.d.ts

@@ -0,0 +1,74 @@
+import type { HotUpdaterClientContext } from "../../clientPlugin";
+export type InsightsEventType = "UNCHANGED" | "UPDATE_DOWNLOADED" | "UPDATE_APPLIED" | "RECOVERED" | "UPDATE_FAILED";
+/** A `POST /events` body. */
+export interface InsightsEventBody {
+    readonly eventId: string;
+    readonly type: InsightsEventType;
+    readonly installId: string;
+    readonly userId?: string;
+    readonly platform: "ios" | "android";
+    readonly appVersion: string;
+    readonly channel: string;
+    readonly cohort: string;
+    readonly fingerprintHash: string | null;
+    readonly sdkVersion: string;
+    readonly fromBundleId: string | null;
+    readonly fromReleaseId: string | null;
+    readonly toBundleId: string;
+    readonly toReleaseId: string | null;
+    readonly updateStrategy: "fingerprint" | "appVersion" | null;
+    readonly metadata?: InsightsEventMetadata;
+}
+/** Details beside an event's fields, by event type. */
+export interface InsightsEventMetadata {
+    /** UPDATE_FAILED: where and why the update failed. */
+    readonly failure?: {
+        readonly stage: "check" | "download" | "install";
+        readonly reason: string;
+        readonly resource?: string;
+        readonly httpStatus?: number;
+        readonly transport?: string;
+        readonly originCode?: string;
+        readonly previousProcessExit?: string;
+    };
+    /** UPDATE_DOWNLOADED: how the bundle arrived. */
+    readonly delivery?: "patch" | "manifest" | "archive";
+    /** UPDATE_DOWNLOADED: a patch was tried, but a file or the archive came instead. */
+    readonly patchFallback?: true;
+    /** RECOVERED: why the previous main process exited, on Android 11+. */
+    readonly previousProcessExit?: string;
+}
+/** How the server answered one event. */
+export type InsightsDelivery = 
+/** The server stored the event, or already had it under its id. */
+"delivered"
+/** The server runs without Insights: a 404, since it mounts no `/events`. */
+ | "disabled"
+/** A 400 for an `UPDATE_FAILED` event, from a server that does not know it. */
+ | "refused"
+/** No attempt got an answer the SDK accepts. */
+ | "failed";
+export interface InsightsEventGate {
+    /**
+     * Whether to send the event now. It is asked before every attempt, so an
+     * event superseded while it waits out a backoff is dropped.
+     */
+    admit(event: InsightsEventBody): boolean;
+    /** Records how an admitted event ended, once per event. */
+    settle(event: InsightsEventBody, delivery: InsightsDelivery): void;
+}
+export type InsightsEventSender = (event: InsightsEventBody) => Promise<void>;
+/**
+ * Sends Insights events one at a time and retries each in the background.
+ *
+ * The server keeps an installation's latest report by arrival, so a later
+ * event waits behind an earlier one's retries; otherwise a retried
+ * UPDATE_APPLIED could land after the UPDATE_DOWNLOADED that followed it.
+ * Callers wait only for first attempts, so a report never waits out a
+ * backoff: once an event backs off, every waiting caller is released, and a
+ * failure after that only warns. The gate sees each event before each
+ * attempt, after every earlier event settled, so it decides with what the
+ * server already answered.
+ */
+export declare const createInsightsEventSender: (fetch: HotUpdaterClientContext["fetch"], gate: InsightsEventGate) => InsightsEventSender;
+//# sourceMappingURL=sender.d.ts.map

package/lib/typescript/commonjs/plugins/insights/sender.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sender.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/insights/sender.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,MAAM,MAAM,iBAAiB,GACzB,WAAW,GACX,mBAAmB,GACnB,gBAAgB,GAChB,WAAW,GACX,eAAe,CAAC;AAEpB,6BAA6B;AAC7B,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,aAAa,GAAG,YAAY,GAAG,IAAI,CAAC;IAC7D,QAAQ,CAAC,QAAQ,CAAC,EAAE,qBAAqB,CAAC;CAC3C;AAED,uDAAuD;AACvD,MAAM,WAAW,qBAAqB;IACpC,sDAAsD;IACtD,QAAQ,CAAC,OAAO,CAAC,EAAE;QACjB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;QACjD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;KACvC,CAAC;IACF,iDAAiD;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,SAAS,CAAC;IACrD,oFAAoF;IACpF,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC;IAC9B,uEAAuE;IACvE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,yCAAyC;AACzC,MAAM,MAAM,gBAAgB;AAC1B,mEAAmE;AACjE,WAAW;AACb,6EAA6E;GAC3E,UAAU;AACZ,+EAA+E;GAC7E,SAAS;AACX,gDAAgD;GAC9C,QAAQ,CAAC;AAEb,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,KAAK,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC;IACzC,2DAA2D;IAC3D,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI,CAAC;CACpE;AA8ED,MAAM,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE9E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,yBAAyB,UAC7B,uBAAuB,CAAC,OAAO,CAAC,QACjC,iBAAiB,KACtB,mBAyDF,CAAC"}

package/lib/typescript/commonjs/plugins/insights/state.d.ts

@@ -0,0 +1,46 @@
+import type { HotUpdaterClientStorage } from "../../clientPlugin";
+/** The UTC day of a time, as `YYYY-MM-DD`. */
+export declare const utcDay: (time: number) => string;
+/** The start of a time's UTC day, in milliseconds. */
+export declare const utcDayStart: (time: number) => number;
+/** What a report says runs: the fields the server compares to skip a same-day launch. */
+export interface RunningReport {
+    readonly day: string;
+    readonly channel: string;
+    readonly appVersion: string;
+    readonly bundleId: string;
+    readonly releaseId: string | null;
+    readonly userId: string | null;
+}
+/**
+ * The Insights plugin's memory across launches, in its plugin storage. Every
+ * read tolerates a missing or unreadable value, and a storage failure only
+ * costs a report that would otherwise have been skipped.
+ */
+export declare const createInsightsState: (storage: HotUpdaterClientStorage) => {
+    /**
+     * Whether reporting pauses: the server answered that Insights is off
+     * during this runtime or in the 24 hours before `now`. A pause that
+     * starts after `now`, from a clock that went back, has ended.
+     */
+    isPaused(now: number): boolean;
+    pause(now: number): void;
+    /** The server stored a report, so Insights is on. */
+    resume(): void;
+    /** Whether a launch report repeats what the installation reported that day. */
+    repeatsReport(report: RunningReport): boolean;
+    /** Records a delivered report that says what runs. */
+    recordReport(report: RunningReport): void;
+    /**
+     * Forgets the last report after a delivered download or failure, so the
+     * next launch reports again, as the server records it after one.
+     */
+    forgetReport(): void;
+    /** Whether a failure was already reported, or refused, that day. */
+    hasFailure(day: string, key: string): boolean;
+    recordFailure(day: string, key: string): void;
+    readUserId(): string | null;
+    writeUserId(userId: string | null): void;
+};
+export type InsightsState = ReturnType<typeof createInsightsState>;
+//# sourceMappingURL=state.d.ts.map

package/lib/typescript/commonjs/plugins/insights/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../../../src/plugins/insights/state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAMlE,8CAA8C;AAC9C,eAAO,MAAM,MAAM,SAAU,MAAM,KAAG,MACK,CAAC;AAE5C,sDAAsD;AACtD,eAAO,MAAM,WAAW,SAAU,MAAM,KAAG,MACP,CAAC;AAErC,yFAAyF;AACzF,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAgED;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,YAAa,uBAAuB;IAoBhE;;;;OAIG;IACH,QAAQ,MAAM,MAAM,GAAG,OAAO;IAU9B,KAAK,MAAM,MAAM;IAIjB,qDAAqD;IACrD,MAAM;IAIN,+EAA+E;IAC/E,aAAa,SAAS,aAAa,GAAG,OAAO;IAI7C,sDAAsD;IACtD,YAAY,SAAS,aAAa;IAGlC;;;OAGG;IACH,YAAY;IAIZ,oEAAoE;IACpE,UAAU,MAAM,MAAM,OAAO,MAAM,GAAG,OAAO;IAI7C,aAAa,MAAM,MAAM,OAAO,MAAM;IAUtC,UAAU,IAAI,MAAM,GAAG,IAAI;IAU3B,WAAW,SAAS,MAAM,GAAG,IAAI;CAIpC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/lib/typescript/commonjs/releaseCatalogCache.d.ts

@@ -20,6 +20,10 @@ type FetchReleaseCatalogInput = {
 };
 export declare const hasExpectedReleaseCatalogScope: (catalog: ReleaseCatalog, expected: ExpectedReleaseCatalogScope) => boolean;
 export declare const createReleaseCatalogCachePartition: (input: Pick<FetchReleaseCatalogInput, "baseURL" | "requestHeaders" | "url">) => string;
-export declare const fetchReleaseCatalogWithCache: (input: FetchReleaseCatalogInput) => Promise<ReleaseCatalog>;
+/**
+ * Fetches a scope's catalog, or null when the server answers that the scope
+ * has none (a 404 with `x-hot-updater-catalog: none`).
+ */
+export declare const fetchReleaseCatalogWithCache: (input: FetchReleaseCatalogInput) => Promise<ReleaseCatalog | null>;
 export {};
 //# sourceMappingURL=releaseCatalogCache.d.ts.map

package/lib/typescript/commonjs/releaseCatalogCache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"releaseCatalogCache.d.ts","sourceRoot":"","sources":["../../../src/releaseCatalogCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAI3B,eAAO,MAAM,8BAA8B,QACA,CAAC;AAC5C,eAAO,MAAM,qCAAqC,QACG,CAAC;AAiCtD,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;CACtC,GAAG,CACA;IACE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC;CAClC,GACD;IACE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC,CACJ,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,2BAA2B,CAAC;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAiDF,eAAO,MAAM,8BAA8B,YAChC,cAAc,YACb,2BAA2B,KACpC,OAcF,CAAC;AAkGF,eAAO,MAAM,kCAAkC,UACtC,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,gBAAgB,GAAG,KAAK,CAAC,KAC1E,MAMC,CAAC;AAqFL,eAAO,MAAM,4BAA4B,UAChC,wBAAwB,KAC9B,OAAO,CAAC,cAAc,CAaxB,CAAC"}
+{"version":3,"file":"releaseCatalogCache.d.ts","sourceRoot":"","sources":["../../../src/releaseCatalogCache.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAM3B,eAAO,MAAM,8BAA8B,QACA,CAAC;AAC5C,eAAO,MAAM,qCAAqC,QACG,CAAC;AAiCtD,MAAM,MAAM,2BAA2B,GAAG;IACxC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;CACtC,GAAG,CACA;IACE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,CAAC;CAClC,GACD;IACE,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC,CACJ,CAAC;AAEF,KAAK,wBAAwB,GAAG;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,2BAA2B,CAAC;IACpD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB,CAAC;AAiDF,eAAO,MAAM,8BAA8B,YAChC,cAAc,YACb,2BAA2B,KACpC,OAcF,CAAC;AAkGF,eAAO,MAAM,kCAAkC,UACtC,IAAI,CAAC,wBAAwB,EAAE,SAAS,GAAG,gBAAgB,GAAG,KAAK,CAAC,KAC1E,MAMC,CAAC;AA8FL;;;GAGG;AACH,eAAO,MAAM,4BAA4B,UAChC,wBAAwB,KAC9B,OAAO,CAAC,cAAc,GAAG,IAAI,CAa/B,CAAC"}

package/lib/typescript/commonjs/sdkVersion.d.ts

@@ -1,2 +1,2 @@
-export declare const HOT_UPDATER_SDK_VERSION = "1.0.0-rc.16";
+export declare const HOT_UPDATER_SDK_VERSION = "1.0.0-rc.17";
 //# sourceMappingURL=sdkVersion.d.ts.map

package/lib/typescript/commonjs/specs/NativeHotUpdater.d.ts

@@ -30,7 +30,11 @@ export interface Spec extends TurboModule {
      * Downloads and applies a bundle update.
      *
      * @param params - Update bundle parameters
-     * @returns Promise that resolves to true if successful
+     * @returns Promise that resolves, once the bundle is staged, to how it
+     *   arrived: `{ delivery, patchFallback }`. `delivery` is "patch" when a
+     *   bsdiff patch produced a file, "manifest" when only changed files were
+     *   downloaded, or "archive" for the full archive; `patchFallback` is true
+     *   when a patch was tried but the file or archive was downloaded instead.
      * @throws {HotUpdaterErrorCode} Rejects with one of the following error codes:
      *
      *   Parameter validation:
@@ -55,8 +59,20 @@ export interface Spec extends TurboModule {
      *
      *   Note: iOS normalizes rare signature/storage errors to SIGNATURE_VERIFICATION_FAILED
      *   or UNKNOWN_ERROR to keep the JS error surface small.
-     */
-    updateBundle(params: UpdateBundleParams): Promise<boolean>;
+     *
+     *   A rejection from the download or install also carries `userInfo`
+     *   `{ stage, reason, resource?, httpStatus?, transport?, originCode? }`:
+     *   `stage` is "download" (transfer and verification) or "install" (patch,
+     *   extract, move into place); `reason` is one of "network", "http",
+     *   "invalid_response", "hash_mismatch", "signature", "patch", "extract",
+     *   "storage", or "unknown"; `resource` is what was being fetched or
+     *   applied: "manifest", "file", "patch", or "archive". `httpStatus` is
+     *   present when `reason` is "http", with `originCode`, the storage
+     *   origin's XML error `<Code>` when the body names one. `transport` is
+     *   present when no response arrived: "timeout", "dns", "tls",
+     *   "connection", "offline", or "cancelled".
+     */
+    updateBundle(params: UpdateBundleParams): Promise<UnsafeObject>;
     /** Accepts and durably advances the catalog high-water for a scope. */
     acceptReleaseCatalog(params: UnsafeObject): boolean;
     /** Reads active/stable selection receipts and catalog high-water state. */
@@ -86,6 +102,13 @@ export interface Spec extends TurboModule {
         toBundleId?: string;
         updateStrategy?: "fingerprint" | "appVersion";
         crashedBundleId?: string;
+        /**
+         * Android 11+: why the app's previous main process exited, the
+         * `ApplicationExitInfo` reason without its `REASON_` prefix (for
+         * example "CRASH", "ANR", "LOW_MEMORY", "USER_REQUESTED"), read once
+         * when the process starts. Absent on iOS and older Android.
+         */
+        previousProcessExit?: string;
     };
     /**
      * Gets the list of bundle IDs that have been marked as crashed.
@@ -143,21 +166,20 @@ export interface Spec extends TurboModule {
      */
     getCohort: () => string;
     /**
-     * Gets the persisted install id for this app installation.
+     * Gets the install id: a random id native creates once per app
+     * installation and keeps out of device backups.
      */
     getInstallId: () => string;
     /**
-     * Gets the persisted nullable user id associated with this installation.
-     */
-    getUserId: () => string | null;
-    /**
-     * Gets the persisted nullable username associated with this installation.
+     * Reads a value from the SDK's persistent key-value store, which native
+     * keeps out of device backups. Returns null when the key has no value.
      */
-    getUsername: () => string | null;
+    getStorageItem: (key: string) => string | null;
     /**
-     * Persists nullable user identity fields associated with this installation.
+     * Writes a value to the SDK's persistent key-value store; null removes the
+     * key.
      */
-    setUser: (userId: string | null, username: string | null) => void;
+    setStorageItem: (key: string, value: string | null) => void;
     addListener(eventName: string): void;
     removeListeners(count: number): void;
     readonly getConstants: () => {

package/lib/typescript/commonjs/specs/NativeHotUpdater.d.ts.map

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

package/lib/typescript/commonjs/updateError.d.ts

@@ -0,0 +1,26 @@
+import type { UpdateError, UpdateErrorResource, UpdateErrorStage } from "./clientPlugin";
+import { HotUpdaterError } from "./error";
+/**
+ * A response the SDK cannot use: a malformed or stale catalog, an artifact
+ * in another protocol, or an invalid URL.
+ */
+export declare class InvalidUpdateResponseError extends HotUpdaterError {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** A request the server answered with a status the SDK does not accept. */
+export declare class UpdateHttpError extends HotUpdaterError {
+    readonly status: number;
+    constructor(status: number, statusText: string);
+}
+type Classification = Pick<UpdateError, "stage" | "reason" | "resource" | "httpStatus" | "originCode" | "transport">;
+/**
+ * Where and why an update failed, or null when the error is not an update
+ * failure. Native rejections carry their own classification; an error the
+ * SDK's JavaScript raised happened in `stage`, fetching `resource` when one
+ * is given.
+ */
+export declare const classifyUpdateError: (error: unknown, stage: UpdateErrorStage, resource?: UpdateErrorResource) => Classification | null;
+export {};
+//# sourceMappingURL=updateError.d.ts.map

package/lib/typescript/commonjs/updateError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"updateError.d.ts","sourceRoot":"","sources":["../../../src/updateError.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EAEX,mBAAmB,EACnB,gBAAgB,EAEjB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1C;;;GAGG;AACH,qBAAa,0BAA2B,SAAQ,eAAe;IAC7D,YAAY,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,EAIzD;CACF;AAED,2EAA2E;AAC3E,qBAAa,eAAgB,SAAQ,eAAe;IAEhD,QAAQ,CAAC,MAAM,EAAE,MAAM;IADzB,YACW,MAAM,EAAE,MAAM,EACvB,UAAU,EAAE,MAAM,EAMnB;CACF;AAiCD,KAAK,cAAc,GAAG,IAAI,CACxB,WAAW,EACX,OAAO,GAAG,QAAQ,GAAG,UAAU,GAAG,YAAY,GAAG,YAAY,GAAG,WAAW,CAC5E,CAAC;AAsCF;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,UACvB,OAAO,SACP,gBAAgB,aACZ,mBAAmB,KAC7B,cAAc,GAAG,IAoCnB,CAAC"}

package/lib/typescript/commonjs/wrap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../../src/wrap.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAOnD,OAAO,KAAK,EACV,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,iBAAiB,EACjB,gCAAgC,EAChC,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAEtB,wBAAgB,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAEvD;AAED,wBAAgB,IAAI,CAClB,OAAO,EAAE,mBAAmB,GAC3B,CAAC,CAAC,SAAS,MAAM,EAClB,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KACrC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAuH1B"}
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../../src/wrap.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAOnD,OAAO,KAAK,EAEV,mBAAmB,EACnB,mBAAmB,EAEpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,iBAAiB,EACjB,gCAAgC,EAChC,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAEtB,wBAAgB,IAAI,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAEvD;AAED,wBAAgB,IAAI,CAClB,OAAO,EAAE,mBAAmB,GAC3B,CAAC,CAAC,SAAS,MAAM,EAClB,gBAAgB,EAAE,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KACrC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAqJ1B"}

package/lib/typescript/commonjs/wrap.types.d.ts

@@ -1,4 +1,5 @@
 import type React from "react";
+import type { HotUpdaterClientPlugin } from "./clientPlugin";
 import type { HotUpdaterError } from "./error";
 import type { HotUpdaterHttpClient } from "./httpClient";
 import type { NotifyAppReadyResult } from "./native";
@@ -20,15 +21,12 @@ export type HotUpdaterFallbackComponentProps = {
 };
 interface CommonHotUpdaterOptions {
     /**
-     * Sends app-ready transitions and same-Bundle Release adoptions to the
-     * configured server. Defaults to `true`; set to `false` to disable client
-     * reporting. Debug builds (`__DEV__`) send nothing unless you pass
-     * `{ debug: true }`, so development sessions stay out of production data.
+     * Client plugins, such as `insights()` from
+     * `@hot-updater/react-native/plugins/insights`. Each plugin's `setup` runs
+     * once, and its hooks observe launches, update checks, downloads, and
+     * update failures. Plugin ids must be unique.
      */
-    insights?: boolean | {
-        /** Also report from debug builds. Defaults to `false`. */
-        debug?: boolean;
-    };
+    plugins?: readonly HotUpdaterClientPlugin[];
     /** Base URL of a server exposing the Hot Updater v1 client HTTP protocol. */
     baseURL: HotUpdaterBaseURL;
     requestHeaders?: Record<string, string>;
@@ -46,8 +44,6 @@ export type AutoUpdateOptions = CommonHotUpdaterOptions & {
 export type HotUpdaterInitOptions = CommonHotUpdaterOptions;
 export type HotUpdaterOptions = AutoUpdateOptions;
 type InternalCommonOptions = {
-    /** Whether this runtime reports, with the debug-build default applied. */
-    insights?: boolean;
     client: HotUpdaterHttpClient;
     requestHeaders?: Record<string, string>;
     requestTimeout?: number;

package/lib/typescript/commonjs/wrap.types.d.ts.map

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

package/lib/typescript/module/appReady.d.ts

@@ -0,0 +1,23 @@
+import type { HotUpdaterError } from "./error";
+import { type NotifyAppReadyResult } from "./native";
+import { emitPluginHook } from "./pluginHost";
+export type NotifyAppReadyOptions = {
+    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
+    onError?: (error: HotUpdaterError | Error | unknown) => void;
+};
+/** Android 11+: why the app's previous main process exited, once the launch was read. */
+export declare const getPreviousProcessExit: () => string | null;
+/**
+ * The Release the running bundle was selected as: the active or stable
+ * selection that names it on the current channel.
+ */
+export declare const getRunningReleaseId: (bundleId: string, channel: string) => string | null;
+/** Reads this runtime's launch once native finalizes it and reports it to plugins. */
+export declare const handleNotifyAppReady: (options: NotifyAppReadyOptions) => Promise<NotifyAppReadyResult | undefined>;
+/**
+ * Calls a plugin hook after this runtime's `onAppReady`, so plugins see the
+ * launch before anything that followed it. The event is built now, from the
+ * state it describes, and only when a plugin listens.
+ */
+export declare const emitAfterAppReady: typeof emitPluginHook;
+//# sourceMappingURL=appReady.d.ts.map

package/lib/typescript/module/appReady.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appReady.d.ts","sourceRoot":"","sources":["../../../src/appReady.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,EAKL,KAAK,oBAAoB,EAE1B,MAAM,UAAU,CAAC;AAClB,OAAO,EAGL,cAAc,EACf,MAAM,cAAc,CAAC;AAEtB,MAAM,MAAM,qBAAqB,GAAG;IAClC,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC1D,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,eAAe,GAAG,KAAK,GAAG,OAAO,KAAK,IAAI,CAAC;CAC9D,CAAC;AAUF,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,QAAO,MAAM,GAAG,IAA2B,CAAC;AAkB/E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aACpB,MAAM,WACP,MAAM,KACd,MAAM,GAAG,IAQX,CAAC;AA4DF,sFAAsF;AACtF,eAAO,MAAM,oBAAoB,YACtB,qBAAqB,KAC7B,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAI1C,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,OAAO,cAWtC,CAAC"}

package/lib/typescript/module/appReady.test-utils.d.ts

@@ -0,0 +1,9 @@
+import type { LaunchTransition, NotifyAppReadyResult } from "./native";
+export declare const createNotifyReadResult: (result?: NotifyAppReadyResult, transition?: LaunchTransition | null, pending?: boolean, previousProcessExit?: string | null) => {
+    transition: LaunchTransition | null;
+    previousProcessExit: string | null;
+    pending: boolean;
+    result: NotifyAppReadyResult;
+};
+export declare const stubNotifyFrame: () => void;
+//# sourceMappingURL=appReady.test-utils.d.ts.map

package/lib/typescript/module/appReady.test-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"appReady.test-utils.d.ts","sourceRoot":"","sources":["../../../src/appReady.test-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAEvE,eAAO,MAAM,sBAAsB,YACzB,oBAAoB,eAChB,gBAAgB,GAAG,IAAI,2CAEd,MAAM,GAAG,IAAI,KACjC;IACD,UAAU,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACpC,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,oBAAoB,CAAC;CAM7B,CAAC;AAEH,eAAO,MAAM,eAAe,YAS3B,CAAC"}

package/lib/typescript/module/baseURL.d.ts

@@ -0,0 +1,4 @@
+import type { HotUpdaterBaseURL } from "./types";
+/** Resolves a functional baseURL and drops trailing slashes. */
+export declare const resolveBaseURL: (baseURL: HotUpdaterBaseURL) => Promise<string>;
+//# sourceMappingURL=baseURL.d.ts.map

package/lib/typescript/module/baseURL.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baseURL.d.ts","sourceRoot":"","sources":["../../../src/baseURL.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,gEAAgE;AAChE,eAAO,MAAM,cAAc,YAChB,iBAAiB,KACzB,OAAO,CAAC,MAAM,CAShB,CAAC"}

package/lib/typescript/module/checkForUpdate.d.ts

@@ -1,4 +1,6 @@
+import type { ReleaseTransitionKind, UpdateErrorResource, UpdateErrorStage } from "./clientPlugin";
 import type { HotUpdaterHttpClient } from "./httpClient";
+export type { ReleaseTransitionKind };
 export interface CheckForUpdateOptions {
     /**
      * Update strategy
@@ -35,10 +37,21 @@ export type CheckForUpdateResult = {
      */
     updateBundle: () => Promise<boolean>;
 };
-export type ReleaseTransitionKind = "INSTALL" | "ADOPT_RELEASE" | "USE_EMBEDDED" | "USE_BUILTIN";
 export interface InternalCheckForUpdateOptions extends CheckForUpdateOptions {
-    insights?: boolean;
     client: HotUpdaterHttpClient;
 }
+/** The running bundle, the channel checked, and the update's target. */
+type UpdateErrorScope = {
+    readonly channel: string;
+    readonly bundleId: string;
+    readonly updateStrategy: "fingerprint" | "appVersion";
+    readonly targetBundleId?: string;
+    readonly targetReleaseId?: string | null;
+};
+/**
+ * Tells plugins why an update failed, when it failed as an update. An error
+ * the SDK's JavaScript raised happened in `stage`, fetching `resource`.
+ */
+export declare const reportUpdateError: (error: unknown, stage: UpdateErrorStage, resource: UpdateErrorResource | undefined, scope: UpdateErrorScope) => void;
 export declare function checkForUpdate(options: InternalCheckForUpdateOptions): Promise<CheckForUpdateResult | null>;
 //# sourceMappingURL=checkForUpdate.d.ts.map

package/lib/typescript/module/checkForUpdate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"checkForUpdate.d.ts","sourceRoot":"","sources":["../../../src/checkForUpdate.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,oBAAoB,EAAyB,MAAM,cAAc,CAAC;AA0BhF,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,cAAc,EAAE,YAAY,GAAG,aAAa,CAAC;IAE7C;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD;;;OAGG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAC7B,SAAS,GACT,eAAe,GACf,cAAc,GACd,aAAa,CAAC;AAElB,MAAM,WAAW,6BAA8B,SAAQ,qBAAqB;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAqUD,wBAAsB,cAAc,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAyDtC"}
+{"version":3,"file":"checkForUpdate.d.ts","sourceRoot":"","sources":["../../../src/checkForUpdate.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAwBzD,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,cAAc,EAAE,YAAY,GAAG,aAAa,CAAC;IAE7C;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD;;;OAGG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC,CAAC;AAEF,MAAM,WAAW,6BAA8B,SAAQ,qBAAqB;IAC1E,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AAyCD,wEAAwE;AACxE,KAAK,gBAAgB,GAAG;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,cAAc,EAAE,aAAa,GAAG,YAAY,CAAC;IACtD,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,UACrB,OAAO,SACP,gBAAgB,YACb,mBAAmB,GAAG,SAAS,SAClC,gBAAgB,KACtB,IAqBF,CAAC;AAuRF,wBAAsB,cAAc,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA2EtC"}

package/lib/typescript/module/clientPlugin.d.ts

@@ -0,0 +1,185 @@
+/**
+ * The client plugin contract. Built-in plugins, such as
+ * `@hot-updater/react-native/plugins/insights`, and third-party plugins use
+ * the same one, as server plugins do.
+ */
+export type UpdateStrategy = "fingerprint" | "appVersion";
+/** How an update moves the app's selection. */
+export type ReleaseTransitionKind = "INSTALL" | "ADOPT_RELEASE" | "USE_EMBEDDED" | "USE_BUILTIN";
+/** The launch outcome native reports once per JavaScript runtime. */
+export type AppReadyResult = ({
+    /** No update was applied or recovered at this launch. */
+    readonly status: "UNCHANGED";
+    readonly channel: string;
+    /** The running bundle. */
+    readonly bundleId: string;
+    /** The Release the running bundle was selected as, when known. */
+    readonly releaseId: string | null;
+} | {
+    /**
+     * `UPDATE_APPLIED`: a staged update became active at this launch.
+     * `RECOVERED`: a failed update was rolled back to `toBundleId`.
+     */
+    readonly status: "UPDATE_APPLIED" | "RECOVERED";
+    readonly channel: string;
+    readonly fromBundleId: string;
+    readonly fromReleaseId: string | null;
+    readonly toBundleId: string;
+    readonly toReleaseId: string | null;
+    readonly updateStrategy: UpdateStrategy;
+}) & {
+    /**
+     * Android 11+: why the app's previous main process exited, the
+     * `ApplicationExitInfo` reason without its `REASON_` prefix, such as
+     * `CRASH`, `ANR`, `LOW_MEMORY`, or `USER_REQUESTED`. Null on iOS and on
+     * older Android. It tells a crash from the system or the user closing the
+     * app.
+     */
+    readonly previousProcessExit: string | null;
+};
+/** What an update check found. */
+export type UpdateCheckResult = {
+    /**
+     * The app keeps running its bundle: the check found nothing to
+     * install, or the app adopted a newer Release of the running bundle.
+     */
+    readonly status: "UNCHANGED";
+    readonly channel: string;
+    readonly bundleId: string;
+    /** The Release the running bundle is selected as after the check. */
+    readonly releaseId: string | null;
+    /** The Release before the check; it differs after an adoption. */
+    readonly previousReleaseId: string | null;
+} | {
+    /** The check found a Release to install, adopt, or roll back to. */
+    readonly status: "UPDATE_AVAILABLE";
+    readonly channel: string;
+    readonly fromBundleId: string;
+    readonly fromReleaseId: string | null;
+    readonly toBundleId: string;
+    readonly toReleaseId: string | null;
+    readonly transitionKind: ReleaseTransitionKind;
+    readonly updateStatus: "UPDATE" | "ROLLBACK";
+    readonly shouldForceUpdate: boolean;
+    readonly updateStrategy: UpdateStrategy;
+};
+/** A bundle the SDK downloaded, verified, and staged for the next launch. */
+export interface BundleDownloadedInfo {
+    readonly channel: string;
+    readonly fromBundleId: string;
+    readonly fromReleaseId: string | null;
+    readonly toBundleId: string;
+    readonly toReleaseId: string | null;
+    readonly updateStrategy: UpdateStrategy;
+    /**
+     * How the bundle arrived: `patch` when a bsdiff patch produced a file,
+     * `manifest` when only the changed files were downloaded, `archive` for
+     * the full archive.
+     */
+    readonly delivery: "patch" | "manifest" | "archive";
+    /** A patch was tried, but the file or the archive was downloaded instead. */
+    readonly patchFallback: boolean;
+}
+/**
+ * Where an update failed: `check` covers the Release catalog request,
+ * `download` the transfer and verification of the update's files, and
+ * `install` patching, extracting, and moving them into place.
+ */
+export type UpdateErrorStage = "check" | "download" | "install";
+/** What the SDK was fetching or applying when an update failed. */
+export type UpdateErrorResource = "catalog" | "artifact" | "manifest" | "file" | "patch" | "archive";
+/** Why no response arrived, for a `network` failure. */
+export type UpdateErrorTransport = "timeout" | "dns" | "tls" | "connection" | "offline" | "cancelled";
+export type UpdateErrorReason = "network" | "http" | "invalid_response" | "hash_mismatch" | "signature" | "patch" | "extract" | "storage" | "unknown";
+/** An update check, download, or install that failed. */
+export interface UpdateError {
+    readonly stage: UpdateErrorStage;
+    readonly reason: UpdateErrorReason;
+    /** What was being fetched or applied, when the SDK knows. */
+    readonly resource?: UpdateErrorResource;
+    /** The response status when `reason` is `"http"`. */
+    readonly httpStatus?: number;
+    /**
+     * The storage origin's XML error `<Code>`, such as `AccessDenied`,
+     * `NoSuchKey`, or `ExpiredToken`, when an `http` failure's body names one.
+     * It tells an expired signed URL from a missing file.
+     */
+    readonly originCode?: string;
+    /** Why no response arrived, for a `network` failure, when the SDK knows. */
+    readonly transport?: UpdateErrorTransport;
+    /** Android 11+: why the previous main process exited (see `AppReadyResult`). */
+    readonly previousProcessExit?: string;
+    /** The bundle the update targeted; absent for the check stage. */
+    readonly targetBundleId?: string;
+    /** The Release the update targeted, when it names one. */
+    readonly targetReleaseId?: string;
+    readonly channel: string;
+    /** The running bundle and the Release it was selected as. */
+    readonly bundleId: string;
+    readonly releaseId: string | null;
+    readonly updateStrategy: UpdateStrategy;
+    /** The error the SDK caught. */
+    readonly cause: unknown;
+}
+/**
+ * Lifecycle hooks a plugin returns from `setup`. Hooks observe: the SDK
+ * never waits for one and ignores what it returns, and a hook that throws or
+ * rejects is reported through `onError`, or a console warning without one,
+ * so a plugin can never delay or change an update.
+ */
+export interface HotUpdaterClientHooks {
+    /** Called once per JavaScript runtime, after native reports the launch. */
+    onAppReady?(result: AppReadyResult): void | Promise<void>;
+    /** Called after each update check, and after a Release adoption commits. */
+    onUpdateCheck?(result: UpdateCheckResult): void | Promise<void>;
+    /** Called after the SDK stages a downloaded bundle. */
+    onBundleDownloaded?(info: BundleDownloadedInfo): void | Promise<void>;
+    /** Called when an update check, download, or install fails. */
+    onUpdateError?(error: UpdateError): void | Promise<void>;
+}
+/**
+ * A plugin's persistent key-value store. Native keeps it on the device,
+ * outside device backups, and the SDK scopes its keys to the plugin's id.
+ * It is meant for small values, up to 64 KB each.
+ */
+export interface HotUpdaterClientStorage {
+    get(key: string): string | null;
+    /** Writes the value; `null` removes the key. */
+    set(key: string, value: string | null): void;
+}
+export interface HotUpdaterClientContext {
+    /**
+     * Requests a path relative to the configured `baseURL`, with the SDK's
+     * `requestHeaders` and `requestTimeout` applied. Rejects with
+     * `Request timed out` when the timeout passes before a response arrives.
+     */
+    fetch(path: string, init?: RequestInit): Promise<Response>;
+    /** A random id native creates once per installation. */
+    readonly installId: string;
+    readonly platform: "ios" | "android";
+    /** The native app version, or null when the native build has none. */
+    readonly appVersion: string | null;
+    readonly sdkVersion: string;
+    /** Whether this is a debug build (`__DEV__`). */
+    readonly isDebugBuild: boolean;
+    /** The bundle native reports as current. */
+    getBundleId(): string;
+    getChannel(): string;
+    getCohort(): string;
+    getFingerprintHash(): string | null;
+    readonly storage: HotUpdaterClientStorage;
+    /** The current time in milliseconds since the epoch. */
+    now(): number;
+}
+export interface HotUpdaterClientPlugin {
+    /** Unique among an app's plugins; two plugins with one id throw at init. */
+    readonly id: string;
+    /**
+     * Called once, when `HotUpdater.init` or `HotUpdater.wrap` first
+     * configures the runtime with this plugin.
+     */
+    setup(context: HotUpdaterClientContext): HotUpdaterClientHooks | void;
+}
+/** Declares a client plugin; built-in and third-party plugins use the same contract. */
+export declare const defineClientPlugin: <const P extends HotUpdaterClientPlugin>(plugin: P) => P;
+//# sourceMappingURL=clientPlugin.d.ts.map