@hot-updater/react-native 0.36.7 → 1.0.0-rc.0

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

@@ -1,7 +1,8 @@
-import { type UpdateStatus } from "@hot-updater/core";
+import { type CatalogHighWater, type UpdateStatus, type PersistedSelectionReceipt } from "@hot-updater/core";
 import { HotUpdaterErrorCode, isHotUpdaterError } from "./error";
 import { type UpdateBundleParams } from "./specs/NativeHotUpdater";
 export { HotUpdaterErrorCode, isHotUpdaterError };
+type PersistedUpdateStrategy = "fingerprint" | "appVersion";
 export interface ManifestAsset {
     fileHash: string;
     signature?: string;
@@ -94,6 +95,41 @@ export type UpdateParams = UpdateBundleParams & {
     status: UpdateStatus;
     shouldSkipCurrentBundleIdCheck?: boolean;
 };
+export interface ActiveUpdateState {
+    readonly activeSelection: ActiveUpdateSelection | null;
+    readonly stableSelection: ActiveUpdateSelection | null;
+    readonly verificationPending: boolean;
+}
+type ActiveUpdateSelection = Pick<PersistedSelectionReceipt, "kind" | "releaseId" | "bundleId" | "channel">;
+export interface InternalActiveUpdateState {
+    readonly activeSelection: PersistedSelectionReceipt | null;
+    readonly stableSelection: PersistedSelectionReceipt | null;
+    readonly verificationPending: boolean;
+    readonly highestSeenCatalogs: Readonly<Record<string, CatalogHighWater>>;
+}
+export interface ReleaseSelectionGuard {
+    readonly catalogId: string;
+    readonly scopeKey: string;
+    readonly generation: number;
+    readonly catalogHash: string;
+    readonly selectionContextHash: string;
+    readonly channel: string;
+}
+export declare const acceptReleaseCatalog: (input: {
+    readonly catalogId: string;
+    readonly scopeKey: string;
+    readonly generation: number;
+    readonly catalogHash: string;
+    readonly channel: string;
+    readonly selectionContextHash: string;
+}) => boolean;
+export declare const getActiveUpdateState: () => InternalActiveUpdateState;
+export declare const getPublicActiveUpdateState: () => ActiveUpdateState;
+export declare const isReleaseSelectionCurrent: (input: ReleaseSelectionGuard) => boolean;
+export declare const commitReleaseSelection: (input: {
+    readonly selection: PersistedSelectionReceipt;
+    readonly guard: ReleaseSelectionGuard;
+}) => Promise<boolean>;
 /**
  * Downloads files and applies them to the app.
  *
@@ -102,10 +138,6 @@ export type UpdateParams = UpdateBundleParams & {
  * @throws {Error} Rejects with error.code from HotUpdaterErrorCode enum and error.message
  */
 export declare function updateBundle(params: UpdateParams): Promise<boolean>;
-/**
- * @deprecated Use updateBundle(params: UpdateBundleParamsWithStatus) instead
- */
-export declare function updateBundle(bundleId: string, fileUrl: string | null): Promise<boolean>;
 /**
  * Fetches the current app version.
  */
@@ -140,12 +172,12 @@ export declare const reload: () => Promise<void>;
  */
 export declare function setReloadBehavior(...args: [behavior: ReloadBehavior] | [behavior: "custom", handler: CustomReloadHandler]): void;
 /**
- * Fetches the minimum bundle id, which represents the initial bundle of the app
- * since it is created at build time.
+ * Fetches the build-time minimum Release id.
  *
- * @returns {string} Resolves with the minimum bundle id or null if not available.
+ * @returns {string} The minimum Release id.
  */
-export declare const getMinBundleId: () => string;
+export declare const getMinimumReleaseId: () => string;
+export declare const getReleaseId: () => Promise<string | null>;
 /**
  * Fetches the current bundle version id.
  *
@@ -184,12 +216,48 @@ export declare const isChannelSwitched: () => boolean;
  * @returns {string | null} Resolves with the fingerprint hash
  */
 export declare const getFingerprintHash: () => string | null;
+export declare const getInstallId: () => string;
+export type PersistedUserIdentity = {
+    userId?: string;
+    username?: string;
+};
+export declare const getPersistedUserIdentity: () => PersistedUserIdentity;
+export type SetUserParams = {
+    userId?: string | number | null;
+    username?: string | null;
+};
+export declare function setUser(params: SetUserParams): void;
+export declare function setUser(params: null): void;
 /**
  * Result returned by notifyAppReady()
  */
 export type NotifyAppReadyResult = {
-    status: "RECOVERED" | "STABLE";
-    crashedBundleId?: string;
+    status: "UNCHANGED";
+} | {
+    status: "UPDATE_APPLIED";
+    fromBundleId: string;
+    toBundleId: string;
+    fromReleaseId?: string;
+    toReleaseId?: string;
+} | {
+    status: "RECOVERED";
+    fromBundleId: string;
+    toBundleId: string;
+    fromReleaseId?: string;
+    toReleaseId?: string;
+};
+export type NotifyAppReadyAnalyticsEvent = {
+    type: "UPDATE_APPLIED" | "RECOVERED";
+    fromBundleId: string;
+    toBundleId: string;
+    fromReleaseId?: string | null;
+    toReleaseId?: string | null;
+    updateStrategy: PersistedUpdateStrategy;
+};
+export declare const readNotifyAppReady: () => {
+    result: NotifyAppReadyResult;
+    analyticsEvent: NotifyAppReadyAnalyticsEvent | null;
+    pending: boolean;
 };
 /**
  * Reads the native launch report for the current process.
@@ -197,19 +265,16 @@ export type NotifyAppReadyResult = {
  * This function is called automatically after the app has rendered.
  *
  * @returns {NotifyAppReadyResult} Bundle state information
- * - `status: "RECOVERED"` - App recovered from crash, rollback occurred (ROLLBACK event)
- * - `status: "STABLE"` - No changes, already stable
- * - `crashedBundleId` - Present only when status is "RECOVERED"
+ * - `status: "UNCHANGED"` - No qualifying OTA transition to report
+ * - `status: "UPDATE_APPLIED"` - A pending update became active
+ * - `status: "RECOVERED"` - Crash recovery rolled back to another bundle
  *
  * @example
  * ```ts
  * const result = HotUpdater.notifyAppReady();
  *
  * if (result.status === "RECOVERED") {
- *   // Send ROLLBACK analytics event
- *   analytics.track("bundle_rollback", {
- *     crashedBundleId: result.crashedBundleId,
- *   });
+ *   console.log(result.fromBundleId, result.toBundleId);
  * }
  * ```
  */

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

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

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

@@ -0,0 +1,13 @@
+import type { HotUpdaterError } from "./error";
+import type { HotUpdaterHttpClient } from "./httpClient";
+import { type NotifyAppReadyResult } from "./native";
+export type NotifyAppReadyOptions = {
+    analytics?: boolean;
+    client: HotUpdaterHttpClient;
+    requestHeaders?: Record<string, string>;
+    requestTimeout?: number;
+    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
+    onError?: (error: HotUpdaterError | Error | unknown) => void;
+};
+export declare const handleNotifyAppReady: (options: NotifyAppReadyOptions) => Promise<void>;
+//# sourceMappingURL=notifyAppReadyAnalytics.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifyAppReadyAnalytics.d.ts","sourceRoot":"","sources":["../../../src/notifyAppReadyAnalytics.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAwB,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAC/E,OAAO,EASL,KAAK,oBAAoB,EAE1B,MAAM,UAAU,CAAC;AAElB,MAAM,MAAM,qBAAqB,GAAG;IAClC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,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;AA4IF,eAAO,MAAM,oBAAoB,YACtB,qBAAqB,KAC7B,OAAO,CAAC,IAAI,CA2Bd,CAAC"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"notifyAppReadyAnalytics.test-utils.d.ts","sourceRoot":"","sources":["../../../src/notifyAppReadyAnalytics.test-utils.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,4BAA4B,EAC5B,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAElB,eAAO,MAAM,sBAAsB,YACzB,oBAAoB,mBACZ,4BAA4B,GAAG,IAAI,wBAElD;IACD,cAAc,EAAE,4BAA4B,GAAG,IAAI,CAAC;IACpD,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,oBAAoB,CAAC;CAK7B,CAAC;AAEH,eAAO,MAAM,eAAe,YAS3B,CAAC"}

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

@@ -0,0 +1,25 @@
+import { type ReleaseCatalog } from "@hot-updater/core";
+export declare const MAX_RELEASE_CATALOG_WIRE_BYTES: number;
+export declare const MAX_RELEASE_CATALOG_CACHE_ENTRY_BYTES: number;
+export type ExpectedReleaseCatalogScope = {
+    readonly channelKey: string;
+    readonly platform: "ios" | "android";
+} & ({
+    readonly strategy: "APP_VERSION";
+    readonly fingerprintHash?: never;
+} | {
+    readonly strategy: "FINGERPRINT";
+    readonly fingerprintHash: string;
+});
+type FetchReleaseCatalogInput = {
+    readonly baseURL: string;
+    readonly expectedScope: ExpectedReleaseCatalogScope;
+    readonly requestHeaders?: Record<string, string>;
+    readonly requestTimeout?: number;
+    readonly url: string;
+};
+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>;
+export {};
+//# sourceMappingURL=releaseCatalogCache.d.ts.map

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

@@ -0,0 +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"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"sdkVersion.d.ts","sourceRoot":"","sources":["../../../src/sdkVersion.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,WAAW,CAAC"}
+{"version":3,"file":"sdkVersion.d.ts","sourceRoot":"","sources":["../../../src/sdkVersion.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,eAAe,CAAC"}

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

@@ -41,6 +41,8 @@ export interface UpdateBundleParams {
      * the currently active bundle.
      */
     changedAssets?: UnsafeObject | null;
+    /** Full Release Catalog selection receipt committed with the staged Bundle. */
+    selection?: UnsafeObject | null;
 }
 export interface Spec extends TurboModule {
     reload(): Promise<void>;
@@ -82,17 +84,34 @@ export interface Spec extends TurboModule {
      *   or UNKNOWN_ERROR to keep the JS error surface small.
      */
     updateBundle(params: UpdateBundleParams): Promise<boolean>;
+    /** 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. */
+    getActiveUpdateState(): UnsafeObject;
+    /** Reads a checksum-verified Release Catalog cache entry. */
+    getReleaseCatalogCache(partition: string): Promise<string | null>;
+    /** Atomically stores a bounded Release Catalog cache entry. */
+    setReleaseCatalogCache(partition: string, payload: string): Promise<boolean>;
+    /** Removes an incompatible Release Catalog cache entry. */
+    removeReleaseCatalogCache(partition: string): Promise<boolean>;
+    /** Rechecks generation/context immediately before a catalog side effect. */
+    isReleaseSelectionCurrent(params: UnsafeObject): boolean;
+    /** Atomically commits a metadata-only, EMBEDDED, or BUILTIN selection. */
+    commitReleaseSelection(params: UnsafeObject): Promise<boolean>;
     /**
      * Reads the launch report for the current process.
      * This is a read-only API; native launch state has already been finalized.
      *
-     * @returns Object with status and optional crashedBundleId
-     * - `status: "RECOVERED"` - App recovered from crash, rollback occurred (ROLLBACK event)
-     * - `status: "STABLE"` - No changes, already stable
-     * - `crashedBundleId` - Present only when status is "RECOVERED"
+     * @returns Object describing whether launch state changed and, for qualifying
+     * transitions, the relevant bundle ids plus persisted transition metadata.
      */
     notifyAppReady(): {
-        status: "RECOVERED" | "STABLE";
+        status: "PENDING" | "UNCHANGED" | "UPDATE_APPLIED" | "RECOVERED";
+        fromReleaseId?: string;
+        fromBundleId?: string;
+        toReleaseId?: string;
+        toBundleId?: string;
+        updateStrategy?: "fingerprint" | "appVersion";
         crashedBundleId?: string;
     };
     /**
@@ -150,6 +169,22 @@ export interface Spec extends TurboModule {
      * persists it before returning.
      */
     getCohort: () => string;
+    /**
+     * Gets the persisted install id for this app installation.
+     */
+    getInstallId: () => string;
+    /**
+     * Gets the persisted nullable user id associated with this installation.
+     */
+    getUserId: () => string | null;
+    /**
+     * Gets the persisted nullable username associated with this installation.
+     */
+    getUsername: () => string | null;
+    /**
+     * Persists nullable user identity fields associated with this installation.
+     */
+    setUser: (userId: string | null, username: string | null) => void;
     addListener(eventName: string): void;
     removeListeners(count: number): void;
     readonly getConstants: () => {

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

@@ -1 +1 @@
-{"version":3,"file":"NativeHotUpdater.d.ts","sourceRoot":"","sources":["../../../../src/specs/NativeHotUpdater.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2CAA2C,CAAC;AAE9E,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,EAAE;QACL,WAAW,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;QAC1B,GAAG,EAAE,MAAM,CAAC;KACb,GAAG,IAAI,CAAC;IACT,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,SAAS,EAAE,QAAQ,CAAC;QACpB,YAAY,EAAE,MAAM,CAAC;QACrB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;QACtB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,IAAI,CAAC;CACV;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC;;;OAGG;IACH,aAAa,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;CACrC;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IAEvC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACxB;;;;OAIG;IACH,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D;;;;;;;;OAQG;IACH,cAAc,IAAI;QAChB,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;QAC/B,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,CAAC;IAEF;;;;;OAKG;IACH,eAAe,IAAI,MAAM,EAAE,CAAC;IAE5B;;;;;OAKG;IACH,iBAAiB,IAAI,OAAO,CAAC;IAE7B;;;;OAIG;IACH,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAEjC;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAEhC;;;;;;OAMG;IACH,WAAW,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAEjC;;;OAGG;IACH,WAAW,EAAE,MAAM,YAAY,CAAC;IAEhC;;;;;;OAMG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC;;;;OAIG;IACH,SAAS,EAAE,MAAM,MAAM,CAAC;IAGxB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,MAAM;QAC3B,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;QACxB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,CAAC;CACH"}
+{"version":3,"file":"NativeHotUpdater.d.ts","sourceRoot":"","sources":["../../../../src/specs/NativeHotUpdater.ts"],"names":[],"mappings":"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"}

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

@@ -1,122 +1,4 @@
-import type { AppUpdateInfo } from "@hot-updater/core";
-import type { NotifyAppReadyResult } from "./native";
 export type HotUpdaterBaseURL = string | (() => string | Promise<string>);
-/**
- * Parameters passed to resolver.checkUpdate method
- */
-export interface ResolverCheckUpdateParams {
-    /**
-     * The platform the app is running on
-     */
-    platform: "ios" | "android";
-    /**
-     * The current app version
-     */
-    appVersion: string;
-    /**
-     * The current bundle ID
-     */
-    bundleId: string;
-    /**
-     * Minimum bundle ID from build time
-     */
-    minBundleId: string;
-    /**
-     * The channel name (e.g., "production", "staging")
-     */
-    channel: string;
-    /**
-     * Cohort identifier used for server-side rollout decisions.
-     */
-    cohort: string;
-    /**
-     * Update strategy being used
-     */
-    updateStrategy: "fingerprint" | "appVersion";
-    /**
-     * The fingerprint hash (only present when using fingerprint strategy)
-     */
-    fingerprintHash: string | null;
-    /**
-     * Request headers from global config (for optional use)
-     */
-    requestHeaders?: Record<string, string>;
-    /**
-     * Request timeout from global config (for optional use)
-     */
-    requestTimeout?: number;
-}
-/**
- * Parameters passed to resolver.notifyAppReady method
- */
-export interface ResolverNotifyAppReadyParams {
-    /**
-     * The bundle state from native notifyAppReady
-     * - "RECOVERED": App recovered from crash, rollback occurred
-     * - "STABLE": No changes, bundle is stable
-     */
-    status: "RECOVERED" | "STABLE";
-    /**
-     * Present only when status is "RECOVERED"
-     */
-    crashedBundleId?: string;
-    /**
-     * Request headers from global config (for optional use)
-     */
-    requestHeaders?: Record<string, string>;
-    /**
-     * Request timeout from global config (for optional use)
-     */
-    requestTimeout?: number;
-}
-/**
- * Resolver interface for custom network operations
- */
-export interface HotUpdaterResolver {
-    /**
-     * Custom implementation for checking updates.
-     * When provided, this completely replaces the default fetchUpdateInfo flow.
-     *
-     * @param params - All parameters needed to check for updates
-     * @returns Update information or null if up to date
-     *
-     * @example
-     * ```typescript
-     * checkUpdate: async (params) => {
-     *   const response = await fetch(`https://api.custom.com/check`, {
-     *     method: 'POST',
-     *     body: JSON.stringify(params),
-     *     headers: params.requestHeaders,
-     *   });
-     *
-     *   if (!response.ok) return null;
-     *   return response.json();
-     * }
-     * ```
-     */
-    checkUpdate?: (params: ResolverCheckUpdateParams) => Promise<AppUpdateInfo | null>;
-    /**
-     * Custom implementation for notifying app ready.
-     * When provided, this completely replaces the default notifyAppReady network flow.
-     * Note: Native rollback/promotion semantics are already finalized before this callback runs.
-     *
-     * @param params - All parameters about the current app state
-     * @returns Notification result
-     *
-     * @example
-     * ```typescript
-     * notifyAppReady: async (params) => {
-     *   await fetch(`https://api.custom.com/notify`, {
-     *     method: 'POST',
-     *     body: JSON.stringify(params),
-     *   });
-     *
-     *   return { status: "STABLE" };
-     * }
-     * ```
-     */
-    notifyAppReady?: (params: ResolverNotifyAppReadyParams) => Promise<NotifyAppReadyResult | undefined>;
-}
 /**
  * Information about a signature verification failure.
  * This is a security-critical event that indicates the bundle

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAErD,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC;;OAEG;IACH,QAAQ,EAAE,KAAK,GAAG,SAAS,CAAC;IAE5B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,cAAc,EAAE,aAAa,GAAG,YAAY,CAAC;IAE7C;;OAEG;IACH,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAE/B;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;;;OAIG;IACH,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;IAE/B;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,WAAW,CAAC,EAAE,CACZ,MAAM,EAAE,yBAAyB,KAC9B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAEnC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,cAAc,CAAC,EAAE,CACf,MAAM,EAAE,4BAA4B,KACjC,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;CAChD;AAED;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgBpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,4BAA4B,CAS9B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;AAE1E;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,KAAK,EAAE,KAAK,CAAC;CACd;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAgBpE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,QAAQ,EAAE,MAAM,GACf,4BAA4B,CAS9B"}

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

@@ -1,195 +1,6 @@
 import React from "react";
-import type { HotUpdaterError } from "./error";
-import { type NotifyAppReadyResult } from "./native";
-import { type HotUpdaterState } from "./store";
-import type { HotUpdaterBaseURL, HotUpdaterResolver } from "./types";
-export interface RunUpdateProcessResponse {
-    status: "ROLLBACK" | "UPDATE" | "UP_TO_DATE";
-    shouldForceUpdate: boolean;
-    message: string | null;
-    id: string;
-}
-type UpdateStatus = "CHECK_FOR_UPDATE" | "UPDATING" | "UPDATE_PROCESS_COMPLETED";
-export type HotUpdaterFallbackComponentProps = {
-    status: Exclude<UpdateStatus, "UPDATE_PROCESS_COMPLETED">;
-    progress: number;
-    downloadedBytes: HotUpdaterState["downloadedBytes"];
-    totalBytes: HotUpdaterState["totalBytes"];
-    message: string | null;
-    artifactType: HotUpdaterState["artifactType"];
-    details: HotUpdaterState["details"];
-};
-/**
- * Common options shared by HotUpdater initialization APIs.
- */
-interface CommonHotUpdaterOptions {
-    /**
-     * Custom request headers for update checks
-     */
-    requestHeaders?: Record<string, string>;
-    /**
-     * Request timeout in milliseconds
-     * @default 5000
-     */
-    requestTimeout?: number;
-    /**
-     * Callback invoked when the app is ready and the native launch report is available.
-     * Provides information about rollback recovery or stable state.
-     *
-     * @param result - Bundle state information
-     * @param result.status - Current bundle state:
-     *   - "RECOVERED": App recovered from a crash, rollback occurred
-     *   - "STABLE": No changes, bundle is stable
-     * @param result.crashedBundleId - Present only when status is "RECOVERED"
-     *
-     * @example
-     * ```tsx
-     * HotUpdater.init({
-     *   baseURL: "https://api.example.com",
-     *   onNotifyAppReady: ({ status, crashedBundleId }) => {
-     *     if (status === "RECOVERED") {
-     *       analytics.track("bundle_rollback", { crashedBundleId });
-     *     }
-     *   },
-     * });
-     * ```
-     */
-    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
-    /**
-     * Default callback invoked when Hot Updater initialization or update checks
-     * fail. Per-call `HotUpdater.checkForUpdate({ onError })` handlers override
-     * this callback for that check.
-     */
-    onError?: (error: HotUpdaterError | Error | unknown) => void;
-}
-/**
- * Configuration with baseURL for standard server-based updates
- */
-interface BaseURLConfig {
-    /**
-     * Base URL for update server. Use a function to resolve it dynamically
-     * before each update check.
-     * @example "https://update.example.com"
-     * @example () => getUpdateServerURL()
-     */
-    baseURL: HotUpdaterBaseURL;
-    /**
-     * Resolver is not allowed when using baseURL
-     */
-    resolver?: never;
-}
-/**
- * Configuration with resolver for custom network operations
- */
-interface ResolverConfig {
-    /**
-     * Custom resolver for network operations
-     */
-    resolver: HotUpdaterResolver;
-    /**
-     * baseURL is not allowed when using resolver
-     */
-    baseURL?: never;
-}
-/**
- * Union type ensuring baseURL and resolver are mutually exclusive
- */
-type NetworkConfig = BaseURLConfig | ResolverConfig;
-export type AutoUpdateOptions = CommonHotUpdaterOptions & NetworkConfig & {
-    /**
-     * Automatic update mode. This is the default and can be omitted.
-     */
-    updateMode?: "auto";
-    /**
-     * Update strategy
-     * - "fingerprint": Use fingerprint hash to check for updates
-     * - "appVersion": Use app version to check for updates
-     */
-    updateStrategy: "fingerprint" | "appVersion";
-    /**
-     * Component to show while downloading a new bundle update.
-     *
-     * When an update exists and the bundle is being downloaded, this component will block access
-     * to the entry point and show download progress.
-     *
-     * @see {@link https://hot-updater.dev/docs/react-native-api/wrap#fallback-component}
-     *
-     * ```tsx
-     * HotUpdater.wrap({
-     *   baseURL: "<update-server-url>",
-     *   updateStrategy: "appVersion",
-     *   fallbackComponent: ({ progress = 0 }) => (
-     *     <View style={styles.container}>
-     *       <Text style={styles.text}>Updating... {progress}%</Text>
-     *     </View>
-     *   )
-     * })(App)
-     * ```
-     *
-     * If not defined, the bundle will download in the background without blocking the screen.
-     */
-    fallbackComponent?: React.FC<HotUpdaterFallbackComponentProps>;
-    onProgress?: (progress: number) => void;
-    /**
-     * When a force update exists, the app will automatically reload.
-     * If `false`, When a force update exists, the app will not reload. `shouldForceUpdate` will be returned as `true` in `onUpdateProcessCompleted`.
-     * If `true`, When a force update exists, the app will automatically reload.
-     * @default true
-     */
-    reloadOnForceUpdate?: boolean;
-    /**
-     * Callback function that is called when the update process is completed.
-     *
-     * @see {@link https://hot-updater.dev/docs/react-native-api/wrap#onupdateprocesscompleted}
-     */
-    onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
-};
-export type ManualUpdateOptions = CommonHotUpdaterOptions & NetworkConfig & {
-    /**
-     * @deprecated Replace manual `HotUpdater.wrap` with `HotUpdater.init`.
-     *
-     * ```tsx
-     * import { HotUpdater } from "@hot-updater/react-native";
-     *
-     * HotUpdater.init({
-     *   baseURL: "<your-update-server-url>",
-     * });
-     *
-     * export default App;
-     * ```
-     *
-     * Then call `HotUpdater.checkForUpdate(...)` from your manual update flow.
-     * See https://hot-updater.dev/docs/guides/custom-update
-     */
-    updateMode: "manual";
-};
-export type HotUpdaterInitOptions = CommonHotUpdaterOptions & NetworkConfig;
-export type HotUpdaterOptions = AutoUpdateOptions | ManualUpdateOptions;
-/**
- * Internal options after normalization in index.ts
- * Always has resolver (never baseURL)
- */
-type InternalCommonOptions = {
-    resolver: HotUpdaterResolver;
-    requestHeaders?: Record<string, string>;
-    requestTimeout?: number;
-    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
-    onError?: (error: HotUpdaterError | Error | unknown) => void;
-};
-type InternalAutoUpdateOptions = InternalCommonOptions & {
-    updateStrategy: "fingerprint" | "appVersion";
-    updateMode: "auto";
-    fallbackComponent?: React.FC<HotUpdaterFallbackComponentProps>;
-    onProgress?: (progress: number) => void;
-    reloadOnForceUpdate?: boolean;
-    onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
-};
-type InternalManualUpdateOptions = InternalCommonOptions & {
-    updateMode: "manual";
-};
-export type InternalInitOptions = InternalCommonOptions;
-export type InternalWrapOptions = InternalAutoUpdateOptions | InternalManualUpdateOptions;
+import type { InternalInitOptions, InternalWrapOptions } from "./wrap.types";
+export type { AutoUpdateOptions, HotUpdaterFallbackComponentProps, HotUpdaterInitOptions, HotUpdaterOptions, InternalInitOptions, InternalWrapOptions, RunUpdateProcessResponse, } from "./wrap.types";
 export declare function init(options: InternalInitOptions): void;
 export declare function wrap(options: InternalWrapOptions): <P extends object>(WrappedComponent: React.ComponentType<P>) => React.ComponentType<P>;
-export {};
 //# sourceMappingURL=wrap.d.ts.map