@b9g/zen 0.1.0 → 0.1.2

package/src/mysql.js

@@ -2,18 +2,19 @@
 import {
   quoteIdent,
   renderDDL
-} from "../chunk-2IEEEMRN.js";
+} from "../chunk-NBXBBEMA.js";
 import {
   generateColumnDDL,
-  generateDDL
-} from "../chunk-QXGEP5PB.js";
+  generateDDL,
+  generateViewDDL
+} from "../chunk-ARUUB3H4.js";
 import {
   ConstraintPreflightError,
   EnsureError,
   SchemaDriftError,
   getTableMeta,
   resolveSQLBuiltin
-} from "../chunk-56M5Z3A6.js";
+} from "../chunk-BEX6VPES.js";
 
 // src/mysql.ts
 import {
@@ -143,13 +144,86 @@ var MySQLDriver = class {
   async close() {
     await this.#pool.end();
   }
+  // ==========================================================================
+  // Type Encoding/Decoding
+  // ==========================================================================
+  /**
+   * Encode a JS value for database insertion.
+   * MySQL: needs conversion for Date and boolean.
+   */
+  encodeValue(value, fieldType) {
+    if (value === null || value === void 0) {
+      return value;
+    }
+    switch (fieldType) {
+      case "datetime":
+        if (value instanceof Date && !isNaN(value.getTime())) {
+          return value.toISOString().replace("T", " ").slice(0, 23);
+        }
+        return value;
+      case "boolean":
+        return value ? 1 : 0;
+      case "json":
+        return JSON.stringify(value);
+      default:
+        return value;
+    }
+  }
+  /**
+   * Decode a database value to JS.
+   * MySQL: handles 0/1 booleans and datetime strings.
+   */
+  decodeValue(value, fieldType) {
+    if (value === null || value === void 0) {
+      return value;
+    }
+    switch (fieldType) {
+      case "datetime":
+        if (value instanceof Date) {
+          if (isNaN(value.getTime())) {
+            throw new Error(`Invalid Date object received from database`);
+          }
+          return value;
+        }
+        if (typeof value === "string") {
+          const normalized = value.includes("T") ? value : value.replace(" ", "T") + "Z";
+          const date = new Date(normalized);
+          if (isNaN(date.getTime())) {
+            throw new Error(
+              `Invalid date value: "${value}" cannot be parsed as a valid date`
+            );
+          }
+          return date;
+        }
+        return value;
+      case "boolean":
+        if (typeof value === "number") {
+          return value !== 0;
+        }
+        if (typeof value === "string") {
+          return value !== "0" && value !== "";
+        }
+        return value;
+      case "json":
+        if (typeof value === "string") {
+          return JSON.parse(value);
+        }
+        return value;
+      default:
+        return value;
+    }
+  }
   async transaction(fn) {
     const connection = await this.#pool.getConnection();
     const handleError = this.#handleError.bind(this);
+    const encodeValue = this.encodeValue.bind(this);
+    const decodeValue = this.decodeValue.bind(this);
     try {
       await connection.query("START TRANSACTION");
       const txDriver = {
         supportsReturning: false,
+        encodeValue,
+        decodeValue,
         all: async (strings, values) => {
           try {
             const { sql, params } = buildSQL(strings, values);
@@ -234,6 +308,12 @@ var MySQLDriver = class {
    * Throws SchemaDriftError if constraints are missing.
    */
   async ensureTable(table) {
+    const meta = getTableMeta(table);
+    if (meta.isView) {
+      throw new Error(
+        `Cannot ensure view "${table.name}". Use the base table "${meta.viewOf}" instead.`
+      );
+    }
     const tableName = table.name;
     let step = 0;
     let applied = false;
@@ -257,6 +337,9 @@ var MySQLDriver = class {
         step = 4;
         await this.#checkMissingConstraints(table);
       }
+      step = 5;
+      const viewsApplied = await this.#ensureViews(table);
+      applied = applied || viewsApplied;
       return { applied };
     } catch (error) {
       if (error instanceof SchemaDriftError || error instanceof ConstraintPreflightError) {
@@ -275,11 +358,45 @@ var MySQLDriver = class {
       );
     }
   }
+  async ensureView(viewObj) {
+    const ddlTemplate = generateViewDDL(viewObj, { dialect: DIALECT });
+    const ddlSQL = renderDDL(ddlTemplate[0], ddlTemplate.slice(1), DIALECT);
+    for (const stmt of ddlSQL.split(";").filter((s) => s.trim())) {
+      await this.#pool.execute(stmt.trim(), []);
+    }
+    return { applied: true };
+  }
+  /**
+   * Ensure the active view exists for this table (if it has soft delete).
+   * Creates the view using generateViewDDL.
+   */
+  async #ensureViews(table) {
+    const meta = getTableMeta(table);
+    if (meta.softDeleteField && !meta.activeView) {
+      void table.active;
+    }
+    const activeView = meta.activeView;
+    if (!activeView) {
+      return false;
+    }
+    const ddlTemplate = generateViewDDL(activeView, { dialect: DIALECT });
+    const ddlSQL = renderDDL(ddlTemplate[0], ddlTemplate.slice(1), DIALECT);
+    for (const stmt of ddlSQL.split(";").filter((s) => s.trim())) {
+      await this.#pool.execute(stmt.trim(), []);
+    }
+    return true;
+  }
   /**
    * Ensure constraints exist on the table.
    * Applies unique and foreign key constraints with preflight checks.
    */
   async ensureConstraints(table) {
+    const meta = getTableMeta(table);
+    if (meta.isView) {
+      throw new Error(
+        `Cannot ensure view "${table.name}". Use the base table "${meta.viewOf}" instead.`
+      );
+    }
     const tableName = table.name;
     let step = 0;
     let applied = false;

package/src/postgres.d.ts

@@ -7,6 +7,7 @@
  * Requires: postgres
  */
 import type { Driver, Table, EnsureResult } from "./zen.js";
+import type { View } from "./impl/table.js";
 /**
  * Options for the postgres adapter.
  */
@@ -46,6 +47,16 @@ export default class PostgresDriver implements Driver {
     run(strings: TemplateStringsArray, values: unknown[]): Promise<number>;
     val<T>(strings: TemplateStringsArray, values: unknown[]): Promise<T | null>;
     close(): Promise<void>;
+    /**
+     * Encode a JS value for database insertion.
+     * PostgreSQL: postgres.js library handles Date and boolean natively.
+     */
+    encodeValue(value: unknown, fieldType: string): unknown;
+    /**
+     * Decode a database value to JS.
+     * PostgreSQL: postgres.js returns proper types for most things.
+     */
+    decodeValue(value: unknown, fieldType: string): unknown;
     transaction<T>(fn: (txDriver: Driver) => Promise<T>): Promise<T>;
     withMigrationLock<T>(fn: () => Promise<T>): Promise<T>;
     /**
@@ -54,6 +65,7 @@ export default class PostgresDriver implements Driver {
      * Throws SchemaDriftError if constraints are missing.
      */
     ensureTable<T extends Table<any>>(table: T): Promise<EnsureResult>;
+    ensureView<T extends View<any>>(viewObj: T): Promise<EnsureResult>;
     /**
      * Ensure constraints exist on the table.
      * Applies unique and foreign key constraints with preflight checks.

package/src/postgres.js

@@ -2,18 +2,19 @@
 import {
   quoteIdent,
   renderDDL
-} from "../chunk-2IEEEMRN.js";
+} from "../chunk-NBXBBEMA.js";
 import {
   generateColumnDDL,
-  generateDDL
-} from "../chunk-QXGEP5PB.js";
+  generateDDL,
+  generateViewDDL
+} from "../chunk-ARUUB3H4.js";
 import {
   ConstraintPreflightError,
   EnsureError,
   SchemaDriftError,
   getTableMeta,
   resolveSQLBuiltin
-} from "../chunk-56M5Z3A6.js";
+} from "../chunk-BEX6VPES.js";
 
 // src/postgres.ts
 import {
@@ -132,11 +133,64 @@ var PostgresDriver = class {
   async close() {
     await this.#sql.end();
   }
+  // ==========================================================================
+  // Type Encoding/Decoding
+  // ==========================================================================
+  /**
+   * Encode a JS value for database insertion.
+   * PostgreSQL: postgres.js library handles Date and boolean natively.
+   */
+  encodeValue(value, fieldType) {
+    if (value === null || value === void 0) {
+      return value;
+    }
+    switch (fieldType) {
+      case "datetime":
+        return value;
+      case "boolean":
+        return value;
+      case "json":
+        return JSON.stringify(value);
+      default:
+        return value;
+    }
+  }
+  /**
+   * Decode a database value to JS.
+   * PostgreSQL: postgres.js returns proper types for most things.
+   */
+  decodeValue(value, fieldType) {
+    if (value === null || value === void 0) {
+      return value;
+    }
+    switch (fieldType) {
+      case "datetime":
+        if (value instanceof Date) {
+          if (isNaN(value.getTime())) {
+            throw new Error(`Invalid Date object received from database`);
+          }
+        }
+        return value;
+      case "boolean":
+        return value;
+      case "json":
+        if (typeof value === "string") {
+          return JSON.parse(value);
+        }
+        return value;
+      default:
+        return value;
+    }
+  }
   async transaction(fn) {
     const handleError = this.#handleError.bind(this);
+    const encodeValue = this.encodeValue.bind(this);
+    const decodeValue = this.decodeValue.bind(this);
     const result = await this.#sql.begin(async (txSql) => {
       const txDriver = {
         supportsReturning: true,
+        encodeValue,
+        decodeValue,
         all: async (strings, values) => {
           try {
             const { sql, params } = buildSQL(strings, values);
@@ -205,6 +259,12 @@ var PostgresDriver = class {
    * Throws SchemaDriftError if constraints are missing.
    */
   async ensureTable(table) {
+    const meta = getTableMeta(table);
+    if (meta.isView) {
+      throw new Error(
+        `Cannot ensure view "${table.name}". Use the base table "${meta.viewOf}" instead.`
+      );
+    }
     const tableName = table.name;
     let step = 0;
     let applied = false;
@@ -228,6 +288,9 @@ var PostgresDriver = class {
         step = 4;
         await this.#checkMissingConstraints(table);
       }
+      step = 5;
+      const viewsApplied = await this.#ensureViews(table);
+      applied = applied || viewsApplied;
       return { applied };
     } catch (error) {
       if (error instanceof SchemaDriftError || error instanceof ConstraintPreflightError) {
@@ -246,11 +309,45 @@ var PostgresDriver = class {
       );
     }
   }
+  async ensureView(viewObj) {
+    const ddlTemplate = generateViewDDL(viewObj, { dialect: DIALECT });
+    const ddlSQL = renderDDL(ddlTemplate[0], ddlTemplate.slice(1), DIALECT);
+    for (const stmt of ddlSQL.split(";").filter((s) => s.trim())) {
+      await this.#sql.unsafe(stmt.trim());
+    }
+    return { applied: true };
+  }
+  /**
+   * Ensure the active view exists for this table (if it has soft delete).
+   * Creates the view using generateViewDDL.
+   */
+  async #ensureViews(table) {
+    const meta = getTableMeta(table);
+    if (meta.softDeleteField && !meta.activeView) {
+      void table.active;
+    }
+    const activeView = meta.activeView;
+    if (!activeView) {
+      return false;
+    }
+    const ddlTemplate = generateViewDDL(activeView, { dialect: DIALECT });
+    const ddlSQL = renderDDL(ddlTemplate[0], ddlTemplate.slice(1), DIALECT);
+    for (const stmt of ddlSQL.split(";").filter((s) => s.trim())) {
+      await this.#sql.unsafe(stmt.trim());
+    }
+    return true;
+  }
   /**
    * Ensure constraints exist on the table.
    * Applies unique and foreign key constraints with preflight checks.
    */
   async ensureConstraints(table) {
+    const meta = getTableMeta(table);
+    if (meta.isView) {
+      throw new Error(
+        `Cannot ensure view "${table.name}". Use the base table "${meta.viewOf}" instead.`
+      );
+    }
     const tableName = table.name;
     let step = 0;
     let applied = false;

package/src/sqlite.d.ts

@@ -7,7 +7,7 @@
  * Requires: better-sqlite3
  */
 import type { Driver, EnsureResult } from "./zen.js";
-import type { Table } from "./impl/table.js";
+import type { Table, View } from "./impl/table.js";
 /**
  * SQLite driver using better-sqlite3.
  *
@@ -36,8 +36,19 @@ export default class SQLiteDriver implements Driver {
     run(strings: TemplateStringsArray, values: unknown[]): Promise<number>;
     val<T>(strings: TemplateStringsArray, values: unknown[]): Promise<T | null>;
     close(): Promise<void>;
+    /**
+     * Encode a JS value for database insertion.
+     * SQLite: needs conversion for Date and boolean.
+     */
+    encodeValue(value: unknown, fieldType: string): unknown;
+    /**
+     * Decode a database value to JS.
+     * SQLite: handles 0/1 booleans and datetime strings.
+     */
+    decodeValue(value: unknown, fieldType: string): unknown;
     transaction<T>(fn: (txDriver: Driver) => Promise<T>): Promise<T>;
     withMigrationLock<T>(fn: () => Promise<T>): Promise<T>;
     ensureTable<T extends Table<any>>(table: T): Promise<EnsureResult>;
+    ensureView<T extends View<any>>(viewObj: T): Promise<EnsureResult>;
     ensureConstraints<T extends Table<any>>(table: T): Promise<EnsureResult>;
 }

package/src/sqlite.js

@@ -2,18 +2,19 @@
 import {
   quoteIdent,
   renderDDL
-} from "../chunk-2IEEEMRN.js";
+} from "../chunk-NBXBBEMA.js";
 import {
   generateColumnDDL,
-  generateDDL
-} from "../chunk-QXGEP5PB.js";
+  generateDDL,
+  generateViewDDL
+} from "../chunk-ARUUB3H4.js";
 import {
   ConstraintPreflightError,
   EnsureError,
   SchemaDriftError,
   getTableMeta,
   resolveSQLBuiltin
-} from "../chunk-56M5Z3A6.js";
+} from "../chunk-BEX6VPES.js";
 
 // src/sqlite.ts
 import {
@@ -129,6 +130,71 @@ var SQLiteDriver = class {
   async close() {
     this.#db.close();
   }
+  // ==========================================================================
+  // Type Encoding/Decoding
+  // ==========================================================================
+  /**
+   * Encode a JS value for database insertion.
+   * SQLite: needs conversion for Date and boolean.
+   */
+  encodeValue(value, fieldType) {
+    if (value === null || value === void 0) {
+      return value;
+    }
+    switch (fieldType) {
+      case "datetime":
+        if (value instanceof Date && !isNaN(value.getTime())) {
+          return value.toISOString();
+        }
+        return value;
+      case "boolean":
+        return value ? 1 : 0;
+      case "json":
+        return JSON.stringify(value);
+      default:
+        return value;
+    }
+  }
+  /**
+   * Decode a database value to JS.
+   * SQLite: handles 0/1 booleans and datetime strings.
+   */
+  decodeValue(value, fieldType) {
+    if (value === null || value === void 0) {
+      return value;
+    }
+    switch (fieldType) {
+      case "datetime":
+        if (value instanceof Date) {
+          if (isNaN(value.getTime())) {
+            throw new Error(`Invalid Date object received from database`);
+          }
+          return value;
+        }
+        if (typeof value === "string") {
+          const date = new Date(value);
+          if (isNaN(date.getTime())) {
+            throw new Error(
+              `Invalid date value: "${value}" cannot be parsed as a valid date`
+            );
+          }
+          return date;
+        }
+        return value;
+      case "boolean":
+        if (typeof value === "number") {
+          return value !== 0;
+        }
+        return value;
+      case "json":
+        if (typeof value === "string") {
+          return JSON.parse(value);
+        }
+        return value;
+      default:
+        return value;
+    }
+  }
   async transaction(fn) {
     this.#db.exec("BEGIN");
     try {
@@ -155,6 +221,12 @@ var SQLiteDriver = class {
   // Schema Management
   // ==========================================================================
   async ensureTable(table) {
+    const meta = getTableMeta(table);
+    if (meta.isView) {
+      throw new Error(
+        `Cannot ensure view "${table.name}". Use the base table "${meta.viewOf}" instead.`
+      );
+    }
     const tableName = table.name;
     let step = 0;
     let applied = false;
@@ -178,6 +250,9 @@ var SQLiteDriver = class {
         step = 4;
         await this.#checkMissingConstraints(table);
       }
+      step = 5;
+      const viewsApplied = await this.#ensureViews(table);
+      applied = applied || viewsApplied;
       return { applied };
     } catch (error) {
       if (error instanceof SchemaDriftError || error instanceof EnsureError) {
@@ -190,7 +265,41 @@ var SQLiteDriver = class {
       );
     }
   }
+  async ensureView(viewObj) {
+    const ddlTemplate = generateViewDDL(viewObj, { dialect: DIALECT });
+    const ddlSQL = renderDDL(ddlTemplate[0], ddlTemplate.slice(1), DIALECT);
+    for (const stmt of ddlSQL.split(";").filter((s) => s.trim())) {
+      this.#db.exec(stmt.trim());
+    }
+    return { applied: true };
+  }
+  /**
+   * Ensure the active view exists for this table (if it has soft delete).
+   * Creates the view using generateViewDDL.
+   */
+  async #ensureViews(table) {
+    const meta = getTableMeta(table);
+    if (meta.softDeleteField && !meta.activeView) {
+      void table.active;
+    }
+    const activeView = meta.activeView;
+    if (!activeView) {
+      return false;
+    }
+    const ddlTemplate = generateViewDDL(activeView, { dialect: DIALECT });
+    const ddlSQL = renderDDL(ddlTemplate[0], ddlTemplate.slice(1), DIALECT);
+    for (const stmt of ddlSQL.split(";").filter((s) => s.trim())) {
+      this.#db.exec(stmt.trim());
+    }
+    return true;
+  }
   async ensureConstraints(table) {
+    const meta = getTableMeta(table);
+    if (meta.isView) {
+      throw new Error(
+        `Cannot ensure view "${table.name}". Use the base table "${meta.viewOf}" instead.`
+      );
+    }
     const tableName = table.name;
     let step = 0;
     let applied = false;

package/src/zen.d.ts

@@ -5,10 +5,9 @@
  */
 import { z as zod } from "zod";
 export { zod as z };
-export { table, type Table, type TableOptions, type Row, type Insert, type Update, type FieldMeta, type FieldType, type Relation, type InferRefs, } 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";