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

package/lib/typescript/commonjs/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

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

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

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

@@ -0,0 +1,65 @@
+import type React from "react";
+import type { HotUpdaterError } from "./error";
+import type { HotUpdaterHttpClient } from "./httpClient";
+import type { NotifyAppReadyResult } from "./native";
+import type { HotUpdaterState } from "./store";
+import type { HotUpdaterBaseURL } from "./types";
+export interface RunUpdateProcessResponse {
+    status: "ROLLBACK" | "UPDATE" | "UP_TO_DATE";
+    shouldForceUpdate: boolean;
+    message: string | null;
+    id: string;
+}
+export 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"];
+};
+interface CommonHotUpdaterOptions {
+    /**
+     * Sends app-ready transitions and same-Bundle Release adoptions to the
+     * configured server. Omit or set to `false` to disable client reporting.
+     */
+    analytics?: boolean;
+    /** Base URL of a server exposing the Hot Updater v1 client HTTP protocol. */
+    baseURL: HotUpdaterBaseURL;
+    requestHeaders?: Record<string, string>;
+    requestTimeout?: number;
+    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
+    onError?: (error: HotUpdaterError | Error | unknown) => void;
+}
+export type AutoUpdateOptions = CommonHotUpdaterOptions & {
+    updateStrategy: "fingerprint" | "appVersion";
+    fallbackComponent?: React.FC<HotUpdaterFallbackComponentProps>;
+    onProgress?: (progress: number) => void;
+    reloadOnForceUpdate?: boolean;
+    onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
+};
+export type HotUpdaterInitOptions = CommonHotUpdaterOptions;
+export type HotUpdaterOptions = AutoUpdateOptions;
+type InternalCommonOptions = {
+    analytics?: boolean;
+    client: HotUpdaterHttpClient;
+    requestHeaders?: Record<string, string>;
+    requestTimeout?: number;
+    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
+    onError?: (error: HotUpdaterError | Error | unknown) => void;
+};
+type InternalAutoUpdateOptions = InternalCommonOptions & {
+    updateStrategy: "fingerprint" | "appVersion";
+    fallbackComponent?: React.FC<HotUpdaterFallbackComponentProps>;
+    onProgress?: (progress: number) => void;
+    reloadOnForceUpdate?: boolean;
+    onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
+};
+export type InternalInitOptions = InternalCommonOptions & {
+    analytics?: boolean;
+};
+export type InternalWrapOptions = InternalAutoUpdateOptions;
+export {};
+//# sourceMappingURL=wrap.types.d.ts.map

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

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

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

@@ -0,0 +1,4 @@
+export declare const readNativeReleaseCatalogCache: (partition: string) => Promise<string | null>;
+export declare const writeNativeReleaseCatalogCache: (partition: string, payload: string) => Promise<boolean>;
+export declare const removeNativeReleaseCatalogCache: (partition: string) => Promise<void>;
+//# sourceMappingURL=catalogCacheNative.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"catalogCacheNative.d.ts","sourceRoot":"","sources":["../../../src/catalogCacheNative.ts"],"names":[],"mappings":"AA4BA,eAAO,MAAM,6BAA6B,cAC7B,MAAM,KAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAYvB,CAAC;AAEF,eAAO,MAAM,8BAA8B,cAC9B,MAAM,WACR,MAAM,KACd,OAAO,CAAC,OAAO,CAWjB,CAAC;AAEF,eAAO,MAAM,+BAA+B,cAC/B,MAAM,KAChB,OAAO,CAAC,IAAI,CAWd,CAAC"}

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

@@ -1,5 +1,5 @@
-import type { AppUpdateAvailableInfo } from "@hot-updater/core";
-import type { HotUpdaterResolver } from "./types";
+import { type ArtifactInfo } from "@hot-updater/core";
+import type { HotUpdaterHttpClient } from "./httpClient";
 export interface CheckForUpdateOptions {
     /**
      * Update strategy
@@ -21,15 +21,25 @@ export interface CheckForUpdateOptions {
      */
     requestTimeout?: number;
 }
-export type CheckForUpdateResult = AppUpdateAvailableInfo & {
+export type CheckForUpdateResult = ArtifactInfo & {
+    readonly id: string;
+    readonly message: string | null;
+    readonly rolloutCohortCount: number;
+    readonly shouldForceUpdate: boolean;
+    readonly status: "ROLLBACK" | "UPDATE";
+    readonly targetCohorts: string[];
+    readonly releaseId?: string | null;
+    readonly transitionKind?: ReleaseTransitionKind;
     /**
      * Updates the bundle.
      * This method is equivalent to `HotUpdater.updateBundle()` but with all required arguments pre-filled.
      */
     updateBundle: () => Promise<boolean>;
 };
+export type ReleaseTransitionKind = "INSTALL" | "ADOPT_RELEASE" | "USE_EMBEDDED" | "USE_BUILTIN";
 export interface InternalCheckForUpdateOptions extends CheckForUpdateOptions {
-    resolver: HotUpdaterResolver;
+    analytics?: boolean;
+    client: HotUpdaterHttpClient;
 }
 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":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAiB,MAAM,mBAAmB,CAAC;AAiB/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAIlD,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,sBAAsB,GAAG;IAC1D;;;OAGG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACtC,CAAC;AAGF,MAAM,WAAW,6BAA8B,SAAQ,qBAAqB;IAC1E,QAAQ,EAAE,kBAAkB,CAAC;CAC9B;AAUD,wBAAsB,cAAc,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA8HtC"}
+{"version":3,"file":"checkForUpdate.d.ts","sourceRoot":"","sources":["../../../src/checkForUpdate.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,YAAY,EAGlB,MAAM,mBAAmB,CAAC;AAK3B,OAAO,KAAK,EAAE,oBAAoB,EAAyB,MAAM,cAAc,CAAC;AAyBhF,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,YAAY,GAAG;IAChD,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,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,oBAAoB,CAAC;CAC9B;AA+TD,wBAAsB,cAAc,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAyDtC"}

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

@@ -121,4 +121,7 @@ export declare function isHotUpdaterError(error: unknown): error is {
 export declare class HotUpdaterError extends Error {
     constructor(message: string);
 }
+export declare class StaleReleaseCatalogError extends HotUpdaterError {
+    constructor();
+}
 //# sourceMappingURL=error.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,oBAAY,mBAAmB;IAG7B;;;;OAIG;IACH,iBAAiB,sBAAsB;IAEvC;;;;OAIG;IACH,gBAAgB,qBAAqB;IAIrC;;;;OAIG;IACH,yBAAyB,8BAA8B;IAEvD;;;;;OAKG;IACH,eAAe,oBAAoB;IAEnC;;;;;OAKG;IACH,mBAAmB,wBAAwB;IAE3C;;;;;OAKG;IACH,uBAAuB,4BAA4B;IAEnD;;;;;OAKG;IACH,cAAc,mBAAmB;IAEjC;;;;;OAKG;IACH,uBAAuB,4BAA4B;IAEnD;;;;;OAKG;IACH,6BAA6B,kCAAkC;IAE/D;;;;;;OAMG;IACH,qBAAqB,0BAA0B;IAE/C;;;;;OAKG;IACH,yBAAyB,8BAA8B;IAOvD;;;;;;;OAOG;IACH,gBAAgB,qBAAqB;IAErC;;;;;OAKG;IACH,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAUzD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF"}
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,oBAAY,mBAAmB;IAG7B;;;;OAIG;IACH,iBAAiB,sBAAsB;IAEvC;;;;OAIG;IACH,gBAAgB,qBAAqB;IAIrC;;;;OAIG;IACH,yBAAyB,8BAA8B;IAEvD;;;;;OAKG;IACH,eAAe,oBAAoB;IAEnC;;;;;OAKG;IACH,mBAAmB,wBAAwB;IAE3C;;;;;OAKG;IACH,uBAAuB,4BAA4B;IAEnD;;;;;OAKG;IACH,cAAc,mBAAmB;IAEjC;;;;;OAKG;IACH,uBAAuB,4BAA4B;IAEnD;;;;;OAKG;IACH,6BAA6B,kCAAkC;IAE/D;;;;;;OAMG;IACH,qBAAqB,0BAA0B;IAE/C;;;;;OAKG;IACH,yBAAyB,8BAA8B;IAOvD;;;;;;;OAOG;IACH,gBAAgB,qBAAqB;IAErC;;;;;OAKG;IACH,aAAa,kBAAkB;CAChC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI;IAAE,IAAI,EAAE,mBAAmB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAUzD;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,qBAAa,wBAAyB,SAAQ,eAAe;IAC3D,cAGC;CACF"}

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

@@ -0,0 +1,6 @@
+export declare const fetchJSON: <T>({ url, requestHeaders, requestTimeout, }: {
+    url: string;
+    requestHeaders?: Record<string, string>;
+    requestTimeout?: number;
+}) => Promise<T>;
+//# sourceMappingURL=fetchJSON.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fetchJSON.d.ts","sourceRoot":"","sources":["../../../src/fetchJSON.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,GAAU,CAAC,4CAI9B;IACD,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,KAAG,OAAO,CAAC,CAAC,CAwBZ,CAAC"}

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

@@ -0,0 +1,56 @@
+import { type ArtifactInfo, type ReleaseCatalog } from "@hot-updater/core";
+import type { HotUpdaterBaseURL } from "./types";
+export interface ReleaseCatalogRequest {
+    readonly platform: "ios" | "android";
+    readonly channel: string;
+    readonly updateStrategy: "fingerprint" | "appVersion";
+    readonly appVersion: string;
+    readonly fingerprintHash: string | null;
+    readonly requestHeaders?: Record<string, string>;
+    readonly requestTimeout?: number;
+}
+export interface ArtifactRequest {
+    readonly targetBundleId: string;
+    readonly currentBundleId: string;
+    readonly requestHeaders?: Record<string, string>;
+    readonly requestTimeout?: number;
+}
+interface AnalyticsEventCommonParams {
+    readonly installId: string;
+    readonly userId?: string;
+    readonly username?: string;
+    readonly platform: "ios" | "android";
+    readonly appVersion: string;
+    readonly channel: string;
+    readonly cohort: string;
+    readonly fingerprintHash: string | null;
+    readonly fromReleaseId?: string | null;
+    readonly toReleaseId?: string | null;
+    readonly requestHeaders?: Record<string, string>;
+    readonly requestTimeout?: number;
+}
+type AnalyticsTransitionEventParams = AnalyticsEventCommonParams & {
+    readonly type: "UPDATE_APPLIED" | "RECOVERED" | "RELEASE_ADOPTED";
+    readonly fromBundleId: string;
+    readonly toBundleId: string;
+    readonly updateStrategy: "fingerprint" | "appVersion";
+};
+type AnalyticsUnchangedEventParams = AnalyticsEventCommonParams & {
+    readonly type: "UNCHANGED";
+    readonly fromBundleId: null;
+    readonly toBundleId: string;
+    readonly updateStrategy: null;
+};
+export type AnalyticsEventParams = AnalyticsTransitionEventParams | AnalyticsUnchangedEventParams;
+export interface HotUpdaterHttpSession {
+    fetchReleaseCatalog: (params: ReleaseCatalogRequest) => Promise<ReleaseCatalog>;
+    resolveArtifact: (params: ArtifactRequest) => Promise<ArtifactInfo>;
+    sendAnalyticsEvent: (params: AnalyticsEventParams) => Promise<void>;
+}
+export interface HotUpdaterHttpClient {
+    createSession: () => Promise<HotUpdaterHttpSession>;
+}
+/** Creates the private HTTP client used by HotUpdater.init and HotUpdater.wrap. */
+export declare const createHttpClient: (baseURL: HotUpdaterBaseURL) => HotUpdaterHttpClient;
+export {};
+//# sourceMappingURL=httpClient.d.ts.map

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

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

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

@@ -1,30 +1,12 @@
 import { type CheckForUpdateOptions } from "./checkForUpdate";
-import { addListener, clearCrashHistory, getAppVersion, getBundleId, getChannel, getCohort, getCrashHistory, getDefaultChannel, getFingerprintHash, getManifest, getMinBundleId, isChannelSwitched, reload, setCohort, setReloadBehavior, type UpdateParams } from "./native";
-import { type AutoUpdateOptions, type HotUpdaterInitOptions, type HotUpdaterOptions, type ManualUpdateOptions, wrap } from "./wrap";
-export type { CustomReloadHandler, HotUpdaterEvent, HotUpdaterProgressArtifactType, HotUpdaterProgressEvent, Manifest, ManifestAsset, NotifyAppReadyResult, ReloadBehavior, ReloadBehaviorSetting, } from "./native";
+import { addListener, clearCrashHistory, getAppVersion, getBundleId, getChannel, getCohort, getCrashHistory, getDefaultChannel, getFingerprintHash, getInstallId, getManifest, getMinimumReleaseId, getReleaseId, isChannelSwitched, notifyAppReady, reload, setCohort, setReloadBehavior, setUser, type UpdateParams } from "./native";
+import { type AutoUpdateOptions, type HotUpdaterInitOptions, type HotUpdaterOptions, wrap } from "./wrap";
+export type { CustomReloadHandler, HotUpdaterEvent, HotUpdaterProgressArtifactType, HotUpdaterProgressEvent, Manifest, ManifestAsset, NotifyAppReadyResult, ActiveUpdateState, ReloadBehavior, ReloadBehaviorSetting, SetUserParams, } from "./native";
 export * from "./store";
-export { createDefaultResolver } from "./DefaultResolver";
-export { extractSignatureFailure, type HotUpdaterBaseURL, type HotUpdaterResolver, isSignatureVerificationError, type ResolverCheckUpdateParams, type ResolverNotifyAppReadyParams, type SignatureVerificationFailure, } from "./types";
-export type { HotUpdaterFallbackComponentProps, HotUpdaterInitOptions, HotUpdaterOptions, ManualUpdateOptions, RunUpdateProcessResponse, } from "./wrap";
+export { extractSignatureFailure, type HotUpdaterBaseURL, isSignatureVerificationError, type SignatureVerificationFailure, } from "./types";
+export type { HotUpdaterFallbackComponentProps, HotUpdaterInitOptions, HotUpdaterOptions, RunUpdateProcessResponse, } from "./wrap";
 type HotUpdaterWrap = {
     (options: AutoUpdateOptions): ReturnType<typeof wrap>;
-    /**
-     * @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
-     */
-    (options: ManualUpdateOptions): ReturnType<typeof wrap>;
     (options: HotUpdaterOptions): ReturnType<typeof wrap>;
 };
 /**
@@ -50,7 +32,7 @@ declare function createHotUpdaterClient(): {
      *   baseURL: "<your-update-server-url>",
      *   updateStrategy: "appVersion",
      *   requestHeaders: {
-     *     "Authorization": "Bearer <your-access-token>",
+     *     "x-api-key": "<your-api-key>",
      *   },
      * })(App);
      * ```
@@ -60,8 +42,7 @@ declare function createHotUpdaterClient(): {
      * Initializes HotUpdater without wrapping a React component.
      *
      * Use this for manual update flows in runtimes where a root component HOC
-     * is not convenient. Replace deprecated manual
-     * `HotUpdater.wrap({ updateMode: "manual" })(App)` usage with this API.
+     * is not convenient. Use this instead of wrapping the root component.
      *
      * @example
      * ```tsx
@@ -110,14 +91,16 @@ declare function createHotUpdaterClient(): {
      * Fetches the current app version.
      */
     getAppVersion: typeof getAppVersion;
+    /** Reads the active and stable Release/Bundle state. */
+    getActiveUpdateState: () => Promise<import("./native").ActiveUpdateState>;
     /**
      * Fetches the current bundle ID of the app.
      */
     getBundleId: typeof getBundleId;
-    /**
-     * Retrieves the initial bundle ID based on the build time of the native app.
-     */
-    getMinBundleId: typeof getMinBundleId;
+    /** Preferred Release-catalog name for the build-time UUIDv7 floor. */
+    getMinimumReleaseId: typeof getMinimumReleaseId;
+    /** Returns the active Release identity, or null for BUILTIN/legacy state. */
+    getReleaseId: typeof getReleaseId;
     /**
      * Fetches the current manifest for the active bundle.
      */
@@ -186,18 +169,17 @@ declare function createHotUpdaterClient(): {
      * Manually checks for updates.
      *
      * @param {Object} config - Update check configuration
-     * @param {string} config.source - Update server URL
      * @param {string} [config.channel] - Optional channel override for this update check
      * @param {Record<string, string>} [config.requestHeaders] - Request headers
      *
-     * @returns {Promise<UpdateInfo | null>} Update information or null if up to date
+     * @returns {Promise<CheckForUpdateResult | null>} Update information or null if up to date
      *
      * @example
      * ```ts
      * const updateInfo = await HotUpdater.checkForUpdate({
-     *   source: "<your-update-server-url>",
+     *   updateStrategy: "appVersion",
      *   requestHeaders: {
-     *     Authorization: "Bearer <your-access-token>",
+     *     "x-api-key": "<your-api-key>",
      *   },
      * });
      *
@@ -206,7 +188,7 @@ declare function createHotUpdaterClient(): {
      *   return;
      * }
      *
-     * await HotUpdater.updateBundle(updateInfo.id, updateInfo.fileUrl);
+     * await updateInfo.updateBundle();
      * if (updateInfo.shouldForceUpdate) {
      *   await HotUpdater.reload();
      * }
@@ -225,9 +207,9 @@ declare function createHotUpdaterClient(): {
      * @example
      * ```ts
      * const updateInfo = await HotUpdater.checkForUpdate({
-     *   source: "<your-update-server-url>",
+     *   updateStrategy: "appVersion",
      *   requestHeaders: {
-     *     Authorization: "Bearer <your-access-token>",
+     *     "x-api-key": "<your-api-key>",
      *   },
      * });
      *
@@ -237,10 +219,7 @@ declare function createHotUpdaterClient(): {
      *   };
      * }
      *
-     * await HotUpdater.updateBundle({
-     *   bundleId: updateInfo.id,
-     *   fileUrl: updateInfo.fileUrl
-     * });
+     * await updateInfo.updateBundle();
      * if (updateInfo.shouldForceUpdate) {
      *   await HotUpdater.reload();
      * }
@@ -265,6 +244,18 @@ declare function createHotUpdaterClient(): {
      * ```
      */
     getFingerprintHash: typeof getFingerprintHash;
+    /**
+     * Fetches the persisted install id for this app installation.
+     */
+    getInstallId: typeof getInstallId;
+    /**
+     * Persists nullable user identity fields associated with this installation.
+     */
+    setUser: typeof setUser;
+    /**
+     * Reads the native launch report for the current process.
+     */
+    notifyAppReady: typeof notifyAppReady;
     /**
      * Gets the list of bundle IDs that have been marked as crashed.
      * These bundles will be rejected if attempted to install again.

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,aAAa,EAEb,WAAW,EACX,UAAU,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,MAAM,EAEN,SAAS,EACT,iBAAiB,EACjB,KAAK,YAAY,EAElB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EAItB,KAAK,mBAAmB,EACxB,IAAI,EACL,MAAM,QAAQ,CAAC;AAEhB,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,8BAA8B,EAC9B,uBAAuB,EACvB,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,cAAc,EACd,qBAAqB,GACtB,MAAM,UAAU,CAAC;AAClB,cAAc,SAAS,CAAC;AACxB,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,4BAA4B,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,4BAA4B,EACjC,KAAK,4BAA4B,GAClC,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,gCAAgC,EAChC,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,QAAQ,CAAC;AAoBhB,KAAK,cAAc,GAAG;IACpB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IACtD;;;;;;;;;;;;;;;OAeG;IACH,CAAC,OAAO,EAAE,mBAAmB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IACxD,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;CACvD,CAAC;AAOF;;;GAGG;AACH,iBAAS,sBAAsB;IA0J3B;;;;;;;;;;;;;;;;;;;;;;OAsBG;oBACa,iBAAiB;IAQjC;;;;;;;;;;;;;;;OAeG;oBACa,qBAAqB,KAAG,IAAI;IAS5C;;OAEG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;;;;;;;;;;OAYG;;IAGH;;;;;;;;;;;OAWG;;IAGH;;;;OAIG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;6BACsB,qBAAqB;IAiB9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;2BACoB,YAAY;IAKnC;;;;OAIG;;IAgBH;;;;;;;;;;OAUG;;IAGH;;;;;;;;;;;OAWG;;IAGH;;;;;;;;;;;OAWG;;EAGN;AAED,KAAK,gBAAgB,GAAG,IAAI,CAC1B,UAAU,CAAC,OAAO,sBAAsB,CAAC,EACzC,MAAM,CACP,GAAG;IACF,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,gBAA2C,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,qBAAqB,EAG3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,WAAW,EAEX,iBAAiB,EACjB,aAAa,EAEb,WAAW,EACX,UAAU,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,MAAM,EAEN,SAAS,EACT,iBAAiB,EACjB,OAAO,EACP,KAAK,YAAY,EAElB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EAItB,IAAI,EACL,MAAM,QAAQ,CAAC;AAEhB,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,8BAA8B,EAC9B,uBAAuB,EACvB,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,EACrB,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,cAAc,SAAS,CAAC;AACxB,OAAO,EACL,uBAAuB,EACvB,KAAK,iBAAiB,EACtB,4BAA4B,EAC5B,KAAK,4BAA4B,GAClC,MAAM,SAAS,CAAC;AACjB,YAAY,EACV,gCAAgC,EAChC,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,QAAQ,CAAC;AAoBhB,KAAK,cAAc,GAAG;IACpB,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;IACtD,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAAC,OAAO,IAAI,CAAC,CAAC;CACvD,CAAC;AAEF;;;GAGG;AACH,iBAAS,sBAAsB;IA0I3B;;;;;;;;;;;;;;;;;;;;;;OAsBG;oBACa,iBAAiB;IAQjC;;;;;;;;;;;;;;OAcG;oBACa,qBAAqB,KAAG,IAAI;IAS5C;;OAEG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;OAEG;;IAGH,wDAAwD;;IAGxD;;OAEG;;IAGH,sEAAsE;;IAGtE,6EAA6E;;IAG7E;;OAEG;;IAGH;;;;;;;;;;;;OAYG;;IAGH;;;;;;;;;;;OAWG;;IAGH;;;;OAIG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;6BACsB,qBAAqB;IAkB9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;2BACoB,YAAY;IAKnC;;;;OAIG;;IAgBH;;;;;;;;;;OAUG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;;;;;;;;;;OAWG;;IAGH;;;;;;;;;;;OAWG;;EAGN;AAED,KAAK,gBAAgB,GAAG,IAAI,CAC1B,UAAU,CAAC,OAAO,sBAAsB,CAAC,EACzC,MAAM,CACP,GAAG;IACF,IAAI,EAAE,cAAc,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,UAAU,EAAE,gBAA2C,CAAC"}