@lunora/d1 1.0.0-alpha.18 → 1.0.0-alpha.180

package/LICENSE.md

@@ -103,3 +103,9 @@ Unless required by applicable law or agreed to in writing, software distributed
 under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
 CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+
+<!-- DEPENDENCIES -->
+<!-- /DEPENDENCIES -->
+
+<!-- TYPE_DEPENDENCIES -->
+<!-- /TYPE_DEPENDENCIES -->

package/dist/dialect.d.mts

@@ -1,41 +1,80 @@
 /**
-* Canonical SQL identifier quoter shared by `@lunora/d1` and `@lunora/do`.
-*
-* Double-quotes a SQL identifier and escapes any embedded double quotes by
-* doubling them (`"` → `""`) — the ANSI/SQLite/Postgres rule. This is a
-* security-relevant primitive (it is the sole defense against identifier
-* injection wherever a table/column name is spliced into raw SQL), so it must
-* have exactly ONE definition rather than byte-identical copies that can drift.
-*
-* Like `shared/stable-key.ts`, it is deliberately **not** a package: `@lunora/d1`
-* and `@lunora/do` sit on the same tier with no lower-level package to host it,
-* so each imports this file by relative path and the bundler (packem/rollup)
-* inlines it — no runtime dependency edge, duplicated only in emitted output.
-* Keep it genuinely zero-dependency (relative/built-in imports only) or inlining
-* breaks. Consumers must drop `outDir`/`rootDir` from their `tsconfig.json` (a
-* set `rootDir` raises TS6059 for this out-of-package file under `tsc --noEmit`).
-*/
+ * The optimistic-concurrency row version every global table carries alongside
+ * `id`/`_creationTime`.
+ *
+ * The CAS used to bind one parameter per physical column of the snapshot, so an
+ * `UPDATE` on a wide table bound `2N+2` parameters — over D1's 100-per-statement
+ * ceiling (workerd's `SQLITE_LIMIT_VARIABLE_NUMBER`) from 50 declared fields up,
+ * while `INSERT` at the same width stayed under it. The table provisioned, rows
+ * inserted, and the first `patch`/`replace`/soft-`delete` died with a raw
+ * `too many SQL variables` that redacts to "Internal error" on the way out.
+ *
+ * Guarding on this one column instead makes the CAS cost two parameters at any
+ * width. Every guarded write bumps it in SQL (`COALESCE(<col>, 0) + 1`), which
+ * costs no parameter of its own; `INSERT` leaves it NULL, and the NULL-safe
+ * comparison handles both that and rows written before the column existed.
+ *
+ * Not decoded into documents — `decodeGlobalRow` builds its result from the
+ * declared shape, so an undeclared physical column is invisible to callers.
+ *
+ * Bundler-inlined rather than owned by one package because BOTH producers of
+ * global-table DDL name it: `@lunora/sql-store`'s auto-provisioner (which runs
+ * the CAS) and `@lunora/d1/dialect`, which `lunora migrate generate` derives its
+ * `CREATE TABLE` from. Importing `@lunora/sql-store` would pull drizzle into the
+ * dependency-free dialect module the CLI reads; a second copy of the string is
+ * how the two shapes drift.
+ */
+declare const OCC_VERSION_COLUMN = "_version";
+/**
+ * Canonical SQL identifier quoter shared by `@lunora/d1` and `@lunora/do`.
+ *
+ * Double-quotes a SQL identifier and escapes any embedded double quotes by
+ * doubling them (`"` → `""`) — the ANSI/SQLite/Postgres rule. This is a
+ * security-relevant primitive (it is the sole defense against identifier
+ * injection wherever a table/column name is spliced into raw SQL), so it must
+ * have exactly ONE definition rather than byte-identical copies that can drift.
+ *
+ * Like `shared/stable-key.ts`, it is deliberately **not** a package: `@lunora/d1`
+ * and `@lunora/do` sit on the same tier with no lower-level package to host it,
+ * so each imports this file by relative path and the bundler (packem/rollup)
+ * inlines it — no runtime dependency edge, duplicated only in emitted output.
+ * Keep it genuinely zero-dependency (relative/built-in imports only) or inlining
+ * breaks. Consumers must drop `outDir`/`rootDir` from their `tsconfig.json` (a
+ * set `rootDir` raises TS6059 for this out-of-package file under `tsc --noEmit`).
+ */
 declare const quoteIdentifier: (name: string) => string;
 /** SQLite column type affinities Lunora emits. */
 type SqlAffinity = "BLOB" | "INTEGER" | "REAL" | "TEXT";
 /**
-* SQLite affinity for a column by its validator `kind`, chosen so the value the
-* D1 layer serializes round-trips intact:
-* - `boolean` → INTEGER (stored as 1/0)
-* - `number`/`timestamp`/`date` → REAL (numeric, never coerced to text)
-* - `bytes` → BLOB
-* - everything else → TEXT — string/id/literal, `bigint` (serialized as a
-* decimal string), and object/array/record/union/any (JSON). A numeric affinity
-* would coerce a numeric-looking string and corrupt the decode.
-*/
+ * SQLite affinity for a column by its validator `kind`, chosen so the value the
+ * D1 layer serializes round-trips intact:
+ * - `boolean` → INTEGER (stored as 1/0)
+ * - `number`/`timestamp`/`date` → REAL (numeric, never coerced to text)
+ * - `bytes` → BLOB
+ * - everything else → TEXT — string/id/literal, `bigint` (the order-preserving
+ * 40-character key `bigintSqlKey` builds: a sign character plus 39 digits, so
+ * text comparison agrees with numeric comparison and an index range scan is
+ * correct), and object/array/record/union/any (JSON). A numeric affinity would
+ * coerce a numeric-looking string and corrupt the decode.
+ */
 declare const sqlAffinityForKind: (kind: string | undefined) => SqlAffinity;
+/**
+ * Most columns one D1 table may carry, framework columns included.
+ *
+ * D1 runs Workerd's SQLite build, which sets `SQLITE_LIMIT_COLUMN` to 100 where
+ * stock SQLite allows 2,000. Exported so the two producers of global-table DDL
+ * — the runtime auto-provisioner in `@lunora/sql-store` and the
+ * `lunora migrate generate` emitter — check the same number rather than each
+ * carrying its own copy.
+ */
+declare const MAX_D1_TABLE_COLUMNS = 100;
 /** Framework columns every global table carries: the physical `id` (exposed as `_id`) and `_creationTime`. */
 declare const frameworkColumnDdl: () => ReadonlyArray<string>;
 /**
-* Resolve a schema field to its physical D1 column: `_id`/`id` both map to the
-* physical `id` column, `_creationTime` to its own, every other field to itself.
-*/
+ * Resolve a schema field to its physical D1 column: `_id`/`id` both map to the
+ * physical `id` column, `_creationTime` to its own, every other field to itself.
+ */
 declare const columnRef: (field: string) => string;
-/** Physical index identifier — `&lt;table>_&lt;name>`, so two tables' like-named indexes don't collide in SQLite's flat index namespace. */
+/** Physical index identifier — `<table>_<name>`, so two tables' like-named indexes don't collide in SQLite's flat index namespace. */
 declare const physicalIndexName: (tableName: string, indexName: string) => string;
-export { SqlAffinity, columnRef, frameworkColumnDdl, physicalIndexName, quoteIdentifier, sqlAffinityForKind };
+export { MAX_D1_TABLE_COLUMNS, OCC_VERSION_COLUMN, SqlAffinity, columnRef, frameworkColumnDdl, physicalIndexName, quoteIdentifier, sqlAffinityForKind };

package/dist/dialect.d.ts

@@ -1,41 +1,80 @@
 /**
-* Canonical SQL identifier quoter shared by `@lunora/d1` and `@lunora/do`.
-*
-* Double-quotes a SQL identifier and escapes any embedded double quotes by
-* doubling them (`"` → `""`) — the ANSI/SQLite/Postgres rule. This is a
-* security-relevant primitive (it is the sole defense against identifier
-* injection wherever a table/column name is spliced into raw SQL), so it must
-* have exactly ONE definition rather than byte-identical copies that can drift.
-*
-* Like `shared/stable-key.ts`, it is deliberately **not** a package: `@lunora/d1`
-* and `@lunora/do` sit on the same tier with no lower-level package to host it,
-* so each imports this file by relative path and the bundler (packem/rollup)
-* inlines it — no runtime dependency edge, duplicated only in emitted output.
-* Keep it genuinely zero-dependency (relative/built-in imports only) or inlining
-* breaks. Consumers must drop `outDir`/`rootDir` from their `tsconfig.json` (a
-* set `rootDir` raises TS6059 for this out-of-package file under `tsc --noEmit`).
-*/
+ * The optimistic-concurrency row version every global table carries alongside
+ * `id`/`_creationTime`.
+ *
+ * The CAS used to bind one parameter per physical column of the snapshot, so an
+ * `UPDATE` on a wide table bound `2N+2` parameters — over D1's 100-per-statement
+ * ceiling (workerd's `SQLITE_LIMIT_VARIABLE_NUMBER`) from 50 declared fields up,
+ * while `INSERT` at the same width stayed under it. The table provisioned, rows
+ * inserted, and the first `patch`/`replace`/soft-`delete` died with a raw
+ * `too many SQL variables` that redacts to "Internal error" on the way out.
+ *
+ * Guarding on this one column instead makes the CAS cost two parameters at any
+ * width. Every guarded write bumps it in SQL (`COALESCE(<col>, 0) + 1`), which
+ * costs no parameter of its own; `INSERT` leaves it NULL, and the NULL-safe
+ * comparison handles both that and rows written before the column existed.
+ *
+ * Not decoded into documents — `decodeGlobalRow` builds its result from the
+ * declared shape, so an undeclared physical column is invisible to callers.
+ *
+ * Bundler-inlined rather than owned by one package because BOTH producers of
+ * global-table DDL name it: `@lunora/sql-store`'s auto-provisioner (which runs
+ * the CAS) and `@lunora/d1/dialect`, which `lunora migrate generate` derives its
+ * `CREATE TABLE` from. Importing `@lunora/sql-store` would pull drizzle into the
+ * dependency-free dialect module the CLI reads; a second copy of the string is
+ * how the two shapes drift.
+ */
+declare const OCC_VERSION_COLUMN = "_version";
+/**
+ * Canonical SQL identifier quoter shared by `@lunora/d1` and `@lunora/do`.
+ *
+ * Double-quotes a SQL identifier and escapes any embedded double quotes by
+ * doubling them (`"` → `""`) — the ANSI/SQLite/Postgres rule. This is a
+ * security-relevant primitive (it is the sole defense against identifier
+ * injection wherever a table/column name is spliced into raw SQL), so it must
+ * have exactly ONE definition rather than byte-identical copies that can drift.
+ *
+ * Like `shared/stable-key.ts`, it is deliberately **not** a package: `@lunora/d1`
+ * and `@lunora/do` sit on the same tier with no lower-level package to host it,
+ * so each imports this file by relative path and the bundler (packem/rollup)
+ * inlines it — no runtime dependency edge, duplicated only in emitted output.
+ * Keep it genuinely zero-dependency (relative/built-in imports only) or inlining
+ * breaks. Consumers must drop `outDir`/`rootDir` from their `tsconfig.json` (a
+ * set `rootDir` raises TS6059 for this out-of-package file under `tsc --noEmit`).
+ */
 declare const quoteIdentifier: (name: string) => string;
 /** SQLite column type affinities Lunora emits. */
 type SqlAffinity = "BLOB" | "INTEGER" | "REAL" | "TEXT";
 /**
-* SQLite affinity for a column by its validator `kind`, chosen so the value the
-* D1 layer serializes round-trips intact:
-* - `boolean` → INTEGER (stored as 1/0)
-* - `number`/`timestamp`/`date` → REAL (numeric, never coerced to text)
-* - `bytes` → BLOB
-* - everything else → TEXT — string/id/literal, `bigint` (serialized as a
-* decimal string), and object/array/record/union/any (JSON). A numeric affinity
-* would coerce a numeric-looking string and corrupt the decode.
-*/
+ * SQLite affinity for a column by its validator `kind`, chosen so the value the
+ * D1 layer serializes round-trips intact:
+ * - `boolean` → INTEGER (stored as 1/0)
+ * - `number`/`timestamp`/`date` → REAL (numeric, never coerced to text)
+ * - `bytes` → BLOB
+ * - everything else → TEXT — string/id/literal, `bigint` (the order-preserving
+ * 40-character key `bigintSqlKey` builds: a sign character plus 39 digits, so
+ * text comparison agrees with numeric comparison and an index range scan is
+ * correct), and object/array/record/union/any (JSON). A numeric affinity would
+ * coerce a numeric-looking string and corrupt the decode.
+ */
 declare const sqlAffinityForKind: (kind: string | undefined) => SqlAffinity;
+/**
+ * Most columns one D1 table may carry, framework columns included.
+ *
+ * D1 runs Workerd's SQLite build, which sets `SQLITE_LIMIT_COLUMN` to 100 where
+ * stock SQLite allows 2,000. Exported so the two producers of global-table DDL
+ * — the runtime auto-provisioner in `@lunora/sql-store` and the
+ * `lunora migrate generate` emitter — check the same number rather than each
+ * carrying its own copy.
+ */
+declare const MAX_D1_TABLE_COLUMNS = 100;
 /** Framework columns every global table carries: the physical `id` (exposed as `_id`) and `_creationTime`. */
 declare const frameworkColumnDdl: () => ReadonlyArray<string>;
 /**
-* Resolve a schema field to its physical D1 column: `_id`/`id` both map to the
-* physical `id` column, `_creationTime` to its own, every other field to itself.
-*/
+ * Resolve a schema field to its physical D1 column: `_id`/`id` both map to the
+ * physical `id` column, `_creationTime` to its own, every other field to itself.
+ */
 declare const columnRef: (field: string) => string;
-/** Physical index identifier — `&lt;table>_&lt;name>`, so two tables' like-named indexes don't collide in SQLite's flat index namespace. */
+/** Physical index identifier — `<table>_<name>`, so two tables' like-named indexes don't collide in SQLite's flat index namespace. */
 declare const physicalIndexName: (tableName: string, indexName: string) => string;
-export { SqlAffinity, columnRef, frameworkColumnDdl, physicalIndexName, quoteIdentifier, sqlAffinityForKind };
+export { MAX_D1_TABLE_COLUMNS, OCC_VERSION_COLUMN, SqlAffinity, columnRef, frameworkColumnDdl, physicalIndexName, quoteIdentifier, sqlAffinityForKind };

package/dist/dialect.mjs

@@ -1,36 +1 @@
-import { quoteIdentifier } from './packem_shared/quoteIdentifier-B-ZeSe1V.mjs';
-
-const sqlAffinityForKind = (kind) => {
-  switch (kind) {
-    case "boolean": {
-      return "INTEGER";
-    }
-    case "bytes": {
-      return "BLOB";
-    }
-    case "date":
-    case "number":
-    case "timestamp": {
-      return "REAL";
-    }
-    default: {
-      return "TEXT";
-    }
-  }
-};
-const frameworkColumnDdl = () => [
-  `${quoteIdentifier("id")} TEXT PRIMARY KEY`,
-  `${quoteIdentifier("_creationTime")} REAL NOT NULL`
-];
-const columnRef = (field) => {
-  if (field === "_id" || field === "id") {
-    return quoteIdentifier("id");
-  }
-  if (field === "_creationTime") {
-    return quoteIdentifier("_creationTime");
-  }
-  return quoteIdentifier(field);
-};
-const physicalIndexName = (tableName, indexName) => quoteIdentifier(`${tableName}_${indexName}`);
-
-export { columnRef, frameworkColumnDdl, physicalIndexName, quoteIdentifier, sqlAffinityForKind };
+import{quoteIdentifier as r}from"./packem_shared/quoteIdentifier-CObIFRhb.mjs";import{OCC_VERSION_COLUMN as T}from"./packem_shared/OCC_VERSION_COLUMN-ByC64Jgx.mjs";const o=e=>{switch(e){case"boolean":return"INTEGER";case"bytes":return"BLOB";case"date":case"number":case"timestamp":return"REAL";default:return"TEXT"}},i=100,c=()=>[`${r("id")} TEXT PRIMARY KEY`,`${r("_creationTime")} REAL NOT NULL`],a=e=>e==="_id"||e==="id"?r("id"):e==="_creationTime"?r("_creationTime"):r(e),s=(e,t)=>r(`${e}_${t}`);export{i as MAX_D1_TABLE_COLUMNS,T as OCC_VERSION_COLUMN,a as columnRef,c as frameworkColumnDdl,s as physicalIndexName,r as quoteIdentifier,o as sqlAffinityForKind};