qubu 0.3.4 → 0.4.0

package/dist/codegen.d.mts

@@ -1,4 +1,4 @@
-import { St as IntrospectionDiagnostic, dt as IntrospectionResult, i as CatalogClassificationConfidence, p as CatalogDialect, z as CatalogPortableStorageType } from "./types-BX0mckiU.mjs";
+import { St as IntrospectionDiagnostic, dt as IntrospectionResult, i as CatalogClassificationConfidence, p as CatalogDialect, z as CatalogPortableStorageType } from "./types-CSNJTYaM.mjs";
 //#region src/codegen/types.d.ts
 /** TypeScript value types that the controlled source printer can emit. */
 type CodegenApplicationType = 'unknown' | 'string' | 'number' | 'boolean' | 'bigint' | 'Date' | 'Uint8Array';

package/dist/codegen.mjs

@@ -1,5 +1,5 @@
 import { l as decodeSchemaSnapshot } from "./canonical-BbnqavJm.mjs";
-import { t as mapCatalogToSnapshot } from "./snapshot-CWPgzxNx.mjs";
+import { t as mapCatalogToSnapshot } from "./snapshot-DJpfmxhQ.mjs";
 //#region src/codegen/source.ts
 const header = `/* Generated by Qubu. Do not edit this machine-owned file. */
 import * as _qubu from 'qubu'

package/dist/column-D-8OqGuV.mjs

@@ -0,0 +1,328 @@
+import { a as assertDialectCapability } from "./json-CUZlv4HT.mjs";
+//#region src/result.ts
+const resultValueMetadata = Symbol("qubu.result-value-metadata");
+function resultValue(type, decoder) {
+	return type === void 0 && decoder === void 0 ? void 0 : Object.freeze({
+		...type === void 0 ? {} : { type },
+		...decoder === void 0 ? {} : { decoder }
+	});
+}
+function resultValueOf(value) {
+	if (typeof value !== "object" || value === null) return void 0;
+	return value[resultValueMetadata];
+}
+function attachResultValue(value, metadata) {
+	if (metadata === void 0) return value;
+	return Object.freeze({
+		...value,
+		[resultValueMetadata]: metadata
+	});
+}
+function createResultShape(fields) {
+	return Object.freeze({ fields: Object.freeze(fields.map((field) => Object.freeze({ ...field }))) });
+}
+function resultShapeValue(shape, name) {
+	const field = shape.fields.find((candidate) => candidate.name === name);
+	return field === void 0 ? void 0 : resultValue(field.type, field.decoder);
+}
+/** Decode SQLite/MySQL-style boolean values while accepting native booleans. */
+const booleanResultDecoder = (value) => {
+	if (typeof value === "boolean") return value;
+	if (value === 0 || value === 0n) return false;
+	if (value === 1 || value === 1n) return true;
+	throw new TypeError("Expected a boolean or numeric 0/1 result");
+};
+/** Decode a SQL DATE string as a JavaScript Date at UTC midnight. */
+const dateResultDecoder = (value) => {
+	if (value instanceof Date && !Number.isNaN(value.getTime())) return value;
+	if (typeof value !== "string" || !/^\d{4}-\d{2}-\d{2}$/u.test(value)) throw new TypeError("Expected a valid Date or YYYY-MM-DD result");
+	const decoded = /* @__PURE__ */ new Date(`${value}T00:00:00.000Z`);
+	if (Number.isNaN(decoded.getTime()) || decoded.toISOString().slice(0, 10) !== value) throw new TypeError("Expected a valid calendar date result");
+	return decoded;
+};
+/** Decode a SQL/ISO timestamp string while accepting driver-created Dates. */
+const timestampResultDecoder = (value) => {
+	if (value instanceof Date && !Number.isNaN(value.getTime())) return value;
+	if (typeof value !== "string") throw new TypeError("Expected a valid Date or timestamp string result");
+	const normalized = value.includes("T") ? value : value.replace(" ", "T");
+	const decoded = new Date(/(?:Z|[+-]\d{2}:?\d{2})$/u.test(normalized) ? normalized : `${normalized}Z`);
+	if (Number.isNaN(decoded.getTime())) throw new TypeError("Expected a valid timestamp result");
+	return decoded;
+};
+/** Decode a serialized JSON result. Use only when the adapter returns JSON text. */
+const jsonTextResultDecoder = (value) => {
+	if (typeof value !== "string") return value;
+	return JSON.parse(value);
+};
+/** Error raised when a projected driver value cannot be decoded. */
+var ResultDecodingError = class extends TypeError {
+	name = "ResultDecodingError";
+	field;
+	rowIndex;
+	resultType;
+	constructor(field, rowIndex, resultType) {
+		super(`Could not decode result field "${field}" in row ${rowIndex}${resultType === void 0 ? "" : ` as ${resultType}`}`);
+		this.field = field;
+		this.rowIndex = rowIndex;
+		this.resultType = resultType;
+	}
+};
+function decodeResultRow(row, shape, decoders, dialect, rowIndex) {
+	let decoded;
+	for (const field of shape.fields) {
+		const decoder = field.decoder ?? (field.type ? decoders?.[field.type] : void 0);
+		if (decoder === void 0 || row[field.name] === null) continue;
+		try {
+			decoded ??= { ...row };
+			decoded[field.name] = decoder(row[field.name], {
+				dialect,
+				field: field.name,
+				rowIndex
+			});
+		} catch {
+			throw new ResultDecodingError(field.name, rowIndex, field.type);
+		}
+	}
+	return decoded ?? row;
+}
+//#endregion
+//#region src/core/fragment.ts
+function fragment(render) {
+	return Object.freeze({ render });
+}
+function sequence(parts, separator = " ") {
+	return fragment((context) => {
+		let first = true;
+		for (const part of parts) {
+			if (!first) context.append(separator);
+			context.render(part);
+			first = false;
+		}
+	});
+}
+function parenthesize(part) {
+	return fragment((context) => {
+		context.append("(");
+		context.render(part);
+		context.append(")");
+	});
+}
+function isFragment(value) {
+	return typeof value === "object" && value !== null && "render" in value && typeof value.render === "function";
+}
+//#endregion
+//#region src/expressions/types.ts
+/** Runtime/type-level proof that an expression is safe to use in schema SQL. */
+const schemaExpressionBrand = Symbol("qubu.schema-expression");
+/** Add a concrete dialect requirement without dropping expression metadata. */
+function withDialectCapability(expression, capability) {
+	const wrapped = makeExpression(expression.expressionKind, (context) => {
+		assertDialectCapability(context.dialect, capability);
+		context.render(expression);
+	}, expression.expressionCategory, resultValueOf(expression));
+	return isSchemaExpression(expression) ? markSchemaExpression(wrapped) : wrapped;
+}
+function makeExpression(expressionKind, render, expressionCategory, result) {
+	return attachResultValue(Object.freeze({
+		expressionKind,
+		...expressionCategory ? { expressionCategory } : {},
+		...fragment(render)
+	}), result);
+}
+/** Mark a query-only expression category without changing its SQL renderer. */
+function markExpressionCategory(expression, category) {
+	return Object.freeze({
+		...expression,
+		expressionCategory: category
+	});
+}
+/**
+* Mark a built-in or explicitly audited renderer as schema-deterministic.
+* Prefer {@link defineSchemaExpression} for application extensions because it
+* supplies a restricted schema rendering context.
+*/
+function makeSchemaExpression(expressionKind, render, result) {
+	const expression = makeExpression(expressionKind, render, void 0, result);
+	return Object.freeze({
+		...expression,
+		[schemaExpressionBrand]: true
+	});
+}
+/** Add the schema-determinism brand to an explicitly audited expression. */
+function markSchemaExpression(expression) {
+	if (isSchemaExpression(expression)) return expression;
+	return Object.freeze({
+		...expression,
+		[schemaExpressionBrand]: true
+	});
+}
+/** Test the runtime brand used by schema rendering and validation. */
+function isSchemaExpression(value) {
+	return typeof value === "object" && value !== null && schemaExpressionBrand in value && value[schemaExpressionBrand] === true;
+}
+function isExpression(value) {
+	return typeof value === "object" && value !== null && "expressionKind" in value && "render" in value && typeof value.render === "function";
+}
+//#endregion
+//#region src/core/naming.ts
+/** Convert an application-facing field name to a SQL-facing identifier. */
+function snakeCaseIdentifier(name) {
+	return name.replace(/([A-Z]+)([A-Z][a-z])/g, "$1_$2").replace(/([a-z0-9])([A-Z])/g, "$1_$2").replace(/[-\s]+/g, "_").toLowerCase();
+}
+function resolveSqlNames(fields) {
+	const sqlNames = {};
+	const fieldsBySqlName = /* @__PURE__ */ new Map();
+	for (const field of fields) {
+		const sqlName = field.sqlName ?? snakeCaseIdentifier(field.fieldName);
+		if (sqlName.length === 0) throw new Error(`SQL name for field "${field.fieldName}" cannot be empty`);
+		const existingField = fieldsBySqlName.get(sqlName);
+		if (existingField) throw new Error(`Fields "${existingField}" and "${field.fieldName}" both resolve to SQL name "${sqlName}"`);
+		fieldsBySqlName.set(sqlName, field.fieldName);
+		sqlNames[field.fieldName] = sqlName;
+	}
+	return Object.freeze(sqlNames);
+}
+//#endregion
+//#region src/schema/metadata.ts
+/** Error raised when relational metadata cannot be represented safely. */
+var SchemaMetadataValidationError = class extends TypeError {
+	name = "SchemaMetadataValidationError";
+	diagnostics;
+	issues;
+	constructor(diagnostics) {
+		const frozenDiagnostics = Object.freeze(diagnostics.map((diagnostic) => Object.freeze({
+			...diagnostic,
+			path: Object.freeze([...diagnostic.path]),
+			relatedPaths: diagnostic.relatedPaths ? Object.freeze(diagnostic.relatedPaths.map((path) => Object.freeze([...path]))) : void 0
+		})));
+		super(frozenDiagnostics.map((diagnostic) => diagnostic.message).join("\n"));
+		this.diagnostics = frozenDiagnostics;
+		this.issues = frozenDiagnostics;
+	}
+};
+/** Generate the version-one physical name for a relational object ID. */
+function generatedSchemaObjectName(id) {
+	return snakeCaseIdentifier(id);
+}
+/** Deep-freeze plain metadata values without introducing executable nodes. */
+function freezeSchemaMetadata(value) {
+	if (Array.isArray(value)) return Object.freeze(value.map((item) => freezeSchemaMetadata(item)));
+	if (typeof value !== "object" || value === null) return value;
+	const frozen = Object.fromEntries(Object.entries(value).map(([key, nested]) => [key, freezeSchemaMetadata(nested)]));
+	return Object.freeze(frozen);
+}
+/** Check the portable identifier subset used for generated metadata names. */
+function isValidSchemaObjectName(name) {
+	return name.length > 0 && name === name.trim() && !/[.\\/\u0000-\u001f\u007f"']/u.test(name);
+}
+/**
+* Attach a record key and resolved physical name without changing the
+* enumerable shape of legacy constraint/index values. The properties are
+* still ordinary read-only runtime metadata and are available to snapshot
+* traversals.
+*/
+function materializeSchemaObjectIdentity(value, id, physicalName) {
+	const materialized = { ...value };
+	Object.defineProperties(materialized, {
+		id: {
+			configurable: false,
+			enumerable: false,
+			value: id,
+			writable: false
+		},
+		physicalName: {
+			configurable: false,
+			enumerable: false,
+			value: physicalName ?? generatedSchemaObjectName(id),
+			writable: false
+		}
+	});
+	return Object.freeze(materialized);
+}
+/**
+* Resolve and validate names for one metadata record. The caller decides
+* whether constraint and index names share a database namespace.
+*/
+function materializeSchemaObjectRecord(record, kind) {
+	const diagnostics = [];
+	const names = /* @__PURE__ */ new Map();
+	const result = {};
+	for (const [id, value] of Object.entries(record)) {
+		const physicalName = value.physicalName ?? generatedSchemaObjectName(id);
+		const path = [kind === "constraint" ? "constraints" : "indexes", id];
+		if (!isValidSchemaObjectName(physicalName)) diagnostics.push({
+			code: "invalid-physical-name",
+			message: `The ${kind} "${id}" has invalid physical name "${physicalName}"`,
+			path: [...path, "physicalName"]
+		});
+		const previousId = names.get(physicalName);
+		if (previousId !== void 0) diagnostics.push({
+			code: "duplicate-physical-name",
+			message: `The ${kind}s "${previousId}" and "${id}" both use physical name "${physicalName}"`,
+			path: [...path, "physicalName"],
+			relatedPaths: [[
+				kind === "constraint" ? "constraints" : "indexes",
+				previousId,
+				"physicalName"
+			]]
+		});
+		else names.set(physicalName, id);
+		result[id] = materializeSchemaObjectIdentity(value, id, physicalName);
+	}
+	if (diagnostics.length > 0) throw new SchemaMetadataValidationError(diagnostics);
+	return Object.freeze(result);
+}
+/** Return a diagnostic when a dialect extension is used by another adapter. */
+function dialectMismatchDiagnostic(extension, dialect, path) {
+	if (extension.dialect === dialect) return void 0;
+	return {
+		code: "dialect-mismatch",
+		message: `Dialect extension belongs to "${extension.dialect}" but the active schema dialect is "${dialect}"`,
+		path,
+		dialect
+	};
+}
+/** Throw a structured error for one or more dialect capability findings. */
+function assertSchemaDialectSupport(diagnostics) {
+	if (diagnostics.length > 0) throw new SchemaMetadataValidationError(diagnostics);
+}
+//#endregion
+//#region src/core/primitives/identifier.ts
+function identifier(name) {
+	return fragment((context) => context.append(context.dialect.quoteIdentifier(name)));
+}
+function qualifiedIdentifier(...parts) {
+	return fragment((context) => {
+		parts.forEach((part, index) => {
+			if (index > 0) context.append(".");
+			context.append(context.dialect.quoteIdentifier(part));
+		});
+	});
+}
+//#endregion
+//#region src/expressions/column.ts
+function createColumnReference(columnName, sourceReference, fieldName, result) {
+	const expression = makeSchemaExpression("column", (context) => {
+		if (context.renderColumnReference) {
+			context.renderColumnReference(columnName);
+			return;
+		}
+		context.render(sourceReference);
+		context.append(".");
+		context.render(identifier(columnName));
+	}, result);
+	return Object.freeze({
+		...expression,
+		fieldName,
+		columnName
+	});
+}
+function isColumnReference(value) {
+	return typeof value === "object" && value !== null && "expressionKind" in value && value.expressionKind === "column";
+}
+/** Turn an expression into a fragment that renders it without changing it. */
+function expressionFragment(expression) {
+	return fragment((context) => context.render(expression));
+}
+//#endregion
+export { dateResultDecoder as A, fragment as C, ResultDecodingError as D, sequence as E, resultValueOf as F, timestampResultDecoder as I, jsonTextResultDecoder as M, resultShapeValue as N, booleanResultDecoder as O, resultValue as P, withDialectCapability as S, parenthesize as T, isSchemaExpression as _, qualifiedIdentifier as a, markExpressionCategory as b, dialectMismatchDiagnostic as c, isValidSchemaObjectName as d, materializeSchemaObjectIdentity as f, isExpression as g, snakeCaseIdentifier as h, identifier as i, decodeResultRow as j, createResultShape as k, freezeSchemaMetadata as l, resolveSqlNames as m, expressionFragment as n, SchemaMetadataValidationError as o, materializeSchemaObjectRecord as p, isColumnReference as r, assertSchemaDialectSupport as s, createColumnReference as t, generatedSchemaObjectName as u, makeExpression as v, isFragment as w, markSchemaExpression as x, makeSchemaExpression as y };

package/dist/{table-llv9tsZ8.mjs → column-LV7oGQde.mjs}

@@ -1,55 +1,4 @@
-import { h as parenthesize, i as identifier, s as isSchemaExpression, t as createColumnReference } from "./column-CXMxx8Hq.mjs";
-import { t as resolveSqlNames } from "./naming-QVCOnSj2.mjs";
-import { r as exposeColumns, t as createSource } from "./source-DUoJVXmL.mjs";
-import { M as materializeSchemaObjectRecord, O as freezeSchemaMetadata } from "./registry-BufIskVN.mjs";
-//#region src/schema/alias.ts
-function alias(sourceOrQuery, name) {
-	const input = sourceOrQuery;
-	const reference = identifier(name);
-	const isQuery = "queryKind" in input;
-	const source = createSource(isQuery ? "query-alias" : "table-alias", (context) => {
-		if (isQuery) context.renderRelation(parenthesize(input));
-		else context.render(input);
-		context.append(" AS ");
-		context.render(reference);
-	}, reference);
-	const fieldNames = isQuery ? Object.keys(input.row) : Object.keys(input.columns);
-	const querySqlNames = isQuery ? resolveSqlNames(fieldNames.map((fieldName) => ({ fieldName }))) : void 0;
-	const columns = Object.fromEntries(fieldNames.map((fieldName) => {
-		const columnName = isQuery ? querySqlNames[fieldName] : input.columns[fieldName].columnName;
-		return [fieldName, createColumnReference(columnName, reference, fieldName)];
-	}));
-	Object.assign(source, {
-		alias: name,
-		base: isQuery ? void 0 : input,
-		query: isQuery ? input : void 0,
-		constraints: isQuery ? {} : input.constraints,
-		indexes: isQuery ? {} : "indexes" in input ? input.indexes : {},
-		columns
-	});
-	exposeColumns(source, columns);
-	return source;
-}
-/** Render a query as a LATERAL source whose outer requirements stay visible. */
-function lateral(query, name) {
-	const reference = identifier(name);
-	const source = createSource("lateral", (context) => {
-		context.append("LATERAL ");
-		context.renderRelation(parenthesize(query));
-		context.append(" AS ");
-		context.render(reference);
-	}, reference);
-	const sqlNames = resolveSqlNames(Object.keys(query.row).map((fieldName) => ({ fieldName })));
-	const columns = Object.fromEntries(Object.keys(query.row).map((fieldName) => [fieldName, createColumnReference(sqlNames[fieldName], reference, fieldName)]));
-	Object.assign(source, {
-		alias: name,
-		query,
-		columns
-	});
-	exposeColumns(source, columns);
-	return source;
-}
-//#endregion
+import { P as resultValue, _ as isSchemaExpression, l as freezeSchemaMetadata } from "./column-D-8OqGuV.mjs";
 //#region src/schema/column-behavior.ts
 /** A column behavior error with a stable code and optional property path. */
 var ColumnBehaviorError = class extends TypeError {
@@ -286,6 +235,7 @@ function column(options) {
 		...resolveColumnBehavior(options ?? {}),
 		sqlName: options?.sqlName,
 		storage: options?.storage ? Object.freeze({ ...options.storage }) : void 0,
+		...options?.decode === void 0 ? {} : { resultDecoder: options.decode },
 		$type: narrowColumnType,
 		castTarget: options?.castType ? Object.freeze({
 			kind: "named-cast",
@@ -293,6 +243,12 @@ function column(options) {
 		}) : void 0
 	});
 }
+/** Resolve the runtime result metadata carried by a column definition. */
+function columnResultValue(definition) {
+	const storage = definition.storage;
+	const type = storage?.kind === "portable" && (storage.type === "boolean" || storage.type === "date" || storage.type === "timestamp" || storage.type === "json") ? storage.type : void 0;
+	return resultValue(type, definition.resultDecoder);
+}
 function nativeColumn(storageOrDialect, typeOrOptions, maybeOptions) {
 	const storage = typeof storageOrDialect === "string" ? nativeStorage(storageOrDialect, typeOrOptions) : storageOrDialect;
 	return column({
@@ -337,48 +293,4 @@ function binary(options) {
 	return withPortableStorage(withPortableCast(column(options), "binary"), "binary");
 }
 //#endregion
-//#region src/schema/table.ts
-function table(name, definitions, metadata) {
-	const source = createSource("table", (context) => context.render(identifier(name)), identifier(name));
-	const sqlNames = resolveSqlNames(Object.entries(definitions).map(([fieldName, definition]) => ({
-		fieldName,
-		sqlName: definition.sqlName
-	})));
-	const columns = Object.fromEntries(Object.keys(definitions).map((fieldName) => {
-		const sqlName = sqlNames[fieldName];
-		return [fieldName, createColumnReference(sqlName, source.reference, fieldName)];
-	}));
-	Object.assign(source, {
-		tableName: name,
-		definitions,
-		sqlNames,
-		columns,
-		constraints: {},
-		indexes: {}
-	});
-	exposeColumns(source, columns);
-	const resolvedMetadata = metadata ? metadata(source) : {
-		constraints: {},
-		indexes: {}
-	};
-	const constraints = materializeSchemaObjectRecord(resolvedMetadata.constraints, "constraint");
-	const indexes = Object.fromEntries(Object.entries(resolvedMetadata.indexes).map(([indexName, tableIndex]) => {
-		const candidateKey = tableIndex.unique && tableIndex.predicate === void 0 && tableIndex.terms.every((term) => {
-			const expression = "orderKind" in term ? term.expression : term;
-			return expression.expressionKind === "column" && definitions[expression.fieldName]?.nullable === false;
-		});
-		return [indexName, Object.freeze({
-			...tableIndex,
-			candidateKey
-		})];
-	}));
-	const namedIndexes = materializeSchemaObjectRecord(indexes, "index");
-	Object.assign(source, {
-		...resolvedMetadata,
-		constraints,
-		indexes: namedIndexes
-	});
-	return source;
-}
-//#endregion
-export { resolveColumnBehavior as C, identityColumn as S, lateral as T, ColumnBehaviorError as _, column as a, externalGeneratedColumn as b, json as c, nullable as d, numeric as f, uuid as g, timestamp as h, boolean as i, nativeColumn as l, text as m, bigint as n, date as o, portableStorage as p, binary as r, integer as s, table as t, nativeStorage as u, canonicalLiteral as v, alias as w, generatedColumn as x, externalDefault as y };
+export { resolveColumnBehavior as C, identityColumn as S, ColumnBehaviorError as _, columnResultValue as a, externalGeneratedColumn as b, json as c, nullable as d, numeric as f, uuid as g, timestamp as h, column as i, nativeColumn as l, text as m, binary as n, date as o, portableStorage as p, boolean as r, integer as s, bigint as t, nativeStorage as u, canonicalLiteral as v, generatedColumn as x, externalDefault as y };

package/dist/{complete-types-BdFqUfbb.d.mts → complete-types-BavBtv8J.d.mts}

@@ -1,4 +1,4 @@
-import { A as SnapshotStorage, D as SnapshotLiteral, O as SnapshotNamingPolicy, T as SnapshotJsonValue, b as SnapshotGeneratedColumn, d as SnapshotDefault, f as SnapshotDiagnostic, g as SnapshotExpression, h as SnapshotDialectExtension, i as SchemaSnapshotInput, m as SnapshotDialect } from "./types-4Q076HKo.mjs";
+import { A as SnapshotStorage, D as SnapshotLiteral, O as SnapshotNamingPolicy, T as SnapshotJsonValue, b as SnapshotGeneratedColumn, d as SnapshotDefault, f as SnapshotDiagnostic, g as SnapshotExpression, h as SnapshotDialectExtension, i as SchemaSnapshotInput, m as SnapshotDialect } from "./types-Deo_q43Y.mjs";
 //#region src/snapshot/complete-types.d.ts
 /** The stable envelope tag shared by Snapshot v1 and the complete model. */
 declare const completeSchemaSnapshotFormat: "qubu-schema";

package/dist/core.d.mts

@@ -1,4 +1,4 @@
-import { $ as PaginationKind, $l as SubqueryMeta, Al as HasSubquery, B as CastTarget, Bl as ProvidesOuterSourceMeta, Cl as ExpressionMeta, Cu as SqlTypeSatisfies, Dl as GroupingKeysOf, Do as RenderedQuery, El as GroupingDependenciesOf, Eo as RenderOptions, Fi as SelectClause, Fl as NullabilityOf, G as DialectJson, Gl as RequiresCapabilityMeta, H as DialectCapability, Hl as QueryCardinality, Il as NullableSourceMeta, J as DialectRowLocking, Jl as RequiresOuterOf, K as DialectOptions, Kl as RequiresOf, Ll as NullableSourcesOf, Ml as InheritedMetadata, Nl as InheritedMetadataOf, Ol as GroupingMeta, Oo as render, Pi as ClausePlacement, Pl as MetadataOf, Q as NamedCastTarget, Ql as SqlTypeOf, Rl as OutputOf, Sl as DependenciesOf, Su as SqlTimestamp, Tl as FragmentMeta, To as RenderCapabilityValidation, Tu as SqlUuid, U as DialectCastTypes, Ul as RenderContext, V as Dialect, Va as typedValue, Vl as ProvidesSourceMeta, W as DialectExplain, Wa as typedCast, Wl as RenderFunction, X as ExplainRenderOptions, Xl as RequiresSourceMeta, Y as ExplainFormat, Yl as RequiresOuterSourceMeta, Z as JsonScalarKind, Zl as ResultMeta, _l as AnyFragment, _u as SqlOrderCompatible, at as SchemaLiteralRenderer, au as sequence, bl as CardinalityMeta, bu as SqlText, ct as resolveCastTarget, cu as SqlBinary, dl as isExpression, du as SqlDecimal, el as expressionFragment, et as PaginationPart, eu as VisibleDependenciesOf, fl as makeExpression, fu as SqlEqualityComparable, gl as AggregateMeta, gu as SqlNumericLike, hl as AggregateDependenciesOf, hu as SqlJson, it as RowLockWaitPolicy, iu as parenthesize, jl as HasWindow, kl as HasAggregate, lu as SqlBoolean, ml as withDialectCapability, mu as SqlInteger, nt as PortableCastType, nu as fragment, ot as assertDialectCapability, ou as AnySqlType, pl as markExpressionCategory, pu as SqlEqualityCompatible, q as DialectPagination, ql as RequiresOuterMetadataOf, ra as typedCall, rl as Expression, rt as RowLockMode, ru as isFragment, st as createDialect, su as SqlBigInt, tt as PortableCastTarget, tu as WindowMeta, uu as SqlDate, vl as CapabilitiesOf, vu as SqlOrderable, wl as Fragment, wu as SqlUnknown, xl as CardinalityOf, xu as SqlTextLike, yl as CapabilityMetadataOf, yu as SqlSemanticType, zl as ProvidesOuterOf } from "./types-4Q076HKo.mjs";
+import { $ as PaginationKind, $l as InheritedMetadata, Au as SqlBoolean, B as CastTarget, Bl as CapabilityMetadataOf, Bu as SqlSemanticType, Cl as markExpressionCategory, Cu as fragment, Du as AnySqlType, Eu as sequence, Fu as SqlInteger, G as DialectJson, Ga as typedValue, Gl as Fragment, Gu as SqlUnknown, H as DialectCapability, Hl as CardinalityOf, Hu as SqlTextLike, Il as AggregateDependenciesOf, Iu as SqlJson, J as DialectRowLocking, Jl as GroupingKeysOf, K as DialectOptions, Kl as FragmentMeta, Ku as SqlUuid, Ll as AggregateMeta, Lu as SqlNumericLike, Mo as RenderOptions, Mu as SqlDecimal, No as RenderedQuery, Nu as SqlEqualityComparable, Ou as SqlBigInt, Po as render, Pu as SqlEqualityCompatible, Q as NamedCastTarget, Ql as HasWindow, Ri as ClausePlacement, Rl as AnyFragment, Ru as SqlOrderCompatible, Sl as makeExpression, Su as WindowMeta, Tu as parenthesize, U as DialectCastTypes, Ul as DependenciesOf, Uu as SqlTimestamp, V as Dialect, Vl as CardinalityMeta, Vu as SqlText, W as DialectExplain, Wl as ExpressionMeta, Wu as SqlTypeSatisfies, X as ExplainRenderOptions, Xl as HasAggregate, Y as ExplainFormat, Ya as typedCast, Yl as GroupingMeta, Z as JsonScalarKind, Zl as HasSubquery, _u as RequiresSourceMeta, at as SchemaLiteralRenderer, au as OutputOf, bu as SubqueryMeta, ct as resolveCastTarget, cu as ProvidesSourceMeta, du as RenderFunction, et as PaginationPart, eu as InheritedMetadataOf, fl as Expression, fu as RequiresCapabilityMeta, gu as RequiresOuterSourceMeta, hu as RequiresOuterOf, it as RowLockWaitPolicy, iu as NullableSourcesOf, jo as RenderCapabilityValidation, ju as SqlDate, ku as SqlBinary, ll as expressionFragment, lu as QueryCardinality, mu as RequiresOuterMetadataOf, nt as PortableCastType, nu as NullabilityOf, ot as assertDialectCapability, ou as ProvidesOuterOf, pu as RequiresOf, q as DialectPagination, ql as GroupingDependenciesOf, rt as RowLockMode, ru as NullableSourceMeta, sa as typedCall, st as createDialect, su as ProvidesOuterSourceMeta, tt as PortableCastTarget, tu as MetadataOf, uu as RenderContext, vu as ResultMeta, wl as withDialectCapability, wu as isFragment, xl as isExpression, xu as VisibleDependenciesOf, yu as SqlTypeOf, zi as SelectClause, zl as CapabilitiesOf, zu as SqlOrderable } from "./types-Deo_q43Y.mjs";
 //#region src/core/primitives/compose.d.ts
 declare function commaSeparated<const TParts extends readonly AnyFragment[]>(parts: TParts): Fragment<InheritedMetadata<TParts[number]>>;
 declare function keyword<TPart extends AnyFragment | undefined>(value: string, part?: TPart): Fragment<TPart extends AnyFragment ? InheritedMetadata<TPart> : never>;

package/dist/core.mjs

@@ -1,7 +1,7 @@
 import { a as assertDialectCapability, o as createDialect, s as resolveCastTarget } from "./json-CUZlv4HT.mjs";
-import { a as routineName, c as render, i as typedCall, s as typedCast, t as createClause } from "./types-Cec0xzo4.mjs";
-import { a as qualifiedIdentifier, c as makeExpression, f as withDialectCapability, g as sequence, h as parenthesize, i as identifier, m as isFragment, n as expressionFragment, o as isExpression, p as fragment, u as markExpressionCategory } from "./column-CXMxx8Hq.mjs";
-import { a as parameter, r as typedValue } from "./value-BvilP0oz.mjs";
+import { a as routineName, c as render, i as typedCall, s as typedCast, t as createClause } from "./types-g-vVvj1B.mjs";
+import { C as fragment, E as sequence, S as withDialectCapability, T as parenthesize, a as qualifiedIdentifier, b as markExpressionCategory, g as isExpression, i as identifier, n as expressionFragment, v as makeExpression, w as isFragment } from "./column-D-8OqGuV.mjs";
+import { a as parameter, r as typedValue } from "./value-b6OFZXVS.mjs";
 //#region src/core/primitives/compose.ts
 function commaSeparated(parts) {
 	return sequence(parts, ", ");

package/dist/ddl.d.mts

@@ -1,4 +1,4 @@
-import { Mr as SchemaDialect } from "./types-4Q076HKo.mjs";
+import { Ir as SchemaDialect } from "./types-Deo_q43Y.mjs";
 import { MigrationLockRequirement, MigrationOperation, MigrationPlan, MigrationTransactionRequirement } from "./migration.mjs";
 //#region src/ddl/types.d.ts
 /** Stable diagnostic categories produced before a migration is rendered. */

package/dist/ddl.mjs

@@ -1,6 +1,6 @@
-import { n as sqliteSchemaDialect } from "./sqlite-BU6DBxef.mjs";
-import { n as postgresSchemaDialect } from "./postgres-DEBBeh52.mjs";
-import { n as mysqlSchemaDialect } from "./mysql-DqkqXB6A.mjs";
+import { n as sqliteSchemaDialect } from "./sqlite-CrsK0Fza.mjs";
+import { n as postgresSchemaDialect } from "./postgres-BK2APkKP.mjs";
+import { n as mysqlSchemaDialect } from "./mysql-CKEKGnj4.mjs";
 import { assertMigrationPlan } from "./migration.mjs";
 //#region src/ddl/emitter.ts
 const objectKinds = /* @__PURE__ */ new Set([

package/dist/diff.d.mts

@@ -1,2 +1,2 @@
-import { C as SnapshotDiffPropertyChange, D as SnapshotRenameTarget, E as SnapshotRenameSuggestion, S as SnapshotDiffPath, T as SnapshotRenameHintResult, _ as SnapshotDiffObjectKind, a as diffSnapshots, b as SnapshotDiffOperationType, c as validateRenameHints, d as SnapshotDiffDecodeResult, f as SnapshotDiffDiagnostic, g as SnapshotDiffObject, h as SnapshotDiffInput, i as decodeSnapshotRenameHints, l as validateSnapshotRenameHints, m as SnapshotDiffEvidence, n as decodeRenameHints, o as encodeRenameHints, p as SnapshotDiffDiagnosticCode, r as decodeSnapshotForDiff, s as encodeSnapshotRenameHints, t as compareSnapshots, u as SnapshotDiff, v as SnapshotDiffObjectReference, w as SnapshotRenameHint, x as SnapshotDiffOptions, y as SnapshotDiffOperation } from "./index-Dug5HnLB.mjs";
+import { C as SnapshotDiffPropertyChange, D as SnapshotRenameTarget, E as SnapshotRenameSuggestion, S as SnapshotDiffPath, T as SnapshotRenameHintResult, _ as SnapshotDiffObjectKind, a as diffSnapshots, b as SnapshotDiffOperationType, c as validateRenameHints, d as SnapshotDiffDecodeResult, f as SnapshotDiffDiagnostic, g as SnapshotDiffObject, h as SnapshotDiffInput, i as decodeSnapshotRenameHints, l as validateSnapshotRenameHints, m as SnapshotDiffEvidence, n as decodeRenameHints, o as encodeRenameHints, p as SnapshotDiffDiagnosticCode, r as decodeSnapshotForDiff, s as encodeSnapshotRenameHints, t as compareSnapshots, u as SnapshotDiff, v as SnapshotDiffObjectReference, w as SnapshotRenameHint, x as SnapshotDiffOptions, y as SnapshotDiffOperation } from "./index-D3ZOwPT-.mjs";
 export { SnapshotDiff, SnapshotDiffDecodeResult, SnapshotDiffDiagnostic, SnapshotDiffDiagnosticCode, SnapshotDiffEvidence, SnapshotDiffInput, SnapshotDiffObject, SnapshotDiffObjectKind, SnapshotDiffObjectReference, SnapshotDiffOperation, SnapshotDiffOperationType, SnapshotDiffOptions, SnapshotDiffPath, SnapshotDiffPropertyChange, SnapshotRenameHint, SnapshotRenameHintResult, SnapshotRenameSuggestion, SnapshotRenameTarget, compareSnapshots, decodeRenameHints, decodeSnapshotForDiff, decodeSnapshotRenameHints, diffSnapshots, encodeRenameHints, encodeSnapshotRenameHints, validateRenameHints, validateSnapshotRenameHints };

package/dist/drizzle-mysql.d.mts

@@ -1,5 +1,5 @@
-import { Pt as AnyTable, Xr as Schema, ni as SchemaTableRecord } from "./types-4Q076HKo.mjs";
-import { r as DrizzleSchemaValidation, t as DrizzleColumnConfig } from "./types-H4vyCw8_.mjs";
+import { Lt as AnyTable, ei as Schema, oi as SchemaTableRecord } from "./types-Deo_q43Y.mjs";
+import { r as DrizzleSchemaValidation, t as DrizzleColumnConfig } from "./types-DZsueVoI.mjs";
 import { MySqlColumn, MySqlTableWithColumns } from "drizzle-orm/mysql-core";
 //#region src/drizzle/mysql.d.ts
 type MysqlDrizzleColumn<TTableName extends string, TDefinition> = MySqlColumn<DrizzleColumnConfig<TTableName, TDefinition>>;

package/dist/drizzle-mysql.mjs

@@ -1,5 +1,5 @@
-import { t as createMysqlSchemaSnapshot } from "./mysql-DqkqXB6A.mjs";
-import { i as stringExtension, n as extensionData, t as convertDrizzleSchema } from "./runtime-BTr-MTlo.mjs";
+import { t as createMysqlSchemaSnapshot } from "./mysql-CKEKGnj4.mjs";
+import { i as stringExtension, n as extensionData, t as convertDrizzleSchema } from "./runtime-Cn_Xgzta.mjs";
 import { bigint, boolean, char, check, customType, date, datetime, decimal, foreignKey, index, int, json, mysqlSchema, mysqlTable, primaryKey, text, unique, uniqueIndex } from "drizzle-orm/mysql-core";
 //#region src/drizzle/mysql.ts
 const mysqlAdapter = {

package/dist/drizzle-postgres.d.mts

@@ -1,5 +1,5 @@
-import { Pt as AnyTable, Xr as Schema, ni as SchemaTableRecord } from "./types-4Q076HKo.mjs";
-import { r as DrizzleSchemaValidation, t as DrizzleColumnConfig } from "./types-H4vyCw8_.mjs";
+import { Lt as AnyTable, ei as Schema, oi as SchemaTableRecord } from "./types-Deo_q43Y.mjs";
+import { r as DrizzleSchemaValidation, t as DrizzleColumnConfig } from "./types-DZsueVoI.mjs";
 import { PgColumn, PgTableWithColumns } from "drizzle-orm/pg-core";
 //#region src/drizzle/postgres.d.ts
 type PostgresDrizzleColumn<TTableName extends string, TDefinition> = PgColumn<'custom', DrizzleColumnConfig<TTableName, TDefinition>>;

package/dist/drizzle-postgres.mjs

@@ -1,5 +1,5 @@
-import { t as createPostgresSchemaSnapshot } from "./postgres-DEBBeh52.mjs";
-import { i as stringExtension, n as extensionData, r as recordExtension, t as convertDrizzleSchema } from "./runtime-BTr-MTlo.mjs";
+import { t as createPostgresSchemaSnapshot } from "./postgres-BK2APkKP.mjs";
+import { i as stringExtension, n as extensionData, r as recordExtension, t as convertDrizzleSchema } from "./runtime-Cn_Xgzta.mjs";
 import { bigint, boolean, check, customType, date, foreignKey, index, integer, jsonb, numeric, pgSchema, pgTable, primaryKey, text, timestamp, unique, uniqueIndex, uuid } from "drizzle-orm/pg-core";
 //#region src/drizzle/postgres.ts
 const postgresAdapter = {

package/dist/drizzle-sqlite.d.mts

@@ -1,9 +1,42 @@
-import { Pt as AnyTable, Xr as Schema, ni as SchemaTableRecord } from "./types-4Q076HKo.mjs";
-import { r as DrizzleSchemaValidation, t as DrizzleColumnConfig } from "./types-H4vyCw8_.mjs";
+import { Lt as AnyTable, Uu as SqlTimestamp, ei as Schema, kc as ExternalDefaultDescriptor, oi as SchemaTableRecord, qs as NativeColumnStorage, ws as ColumnDefinition } from "./types-Deo_q43Y.mjs";
+import { r as DrizzleSchemaValidation, t as DrizzleColumnConfig } from "./types-DZsueVoI.mjs";
 import { SQLiteColumn, SQLiteTableWithColumns } from "drizzle-orm/sqlite-core";
 //#region src/drizzle/sqlite.d.ts
 type SqliteDrizzleColumn<TTableName extends string, TDefinition> = SQLiteColumn<DrizzleColumnConfig<TTableName, TDefinition>>;
 type SqliteDrizzleColumns<TTable extends AnyTable> = { [TKey in keyof TTable['definitions']]: SqliteDrizzleColumn<TTable['tableName'], TTable['definitions'][TKey]>; };
+/** Integer encoding used by Drizzle's SQLite timestamp column builder. */
+type SqliteTimestampMode = 'timestamp' | 'timestamp_ms';
+/** Runtime options for a Drizzle-compatible SQLite integer timestamp. */
+interface SqliteTimestampOptions {
+  /** Store Unix seconds by default, or milliseconds with `timestamp_ms`. */
+  readonly mode?: SqliteTimestampMode;
+  readonly nullable?: boolean;
+  readonly sqlName?: string;
+  /** Supply an application value when a Drizzle insert omits this column. */
+  readonly defaultFn?: () => Date;
+}
+type SqliteTimestampNullable<TOptions extends SqliteTimestampOptions> = TOptions extends {
+  readonly nullable: true;
+} ? true : false;
+type SqliteTimestampHasDefault<TOptions extends SqliteTimestampOptions> = TOptions extends {
+  readonly defaultFn: () => Date;
+} ? true : false;
+/** Qubu definition produced by {@link sqliteTimestamp}. */
+type SqliteTimestampColumn<TOptions extends SqliteTimestampOptions = {}> = ColumnDefinition<{
+  readonly output: Date;
+  readonly nullable: SqliteTimestampNullable<TOptions>;
+  readonly hasDefault: SqliteTimestampHasDefault<TOptions>;
+  readonly sqlType: SqlTimestamp;
+  readonly storage: NativeColumnStorage<'sqlite', 'INTEGER'>;
+  readonly default: SqliteTimestampHasDefault<TOptions> extends true ? ExternalDefaultDescriptor : undefined;
+}>;
+/**
+ * Declare a SQLite `INTEGER` timestamp that retains Drizzle's Date codec.
+ *
+ * @remarks `defaultFn` is runtime-only. Snapshots and emitted DDL retain the
+ * native `INTEGER` storage but do not serialize the callback.
+ */
+declare function sqliteTimestamp<const TOptions extends SqliteTimestampOptions = {}>(options?: TOptions): SqliteTimestampColumn<TOptions>;
 /** The Drizzle SQLite table produced for one Qubu table. */
 type SqliteDrizzleTable<TTable extends AnyTable> = SQLiteTableWithColumns<{
   name: TTable['tableName'];
@@ -21,4 +54,4 @@ type SqliteDrizzleSchema<TSchema extends Schema<any>> = { readonly [TKey in keyo
  */
 declare function toSqliteDrizzleSchema<const TTables extends SchemaTableRecord>(schema: Schema<TTables> & DrizzleSchemaValidation<TTables, 'sqlite'>): SqliteDrizzleSchema<Schema<TTables>>;
 //#endregion
-export { SqliteDrizzleSchema, SqliteDrizzleTable, toSqliteDrizzleSchema };
+export { SqliteDrizzleSchema, SqliteDrizzleTable, SqliteTimestampColumn, SqliteTimestampMode, SqliteTimestampOptions, sqliteTimestamp, toSqliteDrizzleSchema };