@hot-updater/core 0.30.12 → 0.31.0

package/dist/index.cjs

@@ -1,4 +1,38 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/bundleArtifacts.ts
+const stripBundleArtifactMetadata = (metadata) => metadata;
+const getManifestStorageUri = (bundle) => bundle.manifestStorageUri ?? null;
+const getManifestFileHash = (bundle) => bundle.manifestFileHash ?? null;
+const getAssetBaseStorageUri = (bundle) => bundle.assetBaseStorageUri ?? null;
+const isBundlePatchArtifact = (value) => {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const candidate = value;
+	return typeof candidate.baseBundleId === "string" && typeof candidate.baseFileHash === "string" && typeof candidate.patchFileHash === "string" && typeof candidate.patchStorageUri === "string";
+};
+const readBundlePatchArray = (patches) => {
+	if (!Array.isArray(patches)) return [];
+	return patches.filter(isBundlePatchArtifact);
+};
+const getBundlePatches = (bundle) => {
+	const patches = readBundlePatchArray(bundle.patches);
+	const seenBaseBundleIds = /* @__PURE__ */ new Set();
+	return patches.filter((patch) => {
+		if (seenBaseBundleIds.has(patch.baseBundleId)) return false;
+		seenBaseBundleIds.add(patch.baseBundleId);
+		return true;
+	});
+};
+const getBundlePatch = (bundle, baseBundleId) => {
+	return getBundlePatches(bundle).find((patch) => patch.baseBundleId === baseBundleId) ?? null;
+};
+const getPrimaryPatch = (bundle) => {
+	return getBundlePatches(bundle)[0] ?? null;
+};
+const getPatchBaseBundleId = (bundle) => bundle.patchBaseBundleId ?? getPrimaryPatch(bundle)?.baseBundleId ?? null;
+const getPatchBaseFileHash = (bundle) => bundle.patchBaseFileHash ?? getPrimaryPatch(bundle)?.baseFileHash ?? null;
+const getPatchFileHash = (bundle) => bundle.patchFileHash ?? getPrimaryPatch(bundle)?.patchFileHash ?? null;
+const getPatchStorageUri = (bundle) => bundle.patchStorageUri ?? getPrimaryPatch(bundle)?.patchStorageUri ?? null;
+//#endregion
 //#region src/rollout.ts
 const NUMERIC_COHORT_SIZE = 1e3;
 const DEFAULT_ROLLOUT_COHORT_COUNT = NUMERIC_COHORT_SIZE;
@@ -124,9 +158,18 @@ exports.INVALID_COHORT_ERROR_MESSAGE = INVALID_COHORT_ERROR_MESSAGE;
 exports.MAX_COHORT_LENGTH = MAX_COHORT_LENGTH;
 exports.NIL_UUID = NIL_UUID;
 exports.NUMERIC_COHORT_SIZE = NUMERIC_COHORT_SIZE;
+exports.getAssetBaseStorageUri = getAssetBaseStorageUri;
+exports.getBundlePatch = getBundlePatch;
+exports.getBundlePatches = getBundlePatches;
 exports.getDefaultNumericCohort = getDefaultNumericCohort;
+exports.getManifestFileHash = getManifestFileHash;
+exports.getManifestStorageUri = getManifestStorageUri;
 exports.getNumericCohortRolloutPosition = getNumericCohortRolloutPosition;
 exports.getNumericCohortValue = getNumericCohortValue;
+exports.getPatchBaseBundleId = getPatchBaseBundleId;
+exports.getPatchBaseFileHash = getPatchBaseFileHash;
+exports.getPatchFileHash = getPatchFileHash;
+exports.getPatchStorageUri = getPatchStorageUri;
 exports.getRolledOutNumericCohorts = getRolledOutNumericCohorts;
 exports.isCohortEligibleForUpdate = isCohortEligibleForUpdate;
 exports.isCustomCohort = isCustomCohort;
@@ -134,3 +177,4 @@ exports.isNumericCohort = isNumericCohort;
 exports.isValidCohort = isValidCohort;
 exports.normalizeCohortValue = normalizeCohortValue;
 exports.normalizeRolloutCohortCount = normalizeRolloutCohortCount;
+exports.stripBundleArtifactMetadata = stripBundleArtifactMetadata;

package/dist/index.d.cts

@@ -1,24 +1,30 @@
-//#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
 //#region src/types.d.ts
 type Platform = "ios" | "android";
 type BundleMetadata = {
   app_version?: string;
 };
+interface BundlePatchArtifact {
+  baseBundleId: string;
+  baseFileHash: string;
+  patchFileHash: string;
+  patchStorageUri: string;
+}
+interface ChangedAssetPatch {
+  algorithm: "bsdiff";
+  baseBundleId: string;
+  baseFileHash: string;
+  patchFileHash: string;
+  patchUrl: string;
+}
+interface ChangedAssetFile {
+  compression?: "br" | null;
+  url: string;
+}
+interface ChangedAsset {
+  file?: ChangedAssetFile | null;
+  fileHash: string;
+  patch?: ChangedAssetPatch | null;
+}
 interface Bundle {
   /**
    * The unique identifier for the bundle. uuidv7
@@ -80,6 +86,43 @@ interface Bundle {
    * The metadata of the bundle.
    */
   metadata?: BundleMetadata;
+  /**
+   * Storage URI for the bundle manifest artifact.
+   */
+  manifestStorageUri?: string | null;
+  /**
+   * SHA256 hash of the manifest artifact, optionally signed as sig:<signature>.
+   */
+  manifestFileHash?: string | null;
+  /**
+   * Storage URI prefix for manifest assets.
+   */
+  assetBaseStorageUri?: string | null;
+  /**
+   * Binary patch artifacts keyed by base bundle in array order.
+   * Earlier entries take precedence when a single "primary" patch is needed.
+   */
+  patches?: BundlePatchArtifact[] | null;
+  /**
+   * Base bundle id used to generate this bundle's binary patch.
+   * @deprecated Use Bundle.patches.
+   */
+  patchBaseBundleId?: string | null;
+  /**
+   * Expected hash of the base asset before patch application.
+   * @deprecated Use Bundle.patches.
+   */
+  patchBaseFileHash?: string | null;
+  /**
+   * Expected hash of the binary patch artifact.
+   * @deprecated Use Bundle.patches.
+   */
+  patchFileHash?: string | null;
+  /**
+   * Storage URI for the binary patch artifact.
+   * @deprecated Use Bundle.patches.
+   */
+  patchStorageUri?: string | null;
   /**
    * Rollout cohort count (0-1000). Controls gradual rollout to numeric cohorts.
    * - 0: No cohorts receive this update
@@ -105,6 +148,7 @@ type SnakeCase<S extends string> = S extends `${infer T}${infer U}` ? T extends
 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";
+type AppUpdateStatus = UpdateStatus | "UP_TO_DATE";
 /**
  * The update info for the database layer.
  * This is the update info that is used by the database.
@@ -130,7 +174,8 @@ interface UpdateInfo {
  * The update info for the app layer.
  * This is the update info that is used by the app.
  */
-interface AppUpdateInfo extends Omit<UpdateInfo, "storageUri"> {
+interface AppUpdateAvailableInfo extends Omit<UpdateInfo, "storageUri"> {
+  status: UpdateStatus;
   fileUrl: string | null;
   /**
    * SHA256 hash of the bundle file, optionally with embedded signature.
@@ -139,7 +184,29 @@ interface AppUpdateInfo extends Omit<UpdateInfo, "storageUri"> {
    * The client parses this to extract signature for native verification.
    */
   fileHash: string | null;
+  /**
+   * Optional manifest artifact for manifest-driven updates.
+   * When present with `changedAssets`, native can download and verify a signed
+   * manifest, then assemble the next bundle directory from reused and changed
+   * files while keeping archive fallback available through `fileUrl`.
+   */
+  manifestUrl?: string | null;
+  /**
+   * SHA256 hash of the manifest file, optionally with embedded signature.
+   * Follows the same `sig:<base64_signature>` or plain hex format as `fileHash`.
+   */
+  manifestFileHash?: string | null;
+  /**
+   * Per-file descriptors for assets whose hash differs from the client's
+   * current manifest, or for all assets when the server cannot reuse a base
+   * manifest. Keys are manifest-relative file paths.
+   */
+  changedAssets?: Record<string, ChangedAsset> | null;
+}
+interface AppUpToDateInfo {
+  status: "UP_TO_DATE";
 }
+type AppUpdateInfo = AppUpdateAvailableInfo | AppUpToDateInfo;
 type UpdateStrategy = "fingerprint" | "appVersion";
 type FingerprintGetBundlesArgs = {
   _updateStrategy: "fingerprint";
@@ -221,7 +288,35 @@ type UpdateBundleParams = {
   fingerprintHash: string | null;
 };
 //#endregion
+//#region src/bundleArtifacts.d.ts
+declare const stripBundleArtifactMetadata: (metadata: BundleMetadata | undefined) => BundleMetadata | undefined;
+declare const getManifestStorageUri: (bundle: Pick<Bundle, "manifestStorageUri" | "metadata">) => string | null;
+declare const getManifestFileHash: (bundle: Pick<Bundle, "manifestFileHash" | "metadata">) => string | null;
+declare const getAssetBaseStorageUri: (bundle: Pick<Bundle, "assetBaseStorageUri" | "metadata">) => string | null;
+declare const getBundlePatches: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">) => BundlePatchArtifact[];
+declare const getBundlePatch: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">, baseBundleId: string) => BundlePatchArtifact | null;
+declare const getPatchBaseBundleId: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">) => string;
+declare const getPatchBaseFileHash: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">) => string;
+declare const getPatchFileHash: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">) => string;
+declare const getPatchStorageUri: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">) => string;
+//#endregion
+//#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
 //#region src/uuid.d.ts
 declare const NIL_UUID = "00000000-0000-0000-0000-000000000000";
 //#endregion
-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 };
+export { AppUpToDateInfo, AppUpdateAvailableInfo, AppUpdateInfo, AppUpdateStatus, AppVersionGetBundlesArgs, Bundle, BundleMetadata, BundlePatchArtifact, ChangedAsset, ChangedAssetFile, ChangedAssetPatch, DEFAULT_ROLLOUT_COHORT_COUNT, FingerprintGetBundlesArgs, GetBundlesArgs, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NIL_UUID, NUMERIC_COHORT_SIZE, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy, getAssetBaseStorageUri, getBundlePatch, getBundlePatches, getDefaultNumericCohort, getManifestFileHash, getManifestStorageUri, getNumericCohortRolloutPosition, getNumericCohortValue, getPatchBaseBundleId, getPatchBaseFileHash, getPatchFileHash, getPatchStorageUri, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount, stripBundleArtifactMetadata };

package/dist/index.d.mts

@@ -1,24 +1,30 @@
-//#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
 //#region src/types.d.ts
 type Platform = "ios" | "android";
 type BundleMetadata = {
   app_version?: string;
 };
+interface BundlePatchArtifact {
+  baseBundleId: string;
+  baseFileHash: string;
+  patchFileHash: string;
+  patchStorageUri: string;
+}
+interface ChangedAssetPatch {
+  algorithm: "bsdiff";
+  baseBundleId: string;
+  baseFileHash: string;
+  patchFileHash: string;
+  patchUrl: string;
+}
+interface ChangedAssetFile {
+  compression?: "br" | null;
+  url: string;
+}
+interface ChangedAsset {
+  file?: ChangedAssetFile | null;
+  fileHash: string;
+  patch?: ChangedAssetPatch | null;
+}
 interface Bundle {
   /**
    * The unique identifier for the bundle. uuidv7
@@ -80,6 +86,43 @@ interface Bundle {
    * The metadata of the bundle.
    */
   metadata?: BundleMetadata;
+  /**
+   * Storage URI for the bundle manifest artifact.
+   */
+  manifestStorageUri?: string | null;
+  /**
+   * SHA256 hash of the manifest artifact, optionally signed as sig:<signature>.
+   */
+  manifestFileHash?: string | null;
+  /**
+   * Storage URI prefix for manifest assets.
+   */
+  assetBaseStorageUri?: string | null;
+  /**
+   * Binary patch artifacts keyed by base bundle in array order.
+   * Earlier entries take precedence when a single "primary" patch is needed.
+   */
+  patches?: BundlePatchArtifact[] | null;
+  /**
+   * Base bundle id used to generate this bundle's binary patch.
+   * @deprecated Use Bundle.patches.
+   */
+  patchBaseBundleId?: string | null;
+  /**
+   * Expected hash of the base asset before patch application.
+   * @deprecated Use Bundle.patches.
+   */
+  patchBaseFileHash?: string | null;
+  /**
+   * Expected hash of the binary patch artifact.
+   * @deprecated Use Bundle.patches.
+   */
+  patchFileHash?: string | null;
+  /**
+   * Storage URI for the binary patch artifact.
+   * @deprecated Use Bundle.patches.
+   */
+  patchStorageUri?: string | null;
   /**
    * Rollout cohort count (0-1000). Controls gradual rollout to numeric cohorts.
    * - 0: No cohorts receive this update
@@ -105,6 +148,7 @@ type SnakeCase<S extends string> = S extends `${infer T}${infer U}` ? T extends
 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";
+type AppUpdateStatus = UpdateStatus | "UP_TO_DATE";
 /**
  * The update info for the database layer.
  * This is the update info that is used by the database.
@@ -130,7 +174,8 @@ interface UpdateInfo {
  * The update info for the app layer.
  * This is the update info that is used by the app.
  */
-interface AppUpdateInfo extends Omit<UpdateInfo, "storageUri"> {
+interface AppUpdateAvailableInfo extends Omit<UpdateInfo, "storageUri"> {
+  status: UpdateStatus;
   fileUrl: string | null;
   /**
    * SHA256 hash of the bundle file, optionally with embedded signature.
@@ -139,7 +184,29 @@ interface AppUpdateInfo extends Omit<UpdateInfo, "storageUri"> {
    * The client parses this to extract signature for native verification.
    */
   fileHash: string | null;
+  /**
+   * Optional manifest artifact for manifest-driven updates.
+   * When present with `changedAssets`, native can download and verify a signed
+   * manifest, then assemble the next bundle directory from reused and changed
+   * files while keeping archive fallback available through `fileUrl`.
+   */
+  manifestUrl?: string | null;
+  /**
+   * SHA256 hash of the manifest file, optionally with embedded signature.
+   * Follows the same `sig:<base64_signature>` or plain hex format as `fileHash`.
+   */
+  manifestFileHash?: string | null;
+  /**
+   * Per-file descriptors for assets whose hash differs from the client's
+   * current manifest, or for all assets when the server cannot reuse a base
+   * manifest. Keys are manifest-relative file paths.
+   */
+  changedAssets?: Record<string, ChangedAsset> | null;
+}
+interface AppUpToDateInfo {
+  status: "UP_TO_DATE";
 }
+type AppUpdateInfo = AppUpdateAvailableInfo | AppUpToDateInfo;
 type UpdateStrategy = "fingerprint" | "appVersion";
 type FingerprintGetBundlesArgs = {
   _updateStrategy: "fingerprint";
@@ -221,7 +288,35 @@ type UpdateBundleParams = {
   fingerprintHash: string | null;
 };
 //#endregion
+//#region src/bundleArtifacts.d.ts
+declare const stripBundleArtifactMetadata: (metadata: BundleMetadata | undefined) => BundleMetadata | undefined;
+declare const getManifestStorageUri: (bundle: Pick<Bundle, "manifestStorageUri" | "metadata">) => string | null;
+declare const getManifestFileHash: (bundle: Pick<Bundle, "manifestFileHash" | "metadata">) => string | null;
+declare const getAssetBaseStorageUri: (bundle: Pick<Bundle, "assetBaseStorageUri" | "metadata">) => string | null;
+declare const getBundlePatches: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">) => BundlePatchArtifact[];
+declare const getBundlePatch: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">, baseBundleId: string) => BundlePatchArtifact | null;
+declare const getPatchBaseBundleId: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">) => string;
+declare const getPatchBaseFileHash: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">) => string;
+declare const getPatchFileHash: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">) => string;
+declare const getPatchStorageUri: (bundle: Pick<Bundle, "patches" | "patchBaseBundleId" | "patchBaseFileHash" | "patchFileHash" | "patchStorageUri" | "metadata">) => string;
+//#endregion
+//#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
 //#region src/uuid.d.ts
 declare const NIL_UUID = "00000000-0000-0000-0000-000000000000";
 //#endregion
-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 };
+export { AppUpToDateInfo, AppUpdateAvailableInfo, AppUpdateInfo, AppUpdateStatus, AppVersionGetBundlesArgs, Bundle, BundleMetadata, BundlePatchArtifact, ChangedAsset, ChangedAssetFile, ChangedAssetPatch, DEFAULT_ROLLOUT_COHORT_COUNT, FingerprintGetBundlesArgs, GetBundlesArgs, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NIL_UUID, NUMERIC_COHORT_SIZE, Platform, SnakeCaseBundle, UpdateBundleParams, UpdateInfo, UpdateStatus, UpdateStrategy, getAssetBaseStorageUri, getBundlePatch, getBundlePatches, getDefaultNumericCohort, getManifestFileHash, getManifestStorageUri, getNumericCohortRolloutPosition, getNumericCohortValue, getPatchBaseBundleId, getPatchBaseFileHash, getPatchFileHash, getPatchStorageUri, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount, stripBundleArtifactMetadata };

package/dist/index.mjs

@@ -1,3 +1,37 @@
+//#region src/bundleArtifacts.ts
+const stripBundleArtifactMetadata = (metadata) => metadata;
+const getManifestStorageUri = (bundle) => bundle.manifestStorageUri ?? null;
+const getManifestFileHash = (bundle) => bundle.manifestFileHash ?? null;
+const getAssetBaseStorageUri = (bundle) => bundle.assetBaseStorageUri ?? null;
+const isBundlePatchArtifact = (value) => {
+	if (!value || typeof value !== "object" || Array.isArray(value)) return false;
+	const candidate = value;
+	return typeof candidate.baseBundleId === "string" && typeof candidate.baseFileHash === "string" && typeof candidate.patchFileHash === "string" && typeof candidate.patchStorageUri === "string";
+};
+const readBundlePatchArray = (patches) => {
+	if (!Array.isArray(patches)) return [];
+	return patches.filter(isBundlePatchArtifact);
+};
+const getBundlePatches = (bundle) => {
+	const patches = readBundlePatchArray(bundle.patches);
+	const seenBaseBundleIds = /* @__PURE__ */ new Set();
+	return patches.filter((patch) => {
+		if (seenBaseBundleIds.has(patch.baseBundleId)) return false;
+		seenBaseBundleIds.add(patch.baseBundleId);
+		return true;
+	});
+};
+const getBundlePatch = (bundle, baseBundleId) => {
+	return getBundlePatches(bundle).find((patch) => patch.baseBundleId === baseBundleId) ?? null;
+};
+const getPrimaryPatch = (bundle) => {
+	return getBundlePatches(bundle)[0] ?? null;
+};
+const getPatchBaseBundleId = (bundle) => bundle.patchBaseBundleId ?? getPrimaryPatch(bundle)?.baseBundleId ?? null;
+const getPatchBaseFileHash = (bundle) => bundle.patchBaseFileHash ?? getPrimaryPatch(bundle)?.baseFileHash ?? null;
+const getPatchFileHash = (bundle) => bundle.patchFileHash ?? getPrimaryPatch(bundle)?.patchFileHash ?? null;
+const getPatchStorageUri = (bundle) => bundle.patchStorageUri ?? getPrimaryPatch(bundle)?.patchStorageUri ?? null;
+//#endregion
 //#region src/rollout.ts
 const NUMERIC_COHORT_SIZE = 1e3;
 const DEFAULT_ROLLOUT_COHORT_COUNT = NUMERIC_COHORT_SIZE;
@@ -118,4 +152,4 @@ function isCohortEligibleForUpdate(bundleId, cohort, rolloutCohortCount, targetC
 //#region src/uuid.ts
 const NIL_UUID = "00000000-0000-0000-0000-000000000000";
 //#endregion
-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 };
+export { DEFAULT_ROLLOUT_COHORT_COUNT, INVALID_COHORT_ERROR_MESSAGE, MAX_COHORT_LENGTH, NIL_UUID, NUMERIC_COHORT_SIZE, getAssetBaseStorageUri, getBundlePatch, getBundlePatches, getDefaultNumericCohort, getManifestFileHash, getManifestStorageUri, getNumericCohortRolloutPosition, getNumericCohortValue, getPatchBaseBundleId, getPatchBaseFileHash, getPatchFileHash, getPatchStorageUri, getRolledOutNumericCohorts, isCohortEligibleForUpdate, isCustomCohort, isNumericCohort, isValidCohort, normalizeCohortValue, normalizeRolloutCohortCount, stripBundleArtifactMetadata };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/core",
-  "version": "0.30.12",
+  "version": "0.31.0",
   "type": "module",
   "description": "React Native OTA solution for self-hosted",
   "sideEffects": false,