@b9g/zen 0.1.1 → 0.1.3

package/src/impl/template.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Template utilities for building SQL templates.
+ *
+ * This module provides the core primitives for the monadic template approach:
+ * - Templates are branded tuples: [strings, values]
+ * - Templates compose by merging (no string parsing)
+ * - Identifiers use ident() markers for deferred quoting
+ * - Rendering happens in drivers only
+ */
+declare const SQL_TEMPLATE: unique symbol;
+/**
+ * A SQL template as a branded tuple: [strings, ...values]
+ *
+ * Maintains invariant: strings.length === values.length + 1
+ *
+ * Access: template[0] for strings, template.slice(1) for values
+ * The strings array preserves .raw for TemplateStringsArray compatibility.
+ *
+ * This structure matches template tag function parameters, allowing templates
+ * to be directly applied to functions that accept (strings, ...values).
+ *
+ * Branded with symbol for injection protection - prevents user-crafted
+ * objects from being interpolated as raw SQL.
+ */
+export type SQLTemplate = readonly [TemplateStringsArray, ...unknown[]] & {
+    readonly [SQL_TEMPLATE]: true;
+};
+/**
+ * Create a SQL template from strings and values.
+ *
+ * @param strings - TemplateStringsArray (preserves .raw)
+ * @param values - Template values (identifiers, parameters, nested templates)
+ */
+export declare function createTemplate(strings: TemplateStringsArray, values?: readonly unknown[]): SQLTemplate;
+/**
+ * Check if a value is a SQL template.
+ */
+export declare function isSQLTemplate(value: unknown): value is SQLTemplate;
+declare const SQL_IDENT: unique symbol;
+/**
+ * SQL identifier (table name, column name) to be quoted by drivers.
+ *
+ * Identifiers flow through template composition unchanged.
+ * Quoting happens in drivers based on dialect:
+ * - MySQL: backticks (`name`)
+ * - PostgreSQL/SQLite: double quotes ("name")
+ */
+export interface SQLIdentifier {
+    readonly [SQL_IDENT]: true;
+    readonly name: string;
+}
+/**
+ * Create an SQL identifier marker.
+ * Drivers will quote this appropriately for their dialect.
+ */
+export declare function ident(name: string): SQLIdentifier;
+/**
+ * Check if a value is an SQL identifier marker.
+ */
+export declare function isSQLIdentifier(value: unknown): value is SQLIdentifier;
+/**
+ * Build a TemplateStringsArray from string parts.
+ * Used to construct templates programmatically while preserving the .raw property.
+ */
+export declare function makeTemplate(parts: string[]): TemplateStringsArray;
+/**
+ * Merge a template into an accumulator.
+ * Mutates the strings and values arrays in place.
+ *
+ * @param strings - Accumulator strings array (mutated)
+ * @param values - Accumulator values array (mutated)
+ * @param template - Template to merge (tuple format)
+ */
+export declare function mergeTemplate(strings: string[], values: unknown[], template: SQLTemplate): void;
+export {};

package/src/mysql.js

@@ -2,19 +2,19 @@
 import {
   quoteIdent,
   renderDDL
-} from "../chunk-W7JTNEM4.js";
+} from "./_chunks/chunk-2C6KOX4F.js";
 import {
   generateColumnDDL,
   generateDDL,
   generateViewDDL
-} from "../chunk-CHF7L5PC.js";
+} from "./_chunks/chunk-2R6FDKLS.js";
 import {
   ConstraintPreflightError,
   EnsureError,
   SchemaDriftError,
   getTableMeta,
   resolveSQLBuiltin
-} from "../chunk-XHXMCOSW.js";
+} from "./_chunks/chunk-DKLSJISE.js";
 
 // src/mysql.ts
 import {

package/src/postgres.js

@@ -2,19 +2,19 @@
 import {
   quoteIdent,
   renderDDL
-} from "../chunk-W7JTNEM4.js";
+} from "./_chunks/chunk-2C6KOX4F.js";
 import {
   generateColumnDDL,
   generateDDL,
   generateViewDDL
-} from "../chunk-CHF7L5PC.js";
+} from "./_chunks/chunk-2R6FDKLS.js";
 import {
   ConstraintPreflightError,
   EnsureError,
   SchemaDriftError,
   getTableMeta,
   resolveSQLBuiltin
-} from "../chunk-XHXMCOSW.js";
+} from "./_chunks/chunk-DKLSJISE.js";
 
 // src/postgres.ts
 import {

package/src/sqlite.js

@@ -2,19 +2,19 @@
 import {
   quoteIdent,
   renderDDL
-} from "../chunk-W7JTNEM4.js";
+} from "./_chunks/chunk-2C6KOX4F.js";
 import {
   generateColumnDDL,
   generateDDL,
   generateViewDDL
-} from "../chunk-CHF7L5PC.js";
+} from "./_chunks/chunk-2R6FDKLS.js";
 import {
   ConstraintPreflightError,
   EnsureError,
   SchemaDriftError,
   getTableMeta,
   resolveSQLBuiltin
-} from "../chunk-XHXMCOSW.js";
+} from "./_chunks/chunk-DKLSJISE.js";
 
 // src/sqlite.ts
 import {

package/src/zen.d.ts

@@ -5,10 +5,9 @@
  */
 import { z as zod } from "zod";
 export { zod as z };
-export { table, view, type Table, type View, type Queryable, type TableOptions, type Row, type Insert, type Update, type FieldMeta, type FieldType, type Relation, isView, getViewMeta, type ViewMeta, } from "./impl/table.js";
-export { Database, Transaction, DatabaseUpgradeEvent, type Driver, } from "./impl/database.js";
-export { CURRENT_TIMESTAMP, CURRENT_DATE, CURRENT_TIME, NOW, TODAY, isSQLBuiltin, } from "./impl/database.js";
-export { ident, isSQLIdentifier, } from "./impl/template.js";
-export { type SQLTemplate, isSQLTemplate, } from "./impl/template.js";
-export { type EnsureResult, } from "./impl/database.js";
-export { DatabaseError, ValidationError, TableDefinitionError, MigrationError, MigrationLockError, QueryError, NotFoundError, AlreadyExistsError, ConstraintViolationError, ConnectionError, TransactionError, EnsureError, SchemaDriftError, ConstraintPreflightError, isDatabaseError, hasErrorCode, type DatabaseErrorCode, type EnsureOperation, } from "./impl/errors.js";
+export { table, view, extendZod, isTable, isView, getViewMeta, type Table, type PartialTable, type DerivedTable, type View, type Queryable, type TableOptions, type Row, type Insert, type Update, type SetValues, type FieldMeta, type FieldType, type FieldDBMeta, type Relation, type ReferenceInfo, type CompoundReference, type ViewMeta, } from "./impl/table.js";
+export { Database, Transaction, DatabaseUpgradeEvent, type Driver, type TaggedQuery, type EnsureResult, } from "./impl/database.js";
+export { NOW, TODAY, CURRENT_TIMESTAMP, CURRENT_DATE, CURRENT_TIME, isSQLBuiltin, } from "./impl/database.js";
+export { ident, isSQLIdentifier, type SQLTemplate, isSQLTemplate, } from "./impl/template.js";
+export { type SQLDialect } from "./impl/sql.js";
+export { DatabaseError, isDatabaseError, hasErrorCode, ValidationError, TableDefinitionError, QueryError, NotFoundError, AlreadyExistsError, ConstraintViolationError, MigrationError, MigrationLockError, EnsureError, SchemaDriftError, ConstraintPreflightError, ConnectionError, TransactionError, type DatabaseErrorCode, type EnsureOperation, } from "./impl/errors.js";

package/src/zen.js

@@ -1,5 +1,5 @@
 /// <reference types="./zen.d.ts" />
-import "../chunk-W7JTNEM4.js";
+import "./_chunks/chunk-2C6KOX4F.js";
 import {
   AlreadyExistsError,
   CURRENT_DATE,
@@ -32,13 +32,14 @@ import {
   isSQLBuiltin,
   isSQLIdentifier,
   isSQLTemplate,
+  isTable,
   isView,
   makeTemplate,
   resolveSQLBuiltin,
   table,
   validateWithStandardSchema,
   view
-} from "../chunk-XHXMCOSW.js";
+} from "./_chunks/chunk-DKLSJISE.js";
 
 // src/zen.ts
 import { z as zod } from "zod";
@@ -2270,6 +2271,7 @@ export {
   Transaction,
   TransactionError,
   ValidationError,
+  extendZod,
   getViewMeta,
   hasErrorCode,
   ident,
@@ -2277,6 +2279,7 @@ export {
   isSQLBuiltin,
   isSQLIdentifier,
   isSQLTemplate,
+  isTable,
   isView,
   table,
   view,