react-native-instantpay-code-push 1.1.0

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

@@ -0,0 +1,179 @@
+import React from "react";
+import { type NotifyAppReadyResult } from "./native";
+import type { IpayCodePushResolver } from "./types";
+import type { IpayCodePushError } from "./error";
+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";
+/**
+ * Common options shared between auto and manual update modes
+ */
+interface CommonIpayCodePushOptions {
+    /**
+     * 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 bundle verification completes.
+     * Provides information about bundle promotion, recovery from crashes, or stable state.
+     *
+     * @param result - Bundle state information
+     * @param result.status - Current bundle state:
+     *   - "PROMOTED": Staging bundle was promoted to stable (new update applied)
+     *   - "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
+     * IpayCodePush.wrap({
+     *   baseURL: "https://api.example.com",
+     *   updateMode: "manual",
+     *   onNotifyAppReady: ({ status, crashedBundleId }) => {
+     *     if (status === "RECOVERED") {
+     *       analytics.track('bundle_rollback', { crashedBundleId });
+     *     } else if (status === "PROMOTED") {
+     *       analytics.track('bundle_promoted');
+     *     }
+     *   }
+     * })(App);
+     * ```
+     */
+    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
+}
+/**
+ * Configuration with baseURL for standard server-based updates
+ */
+interface BaseURLConfig {
+    /**
+     * Base URL for update server
+     * @example "https://update.example.com"
+     */
+    baseURL: string;
+    /**
+     * Resolver is not allowed when using baseURL
+     */
+    resolver?: never;
+}
+/**
+ * Configuration with resolver for custom network operations
+ */
+interface ResolverConfig {
+    /**
+     * Custom resolver for network operations
+     */
+    resolver: IpayCodePushResolver;
+    /**
+     * 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 = CommonIpayCodePushOptions & NetworkConfig & {
+    /**
+     * Update strategy
+     * - "fingerprint": Use fingerprint hash to check for updates
+     * - "appVersion": Use app version to check for updates
+     */
+    updateStrategy: "fingerprint" | "appVersion";
+    /**
+     * Update mode
+     * - "auto": Automatically check and download updates
+     */
+    updateMode: "auto";
+    onError?: (error: IpayCodePushError | Error | unknown) => void;
+    /**
+     * 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.
+     *
+     *
+     * ```tsx
+     * IpayCodePush.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<{
+        status: Exclude<UpdateStatus, "UPDATE_PROCESS_COMPLETED">;
+        progress: number;
+        message: string | null;
+    }>;
+    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.
+     *
+     */
+    onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
+};
+export type ManualUpdateOptions = CommonIpayCodePushOptions & NetworkConfig & {
+    /**
+     * Update mode
+     * - "manual": Only notify app ready, user manually calls checkForUpdate()
+     */
+    updateMode: "manual";
+};
+export type IpayCodePushOptions = AutoUpdateOptions | ManualUpdateOptions;
+/**
+ * Internal options after normalization in index.ts
+ * Always has resolver (never baseURL)
+ */
+type InternalCommonOptions = {
+    resolver: IpayCodePushResolver;
+    requestHeaders?: Record<string, string>;
+    requestTimeout?: number;
+    onNotifyAppReady?: (result: NotifyAppReadyResult) => void;
+};
+type InternalAutoUpdateOptions = InternalCommonOptions & {
+    updateStrategy: "fingerprint" | "appVersion";
+    updateMode: "auto";
+    onError?: (error: IpayCodePushError | Error | unknown) => void;
+    fallbackComponent?: React.FC<{
+        status: Exclude<UpdateStatus, "UPDATE_PROCESS_COMPLETED">;
+        progress: number;
+        message: string | null;
+    }>;
+    onProgress?: (progress: number) => void;
+    reloadOnForceUpdate?: boolean;
+    onUpdateProcessCompleted?: (response: RunUpdateProcessResponse) => void;
+};
+type InternalManualUpdateOptions = InternalCommonOptions & {
+    updateMode: "manual";
+};
+export type InternalWrapOptions = InternalAutoUpdateOptions | InternalManualUpdateOptions;
+/**
+ * @usage IpayCodePushHOC.wrap({})(App); App Component or any other component
+ * @param options
+ * @returns
+ */
+export declare function wrap<T extends React.JSX.IntrinsicAttributes = object>(options: InternalWrapOptions): (WrappedComponent: React.ComponentType<T>) => React.ComponentType<T>;
+export {};
+//# sourceMappingURL=wrap.d.ts.map

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

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

package/package.json

@@ -0,0 +1,174 @@
+{
+  "name": "react-native-instantpay-code-push",
+  "version": "1.1.0",
+  "description": "React Native plugin for the CodePush service",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-instantpay-code-push-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version",
+    "generateBundle" : "ruby generateBundle.rb --projectDir /var/www/npm-package/react-native-instantpay-code-push/example --platform ANDROID --enableHermes true"
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/InstantPay/react-native-instantpay-code-push.git"
+  },
+  "author": "Dhananjay Kumar <dhananjayspeed@gmail.com> (https://github.com/InstantPay)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/InstantPay/react-native-instantpay-code-push/issues"
+  },
+  "homepage": "https://github.com/InstantPay/react-native-instantpay-code-push#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^19.8.1",
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.83.0",
+    "@react-native/eslint-config": "0.83.0",
+    "@release-it/conventional-changelog": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "@types/react": "^19.2.0",
+    "@types/use-sync-external-store": "^1.5.0",
+    "commitlint": "^19.8.1",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "jest": "^29.7.0",
+    "lefthook": "^2.0.3",
+    "prettier": "^3.0.4",
+    "react": "19.2.0",
+    "react-native": "0.83.0",
+    "react-native-builder-bob": "^0.40.17",
+    "release-it": "^19.0.4",
+    "turbo": "^2.5.6",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "InstantpayCodePushSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.instantpaycodepush"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "react-native",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ]
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.56.0"
+  },
+  "dependencies": {
+    "use-sync-external-store": "1.6.0"
+  }
+}

package/src/DefaultResolver.ts

@@ -0,0 +1,36 @@
+import type { AppUpdateInfo } from "./types";
+import { fetchUpdateInfo } from "./fetchUpdateInfo";
+import type { IpayCodePushResolver, ResolverCheckUpdateParams } 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 function createDefaultResolver(baseURL: string): IpayCodePushResolver {
+    return {
+        checkUpdate: async (
+            params: ResolverCheckUpdateParams,
+        ): Promise<AppUpdateInfo | null> => {
+            // Build URL based on strategy (existing buildUpdateUrl logic)
+            let url: string;
+            if (params.updateStrategy === "fingerprint") {
+                if (!params.fingerprintHash) {
+                    throw new Error("Fingerprint hash is required");
+                }
+                url = `${baseURL}/fingerprint/${params.platform}/${params.fingerprintHash}/${params.channel}/${params.minBundleId}/${params.bundleId}`;
+            } else {
+                url = `${baseURL}/app-version/${params.platform}/${params.appVersion}/${params.channel}/${params.minBundleId}/${params.bundleId}`;
+            }
+
+            // Use existing fetchUpdateInfo
+            return fetchUpdateInfo({
+                url,
+                requestHeaders: params.requestHeaders,
+                requestTimeout: params.requestTimeout,
+            });
+        },
+    };
+}

package/src/NativeInstantpayCodePush.ts

@@ -0,0 +1,111 @@
+import { TurboModuleRegistry, 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 {
+
+    // Methods
+    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;
+
+    // EventEmitter
+    addListener(eventName: string): void;
+
+    removeListeners(count: number): void;
+    
+    readonly getConstants: () => {
+        MIN_BUNDLE_ID: string;
+        APP_VERSION: string | null;
+        CHANNEL: string;
+        FINGERPRINT_HASH: string | null;
+    };
+}
+
+export default TurboModuleRegistry.getEnforcing<Spec>('InstantpayCodePush');

package/src/checkForUpdate.ts

@@ -0,0 +1,122 @@
+import { Platform } from "react-native";
+import { IpayCodePushError } from "./error";
+
+import {
+    getAppVersion,
+    getBundleId,
+    getChannel,
+    getFingerprintHash,
+    getMinBundleId,
+    updateBundle,
+} from "./native";
+
+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>;
+};
+
+// Internal type that includes resolver for use within index.ts
+export interface InternalCheckForUpdateOptions extends CheckForUpdateOptions {
+    resolver: IpayCodePushResolver;
+}
+
+export async function checkForUpdate(
+    options: InternalCheckForUpdateOptions,
+): Promise<CheckForUpdateResult | null> {
+    if (__DEV__) {
+        console.log('checkForUpdate : Running in dev mode')
+        return null;
+    }
+
+    if(Platform.OS == 'ios'){
+        console.log("Under Development in iOS Platform");
+        return null;
+    }
+
+    if (!["ios", "android"].includes(Platform.OS)) {
+        options.onError?.(
+            new IpayCodePushError("IpayCodePush is only supported on iOS and Android"),
+        );
+        return null;
+    }
+
+    const currentAppVersion = getAppVersion();
+    const platform = Platform.OS as "ios" | "android";
+    const currentBundleId = getBundleId();
+    const minBundleId = getMinBundleId();
+    const channel = getChannel();
+
+    if (!currentAppVersion) {
+        options.onError?.(new IpayCodePushError("Failed to get app version"));
+        return null;
+    }
+
+    const fingerprintHash = getFingerprintHash();
+
+    if (!options.resolver?.checkUpdate) {
+        options.onError?.(
+            new IpayCodePushError("Resolver is required but not configured"),
+        );
+        return null;
+    }
+
+    let updateInfo: AppUpdateInfo | null = null;
+
+    try {
+        updateInfo = await options.resolver.checkUpdate({
+            platform,
+            appVersion: currentAppVersion,
+            bundleId: currentBundleId,
+            minBundleId,
+            channel,
+            updateStrategy: options.updateStrategy,
+            fingerprintHash,
+            requestHeaders: options.requestHeaders,
+            requestTimeout: options.requestTimeout,
+        });
+    } catch (error) {
+        options.onError?.(error as Error);
+        return null;
+    }
+
+    if (!updateInfo) {
+        return null;
+    }
+
+    return {
+        ...updateInfo,
+        updateBundle: async () => {
+            return updateBundle({
+                bundleId: updateInfo.id,
+                fileUrl: updateInfo.fileUrl,
+                fileHash: updateInfo.fileHash,
+                status: updateInfo.status,
+            });
+        },
+    };
+}