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

package/dist/database/resolveSchema.mjs

@@ -1,196 +0,0 @@
-import { physicalRetention, retentionProblems } from "./retention.mjs";
-import { DATABASE_VERSION_COLUMN, DatabaseSchemaError } from "@hot-updater/plugin-core/internal";
-//#region src/database/resolveSchema.ts
-const SHARD_COLUMN = "_shard";
-const MAX_SHARDS = 64;
-const NAME = /^[a-z][a-z0-9_]*$/u;
-const INDEX_NAME = /^[A-Za-z][A-Za-z0-9_]*$/u;
-const tableName = (module, model) => module.namespace ? `${module.namespace}_${model}` : model;
-const integer = (name, defaulted = false) => ({
-	name,
-	type: "integer",
-	nullable: false,
-	...defaulted ? { default: 0 } : {}
-});
-/** A declared or derived field's type, and whether it holds several values. */
-const fieldType = (model, name) => {
-	const field = model.fields[name] ?? (model.kind === "table" ? model.derived[name] : void 0);
-	return field && {
-		type: field.type,
-		multi: "multi" in field && !!field.multi
-	};
-};
-const metricsOf = (model) => [
-	...model.counters,
-	...model.gauges,
-	...model.distinct
-];
-/** Field names, the key, and each field's options. */
-const fieldProblems = (definition, add) => {
-	const names = [...Object.keys(definition.fields), ...definition.kind === "table" ? Object.keys(definition.derived) : metricsOf(definition)];
-	for (const name of new Set(names)) {
-		if (!NAME.test(name)) add(`field "${name}" must match ${NAME.source}`);
-		if (names.indexOf(name) !== names.lastIndexOf(name)) add(`field "${name}" is declared twice`);
-	}
-	const { key } = definition;
-	if (key.length === 0) add("key is empty");
-	if (new Set(key).size !== key.length) add("key repeats a field");
-	for (const name of key) {
-		const field = definition.fields[name];
-		if (field === void 0) add(`key field "${name}" is not a declared field`);
-		else if (field.required === false) add(`key field "${name}" is nullable`);
-		else if (field.type === "json") add(`key field "${name}" is json`);
-	}
-	for (const [name, { type, maxLength, ascii }] of Object.entries(definition.fields)) {
-		if (maxLength !== void 0 && (type !== "string" || !Number.isSafeInteger(maxLength) || maxLength < 1)) add(`field "${name}" has an invalid maxLength`);
-		if (ascii && type !== "string") add(`field "${name}" is ascii but not a string`);
-	}
-};
-/** A table's derived fields and references. */
-const tableProblems = (definition, add, table) => {
-	for (const [name, derived] of Object.entries(definition.derived)) {
-		if (typeof derived.compute !== "function") add(`derived field "${name}" has no compute function`);
-		if (derived.multi && derived.type === "json") add(`derived field "${name}" cannot be multi-valued json`);
-	}
-	for (const [name, { type, references }] of Object.entries(definition.fields)) {
-		if (references === void 0) continue;
-		const target = table(references.model);
-		const targetKey = target?.key.length === 1 ? target.fields[target.key[0]] : void 0;
-		if (targetKey === void 0) add(`field "${name}" references "${references.model}", which is not a single-key table of this module`);
-		else if (targetKey.type !== type) add(`field "${name}" and the key of "${references.model}" differ in type`);
-		if (references.onDelete === "cascade" && !Object.values(definition.indexes).some(({ eq }) => eq.length === 1 && eq[0] === name)) add(`cascade on "${name}" needs an index whose eq is exactly [${name}]`);
-	}
-};
-/** An aggregate's identity, metrics, and shards. */
-const aggregateProblems = (definition, add) => {
-	const identity = Object.keys(definition.fields);
-	if (definition.key.join("\0") !== identity.join("\0")) add(`key must list the identity fields in declaration order: ${identity.join(", ")}`);
-	if (metricsOf(definition).length === 0) add("aggregate has no metrics");
-	if (definition.distinct.length > 0 && definition.counters.length + definition.gauges.length > 0) add("distinct sketches need an aggregate of their own");
-	const { shards } = definition;
-	if (!Number.isSafeInteger(shards) || shards < 1 || shards > 64) add(`shards must be 1–64`);
-};
-/** Every problem in one model's declaration, its roots and references included. */
-const problemsOf = (module, model, definition) => {
-	const problems = [];
-	const add = (message) => problems.push(`${module.id}.${model}: ${message}`);
-	const table = (name) => {
-		const target = module.schema[name];
-		return target?.kind === "table" ? target : void 0;
-	};
-	if (!NAME.test(model)) add("model names use lowercase letters, digits, and _");
-	fieldProblems(definition, add);
-	for (const [name, index] of Object.entries(definition.indexes)) {
-		const columns = [...index.eq, ...index.sort];
-		if (!INDEX_NAME.test(name)) add(`index "${name}" must match ${INDEX_NAME.source}`);
-		if (columns.length === 0) add(`index "${name}" has no fields`);
-		if (index.unique && index.sort.length > 0) add(`unique index "${name}" cannot sort`);
-		if (columns.filter((column) => {
-			const type = fieldType(definition, column);
-			if (type === void 0) add(`index "${name}" names undeclared field "${column}"`);
-			else if (type.type === "json") add(`index "${name}" names json field "${column}"`);
-			else if (type.multi && index.sort.includes(column)) add(`index "${name}" sorts by multi-valued field "${column}"`);
-			return type?.type !== "json" && type?.multi;
-		}).length > 1) add(`index "${name}" has more than one multi-valued field`);
-		if (index.root === void 0) continue;
-		const root = table(index.root.model);
-		if (root === void 0) add(`index "${name}" is rooted at unknown table "${index.root.model}"`);
-		else if (root.key.length > index.eq.length || root.key.some((field, position) => fieldType(definition, index.eq[position])?.type !== root.fields[field].type)) add(`index "${name}" eq must start with the key of "${index.root.model}"`);
-	}
-	if (definition.kind === "table") tableProblems(definition, add, table);
-	else aggregateProblems(definition, add);
-	for (const problem of retentionProblems(module.schema, model)) add(problem);
-	return problems;
-};
-/** Rejects invalid module schemas at startup, listing every problem. */
-const validateSchema = (modules) => {
-	const problems = [];
-	const owners = /* @__PURE__ */ new Map();
-	for (const module of modules) for (const [model, definition] of Object.entries(module.schema)) {
-		const name = tableName(module, model);
-		const owner = owners.get(name);
-		if (owner !== void 0) problems.push(`${module.id}.${model}: table "${name}" is also declared by ${owner}`);
-		owners.set(name, `${module.id}.${model}`);
-		problems.push(...problemsOf(module, model, definition));
-	}
-	if (problems.length > 0) throw new DatabaseSchemaError(`Invalid database schema:\n- ${problems.join("\n- ")}`);
-};
-const indexesOf = (definition) => [...Object.entries(definition.indexes).map(([name, index]) => ({
-	name,
-	eq: [...index.eq],
-	sort: [...index.sort],
-	...index.unique ? { unique: true } : {}
-})), ...Object.entries(definition.fields).flatMap(([name, field]) => field.unique ? [{
-	name,
-	eq: [name],
-	sort: [],
-	unique: true
-}] : [])];
-/** Validates the modules, then resolves them into physical tables with engine columns. */
-const resolveSchema = (modules) => {
-	validateSchema(modules);
-	const references = [];
-	for (const module of modules) for (const [model, definition] of Object.entries(module.schema)) {
-		if (definition.kind !== "table") continue;
-		const table = tableName(module, model);
-		for (const [field, { references: to }] of Object.entries(definition.fields)) {
-			if (to === void 0) continue;
-			const { onDelete } = to;
-			const target = tableName(module, to.model);
-			const counter = onDelete === "none" ? {} : { counter: `_refs_${table}_${field}` };
-			references.push({
-				table,
-				field,
-				target,
-				onDelete,
-				...counter
-			});
-		}
-	}
-	const models = /* @__PURE__ */ new Map();
-	for (const module of modules) for (const [model, definition] of Object.entries(module.schema)) {
-		const name = tableName(module, model);
-		const referencedBy = references.filter(({ target }) => target === name);
-		const columns = Object.entries(definition.fields).map(([field, { type, required, maxLength, ascii }]) => ({
-			name: field,
-			type,
-			nullable: required === false,
-			...maxLength === void 0 ? {} : { maxLength },
-			...ascii ? { ascii } : {}
-		}));
-		if (definition.kind === "table") for (const [field, { type, multi }] of Object.entries(definition.derived)) columns.push({
-			name: field,
-			type,
-			nullable: true,
-			...multi ? { multi } : {}
-		});
-		else columns.push(integer(SHARD_COLUMN), ...[...definition.counters, ...definition.gauges].map((metric) => integer(metric)), ...definition.distinct.map((metric) => ({
-			name: metric,
-			type: "string",
-			nullable: true
-		})));
-		for (const { counter } of referencedBy) if (counter !== void 0) columns.push(integer(counter, true));
-		columns.push(integer(DATABASE_VERSION_COLUMN, true));
-		models.set(name, {
-			module: module.id,
-			model,
-			definition,
-			table: {
-				name,
-				columns,
-				key: definition.kind === "aggregate" ? [...definition.key, SHARD_COLUMN] : [...definition.key],
-				indexes: indexesOf(definition),
-				...physicalRetention(definition)
-			},
-			references: references.filter(({ table }) => table === name),
-			referencedBy,
-			roots: new Map(Object.entries(definition.indexes).flatMap(([index, { root }]) => root === void 0 ? [] : [[index, tableName(module, root.model)]]))
-		});
-	}
-	return {
-		models,
-		tables: [...models.values()].map(({ table }) => table)
-	};
-};
-//#endregion
-export { MAX_SHARDS, SHARD_COLUMN, resolveSchema, validateSchema };

package/dist/database/retention.cjs

@@ -1,92 +0,0 @@
-//#region src/database/retention.ts
-const MINUTE_MS = 6e4;
-const HOUR_MS = 60 * MINUTE_MS;
-const DAY_MS = 24 * HOUR_MS;
-/** A model's retention as its physical table carries it, which each adapter maps natively. */
-const physicalRetention = ({ retention }) => retention === void 0 ? {} : { retention: {
-	column: retention.field,
-	ms: retention.days * DAY_MS
-} };
-/** Models in a reference or a rooted index, which an expired row's delete would break. */
-const linkedModels = (schema) => Object.entries(schema).flatMap(([name, { fields, indexes }]) => [...Object.values(fields).map(({ references }) => references), ...Object.values(indexes).map(({ root }) => root)].flatMap((link) => link ? [name, link.model] : []));
-/**
-* What is wrong with a model's retention: it counts from an integer field,
-* over whole days, and expired rows are deleted without cascades, counter
-* moves, or root bumps, so the model is in no reference or rooted index.
-*/
-const retentionProblems = (schema, model) => {
-	const definition = schema[model];
-	if (definition.retention === void 0) return [];
-	const { field, days } = definition.retention;
-	const declared = definition.fields[field] ?? (definition.kind === "table" ? definition.derived[field] : void 0);
-	return [
-		...declared?.type !== "integer" || "multi" in declared && declared.multi === true ? [`retention field "${field}" is not an integer field`] : [],
-		...Number.isSafeInteger(days) && days >= 1 ? [] : ["retention days must be a whole number of at least 1"],
-		...linkedModels(schema).includes(model) ? ["a model with retention is in no reference or rooted index"] : []
-	];
-};
-/**
-* Rows a pass deletes from each table: one statement or two a table, so a
-* pass stays well inside D1's 50 queries an invocation.
-*/
-const PASS_LIMIT = 500;
-/** The lease row: when the next pass is due, in epoch ms. */
-const LEASE_KEY = "retention.nextPassAt";
-/**
-* The adapter, pruning during its writes with no scheduler: once the lease
-* row in `leaseTable` is due, the write that takes it first runs one bounded
-* pass over the tables with retention, and other writers skip. The next pass is due in an hour, or in a minute while a pass still
-* found a full batch of expired rows in some table. A backend that expires
-* rows natively, or a schema without retention, gets its adapter back.
-*/
-const pruneDuringWrites = (adapter, tables, { leaseTable: table, now }) => {
-	const expiring = tables.filter(({ retention }) => retention !== void 0);
-	if (adapter.prune === void 0 || expiring.length === 0) return adapter;
-	const key = [LEASE_KEY];
-	let checkAt = 0;
-	const lease = async (row, due) => {
-		const value = String(due);
-		const guard = { v: row === null ? -1 : Number(row._v) };
-		const next = {
-			key: LEASE_KEY,
-			value,
-			_v: guard.v + 1
-		};
-		const op = row === null ? {
-			type: "insert",
-			table,
-			row: next
-		} : {
-			type: "patch",
-			table,
-			key,
-			set: { value },
-			guard,
-			previous: row
-		};
-		return (await adapter.write([op])).ok ? next : null;
-	};
-	const pass = async () => {
-		const at = now();
-		if (at < checkAt) return;
-		checkAt = at + MINUTE_MS;
-		const [row = null] = await adapter.get(table, [key]);
-		checkAt = row === null ? at : Number(row.value);
-		if (checkAt > at) return;
-		const held = await lease(row, at + HOUR_MS);
-		if (held === null) return;
-		checkAt = at + HOUR_MS;
-		const deleted = [];
-		for (const t of expiring) deleted.push(await adapter.prune(t, at - t.retention.ms, PASS_LIMIT));
-		if (deleted.includes(PASS_LIMIT) && await lease(held, at + MINUTE_MS) !== null) checkAt = at + MINUTE_MS;
-	};
-	const warn = (error) => console.warn("[hot-updater] Pruning expired rows failed.", error);
-	return Object.assign(Object.create(adapter), { async write(ops) {
-		await pass().catch(warn);
-		return adapter.write(ops);
-	} });
-};
-//#endregion
-exports.physicalRetention = physicalRetention;
-exports.pruneDuringWrites = pruneDuringWrites;
-exports.retentionProblems = retentionProblems;

package/dist/database/retention.mjs

@@ -1,90 +0,0 @@
-//#region src/database/retention.ts
-const MINUTE_MS = 6e4;
-const HOUR_MS = 60 * MINUTE_MS;
-const DAY_MS = 24 * HOUR_MS;
-/** A model's retention as its physical table carries it, which each adapter maps natively. */
-const physicalRetention = ({ retention }) => retention === void 0 ? {} : { retention: {
-	column: retention.field,
-	ms: retention.days * DAY_MS
-} };
-/** Models in a reference or a rooted index, which an expired row's delete would break. */
-const linkedModels = (schema) => Object.entries(schema).flatMap(([name, { fields, indexes }]) => [...Object.values(fields).map(({ references }) => references), ...Object.values(indexes).map(({ root }) => root)].flatMap((link) => link ? [name, link.model] : []));
-/**
-* What is wrong with a model's retention: it counts from an integer field,
-* over whole days, and expired rows are deleted without cascades, counter
-* moves, or root bumps, so the model is in no reference or rooted index.
-*/
-const retentionProblems = (schema, model) => {
-	const definition = schema[model];
-	if (definition.retention === void 0) return [];
-	const { field, days } = definition.retention;
-	const declared = definition.fields[field] ?? (definition.kind === "table" ? definition.derived[field] : void 0);
-	return [
-		...declared?.type !== "integer" || "multi" in declared && declared.multi === true ? [`retention field "${field}" is not an integer field`] : [],
-		...Number.isSafeInteger(days) && days >= 1 ? [] : ["retention days must be a whole number of at least 1"],
-		...linkedModels(schema).includes(model) ? ["a model with retention is in no reference or rooted index"] : []
-	];
-};
-/**
-* Rows a pass deletes from each table: one statement or two a table, so a
-* pass stays well inside D1's 50 queries an invocation.
-*/
-const PASS_LIMIT = 500;
-/** The lease row: when the next pass is due, in epoch ms. */
-const LEASE_KEY = "retention.nextPassAt";
-/**
-* The adapter, pruning during its writes with no scheduler: once the lease
-* row in `leaseTable` is due, the write that takes it first runs one bounded
-* pass over the tables with retention, and other writers skip. The next pass is due in an hour, or in a minute while a pass still
-* found a full batch of expired rows in some table. A backend that expires
-* rows natively, or a schema without retention, gets its adapter back.
-*/
-const pruneDuringWrites = (adapter, tables, { leaseTable: table, now }) => {
-	const expiring = tables.filter(({ retention }) => retention !== void 0);
-	if (adapter.prune === void 0 || expiring.length === 0) return adapter;
-	const key = [LEASE_KEY];
-	let checkAt = 0;
-	const lease = async (row, due) => {
-		const value = String(due);
-		const guard = { v: row === null ? -1 : Number(row._v) };
-		const next = {
-			key: LEASE_KEY,
-			value,
-			_v: guard.v + 1
-		};
-		const op = row === null ? {
-			type: "insert",
-			table,
-			row: next
-		} : {
-			type: "patch",
-			table,
-			key,
-			set: { value },
-			guard,
-			previous: row
-		};
-		return (await adapter.write([op])).ok ? next : null;
-	};
-	const pass = async () => {
-		const at = now();
-		if (at < checkAt) return;
-		checkAt = at + MINUTE_MS;
-		const [row = null] = await adapter.get(table, [key]);
-		checkAt = row === null ? at : Number(row.value);
-		if (checkAt > at) return;
-		const held = await lease(row, at + HOUR_MS);
-		if (held === null) return;
-		checkAt = at + HOUR_MS;
-		const deleted = [];
-		for (const t of expiring) deleted.push(await adapter.prune(t, at - t.retention.ms, PASS_LIMIT));
-		if (deleted.includes(PASS_LIMIT) && await lease(held, at + MINUTE_MS) !== null) checkAt = at + MINUTE_MS;
-	};
-	const warn = (error) => console.warn("[hot-updater] Pruning expired rows failed.", error);
-	return Object.assign(Object.create(adapter), { async write(ops) {
-		await pass().catch(warn);
-		return adapter.write(ops);
-	} });
-};
-//#endregion
-export { physicalRetention, pruneDuringWrites, retentionProblems };

package/dist/database/schema.cjs

@@ -1,24 +0,0 @@
-//#region src/database/schema.ts
-const defineTable = (fields, options) => ({
-	kind: "table",
-	fields,
-	key: options.key,
-	derived: options.derived ?? {},
-	indexes: options.indexes ?? {},
-	...options.retention === void 0 ? {} : { retention: options.retention }
-});
-const defineAggregate = (fields, options) => ({
-	kind: "aggregate",
-	fields,
-	key: options.key,
-	counters: options.counters ?? [],
-	gauges: options.gauges ?? [],
-	distinct: options.distinct ?? [],
-	shards: options.shards ?? 1,
-	indexes: options.indexes ?? {},
-	...options.batched ? { batched: true } : {},
-	...options.retention === void 0 ? {} : { retention: options.retention }
-});
-//#endregion
-exports.defineAggregate = defineAggregate;
-exports.defineTable = defineTable;

package/dist/database/schema.d.cts

@@ -1,90 +0,0 @@
-import { AggregateShape, FieldDefinition, FieldReference, FieldType, IndexDefinition, ReferenceAction, TableShape } from "./definitions.cjs";
-import { DatabaseJson } from "@hot-updater/plugin-core/internal";
-//#region src/database/schema.d.ts
-/**
- * How long a model keeps its rows: `days` past the epoch milliseconds in
- * `field`, an integer field (a table's derived one too, where null keeps
- * the row). Expired rows are deleted without cascades, so a model with
- * retention is in no reference and no rooted index.
- */
-interface RetentionDefinition<TField extends string = string> {
-  readonly field: TField;
-  readonly days: number;
-}
-type FieldValue<TType extends FieldType> = TType extends "string" ? string : TType extends "integer" | "number" ? number : TType extends "boolean" ? boolean : DatabaseJson;
-type Fields = Readonly<Record<string, FieldDefinition>>;
-type RowOf<TFields extends Fields> = { -readonly [K in keyof TFields]: TFields[K] extends FieldDefinition<infer TType> ? TFields[K] extends {
-  readonly required: false;
-} ? FieldValue<TType> | null : FieldValue<TType> : never; };
-/** Computed on every write and stored as a real column. */
-interface DerivedDefinition<TRow = never, TType extends FieldType = FieldType> {
-  readonly type: TType;
-  /** 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: TRow): FieldValue<TType> | null | readonly FieldValue<TType>[];
-}
-type DerivedTypes = Readonly<Record<string, FieldType>>;
-/** Derived fields over a table's row, by name. */
-type DerivedFields<TFields extends Fields, TDerived extends DerivedTypes> = { readonly [K in keyof TDerived]: DerivedDefinition<RowOf<TFields>, TDerived[K]>; };
-type Indexes = Readonly<Record<string, IndexDefinition>>;
-/** The integer fields, declared or derived, that retention can count from. */
-type IntegerFields<TFields extends Fields, TDerived extends DerivedTypes> = { [K in keyof TFields]: TFields[K] extends {
-  readonly type: "integer";
-} ? K : never; }[keyof TFields] | { [K in keyof TDerived]: TDerived[K] extends "integer" ? K : never; }[keyof TDerived];
-type MissingFields<TIndex, TNames extends string> = TIndex extends {
-  readonly eq: readonly (infer TEq)[];
-  readonly sort: readonly (infer TSort)[];
-} ? Exclude<TEq | TSort, TNames> : never;
-/** Maps an index to an error message when it names an undeclared field. */
-type CheckIndex<TName extends PropertyKey, TIndex, TNames extends string> = [MissingFields<TIndex, TNames>] extends [never] ? TIndex : `Index "${TName & string}" names undeclared field "${MissingFields<TIndex, TNames> & string}"`;
-type CheckIndexes<TIndexes, TNames extends string> = { readonly [K in keyof TIndexes]: CheckIndex<K, TIndexes[K], TNames>; };
-interface TableDefinition<TFields extends Fields = Fields, TDerived extends DerivedTypes = DerivedTypes, TIndexes extends Indexes = Indexes, TKey extends readonly (keyof TFields & string)[] = readonly (keyof TFields & string)[]> extends TableShape {
-  readonly kind: "table";
-  readonly fields: TFields;
-  readonly key: TKey;
-  readonly derived: DerivedFields<TFields, TDerived>;
-  readonly indexes: TIndexes;
-}
-declare const defineTable: <const TFields extends Fields, const TKey extends readonly (keyof TFields & string)[], const TDerived extends DerivedTypes = {}, const TIndexes extends Indexes = {}>(fields: TFields, options: {
-  readonly key: TKey;
-  readonly derived?: DerivedFields<TFields, TDerived>;
-  readonly indexes?: TIndexes & CheckIndexes<TIndexes, (keyof TFields | keyof TDerived) & string>;
-  /** Rows expire `days` after the epoch milliseconds in `field`. */
-  readonly retention?: RetentionDefinition<IntegerFields<TFields, TDerived> & string>;
-}) => TableDefinition<TFields, TDerived, TIndexes, TKey>;
-interface AggregateDefinition<TFields extends Fields = Fields, TMetric extends string = string, TIndexes extends Indexes = Indexes, TSketch extends string = string, TKey extends readonly (keyof TFields & string)[] = readonly (keyof TFields & string)[]> extends AggregateShape {
-  readonly kind: "aggregate";
-  readonly fields: TFields;
-  readonly key: TKey;
-  readonly counters: readonly TMetric[];
-  readonly gauges: readonly TMetric[];
-  readonly distinct: readonly TSketch[];
-  readonly indexes: TIndexes;
-  /**
-   * On a database that batches aggregates, changes apply after their
-   * transaction commits, in one write per row with other transactions'
-   * changes, so reads may lag them. Elsewhere they commit with it.
-   */
-  readonly batched?: true;
-}
-declare const defineAggregate: <const TFields extends Fields, const TKey extends readonly (keyof TFields & string)[], const TMetric extends string = never, const TIndexes extends Indexes = {}, const TSketch extends string = never>(fields: TFields, options: {
-  readonly key: TKey;
-  readonly counters?: readonly TMetric[];
-  readonly gauges?: readonly TMetric[];
-  readonly distinct?: readonly TSketch[];
-  readonly shards?: number;
-  readonly indexes?: TIndexes & CheckIndexes<TIndexes, keyof TFields & string>;
-  readonly batched?: true;
-  /**
-   * Rows expire `days` after the epoch milliseconds in `field`, an
-   * identity field such as a bucket's start; a change to a row already
-   * past it is dropped, so a late gauge decrement never goes below zero.
-   */
-  readonly retention?: RetentionDefinition<IntegerFields<TFields, {}> & string>;
-}) => AggregateDefinition<TFields, TMetric, TIndexes, TSketch, TKey>;
-type ModelDefinition = TableDefinition | AggregateDefinition;
-/** A module's models by name: core, or one plugin. */
-type ModuleSchema = Readonly<Record<string, ModelDefinition>>;
-//#endregion
-export { AggregateDefinition, CheckIndex, DerivedDefinition, DerivedFields, type FieldDefinition, type FieldReference, type FieldType, FieldValue, type IndexDefinition, ModelDefinition, ModuleSchema, type ReferenceAction, RetentionDefinition, RowOf, TableDefinition, defineAggregate, defineTable };

package/dist/database/schema.d.mts

@@ -1,90 +0,0 @@
-import { AggregateShape, FieldDefinition, FieldReference, FieldType, IndexDefinition, ReferenceAction, TableShape } from "./definitions.mjs";
-import { DatabaseJson } from "@hot-updater/plugin-core/internal";
-//#region src/database/schema.d.ts
-/**
- * How long a model keeps its rows: `days` past the epoch milliseconds in
- * `field`, an integer field (a table's derived one too, where null keeps
- * the row). Expired rows are deleted without cascades, so a model with
- * retention is in no reference and no rooted index.
- */
-interface RetentionDefinition<TField extends string = string> {
-  readonly field: TField;
-  readonly days: number;
-}
-type FieldValue<TType extends FieldType> = TType extends "string" ? string : TType extends "integer" | "number" ? number : TType extends "boolean" ? boolean : DatabaseJson;
-type Fields = Readonly<Record<string, FieldDefinition>>;
-type RowOf<TFields extends Fields> = { -readonly [K in keyof TFields]: TFields[K] extends FieldDefinition<infer TType> ? TFields[K] extends {
-  readonly required: false;
-} ? FieldValue<TType> | null : FieldValue<TType> : never; };
-/** Computed on every write and stored as a real column. */
-interface DerivedDefinition<TRow = never, TType extends FieldType = FieldType> {
-  readonly type: TType;
-  /** 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: TRow): FieldValue<TType> | null | readonly FieldValue<TType>[];
-}
-type DerivedTypes = Readonly<Record<string, FieldType>>;
-/** Derived fields over a table's row, by name. */
-type DerivedFields<TFields extends Fields, TDerived extends DerivedTypes> = { readonly [K in keyof TDerived]: DerivedDefinition<RowOf<TFields>, TDerived[K]>; };
-type Indexes = Readonly<Record<string, IndexDefinition>>;
-/** The integer fields, declared or derived, that retention can count from. */
-type IntegerFields<TFields extends Fields, TDerived extends DerivedTypes> = { [K in keyof TFields]: TFields[K] extends {
-  readonly type: "integer";
-} ? K : never; }[keyof TFields] | { [K in keyof TDerived]: TDerived[K] extends "integer" ? K : never; }[keyof TDerived];
-type MissingFields<TIndex, TNames extends string> = TIndex extends {
-  readonly eq: readonly (infer TEq)[];
-  readonly sort: readonly (infer TSort)[];
-} ? Exclude<TEq | TSort, TNames> : never;
-/** Maps an index to an error message when it names an undeclared field. */
-type CheckIndex<TName extends PropertyKey, TIndex, TNames extends string> = [MissingFields<TIndex, TNames>] extends [never] ? TIndex : `Index "${TName & string}" names undeclared field "${MissingFields<TIndex, TNames> & string}"`;
-type CheckIndexes<TIndexes, TNames extends string> = { readonly [K in keyof TIndexes]: CheckIndex<K, TIndexes[K], TNames>; };
-interface TableDefinition<TFields extends Fields = Fields, TDerived extends DerivedTypes = DerivedTypes, TIndexes extends Indexes = Indexes, TKey extends readonly (keyof TFields & string)[] = readonly (keyof TFields & string)[]> extends TableShape {
-  readonly kind: "table";
-  readonly fields: TFields;
-  readonly key: TKey;
-  readonly derived: DerivedFields<TFields, TDerived>;
-  readonly indexes: TIndexes;
-}
-declare const defineTable: <const TFields extends Fields, const TKey extends readonly (keyof TFields & string)[], const TDerived extends DerivedTypes = {}, const TIndexes extends Indexes = {}>(fields: TFields, options: {
-  readonly key: TKey;
-  readonly derived?: DerivedFields<TFields, TDerived>;
-  readonly indexes?: TIndexes & CheckIndexes<TIndexes, (keyof TFields | keyof TDerived) & string>;
-  /** Rows expire `days` after the epoch milliseconds in `field`. */
-  readonly retention?: RetentionDefinition<IntegerFields<TFields, TDerived> & string>;
-}) => TableDefinition<TFields, TDerived, TIndexes, TKey>;
-interface AggregateDefinition<TFields extends Fields = Fields, TMetric extends string = string, TIndexes extends Indexes = Indexes, TSketch extends string = string, TKey extends readonly (keyof TFields & string)[] = readonly (keyof TFields & string)[]> extends AggregateShape {
-  readonly kind: "aggregate";
-  readonly fields: TFields;
-  readonly key: TKey;
-  readonly counters: readonly TMetric[];
-  readonly gauges: readonly TMetric[];
-  readonly distinct: readonly TSketch[];
-  readonly indexes: TIndexes;
-  /**
-   * On a database that batches aggregates, changes apply after their
-   * transaction commits, in one write per row with other transactions'
-   * changes, so reads may lag them. Elsewhere they commit with it.
-   */
-  readonly batched?: true;
-}
-declare const defineAggregate: <const TFields extends Fields, const TKey extends readonly (keyof TFields & string)[], const TMetric extends string = never, const TIndexes extends Indexes = {}, const TSketch extends string = never>(fields: TFields, options: {
-  readonly key: TKey;
-  readonly counters?: readonly TMetric[];
-  readonly gauges?: readonly TMetric[];
-  readonly distinct?: readonly TSketch[];
-  readonly shards?: number;
-  readonly indexes?: TIndexes & CheckIndexes<TIndexes, keyof TFields & string>;
-  readonly batched?: true;
-  /**
-   * Rows expire `days` after the epoch milliseconds in `field`, an
-   * identity field such as a bucket's start; a change to a row already
-   * past it is dropped, so a late gauge decrement never goes below zero.
-   */
-  readonly retention?: RetentionDefinition<IntegerFields<TFields, {}> & string>;
-}) => AggregateDefinition<TFields, TMetric, TIndexes, TSketch, TKey>;
-type ModelDefinition = TableDefinition | AggregateDefinition;
-/** A module's models by name: core, or one plugin. */
-type ModuleSchema = Readonly<Record<string, ModelDefinition>>;
-//#endregion
-export { AggregateDefinition, CheckIndex, DerivedDefinition, DerivedFields, type FieldDefinition, type FieldReference, type FieldType, FieldValue, type IndexDefinition, ModelDefinition, ModuleSchema, type ReferenceAction, RetentionDefinition, RowOf, TableDefinition, defineAggregate, defineTable };

package/dist/database/schema.mjs

@@ -1,23 +0,0 @@
-//#region src/database/schema.ts
-const defineTable = (fields, options) => ({
-	kind: "table",
-	fields,
-	key: options.key,
-	derived: options.derived ?? {},
-	indexes: options.indexes ?? {},
-	...options.retention === void 0 ? {} : { retention: options.retention }
-});
-const defineAggregate = (fields, options) => ({
-	kind: "aggregate",
-	fields,
-	key: options.key,
-	counters: options.counters ?? [],
-	gauges: options.gauges ?? [],
-	distinct: options.distinct ?? [],
-	shards: options.shards ?? 1,
-	indexes: options.indexes ?? {},
-	...options.batched ? { batched: true } : {},
-	...options.retention === void 0 ? {} : { retention: options.retention }
-});
-//#endregion
-export { defineAggregate, defineTable };