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

package/dist/database/definitions.d.mts

@@ -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 };

package/dist/database/engine.cjs

@@ -1,37 +0,0 @@
-const require_engineReads = require("./engineReads.cjs");
-const require_engineTransaction = require("./engineTransaction.cjs");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
-//#region src/database/engine.ts
-/** Storage semantics over one adapter, addressed by physical table name. */
-const createEngine = ({ adapter: given, schema, maxPageSize, verify, retry }) => {
-	const verified = verify ? (0, _hot_updater_plugin_core_internal.verifyAdapter)(given) : void 0;
-	const adapter = verified ?? given;
-	const reads = require_engineReads.createEngineReads({
-		adapter,
-		schema,
-		maxPageSize
-	});
-	const { transaction } = require_engineTransaction.createTransactions({
-		adapter,
-		schema,
-		reads,
-		retry
-	});
-	return {
-		reads,
-		transaction,
-		/** Runs `read` and reports what it read at both boundaries (verify mode only). */
-		async measureReads(read) {
-			if (verified === void 0) throw new Error("measureReads needs an engine created with verify: true.");
-			verified.reads.reset();
-			reads.reads.reset();
-			return {
-				result: await read(),
-				adapter: verified.reads.total(),
-				engine: reads.reads.total()
-			};
-		}
-	};
-};
-//#endregion
-exports.createEngine = createEngine;

package/dist/database/engine.d.cts

@@ -1,41 +0,0 @@
-import { ResolvedModel, ResolvedSchema } from "./resolveSchema.cjs";
-import { EngineReadCount, Page, ReadInput } from "./engineReads.cjs";
-import { RetryOptions, TransactionEngine } from "./engineTransaction.cjs";
-import { DatabaseAdapter, DatabaseReadCount } from "@hot-updater/plugin-core/internal";
-//#region src/database/engine.d.ts
-interface DatabaseEngineOptions {
-  readonly adapter: DatabaseAdapter;
-  readonly schema: ResolvedSchema;
-  readonly maxPageSize?: number;
-  /** Checks every adapter call against the contract and meters adapter reads. */
-  readonly verify?: boolean;
-  readonly retry?: RetryOptions;
-}
-interface ReadMeasurement<T> {
-  readonly result: T;
-  /** Point reads and rows the adapter returned. */
-  readonly adapter: DatabaseReadCount;
-  /** Calls and rows (logical rows for aggregates) returned to callers. */
-  readonly engine: EngineReadCount;
-}
-/** Storage semantics over one adapter, addressed by physical table name. */
-declare const createEngine: ({ adapter: given, schema, maxPageSize, verify, retry }: DatabaseEngineOptions) => {
-  reads: {
-    maxPageSize: number;
-    modelOf: (name: string, kind?: "table" | "aggregate") => ResolvedModel;
-    reads: {
-      total: () => EngineReadCount;
-      reset: () => void;
-    };
-    findByKeys: (name: string, lookups: readonly Readonly<Record<string, import("@hot-updater/plugin-core/internal").DatabaseKeyValue>>[]) => Promise<(import("@hot-updater/plugin-core/internal").StoredRow | null)[]>;
-    findOne(name: string, lookup: Readonly<Record<string, import("@hot-updater/plugin-core/internal").DatabaseKeyValue>>): Promise<import("@hot-updater/plugin-core/internal").StoredRow | null>;
-    findMany(name: string, input: ReadInput): Promise<Page<import("@hot-updater/plugin-core/internal").StoredRow>>;
-    findAggregates(name: string, input: ReadInput): Promise<Page<import("@hot-updater/plugin-core/internal").StoredRow>>;
-  };
-  transaction: <R>(fn: (tx: TransactionEngine) => Promise<R>) => Promise<R>;
-  /** Runs `read` and reports what it read at both boundaries (verify mode only). */
-  measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>>;
-};
-type Engine = ReturnType<typeof createEngine>;
-//#endregion
-export { DatabaseEngineOptions, Engine, ReadMeasurement, createEngine };

package/dist/database/engine.d.mts

@@ -1,41 +0,0 @@
-import { ResolvedModel, ResolvedSchema } from "./resolveSchema.mjs";
-import { EngineReadCount, Page, ReadInput } from "./engineReads.mjs";
-import { RetryOptions, TransactionEngine } from "./engineTransaction.mjs";
-import { DatabaseAdapter, DatabaseReadCount } from "@hot-updater/plugin-core/internal";
-//#region src/database/engine.d.ts
-interface DatabaseEngineOptions {
-  readonly adapter: DatabaseAdapter;
-  readonly schema: ResolvedSchema;
-  readonly maxPageSize?: number;
-  /** Checks every adapter call against the contract and meters adapter reads. */
-  readonly verify?: boolean;
-  readonly retry?: RetryOptions;
-}
-interface ReadMeasurement<T> {
-  readonly result: T;
-  /** Point reads and rows the adapter returned. */
-  readonly adapter: DatabaseReadCount;
-  /** Calls and rows (logical rows for aggregates) returned to callers. */
-  readonly engine: EngineReadCount;
-}
-/** Storage semantics over one adapter, addressed by physical table name. */
-declare const createEngine: ({ adapter: given, schema, maxPageSize, verify, retry }: DatabaseEngineOptions) => {
-  reads: {
-    maxPageSize: number;
-    modelOf: (name: string, kind?: "table" | "aggregate") => ResolvedModel;
-    reads: {
-      total: () => EngineReadCount;
-      reset: () => void;
-    };
-    findByKeys: (name: string, lookups: readonly Readonly<Record<string, import("@hot-updater/plugin-core/internal").DatabaseKeyValue>>[]) => Promise<(import("@hot-updater/plugin-core/internal").StoredRow | null)[]>;
-    findOne(name: string, lookup: Readonly<Record<string, import("@hot-updater/plugin-core/internal").DatabaseKeyValue>>): Promise<import("@hot-updater/plugin-core/internal").StoredRow | null>;
-    findMany(name: string, input: ReadInput): Promise<Page<import("@hot-updater/plugin-core/internal").StoredRow>>;
-    findAggregates(name: string, input: ReadInput): Promise<Page<import("@hot-updater/plugin-core/internal").StoredRow>>;
-  };
-  transaction: <R>(fn: (tx: TransactionEngine) => Promise<R>) => Promise<R>;
-  /** Runs `read` and reports what it read at both boundaries (verify mode only). */
-  measureReads<T>(read: () => Promise<T>): Promise<ReadMeasurement<T>>;
-};
-type Engine = ReturnType<typeof createEngine>;
-//#endregion
-export { DatabaseEngineOptions, Engine, ReadMeasurement, createEngine };

package/dist/database/engine.mjs

@@ -1,37 +0,0 @@
-import { createEngineReads } from "./engineReads.mjs";
-import { createTransactions } from "./engineTransaction.mjs";
-import { verifyAdapter } from "@hot-updater/plugin-core/internal";
-//#region src/database/engine.ts
-/** Storage semantics over one adapter, addressed by physical table name. */
-const createEngine = ({ adapter: given, schema, maxPageSize, verify, retry }) => {
-	const verified = verify ? verifyAdapter(given) : void 0;
-	const adapter = verified ?? given;
-	const reads = createEngineReads({
-		adapter,
-		schema,
-		maxPageSize
-	});
-	const { transaction } = createTransactions({
-		adapter,
-		schema,
-		reads,
-		retry
-	});
-	return {
-		reads,
-		transaction,
-		/** Runs `read` and reports what it read at both boundaries (verify mode only). */
-		async measureReads(read) {
-			if (verified === void 0) throw new Error("measureReads needs an engine created with verify: true.");
-			verified.reads.reset();
-			reads.reads.reset();
-			return {
-				result: await read(),
-				adapter: verified.reads.total(),
-				engine: reads.reads.total()
-			};
-		}
-	};
-};
-//#endregion
-export { createEngine };

package/dist/database/engineAggregates.cjs

@@ -1,118 +0,0 @@
-const require_cursor = require("./cursor.cjs");
-const require_errors = require("./errors.cjs");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
-//#region src/database/engineAggregates.ts
-const definitionOf = (model) => model.definition;
-/** Every change keyed by one value lands on one shard. */
-const shardOf = (value, shards) => require_cursor.fnv1a(value) % shards;
-/** Merges one `tx.aggregate` call into its shard row's pending changes. */
-const recordAggregate = (changes, model, identity, values, shardBy) => {
-	const { key: fields, counters, gauges, distinct, shards } = definitionOf(model);
-	const fail = (message) => new require_errors.DatabaseTransactionError(`${model.table.name}: ${message}`);
-	if (Object.keys(identity).length !== fields.length || !fields.every((name) => (0, _hot_updater_plugin_core_internal.isKeyValue)(identity[name]))) throw fail(`aggregate takes exactly its identity fields: ${fields.join(", ")}.`);
-	if (shardBy === void 0 && shards > 1 && gauges.some((gauge) => gauge in values)) throw fail("gauges of a sharded aggregate need shardBy.");
-	const shard = shardBy === void 0 ? Math.floor(Math.random() * shards) : shardOf(shardBy, shards);
-	const key = [...fields.map((name) => identity[name]), shard];
-	const id = JSON.stringify([model.table.name, key]);
-	const change = changes.get(id) ?? {
-		model,
-		key,
-		deltas: {},
-		sketches: {}
-	};
-	changes.set(id, change);
-	for (const [metric, value] of Object.entries(values)) if (distinct.includes(metric) && typeof value === "string") change.sketches[metric] = (0, _hot_updater_plugin_core_internal.mergeDistinct)([change.sketches[metric], value]);
-	else if ((counters.includes(metric) || gauges.includes(metric)) && Number.isSafeInteger(value)) change.deltas[metric] = (change.deltas[metric] ?? 0) + Number(value);
-	else throw fail(`${metric} is not a counter, gauge, or sketch of this aggregate.`);
-};
-/** A shard row before its first change: every metric zero or empty. */
-const blank = (model, key) => {
-	const { counters, gauges, distinct } = definitionOf(model);
-	return Object.fromEntries([
-		...model.table.key.map((column, position) => [column, key[position]]),
-		...[...counters, ...gauges].map((name) => [name, 0]),
-		...distinct.map((name) => [name, null]),
-		[_hot_updater_plugin_core_internal.DATABASE_VERSION_COLUMN, 0]
-	]);
-};
-/**
-* A gauge computed below zero. Deltas from a row another writer has since
-* moved do this, so the transaction reruns; it is thrown only when it lasts.
-*/
-var NegativeGaugeError = class extends require_errors.DatabaseTransactionError {};
-/** The guarded write that merges `change` into `current`: insert, patch, or delete at zero. */
-const rewrite = ({ model, key, deltas, sketches }, current) => {
-	const { table } = model;
-	const { counters, gauges, distinct } = definitionOf(model);
-	const base = current ?? blank(model, key);
-	const set = {};
-	for (const [metric, delta] of Object.entries(deltas)) set[metric] = Number(base[metric] ?? 0) + delta;
-	for (const [metric, sketch] of Object.entries(sketches)) set[metric] = (0, _hot_updater_plugin_core_internal.mergeDistinct)([base[metric], sketch]);
-	if (current && Object.entries(set).every(([metric, value]) => current[metric] === value)) return;
-	const row = {
-		...base,
-		...set
-	};
-	if (gauges.some((gauge) => Number(row[gauge]) < 0)) {
-		if (current === null && table.retention) return void 0;
-		throw new NegativeGaugeError(`${table.name}: a gauge went below 0.`);
-	}
-	const zero = distinct.length === 0 && [...counters, ...gauges].every((metric) => Number(row[metric]) === 0);
-	if (current === null) return zero ? void 0 : {
-		type: "insert",
-		table,
-		row
-	};
-	const guard = { v: Number(current[_hot_updater_plugin_core_internal.DATABASE_VERSION_COLUMN]) };
-	return zero ? {
-		type: "delete",
-		table,
-		key,
-		guard,
-		previous: current
-	} : {
-		type: "patch",
-		table,
-		key,
-		set,
-		guard,
-		previous: current
-	};
-};
-/**
-* Counter-only rows become blind increments that create the row when it is
-* missing. Rows with gauges or sketches are read in one parallel batch per
-* table, merged, and written back under a guard, so a conflict resends only
-* them.
-*/
-const compileAggregates = async (adapter, changes) => {
-	const ops = [];
-	const merged = /* @__PURE__ */ new Map();
-	for (const change of changes) {
-		const { model, key, deltas, sketches } = change;
-		if (Object.keys(sketches).length > 0 || definitionOf(model).gauges.some((gauge) => (deltas[gauge] ?? 0) !== 0)) merged.set(model, [...merged.get(model) ?? [], change]);
-		else if (Object.values(deltas).some((delta) => delta !== 0)) {
-			const { table } = model;
-			const init = blank(model, key);
-			ops.push({
-				type: "increment",
-				table,
-				key,
-				by: deltas,
-				init
-			});
-		}
-	}
-	const groups = [...merged.values()];
-	const current = await Promise.all(groups.map((group) => adapter.get(group[0].model.table, group.map(({ key }) => key))));
-	groups.forEach((group, index) => group.forEach((change, position) => {
-		const op = rewrite(change, current[index][position] ?? null);
-		if (op !== void 0) ops.push(op);
-	}));
-	return ops;
-};
-//#endregion
-exports.NegativeGaugeError = NegativeGaugeError;
-exports.compileAggregates = compileAggregates;
-exports.recordAggregate = recordAggregate;
-exports.shardOf = shardOf;

package/dist/database/engineAggregates.mjs

@@ -1,115 +0,0 @@
-import { fnv1a } from "./cursor.mjs";
-import { DatabaseTransactionError } from "./errors.mjs";
-import { DATABASE_VERSION_COLUMN, isKeyValue, mergeDistinct } from "@hot-updater/plugin-core/internal";
-//#region src/database/engineAggregates.ts
-const definitionOf = (model) => model.definition;
-/** Every change keyed by one value lands on one shard. */
-const shardOf = (value, shards) => fnv1a(value) % shards;
-/** Merges one `tx.aggregate` call into its shard row's pending changes. */
-const recordAggregate = (changes, model, identity, values, shardBy) => {
-	const { key: fields, counters, gauges, distinct, shards } = definitionOf(model);
-	const fail = (message) => new DatabaseTransactionError(`${model.table.name}: ${message}`);
-	if (Object.keys(identity).length !== fields.length || !fields.every((name) => isKeyValue(identity[name]))) throw fail(`aggregate takes exactly its identity fields: ${fields.join(", ")}.`);
-	if (shardBy === void 0 && shards > 1 && gauges.some((gauge) => gauge in values)) throw fail("gauges of a sharded aggregate need shardBy.");
-	const shard = shardBy === void 0 ? Math.floor(Math.random() * shards) : shardOf(shardBy, shards);
-	const key = [...fields.map((name) => identity[name]), shard];
-	const id = JSON.stringify([model.table.name, key]);
-	const change = changes.get(id) ?? {
-		model,
-		key,
-		deltas: {},
-		sketches: {}
-	};
-	changes.set(id, change);
-	for (const [metric, value] of Object.entries(values)) if (distinct.includes(metric) && typeof value === "string") change.sketches[metric] = mergeDistinct([change.sketches[metric], value]);
-	else if ((counters.includes(metric) || gauges.includes(metric)) && Number.isSafeInteger(value)) change.deltas[metric] = (change.deltas[metric] ?? 0) + Number(value);
-	else throw fail(`${metric} is not a counter, gauge, or sketch of this aggregate.`);
-};
-/** A shard row before its first change: every metric zero or empty. */
-const blank = (model, key) => {
-	const { counters, gauges, distinct } = definitionOf(model);
-	return Object.fromEntries([
-		...model.table.key.map((column, position) => [column, key[position]]),
-		...[...counters, ...gauges].map((name) => [name, 0]),
-		...distinct.map((name) => [name, null]),
-		[DATABASE_VERSION_COLUMN, 0]
-	]);
-};
-/**
-* A gauge computed below zero. Deltas from a row another writer has since
-* moved do this, so the transaction reruns; it is thrown only when it lasts.
-*/
-var NegativeGaugeError = class extends DatabaseTransactionError {};
-/** The guarded write that merges `change` into `current`: insert, patch, or delete at zero. */
-const rewrite = ({ model, key, deltas, sketches }, current) => {
-	const { table } = model;
-	const { counters, gauges, distinct } = definitionOf(model);
-	const base = current ?? blank(model, key);
-	const set = {};
-	for (const [metric, delta] of Object.entries(deltas)) set[metric] = Number(base[metric] ?? 0) + delta;
-	for (const [metric, sketch] of Object.entries(sketches)) set[metric] = mergeDistinct([base[metric], sketch]);
-	if (current && Object.entries(set).every(([metric, value]) => current[metric] === value)) return;
-	const row = {
-		...base,
-		...set
-	};
-	if (gauges.some((gauge) => Number(row[gauge]) < 0)) {
-		if (current === null && table.retention) return void 0;
-		throw new NegativeGaugeError(`${table.name}: a gauge went below 0.`);
-	}
-	const zero = distinct.length === 0 && [...counters, ...gauges].every((metric) => Number(row[metric]) === 0);
-	if (current === null) return zero ? void 0 : {
-		type: "insert",
-		table,
-		row
-	};
-	const guard = { v: Number(current[DATABASE_VERSION_COLUMN]) };
-	return zero ? {
-		type: "delete",
-		table,
-		key,
-		guard,
-		previous: current
-	} : {
-		type: "patch",
-		table,
-		key,
-		set,
-		guard,
-		previous: current
-	};
-};
-/**
-* Counter-only rows become blind increments that create the row when it is
-* missing. Rows with gauges or sketches are read in one parallel batch per
-* table, merged, and written back under a guard, so a conflict resends only
-* them.
-*/
-const compileAggregates = async (adapter, changes) => {
-	const ops = [];
-	const merged = /* @__PURE__ */ new Map();
-	for (const change of changes) {
-		const { model, key, deltas, sketches } = change;
-		if (Object.keys(sketches).length > 0 || definitionOf(model).gauges.some((gauge) => (deltas[gauge] ?? 0) !== 0)) merged.set(model, [...merged.get(model) ?? [], change]);
-		else if (Object.values(deltas).some((delta) => delta !== 0)) {
-			const { table } = model;
-			const init = blank(model, key);
-			ops.push({
-				type: "increment",
-				table,
-				key,
-				by: deltas,
-				init
-			});
-		}
-	}
-	const groups = [...merged.values()];
-	const current = await Promise.all(groups.map((group) => adapter.get(group[0].model.table, group.map(({ key }) => key))));
-	groups.forEach((group, index) => group.forEach((change, position) => {
-		const op = rewrite(change, current[index][position] ?? null);
-		if (op !== void 0) ops.push(op);
-	}));
-	return ops;
-};
-//#endregion
-export { NegativeGaugeError, compileAggregates, recordAggregate, shardOf };

package/dist/database/engineReads.cjs

@@ -1,182 +0,0 @@
-const require_cursor = require("./cursor.cjs");
-const require_resolveSchema = require("./resolveSchema.cjs");
-let _hot_updater_plugin_core_internal = require("@hot-updater/plugin-core/internal");
-//#region src/database/engineReads.ts
-var DatabaseQueryError = class extends Error {
-	name = "DatabaseQueryError";
-};
-const sameFields = (left, right) => left.length === right.length && left.every((field) => right.includes(field));
-const keyValue = (value, field) => {
-	if ((0, _hot_updater_plugin_core_internal.isKeyValue)(value)) return value;
-	throw new DatabaseQueryError(`${field} needs a string, number, or boolean.`);
-};
-const bound = (exclusive, inclusive, columns) => {
-	if (exclusive !== void 0 && inclusive !== void 0) throw new DatabaseQueryError(`range on ${columns[0]} sets both bounds of one side.`);
-	const value = exclusive ?? inclusive;
-	if (value === void 0) return void 0;
-	const values = Array.isArray(value) ? value : [value];
-	if (values.length === 0 || values.length > columns.length) throw new DatabaseQueryError(`range on ${columns[0]} takes 1–${columns.length} values of ${columns.join(", ")}.`);
-	return {
-		values: values.map((item, position) => keyValue(item, columns[position])),
-		inclusive: inclusive !== void 0
-	};
-};
-const createEngineReads = ({ adapter, schema, maxPageSize: requested = _hot_updater_plugin_core_internal.DATABASE_MAX_QUERY_LIMIT }) => {
-	const maxPageSize = Math.min(requested, _hot_updater_plugin_core_internal.DATABASE_MAX_QUERY_LIMIT);
-	let count = {
-		calls: 0,
-		rows: 0
-	};
-	const returned = (rows) => {
-		const size = Array.isArray(rows) ? rows.length : rows === null ? 0 : 1;
-		count = {
-			calls: count.calls + 1,
-			rows: count.rows + size
-		};
-		return rows;
-	};
-	/** A model of `kind` by physical table name, for reads and transactions. */
-	const modelOf = (name, kind = "table") => {
-		const model = schema.models.get(name);
-		if (model?.definition.kind === kind) return model;
-		throw new DatabaseQueryError(model === void 0 ? `Unknown model ${name}.` : kind === "table" ? `${name} is an aggregate; read it with findAggregates and change it with aggregate.` : `${name} is a table; read it with findMany and change it with create, update, or delete.`);
-	};
-	const plan = ({ table }, input) => {
-		const index = table.indexes.find(({ name }) => name === input.index);
-		if (index === void 0) throw new DatabaseQueryError(`${table.name} has no index ${input.index}.`);
-		const where = input.where ?? {};
-		if (!sameFields(Object.keys(where), index.eq)) throw new DatabaseQueryError(`${table.name}.${index.name} reads need where on exactly: ${index.eq.join(", ") || "(none)"}.`);
-		const { limit, order = "asc", range } = input;
-		if (!Number.isSafeInteger(limit) || limit < 1 || limit > maxPageSize) throw new DatabaseQueryError(`limit must be 1–${maxPageSize}.`);
-		const columns = (0, _hot_updater_plugin_core_internal.indexOrderColumns)(table, index);
-		const eq = index.eq.map((field) => keyValue(where[field], `${table.name}.${field}`));
-		const scope = require_cursor.cursorScope([
-			table.name,
-			index.name,
-			eq,
-			order,
-			range
-		]);
-		let lower = bound(range?.gt, range?.gte, columns);
-		let upper = bound(range?.lt, range?.lte, columns);
-		if (input.cursor !== void 0) {
-			const values = require_cursor.decodeCursor(scope, input.cursor);
-			if (order === "asc") lower = {
-				values,
-				inclusive: false
-			};
-			else upper = {
-				values,
-				inclusive: false
-			};
-		}
-		return {
-			request: {
-				index: index.name,
-				eq,
-				order,
-				limit,
-				...lower === void 0 ? {} : { lower },
-				...upper === void 0 ? {} : { upper }
-			},
-			index,
-			scope
-		};
-	};
-	/** Reads rows by key in one batch; the results follow the keys' order. */
-	const findByKeys = async (name, lookups) => {
-		const { table } = modelOf(name, "table");
-		const keys = lookups.map((lookup) => {
-			if (!sameFields(Object.keys(lookup), table.key)) throw new DatabaseQueryError(`findByKeys on ${name} takes its key: ${table.key.join(", ")}.`);
-			return table.key.map((field) => keyValue(lookup[field], `${name}.${field}`));
-		});
-		const rows = keys.length === 0 ? [] : await adapter.get(table, keys);
-		returned(rows.filter((row) => row !== null));
-		return rows.map((row) => row ?? null);
-	};
-	return {
-		maxPageSize,
-		modelOf,
-		reads: {
-			total: () => count,
-			reset: () => {
-				count = {
-					calls: 0,
-					rows: 0
-				};
-			}
-		},
-		findByKeys,
-		/** Reads one row by its key or by the eq fields of a unique index. */
-		async findOne(name, lookup) {
-			const { table } = modelOf(name, "table");
-			const fields = Object.keys(lookup);
-			if (sameFields(fields, table.key)) return (await findByKeys(name, [lookup]))[0];
-			const index = table.indexes.find(({ unique, eq }) => unique && sameFields(fields, eq));
-			if (index === void 0) throw new DatabaseQueryError(`findOne on ${name} needs its key or a unique field, not ${fields.join(", ")}.`);
-			const [row] = await adapter.query(table, {
-				index: index.name,
-				eq: index.eq.map((field) => keyValue(lookup[field], `${name}.${field}`)),
-				order: "asc",
-				limit: 1
-			});
-			return returned(row ?? null);
-		},
-		/** Reads one page of an index range; `next` resumes right after it. */
-		async findMany(name, input) {
-			const model = modelOf(name, "table");
-			const { request, index, scope } = plan(model, input);
-			const rows = returned(await adapter.query(model.table, request));
-			const last = rows.at(-1);
-			return rows.length === input.limit && last !== void 0 ? {
-				rows,
-				next: require_cursor.encodeCursor(scope, (0, _hot_updater_plugin_core_internal.indexOrderTuple)(model.table, index, last))
-			} : { rows };
-		},
-		/**
-		* Reads one page of logical aggregate rows, summing counters and gauges
-		* and merging sketches across each row's shards. A row cut off by the
-		* limit is completed by reading only its remaining shards.
-		*/
-		async findAggregates(name, input) {
-			const model = modelOf(name, "aggregate");
-			const { table, definition } = model;
-			if (definition.kind !== "aggregate") throw new DatabaseQueryError(name);
-			const { request, index, scope } = plan(model, input);
-			const rows = await adapter.query(table, request);
-			const logicalKey = (row) => definition.key.map((column) => keyValue(row[column], column));
-			const groups = /* @__PURE__ */ new Map();
-			for (const row of rows) {
-				const key = JSON.stringify(logicalKey(row));
-				groups.set(key, [...groups.get(key) ?? [], row]);
-			}
-			const full = rows.length === input.limit;
-			const last = [...groups.values()].at(-1);
-			if (full && last !== void 0) {
-				const seen = new Set(last.map((row) => row[require_resolveSchema.SHARD_COLUMN]));
-				const missing = Array.from({ length: definition.shards }, (_, shard) => shard).filter((shard) => !seen.has(shard));
-				if (missing.length > 0) {
-					const key = logicalKey(last[0]);
-					const rest = await adapter.get(table, missing.map((shard) => [...key, shard]));
-					last.push(...rest.filter((row) => row !== null));
-				}
-			}
-			const merged = [...groups.values()].map((shards) => {
-				const row = Object.fromEntries(definition.key.map((field) => [field, shards[0][field]]));
-				for (const metric of [...definition.counters, ...definition.gauges]) row[metric] = shards.reduce((sum, shard) => sum + Number(shard[metric] ?? 0), 0);
-				for (const metric of definition.distinct) row[metric] = (0, _hot_updater_plugin_core_internal.mergeDistinct)(shards.map((shard) => shard[metric]));
-				return row;
-			});
-			returned(merged);
-			if (!full || last === void 0) return { rows: merged };
-			const tuple = (0, _hot_updater_plugin_core_internal.indexOrderTuple)(table, index, last[0]);
-			return {
-				rows: merged,
-				next: require_cursor.encodeCursor(scope, tuple.slice(0, -1))
-			};
-		}
-	};
-};
-//#endregion
-exports.DatabaseQueryError = DatabaseQueryError;
-exports.createEngineReads = createEngineReads;