@lunora/sql-store 1.0.0-alpha.26 → 1.0.0-alpha.27

package/dist/dialect.d.mts

@@ -46,9 +46,19 @@ interface SqlDialect {
     real: string;
     text: string;
   };
-  /** Map a stored value back to its JS form, by effective validator `kind` (inverse of `encode`). */
+  /**
+  * Map a stored value back to its JS form, by effective validator `kind`
+  * (inverse of `encode`). NOTE: currently **unused** by the store core, which
+  * hard-codes `sqliteDecode` in `decodeGlobalRow` on every engine. Kept on the
+  * seam for a future engine-native codec; an override here does not run today.
+  */
   decode: (value: unknown, kind: string | undefined) => unknown;
-  /** Map a JS value to its bound storage form (boolean→1/0, bigint→string, object→JSON on SQLite; mostly native on PG). */
+  /**
+  * Map a JS value to its bound storage form (boolean→1/0, bigint→string,
+  * object→JSON on SQLite). NOTE: currently **unused** by the store core, which
+  * hard-codes `sqliteEncode` as `serializeColumnValue` on every engine. Kept on
+  * the seam for a future engine-native codec; an override here does not run today.
+  */
   encode: (value: unknown) => unknown;
   /** The framework columns every global table carries — the `id` primary key and `_creationTime` — as `{ name, type }` so the DDL builder can quote each name through the engine's dialect. */
   frameworkColumns: () => ReadonlyArray<{

package/dist/dialect.d.ts

@@ -46,9 +46,19 @@ interface SqlDialect {
     real: string;
     text: string;
   };
-  /** Map a stored value back to its JS form, by effective validator `kind` (inverse of `encode`). */
+  /**
+  * Map a stored value back to its JS form, by effective validator `kind`
+  * (inverse of `encode`). NOTE: currently **unused** by the store core, which
+  * hard-codes `sqliteDecode` in `decodeGlobalRow` on every engine. Kept on the
+  * seam for a future engine-native codec; an override here does not run today.
+  */
   decode: (value: unknown, kind: string | undefined) => unknown;
-  /** Map a JS value to its bound storage form (boolean→1/0, bigint→string, object→JSON on SQLite; mostly native on PG). */
+  /**
+  * Map a JS value to its bound storage form (boolean→1/0, bigint→string,
+  * object→JSON on SQLite). NOTE: currently **unused** by the store core, which
+  * hard-codes `sqliteEncode` as `serializeColumnValue` on every engine. Kept on
+  * the seam for a future engine-native codec; an override here does not run today.
+  */
   encode: (value: unknown) => unknown;
   /** The framework columns every global table carries — the `id` primary key and `_creationTime` — as `{ name, type }` so the DDL builder can quote each name through the engine's dialect. */
   frameworkColumns: () => ReadonlyArray<{

package/dist/index.d.mts

@@ -168,6 +168,12 @@ declare const effectiveColumnKind: (validator: ValidatorLike) => string | undefi
 * - `object`/`array`/`record`: JSON string → parsed value.
 * - `union`/`any`: parsed back only when the stored string is a JSON non-scalar
 *   (a scalar union member round-trips through SQLite's native column type).
+*   CAVEAT: a union/any member is stored verbatim by {@link sqliteEncode}, so a
+*   legitimate *string* value that itself looks like JSON (`'{"a":1}'`, `'[1,2]'`)
+*   is ambiguous on read and decodes back to the parsed object/array, not the
+*   original string. This is inherent to sharing one TEXT column between a string
+*   and an object member; disambiguating would require a breaking storage-format
+*   change (tagging encoded non-scalars), so it is documented rather than fixed.
 * - everything else (string/number/date/timestamp/id/literal): verbatim.
 */
 declare const sqliteDecode: (raw: unknown, kind: string | undefined) => unknown;

package/dist/index.d.ts

@@ -168,6 +168,12 @@ declare const effectiveColumnKind: (validator: ValidatorLike) => string | undefi
 * - `object`/`array`/`record`: JSON string → parsed value.
 * - `union`/`any`: parsed back only when the stored string is a JSON non-scalar
 *   (a scalar union member round-trips through SQLite's native column type).
+*   CAVEAT: a union/any member is stored verbatim by {@link sqliteEncode}, so a
+*   legitimate *string* value that itself looks like JSON (`'{"a":1}'`, `'[1,2]'`)
+*   is ambiguous on read and decodes back to the parsed object/array, not the
+*   original string. This is inherent to sharing one TEXT column between a string
+*   and an object member; disambiguating would require a breaking storage-format
+*   change (tagging encoded non-scalars), so it is documented rather than fixed.
 * - everything else (string/number/date/timestamp/id/literal): verbatim.
 */
 declare const sqliteDecode: (raw: unknown, kind: string | undefined) => unknown;

package/dist/index.mjs

@@ -1,2 +1,2 @@
-export { createSqlCtxDb, decodeGlobalRow, readSqlCdcChanges, runSqlAggregateMigrations, runSqlCdcMigration, runSqlGlobalTableMigrations, runSqlRankMigrations, runSqlSearchMigrations, trimSqlCdcChanges } from './packem_shared/createSqlCtxDb-CuoIlIqO.mjs';
+export { createSqlCtxDb, decodeGlobalRow, readSqlCdcChanges, runSqlAggregateMigrations, runSqlCdcMigration, runSqlGlobalTableMigrations, runSqlRankMigrations, runSqlSearchMigrations, trimSqlCdcChanges } from './packem_shared/createSqlCtxDb-KdluzmSA.mjs';
 export { decodeBigint, effectiveColumnKind, sqliteDecode, sqliteEncode, tryJsonParse } from './packem_shared/decodeBigint-Dedu92k4.mjs';

package/dist/packem_shared/{createSqlCtxDb-CuoIlIqO.mjs → createSqlCtxDb-KdluzmSA.mjs}

@@ -3,6 +3,16 @@ import { LunoraError } from '@lunora/errors';
 import { sql } from 'drizzle-orm';
 import { sqliteDecode, sqliteEncode, effectiveColumnKind } from './decodeBigint-Dedu92k4.mjs';
 
+const evictOldestEntry = (map, capacity) => {
+  if (map.size < capacity) {
+    return;
+  }
+  const oldest = map.keys().next().value;
+  if (oldest !== void 0) {
+    map.delete(oldest);
+  }
+};
+
 const physicalColumn = (field) => field === "_id" || field === "id" ? "id" : field;
 const columnRefSql = (field) => sql`${sql.identifier(physicalColumn(field))}`;
 const ID_ORDER_FIELDS = /* @__PURE__ */ new Set(["_id", "id"]);
@@ -158,11 +168,8 @@ const createTableNameCache = () => {
     set: (id, table) => {
       if (map.has(id)) {
         map.delete(id);
-      } else if (map.size >= TABLE_NAME_CACHE_CAPACITY) {
-        const oldest = map.keys().next().value;
-        if (oldest !== void 0) {
-          map.delete(oldest);
-        }
+      } else {
+        evictOldestEntry(map, TABLE_NAME_CACHE_CAPACITY);
       }
       map.set(id, table);
     }
@@ -282,6 +289,10 @@ const createSearchBuilder = (search, tableName) => {
   };
   return builder;
 };
+const rankIndexFieldsUnchanged = (index, previous, next) => {
+  const fields = [...index.partitionBy ?? [], ...index.sortBy.map((key) => key.field), ...index.where ? Object.keys(index.where) : []];
+  return fields.every((field) => previous[field] === next[field]);
+};
 const andBranch = (conditions) => conditions.length === 1 ? conditions[0] : sql`(${sql.join(conditions, sql` AND `)})`;
 const buildRankBeforeBranches = (engine, index, sortColumns, own, rowId) => {
   const branches = [];
@@ -938,11 +949,18 @@ const createSqlCtxDb = (options) => {
     }
   };
   const syncRanks = async (tableName, id, previous, next) => {
-    const indexes = schema.tables[tableName]?.rankIndexes;
+    const definition = schema.tables[tableName];
+    const indexes = definition?.rankIndexes;
     if (!indexes || indexes.length === 0) {
       return;
     }
+    const softField = definition?.softDeleteMode?.field;
+    const nextFieldValue = softField === void 0 || next === void 0 ? void 0 : next[softField];
+    const nextSoftDeleted = nextFieldValue !== null && nextFieldValue !== void 0;
     for (const index of indexes) {
+      if (previous !== void 0 && next !== void 0 && rankIndexFieldsUnchanged(index, previous, next)) {
+        continue;
+      }
       const cacheKey = `${tableName}::rank::${index.name}`;
       const cached = rankBackfilled.get(cacheKey);
       const exists = cached ?? await rankTableExists(tableName, index.name);
@@ -953,7 +971,7 @@ const createSqlCtxDb = (options) => {
       if (previous) {
         await queryRun(exec, dialect, sql`DELETE FROM ${sql.identifier(rankTable)} WHERE ${sql.identifier("__id__")} = ${id}`);
       }
-      if (next) {
+      if (next && !nextSoftDeleted) {
         if (index.where && !matchesRankStaticWhere(next, index.where)) {
           continue;
         }
@@ -1091,6 +1109,9 @@ const createSqlCtxDb = (options) => {
       const row = rowsIndexed2[0];
       return [{ key: { ...planned.partial }, value: readAggregateValue(agg.op, { count: row.count, value: aggregateScalar(row.value) }) }];
     }
+    if (partialKeys.length > 0) {
+      return void 0;
+    }
     const rowsIndexed = await queryAll(
       exec,
       dialect,
@@ -1467,7 +1488,7 @@ const createSqlCtxDb = (options) => {
         id = generateId();
         usedExplicitId = false;
       }
-      const creationTime = typeof withDefaults["_creationTime"] === "number" ? withDefaults["_creationTime"] : clock();
+      const creationTime = insertOptions?.allowExplicitId && typeof withDefaults["_creationTime"] === "number" ? withDefaults["_creationTime"] : clock();
       const documentWithMeta = { ...withDefaults, _creationTime: creationTime, _id: id };
       if (hasMatchingTrigger(tableName, "before", "insert")) {
         await fireTriggers("before", "insert", { doc: { ...documentWithMeta }, id, op: "insert", table: tableName });
@@ -1552,7 +1573,7 @@ const createSqlCtxDb = (options) => {
       if (wasDeleted) {
         const row = decodeRow(definition, snapshot);
         if (row !== null) {
-          await syncRanks(tableName, id, void 0, row);
+          await syncRanks(tableName, id, void 0, { ...row, [field]: null });
         }
       }
     },
@@ -1754,7 +1775,7 @@ const createSqlCtxDb = (options) => {
       }
       return { continueCursor, isDone: !hasMore, page: documents };
     },
-    async replace(id, document, expectedTable) {
+    async replace(id, document, expectedTable, replaceOptions) {
       const tableName = await resolveTableName(id, expectedTable);
       if (!tableName) {
         throw new LunoraError("INTERNAL", `document not found: ${id}`);
@@ -1769,7 +1790,7 @@ const createSqlCtxDb = (options) => {
       }
       const needsPrevious = hasTrigger(schema, tableName, "update") || (definition.aggregateIndexes ?? []).length > 0 || (definition.rankIndexes ?? []).length > 0;
       const previous = needsPrevious ? decodeRow(definition, snapshot) ?? void 0 : void 0;
-      const creationTime = typeof document["_creationTime"] === "number" ? document["_creationTime"] : clock();
+      const creationTime = replaceOptions?.allowExplicitId && typeof document["_creationTime"] === "number" ? document["_creationTime"] : clock();
       const replaced = { ...document, _creationTime: creationTime, _id: id };
       applyOnUpdate(definition, document, replaced, auth);
       runRowValidators(definition, replaced);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/sql-store",
-  "version": "1.0.0-alpha.26",
+  "version": "1.0.0-alpha.27",
   "description": "Internal dialect-parameterized SQL store core for Lunora .global() backends (D1, PlanetScale)",
   "keywords": [
     "cloudflare",
@@ -50,8 +50,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/do": "1.0.0-alpha.26",
-    "@lunora/errors": "1.0.0-alpha.3",
+    "@lunora/do": "1.0.0-alpha.27",
+    "@lunora/errors": "1.0.0-alpha.4",
     "drizzle-orm": "^0.45.2"
   },
   "engines": {