typion 0.0.0-stage → 0.1.1

package/dist/seed/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/seed/index.ts"],"sourcesContent":["import { is, sql } from 'drizzle-orm'\nimport {\n  getTableConfig,\n  type PgAsyncDatabase,\n  type PgQueryResultHKT,\n  PgTable,\n} from 'drizzle-orm/pg-core'\nimport { ConfigError } from '../errors.js'\nimport type { TypionConfig } from '../types/collection.js'\nimport type { EntityMeta } from '../types/meta.js'\nimport type { SeedColumnsInput, SeedGenerators } from '../types/plugin.js'\n\n// A thin wrapper over drizzle-seed. What it adds is what drizzle-seed cannot know: which tables belong to the\n// engine rather than to the application (the tables the plugins own or derive, the migrations),\n// and what the installed plugins want their own columns to hold. Nothing here knows what a draft or a tenant\n// is: a plugin that is not installed contributes nothing, and the rows are drizzle-seed's own.\n\ntype Db = PgAsyncDatabase<PgQueryResultHKT, any>\n\ntype SeedModule = {\n  seed: (\n    db: Db,\n    schema: Record<string, PgTable>,\n    options?: { count?: number; seed?: number },\n  ) => {\n    refine(callback: (funcs: SeedGenerators) => Record<string, unknown>): Promise<void>\n  } & Promise<void>\n}\n\nexport type CollectionSeed = (\n  generators: SeedGenerators,\n  entity: EntityMeta,\n) => Record<string, unknown>\n\nexport type SeedOptions = {\n  // Rows per collection.\n  count?: number\n  // Same number, same rows.\n  seed?: number\n  // By default every collection of the config except the ones a plugin owns.\n  collections?: readonly string[]\n  // Values the plugins read (the tenant of multi-tenancy, say).\n  values?: Readonly<Record<string, unknown>>\n  // The last word: drizzle-seed refinements, merged over everything else.\n  refine?: (generators: SeedGenerators) => Record<string, unknown>\n  db?: Db\n}\n\n// The build of drizzle-seed that runs on the Drizzle the engine is built on: its `latest` is for Drizzle 0.x, and its\n// release candidate wants a newer Drizzle.\nexport const DRIZZLE_SEED = '1.0.0-rc.5-ab785fc'\n\nasync function load(): Promise<SeedModule> {\n  try {\n    return (await import('drizzle-seed')) as unknown as SeedModule\n  } catch (error) {\n    throw new ConfigError(\n      `Seeding needs drizzle-seed@${DRIZZLE_SEED} (\\`pnpm add -D drizzle-seed@${DRIZZLE_SEED}\\`)`,\n      'config',\n      { cause: error },\n    )\n  }\n}\n\nfunction truncate(db: Db, tables: readonly PgTable[]): Promise<unknown> | undefined {\n  if (tables.length === 0) return undefined\n  const names = tables.map((table) => {\n    const info = getTableConfig(table)\n    return `\"${info.schema ?? 'public'}\".\"${info.name}\"`\n  })\n  return db.execute(sql.raw(`truncate table ${names.join(', ')} cascade`))\n}\n\nfunction connect(config: TypionConfig<any>, given?: Db): Db {\n  if (given !== undefined) return given\n  if (config.db === undefined) {\n    throw new ConfigError('The config has no database adapter (`db` in defineConfig)')\n  }\n  return config.db.connect(config.definition.relations)\n}\n\nfunction collectionsOf(config: TypionConfig<any>, names?: readonly string[]): EntityMeta[] {\n  const entities = Object.values(config.definition.entities) as EntityMeta[]\n  const own = entities.filter((entity) => entity.owner === 'user')\n  if (names === undefined) return own\n  return names.map((name) => {\n    const entity = own.find((candidate) => candidate.name === name)\n    if (entity === undefined) throw new ConfigError(`'${name}' is not a collection of this config`)\n    return entity\n  })\n}\n\n// Plugins first, then what the collection says about itself, then what the caller says.\nfunction columnsFor(\n  config: TypionConfig<any>,\n  entity: EntityMeta,\n  input: SeedColumnsInput,\n): Record<string, unknown> {\n  const columns: Record<string, unknown> = {}\n  for (const plugin of config.definition.plugins) {\n    Object.assign(columns, plugin.spec.seed?.columns?.(entity, input))\n  }\n  const generators = input.generators\n  const own = entity.pluginOptions.seed as CollectionSeed | undefined\n  if (typeof own === 'function') Object.assign(columns, own(generators, entity))\n  return columns\n}\n\nexport async function seedCollections(\n  config: TypionConfig<any>,\n  options: SeedOptions = {},\n): Promise<void> {\n  const { seed } = await load()\n  const defaults = config.seed ?? {}\n  const db = connect(config, options.db)\n  const entities = collectionsOf(config, options.collections ?? defaults.collections)\n  const schema: Record<string, PgTable> = {}\n  for (const entity of entities) schema[entity.name] = entity.table\n  const values = { ...defaults.values, ...options.values }\n  // drizzle-seed's own default, which the plugins need to know to give every row a distinct value.\n  const count = options.count ?? defaults.count ?? 10\n  const refine = options.refine ?? defaults.refine\n\n  await seed(db, schema, { count, seed: options.seed ?? defaults.seed }).refine((generators) => {\n    const refinements: Record<string, unknown> = {}\n    for (const entity of entities) {\n      const columns = columnsFor(config, entity, { generators, values, count })\n      if (Object.keys(columns).length > 0) refinements[entity.name] = { columns }\n    }\n    return { ...refinements, ...refine?.(generators) }\n  })\n}\n\n// Empties the collections (and, through their foreign keys, what the plugins derived from them).\nexport async function resetCollections(\n  config: TypionConfig<any>,\n  options: Pick<SeedOptions, 'collections' | 'db'> = {},\n): Promise<void> {\n  const db = connect(config, options.db)\n  await truncate(\n    db,\n    collectionsOf(config, options.collections).map((entity) => entity.table),\n  )\n}\n\n// Every table of the config — the collections, their history, the plugins' tables, the config's `tables` — as\n// `typion db push` made them: starting again from a seed needs the auth library's users and the audit trail gone too.\nexport async function resetTables(\n  config: TypionConfig<any>,\n  options: Pick<SeedOptions, 'db'> = {},\n): Promise<void> {\n  const tables = Object.values(config.schema).filter((value): value is PgTable =>\n    is(value, PgTable),\n  )\n  await truncate(connect(config, options.db), tables)\n}\n"],"mappings":"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"}

package/dist/structural-BZnjFmCs.js

@@ -0,0 +1,247 @@
+import { n as ConfigError } from "./errors-D-CKO-px.js";
+import { a as prefixIssues, n as isStandardSchema, o as runStandard, r as issueAt, t as isPromiseLike } from "./issues-DLqCBQT1.js";
+//#region src/validation/structural.ts
+const VENDOR = "typion";
+const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+const INTEGER_CONSTRAINTS = /* @__PURE__ */ new Set([
+	"int8",
+	"uint8",
+	"int16",
+	"uint16",
+	"int24",
+	"uint24",
+	"int32",
+	"uint32",
+	"int53",
+	"uint53",
+	"year"
+]);
+function runtimeOf(column) {
+	return column.column;
+}
+function isPlainObject(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const proto = Object.getPrototypeOf(value);
+	return proto === Object.prototype || proto === null;
+}
+function isJsonValue(value) {
+	const type = typeof value;
+	return type === "string" || type === "number" || type === "boolean" || type === "object";
+}
+function then(value, fn) {
+	return isPromiseLike(value) ? value.then(fn) : fn(value);
+}
+function typeMismatch(dataType, value, runtime, enumValues) {
+	const [type, constraint] = dataType.split(" ");
+	switch (type) {
+		case "string": {
+			if (typeof value !== "string") return "Expected a string";
+			if (constraint === "uuid") return UUID_RE.test(value) ? null : "Expected a uuid";
+			if (constraint === "enum") return enumValues?.includes(value) ? null : `Expected one of ${(enumValues ?? []).map((v) => `'${v}'`).join(", ")}`;
+			if (constraint === "int64" || constraint === "uint64") return (constraint === "int64" ? /^-?\d+$/ : /^\d+$/).test(value) ? null : "Expected an integer string";
+			if (constraint === "binary" && !/^[01]*$/.test(value)) return "Expected a bit string";
+			const { length, isLengthExact } = runtime;
+			if (length !== void 0) {
+				if (isLengthExact && value.length !== length) return `Expected exactly ${length} characters`;
+				if (!isLengthExact && value.length > length) return `Expected at most ${length} characters`;
+			}
+			return null;
+		}
+		case "number":
+			if (typeof value !== "number" || !Number.isFinite(value)) return "Expected a number";
+			if (constraint !== void 0 && INTEGER_CONSTRAINTS.has(constraint) && !Number.isInteger(value)) return "Expected an integer";
+			return null;
+		case "bigint": return typeof value === "bigint" ? null : "Expected a bigint";
+		case "boolean": return typeof value === "boolean" ? null : "Expected a boolean";
+		case "object":
+			if (constraint === "date") return value instanceof Date && !Number.isNaN(value.getTime()) ? null : "Expected a Date";
+			if (constraint === "buffer") return value instanceof Uint8Array ? null : "Expected a buffer";
+			if (constraint === "json") return isJsonValue(value) ? null : "Expected a JSON value";
+			return typeof value === "object" && value !== null ? null : "Expected an object";
+		case "array":
+			if (!Array.isArray(value)) return "Expected an array";
+			if (constraint === "basecolumn" && runtime.baseColumn !== void 0) {
+				const base = runtime.baseColumn;
+				for (const item of value) {
+					const message = typeMismatch(base.dataType, item, base, base.enumValues);
+					if (message !== null) return `Array item: ${message.toLowerCase()}`;
+				}
+			}
+			return null;
+		default: return null;
+	}
+}
+function checkDimensions(column, runtime, value, depth) {
+	if (depth === 0) return typeMismatch(column.dataType, value, runtime, column.enumValues);
+	if (!Array.isArray(value)) return "Expected an array";
+	for (const item of value) {
+		const message = checkDimensions(column, runtime, item, depth - 1);
+		if (message !== null) return message;
+	}
+	return null;
+}
+function scalarChecker(column, refinement) {
+	const runtime = runtimeOf(column);
+	const dimensions = runtime.dimensions ?? 0;
+	return (value) => {
+		const message = checkDimensions(column, runtime, value, dimensions);
+		if (message !== null) return { issues: [issueAt(message)] };
+		return refinement === void 0 ? { value } : runStandard(refinement, value);
+	};
+}
+function valueChecker(value) {
+	if (value === void 0) return (item) => isJsonValue(item) ? null : "Expected a JSON value";
+	const column = {
+		dataType: value.dataType,
+		enumValues: value.enumValues,
+		column: value
+	};
+	const runtime = runtimeOf(column);
+	const dimensions = runtime.dimensions ?? 0;
+	return (item) => checkDimensions(column, runtime, item, dimensions);
+}
+function capitalized(word) {
+	return word.charAt(0).toUpperCase() + word.slice(1);
+}
+function keyedChecker(shape, perKey, whole) {
+	const known = new Set(shape.keys);
+	const required = new Set(shape.required);
+	const nonNull = new Set(shape.nonNull);
+	const noun = shape.keyName;
+	const check = valueChecker(shape.value);
+	return (value) => {
+		if (!isPlainObject(value)) return { issues: [issueAt(`Expected an object keyed by ${noun}`)] };
+		const issues = [];
+		const output = {};
+		const pending = [];
+		for (const key of Object.keys(value)) if (!known.has(key)) issues.push(issueAt(`Unknown ${noun} '${key}'`, [key]));
+		for (const key of required) if (value[key] === void 0 || value[key] === null) issues.push(issueAt(`${capitalized(noun)} '${key}' is required`, [key]));
+		for (const key of shape.keys) {
+			const item = value[key];
+			if (item === void 0) continue;
+			if (item === null) {
+				if (nonNull.has(key)) continue;
+				output[key] = null;
+				continue;
+			}
+			const mismatch = check(item);
+			if (mismatch !== null) {
+				issues.push(issueAt(mismatch, [key]));
+				continue;
+			}
+			const refinement = perKey[key];
+			if (refinement === void 0) {
+				output[key] = item;
+				continue;
+			}
+			const result = then(runStandard(refinement, item), (r) => {
+				if (r.issues === void 0) output[key] = r.value;
+				else issues.push(...prefixIssues(r.issues, [key]));
+			});
+			if (isPromiseLike(result)) pending.push(result);
+		}
+		const finish = () => {
+			if (issues.length > 0) return { issues };
+			return whole === void 0 ? { value: output } : runStandard(whole, output);
+		};
+		return pending.length === 0 ? finish() : Promise.all(pending).then(finish);
+	};
+}
+function isRequired(column, mode) {
+	if (mode === "select") return true;
+	if (mode === "update") return false;
+	return column.notNull && !column.hasDefault && !column.generated;
+}
+function isGeneratedAlways(column) {
+	const runtime = runtimeOf(column);
+	return runtime.generated?.type === "always" || runtime.generatedIdentity?.type === "always";
+}
+function fieldSchema(key, required, nullable, keyed, check) {
+	return {
+		key,
+		required,
+		nullable,
+		keyed,
+		"~standard": {
+			version: 1,
+			vendor: VENDOR,
+			validate: (value) => {
+				if (value === void 0) return required ? { issues: [issueAt("Required")] } : { value: void 0 };
+				if (value === null) return nullable ? { value: null } : { issues: [issueAt("Expected a non-null value")] };
+				return check(value);
+			}
+		}
+	};
+}
+function fail(entity, message) {
+	throw new ConfigError(`Entity '${entity}': validate.fields ${message}`, "config", { entity });
+}
+function buildField(entity, column, mode, refinement) {
+	const shape = column.columnKind?.validation?.(column, mode);
+	const required = isRequired(column, mode);
+	const nullable = !column.notNull;
+	if (shape === void 0) {
+		if (refinement !== void 0 && !isStandardSchema(refinement)) fail(entity.name, `.${column.key} must be a Standard Schema`);
+		return fieldSchema(column.key, required, nullable, false, scalarChecker(column, refinement));
+	}
+	let whole;
+	let perKey = {};
+	if (isStandardSchema(refinement)) whole = refinement;
+	else if (refinement !== void 0) {
+		if (!isPlainObject(refinement)) fail(entity.name, `.${column.key} must be a Standard Schema or a per-${shape.keyName} record of them`);
+		for (const [key, schema] of Object.entries(refinement)) {
+			if (!shape.keys.includes(key)) fail(entity.name, `.${column.key}.${key} is not a configured ${shape.keyName}`);
+			if (schema !== void 0 && !isStandardSchema(schema)) fail(entity.name, `.${column.key}.${key} must be a Standard Schema`);
+		}
+		perKey = refinement;
+	}
+	return fieldSchema(column.key, required, nullable, true, keyedChecker(shape, perKey, whole));
+}
+function schemaKeys(entity, mode) {
+	if (mode === "select") return [...entity.visibleKeys];
+	return Object.keys(entity.columns).filter((key) => !isGeneratedAlways(entity.columns[key]));
+}
+function structuralSchema(entity, mode, refinements) {
+	for (const key of Object.keys(refinements ?? {})) if (!(key in entity.columns)) fail(entity.name, `.${key} does not name a column`);
+	const fields = {};
+	for (const key of schemaKeys(entity, mode)) {
+		const column = entity.columns[key];
+		fields[key] = buildField(entity, column, mode, refinements?.[key]);
+	}
+	const validate = (input) => {
+		if (!isPlainObject(input)) return { issues: [issueAt("Expected an object")] };
+		const issues = [];
+		const output = {};
+		const pending = [];
+		for (const key of Object.keys(input)) if (!(key in fields)) issues.push(issueAt(`Unknown key '${key}'`, [key]));
+		for (const [key, field] of Object.entries(fields)) {
+			const result = then(field["~standard"].validate(input[key]), (r) => {
+				if (r.issues !== void 0) issues.push(...prefixIssues(r.issues, [key]));
+				else if (r.value !== void 0) output[key] = r.value;
+			});
+			if (isPromiseLike(result)) pending.push(result);
+		}
+		const finish = () => issues.length > 0 ? { issues } : { value: output };
+		return pending.length === 0 ? finish() : Promise.all(pending).then(finish);
+	};
+	return {
+		entity: entity.name,
+		mode,
+		fields,
+		"~standard": {
+			version: 1,
+			vendor: VENDOR,
+			validate
+		}
+	};
+}
+function structuralValidation() {
+	return {
+		id: "structural",
+		base: (entity, mode, refinements) => structuralSchema(entity, mode, refinements)
+	};
+}
+//#endregion
+export { structuralValidation as n, schemaKeys as t };
+
+//# sourceMappingURL=structural-BZnjFmCs.js.map

package/dist/structural-BZnjFmCs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-BZnjFmCs.js","names":[],"sources":["../src/validation/structural.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec'\nimport type { AnyPgColumn } from 'drizzle-orm/pg-core'\nimport { ConfigError } from '../errors.js'\nimport type { KeyedShape, ValidationMode } from '../types/kinds.js'\nimport type { ColumnMeta, EntityMeta } from '../types/meta.js'\nimport type { ValidationAdapter } from '../types/runtime.js'\nimport { isPromiseLike, isStandardSchema, issueAt, prefixIssues, runStandard } from './issues.js'\n\nexport type { ValidationMode }\n\nexport type StructuralFieldRefinement =\n  StandardSchemaV1 | Readonly<Record<string, StandardSchemaV1 | undefined>>\n\nexport type StructuralRefinements = Readonly<Record<string, StructuralFieldRefinement | undefined>>\n\nexport interface StructuralFieldSchema extends StandardSchemaV1 {\n  readonly key: string\n  readonly required: boolean\n  readonly nullable: boolean\n  // The column's kind stores an object keyed per value (a localized column: one key per locale).\n  readonly keyed: boolean\n}\n\nexport interface StructuralSchema extends StandardSchemaV1<\n  Record<string, unknown>,\n  Record<string, unknown>\n> {\n  readonly entity: string\n  readonly mode: ValidationMode\n  readonly fields: Readonly<Record<string, StructuralFieldSchema>>\n}\n\nexport interface StructuralValidationAdapter extends ValidationAdapter {\n  readonly id: 'structural'\n  base(\n    entity: EntityMeta,\n    mode: ValidationMode,\n    refinements: Record<string, unknown> | undefined,\n  ): StructuralSchema\n}\n\ntype Result = StandardSchemaV1.Result<unknown>\ntype MaybeAsync<T> = T | Promise<T>\ntype Checker = (value: unknown) => MaybeAsync<Result>\n\nconst VENDOR = 'typion'\nconst UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i\nconst INTEGER_CONSTRAINTS = new Set([\n  'int8',\n  'uint8',\n  'int16',\n  'uint16',\n  'int24',\n  'uint24',\n  'int32',\n  'uint32',\n  'int53',\n  'uint53',\n  'year',\n])\n\n// Runtime column fields the type layer does not surface on `AnyPgColumn` (arrays carry their base column\n// and dimension count; strings their length constraint).\ntype ColumnRuntime = {\n  dimensions?: number\n  baseColumn?: ColumnRuntime & { dataType: string; enumValues?: readonly string[] | undefined }\n  length?: number\n  isLengthExact?: boolean\n  generated?: { type?: string } | undefined\n  generatedIdentity?: { type?: string } | undefined\n}\n\nfunction runtimeOf(column: ColumnMeta): ColumnRuntime {\n  return column.column as unknown as ColumnRuntime\n}\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) return false\n  const proto = Object.getPrototypeOf(value)\n  return proto === Object.prototype || proto === null\n}\n\n// JSON has no undefined, functions, symbols or bigints; null is handled by the nullability rules.\nfunction isJsonValue(value: unknown): boolean {\n  const type = typeof value\n  return type === 'string' || type === 'number' || type === 'boolean' || type === 'object'\n}\n\nfunction then<T, R>(value: MaybeAsync<T>, fn: (v: T) => MaybeAsync<R>): MaybeAsync<R> {\n  return isPromiseLike(value) ? value.then(fn) : fn(value)\n}\n\n// Returns the failure message for a value that does not fit the column's storage type, or null.\nfunction typeMismatch(\n  dataType: string,\n  value: unknown,\n  runtime: ColumnRuntime,\n  enumValues: readonly string[] | undefined,\n): string | null {\n  const [type, constraint] = dataType.split(' ')\n  switch (type) {\n    case 'string': {\n      if (typeof value !== 'string') return 'Expected a string'\n      if (constraint === 'uuid') return UUID_RE.test(value) ? null : 'Expected a uuid'\n      if (constraint === 'enum') {\n        return enumValues?.includes(value)\n          ? null\n          : `Expected one of ${(enumValues ?? []).map((v) => `'${v}'`).join(', ')}`\n      }\n      if (constraint === 'int64' || constraint === 'uint64') {\n        return (constraint === 'int64' ? /^-?\\d+$/ : /^\\d+$/).test(value)\n          ? null\n          : 'Expected an integer string'\n      }\n      if (constraint === 'binary' && !/^[01]*$/.test(value)) return 'Expected a bit string'\n      const { length, isLengthExact } = runtime\n      if (length !== undefined) {\n        if (isLengthExact && value.length !== length) return `Expected exactly ${length} characters`\n        if (!isLengthExact && value.length > length) return `Expected at most ${length} characters`\n      }\n      return null\n    }\n    case 'number': {\n      if (typeof value !== 'number' || !Number.isFinite(value)) return 'Expected a number'\n      if (\n        constraint !== undefined &&\n        INTEGER_CONSTRAINTS.has(constraint) &&\n        !Number.isInteger(value)\n      ) {\n        return 'Expected an integer'\n      }\n      return null\n    }\n    case 'bigint':\n      return typeof value === 'bigint' ? null : 'Expected a bigint'\n    case 'boolean':\n      return typeof value === 'boolean' ? null : 'Expected a boolean'\n    case 'object': {\n      if (constraint === 'date') {\n        return value instanceof Date && !Number.isNaN(value.getTime()) ? null : 'Expected a Date'\n      }\n      if (constraint === 'buffer') return value instanceof Uint8Array ? null : 'Expected a buffer'\n      if (constraint === 'json') return isJsonValue(value) ? null : 'Expected a JSON value'\n      return typeof value === 'object' && value !== null ? null : 'Expected an object'\n    }\n    case 'array': {\n      if (!Array.isArray(value)) return 'Expected an array'\n      if (constraint === 'basecolumn' && runtime.baseColumn !== undefined) {\n        const base = runtime.baseColumn\n        for (const item of value) {\n          const message = typeMismatch(base.dataType, item, base, base.enumValues)\n          if (message !== null) return `Array item: ${message.toLowerCase()}`\n        }\n      }\n      return null\n    }\n    default:\n      return null\n  }\n}\n\n// pg arrays keep the element's dataType and count the nesting in `dimensions`.\nfunction checkDimensions(\n  column: ColumnMeta,\n  runtime: ColumnRuntime,\n  value: unknown,\n  depth: number,\n): string | null {\n  if (depth === 0) return typeMismatch(column.dataType, value, runtime, column.enumValues)\n  if (!Array.isArray(value)) return 'Expected an array'\n  for (const item of value) {\n    const message = checkDimensions(column, runtime, item, depth - 1)\n    if (message !== null) return message\n  }\n  return null\n}\n\nfunction scalarChecker(column: ColumnMeta, refinement: StandardSchemaV1 | undefined): Checker {\n  const runtime = runtimeOf(column)\n  const dimensions = runtime.dimensions ?? 0\n  return (value) => {\n    const message = checkDimensions(column, runtime, value, dimensions)\n    if (message !== null) return { issues: [issueAt(message)] }\n    return refinement === undefined ? { value } : runStandard(refinement, value)\n  }\n}\n\n// A keyed kind's values are checked as the column it names, with the same messages.\nfunction valueChecker(value: AnyPgColumn | undefined): (item: unknown) => string | null {\n  if (value === undefined) return (item) => (isJsonValue(item) ? null : 'Expected a JSON value')\n  const column = {\n    dataType: value.dataType,\n    enumValues: value.enumValues,\n    column: value,\n  } as unknown as ColumnMeta\n  const runtime = runtimeOf(column)\n  const dimensions = runtime.dimensions ?? 0\n  return (item) => checkDimensions(column, runtime, item, dimensions)\n}\n\nfunction capitalized(word: string): string {\n  return word.charAt(0).toUpperCase() + word.slice(1)\n}\n\nfunction keyedChecker(\n  shape: KeyedShape,\n  perKey: Readonly<Record<string, StandardSchemaV1 | undefined>>,\n  whole: StandardSchemaV1 | undefined,\n): Checker {\n  const known = new Set<string>(shape.keys)\n  const required = new Set<string>(shape.required)\n  const nonNull = new Set<string>(shape.nonNull)\n  const noun = shape.keyName\n  const check = valueChecker(shape.value)\n  return (value) => {\n    if (!isPlainObject(value)) return { issues: [issueAt(`Expected an object keyed by ${noun}`)] }\n    const issues: StandardSchemaV1.Issue[] = []\n    const output: Record<string, unknown> = {}\n    const pending: Promise<void>[] = []\n    for (const key of Object.keys(value)) {\n      if (!known.has(key)) issues.push(issueAt(`Unknown ${noun} '${key}'`, [key]))\n    }\n    for (const key of required) {\n      if (value[key] === undefined || value[key] === null) {\n        issues.push(issueAt(`${capitalized(noun)} '${key}' is required`, [key]))\n      }\n    }\n    for (const key of shape.keys) {\n      const item = value[key]\n      if (item === undefined) continue\n      if (item === null) {\n        if (nonNull.has(key)) continue\n        output[key] = null\n        continue\n      }\n      const mismatch = check(item)\n      if (mismatch !== null) {\n        issues.push(issueAt(mismatch, [key]))\n        continue\n      }\n      const refinement = perKey[key]\n      if (refinement === undefined) {\n        output[key] = item\n        continue\n      }\n      const result = then(runStandard(refinement, item), (r) => {\n        if (r.issues === undefined) output[key] = r.value\n        else issues.push(...prefixIssues(r.issues, [key]))\n      })\n      if (isPromiseLike(result)) pending.push(result)\n    }\n    const finish = (): MaybeAsync<Result> => {\n      if (issues.length > 0) return { issues }\n      return whole === undefined ? { value: output } : runStandard(whole, output)\n    }\n    return pending.length === 0 ? finish() : Promise.all(pending).then(finish)\n  }\n}\n\nfunction isRequired(column: ColumnMeta, mode: ValidationMode): boolean {\n  if (mode === 'select') return true\n  if (mode === 'update') return false\n  return column.notNull && !column.hasDefault && !column.generated\n}\n\nfunction isGeneratedAlways(column: ColumnMeta): boolean {\n  const runtime = runtimeOf(column)\n  return runtime.generated?.type === 'always' || runtime.generatedIdentity?.type === 'always'\n}\n\nfunction fieldSchema(\n  key: string,\n  required: boolean,\n  nullable: boolean,\n  keyed: boolean,\n  check: Checker,\n): StructuralFieldSchema {\n  return {\n    key,\n    required,\n    nullable,\n    keyed,\n    '~standard': {\n      version: 1,\n      vendor: VENDOR,\n      validate: (value) => {\n        if (value === undefined) {\n          return required ? { issues: [issueAt('Required')] } : { value: undefined }\n        }\n        if (value === null) {\n          return nullable ? { value: null } : { issues: [issueAt('Expected a non-null value')] }\n        }\n        return check(value)\n      },\n    },\n  }\n}\n\nfunction fail(entity: string, message: string): never {\n  throw new ConfigError(`Entity '${entity}': validate.fields ${message}`, 'config', { entity })\n}\n\nfunction buildField(\n  entity: EntityMeta,\n  column: ColumnMeta,\n  mode: ValidationMode,\n  refinement: unknown,\n): StructuralFieldSchema {\n  const shape = column.columnKind?.validation?.(column, mode)\n  const required = isRequired(column, mode)\n  const nullable = !column.notNull\n  if (shape === undefined) {\n    if (refinement !== undefined && !isStandardSchema(refinement)) {\n      fail(entity.name, `.${column.key} must be a Standard Schema`)\n    }\n    return fieldSchema(column.key, required, nullable, false, scalarChecker(column, refinement))\n  }\n  let whole: StandardSchemaV1 | undefined\n  let perKey: Readonly<Record<string, StandardSchemaV1 | undefined>> = {}\n  if (isStandardSchema(refinement)) {\n    whole = refinement\n  } else if (refinement !== undefined) {\n    if (!isPlainObject(refinement)) {\n      fail(\n        entity.name,\n        `.${column.key} must be a Standard Schema or a per-${shape.keyName} record of them`,\n      )\n    }\n    for (const [key, schema] of Object.entries(refinement)) {\n      if (!shape.keys.includes(key)) {\n        fail(entity.name, `.${column.key}.${key} is not a configured ${shape.keyName}`)\n      }\n      if (schema !== undefined && !isStandardSchema(schema)) {\n        fail(entity.name, `.${column.key}.${key} must be a Standard Schema`)\n      }\n    }\n    perKey = refinement as Readonly<Record<string, StandardSchemaV1 | undefined>>\n  }\n  return fieldSchema(column.key, required, nullable, true, keyedChecker(shape, perKey, whole))\n}\n\nexport function schemaKeys(entity: EntityMeta, mode: ValidationMode): string[] {\n  if (mode === 'select') return [...entity.visibleKeys]\n  return Object.keys(entity.columns).filter(\n    (key) => !isGeneratedAlways(entity.columns[key] as ColumnMeta),\n  )\n}\n\nexport function structuralSchema(\n  entity: EntityMeta,\n  mode: ValidationMode,\n  refinements: Record<string, unknown> | undefined,\n): StructuralSchema {\n  for (const key of Object.keys(refinements ?? {})) {\n    if (!(key in entity.columns)) fail(entity.name, `.${key} does not name a column`)\n  }\n  const fields: Record<string, StructuralFieldSchema> = {}\n  for (const key of schemaKeys(entity, mode)) {\n    const column = entity.columns[key] as ColumnMeta\n    fields[key] = buildField(entity, column, mode, refinements?.[key])\n  }\n\n  type RowResult = StandardSchemaV1.Result<Record<string, unknown>>\n  const validate = (input: unknown): MaybeAsync<RowResult> => {\n    if (!isPlainObject(input)) return { issues: [issueAt('Expected an object')] }\n    const issues: StandardSchemaV1.Issue[] = []\n    const output: Record<string, unknown> = {}\n    const pending: Promise<void>[] = []\n    for (const key of Object.keys(input)) {\n      if (!(key in fields)) issues.push(issueAt(`Unknown key '${key}'`, [key]))\n    }\n    for (const [key, field] of Object.entries(fields)) {\n      const result = then(field['~standard'].validate(input[key]), (r) => {\n        if (r.issues !== undefined) issues.push(...prefixIssues(r.issues, [key]))\n        else if (r.value !== undefined) output[key] = r.value\n      })\n      if (isPromiseLike(result)) pending.push(result)\n    }\n    const finish = (): RowResult => (issues.length > 0 ? { issues } : { value: output })\n    return pending.length === 0 ? finish() : Promise.all(pending).then(finish)\n  }\n\n  return {\n    entity: entity.name,\n    mode,\n    fields,\n    '~standard': { version: 1, vendor: VENDOR, validate },\n  }\n}\n\nexport function structuralValidation(): StructuralValidationAdapter {\n  return {\n    id: 'structural',\n    base: (entity, mode, refinements) => structuralSchema(entity, mode, refinements),\n  }\n}\n"],"mappings":"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"}

package/dist/testing/index.d.ts

@@ -0,0 +1,26 @@
+import { Gt as ContextFactoryInput, Mt as AfterCommitErrorHandler, Sa as PluginSystemOptions, a as MaybePromise, ba as PluginContextOptions, f as TypionApp, m as TypionTypes, n as ContextInput, p as TypionEngine, pn as TypionConfig, un as TypesOf } from "../context-B4e2eREP.js";
+import { PgAsyncDatabase, PgQueryResultHKT } from "drizzle-orm/pg-core";
+//#region src/testing/harness.d.ts
+interface TestTypion<TE extends TypionTypes> {
+  readonly typion: TypionEngine<TE>;
+  readonly db: PgAsyncDatabase<PgQueryResultHKT, TE['relations']>;
+  reset(): Promise<void>;
+  close(): Promise<void>;
+  asUser(ctx: TE['ctx'], opts?: {
+    meta?: Record<string, unknown>;
+  } & PluginContextOptions<TE['plugins']>): TypionApp<TE, 'user'>;
+  asSystem(reason?: string, opts?: {
+    ctx?: Partial<TE['ctx']>;
+    meta?: Record<string, unknown>;
+  } & PluginContextOptions<TE['plugins']> & PluginSystemOptions<TE['plugins']>): TypionApp<TE, 'system'>;
+}
+type TestTypionOptions<TE extends TypionTypes, TInput = ContextInput> = {
+  context?: (input: TInput) => MaybePromise<TE['ctx']>;
+  onAfterCommitError?: AfterCommitErrorHandler;
+  checkSchema?: boolean;
+  now?: () => Date;
+};
+export declare function createTestTypion<const C extends TypionConfig<any>>(config: C, options?: TestTypionOptions<TypesOf<C>, ContextFactoryInput>): Promise<TestTypion<TypesOf<C>>>;
+//#endregion
+export type { TestTypion, TestTypionOptions };
+//# sourceMappingURL=index.d.ts.map

package/dist/testing/index.js

@@ -0,0 +1,92 @@
+import { r as standIn, t as createFromConfig } from "../typion-Dh2BCSRz.js";
+import { PgTable, getTableConfig } from "drizzle-orm/pg-core";
+import { is, sql } from "drizzle-orm";
+import { PGlite } from "@electric-sql/pglite";
+import { drizzle } from "drizzle-orm/pglite";
+import { randomBytes } from "node:crypto";
+import { pushSchema } from "drizzle-kit/api-postgres";
+//#region src/testing/harness.ts
+async function openDatabase(relations) {
+	const url = process.env.TYPION_TEST_DATABASE_URL;
+	if (url === void 0 || url === "") {
+		const client = new PGlite();
+		return {
+			db: drizzle({
+				client,
+				relations
+			}),
+			close: () => client.close()
+		};
+	}
+	const { default: pg } = await import("pg");
+	const { drizzle: drizzlePg } = await import("drizzle-orm/node-postgres");
+	const name = `typion_test_${randomBytes(6).toString("hex")}`;
+	const admin = async (statement) => {
+		const client = new pg.Client({ connectionString: url });
+		await client.connect();
+		try {
+			await client.query(statement);
+		} finally {
+			await client.end();
+		}
+	};
+	await admin(`create database "${name}"`);
+	const target = new URL(url);
+	target.pathname = `/${name}`;
+	const pool = new pg.Pool({
+		connectionString: target.toString(),
+		max: 3
+	});
+	return {
+		db: drizzlePg({
+			client: pool,
+			relations
+		}),
+		close: async () => {
+			await pool.end();
+			await admin(`drop database "${name}" with (force)`);
+		}
+	};
+}
+async function harness(def, create) {
+	const { db: opened, close } = await openDatabase(def.relations);
+	const db = opened;
+	const { apply } = await pushSchema(def.schema, db);
+	await apply();
+	const typion = create(db);
+	const tables = Object.values(def.schema).filter((value) => is(value, PgTable)).map((table) => {
+		const info = getTableConfig(table);
+		return `"${info.schema ?? "public"}"."${info.name}"`;
+	});
+	return {
+		typion,
+		db,
+		async reset() {
+			if (tables.length > 0) await db.execute(sql.raw(`truncate table ${tables.join(", ")} cascade`));
+		},
+		close,
+		asUser: (ctx, opts) => typion.$as(ctx, opts),
+		asSystem: (reason = "test", opts = {}) => typion.$system({
+			reason,
+			...opts
+		})
+	};
+}
+async function createTestTypion(config, options = {}) {
+	const t = await harness(config.definition, (db) => createFromConfig(config, {
+		...options,
+		db
+	}));
+	const restore = standIn(config, t.typion);
+	return {
+		...t,
+		close: async () => {
+			restore();
+			await t.close();
+		}
+	};
+}
+//#endregion
+export { createTestTypion };
+
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/testing/harness.ts"],"sourcesContent":["import { randomBytes } from 'node:crypto'\nimport { PGlite } from '@electric-sql/pglite'\nimport { pushSchema } from 'drizzle-kit/api-postgres'\nimport { type AnyRelations, is, sql } from 'drizzle-orm'\nimport {\n  getTableConfig,\n  type PgAsyncDatabase,\n  type PgQueryResultHKT,\n  PgTable,\n} from 'drizzle-orm/pg-core'\nimport { drizzle } from 'drizzle-orm/pglite'\nimport { createEngine } from '../runtime/engine.js'\nimport { createFromConfig, standIn } from '../runtime/typion.js'\nimport type {\n  AfterCommitErrorHandler,\n  ContextFactoryInput,\n  TypesOf,\n  TypionConfig,\n} from '../types/collection.js'\nimport type { ContextInput, MaybePromise } from '../types/context.js'\nimport type { TypionApp, TypionEngine, TypionTypes } from '../types/engine.js'\nimport type { PluginContextOptions, PluginSystemOptions } from '../types/kinds.js'\nimport type { TypionDefinition } from '../types/meta.js'\n\nexport interface TestTypion<TE extends TypionTypes> {\n  readonly typion: TypionEngine<TE>\n  readonly db: PgAsyncDatabase<PgQueryResultHKT, TE['relations']>\n  // Truncates every table of the definition; faster than a new database per test.\n  reset(): Promise<void>\n  close(): Promise<void>\n  asUser(\n    ctx: TE['ctx'],\n    opts?: { meta?: Record<string, unknown> } & PluginContextOptions<TE['plugins']>,\n  ): TypionApp<TE, 'user'>\n  asSystem(\n    reason?: string,\n    opts?: {\n      ctx?: Partial<TE['ctx']>\n      meta?: Record<string, unknown>\n    } & PluginContextOptions<TE['plugins']> &\n      PluginSystemOptions<TE['plugins']>,\n  ): TypionApp<TE, 'system'>\n}\n\nexport type TestTypionOptions<TE extends TypionTypes, TInput = ContextInput> = {\n  // Replaces the context factory of the config, and gets what it gets: `system` and `db` too, for a config's instance.\n  context?: (input: TInput) => MaybePromise<TE['ctx']>\n  onAfterCommitError?: AfterCommitErrorHandler\n  checkSchema?: boolean\n  // A fixed clock for timestamps the engine writes.\n  now?: () => Date\n}\n\ntype TestDatabase = {\n  db: PgAsyncDatabase<PgQueryResultHKT, AnyRelations>\n  close: () => Promise<void>\n}\n\n// `TYPION_TEST_DATABASE_URL` runs the instance on that Postgres server instead of PGlite, in a database of its\n// own, created here and dropped on close: suites run in parallel and must never share tables.\nasync function openDatabase(relations: AnyRelations): Promise<TestDatabase> {\n  const url = process.env.TYPION_TEST_DATABASE_URL\n  if (url === undefined || url === '') {\n    const client = new PGlite()\n    return { db: drizzle({ client, relations }), close: () => client.close() }\n  }\n  const { default: pg } = await import('pg')\n  const { drizzle: drizzlePg } = await import('drizzle-orm/node-postgres')\n  const name = `typion_test_${randomBytes(6).toString('hex')}`\n  const admin = async (statement: string) => {\n    const client = new pg.Client({ connectionString: url })\n    await client.connect()\n    try {\n      await client.query(statement)\n    } finally {\n      await client.end()\n    }\n  }\n  await admin(`create database \"${name}\"`)\n  const target = new URL(url)\n  target.pathname = `/${name}`\n  // Few connections each: many instances share the server's limit while the suites run in parallel.\n  const pool = new pg.Pool({ connectionString: target.toString(), max: 3 })\n  return {\n    db: drizzlePg({ client: pool, relations }),\n    close: async () => {\n      await pool.end()\n      await admin(`drop database \"${name}\" with (force)`)\n    },\n  }\n}\n\n// pushSchema diffs every schema in the database, so the complete `schema` (user, generated and plugin tables\n// plus their pg schemas) is always passed: a partial record would drop the missing tables.\nasync function harness<TE extends TypionTypes>(\n  def: TypionDefinition<TE>,\n  create: (db: TestTypion<TE>['db']) => TypionEngine<TE>,\n): Promise<TestTypion<TE>> {\n  const { db: opened, close } = await openDatabase(def.relations)\n  const db = opened as TestTypion<TE>['db']\n  const { apply } = await pushSchema(def.schema as Record<string, unknown>, db as never)\n  await apply()\n  const typion = create(db)\n  const tables = Object.values(def.schema)\n    .filter((value): value is PgTable => is(value, PgTable))\n    .map((table) => {\n      const info = getTableConfig(table)\n      return `\"${info.schema ?? 'public'}\".\"${info.name}\"`\n    })\n  return {\n    typion,\n    db,\n    async reset() {\n      if (tables.length > 0)\n        await db.execute(sql.raw(`truncate table ${tables.join(', ')} cascade`))\n    },\n    close,\n    asUser: (ctx, opts) => typion.$as(ctx, opts),\n    asSystem: (reason = 'test', opts = {} as never) => typion.$system({ reason, ...opts } as never),\n  }\n}\n\n// The instance of a config on a fresh in-memory database; the config's context factory applies unless\n// `context` replaces it. Until `close`, it is the config's instance: `getTypion(config)` returns it, so a Hono app\n// or a route handler tested with requests reads and writes the test's database.\nexport async function createTestTypion<const C extends TypionConfig<any>>(\n  config: C,\n  options: TestTypionOptions<TypesOf<C>, ContextFactoryInput> = {},\n): Promise<TestTypion<TypesOf<C>>> {\n  const t = await harness(config.definition, (db) =>\n    createFromConfig(config, { ...options, db: db as never }),\n  )\n  const restore = standIn(config, t.typion)\n  return {\n    ...t,\n    close: async () => {\n      restore()\n      await t.close()\n    },\n  } as never\n}\n\n// The same over a definition of the internal chain, for the engine's own suite.\nexport function createTestEngine<TE extends TypionTypes>(\n  def: TypionDefinition<TE>,\n  options: TestTypionOptions<TE> = {},\n): Promise<TestTypion<TE>> {\n  return harness(def, (db) => createEngine(def, { ...options, db: db as never }))\n}\n"],"mappings":";;;;;;;;AA4DA,eAAe,aAAa,WAAgD;CAC1E,MAAM,MAAM,QAAQ,IAAI;CACxB,IAAI,QAAQ,KAAA,KAAa,QAAQ,IAAI;EACnC,MAAM,SAAS,IAAI,OAAO;EAC1B,OAAO;GAAE,IAAI,QAAQ;IAAE;IAAQ;GAAU,CAAC;GAAG,aAAa,OAAO,MAAM;EAAE;CAC3E;CACA,MAAM,EAAE,SAAS,OAAO,MAAM,OAAO;CACrC,MAAM,EAAE,SAAS,cAAc,MAAM,OAAO;CAC5C,MAAM,OAAO,eAAe,YAAY,CAAC,CAAC,CAAC,SAAS,KAAK;CACzD,MAAM,QAAQ,OAAO,cAAsB;EACzC,MAAM,SAAS,IAAI,GAAG,OAAO,EAAE,kBAAkB,IAAI,CAAC;EACtD,MAAM,OAAO,QAAQ;EACrB,IAAI;GACF,MAAM,OAAO,MAAM,SAAS;EAC9B,UAAU;GACR,MAAM,OAAO,IAAI;EACnB;CACF;CACA,MAAM,MAAM,oBAAoB,KAAK,EAAE;CACvC,MAAM,SAAS,IAAI,IAAI,GAAG;CAC1B,OAAO,WAAW,IAAI;CAEtB,MAAM,OAAO,IAAI,GAAG,KAAK;EAAE,kBAAkB,OAAO,SAAS;EAAG,KAAK;CAAE,CAAC;CACxE,OAAO;EACL,IAAI,UAAU;GAAE,QAAQ;GAAM;EAAU,CAAC;EACzC,OAAO,YAAY;GACjB,MAAM,KAAK,IAAI;GACf,MAAM,MAAM,kBAAkB,KAAK,eAAe;EACpD;CACF;AACF;AAIA,eAAe,QACb,KACA,QACyB;CACzB,MAAM,EAAE,IAAI,QAAQ,UAAU,MAAM,aAAa,IAAI,SAAS;CAC9D,MAAM,KAAK;CACX,MAAM,EAAE,UAAU,MAAM,WAAW,IAAI,QAAmC,EAAW;CACrF,MAAM,MAAM;CACZ,MAAM,SAAS,OAAO,EAAE;CACxB,MAAM,SAAS,OAAO,OAAO,IAAI,MAAM,CAAC,CACrC,QAAQ,UAA4B,GAAG,OAAO,OAAO,CAAC,CAAC,CACvD,KAAK,UAAU;EACd,MAAM,OAAO,eAAe,KAAK;EACjC,OAAO,IAAI,KAAK,UAAU,SAAS,KAAK,KAAK,KAAK;CACpD,CAAC;CACH,OAAO;EACL;EACA;EACA,MAAM,QAAQ;GACZ,IAAI,OAAO,SAAS,GAClB,MAAM,GAAG,QAAQ,IAAI,IAAI,kBAAkB,OAAO,KAAK,IAAI,EAAE,SAAS,CAAC;EAC3E;EACA;EACA,SAAS,KAAK,SAAS,OAAO,IAAI,KAAK,IAAI;EAC3C,WAAW,SAAS,QAAQ,OAAO,CAAC,MAAe,OAAO,QAAQ;GAAE;GAAQ,GAAG;EAAK,CAAU;CAChG;AACF;AAKA,eAAsB,iBACpB,QACA,UAA8D,CAAC,GAC9B;CACjC,MAAM,IAAI,MAAM,QAAQ,OAAO,aAAa,OAC1C,iBAAiB,QAAQ;EAAE,GAAG;EAAa;CAAY,CAAC,CAC1D;CACA,MAAM,UAAU,QAAQ,QAAQ,EAAE,MAAM;CACxC,OAAO;EACL,GAAG;EACH,OAAO,YAAY;GACjB,QAAQ;GACR,MAAM,EAAE,MAAM;EAChB;CACF;AACF"}