@happyvertical/smrt-core 0.60.9 → 0.60.10

package/dist/smrt-knowledge.okf.md

@@ -0,0 +1,181 @@
+---
+type: "Component"
+title: "@happyvertical/smrt-core"
+description: "Core SMRT framework for business objects, persistence, and generated REST, CLI, MCP, and AI interfaces"
+status: "stable"
+generated:
+  by: "smrt/scripts/generate-knowledge-okf.ts"
+  at: "2026-11-05T20:27:03Z"
+audience: "internal"
+evidence_level: "source-inspected"
+source_revision: "sha256:53b8a0911a425be4d61221228978265f10d7550b534098ed74d32c2ef13327fd"
+sources:
+  - id: "manifest"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/package.json"
+    title: "@happyvertical/smrt-core package manifest"
+  - id: "agents"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/AGENTS.md"
+    title: "@happyvertical/smrt-core packages/core/AGENTS.md"
+  - id: "agents-2"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/browser-entry.md"
+    title: "@happyvertical/smrt-core packages/core/agents/browser-entry.md"
+  - id: "agents-3"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/build-knowledge.md"
+    title: "@happyvertical/smrt-core packages/core/agents/build-knowledge.md"
+  - id: "agents-4"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/change-feed.md"
+    title: "@happyvertical/smrt-core packages/core/agents/change-feed.md"
+  - id: "agents-5"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/change-signals.md"
+    title: "@happyvertical/smrt-core packages/core/agents/change-signals.md"
+  - id: "agents-6"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/collection-reads.md"
+    title: "@happyvertical/smrt-core packages/core/agents/collection-reads.md"
+  - id: "agents-7"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/cookbook-engine.md"
+    title: "@happyvertical/smrt-core packages/core/agents/cookbook-engine.md"
+  - id: "agents-8"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/cookbook.md"
+    title: "@happyvertical/smrt-core packages/core/agents/cookbook.md"
+  - id: "agents-9"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/data-query.md"
+    title: "@happyvertical/smrt-core packages/core/agents/data-query.md"
+  - id: "agents-10"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/deployment-phases.md"
+    title: "@happyvertical/smrt-core packages/core/agents/deployment-phases.md"
+  - id: "agents-11"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/generators.md"
+    title: "@happyvertical/smrt-core packages/core/agents/generators.md"
+  - id: "agents-12"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/memory.md"
+    title: "@happyvertical/smrt-core packages/core/agents/memory.md"
+  - id: "agents-13"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/model-moves.md"
+    title: "@happyvertical/smrt-core packages/core/agents/model-moves.md"
+  - id: "agents-14"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/object-runtime.md"
+    title: "@happyvertical/smrt-core packages/core/agents/object-runtime.md"
+  - id: "agents-15"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/query-bounds.md"
+    title: "@happyvertical/smrt-core packages/core/agents/query-bounds.md"
+  - id: "agents-16"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/recipes.md"
+    title: "@happyvertical/smrt-core packages/core/agents/recipes.md"
+  - id: "agents-17"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/registry-snapshot.md"
+    title: "@happyvertical/smrt-core packages/core/agents/registry-snapshot.md"
+  - id: "agents-18"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/revision-guard.md"
+    title: "@happyvertical/smrt-core packages/core/agents/revision-guard.md"
+  - id: "agents-19"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/run-once.md"
+    title: "@happyvertical/smrt-core packages/core/agents/run-once.md"
+  - id: "agents-20"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/schema-paths.md"
+    title: "@happyvertical/smrt-core packages/core/agents/schema-paths.md"
+  - id: "agents-21"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/system-diagnostics.md"
+    title: "@happyvertical/smrt-core packages/core/agents/system-diagnostics.md"
+  - id: "agents-22"
+    resource: "https://github.com/happyvertical/smrt/blob/main/packages/core/agents/test-types.md"
+    title: "@happyvertical/smrt-core packages/core/agents/test-types.md"
+---
+
+# @happyvertical/smrt-core
+
+## Package
+
+- Directory: `packages/core`
+- Private: no
+- Object source: `domain-artifact`
+- Evidence level: `source-inspected`
+
+## Documentation
+
+- `packages/core/AGENTS.md`
+- `packages/core/agents/browser-entry.md`
+- `packages/core/agents/build-knowledge.md`
+- `packages/core/agents/change-feed.md`
+- `packages/core/agents/change-signals.md`
+- `packages/core/agents/collection-reads.md`
+- `packages/core/agents/cookbook-engine.md`
+- `packages/core/agents/cookbook.md`
+- `packages/core/agents/data-query.md`
+- `packages/core/agents/deployment-phases.md`
+- `packages/core/agents/generators.md`
+- `packages/core/agents/memory.md`
+- `packages/core/agents/model-moves.md`
+- `packages/core/agents/object-runtime.md`
+- `packages/core/agents/query-bounds.md`
+- `packages/core/agents/recipes.md`
+- `packages/core/agents/registry-snapshot.md`
+- `packages/core/agents/revision-guard.md`
+- `packages/core/agents/run-once.md`
+- `packages/core/agents/schema-paths.md`
+- `packages/core/agents/system-diagnostics.md`
+- `packages/core/agents/test-types.md`
+
+## Framework dependencies
+
+- [smrt-config](/components/smrt-config.md)
+- [smrt-scanner](/components/smrt-scanner.md)
+- [smrt-types](/components/smrt-types.md)
+
+## SDK dependencies
+
+- `@happyvertical/ai`
+- `@happyvertical/files`
+- `@happyvertical/json`
+- `@happyvertical/logger`
+- `@happyvertical/sql`
+- `@happyvertical/utils`
+
+## Exports
+
+- `.`
+- `./byo-inference`
+- `./consumer-plugin`
+- `./cookbook`
+- `./cookbook/engine`
+- `./cookbook/v1.schema.json`
+- `./filesystem`
+- `./generators`
+- `./generators/custom-action`
+- `./generators/mcp`
+- `./generators/rest`
+- `./generators/swagger`
+- `./knowledge`
+- `./manifest`
+- `./manifest.json`
+- `./manifest/discover-base-classes`
+- `./manifest/discover-smrt-packages`
+- `./mcp-serializer`
+- `./migrations`
+- `./prebuild`
+- `./prebuild/cli`
+- `./recipe-demo`
+- `./runtime`
+- `./scanner`
+- `./scanner/types`
+- `./schema`
+- `./schema/utils`
+- `./smrt-error`
+- `./smrt-knowledge.json`
+- `./table-cache`
+- `./testing`
+- `./ui-metadata`
+- `./utils`
+- `./utils/database-url`
+- `./utils/import-workspace-module`
+- `./vite`
+- `./vite-plugin`
+
+## Models
+
+- `SmrtClass` (collection `smrtclasses`)
+- `SmrtCollection` (collection `smrtcollections`, extends `SmrtClass`)
+- `SmrtHierarchical` (collection `smrthierarchicals`, extends `SmrtObject`)
+- `SmrtJunction` (collection `smrtjunctions`, extends `SmrtJunctionBase`)
+- `SmrtJunctionBase` (collection `smrtjunctionbases`, extends `SmrtCollection`)
+- `SmrtObject` (collection `smrtobjects`, extends `SmrtClass`)
+- `SmrtPolymorphicAssociation` (collection `smrtpolymorphicassociations`, extends `SmrtObject`)

package/dist/sync-device.d.ts

@@ -0,0 +1,6 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+/** Configure the identity used for local tracked writes on this database handle. */
+export declare function setDatabaseSyncDeviceId(db: DatabaseInterface, deviceId: string): void;
+export declare function getDatabaseSyncDeviceId(db: DatabaseInterface): string | undefined;
+export declare function inheritDatabaseSyncDeviceId(db: DatabaseInterface, bound: DatabaseInterface): void;
+//# sourceMappingURL=sync-device.d.ts.map

package/dist/sync-device.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-device.d.ts","sourceRoot":"","sources":["../src/sync-device.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAI5D,oFAAoF;AACpF,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,iBAAiB,EACrB,QAAQ,EAAE,MAAM,GACf,IAAI,CAUN;AAED,wBAAgB,uBAAuB,CACrC,EAAE,EAAE,iBAAiB,GACpB,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,2BAA2B,CACzC,EAAE,EAAE,iBAAiB,EACrB,KAAK,EAAE,iBAAiB,GACvB,IAAI,CAGN"}

package/dist/sync-device.js

@@ -0,0 +1,18 @@
+//#region src/sync-device.ts
+var deviceIds = /* @__PURE__ */ new WeakMap();
+/** Configure the identity used for local tracked writes on this database handle. */
+function setDatabaseSyncDeviceId(db, deviceId) {
+	if (typeof deviceId !== "string" || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(deviceId)) throw new TypeError("The sync device ID must be a UUID");
+	deviceIds.set(db, deviceId.toLowerCase());
+}
+function getDatabaseSyncDeviceId(db) {
+	return deviceIds.get(db);
+}
+function inheritDatabaseSyncDeviceId(db, bound) {
+	const deviceId = getDatabaseSyncDeviceId(db);
+	if (deviceId !== void 0) deviceIds.set(bound, deviceId);
+}
+//#endregion
+export { getDatabaseSyncDeviceId, inheritDatabaseSyncDeviceId, setDatabaseSyncDeviceId };
+
+//# sourceMappingURL=sync-device.js.map

package/dist/sync-device.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-device.js","names":[],"sources":["../src/sync-device.ts"],"sourcesContent":["import type { DatabaseInterface } from '@happyvertical/sql';\n\nconst deviceIds = new WeakMap<DatabaseInterface, string>();\n\n/** Configure the identity used for local tracked writes on this database handle. */\nexport function setDatabaseSyncDeviceId(\n  db: DatabaseInterface,\n  deviceId: string,\n): void {\n  if (\n    typeof deviceId !== 'string' ||\n    !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(\n      deviceId,\n    )\n  ) {\n    throw new TypeError('The sync device ID must be a UUID');\n  }\n  deviceIds.set(db, deviceId.toLowerCase());\n}\n\nexport function getDatabaseSyncDeviceId(\n  db: DatabaseInterface,\n): string | undefined {\n  return deviceIds.get(db);\n}\n\nexport function inheritDatabaseSyncDeviceId(\n  db: DatabaseInterface,\n  bound: DatabaseInterface,\n): void {\n  const deviceId = getDatabaseSyncDeviceId(db);\n  if (deviceId !== undefined) deviceIds.set(bound, deviceId);\n}\n"],"mappings":";AAEA,IAAM,4BAAY,IAAI,QAAmC;;AAGzD,SAAgB,wBACd,IACA,UACM;CACN,IACE,OAAO,aAAa,YACpB,CAAC,kEAAkE,KACjE,QACF,GAEA,MAAM,IAAI,UAAU,mCAAmC;CAEzD,UAAU,IAAI,IAAI,SAAS,YAAY,CAAC;AAC1C;AAEA,SAAgB,wBACd,IACoB;CACpB,OAAO,UAAU,IAAI,EAAE;AACzB;AAEA,SAAgB,4BACd,IACA,OACM;CACN,MAAM,WAAW,wBAAwB,EAAE;CAC3C,IAAI,aAAa,KAAA,GAAW,UAAU,IAAI,OAAO,QAAQ;AAC3D"}

package/dist/sync-tombstones.d.ts

@@ -0,0 +1,30 @@
+import type { DatabaseInterface } from '@happyvertical/sql';
+import { RuntimeError } from './errors.js';
+export declare const SYNC_TOMBSTONES_TABLE = "_smrt_sync_tombstones";
+export interface SyncRevision {
+    originDeviceId: string;
+    revision: number;
+}
+export interface SyncRowIdentity {
+    tableName: string;
+    model: string;
+    tenantColumn?: string;
+    sti?: boolean;
+}
+/** DuckDB binds JavaScript integer numbers as INT32, even for BIGINT columns. */
+export declare function bindSyncRevision(revision: number, nativeDuckDb: boolean): number | bigint;
+export declare function compareSyncRevisions(left: SyncRevision, right: SyncRevision): number;
+export declare function validateSyncRevision(originDeviceId: unknown, revision: unknown): SyncRevision;
+export declare function syncRevisionConflict(id: unknown): RuntimeError;
+export declare function lockSyncRowIdentity(db: DatabaseInterface, tableName: string, rowId: string): Promise<void>;
+export declare function putSyncTombstone(db: DatabaseInterface, identity: SyncRowIdentity, rowId: string, model: string, tenantId: string | null, revision: SyncRevision): Promise<void>;
+/** Must run inside the same transaction as the enclosing delete/cascade. */
+export declare function deleteSyncRows(db: DatabaseInterface, identity: SyncRowIdentity, filter: Record<string, unknown>, didDelete: (count: number) => void, incoming?: {
+    rowId: string;
+    tenantId: string | null;
+    revision: SyncRevision;
+}): Promise<{
+    affected: number;
+}>;
+export declare function nullSyncReference(db: DatabaseInterface, tableName: string, column: string, filter: Record<string, unknown>, didUpdate: (count: number) => void): Promise<void>;
+//# sourceMappingURL=sync-tombstones.d.ts.map

package/dist/sync-tombstones.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-tombstones.d.ts","sourceRoot":"","sources":["../src/sync-tombstones.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAK5D,OAAO,EAAE,YAAY,EAAmB,MAAM,aAAa,CAAC;AAQ5D,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAE7D,MAAM,WAAW,YAAY;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAUD,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,mBAEvE;AAMD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,UAS3E;AAED,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,OAAO,EACvB,QAAQ,EAAE,OAAO,GAChB,YAAY,CAed;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,OAAO,gBAM/C;AAED,wBAAsB,mBAAmB,CACvC,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAsB,gBAAgB,CACpC,EAAE,EAAE,iBAAiB,EACrB,QAAQ,EAAE,eAAe,EACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,QAAQ,EAAE,YAAY,GACrB,OAAO,CAAC,IAAI,CAAC,CAmCf;AAED,4EAA4E;AAC5E,wBAAsB,cAAc,CAClC,EAAE,EAAE,iBAAiB,EACrB,QAAQ,EAAE,eAAe,EACzB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,EAClC,QAAQ,CAAC,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAA;CAAE,GAC5E,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CA6D/B;AAED,wBAAsB,iBAAiB,CACrC,EAAE,EAAE,iBAAiB,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GACjC,OAAO,CAAC,IAAI,CAAC,CAiCf"}

package/dist/sync-tombstones.js

@@ -0,0 +1,112 @@
+import { buildWhere } from "./host.js";
+import { isJsonAdapterHandle, isKnownNativeDuckDbHandle } from "./native-duckdb.js";
+import { getDatabaseSyncDeviceId } from "./sync-device.js";
+import { isPostgresDatabase, usesPostgresDialect } from "./embedded-write-queue.js";
+import { RuntimeError, ValidationError } from "./errors.js";
+//#region src/sync-tombstones.ts
+var SYNC_TOMBSTONES_TABLE = "_smrt_sync_tombstones";
+function dialect(db) {
+	return usesPostgresDialect(db) ? "postgres" : isKnownNativeDuckDbHandle(db) ? "duckdb" : "sqlite";
+}
+/** DuckDB binds JavaScript integer numbers as INT32, even for BIGINT columns. */
+function bindSyncRevision(revision, nativeDuckDb) {
+	return nativeDuckDb ? BigInt(revision) : revision;
+}
+function quote(name) {
+	return `"${name.replaceAll("\"", "\"\"")}"`;
+}
+function compareSyncRevisions(left, right) {
+	return left.revision - right.revision || (left.originDeviceId > right.originDeviceId ? 1 : left.originDeviceId < right.originDeviceId ? -1 : 0);
+}
+function validateSyncRevision(originDeviceId, revision) {
+	if (typeof originDeviceId !== "string" || !originDeviceId.trim() || originDeviceId.length > 255 || typeof revision !== "number" || !Number.isSafeInteger(revision) || revision < 1) throw new ValidationError("Invalid sync revision or missing local sync device", "VALIDATION_SYNC_METADATA");
+	return {
+		originDeviceId,
+		revision
+	};
+}
+function syncRevisionConflict(id) {
+	return new RuntimeError("Incoming sync revision does not advance the row", "RUNTIME_SYNC_REVISION_CONFLICT", { id });
+}
+async function lockSyncRowIdentity(db, tableName, rowId) {
+	if (!isPostgresDatabase(db)) return;
+	await db.query("SELECT pg_advisory_xact_lock(hashtextextended($1::text, 0))", JSON.stringify([
+		SYNC_TOMBSTONES_TABLE,
+		tableName,
+		rowId
+	]));
+}
+async function putSyncTombstone(db, identity, rowId, model, tenantId, revision) {
+	const filter = {
+		table_name: identity.tableName,
+		row_id: rowId
+	};
+	const old = await db.get(SYNC_TOMBSTONES_TABLE, filter);
+	if (old) {
+		if (old.model !== model || (old.tenant_id ?? null) !== tenantId || compareSyncRevisions(revision, validateSyncRevision(old.origin_device_id, Number(old.revision))) <= 0) throw syncRevisionConflict(rowId);
+		await db.update(SYNC_TOMBSTONES_TABLE, filter, {
+			origin_device_id: revision.originDeviceId,
+			revision: bindSyncRevision(revision.revision, isKnownNativeDuckDbHandle(db)),
+			deleted_at: (/* @__PURE__ */ new Date()).toISOString()
+		});
+		return;
+	}
+	await db.insert(SYNC_TOMBSTONES_TABLE, {
+		...filter,
+		model,
+		tenant_id: tenantId,
+		origin_device_id: revision.originDeviceId,
+		revision: bindSyncRevision(revision.revision, isKnownNativeDuckDbHandle(db)),
+		deleted_at: (/* @__PURE__ */ new Date()).toISOString()
+	});
+}
+/** Must run inside the same transaction as the enclosing delete/cascade. */
+async function deleteSyncRows(db, identity, filter, didDelete, incoming) {
+	if (isJsonAdapterHandle(db)) {
+		if (incoming) throw RuntimeError.invalidState("Sync tombstones require a SQL database");
+		const result = await db.delete(identity.tableName, filter);
+		didDelete(result.affected);
+		return result;
+	}
+	const { sql, values } = buildWhere(filter, 1, dialect(db));
+	const tenant = identity.tenantColumn ? ", CAST(" + quote(identity.tenantColumn) + " AS VARCHAR) AS _sync_deleted_tenant" : "";
+	const discriminator = identity.sti ? ", _meta_type" : "";
+	const result = await db.query("DELETE FROM " + quote(identity.tableName) + " " + sql + " RETURNING CAST(id AS VARCHAR) AS _sync_deleted_id, _sync_origin_device_id, _sync_revision" + tenant + discriminator, ...values);
+	didDelete(result.rows.length);
+	for (const row of result.rows) {
+		if (!incoming && row._sync_origin_device_id == null) continue;
+		const rowId = String(row._sync_deleted_id);
+		const model = typeof row._meta_type === "string" && row._meta_type.includes(":") ? row._meta_type : identity.model;
+		const tenantId = row._sync_deleted_tenant ?? null;
+		if (incoming && (rowId !== incoming.rowId || model !== identity.model || tenantId !== incoming.tenantId)) throw syncRevisionConflict(rowId);
+		const prior = row._sync_origin_device_id == null ? void 0 : validateSyncRevision(row._sync_origin_device_id, Number(row._sync_revision));
+		const revision = incoming?.revision ?? validateSyncRevision(getDatabaseSyncDeviceId(db), (prior?.revision ?? 0) + 1);
+		if (prior && compareSyncRevisions(revision, prior) <= 0) throw syncRevisionConflict(rowId);
+		await putSyncTombstone(db, identity, rowId, model, tenantId, revision);
+	}
+	return { affected: result.rows.length };
+}
+async function nullSyncReference(db, tableName, column, filter, didUpdate) {
+	if (isJsonAdapterHandle(db)) {
+		didUpdate((await db.update(tableName, filter, { [column]: null })).affected);
+		return;
+	}
+	const engine = dialect(db);
+	const parameter = (index) => engine === "postgres" ? `$${index}` : "?";
+	const { sql, values } = buildWhere(filter, 3, engine);
+	const device = getDatabaseSyncDeviceId(db);
+	const tracked = "_sync_origin_device_id IS NOT NULL";
+	const nextTimestamp = engine === "sqlite" ? `max(${parameter(1)}, coalesce(strftime('%Y-%m-%dT%H:%M:%fZ', updated_at, '+0.001 seconds'), ''))` : `greatest(CAST(${parameter(1)} AS ${engine === "postgres" ? "TIMESTAMPTZ" : "TIMESTAMP"}), updated_at + INTERVAL '1 millisecond')`;
+	const result = await db.query(`UPDATE ${quote(tableName)}
+        SET ${quote(column)} = NULL,
+            updated_at = CASE WHEN ${tracked} THEN ${nextTimestamp} ELSE updated_at END,
+            _sync_origin_device_id = CASE WHEN ${tracked} THEN COALESCE(${parameter(2)}, _sync_origin_device_id) ELSE NULL END,
+            _sync_revision = CASE WHEN ${tracked} THEN _sync_revision + 1 ELSE _sync_revision END
+      ${sql} RETURNING _sync_origin_device_id, _sync_revision`, (/* @__PURE__ */ new Date()).toISOString(), device ?? null, ...values);
+	didUpdate(result.rows.length);
+	for (const row of result.rows) if (row._sync_origin_device_id != null) validateSyncRevision(device, Number(row._sync_revision));
+}
+//#endregion
+export { SYNC_TOMBSTONES_TABLE, bindSyncRevision, compareSyncRevisions, deleteSyncRows, lockSyncRowIdentity, nullSyncReference, putSyncTombstone, syncRevisionConflict, validateSyncRevision };
+
+//# sourceMappingURL=sync-tombstones.js.map

package/dist/sync-tombstones.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-tombstones.js","names":[],"sources":["../src/sync-tombstones.ts"],"sourcesContent":["import type { DatabaseInterface } from '@happyvertical/sql';\nimport {\n  isPostgresDatabase,\n  usesPostgresDialect,\n} from './embedded-write-queue.js';\nimport { RuntimeError, ValidationError } from './errors.js';\nimport { buildWhere } from './host.js';\nimport {\n  isJsonAdapterHandle,\n  isKnownNativeDuckDbHandle,\n} from './native-duckdb.js';\nimport { getDatabaseSyncDeviceId } from './sync-device.js';\n\nexport const SYNC_TOMBSTONES_TABLE = '_smrt_sync_tombstones';\n\nexport interface SyncRevision {\n  originDeviceId: string;\n  revision: number;\n}\n\nexport interface SyncRowIdentity {\n  tableName: string;\n  model: string;\n  tenantColumn?: string;\n  sti?: boolean;\n}\n\nfunction dialect(db: DatabaseInterface) {\n  return usesPostgresDialect(db)\n    ? 'postgres'\n    : isKnownNativeDuckDbHandle(db)\n      ? 'duckdb'\n      : 'sqlite';\n}\n\n/** DuckDB binds JavaScript integer numbers as INT32, even for BIGINT columns. */\nexport function bindSyncRevision(revision: number, nativeDuckDb: boolean) {\n  return nativeDuckDb ? BigInt(revision) : revision;\n}\n\nfunction quote(name: string): string {\n  return `\"${name.replaceAll('\"', '\"\"')}\"`;\n}\n\nexport function compareSyncRevisions(left: SyncRevision, right: SyncRevision) {\n  return (\n    left.revision - right.revision ||\n    (left.originDeviceId > right.originDeviceId\n      ? 1\n      : left.originDeviceId < right.originDeviceId\n        ? -1\n        : 0)\n  );\n}\n\nexport function validateSyncRevision(\n  originDeviceId: unknown,\n  revision: unknown,\n): SyncRevision {\n  if (\n    typeof originDeviceId !== 'string' ||\n    !originDeviceId.trim() ||\n    originDeviceId.length > 255 ||\n    typeof revision !== 'number' ||\n    !Number.isSafeInteger(revision) ||\n    revision < 1\n  ) {\n    throw new ValidationError(\n      'Invalid sync revision or missing local sync device',\n      'VALIDATION_SYNC_METADATA',\n    );\n  }\n  return { originDeviceId, revision };\n}\n\nexport function syncRevisionConflict(id: unknown) {\n  return new RuntimeError(\n    'Incoming sync revision does not advance the row',\n    'RUNTIME_SYNC_REVISION_CONFLICT',\n    { id },\n  );\n}\n\nexport async function lockSyncRowIdentity(\n  db: DatabaseInterface,\n  tableName: string,\n  rowId: string,\n): Promise<void> {\n  if (!isPostgresDatabase(db)) return;\n  await db.query(\n    'SELECT pg_advisory_xact_lock(hashtextextended($1::text, 0))',\n    JSON.stringify([SYNC_TOMBSTONES_TABLE, tableName, rowId]),\n  );\n}\n\nexport async function putSyncTombstone(\n  db: DatabaseInterface,\n  identity: SyncRowIdentity,\n  rowId: string,\n  model: string,\n  tenantId: string | null,\n  revision: SyncRevision,\n): Promise<void> {\n  const filter = { table_name: identity.tableName, row_id: rowId };\n  const old = await db.get(SYNC_TOMBSTONES_TABLE, filter);\n  if (old) {\n    if (\n      old.model !== model ||\n      (old.tenant_id ?? null) !== tenantId ||\n      compareSyncRevisions(\n        revision,\n        validateSyncRevision(old.origin_device_id, Number(old.revision)),\n      ) <= 0\n    ) {\n      throw syncRevisionConflict(rowId);\n    }\n    await db.update(SYNC_TOMBSTONES_TABLE, filter, {\n      origin_device_id: revision.originDeviceId,\n      revision: bindSyncRevision(\n        revision.revision,\n        isKnownNativeDuckDbHandle(db),\n      ),\n      deleted_at: new Date().toISOString(),\n    });\n    return;\n  }\n  await db.insert(SYNC_TOMBSTONES_TABLE, {\n    ...filter,\n    model,\n    tenant_id: tenantId,\n    origin_device_id: revision.originDeviceId,\n    revision: bindSyncRevision(\n      revision.revision,\n      isKnownNativeDuckDbHandle(db),\n    ),\n    deleted_at: new Date().toISOString(),\n  });\n}\n\n/** Must run inside the same transaction as the enclosing delete/cascade. */\nexport async function deleteSyncRows(\n  db: DatabaseInterface,\n  identity: SyncRowIdentity,\n  filter: Record<string, unknown>,\n  didDelete: (count: number) => void,\n  incoming?: { rowId: string; tenantId: string | null; revision: SyncRevision },\n): Promise<{ affected: number }> {\n  if (isJsonAdapterHandle(db)) {\n    if (incoming)\n      throw RuntimeError.invalidState('Sync tombstones require a SQL database');\n    const result = await db.delete(identity.tableName, filter);\n    didDelete(result.affected);\n    return result;\n  }\n  const { sql, values } = buildWhere(filter, 1, dialect(db));\n  const tenant = identity.tenantColumn\n    ? ', CAST(' +\n      quote(identity.tenantColumn) +\n      ' AS VARCHAR) AS _sync_deleted_tenant'\n    : '';\n  const discriminator = identity.sti ? ', _meta_type' : '';\n  const result = await db.query(\n    'DELETE FROM ' +\n      quote(identity.tableName) +\n      ' ' +\n      sql +\n      ' RETURNING CAST(id AS VARCHAR) AS _sync_deleted_id, _sync_origin_device_id, _sync_revision' +\n      tenant +\n      discriminator,\n    ...values,\n  );\n  didDelete(result.rows.length);\n  for (const row of result.rows) {\n    if (!incoming && row._sync_origin_device_id == null) continue;\n    const rowId = String(row._sync_deleted_id);\n    const model =\n      typeof row._meta_type === 'string' && row._meta_type.includes(':')\n        ? row._meta_type\n        : identity.model;\n    const tenantId = (row._sync_deleted_tenant ?? null) as string | null;\n    if (\n      incoming &&\n      (rowId !== incoming.rowId ||\n        model !== identity.model ||\n        tenantId !== incoming.tenantId)\n    ) {\n      throw syncRevisionConflict(rowId);\n    }\n    const prior =\n      row._sync_origin_device_id == null\n        ? undefined\n        : validateSyncRevision(\n            row._sync_origin_device_id,\n            Number(row._sync_revision),\n          );\n    const revision =\n      incoming?.revision ??\n      validateSyncRevision(\n        getDatabaseSyncDeviceId(db),\n        (prior?.revision ?? 0) + 1,\n      );\n    if (prior && compareSyncRevisions(revision, prior) <= 0) {\n      throw syncRevisionConflict(rowId);\n    }\n    await putSyncTombstone(db, identity, rowId, model, tenantId, revision);\n  }\n  return { affected: result.rows.length };\n}\n\nexport async function nullSyncReference(\n  db: DatabaseInterface,\n  tableName: string,\n  column: string,\n  filter: Record<string, unknown>,\n  didUpdate: (count: number) => void,\n): Promise<void> {\n  if (isJsonAdapterHandle(db)) {\n    const result = await db.update(tableName, filter, { [column]: null });\n    didUpdate(result.affected);\n    return;\n  }\n  const engine = dialect(db);\n  const parameter = (index: number) =>\n    engine === 'postgres' ? `$${index}` : '?';\n  const { sql, values } = buildWhere(filter, 3, engine);\n  const device = getDatabaseSyncDeviceId(db);\n  const tracked = '_sync_origin_device_id IS NOT NULL';\n  const nextTimestamp =\n    engine === 'sqlite'\n      ? `max(${parameter(1)}, coalesce(strftime('%Y-%m-%dT%H:%M:%fZ', updated_at, '+0.001 seconds'), ''))`\n      : `greatest(CAST(${parameter(1)} AS ${engine === 'postgres' ? 'TIMESTAMPTZ' : 'TIMESTAMP'}), updated_at + INTERVAL '1 millisecond')`;\n  const result = await db.query(\n    `UPDATE ${quote(tableName)}\n        SET ${quote(column)} = NULL,\n            updated_at = CASE WHEN ${tracked} THEN ${nextTimestamp} ELSE updated_at END,\n            _sync_origin_device_id = CASE WHEN ${tracked} THEN COALESCE(${parameter(2)}, _sync_origin_device_id) ELSE NULL END,\n            _sync_revision = CASE WHEN ${tracked} THEN _sync_revision + 1 ELSE _sync_revision END\n      ${sql} RETURNING _sync_origin_device_id, _sync_revision`,\n    new Date().toISOString(),\n    device ?? null,\n    ...values,\n  );\n  didUpdate(result.rows.length);\n  for (const row of result.rows) {\n    if (row._sync_origin_device_id != null) {\n      validateSyncRevision(device, Number(row._sync_revision));\n    }\n  }\n}\n"],"mappings":"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"}

package/dist/system/schema.d.ts

@@ -260,6 +260,8 @@ export declare const RUN_ONCE_CLAIMS_TABLE = "_smrt_run_once_claims";
  * can always run again.
  */
 export declare const CREATE_SMRT_RUN_ONCE_CLAIMS_TABLE = "\nCREATE TABLE IF NOT EXISTS _smrt_run_once_claims (\n  claim_key TEXT PRIMARY KEY,\n  tenant_id TEXT NOT NULL,\n  actor TEXT NOT NULL,\n  content_digest TEXT NOT NULL,\n  status TEXT NOT NULL DEFAULT 'in_progress',\n  result TEXT,\n  created_at TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,\n  completed_at TIMESTAMP\n);\n\nCREATE INDEX IF NOT EXISTS idx_smrt_run_once_claims_tenant\n  ON _smrt_run_once_claims(tenant_id, created_at);\n\n-- Retention predicate for pruneRunOnceClaims() (#3080): completed claims are\n-- aged out on completed_at, scoped to status = 'completed' so an in_progress\n-- claim (completed_at IS NULL) is never matched by the sweep.\nCREATE INDEX IF NOT EXISTS idx_smrt_run_once_claims_status_completed\n  ON _smrt_run_once_claims(status, completed_at);\n";
+/** Durable sync deletion revisions, separate from live natural keys. */
+export declare const CREATE_SMRT_SYNC_TOMBSTONES_TABLE = "\nCREATE TABLE IF NOT EXISTS _smrt_sync_tombstones (\n  table_name TEXT NOT NULL,\n  row_id TEXT NOT NULL,\n  model TEXT NOT NULL,\n  tenant_id TEXT,\n  origin_device_id TEXT NOT NULL,\n  revision INTEGER NOT NULL,\n  deleted_at TIMESTAMP NOT NULL,\n  PRIMARY KEY (table_name, row_id)\n);\n";
 /**
  * All system table creation statements
  */
@@ -371,8 +373,10 @@ export declare function getSystemTableDDLForEngine(ddl: string, engine: Database
  * 1.11.1 adds `idx_smrt_run_once_claims_status_completed` (#3080), the
  * `(status, completed_at)` index backing `pruneRunOnceClaims()`'s retention
  * predicate (`system/retention.ts`).
+ *
+ * 1.12.0 adds the durable tracked-deletion ledger.
  */
-export declare const SMRT_SCHEMA_VERSION = "1.11.1";
+export declare const SMRT_SCHEMA_VERSION = "1.12.0";
 /**
  * Canonical form of the system DDL that {@link SMRT_SCHEMA_DDL_CHECKSUMS} covers.
  *

package/dist/system/schema.d.ts.map

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

package/dist/system/schema.js

@@ -1087,6 +1087,19 @@ CREATE INDEX IF NOT EXISTS idx_smrt_run_once_claims_tenant
 CREATE INDEX IF NOT EXISTS idx_smrt_run_once_claims_status_completed
   ON _smrt_run_once_claims(status, completed_at);
 `;
+/** Durable sync deletion revisions, separate from live natural keys. */
+var CREATE_SMRT_SYNC_TOMBSTONES_TABLE = `
+CREATE TABLE IF NOT EXISTS _smrt_sync_tombstones (
+  table_name TEXT NOT NULL,
+  row_id TEXT NOT NULL,
+  model TEXT NOT NULL,
+  tenant_id TEXT,
+  origin_device_id TEXT NOT NULL,
+  revision INTEGER NOT NULL,
+  deleted_at TIMESTAMP NOT NULL,
+  PRIMARY KEY (table_name, row_id)
+);
+`;
 /**
 * All system table creation statements
 */
@@ -1100,7 +1113,8 @@ var ALL_SYSTEM_TABLES = [
 	CREATE_SMRT_DISPATCH_TABLE,
 	CREATE_SMRT_DISPATCH_SUBSCRIPTIONS_TABLE,
 	CREATE_SMRT_AI_USAGE_TABLE,
-	CREATE_SMRT_CHANGES_TABLE
+	CREATE_SMRT_CHANGES_TABLE,
+	CREATE_SMRT_SYNC_TOMBSTONES_TABLE
 ];
 /**
 * Framework-owned tables that are backed by `@smrt()` models rather than by
@@ -1233,14 +1247,17 @@ function toPostgresTenantUuid(ddl) {
 * 1.11.1 adds `idx_smrt_run_once_claims_status_completed` (#3080), the
 * `(status, completed_at)` index backing `pruneRunOnceClaims()`'s retention
 * predicate (`system/retention.ts`).
+*
+* 1.12.0 adds the durable tracked-deletion ledger.
 */
-var SMRT_SCHEMA_VERSION = "1.11.1";
+var SMRT_SCHEMA_VERSION = "1.12.0";
 Object.freeze({
 	"1.10.1": "f796ee3b3f7ab8b9dc659ecaa68884ec01277408c3dd6edea540853fce369c16",
 	"1.11.0": "c51351a76c96beb64fa7e5922f78d776367af882ed1ff37229f9e9ffacee8372",
-	"1.11.1": "98112937a3bbb3883c3db1fd5e836751f91a479c1c5da64d4410263a6581ef1f"
+	"1.11.1": "98112937a3bbb3883c3db1fd5e836751f91a479c1c5da64d4410263a6581ef1f",
+	"1.12.0": "6aa42e368e7d57191de9b0c040c289edf38a1ffa7ae0097f57188ecd5a5b8f9c"
 });
 //#endregion
-export { ALL_SYSTEM_TABLES, CREATE_POSTGRES_CHANGE_FEED_APPEND_BATCH_FUNCTION, CREATE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION, CREATE_POSTGRES_CHANGE_FEED_COMPAT_DRAIN_FUNCTION, CREATE_POSTGRES_CHANGE_FEED_DRAIN_FUNCTION, CREATE_POSTGRES_SMRT_CHANGES_PENDING_TABLE, CREATE_POSTGRES_SMRT_CHANGES_TABLE, CREATE_SMRT_AI_USAGE_TABLE, CREATE_SMRT_BACKFILLS_TABLE, CREATE_SMRT_CHANGES_TABLE, CREATE_SMRT_CONTEXTS_TABLE, CREATE_SMRT_DISPATCH_SUBSCRIPTIONS_TABLE, CREATE_SMRT_DISPATCH_TABLE, CREATE_SMRT_EMBEDDINGS_TABLE, CREATE_SMRT_MIGRATIONS_TABLE, CREATE_SMRT_RUN_ONCE_CLAIMS_TABLE, CREATE_SMRT_SCHEMA_MIGRATIONS_TABLE, ENSURE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION, ENSURE_POSTGRES_CHANGE_FEED_SCHEMA, FRAMEWORK_OPERATIONAL_TABLES, LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY, POSTGRES_CHANGE_FEED_APPEND_BATCH_FUNCTION_IDENTITY, POSTGRES_CHANGE_FEED_APPEND_BATCH_FUNCTION_NAME, POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY, POSTGRES_CHANGE_FEED_APPEND_FUNCTION_NAME, POSTGRES_CHANGE_FEED_COMPAT_DRAIN_FUNCTION_IDENTITY, POSTGRES_CHANGE_FEED_DRAIN_BATCH, POSTGRES_CHANGE_FEED_DRAIN_FUNCTION_IDENTITY, POSTGRES_CHANGE_FEED_DRAIN_FUNCTION_NAME, POSTGRES_CHANGE_FEED_HELPER_COMPAT_MARKER, POSTGRES_CHANGE_FEED_HELPER_MARKER, POSTGRES_CHANGE_FEED_PENDING_TABLE, REPLACE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION, RETIRED_SYSTEM_TABLES, RUN_ONCE_CLAIMS_TABLE, SMRT_SCHEMA_VERSION, SYSTEM_TABLE_TENANT_UUID_COLUMNS, getSystemTableDDL, getSystemTableDDLForEngine };
+export { ALL_SYSTEM_TABLES, CREATE_POSTGRES_CHANGE_FEED_APPEND_BATCH_FUNCTION, CREATE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION, CREATE_POSTGRES_CHANGE_FEED_COMPAT_DRAIN_FUNCTION, CREATE_POSTGRES_CHANGE_FEED_DRAIN_FUNCTION, CREATE_POSTGRES_SMRT_CHANGES_PENDING_TABLE, CREATE_POSTGRES_SMRT_CHANGES_TABLE, CREATE_SMRT_AI_USAGE_TABLE, CREATE_SMRT_BACKFILLS_TABLE, CREATE_SMRT_CHANGES_TABLE, CREATE_SMRT_CONTEXTS_TABLE, CREATE_SMRT_DISPATCH_SUBSCRIPTIONS_TABLE, CREATE_SMRT_DISPATCH_TABLE, CREATE_SMRT_EMBEDDINGS_TABLE, CREATE_SMRT_MIGRATIONS_TABLE, CREATE_SMRT_RUN_ONCE_CLAIMS_TABLE, CREATE_SMRT_SCHEMA_MIGRATIONS_TABLE, CREATE_SMRT_SYNC_TOMBSTONES_TABLE, ENSURE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION, ENSURE_POSTGRES_CHANGE_FEED_SCHEMA, FRAMEWORK_OPERATIONAL_TABLES, LEGACY_POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY, POSTGRES_CHANGE_FEED_APPEND_BATCH_FUNCTION_IDENTITY, POSTGRES_CHANGE_FEED_APPEND_BATCH_FUNCTION_NAME, POSTGRES_CHANGE_FEED_APPEND_FUNCTION_IDENTITY, POSTGRES_CHANGE_FEED_APPEND_FUNCTION_NAME, POSTGRES_CHANGE_FEED_COMPAT_DRAIN_FUNCTION_IDENTITY, POSTGRES_CHANGE_FEED_DRAIN_BATCH, POSTGRES_CHANGE_FEED_DRAIN_FUNCTION_IDENTITY, POSTGRES_CHANGE_FEED_DRAIN_FUNCTION_NAME, POSTGRES_CHANGE_FEED_HELPER_COMPAT_MARKER, POSTGRES_CHANGE_FEED_HELPER_MARKER, POSTGRES_CHANGE_FEED_PENDING_TABLE, REPLACE_POSTGRES_CHANGE_FEED_APPEND_FUNCTION, RETIRED_SYSTEM_TABLES, RUN_ONCE_CLAIMS_TABLE, SMRT_SCHEMA_VERSION, SYSTEM_TABLE_TENANT_UUID_COLUMNS, getSystemTableDDL, getSystemTableDDLForEngine };
 
 //# sourceMappingURL=schema.js.map