@hot-updater/react-native 1.0.0-rc.40 → 1.0.0-rc.41

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

@@ -1,67 +1,26 @@
+import { type LaunchReporter } from "./appReady";
 import { type CheckForUpdateOptions } from "./checkForUpdate";
+import type { ClientPluginApis, HotUpdaterClientPlugin } from "./clientPlugin";
+import { type HotUpdaterHttpClient } from "./httpClient";
+import type { HotUpdaterInitOptions } from "./init.types";
 import { addListener, clearCrashHistory, getAppVersion, getUpdateId, getChannel, getCohort, getCrashHistory, getDefaultChannel, getFingerprintHash, getInstallId, getManifest, getMinBundleId, isChannelSwitched, notifyAppReady, reload, setCohort, setReloadBehavior, type UpdateParams } from "./native";
-import { type AutoUpdateOptions, type HotUpdaterInitOptions, type HotUpdaterOptions, wrap } from "./wrap";
-export { defineClientPlugin, type AppReadyResult, type BundleDownloadedInfo, type HotUpdaterClientContext, type HotUpdaterClientHooks, type HotUpdaterClientPlugin, type HotUpdaterClientStorage, type ReleaseTransitionKind, type UpdateCheckResult, type UpdateError, type UpdateErrorReason, type UpdateErrorStage, type UpdateHttpResponse, type UpdateStrategy, } from "./clientPlugin";
-export { insights, type InsightsOptions, type InsightsPlugin, type InsightsUser, } from "@hot-updater/plugin-insights/client";
+import { type HotUpdaterWrapOptions } from "./wrap";
+export { defineClientPlugin, type AppReadyResult, type BundleDownloadedInfo, type ClientPluginApi, type ClientPluginApis, type HotUpdaterClientContext, type HotUpdaterClientHooks, type HotUpdaterClientPlugin, type HotUpdaterClientSetup, type HotUpdaterClientStorage, type ReleaseTransitionKind, type UpdateCheckResult, type UpdateError, type UpdateErrorReason, type UpdateErrorStage, type UpdateHttpResponse, type UpdateStrategy, } from "./clientPlugin";
+export { insights, type InsightsClient, type InsightsOptions, type InsightsPlugin, type InsightsUser, } from "@hot-updater/plugin-insights/client";
+export { remoteConfig, type RemoteConfigClient, type RemoteConfigDefaults, type RemoteConfigDefaultValue, type RemoteConfigFetchOptions, type RemoteConfigFetchStatus, type RemoteConfigKey, type RemoteConfigOptions, type RemoteConfigPlugin, type RemoteConfigValue, type RemoteConfigValueSource, } from "@hot-updater/plugin-remote-config/client";
 export type { CustomReloadHandler, HotUpdaterEvent, HotUpdaterProgressArtifactType, HotUpdaterProgressEvent, Manifest, ManifestAsset, NotifyAppReadyResult, ActiveUpdateState, ReloadBehavior, ReloadBehaviorSetting, } from "./native";
 export * from "./store";
 export { extractSignatureFailure, type HotUpdaterBaseURL, isSignatureVerificationError, type SignatureVerificationFailure, } from "./types";
-export type { HotUpdaterFallbackComponentProps, HotUpdaterInitOptions, HotUpdaterOptions, RunUpdateProcessResponse, } from "./wrap";
-type HotUpdaterWrap = {
-    (options: AutoUpdateOptions): ReturnType<typeof wrap>;
-    (options: HotUpdaterOptions): ReturnType<typeof wrap>;
-};
-/**
- * Creates a HotUpdater client instance with all update management methods.
- * This function is called once on module initialization to create a singleton instance.
- */
-declare function createHotUpdaterClient(): {
-    /**
-     * `HotUpdater.wrap` checks for updates at the entry point, and if there is a bundle to update, it downloads the bundle and applies the update strategy.
-     *
-     * @param {object} options - Configuration options
-     * @param {string} options.source - Update server URL
-     * @param {object} [options.requestHeaders] - Request headers
-     * @param {React.ComponentType} [options.fallbackComponent] - Component to display during updates
-     * @param {boolean} [options.reloadOnForceUpdate=true] - Whether to automatically reload the app on force updates
-     * @param {Function} [options.onUpdateProcessCompleted] - Callback after update process completes
-     * @param {Function} [options.onProgress] - Callback to track bundle download progress
-     * @returns {Function} Higher-order component that wraps the app component
-     *
-     * @example
-     * ```tsx
-     * export default HotUpdater.wrap({
-     *   baseURL: "<your-update-server-url>",
-     *   updateStrategy: "appVersion",
-     *   requestHeaders: {
-     *     "x-api-key": "<your-api-key>",
-     *   },
-     * })(App);
-     * ```
-     */
-    wrap: (options: HotUpdaterOptions) => <P extends object>(WrappedComponent: React.ComponentType<P>) => React.ComponentType<P>;
-    /**
-     * Initializes HotUpdater without wrapping a React component.
-     *
-     * Use this for manual update flows in runtimes where a root component HOC
-     * is not convenient. Use this instead of wrapping the root component.
-     *
-     * @example
-     * ```tsx
-     * HotUpdater.init({
-     *   baseURL: "<your-update-server-url>",
-     * });
-     *
-     * export default App;
-     * ```
-     */
-    init: (options: HotUpdaterInitOptions) => void;
+export type { HotUpdaterInitOptions } from "./init.types";
+export type { HotUpdaterFallbackComponentProps, HotUpdaterWrapOptions, RunUpdateProcessResponse, } from "./wrap";
+/** The methods that read or change native state, the same on every instance. */
+declare const nativeMethods: {
     /**
      * Reloads the app.
      */
     reload: typeof reload;
     /**
-     * Configures how `HotUpdater.reload()` behaves.
+     * Configures how `hotUpdater.reload()` behaves.
      *
      * This can be called unconditionally on both platforms.
      * The default is `processRestart`.
@@ -74,7 +33,7 @@ declare function createHotUpdaterClient(): {
     /**
      * Returns whether an update has finished downloading in this app session.
      *
-     * When it returns true, calling `HotUpdater.reload()` (or restarting the app)
+     * When it returns true, calling `hotUpdater.reload()` (or restarting the app)
      * will apply the downloaded update bundle.
      *
      * - Derived from `progress` reaching 1.0
@@ -83,8 +42,8 @@ declare function createHotUpdaterClient(): {
      * @returns {boolean} True if a downloaded update is ready to apply
      * @example
      * ```ts
-     * if (HotUpdater.isUpdateDownloaded()) {
-     *   await HotUpdater.reload();
+     * if (hotUpdater.isUpdateDownloaded()) {
+     *   await hotUpdater.reload();
      * }
      * ```
      */
@@ -115,7 +74,7 @@ declare function createHotUpdaterClient(): {
      * @default "production"
      * @example
      * ```ts
-     * const channel = HotUpdater.getChannel();
+     * const channel = hotUpdater.getChannel();
      * console.log(`Current channel: ${channel}`);
      * ```
      */
@@ -128,7 +87,7 @@ declare function createHotUpdaterClient(): {
      * @returns {string} The default release channel embedded in the app
      * @example
      * ```ts
-     * const defaultChannel = HotUpdater.getDefaultChannel();
+     * const defaultChannel = hotUpdater.getDefaultChannel();
      * console.log(`Default channel: ${defaultChannel}`);
      * ```
      */
@@ -157,7 +116,7 @@ declare function createHotUpdaterClient(): {
      *
      * @example
      * ```ts
-     * const unsubscribe = HotUpdater.addListener("onProgress", ({ progress }) => {
+     * const unsubscribe = hotUpdater.addListener("onProgress", ({ progress }) => {
      *   console.log(`Update progress: ${progress * 100}%`);
      * });
      *
@@ -167,7 +126,71 @@ declare function createHotUpdaterClient(): {
      */
     addListener: typeof addListener;
     /**
-     * Manually checks for updates.
+     * Clears the runtime channel override and restores the original bundle.
+     *
+     * @returns {Promise<boolean>} Resolves with true if reset was successful
+     */
+    resetChannel: () => Promise<boolean>;
+    /**
+     * Fetches the fingerprint of the app.
+     *
+     * @returns {string} The fingerprint of the app
+     *
+     * @example
+     * ```ts
+     * const fingerprint = hotUpdater.getFingerprintHash();
+     * console.log(`Fingerprint: ${fingerprint}`);
+     * ```
+     */
+    getFingerprintHash: typeof getFingerprintHash;
+    /**
+     * Fetches the persisted install id for this app installation.
+     */
+    getInstallId: typeof getInstallId;
+    /**
+     * 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.
+     *
+     * @returns {string[]} Array of crashed bundle IDs
+     *
+     * @example
+     * ```ts
+     * const crashedBundles = hotUpdater.getCrashHistory();
+     * console.log("Crashed bundles:", crashedBundles);
+     * ```
+     */
+    getCrashHistory: typeof getCrashHistory;
+    /**
+     * Clears the crashed bundle history, allowing previously crashed bundles
+     * to be installed again.
+     *
+     * @returns {boolean} true if clearing was successful
+     *
+     * @example
+     * ```ts
+     * // Clear crash history to allow retrying a previously failed bundle
+     * hotUpdater.clearCrashHistory();
+     * ```
+     */
+    clearCrashHistory: typeof clearCrashHistory;
+};
+/** What an instance's own methods use: its server, settings, and launch. */
+interface InstanceConfig {
+    readonly client: HotUpdaterHttpClient;
+    readonly requestHeaders?: Record<string, string>;
+    readonly requestTimeout?: number;
+    readonly onError?: (error: unknown) => void;
+    readonly launch: LaunchReporter;
+}
+/** The methods that use the instance's own configuration and plugins. */
+declare const createConfiguredMethods: (config: InstanceConfig) => {
+    /**
+     * Checks for an update, with this instance's server and request
+     * settings.
      *
      * @param {Object} config - Update check configuration
      * @param {string} [config.channel] - Optional channel override for this update check
@@ -177,7 +200,7 @@ declare function createHotUpdaterClient(): {
      *
      * @example
      * ```ts
-     * const updateInfo = await HotUpdater.checkForUpdate({
+     * const updateInfo = await hotUpdater.checkForUpdate({
      *   updateStrategy: "appVersion",
      *   requestHeaders: {
      *     "x-api-key": "<your-api-key>",
@@ -191,11 +214,11 @@ declare function createHotUpdaterClient(): {
      *
      * await updateInfo.updateBundle();
      * if (updateInfo.shouldForceUpdate) {
-     *   await HotUpdater.reload();
+     *   await hotUpdater.reload();
      * }
      * ```
      */
-    checkForUpdate: (config: CheckForUpdateOptions) => Promise<import("./checkForUpdate").CheckForUpdateResult | null>;
+    checkForUpdate: (options: CheckForUpdateOptions) => Promise<import("./checkForUpdate").CheckForUpdateResult | null>;
     /**
      * Updates the bundle of the app.
      *
@@ -205,7 +228,7 @@ declare function createHotUpdaterClient(): {
      *
      * @example
      * ```ts
-     * const updateInfo = await HotUpdater.checkForUpdate({
+     * const updateInfo = await hotUpdater.checkForUpdate({
      *   updateStrategy: "appVersion",
      *   requestHeaders: {
      *     "x-api-key": "<your-api-key>",
@@ -220,66 +243,55 @@ declare function createHotUpdaterClient(): {
      *
      * await updateInfo.updateBundle();
      * if (updateInfo.shouldForceUpdate) {
-     *   await HotUpdater.reload();
+     *   await hotUpdater.reload();
      * }
      * ```
      */
     updateBundle: (params: UpdateParams) => Promise<boolean>;
     /**
-     * Clears the runtime channel override and restores the original bundle.
-     *
-     * @returns {Promise<boolean>} Resolves with true if reset was successful
-     */
-    resetChannel: () => Promise<boolean>;
-    /**
-     * Fetches the fingerprint of the app.
-     *
-     * @returns {string} The fingerprint of the app
+     * Wraps the app's root: when it mounts, it checks for an update with
+     * this instance's configuration, downloads one, and reloads for a
+     * forced update. A `fallbackComponent` replaces the root until the
+     * check and a forced update finish.
      *
      * @example
-     * ```ts
-     * const fingerprint = HotUpdater.getFingerprintHash();
-     * console.log(`Fingerprint: ${fingerprint}`);
+     * ```tsx
+     * export default hotUpdater.wrap({
+     *   updateStrategy: "appVersion",
+     *   fallbackComponent: ({ progress }) => <Splash progress={progress} />,
+     * })(App);
      * ```
      */
-    getFingerprintHash: typeof getFingerprintHash;
-    /**
-     * Fetches the persisted install id for this app installation.
-     */
-    getInstallId: typeof getInstallId;
-    /**
-     * Reads the native launch report for the current process.
-     */
-    notifyAppReady: typeof notifyAppReady;
+    wrap: (options: HotUpdaterWrapOptions) => <P extends object>(WrappedComponent: React.ComponentType<P>) => React.ComponentType<P>;
+};
+/** The methods of every instance `HotUpdater.init` returns. */
+export type HotUpdaterCore = typeof nativeMethods & ReturnType<typeof createConfiguredMethods>;
+/**
+ * The instance `HotUpdater.init` returns: HotUpdater's methods, and each
+ * plugin's API under the plugin's id.
+ */
+export type HotUpdaterInstance<TPlugins extends readonly HotUpdaterClientPlugin[] = readonly []> = Readonly<HotUpdaterCore> & ClientPluginApis<TPlugins>;
+export declare const HotUpdater: {
     /**
-     * Gets the list of bundle IDs that have been marked as crashed.
-     * These bundles will be rejected if attempted to install again.
+     * Creates the app's HotUpdater instance: the update server, its request
+     * settings, and the client plugins. Each call returns an independent
+     * instance with its own configuration and plugins, so create one, at the
+     * top level of a module, and export it.
      *
-     * @returns {string[]} Array of crashed bundle IDs
+     * The instance has every HotUpdater method, such as `wrap`,
+     * `checkForUpdate`, and `reload`, and each plugin's API under the
+     * plugin's id, such as `hotUpdater.remoteConfig` for `remoteConfig()`.
      *
      * @example
-     * ```ts
-     * const crashedBundles = HotUpdater.getCrashHistory();
-     * console.log("Crashed bundles:", crashedBundles);
-     * ```
-     */
-    getCrashHistory: typeof getCrashHistory;
-    /**
-     * Clears the crashed bundle history, allowing previously crashed bundles
-     * to be installed again.
-     *
-     * @returns {boolean} true if clearing was successful
+     * ```tsx
+     * export const hotUpdater = HotUpdater.init({
+     *   baseURL: "<your-update-server-url>",
+     *   plugins: [remoteConfig({ defaults: { welcome_message: "Hi" } })],
+     * });
      *
-     * @example
-     * ```ts
-     * // Clear crash history to allow retrying a previously failed bundle
-     * HotUpdater.clearCrashHistory();
+     * hotUpdater.remoteConfig.getString("welcome_message");
      * ```
      */
-    clearCrashHistory: typeof clearCrashHistory;
-};
-type HotUpdaterClient = Omit<ReturnType<typeof createHotUpdaterClient>, "wrap"> & {
-    wrap: HotUpdaterWrap;
+    init: <const TPlugins extends readonly HotUpdaterClientPlugin[] = readonly []>(options: HotUpdaterInitOptions<TPlugins>) => HotUpdaterInstance<TPlugins>;
 };
-export declare const HotUpdater: HotUpdaterClient;
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,qBAAqB,EAI3B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,WAAW,EAIX,iBAAiB,EACjB,aAAa,EAEb,WAAW,EACX,UAAU,EACV,SAAS,EACT,eAAe,EACf,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,MAAM,EAEN,SAAS,EACT,iBAAiB,EAEjB,KAAK,YAAY,EAClB,MAAM,UAAU,CAAC;AAGlB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EAItB,IAAI,EACL,MAAM,QAAQ,CAAC;AAEhB,OAAO,EACL,kBAAkB,EAClB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,QAAQ,EACR,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,YAAY,GAClB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EACV,mBAAmB,EACnB,eAAe,EACf,8BAA8B,EAC9B,uBAAuB,EACvB,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,qBAAqB,GACtB,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;IAmJ3B;;;;;;;;;;;;;;;;;;;;;;OAsBG;oBACa,iBAAiB;IAQjC;;;;;;;;;;;;;;OAcG;oBACa,qBAAqB,KAAG,IAAI;IAS5C;;OAEG;;IAGH;;;;;;;;;OASG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;OAEG;;IAGH,wDAAwD;;IAGxD;;;OAGG;;IAGH,wEAAwE;;IAGxE;;OAEG;;IAGH;;;;;;;;;;;;OAYG;;IAGH;;;;;;;;;;;OAWG;;IAGH;;;;OAIG;;IAGH;;;OAGG;;IAGH;;OAEG;;IAGH;;;;;;;;;;;;;;;;OAgBG;;IAGH;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA4BG;6BACsB,qBAAqB;IAiB9C;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;2BAC0B,YAAY;IAiDzC;;;;OAIG;;IAcH;;;;;;;;;;OAUG;;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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,21 @@
+import type { HotUpdaterClientPlugin } from "./clientPlugin";
+import type { HotUpdaterError } from "./error";
+import type { NotifyAppReadyResult } from "./native";
+import type { HotUpdaterBaseURL } from "./types";
+export interface HotUpdaterInitOptions<TPlugins extends readonly HotUpdaterClientPlugin[] = readonly HotUpdaterClientPlugin[]> {
+    /**
+     * Client plugins, such as `insights()` and `remoteConfig()` from
+     * `@hot-updater/react-native`. Each plugin's `setup` runs once for the
+     * instance `init` returns; its hooks observe that instance's launch,
+     * update checks, downloads, and update failures, and its API is on the
+     * instance, under the plugin's id. Plugin ids must be unique.
+     */
+    plugins?: TPlugins;
+    /** 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;
+}
+//# sourceMappingURL=init.types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"init.types.d.ts","sourceRoot":"","sources":["../../../src/init.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,qBAAqB,CACpC,QAAQ,SAAS,SAAS,sBAAsB,EAAE,GAChD,SAAS,sBAAsB,EAAE;IAEnC;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,6EAA6E;IAC7E,OAAO,EAAE,iBAAiB,CAAC;IAC3B,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"}

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

@@ -12,7 +12,7 @@ export interface Manifest {
     assets: Record<string, ManifestAsset>;
 }
 /**
- * Built-in reload behaviors used by `HotUpdater.reload()`.
+ * Built-in reload behaviors used by `hotUpdater.reload()`.
  *
  * - `reload`: In-process React Native reload.
  * - `processRestart`: Android-only cold restart. On iOS the same call behaves like `reload`.
@@ -171,7 +171,7 @@ export declare const getAppVersion: () => string | null;
  */
 export declare const reload: () => Promise<void>;
 /**
- * Configures how `HotUpdater.reload()` should behave.
+ * Configures how `hotUpdater.reload()` should behave.
  *
  * This API is available on both Android and iOS so app code can stay symmetric.
  * By default, HotUpdater uses `processRestart`.
@@ -281,7 +281,7 @@ export declare const readNotifyAppReady: () => {
  *
  * @example
  * ```ts
- * const result = HotUpdater.notifyAppReady();
+ * const result = hotUpdater.notifyAppReady();
  *
  * if (result.status === "RECOVERED") {
  *   console.log(result.fromBundleId, result.toBundleId);

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

@@ -1,4 +1,8 @@
-export type { PluginHostConfig } from "@hot-updater/protocol";
-/** The app's plugin host: plugins read the native module and fetch the configured server. */
-export declare const configurePlugins: (plugins: readonly import("@hot-updater/protocol").HotUpdaterClientPlugin[] | undefined, config: import("@hot-updater/protocol").PluginHostConfig) => void, hasPluginHook: (name: import("@hot-updater/protocol").PluginHookName) => boolean, buildPluginEvent: <K extends import("@hot-updater/protocol").PluginHookName>(name: K, createPayload: () => import("@hot-updater/protocol").PluginHookPayload<K> | null) => import("@hot-updater/protocol").PluginHookPayload<K> | null, dispatchPluginHook: <K extends import("@hot-updater/protocol").PluginHookName>(name: K, payload: import("@hot-updater/protocol").PluginHookPayload<K>) => readonly Promise<void>[], emitPluginHook: <K extends import("@hot-updater/protocol").PluginHookName>(name: K, createPayload: () => import("@hot-updater/protocol").PluginHookPayload<K> | null) => void;
+import { type PluginHost } from "@hot-updater/protocol";
+export type { PluginHost, PluginHostConfig } from "@hot-updater/protocol";
+/**
+ * Creates an instance's plugin host: its plugins read the native module and
+ * fetch the server the instance was configured with.
+ */
+export declare const createAppPluginHost: () => PluginHost;
 //# sourceMappingURL=pluginHost.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"pluginHost.d.ts","sourceRoot":"","sources":["../../../src/pluginHost.ts"],"names":[],"mappings":"AAgBA,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D,6FAA6F;AAC7F,eAAO,MACL,gBAAgB,8JAChB,aAAa,qEACb,gBAAgB,wNAChB,kBAAkB,kKAClB,cAAc,+JAsBd,CAAC"}
+{"version":3,"file":"pluginHost.d.ts","sourceRoot":"","sources":["../../../src/pluginHost.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,uBAAuB,CAAC;AAgB/B,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AA0B1E;;;GAGG;AACH,eAAO,MAAM,mBAAmB,QAAO,UACR,CAAC"}

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

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

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

@@ -1,6 +1,5 @@
 import React from "react";
-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;
+import type { InternalWrapOptions } from "./wrap.types";
+export type { HotUpdaterFallbackComponentProps, HotUpdaterWrapOptions, InternalWrapOptions, RunUpdateProcessResponse, } from "./wrap.types";
 export declare function wrap(options: InternalWrapOptions): <P extends object>(WrappedComponent: React.ComponentType<P>) => React.ComponentType<P>;
 //# 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":"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"}
+{"version":3,"file":"wrap.d.ts","sourceRoot":"","sources":["../../../src/wrap.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAKnD,OAAO,KAAK,EAEV,mBAAmB,EAEpB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,gCAAgC,EAChC,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,GACzB,MAAM,cAAc,CAAC;AAEtB,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,CAiJ1B"}

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

@@ -1,10 +1,6 @@
 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";
+import type { CheckForUpdateOptions, CheckForUpdateResult } from "./checkForUpdate";
 import type { HotUpdaterState } from "./store";
-import type { HotUpdaterBaseURL } from "./types";
 export interface RunUpdateProcessResponse {
     status: "ROLLBACK" | "UPDATE" | "UP_TO_DATE";
     shouldForceUpdate: boolean;
@@ -19,45 +15,22 @@ export type HotUpdaterFallbackComponentProps = {
     artifactType: HotUpdaterState["artifactType"];
     details: HotUpdaterState["details"];
 };
-interface CommonHotUpdaterOptions {
-    /**
-     * Client plugins, such as `insights()` from `@hot-updater/react-native`.
-     * Each plugin's `setup` runs
-     * once, and its hooks observe launches, update checks, downloads, and
-     * update failures. Plugin ids must be unique.
-     */
-    plugins?: readonly HotUpdaterClientPlugin[];
-    /** 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 = {
-    client: HotUpdaterHttpClient;
-    requestHeaders?: Record<string, string>;
-    requestTimeout?: number;
-    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
-    onError?: (error: HotUpdaterError | Error | unknown) => void;
-};
-type InternalAutoUpdateOptions = InternalCommonOptions & {
+/**
+ * The update flow `hotUpdater.wrap` runs when the wrapped root mounts. The
+ * server, request settings, and plugins come from `HotUpdater.init`.
+ */
+export interface HotUpdaterWrapOptions {
     updateStrategy: "fingerprint" | "appVersion";
     fallbackComponent?: React.FC<HotUpdaterFallbackComponentProps>;
     onProgress?: (progress: number) => void;
     reloadOnForceUpdate?: boolean;
     onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
+}
+export type InternalWrapOptions = HotUpdaterWrapOptions & {
+    /** The instance's check, over the configuration of `HotUpdater.init`. */
+    checkForUpdate: (options: Pick<CheckForUpdateOptions, "updateStrategy">) => Promise<CheckForUpdateResult | null>;
+    /** Settles once `HotUpdater.init` has read this launch. */
+    appReady: () => Promise<unknown>;
+    onError: (error: unknown) => void;
 };
-export type InternalInitOptions = InternalCommonOptions;
-export type InternalWrapOptions = InternalAutoUpdateOptions;
-export {};
 //# sourceMappingURL=wrap.types.d.ts.map

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":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC7C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,UAAU,GACV,0BAA0B,CAAC;AAE/B,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;IAC9C,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF,UAAU,uBAAuB;IAC/B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,SAAS,sBAAsB,EAAE,CAAC;IAC5C,6EAA6E;IAC7E,OAAO,EAAE,iBAAiB,CAAC;IAC3B,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;AAED,MAAM,MAAM,iBAAiB,GAAG,uBAAuB,GAAG;IACxD,cAAc,EAAE,aAAa,GAAG,YAAY,CAAC;IAC7C,iBAAiB,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAAC;IAC/D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAE5D,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAElD,KAAK,qBAAqB,GAAG;IAC3B,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;AAEF,KAAK,yBAAyB,GAAG,qBAAqB,GAAG;IACvD,cAAc,EAAE,aAAa,GAAG,YAAY,CAAC;IAC7C,iBAAiB,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAAC;IAC/D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACzE,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAAG,yBAAyB,CAAC"}
+{"version":3,"file":"wrap.types.d.ts","sourceRoot":"","sources":["../../../src/wrap.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,UAAU,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC7C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,MAAM,YAAY,GACpB,kBAAkB,GAClB,UAAU,GACV,0BAA0B,CAAC;AAE/B,MAAM,MAAM,gCAAgC,GAAG;IAC7C,MAAM,EAAE,OAAO,CAAC,YAAY,EAAE,0BAA0B,CAAC,CAAC;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,YAAY,EAAE,eAAe,CAAC,cAAc,CAAC,CAAC;IAC9C,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC,CAAC;CACrC,CAAC;AAEF;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,cAAc,EAAE,aAAa,GAAG,YAAY,CAAC;IAC7C,iBAAiB,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC,gCAAgC,CAAC,CAAC;IAC/D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,wBAAwB,CAAC,EAAE,CAAC,QAAQ,EAAE,wBAAwB,KAAK,IAAI,CAAC;CACzE;AAED,MAAM,MAAM,mBAAmB,GAAG,qBAAqB,GAAG;IACxD,yEAAyE;IACzE,cAAc,EAAE,CACd,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,gBAAgB,CAAC,KACnD,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAAC;IAC1C,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;IACjC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACnC,CAAC"}

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

@@ -1,6 +1,6 @@
 import type { HotUpdaterError } from "./error";
 import { type NotifyAppReadyResult } from "./native";
-import { emitPluginHook } from "./pluginHost";
+import type { PluginHost } from "./pluginHost";
 export type NotifyAppReadyOptions = {
     onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
     onError?: (error: HotUpdaterError | Error | unknown) => void;
@@ -10,12 +10,21 @@ export type NotifyAppReadyOptions = {
  * 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;
+/** An instance's launch: read once, and reported to the instance's plugins. */
+export interface LaunchReporter {
+    /**
+     * Reads this launch once native finalizes it and reports it to the
+     * plugins, once. It rejects only if `onError` throws.
+     */
+    read(options: NotifyAppReadyOptions): Promise<NotifyAppReadyResult | undefined>;
+    /** Settles once the launch was read, whether it was reported or failed. */
+    readonly appReady: Promise<unknown>;
+    /**
+     * Calls a plugin hook after the instance'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.
+     */
+    emit: PluginHost["emitPluginHook"];
+}
+export declare const createLaunchReporter: (host: PluginHost) => LaunchReporter;
 //# sourceMappingURL=appReady.d.ts.map

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

@@ -1 +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;AAwBF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aACpB,MAAM,WACP,MAAM,KACd,MAAM,GAAG,IAQX,CAAC;AAyDF,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"}
+{"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,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE/C,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;AAoBF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,aACpB,MAAM,WACP,MAAM,KACd,MAAM,GAAG,IAQX,CAAC;AAyDF,+EAA+E;AAC/E,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,IAAI,CACF,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAC;IAC7C,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACpC;;;;OAIG;IACH,IAAI,EAAE,UAAU,CAAC,gBAAgB,CAAC,CAAC;CACpC;AAED,eAAO,MAAM,oBAAoB,SAAU,UAAU,KAAG,cAoBvD,CAAC"}

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

@@ -1,3 +1,4 @@
+import { type LaunchReporter } from "./appReady";
 import type { ReleaseTransitionKind, UpdateErrorResource, UpdateErrorStage } from "./clientPlugin";
 import type { HotUpdaterHttpClient } from "./httpClient";
 export type { ReleaseTransitionKind };
@@ -6,7 +7,6 @@ export interface CheckForUpdateOptions {
      * Update strategy
      * - "fingerprint": Use fingerprint hash to check for updates
      * - "appVersion": Use app version to check for updates
-     * - Can override the strategy set in HotUpdater.wrap()
      */
     updateStrategy: "appVersion" | "fingerprint";
     /**
@@ -33,12 +33,14 @@ export type CheckForUpdateResult = {
     readonly transitionKind?: ReleaseTransitionKind;
     /**
      * Updates the bundle.
-     * This method is equivalent to `HotUpdater.updateBundle()` but with all required arguments pre-filled.
+     * This method is equivalent to `hotUpdater.updateBundle()` but with all required arguments pre-filled.
      */
     updateBundle: () => Promise<boolean>;
 };
 export interface InternalCheckForUpdateOptions extends CheckForUpdateOptions {
     client: HotUpdaterHttpClient;
+    /** Calls the checking instance's plugin hooks. */
+    emit: LaunchReporter["emit"];
 }
 /** The running bundle, the channel checked, and the update's target. */
 type UpdateErrorScope = {
@@ -52,6 +54,6 @@ type UpdateErrorScope = {
  * 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 const reportUpdateError: (emit: LaunchReporter["emit"], 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":"AAcA,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAoBzD,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,IAmBF,CAAC;AAuRF,wBAAsB,cAAc,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA2EtC"}
+{"version":3,"file":"checkForUpdate.d.ts","sourceRoot":"","sources":["../../../src/checkForUpdate.ts"],"names":[],"mappings":"AAaA,OAAO,EAAuB,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACtE,OAAO,KAAK,EACV,qBAAqB,EACrB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAoBzD,YAAY,EAAE,qBAAqB,EAAE,CAAC;AAEtC,MAAM,WAAW,qBAAqB;IACpC;;;;OAIG;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;IAC7B,kDAAkD;IAClD,IAAI,EAAE,cAAc,CAAC,MAAM,CAAC,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,SACtB,cAAc,CAAC,MAAM,CAAC,SACrB,OAAO,SACP,gBAAgB,YACb,mBAAmB,GAAG,SAAS,SAClC,gBAAgB,KACtB,IAmBF,CAAC;AA6RF,wBAAsB,cAAc,CAClC,OAAO,EAAE,6BAA6B,GACrC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CA2EtC"}

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

@@ -1,2 +1,2 @@
-export { defineClientPlugin, type AppReadyResult, type BundleDownloadedInfo, type HotUpdaterClientContext, type HotUpdaterClientHooks, type HotUpdaterClientPlugin, type HotUpdaterClientStorage, type ReleaseTransitionKind, type UpdateCheckResult, type UpdateError, type UpdateErrorReason, type UpdateErrorResource, type UpdateErrorStage, type UpdateErrorTransport, type UpdateHttpResponse, type UpdateStrategy, } from "@hot-updater/protocol";
+export { defineClientPlugin, type AppReadyResult, type BundleDownloadedInfo, type ClientPluginApi, type ClientPluginApis, type HotUpdaterClientContext, type HotUpdaterClientHooks, type HotUpdaterClientPlugin, type HotUpdaterClientSetup, type HotUpdaterClientStorage, type ReleaseTransitionKind, type UpdateCheckResult, type UpdateError, type UpdateErrorReason, type UpdateErrorResource, type UpdateErrorStage, type UpdateErrorTransport, type UpdateHttpResponse, type UpdateStrategy, } from "@hot-updater/protocol";
 //# sourceMappingURL=clientPlugin.d.ts.map