@hot-updater/plugin-core 0.21.11 → 0.21.13

package/dist/createStoragePlugin.d.cts

@@ -0,0 +1,63 @@
+import { StoragePlugin, StoragePluginHooks } from "./types/index.cjs";
+
+//#region src/createStoragePlugin.d.ts
+
+/**
+ * Storage plugin methods without name and supportedProtocol
+ */
+type StoragePluginMethods = Omit<StoragePlugin, "name" | "supportedProtocol">;
+/**
+ * Factory function that creates storage plugin methods
+ */
+type StoragePluginFactory<TConfig> = (config: TConfig) => StoragePluginMethods;
+/**
+ * Configuration options for creating a storage plugin
+ */
+interface CreateStoragePluginOptions<TConfig> {
+  /**
+   * 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
+   */
+  supportedProtocol: string;
+  /**
+   * Function that creates the storage plugin methods (upload, delete, getDownloadUrl)
+   */
+  factory: StoragePluginFactory<TConfig>;
+}
+/**
+ * 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) { ... }
+ *     };
+ *   }
+ * });
+ * ```
+ */
+declare const createStoragePlugin: <TConfig>(options: CreateStoragePluginOptions<TConfig>) => (config: TConfig, hooks?: StoragePluginHooks) => () => StoragePlugin;
+//#endregion
+export { CreateStoragePluginOptions, createStoragePlugin };

package/dist/createStoragePlugin.d.ts

@@ -0,0 +1,63 @@
+import { StoragePlugin, StoragePluginHooks } from "./types/index.js";
+
+//#region src/createStoragePlugin.d.ts
+
+/**
+ * Storage plugin methods without name and supportedProtocol
+ */
+type StoragePluginMethods = Omit<StoragePlugin, "name" | "supportedProtocol">;
+/**
+ * Factory function that creates storage plugin methods
+ */
+type StoragePluginFactory<TConfig> = (config: TConfig) => StoragePluginMethods;
+/**
+ * Configuration options for creating a storage plugin
+ */
+interface CreateStoragePluginOptions<TConfig> {
+  /**
+   * 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
+   */
+  supportedProtocol: string;
+  /**
+   * Function that creates the storage plugin methods (upload, delete, getDownloadUrl)
+   */
+  factory: StoragePluginFactory<TConfig>;
+}
+/**
+ * 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) { ... }
+ *     };
+ *   }
+ * });
+ * ```
+ */
+declare const createStoragePlugin: <TConfig>(options: CreateStoragePluginOptions<TConfig>) => (config: TConfig, hooks?: StoragePluginHooks) => () => StoragePlugin;
+//#endregion
+export { CreateStoragePluginOptions, createStoragePlugin };

package/dist/createStoragePlugin.js

@@ -0,0 +1,56 @@
+//#region src/createStoragePlugin.ts
+/**
+* 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) { ... }
+*     };
+*   }
+* });
+* ```
+*/
+const createStoragePlugin = (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) {
+					return getMethods().getDownloadUrl(storageUri);
+				}
+			};
+		};
+	};
+};
+
+//#endregion
+export { createStoragePlugin };

package/dist/index.cjs

@@ -3,6 +3,7 @@ const require_compressionFormat = require('./compressionFormat.cjs');
 const require_createDatabasePlugin = require('./createDatabasePlugin.cjs');
 const require_createBlobDatabasePlugin = require('./createBlobDatabasePlugin.cjs');
 const require_createStorageKeyBuilder = require('./createStorageKeyBuilder.cjs');
+const require_createStoragePlugin = require('./createStoragePlugin.cjs');
 const require_semverSatisfies = require('./semverSatisfies.cjs');
 const require_filterCompatibleAppVersions = require('./filterCompatibleAppVersions.cjs');
 const require_generateMinBundleId = require('./generateMinBundleId.cjs');
@@ -12,6 +13,7 @@ exports.calculatePagination = require_calculatePagination.calculatePagination;
 exports.createBlobDatabasePlugin = require_createBlobDatabasePlugin.createBlobDatabasePlugin;
 exports.createDatabasePlugin = require_createDatabasePlugin.createDatabasePlugin;
 exports.createStorageKeyBuilder = require_createStorageKeyBuilder.createStorageKeyBuilder;
+exports.createStoragePlugin = require_createStoragePlugin.createStoragePlugin;
 exports.detectCompressionFormat = require_compressionFormat.detectCompressionFormat;
 exports.filterCompatibleAppVersions = require_filterCompatibleAppVersions.filterCompatibleAppVersions;
 exports.generateMinBundleId = require_generateMinBundleId.generateMinBundleId;

package/dist/index.d.cts

@@ -2,11 +2,12 @@ import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./
 import { BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabasePlugin, DatabasePluginHooks, NativeBuildArgs, PaginationInfo, Platform, PlatformConfig, StoragePlugin, StoragePluginHooks } from "./types/index.cjs";
 import { PaginatedResult, PaginationOptions, calculatePagination } from "./calculatePagination.cjs";
 import { CompressionFormat, CompressionFormatInfo, detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.cjs";
-import { createBlobDatabasePlugin } from "./createBlobDatabasePlugin.cjs";
-import { AbstractDatabasePlugin, createDatabasePlugin } from "./createDatabasePlugin.cjs";
+import { BlobOperations, createBlobDatabasePlugin } from "./createBlobDatabasePlugin.cjs";
+import { AbstractDatabasePlugin, CreateDatabasePluginOptions, createDatabasePlugin } from "./createDatabasePlugin.cjs";
 import { createStorageKeyBuilder } from "./createStorageKeyBuilder.cjs";
+import { CreateStoragePluginOptions, createStoragePlugin } from "./createStoragePlugin.cjs";
 import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.cjs";
 import { generateMinBundleId } from "./generateMinBundleId.cjs";
 import { ParsedStorageUri, parseStorageUri } from "./parseStorageUri.cjs";
 import { semverSatisfies } from "./semverSatisfies.cjs";
-export { AbstractDatabasePlugin, BasePluginArgs, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, DatabasePlugin, DatabasePluginHooks, HasMultipleCallSignatures, NativeBuildArgs, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequiredDeep, StoragePlugin, StoragePluginHooks, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createStorageKeyBuilder, detectCompressionFormat, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, parseStorageUri, semverSatisfies };
+export { AbstractDatabasePlugin, BasePluginArgs, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginOptions, CreateStoragePluginOptions, DatabasePlugin, DatabasePluginHooks, HasMultipleCallSignatures, NativeBuildArgs, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequiredDeep, StoragePlugin, StoragePluginHooks, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createStorageKeyBuilder, createStoragePlugin, detectCompressionFormat, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, parseStorageUri, semverSatisfies };

package/dist/index.d.ts

@@ -2,11 +2,12 @@ import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./
 import { BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabasePlugin, DatabasePluginHooks, NativeBuildArgs, PaginationInfo, Platform, PlatformConfig, StoragePlugin, StoragePluginHooks } from "./types/index.js";
 import { PaginatedResult, PaginationOptions, calculatePagination } from "./calculatePagination.js";
 import { CompressionFormat, CompressionFormatInfo, detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.js";
-import { createBlobDatabasePlugin } from "./createBlobDatabasePlugin.js";
-import { AbstractDatabasePlugin, createDatabasePlugin } from "./createDatabasePlugin.js";
+import { BlobOperations, createBlobDatabasePlugin } from "./createBlobDatabasePlugin.js";
+import { AbstractDatabasePlugin, CreateDatabasePluginOptions, createDatabasePlugin } from "./createDatabasePlugin.js";
 import { createStorageKeyBuilder } from "./createStorageKeyBuilder.js";
+import { CreateStoragePluginOptions, createStoragePlugin } from "./createStoragePlugin.js";
 import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.js";
 import { generateMinBundleId } from "./generateMinBundleId.js";
 import { ParsedStorageUri, parseStorageUri } from "./parseStorageUri.js";
 import { semverSatisfies } from "./semverSatisfies.js";
-export { AbstractDatabasePlugin, BasePluginArgs, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, DatabasePlugin, DatabasePluginHooks, HasMultipleCallSignatures, NativeBuildArgs, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequiredDeep, StoragePlugin, StoragePluginHooks, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createStorageKeyBuilder, detectCompressionFormat, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, parseStorageUri, semverSatisfies };
+export { AbstractDatabasePlugin, BasePluginArgs, BlobOperations, BuildPlugin, BuildPluginConfig, BuiltIns, Bundle, CompressionFormat, CompressionFormatInfo, ConfigInput, CreateDatabasePluginOptions, CreateStoragePluginOptions, DatabasePlugin, DatabasePluginHooks, HasMultipleCallSignatures, NativeBuildArgs, PaginatedResult, PaginationInfo, PaginationOptions, ParsedStorageUri, Platform, PlatformConfig, Primitive, RequiredDeep, StoragePlugin, StoragePluginHooks, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createStorageKeyBuilder, createStoragePlugin, detectCompressionFormat, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, parseStorageUri, semverSatisfies };

package/dist/index.js

@@ -3,9 +3,10 @@ import { detectCompressionFormat, getCompressionMimeType, getContentType } from
 import { createDatabasePlugin } from "./createDatabasePlugin.js";
 import { createBlobDatabasePlugin } from "./createBlobDatabasePlugin.js";
 import { createStorageKeyBuilder } from "./createStorageKeyBuilder.js";
+import { createStoragePlugin } from "./createStoragePlugin.js";
 import { semverSatisfies } from "./semverSatisfies.js";
 import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.js";
 import { generateMinBundleId } from "./generateMinBundleId.js";
 import { parseStorageUri } from "./parseStorageUri.js";
 
-export { calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createStorageKeyBuilder, detectCompressionFormat, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, parseStorageUri, semverSatisfies };
+export { calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createStorageKeyBuilder, createStoragePlugin, detectCompressionFormat, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, parseStorageUri, semverSatisfies };

package/package.json

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