@vibeorm/sql 5.9.0 → 5.10.0

package/dist/dialects/sqlite-index-expressions.d.ts

@@ -1,25 +1,2 @@
-import type { IndexKeyOperand } from "../index-expressions.ts";
-import type { TableDefinitionToken } from "./sqlite-table-definition.ts";
-/** Exact outer-key slices shared by CREATE INDEX and MySQL table-key clauses. */
-export declare function extractIndexKeyList({ sql, open, close, tokens, wrapped, removeWrapper }: {
-    readonly sql: string;
-    readonly open: TableDefinitionToken;
-    readonly close: TableDefinitionToken;
-    readonly tokens: readonly TableDefinitionToken[];
-    readonly wrapped?: boolean;
-    readonly removeWrapper?: boolean;
-}): readonly IndexKeyOperand[] | undefined;
-/** Parse the CREATE INDEX header without interpreting any scalar expression. */
-export declare function extractStandaloneIndexKeys({ definition, index, postgres, included }: {
-    readonly definition: string;
-    readonly index: string;
-    readonly postgres?: boolean;
-    /** PostgreSQL INCLUDE columns the caller read from the catalog (default none). */
-    readonly included?: number;
-}): readonly IndexKeyOperand[] | undefined;
-/** SQLite source spelling is the evidence; CAST alone never proves a plain Decimal key. */
-export declare function extractSqliteIndexKeys({ definition, index }: {
-    readonly definition: string;
-    readonly index: string;
-}): readonly IndexKeyOperand[] | undefined;
+export {};
 //# sourceMappingURL=sqlite-index-expressions.d.ts.map

package/dist/dialects/sqlite-json-equality.d.ts

@@ -1,15 +1,2 @@
-import type { SqlDialect } from "../dialect.ts";
-/**
- * Compare both JSON trees by decoded key/index paths, node type and atomic value.
- * Object order and JSON escape spelling do not matter; array positions do.
- * Container nodes retain empty-object/array distinctions, and multiplicity stops
- * duplicate object members from disappearing as they would in a set difference.
- * SQL NULL remains unknown. The tree input is guarded against non-JSON scalar
- * text even when SQLite evaluates this expression before the outer type guard.
- */
-export declare function renderSqliteJsonEquality(params: {
-    dialect: SqlDialect;
-    left: string;
-    right: string;
-}): string;
+export {};
 //# sourceMappingURL=sqlite-json-equality.d.ts.map

package/dist/dialects/sqlite-row-rules.d.ts

@@ -1,8 +1,2 @@
-import type { SqlDialect } from "../dialect.ts";
-import type { EventRowRuleContext, RenderedRowRule } from "../row-rules.ts";
-/** Emit literal-only ABORT diagnostics and one unfiltered BEFORE trigger per event. */
-export declare function renderSqliteRowRule({ dialect, context }: {
-    readonly dialect: SqlDialect;
-    readonly context: EventRowRuleContext;
-}): RenderedRowRule;
+export {};
 //# sourceMappingURL=sqlite-row-rules.d.ts.map

package/dist/dialects/sqlite-table-definition.d.ts

@@ -8,30 +8,11 @@ export type TableDefinitionParts = {
     readonly clauses: readonly string[];
     readonly suffix: string;
 };
-/** A source token with balanced-parenthesis depth and original byte boundaries. */
-export type TableDefinitionToken = {
-    readonly value: string;
-    readonly kind: "word" | "quoted" | "literal" | "symbol";
-    readonly start: number;
-    readonly end: number;
-    readonly depth: number;
-};
-/** Scan SQL delimiters without looking inside quoted strings, identifiers or comments. */
-export declare function tableDefinitionTokens({ sql, backslashEscapes }: {
-    readonly sql: string;
-    readonly backslashEscapes?: boolean;
-}): readonly TableDefinitionToken[];
 /** Extract a CREATE TABLE list with a quote/comment-aware delimiter walk. */
 export declare function tableDefinitionParts({ sql, backslashEscapes }: {
     readonly sql: string;
     readonly backslashEscapes?: boolean;
 }): TableDefinitionParts;
-/** Read column names for SQLite source and MySQL SHOW CREATE using the same lexer. */
-export declare function tableColumnClauses({ sql, backslashEscapes, mysql }: {
-    readonly sql: string;
-    readonly backslashEscapes?: boolean;
-    readonly mysql?: boolean;
-}): readonly SqliteColumnClause[];
 /** Return column clauses without rewriting any SQL inside them. */
 export declare function sqliteColumnClauses({ sql }: {
     readonly sql: string;

package/dist/dialects/test-databases.d.ts

@@ -0,0 +1,96 @@
+import type { Dialect } from "@vibeorm/schema";
+import type { SqlDialect } from "../dialect.ts";
+import type { RenderedQuery } from "../render.ts";
+/**
+ * Which dialects can copy a migrated database on the server. PostgreSQL clones
+ * a template database (`CREATE DATABASE … TEMPLATE`). MySQL has no template
+ * databases, and its only server-side copy (`CREATE TABLE … LIKE`) leaves the
+ * foreign keys behind; SQLite copies files and sends no SQL for it.
+ */
+export declare const TEST_DATABASE_CAPABILITIES: Readonly<Record<Dialect, Readonly<{
+    templateDatabases: boolean;
+}>>>;
+/**
+ * A caller's test-database prefix: lower-case, a plain identifier start, and
+ * the word `test` in it, so a prefix cannot name an application's databases.
+ */
+export declare const TEST_DATABASE_PREFIX_PATTERN: RegExp;
+/** What a test-database name is, by its shape under one prefix. */
+export type TestDatabaseKind = "template" | "clone";
+/** `undefined` for a valid prefix, else why it is refused. */
+export declare function testDatabasePrefixIssue(params: {
+    prefix: unknown;
+}): string | undefined;
+/** The kind of a database name under `prefix`, or `undefined` for every other name. */
+export declare function testDatabaseKind(params: {
+    prefix: string;
+    name: string;
+}): TestDatabaseKind | undefined;
+/** When a clone was created (ms since the epoch, the creating process's clock), read from its name. */
+export declare function testCloneCreatedAt(params: {
+    prefix: string;
+    name: string;
+}): number | undefined;
+/** The template marker's creation time (server milliseconds), or `undefined` for any other comment. */
+export declare function parseTestTemplateMarker(params: {
+    text: unknown;
+}): number | undefined;
+/** Test-database statements on the administration connection. */
+export type TestDatabaseOperation = 
+/**
+ * One row whether or not the database exists: its template flag (null when
+ * absent), its comment, the sessions connected to it other than this one, and
+ * the server clock in milliseconds.
+ */
+{
+    readonly kind: "state";
+    readonly prefix: string;
+    readonly name: string;
+}
+/** An empty database to build a template in. */
+ | {
+    readonly kind: "createTemplate";
+    readonly prefix: string;
+    readonly name: string;
+}
+/** The template's creation time (server milliseconds), as its database comment. */
+ | {
+    readonly kind: "markTemplate";
+    readonly prefix: string;
+    readonly name: string;
+    readonly created: number;
+}
+/**
+ * Set: the build's last step and the ready signal — a template that refuses
+ * connections, because one connection to it blocks every clone. Cleared before
+ * a template is dropped.
+ */
+ | {
+    readonly kind: "flagTemplate";
+    readonly prefix: string;
+    readonly name: string;
+    readonly template: boolean;
+} | {
+    readonly kind: "clone";
+    readonly prefix: string;
+    readonly name: string;
+    readonly template: string;
+}
+/** `force` (PostgreSQL 13+) ends the sessions still connected; only a clone may be forced. */
+ | {
+    readonly kind: "drop";
+    readonly prefix: string;
+    readonly name: string;
+    readonly force?: boolean;
+}
+/** Every database whose name starts with the prefix, its template flag, comment and other sessions, and the server clock. */
+ | {
+    readonly kind: "list";
+    readonly prefix: string;
+};
+/** Render one test-database statement; dialects without template databases refuse. */
+export declare function renderTestDatabaseOperation(params: {
+    dialect: SqlDialect;
+    operation: TestDatabaseOperation;
+}): RenderedQuery;
+//# sourceMappingURL=test-databases.d.ts.map

package/dist/expr-fragment.d.ts

@@ -0,0 +1,13 @@
+import type { SqlExpr } from "./ast.ts";
+import type { SqlFragment } from "./composable.ts";
+import type { SqlDialect } from "./dialect.ts";
+/**
+ * A compiled boolean expression as an opaque fragment for the caller's own
+ * statement: the text the dialect renders, every bound value a fragment
+ * value, so the enclosing statement numbers the placeholders.
+ */
+export declare function exprToFragment(params: {
+    dialect: SqlDialect;
+    expr: SqlExpr;
+}): SqlFragment;
+//# sourceMappingURL=expr-fragment.d.ts.map

package/dist/identifiers.d.ts

@@ -7,8 +7,5 @@
  * containing one is not an identifier at all. Refused at render time, the
  * earliest point every path (IR, raw `sql.ident`, extension DDL) shares.
  */
-/** Return `name` unchanged, or throw `VIBE_VALIDATION` when it contains a NUL. */
-export declare function assertNoNul(params: {
-    name: string;
-}): string;
+export {};
 //# sourceMappingURL=identifiers.d.ts.map

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { cloneTimestampDate, compareTimestampDates, timestampIdentityKey, timestampIdentityText } from "./timestamp-identity.ts";
+export { parsePlainTimestampText } from "./timestamp-text.ts";
 export { nativeEnumArrayParameter, isNativeEnumArrayParameter } from "./native-enum-parameter.ts";
 export type { NativeEnumArrayParameter } from "./native-enum-parameter.ts";
 export { isJsonListParameter, jsonListParameter } from "./json-list-parameter.ts";
@@ -21,12 +22,15 @@ export { renderReplayCoverageGaps } from "./dialects/migration-replay-coverage.t
 export { SHADOW_DATABASE, SHADOW_CAPABILITIES, renderShadowOperation } from "./dialects/migration-shadow.ts";
 export { AUTOMATIC_SHADOW_NAME_PATTERN, SHADOW_MARKER_CAPABILITIES, automaticShadowMarkerText, parseAutomaticShadowMarker, renderAutomaticShadowOperation } from "./dialects/migration-shadow-marker.ts";
 export type { AutomaticShadowMarker, AutomaticShadowOperation } from "./dialects/migration-shadow-marker.ts";
+export { TEST_DATABASE_CAPABILITIES, TEST_DATABASE_PREFIX_PATTERN, parseTestTemplateMarker, renderTestDatabaseOperation, testCloneCreatedAt, testDatabaseKind, testDatabasePrefixIssue } from "./dialects/test-databases.ts";
+export type { TestDatabaseKind, TestDatabaseOperation } from "./dialects/test-databases.ts";
 export type { ShadowOperation } from "./dialects/migration-shadow.ts";
 export { MODULE_JOURNAL_COLUMN, renderModuleJournal } from "./module-journal.ts";
 export { renderSqliteFtsUpdateTrigger, sqliteFtsUpdateUpgrade } from "./dialects/sqlite-fts.ts";
 export { SQLITE_SESSION_SQL } from "./dialects/sqlite-session.ts";
-export { sql, isSqlFragment, renderSqlFragment, compileSql, sqlUsesIncoming, mapConflictColumns } from "./composable.ts";
+export { sql, isSqlFragment, renderSqlFragment, compileSql, sqlUsesIncoming, mapConflictColumns, captureSqlTemplate, compileSqlTemplate, PlainSqlTemplate } from "./composable.ts";
 export { registerSqlHandleCheck } from "./sql-handles.ts";
+export { exprToFragment } from "./expr-fragment.ts";
 export type { SqlFragment, SqlTag } from "./composable.ts";
 export { createSqlQuery, createSqlCommand, isSqlQuery, isSqlCommand, compileSqlQuery, compileSqlCommand } from "./query-plan.ts";
 export type { SqlQuery, SqlCommand, SqlPlanRender, CompiledSqlQuery, CompiledSqlCommand, ReusableSqlQuery, ReusableSqlCommand } from "./query-plan.ts";
@@ -35,7 +39,7 @@ export { isSqlParam, createSqlInput, sqlInputContract, createSqlInputScope, seal
 export type { SqlParam, SqlInput, SqlInputMap, SqlInputValue, SqlInputValues, SqlInputTokens, SqlExecutionParams, SqlInputContract, SqlInputScope } from "./sql-input.ts";
 export { isSqlBindingCollector, recordSqlBinding, recordSqlBindingCheck } from "./sql-bindings.ts";
 export type { SqlBindingSource, SqlParameterTransport, SqlBindingEncoder } from "./sql-bindings.ts";
-export { decode, encode, resultScalarContract, sameResultDecoder } from "./result-decoder.ts";
+export { decode, decodeResultColumn, encode, resultScalarContract, sameResultDecoder } from "./result-decoder.ts";
 export type { ResultDecoder, ResultReadDecoder, ResultParameterEncoder, ResultScalarContract, Decoded, ExtendedDateTime } from "./result-decoder.ts";
 /**
  * @vibeorm/sql — dialect-aware SQL layer for VibeORM v2.
@@ -44,7 +48,7 @@ export type { ResultDecoder, ResultReadDecoder, ResultParameterEncoder, ResultSc
  * lives in this package; see the root sql-catalog.md for the reviewable surface.
  */
 export { compileExclusion, renderExclusionSetup, renderExclusionDdl, renderExclusionCatalog, renderExclusionProbe } from "./exclusion.ts";
-export type { AdvisoryLockKey, AdvisoryLockStatement, AdvisoryLocksStatement, AggFn, AggRef, AggSelect, ChainResult, ChainRowSource, ChainCapture, CaptureReturningColumn, CaptureCascade, CaptureCascadeReturningColumn, CaptureCell, CaptureHop, OtherRowReturningColumn, ChainStatement, ChainStep, ChainStepStatement, ChainTally, ChainVeto, ColRef, ComparisonOp, DateTruncation, GroupKeyExpression, GroupingSets, CountSubquery, ScalarSubquery, DeleteStatement, ExcludedRef, InnerJoin, KeyListMember, KeyPage, KeyRows, KeyTableJoin, KeyTableMember, InsertSelectStatement, InsertStatement, ReturningColumn, JsonFilterOp, LateralJoin, LeftJoin, ListSetOperation, OnConflictClause, OnConflictDoNothing, OnConflictUpdate, OrderByAggregate, OrderByColumn, OrderBySubquery, OrderTerm, RowLock, RowNumberProjection, DbNowMarker, JsonParamCell, SelectExpr, SelectStatement, SetOperation, SetOperator, SqlExpr, SqlStatement, StepColumnRef, SourceColumnRef, UpdateSource, UpdateTableSource, UpdateSelectSource, TableRef, UpdateStatement, } from "./ast.ts";
+export type { AdvisoryLockKey, AdvisoryLockStatement, AdvisoryLocksStatement, AggFn, AggRef, AggSelect, ChainResult, ChainRowSource, ChainCapture, CaptureReturningColumn, CaptureCascade, CaptureCascadeReturningColumn, CaptureCell, CaptureHop, OtherRowReturningColumn, ServerVersionReturningColumn, ChainStatement, ChainStep, ChainStepStatement, ChainTally, ChainVeto, ColRef, ComparisonOp, DateTruncation, GroupKeyExpression, GroupingSets, CountSubquery, ScalarSubquery, DeleteStatement, ExcludedRef, InnerJoin, KeyListMember, KeyPage, KeyRows, KeyTableJoin, KeyTableMember, InsertSelectStatement, InsertStatement, ReturningColumn, JsonFilterOp, LateralJoin, LeftJoin, ListSetOperation, OnConflictClause, OnConflictDoNothing, UnchangedColumn, UnchangedExactness, OnConflictUpdate, OrderByAggregate, OrderByColumn, OrderBySubquery, OrderTerm, RowLock, RowNumberProjection, DbNowMarker, JsonParamCell, SelectExpr, SelectStatement, SetOperation, SetOperator, SqlExpr, SqlStatement, StepColumnRef, SourceColumnRef, UpdateSource, UpdateTableSource, UpdateSelectSource, TableRef, UpdateStatement, } from "./ast.ts";
 export { ADVISORY_LOCK_RESULT_COLUMN, CHAIN_VETO_PREFIX, CHAIN_VETO_TOKEN_PATTERN, COALESCE_REF_NAME, SQL_DEFAULT_CELL, SQL_KEEP_CELL, chainVetoToken, coalesceRef, dbNowMarker, excludedRef, isDbNowMarker, isExcludedRef, isJsonParamCell, isListSetOperation, isSetOperation, isSqlDefaultCell, isSqlKeepCell, isStepColumnRef, isSourceColumnRef, sourceColumnRef, isCaptureReturningColumn, isOtherRowReturningColumn, jsonParamCell, returningColumnName, stepColumnRef, } from "./ast.ts";
 export type { AdvisoryLockFunctions, AdvisoryLockModeFunctions, RowLockSyntax, EmptyInsertSyntax, SqlDialect, } from "./dialect.ts";
 export { ADVISORY_KEY_BOUNDS, describeRowLock, renderAdvisoryLock, renderAdvisoryLocks, renderRowLockClause } from "./locks.ts";
@@ -70,8 +74,8 @@ export { renderRowRule } from "./row-rules.ts";
 export type { RenderedRowRule, RowRuleStatement, RowRuleTriggerPlacement } from "./row-rules.ts";
 export type { PredicateModel, PredicateUsage } from "./predicate.ts";
 export { DIALECT_CAPABILITIES, MYSQL_CAPABILITIES, POSTGRES_CAPABILITIES, SQLITE_CAPABILITIES, } from "./capabilities.ts";
-export { DIALECT_CODECS, MYSQL_CODECS, POSTGRES_CODECS, SQLITE_CODECS, decodeIsNoop, decodedDateTimeRefusal, enumMembershipCodec, float32Codec, localDateCodec, parseDateTimeText, parseExtendedDateTimeText, parseJsonText, postgresArrayElementFromText, shortestFloat32, timeOfDayCodec, } from "./codecs.ts";
-export type { CodecTable, ScalarCodec, WireFidelity } from "./codecs.ts";
+export { DIALECT_CODECS, MYSQL_CODECS, POSTGRES_CODECS, SQLITE_CODECS, dateTimeTextLayoutError, decodeIsNoop, decodedDateTimeRefusal, undecodableDateTimeText, enumMembershipCodec, float32Codec, localDateCodec, parseDateTimeText, parseExtendedDateTimeText, parseJsonText, postgresArrayElementFromText, shortestFloat32, timeOfDayCodec, dateOnlyCodec, dateTimeZoneKey, mysqlBoundTimestampText, parseZoneLessDateTime, zonedCodec, } from "./codecs.ts";
+export type { CodecTable, DateTimeZone, ScalarCodec, WireFidelity } from "./codecs.ts";
 export { isRollupChain, renderExpr, renderFragment, renderProjection, renderStatement } from "./render.ts";
 export type { RenderedQuery } from "./render.ts";
 export { snapshotSqlValue } from "./parameter-snapshot.ts";