@hot-updater/plugin-core 0.30.12 → 0.31.1

package/dist/createDatabasePlugin.cjs

@@ -2,7 +2,7 @@ require("./_virtual/_rolldown/runtime.cjs");
 const require_calculatePagination = require("./calculatePagination.cjs");
 let es_toolkit = require("es-toolkit");
 //#region src/createDatabasePlugin.ts
-const REPLACE_ON_UPDATE_KEYS = ["targetCohorts"];
+const REPLACE_ON_UPDATE_KEYS = ["patches", "targetCohorts"];
 const DEFAULT_DESC_ORDER = {
 	field: "id",
 	direction: "desc"

package/dist/createDatabasePlugin.mjs

@@ -1,7 +1,7 @@
 import { calculatePagination } from "./calculatePagination.mjs";
 import { mergeWith } from "es-toolkit";
 //#region src/createDatabasePlugin.ts
-const REPLACE_ON_UPDATE_KEYS = ["targetCohorts"];
+const REPLACE_ON_UPDATE_KEYS = ["patches", "targetCohorts"];
 const DEFAULT_DESC_ORDER = {
 	field: "id",
 	direction: "desc"

package/dist/createStoragePlugin.cjs

@@ -1,55 +1,126 @@
 //#region src/createStoragePlugin.ts
+const wrapNodeProfile = (node, hooks) => ({
+	...node,
+	async upload(key, filePath) {
+		const result = await node.upload(key, filePath);
+		await hooks?.onStorageUploaded?.();
+		return result;
+	}
+});
+const createProfiledStoragePlugin = ({ createProfiles, name, profileShape, supportedProtocol }, hooks) => {
+	let cachedProfiles = null;
+	let cachedNodeProfile;
+	let cachedRuntimeProfile;
+	const getProfiles = () => {
+		cachedProfiles ??= createProfiles();
+		return cachedProfiles;
+	};
+	const getNodeProfile = () => {
+		const node = getProfiles().node;
+		if (!node) return;
+		cachedNodeProfile ??= wrapNodeProfile(node, hooks);
+		return cachedNodeProfile;
+	};
+	const requireNodeProfile = () => {
+		const node = getNodeProfile();
+		if (!node) throw new Error(`${name} does not implement the node storage profile for protocol "${supportedProtocol}".`);
+		return node;
+	};
+	const getRuntimeProfile = () => {
+		const runtime = getProfiles().runtime;
+		if (!runtime) return;
+		cachedRuntimeProfile ??= runtime;
+		return cachedRuntimeProfile;
+	};
+	const requireRuntimeProfile = () => {
+		const runtime = getRuntimeProfile();
+		if (!runtime) throw new Error(`${name} does not implement the runtime storage profile for protocol "${supportedProtocol}".`);
+		return runtime;
+	};
+	const profiles = {};
+	if (profileShape?.node) profiles.node = {
+		async delete(storageUri) {
+			return requireNodeProfile().delete(storageUri);
+		},
+		async downloadFile(storageUri, filePath) {
+			return requireNodeProfile().downloadFile(storageUri, filePath);
+		},
+		async upload(key, filePath) {
+			return requireNodeProfile().upload(key, filePath);
+		}
+	};
+	else if (profileShape?.node !== false) Object.defineProperty(profiles, "node", {
+		enumerable: true,
+		get: getNodeProfile
+	});
+	if (profileShape?.runtime) profiles.runtime = {
+		async getDownloadUrl(storageUri, context) {
+			return requireRuntimeProfile().getDownloadUrl(storageUri, context);
+		},
+		async readText(storageUri, context) {
+			return requireRuntimeProfile().readText(storageUri, context);
+		}
+	};
+	else if (profileShape?.runtime !== false) Object.defineProperty(profiles, "runtime", {
+		enumerable: true,
+		get: getRuntimeProfile
+	});
+	return {
+		name,
+		supportedProtocol,
+		profiles
+	};
+};
+/**
+* Creates a deploy/CLI/console storage plugin.
+*/
+const createNodeStoragePlugin = (options) => {
+	return (config, hooks) => {
+		return () => createProfiledStoragePlugin({
+			createProfiles: () => ({ node: options.factory(config) }),
+			name: options.name,
+			profileShape: {
+				node: true,
+				runtime: false
+			},
+			supportedProtocol: options.supportedProtocol
+		}, hooks);
+	};
+};
+/**
+* Creates an update-check runtime storage plugin.
+*/
+const createRuntimeStoragePlugin = (options) => {
+	return (config, hooks) => {
+		return () => createProfiledStoragePlugin({
+			createProfiles: () => ({ runtime: options.factory(config) }),
+			name: options.name,
+			profileShape: {
+				node: false,
+				runtime: true
+			},
+			supportedProtocol: options.supportedProtocol
+		}, hooks);
+	};
+};
 /**
-* Creates a storage plugin with lazy initialization and automatic hook execution.
-*
-* This factory function abstracts the double currying pattern used by all storage plugins,
-* ensuring consistent lazy initialization behavior across different storage providers.
-* Hooks are automatically executed at appropriate times without requiring manual invocation.
-*
-* @param options - Configuration options for the storage plugin
-* @returns A double-curried function that lazily initializes the storage plugin
-*
-* @example
-* ```typescript
-* export const s3Storage = createStoragePlugin<S3StorageConfig>({
-*   name: "s3Storage",
-*   supportedProtocol: "s3",
-*   factory: (config) => {
-*     const client = new S3Client(config);
-*     return {
-*       async upload(key, filePath) { ... },
-*       async delete(storageUri) { ... },
-*       async getDownloadUrl(storageUri, context) { ... }
-*     };
-*   }
-* });
-* ```
+* Creates a storage plugin that can be used by both Node tooling and update
+* check runtimes.
 */
-const createStoragePlugin = (options) => {
+const createUniversalStoragePlugin = (options) => {
 	return (config, hooks) => {
-		return () => {
-			let cachedMethods = null;
-			const getMethods = () => {
-				if (!cachedMethods) cachedMethods = options.factory(config);
-				return cachedMethods;
-			};
-			return {
-				name: options.name,
-				supportedProtocol: options.supportedProtocol,
-				async upload(key, filePath) {
-					const result = await getMethods().upload(key, filePath);
-					await hooks?.onStorageUploaded?.();
-					return result;
-				},
-				async delete(storageUri) {
-					return getMethods().delete(storageUri);
-				},
-				async getDownloadUrl(storageUri, context) {
-					return getMethods().getDownloadUrl(storageUri, context);
-				}
-			};
-		};
+		return () => createProfiledStoragePlugin({
+			createProfiles: () => options.factory(config),
+			name: options.name,
+			profileShape: {
+				node: true,
+				runtime: true
+			},
+			supportedProtocol: options.supportedProtocol
+		}, hooks);
 	};
 };
 //#endregion
-exports.createStoragePlugin = createStoragePlugin;
+exports.createNodeStoragePlugin = createNodeStoragePlugin;
+exports.createRuntimeStoragePlugin = createRuntimeStoragePlugin;
+exports.createUniversalStoragePlugin = createUniversalStoragePlugin;

package/dist/createStoragePlugin.d.cts

@@ -1,62 +1,55 @@
-import { StoragePlugin, StoragePluginHooks } from "./types/index.cjs";
+import { NodeStoragePlugin, NodeStorageProfile, RuntimeStoragePlugin, RuntimeStorageProfile, StoragePluginHooks, StoragePluginProfiles, UniversalStoragePlugin } from "./types/index.cjs";
 
 //#region src/createStoragePlugin.d.ts
-/**
- * Storage plugin methods without name and supportedProtocol
- */
-type StoragePluginMethods<TContext = unknown> = Omit<StoragePlugin<TContext>, "name" | "supportedProtocol">;
-/**
- * Factory function that creates storage plugin methods
- */
-type StoragePluginFactory<TConfig, TContext = unknown> = (config: TConfig) => StoragePluginMethods<TContext>;
-/**
- * Configuration options for creating a storage plugin
- */
-interface CreateStoragePluginOptions<TConfig, TContext = unknown> {
+type StorageProfileFactory<TConfig, TProfiles> = (config: TConfig) => TProfiles;
+interface BaseStoragePluginOptions<TConfig, TContext = unknown, TProfiles extends StoragePluginProfiles<TContext> = StoragePluginProfiles<TContext>> {
   /**
-   * The name of the storage plugin (e.g., "s3Storage", "r2Storage")
+   * The name of the storage plugin (e.g., "s3Storage", "r2Storage").
    */
   name: string;
   /**
    * The protocol that this storage plugin supports (e.g., "s3", "r2", "gs").
    *
-   * This value is stored in the database and is used by the server to understand
-   * how to fetch assets.
-   * For example, if the protocol is "s3", assets will be stored in the format:
-   *   s3://bucketName/key
+   * This value is stored in the database and is used by the server to
+   * understand how to fetch assets.
    */
   supportedProtocol: string;
   /**
-   * Function that creates the storage plugin methods (upload, delete, getDownloadUrl)
+   * Function that creates the storage plugin profiles.
    */
-  factory: StoragePluginFactory<TConfig, TContext>;
+  factory: StorageProfileFactory<TConfig, TProfiles>;
 }
+type CreateNodeStoragePluginOptions<TConfig> = Omit<BaseStoragePluginOptions<TConfig, unknown, {
+  node: NodeStorageProfile;
+}>, "factory"> & {
+  factory: StorageProfileFactory<TConfig, NodeStorageProfile>;
+};
+type CreateRuntimeStoragePluginOptions<TConfig, TContext = unknown> = Omit<BaseStoragePluginOptions<TConfig, TContext, {
+  runtime: RuntimeStorageProfile<TContext>;
+}>, "factory"> & {
+  factory: StorageProfileFactory<TConfig, RuntimeStorageProfile<TContext>>;
+};
+type CreateUniversalStoragePluginOptions<TConfig, TContext = unknown> = Omit<BaseStoragePluginOptions<TConfig, TContext, {
+  node: NodeStorageProfile;
+  runtime: RuntimeStorageProfile<TContext>;
+}>, "factory"> & {
+  factory: StorageProfileFactory<TConfig, {
+    node: NodeStorageProfile;
+    runtime: RuntimeStorageProfile<TContext>;
+  }>;
+};
+/**
+ * Creates a deploy/CLI/console storage plugin.
+ */
+declare const createNodeStoragePlugin: <TConfig>(options: CreateNodeStoragePluginOptions<TConfig>) => (config: TConfig, hooks?: StoragePluginHooks) => () => NodeStoragePlugin;
+/**
+ * Creates an update-check runtime storage plugin.
+ */
+declare const createRuntimeStoragePlugin: <TConfig, TContext = unknown>(options: CreateRuntimeStoragePluginOptions<TConfig, TContext>) => (config: TConfig, hooks?: StoragePluginHooks) => () => RuntimeStoragePlugin<TContext>;
 /**
- * Creates a storage plugin with lazy initialization and automatic hook execution.
- *
- * This factory function abstracts the double currying pattern used by all storage plugins,
- * ensuring consistent lazy initialization behavior across different storage providers.
- * Hooks are automatically executed at appropriate times without requiring manual invocation.
- *
- * @param options - Configuration options for the storage plugin
- * @returns A double-curried function that lazily initializes the storage plugin
- *
- * @example
- * ```typescript
- * export const s3Storage = createStoragePlugin<S3StorageConfig>({
- *   name: "s3Storage",
- *   supportedProtocol: "s3",
- *   factory: (config) => {
- *     const client = new S3Client(config);
- *     return {
- *       async upload(key, filePath) { ... },
- *       async delete(storageUri) { ... },
- *       async getDownloadUrl(storageUri, context) { ... }
- *     };
- *   }
- * });
- * ```
+ * Creates a storage plugin that can be used by both Node tooling and update
+ * check runtimes.
  */
-declare const createStoragePlugin: <TConfig, TContext = unknown>(options: CreateStoragePluginOptions<TConfig, TContext>) => (config: TConfig, hooks?: StoragePluginHooks) => () => StoragePlugin<TContext>;
+declare const createUniversalStoragePlugin: <TConfig, TContext = unknown>(options: CreateUniversalStoragePluginOptions<TConfig, TContext>) => (config: TConfig, hooks?: StoragePluginHooks) => () => UniversalStoragePlugin<TContext>;
 //#endregion
-export { CreateStoragePluginOptions, createStoragePlugin };
+export { createNodeStoragePlugin, createRuntimeStoragePlugin, createUniversalStoragePlugin };

package/dist/createStoragePlugin.d.mts

@@ -1,62 +1,55 @@
-import { StoragePlugin, StoragePluginHooks } from "./types/index.mjs";
+import { NodeStoragePlugin, NodeStorageProfile, RuntimeStoragePlugin, RuntimeStorageProfile, StoragePluginHooks, StoragePluginProfiles, UniversalStoragePlugin } from "./types/index.mjs";
 
 //#region src/createStoragePlugin.d.ts
-/**
- * Storage plugin methods without name and supportedProtocol
- */
-type StoragePluginMethods<TContext = unknown> = Omit<StoragePlugin<TContext>, "name" | "supportedProtocol">;
-/**
- * Factory function that creates storage plugin methods
- */
-type StoragePluginFactory<TConfig, TContext = unknown> = (config: TConfig) => StoragePluginMethods<TContext>;
-/**
- * Configuration options for creating a storage plugin
- */
-interface CreateStoragePluginOptions<TConfig, TContext = unknown> {
+type StorageProfileFactory<TConfig, TProfiles> = (config: TConfig) => TProfiles;
+interface BaseStoragePluginOptions<TConfig, TContext = unknown, TProfiles extends StoragePluginProfiles<TContext> = StoragePluginProfiles<TContext>> {
   /**
-   * The name of the storage plugin (e.g., "s3Storage", "r2Storage")
+   * The name of the storage plugin (e.g., "s3Storage", "r2Storage").
    */
   name: string;
   /**
    * The protocol that this storage plugin supports (e.g., "s3", "r2", "gs").
    *
-   * This value is stored in the database and is used by the server to understand
-   * how to fetch assets.
-   * For example, if the protocol is "s3", assets will be stored in the format:
-   *   s3://bucketName/key
+   * This value is stored in the database and is used by the server to
+   * understand how to fetch assets.
    */
   supportedProtocol: string;
   /**
-   * Function that creates the storage plugin methods (upload, delete, getDownloadUrl)
+   * Function that creates the storage plugin profiles.
    */
-  factory: StoragePluginFactory<TConfig, TContext>;
+  factory: StorageProfileFactory<TConfig, TProfiles>;
 }
+type CreateNodeStoragePluginOptions<TConfig> = Omit<BaseStoragePluginOptions<TConfig, unknown, {
+  node: NodeStorageProfile;
+}>, "factory"> & {
+  factory: StorageProfileFactory<TConfig, NodeStorageProfile>;
+};
+type CreateRuntimeStoragePluginOptions<TConfig, TContext = unknown> = Omit<BaseStoragePluginOptions<TConfig, TContext, {
+  runtime: RuntimeStorageProfile<TContext>;
+}>, "factory"> & {
+  factory: StorageProfileFactory<TConfig, RuntimeStorageProfile<TContext>>;
+};
+type CreateUniversalStoragePluginOptions<TConfig, TContext = unknown> = Omit<BaseStoragePluginOptions<TConfig, TContext, {
+  node: NodeStorageProfile;
+  runtime: RuntimeStorageProfile<TContext>;
+}>, "factory"> & {
+  factory: StorageProfileFactory<TConfig, {
+    node: NodeStorageProfile;
+    runtime: RuntimeStorageProfile<TContext>;
+  }>;
+};
+/**
+ * Creates a deploy/CLI/console storage plugin.
+ */
+declare const createNodeStoragePlugin: <TConfig>(options: CreateNodeStoragePluginOptions<TConfig>) => (config: TConfig, hooks?: StoragePluginHooks) => () => NodeStoragePlugin;
+/**
+ * Creates an update-check runtime storage plugin.
+ */
+declare const createRuntimeStoragePlugin: <TConfig, TContext = unknown>(options: CreateRuntimeStoragePluginOptions<TConfig, TContext>) => (config: TConfig, hooks?: StoragePluginHooks) => () => RuntimeStoragePlugin<TContext>;
 /**
- * Creates a storage plugin with lazy initialization and automatic hook execution.
- *
- * This factory function abstracts the double currying pattern used by all storage plugins,
- * ensuring consistent lazy initialization behavior across different storage providers.
- * Hooks are automatically executed at appropriate times without requiring manual invocation.
- *
- * @param options - Configuration options for the storage plugin
- * @returns A double-curried function that lazily initializes the storage plugin
- *
- * @example
- * ```typescript
- * export const s3Storage = createStoragePlugin<S3StorageConfig>({
- *   name: "s3Storage",
- *   supportedProtocol: "s3",
- *   factory: (config) => {
- *     const client = new S3Client(config);
- *     return {
- *       async upload(key, filePath) { ... },
- *       async delete(storageUri) { ... },
- *       async getDownloadUrl(storageUri, context) { ... }
- *     };
- *   }
- * });
- * ```
+ * Creates a storage plugin that can be used by both Node tooling and update
+ * check runtimes.
  */
-declare const createStoragePlugin: <TConfig, TContext = unknown>(options: CreateStoragePluginOptions<TConfig, TContext>) => (config: TConfig, hooks?: StoragePluginHooks) => () => StoragePlugin<TContext>;
+declare const createUniversalStoragePlugin: <TConfig, TContext = unknown>(options: CreateUniversalStoragePluginOptions<TConfig, TContext>) => (config: TConfig, hooks?: StoragePluginHooks) => () => UniversalStoragePlugin<TContext>;
 //#endregion
-export { CreateStoragePluginOptions, createStoragePlugin };
+export { createNodeStoragePlugin, createRuntimeStoragePlugin, createUniversalStoragePlugin };

package/dist/createStoragePlugin.mjs

@@ -1,55 +1,124 @@
 //#region src/createStoragePlugin.ts
+const wrapNodeProfile = (node, hooks) => ({
+	...node,
+	async upload(key, filePath) {
+		const result = await node.upload(key, filePath);
+		await hooks?.onStorageUploaded?.();
+		return result;
+	}
+});
+const createProfiledStoragePlugin = ({ createProfiles, name, profileShape, supportedProtocol }, hooks) => {
+	let cachedProfiles = null;
+	let cachedNodeProfile;
+	let cachedRuntimeProfile;
+	const getProfiles = () => {
+		cachedProfiles ??= createProfiles();
+		return cachedProfiles;
+	};
+	const getNodeProfile = () => {
+		const node = getProfiles().node;
+		if (!node) return;
+		cachedNodeProfile ??= wrapNodeProfile(node, hooks);
+		return cachedNodeProfile;
+	};
+	const requireNodeProfile = () => {
+		const node = getNodeProfile();
+		if (!node) throw new Error(`${name} does not implement the node storage profile for protocol "${supportedProtocol}".`);
+		return node;
+	};
+	const getRuntimeProfile = () => {
+		const runtime = getProfiles().runtime;
+		if (!runtime) return;
+		cachedRuntimeProfile ??= runtime;
+		return cachedRuntimeProfile;
+	};
+	const requireRuntimeProfile = () => {
+		const runtime = getRuntimeProfile();
+		if (!runtime) throw new Error(`${name} does not implement the runtime storage profile for protocol "${supportedProtocol}".`);
+		return runtime;
+	};
+	const profiles = {};
+	if (profileShape?.node) profiles.node = {
+		async delete(storageUri) {
+			return requireNodeProfile().delete(storageUri);
+		},
+		async downloadFile(storageUri, filePath) {
+			return requireNodeProfile().downloadFile(storageUri, filePath);
+		},
+		async upload(key, filePath) {
+			return requireNodeProfile().upload(key, filePath);
+		}
+	};
+	else if (profileShape?.node !== false) Object.defineProperty(profiles, "node", {
+		enumerable: true,
+		get: getNodeProfile
+	});
+	if (profileShape?.runtime) profiles.runtime = {
+		async getDownloadUrl(storageUri, context) {
+			return requireRuntimeProfile().getDownloadUrl(storageUri, context);
+		},
+		async readText(storageUri, context) {
+			return requireRuntimeProfile().readText(storageUri, context);
+		}
+	};
+	else if (profileShape?.runtime !== false) Object.defineProperty(profiles, "runtime", {
+		enumerable: true,
+		get: getRuntimeProfile
+	});
+	return {
+		name,
+		supportedProtocol,
+		profiles
+	};
+};
+/**
+* Creates a deploy/CLI/console storage plugin.
+*/
+const createNodeStoragePlugin = (options) => {
+	return (config, hooks) => {
+		return () => createProfiledStoragePlugin({
+			createProfiles: () => ({ node: options.factory(config) }),
+			name: options.name,
+			profileShape: {
+				node: true,
+				runtime: false
+			},
+			supportedProtocol: options.supportedProtocol
+		}, hooks);
+	};
+};
+/**
+* Creates an update-check runtime storage plugin.
+*/
+const createRuntimeStoragePlugin = (options) => {
+	return (config, hooks) => {
+		return () => createProfiledStoragePlugin({
+			createProfiles: () => ({ runtime: options.factory(config) }),
+			name: options.name,
+			profileShape: {
+				node: false,
+				runtime: true
+			},
+			supportedProtocol: options.supportedProtocol
+		}, hooks);
+	};
+};
 /**
-* Creates a storage plugin with lazy initialization and automatic hook execution.
-*
-* This factory function abstracts the double currying pattern used by all storage plugins,
-* ensuring consistent lazy initialization behavior across different storage providers.
-* Hooks are automatically executed at appropriate times without requiring manual invocation.
-*
-* @param options - Configuration options for the storage plugin
-* @returns A double-curried function that lazily initializes the storage plugin
-*
-* @example
-* ```typescript
-* export const s3Storage = createStoragePlugin<S3StorageConfig>({
-*   name: "s3Storage",
-*   supportedProtocol: "s3",
-*   factory: (config) => {
-*     const client = new S3Client(config);
-*     return {
-*       async upload(key, filePath) { ... },
-*       async delete(storageUri) { ... },
-*       async getDownloadUrl(storageUri, context) { ... }
-*     };
-*   }
-* });
-* ```
+* Creates a storage plugin that can be used by both Node tooling and update
+* check runtimes.
 */
-const createStoragePlugin = (options) => {
+const createUniversalStoragePlugin = (options) => {
 	return (config, hooks) => {
-		return () => {
-			let cachedMethods = null;
-			const getMethods = () => {
-				if (!cachedMethods) cachedMethods = options.factory(config);
-				return cachedMethods;
-			};
-			return {
-				name: options.name,
-				supportedProtocol: options.supportedProtocol,
-				async upload(key, filePath) {
-					const result = await getMethods().upload(key, filePath);
-					await hooks?.onStorageUploaded?.();
-					return result;
-				},
-				async delete(storageUri) {
-					return getMethods().delete(storageUri);
-				},
-				async getDownloadUrl(storageUri, context) {
-					return getMethods().getDownloadUrl(storageUri, context);
-				}
-			};
-		};
+		return () => createProfiledStoragePlugin({
+			createProfiles: () => options.factory(config),
+			name: options.name,
+			profileShape: {
+				node: true,
+				runtime: true
+			},
+			supportedProtocol: options.supportedProtocol
+		}, hooks);
 	};
 };
 //#endregion
-export { createStoragePlugin };
+export { createNodeStoragePlugin, createRuntimeStoragePlugin, createUniversalStoragePlugin };

package/dist/index.cjs

@@ -12,24 +12,31 @@ const require_createStorageKeyBuilder = require("./createStorageKeyBuilder.cjs")
 const require_createStoragePlugin = require("./createStoragePlugin.cjs");
 const require_generateMinBundleId = require("./generateMinBundleId.cjs");
 const require_parseStorageUri = require("./parseStorageUri.cjs");
+const require_storageProfile = require("./storageProfile.cjs");
 const require_index = require("./types/index.cjs");
 const require_uuidv7 = require("./uuidv7.cjs");
+exports.assertNodeStoragePlugin = require_storageProfile.assertNodeStoragePlugin;
+exports.assertRuntimeStoragePlugin = require_storageProfile.assertRuntimeStoragePlugin;
 exports.bundleIdMatchesFilter = require_queryBundles.bundleIdMatchesFilter;
 exports.bundleMatchesQueryWhere = require_queryBundles.bundleMatchesQueryWhere;
 exports.calculatePagination = require_calculatePagination.calculatePagination;
 exports.createBlobDatabasePlugin = require_createBlobDatabasePlugin.createBlobDatabasePlugin;
 exports.createDatabasePlugin = require_createDatabasePlugin.createDatabasePlugin;
 exports.createDatabasePluginGetUpdateInfo = require_createDatabasePluginGetUpdateInfo.createDatabasePluginGetUpdateInfo;
+exports.createNodeStoragePlugin = require_createStoragePlugin.createNodeStoragePlugin;
+exports.createRuntimeStoragePlugin = require_createStoragePlugin.createRuntimeStoragePlugin;
 exports.createStorageKeyBuilder = require_createStorageKeyBuilder.createStorageKeyBuilder;
-exports.createStoragePlugin = require_createStoragePlugin.createStoragePlugin;
 exports.createUUIDv7 = require_uuidv7.createUUIDv7;
 exports.createUUIDv7WithSameTimestamp = require_uuidv7.createUUIDv7WithSameTimestamp;
+exports.createUniversalStoragePlugin = require_createStoragePlugin.createUniversalStoragePlugin;
 exports.detectCompressionFormat = require_compressionFormat.detectCompressionFormat;
 exports.extractTimestampFromUUIDv7 = require_uuidv7.extractTimestampFromUUIDv7;
 exports.filterCompatibleAppVersions = require_filterCompatibleAppVersions.filterCompatibleAppVersions;
 exports.generateMinBundleId = require_generateMinBundleId.generateMinBundleId;
 exports.getCompressionMimeType = require_compressionFormat.getCompressionMimeType;
 exports.getContentType = require_compressionFormat.getContentType;
+exports.isNodeStoragePlugin = require_storageProfile.isNodeStoragePlugin;
+exports.isRuntimeStoragePlugin = require_storageProfile.isRuntimeStoragePlugin;
 exports.paginateBundles = require_paginateBundles.paginateBundles;
 exports.parseStorageUri = require_parseStorageUri.parseStorageUri;
 exports.semverSatisfies = require_semverSatisfies.semverSatisfies;

package/dist/index.d.cts

@@ -1,17 +1,18 @@
 import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./types/utils.cjs";
-import { AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, Paginated, PaginatedResult, PaginationInfo, Platform, PlatformConfig, RequestEnvContext, SigningConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext, UpdateInfo, supportedIosPlatforms } from "./types/index.cjs";
+import { AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, supportedIosPlatforms } from "./types/index.cjs";
 import { PaginationOptions, calculatePagination } from "./calculatePagination.cjs";
 import { CompressionFormat, CompressionFormatInfo, detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.cjs";
 import { BlobDatabasePluginConfig, BlobOperations, createBlobDatabasePlugin } from "./createBlobDatabasePlugin.cjs";
 import { AbstractDatabasePlugin, CreateDatabasePluginOptions, createDatabasePlugin } from "./createDatabasePlugin.cjs";
 import { CreateDatabasePluginGetUpdateInfoOptions, createDatabasePluginGetUpdateInfo } from "./createDatabasePluginGetUpdateInfo.cjs";
 import { createStorageKeyBuilder } from "./createStorageKeyBuilder.cjs";
-import { CreateStoragePluginOptions, createStoragePlugin } from "./createStoragePlugin.cjs";
+import { createNodeStoragePlugin, createRuntimeStoragePlugin, createUniversalStoragePlugin } from "./createStoragePlugin.cjs";
 import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.cjs";
 import { generateMinBundleId } from "./generateMinBundleId.cjs";
 import { ParsedStorageUri, parseStorageUri } from "./parseStorageUri.cjs";
 import { paginateBundles } from "./paginateBundles.cjs";
 import { bundleIdMatchesFilter, bundleMatchesQueryWhere, sortBundles } from "./queryBundles.cjs";
 import { semverSatisfies } from "./semverSatisfies.cjs";
+import { assertNodeStoragePlugin, assertRuntimeStoragePlugin, isNodeStoragePlugin, isRuntimeStoragePlugin } from "./storageProfile.cjs";
 import { createUUIDv7, createUUIDv7WithSameTimestamp, extractTimestampFromUUIDv7 } from "./uuidv7.cjs";
-export { AbstractDatabasePlugin, AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BlobDatabasePluginConfig, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginGetUpdateInfoOptions, CreateDatabasePluginOptions, CreateStoragePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HasMultipleCallSignatures, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequestEnvContext, RequiredDeep, SigningConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext, UpdateInfo, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createStorageKeyBuilder, createStoragePlugin, createUUIDv7, createUUIDv7WithSameTimestamp, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, paginateBundles, parseStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };
+export { AbstractDatabasePlugin, AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BlobDatabasePluginConfig, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginGetUpdateInfoOptions, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HasMultipleCallSignatures, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequestEnvContext, RequiredDeep, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createNodeStoragePlugin, createRuntimeStoragePlugin, createStorageKeyBuilder, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };

package/dist/index.d.mts

@@ -1,17 +1,18 @@
 import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./types/utils.mjs";
-import { AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, Paginated, PaginatedResult, PaginationInfo, Platform, PlatformConfig, RequestEnvContext, SigningConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext, UpdateInfo, supportedIosPlatforms } from "./types/index.mjs";
+import { AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, supportedIosPlatforms } from "./types/index.mjs";
 import { PaginationOptions, calculatePagination } from "./calculatePagination.mjs";
 import { CompressionFormat, CompressionFormatInfo, detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.mjs";
 import { BlobDatabasePluginConfig, BlobOperations, createBlobDatabasePlugin } from "./createBlobDatabasePlugin.mjs";
 import { AbstractDatabasePlugin, CreateDatabasePluginOptions, createDatabasePlugin } from "./createDatabasePlugin.mjs";
 import { CreateDatabasePluginGetUpdateInfoOptions, createDatabasePluginGetUpdateInfo } from "./createDatabasePluginGetUpdateInfo.mjs";
 import { createStorageKeyBuilder } from "./createStorageKeyBuilder.mjs";
-import { CreateStoragePluginOptions, createStoragePlugin } from "./createStoragePlugin.mjs";
+import { createNodeStoragePlugin, createRuntimeStoragePlugin, createUniversalStoragePlugin } from "./createStoragePlugin.mjs";
 import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.mjs";
 import { generateMinBundleId } from "./generateMinBundleId.mjs";
 import { ParsedStorageUri, parseStorageUri } from "./parseStorageUri.mjs";
 import { paginateBundles } from "./paginateBundles.mjs";
 import { bundleIdMatchesFilter, bundleMatchesQueryWhere, sortBundles } from "./queryBundles.mjs";
 import { semverSatisfies } from "./semverSatisfies.mjs";
+import { assertNodeStoragePlugin, assertRuntimeStoragePlugin, isNodeStoragePlugin, isRuntimeStoragePlugin } from "./storageProfile.mjs";
 import { createUUIDv7, createUUIDv7WithSameTimestamp, extractTimestampFromUUIDv7 } from "./uuidv7.mjs";
-export { AbstractDatabasePlugin, AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BlobDatabasePluginConfig, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginGetUpdateInfoOptions, CreateDatabasePluginOptions, CreateStoragePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HasMultipleCallSignatures, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequestEnvContext, RequiredDeep, SigningConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext, UpdateInfo, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createStorageKeyBuilder, createStoragePlugin, createUUIDv7, createUUIDv7WithSameTimestamp, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, paginateBundles, parseStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };
+export { AbstractDatabasePlugin, AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BlobDatabasePluginConfig, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginGetUpdateInfoOptions, CreateDatabasePluginOptions, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, FingerprintGetBundlesArgs, GetBundlesArgs, HasMultipleCallSignatures, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequestEnvContext, RequiredDeep, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, UpdateInfo, assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createNodeStoragePlugin, createRuntimeStoragePlugin, createStorageKeyBuilder, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };

package/dist/index.mjs

@@ -8,9 +8,10 @@ import { paginateBundles } from "./paginateBundles.mjs";
 import { createBlobDatabasePlugin } from "./createBlobDatabasePlugin.mjs";
 import { createDatabasePluginGetUpdateInfo } from "./createDatabasePluginGetUpdateInfo.mjs";
 import { createStorageKeyBuilder } from "./createStorageKeyBuilder.mjs";
-import { createStoragePlugin } from "./createStoragePlugin.mjs";
+import { createNodeStoragePlugin, createRuntimeStoragePlugin, createUniversalStoragePlugin } from "./createStoragePlugin.mjs";
 import { generateMinBundleId } from "./generateMinBundleId.mjs";
 import { parseStorageUri } from "./parseStorageUri.mjs";
+import { assertNodeStoragePlugin, assertRuntimeStoragePlugin, isNodeStoragePlugin, isRuntimeStoragePlugin } from "./storageProfile.mjs";
 import { supportedIosPlatforms } from "./types/index.mjs";
 import { createUUIDv7, createUUIDv7WithSameTimestamp, extractTimestampFromUUIDv7 } from "./uuidv7.mjs";
-export { bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createStorageKeyBuilder, createStoragePlugin, createUUIDv7, createUUIDv7WithSameTimestamp, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, paginateBundles, parseStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };
+export { assertNodeStoragePlugin, assertRuntimeStoragePlugin, bundleIdMatchesFilter, bundleMatchesQueryWhere, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createDatabasePluginGetUpdateInfo, createNodeStoragePlugin, createRuntimeStoragePlugin, createStorageKeyBuilder, createUUIDv7, createUUIDv7WithSameTimestamp, createUniversalStoragePlugin, detectCompressionFormat, extractTimestampFromUUIDv7, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, isNodeStoragePlugin, isRuntimeStoragePlugin, paginateBundles, parseStorageUri, semverSatisfies, sortBundles, supportedIosPlatforms };

package/dist/storageProfile.cjs

@@ -0,0 +1,15 @@
+//#region src/storageProfile.ts
+const createMissingProfileError = (plugin, profile) => /* @__PURE__ */ new Error(`${plugin.name} does not implement the ${profile} storage profile for protocol "${plugin.supportedProtocol}".`);
+const isNodeStoragePlugin = (plugin) => Boolean(plugin.profiles.node);
+const isRuntimeStoragePlugin = (plugin) => Boolean(plugin.profiles.runtime);
+function assertNodeStoragePlugin(plugin) {
+	if (!isNodeStoragePlugin(plugin)) throw createMissingProfileError(plugin, "node");
+}
+function assertRuntimeStoragePlugin(plugin) {
+	if (!isRuntimeStoragePlugin(plugin)) throw createMissingProfileError(plugin, "runtime");
+}
+//#endregion
+exports.assertNodeStoragePlugin = assertNodeStoragePlugin;
+exports.assertRuntimeStoragePlugin = assertRuntimeStoragePlugin;
+exports.isNodeStoragePlugin = isNodeStoragePlugin;
+exports.isRuntimeStoragePlugin = isRuntimeStoragePlugin;

package/dist/storageProfile.d.cts

@@ -0,0 +1,9 @@
+import { NodeStoragePlugin, RuntimeStoragePlugin, StoragePlugin } from "./types/index.cjs";
+
+//#region src/storageProfile.d.ts
+declare const isNodeStoragePlugin: <TContext = unknown>(plugin: StoragePlugin<TContext>) => plugin is NodeStoragePlugin<TContext>;
+declare const isRuntimeStoragePlugin: <TContext = unknown>(plugin: StoragePlugin<TContext>) => plugin is RuntimeStoragePlugin<TContext>;
+declare function assertNodeStoragePlugin<TContext = unknown>(plugin: StoragePlugin<TContext>): asserts plugin is NodeStoragePlugin<TContext>;
+declare function assertRuntimeStoragePlugin<TContext = unknown>(plugin: StoragePlugin<TContext>): asserts plugin is RuntimeStoragePlugin<TContext>;
+//#endregion
+export { assertNodeStoragePlugin, assertRuntimeStoragePlugin, isNodeStoragePlugin, isRuntimeStoragePlugin };

package/dist/storageProfile.d.mts

@@ -0,0 +1,9 @@
+import { NodeStoragePlugin, RuntimeStoragePlugin, StoragePlugin } from "./types/index.mjs";
+
+//#region src/storageProfile.d.ts
+declare const isNodeStoragePlugin: <TContext = unknown>(plugin: StoragePlugin<TContext>) => plugin is NodeStoragePlugin<TContext>;
+declare const isRuntimeStoragePlugin: <TContext = unknown>(plugin: StoragePlugin<TContext>) => plugin is RuntimeStoragePlugin<TContext>;
+declare function assertNodeStoragePlugin<TContext = unknown>(plugin: StoragePlugin<TContext>): asserts plugin is NodeStoragePlugin<TContext>;
+declare function assertRuntimeStoragePlugin<TContext = unknown>(plugin: StoragePlugin<TContext>): asserts plugin is RuntimeStoragePlugin<TContext>;
+//#endregion
+export { assertNodeStoragePlugin, assertRuntimeStoragePlugin, isNodeStoragePlugin, isRuntimeStoragePlugin };

package/dist/storageProfile.mjs

@@ -0,0 +1,12 @@
+//#region src/storageProfile.ts
+const createMissingProfileError = (plugin, profile) => /* @__PURE__ */ new Error(`${plugin.name} does not implement the ${profile} storage profile for protocol "${plugin.supportedProtocol}".`);
+const isNodeStoragePlugin = (plugin) => Boolean(plugin.profiles.node);
+const isRuntimeStoragePlugin = (plugin) => Boolean(plugin.profiles.runtime);
+function assertNodeStoragePlugin(plugin) {
+	if (!isNodeStoragePlugin(plugin)) throw createMissingProfileError(plugin, "node");
+}
+function assertRuntimeStoragePlugin(plugin) {
+	if (!isRuntimeStoragePlugin(plugin)) throw createMissingProfileError(plugin, "runtime");
+}
+//#endregion
+export { assertNodeStoragePlugin, assertRuntimeStoragePlugin, isNodeStoragePlugin, isRuntimeStoragePlugin };

package/dist/types/index.d.cts

@@ -269,20 +269,61 @@ interface RequestEnvContext<TEnv = unknown> {
 }
 type HotUpdaterContext<TContext = unknown> = TContext;
 type StorageResolveContext<TContext = unknown> = HotUpdaterContext<TContext>;
-interface StoragePlugin<TContext = unknown> {
-  /**
-   * Protocol this storage plugin can resolve.
-   * @example "s3", "r2", "supabase-storage".
-   */
-  supportedProtocol: string;
+interface NodeStorageProfile {
   upload: (key: string, filePath: string) => Promise<{
     storageUri: string;
   }>;
   delete: (storageUri: string) => Promise<void>;
+  downloadFile: (storageUri: string, filePath: string) => Promise<void>;
+}
+interface RuntimeStorageProfile<TContext = unknown> {
   getDownloadUrl: (storageUri: string, context?: StorageResolveContext<TContext>) => Promise<{
     fileUrl: string;
   }>;
+  readText: (storageUri: string, context?: StorageResolveContext<TContext>) => Promise<string | null>;
+}
+interface StoragePluginProfiles<TContext = unknown> {
+  /**
+   * Node/deploy/console profile.
+   *
+   * Use this profile when the caller can materialize storage objects to the
+   * local filesystem.
+   */
+  node?: NodeStorageProfile;
+  /**
+   * Runtime update-check profile.
+   *
+   * Use this profile when the caller needs signed/public client URLs and direct
+   * server-side reads for small control-plane text objects such as manifests.
+   */
+  runtime?: RuntimeStorageProfile<TContext>;
+}
+interface StoragePlugin<TContext = unknown> {
+  /**
+   * Protocol this storage plugin can resolve.
+   * @example "s3", "r2", "supabase-storage".
+   */
+  supportedProtocol: string;
   name: string;
+  profiles: StoragePluginProfiles<TContext>;
+}
+interface NodeStoragePlugin<TContext = unknown> extends StoragePlugin<TContext> {
+  profiles: {
+    node: NodeStorageProfile;
+    runtime?: RuntimeStorageProfile<TContext>;
+  };
+}
+interface RuntimeStoragePlugin<TContext = unknown> extends StoragePlugin<TContext> {
+  profiles: {
+    node?: NodeStorageProfile;
+    runtime: RuntimeStorageProfile<TContext>;
+  };
+}
+interface UniversalStoragePlugin<TContext = unknown> extends StoragePlugin<TContext> {
+  profiles: {
+    node: NodeStorageProfile;
+    runtime: RuntimeStorageProfile<TContext>;
+  };
 }
 interface StoragePluginHooks {
   onStorageUploaded?: () => Promise<void>;
@@ -370,6 +411,30 @@ type ConfigInput = {
      */
     debug?: boolean;
   };
+  /**
+   * Optional pre-generated patch artifacts for faster OTA delivery.
+   *
+   * When enabled, `hot-updater deploy` tries to prepare binary patches against
+   * up to `maxBaseBundles` recent compatible bundles. Patch generation is an
+   * optimization only; archive delivery remains the fallback path.
+   *
+   * @default { enabled: true, maxBaseBundles: 3 }
+   */
+  patch?: {
+    /**
+     * Enable automatic patch generation during deploy.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Maximum number of compatible older bundles to prepare patches for.
+     * Must be a positive integer.
+     *
+     * @default 3
+     */
+    maxBaseBundles?: number;
+  };
   console?: {
     /**
      * Git repository URL
@@ -406,7 +471,7 @@ type ConfigInput = {
    */
   signing?: SigningConfig;
   build: (args: BasePluginArgs) => Promise<BuildPlugin> | BuildPlugin;
-  storage: () => Promise<StoragePlugin> | StoragePlugin;
+  storage: () => Promise<NodeStoragePlugin> | NodeStoragePlugin;
   database: () => Promise<DatabasePlugin> | DatabasePlugin;
 };
 interface NativeBuildOptions {
@@ -416,4 +481,4 @@ interface NativeBuildOptions {
   scheme?: string;
 }
 //#endregion
-export { type AppVersionGetBundlesArgs$1 as AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs$1 as FingerprintGetBundlesArgs, type GetBundlesArgs$1 as GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, SigningConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext, type UpdateInfo$1 as UpdateInfo, supportedIosPlatforms };
+export { type AppVersionGetBundlesArgs$1 as AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs$1 as FingerprintGetBundlesArgs, type GetBundlesArgs$1 as GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, type UpdateInfo$1 as UpdateInfo, supportedIosPlatforms };

package/dist/types/index.d.mts

@@ -269,20 +269,61 @@ interface RequestEnvContext<TEnv = unknown> {
 }
 type HotUpdaterContext<TContext = unknown> = TContext;
 type StorageResolveContext<TContext = unknown> = HotUpdaterContext<TContext>;
-interface StoragePlugin<TContext = unknown> {
-  /**
-   * Protocol this storage plugin can resolve.
-   * @example "s3", "r2", "supabase-storage".
-   */
-  supportedProtocol: string;
+interface NodeStorageProfile {
   upload: (key: string, filePath: string) => Promise<{
     storageUri: string;
   }>;
   delete: (storageUri: string) => Promise<void>;
+  downloadFile: (storageUri: string, filePath: string) => Promise<void>;
+}
+interface RuntimeStorageProfile<TContext = unknown> {
   getDownloadUrl: (storageUri: string, context?: StorageResolveContext<TContext>) => Promise<{
     fileUrl: string;
   }>;
+  readText: (storageUri: string, context?: StorageResolveContext<TContext>) => Promise<string | null>;
+}
+interface StoragePluginProfiles<TContext = unknown> {
+  /**
+   * Node/deploy/console profile.
+   *
+   * Use this profile when the caller can materialize storage objects to the
+   * local filesystem.
+   */
+  node?: NodeStorageProfile;
+  /**
+   * Runtime update-check profile.
+   *
+   * Use this profile when the caller needs signed/public client URLs and direct
+   * server-side reads for small control-plane text objects such as manifests.
+   */
+  runtime?: RuntimeStorageProfile<TContext>;
+}
+interface StoragePlugin<TContext = unknown> {
+  /**
+   * Protocol this storage plugin can resolve.
+   * @example "s3", "r2", "supabase-storage".
+   */
+  supportedProtocol: string;
   name: string;
+  profiles: StoragePluginProfiles<TContext>;
+}
+interface NodeStoragePlugin<TContext = unknown> extends StoragePlugin<TContext> {
+  profiles: {
+    node: NodeStorageProfile;
+    runtime?: RuntimeStorageProfile<TContext>;
+  };
+}
+interface RuntimeStoragePlugin<TContext = unknown> extends StoragePlugin<TContext> {
+  profiles: {
+    node?: NodeStorageProfile;
+    runtime: RuntimeStorageProfile<TContext>;
+  };
+}
+interface UniversalStoragePlugin<TContext = unknown> extends StoragePlugin<TContext> {
+  profiles: {
+    node: NodeStorageProfile;
+    runtime: RuntimeStorageProfile<TContext>;
+  };
 }
 interface StoragePluginHooks {
   onStorageUploaded?: () => Promise<void>;
@@ -370,6 +411,30 @@ type ConfigInput = {
      */
     debug?: boolean;
   };
+  /**
+   * Optional pre-generated patch artifacts for faster OTA delivery.
+   *
+   * When enabled, `hot-updater deploy` tries to prepare binary patches against
+   * up to `maxBaseBundles` recent compatible bundles. Patch generation is an
+   * optimization only; archive delivery remains the fallback path.
+   *
+   * @default { enabled: true, maxBaseBundles: 3 }
+   */
+  patch?: {
+    /**
+     * Enable automatic patch generation during deploy.
+     *
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Maximum number of compatible older bundles to prepare patches for.
+     * Must be a positive integer.
+     *
+     * @default 3
+     */
+    maxBaseBundles?: number;
+  };
   console?: {
     /**
      * Git repository URL
@@ -406,7 +471,7 @@ type ConfigInput = {
    */
   signing?: SigningConfig;
   build: (args: BasePluginArgs) => Promise<BuildPlugin> | BuildPlugin;
-  storage: () => Promise<StoragePlugin> | StoragePlugin;
+  storage: () => Promise<NodeStoragePlugin> | NodeStoragePlugin;
   database: () => Promise<DatabasePlugin> | DatabasePlugin;
 };
 interface NativeBuildOptions {
@@ -416,4 +481,4 @@ interface NativeBuildOptions {
   scheme?: string;
 }
 //#endregion
-export { type AppVersionGetBundlesArgs$1 as AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs$1 as FingerprintGetBundlesArgs, type GetBundlesArgs$1 as GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, SigningConfig, StoragePlugin, StoragePluginHooks, StorageResolveContext, type UpdateInfo$1 as UpdateInfo, supportedIosPlatforms };
+export { type AppVersionGetBundlesArgs$1 as AppVersionGetBundlesArgs, ApplePlatform, BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabaseBundleCursor, DatabaseBundleIdFilter, DatabaseBundleQueryOptions, DatabaseBundleQueryOrder, DatabaseBundleQueryWhere, DatabasePlugin, DatabasePluginHooks, type FingerprintGetBundlesArgs$1 as FingerprintGetBundlesArgs, type GetBundlesArgs$1 as GetBundlesArgs, HotUpdaterContext, IosBuildDestination, NativeBuildAndroidScheme, NativeBuildArgs, NativeBuildIosScheme, NativeBuildOptions, NodeStoragePlugin, NodeStorageProfile, Paginated, PaginatedResult, PaginationInfo, type Platform$1 as Platform, PlatformConfig, RequestEnvContext, RuntimeStoragePlugin, RuntimeStorageProfile, SigningConfig, StoragePlugin, StoragePluginHooks, StoragePluginProfiles, StorageResolveContext, UniversalStoragePlugin, type UpdateInfo$1 as UpdateInfo, supportedIosPlatforms };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/plugin-core",
-  "version": "0.30.12",
+  "version": "0.31.1",
   "type": "module",
   "description": "React Native OTA solution for self-hosted",
   "sideEffects": false,
@@ -42,14 +42,14 @@
     "es-toolkit": "^1.32.0",
     "mime": "^4.0.4",
     "semver": "^7.7.2",
-    "@hot-updater/core": "0.30.12",
-    "@hot-updater/js": "0.30.12"
+    "@hot-updater/core": "0.31.1",
+    "@hot-updater/js": "0.31.1"
   },
   "devDependencies": {
     "@types/node": "^20",
     "@types/semver": "^7.5.8",
     "typescript": "6.0.2",
-    "@hot-updater/test-utils": "0.30.12"
+    "@hot-updater/test-utils": "0.31.1"
   },
   "scripts": {
     "build": "tsdown",