@b9g/zen 0.1.2 → 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-NBXBBEMA.js";
+} from "./_chunks/chunk-2C6KOX4F.js";
 import {
   generateColumnDDL,
   generateDDL,
   generateViewDDL
-} from "../chunk-ARUUB3H4.js";
+} from "./_chunks/chunk-2R6FDKLS.js";
 import {
   ConstraintPreflightError,
   EnsureError,
   SchemaDriftError,
   getTableMeta,
   resolveSQLBuiltin
-} from "../chunk-BEX6VPES.js";
+} from "./_chunks/chunk-DKLSJISE.js";
 
 // src/mysql.ts
 import {

package/src/postgres.js

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

package/src/sqlite.js

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

package/src/zen.js

@@ -1,5 +1,5 @@
 /// <reference types="./zen.d.ts" />
-import "../chunk-NBXBBEMA.js";
+import "./_chunks/chunk-2C6KOX4F.js";
 import {
   AlreadyExistsError,
   CURRENT_DATE,
@@ -39,7 +39,7 @@ import {
   table,
   validateWithStandardSchema,
   view
-} from "../chunk-BEX6VPES.js";
+} from "./_chunks/chunk-DKLSJISE.js";
 
 // src/zen.ts
 import { z as zod } from "zod";