react-native-instantpay-code-push 1.1.0

package/lib/module/wrap.js

@@ -0,0 +1,171 @@
+"use strict";
+
+import React, { useEffect, useLayoutEffect, useState } from "react";
+import { checkForUpdate } from "./checkForUpdate.js";
+import { getBundleId, notifyAppReady as nativeNotifyAppReady, reload } from "./native.js";
+import { useEventCallback } from "./hooks/useEventCallback.js";
+import { useIpayCodePushStore } from "./store.js";
+
+/**
+ * Common options shared between auto and manual update modes
+ */
+
+/**
+ * Configuration with baseURL for standard server-based updates
+ */
+
+/**
+ * Configuration with resolver for custom network operations
+ */
+
+/**
+ * Union type ensuring baseURL and resolver are mutually exclusive
+ */
+
+/**
+ * Internal options after normalization in index.ts
+ * Always has resolver (never baseURL)
+ */
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Helper function to handle notifyAppReady flow
+ */
+const handleNotifyAppReady = async options => {
+  try {
+    // Always call native notifyAppReady for bundle promotion
+    const nativeResult = nativeNotifyAppReady();
+
+    // If resolver.notifyAppReady exists, call it with simplified params
+    if (options.resolver?.notifyAppReady) {
+      await options.resolver.notifyAppReady({
+        status: nativeResult.status,
+        crashedBundleId: nativeResult.crashedBundleId,
+        requestHeaders: options.requestHeaders,
+        requestTimeout: options.requestTimeout
+      }).catch(e => {
+        console.warn("[IpayCodePush] Resolver notifyAppReady failed:", e);
+      });
+    }
+    options.onNotifyAppReady?.(nativeResult);
+  } catch (e) {
+    console.warn("[IpayCodePush] Failed to notify app ready:", e);
+  }
+};
+
+/**
+ * @usage IpayCodePushHOC.wrap({})(App); App Component or any other component
+ * @param options 
+ * @returns 
+ */
+export function wrap(options) {
+  if (options.updateMode === "manual") {
+    return WrappedComponent => {
+      const ManualHOC = props => {
+        useLayoutEffect(() => {
+          void handleNotifyAppReady(options);
+        }, []);
+        return /*#__PURE__*/_jsx(WrappedComponent, {
+          ...props
+        });
+      };
+      return ManualHOC;
+    };
+  }
+
+  // updateMode: "auto"
+  const {
+    reloadOnForceUpdate = true,
+    ...restOptions
+  } = options;
+  return WrappedComponent => {
+    const IpayCodePushHOC = props => {
+      const progress = useIpayCodePushStore(state => state.progress);
+      const [message, setMessage] = useState(null);
+      const [updateStatus, setUpdateStatus] = useState("CHECK_FOR_UPDATE");
+      const initIpayCodePush = useEventCallback(async () => {
+        try {
+          setUpdateStatus("CHECK_FOR_UPDATE");
+          const updateInfo = await checkForUpdate({
+            resolver: restOptions.resolver,
+            updateStrategy: restOptions.updateStrategy,
+            requestHeaders: restOptions.requestHeaders,
+            requestTimeout: restOptions.requestTimeout,
+            onError: restOptions.onError
+          });
+          setMessage(updateInfo?.message ?? null);
+          if (!updateInfo) {
+            restOptions.onUpdateProcessCompleted?.({
+              status: "UP_TO_DATE",
+              shouldForceUpdate: false,
+              message: null,
+              id: getBundleId()
+            });
+            setUpdateStatus("UPDATE_PROCESS_COMPLETED");
+            return;
+          }
+
+          //If forceupdate is not allowed for the bunlde
+          if (updateInfo.shouldForceUpdate === false) {
+            void updateInfo.updateBundle().catch(error => {
+              restOptions.onError?.(error);
+            });
+            restOptions.onUpdateProcessCompleted?.({
+              id: updateInfo.id,
+              status: updateInfo.status,
+              shouldForceUpdate: updateInfo.shouldForceUpdate,
+              message: updateInfo.message
+            });
+            setUpdateStatus("UPDATE_PROCESS_COMPLETED");
+            return;
+          }
+
+          // Force Update Scenario
+          setUpdateStatus("UPDATING");
+          const isSuccess = await updateInfo.updateBundle();
+          if (!isSuccess) {
+            throw new Error("New update was found but failed to download the bundle.");
+          }
+          if (reloadOnForceUpdate) {
+            await reload();
+          }
+          restOptions.onUpdateProcessCompleted?.({
+            id: updateInfo.id,
+            status: updateInfo.status,
+            shouldForceUpdate: updateInfo.shouldForceUpdate,
+            message: updateInfo.message
+          });
+          setUpdateStatus("UPDATE_PROCESS_COMPLETED");
+        } catch (error) {
+          restOptions.onError?.(error);
+          setUpdateStatus("UPDATE_PROCESS_COMPLETED");
+        }
+      });
+      useEffect(() => {
+        restOptions.onProgress?.(progress);
+      }, [progress]);
+
+      // Notify native side that app is ready (JS bundle fully loaded)
+      useLayoutEffect(() => {
+        void handleNotifyAppReady(restOptions);
+      }, []);
+
+      // Start update check
+      useLayoutEffect(() => {
+        initIpayCodePush();
+      }, []);
+      if (restOptions.fallbackComponent && updateStatus !== "UPDATE_PROCESS_COMPLETED") {
+        const Fallback = restOptions.fallbackComponent;
+        return /*#__PURE__*/_jsx(Fallback, {
+          progress: progress,
+          status: updateStatus,
+          message: message
+        });
+      }
+      return /*#__PURE__*/_jsx(WrappedComponent, {
+        ...props
+      });
+    };
+    return IpayCodePushHOC;
+  };
+}
+//# sourceMappingURL=wrap.js.map

package/lib/module/wrap.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","useEffect","useLayoutEffect","useState","checkForUpdate","getBundleId","notifyAppReady","nativeNotifyAppReady","reload","useEventCallback","useIpayCodePushStore","jsx","_jsx","handleNotifyAppReady","options","nativeResult","resolver","status","crashedBundleId","requestHeaders","requestTimeout","catch","e","console","warn","onNotifyAppReady","wrap","updateMode","WrappedComponent","ManualHOC","props","reloadOnForceUpdate","restOptions","IpayCodePushHOC","progress","state","message","setMessage","updateStatus","setUpdateStatus","initIpayCodePush","updateInfo","updateStrategy","onError","onUpdateProcessCompleted","shouldForceUpdate","id","updateBundle","error","isSuccess","Error","onProgress","fallbackComponent","Fallback"],"sourceRoot":"../../src","sources":["wrap.tsx"],"mappings":"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","ignoreList":[]}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/DefaultResolver.d.ts

@@ -0,0 +1,10 @@
+import type { IpayCodePushResolver } from "./types";
+/**
+ * Creates a default resolver that uses baseURL for network operations.
+ * This encapsulates the existing baseURL logic into a resolver.
+ *
+ * @param baseURL - The base URL for the update server
+ * @returns A HotUpdaterResolver that uses the baseURL
+ */
+export declare function createDefaultResolver(baseURL: string): IpayCodePushResolver;
+//# sourceMappingURL=DefaultResolver.d.ts.map

package/lib/typescript/src/DefaultResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DefaultResolver.d.ts","sourceRoot":"","sources":["../../../src/DefaultResolver.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAA6B,MAAM,SAAS,CAAC;AAE/E;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,oBAAoB,CAwB3E"}

package/lib/typescript/src/NativeInstantpayCodePush.d.ts

@@ -0,0 +1,100 @@
+import { type TurboModule } from 'react-native';
+export interface UpdateBundleParams {
+    bundleId: string;
+    fileUrl: string | null;
+    /**
+     * File hash for integrity/signature verification.
+     *
+     * Format depends on signing configuration:
+     * - Signed: `sig:<base64_signature>` - Native will verify signature (and implicitly hash)
+     * - Unsigned: `<hex_hash>` - Native will verify SHA256 hash only
+     *
+     * Native determines verification mode by checking for "sig:" prefix.
+     */
+    fileHash: string | null;
+}
+export interface Spec extends TurboModule {
+    reload(): Promise<void>;
+    /**
+     * Downloads and applies a bundle update.
+     *
+     * @param params - Update bundle parameters
+     * @returns Promise that resolves to true if successful
+     * @throws {IpayCodePushErrorCode} Rejects with one of the following error codes:
+     *
+     *   Parameter validation:
+     *   - MISSING_BUNDLE_ID: Missing or empty bundleId
+     *   - INVALID_FILE_URL: Invalid fileUrl provided
+     *
+     *   Bundle storage:
+     *   - DIRECTORY_CREATION_FAILED: Failed to create bundle directory
+     *   - DOWNLOAD_FAILED: Failed to download bundle
+     *   - INCOMPLETE_DOWNLOAD: Download incomplete (size mismatch)
+     *   - EXTRACTION_FORMAT_ERROR: Invalid or corrupted archive format
+     *   - INVALID_BUNDLE: Bundle missing required platform files
+     *   - INSUFFICIENT_DISK_SPACE: Insufficient disk space
+     *   - MOVE_OPERATION_FAILED: Failed to move bundle files
+     *   - BUNDLE_IN_CRASHED_HISTORY: Bundle was previously marked as crashed
+     *
+     *   Signature:
+     *   - SIGNATURE_VERIFICATION_FAILED: Any signature/hash verification failure
+     *
+     *   Internal:
+     *   - SELF_DEALLOCATED: Native object was deallocated (iOS)
+     *   - UNKNOWN_ERROR: Fallback for rare or platform-specific errors
+     *
+     *   Note: iOS normalizes rare signature/storage errors to SIGNATURE_VERIFICATION_FAILED
+     *   or UNKNOWN_ERROR to keep the JS error surface small.
+     */
+    updateBundle(params: UpdateBundleParams): Promise<boolean>;
+    /**
+     * Notifies the native side that the app has successfully started with the given bundle.
+     * If the bundle matches the staging bundle, it promotes to stable.
+     *
+     * @param params - Parameters containing the bundle ID
+     * @returns Object with status and optional crashedBundleId
+     * - `status: "PROMOTED"` - Staging bundle was promoted to stable (ACTIVE event)
+     * - `status: "RECOVERED"` - App recovered from crash, rollback occurred (ROLLBACK event)
+     * - `status: "STABLE"` - No changes, already stable
+     * - `crashedBundleId` - Present only when status is "RECOVERED"
+     */
+    notifyAppReady(params: {
+        bundleId: string;
+    }): {
+        status: "PROMOTED" | "RECOVERED" | "STABLE";
+        crashedBundleId?: string;
+    };
+    /**
+     * Gets the list of bundle IDs that have been marked as crashed.
+     * These bundles will be rejected if attempted to install again.
+     *
+     * @returns Array of crashed bundle IDs
+     */
+    getCrashHistory(): string[];
+    /**
+     * Clears the crashed bundle history, allowing previously crashed bundles
+     * to be installed again.
+     *
+     * @returns true if clearing was successful
+     */
+    clearCrashHistory(): boolean;
+    /**
+     * Gets the base URL for the current active bundle directory.
+     * Returns the file:// URL to the bundle directory without trailing slash.
+     * This is used for Expo DOM components to construct full asset paths.
+     *
+     * @returns Base URL string (e.g., "file:///data/.../bundle-store/abc123") or "" if not available
+     */
+    getBaseURL: () => string;
+    addListener(eventName: string): void;
+    removeListeners(count: number): void;
+    readonly getConstants: () => {
+        MIN_BUNDLE_ID: string;
+        APP_VERSION: string | null;
+        CHANNEL: string;
+        FINGERPRINT_HASH: string | null;
+    };
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeInstantpayCodePush.d.ts.map

package/lib/typescript/src/NativeInstantpayCodePush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeInstantpayCodePush.d.ts","sourceRoot":"","sources":["../../../src/NativeInstantpayCodePush.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,WAAW,EAAE,MAAM,cAAc,CAAC;AAGrE,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;;;;;;;OAQG;IACH,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,IAAK,SAAQ,WAAW;IAGrC,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3D;;;;;;;;;;OAUG;IACH,cAAc,CAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG;QAC1C,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,CAAC;QAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;KAC5B,CAAC;IAEF;;;;;OAKG;IACH,eAAe,IAAI,MAAM,EAAE,CAAC;IAE5B;;;;;OAKG;IACH,iBAAiB,IAAI,OAAO,CAAC;IAE7B;;;;;;OAMG;IACH,UAAU,EAAE,MAAM,MAAM,CAAC;IAGzB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErC,QAAQ,CAAC,YAAY,EAAE,MAAM;QACzB,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,OAAO,EAAE,MAAM,CAAC;QAChB,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;KACnC,CAAC;CACL;;AAED,wBAA4E"}

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

@@ -0,0 +1,29 @@
+import type { IpayCodePushResolver, AppUpdateInfo } from "./types";
+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 IpayCodePush.wrap()
+     */
+    updateStrategy: "appVersion" | "fingerprint";
+    requestHeaders?: Record<string, string>;
+    onError?: (error: Error) => void;
+    /**
+     * The timeout duration for the request.
+     * @default 5000
+     */
+    requestTimeout?: number;
+}
+export type CheckForUpdateResult = AppUpdateInfo & {
+    /**
+     * Updates the bundle.
+     * This method is equivalent to `IpayCodePush.updateBundle()` but with all required arguments pre-filled.
+     */
+    updateBundle: () => Promise<boolean>;
+};
+export interface InternalCheckForUpdateOptions extends CheckForUpdateOptions {
+    resolver: IpayCodePushResolver;
+}
+export declare function checkForUpdate(options: InternalCheckForUpdateOptions): Promise<CheckForUpdateResult | null>;
+//# sourceMappingURL=checkForUpdate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"checkForUpdate.d.ts","sourceRoot":"","sources":["../../../src/checkForUpdate.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAGnE,MAAM,WAAW,qBAAqB;IAClC;;;;;OAKG;IACH,cAAc,EAAE,YAAY,GAAG,aAAa,CAAC;IAE7C,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAExC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,oBAAoB,GAAG,aAAa,GAAG;IAC/C;;;OAGG;IACH,YAAY,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CACxC,CAAC;AAGF,MAAM,WAAW,6BAA8B,SAAQ,qBAAqB;IACxE,QAAQ,EAAE,oBAAoB,CAAC;CAClC;AAED,wBAAsB,cAAc,CAChC,OAAO,EAAE,6BAA6B,GACvC,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAwEtC"}

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

@@ -0,0 +1,124 @@
+/**
+ * Ipay Code Push Error Codes
+ *
+ * This file defines all possible error codes that can be thrown by the native
+ * updateBundle function. These error codes are shared across iOS and Android
+ * implementations to ensure consistent error handling.
+ *
+ * Error Classification:
+ * - Parameter Validation: Invalid or missing function parameters
+ * - Bundle Storage: Errors during download, extraction, and storage
+ * - Signature Verification: Cryptographic verification failures (collapsed to a single public code)
+ * - Internal: Platform-specific or unexpected errors
+ *
+ * Retryability:
+ * - Retryable: DOWNLOAD_FAILED, INCOMPLETE_DOWNLOAD
+ * - Non-retryable: Most validation and verification errors
+ */
+export declare enum IpayCodePushErrorCode {
+    /**
+     * Bundle ID is missing or empty.
+     * Thrown when bundleId parameter is null, undefined, or empty string.
+     * @retryable false
+     */
+    MISSING_BUNDLE_ID = "MISSING_BUNDLE_ID",
+    /**
+     * File URL is invalid or malformed.
+     * Thrown when fileUrl parameter cannot be parsed as a valid URL.
+     * @retryable false
+     */
+    INVALID_FILE_URL = "INVALID_FILE_URL",
+    /**
+     * Failed to create required directory for bundle storage.
+     * Thrown when bundle directory creation fails due to permissions or disk errors.
+     * @retryable false - Usually indicates permissions or filesystem corruption
+     */
+    DIRECTORY_CREATION_FAILED = "DIRECTORY_CREATION_FAILED",
+    /**
+     * Bundle download failed.
+     * Covers network errors, HTTP errors (4xx/5xx), timeouts, and connection issues.
+     * Check error message for specific cause (network, HTTP status code, etc.).
+     * @retryable true - Network issues are often transient
+     */
+    DOWNLOAD_FAILED = "DOWNLOAD_FAILED",
+    /**
+     * Download incomplete - received size doesn't match expected size.
+     * Thrown when downloaded file size doesn't match Content-Length header.
+     * Error message includes both expected and actual byte counts.
+     * @retryable true - Download may succeed on retry
+     */
+    INCOMPLETE_DOWNLOAD = "INCOMPLETE_DOWNLOAD",
+    /**
+     * Bundle archive format is invalid or corrupted.
+     * Thrown when ZIP file has wrong magic bytes, invalid structure, or unsupported format.
+     * Also thrown for path traversal attempts during extraction.
+     * @retryable false - Indicates corrupted or malicious bundle
+     */
+    EXTRACTION_FORMAT_ERROR = "EXTRACTION_FORMAT_ERROR",
+    /**
+     * Bundle missing required platform files.
+     * Thrown when extracted bundle doesn't contain index.android.bundle (Android)
+     * or main.jsbundle (iOS).
+     * @retryable false - Indicates incorrectly built bundle
+     */
+    INVALID_BUNDLE = "INVALID_BUNDLE",
+    /**
+     * Insufficient disk space for bundle download and extraction.
+     * Thrown when available disk space is less than required (file size * 2).
+     * Error message includes required and available bytes.
+     * @retryable false - User must free up disk space
+     */
+    INSUFFICIENT_DISK_SPACE = "INSUFFICIENT_DISK_SPACE",
+    /**
+     * Bundle signature verification failed (general).
+     * Thrown when cryptographic signature verification fails.
+     * All signature/hash sub-errors are collapsed into this public code.
+     * @retryable false - Indicates tampered or incorrectly signed bundle
+     */
+    SIGNATURE_VERIFICATION_FAILED = "SIGNATURE_VERIFICATION_FAILED",
+    /**
+     * Failed to move bundle to final location.
+     * Thrown when atomic move from temp directory to final directory fails.
+     * iOS: Thrown if move operation fails.
+     * Android: Thrown if rename, move, AND copy all fail.
+     * @retryable false - Usually indicates filesystem corruption or permissions
+     */
+    MOVE_OPERATION_FAILED = "MOVE_OPERATION_FAILED",
+    /**
+     * Bundle is in crashed history and cannot be applied.
+     * Thrown when attempting to install a bundle that previously caused a crash.
+     * Use IpayCodePush.clearCrashHistory() to allow retrying this bundle.
+     * @retryable false - Bundle was marked as crashed for safety
+     */
+    BUNDLE_IN_CRASHED_HISTORY = "BUNDLE_IN_CRASHED_HISTORY",
+    /**
+     * Internal error: self deallocated during update (iOS only).
+     * Thrown when the native object is deallocated mid-operation.
+     * iOS-specific due to manual memory management (ARC).
+     * Not applicable to Android (uses garbage collection).
+     * @platform iOS
+     * @retryable false - Memory management issue
+     */
+    SELF_DEALLOCATED = "SELF_DEALLOCATED",
+    /**
+     * An unknown or unexpected error occurred.
+     * Catch-all for errors that don't fit other categories.
+     * Check error message for details.
+     * @retryable unknown - Depends on underlying cause
+     */
+    UNKNOWN_ERROR = "UNKNOWN_ERROR"
+}
+/**
+ * Type guard to check if an error is a IpayCodePushError
+ */
+export declare function isIpayCodePushError(error: unknown): error is {
+    code: IpayCodePushErrorCode;
+    message: string;
+};
+/**
+ * Base error class for Ipay Code Push
+ */
+export declare class IpayCodePushError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=error.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../../../src/error.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,oBAAY,qBAAqB;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;CAClC;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAC/B,KAAK,EAAE,OAAO,GACf,KAAK,IAAI;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAU3D;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI9B"}

package/lib/typescript/src/fetchUpdateInfo.d.ts

@@ -0,0 +1,8 @@
+import type { AppUpdateInfo } from "./types";
+export declare const fetchUpdateInfo: ({ url, requestHeaders, onError, requestTimeout, }: {
+    url: string;
+    requestHeaders?: Record<string, string>;
+    onError?: (error: Error) => void;
+    requestTimeout?: number;
+}) => Promise<AppUpdateInfo | null>;
+//# sourceMappingURL=fetchUpdateInfo.d.ts.map

package/lib/typescript/src/fetchUpdateInfo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchUpdateInfo.d.ts","sourceRoot":"","sources":["../../../src/fetchUpdateInfo.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,eAAO,MAAM,eAAe,GAAU,mDAKnC;IACC,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B,KAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAkC/B,CAAC"}

package/lib/typescript/src/hooks/useEventCallback.d.ts

@@ -0,0 +1,5 @@
+type EventCallback<Args extends unknown[], R> = ((...args: Args) => R) | undefined;
+export declare function useEventCallback<Args extends unknown[], R>(fn: (...args: Args) => R): (...args: Args) => R;
+export declare function useEventCallback<Args extends unknown[], R>(fn: EventCallback<Args, R>): EventCallback<Args, R>;
+export {};
+//# sourceMappingURL=useEventCallback.d.ts.map

package/lib/typescript/src/hooks/useEventCallback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEventCallback.d.ts","sourceRoot":"","sources":["../../../../src/hooks/useEventCallback.ts"],"names":[],"mappings":"AAEA,KAAK,aAAa,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,IACxC,CAAC,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,GACtB,SAAS,CAAC;AAEd,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EACtD,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,GACzB,CAAC,GAAG,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC;AAExB,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,OAAO,EAAE,EAAE,CAAC,EACtD,EAAE,EAAE,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,GAC3B,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC"}