@hot-updater/core 0.1.6-0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 Sungyu Kang 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,36 @@
+"use strict";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = function(exports1, definition) {
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = function(obj, prop) {
+        return Object.prototype.hasOwnProperty.call(obj, prop);
+    };
+})();
+(()=>{
+    __webpack_require__.r = function(exports1) {
+        if ('undefined' != typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    NIL_UUID: ()=>NIL_UUID
+});
+const NIL_UUID = "00000000-0000-0000-0000-000000000000";
+var __webpack_export_target__ = exports;
+for(var __webpack_i__ in __webpack_exports__)__webpack_export_target__[__webpack_i__] = __webpack_exports__[__webpack_i__];
+if (__webpack_exports__.__esModule) Object.defineProperty(__webpack_export_target__, '__esModule', {
+    value: true
+});

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export type * from "./types";
+export * from "./uuid";

package/dist/index.js

@@ -0,0 +1,2 @@
+const NIL_UUID = "00000000-0000-0000-0000-000000000000";
+export { NIL_UUID };

package/dist/test-utils/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./setupGetUpdateInfoTestSuite";
+export * from "./setupSemverSatisfiesTestSuite";

package/dist/test-utils/setupGetUpdateInfoTestSuite.d.ts

@@ -0,0 +1,4 @@
+import type { Bundle, GetBundlesArgs, UpdateInfo } from "../types";
+export declare const setupGetUpdateInfoTestSuite: ({ getUpdateInfo, }: {
+    getUpdateInfo: (bundles: Bundle[], options: GetBundlesArgs) => Promise<UpdateInfo | null>;
+}) => void;

package/dist/test-utils/setupSemverSatisfiesTestSuite.d.ts

@@ -0,0 +1,20 @@
+/**
+ *
+ * Filters based on semver. And sorts by the highest bundle version.
+ *
+ * * Range Expression Table:
+ *
+ * | Range Expression | Who gets the update                                                    |
+ * |------------------|------------------------------------------------------------------------|
+ * | 1.2.3            | Only devices running the specific binary app store version 1.2.3 of your app |
+ * | *                | Any device configured to consume updates from your CodePush app         |
+ * | 1.2.x            | Devices running major version 1, minor version 2 and any patch version of your app |
+ * | 1.2.3 - 1.2.7    | Devices running any binary version between 1.2.3 (inclusive) and 1.2.7 (inclusive) |
+ * | >=1.2.3 <1.2.7   | Devices running any binary version between 1.2.3 (inclusive) and 1.2.7 (exclusive) |
+ * | 1.2              | Equivalent to >=1.2.0 <1.3.0                                            |
+ * | ~1.2.3           | Equivalent to >=1.2.3 <1.3.0                                            |
+ * | ^1.2.3           | Equivalent to >=1.2.3 <2.0.0                                            |
+ */
+export declare const setupSemverSatisfiesTestSuite: ({ semverSatisfies, }: {
+    semverSatisfies: (targetVersion: string, currentVersion: string) => Promise<boolean> | boolean;
+}) => void;

package/dist/types.d.ts

@@ -0,0 +1,53 @@
+export type Platform = "ios" | "android";
+export interface Bundle {
+    /**
+     * The unique identifier for the bundle. uuidv7
+     */
+    id: string;
+    /**
+     * The platform the bundle is for.
+     */
+    platform: Platform;
+    /**
+     * The target version of the bundle.
+     */
+    targetVersion: string;
+    /**
+     * Whether the bundle should force an update.
+     */
+    forceUpdate: boolean;
+    /**
+     * Whether the bundle is enabled.
+     */
+    enabled: boolean;
+    /**
+     * The file URL of the bundle.
+     */
+    fileUrl: string;
+    /**
+     * The hash of the bundle.
+     */
+    fileHash: string;
+    /**
+     * The git commit hash of the bundle.
+     */
+    gitCommitHash: string | null;
+    /**
+     * The message of the bundle.
+     */
+    message: string | null;
+}
+export type BundleArg = string | Bundle[] | (() => Promise<Bundle[]>) | (() => Bundle[]);
+export type UpdateStatus = "ROLLBACK" | "UPDATE";
+export interface UpdateInfo {
+    id: string;
+    forceUpdate: boolean;
+    fileUrl: string | null;
+    fileHash: string | null;
+    status: UpdateStatus;
+}
+export interface GetBundlesArgs {
+    platform: Platform;
+    bundleId: string;
+    appVersion: string;
+}

package/dist/uuid.d.ts

@@ -0,0 +1 @@
+export declare const NIL_UUID = "00000000-0000-0000-0000-000000000000";

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@hot-updater/core",
+  "version": "0.1.6-0",
+  "type": "module",
+  "description": "React Native OTA solution for self-hosted",
+  "sideEffects": false,
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./test-utils": {
+      "types": "./src/test-utils/index.ts",
+      "import": "./src/test-utils/index.ts",
+      "require": "./src/test-utils/index.ts"
+    }
+  },
+  "files": [
+    "src",
+    "dist",
+    "package.json"
+  ],
+  "keywords": [
+    "react-native",
+    "react-native-code-push",
+    "code-push",
+    "eas",
+    "eas-update",
+    "expo",
+    "expo-update",
+    "self-hosted"
+  ],
+  "license": "MIT",
+  "repository": "https://github.com/gronxb/hot-updater",
+  "author": "gronxb <gron1gh1@gmail.com> (https://github.com/gronxb)",
+  "bugs": {
+    "url": "https://github.com/gronxb/hot-updater/issues"
+  },
+  "homepage": "https://github.com/gronxb/hot-updater#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@rslib/core": "^0.2.2",
+    "@types/node": "^20.9.4",
+    "vitest": "^2.1.8"
+  },
+  "scripts": {
+    "build": "rslib build",
+    "test:type": "tsc --noEmit"
+  }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export type * from "./types";
+export * from "./uuid";

package/src/test-utils/index.ts

@@ -0,0 +1,2 @@
+export * from "./setupGetUpdateInfoTestSuite";
+export * from "./setupSemverSatisfiesTestSuite";

package/src/test-utils/setupGetUpdateInfoTestSuite.ts

@@ -0,0 +1,556 @@
+import { expect, it } from "vitest";
+import type { Bundle, GetBundlesArgs, UpdateInfo } from "../types";
+import { NIL_UUID } from "../uuid";
+
+const DEFAULT_BUNDLE = {
+  fileUrl: "http://example.com/bundle.zip",
+  fileHash: "hash",
+  platform: "ios",
+  gitCommitHash: null,
+  message: null,
+} as const;
+
+export const setupGetUpdateInfoTestSuite = ({
+  getUpdateInfo,
+}: {
+  getUpdateInfo: (
+    bundles: Bundle[],
+    options: GetBundlesArgs,
+  ) => Promise<UpdateInfo | null>;
+}) => {
+  it("applies an update when a '*' bundle is available", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "*",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: NIL_UUID,
+      platform: "ios",
+    });
+
+    expect(update).toStrictEqual({
+      id: "00000000-0000-0000-0000-000000000001",
+      fileUrl: "http://example.com/bundle.zip",
+      fileHash: "hash",
+      forceUpdate: false,
+      status: "UPDATE",
+    });
+  });
+
+  it("returns null when no bundles are provided", async () => {
+    const bundles: Bundle[] = [];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: NIL_UUID,
+      platform: "ios",
+    });
+    expect(update).toBeNull();
+  });
+
+  it("returns null when the app version does not qualify for the available higher version", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.1",
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+        forceUpdate: false,
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: NIL_UUID,
+      platform: "ios",
+    });
+    expect(update).toBeNull();
+  });
+
+  it("applies an update when a higher semver-compatible bundle is available", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.x.x",
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+        forceUpdate: false,
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000002",
+        forceUpdate: false,
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: NIL_UUID,
+      platform: "ios",
+    });
+    expect(update).toStrictEqual({
+      id: "00000000-0000-0000-0000-000000000002",
+      forceUpdate: false,
+      status: "UPDATE",
+      fileUrl: "http://example.com/bundle.zip",
+      fileHash: "hash",
+    });
+  });
+
+  it("applies an update if forceUpdate is true for a matching version", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+        forceUpdate: true,
+      },
+    ];
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: NIL_UUID,
+      platform: "ios",
+    });
+
+    expect(update).toStrictEqual({
+      id: "00000000-0000-0000-0000-000000000001",
+      forceUpdate: true,
+      status: "UPDATE",
+      fileUrl: "http://example.com/bundle.zip",
+      fileHash: "hash",
+    });
+  });
+
+  it("applies an update for a matching version even if forceUpdate is false", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+        forceUpdate: false,
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: NIL_UUID,
+      platform: "ios",
+    });
+    expect(update).toStrictEqual({
+      id: "00000000-0000-0000-0000-000000000001",
+      forceUpdate: false,
+      status: "UPDATE",
+      fileUrl: "http://example.com/bundle.zip",
+      fileHash: "hash",
+    });
+  });
+
+  it("applies an update when the app version is the same but the bundle is still considered higher", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000005",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: NIL_UUID,
+      platform: "ios",
+    });
+    expect(update).toStrictEqual({
+      id: "00000000-0000-0000-0000-000000000005",
+      forceUpdate: false,
+      fileUrl: "http://example.com/bundle.zip",
+      fileHash: "hash",
+      status: "UPDATE",
+    });
+  });
+
+  it("falls back to an older enabled bundle when the latest is disabled", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: true,
+        enabled: false, // Disabled
+        id: "00000000-0000-0000-0000-000000000002",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: NIL_UUID,
+      platform: "ios",
+    });
+    expect(update).toStrictEqual({
+      fileUrl: "http://example.com/bundle.zip",
+      fileHash: "hash",
+      id: "00000000-0000-0000-0000-000000000001",
+      forceUpdate: false,
+      status: "UPDATE",
+    });
+  });
+
+  it("returns null if all bundles are disabled", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: true,
+        enabled: false, // Disabled
+        id: "00000000-0000-0000-0000-000000000002",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: false, // Disabled
+        id: "00000000-0000-0000-0000-000000000001",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: NIL_UUID,
+      platform: "ios",
+    });
+    expect(update).toBeNull();
+  });
+
+  it("triggers a rollback if the latest bundle is disabled and no other updates are enabled", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: true,
+        enabled: false, // Disabled
+        id: "00000000-0000-0000-0000-000000000002",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: false, // Disabled
+        id: "00000000-0000-0000-0000-000000000001",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: NIL_UUID,
+      platform: "ios",
+    });
+    expect(update).toStrictEqual(null);
+  });
+
+  it("applies an update when a same-version bundle is available and enabled", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        forceUpdate: false,
+        fileUrl: "20240722210327/build.zip",
+        fileHash:
+          "a5cbf59a627759a88d472c502423ff55a4f6cd1aafeed3536f6a5f6e870c2290",
+        message: "",
+        targetVersion: "1.0",
+        id: "00000000-0000-0000-0000-000000000001",
+        enabled: true,
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: NIL_UUID,
+      platform: "ios",
+    });
+    expect(update).toStrictEqual({
+      id: "00000000-0000-0000-0000-000000000001",
+      forceUpdate: false,
+      status: "UPDATE",
+      fileUrl: "20240722210327/build.zip",
+      fileHash:
+        "a5cbf59a627759a88d472c502423ff55a4f6cd1aafeed3536f6a5f6e870c2290",
+    });
+  });
+
+  it("forces a rollback if no matching bundle exists for the provided bundleId", async () => {
+    const bundles: Bundle[] = [];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: "00000000-0000-0000-0000-000000000002",
+      platform: "ios",
+    });
+    expect(update).toStrictEqual({
+      fileUrl: null,
+      fileHash: null,
+      id: NIL_UUID,
+      forceUpdate: true, // Cause the app to reload
+      status: "ROLLBACK",
+    });
+  });
+
+  it("returns null if the user is already up-to-date with an available bundle", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000002",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: "00000000-0000-0000-0000-000000000002",
+      platform: "ios",
+    });
+    expect(update).toBeNull();
+  });
+
+  it("triggers a rollback if the previously used bundle no longer exists", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: "00000000-0000-0000-0000-000000000002",
+      platform: "ios",
+    });
+    expect(update).toStrictEqual({
+      fileHash: "hash",
+      fileUrl: "http://example.com/bundle.zip",
+      id: "00000000-0000-0000-0000-000000000001",
+      forceUpdate: true,
+      status: "ROLLBACK",
+    });
+  });
+
+  it("selects the next available bundle even if forceUpdate is false", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000003",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000002",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: "00000000-0000-0000-0000-000000000002",
+      platform: "ios",
+    });
+    expect(update).toStrictEqual({
+      fileUrl: "http://example.com/bundle.zip",
+      fileHash: "hash",
+      id: "00000000-0000-0000-0000-000000000003",
+      forceUpdate: false,
+      status: "UPDATE",
+    });
+  });
+
+  it("applies the highest available bundle even if the app version is unchanged", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000005", // Higher than the current version
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000004",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        platform: "ios",
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000003",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000002",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: "00000000-0000-0000-0000-000000000002",
+      platform: "ios",
+    });
+    expect(update).toStrictEqual({
+      fileUrl: "http://example.com/bundle.zip",
+      fileHash: "hash",
+      id: "00000000-0000-0000-0000-000000000005",
+      forceUpdate: false,
+      status: "UPDATE",
+    });
+  });
+
+  it("returns null if the newest matching bundle is disabled", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: true,
+        enabled: false, // Disabled
+        id: "00000000-0000-0000-0000-000000000003",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: true,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000002",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: "00000000-0000-0000-0000-000000000002",
+      platform: "ios",
+    });
+    expect(update).toBeNull();
+  });
+
+  it("rolls back to an older enabled bundle if the current one is disabled", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: true,
+        enabled: false, // Disabled
+        id: "00000000-0000-0000-0000-000000000002",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: true,
+        id: "00000000-0000-0000-0000-000000000001",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: "00000000-0000-0000-0000-000000000002",
+      platform: "ios",
+    });
+
+    expect(update).toStrictEqual({
+      fileUrl: "http://example.com/bundle.zip",
+      fileHash: "hash",
+      id: "00000000-0000-0000-0000-000000000001",
+      forceUpdate: true, // Cause the app to reload
+      status: "ROLLBACK",
+    });
+  });
+
+  it("rolls back to the original bundle when all available bundles are disabled", async () => {
+    const bundles: Bundle[] = [
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: true,
+        enabled: false, // Disabled
+        id: "00000000-0000-0000-0000-000000000002",
+      },
+      {
+        ...DEFAULT_BUNDLE,
+        targetVersion: "1.0",
+        forceUpdate: false,
+        enabled: false, // Disabled
+        id: "00000000-0000-0000-0000-000000000001",
+      },
+    ];
+
+    const update = await getUpdateInfo(bundles, {
+      appVersion: "1.0",
+      bundleId: "00000000-0000-0000-0000-000000000002",
+      platform: "ios",
+    });
+    expect(update).toStrictEqual({
+      id: NIL_UUID,
+      fileUrl: null,
+      fileHash: null,
+      forceUpdate: true, // Cause the app to reload
+      status: "ROLLBACK",
+    });
+  });
+};

package/src/test-utils/setupSemverSatisfiesTestSuite.ts

@@ -0,0 +1,139 @@
+import { expect, it } from "vitest";
+
+/**
+ *
+ * Filters based on semver. And sorts by the highest bundle version.
+ *
+ * * Range Expression Table:
+ *
+ * | Range Expression | Who gets the update                                                    |
+ * |------------------|------------------------------------------------------------------------|
+ * | 1.2.3            | Only devices running the specific binary app store version 1.2.3 of your app |
+ * | *                | Any device configured to consume updates from your CodePush app         |
+ * | 1.2.x            | Devices running major version 1, minor version 2 and any patch version of your app |
+ * | 1.2.3 - 1.2.7    | Devices running any binary version between 1.2.3 (inclusive) and 1.2.7 (inclusive) |
+ * | >=1.2.3 <1.2.7   | Devices running any binary version between 1.2.3 (inclusive) and 1.2.7 (exclusive) |
+ * | 1.2              | Equivalent to >=1.2.0 <1.3.0                                            |
+ * | ~1.2.3           | Equivalent to >=1.2.3 <1.3.0                                            |
+ * | ^1.2.3           | Equivalent to >=1.2.3 <2.0.0                                            |
+ */
+export const setupSemverSatisfiesTestSuite = ({
+  semverSatisfies,
+}: {
+  semverSatisfies: (
+    targetVersion: string,
+    currentVersion: string,
+  ) => Promise<boolean> | boolean;
+}) => {
+  it("version 1.2.3 should satisfy version 1.2.3", async () => {
+    expect(await semverSatisfies("1.2.3", "1.2.3")).toBe(true);
+  });
+
+  it("version 1.2.4 should not satisfy version 1.2.3", async () => {
+    expect(await semverSatisfies("1.2.3", "1.2.4")).toBe(false);
+  });
+
+  it("version 1.2.4 should not satisfy version 1.2.3", async () => {
+    expect(await semverSatisfies("1.2.3", "1.2.4")).toBe(false);
+  });
+
+  it("version 1.2.4 should not satisfy version 1.2.3", async () => {
+    expect(await semverSatisfies("1.2.3", "1.2.4")).toBe(false);
+  });
+
+  it("1.x.x should satisfy version 1.0", async () => {
+    expect(await semverSatisfies("1.x.x", "1.0")).toBe(true);
+  });
+
+  it("1.x.x should satisfy version 1.12", async () => {
+    expect(await semverSatisfies("1.x.x", "1.12")).toBe(true);
+  });
+
+  it("1.x.x should satisfy version 1.0.0", async () => {
+    expect(await semverSatisfies("1.x.x", "1.0.0")).toBe(true);
+  });
+
+  it("1.x.x should satisfy version 1.2.3", async () => {
+    expect(await semverSatisfies("1.x.x", "1.2.3")).toBe(true);
+  });
+
+  it("1.x.x should not satisfy version 2.0.0", async () => {
+    expect(await semverSatisfies("1.x.x", "2.0.0")).toBe(false);
+  });
+
+  it("1.x.x should not satisfy version 2.0.0", async () => {
+    expect(await semverSatisfies("1.x.x", "2.0.0")).toBe(false);
+  });
+
+  it("1.2.x should satisfy version 1.2.5", async () => {
+    expect(await semverSatisfies("1.2.x", "1.2.5")).toBe(true);
+  });
+
+  it("1.2.x should not satisfy version 1.3.0", async () => {
+    expect(await semverSatisfies("1.2.x", "1.3.0")).toBe(false);
+  });
+
+  it("1.2.x should not satisfy version 1.3.0", async () => {
+    expect(await semverSatisfies("1.2.x", "1.3.0")).toBe(false);
+  });
+
+  it("range 1.2.3-1.2.7 should satisfy version 1.2.5", async () => {
+    expect(await semverSatisfies("1.2.3 - 1.2.7", "1.2.5")).toBe(true);
+  });
+
+  it("range 1.2.3-1.2.7 should satisfy version 1.2.5", async () => {
+    expect(await semverSatisfies("1.2.3 - 1.2.7", "1.2.5")).toBe(true);
+  });
+
+  it("range 1.2.3-1.2.7 should not satisfy version 1.3.0", async () => {
+    expect(await semverSatisfies("1.2.3 - 1.2.7", "1.3.0")).toBe(false);
+  });
+
+  it("range >=1.2.3 <1.2.7 should satisfy version 1.2.5", async () => {
+    expect(await semverSatisfies(">=1.2.3 <1.2.7", "1.2.5")).toBe(true);
+  });
+
+  it("range >=1.2.3 <1.2.7 should satisfy version 1.2.5", async () => {
+    expect(await semverSatisfies(">=1.2.3 <1.2.7", "1.2.5")).toBe(true);
+  });
+
+  it("range >=1.2.3 <1.2.7 should not satisfy version 1.2.7", async () => {
+    expect(await semverSatisfies(">=1.2.3 <1.2.7", "1.2.7")).toBe(false);
+  });
+
+  it("~1.2.3 should satisfy version 1.2.3", async () => {
+    expect(await semverSatisfies("~1.2.3", "1.2.3")).toBe(true);
+  });
+
+  it("~1.2.3 should satisfy version 1.2.4", async () => {
+    expect(await semverSatisfies("~1.2.3", "1.2.4")).toBe(true);
+  });
+
+  it("~1.2.3 should not satisfy version 1.3.0", async () => {
+    expect(await semverSatisfies("~1.2.3", "1.3.0")).toBe(false);
+  });
+
+  it("~1.2.3 should satisfy version 1.2.3", async () => {
+    expect(await semverSatisfies("~1.2.3", "1.2.3")).toBe(true);
+  });
+
+  it("~1.2.3 should satisfy version 1.2.4", async () => {
+    expect(await semverSatisfies("~1.2.3", "1.2.4")).toBe(true);
+  });
+
+  it("~1.2.3 should not satisfy version 1.3.0", async () => {
+    expect(await semverSatisfies("~1.2.3", "1.3.0")).toBe(false);
+  });
+
+  it("^1.2.3 should satisfy version 1.3.0", async () => {
+    expect(await semverSatisfies("^1.2.3", "1.3.0")).toBe(true);
+  });
+
+  it("^1.2.3 should satisfy version 1.3.0", async () => {
+    expect(await semverSatisfies("^1.2.3", "1.3.0")).toBe(true);
+  });
+
+  it("^1.2.3 should not satisfy version 2.0.0", async () => {
+    expect(await semverSatisfies("^1.2.3", "2.0.0")).toBe(false);
+  });
+};

package/src/types.ts

@@ -0,0 +1,62 @@
+export type Platform = "ios" | "android";
+
+export interface Bundle {
+  /**
+   * The unique identifier for the bundle. uuidv7
+   */
+  id: string;
+  /**
+   * The platform the bundle is for.
+   */
+  platform: Platform;
+  /**
+   * The target version of the bundle.
+   */
+  targetVersion: string;
+  /**
+   * Whether the bundle should force an update.
+   */
+  forceUpdate: boolean;
+  /**
+   * Whether the bundle is enabled.
+   */
+  enabled: boolean;
+  /**
+   * The file URL of the bundle.
+   */
+  fileUrl: string;
+  /**
+   * The hash of the bundle.
+   */
+  fileHash: string;
+  /**
+   * The git commit hash of the bundle.
+   */
+  gitCommitHash: string | null;
+  /**
+   * The message of the bundle.
+   */
+  message: string | null;
+}
+
+export type BundleArg =
+  | string
+  | Bundle[]
+  | (() => Promise<Bundle[]>)
+  | (() => Bundle[]);
+
+export type UpdateStatus = "ROLLBACK" | "UPDATE";
+
+export interface UpdateInfo {
+  id: string;
+  forceUpdate: boolean;
+  fileUrl: string | null;
+  fileHash: string | null;
+  status: UpdateStatus;
+}
+
+export interface GetBundlesArgs {
+  platform: Platform;
+  bundleId: string;
+  appVersion: string;
+}

package/src/uuid.ts

@@ -0,0 +1 @@
+export const NIL_UUID = "00000000-0000-0000-0000-000000000000";