@vibesdotdev/storage 0.0.2 → 1.0.0-rc.4

package/dist/record/delivery.js

@@ -0,0 +1,262 @@
+import { RecordDeliveryClaimSchema } from "../schemas/record/delivery.js";
+export { StorageRecordDeliveryJobInputSchema, RecordDeliveryClaimSchema } from "../schemas/record/delivery.js";
+/**
+ * Durable delivery of created records (D-RC11, route a).
+ *
+ * A record kind that declares `delivery` gets its created rows delivered by a
+ * Workers job, not by the in-process `storage/record` hook. The hook bus lives
+ * on the writer's runtime and dies with it, so a finite CLI that writes a row
+ * and exits used to leave the row `pending` forever: the daemon holding the
+ * subscription never heard the event. Workers owns delivery, retry and dead
+ * letters (RC11, D19); this module only puts the job on the queue.
+ *
+ * - Durable intent: a record's pending delivery is defined over the row's own
+ *   fields (`delivery.pending.where`), so the intent is written by the same
+ *   INSERT as the record — no second write can be lost between them.
+ * - `enqueueRecordDelivery` runs inside `StorageRecord.create()`: an
+ *   idempotent claim (`WorkersClient.startJobOnce`) keyed by the record id.
+ * - `requeuePendingDeliveries` reconciles: every row still matching its
+ *   kind's pending filter is claimed again under the same key. It runs when
+ *   the Workers consumer starts AND on the Workers-scheduled
+ *   `storage.record-delivery.reconcile` job while it runs, so an enqueue that
+ *   failed after the row committed is recovered within one schedule period.
+ *   The claim skips a job already delayed, pending or running, and never
+ *   re-enqueues past a cancelled job.
+ * - Eligibility (`delivery.gate`): a kind whose delivery depends on a state
+ *   outside the row (the knowledge items gate: signed in, paid plan, service
+ *   declared) names a `storage/delivery-gate`. The reconcile asks it once per
+ *   pass, before listing anything. Ineligible: nothing is claimed, the rows
+ *   stay pending, and one typed skip line is logged for the pass. A gate that
+ *   cannot decide is a typed failure for the pass, never "ineligible" or
+ *   "eligible", and still claims nothing. `create()` does not claim a gated
+ *   kind; the next reconcile pass does, after the gate admits it.
+ * - Recovery: a claim made after the gate admitted it is stamped
+ *   `deliveryGate: <gate id>`. A failed (dead-lettered) job for a pending row
+ *   that lacks that stamp failed before eligibility was decided (the rows
+ *   that dead-lettered on a host with no service or no login), so the next
+ *   eligible pass starts a new attempt under the same key. A failed job that
+ *   carries the stamp failed while eligible and stays with the dead-letter
+ *   owner (`vibes workers dlq replay`), so a row that genuinely cannot be
+ *   delivered is not retried every period.
+ */
+import * as z from 'zod/v4';
+import { getLogger } from '@vibesdotdev/logging';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { resolveWorkersClient, WorkersClaimClientSchema } from "../workers-port.js";
+import { outcomeOf } from "../utils/failure-of.js";
+/** Input every delivery job receives. */
+/** Records fetched per page while re-enqueueing pending deliveries. */
+export const PENDING_DELIVERY_PAGE_SIZE = 200;
+/** Queue identity of one record's delivery job; the same record always maps to the same job. */
+export function deliveryJobKey(recordKind, recordId) {
+    return `storage-delivery:${recordKind}:${recordId}`;
+}
+/** Job metadata key stamped on a claim the kind's delivery gate admitted. */
+export const DELIVERY_GATE_METADATA_KEY = 'deliveryGate';
+/**
+ * Claim the declared delivery job for one record. Throws when the Workers
+ * client is not composed on `runtime` (`UNAVAILABLE`
+ * `storage-workers-client-absent`), when it answers a claim in an unexpected
+ * shape (`INTERNAL` `storage-delivery-claim-invalid`), or when the enqueue
+ * fails; the caller decides how to report it (the record itself is already
+ * persisted).
+ *
+ * `admittedByGate` is the gate id that admitted this claim: it stamps the job
+ * and lets a failed job claimed before that decision start a new attempt.
+ */
+export async function enqueueRecordDelivery(runtime, recordKind, delivery, recordId, admittedByGate) {
+    const workers = await resolveWorkersClient(runtime, WorkersClaimClientSchema);
+    const input = { recordKind, recordId };
+    const options = { jobId: deliveryJobKey(recordKind, recordId) };
+    if (admittedByGate) {
+        options.metadata = { [DELIVERY_GATE_METADATA_KEY]: admittedByGate };
+        options.restartFailed = (existing) => existing.metadata[DELIVERY_GATE_METADATA_KEY] !== admittedByGate;
+    }
+    const claimed = RecordDeliveryClaimSchema.safeParse(await workers.startJobOnce(delivery.job, input, options));
+    if (!claimed.success) {
+        throw new CapabilityError('The Workers client answered a delivery claim in an unexpected shape.', 'INTERNAL', { reason: 'storage-delivery-claim-invalid', retryable: false, details: { recordKind, job: delivery.job } });
+    }
+    return claimed.data;
+}
+/**
+ * Ask a record kind's declared delivery gate whether its records may be
+ * delivered now. A kind without a gate is always eligible. A declared gate
+ * that is not registered is a composition error (`UNAVAILABLE`
+ * `storage-delivery-gate-missing`); a gate that cannot decide throws its own
+ * typed error. Neither is ever read as a decision.
+ */
+export async function evaluateDeliveryGate(runtime, recordKind, delivery) {
+    if (!delivery.gate)
+        return { eligible: true };
+    const query = runtime.hasKind('storage/delivery-gate')
+        ? runtime.query('storage/delivery-gate').withId(delivery.gate)
+        : null;
+    if (!query || query.descriptors().length === 0) {
+        throw new CapabilityError(`Record kind '${recordKind}' declares delivery gate '${delivery.gate}', which is not registered on this runtime.`, 'UNAVAILABLE', { reason: 'storage-delivery-gate-missing', details: { recordKind, gate: delivery.gate } });
+    }
+    const gate = await query.resolve();
+    return gate.check();
+}
+/** A row of a record kind that declares delivery: only its primary key is read here. */
+const DeliveryRecordRowSchema = z.record(z.string(), z.unknown());
+/** A pending row's id: a non-empty string; any other primary-key value is not claimable. */
+const PendingRecordIdSchema = z.string().min(1);
+async function requeueKind(runtime, descriptor) {
+    const report = {
+        recordKind: descriptor.id,
+        job: descriptor.delivery.job,
+        pending: 0,
+        enqueued: 0,
+        alreadyActive: 0,
+        restarted: 0,
+        terminal: [],
+        failures: []
+    };
+    const logger = getLogger('storage:record-delivery', runtime);
+    // Eligibility first, once per pass: an ineligible or undecidable kind is
+    // neither listed nor claimed, so its rows stay pending with no job.
+    const decided = await outcomeOf(() => evaluateDeliveryGate(runtime, descriptor.id, descriptor.delivery));
+    if (!decided.ok) {
+        report.error = decided.failure;
+        logger.error('Delivery eligibility could not be decided; pending records stay pending this pass', {
+            reason: 'storage-delivery-gate-failed',
+            recordKind: descriptor.id,
+            gate: descriptor.delivery.gate,
+            error: decided.failure
+        });
+        return report;
+    }
+    const eligibility = decided.value;
+    if (!eligibility.eligible) {
+        report.skipped = { reason: eligibility.reason, condition: eligibility.condition, message: eligibility.message };
+        logger.info(eligibility.message, {
+            reason: eligibility.reason,
+            condition: eligibility.condition,
+            recordKind: descriptor.id,
+            gate: descriptor.delivery.gate,
+            job: descriptor.delivery.job
+        });
+        return report;
+    }
+    const primaryKey = descriptor.primaryKey || 'id';
+    const resolved = await outcomeOf(() => runtime
+        .query('storage/record')
+        .withId(descriptor.id)
+        .enabled()
+        .resolve());
+    if (!resolved.ok) {
+        report.error = resolved.failure;
+        logger.error('Pending deliveries could not be read: the record kind did not resolve', {
+            reason: 'storage-delivery-requeue-unreadable',
+            recordKind: descriptor.id,
+            error: resolved.failure
+        });
+        return report;
+    }
+    const record = resolved.value;
+    // Collect every pending id before enqueueing: a delivery that completes
+    // while this runs drops its row out of the pending filter, which would shift
+    // later pages and skip records.
+    const listed = await outcomeOf(async () => {
+        const ids = [];
+        for (let offset = 0;; offset += PENDING_DELIVERY_PAGE_SIZE) {
+            const page = await record.list({
+                where: descriptor.delivery.pending.where,
+                limit: PENDING_DELIVERY_PAGE_SIZE,
+                offset
+            });
+            for (const item of page.items) {
+                const recordId = PendingRecordIdSchema.safeParse(item[primaryKey]);
+                if (recordId.success)
+                    ids.push(recordId.data);
+            }
+            if (page.items.length < PENDING_DELIVERY_PAGE_SIZE)
+                return ids;
+        }
+    });
+    if (!listed.ok) {
+        report.error = listed.failure;
+        logger.error('Pending deliveries could not be listed', {
+            reason: 'storage-delivery-requeue-unreadable',
+            recordKind: descriptor.id,
+            error: listed.failure
+        });
+        return report;
+    }
+    const pendingIds = listed.value;
+    report.pending = pendingIds.length;
+    for (const recordId of pendingIds) {
+        const outcome = await outcomeOf(() => enqueueRecordDelivery(runtime, descriptor.id, descriptor.delivery, recordId, descriptor.delivery.gate));
+        if (!outcome.ok) {
+            report.failures.push({ recordId, error: outcome.failure });
+            logger.error('Pending delivery could not be enqueued', {
+                reason: 'storage-delivery-requeue-failed',
+                recordKind: descriptor.id,
+                recordId,
+                job: descriptor.delivery.job,
+                error: outcome.failure
+            });
+            continue;
+        }
+        const claimed = outcome.value;
+        if (claimed.claim === 'started')
+            report.enqueued++;
+        else if (claimed.claim === 'restarted')
+            report.restarted++;
+        else if (claimed.claim === 'already-active')
+            report.alreadyActive++;
+        else {
+            const terminal = { recordId };
+            if (claimed.existingStatus)
+                terminal.status = claimed.existingStatus;
+            report.terminal.push(terminal);
+        }
+    }
+    return report;
+}
+/**
+ * Enqueue again, idempotently, every record still awaiting delivery on every
+ * record kind that declares `delivery`. The Workers consumer calls this when it
+ * starts. A kind that fails to read is reported and does not stop the others.
+ */
+export async function requeuePendingDeliveries(runtime) {
+    if (!runtime.hasKind('storage/record'))
+        return [];
+    const descriptors = runtime
+        .query('storage/record')
+        .enabled()
+        .descriptors()
+        .filter((d) => Boolean(d.delivery));
+    const reports = [];
+    for (const descriptor of descriptors) {
+        reports.push(await requeueKind(runtime, descriptor));
+    }
+    const logger = getLogger('storage:record-delivery', runtime);
+    for (const report of reports) {
+        if (report.terminal.length > 0) {
+            logger.warn('Pending records whose delivery job ended failed or cancelled; left to the dead-letter owner', {
+                reason: 'storage-delivery-terminal',
+                recordKind: report.recordKind,
+                job: report.job,
+                records: report.terminal
+            });
+        }
+        if (report.pending > 0 || report.error) {
+            const summary = {
+                recordKind: report.recordKind,
+                job: report.job,
+                pending: report.pending,
+                enqueued: report.enqueued,
+                restarted: report.restarted,
+                alreadyActive: report.alreadyActive,
+                terminal: report.terminal.length,
+                failed: report.failures.length
+            };
+            if (report.error)
+                summary.error = report.error;
+            logger.info('Re-enqueued pending record deliveries', summary);
+        }
+    }
+    return reports;
+}
+//# sourceMappingURL=delivery.js.map

package/dist/record/delivery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery.js","sourceRoot":"","sources":["../../src/record/delivery.ts"],"names":[],"mappings":"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"}

package/dist/record/events.js

@@ -16,7 +16,7 @@
  * })
  * ```
  */
-import { createRuntimeAsset } from '@vibesdotdev/runtime';
+import { createRuntimeAsset } from '@vibesdotdev/kernel';
 export const storageRecordCreatedEvent = createRuntimeAsset({
     kind: 'runtime/event',
     id: 'storage.record.afterCreate',

package/dist/record/events.js.map

@@ -1 +1 @@
-{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/record/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,CAAC,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;IAC3D,IAAI,EAAE,eAAwB;IAC9B,EAAE,EAAE,4BAA4B;IAChC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,oDAAoD;IACjE,OAAO,EAAE,WAAoB;IAC7B,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,aAAsB;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;IAC3D,IAAI,EAAE,eAAwB;IAC9B,EAAE,EAAE,4BAA4B;IAChC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,0DAA0D;IACvE,OAAO,EAAE,WAAoB;IAC7B,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,aAAsB;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;IAC3D,IAAI,EAAE,eAAwB;IAC9B,EAAE,EAAE,4BAA4B;IAChC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,+DAA+D;IAC5E,OAAO,EAAE,WAAoB;IAC7B,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,aAAsB;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,yBAAyB;IACzB,yBAAyB;IACzB,yBAAyB;CACzB,CAAC"}
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/record/events.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAEzD,MAAM,CAAC,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;IAC3D,IAAI,EAAE,eAAwB;IAC9B,EAAE,EAAE,4BAA4B;IAChC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,oDAAoD;IACjE,OAAO,EAAE,WAAoB;IAC7B,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,aAAsB;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;IAC3D,IAAI,EAAE,eAAwB;IAC9B,EAAE,EAAE,4BAA4B;IAChC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,0DAA0D;IACvE,OAAO,EAAE,WAAoB;IAC7B,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,aAAsB;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,yBAAyB,GAAG,kBAAkB,CAAC;IAC3D,IAAI,EAAE,eAAwB;IAC9B,EAAE,EAAE,4BAA4B;IAChC,IAAI,EAAE,wBAAwB;IAC9B,WAAW,EAAE,+DAA+D;IAC5E,OAAO,EAAE,WAAoB;IAC7B,MAAM,EAAE,gBAAgB;IACxB,SAAS,EAAE,aAAsB;CACjC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,yBAAyB;IACzB,yBAAyB;IACzB,yBAAyB;CACzB,CAAC"}

package/dist/record/extensions.d.ts

@@ -4,10 +4,10 @@
  * Additional methods for FTS, hierarchy, computed fields, side effects, and raw queries.
  * These are mixed into the StorageRecord class.
  */
-import type { SqlDatabaseHandle } from '../interfaces/adapter';
-import type { StorageRecordDescriptor, StorageSideEffect } from '../schemas/record';
-import type { SearchOptions, SearchResult, HierarchyOptions, TreeNode, RawQueryOptions, QueryOptions, QueryResult } from '../interfaces/record';
-import type { VibesRuntime } from '@vibesdotdev/runtime';
+import type { SqlDatabaseHandle } from '../interfaces/adapter.ts';
+import type { StorageRecordDescriptor, StorageSideEffect } from '../schemas/record/index.ts';
+import type { SearchOptions, SearchResult, HierarchyOptions, TreeNode, RawQueryOptions, QueryOptions, QueryResult } from '../interfaces/record/index.ts';
+import type { RuntimeRef } from '@vibesdotdev/kernel';
 /**
  * Extended StorageRecord methods interface
  */
@@ -22,6 +22,9 @@ export interface StorageRecordExtensions<T> {
     raw<R>(sql: string, ...params: unknown[]): Promise<R[]>;
     queryRaw<R>(options: RawQueryOptions<R>): Promise<R[]>;
 }
+/** A built SQL statement and its positional parameters. */
+export type { RecordSqlQuery } from '../schemas/record/query-values.ts';
+import type { RecordSqlQuery } from '../schemas/record/query-values.ts';
 /**
  * Create FTS table and triggers for SQLite
  */
@@ -29,21 +32,21 @@ export declare function createFtsTable(db: SqlDatabaseHandle, tableName: string,
 /**
  * Build FTS search query for SQLite
  */
-export declare function buildFtsSearchQuery(tableName: string, ftsFields: string[], query: string, options?: SearchOptions<unknown>): {
-    sql: string;
-    params: unknown[];
-};
+export declare function buildFtsSearchQuery(tableName: string, ftsFields: string[], query: string, options?: SearchOptions<unknown>): RecordSqlQuery;
 /**
  * Build recursive CTE for hierarchy queries
  */
-export declare function buildRecursiveCTE(tableName: string, parentField: string, primaryKey: string, rootId: string, options?: HierarchyOptions<unknown>): {
-    sql: string;
-    params: unknown[];
-};
+export declare function buildRecursiveCTE(tableName: string, parentField: string, primaryKey: string, rootId: string, options?: HierarchyOptions<unknown>): RecordSqlQuery;
+/** The record whose write triggers side effects: its foreign keys name the targets. */
+import { type CrossTableRow as SideEffectSourceRecord } from '../schemas/record/query-values.ts';
+export type { CrossTableRow as SideEffectSourceRecord } from '../schemas/record/query-values.ts';
 /**
- * Execute side effects
+ * Execute side effects. Skips and failures are reported to the record's
+ * handed runtime's Logging. A failing effect that declares `ignoreMissing:
+ * false` throws its failure; any other failing effect is logged as its
+ * value-free facts and the rest still run.
  */
-export declare function executeSideEffects(sideEffects: StorageSideEffect[], sourceRecord: Record<string, unknown>, runtime?: VibesRuntime, db?: SqlDatabaseHandle): Promise<void>;
+export declare function executeSideEffects(sideEffects: StorageSideEffect[], sourceRecord: SideEffectSourceRecord, runtime: RuntimeRef, db?: SqlDatabaseHandle): Promise<void>;
 /**
  * Build computed field subquery
  */

package/dist/record/extensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/record/extensions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extensions.d.ts","sourceRoot":"","sources":["../../src/record/extensions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAMlE,OAAO,KAAK,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,KAAK,EACX,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,QAAQ,EACR,eAAe,EACf,YAAY,EACZ,WAAW,EACX,MAAM,+BAA+B,CAAC;AACvC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,uBAAuB,CAAC,CAAC;IAEzC,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;IAG5E,cAAc,CACb,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC3B,OAAO,CAAC,WAAW,CAAC,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC,CAAC;IAChE,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAClE,OAAO,CAAC,OAAO,CAAC,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAG/D,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACxD,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;CACvD;AAED,2DAA2D;AAC3D,YAAY,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AAExE;;GAEG;AACH,wBAAgB,cAAc,CAC7B,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EAAE,EACnB,YAAY,CAAC,EAAE,MAAM,EACrB,SAAS,CAAC,EAAE,MAAM,GAChB,IAAI,CAwCN;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAClC,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,GAC9B,cAAc,CA+BhB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,GACjC,cAAc,CA+BhB;AAED,uFAAuF;AACvF,OAAO,EAAE,KAAK,aAAa,IAAI,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACjG,YAAY,EAAE,aAAa,IAAI,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AA0EjG;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACvC,WAAW,EAAE,iBAAiB,EAAE,EAChC,YAAY,EAAE,sBAAsB,EACpC,OAAO,EAAE,UAAU,EACnB,EAAE,CAAC,EAAE,iBAAiB,GACpB,OAAO,CAAC,IAAI,CAAC,CAef;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACzC,UAAU,EAAE,uBAAuB,EACnC,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,WAAW,CAAC,uBAAuB,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,GAC3E,MAAM,CAmDR"}

package/dist/record/extensions.js

@@ -4,9 +4,10 @@
  * Additional methods for FTS, hierarchy, computed fields, side effects, and raw queries.
  * These are mixed into the StorageRecord class.
  */
+import * as z from 'zod/v4';
 import { getLogger } from '@vibesdotdev/logging';
-import { toErrorContext } from '../utils/error-context.js';
-const logger = getLogger('storage:record');
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { failureOfSync } from "../utils/failure-of.js";
 /**
  * Create FTS table and triggers for SQLite
  */
@@ -108,63 +109,88 @@ export function buildRecursiveCTE(tableName, parentField, primaryKey, rootId, op
 	`;
     return { sql, params: [rootId, maxDepth] };
 }
+/** The record whose write triggers side effects: its foreign keys name the targets. */
+import {} from "../schemas/record/query-values.js";
+/** A side effect's value generator: it receives the source record. */
+const SideEffectValueFnSchema = z.custom((value) => value instanceof Function);
+/** A target row id read from the source record's foreign key; any other value names no target. */
+const SideEffectTargetIdSchema = z.union([z.string(), z.number()]);
+/** The target row id of one side effect, or undefined when the source names none. */
+function sideEffectTargetId(effect, sourceRecord) {
+    if (!effect.foreignKey)
+        return undefined;
+    const parsed = SideEffectTargetIdSchema.safeParse(sourceRecord[effect.foreignKey]);
+    return parsed.success && parsed.data ? parsed.data : undefined;
+}
+/** The value one side effect writes: its generator's result, its fixed value, or a touch timestamp. */
+function sideEffectValue(effect, sourceRecord) {
+    if (effect.valueFn !== undefined) {
+        const valueFn = SideEffectValueFnSchema.safeParse(effect.valueFn);
+        if (!valueFn.success) {
+            throw new CapabilityError(`Side effect on '${effect.target}' declares a valueFn that is not a function.`, 'INVALID_INPUT', {
+                reason: 'storage-side-effect-value-fn-invalid',
+                details: { target: effect.target }
+            });
+        }
+        return valueFn.data(sourceRecord);
+    }
+    if (effect.value !== undefined)
+        return effect.value;
+    if (effect.operation === 'touch')
+        return new Date().toISOString();
+    return undefined;
+}
+/** Apply one side effect to its target row. */
+function applySideEffect(effect, sourceRecord, targetId, db) {
+    const value = sideEffectValue(effect, sourceRecord);
+    if (!db || !targetId || !effect.field)
+        return;
+    const table = effect.target.split('.')[1] || effect.target;
+    if (effect.operation === 'increment') {
+        db.prepare(`
+			UPDATE ${table} 
+			SET data = json_set(data, '$.${effect.field}', 
+				COALESCE(json_extract(data, '$.${effect.field}'), 0) + 1)
+			WHERE id = ?
+		`).run(targetId);
+    }
+    else if (effect.operation === 'decrement') {
+        db.prepare(`
+			UPDATE ${table}
+			SET data = json_set(data, '$.${effect.field}',
+				COALESCE(json_extract(data, '$.${effect.field}'), 0) - 1)
+			WHERE id = ?
+		`).run(targetId);
+    }
+    else {
+        db.prepare(`
+			UPDATE ${table}
+			SET data = json_set(data, '$.${effect.field}', ?)
+			WHERE id = ?
+		`).run(value, targetId);
+    }
+}
 /**
- * Execute side effects
+ * Execute side effects. Skips and failures are reported to the record's
+ * handed runtime's Logging. A failing effect that declares `ignoreMissing:
+ * false` throws its failure; any other failing effect is logged as its
+ * value-free facts and the rest still run.
  */
 export async function executeSideEffects(sideEffects, sourceRecord, runtime, db) {
+    const logger = getLogger('storage:record', runtime);
     for (const effect of sideEffects) {
-        try {
-            // Get target ID from foreign key
-            const targetId = effect.foreignKey ? sourceRecord[effect.foreignKey] : null;
-            if (!targetId && !effect.ignoreMissing) {
-                logger.warn(`[SideEffects] No target ID for effect on ${effect.target}`);
-                continue;
-            }
-            // Calculate value
-            let value;
-            if (effect.valueFn) {
-                value = effect.valueFn(sourceRecord);
-            }
-            else if (effect.value !== undefined) {
-                value = effect.value;
-            }
-            else if (effect.operation === 'touch') {
-                value = new Date().toISOString();
-            }
-            // Execute update
-            if (db && targetId) {
-                const _setClause = effect.field ? `json_set(data, '$.${effect.field}', ?)` : '?';
-                if (effect.operation === 'increment' && effect.field) {
-                    db.query(`
-						UPDATE ${effect.target.split('.')[1] || effect.target} 
-						SET data = json_set(data, '$.${effect.field}', 
-							COALESCE(json_extract(data, '$.${effect.field}'), 0) + 1)
-						WHERE id = ?
-					`).run(targetId);
-                }
-                else if (effect.operation === 'decrement' && effect.field) {
-                    db.query(`
-						UPDATE ${effect.target.split('.')[1] || effect.target}
-						SET data = json_set(data, '$.${effect.field}',
-							COALESCE(json_extract(data, '$.${effect.field}'), 0) - 1)
-						WHERE id = ?
-					`).run(targetId);
-                }
-                else if (effect.field) {
-                    db.query(`
-						UPDATE ${effect.target.split('.')[1] || effect.target}
-						SET data = json_set(data, '$.${effect.field}', ?)
-						WHERE id = ?
-					`).run(value, targetId);
-                }
-            }
+        const targetId = sideEffectTargetId(effect, sourceRecord);
+        if (!targetId && !effect.ignoreMissing) {
+            logger.warn(`[SideEffects] No target ID for effect on ${effect.target}`);
+            continue;
         }
-        catch (error) {
-            logger.error(`[SideEffects] Failed to execute effect:`, toErrorContext(error));
-            if (!effect.ignoreMissing) {
-                throw error;
-            }
+        if (!effect.ignoreMissing) {
+            applySideEffect(effect, sourceRecord, targetId, db);
+            continue;
         }
+        const failure = failureOfSync(() => applySideEffect(effect, sourceRecord, targetId, db));
+        if (failure)
+            logger.error('[SideEffects] Failed to execute effect', { target: effect.target, error: failure });
     }
 }
 /**

package/dist/record/extensions.js.map

@@ -1 +1 @@
-{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../src/record/extensions.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"extensions.js","sourceRoot":"","sources":["../../src/record/extensions.ts"],"names":[],"mappings":"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"}

package/dist/record/failure-condition.d.ts

@@ -0,0 +1,14 @@
+/**
+ * What a failed record statement hit, as LocalDB's SQLite driver classifies it
+ * (`details.condition` on `sqlite-statement-failed`): owners branch on the
+ * fixed word — a missing table is an empty store, a unique collision a lost
+ * race — instead of matching SQLite's text, which never reaches a message.
+ */
+export { sqliteFailureCondition as storageFailureCondition, type SqliteFailureCondition as StorageFailureCondition } from '@vibesdotdev/localdb/sqlite-driver';
+/**
+ * Whether a record migration failed because its table does not exist yet (a
+ * consumer reading before its first seed): LocalDB's driver says so with the
+ * `missing-table` condition; another adapter may only say it in its message.
+ */
+export declare function isRecordTableMissing(failure: Error): boolean;
+//# sourceMappingURL=failure-condition.d.ts.map

package/dist/record/failure-condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-condition.d.ts","sourceRoot":"","sources":["../../src/record/failure-condition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACN,sBAAsB,IAAI,uBAAuB,EACjD,KAAK,sBAAsB,IAAI,uBAAuB,EACtD,MAAM,oCAAoC,CAAC;AAI5C;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,KAAK,GAAG,OAAO,CAE5D"}

package/dist/record/failure-condition.js

@@ -0,0 +1,17 @@
+/**
+ * What a failed record statement hit, as LocalDB's SQLite driver classifies it
+ * (`details.condition` on `sqlite-statement-failed`): owners branch on the
+ * fixed word — a missing table is an empty store, a unique collision a lost
+ * race — instead of matching SQLite's text, which never reaches a message.
+ */
+export { sqliteFailureCondition as storageFailureCondition } from '@vibesdotdev/localdb/sqlite-driver';
+import { sqliteFailureCondition } from '@vibesdotdev/localdb/sqlite-driver';
+/**
+ * Whether a record migration failed because its table does not exist yet (a
+ * consumer reading before its first seed): LocalDB's driver says so with the
+ * `missing-table` condition; another adapter may only say it in its message.
+ */
+export function isRecordTableMissing(failure) {
+    return sqliteFailureCondition(failure) === 'missing-table' || /no such table/i.test(failure.message);
+}
+//# sourceMappingURL=failure-condition.js.map

package/dist/record/failure-condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"failure-condition.js","sourceRoot":"","sources":["../../src/record/failure-condition.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EACN,sBAAsB,IAAI,uBAAuB,EAEjD,MAAM,oCAAoC,CAAC;AAE5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAE5E;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAc;IAClD,OAAO,sBAAsB,CAAC,OAAO,CAAC,KAAK,eAAe,IAAI,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;AACtG,CAAC"}

package/dist/record/index.d.ts

@@ -3,5 +3,9 @@
  *
  * Exports the StorageRecord class for single-table CRUD operations.
  */
-export { StorageRecord } from './base';
+export { StorageRecord, OptimisticLockError } from './base.ts';
+export { recordRevisions } from './revision.ts';
+export { recordAtomic } from './atomic.ts';
+export { mergeRecord, RECORD_MERGE_ATTEMPTS } from './merge.ts';
+export { deliveryJobKey, enqueueRecordDelivery, evaluateDeliveryGate, DELIVERY_GATE_METADATA_KEY, requeuePendingDeliveries, StorageRecordDeliveryJobInputSchema, PENDING_DELIVERY_PAGE_SIZE, type StorageRecordDeliveryJobInput, type PendingDeliveryReport } from './delivery.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/record/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/record/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/record/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EACN,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,mCAAmC,EACnC,0BAA0B,EAC1B,KAAK,6BAA6B,EAClC,KAAK,qBAAqB,EAC1B,MAAM,eAAe,CAAC"}

package/dist/record/index.js

@@ -3,5 +3,9 @@
  *
  * Exports the StorageRecord class for single-table CRUD operations.
  */
-export { StorageRecord } from './base.js';
+export { StorageRecord, OptimisticLockError } from "./base.js";
+export { recordRevisions } from "./revision.js";
+export { recordAtomic } from "./atomic.js";
+export { mergeRecord, RECORD_MERGE_ATTEMPTS } from "./merge.js";
+export { deliveryJobKey, enqueueRecordDelivery, evaluateDeliveryGate, DELIVERY_GATE_METADATA_KEY, requeuePendingDeliveries, StorageRecordDeliveryJobInputSchema, PENDING_DELIVERY_PAGE_SIZE } from "./delivery.js";
 //# sourceMappingURL=index.js.map

package/dist/record/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/record/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/record/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EACN,cAAc,EACd,qBAAqB,EACrB,oBAAoB,EACpB,0BAA0B,EAC1B,wBAAwB,EACxB,mCAAmC,EACnC,0BAA0B,EAG1B,MAAM,eAAe,CAAC"}