@hot-updater/plugin-core 0.36.6 → 1.0.0-rc.0

package/dist/createStorageKeyBuilder.cjs

@@ -1,6 +1,13 @@
 //#region src/createStorageKeyBuilder.ts
-const createStorageKeyBuilder = (basePath) => (...args) => {
-	return [basePath || "", ...args].filter(Boolean).join("/");
+const normalizeStorageKeyParts = (values) => {
+	if (values.some((value) => value.includes("\\"))) throw new Error("Storage keys must use '/' as the hierarchy separator.");
+	const segments = values.flatMap((value) => value.split("/").filter(Boolean));
+	if (segments.some((segment) => segment === "." || segment === "..")) throw new Error("Storage key segments must not be '.' or '..'.");
+	return segments;
+};
+const createStorageKeyBuilder = (basePath) => {
+	const baseSegments = normalizeStorageKeyParts([basePath ?? ""]);
+	return (...args) => [...baseSegments, ...normalizeStorageKeyParts(args)].join("/");
 };
 //#endregion
 exports.createStorageKeyBuilder = createStorageKeyBuilder;

package/dist/createStorageKeyBuilder.mjs

@@ -1,6 +1,13 @@
 //#region src/createStorageKeyBuilder.ts
-const createStorageKeyBuilder = (basePath) => (...args) => {
-	return [basePath || "", ...args].filter(Boolean).join("/");
+const normalizeStorageKeyParts = (values) => {
+	if (values.some((value) => value.includes("\\"))) throw new Error("Storage keys must use '/' as the hierarchy separator.");
+	const segments = values.flatMap((value) => value.split("/").filter(Boolean));
+	if (segments.some((segment) => segment === "." || segment === "..")) throw new Error("Storage key segments must not be '.' or '..'.");
+	return segments;
+};
+const createStorageKeyBuilder = (basePath) => {
+	const baseSegments = normalizeStorageKeyParts([basePath ?? ""]);
+	return (...args) => [...baseSegments, ...normalizeStorageKeyParts(args)].join("/");
 };
 //#endregion
 export { createStorageKeyBuilder };

package/dist/createStoragePlugin.cjs

@@ -1,147 +1,8 @@
 //#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) {
-		const nodeProfile = {
-			async delete(storageUri) {
-				return requireNodeProfile().delete(storageUri);
-			},
-			async downloadFile(storageUri, filePath) {
-				return requireNodeProfile().downloadFile(storageUri, filePath);
-			},
-			async exists(storageUri) {
-				return requireNodeProfile().exists(storageUri);
-			},
-			async upload(key, filePath) {
-				return requireNodeProfile().upload(key, filePath);
-			}
-		};
-		Object.defineProperties(nodeProfile, {
-			deleteObjects: {
-				enumerable: true,
-				get: () => {
-					const deleteObjects = requireNodeProfile().deleteObjects;
-					return deleteObjects ? (keys) => deleteObjects(keys) : void 0;
-				}
-			},
-			listObjects: {
-				enumerable: true,
-				get: () => {
-					const listObjects = requireNodeProfile().listObjects;
-					return listObjects ? (prefix) => listObjects(prefix) : void 0;
-				}
-			}
-		});
-		profiles.node = nodeProfile;
-	} 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 that can be used by both Node tooling and update
-* check runtimes.
-*/
-const createUniversalStoragePlugin = (options) => {
-	return (config, hooks) => {
-		return () => createProfiledStoragePlugin({
-			createProfiles: () => options.factory(config),
-			name: options.name,
-			profileShape: {
-				node: true,
-				runtime: true
-			},
-			supportedProtocol: options.supportedProtocol
-		}, hooks);
-	};
-};
+const createStoragePlugin = (options) => ({ ...options });
+function assertStorageOperations(plugin, operations) {
+	for (const operation of operations) if (typeof plugin[operation] !== "function") throw new Error(`Storage plugin "${plugin.name}" does not implement ${operation}.`);
+}
 //#endregion
-exports.createNodeStoragePlugin = createNodeStoragePlugin;
-exports.createRuntimeStoragePlugin = createRuntimeStoragePlugin;
-exports.createUniversalStoragePlugin = createUniversalStoragePlugin;
+exports.assertStorageOperations = assertStorageOperations;
+exports.createStoragePlugin = createStoragePlugin;

package/dist/createStoragePlugin.d.cts

@@ -1,55 +1,10 @@
-import { NodeStoragePlugin, NodeStorageProfile, RuntimeStoragePlugin, RuntimeStorageProfile, StoragePluginHooks, StoragePluginProfiles, UniversalStoragePlugin } from "./types/index.cjs";
+import { StoragePlugin } from "./types/index.cjs";
 
 //#region src/createStoragePlugin.d.ts
-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").
-   */
-  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.
-   */
-  supportedProtocol: string;
-  /**
-   * Function that creates the storage plugin profiles.
-   */
-  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 that can be used by both Node tooling and update
- * check runtimes.
- */
-declare const createUniversalStoragePlugin: <TConfig, TContext = unknown>(options: CreateUniversalStoragePluginOptions<TConfig, TContext>) => (config: TConfig, hooks?: StoragePluginHooks) => () => UniversalStoragePlugin<TContext>;
+type CreateStoragePluginOptions = StoragePlugin;
+type StorageOperation = Exclude<keyof StoragePlugin, "name" | "protocol">;
+type StoragePluginWith<TOperation extends StorageOperation> = StoragePlugin & Required<Pick<StoragePlugin, TOperation>>;
+declare const createStoragePlugin: <const TOptions extends CreateStoragePluginOptions>(options: TOptions) => TOptions;
+declare function assertStorageOperations<const TOperations extends readonly StorageOperation[]>(plugin: StoragePlugin, operations: TOperations): asserts plugin is StoragePluginWith<TOperations[number]>;
 //#endregion
-export { createNodeStoragePlugin, createRuntimeStoragePlugin, createUniversalStoragePlugin };
+export { CreateStoragePluginOptions, StorageOperation, StoragePluginWith, assertStorageOperations, createStoragePlugin };

package/dist/createStoragePlugin.d.mts

@@ -1,55 +1,10 @@
-import { NodeStoragePlugin, NodeStorageProfile, RuntimeStoragePlugin, RuntimeStorageProfile, StoragePluginHooks, StoragePluginProfiles, UniversalStoragePlugin } from "./types/index.mjs";
+import { StoragePlugin } from "./types/index.mjs";
 
 //#region src/createStoragePlugin.d.ts
-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").
-   */
-  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.
-   */
-  supportedProtocol: string;
-  /**
-   * Function that creates the storage plugin profiles.
-   */
-  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 that can be used by both Node tooling and update
- * check runtimes.
- */
-declare const createUniversalStoragePlugin: <TConfig, TContext = unknown>(options: CreateUniversalStoragePluginOptions<TConfig, TContext>) => (config: TConfig, hooks?: StoragePluginHooks) => () => UniversalStoragePlugin<TContext>;
+type CreateStoragePluginOptions = StoragePlugin;
+type StorageOperation = Exclude<keyof StoragePlugin, "name" | "protocol">;
+type StoragePluginWith<TOperation extends StorageOperation> = StoragePlugin & Required<Pick<StoragePlugin, TOperation>>;
+declare const createStoragePlugin: <const TOptions extends CreateStoragePluginOptions>(options: TOptions) => TOptions;
+declare function assertStorageOperations<const TOperations extends readonly StorageOperation[]>(plugin: StoragePlugin, operations: TOperations): asserts plugin is StoragePluginWith<TOperations[number]>;
 //#endregion
-export { createNodeStoragePlugin, createRuntimeStoragePlugin, createUniversalStoragePlugin };
+export { CreateStoragePluginOptions, StorageOperation, StoragePluginWith, assertStorageOperations, createStoragePlugin };

package/dist/createStoragePlugin.mjs

@@ -1,145 +1,7 @@
 //#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) {
-		const nodeProfile = {
-			async delete(storageUri) {
-				return requireNodeProfile().delete(storageUri);
-			},
-			async downloadFile(storageUri, filePath) {
-				return requireNodeProfile().downloadFile(storageUri, filePath);
-			},
-			async exists(storageUri) {
-				return requireNodeProfile().exists(storageUri);
-			},
-			async upload(key, filePath) {
-				return requireNodeProfile().upload(key, filePath);
-			}
-		};
-		Object.defineProperties(nodeProfile, {
-			deleteObjects: {
-				enumerable: true,
-				get: () => {
-					const deleteObjects = requireNodeProfile().deleteObjects;
-					return deleteObjects ? (keys) => deleteObjects(keys) : void 0;
-				}
-			},
-			listObjects: {
-				enumerable: true,
-				get: () => {
-					const listObjects = requireNodeProfile().listObjects;
-					return listObjects ? (prefix) => listObjects(prefix) : void 0;
-				}
-			}
-		});
-		profiles.node = nodeProfile;
-	} 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 that can be used by both Node tooling and update
-* check runtimes.
-*/
-const createUniversalStoragePlugin = (options) => {
-	return (config, hooks) => {
-		return () => createProfiledStoragePlugin({
-			createProfiles: () => options.factory(config),
-			name: options.name,
-			profileShape: {
-				node: true,
-				runtime: true
-			},
-			supportedProtocol: options.supportedProtocol
-		}, hooks);
-	};
-};
+const createStoragePlugin = (options) => ({ ...options });
+function assertStorageOperations(plugin, operations) {
+	for (const operation of operations) if (typeof plugin[operation] !== "function") throw new Error(`Storage plugin "${plugin.name}" does not implement ${operation}.`);
+}
 //#endregion
-export { createNodeStoragePlugin, createRuntimeStoragePlugin, createUniversalStoragePlugin };
+export { assertStorageOperations, createStoragePlugin };

package/dist/databaseClient.cjs

@@ -0,0 +1,112 @@
+const require_createDatabasePlugin = require("./createDatabasePlugin.cjs");
+const require_databaseRows = require("./databaseRows.cjs");
+const require_databaseClientReads = require("./databaseClientReads.cjs");
+const require_databaseClientUpdates = require("./databaseClientUpdates.cjs");
+//#region src/databaseClient.ts
+var DatabaseBundleNotFoundError = class extends Error {
+	name = "DatabaseBundleNotFoundError";
+	constructor(bundleId) {
+		super(`Bundle "${bundleId}" was not found.`);
+		this.bundleId = bundleId;
+	}
+};
+var DatabasePatchInsertUnsupportedError = class extends Error {
+	name = "DatabasePatchInsertUnsupportedError";
+	constructor(bundleId, pluginName) {
+		super(`Database plugin "${pluginName}" cannot atomically insert patches for bundle "${bundleId}".`);
+		this.bundleId = bundleId;
+		this.pluginName = pluginName;
+	}
+};
+const insertChanges = (bundle) => [{
+	model: "bundles",
+	operation: "insert",
+	row: require_databaseRows.bundleToRow(bundle)
+}, ...require_databaseRows.bundleToPatchRows(bundle).map((row) => ({
+	model: "bundlePatches",
+	operation: "insert",
+	row
+}))];
+const updateChanges = (bundleId, update) => {
+	const rowUpdate = require_databaseClientUpdates.bundleUpdateToRow(update);
+	return [{
+		model: "bundles",
+		operation: "update",
+		where: { id: bundleId },
+		update: rowUpdate
+	}, ...Object.hasOwn(update, "patches") ? [{
+		model: "bundlePatches",
+		operation: "delete",
+		where: { bundleId }
+	}, ...require_databaseClientUpdates.bundleUpdateToPatchRows(bundleId, update).map((row) => ({
+		model: "bundlePatches",
+		operation: "insert",
+		row
+	}))] : []];
+};
+const deleteChanges = (bundleId) => [{
+	model: "bundles",
+	operation: "delete",
+	where: { id: bundleId }
+}];
+const createDatabaseClient = (plugin) => {
+	const getBundleById = async (id) => {
+		const row = await plugin.models.bundles.findById(id);
+		if (!row) return null;
+		return (await require_databaseClientReads.hydrateRows(plugin, [row]))[0] ?? null;
+	};
+	const insertChannel = (input) => plugin.models.channels.insert(input);
+	const createMutationClient = (commit) => ({
+		getBundleById,
+		getBundles: (options) => require_databaseClientReads.responsePage(plugin, options),
+		async getChannels() {
+			return (await plugin.models.channels.list({})).channels;
+		},
+		insertChannel,
+		async insertBundle(bundle) {
+			try {
+				await commit(insertChanges(bundle));
+			} catch (error) {
+				if (error instanceof require_createDatabasePlugin.DatabaseAtomicCommitUnsupportedError && require_databaseRows.bundleToPatchRows(bundle).length > 0) throw new DatabasePatchInsertUnsupportedError(bundle.id, plugin.name);
+				throw error;
+			}
+		},
+		async updateBundleById(bundleId, update) {
+			try {
+				if (!(await commit(updateChanges(bundleId, update))).committed) throw new DatabaseBundleNotFoundError(bundleId);
+			} catch (error) {
+				if (error instanceof require_createDatabasePlugin.DatabaseAtomicCommitUnsupportedError && Object.hasOwn(update, "patches")) throw new require_databaseClientUpdates.DatabasePatchUpdateUnsupportedError(bundleId, plugin.name);
+				throw error;
+			}
+		},
+		async deleteBundleById(bundleId) {
+			const result = await commit(deleteChanges(bundleId));
+			if (!result.committed && result.conflict.reason === "referenced") throw new require_createDatabasePlugin.DatabaseRowReferencedError();
+		}
+	});
+	const runMutation = async (operation) => {
+		const changes = [];
+		const result = await operation(createMutationClient(async (input) => {
+			changes.push(...input);
+			return { committed: true };
+		}));
+		if (changes.length === 0) return result;
+		const commitResult = await plugin.commit({ changes });
+		if (!commitResult.committed) {
+			const change = changes[commitResult.conflict.changeIndex];
+			if (commitResult.conflict.reason === "referenced" && change?.model === "bundles" && change.operation === "delete") throw new require_createDatabasePlugin.DatabaseRowReferencedError();
+			if (change?.model === "bundles" && change.operation === "update") throw new DatabaseBundleNotFoundError(change.where.id);
+			throw new Error(`Database plugin "${plugin.name}" rejected a commit.`);
+		}
+		return result;
+	};
+	return {
+		...createMutationClient((changes) => plugin.commit({ changes })),
+		deleteChannel: (input) => plugin.models.channels.delete(input),
+		mutate: runMutation
+	};
+};
+//#endregion
+exports.DatabaseBundleNotFoundError = DatabaseBundleNotFoundError;
+exports.DatabasePatchInsertUnsupportedError = DatabasePatchInsertUnsupportedError;
+exports.createDatabaseClient = createDatabaseClient;

package/dist/databaseClient.d.cts

@@ -0,0 +1,33 @@
+import { ChannelRow } from "./types/databaseRows.cjs";
+import { BundleRepository, ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult } from "./types/databasePlugin.cjs";
+import { DatabaseBundleQueryOptions, PaginatedResult } from "./types/index.cjs";
+import { DatabasePatchUpdateUnsupportedError } from "./databaseClientUpdates.cjs";
+import { Bundle } from "@hot-updater/core";
+
+//#region src/databaseClient.d.ts
+interface DatabaseClient {
+  getBundleById(id: string): Promise<Bundle | null>;
+  getChannels(): Promise<readonly ChannelRow[]>;
+  insertChannel(input: ChannelInsertInput): Promise<ChannelInsertResult>;
+  deleteChannel(input: ChannelDeleteInput): Promise<ChannelDeleteResult>;
+  getBundles(options: DatabaseBundleQueryOptions): Promise<PaginatedResult>;
+  insertBundle(bundle: Bundle): Promise<void>;
+  updateBundleById(bundleId: string, update: Partial<Bundle>): Promise<void>;
+  deleteBundleById(bundleId: string): Promise<void>;
+  mutate<TResult>(operation: (client: DatabaseMutationClient) => Promise<TResult>): Promise<TResult>;
+}
+type DatabaseMutationClient = Omit<DatabaseClient, "deleteChannel" | "mutate">;
+declare class DatabaseBundleNotFoundError extends Error {
+  readonly bundleId: string;
+  readonly name = "DatabaseBundleNotFoundError";
+  constructor(bundleId: string);
+}
+declare class DatabasePatchInsertUnsupportedError extends Error {
+  readonly bundleId: string;
+  readonly pluginName: string;
+  readonly name = "DatabasePatchInsertUnsupportedError";
+  constructor(bundleId: string, pluginName: string);
+}
+declare const createDatabaseClient: (plugin: BundleRepository) => DatabaseClient;
+//#endregion
+export { DatabaseBundleNotFoundError, DatabaseClient, DatabaseMutationClient, DatabasePatchInsertUnsupportedError, createDatabaseClient };

package/dist/databaseClient.d.mts

@@ -0,0 +1,33 @@
+import { ChannelRow } from "./types/databaseRows.mjs";
+import { BundleRepository, ChannelDeleteInput, ChannelDeleteResult, ChannelInsertInput, ChannelInsertResult } from "./types/databasePlugin.mjs";
+import { DatabaseBundleQueryOptions, PaginatedResult } from "./types/index.mjs";
+import { DatabasePatchUpdateUnsupportedError } from "./databaseClientUpdates.mjs";
+import { Bundle } from "@hot-updater/core";
+
+//#region src/databaseClient.d.ts
+interface DatabaseClient {
+  getBundleById(id: string): Promise<Bundle | null>;
+  getChannels(): Promise<readonly ChannelRow[]>;
+  insertChannel(input: ChannelInsertInput): Promise<ChannelInsertResult>;
+  deleteChannel(input: ChannelDeleteInput): Promise<ChannelDeleteResult>;
+  getBundles(options: DatabaseBundleQueryOptions): Promise<PaginatedResult>;
+  insertBundle(bundle: Bundle): Promise<void>;
+  updateBundleById(bundleId: string, update: Partial<Bundle>): Promise<void>;
+  deleteBundleById(bundleId: string): Promise<void>;
+  mutate<TResult>(operation: (client: DatabaseMutationClient) => Promise<TResult>): Promise<TResult>;
+}
+type DatabaseMutationClient = Omit<DatabaseClient, "deleteChannel" | "mutate">;
+declare class DatabaseBundleNotFoundError extends Error {
+  readonly bundleId: string;
+  readonly name = "DatabaseBundleNotFoundError";
+  constructor(bundleId: string);
+}
+declare class DatabasePatchInsertUnsupportedError extends Error {
+  readonly bundleId: string;
+  readonly pluginName: string;
+  readonly name = "DatabasePatchInsertUnsupportedError";
+  constructor(bundleId: string, pluginName: string);
+}
+declare const createDatabaseClient: (plugin: BundleRepository) => DatabaseClient;
+//#endregion
+export { DatabaseBundleNotFoundError, DatabaseClient, DatabaseMutationClient, DatabasePatchInsertUnsupportedError, createDatabaseClient };