@hot-updater/server 1.0.0-rc.18 → 1.0.0-rc.21

package/dist/database/busy.mjs

@@ -1,36 +0,0 @@
-import { DatabaseConflictError } from "./errors.mjs";
-//#region src/database/busy.ts
-/** Error names the AWS SDKs give a throttled request, as their retry strategy classifies them. */
-const THROTTLING_NAMES = /* @__PURE__ */ new Set([
-	"ProvisionedThroughputExceededException",
-	"RequestLimitExceeded",
-	"RequestThrottled",
-	"RequestThrottledException",
-	"SlowDown",
-	"ThrottledException",
-	"Throttling",
-	"ThrottlingException",
-	"TooManyRequestsException"
-]);
-/** gRPC's RESOURCE_EXHAUSTED, the status Firestore throttles a request with. */
-const RESOURCE_EXHAUSTED = 8;
-/**
-* Whether the database is busy rather than broken, so the same request can
-* succeed later: a transaction ran out of retries, or the backend throttled
-* a request. Writes already retry transient failures, throttled ones
-* included, until the budget runs out. A throttled read throws the backend's
-* own error, so it is recognized by what the backends call it: a name the
-* AWS SDKs retry as throttling, HTTP 429, or gRPC's RESOURCE_EXHAUSTED.
-*/
-const isDatabaseBusyError = (error) => {
-	if (error instanceof DatabaseConflictError) return true;
-	if (typeof error !== "object" || error === null) return false;
-	const { name, code, message, status, statusCode, $metadata } = error;
-	return typeof name === "string" && THROTTLING_NAMES.has(name) || [
-		status,
-		statusCode,
-		$metadata?.httpStatusCode
-	].includes(429) || code === RESOURCE_EXHAUSTED && typeof message === "string" && message.includes("RESOURCE_EXHAUSTED");
-};
-//#endregion
-export { isDatabaseBusyError };

package/dist/database/cursor.cjs

@@ -1,44 +0,0 @@
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
-//#region src/database/cursor.ts
-var DatabaseCursorError = class extends Error {
-	name = "DatabaseCursorError";
-};
-const encoder = new TextEncoder();
-const decoder = new TextDecoder();
-const toBase64Url = (text) => {
-	let binary = "";
-	for (const byte of encoder.encode(text)) binary += String.fromCharCode(byte);
-	return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/u, "");
-};
-const fromBase64Url = (value) => {
-	const binary = atob(value.replaceAll("-", "+").replaceAll("_", "/"));
-	return decoder.decode(Uint8Array.from(binary, (char) => char.charCodeAt(0)));
-};
-/** A stable 32-bit FNV-1a hash of the text's UTF-8 bytes. */
-const fnv1a = (text) => {
-	let hash = 2166136261;
-	for (const byte of encoder.encode(text)) hash = Math.imul(hash ^ byte, 16777619) >>> 0;
-	return hash;
-};
-/** A hash of the request's identity; a cursor only resumes the same read. */
-const cursorScope = (parts) => fnv1a(JSON.stringify(parts)).toString(36);
-const encodeCursor = (scope, after) => toBase64Url(JSON.stringify([scope, after]));
-/** The order tuple a cursor resumes after; rejects a cursor from another read. */
-const decodeCursor = (scope, cursor) => {
-	let decoded;
-	try {
-		decoded = JSON.parse(fromBase64Url(cursor));
-	} catch {
-		decoded = void 0;
-	}
-	const [from, after] = Array.isArray(decoded) ? decoded : [];
-	if (typeof from !== "string" || !Array.isArray(after) || !after.every(_hot_updater_plugin_core_internal.isKeyValue)) throw new DatabaseCursorError("The cursor is malformed.");
-	if (from !== scope) throw new DatabaseCursorError("The cursor belongs to a read with another model, index, filter, order, or range.");
-	return after;
-};
-//#endregion
-exports.DatabaseCursorError = DatabaseCursorError;
-exports.cursorScope = cursorScope;
-exports.decodeCursor = decodeCursor;
-exports.encodeCursor = encodeCursor;
-exports.fnv1a = fnv1a;

package/dist/database/cursor.d.cts

@@ -1,7 +0,0 @@
-import "@hot-updater/plugin-core/internal";
-//#region src/database/cursor.d.ts
-declare class DatabaseCursorError extends Error {
-  readonly name = "DatabaseCursorError";
-}
-//#endregion
-export { DatabaseCursorError };

package/dist/database/cursor.d.mts

@@ -1,7 +0,0 @@
-import "@hot-updater/plugin-core/internal";
-//#region src/database/cursor.d.ts
-declare class DatabaseCursorError extends Error {
-  readonly name = "DatabaseCursorError";
-}
-//#endregion
-export { DatabaseCursorError };

package/dist/database/cursor.mjs

@@ -1,40 +0,0 @@
-import { isKeyValue } from "@hot-updater/plugin-core/internal";
-//#region src/database/cursor.ts
-var DatabaseCursorError = class extends Error {
-	name = "DatabaseCursorError";
-};
-const encoder = new TextEncoder();
-const decoder = new TextDecoder();
-const toBase64Url = (text) => {
-	let binary = "";
-	for (const byte of encoder.encode(text)) binary += String.fromCharCode(byte);
-	return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/u, "");
-};
-const fromBase64Url = (value) => {
-	const binary = atob(value.replaceAll("-", "+").replaceAll("_", "/"));
-	return decoder.decode(Uint8Array.from(binary, (char) => char.charCodeAt(0)));
-};
-/** A stable 32-bit FNV-1a hash of the text's UTF-8 bytes. */
-const fnv1a = (text) => {
-	let hash = 2166136261;
-	for (const byte of encoder.encode(text)) hash = Math.imul(hash ^ byte, 16777619) >>> 0;
-	return hash;
-};
-/** A hash of the request's identity; a cursor only resumes the same read. */
-const cursorScope = (parts) => fnv1a(JSON.stringify(parts)).toString(36);
-const encodeCursor = (scope, after) => toBase64Url(JSON.stringify([scope, after]));
-/** The order tuple a cursor resumes after; rejects a cursor from another read. */
-const decodeCursor = (scope, cursor) => {
-	let decoded;
-	try {
-		decoded = JSON.parse(fromBase64Url(cursor));
-	} catch {
-		decoded = void 0;
-	}
-	const [from, after] = Array.isArray(decoded) ? decoded : [];
-	if (typeof from !== "string" || !Array.isArray(after) || !after.every(isKeyValue)) throw new DatabaseCursorError("The cursor is malformed.");
-	if (from !== scope) throw new DatabaseCursorError("The cursor belongs to a read with another model, index, filter, order, or range.");
-	return after;
-};
-//#endregion
-export { DatabaseCursorError, cursorScope, decodeCursor, encodeCursor, fnv1a };

package/dist/database/database.cjs

@@ -1,63 +0,0 @@
-const require_aggregateBatching = require("./aggregateBatching.cjs");
-const require_engineTransaction = require("./engineTransaction.cjs");
-const require_engine = require("./engine.cjs");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
-//#region src/database/database.ts
-/** The engine plus `database(module)`, which hands a module its typed handle. */
-const createDatabaseEngine = ({ batching, now = Date.now, ...options }) => {
-	const engine = require_engine.createEngine(options);
-	const { reads } = engine;
-	const batches = batching && require_aggregateBatching.createAggregateBatches({
-		engine,
-		adapter: options.adapter,
-		schema: options.schema,
-		batching,
-		now
-	});
-	const transaction = batches?.transaction ?? engine.transaction;
-	const outside = (read) => (...args) => {
-		require_engineTransaction.assertOutsideTransaction();
-		return read(...args);
-	};
-	/** No read outside a transaction returns `_v`, which a key-value index copy lacks. */
-	const bare = (row) => row && Object.fromEntries(Object.entries(row).filter(([column]) => column !== _hot_updater_plugin_core_internal.DATABASE_VERSION_COLUMN));
-	const barePage = async (page) => {
-		const { rows, next } = await page;
-		return {
-			rows: rows.map(bare),
-			...next === void 0 ? {} : { next }
-		};
-	};
-	return {
-		...engine,
-		/** Applies batched aggregate changes still pending: this process's buffer and the log. */
-		flush: async () => {
-			await batches?.flush();
-		},
-		dispose: async () => {
-			await batches?.dispose();
-		},
-		database(module) {
-			const name = (model) => module.namespace ? `${module.namespace}_${model}` : model;
-			return {
-				findOne: outside(async (model, lookup) => bare(await reads.findOne(name(model), lookup))),
-				findByKeys: outside(async (model, keys) => (await reads.findByKeys(name(model), keys)).map(bare)),
-				findMany: outside((model, input) => barePage(reads.findMany(name(model), input))),
-				findAggregates: outside(async (model, input) => {
-					await batches?.beforeRead(name(model));
-					return await barePage(reads.findAggregates(name(model), input));
-				}),
-				transaction: (fn) => transaction((tx) => fn({
-					findOne: (model, lookup) => tx.findOne(name(model), lookup),
-					findMany: (model, input) => tx.findMany(name(model), input),
-					create: (model, row) => tx.create(name(model), row),
-					update: (model, row, set) => tx.update(name(model), row, set),
-					delete: (model, row) => tx.delete(name(model), row),
-					aggregate: (model, identity, changes, options) => tx.aggregate(name(model), identity, changes, options)
-				}))
-			};
-		}
-	};
-};
-//#endregion
-exports.createDatabaseEngine = createDatabaseEngine;

package/dist/database/database.d.cts

@@ -1,136 +0,0 @@
-import { FieldType } from "./definitions.cjs";
-import { ResolvedModel, SchemaModule } from "./resolveSchema.cjs";
-import { AggregateDefinition, FieldValue, ModuleSchema, RowOf, TableDefinition } from "./schema.cjs";
-import { EngineReadCount, Page, ReadInput } from "./engineReads.cjs";
-import { TransactionEngine } from "./engineTransaction.cjs";
-import { DatabaseEngineOptions, ReadMeasurement } from "./engine.cjs";
-import { AggregateBatching } from "@hot-updater/plugin-core";
-import { DatabaseKeyValue, StoredRow } from "@hot-updater/plugin-core/internal";
-//#region src/database/database.d.ts
-type TableNames<S extends ModuleSchema> = { [K in keyof S]: S[K] extends TableDefinition ? K : never; }[keyof S] & string;
-type AggregateNames<S extends ModuleSchema> = { [K in keyof S]: S[K] extends AggregateDefinition ? K : never; }[keyof S] & string;
-/** Reference counters: how many rows of another table point at this one. */
-type RefColumns = {
-  readonly [K: `_refs_${string}`]: number;
-};
-/** Engine columns every stored row carries. */
-type EngineColumns = {
-  readonly _v: number;
-} & RefColumns;
-type DerivedValues<TDerived> = { -readonly [K in keyof TDerived]: TDerived[K] extends FieldType ? FieldValue<TDerived[K]> | readonly FieldValue<TDerived[K]>[] | null : never; };
-type Values<TModel> = TModel extends TableDefinition<infer TFields, infer TDerived> ? RowOf<TFields> & DerivedValues<TDerived> : TModel extends AggregateDefinition<infer TFields, infer TMetric, infer _TIndexes, infer TSketch> ? RowOf<TFields> & { -readonly [K in TMetric]: number; } & { -readonly [K in TSketch]: string; } : never;
-/** A row read in a transaction, `_v` included, so the transaction can write it back. */
-type TableRow<TModel> = Values<TModel> & EngineColumns;
-/** A row read outside a transaction, without `_v`, which only a transaction's guard uses. */
-type ReadRow<TModel> = Values<TModel> & RefColumns;
-type AggregateRow<TModel> = Values<TModel>;
-type IndexesOf<TModel> = TModel extends {
-  readonly indexes: infer I;
-} ? I : never;
-type IndexName<TModel> = keyof IndexesOf<TModel> & string;
-type IndexFields<TModel, TIndex, TPart extends "eq" | "sort"> = IndexesOf<TModel>[TIndex & keyof IndexesOf<TModel>] extends { readonly [P in TPart]: readonly (infer F)[]; } ? F & keyof Values<TModel> : never;
-type KeyValueOf<TModel, TField extends keyof Values<TModel>> = Exclude<Values<TModel>[TField], null | readonly unknown[]>;
-type FirstOrderField<TModel, TIndex> = IndexesOf<TModel>[TIndex & keyof IndexesOf<TModel>] extends {
-  readonly sort: readonly [infer F, ...unknown[]];
-} ? F & keyof Values<TModel> : TModel extends {
-  readonly key: readonly (infer K)[];
-} ? K & keyof Values<TModel> : never;
-interface ReadOptions<TModel, TIndex> {
-  readonly index: TIndex;
-  /** Every eq field of the index; null never matches. */
-  readonly where: { readonly [F in IndexFields<TModel, TIndex, "eq">]: KeyValueOf<TModel, F>; };
-  /** Bounds on the first order field, or on a prefix of the order tuple (sort fields, then the key). */
-  readonly range?: { readonly [B in "gt" | "gte" | "lt" | "lte"]?: KeyValueOf<TModel, FirstOrderField<TModel, TIndex>> | readonly [KeyValueOf<TModel, FirstOrderField<TModel, TIndex>>, ...DatabaseKeyValue[]]; };
-  readonly order?: "asc" | "desc";
-  readonly limit: number;
-  readonly cursor?: string;
-}
-type UniqueLookups<TModel> = TModel extends TableDefinition<infer TFields, infer _D, infer TIndexes> ? { [F in keyof TFields]: TFields[F] extends {
-  readonly unique: true;
-} ? { readonly [P in F]: KeyValueOf<TModel, P & keyof Values<TModel>>; } : never; }[keyof TFields] | { [I in keyof TIndexes]: TIndexes[I] extends {
-  readonly unique: true;
-  readonly eq: readonly (infer E)[];
-} ? { readonly [P in E & string]: KeyValueOf<TModel, P & keyof Values<TModel>>; } : never; }[keyof TIndexes] : never;
-/** A table's key values. */
-type KeyLookup<TModel> = TModel extends TableDefinition<infer _F> ? { readonly [K in TModel["key"][number]]: KeyValueOf<TModel, K & keyof Values<TModel>>; } : never;
-/** The key, or the eq fields of a unique index. */
-type Lookup<TModel> = KeyLookup<TModel> | UniqueLookups<TModel>;
-type RootedIndexName<TModel> = { [I in keyof IndexesOf<TModel>]: IndexesOf<TModel>[I] extends {
-  readonly root: object;
-} ? I : never; }[keyof IndexesOf<TModel>] & string;
-type OptionalFields<TFields> = { [K in keyof TFields]: TFields[K] extends {
-  readonly required: false;
-} ? K : never; }[keyof TFields];
-/** Declared fields, optional ones omittable; derived fields and engine columns are computed. */
-type CreateRow<TModel> = TModel extends TableDefinition<infer TFields> ? Omit<RowOf<TFields>, OptionalFields<TFields>> & Partial<Pick<RowOf<TFields>, OptionalFields<TFields>>> : never;
-/** Changed non-key fields. */
-type UpdateSet<TModel> = TModel extends TableDefinition<infer TFields, infer _D, infer _I, infer TKey> ? Partial<Omit<RowOf<TFields>, TKey[number]>> : never;
-type AggregateIdentity<TModel> = TModel extends AggregateDefinition<infer TFields> ? RowOf<TFields> : never;
-/** Counter and gauge deltas, and sketches to merge. */
-type AggregateChanges<TModel> = TModel extends AggregateDefinition<infer _F, infer TMetric, infer _I, infer TSketch> ? { readonly [K in TMetric]?: number; } & { readonly [K in TSketch]?: string; } : never;
-/** Reads are recorded and guarded at commit; writes apply only if every guard holds. */
-interface HotUpdaterTransaction<S extends ModuleSchema> {
-  findOne<M extends TableNames<S>>(model: M, lookup: Lookup<S[M]>): Promise<TableRow<S[M]> | null>;
-  /** Rooted indexes only: the parent row guards the whole range. */
-  findMany<M extends TableNames<S>, I extends RootedIndexName<S[M]>>(model: M, options: ReadOptions<S[M], I>): Promise<Page<TableRow<S[M]>>>;
-  create<M extends TableNames<S>>(model: M, row: CreateRow<S[M]>): void;
-  /** Patches a row this transaction read, by key or through a rooted range. */
-  update<M extends TableNames<S>>(model: M, row: TableRow<S[M]>, set: UpdateSet<S[M]>): void;
-  /** Deletes a row this transaction read, cascading to its children first. */
-  delete<M extends TableNames<S>>(model: M, row: TableRow<S[M]>): Promise<void>;
-  /**
-   * Changes one shard row of an aggregate. Gauges of a sharded aggregate need
-   * `shardBy`, so every change keyed by one value lands on one shard.
-   */
-  aggregate<M extends AggregateNames<S>>(model: M, identity: AggregateIdentity<S[M]>, changes: AggregateChanges<S[M]>, options?: {
-    readonly shardBy?: string;
-  }): void;
-}
-/** A table name, or the reason an aggregate cannot be read this way. */
-type FindManyModel<S extends ModuleSchema, M> = M extends TableNames<S> ? M : "findMany reads tables; read aggregates with findAggregates";
-/** An aggregate name, or the reason a table cannot be read this way. */
-type FindAggregatesModel<S extends ModuleSchema, M> = M extends AggregateNames<S> ? M : "findAggregates reads aggregates; read tables with findMany";
-/** A module's database handle. There is no count, offset, or free-form filter. */
-interface HotUpdaterDatabase<S extends ModuleSchema> {
-  findOne<M extends TableNames<S>>(model: M, lookup: Lookup<S[M]>): Promise<ReadRow<S[M]> | null>;
-  /** Rows by key in one batch read, in the keys' order. */
-  findByKeys<M extends TableNames<S>>(model: M, keys: readonly KeyLookup<S[M]>[]): Promise<(ReadRow<S[M]> | null)[]>;
-  findMany<M extends keyof S & string, I extends IndexName<S[M]>>(model: FindManyModel<S, M>, options: ReadOptions<S[M], I>): Promise<Page<ReadRow<S[M]>>>;
-  findAggregates<M extends keyof S & string, I extends IndexName<S[M]>>(model: FindAggregatesModel<S, M>, options: ReadOptions<S[M], I>): Promise<Page<AggregateRow<S[M]>>>;
-  /** Reruns `fn` when a guarded read changed, within a jittered retry budget. */
-  transaction<R>(fn: (tx: HotUpdaterTransaction<S>) => Promise<R>): Promise<R>;
-}
-/** The engine plus `database(module)`, which hands a module its typed handle. */
-declare const createDatabaseEngine: ({ batching, now, ...options }: DatabaseEngineOptions & {
-  /**
-   * Batches changes to aggregates declared `batched`; the schema must
-   * include `aggregateBatchingModule`.
-   */
-  readonly batching?: AggregateBatching;
-  /** The clock batching times its flushes and compactions by. */
-  readonly now?: () => number;
-}) => {
-  /** Applies batched aggregate changes still pending: this process's buffer and the log. */
-  flush: () => Promise<void>;
-  dispose: () => Promise<void>;
-  database<S extends ModuleSchema>(module: SchemaModule & {
-    readonly schema: S;
-  }): HotUpdaterDatabase<S>;
-  reads: {
-    maxPageSize: number;
-    modelOf: (name: string, kind?: "table" | "aggregate") => ResolvedModel;
-    reads: {
-      total: () => EngineReadCount;
-      reset: () => void;
-    };
-    findByKeys: (name: string, lookups: readonly Readonly<Record<string, DatabaseKeyValue>>[]) => Promise<(StoredRow | null)[]>;
-    findOne(name: string, lookup: Readonly<Record<string, DatabaseKeyValue>>): Promise<StoredRow | null>;
-    findMany(name: string, input: ReadInput): Promise<Page<StoredRow>>;
-    findAggregates(name: string, input: ReadInput): Promise<Page<StoredRow>>;
-  };
-  transaction: <R>(fn: (tx: TransactionEngine) => Promise<R>) => Promise<R>;
-  measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>>;
-};
-type DatabaseEngine = ReturnType<typeof createDatabaseEngine>;
-//#endregion
-export { AggregateChanges, AggregateIdentity, AggregateRow, CreateRow, DatabaseEngine, EngineColumns, FindAggregatesModel, FindManyModel, HotUpdaterDatabase, HotUpdaterTransaction, KeyLookup, Lookup, ReadOptions, ReadRow, TableRow, UpdateSet, createDatabaseEngine };

package/dist/database/database.d.mts

@@ -1,136 +0,0 @@
-import { FieldType } from "./definitions.mjs";
-import { ResolvedModel, SchemaModule } from "./resolveSchema.mjs";
-import { AggregateDefinition, FieldValue, ModuleSchema, RowOf, TableDefinition } from "./schema.mjs";
-import { EngineReadCount, Page, ReadInput } from "./engineReads.mjs";
-import { TransactionEngine } from "./engineTransaction.mjs";
-import { DatabaseEngineOptions, ReadMeasurement } from "./engine.mjs";
-import { AggregateBatching } from "@hot-updater/plugin-core";
-import { DatabaseKeyValue, StoredRow } from "@hot-updater/plugin-core/internal";
-//#region src/database/database.d.ts
-type TableNames<S extends ModuleSchema> = { [K in keyof S]: S[K] extends TableDefinition ? K : never; }[keyof S] & string;
-type AggregateNames<S extends ModuleSchema> = { [K in keyof S]: S[K] extends AggregateDefinition ? K : never; }[keyof S] & string;
-/** Reference counters: how many rows of another table point at this one. */
-type RefColumns = {
-  readonly [K: `_refs_${string}`]: number;
-};
-/** Engine columns every stored row carries. */
-type EngineColumns = {
-  readonly _v: number;
-} & RefColumns;
-type DerivedValues<TDerived> = { -readonly [K in keyof TDerived]: TDerived[K] extends FieldType ? FieldValue<TDerived[K]> | readonly FieldValue<TDerived[K]>[] | null : never; };
-type Values<TModel> = TModel extends TableDefinition<infer TFields, infer TDerived> ? RowOf<TFields> & DerivedValues<TDerived> : TModel extends AggregateDefinition<infer TFields, infer TMetric, infer _TIndexes, infer TSketch> ? RowOf<TFields> & { -readonly [K in TMetric]: number; } & { -readonly [K in TSketch]: string; } : never;
-/** A row read in a transaction, `_v` included, so the transaction can write it back. */
-type TableRow<TModel> = Values<TModel> & EngineColumns;
-/** A row read outside a transaction, without `_v`, which only a transaction's guard uses. */
-type ReadRow<TModel> = Values<TModel> & RefColumns;
-type AggregateRow<TModel> = Values<TModel>;
-type IndexesOf<TModel> = TModel extends {
-  readonly indexes: infer I;
-} ? I : never;
-type IndexName<TModel> = keyof IndexesOf<TModel> & string;
-type IndexFields<TModel, TIndex, TPart extends "eq" | "sort"> = IndexesOf<TModel>[TIndex & keyof IndexesOf<TModel>] extends { readonly [P in TPart]: readonly (infer F)[]; } ? F & keyof Values<TModel> : never;
-type KeyValueOf<TModel, TField extends keyof Values<TModel>> = Exclude<Values<TModel>[TField], null | readonly unknown[]>;
-type FirstOrderField<TModel, TIndex> = IndexesOf<TModel>[TIndex & keyof IndexesOf<TModel>] extends {
-  readonly sort: readonly [infer F, ...unknown[]];
-} ? F & keyof Values<TModel> : TModel extends {
-  readonly key: readonly (infer K)[];
-} ? K & keyof Values<TModel> : never;
-interface ReadOptions<TModel, TIndex> {
-  readonly index: TIndex;
-  /** Every eq field of the index; null never matches. */
-  readonly where: { readonly [F in IndexFields<TModel, TIndex, "eq">]: KeyValueOf<TModel, F>; };
-  /** Bounds on the first order field, or on a prefix of the order tuple (sort fields, then the key). */
-  readonly range?: { readonly [B in "gt" | "gte" | "lt" | "lte"]?: KeyValueOf<TModel, FirstOrderField<TModel, TIndex>> | readonly [KeyValueOf<TModel, FirstOrderField<TModel, TIndex>>, ...DatabaseKeyValue[]]; };
-  readonly order?: "asc" | "desc";
-  readonly limit: number;
-  readonly cursor?: string;
-}
-type UniqueLookups<TModel> = TModel extends TableDefinition<infer TFields, infer _D, infer TIndexes> ? { [F in keyof TFields]: TFields[F] extends {
-  readonly unique: true;
-} ? { readonly [P in F]: KeyValueOf<TModel, P & keyof Values<TModel>>; } : never; }[keyof TFields] | { [I in keyof TIndexes]: TIndexes[I] extends {
-  readonly unique: true;
-  readonly eq: readonly (infer E)[];
-} ? { readonly [P in E & string]: KeyValueOf<TModel, P & keyof Values<TModel>>; } : never; }[keyof TIndexes] : never;
-/** A table's key values. */
-type KeyLookup<TModel> = TModel extends TableDefinition<infer _F> ? { readonly [K in TModel["key"][number]]: KeyValueOf<TModel, K & keyof Values<TModel>>; } : never;
-/** The key, or the eq fields of a unique index. */
-type Lookup<TModel> = KeyLookup<TModel> | UniqueLookups<TModel>;
-type RootedIndexName<TModel> = { [I in keyof IndexesOf<TModel>]: IndexesOf<TModel>[I] extends {
-  readonly root: object;
-} ? I : never; }[keyof IndexesOf<TModel>] & string;
-type OptionalFields<TFields> = { [K in keyof TFields]: TFields[K] extends {
-  readonly required: false;
-} ? K : never; }[keyof TFields];
-/** Declared fields, optional ones omittable; derived fields and engine columns are computed. */
-type CreateRow<TModel> = TModel extends TableDefinition<infer TFields> ? Omit<RowOf<TFields>, OptionalFields<TFields>> & Partial<Pick<RowOf<TFields>, OptionalFields<TFields>>> : never;
-/** Changed non-key fields. */
-type UpdateSet<TModel> = TModel extends TableDefinition<infer TFields, infer _D, infer _I, infer TKey> ? Partial<Omit<RowOf<TFields>, TKey[number]>> : never;
-type AggregateIdentity<TModel> = TModel extends AggregateDefinition<infer TFields> ? RowOf<TFields> : never;
-/** Counter and gauge deltas, and sketches to merge. */
-type AggregateChanges<TModel> = TModel extends AggregateDefinition<infer _F, infer TMetric, infer _I, infer TSketch> ? { readonly [K in TMetric]?: number; } & { readonly [K in TSketch]?: string; } : never;
-/** Reads are recorded and guarded at commit; writes apply only if every guard holds. */
-interface HotUpdaterTransaction<S extends ModuleSchema> {
-  findOne<M extends TableNames<S>>(model: M, lookup: Lookup<S[M]>): Promise<TableRow<S[M]> | null>;
-  /** Rooted indexes only: the parent row guards the whole range. */
-  findMany<M extends TableNames<S>, I extends RootedIndexName<S[M]>>(model: M, options: ReadOptions<S[M], I>): Promise<Page<TableRow<S[M]>>>;
-  create<M extends TableNames<S>>(model: M, row: CreateRow<S[M]>): void;
-  /** Patches a row this transaction read, by key or through a rooted range. */
-  update<M extends TableNames<S>>(model: M, row: TableRow<S[M]>, set: UpdateSet<S[M]>): void;
-  /** Deletes a row this transaction read, cascading to its children first. */
-  delete<M extends TableNames<S>>(model: M, row: TableRow<S[M]>): Promise<void>;
-  /**
-   * Changes one shard row of an aggregate. Gauges of a sharded aggregate need
-   * `shardBy`, so every change keyed by one value lands on one shard.
-   */
-  aggregate<M extends AggregateNames<S>>(model: M, identity: AggregateIdentity<S[M]>, changes: AggregateChanges<S[M]>, options?: {
-    readonly shardBy?: string;
-  }): void;
-}
-/** A table name, or the reason an aggregate cannot be read this way. */
-type FindManyModel<S extends ModuleSchema, M> = M extends TableNames<S> ? M : "findMany reads tables; read aggregates with findAggregates";
-/** An aggregate name, or the reason a table cannot be read this way. */
-type FindAggregatesModel<S extends ModuleSchema, M> = M extends AggregateNames<S> ? M : "findAggregates reads aggregates; read tables with findMany";
-/** A module's database handle. There is no count, offset, or free-form filter. */
-interface HotUpdaterDatabase<S extends ModuleSchema> {
-  findOne<M extends TableNames<S>>(model: M, lookup: Lookup<S[M]>): Promise<ReadRow<S[M]> | null>;
-  /** Rows by key in one batch read, in the keys' order. */
-  findByKeys<M extends TableNames<S>>(model: M, keys: readonly KeyLookup<S[M]>[]): Promise<(ReadRow<S[M]> | null)[]>;
-  findMany<M extends keyof S & string, I extends IndexName<S[M]>>(model: FindManyModel<S, M>, options: ReadOptions<S[M], I>): Promise<Page<ReadRow<S[M]>>>;
-  findAggregates<M extends keyof S & string, I extends IndexName<S[M]>>(model: FindAggregatesModel<S, M>, options: ReadOptions<S[M], I>): Promise<Page<AggregateRow<S[M]>>>;
-  /** Reruns `fn` when a guarded read changed, within a jittered retry budget. */
-  transaction<R>(fn: (tx: HotUpdaterTransaction<S>) => Promise<R>): Promise<R>;
-}
-/** The engine plus `database(module)`, which hands a module its typed handle. */
-declare const createDatabaseEngine: ({ batching, now, ...options }: DatabaseEngineOptions & {
-  /**
-   * Batches changes to aggregates declared `batched`; the schema must
-   * include `aggregateBatchingModule`.
-   */
-  readonly batching?: AggregateBatching;
-  /** The clock batching times its flushes and compactions by. */
-  readonly now?: () => number;
-}) => {
-  /** Applies batched aggregate changes still pending: this process's buffer and the log. */
-  flush: () => Promise<void>;
-  dispose: () => Promise<void>;
-  database<S extends ModuleSchema>(module: SchemaModule & {
-    readonly schema: S;
-  }): HotUpdaterDatabase<S>;
-  reads: {
-    maxPageSize: number;
-    modelOf: (name: string, kind?: "table" | "aggregate") => ResolvedModel;
-    reads: {
-      total: () => EngineReadCount;
-      reset: () => void;
-    };
-    findByKeys: (name: string, lookups: readonly Readonly<Record<string, DatabaseKeyValue>>[]) => Promise<(StoredRow | null)[]>;
-    findOne(name: string, lookup: Readonly<Record<string, DatabaseKeyValue>>): Promise<StoredRow | null>;
-    findMany(name: string, input: ReadInput): Promise<Page<StoredRow>>;
-    findAggregates(name: string, input: ReadInput): Promise<Page<StoredRow>>;
-  };
-  transaction: <R>(fn: (tx: TransactionEngine) => Promise<R>) => Promise<R>;
-  measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>>;
-};
-type DatabaseEngine = ReturnType<typeof createDatabaseEngine>;
-//#endregion
-export { AggregateChanges, AggregateIdentity, AggregateRow, CreateRow, DatabaseEngine, EngineColumns, FindAggregatesModel, FindManyModel, HotUpdaterDatabase, HotUpdaterTransaction, KeyLookup, Lookup, ReadOptions, ReadRow, TableRow, UpdateSet, createDatabaseEngine };

package/dist/database/database.mjs

@@ -1,63 +0,0 @@
-import { createAggregateBatches } from "./aggregateBatching.mjs";
-import { assertOutsideTransaction } from "./engineTransaction.mjs";
-import { createEngine } from "./engine.mjs";
-import { DATABASE_VERSION_COLUMN } from "@hot-updater/plugin-core/internal";
-//#region src/database/database.ts
-/** The engine plus `database(module)`, which hands a module its typed handle. */
-const createDatabaseEngine = ({ batching, now = Date.now, ...options }) => {
-	const engine = createEngine(options);
-	const { reads } = engine;
-	const batches = batching && createAggregateBatches({
-		engine,
-		adapter: options.adapter,
-		schema: options.schema,
-		batching,
-		now
-	});
-	const transaction = batches?.transaction ?? engine.transaction;
-	const outside = (read) => (...args) => {
-		assertOutsideTransaction();
-		return read(...args);
-	};
-	/** No read outside a transaction returns `_v`, which a key-value index copy lacks. */
-	const bare = (row) => row && Object.fromEntries(Object.entries(row).filter(([column]) => column !== DATABASE_VERSION_COLUMN));
-	const barePage = async (page) => {
-		const { rows, next } = await page;
-		return {
-			rows: rows.map(bare),
-			...next === void 0 ? {} : { next }
-		};
-	};
-	return {
-		...engine,
-		/** Applies batched aggregate changes still pending: this process's buffer and the log. */
-		flush: async () => {
-			await batches?.flush();
-		},
-		dispose: async () => {
-			await batches?.dispose();
-		},
-		database(module) {
-			const name = (model) => module.namespace ? `${module.namespace}_${model}` : model;
-			return {
-				findOne: outside(async (model, lookup) => bare(await reads.findOne(name(model), lookup))),
-				findByKeys: outside(async (model, keys) => (await reads.findByKeys(name(model), keys)).map(bare)),
-				findMany: outside((model, input) => barePage(reads.findMany(name(model), input))),
-				findAggregates: outside(async (model, input) => {
-					await batches?.beforeRead(name(model));
-					return await barePage(reads.findAggregates(name(model), input));
-				}),
-				transaction: (fn) => transaction((tx) => fn({
-					findOne: (model, lookup) => tx.findOne(name(model), lookup),
-					findMany: (model, input) => tx.findMany(name(model), input),
-					create: (model, row) => tx.create(name(model), row),
-					update: (model, row, set) => tx.update(name(model), row, set),
-					delete: (model, row) => tx.delete(name(model), row),
-					aggregate: (model, identity, changes, options) => tx.aggregate(name(model), identity, changes, options)
-				}))
-			};
-		}
-	};
-};
-//#endregion
-export { createDatabaseEngine };

package/dist/database/definitions.d.cts

@@ -1,78 +0,0 @@
-//#region src/database/definitions.d.ts
-/**
- * The model declarations the engine reads. `defineTable` and
- * `defineAggregate` (./schema) build them with typed rows.
- */
-type FieldType = "string" | "integer" | "number" | "boolean" | "json";
-type ReferenceAction = "restrict" | "cascade" | "none";
-interface FieldReference {
-  readonly model: string;
-  readonly onDelete: ReferenceAction;
-}
-interface FieldDefinition<TType extends FieldType = FieldType> {
-  readonly type: TType;
-  /** Defaults to true; an optional field stores null. */
-  readonly required?: boolean;
-  /** Adds a unique index named after the field. */
-  readonly unique?: true;
-  /** Strings: the maximum length; unbounded text when absent. */
-  readonly maxLength?: number;
-  /** Strings: ASCII only, so a long key fits MySQL's 3,072-byte index limit. */
-  readonly ascii?: true;
-  readonly references?: FieldReference;
-}
-interface IndexDefinition<TField extends string = string> {
-  readonly eq: readonly TField[];
-  readonly sort: readonly TField[];
-  /** The eq values identify at most one row. */
-  readonly unique?: true;
-  /** `eq` starts with the key of a `model` row, which every child write bumps. */
-  readonly root?: {
-    readonly model: string;
-  };
-}
-/** A field computed on every write and stored as a real column. */
-interface DerivedShape {
-  readonly type: FieldType;
-  /** Up to 16 values; the row is indexed once per value. */
-  readonly multi?: true;
-  /** Null, or an empty list, leaves the row out of indexes on this field. */
-  compute(row: never): unknown;
-}
-interface TableShape {
-  readonly kind: "table";
-  readonly fields: Readonly<Record<string, FieldDefinition>>;
-  readonly key: readonly string[];
-  readonly derived: Readonly<Record<string, DerivedShape>>;
-  readonly indexes: Readonly<Record<string, IndexDefinition>>;
-  /** Rows expire `days` after the epoch milliseconds in `field`. */
-  readonly retention?: {
-    readonly field: string;
-    readonly days: number;
-  };
-}
-interface AggregateShape {
-  readonly kind: "aggregate";
-  /** Identity fields; `key` lists them in declaration order. */
-  readonly fields: Readonly<Record<string, FieldDefinition>>;
-  readonly key: readonly string[];
-  /** Blind increments. */
-  readonly counters: readonly string[];
-  /** Read, merged, and written back per shard; a row at zero is deleted. */
-  readonly gauges: readonly string[];
-  /** HLL sketches, kept in aggregates of their own. */
-  readonly distinct: readonly string[];
-  /** Fixed once data exists. */
-  readonly shards: number;
-  readonly indexes: Readonly<Record<string, IndexDefinition>>;
-  /** On an identity field; a change to a row past it is dropped. */
-  readonly retention?: {
-    readonly field: string;
-    readonly days: number;
-  };
-}
-type ModelShape = TableShape | AggregateShape;
-/** A module's models by name: core, or one plugin. */
-type SchemaShape = Readonly<Record<string, ModelShape>>;
-//#endregion
-export { AggregateShape, DerivedShape, FieldDefinition, FieldReference, FieldType, IndexDefinition, ModelShape, ReferenceAction, SchemaShape, TableShape };