@lunora/sql-store 1.0.0-alpha.21 → 1.0.0-alpha.23

package/dist/index.mjs

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

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

@@ -1,4 +1,5 @@
 import { aggregateTableName, rankTableName, ftsTableName, hasTrigger, runRowValidators, assertFlatPredicate, mergeWhere, sortColumnName, resolveRankPartition, encodePartitionKey, decodeCursor, RANK_TIEBREAK, CountRlsUnsupportedError, normalizeIdStructurally, assertValidClientId, aggregateSqlFunction, softDeleteScope, compileWhereSql, normalizeOrderKeys, buildSeekWhere, resolveRelationPredicates, resolveWith, applySelect, encodeCursor, NotFoundError, applyOnDelete, ConflictError, normalizeCountArgument, selectIndexForCount, encodeAggregateKey, selectIndexForAggregate, readAggregateValue, renderSql, runTriggers, matchesRankStaticWhere, stringifySearchText, selectIndexForGroupBy, fanOutScalarCounts, matchesStaticWhere, coerceAggregateNumber, foldAggregateTally, NotUniqueError, throwingScheduler, tokenizeSearch, buildFtsMatch, scoreDocument } from '@lunora/do';
+import { LunoraError } from '@lunora/errors';
 import { sql } from 'drizzle-orm';
 import { sqliteDecode, sqliteEncode, effectiveColumnKind } from './decodeBigint-Dedu92k4.mjs';
 
@@ -260,14 +261,17 @@ const createSearchBuilder = (search, tableName) => {
   const builder = {
     eq: (field, value) => {
       if (!search.definition.filterFields?.includes(field)) {
-        throw new Error(`field "${field}" is not a filter field of search index "${search.indexName}" on table "${tableName}"`);
+        throw new LunoraError("INTERNAL", `field "${field}" is not a filter field of search index "${search.indexName}" on table "${tableName}"`);
       }
       search.filters.push({ field, value });
       return builder;
     },
     search: (field, query) => {
       if (field !== search.definition.field) {
-        throw new Error(`search index "${search.indexName}" on table "${tableName}" indexes "${search.definition.field}", not "${field}"`);
+        throw new LunoraError(
+          "INTERNAL",
+          `search index "${search.indexName}" on table "${tableName}" indexes "${search.definition.field}", not "${field}"`
+        );
       }
       const stage = search;
       stage.field = field;
@@ -315,7 +319,7 @@ const buildRankCursorSeek = (engine, columns, decoded) => {
 };
 const rankPageColumns = (index, sortColumns) => {
   if (index.sortBy.length === 0) {
-    throw new Error(`rankIndex "${index.name}" requires at least one "sortBy" column for stable pagination`);
+    throw new LunoraError("INTERNAL", `rankIndex "${index.name}" requires at least one "sortBy" column for stable pagination`);
   }
   const columns = [{ column: "__partition__", direction: "asc" }];
   for (const [i, sortKey] of index.sortBy.entries()) {
@@ -1105,7 +1109,8 @@ const createSqlCtxDb = (options) => {
     return kind === "shardBy" || kind === "root";
   };
   const crossBackendUnsupported = (childTable) => {
-    throw new Error(
+    throw new LunoraError(
+      "INTERNAL",
       `cross-backend relation: a global table cannot load the shard-local relation '${childTable}' (it spans every shard) — wire a cross-shard reader to support it`
     );
   };
@@ -1127,7 +1132,7 @@ const createSqlCtxDb = (options) => {
     async aggregate(tableName, aggOptions) {
       const definition = schema.tables[tableName];
       if (!definition) {
-        throw new Error(`unknown table: ${tableName}`);
+        throw new LunoraError("INTERNAL", `unknown table: ${tableName}`);
       }
       await ensureMigrated();
       aggregateSqlFunction(aggOptions.op);
@@ -1140,7 +1145,7 @@ const createSqlCtxDb = (options) => {
         });
       }
       if (!aggOptions.field) {
-        throw new Error(`aggregate(${tableName}, { op: "${aggOptions.op}" }): "field" is required for non-count reducers`);
+        throw new LunoraError("INTERNAL", `aggregate(${tableName}, { op: "${aggOptions.op}" }): "field" is required for non-count reducers`);
       }
       const aggScope = softDeleteScope(definition.softDeleteMode, void 0);
       const effective = mergeWhere(mergeWhere(aggOptions.baseWhere, aggOptions.where), aggScope);
@@ -1173,7 +1178,7 @@ const createSqlCtxDb = (options) => {
     async count(tableName, whereOrOptions) {
       const definition = schema.tables[tableName];
       if (!definition) {
-        throw new Error(`unknown table: ${tableName}`);
+        throw new LunoraError("INTERNAL", `unknown table: ${tableName}`);
       }
       await ensureMigrated();
       const countOptions = normalizeCountArgument(whereOrOptions);
@@ -1229,7 +1234,8 @@ const createSqlCtxDb = (options) => {
         deletedReference: (references) => existing?.[references],
         findHolders: async (holderTable, field, value) => {
           if (schema.tables[holderTable]?.shardMode?.kind === "shardBy") {
-            throw new Error(
+            throw new LunoraError(
+              "INTERNAL",
               `cross-backend cascade from global '${tableName}' into shardBy '${holderTable}' is not supported — would require Query Coordinator fan-out across shards`
             );
           }
@@ -1288,7 +1294,7 @@ const createSqlCtxDb = (options) => {
     async findMany(tableName, args = {}) {
       const definition = schema.tables[tableName];
       if (!definition) {
-        throw new Error(`unknown table: ${tableName}`);
+        throw new LunoraError("INTERNAL", `unknown table: ${tableName}`);
       }
       await ensureMigrated();
       const orderKeys = normalizeOrderKeys(args.orderBy);
@@ -1303,7 +1309,7 @@ const createSqlCtxDb = (options) => {
         }
         const childDefinition = schema.tables[childTable];
         if (!childDefinition) {
-          throw new Error(`unknown table: ${childTable}`);
+          throw new LunoraError("INTERNAL", `unknown table: ${childTable}`);
         }
         const softScope = softDeleteScope(childDefinition.softDeleteMode, void 0);
         const inFilter = { [whereField]: { in: values } };
@@ -1391,13 +1397,13 @@ const createSqlCtxDb = (options) => {
     async groupBy(tableName, groupOptions) {
       const definition = schema.tables[tableName];
       if (!definition) {
-        throw new Error(`unknown table: ${tableName}`);
+        throw new LunoraError("INTERNAL", `unknown table: ${tableName}`);
       }
       await ensureMigrated();
       const agg = groupOptions.agg ?? { op: "count" };
       aggregateSqlFunction(agg.op);
       if (agg.op !== "count" && !agg.field) {
-        throw new Error(`groupBy(${tableName}, { agg: { op: "${agg.op}" } }): "field" is required for non-count reducers`);
+        throw new LunoraError("INTERNAL", `groupBy(${tableName}, { agg: { op: "${agg.op}" } }): "field" is required for non-count reducers`);
       }
       const groupScope = softDeleteScope(definition.softDeleteMode, void 0);
       const effective = mergeWhere(mergeWhere(groupOptions.baseWhere, groupOptions.where), groupScope);
@@ -1415,7 +1421,7 @@ const createSqlCtxDb = (options) => {
         select.push(sql`COUNT(*) AS value`);
       } else {
         if (!agg.field) {
-          throw new Error(`groupBy(${tableName}, { agg: { op: "${agg.op}" } }): "field" is required for non-count reducers`);
+          throw new LunoraError("INTERNAL", `groupBy(${tableName}, { agg: { op: "${agg.op}" } }): "field" is required for non-count reducers`);
         }
         select.push(sql`${sql.raw(aggregateSqlFunction(agg.op))}(${columnRefSql(agg.field)}) AS value`);
       }
@@ -1445,7 +1451,7 @@ const createSqlCtxDb = (options) => {
     async insert(tableName, document, insertOptions) {
       const definition = schema.tables[tableName];
       if (!definition) {
-        throw new Error(`unknown table: ${tableName}`);
+        throw new LunoraError("INTERNAL", `unknown table: ${tableName}`);
       }
       await ensureMigrated();
       const withDefaults = applyInsertDefaults(definition, document, auth);
@@ -1496,16 +1502,16 @@ const createSqlCtxDb = (options) => {
     async patch(id, patch, expectedTable) {
       const tableName = await resolveTableName(id, expectedTable);
       if (!tableName) {
-        throw new Error(`document not found: ${id}`);
+        throw new LunoraError("INTERNAL", `document not found: ${id}`);
       }
       const definition = schema.tables[tableName];
       if (!definition) {
-        throw new Error(`document not found: ${id}`);
+        throw new LunoraError("INTERNAL", `document not found: ${id}`);
       }
       const snapshot = await rawRow(tableName, id);
       const existing = decodeRow(definition, snapshot);
       if (!existing) {
-        throw new Error(`document not found: ${id}`);
+        throw new LunoraError("INTERNAL", `document not found: ${id}`);
       }
       const merged = { ...existing, ...patch, _id: id };
       applyOnUpdate(definition, patch, merged, auth);
@@ -1533,12 +1539,12 @@ const createSqlCtxDb = (options) => {
     async restore(id, expectedTable) {
       const tableName = await resolveTableName(id, expectedTable);
       if (!tableName) {
-        throw new Error(`document not found: ${id}`);
+        throw new LunoraError("INTERNAL", `document not found: ${id}`);
       }
       const definition = schema.tables[tableName];
       const field = definition?.softDeleteMode?.field;
       if (!definition || !field) {
-        throw new Error(`ctx.db.restore: table "${tableName}" is not a .softDelete() table`);
+        throw new LunoraError("INTERNAL", `ctx.db.restore: table "${tableName}" is not a .softDelete() table`);
       }
       const snapshot = await rawRow(tableName, id);
       const wasDeleted = snapshot?.[field] !== null && snapshot?.[field] !== void 0;
@@ -1553,7 +1559,7 @@ const createSqlCtxDb = (options) => {
     query(tableName) {
       const definition = schema.tables[tableName];
       if (!definition) {
-        throw new Error(`unknown table: ${tableName}`);
+        throw new LunoraError("INTERNAL", `unknown table: ${tableName}`);
       }
       const LEGACY_READER_ERROR = "the legacy query()/withIndex() reader is not available on the D1 (global) backend; use findMany";
       const runSearch = async (stage, limit) => {
@@ -1564,16 +1570,16 @@ const createSqlCtxDb = (options) => {
         const reader = {
           async collect() {
             if (!stage) {
-              throw new Error(LEGACY_READER_ERROR);
+              throw new LunoraError("INTERNAL", LEGACY_READER_ERROR);
             }
             return runSearch(stage, void 0);
           },
           filter() {
-            throw new Error(LEGACY_READER_ERROR);
+            throw new LunoraError("INTERNAL", LEGACY_READER_ERROR);
           },
           async first() {
             if (!stage) {
-              throw new Error(LEGACY_READER_ERROR);
+              throw new LunoraError("INTERNAL", LEGACY_READER_ERROR);
             }
             const rows = await runSearch(stage, 1);
             return rows[0] ?? null;
@@ -1584,19 +1590,19 @@ const createSqlCtxDb = (options) => {
           // eslint-disable-next-line @typescript-eslint/require-await -- TableReaderLike.paginate returns a Promise; search queries don't support pagination on either backend
           async paginate() {
             if (stage) {
-              throw new Error("pagination is not supported on search queries; use .take(n) or .collect()");
+              throw new LunoraError("INTERNAL", "pagination is not supported on search queries; use .take(n) or .collect()");
             }
-            throw new Error(LEGACY_READER_ERROR);
+            throw new LunoraError("INTERNAL", LEGACY_READER_ERROR);
           },
           async take(limit) {
             if (!stage) {
-              throw new Error(LEGACY_READER_ERROR);
+              throw new LunoraError("INTERNAL", LEGACY_READER_ERROR);
             }
             return runSearch(stage, limit);
           },
           async unique() {
             if (!stage) {
-              throw new Error(LEGACY_READER_ERROR);
+              throw new LunoraError("INTERNAL", LEGACY_READER_ERROR);
             }
             const rows = await runSearch(stage, 2);
             if (rows.length > 1) {
@@ -1605,12 +1611,12 @@ const createSqlCtxDb = (options) => {
             return rows[0] ?? null;
           },
           withIndex() {
-            throw new Error(LEGACY_READER_ERROR);
+            throw new LunoraError("INTERNAL", LEGACY_READER_ERROR);
           },
           withSearchIndex(indexName, search) {
             const searchDefinition = (definition.searchIndexes ?? []).find((index) => index.name === indexName);
             if (!searchDefinition) {
-              throw new Error(`unknown search index "${indexName}" on table "${tableName}"`);
+              throw new LunoraError("INTERNAL", `unknown search index "${indexName}" on table "${tableName}"`);
             }
             const searchStage = {
               definition: searchDefinition,
@@ -1622,7 +1628,7 @@ const createSqlCtxDb = (options) => {
             };
             search(createSearchBuilder(searchStage, tableName));
             if (!searchStage.hasQuery) {
-              throw new Error(`search index "${indexName}" on table "${tableName}" requires a .search(field, query) call`);
+              throw new LunoraError("INTERNAL", `search index "${indexName}" on table "${tableName}" requires a .search(field, query) call`);
             }
             return buildReader(searchStage);
           }
@@ -1634,11 +1640,11 @@ const createSqlCtxDb = (options) => {
     async rank(tableName, indexName, rankOptions) {
       const definition = schema.tables[tableName];
       if (!definition) {
-        throw new Error(`unknown table: ${tableName}`);
+        throw new LunoraError("INTERNAL", `unknown table: ${tableName}`);
       }
       const index = definition.rankIndexes?.find((i) => i.name === indexName);
       if (!index) {
-        throw new Error(`unknown rankIndex "${indexName}" on table "${tableName}"`);
+        throw new LunoraError("INTERNAL", `unknown rankIndex "${indexName}" on table "${tableName}"`);
       }
       if (rankOptions.restrictsCounts) {
         throw new CountRlsUnsupportedError(tableName);
@@ -1691,11 +1697,11 @@ const createSqlCtxDb = (options) => {
       assertFlatPredicate(mergeWhere(rankPageOptions.baseWhere, rankPageOptions.where), schema, tableName, "rankPage");
       const definition = schema.tables[tableName];
       if (!definition) {
-        throw new Error(`unknown table: ${tableName}`);
+        throw new LunoraError("INTERNAL", `unknown table: ${tableName}`);
       }
       const index = definition.rankIndexes?.find((i) => i.name === indexName);
       if (!index) {
-        throw new Error(`unknown rankIndex "${indexName}" on table "${tableName}"`);
+        throw new LunoraError("INTERNAL", `unknown rankIndex "${indexName}" on table "${tableName}"`);
       }
       await ensureMigrated();
       const counterReady = await ensureRankBackfilled(tableName, index);
@@ -1751,15 +1757,15 @@ const createSqlCtxDb = (options) => {
     async replace(id, document, expectedTable) {
       const tableName = await resolveTableName(id, expectedTable);
       if (!tableName) {
-        throw new Error(`document not found: ${id}`);
+        throw new LunoraError("INTERNAL", `document not found: ${id}`);
       }
       const definition = schema.tables[tableName];
       if (!definition) {
-        throw new Error(`document not found: ${id}`);
+        throw new LunoraError("INTERNAL", `document not found: ${id}`);
       }
       const snapshot = await rawRow(tableName, id);
       if (snapshot === void 0) {
-        throw new Error(`document not found: ${id}`);
+        throw new LunoraError("INTERNAL", `document not found: ${id}`);
       }
       const needsPrevious = hasTrigger(schema, tableName, "update") || (definition.aggregateIndexes ?? []).length > 0 || (definition.rankIndexes ?? []).length > 0;
       const previous = needsPrevious ? decodeRow(definition, snapshot) ?? void 0 : void 0;

package/package.json

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