@databricks/appkit 0.64.0 → 0.66.0

package/dist/database/schema-builder/columns.js

@@ -0,0 +1,162 @@
+import { SchemaBuildError } from "./types.js";
+import { columnValueSchema } from "./validators.js";
+
+//#region src/database/schema-builder/columns.ts
+const REFERENTIAL_ACTIONS = new Set([
+	"cascade",
+	"set null",
+	"set default",
+	"restrict",
+	"no action"
+]);
+const MAX_VARCHAR_LENGTH = 10485760;
+function specStorageKind(spec) {
+	return spec.kind === "fk" ? "integer" : spec.kind;
+}
+function validateVarcharLength(length) {
+	if (!Number.isInteger(length) || length < 1 || length > MAX_VARCHAR_LENGTH) throw new SchemaBuildError(`varchar() length must be an integer between 1 and ${MAX_VARCHAR_LENGTH}`);
+}
+function validateEnum(name, values) {
+	if (!name) throw new SchemaBuildError("enum() requires a name");
+	if (values.length === 0) throw new SchemaBuildError(`enum("${name}") requires at least one value`);
+	if (values.some((value) => typeof value !== "string" || value.length === 0)) throw new SchemaBuildError(`enum("${name}") values must be non-empty strings`);
+	if (new Set(values).size !== values.length) throw new SchemaBuildError(`enum("${name}") declares duplicate values`);
+	return Object.freeze([...values]);
+}
+function validateReferentialAction(action) {
+	if (!REFERENTIAL_ACTIONS.has(action)) throw new SchemaBuildError("Unsupported referential action");
+}
+function isCompatibleLiteralDefault(meta) {
+	switch (meta.storageKind) {
+		case "id":
+		case "bigid":
+		case "bigint":
+		case "jsonb": return false;
+		default: return columnValueSchema(meta).safeParse(meta.defaultValue).success;
+	}
+}
+/** FK literals wait until finalization because fk() inherits target storage. */
+function validateLiteralDefaults(tables) {
+	for (const table of tables) for (const meta of Object.values(table.metas)) if (Object.hasOwn(meta, "defaultValue") && !isCompatibleLiteralDefault(meta)) throw new SchemaBuildError(`Default for column "${table.name}.${meta.columnName}" is not compatible with ${meta.storageKind} storage`);
+}
+/** Mutable DSL builder; table() clones its metadata before finalization. */
+var ColumnBuilder = class {
+	/** @internal */ _meta;
+	declarationKind;
+	constructor(spec, kind) {
+		this.declarationKind = spec.kind;
+		const enumValues = spec.kind === "enum" ? validateEnum(spec.enumName, spec.values) : void 0;
+		const serverGenerated = spec.kind === "id" || spec.kind === "bigid";
+		this._meta = {
+			name: "",
+			columnName: "",
+			kind,
+			storageKind: specStorageKind(spec),
+			notNull: serverGenerated,
+			primaryKey: serverGenerated,
+			unique: false,
+			isPrivate: false,
+			serverGenerated,
+			hasDefault: serverGenerated,
+			withTimezone: spec.kind === "timestamp" ? spec.withTimezone : void 0,
+			varcharLength: spec.kind === "varchar" ? spec.length : void 0,
+			enumName: spec.kind === "enum" ? spec.enumName : void 0,
+			enumValues
+		};
+	}
+	/** @internal Clone declaration state so builder reuse cannot mutate a table. */
+	_cloneMeta() {
+		return {
+			...this._meta,
+			enumValues: this._meta.enumValues ? Object.freeze([...this._meta.enumValues]) : void 0,
+			fk: this._meta.fk ? { ...this._meta.fk } : void 0
+		};
+	}
+	notNull() {
+		this._meta.notNull = true;
+		return this;
+	}
+	primaryKey() {
+		this._meta.primaryKey = true;
+		this._meta.notNull = true;
+		return this;
+	}
+	unique() {
+		this._meta.unique = true;
+		return this;
+	}
+	private() {
+		this._meta.isPrivate = true;
+		return this;
+	}
+	default(value) {
+		this.requireNoDefault();
+		this._meta.hasDefault = true;
+		this._meta.defaultValue = value;
+		return this;
+	}
+	defaultNow() {
+		this.requireNoDefault();
+		if (this.declarationKind !== "timestamp") throw new SchemaBuildError(".defaultNow() is only valid on timestamp columns");
+		this._meta.hasDefault = true;
+		this._meta.defaultNow = true;
+		return this;
+	}
+	defaultRandom() {
+		this.requireNoDefault();
+		if (this.declarationKind !== "uuid") throw new SchemaBuildError(".defaultRandom() is only valid on uuid columns");
+		this._meta.hasDefault = true;
+		this._meta.defaultRandom = true;
+		return this;
+	}
+	onDelete(action) {
+		this.requireFk("onDelete");
+		validateReferentialAction(action);
+		this._meta.onDelete = action;
+		return this;
+	}
+	onUpdate(action) {
+		this.requireFk("onUpdate");
+		validateReferentialAction(action);
+		this._meta.onUpdate = action;
+		return this;
+	}
+	requireNoDefault() {
+		if (this._meta.hasDefault) throw new SchemaBuildError("A column may declare only one default mode");
+	}
+	requireFk(modifier) {
+		if (this.declarationKind !== "fk") throw new SchemaBuildError(`.${modifier}() is only valid on fk() columns`);
+	}
+};
+const id = () => new ColumnBuilder({ kind: "id" }, "number");
+const bigid = () => new ColumnBuilder({ kind: "bigid" }, "bigint");
+const text = () => new ColumnBuilder({ kind: "text" }, "string");
+const varchar = (length = 255) => {
+	validateVarcharLength(length);
+	return new ColumnBuilder({
+		kind: "varchar",
+		length
+	}, "string");
+};
+const integer = () => new ColumnBuilder({ kind: "integer" }, "number");
+const bigint = () => new ColumnBuilder({ kind: "bigint" }, "bigint");
+const boolean = () => new ColumnBuilder({ kind: "boolean" }, "boolean");
+const uuid = () => new ColumnBuilder({ kind: "uuid" }, "uuid");
+const timestamp = (opts) => {
+	return new ColumnBuilder({
+		kind: "timestamp",
+		withTimezone: opts?.withTimezone ?? false
+	}, "date");
+};
+const jsonb = () => new ColumnBuilder({ kind: "jsonb" }, "json");
+function enumColumn(name, values) {
+	return new ColumnBuilder({
+		kind: "enum",
+		enumName: name,
+		values
+	}, "enum");
+}
+
+//#endregion
+export { ColumnBuilder, bigid, bigint, boolean, enumColumn, id, integer, jsonb, text, timestamp, uuid, validateLiteralDefaults, varchar };
+//# sourceMappingURL=columns.js.map

package/dist/database/schema-builder/columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.js","names":[],"sources":["../../../src/database/schema-builder/columns.ts"],"sourcesContent":["import {\n  type ColumnTypeSpec,\n  type ColumnValueKind,\n  type MutableColumnMeta,\n  type ReferentialAction,\n  SchemaBuildError,\n  type StorageKind,\n} from \"./types\";\nimport { columnValueSchema } from \"./validators\";\n\nconst REFERENTIAL_ACTIONS = new Set<ReferentialAction>([\n  \"cascade\",\n  \"set null\",\n  \"set default\",\n  \"restrict\",\n  \"no action\",\n]);\nconst MAX_VARCHAR_LENGTH = 10_485_760;\n\nfunction specStorageKind(spec: ColumnTypeSpec): StorageKind {\n  return spec.kind === \"fk\" ? \"integer\" : spec.kind;\n}\n\nfunction validateVarcharLength(length: number): void {\n  if (!Number.isInteger(length) || length < 1 || length > MAX_VARCHAR_LENGTH) {\n    throw new SchemaBuildError(\n      `varchar() length must be an integer between 1 and ${MAX_VARCHAR_LENGTH}`,\n    );\n  }\n}\n\nfunction validateEnum(\n  name: string,\n  values: readonly string[],\n): readonly string[] {\n  if (!name) throw new SchemaBuildError(\"enum() requires a name\");\n  if (values.length === 0) {\n    throw new SchemaBuildError(`enum(\"${name}\") requires at least one value`);\n  }\n  if (values.some((value) => typeof value !== \"string\" || value.length === 0)) {\n    throw new SchemaBuildError(\n      `enum(\"${name}\") values must be non-empty strings`,\n    );\n  }\n  if (new Set(values).size !== values.length) {\n    throw new SchemaBuildError(`enum(\"${name}\") declares duplicate values`);\n  }\n  return Object.freeze([...values]);\n}\n\nfunction validateReferentialAction(action: ReferentialAction): void {\n  if (!REFERENTIAL_ACTIONS.has(action)) {\n    throw new SchemaBuildError(\"Unsupported referential action\");\n  }\n}\n\ninterface DefaultValidationTable {\n  readonly name: string;\n  readonly metas: Readonly<Record<string, MutableColumnMeta>>;\n}\n\nfunction isCompatibleLiteralDefault(meta: MutableColumnMeta): boolean {\n  switch (meta.storageKind) {\n    case \"id\":\n    case \"bigid\":\n    case \"bigint\":\n    case \"jsonb\":\n      return false;\n    default:\n      return columnValueSchema(meta).safeParse(meta.defaultValue).success;\n  }\n}\n\n/** FK literals wait until finalization because fk() inherits target storage. */\nexport function validateLiteralDefaults(\n  tables: Iterable<DefaultValidationTable>,\n): void {\n  for (const table of tables) {\n    for (const meta of Object.values(table.metas)) {\n      if (\n        Object.hasOwn(meta, \"defaultValue\") &&\n        !isCompatibleLiteralDefault(meta)\n      ) {\n        throw new SchemaBuildError(\n          `Default for column \"${table.name}.${meta.columnName}\" is not compatible with ${meta.storageKind} storage`,\n        );\n      }\n    }\n  }\n}\n\n/** Mutable DSL builder; table() clones its metadata before finalization. */\nexport class ColumnBuilder {\n  /** @internal */ readonly _meta: MutableColumnMeta;\n  private readonly declarationKind: ColumnTypeSpec[\"kind\"];\n\n  constructor(spec: ColumnTypeSpec, kind: ColumnValueKind) {\n    this.declarationKind = spec.kind;\n    const enumValues =\n      spec.kind === \"enum\"\n        ? validateEnum(spec.enumName, spec.values)\n        : undefined;\n\n    const serverGenerated = spec.kind === \"id\" || spec.kind === \"bigid\";\n    this._meta = {\n      name: \"\",\n      columnName: \"\",\n      kind,\n      storageKind: specStorageKind(spec),\n      notNull: serverGenerated,\n      primaryKey: serverGenerated,\n      unique: false,\n      isPrivate: false,\n      serverGenerated,\n      hasDefault: serverGenerated,\n      withTimezone: spec.kind === \"timestamp\" ? spec.withTimezone : undefined,\n      varcharLength: spec.kind === \"varchar\" ? spec.length : undefined,\n      enumName: spec.kind === \"enum\" ? spec.enumName : undefined,\n      enumValues,\n    };\n  }\n\n  /** @internal Clone declaration state so builder reuse cannot mutate a table. */\n  _cloneMeta(): MutableColumnMeta {\n    return {\n      ...this._meta,\n      enumValues: this._meta.enumValues\n        ? Object.freeze([...this._meta.enumValues])\n        : undefined,\n      fk: this._meta.fk ? { ...this._meta.fk } : undefined,\n    };\n  }\n\n  notNull(): this {\n    this._meta.notNull = true;\n    return this;\n  }\n\n  primaryKey(): this {\n    this._meta.primaryKey = true;\n    this._meta.notNull = true;\n    return this;\n  }\n\n  unique(): this {\n    this._meta.unique = true;\n    return this;\n  }\n\n  private(): this {\n    this._meta.isPrivate = true;\n    return this;\n  }\n\n  default(value: string | number | boolean): this {\n    this.requireNoDefault();\n    this._meta.hasDefault = true;\n    this._meta.defaultValue = value;\n    return this;\n  }\n\n  defaultNow(): this {\n    this.requireNoDefault();\n    if (this.declarationKind !== \"timestamp\") {\n      throw new SchemaBuildError(\n        \".defaultNow() is only valid on timestamp columns\",\n      );\n    }\n    this._meta.hasDefault = true;\n    this._meta.defaultNow = true;\n    return this;\n  }\n\n  defaultRandom(): this {\n    this.requireNoDefault();\n    if (this.declarationKind !== \"uuid\") {\n      throw new SchemaBuildError(\n        \".defaultRandom() is only valid on uuid columns\",\n      );\n    }\n    this._meta.hasDefault = true;\n    this._meta.defaultRandom = true;\n    return this;\n  }\n\n  onDelete(action: ReferentialAction): this {\n    this.requireFk(\"onDelete\");\n    validateReferentialAction(action);\n    this._meta.onDelete = action;\n    return this;\n  }\n\n  onUpdate(action: ReferentialAction): this {\n    this.requireFk(\"onUpdate\");\n    validateReferentialAction(action);\n    this._meta.onUpdate = action;\n    return this;\n  }\n\n  private requireNoDefault(): void {\n    if (this._meta.hasDefault) {\n      throw new SchemaBuildError(\"A column may declare only one default mode\");\n    }\n  }\n\n  private requireFk(modifier: string): void {\n    if (this.declarationKind !== \"fk\") {\n      throw new SchemaBuildError(\n        `.${modifier}() is only valid on fk() columns`,\n      );\n    }\n  }\n}\n\nexport const id = () => new ColumnBuilder({ kind: \"id\" }, \"number\");\nexport const bigid = () => new ColumnBuilder({ kind: \"bigid\" }, \"bigint\");\nexport const text = () => new ColumnBuilder({ kind: \"text\" }, \"string\");\nexport const varchar = (length = 255) => {\n  validateVarcharLength(length);\n  return new ColumnBuilder({ kind: \"varchar\", length }, \"string\");\n};\nexport const integer = () => new ColumnBuilder({ kind: \"integer\" }, \"number\");\nexport const bigint = () => new ColumnBuilder({ kind: \"bigint\" }, \"bigint\");\nexport const boolean = () => new ColumnBuilder({ kind: \"boolean\" }, \"boolean\");\nexport const uuid = () => new ColumnBuilder({ kind: \"uuid\" }, \"uuid\");\nexport const timestamp = (opts?: { withTimezone?: boolean }) => {\n  const withTimezone = opts?.withTimezone ?? false;\n  return new ColumnBuilder({ kind: \"timestamp\", withTimezone }, \"date\");\n};\nexport const jsonb = () => new ColumnBuilder({ kind: \"jsonb\" }, \"json\");\n\nexport function enumColumn(name: string, values: readonly string[]) {\n  return new ColumnBuilder({ kind: \"enum\", enumName: name, values }, \"enum\");\n}\n"],"mappings":"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"}

package/dist/database/schema-builder/define-schema.d.ts

@@ -0,0 +1,12 @@
+import { AppKitTable, DefineSchemaOptions, Schema, TableHandle } from "./types.js";
+import { ColumnBuilder } from "./columns.js";
+
+//#region src/database/schema-builder/define-schema.d.ts
+interface SchemaBuilderContext {
+  table<C extends Record<string, ColumnBuilder>>(name: string, columns: C): TableHandle<C>;
+  enum(name: string, values: readonly string[]): ColumnBuilder;
+}
+declare function defineSchema(builder: (context: SchemaBuilderContext) => Record<string, AppKitTable>, options?: DefineSchemaOptions): Schema;
+//#endregion
+export { defineSchema };
+//# sourceMappingURL=define-schema.d.ts.map

package/dist/database/schema-builder/define-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-schema.d.ts","names":[],"sources":["../../../src/database/schema-builder/define-schema.ts"],"mappings":";;;;UAoCiB,oBAAA;EACf,KAAA,WAAgB,MAAA,SAAe,aAAA,GAC7B,IAAA,UACA,OAAA,EAAS,CAAA,GACR,WAAA,CAAY,CAAA;EACf,IAAA,CAAK,IAAA,UAAc,MAAA,sBAA4B,aAAA;AAAA;AAAA,iBA4SjC,YAAA,CACd,OAAA,GAAU,OAAA,EAAS,oBAAA,KAAyB,MAAA,SAAe,WAAA,GAC3D,OAAA,GAAU,mBAAA,GACT,MAAA"}

package/dist/database/schema-builder/define-schema.js

@@ -0,0 +1,207 @@
+import { SchemaBuildError } from "./types.js";
+import { deriveInsertSchema, deriveUpdateSchema } from "./validators.js";
+import { ColumnBuilder, enumColumn, validateLiteralDefaults } from "./columns.js";
+import { buildEngineTables } from "./engine/tables.js";
+import { resolveForeignKeys } from "./fk.js";
+import { buildRelations } from "./relations.js";
+
+//#region src/database/schema-builder/define-schema.ts
+const RESERVED_OBJECT_KEYS = new Set([
+	"__proto__",
+	"prototype",
+	"constructor"
+]);
+const RESERVED_DATABASE_EXPORT_KEYS = new Set(["sql", "transaction"]);
+const FINALIZED_SCHEMA = Symbol.for("@databricks/appkit.database.schema");
+const TABLE_METADATA_KEYS = [
+	"$name",
+	"$schemaName",
+	"$columns",
+	"$engine",
+	"$relations",
+	"$insertSchema",
+	"$updateSchema"
+];
+function nullRecord() {
+	return Object.create(null);
+}
+function assertRecord(value, label) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) throw new SchemaBuildError(`${label} must be an object`);
+}
+function assertName(value, label) {
+	if (!value || RESERVED_OBJECT_KEYS.has(value)) throw new SchemaBuildError(`${label} "${value}" is reserved`);
+}
+function assertTableName(value) {
+	assertName(value, "Table name");
+	if (RESERVED_DATABASE_EXPORT_KEYS.has(value)) throw new SchemaBuildError(`Table name "${value}" is reserved`);
+}
+function finalizeColumn(meta) {
+	if (!meta.engineColumn) throw new SchemaBuildError(`Engine column "${meta.columnName}" is missing during finalization`);
+	const { fkRef: _fkRef, ...published } = meta;
+	return Object.freeze({
+		...published,
+		enumValues: meta.enumValues ? Object.freeze([...meta.enumValues]) : void 0,
+		fk: meta.fk ? Object.freeze({ ...meta.fk }) : void 0,
+		engineColumn: meta.engineColumn
+	});
+}
+function finalizeRelations(relations) {
+	return Object.freeze(relations.map((relation) => Object.freeze({ ...relation })));
+}
+/** Clone builders into per-table metadata and create stable column handles. */
+function declareTable(state, name, columns) {
+	assertTableName(name);
+	if (state.raw.has(name)) throw new SchemaBuildError(`Duplicate table "${name}"`);
+	assertRecord(columns, `Columns for table "${name}"`);
+	const metas = nullRecord();
+	const handle = Object.create(null);
+	for (const [key, column] of Object.entries(columns)) {
+		assertName(key, `Column name on table "${name}"`);
+		if (key.startsWith("$") || key === "and" || key === "or") throw new SchemaBuildError(`Column "${name}.${key}" collides with AppKit runtime metadata`);
+		if (!(column instanceof ColumnBuilder)) throw new SchemaBuildError(`Column "${name}.${key}" was not created by an AppKit column builder`);
+		const meta = column._cloneMeta();
+		meta.name = key;
+		meta.columnName = key;
+		metas[key] = meta;
+		const reference = Object.freeze({
+			__isColumnRef: true,
+			tableName: name,
+			columnName: key
+		});
+		Object.defineProperty(handle, key, {
+			enumerable: true,
+			value: reference
+		});
+	}
+	state.raw.set(name, {
+		name,
+		metas,
+		handle
+	});
+	state.handleNames.set(handle, name);
+	return handle;
+}
+function createBuilderContext(state) {
+	return {
+		table(name, columns) {
+			return declareTable(state, name, columns);
+		},
+		enum(name, values) {
+			return enumColumn(name, values);
+		}
+	};
+}
+/** Require every exact table handle once under its declared identity. */
+function validateReturnedTables(returned, state) {
+	assertRecord(returned, "defineSchema() return value");
+	const returnedHandles = /* @__PURE__ */ new Set();
+	for (const [key, value] of Object.entries(returned)) {
+		const name = value !== null && typeof value === "object" ? state.handleNames.get(value) : void 0;
+		if (!name) throw new SchemaBuildError(`defineSchema returned a value for "${key}" that was not produced by ctx.table()`);
+		if (key !== name) throw new SchemaBuildError(`defineSchema returned table "${name}" under key "${key}"; aliases are not supported`);
+		if (returnedHandles.has(value)) throw new SchemaBuildError(`Table "${name}" was returned more than once`);
+		returnedHandles.add(value);
+	}
+	if (returnedHandles.size !== state.raw.size) {
+		const omitted = [...state.raw.values()].filter((table) => !returnedHandles.has(table.handle)).map((table) => table.name);
+		throw new SchemaBuildError(`defineSchema omitted declared table${omitted.length === 1 ? "" : "s"}: ${omitted.join(", ")}`);
+	}
+}
+/** Detect declaration-handle tampering before metadata publication. */
+function validateHandles(raw) {
+	for (const table of raw.values()) {
+		const ownKeys = Reflect.ownKeys(table.handle);
+		const hasOnlyDeclaredColumns = ownKeys.length === Object.keys(table.metas).length && ownKeys.every((key) => typeof key === "string" && Object.hasOwn(table.metas, key));
+		const hasMetadataCollision = TABLE_METADATA_KEYS.some((key) => Object.hasOwn(table.handle, key));
+		if (Object.getPrototypeOf(table.handle) !== null || !Object.isExtensible(table.handle) || !hasOnlyDeclaredColumns || hasMetadataCollision) throw new SchemaBuildError(`Table handle "${table.name}" was modified during schema declaration`);
+	}
+}
+/** Reject composite primary keys, which keyed operations cannot represent. */
+function validatePrimaryKeys(raw) {
+	for (const table of raw.values()) if (Object.values(table.metas).filter((meta) => meta.primaryKey).length > 1) throw new SchemaBuildError(`Table "${table.name}" declares multiple primary-key columns; composite primary keys are not supported`);
+}
+/** Reject table names that collide with generated Drizzle relation keys. */
+function validateRelationKeys(raw, relations) {
+	for (const [name, tableRelations] of relations) if (tableRelations.length > 0 && raw.has(`${name}Relations`)) throw new SchemaBuildError(`Table "${name}Relations" collides with generated relation metadata for "${name}"`);
+}
+/** Prepare every engine object and validator without mutating handles. */
+function prepareTables(raw, schemaName, relations) {
+	const built = buildEngineTables(raw.values(), schemaName);
+	const candidates = /* @__PURE__ */ new Map();
+	for (const table of raw.values()) {
+		const builtTable = built.get(table.name);
+		if (!builtTable) throw new SchemaBuildError(`Engine table "${table.name}" was not constructed`);
+		const columns = nullRecord();
+		for (const [key, meta] of Object.entries(builtTable.columns)) columns[key] = finalizeColumn(meta);
+		Object.freeze(columns);
+		const tableRelations = finalizeRelations(relations.get(table.name) ?? []);
+		const validatorTable = { $columns: columns };
+		candidates.set(table.name, {
+			columns,
+			engine: builtTable.engine,
+			relations: tableRelations,
+			insertSchema: deriveInsertSchema(validatorTable),
+			updateSchema: deriveUpdateSchema(validatorTable)
+		});
+	}
+	return candidates;
+}
+/** Atomically publish prepared metadata as the final schema transition. */
+function publishSchema(raw, candidates, schemaName) {
+	const publications = [...raw.values()].map((table) => {
+		const candidate = candidates.get(table.name);
+		if (!candidate) throw new SchemaBuildError(`Table "${table.name}" was not prepared for finalization`);
+		return {
+			table,
+			candidate
+		};
+	});
+	const tables = nullRecord();
+	const engine = nullRecord();
+	for (const { table, candidate } of publications) {
+		Object.defineProperties(table.handle, {
+			$name: { value: table.name },
+			$schemaName: { value: schemaName },
+			$columns: { value: candidate.columns },
+			$engine: { value: candidate.engine },
+			$relations: { value: candidate.relations },
+			$insertSchema: { value: candidate.insertSchema },
+			$updateSchema: { value: candidate.updateSchema }
+		});
+		const finalized = Object.freeze(table.handle);
+		tables[table.name] = finalized;
+		engine[table.name] = candidate.engine;
+	}
+	const schema = {
+		$schemaName: schemaName,
+		$tables: Object.freeze(tables),
+		$engine: Object.freeze(engine)
+	};
+	Object.defineProperty(schema, FINALIZED_SCHEMA, { value: true });
+	return Object.freeze(schema);
+}
+/** @internal Reject values that were not finalized by `defineSchema()`. */
+function assertFinalizedSchema(value) {
+	if (value === null || typeof value !== "object" || value[FINALIZED_SCHEMA] !== true) throw new TypeError("Expected a finalized AppKit database schema");
+}
+function defineSchema(builder, options) {
+	const schemaName = options?.schemaName ?? "public";
+	if (!schemaName) throw new SchemaBuildError("Schema name cannot be empty");
+	const state = {
+		raw: /* @__PURE__ */ new Map(),
+		handleNames: /* @__PURE__ */ new Map()
+	};
+	validateReturnedTables(builder(createBuilderContext(state)), state);
+	validateHandles(state.raw);
+	validatePrimaryKeys(state.raw);
+	resolveForeignKeys(state.raw);
+	validateLiteralDefaults(state.raw.values());
+	const relations = buildRelations(state.raw);
+	validateRelationKeys(state.raw, relations);
+	const candidates = prepareTables(state.raw, schemaName, relations);
+	return publishSchema(state.raw, candidates, schemaName);
+}
+
+//#endregion
+export { assertFinalizedSchema, defineSchema };
+//# sourceMappingURL=define-schema.js.map

package/dist/database/schema-builder/define-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-schema.js","names":[],"sources":["../../../src/database/schema-builder/define-schema.ts"],"sourcesContent":["import { ColumnBuilder, enumColumn, validateLiteralDefaults } from \"./columns\";\nimport { buildEngineTables } from \"./engine/tables\";\nimport { resolveForeignKeys } from \"./fk\";\nimport { buildRelations } from \"./relations\";\nimport {\n  type AppKitTable,\n  type ColumnMeta,\n  type ColumnRef,\n  type DefineSchemaOptions,\n  type MutableColumnMeta,\n  type ResolvedRelation,\n  type Schema,\n  SchemaBuildError,\n  type TableHandle,\n} from \"./types\";\nimport { deriveInsertSchema, deriveUpdateSchema } from \"./validators\";\n\ninterface RawTable {\n  readonly name: string;\n  readonly metas: Record<string, MutableColumnMeta>;\n  readonly handle: Record<string, ColumnRef>;\n}\n\ninterface FinalizedTableCandidate {\n  readonly columns: Readonly<Record<string, ColumnMeta>>;\n  readonly engine: Schema[\"$engine\"][string];\n  readonly relations: readonly ResolvedRelation[];\n  readonly insertSchema: unknown;\n  readonly updateSchema: unknown;\n}\n\ninterface DeclarationState {\n  readonly raw: Map<string, RawTable>;\n  readonly handleNames: Map<object, string>;\n}\n\nexport interface SchemaBuilderContext {\n  table<C extends Record<string, ColumnBuilder>>(\n    name: string,\n    columns: C,\n  ): TableHandle<C>;\n  enum(name: string, values: readonly string[]): ColumnBuilder;\n}\n\nconst RESERVED_OBJECT_KEYS = new Set([\"__proto__\", \"prototype\", \"constructor\"]);\nconst RESERVED_DATABASE_EXPORT_KEYS = new Set([\"sql\", \"transaction\"]);\n// A global symbol lets typegen recognize schemas loaded through another AppKit instance.\nconst FINALIZED_SCHEMA = Symbol.for(\"@databricks/appkit.database.schema\");\nconst TABLE_METADATA_KEYS = [\n  \"$name\",\n  \"$schemaName\",\n  \"$columns\",\n  \"$engine\",\n  \"$relations\",\n  \"$insertSchema\",\n  \"$updateSchema\",\n] as const;\n\nfunction nullRecord<T>(): Record<string, T> {\n  return Object.create(null) as Record<string, T>;\n}\n\nfunction assertRecord(value: unknown, label: string): asserts value is object {\n  if (value === null || typeof value !== \"object\" || Array.isArray(value)) {\n    throw new SchemaBuildError(`${label} must be an object`);\n  }\n}\n\nfunction assertName(value: string, label: string): void {\n  if (!value || RESERVED_OBJECT_KEYS.has(value)) {\n    throw new SchemaBuildError(`${label} \"${value}\" is reserved`);\n  }\n}\n\nfunction assertTableName(value: string): void {\n  assertName(value, \"Table name\");\n  if (RESERVED_DATABASE_EXPORT_KEYS.has(value)) {\n    throw new SchemaBuildError(`Table name \"${value}\" is reserved`);\n  }\n}\n\nfunction finalizeColumn(meta: MutableColumnMeta): ColumnMeta {\n  if (!meta.engineColumn) {\n    throw new SchemaBuildError(\n      `Engine column \"${meta.columnName}\" is missing during finalization`,\n    );\n  }\n  const { fkRef: _fkRef, ...published } = meta;\n  return Object.freeze({\n    ...published,\n    enumValues: meta.enumValues\n      ? Object.freeze([...meta.enumValues])\n      : undefined,\n    fk: meta.fk ? Object.freeze({ ...meta.fk }) : undefined,\n    engineColumn: meta.engineColumn,\n  }) as ColumnMeta;\n}\n\nfunction finalizeRelations(\n  relations: readonly ResolvedRelation[],\n): readonly ResolvedRelation[] {\n  return Object.freeze(\n    relations.map((relation) => Object.freeze({ ...relation })),\n  );\n}\n\n/** Clone builders into per-table metadata and create stable column handles. */\nfunction declareTable<C extends Record<string, ColumnBuilder>>(\n  state: DeclarationState,\n  name: string,\n  columns: C,\n): TableHandle<C> {\n  assertTableName(name);\n  if (state.raw.has(name)) {\n    throw new SchemaBuildError(`Duplicate table \"${name}\"`);\n  }\n  assertRecord(columns, `Columns for table \"${name}\"`);\n\n  const metas = nullRecord<MutableColumnMeta>();\n  const handle = Object.create(null) as Record<string, ColumnRef>;\n  for (const [key, column] of Object.entries(columns)) {\n    assertName(key, `Column name on table \"${name}\"`);\n    if (key.startsWith(\"$\") || key === \"and\" || key === \"or\") {\n      throw new SchemaBuildError(\n        `Column \"${name}.${key}\" collides with AppKit runtime metadata`,\n      );\n    }\n    if (!(column instanceof ColumnBuilder)) {\n      throw new SchemaBuildError(\n        `Column \"${name}.${key}\" was not created by an AppKit column builder`,\n      );\n    }\n\n    const meta = column._cloneMeta();\n    meta.name = key;\n    meta.columnName = key;\n    metas[key] = meta;\n\n    const reference: ColumnRef = Object.freeze({\n      __isColumnRef: true,\n      tableName: name,\n      columnName: key,\n    });\n    Object.defineProperty(handle, key, {\n      enumerable: true,\n      value: reference,\n    });\n  }\n\n  state.raw.set(name, { name, metas, handle });\n  state.handleNames.set(handle, name);\n  return handle as unknown as TableHandle<C>;\n}\n\nfunction createBuilderContext(state: DeclarationState): SchemaBuilderContext {\n  return {\n    table(name, columns) {\n      return declareTable(state, name, columns);\n    },\n    enum(name, values) {\n      return enumColumn(name, values);\n    },\n  };\n}\n\n/** Require every exact table handle once under its declared identity. */\nfunction validateReturnedTables(\n  returned: unknown,\n  state: DeclarationState,\n): void {\n  assertRecord(returned, \"defineSchema() return value\");\n  const returnedHandles = new Set<object>();\n  for (const [key, value] of Object.entries(returned)) {\n    const name =\n      value !== null && typeof value === \"object\"\n        ? state.handleNames.get(value)\n        : undefined;\n    if (!name) {\n      throw new SchemaBuildError(\n        `defineSchema returned a value for \"${key}\" that was not produced by ctx.table()`,\n      );\n    }\n    if (key !== name) {\n      throw new SchemaBuildError(\n        `defineSchema returned table \"${name}\" under key \"${key}\"; aliases are not supported`,\n      );\n    }\n    if (returnedHandles.has(value)) {\n      throw new SchemaBuildError(`Table \"${name}\" was returned more than once`);\n    }\n    returnedHandles.add(value);\n  }\n  if (returnedHandles.size !== state.raw.size) {\n    const omitted = [...state.raw.values()]\n      .filter((table) => !returnedHandles.has(table.handle))\n      .map((table) => table.name);\n    throw new SchemaBuildError(\n      `defineSchema omitted declared table${omitted.length === 1 ? \"\" : \"s\"}: ${omitted.join(\", \")}`,\n    );\n  }\n}\n\n/** Detect declaration-handle tampering before metadata publication. */\nfunction validateHandles(raw: ReadonlyMap<string, RawTable>): void {\n  for (const table of raw.values()) {\n    const ownKeys = Reflect.ownKeys(table.handle);\n    const hasOnlyDeclaredColumns =\n      ownKeys.length === Object.keys(table.metas).length &&\n      ownKeys.every(\n        (key) => typeof key === \"string\" && Object.hasOwn(table.metas, key),\n      );\n    const hasMetadataCollision = TABLE_METADATA_KEYS.some((key) =>\n      Object.hasOwn(table.handle, key),\n    );\n    if (\n      Object.getPrototypeOf(table.handle) !== null ||\n      !Object.isExtensible(table.handle) ||\n      !hasOnlyDeclaredColumns ||\n      hasMetadataCollision\n    ) {\n      throw new SchemaBuildError(\n        `Table handle \"${table.name}\" was modified during schema declaration`,\n      );\n    }\n  }\n}\n\n/** Reject composite primary keys, which keyed operations cannot represent. */\nfunction validatePrimaryKeys(raw: ReadonlyMap<string, RawTable>): void {\n  for (const table of raw.values()) {\n    const primaryKeys = Object.values(table.metas).filter(\n      (meta) => meta.primaryKey,\n    );\n    if (primaryKeys.length > 1) {\n      throw new SchemaBuildError(\n        `Table \"${table.name}\" declares multiple primary-key columns; composite primary keys are not supported`,\n      );\n    }\n  }\n}\n\n/** Reject table names that collide with generated Drizzle relation keys. */\nfunction validateRelationKeys(\n  raw: ReadonlyMap<string, RawTable>,\n  relations: ReadonlyMap<string, readonly ResolvedRelation[]>,\n): void {\n  for (const [name, tableRelations] of relations) {\n    if (tableRelations.length > 0 && raw.has(`${name}Relations`)) {\n      throw new SchemaBuildError(\n        `Table \"${name}Relations\" collides with generated relation metadata for \"${name}\"`,\n      );\n    }\n  }\n}\n\n/** Prepare every engine object and validator without mutating handles. */\nfunction prepareTables(\n  raw: ReadonlyMap<string, RawTable>,\n  schemaName: string,\n  relations: ReadonlyMap<string, readonly ResolvedRelation[]>,\n): Map<string, FinalizedTableCandidate> {\n  const built = buildEngineTables(raw.values(), schemaName);\n  const candidates = new Map<string, FinalizedTableCandidate>();\n  for (const table of raw.values()) {\n    const builtTable = built.get(table.name);\n    if (!builtTable) {\n      throw new SchemaBuildError(\n        `Engine table \"${table.name}\" was not constructed`,\n      );\n    }\n    const columns = nullRecord<ColumnMeta>();\n    for (const [key, meta] of Object.entries(builtTable.columns)) {\n      columns[key] = finalizeColumn(meta);\n    }\n    Object.freeze(columns);\n    const tableRelations = finalizeRelations(relations.get(table.name) ?? []);\n    const validatorTable = { $columns: columns } as AppKitTable;\n    candidates.set(table.name, {\n      columns,\n      engine: builtTable.engine,\n      relations: tableRelations,\n      insertSchema: deriveInsertSchema(validatorTable),\n      updateSchema: deriveUpdateSchema(validatorTable),\n    });\n  }\n  return candidates;\n}\n\n/** Atomically publish prepared metadata as the final schema transition. */\nfunction publishSchema(\n  raw: ReadonlyMap<string, RawTable>,\n  candidates: ReadonlyMap<string, FinalizedTableCandidate>,\n  schemaName: string,\n): Schema {\n  const publications = [...raw.values()].map((table) => {\n    const candidate = candidates.get(table.name);\n    if (!candidate) {\n      throw new SchemaBuildError(\n        `Table \"${table.name}\" was not prepared for finalization`,\n      );\n    }\n    return { table, candidate };\n  });\n\n  const tables = nullRecord<AppKitTable>();\n  const engine = nullRecord<Schema[\"$engine\"][string]>();\n  for (const { table, candidate } of publications) {\n    Object.defineProperties(table.handle, {\n      $name: { value: table.name },\n      $schemaName: { value: schemaName },\n      $columns: { value: candidate.columns },\n      $engine: { value: candidate.engine },\n      $relations: { value: candidate.relations },\n      $insertSchema: { value: candidate.insertSchema },\n      $updateSchema: { value: candidate.updateSchema },\n    });\n    const finalized = Object.freeze(table.handle) as unknown as AppKitTable;\n    tables[table.name] = finalized;\n    engine[table.name] = candidate.engine;\n  }\n\n  const schema = {\n    $schemaName: schemaName,\n    $tables: Object.freeze(tables),\n    $engine: Object.freeze(engine),\n  };\n  Object.defineProperty(schema, FINALIZED_SCHEMA, { value: true });\n  return Object.freeze(schema);\n}\n\n/** @internal Reject values that were not finalized by `defineSchema()`. */\nexport function assertFinalizedSchema(value: unknown): asserts value is Schema {\n  if (\n    value === null ||\n    typeof value !== \"object\" ||\n    (value as Record<PropertyKey, unknown>)[FINALIZED_SCHEMA] !== true\n  ) {\n    throw new TypeError(\"Expected a finalized AppKit database schema\");\n  }\n}\n\nexport function defineSchema(\n  builder: (context: SchemaBuilderContext) => Record<string, AppKitTable>,\n  options?: DefineSchemaOptions,\n): Schema {\n  const schemaName = options?.schemaName ?? \"public\";\n  if (!schemaName) throw new SchemaBuildError(\"Schema name cannot be empty\");\n\n  const state: DeclarationState = {\n    raw: new Map(),\n    handleNames: new Map(),\n  };\n  const returned = builder(createBuilderContext(state));\n\n  validateReturnedTables(returned, state);\n  validateHandles(state.raw);\n  validatePrimaryKeys(state.raw);\n  resolveForeignKeys(state.raw);\n  // FK literals are checked against the inherited target storage, not the placeholder.\n  validateLiteralDefaults(state.raw.values());\n\n  const relations = buildRelations(state.raw);\n  validateRelationKeys(state.raw, relations);\n  const candidates = prepareTables(state.raw, schemaName, relations);\n  return publishSchema(state.raw, candidates, schemaName);\n}\n"],"mappings":"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"}

package/dist/database/schema-builder/engine/relations.js

@@ -0,0 +1,37 @@
+import { SchemaBuildError } from "../types.js";
+import { relations } from "drizzle-orm";
+
+//#region src/database/schema-builder/engine/relations.ts
+function columnOf(table, name) {
+	const column = table.$columns[name]?.engineColumn;
+	if (!column) throw new SchemaBuildError(`Engine relation column "${table.$name}.${name}" is not finalized`);
+	return column;
+}
+/** Adapt finalized relation metadata to Drizzle's relation registration shape. */
+function buildEngineRelations(tables) {
+	const byName = /* @__PURE__ */ new Map();
+	for (const table of Object.values(tables)) byName.set(table.$name, table);
+	const out = Object.create(null);
+	for (const table of Object.values(tables)) {
+		if (table.$relations.length === 0) continue;
+		const localEngine = table.$engine;
+		out[`${table.$name}Relations`] = relations(localEngine, ({ one, many }) => {
+			const config = Object.create(null);
+			for (const relation of table.$relations) {
+				const target = byName.get(relation.targetTable);
+				if (!target) throw new SchemaBuildError(`Engine relation target "${relation.targetTable}" is not finalized`);
+				const targetEngine = target.$engine;
+				config[relation.name] = relation.cardinality === "toOne" ? one(targetEngine, {
+					fields: [columnOf(table, relation.localColumn)],
+					references: [columnOf(target, relation.targetColumn)]
+				}) : many(targetEngine);
+			}
+			return config;
+		});
+	}
+	return out;
+}
+
+//#endregion
+export { buildEngineRelations };
+//# sourceMappingURL=relations.js.map

package/dist/database/schema-builder/engine/relations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"relations.js","names":[],"sources":["../../../../src/database/schema-builder/engine/relations.ts"],"sourcesContent":["import { type Relation, relations } from \"drizzle-orm\";\nimport type { AnyPgColumn, PgTable } from \"drizzle-orm/pg-core\";\n\nimport { type AppKitTable, SchemaBuildError } from \"../types\";\n\nfunction columnOf(table: AppKitTable, name: string): AnyPgColumn {\n  const column = table.$columns[name]?.engineColumn;\n  if (!column) {\n    throw new SchemaBuildError(\n      `Engine relation column \"${table.$name}.${name}\" is not finalized`,\n    );\n  }\n  return column as unknown as AnyPgColumn;\n}\n\n/** Adapt finalized relation metadata to Drizzle's relation registration shape. */\nexport function buildEngineRelations(\n  tables: Record<string, AppKitTable>,\n): Record<string, unknown> {\n  const byName = new Map<string, AppKitTable>();\n  for (const table of Object.values(tables)) byName.set(table.$name, table);\n\n  const out: Record<string, unknown> = Object.create(null);\n\n  for (const table of Object.values(tables)) {\n    if (table.$relations.length === 0) continue;\n\n    const localEngine = table.$engine as unknown as PgTable;\n    out[`${table.$name}Relations`] = relations(localEngine, ({ one, many }) => {\n      const config: Record<string, Relation> = Object.create(null);\n      for (const relation of table.$relations) {\n        const target = byName.get(relation.targetTable);\n        if (!target) {\n          throw new SchemaBuildError(\n            `Engine relation target \"${relation.targetTable}\" is not finalized`,\n          );\n        }\n        const targetEngine = target.$engine as unknown as PgTable;\n        config[relation.name] =\n          relation.cardinality === \"toOne\"\n            ? one(targetEngine, {\n                fields: [columnOf(table, relation.localColumn)],\n                references: [columnOf(target, relation.targetColumn)],\n              })\n            : many(targetEngine);\n      }\n      return config;\n    });\n  }\n  return out;\n}\n"],"mappings":";;;;AAKA,SAAS,SAAS,OAAoB,MAA2B;CAC/D,MAAM,SAAS,MAAM,SAAS,OAAO;AACrC,KAAI,CAAC,OACH,OAAM,IAAI,iBACR,2BAA2B,MAAM,MAAM,GAAG,KAAK,oBAChD;AAEH,QAAO;;;AAIT,SAAgB,qBACd,QACyB;CACzB,MAAM,yBAAS,IAAI,KAA0B;AAC7C,MAAK,MAAM,SAAS,OAAO,OAAO,OAAO,CAAE,QAAO,IAAI,MAAM,OAAO,MAAM;CAEzE,MAAM,MAA+B,OAAO,OAAO,KAAK;AAExD,MAAK,MAAM,SAAS,OAAO,OAAO,OAAO,EAAE;AACzC,MAAI,MAAM,WAAW,WAAW,EAAG;EAEnC,MAAM,cAAc,MAAM;AAC1B,MAAI,GAAG,MAAM,MAAM,cAAc,UAAU,cAAc,EAAE,KAAK,WAAW;GACzE,MAAM,SAAmC,OAAO,OAAO,KAAK;AAC5D,QAAK,MAAM,YAAY,MAAM,YAAY;IACvC,MAAM,SAAS,OAAO,IAAI,SAAS,YAAY;AAC/C,QAAI,CAAC,OACH,OAAM,IAAI,iBACR,2BAA2B,SAAS,YAAY,oBACjD;IAEH,MAAM,eAAe,OAAO;AAC5B,WAAO,SAAS,QACd,SAAS,gBAAgB,UACrB,IAAI,cAAc;KAChB,QAAQ,CAAC,SAAS,OAAO,SAAS,YAAY,CAAC;KAC/C,YAAY,CAAC,SAAS,QAAQ,SAAS,aAAa,CAAC;KACtD,CAAC,GACF,KAAK,aAAa;;AAE1B,UAAO;IACP;;AAEJ,QAAO"}

package/dist/database/schema-builder/engine/tables.js

@@ -0,0 +1,124 @@
+import { SchemaBuildError } from "../types.js";
+import { bigint, boolean, integer, jsonb, pgEnum, pgSchema, pgTable, text, timestamp, uuid, varchar } from "drizzle-orm/pg-core";
+
+//#region src/database/schema-builder/engine/tables.ts
+function sameValues(left, right) {
+	return left.length === right.length && left.every((value, index) => value === right[index]);
+}
+function getEnum(registry, schemaName, name, values) {
+	const existing = registry.get(name);
+	if (existing) {
+		if (!sameValues(existing.enumValues, values)) throw new SchemaBuildError(`Enum "${name}" is declared with conflicting values`);
+		return existing;
+	}
+	const tuple = values;
+	const created = schemaName === "public" ? pgEnum(name, tuple) : pgSchema(schemaName).enum(name, tuple);
+	registry.set(name, created);
+	return created;
+}
+/** Map resolved storage metadata to its Drizzle column builder. */
+function baseColumn(meta, schemaName, enums) {
+	const name = meta.columnName;
+	let builder;
+	switch (meta.storageKind) {
+		case "id":
+		case "integer":
+			builder = integer(name);
+			break;
+		case "bigid":
+		case "bigint":
+			builder = bigint(name, { mode: "bigint" });
+			break;
+		case "text":
+			builder = text(name);
+			break;
+		case "varchar":
+			builder = varchar(name, { length: meta.varcharLength ?? 255 });
+			break;
+		case "boolean":
+			builder = boolean(name);
+			break;
+		case "uuid":
+			builder = uuid(name);
+			break;
+		case "timestamp":
+			builder = timestamp(name, {
+				mode: "string",
+				withTimezone: meta.withTimezone ?? false
+			});
+			break;
+		case "jsonb":
+			builder = jsonb(name);
+			break;
+		case "enum":
+			if (!meta.enumName || !meta.enumValues?.length) throw new SchemaBuildError(`Enum column "${meta.columnName}" has no enum definition`);
+			builder = getEnum(enums, schemaName, meta.enumName, meta.enumValues)(name);
+			break;
+	}
+	return builder;
+}
+function buildColumn(meta, schemaName, enums, resolveTarget) {
+	let column = baseColumn(meta, schemaName, enums);
+	if (meta.serverGenerated) column = column.generatedByDefaultAsIdentity();
+	if (meta.primaryKey) column = column.primaryKey();
+	else if (meta.notNull) column = column.notNull();
+	if (meta.unique) column = column.unique();
+	if (!meta.serverGenerated) {
+		if (meta.defaultNow) column = column.defaultNow();
+		else if (meta.defaultRandom) column = column.defaultRandom();
+		else if (Object.hasOwn(meta, "defaultValue")) column = column.default(meta.defaultValue);
+	}
+	if (meta.fk) {
+		const target = meta.fk;
+		column = column.references(() => resolveTarget(target.targetTable, target.targetColumn), {
+			onDelete: target.onDelete,
+			onUpdate: target.onUpdate
+		});
+	}
+	return column;
+}
+const PG_TIMESTAMP = /^(\d{4}-\d{2}-\d{2})[ T](\d{2}:\d{2}:\d{2}(?:\.\d+)?)(?:([+-]\d{2})(?::?(\d{2}))?)?$/;
+function isoTimestamp(value) {
+	if (typeof value !== "string") return value;
+	const parts = PG_TIMESTAMP.exec(value);
+	if (!parts) return value;
+	const [, date, time, offsetHours, offsetMinutes] = parts;
+	return `${date}T${time}${offsetHours === void 0 ? "" : `${offsetHours}:${offsetMinutes ?? "00"}`}`;
+}
+function buildTable(name, schemaName, metas, enums, resolveTarget) {
+	const columnBuilders = Object.create(null);
+	for (const [key, meta] of Object.entries(metas)) columnBuilders[key] = buildColumn(meta, schemaName, enums, resolveTarget);
+	const engine = schemaName === "public" ? pgTable(name, columnBuilders) : pgSchema(schemaName).table(name, columnBuilders);
+	for (const [key, meta] of Object.entries(metas)) {
+		const engineColumn = engine[key];
+		if (!engineColumn) throw new SchemaBuildError(`Engine column "${name}.${key}" was not constructed`);
+		if (meta.storageKind === "timestamp") engineColumn.mapFromDriverValue = isoTimestamp;
+		meta.engineColumn = engineColumn;
+	}
+	return {
+		engine,
+		columns: metas
+	};
+}
+/** Build all Drizzle tables only after declaration validation has succeeded. */
+function buildEngineTables(raw, schemaName) {
+	const entries = [...raw];
+	const builtEngine = /* @__PURE__ */ new Map();
+	const resolveTarget = (table, column) => {
+		const target = builtEngine.get(table)?.[column];
+		if (!target) throw new SchemaBuildError(`Cannot resolve FK target "${table}.${column}"`);
+		return target;
+	};
+	const enums = /* @__PURE__ */ new Map();
+	const tables = /* @__PURE__ */ new Map();
+	for (const { name, metas } of entries) {
+		const built = buildTable(name, schemaName, metas, enums, resolveTarget);
+		builtEngine.set(name, built.engine);
+		tables.set(name, built);
+	}
+	return tables;
+}
+
+//#endregion
+export { buildEngineTables };
+//# sourceMappingURL=tables.js.map

package/dist/database/schema-builder/engine/tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tables.js","names":["pgInteger","pgBigint","pgText","pgVarchar","pgBoolean","pgUuid","pgTimestamp","pgJsonb"],"sources":["../../../../src/database/schema-builder/engine/tables.ts"],"sourcesContent":["import {\n  type AnyPgColumn,\n  type PgColumnBuilderBase,\n  type PgEnum,\n  bigint as pgBigint,\n  boolean as pgBoolean,\n  pgEnum,\n  integer as pgInteger,\n  jsonb as pgJsonb,\n  pgSchema,\n  pgTable,\n  text as pgText,\n  timestamp as pgTimestamp,\n  uuid as pgUuid,\n  varchar as pgVarchar,\n} from \"drizzle-orm/pg-core\";\n\nimport {\n  type EngineTable,\n  type MutableColumnMeta,\n  type ReferentialAction,\n  SchemaBuildError,\n} from \"../types\";\n\ntype AnyColumnBuilder = PgColumnBuilderBase & {\n  primaryKey(): AnyColumnBuilder;\n  notNull(): AnyColumnBuilder;\n  unique(): AnyColumnBuilder;\n  default(value: unknown): AnyColumnBuilder;\n  defaultNow(): AnyColumnBuilder;\n  defaultRandom(): AnyColumnBuilder;\n  generatedByDefaultAsIdentity(): AnyColumnBuilder;\n  references(\n    ref: () => AnyPgColumn,\n    actions?: { onDelete?: ReferentialAction; onUpdate?: ReferentialAction },\n  ): AnyColumnBuilder;\n};\n\ntype PgEnumValues = PgEnum<[string, ...string[]]>;\n/** Reuse one Drizzle enum object for each enum name in this schema. */\ntype EnumRegistry = Map<string, PgEnumValues>;\n\ninterface BuiltEngineTable {\n  readonly engine: EngineTable;\n  readonly columns: Record<string, MutableColumnMeta>;\n}\n\nfunction sameValues(\n  left: readonly string[],\n  right: readonly string[],\n): boolean {\n  return (\n    left.length === right.length &&\n    left.every((value, index) => value === right[index])\n  );\n}\n\nfunction getEnum(\n  registry: EnumRegistry,\n  schemaName: string,\n  name: string,\n  values: readonly string[],\n): PgEnumValues {\n  const existing = registry.get(name);\n  if (existing) {\n    if (!sameValues(existing.enumValues, values)) {\n      throw new SchemaBuildError(\n        `Enum \"${name}\" is declared with conflicting values`,\n      );\n    }\n    return existing;\n  }\n\n  const tuple = values as [string, ...string[]];\n  const created =\n    schemaName === \"public\"\n      ? pgEnum(name, tuple)\n      : pgSchema(schemaName).enum(name, tuple);\n  registry.set(name, created as PgEnumValues);\n  return created as PgEnumValues;\n}\n\n/** Map resolved storage metadata to its Drizzle column builder. */\nfunction baseColumn(\n  meta: MutableColumnMeta,\n  schemaName: string,\n  enums: EnumRegistry,\n): AnyColumnBuilder {\n  const name = meta.columnName;\n  let builder: PgColumnBuilderBase;\n  switch (meta.storageKind) {\n    case \"id\":\n    case \"integer\":\n      builder = pgInteger(name);\n      break;\n    case \"bigid\":\n    case \"bigint\":\n      builder = pgBigint(name, { mode: \"bigint\" });\n      break;\n    case \"text\":\n      builder = pgText(name);\n      break;\n    case \"varchar\":\n      builder = pgVarchar(name, { length: meta.varcharLength ?? 255 });\n      break;\n    case \"boolean\":\n      builder = pgBoolean(name);\n      break;\n    case \"uuid\":\n      builder = pgUuid(name);\n      break;\n    case \"timestamp\":\n      builder = pgTimestamp(name, {\n        mode: \"string\",\n        withTimezone: meta.withTimezone ?? false,\n      });\n      break;\n    case \"jsonb\":\n      builder = pgJsonb(name);\n      break;\n    case \"enum\": {\n      if (!meta.enumName || !meta.enumValues?.length) {\n        throw new SchemaBuildError(\n          `Enum column \"${meta.columnName}\" has no enum definition`,\n        );\n      }\n      builder = getEnum(\n        enums,\n        schemaName,\n        meta.enumName,\n        meta.enumValues,\n      )(name);\n      break;\n    }\n  }\n  return builder as AnyColumnBuilder;\n}\n\nfunction buildColumn(\n  meta: MutableColumnMeta,\n  schemaName: string,\n  enums: EnumRegistry,\n  resolveTarget: (table: string, column: string) => AnyPgColumn,\n): PgColumnBuilderBase {\n  let column = baseColumn(meta, schemaName, enums);\n  if (meta.serverGenerated) column = column.generatedByDefaultAsIdentity();\n  if (meta.primaryKey) column = column.primaryKey();\n  else if (meta.notNull) column = column.notNull();\n  if (meta.unique) column = column.unique();\n\n  if (!meta.serverGenerated) {\n    if (meta.defaultNow) column = column.defaultNow();\n    else if (meta.defaultRandom) column = column.defaultRandom();\n    else if (Object.hasOwn(meta, \"defaultValue\")) {\n      column = column.default(meta.defaultValue);\n    }\n  }\n\n  if (meta.fk) {\n    const target = meta.fk;\n    // Drizzle resolves this thunk after all referenced tables are registered.\n    column = column.references(\n      () => resolveTarget(target.targetTable, target.targetColumn),\n      { onDelete: target.onDelete, onUpdate: target.onUpdate },\n    );\n  }\n  return column;\n}\n\n// PostgreSQL renders a timestamp as `2026-06-29 19:05:19.051709+00` over the\n// text protocol but as ISO-8601 inside the JSON aggregates Drizzle builds for\n// relations, so one column reaches callers in two shapes depending on whether\n// it was included. Both shapes are declared `string`, and only ISO-8601 parses\n// per the ECMAScript grammar, so normalize to it.\nconst PG_TIMESTAMP =\n  /^(\\d{4}-\\d{2}-\\d{2})[ T](\\d{2}:\\d{2}:\\d{2}(?:\\.\\d+)?)(?:([+-]\\d{2})(?::?(\\d{2}))?)?$/;\n\nfunction isoTimestamp(value: unknown): unknown {\n  if (typeof value !== \"string\") return value;\n  const parts = PG_TIMESTAMP.exec(value);\n  // Leave `infinity`, `-infinity`, and anything unrecognized untouched.\n  if (!parts) return value;\n  const [, date, time, offsetHours, offsetMinutes] = parts;\n  const offset =\n    offsetHours === undefined ? \"\" : `${offsetHours}:${offsetMinutes ?? \"00\"}`;\n  return `${date}T${time}${offset}`;\n}\n\nfunction buildTable(\n  name: string,\n  schemaName: string,\n  metas: Record<string, MutableColumnMeta>,\n  enums: EnumRegistry,\n  resolveTarget: (table: string, column: string) => AnyPgColumn,\n): BuiltEngineTable {\n  const columnBuilders: Record<string, PgColumnBuilderBase> =\n    Object.create(null);\n  for (const [key, meta] of Object.entries(metas)) {\n    columnBuilders[key] = buildColumn(meta, schemaName, enums, resolveTarget);\n  }\n\n  const engine =\n    schemaName === \"public\"\n      ? pgTable(name, columnBuilders)\n      : pgSchema(schemaName).table(name, columnBuilders);\n  for (const [key, meta] of Object.entries(metas)) {\n    const engineColumn = (engine as unknown as Record<string, AnyPgColumn>)[\n      key\n    ];\n    if (!engineColumn) {\n      throw new SchemaBuildError(\n        `Engine column \"${name}.${key}\" was not constructed`,\n      );\n    }\n    if (meta.storageKind === \"timestamp\") {\n      // Drizzle routes every read path through this decoder, so overriding it\n      // covers direct selects, relation includes, and mutation RETURNING alike.\n      (engineColumn as unknown as Record<string, unknown>).mapFromDriverValue =\n        isoTimestamp;\n    }\n    meta.engineColumn =\n      engineColumn as unknown as MutableColumnMeta[\"engineColumn\"];\n  }\n  return { engine: engine as unknown as EngineTable, columns: metas };\n}\n\n/** Build all Drizzle tables only after declaration validation has succeeded. */\nexport function buildEngineTables(\n  raw: Iterable<{ name: string; metas: Record<string, MutableColumnMeta> }>,\n  schemaName: string,\n): Map<string, BuiltEngineTable> {\n  const entries = [...raw];\n  const builtEngine = new Map<string, Record<string, AnyPgColumn>>();\n  const resolveTarget = (table: string, column: string): AnyPgColumn => {\n    const target = builtEngine.get(table)?.[column];\n    if (!target) {\n      throw new SchemaBuildError(\n        `Cannot resolve FK target \"${table}.${column}\"`,\n      );\n    }\n    return target;\n  };\n\n  const enums: EnumRegistry = new Map();\n  const tables = new Map<string, BuiltEngineTable>();\n  for (const { name, metas } of entries) {\n    const built = buildTable(name, schemaName, metas, enums, resolveTarget);\n    builtEngine.set(\n      name,\n      built.engine as unknown as Record<string, AnyPgColumn>,\n    );\n    tables.set(name, built);\n  }\n  return tables;\n}\n"],"mappings":"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"}