@hot-updater/server 0.36.7 → 1.0.0-rc.0

package/dist/db/schemaReadiness.mjs

@@ -1,8 +1,9 @@
-import { HOT_UPDATER_SCHEMA_VERSION } from "../schema/types.mjs";
+import "../schema/types.mjs";
+import { unsupportedSchemaUpgradeMessage } from "./fixedMigratorShared.mjs";
 //#region src/db/schemaReadiness.ts
 var HotUpdaterSchemaMigrationRequiredError = class extends Error {
 	constructor(adapterName, currentVersion) {
-		super(currentVersion === void 0 ? `Hot Updater database schema is not initialized for ${adapterName}. Run \`hot-updater db migrate\` before using this adapter.` : `Hot Updater database schema version ${currentVersion} is not supported by ${adapterName}. Run \`hot-updater db migrate\` to upgrade to ${HOT_UPDATER_SCHEMA_VERSION}.`);
+		super(currentVersion === void 0 ? `Hot Updater database schema is not initialized for ${adapterName}. Run \`hot-updater db migrate\` before using this adapter.` : unsupportedSchemaUpgradeMessage(currentVersion));
 		this.adapterName = adapterName;
 		this.currentVersion = currentVersion;
 		this.name = "HotUpdaterSchemaMigrationRequiredError";
@@ -14,7 +15,7 @@ const createSchemaReadinessChecker = (adapterName, createMigrator) => {
 	return async () => {
 		if (ready) return;
 		const version = await createMigrator().getVersion();
-		if (version !== "0.31.0") throw new HotUpdaterSchemaMigrationRequiredError(adapterName, version);
+		if (version !== "1.0.0") throw new HotUpdaterSchemaMigrationRequiredError(adapterName, version);
 		ready = true;
 	};
 };

package/dist/db/sqlMigrationExecution.cjs

@@ -0,0 +1,67 @@
+require("../_virtual/_rolldown/runtime.cjs");
+let kysely = require("kysely");
+//#region src/db/sqlMigrationExecution.ts
+var SqliteMigrationForeignKeyError = class extends Error {
+	name = "SqliteMigrationForeignKeyError";
+	constructor(violations) {
+		super(`SQLite migration produced ${violations} foreign key violation(s).`);
+		this.violations = violations;
+	}
+};
+const executeTransactionalStatements = async (db, statements) => {
+	await db.getExecutor().provideConnection(async (connection) => {
+		const execute = (statement) => connection.executeQuery(kysely.sql.raw(statement).compile(db));
+		await execute("begin");
+		try {
+			for (const statement of statements) await execute(statement);
+			await execute("commit");
+		} catch (error) {
+			await execute("rollback");
+			throw error;
+		}
+	});
+};
+const executeSqliteStatements = async (db, statements) => {
+	await db.getExecutor().provideConnection(async (connection) => {
+		const execute = (statement) => connection.executeQuery(kysely.sql.raw(statement).compile(db));
+		const state = (await execute("pragma foreign_keys")).rows[0];
+		const foreignKeysWereEnabled = typeof state === "object" && state !== null && "foreign_keys" in state && state.foreign_keys === 1;
+		await execute("pragma foreign_keys = off");
+		try {
+			await execute("begin");
+			try {
+				for (const statement of statements) {
+					if (statement === "pragma foreign_keys = off" || statement === "pragma foreign_keys = on") continue;
+					if (statement === "pragma foreign_key_check") {
+						const result = await execute(statement);
+						if (result.rows.length > 0) throw new SqliteMigrationForeignKeyError(result.rows.length);
+						continue;
+					}
+					await execute(statement);
+				}
+				await execute("commit");
+			} catch (error) {
+				await execute("rollback");
+				throw error;
+			}
+		} finally {
+			await execute(foreignKeysWereEnabled ? "pragma foreign_keys = on" : "pragma foreign_keys = off");
+		}
+	});
+};
+const executeMysqlStatements = async (db, statements) => {
+	for (const statement of statements) await kysely.sql.raw(statement).execute(db);
+};
+const executeMigrationStatements = async ({ db, provider, statements }) => {
+	if (provider === "mysql") {
+		await executeMysqlStatements(db, statements);
+		return;
+	}
+	if (provider === "sqlite") {
+		await executeSqliteStatements(db, statements);
+		return;
+	}
+	await executeTransactionalStatements(db, statements);
+};
+//#endregion
+exports.executeMigrationStatements = executeMigrationStatements;

package/dist/db/sqlMigrationExecution.mjs

@@ -0,0 +1,66 @@
+import { sql } from "kysely";
+//#region src/db/sqlMigrationExecution.ts
+var SqliteMigrationForeignKeyError = class extends Error {
+	name = "SqliteMigrationForeignKeyError";
+	constructor(violations) {
+		super(`SQLite migration produced ${violations} foreign key violation(s).`);
+		this.violations = violations;
+	}
+};
+const executeTransactionalStatements = async (db, statements) => {
+	await db.getExecutor().provideConnection(async (connection) => {
+		const execute = (statement) => connection.executeQuery(sql.raw(statement).compile(db));
+		await execute("begin");
+		try {
+			for (const statement of statements) await execute(statement);
+			await execute("commit");
+		} catch (error) {
+			await execute("rollback");
+			throw error;
+		}
+	});
+};
+const executeSqliteStatements = async (db, statements) => {
+	await db.getExecutor().provideConnection(async (connection) => {
+		const execute = (statement) => connection.executeQuery(sql.raw(statement).compile(db));
+		const state = (await execute("pragma foreign_keys")).rows[0];
+		const foreignKeysWereEnabled = typeof state === "object" && state !== null && "foreign_keys" in state && state.foreign_keys === 1;
+		await execute("pragma foreign_keys = off");
+		try {
+			await execute("begin");
+			try {
+				for (const statement of statements) {
+					if (statement === "pragma foreign_keys = off" || statement === "pragma foreign_keys = on") continue;
+					if (statement === "pragma foreign_key_check") {
+						const result = await execute(statement);
+						if (result.rows.length > 0) throw new SqliteMigrationForeignKeyError(result.rows.length);
+						continue;
+					}
+					await execute(statement);
+				}
+				await execute("commit");
+			} catch (error) {
+				await execute("rollback");
+				throw error;
+			}
+		} finally {
+			await execute(foreignKeysWereEnabled ? "pragma foreign_keys = on" : "pragma foreign_keys = off");
+		}
+	});
+};
+const executeMysqlStatements = async (db, statements) => {
+	for (const statement of statements) await sql.raw(statement).execute(db);
+};
+const executeMigrationStatements = async ({ db, provider, statements }) => {
+	if (provider === "mysql") {
+		await executeMysqlStatements(db, statements);
+		return;
+	}
+	if (provider === "sqlite") {
+		await executeSqliteStatements(db, statements);
+		return;
+	}
+	await executeTransactionalStatements(db, statements);
+};
+//#endregion
+export { executeMigrationStatements };

package/dist/db/types.cjs

@@ -8,11 +8,8 @@ const sqlProviders = [
 ];
 const noSqlProviders = ["mongodb"];
 [...sqlProviders, ...noSqlProviders];
-function isDatabasePluginFactory(adapter) {
-	return typeof adapter === "function";
-}
-function isDatabasePlugin(adapter) {
-	return typeof adapter === "object" && adapter !== null && "getBundleById" in adapter && "getBundles" in adapter && "getChannels" in adapter;
+function isDatabasePlugin(plugin) {
+	return typeof plugin === "object" && plugin !== null && "name" in plugin && typeof plugin.name === "string" && "models" in plugin && typeof plugin.models === "object" && plugin.models !== null && "bundles" in plugin.models && typeof plugin.models.bundles === "object" && plugin.models.bundles !== null && "findById" in plugin.models.bundles && typeof plugin.models.bundles.findById === "function" && "findMany" in plugin.models.bundles && typeof plugin.models.bundles.findMany === "function" && "count" in plugin.models.bundles && typeof plugin.models.bundles.count === "function" && "bundlePatches" in plugin.models && typeof plugin.models.bundlePatches === "object" && plugin.models.bundlePatches !== null && "findByBundleIds" in plugin.models.bundlePatches && typeof plugin.models.bundlePatches.findByBundleIds === "function" && "channels" in plugin.models && typeof plugin.models.channels === "object" && plugin.models.channels !== null && "insert" in plugin.models.channels && typeof plugin.models.channels.insert === "function" && "list" in plugin.models.channels && typeof plugin.models.channels.list === "function" && "delete" in plugin.models.channels && typeof plugin.models.channels.delete === "function" && "analytics" in plugin.models && typeof plugin.models.analytics === "object" && plugin.models.analytics !== null && "append" in plugin.models.analytics && typeof plugin.models.analytics.append === "function" && "scan" in plugin.models.analytics && typeof plugin.models.analytics.scan === "function" && "apiKeys" in plugin.models && typeof plugin.models.apiKeys === "object" && plugin.models.apiKeys !== null && "create" in plugin.models.apiKeys && typeof plugin.models.apiKeys.create === "function" && "findByHash" in plugin.models.apiKeys && typeof plugin.models.apiKeys.findByHash === "function" && "list" in plugin.models.apiKeys && typeof plugin.models.apiKeys.list === "function" && "revoke" in plugin.models.apiKeys && typeof plugin.models.apiKeys.revoke === "function" && "commit" in plugin && typeof plugin.commit === "function" && (!("dispose" in plugin) || plugin.dispose === void 0 || typeof plugin.dispose === "function");
 }
 function getSQLProvider(provider) {
 	if (!provider) return;
@@ -21,4 +18,3 @@ function getSQLProvider(provider) {
 //#endregion
 exports.getSQLProvider = getSQLProvider;
 exports.isDatabasePlugin = isDatabasePlugin;
-exports.isDatabasePluginFactory = isDatabasePluginFactory;

package/dist/db/types.d.cts

@@ -1,9 +1,11 @@
+import { ReleaseCatalogRequest } from "./releaseCatalog.cjs";
 import { PaginatedResult } from "../types/index.cjs";
-import { AppUpdateAvailableInfo, Bundle, GetBundlesArgs, UpdateInfo } from "@hot-updater/core";
-import { DatabaseBundleQueryOptions, DatabasePlugin, HotUpdaterContext, RuntimeStoragePlugin } from "@hot-updater/plugin-core";
+import * as _$_hot_updater_core0 from "@hot-updater/core";
+import { ArtifactInfo, Bundle } from "@hot-updater/core";
+import * as _$_hot_updater_plugin_core0 from "@hot-updater/plugin-core";
+import { ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult, ChannelRow, DatabaseCommit, DatabaseCommitResult, DatabasePlugin, ReleaseCatalogMutationPreflight, ReleaseCatalogMutationResult, ReleaseCatalogRebuildResult, ReleaseCatalogRow, ReleasePolicyPatch, ReleaseRow } from "@hot-updater/plugin-core";
 
 //#region src/db/types.d.ts
-type DatabasePluginFactory<TContext = unknown> = (() => DatabasePlugin<TContext>) & Partial<DatabaseAdapterCapabilities>;
 declare const sqlProviders: readonly ["sqlite", "cockroachdb", "mysql", "postgresql", "mssql"];
 declare const providers: readonly ["sqlite", "cockroachdb", "mysql", "postgresql", "mssql", "mongodb"];
 type ORMProvider = (typeof providers)[number];
@@ -23,6 +25,9 @@ type MigrationOperation = {
       type: string;
     }>;
   };
+} | {
+  type: "custom";
+  description: string;
 } | {
   type: "custom";
   sql: string;
@@ -60,18 +65,57 @@ interface DatabaseAdapterCapabilities {
   createMigrator?: () => Migrator;
   generateSchema?: SchemaGenerator;
 }
-type DatabaseAdapterWithCapabilities<TContext = unknown> = DatabasePlugin<TContext> & DatabaseAdapterCapabilities;
-type DatabaseAdapter<TContext = unknown> = DatabaseAdapterWithCapabilities<TContext> | DatabasePlugin<TContext> | DatabasePluginFactory<TContext>;
-interface DatabaseAPI<TContext = unknown> {
-  getBundleById(id: string, context?: HotUpdaterContext<TContext>): Promise<Bundle | null>;
-  getUpdateInfo(args: GetBundlesArgs, context?: HotUpdaterContext<TContext>): Promise<UpdateInfo | null>;
-  getAppUpdateInfo(args: GetBundlesArgs, context?: HotUpdaterContext<TContext>): Promise<AppUpdateAvailableInfo | null>;
-  getChannels(context?: HotUpdaterContext<TContext>): Promise<string[]>;
-  getBundles(options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>): Promise<PaginatedResult>;
-  insertBundle(bundle: Bundle, context?: HotUpdaterContext<TContext>): Promise<void>;
-  updateBundleById(bundleId: string, newBundle: Partial<Bundle>, context?: HotUpdaterContext<TContext>): Promise<void>;
-  deleteBundleById(bundleId: string, context?: HotUpdaterContext<TContext>): Promise<void>;
+type DatabaseAdapterWithCapabilities = DatabasePlugin & DatabaseAdapterCapabilities;
+type DatabasePlugin$1 = DatabaseAdapterWithCapabilities;
+interface DatabaseAPI {
+  getBundleById(id: string): Promise<Bundle | null>;
+  getReleaseCatalog(input: ReleaseCatalogRequest): Promise<_$_hot_updater_core0.ReleaseCatalog | null>;
+  getArtifactInfo(targetBundleId: string, currentBundleId: string): Promise<ArtifactInfo | null>;
+  getReleaseById(id: string): Promise<ReleaseRow | null>;
+  getReleasesByScope(input: {
+    readonly scopeKey: string;
+    readonly afterReleaseId?: string;
+    readonly limit: number;
+  }): Promise<readonly ReleaseRow[]>;
+  getReleases(input: {
+    readonly afterReleaseId?: string;
+    readonly beforeReleaseId?: string;
+    readonly bundleId?: string;
+    readonly channelId?: string;
+    readonly enabled?: boolean;
+    readonly platform?: "ios" | "android";
+    readonly targetAppVersion?: string;
+    readonly limit: number;
+  }): Promise<readonly ReleaseRow[]>;
+  getReleaseCatalogByScopeKey(scopeKey: string): Promise<ReleaseCatalogRow | null>;
+  getReleaseCatalogs(input: {
+    readonly afterScopeKey?: string;
+    readonly limit: number;
+  }): Promise<readonly ReleaseCatalogRow[]>;
+  updateReleasePolicy(input: {
+    readonly expectedRevision?: number;
+    readonly patch: ReleasePolicyPatch;
+    readonly releaseId: string;
+  }): Promise<ReleaseCatalogMutationResult>;
+  preflightReleasePolicy(input: {
+    readonly expectedRevision?: number;
+    readonly patch: ReleasePolicyPatch;
+    readonly releaseId: string;
+  }): Promise<ReleaseCatalogMutationPreflight>;
+  deleteRelease(input: {
+    readonly expectedRevision?: number;
+    readonly releaseId: string;
+  }): Promise<ReleaseCatalogMutationResult>;
+  rebuildReleaseCatalog(scopeKey: string): Promise<ReleaseCatalogRebuildResult>;
+  commitDatabase(input: DatabaseCommit): Promise<DatabaseCommitResult>;
+  getChannels(): Promise<readonly ChannelRow[]>;
+  insertChannel(input: ChannelInsertInput): Promise<ChannelInsertResult>;
+  deleteChannel(input: ChannelDeleteInput): Promise<ChannelDeleteResult>;
+  getBundles(options: _$_hot_updater_plugin_core0.DatabaseBundleQueryOptions): Promise<PaginatedResult>;
+  insertBundle(bundle: Bundle): Promise<void>;
+  insertBundles(bundles: readonly Bundle[]): Promise<void>;
+  updateBundleById(bundleId: string, newBundle: Partial<Bundle>): Promise<void>;
+  deleteBundleById(bundleId: string): Promise<void>;
 }
-type StoragePluginFactory<TContext = unknown> = () => RuntimeStoragePlugin<TContext>;
 //#endregion
-export { DatabaseAPI, DatabaseAdapter, DatabasePluginFactory, Migrator, ORMProvider, ORMSQLProvider, RelationMode, SchemaGenerator, StoragePluginFactory };
+export { DatabaseAPI, DatabaseAdapterWithCapabilities, DatabasePlugin$1 as DatabasePlugin, Migrator, ORMProvider, ORMSQLProvider, RelationMode, SchemaGenerator };

package/dist/db/types.d.mts

@@ -1,9 +1,11 @@
+import { ReleaseCatalogRequest } from "./releaseCatalog.mjs";
 import { PaginatedResult } from "../types/index.mjs";
-import { DatabaseBundleQueryOptions, DatabasePlugin, HotUpdaterContext, RuntimeStoragePlugin } from "@hot-updater/plugin-core";
-import { AppUpdateAvailableInfo, Bundle as Bundle$1, GetBundlesArgs, UpdateInfo } from "@hot-updater/core";
+import * as _$_hot_updater_plugin_core0 from "@hot-updater/plugin-core";
+import { ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult, ChannelRow, DatabaseCommit, DatabaseCommitResult, DatabasePlugin, ReleaseCatalogMutationPreflight, ReleaseCatalogMutationResult, ReleaseCatalogRebuildResult, ReleaseCatalogRow, ReleasePolicyPatch, ReleaseRow } from "@hot-updater/plugin-core";
+import * as _$_hot_updater_core0 from "@hot-updater/core";
+import { ArtifactInfo, Bundle as Bundle$1 } from "@hot-updater/core";
 
 //#region src/db/types.d.ts
-type DatabasePluginFactory<TContext = unknown> = (() => DatabasePlugin<TContext>) & Partial<DatabaseAdapterCapabilities>;
 declare const sqlProviders: readonly ["sqlite", "cockroachdb", "mysql", "postgresql", "mssql"];
 declare const providers: readonly ["sqlite", "cockroachdb", "mysql", "postgresql", "mssql", "mongodb"];
 type ORMProvider = (typeof providers)[number];
@@ -23,6 +25,9 @@ type MigrationOperation = {
       type: string;
     }>;
   };
+} | {
+  type: "custom";
+  description: string;
 } | {
   type: "custom";
   sql: string;
@@ -60,18 +65,57 @@ interface DatabaseAdapterCapabilities {
   createMigrator?: () => Migrator;
   generateSchema?: SchemaGenerator;
 }
-type DatabaseAdapterWithCapabilities<TContext = unknown> = DatabasePlugin<TContext> & DatabaseAdapterCapabilities;
-type DatabaseAdapter<TContext = unknown> = DatabaseAdapterWithCapabilities<TContext> | DatabasePlugin<TContext> | DatabasePluginFactory<TContext>;
-interface DatabaseAPI<TContext = unknown> {
-  getBundleById(id: string, context?: HotUpdaterContext<TContext>): Promise<Bundle$1 | null>;
-  getUpdateInfo(args: GetBundlesArgs, context?: HotUpdaterContext<TContext>): Promise<UpdateInfo | null>;
-  getAppUpdateInfo(args: GetBundlesArgs, context?: HotUpdaterContext<TContext>): Promise<AppUpdateAvailableInfo | null>;
-  getChannels(context?: HotUpdaterContext<TContext>): Promise<string[]>;
-  getBundles(options: DatabaseBundleQueryOptions, context?: HotUpdaterContext<TContext>): Promise<PaginatedResult>;
-  insertBundle(bundle: Bundle$1, context?: HotUpdaterContext<TContext>): Promise<void>;
-  updateBundleById(bundleId: string, newBundle: Partial<Bundle$1>, context?: HotUpdaterContext<TContext>): Promise<void>;
-  deleteBundleById(bundleId: string, context?: HotUpdaterContext<TContext>): Promise<void>;
+type DatabaseAdapterWithCapabilities = DatabasePlugin & DatabaseAdapterCapabilities;
+type DatabasePlugin$1 = DatabaseAdapterWithCapabilities;
+interface DatabaseAPI {
+  getBundleById(id: string): Promise<Bundle$1 | null>;
+  getReleaseCatalog(input: ReleaseCatalogRequest): Promise<_$_hot_updater_core0.ReleaseCatalog | null>;
+  getArtifactInfo(targetBundleId: string, currentBundleId: string): Promise<ArtifactInfo | null>;
+  getReleaseById(id: string): Promise<ReleaseRow | null>;
+  getReleasesByScope(input: {
+    readonly scopeKey: string;
+    readonly afterReleaseId?: string;
+    readonly limit: number;
+  }): Promise<readonly ReleaseRow[]>;
+  getReleases(input: {
+    readonly afterReleaseId?: string;
+    readonly beforeReleaseId?: string;
+    readonly bundleId?: string;
+    readonly channelId?: string;
+    readonly enabled?: boolean;
+    readonly platform?: "ios" | "android";
+    readonly targetAppVersion?: string;
+    readonly limit: number;
+  }): Promise<readonly ReleaseRow[]>;
+  getReleaseCatalogByScopeKey(scopeKey: string): Promise<ReleaseCatalogRow | null>;
+  getReleaseCatalogs(input: {
+    readonly afterScopeKey?: string;
+    readonly limit: number;
+  }): Promise<readonly ReleaseCatalogRow[]>;
+  updateReleasePolicy(input: {
+    readonly expectedRevision?: number;
+    readonly patch: ReleasePolicyPatch;
+    readonly releaseId: string;
+  }): Promise<ReleaseCatalogMutationResult>;
+  preflightReleasePolicy(input: {
+    readonly expectedRevision?: number;
+    readonly patch: ReleasePolicyPatch;
+    readonly releaseId: string;
+  }): Promise<ReleaseCatalogMutationPreflight>;
+  deleteRelease(input: {
+    readonly expectedRevision?: number;
+    readonly releaseId: string;
+  }): Promise<ReleaseCatalogMutationResult>;
+  rebuildReleaseCatalog(scopeKey: string): Promise<ReleaseCatalogRebuildResult>;
+  commitDatabase(input: DatabaseCommit): Promise<DatabaseCommitResult>;
+  getChannels(): Promise<readonly ChannelRow[]>;
+  insertChannel(input: ChannelInsertInput): Promise<ChannelInsertResult>;
+  deleteChannel(input: ChannelDeleteInput): Promise<ChannelDeleteResult>;
+  getBundles(options: _$_hot_updater_plugin_core0.DatabaseBundleQueryOptions): Promise<PaginatedResult>;
+  insertBundle(bundle: Bundle$1): Promise<void>;
+  insertBundles(bundles: readonly Bundle$1[]): Promise<void>;
+  updateBundleById(bundleId: string, newBundle: Partial<Bundle$1>): Promise<void>;
+  deleteBundleById(bundleId: string): Promise<void>;
 }
-type StoragePluginFactory<TContext = unknown> = () => RuntimeStoragePlugin<TContext>;
 //#endregion
-export { DatabaseAPI, DatabaseAdapter, DatabasePluginFactory, Migrator, ORMProvider, ORMSQLProvider, RelationMode, SchemaGenerator, StoragePluginFactory };
+export { DatabaseAPI, DatabaseAdapterWithCapabilities, DatabasePlugin$1 as DatabasePlugin, Migrator, ORMProvider, ORMSQLProvider, RelationMode, SchemaGenerator };

package/dist/db/types.mjs

@@ -8,15 +8,12 @@ const sqlProviders = [
 ];
 const noSqlProviders = ["mongodb"];
 [...sqlProviders, ...noSqlProviders];
-function isDatabasePluginFactory(adapter) {
-	return typeof adapter === "function";
-}
-function isDatabasePlugin(adapter) {
-	return typeof adapter === "object" && adapter !== null && "getBundleById" in adapter && "getBundles" in adapter && "getChannels" in adapter;
+function isDatabasePlugin(plugin) {
+	return typeof plugin === "object" && plugin !== null && "name" in plugin && typeof plugin.name === "string" && "models" in plugin && typeof plugin.models === "object" && plugin.models !== null && "bundles" in plugin.models && typeof plugin.models.bundles === "object" && plugin.models.bundles !== null && "findById" in plugin.models.bundles && typeof plugin.models.bundles.findById === "function" && "findMany" in plugin.models.bundles && typeof plugin.models.bundles.findMany === "function" && "count" in plugin.models.bundles && typeof plugin.models.bundles.count === "function" && "bundlePatches" in plugin.models && typeof plugin.models.bundlePatches === "object" && plugin.models.bundlePatches !== null && "findByBundleIds" in plugin.models.bundlePatches && typeof plugin.models.bundlePatches.findByBundleIds === "function" && "channels" in plugin.models && typeof plugin.models.channels === "object" && plugin.models.channels !== null && "insert" in plugin.models.channels && typeof plugin.models.channels.insert === "function" && "list" in plugin.models.channels && typeof plugin.models.channels.list === "function" && "delete" in plugin.models.channels && typeof plugin.models.channels.delete === "function" && "analytics" in plugin.models && typeof plugin.models.analytics === "object" && plugin.models.analytics !== null && "append" in plugin.models.analytics && typeof plugin.models.analytics.append === "function" && "scan" in plugin.models.analytics && typeof plugin.models.analytics.scan === "function" && "apiKeys" in plugin.models && typeof plugin.models.apiKeys === "object" && plugin.models.apiKeys !== null && "create" in plugin.models.apiKeys && typeof plugin.models.apiKeys.create === "function" && "findByHash" in plugin.models.apiKeys && typeof plugin.models.apiKeys.findByHash === "function" && "list" in plugin.models.apiKeys && typeof plugin.models.apiKeys.list === "function" && "revoke" in plugin.models.apiKeys && typeof plugin.models.apiKeys.revoke === "function" && "commit" in plugin && typeof plugin.commit === "function" && (!("dispose" in plugin) || plugin.dispose === void 0 || typeof plugin.dispose === "function");
 }
 function getSQLProvider(provider) {
 	if (!provider) return;
 	return sqlProviders.includes(provider) ? provider : void 0;
 }
 //#endregion
-export { getSQLProvider, isDatabasePlugin, isDatabasePluginFactory };
+export { getSQLProvider, isDatabasePlugin };

package/dist/db/updateArtifacts.cjs

@@ -3,6 +3,19 @@ let _hot_updater_plugin_core = require("@hot-updater/plugin-core");
 let _hot_updater_core = require("@hot-updater/core");
 //#region src/db/updateArtifacts.ts
 const HBC_ASSET_PATH_RE = /\.bundle$/;
+const asByteSize = (value) => typeof value === "number" && Number.isSafeInteger(value) && value >= 0 ? value : null;
+const sumByteSizes = (byteSizes) => {
+	let total = 0;
+	for (const byteSize of byteSizes) {
+		if (byteSize === null || total > Number.MAX_SAFE_INTEGER - byteSize) return null;
+		total += byteSize;
+	}
+	return total;
+};
+const shouldUseArchive = (targetBundle, downloadByteSize) => {
+	const archiveByteSize = asByteSize(targetBundle.archiveByteSize);
+	return archiveByteSize !== null && downloadByteSize !== null && downloadByteSize >= archiveByteSize;
+};
 const resolveUniqueHbcAssetPath = (manifest) => {
 	const candidates = Object.keys(manifest.assets).sort((left, right) => left.localeCompare(right)).filter((candidate) => HBC_ASSET_PATH_RE.test(candidate));
 	return candidates.length === 1 ? candidates[0] : null;
@@ -18,19 +31,8 @@ const isBundleManifest = (value) => {
 		return typeof manifestAsset.fileHash === "string" && (manifestAsset.signature === void 0 || typeof manifestAsset.signature === "string");
 	});
 };
-const parseBundleMetadata = (value) => {
-	if (!value) return;
-	let parsedValue = value;
-	if (typeof parsedValue === "string") try {
-		parsedValue = JSON.parse(parsedValue);
-	} catch {
-		return;
-	}
-	if (!parsedValue || typeof parsedValue !== "object" || Array.isArray(parsedValue)) return;
-	return (0, _hot_updater_core.stripBundleArtifactMetadata)(parsedValue);
-};
-async function fetchBundleManifest(storageUri, readStorageText, resolveFileUrl, context) {
-	const [storageText, fileUrl] = await Promise.all([readStorageText(storageUri, context), resolveFileUrl(storageUri, context)]);
+async function fetchBundleManifest(storageUri, readStorageText) {
+	const storageText = await readStorageText(storageUri);
 	if (storageText === null) return null;
 	let payload;
 	try {
@@ -39,89 +41,141 @@ async function fetchBundleManifest(storageUri, readStorageText, resolveFileUrl,
 		return null;
 	}
 	if (!isBundleManifest(payload)) return null;
-	if (!fileUrl) return null;
 	return {
-		fileUrl,
+		byteSize: asByteSize(new TextEncoder().encode(storageText).byteLength),
 		manifest: payload
 	};
 }
-async function resolveChangedAssets({ assetBaseStorageUri, currentManifest, currentBundle, resolveFileUrl, targetBundle, targetManifest, context }) {
-	const patchDescriptor = await resolveHbcPatchDescriptor({
+function resolveHbcPatchPlan({ currentBundle, targetBundle, targetManifest }) {
+	const matchingPatch = currentBundle ? (0, _hot_updater_core.getBundlePatch)(targetBundle, currentBundle.id) : null;
+	const patchAssetPath = resolveUniqueHbcAssetPath(targetManifest);
+	if (!currentBundle || !matchingPatch || !patchAssetPath || !matchingPatch.patchStorageUri || !matchingPatch.patchFileHash || !matchingPatch.baseFileHash) return null;
+	return {
+		assetPath: patchAssetPath,
+		patch: {
+			baseBundleId: matchingPatch.baseBundleId,
+			baseFileHash: matchingPatch.baseFileHash,
+			byteSize: asByteSize(matchingPatch.byteSize),
+			patchFileHash: matchingPatch.patchFileHash,
+			storageUri: matchingPatch.patchStorageUri
+		}
+	};
+}
+function createManifestArtifactPlan({ assetBaseStorageUri, currentManifest, currentBundle, targetBundle, targetManifest, targetManifestByteSize }) {
+	const patchCandidate = resolveHbcPatchPlan({
 		currentBundle,
-		resolveFileUrl,
 		targetBundle,
-		targetManifest,
-		context
+		targetManifest
 	});
-	const changedEntries = await Promise.all(Object.entries(targetManifest.assets).map(async ([assetPath, asset]) => {
-		if ((currentManifest?.assets[assetPath])?.fileHash === asset.fileHash) return null;
+	const changedAssets = Object.entries(targetManifest.assets).flatMap(([assetPath, asset]) => {
+		if ((currentManifest?.assets[assetPath])?.fileHash === asset.fileHash) return [];
+		const downloadByteSize = asByteSize(asset.downloadByteSize);
 		const downloadPath = (0, _hot_updater_plugin_core.getManifestAssetDownloadPath)(assetPath);
-		const usesBrotliAsset = downloadPath !== assetPath;
-		const storageUri = (0, _hot_updater_plugin_core.resolveManifestAssetStorageUri)({
-			assetBaseStorageUri,
-			assetPath: downloadPath,
-			fileHash: asset.fileHash
-		});
-		const patch = patchDescriptor?.assetPath === assetPath ? patchDescriptor.patch : null;
+		const isTransformedDownload = downloadPath !== assetPath;
+		const hasValidDownloadFileHash = (0, _hot_updater_plugin_core.isContentAddressedAssetFileHash)(asset.downloadFileHash);
+		const file = {
+			byteSize: downloadByteSize !== null && (hasValidDownloadFileHash || !isTransformedDownload && asset.downloadFileHash === void 0) ? downloadByteSize : null,
+			storageUri: (0, _hot_updater_plugin_core.resolveManifestAssetStorageUri)({
+				assetBaseStorageUri,
+				assetPath: downloadPath,
+				downloadFileHash: asset.downloadFileHash,
+				fileHash: asset.fileHash
+			})
+		};
+		if (isTransformedDownload) file.compression = "br";
+		const patch = patchCandidate?.assetPath === assetPath ? patchCandidate.patch : null;
+		return [{
+			assetPath,
+			file,
+			fileHash: asset.fileHash,
+			patch
+		}];
+	});
+	const allPossibleByteSizesKnown = targetManifestByteSize !== null && changedAssets.every((asset) => asset.file.byteSize !== null && (asset.patch === null || asset.patch.byteSize !== null));
+	const primaryByteSizes = changedAssets.map((asset) => {
+		if (!asset.patch) return asset.file.byteSize;
+		if (asset.patch.byteSize === null || asset.file.byteSize === null) return null;
+		return Math.min(asset.patch.byteSize, asset.file.byteSize);
+	});
+	return {
+		allPossibleByteSizesKnown,
+		changedAssets,
+		manifestByteSize: targetManifestByteSize,
+		minimumDownloadByteSize: allPossibleByteSizesKnown ? sumByteSizes([targetManifestByteSize, ...primaryByteSizes]) : null
+	};
+}
+async function resolveChangedAssets(plan, resolveFileUrl) {
+	const patchAsset = plan.changedAssets.find((asset) => asset.patch !== null);
+	let resolvedPatch = null;
+	if (patchAsset?.patch) {
+		const patchUrl = await resolveFileUrl(patchAsset.patch.storageUri);
+		if (patchUrl) resolvedPatch = {
+			assetPath: patchAsset.assetPath,
+			patch: {
+				algorithm: "bsdiff",
+				baseBundleId: patchAsset.patch.baseBundleId,
+				baseFileHash: patchAsset.patch.baseFileHash,
+				patchFileHash: patchAsset.patch.patchFileHash,
+				patchUrl
+			}
+		};
+	}
+	const changedEntries = await Promise.all(plan.changedAssets.map(async (asset) => {
+		let patch = resolvedPatch?.assetPath === asset.assetPath ? resolvedPatch.patch : null;
 		let fileUrl = null;
 		try {
-			fileUrl = await resolveFileUrl(storageUri, context);
+			fileUrl = await resolveFileUrl(asset.file.storageUri);
 		} catch (error) {
 			if (!patch) throw error;
 		}
-		if (!fileUrl && !patch) return false;
+		if (fileUrl && patch && asset.file.byteSize !== null && asset.patch !== null && asset.patch.byteSize !== null && asset.patch.byteSize >= asset.file.byteSize) patch = null;
+		if (!fileUrl && !patch) return null;
 		const changedAsset = { fileHash: asset.fileHash };
 		if (fileUrl) {
 			changedAsset.file = { url: fileUrl };
-			if (usesBrotliAsset) changedAsset.file.compression = "br";
+			if (asset.file.compression) changedAsset.file.compression = asset.file.compression;
 		}
 		if (patch) changedAsset.patch = patch;
-		return [assetPath, changedAsset];
+		return {
+			asset: [asset.assetPath, changedAsset],
+			primaryByteSize: patch ? asset.patch?.byteSize ?? null : asset.file.byteSize
+		};
 	}));
-	if (changedEntries.some((entry) => entry === false)) return null;
-	return Object.fromEntries(changedEntries.filter((entry) => entry !== null));
-}
-async function resolveHbcPatchDescriptor({ currentBundle, resolveFileUrl, targetBundle, targetManifest, context }) {
-	const matchingPatch = targetBundle && currentBundle ? (0, _hot_updater_core.getBundlePatch)(targetBundle, currentBundle.id) : null;
-	const patchAssetPath = resolveUniqueHbcAssetPath(targetManifest);
-	if (!currentBundle || !matchingPatch || !patchAssetPath || !matchingPatch.patchStorageUri || !matchingPatch.patchFileHash || !matchingPatch.baseFileHash) return null;
-	const patchUrl = await resolveFileUrl(matchingPatch.patchStorageUri, context);
-	if (!patchUrl) return null;
+	if (changedEntries.some((entry) => entry === null)) return null;
+	const resolvedEntries = changedEntries.filter((entry) => entry !== null);
 	return {
-		assetPath: patchAssetPath,
-		patch: {
-			algorithm: "bsdiff",
-			baseBundleId: matchingPatch.baseBundleId,
-			baseFileHash: matchingPatch.baseFileHash,
-			patchFileHash: matchingPatch.patchFileHash,
-			patchUrl
-		}
+		changedAssets: Object.fromEntries(resolvedEntries.map((entry) => entry.asset)),
+		primaryByteSizes: resolvedEntries.map((entry) => entry.primaryByteSize)
 	};
 }
-async function resolveManifestArtifacts({ currentBundle, resolveFileUrl, readStorageText, targetBundle, context }) {
+async function resolveManifestArtifacts({ archiveUrlUsable, currentBundle, resolveFileUrl, readStorageText, targetBundle }) {
 	const manifestStorageUri = targetBundle ? (0, _hot_updater_core.getManifestStorageUri)(targetBundle) : null;
 	const manifestFileHash = targetBundle ? (0, _hot_updater_core.getManifestFileHash)(targetBundle) : null;
 	const assetBaseStorageUri = targetBundle ? (0, _hot_updater_core.getAssetBaseStorageUri)(targetBundle) : null;
-	if (!manifestStorageUri || !manifestFileHash || !assetBaseStorageUri) return null;
+	if (!targetBundle || !manifestStorageUri || !manifestFileHash || !assetBaseStorageUri) return null;
 	const currentManifestStorageUri = currentBundle ? (0, _hot_updater_core.getManifestStorageUri)(currentBundle) : null;
-	const [targetManifestResult, currentManifestResult] = await Promise.all([fetchBundleManifest(manifestStorageUri, readStorageText, resolveFileUrl, context), currentManifestStorageUri ? fetchBundleManifest(currentManifestStorageUri, readStorageText, resolveFileUrl, context) : null]);
+	const [targetManifestResult, currentManifestResult] = await Promise.all([fetchBundleManifest(manifestStorageUri, readStorageText), currentManifestStorageUri ? fetchBundleManifest(currentManifestStorageUri, readStorageText) : null]);
 	if (!targetManifestResult) return null;
-	const changedAssets = await resolveChangedAssets({
+	const plan = createManifestArtifactPlan({
 		assetBaseStorageUri,
 		currentManifest: currentManifestResult?.manifest ?? null,
 		currentBundle,
-		resolveFileUrl,
 		targetBundle,
 		targetManifest: targetManifestResult.manifest,
-		context
+		targetManifestByteSize: targetManifestResult.byteSize
 	});
-	if (!changedAssets) return null;
+	if (archiveUrlUsable && plan.allPossibleByteSizesKnown && shouldUseArchive(targetBundle, plan.minimumDownloadByteSize)) return null;
+	const manifestUrl = await resolveFileUrl(manifestStorageUri);
+	if (!manifestUrl) return null;
+	const resolved = await resolveChangedAssets(plan, resolveFileUrl);
+	if (!resolved) return null;
+	const resolvedDownloadByteSize = sumByteSizes([plan.manifestByteSize, ...resolved.primaryByteSizes]);
+	if (archiveUrlUsable && shouldUseArchive(targetBundle, resolvedDownloadByteSize)) return null;
 	return {
-		changedAssets,
+		changedAssets: resolved.changedAssets,
 		manifestFileHash,
-		manifestUrl: targetManifestResult.fileUrl
+		manifestUrl
 	};
 }
 //#endregion
-exports.parseBundleMetadata = parseBundleMetadata;
 exports.resolveManifestArtifacts = resolveManifestArtifacts;