@hot-updater/core 0.27.1 → 0.29.0

package/dist/_virtual/_rolldown/runtime.cjs

@@ -0,0 +1,23 @@
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+//#endregion
+exports.__toESM = __toESM;

package/dist/hotUpdateDirUtil.cjs

@@ -0,0 +1,26 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+let node_path = require("node:path");
+node_path = require_runtime.__toESM(node_path);
+//#region src/hotUpdateDirUtil.ts
+const HOT_UPDATE_DIR_NAME = ".hot-updater";
+const HOT_UPDATE_OUTPUT_DIR_NAME = "output";
+const HOT_UPDATE_LOG_DIR_NAME = "log";
+const HotUpdateDirUtil = {
+	dirName: HOT_UPDATE_DIR_NAME,
+	outputDirName: HOT_UPDATE_OUTPUT_DIR_NAME,
+	logDirName: HOT_UPDATE_LOG_DIR_NAME,
+	outputGitignorePath: `${HOT_UPDATE_DIR_NAME}/${HOT_UPDATE_OUTPUT_DIR_NAME}`,
+	logGitignorePath: `${HOT_UPDATE_DIR_NAME}/${HOT_UPDATE_LOG_DIR_NAME}`,
+	getDirPath: ({ cwd }) => {
+		return node_path.default.join(cwd, HOT_UPDATE_DIR_NAME);
+	},
+	getDefaultOutputPath: ({ cwd }) => {
+		return node_path.default.join(cwd, HOT_UPDATE_DIR_NAME, HOT_UPDATE_OUTPUT_DIR_NAME);
+	},
+	getLogDirPath: ({ cwd }) => {
+		return node_path.default.join(cwd, HOT_UPDATE_DIR_NAME, HOT_UPDATE_LOG_DIR_NAME);
+	}
+};
+//#endregion
+exports.HotUpdateDirUtil = HotUpdateDirUtil;

package/dist/hotUpdateDirUtil.d.cts

@@ -0,0 +1,25 @@
+//#region src/hotUpdateDirUtil.d.ts
+declare const HotUpdateDirUtil: {
+  readonly dirName: ".hot-updater";
+  readonly outputDirName: "output";
+  readonly logDirName: "log";
+  readonly outputGitignorePath: ".hot-updater/output";
+  readonly logGitignorePath: ".hot-updater/log";
+  readonly getDirPath: ({
+    cwd
+  }: {
+    cwd: string;
+  }) => string;
+  readonly getDefaultOutputPath: ({
+    cwd
+  }: {
+    cwd: string;
+  }) => string;
+  readonly getLogDirPath: ({
+    cwd
+  }: {
+    cwd: string;
+  }) => string;
+};
+//#endregion
+export { HotUpdateDirUtil };

package/dist/hotUpdateDirUtil.d.mts

@@ -0,0 +1,25 @@
+//#region src/hotUpdateDirUtil.d.ts
+declare const HotUpdateDirUtil: {
+  readonly dirName: ".hot-updater";
+  readonly outputDirName: "output";
+  readonly logDirName: "log";
+  readonly outputGitignorePath: ".hot-updater/output";
+  readonly logGitignorePath: ".hot-updater/log";
+  readonly getDirPath: ({
+    cwd
+  }: {
+    cwd: string;
+  }) => string;
+  readonly getDefaultOutputPath: ({
+    cwd
+  }: {
+    cwd: string;
+  }) => string;
+  readonly getLogDirPath: ({
+    cwd
+  }: {
+    cwd: string;
+  }) => string;
+};
+//#endregion
+export { HotUpdateDirUtil };

package/dist/{index.js → hotUpdateDirUtil.mjs}

@@ -1,5 +1,4 @@
-import path from "path";
-
+import path from "node:path";
 //#region src/hotUpdateDirUtil.ts
 const HOT_UPDATE_DIR_NAME = ".hot-updater";
 const HOT_UPDATE_OUTPUT_DIR_NAME = "output";
@@ -20,10 +19,5 @@ const HotUpdateDirUtil = {
 		return path.join(cwd, HOT_UPDATE_DIR_NAME, HOT_UPDATE_LOG_DIR_NAME);
 	}
 };
-
 //#endregion
-//#region src/uuid.ts
-const NIL_UUID = "00000000-0000-0000-0000-000000000000";
-
-//#endregion
-export { HotUpdateDirUtil, NIL_UUID };
+export { HotUpdateDirUtil };

package/dist/index.cjs

@@ -1,54 +1,20 @@
-//#region rolldown:runtime
-var __create = Object.create;
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __getProtoOf = Object.getPrototypeOf;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
-		key = keys[i];
-		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
-			get: ((k) => from[k]).bind(null, key),
-			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-		});
-	}
-	return to;
-};
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
-	value: mod,
-	enumerable: true
-}) : target, mod));
-
-//#endregion
-let path = require("path");
-path = __toESM(path);
-
-//#region src/hotUpdateDirUtil.ts
-const HOT_UPDATE_DIR_NAME = ".hot-updater";
-const HOT_UPDATE_OUTPUT_DIR_NAME = "output";
-const HOT_UPDATE_LOG_DIR_NAME = "log";
-const HotUpdateDirUtil = {
-	dirName: HOT_UPDATE_DIR_NAME,
-	outputDirName: HOT_UPDATE_OUTPUT_DIR_NAME,
-	logDirName: HOT_UPDATE_LOG_DIR_NAME,
-	outputGitignorePath: `${HOT_UPDATE_DIR_NAME}/${HOT_UPDATE_OUTPUT_DIR_NAME}`,
-	logGitignorePath: `${HOT_UPDATE_DIR_NAME}/${HOT_UPDATE_LOG_DIR_NAME}`,
-	getDirPath: ({ cwd }) => {
-		return path.default.join(cwd, HOT_UPDATE_DIR_NAME);
-	},
-	getDefaultOutputPath: ({ cwd }) => {
-		return path.default.join(cwd, HOT_UPDATE_DIR_NAME, HOT_UPDATE_OUTPUT_DIR_NAME);
-	},
-	getLogDirPath: ({ cwd }) => {
-		return path.default.join(cwd, HOT_UPDATE_DIR_NAME, HOT_UPDATE_LOG_DIR_NAME);
-	}
-};
-
-//#endregion
-//#region src/uuid.ts
-const NIL_UUID = "00000000-0000-0000-0000-000000000000";
-
-//#endregion
-exports.HotUpdateDirUtil = HotUpdateDirUtil;
-exports.NIL_UUID = NIL_UUID;
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_hotUpdateDirUtil = require("./hotUpdateDirUtil.cjs");
+const require_rollout = require("./rollout.cjs");
+const require_uuid = require("./uuid.cjs");
+exports.DEFAULT_ROLLOUT_COHORT_COUNT = require_rollout.DEFAULT_ROLLOUT_COHORT_COUNT;
+exports.HotUpdateDirUtil = require_hotUpdateDirUtil.HotUpdateDirUtil;
+exports.INVALID_COHORT_ERROR_MESSAGE = require_rollout.INVALID_COHORT_ERROR_MESSAGE;
+exports.MAX_COHORT_LENGTH = require_rollout.MAX_COHORT_LENGTH;
+exports.NIL_UUID = require_uuid.NIL_UUID;
+exports.NUMERIC_COHORT_SIZE = require_rollout.NUMERIC_COHORT_SIZE;
+exports.getDefaultNumericCohort = require_rollout.getDefaultNumericCohort;
+exports.getNumericCohortRolloutPosition = require_rollout.getNumericCohortRolloutPosition;
+exports.getNumericCohortValue = require_rollout.getNumericCohortValue;
+exports.getRolledOutNumericCohorts = require_rollout.getRolledOutNumericCohorts;
+exports.isCohortEligibleForUpdate = require_rollout.isCohortEligibleForUpdate;
+exports.isCustomCohort = require_rollout.isCustomCohort;
+exports.isNumericCohort = require_rollout.isNumericCohort;
+exports.isValidCohort = require_rollout.isValidCohort;
+exports.normalizeCohortValue = require_rollout.normalizeCohortValue;
+exports.normalizeRolloutCohortCount = require_rollout.normalizeRolloutCohortCount;

package/dist/index.d.cts

@@ -1,198 +1,5 @@
-//#region src/hotUpdateDirUtil.d.ts
-declare const HotUpdateDirUtil: {
-  readonly dirName: ".hot-updater";
-  readonly outputDirName: "output";
-  readonly logDirName: "log";
-  readonly outputGitignorePath: ".hot-updater/output";
-  readonly logGitignorePath: ".hot-updater/log";
-  readonly getDirPath: ({
-    cwd
-  }: {
-    cwd: string;
-  }) => string;
-  readonly getDefaultOutputPath: ({
-    cwd
-  }: {
-    cwd: string;
-  }) => string;
-  readonly getLogDirPath: ({
-    cwd
-  }: {
-    cwd: string;
-  }) => string;
-};
-//#endregion
-//#region src/types.d.ts
-type Platform = "ios" | "android";
-type BundleMetadata = {
-  app_version?: string;
-};
-interface Bundle {
-  /**
-   * The unique identifier for the bundle. uuidv7
-   */
-  id: string;
-  /**
-   * The platform the bundle is for.
-   */
-  platform: Platform;
-  /**
-   * Whether the bundle should force an update.
-   */
-  shouldForceUpdate: boolean;
-  /**
-   * Whether the bundle is enabled.
-   */
-  enabled: boolean;
-  /**
-   * The hash of the bundle.
-   */
-  fileHash: string;
-  /**
-   * The storage key of the bundle.
-   * @example "s3://my-bucket/my-app/00000000-0000-0000-0000-000000000000/bundle.zip"
-   * @example "r2://my-bucket/my-app/00000000-0000-0000-0000-000000000000/bundle.zip"
-   * @example "firebase-storage://my-bucket/my-app/00000000-0000-0000-0000-000000000000/bundle.zip"
-   * @example "storage://my-app/00000000-0000-0000-0000-000000000000/bundle.zip"
-   */
-  storageUri: string;
-  /**
-   * The git commit hash of the bundle.
-   */
-  gitCommitHash: string | null;
-  /**
-   * The message of the bundle.
-   */
-  message: string | null;
-  /**
-   * The name of the channel where the bundle is deployed.
-   *
-   * Examples:
-   * - production: Production channel for end users
-   * - development: Development channel for testing
-   * - staging: Staging channel for quality assurance before production
-   * - app-name: Channel for specific app instances (e.g., my-app, app-test)
-   *
-   * Different channel values can be used based on each app's requirements.
-   */
-  channel: string;
-  /**
-   * The target app version of the bundle.
-   */
-  targetAppVersion: string | null;
-  /**
-   * The fingerprint hash of the bundle.
-   */
-  fingerprintHash: string | null;
-  /**
-   * The metadata of the bundle.
-   */
-  metadata?: BundleMetadata;
-}
-type SnakeCase<S extends string> = S extends `${infer T}${infer U}` ? `${T extends Capitalize<T> ? "_" : ""}${Lowercase<T>}${SnakeCase<U>}` : S;
-type SnakeKeyObject<T$1> = T$1 extends Record<string, any> ? { [K in keyof T$1 as SnakeCase<Extract<K, string>>]: T$1[K] extends object ? SnakeKeyObject<T$1[K]> : T$1[K] } : T$1;
-type SnakeCaseBundle = SnakeKeyObject<Bundle>;
-type UpdateStatus = "ROLLBACK" | "UPDATE";
-/**
- * The update info for the database layer.
- * This is the update info that is used by the database.
- */
-interface UpdateInfo {
-  id: string;
-  shouldForceUpdate: boolean;
-  message: string | null;
-  status: UpdateStatus;
-  storageUri: string | null;
-  fileHash: string | null;
-}
-/**
- * The update info for the app layer.
- * This is the update info that is used by the app.
- */
-interface AppUpdateInfo extends Omit<UpdateInfo, "storageUri"> {
-  fileUrl: string | null;
-  /**
-   * SHA256 hash of the bundle file, optionally with embedded signature.
-   * Format when signed: "sig:<base64_signature>"
-   * Format when unsigned: "<hex_hash>" (64-character lowercase hex)
-   * The client parses this to extract signature for native verification.
-   */
-  fileHash: string | null;
-}
-type UpdateStrategy = "fingerprint" | "appVersion";
-type FingerprintGetBundlesArgs = {
-  _updateStrategy: "fingerprint";
-  platform: Platform;
-  /**
-   * The current bundle id of the app.
-   */
-  bundleId: string;
-  /**
-   * Minimum bundle id that should be used.
-   * This value is generated at build time via getMinBundleId().
-   *
-   * @default "00000000-0000-0000-0000-000000000000"
-   */
-  minBundleId?: string;
-  /**
-   * The name of the channel where the bundle is deployed.
-   *
-   * @default "production"
-   *
-   * Examples:
-   * - production: Production channel for end users
-   * - development: Development channel for testing
-   * - staging: Staging channel for quality assurance before production
-   * - app-name: Channel for specific app instances (e.g., my-app, app-test)
-   */
-  channel?: string;
-  /**
-   * The fingerprint hash of the bundle.
-   */
-  fingerprintHash: string;
-};
-type AppVersionGetBundlesArgs = {
-  _updateStrategy: "appVersion";
-  platform: Platform;
-  /**
-   * The current bundle id of the app.
-   */
-  bundleId: string;
-  /**
-   * Minimum bundle id that should be used.
-   * This value is generated at build time via getMinBundleId().
-   *
-   * @default "00000000-0000-0000-0000-000000000000"
-   */
-  minBundleId?: string;
-  /**
-   * The name of the channel where the bundle is deployed.
-   *
-   * @default "production"
-   *
-   * Examples:
-   * - production: Production channel for end users
-   * - development: Development channel for testing
-   * - staging: Staging channel for quality assurance before production
-   * - app-name: Channel for specific app instances (e.g., my-app, app-test)
-   */
-  channel?: string;
-  /**
-   * The current app version.
-   */
-  appVersion: string;
-};
-type GetBundlesArgs = FingerprintGetBundlesArgs | AppVersionGetBundlesArgs;
-type UpdateBundleParams = {
-  platform: Platform;
-  bundleId: string;
-  minBundleId: string;
-  channel: string;
-  appVersion: string;
-  fingerprintHash: string | null;
-};
-//#endregion
-//#region src/uuid.d.ts
-declare const NIL_UUID = "00000000-0000-0000-0000-000000000000";
-//#endregion
-export { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdateDirUtil, NIL_UUID, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy };
+import { HotUpdateDirUtil } from "./hotUpdateDirUtil.cjs";
+import { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NUMERIC_COHORT_SIZE, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount } from "./rollout.cjs";
+import { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, FingerprintGetBundlesArgs, GetBundlesArgs, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy } from "./types.cjs";
+import { NIL_UUID } from "./uuid.cjs";
+export { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, DEFAULT_ROLLOUT_COHORT_COUNT, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdateDirUtil, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NIL_UUID, NUMERIC_COHORT_SIZE, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount };

package/dist/index.d.mts

@@ -0,0 +1,5 @@
+import { HotUpdateDirUtil } from "./hotUpdateDirUtil.mjs";
+import { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NUMERIC_COHORT_SIZE, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount } from "./rollout.mjs";
+import { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, FingerprintGetBundlesArgs, GetBundlesArgs, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy } from "./types.mjs";
+import { NIL_UUID } from "./uuid.mjs";
+export { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, DEFAULT_ROLLOUT_COHORT_COUNT, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdateDirUtil, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NIL_UUID, NUMERIC_COHORT_SIZE, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount };

package/dist/index.mjs

@@ -0,0 +1,4 @@
+import { HotUpdateDirUtil } from "./hotUpdateDirUtil.mjs";
+import { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NUMERIC_COHORT_SIZE, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount } from "./rollout.mjs";
+import { NIL_UUID } from "./uuid.mjs";
+export { DEFAULT_ROLLOUT_COHORT_COUNT, HotUpdateDirUtil, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NIL_UUID, NUMERIC_COHORT_SIZE, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount };

package/dist/react-native.cjs

@@ -0,0 +1,18 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_rollout = require("./rollout.cjs");
+const require_uuid = require("./uuid.cjs");
+exports.DEFAULT_ROLLOUT_COHORT_COUNT = require_rollout.DEFAULT_ROLLOUT_COHORT_COUNT;
+exports.INVALID_COHORT_ERROR_MESSAGE = require_rollout.INVALID_COHORT_ERROR_MESSAGE;
+exports.MAX_COHORT_LENGTH = require_rollout.MAX_COHORT_LENGTH;
+exports.NIL_UUID = require_uuid.NIL_UUID;
+exports.NUMERIC_COHORT_SIZE = require_rollout.NUMERIC_COHORT_SIZE;
+exports.getDefaultNumericCohort = require_rollout.getDefaultNumericCohort;
+exports.getNumericCohortRolloutPosition = require_rollout.getNumericCohortRolloutPosition;
+exports.getNumericCohortValue = require_rollout.getNumericCohortValue;
+exports.getRolledOutNumericCohorts = require_rollout.getRolledOutNumericCohorts;
+exports.isCohortEligibleForUpdate = require_rollout.isCohortEligibleForUpdate;
+exports.isCustomCohort = require_rollout.isCustomCohort;
+exports.isNumericCohort = require_rollout.isNumericCohort;
+exports.isValidCohort = require_rollout.isValidCohort;
+exports.normalizeCohortValue = require_rollout.normalizeCohortValue;
+exports.normalizeRolloutCohortCount = require_rollout.normalizeRolloutCohortCount;

package/dist/react-native.d.cts

@@ -0,0 +1,4 @@
+import { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NUMERIC_COHORT_SIZE, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount } from "./rollout.cjs";
+import { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, FingerprintGetBundlesArgs, GetBundlesArgs, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy } from "./types.cjs";
+import { NIL_UUID } from "./uuid.cjs";
+export { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, DEFAULT_ROLLOUT_COHORT_COUNT, FingerprintGetBundlesArgs, GetBundlesArgs, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NIL_UUID, NUMERIC_COHORT_SIZE, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount };

package/dist/react-native.d.mts

@@ -0,0 +1,4 @@
+import { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NUMERIC_COHORT_SIZE, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount } from "./rollout.mjs";
+import { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, FingerprintGetBundlesArgs, GetBundlesArgs, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy } from "./types.mjs";
+import { NIL_UUID } from "./uuid.mjs";
+export { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, DEFAULT_ROLLOUT_COHORT_COUNT, FingerprintGetBundlesArgs, GetBundlesArgs, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NIL_UUID, NUMERIC_COHORT_SIZE, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount };

package/dist/react-native.mjs

@@ -0,0 +1,3 @@
+import { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NUMERIC_COHORT_SIZE, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount } from "./rollout.mjs";
+import { NIL_UUID } from "./uuid.mjs";
+export { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NIL_UUID, NUMERIC_COHORT_SIZE, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount };

package/dist/rollout.cjs

@@ -0,0 +1,132 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/rollout.ts
+const NUMERIC_COHORT_SIZE = 1e3;
+const DEFAULT_ROLLOUT_COHORT_COUNT = NUMERIC_COHORT_SIZE;
+const MAX_COHORT_LENGTH = 64;
+const INVALID_COHORT_ERROR_MESSAGE = `Invalid cohort. Use 1-1000 or a lowercase slug without spaces, up to 64 characters.`;
+const CUSTOM_COHORT_PATTERN = /^[a-z0-9-]+$/;
+function parseNumericCohortValue(cohort) {
+	if (!/^\d+$/.test(cohort)) return null;
+	const parsed = Number.parseInt(cohort, 10);
+	if (Number.isNaN(parsed) || parsed < 1 || parsed > 1e3) return null;
+	return parsed;
+}
+function positiveMod(value, modulus) {
+	return (value % modulus + modulus) % modulus;
+}
+function hashString(value) {
+	let hash = 0;
+	for (let i = 0; i < value.length; i++) {
+		const char = value.charCodeAt(i);
+		hash = (hash << 5) - hash + char;
+		hash |= 0;
+	}
+	return hash;
+}
+function gcd(a, b) {
+	let x = Math.abs(a);
+	let y = Math.abs(b);
+	while (y !== 0) {
+		const next = x % y;
+		x = y;
+		y = next;
+	}
+	return x;
+}
+function modularInverse(value, modulus) {
+	let t = 0;
+	let newT = 1;
+	let r = modulus;
+	let newR = positiveMod(value, modulus);
+	while (newR !== 0) {
+		const quotient = Math.floor(r / newR);
+		[t, newT] = [newT, t - quotient * newT];
+		[r, newR] = [newR, r - quotient * newR];
+	}
+	if (r > 1) throw new Error(`No modular inverse for ${value} mod ${modulus}`);
+	return positiveMod(t, modulus);
+}
+function getRolloutShuffleParameters(bundleId) {
+	let multiplier = positiveMod(hashString(`${bundleId}:multiplier`), 997);
+	if (multiplier === 0) multiplier = 1;
+	while (gcd(multiplier, NUMERIC_COHORT_SIZE) !== 1) {
+		multiplier = positiveMod(multiplier + 1, NUMERIC_COHORT_SIZE);
+		if (multiplier === 0) multiplier = 1;
+	}
+	const offset = positiveMod(hashString(`${bundleId}:offset`), NUMERIC_COHORT_SIZE);
+	return {
+		multiplier,
+		offset,
+		inverseMultiplier: modularInverse(multiplier, NUMERIC_COHORT_SIZE)
+	};
+}
+function normalizeRolloutCohortCount(rolloutCohortCount) {
+	if (rolloutCohortCount === null || rolloutCohortCount === void 0) return DEFAULT_ROLLOUT_COHORT_COUNT;
+	if (rolloutCohortCount <= 0) return 0;
+	if (rolloutCohortCount >= 1e3) return NUMERIC_COHORT_SIZE;
+	return Math.floor(rolloutCohortCount);
+}
+function normalizeCohortValue(cohort) {
+	const normalized = cohort.trim().toLowerCase();
+	const numericCohort = parseNumericCohortValue(normalized);
+	if (numericCohort !== null) return String(numericCohort);
+	return normalized;
+}
+function getNumericCohortValue(cohort) {
+	return parseNumericCohortValue(normalizeCohortValue(cohort));
+}
+function isNumericCohort(cohort) {
+	return getNumericCohortValue(cohort) !== null;
+}
+function isCustomCohort(cohort) {
+	const normalized = normalizeCohortValue(cohort);
+	return normalized.length > 0 && normalized.length <= 64 && !/^\d+$/.test(normalized) && CUSTOM_COHORT_PATTERN.test(normalized);
+}
+function isValidCohort(cohort) {
+	const normalized = normalizeCohortValue(cohort);
+	return isNumericCohort(normalized) || isCustomCohort(normalized);
+}
+function getDefaultNumericCohort(identifier) {
+	const cohortValue = positiveMod(hashString(identifier), NUMERIC_COHORT_SIZE) + 1;
+	return String(cohortValue);
+}
+function getNumericCohortRolloutPosition(bundleId, cohortValue) {
+	if (cohortValue < 1 || cohortValue > 1e3) throw new Error(`Invalid numeric cohort: ${cohortValue}`);
+	const { offset, inverseMultiplier } = getRolloutShuffleParameters(bundleId);
+	return positiveMod(inverseMultiplier * (cohortValue - 1 - offset), NUMERIC_COHORT_SIZE);
+}
+function getRolledOutNumericCohorts(bundleId, rolloutCohortCount) {
+	const normalizedRolloutCount = normalizeRolloutCohortCount(rolloutCohortCount);
+	if (normalizedRolloutCount <= 0) return [];
+	return Array.from({ length: NUMERIC_COHORT_SIZE }, (_, index) => index + 1).filter((cohortValue) => {
+		if (normalizedRolloutCount >= 1e3) return true;
+		return getNumericCohortRolloutPosition(bundleId, cohortValue) < normalizedRolloutCount;
+	});
+}
+function isCohortEligibleForUpdate(bundleId, cohort, rolloutCohortCount, targetCohorts) {
+	const normalizedCohort = cohort === null || cohort === void 0 ? void 0 : normalizeCohortValue(cohort);
+	const normalizedTargetCohorts = targetCohorts?.map((targetCohort) => normalizeCohortValue(targetCohort)) ?? [];
+	if (normalizedTargetCohorts.length > 0) return normalizedCohort !== void 0 && normalizedTargetCohorts.includes(normalizedCohort);
+	const normalizedRolloutCount = normalizeRolloutCohortCount(rolloutCohortCount);
+	if (normalizedRolloutCount <= 0) return false;
+	if (normalizedCohort === void 0) return normalizedRolloutCount >= NUMERIC_COHORT_SIZE;
+	const numericCohort = getNumericCohortValue(normalizedCohort);
+	if (numericCohort === null) return false;
+	if (normalizedRolloutCount >= 1e3) return true;
+	return getNumericCohortRolloutPosition(bundleId, numericCohort) < normalizedRolloutCount;
+}
+//#endregion
+exports.DEFAULT_ROLLOUT_COHORT_COUNT = DEFAULT_ROLLOUT_COHORT_COUNT;
+exports.INVALID_COHORT_ERROR_MESSAGE = INVALID_COHORT_ERROR_MESSAGE;
+exports.MAX_COHORT_LENGTH = MAX_COHORT_LENGTH;
+exports.NUMERIC_COHORT_SIZE = NUMERIC_COHORT_SIZE;
+exports.getDefaultNumericCohort = getDefaultNumericCohort;
+exports.getNumericCohortRolloutPosition = getNumericCohortRolloutPosition;
+exports.getNumericCohortValue = getNumericCohortValue;
+exports.getRolledOutNumericCohorts = getRolledOutNumericCohorts;
+exports.isCohortEligibleForUpdate = isCohortEligibleForUpdate;
+exports.isCustomCohort = isCustomCohort;
+exports.isNumericCohort = isNumericCohort;
+exports.isValidCohort = isValidCohort;
+exports.normalizeCohortValue = normalizeCohortValue;
+exports.normalizeRolloutCohortCount = normalizeRolloutCohortCount;

package/dist/rollout.d.cts

@@ -0,0 +1,17 @@
+//#region src/rollout.d.ts
+declare const NUMERIC_COHORT_SIZE = 1000;
+declare const DEFAULT_ROLLOUT_COHORT_COUNT = 1000;
+declare const MAX_COHORT_LENGTH = 64;
+declare const INVALID_COHORT_ERROR_MESSAGE = "Invalid cohort. Use 1-1000 or a lowercase slug without spaces, up to 64 characters.";
+declare function normalizeRolloutCohortCount(rolloutCohortCount: number | null | undefined): number;
+declare function normalizeCohortValue(cohort: string): string;
+declare function getNumericCohortValue(cohort: string): number | null;
+declare function isNumericCohort(cohort: string): boolean;
+declare function isCustomCohort(cohort: string): boolean;
+declare function isValidCohort(cohort: string): boolean;
+declare function getDefaultNumericCohort(identifier: string): string;
+declare function getNumericCohortRolloutPosition(bundleId: string, cohortValue: number): number;
+declare function getRolledOutNumericCohorts(bundleId: string, rolloutCohortCount: number | null | undefined): number[];
+declare function isCohortEligibleForUpdate(bundleId: string, cohort: string | null | undefined, rolloutCohortCount: number | null | undefined, targetCohorts: readonly string[] | null | undefined): boolean;
+//#endregion
+export { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NUMERIC_COHORT_SIZE, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount };

package/dist/rollout.d.mts

@@ -0,0 +1,17 @@
+//#region src/rollout.d.ts
+declare const NUMERIC_COHORT_SIZE = 1000;
+declare const DEFAULT_ROLLOUT_COHORT_COUNT = 1000;
+declare const MAX_COHORT_LENGTH = 64;
+declare const INVALID_COHORT_ERROR_MESSAGE = "Invalid cohort. Use 1-1000 or a lowercase slug without spaces, up to 64 characters.";
+declare function normalizeRolloutCohortCount(rolloutCohortCount: number | null | undefined): number;
+declare function normalizeCohortValue(cohort: string): string;
+declare function getNumericCohortValue(cohort: string): number | null;
+declare function isNumericCohort(cohort: string): boolean;
+declare function isCustomCohort(cohort: string): boolean;
+declare function isValidCohort(cohort: string): boolean;
+declare function getDefaultNumericCohort(identifier: string): string;
+declare function getNumericCohortRolloutPosition(bundleId: string, cohortValue: number): number;
+declare function getRolledOutNumericCohorts(bundleId: string, rolloutCohortCount: number | null | undefined): number[];
+declare function isCohortEligibleForUpdate(bundleId: string, cohort: string | null | undefined, rolloutCohortCount: number | null | undefined, targetCohorts: readonly string[] | null | undefined): boolean;
+//#endregion
+export { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NUMERIC_COHORT_SIZE, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount };

package/dist/rollout.mjs

@@ -0,0 +1,118 @@
+//#region src/rollout.ts
+const NUMERIC_COHORT_SIZE = 1e3;
+const DEFAULT_ROLLOUT_COHORT_COUNT = NUMERIC_COHORT_SIZE;
+const MAX_COHORT_LENGTH = 64;
+const INVALID_COHORT_ERROR_MESSAGE = `Invalid cohort. Use 1-1000 or a lowercase slug without spaces, up to 64 characters.`;
+const CUSTOM_COHORT_PATTERN = /^[a-z0-9-]+$/;
+function parseNumericCohortValue(cohort) {
+	if (!/^\d+$/.test(cohort)) return null;
+	const parsed = Number.parseInt(cohort, 10);
+	if (Number.isNaN(parsed) || parsed < 1 || parsed > 1e3) return null;
+	return parsed;
+}
+function positiveMod(value, modulus) {
+	return (value % modulus + modulus) % modulus;
+}
+function hashString(value) {
+	let hash = 0;
+	for (let i = 0; i < value.length; i++) {
+		const char = value.charCodeAt(i);
+		hash = (hash << 5) - hash + char;
+		hash |= 0;
+	}
+	return hash;
+}
+function gcd(a, b) {
+	let x = Math.abs(a);
+	let y = Math.abs(b);
+	while (y !== 0) {
+		const next = x % y;
+		x = y;
+		y = next;
+	}
+	return x;
+}
+function modularInverse(value, modulus) {
+	let t = 0;
+	let newT = 1;
+	let r = modulus;
+	let newR = positiveMod(value, modulus);
+	while (newR !== 0) {
+		const quotient = Math.floor(r / newR);
+		[t, newT] = [newT, t - quotient * newT];
+		[r, newR] = [newR, r - quotient * newR];
+	}
+	if (r > 1) throw new Error(`No modular inverse for ${value} mod ${modulus}`);
+	return positiveMod(t, modulus);
+}
+function getRolloutShuffleParameters(bundleId) {
+	let multiplier = positiveMod(hashString(`${bundleId}:multiplier`), 997);
+	if (multiplier === 0) multiplier = 1;
+	while (gcd(multiplier, NUMERIC_COHORT_SIZE) !== 1) {
+		multiplier = positiveMod(multiplier + 1, NUMERIC_COHORT_SIZE);
+		if (multiplier === 0) multiplier = 1;
+	}
+	const offset = positiveMod(hashString(`${bundleId}:offset`), NUMERIC_COHORT_SIZE);
+	return {
+		multiplier,
+		offset,
+		inverseMultiplier: modularInverse(multiplier, NUMERIC_COHORT_SIZE)
+	};
+}
+function normalizeRolloutCohortCount(rolloutCohortCount) {
+	if (rolloutCohortCount === null || rolloutCohortCount === void 0) return DEFAULT_ROLLOUT_COHORT_COUNT;
+	if (rolloutCohortCount <= 0) return 0;
+	if (rolloutCohortCount >= 1e3) return NUMERIC_COHORT_SIZE;
+	return Math.floor(rolloutCohortCount);
+}
+function normalizeCohortValue(cohort) {
+	const normalized = cohort.trim().toLowerCase();
+	const numericCohort = parseNumericCohortValue(normalized);
+	if (numericCohort !== null) return String(numericCohort);
+	return normalized;
+}
+function getNumericCohortValue(cohort) {
+	return parseNumericCohortValue(normalizeCohortValue(cohort));
+}
+function isNumericCohort(cohort) {
+	return getNumericCohortValue(cohort) !== null;
+}
+function isCustomCohort(cohort) {
+	const normalized = normalizeCohortValue(cohort);
+	return normalized.length > 0 && normalized.length <= 64 && !/^\d+$/.test(normalized) && CUSTOM_COHORT_PATTERN.test(normalized);
+}
+function isValidCohort(cohort) {
+	const normalized = normalizeCohortValue(cohort);
+	return isNumericCohort(normalized) || isCustomCohort(normalized);
+}
+function getDefaultNumericCohort(identifier) {
+	const cohortValue = positiveMod(hashString(identifier), NUMERIC_COHORT_SIZE) + 1;
+	return String(cohortValue);
+}
+function getNumericCohortRolloutPosition(bundleId, cohortValue) {
+	if (cohortValue < 1 || cohortValue > 1e3) throw new Error(`Invalid numeric cohort: ${cohortValue}`);
+	const { offset, inverseMultiplier } = getRolloutShuffleParameters(bundleId);
+	return positiveMod(inverseMultiplier * (cohortValue - 1 - offset), NUMERIC_COHORT_SIZE);
+}
+function getRolledOutNumericCohorts(bundleId, rolloutCohortCount) {
+	const normalizedRolloutCount = normalizeRolloutCohortCount(rolloutCohortCount);
+	if (normalizedRolloutCount <= 0) return [];
+	return Array.from({ length: NUMERIC_COHORT_SIZE }, (_, index) => index + 1).filter((cohortValue) => {
+		if (normalizedRolloutCount >= 1e3) return true;
+		return getNumericCohortRolloutPosition(bundleId, cohortValue) < normalizedRolloutCount;
+	});
+}
+function isCohortEligibleForUpdate(bundleId, cohort, rolloutCohortCount, targetCohorts) {
+	const normalizedCohort = cohort === null || cohort === void 0 ? void 0 : normalizeCohortValue(cohort);
+	const normalizedTargetCohorts = targetCohorts?.map((targetCohort) => normalizeCohortValue(targetCohort)) ?? [];
+	if (normalizedTargetCohorts.length > 0) return normalizedCohort !== void 0 && normalizedTargetCohorts.includes(normalizedCohort);
+	const normalizedRolloutCount = normalizeRolloutCohortCount(rolloutCohortCount);
+	if (normalizedRolloutCount <= 0) return false;
+	if (normalizedCohort === void 0) return normalizedRolloutCount >= NUMERIC_COHORT_SIZE;
+	const numericCohort = getNumericCohortValue(normalizedCohort);
+	if (numericCohort === null) return false;
+	if (normalizedRolloutCount >= 1e3) return true;
+	return getNumericCohortRolloutPosition(bundleId, numericCohort) < normalizedRolloutCount;
+}
+//#endregion
+export { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NUMERIC_COHORT_SIZE, getDefaultNumericCohort, getNumericCohortRolloutPosition, getNumericCohortValue, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount };

package/dist/{index.d.ts → types.d.cts}

@@ -1,27 +1,3 @@
-//#region src/hotUpdateDirUtil.d.ts
-declare const HotUpdateDirUtil: {
-  readonly dirName: ".hot-updater";
-  readonly outputDirName: "output";
-  readonly logDirName: "log";
-  readonly outputGitignorePath: ".hot-updater/output";
-  readonly logGitignorePath: ".hot-updater/log";
-  readonly getDirPath: ({
-    cwd
-  }: {
-    cwd: string;
-  }) => string;
-  readonly getDefaultOutputPath: ({
-    cwd
-  }: {
-    cwd: string;
-  }) => string;
-  readonly getLogDirPath: ({
-    cwd
-  }: {
-    cwd: string;
-  }) => string;
-};
-//#endregion
 //#region src/types.d.ts
 type Platform = "ios" | "android";
 type BundleMetadata = {
@@ -88,9 +64,28 @@ interface Bundle {
    * The metadata of the bundle.
    */
   metadata?: BundleMetadata;
+  /**
+   * Rollout cohort count (0-1000). Controls gradual rollout to numeric cohorts.
+   * - 0: No cohorts receive this update
+   * - 250: 25.0% of numeric cohorts receive this update
+   * - 1000 or null: All numeric cohorts receive this update (full rollout)
+   *
+   * @default 1000
+   */
+  rolloutCohortCount?: number | null;
+  /**
+   * Target specific cohorts for this update.
+   * If provided, only these cohorts will receive the update.
+   * If empty/null, rolloutCohortCount-based rollout is used.
+   *
+   * NOTE: This field is stored in database but should NOT be returned to
+   * update-check clients for security reasons. Server uses it for rollout
+   * decisions only.
+   */
+  targetCohorts?: string[] | null;
 }
-type SnakeCase<S extends string> = S extends `${infer T}${infer U}` ? `${T extends Capitalize<T> ? "_" : ""}${Lowercase<T>}${SnakeCase<U>}` : S;
-type SnakeKeyObject<T$1> = T$1 extends Record<string, any> ? { [K in keyof T$1 as SnakeCase<Extract<K, string>>]: T$1[K] extends object ? SnakeKeyObject<T$1[K]> : T$1[K] } : T$1;
+type SnakeCase<S extends string> = S extends `${infer T}${infer U}` ? T extends "_" ? `_${SnakeCase<U>}` : T extends "-" ? `-${SnakeCase<U>}` : T extends Lowercase<T> ? `${T}${SnakeCase<U>}` : `_${Lowercase<T>}${SnakeCase<U>}` : S;
+type SnakeKeyObject<T> = T extends readonly (infer U)[] ? SnakeKeyObject<U>[] : T extends Record<string, any> ? { [K in keyof T as SnakeCase<Extract<K, string>>]: SnakeKeyObject<T[K]> } : T;
 type SnakeCaseBundle = SnakeKeyObject<Bundle>;
 type UpdateStatus = "ROLLBACK" | "UPDATE";
 /**
@@ -104,6 +99,15 @@ interface UpdateInfo {
   status: UpdateStatus;
   storageUri: string | null;
   fileHash: string | null;
+  /**
+   * Rollout cohort count (0-1000). Controls gradual rollout to numeric cohorts.
+   */
+  rolloutCohortCount?: number | null;
+  /**
+   * Target specific cohorts for this update.
+   * Used internally for rollout decisions.
+   */
+  targetCohorts?: string[] | null;
 }
 /**
  * The update info for the app layer.
@@ -146,6 +150,10 @@ type FingerprintGetBundlesArgs = {
    * - app-name: Channel for specific app instances (e.g., my-app, app-test)
    */
   channel?: string;
+  /**
+   * Cohort identifier used for server-side rollout decisions.
+   */
+  cohort?: string;
   /**
    * The fingerprint hash of the bundle.
    */
@@ -177,6 +185,10 @@ type AppVersionGetBundlesArgs = {
    * - app-name: Channel for specific app instances (e.g., my-app, app-test)
    */
   channel?: string;
+  /**
+   * Cohort identifier used for server-side rollout decisions.
+   */
+  cohort?: string;
   /**
    * The current app version.
    */
@@ -192,7 +204,4 @@ type UpdateBundleParams = {
   fingerprintHash: string | null;
 };
 //#endregion
-//#region src/uuid.d.ts
-declare const NIL_UUID = "00000000-0000-0000-0000-000000000000";
-//#endregion
-export { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdateDirUtil, NIL_UUID, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy };
+export { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, FingerprintGetBundlesArgs, GetBundlesArgs, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy };

package/dist/types.d.mts

@@ -0,0 +1,207 @@
+//#region src/types.d.ts
+type Platform = "ios" | "android";
+type BundleMetadata = {
+  app_version?: string;
+};
+interface Bundle {
+  /**
+   * The unique identifier for the bundle. uuidv7
+   */
+  id: string;
+  /**
+   * The platform the bundle is for.
+   */
+  platform: Platform;
+  /**
+   * Whether the bundle should force an update.
+   */
+  shouldForceUpdate: boolean;
+  /**
+   * Whether the bundle is enabled.
+   */
+  enabled: boolean;
+  /**
+   * The hash of the bundle.
+   */
+  fileHash: string;
+  /**
+   * The storage key of the bundle.
+   * @example "s3://my-bucket/my-app/00000000-0000-0000-0000-000000000000/bundle.zip"
+   * @example "r2://my-bucket/my-app/00000000-0000-0000-0000-000000000000/bundle.zip"
+   * @example "firebase-storage://my-bucket/my-app/00000000-0000-0000-0000-000000000000/bundle.zip"
+   * @example "storage://my-app/00000000-0000-0000-0000-000000000000/bundle.zip"
+   */
+  storageUri: string;
+  /**
+   * The git commit hash of the bundle.
+   */
+  gitCommitHash: string | null;
+  /**
+   * The message of the bundle.
+   */
+  message: string | null;
+  /**
+   * The name of the channel where the bundle is deployed.
+   *
+   * Examples:
+   * - production: Production channel for end users
+   * - development: Development channel for testing
+   * - staging: Staging channel for quality assurance before production
+   * - app-name: Channel for specific app instances (e.g., my-app, app-test)
+   *
+   * Different channel values can be used based on each app's requirements.
+   */
+  channel: string;
+  /**
+   * The target app version of the bundle.
+   */
+  targetAppVersion: string | null;
+  /**
+   * The fingerprint hash of the bundle.
+   */
+  fingerprintHash: string | null;
+  /**
+   * The metadata of the bundle.
+   */
+  metadata?: BundleMetadata;
+  /**
+   * Rollout cohort count (0-1000). Controls gradual rollout to numeric cohorts.
+   * - 0: No cohorts receive this update
+   * - 250: 25.0% of numeric cohorts receive this update
+   * - 1000 or null: All numeric cohorts receive this update (full rollout)
+   *
+   * @default 1000
+   */
+  rolloutCohortCount?: number | null;
+  /**
+   * Target specific cohorts for this update.
+   * If provided, only these cohorts will receive the update.
+   * If empty/null, rolloutCohortCount-based rollout is used.
+   *
+   * NOTE: This field is stored in database but should NOT be returned to
+   * update-check clients for security reasons. Server uses it for rollout
+   * decisions only.
+   */
+  targetCohorts?: string[] | null;
+}
+type SnakeCase<S extends string> = S extends `${infer T}${infer U}` ? T extends "_" ? `_${SnakeCase<U>}` : T extends "-" ? `-${SnakeCase<U>}` : T extends Lowercase<T> ? `${T}${SnakeCase<U>}` : `_${Lowercase<T>}${SnakeCase<U>}` : S;
+type SnakeKeyObject<T> = T extends readonly (infer U)[] ? SnakeKeyObject<U>[] : T extends Record<string, any> ? { [K in keyof T as SnakeCase<Extract<K, string>>]: SnakeKeyObject<T[K]> } : T;
+type SnakeCaseBundle = SnakeKeyObject<Bundle>;
+type UpdateStatus = "ROLLBACK" | "UPDATE";
+/**
+ * The update info for the database layer.
+ * This is the update info that is used by the database.
+ */
+interface UpdateInfo {
+  id: string;
+  shouldForceUpdate: boolean;
+  message: string | null;
+  status: UpdateStatus;
+  storageUri: string | null;
+  fileHash: string | null;
+  /**
+   * Rollout cohort count (0-1000). Controls gradual rollout to numeric cohorts.
+   */
+  rolloutCohortCount?: number | null;
+  /**
+   * Target specific cohorts for this update.
+   * Used internally for rollout decisions.
+   */
+  targetCohorts?: string[] | null;
+}
+/**
+ * The update info for the app layer.
+ * This is the update info that is used by the app.
+ */
+interface AppUpdateInfo extends Omit<UpdateInfo, "storageUri"> {
+  fileUrl: string | null;
+  /**
+   * SHA256 hash of the bundle file, optionally with embedded signature.
+   * Format when signed: "sig:<base64_signature>"
+   * Format when unsigned: "<hex_hash>" (64-character lowercase hex)
+   * The client parses this to extract signature for native verification.
+   */
+  fileHash: string | null;
+}
+type UpdateStrategy = "fingerprint" | "appVersion";
+type FingerprintGetBundlesArgs = {
+  _updateStrategy: "fingerprint";
+  platform: Platform;
+  /**
+   * The current bundle id of the app.
+   */
+  bundleId: string;
+  /**
+   * Minimum bundle id that should be used.
+   * This value is generated at build time via getMinBundleId().
+   *
+   * @default "00000000-0000-0000-0000-000000000000"
+   */
+  minBundleId?: string;
+  /**
+   * The name of the channel where the bundle is deployed.
+   *
+   * @default "production"
+   *
+   * Examples:
+   * - production: Production channel for end users
+   * - development: Development channel for testing
+   * - staging: Staging channel for quality assurance before production
+   * - app-name: Channel for specific app instances (e.g., my-app, app-test)
+   */
+  channel?: string;
+  /**
+   * Cohort identifier used for server-side rollout decisions.
+   */
+  cohort?: string;
+  /**
+   * The fingerprint hash of the bundle.
+   */
+  fingerprintHash: string;
+};
+type AppVersionGetBundlesArgs = {
+  _updateStrategy: "appVersion";
+  platform: Platform;
+  /**
+   * The current bundle id of the app.
+   */
+  bundleId: string;
+  /**
+   * Minimum bundle id that should be used.
+   * This value is generated at build time via getMinBundleId().
+   *
+   * @default "00000000-0000-0000-0000-000000000000"
+   */
+  minBundleId?: string;
+  /**
+   * The name of the channel where the bundle is deployed.
+   *
+   * @default "production"
+   *
+   * Examples:
+   * - production: Production channel for end users
+   * - development: Development channel for testing
+   * - staging: Staging channel for quality assurance before production
+   * - app-name: Channel for specific app instances (e.g., my-app, app-test)
+   */
+  channel?: string;
+  /**
+   * Cohort identifier used for server-side rollout decisions.
+   */
+  cohort?: string;
+  /**
+   * The current app version.
+   */
+  appVersion: string;
+};
+type GetBundlesArgs = FingerprintGetBundlesArgs | AppVersionGetBundlesArgs;
+type UpdateBundleParams = {
+  platform: Platform;
+  bundleId: string;
+  minBundleId: string;
+  channel: string;
+  appVersion: string;
+  fingerprintHash: string | null;
+};
+//#endregion
+export { AppUpdateInfo, AppVersionGetBundlesArgs, Bundle, BundleMetadata, FingerprintGetBundlesArgs, GetBundlesArgs, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy };

package/dist/types.mjs

@@ -0,0 +1 @@
+export {};

package/dist/uuid.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/uuid.ts
+const NIL_UUID = "00000000-0000-0000-0000-000000000000";
+//#endregion
+exports.NIL_UUID = NIL_UUID;

package/dist/uuid.d.cts

@@ -0,0 +1,4 @@
+//#region src/uuid.d.ts
+declare const NIL_UUID = "00000000-0000-0000-0000-000000000000";
+//#endregion
+export { NIL_UUID };

package/dist/uuid.d.mts

@@ -0,0 +1,4 @@
+//#region src/uuid.d.ts
+declare const NIL_UUID = "00000000-0000-0000-0000-000000000000";
+//#endregion
+export { NIL_UUID };

package/dist/uuid.mjs

@@ -0,0 +1,4 @@
+//#region src/uuid.ts
+const NIL_UUID = "00000000-0000-0000-0000-000000000000";
+//#endregion
+export { NIL_UUID };

package/package.json

@@ -1,17 +1,38 @@
 {
   "name": "@hot-updater/core",
-  "version": "0.27.1",
+  "version": "0.29.0",
   "type": "module",
   "description": "React Native OTA solution for self-hosted",
   "sideEffects": false,
   "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "react-native": "./dist/react-native.mjs",
   "types": "./dist/index.d.cts",
   "exports": {
     ".": {
-      "import": "./dist/index.js",
+      "import": "./dist/index.mjs",
       "require": "./dist/index.cjs"
     },
+    "./hotUpdateDirUtil": {
+      "import": "./dist/hotUpdateDirUtil.mjs",
+      "require": "./dist/hotUpdateDirUtil.cjs"
+    },
+    "./react-native": {
+      "import": "./dist/react-native.mjs",
+      "require": "./dist/react-native.cjs"
+    },
+    "./rollout": {
+      "import": "./dist/rollout.mjs",
+      "require": "./dist/rollout.cjs"
+    },
+    "./types": {
+      "import": "./dist/types.mjs",
+      "require": "./dist/types.cjs"
+    },
+    "./uuid": {
+      "import": "./dist/uuid.mjs",
+      "require": "./dist/uuid.cjs"
+    },
     "./package.json": "./package.json"
   },
   "files": [