@hot-updater/plugin-core 0.22.2 → 0.23.0

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./types/utils.cjs";
-import { BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabasePlugin, DatabasePluginHooks, NativeBuildArgs, PaginationInfo, Platform, PlatformConfig, StoragePlugin, StoragePluginHooks } from "./types/index.cjs";
+import { BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabasePlugin, DatabasePluginHooks, NativeBuildArgs, PaginationInfo, Platform, PlatformConfig, SigningConfig, StoragePlugin, StoragePluginHooks } from "./types/index.cjs";
 import { PaginatedResult, PaginationOptions, calculatePagination } from "./calculatePagination.cjs";
 import { CompressionFormat, CompressionFormatInfo, detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.cjs";
 import { BlobOperations, createBlobDatabasePlugin } from "./createBlobDatabasePlugin.cjs";
@@ -10,4 +10,4 @@ import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.cjs";
 import { generateMinBundleId } from "./generateMinBundleId.cjs";
 import { ParsedStorageUri, parseStorageUri } from "./parseStorageUri.cjs";
 import { semverSatisfies } from "./semverSatisfies.cjs";
-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 };
+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, SigningConfig, StoragePlugin, StoragePluginHooks, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createStorageKeyBuilder, createStoragePlugin, detectCompressionFormat, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, parseStorageUri, semverSatisfies };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import { BuiltIns, HasMultipleCallSignatures, Primitive, RequiredDeep } from "./types/utils.js";
-import { BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabasePlugin, DatabasePluginHooks, NativeBuildArgs, PaginationInfo, Platform, PlatformConfig, StoragePlugin, StoragePluginHooks } from "./types/index.js";
+import { BasePluginArgs, BuildPlugin, BuildPluginConfig, Bundle, ConfigInput, DatabasePlugin, DatabasePluginHooks, NativeBuildArgs, PaginationInfo, Platform, PlatformConfig, SigningConfig, StoragePlugin, StoragePluginHooks } from "./types/index.js";
 import { PaginatedResult, PaginationOptions, calculatePagination } from "./calculatePagination.js";
 import { CompressionFormat, CompressionFormatInfo, detectCompressionFormat, getCompressionMimeType, getContentType } from "./compressionFormat.js";
 import { BlobOperations, createBlobDatabasePlugin } from "./createBlobDatabasePlugin.js";
@@ -10,4 +10,4 @@ import { filterCompatibleAppVersions } from "./filterCompatibleAppVersions.js";
 import { generateMinBundleId } from "./generateMinBundleId.js";
 import { ParsedStorageUri, parseStorageUri } from "./parseStorageUri.js";
 import { semverSatisfies } from "./semverSatisfies.js";
-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 };
+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, SigningConfig, StoragePlugin, StoragePluginHooks, calculatePagination, createBlobDatabasePlugin, createDatabasePlugin, createStorageKeyBuilder, createStoragePlugin, detectCompressionFormat, filterCompatibleAppVersions, generateMinBundleId, getCompressionMimeType, getContentType, parseStorageUri, semverSatisfies };

package/dist/types/index.d.cts

@@ -130,6 +130,40 @@ interface StoragePlugin {
 interface StoragePluginHooks {
   onStorageUploaded?: () => Promise<void>;
 }
+/**
+ * Signing configuration type with conditional required fields.
+ * When enabled is true, privateKeyPath is required.
+ * When enabled is false, privateKeyPath is optional.
+ */
+type SigningConfig = {
+  /**
+   * Enable bundle signing during deployment.
+   * When false, signing is disabled and privateKeyPath is optional.
+   */
+  enabled: false;
+  /**
+   * Path to RSA private key file in PEM format (PKCS#8).
+   * Optional when signing is disabled.
+   */
+  privateKeyPath?: string;
+} | {
+  /**
+   * Enable bundle signing during deployment.
+   * When true, bundles will be signed with privateKeyPath.
+   */
+  enabled: true;
+  /**
+   * Path to RSA private key file in PEM format (PKCS#8).
+   * Generate with: npx hot-updater keys:generate
+   *
+   * Security: Never commit this key to version control!
+   * Use secure storage (AWS Secrets Manager, etc.) for CI/CD.
+   *
+   * @example "./keys/private-key.pem"
+   * @example "/secure/path/to/private-key.pem"
+   */
+  privateKeyPath: string;
+};
 type ConfigInput = {
   /**
    * The channel used when building the native app.
@@ -193,9 +227,30 @@ type ConfigInput = {
   };
   platform?: PlatformConfig;
   nativeBuild?: NativeBuildArgs;
+  /**
+   * Code signing configuration for bundle verification.
+   * Enables RSA-SHA256 cryptographic signatures for bundle integrity.
+   *
+   * @optional Feature is opt-in for backward compatibility
+   *
+   * @example
+   * ```ts
+   * // Signing enabled - privateKeyPath is required
+   * signing: {
+   *   enabled: true,
+   *   privateKeyPath: './keys/private-key.pem'
+   * }
+   *
+   * // Signing disabled - privateKeyPath is optional
+   * signing: {
+   *   enabled: false
+   * }
+   * ```
+   */
+  signing?: SigningConfig;
   build: (args: BasePluginArgs) => Promise<BuildPlugin> | BuildPlugin;
   storage: () => Promise<StoragePlugin> | StoragePlugin;
   database: () => Promise<DatabasePlugin> | DatabasePlugin;
 };
 //#endregion
-export { BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabasePlugin, DatabasePluginHooks, NativeBuildArgs, PaginationInfo, type Platform$1 as Platform, PlatformConfig, StoragePlugin, StoragePluginHooks };
+export { BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabasePlugin, DatabasePluginHooks, NativeBuildArgs, PaginationInfo, type Platform$1 as Platform, PlatformConfig, SigningConfig, StoragePlugin, StoragePluginHooks };

package/dist/types/index.d.ts

@@ -130,6 +130,40 @@ interface StoragePlugin {
 interface StoragePluginHooks {
   onStorageUploaded?: () => Promise<void>;
 }
+/**
+ * Signing configuration type with conditional required fields.
+ * When enabled is true, privateKeyPath is required.
+ * When enabled is false, privateKeyPath is optional.
+ */
+type SigningConfig = {
+  /**
+   * Enable bundle signing during deployment.
+   * When false, signing is disabled and privateKeyPath is optional.
+   */
+  enabled: false;
+  /**
+   * Path to RSA private key file in PEM format (PKCS#8).
+   * Optional when signing is disabled.
+   */
+  privateKeyPath?: string;
+} | {
+  /**
+   * Enable bundle signing during deployment.
+   * When true, bundles will be signed with privateKeyPath.
+   */
+  enabled: true;
+  /**
+   * Path to RSA private key file in PEM format (PKCS#8).
+   * Generate with: npx hot-updater keys:generate
+   *
+   * Security: Never commit this key to version control!
+   * Use secure storage (AWS Secrets Manager, etc.) for CI/CD.
+   *
+   * @example "./keys/private-key.pem"
+   * @example "/secure/path/to/private-key.pem"
+   */
+  privateKeyPath: string;
+};
 type ConfigInput = {
   /**
    * The channel used when building the native app.
@@ -193,9 +227,30 @@ type ConfigInput = {
   };
   platform?: PlatformConfig;
   nativeBuild?: NativeBuildArgs;
+  /**
+   * Code signing configuration for bundle verification.
+   * Enables RSA-SHA256 cryptographic signatures for bundle integrity.
+   *
+   * @optional Feature is opt-in for backward compatibility
+   *
+   * @example
+   * ```ts
+   * // Signing enabled - privateKeyPath is required
+   * signing: {
+   *   enabled: true,
+   *   privateKeyPath: './keys/private-key.pem'
+   * }
+   *
+   * // Signing disabled - privateKeyPath is optional
+   * signing: {
+   *   enabled: false
+   * }
+   * ```
+   */
+  signing?: SigningConfig;
   build: (args: BasePluginArgs) => Promise<BuildPlugin> | BuildPlugin;
   storage: () => Promise<StoragePlugin> | StoragePlugin;
   database: () => Promise<DatabasePlugin> | DatabasePlugin;
 };
 //#endregion
-export { BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabasePlugin, DatabasePluginHooks, NativeBuildArgs, PaginationInfo, type Platform$1 as Platform, PlatformConfig, StoragePlugin, StoragePluginHooks };
+export { BasePluginArgs, BuildPlugin, BuildPluginConfig, type Bundle$1 as Bundle, ConfigInput, DatabasePlugin, DatabasePluginHooks, NativeBuildArgs, PaginationInfo, type Platform$1 as Platform, PlatformConfig, SigningConfig, StoragePlugin, StoragePluginHooks };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hot-updater/plugin-core",
-  "version": "0.22.2",
+  "version": "0.23.0",
   "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.22.2"
+    "@hot-updater/core": "0.23.0"
   },
   "devDependencies": {
     "@types/semver": "^7.5.8",
     "typescript": "5.8.2",
-    "@hot-updater/test-utils": "0.22.2"
+    "@hot-updater/test-utils": "0.23.0"
   },
   "scripts": {
     "build": "tsdown",