@lunora/sql-store 1.0.0-alpha.4 → 1.0.0-alpha.5

package/dist/index.mjs

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

package/dist/packem_shared/{createSqlCtxDb-WI84CQ7K.mjs → createSqlCtxDb-DYqDyPq8.mjs}

@@ -1,4 +1,4 @@
-import { aggregateTableName, rankTableName, ftsTableName, hasTrigger, runRowValidators, assertFlatPredicate, mergeWhere, sortColumnName, resolveRankPartition, encodePartitionKey, decodeCursor, RANK_TIEBREAK, CountRlsUnsupportedError, normalizeIdStructurally, assertValidClientId, aggregateSqlFunction, compileWhereSql, normalizeOrderKeys, buildSeekWhere, resolveRelationPredicates, resolveWith, encodeCursor, NotFoundError, applyOnDelete, ConflictError, normalizeCountArgument, selectIndexForCount, encodeAggregateKey, selectIndexForAggregate, readAggregateValue, renderSql, runTriggers, matchesRankStaticWhere, stringifySearchText, selectIndexForGroupBy, matchesStaticWhere, coerceAggregateNumber, foldAggregateTally, NotUniqueError, throwingScheduler, tokenizeSearch, buildFtsMatch, scoreDocument } from '@lunora/do';
+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, matchesStaticWhere, coerceAggregateNumber, foldAggregateTally, NotUniqueError, throwingScheduler, tokenizeSearch, buildFtsMatch, scoreDocument } from '@lunora/do';
 import { sql } from 'drizzle-orm';
 import { sqliteDecode, effectiveColumnKind, sqliteEncode } from './decodeBigint-Dedu92k4.mjs';
 
@@ -212,6 +212,9 @@ const searchViaFts = async (exec, dialect, definition, tableName, search, limit)
   for (const filter of search.filters) {
     conditions.push(sql`m.${columnRefSql(filter.field)} = ${serializeColumnValue(filter.value)}`);
   }
+  if (definition.softDeleteMode) {
+    conditions.push(sql`m.${columnRefSql(definition.softDeleteMode.field)} IS NULL`);
+  }
   let query = sql`SELECT m.* FROM ${sql.identifier(ftName)} f JOIN ${sql.identifier(tableName)} m ON m.${sql.identifier("id")} = f.${sql.identifier("__id__")} WHERE ${sql.join(conditions, sql` AND `)} ORDER BY f.rank, m.${sql.identifier("_creationTime")} DESC`;
   if (typeof limit === "number") {
     query = sql`${query} LIMIT ${sql.raw(String(Math.max(0, Math.floor(limit))))}`;
@@ -225,6 +228,9 @@ const searchViaScan = async (exec, dialect, definition, tableName, search, limit
     return [];
   }
   const conditions = search.filters.map((filter) => sql`${columnRefSql(filter.field)} = ${serializeColumnValue(filter.value)}`);
+  if (definition.softDeleteMode) {
+    conditions.push(sql`${columnRefSql(definition.softDeleteMode.field)} IS NULL`);
+  }
   let query = sql`SELECT * FROM ${sql.identifier(tableName)}`;
   if (conditions.length > 0) {
     query = sql`${query} WHERE ${sql.join(conditions, sql` AND `)}`;
@@ -1122,10 +1128,11 @@ const createSqlCtxDb = (options) => {
       if (!aggOptions.field) {
         throw new Error(`aggregate(${tableName}, { op: "${aggOptions.op}" }): "field" is required for non-count reducers`);
       }
-      const effective = mergeWhere(aggOptions.baseWhere, aggOptions.where);
+      const aggScope = softDeleteScope(definition.softDeleteMode, void 0);
+      const effective = mergeWhere(mergeWhere(aggOptions.baseWhere, aggOptions.where), aggScope);
       const resolved = await resolveAggregateRelations(effective, tableName, aggOptions.relationBaseWhere);
       const hasRelation = resolved !== effective;
-      if (definition.aggregateIndexes && !aggOptions.baseWhere && !hasRelation) {
+      if (definition.aggregateIndexes && !aggOptions.baseWhere && !hasRelation && !aggScope) {
         const planned = selectIndexForAggregate(definition.aggregateIndexes, aggOptions.op, aggOptions.field, aggOptions.where);
         if (planned) {
           const counterReady = await ensureBackfilled(tableName, planned.index);
@@ -1159,10 +1166,11 @@ const createSqlCtxDb = (options) => {
       if (countOptions.restrictsCounts) {
         throw new CountRlsUnsupportedError(tableName);
       }
-      const effective = mergeWhere(countOptions.baseWhere, countOptions.where);
+      const countScope = softDeleteScope(definition.softDeleteMode, void 0);
+      const effective = mergeWhere(mergeWhere(countOptions.baseWhere, countOptions.where), countScope);
       const resolved = await resolveAggregateRelations(effective, tableName, countOptions.relationBaseWhere);
       const hasRelation = resolved !== effective;
-      if (definition.aggregateIndexes && !countOptions.baseWhere && !hasRelation) {
+      if (definition.aggregateIndexes && !countOptions.baseWhere && !hasRelation && !countScope) {
         const planned = selectIndexForCount(definition.aggregateIndexes, countOptions.where);
         if (planned) {
           const counterReady = await ensureBackfilled(tableName, planned.index);
@@ -1183,7 +1191,7 @@ const createSqlCtxDb = (options) => {
       const rows = await queryAll(exec, dialect, whereCondition ? sql`${query} WHERE ${whereCondition}` : query);
       return Number(rows[0]?.["count"] ?? 0);
     },
-    async delete(id, expectedTable) {
+    async delete(id, expectedTable, deleteOptions) {
       const tableName = await resolveTableName(id, expectedTable);
       if (!tableName) {
         return;
@@ -1194,6 +1202,11 @@ const createSqlCtxDb = (options) => {
       }
       const snapshot = await rawRow(tableName, id);
       const existing = decodeRow(definition, snapshot);
+      const hard = deleteOptions?.hard === true;
+      const softField = !hard && definition.softDeleteMode ? definition.softDeleteMode.field : void 0;
+      if (softField && (!existing || existing[softField] !== null && existing[softField] !== void 0)) {
+        return;
+      }
       if (hasMatchingTrigger(tableName, "before", "delete")) {
         await fireTriggers("before", "delete", { id, op: "delete", previous: existing ?? void 0, table: tableName });
       }
@@ -1206,10 +1219,10 @@ const createSqlCtxDb = (options) => {
               `cross-backend cascade from global '${tableName}' into shardBy '${holderTable}' is not supported — would require Query Coordinator fan-out across shards`
             );
           }
-          const holders = await writer.findMany(holderTable, { where: { [field]: value } });
+          const holders = await writer.findMany(holderTable, { includeDeleted: hard, where: { [field]: value } });
           return holders.page;
         },
-        onCascade: (_holderTable, holderId) => writer.delete(holderId),
+        onCascade: (_holderTable, holderId) => writer.delete(holderId, void 0, deleteOptions),
         onRestrict: (message) => {
           throw new ConflictError(message, "restrict");
         },
@@ -1220,6 +1233,23 @@ const createSqlCtxDb = (options) => {
       });
       await ensureBackfilledForTable(tableName);
       await ensureRankBackfilledForTable(tableName);
+      if (softField && existing) {
+        const merged = { ...existing, [softField]: clock() };
+        const assignments = sql.join(
+          // eslint-disable-next-line unicorn/no-null -- SQL bind value: an absent column binds `null`, matching the patch path.
+          Object.keys(definition.shape).map((field) => sql`${sql.identifier(field)} = ${serializeColumnValue(merged[field] ?? null)}`),
+          sql`, `
+        );
+        await runGuardedWrite(tableName, "UPDATE", assignments, snapshot);
+        await syncAggregates(tableName, existing, merged);
+        await syncRanks(tableName, id, existing, void 0);
+        await syncSearch(tableName, id, merged);
+        await recordCdc(tableName, id, "update", merged);
+        if (hasMatchingTrigger(tableName, "after", "delete")) {
+          await fireTriggers("after", "delete", { id, op: "delete", previous: existing, table: tableName });
+        }
+        return;
+      }
       await runGuardedWrite(tableName, "DELETE", void 0, snapshot);
       tableNameCache.delete(id);
       await syncAggregates(tableName, existing ?? void 0, void 0);
@@ -1257,6 +1287,7 @@ const createSqlCtxDb = (options) => {
         return crossShardCounter ? crossShardCounter(childTable, where) : crossBackendUnsupported(childTable);
       };
       let predicate = mergeWhere(args.baseWhere, args.where);
+      predicate = mergeWhere(predicate, softDeleteScope(definition.softDeleteMode, args.includeDeleted));
       predicate = await resolveRelationPredicates(predicate, {
         fetcher: relationFetcher,
         maxRelationKeys,
@@ -1284,7 +1315,7 @@ const createSqlCtxDb = (options) => {
         if (args.with) {
           await resolveWith({ counter: relationCounter, fetcher: relationFetcher, parents: documents, schema, tableName, with: args.with });
         }
-        return { continueCursor: null, isDone: true, page: documents };
+        return { continueCursor: null, isDone: true, page: applySelect(documents, args.select, args.with) };
       }
       const hasMore = documents.length > limit;
       const page = hasMore ? documents.slice(0, limit) : documents;
@@ -1293,10 +1324,12 @@ const createSqlCtxDb = (options) => {
         await resolveWith({ counter: relationCounter, fetcher: relationFetcher, parents: page, schema, tableName, with: args.with });
       }
       return {
+        // The cursor is encoded from `last` (the full, unprojected row), so
+        // `applySelect` only trims the returned payload — paging is intact.
         // eslint-disable-next-line unicorn/no-null -- public return shape: `continueCursor` is `string | null`; `null` marks the final page.
         continueCursor: hasMore && last ? encodeCursor(last, orderKeys) : null,
         isDone: !hasMore,
-        page
+        page: applySelect(page, args.select, args.with)
       };
     },
     async get(id, expectedTable) {
@@ -1322,10 +1355,11 @@ const createSqlCtxDb = (options) => {
       if (agg.op !== "count" && !agg.field) {
         throw new Error(`groupBy(${tableName}, { agg: { op: "${agg.op}" } }): "field" is required for non-count reducers`);
       }
-      const effective = mergeWhere(groupOptions.baseWhere, groupOptions.where);
+      const groupScope = softDeleteScope(definition.softDeleteMode, void 0);
+      const effective = mergeWhere(mergeWhere(groupOptions.baseWhere, groupOptions.where), groupScope);
       const resolved = await resolveAggregateRelations(effective, tableName, groupOptions.relationBaseWhere);
       const hasRelation = resolved !== effective;
-      if (definition.aggregateIndexes && !groupOptions.baseWhere && !hasRelation) {
+      if (definition.aggregateIndexes && !groupOptions.baseWhere && !hasRelation && !groupScope) {
         const indexed = await tryIndexedGroupBy(tableName, definition.aggregateIndexes, agg, groupOptions);
         if (indexed !== void 0) {
           return indexed;
@@ -1452,6 +1486,26 @@ const createSqlCtxDb = (options) => {
         await fireTriggers("after", "update", { doc: merged, id, op: "update", previous: existing, table: tableName });
       }
     },
+    async restore(id, expectedTable) {
+      const tableName = await resolveTableName(id, expectedTable);
+      if (!tableName) {
+        throw new Error(`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`);
+      }
+      const snapshot = await rawRow(tableName, id);
+      const wasDeleted = snapshot?.[field] !== null && snapshot?.[field] !== void 0;
+      await writer.patch(id, { [field]: null }, expectedTable);
+      if (wasDeleted) {
+        const row = decodeRow(definition, snapshot);
+        if (row !== null) {
+          await syncRanks(tableName, id, void 0, row);
+        }
+      }
+    },
     query(tableName) {
       const definition = schema.tables[tableName];
       if (!definition) {

package/package.json

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