@xyo-network/event-kit-node 2.1.0 → 2.2.0

package/dist/node/sqliteBestEffortInbox.d.ts

@@ -0,0 +1,20 @@
+import type { BestEffortDirtyTarget, PersistentBestEffortInbox } from './bestEffortTypes.ts';
+export interface SqliteBestEffortInboxOptions {
+    /** An immutable host application/consumer identifier. Do not share with Durable Delivery. */
+    readonly consumerId: string;
+    /** Finite per-index replay capacity; unexpired records are never evicted. */
+    readonly maxSecurityRecords: number;
+    /** Finite exact binding capacity, including retained completed targets. */
+    readonly maxTargets?: number;
+    readonly nowSeconds?: () => number;
+    readonly path: string;
+    /** Acceleration only. Failure is repaired by durable scanning or a matching duplicate. */
+    readonly requestWork?: (target: BestEffortDirtyTarget) => void | Promise<void>;
+}
+/**
+ * SQLite co-commits security, receive-clock high water and dirty generation in
+ * one writer transaction. Only the Best Effort namespace is decoded. No callback
+ * or external queue participates in the durability boundary.
+ */
+export declare function createSqliteBestEffortInbox(options: SqliteBestEffortInboxOptions): Promise<PersistentBestEffortInbox>;
+//# sourceMappingURL=sqliteBestEffortInbox.d.ts.map

package/dist/node/sqliteBestEffortInbox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqliteBestEffortInbox.d.ts","sourceRoot":"","sources":["../../src/sqliteBestEffortInbox.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACiB,qBAAqB,EAAyB,yBAAyB,EACnG,MAAM,sBAAsB,CAAA;AAG7B,MAAM,WAAW,4BAA4B;IAC3C,6FAA6F;IAC7F,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAA;IACnC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;IAC5B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,MAAM,CAAA;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0FAA0F;IAC1F,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,qBAAqB,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC/E;AAgFD;;;;GAIG;AACH,wBAAsB,2BAA2B,CAAC,OAAO,EAAE,4BAA4B,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAwQ3H"}

package/dist/node/sqliteWakeQueue.d.ts

@@ -1,25 +1,91 @@
 import type { WakeQueue } from '@xyo-network/event-kit-protocol';
 export interface SqliteWakeQueueOptions {
-    /** Database file path, or `:memory:` for a throwaway store. */
     readonly path: string;
 }
 export interface SqliteWakeQueue extends WakeQueue {
-    /** Releases the underlying handle. */
-    close: () => void;
+    close(): void;
 }
-/**
- * SQLite-backed `WakeQueue`.
- *
- * Every state change is a single statement under WAL, so a claim cannot be
- * observed half-applied and two callers cannot lease one row: the claim is an
- * `UPDATE … WHERE state = 'pending'` whose affected-row count decides the
- * winner. That is the transactional form of the lease the filesystem provider
- * approximates with `link`.
- *
- * WAL also permits concurrent readers with one writer, so several processes on
- * one host can share the file. It does not coordinate across hosts.
- *
- * Uses Node's built-in `node:sqlite`, which still emits an ExperimentalWarning.
- */
+/** FULL/WAL queue; old unfenced databases require explicit offline migration. */
 export declare function createSqliteWakeQueue(options: SqliteWakeQueueOptions): Promise<SqliteWakeQueue>;
+/** Atomic production composition: identities and work live in one database. */
+export declare function createSqliteWakeReceiver(options: SqliteWakeQueueOptions): Promise<{
+    queue: WakeQueue<{
+        audience: string;
+        deploymentId: string;
+        event: {
+            schema: "network.xyo.event.wake.envelope" & {
+                readonly __schema: true;
+            };
+            authorizationChainId: string;
+            deploymentId: string;
+            wakeId: string;
+            deliveryMode: "best-effort" | "durable";
+            source: {
+                kind: "xl1-finalized";
+                chainId: string;
+            } | {
+                kind: "ethereum-finalized";
+                chainId: string;
+                genesisHash: string;
+            } | {
+                kind: "utc-interval";
+                scheduleId: string;
+                anchorSeconds: number;
+                intervalSeconds: number;
+            };
+            fromPosition: number;
+            toPosition: number;
+            filterHash: string;
+            issuedAt: number;
+            queueId?: string | undefined;
+        };
+        eventHash: string;
+        fromPosition: number;
+        toPosition: number;
+        jti: string;
+        publisher: string;
+        wakeId: string;
+        queueId?: string | undefined;
+    }>;
+    inbox: import("@xyo-network/event-kit-protocol").AtomicWakeInbox<{
+        audience: string;
+        deploymentId: string;
+        event: {
+            schema: "network.xyo.event.wake.envelope" & {
+                readonly __schema: true;
+            };
+            authorizationChainId: string;
+            deploymentId: string;
+            wakeId: string;
+            deliveryMode: "best-effort" | "durable";
+            source: {
+                kind: "xl1-finalized";
+                chainId: string;
+            } | {
+                kind: "ethereum-finalized";
+                chainId: string;
+                genesisHash: string;
+            } | {
+                kind: "utc-interval";
+                scheduleId: string;
+                anchorSeconds: number;
+                intervalSeconds: number;
+            };
+            fromPosition: number;
+            toPosition: number;
+            filterHash: string;
+            issuedAt: number;
+            queueId?: string | undefined;
+        };
+        eventHash: string;
+        fromPosition: number;
+        toPosition: number;
+        jti: string;
+        publisher: string;
+        wakeId: string;
+        queueId?: string | undefined;
+    }>;
+    close: () => void;
+    pruneExpiredTokens: (nowSeconds: number) => Promise<number>;
+}>;
 //# sourceMappingURL=sqliteWakeQueue.d.ts.map

package/dist/node/sqliteWakeQueue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sqliteWakeQueue.d.ts","sourceRoot":"","sources":["../../src/sqliteWakeQueue.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAGV,SAAS,EACV,MAAM,iCAAiC,CAAA;AAExC,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,sCAAsC;IACtC,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAmE1B"}
+{"version":3,"file":"sqliteWakeQueue.d.ts","sourceRoot":"","sources":["../../src/sqliteWakeQueue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAA;AAIhE,MAAM,WAAW,sBAAsB;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AACjE,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAAG,KAAK,IAAI,IAAI,CAAA;CAAE;AAEpE,iFAAiF;AACjF,wBAAsB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC,CAGrG;AAED,+EAA+E;AAC/E,wBAAsB,wBAAwB,CAAC,OAAO,EAAE,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qCAMnC,MAAM;GAEhD"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xyo-network/event-kit-node",
-  "version": "2.1.0",
-  "description": "Node 24+ Event Kit durability, handshake clients, and SQLite source publisher runtime",
+  "version": "2.2.0",
+  "description": "Node 26+ Event Kit durability, handshake clients, and SQLite source publisher runtime",
   "keywords": [
     "xyo",
     "xl1",
@@ -41,11 +41,11 @@
     "README.md"
   ],
   "dependencies": {
-    "@xyo-network/event-kit-actor": "~2.1.0",
-    "@xyo-network/event-kit-protocol": "~2.1.0",
-    "@xyo-network/event-kit-schemas": "~2.1.0",
-    "@xyo-network/event-kit-statement-graph": "~2.1.0",
-    "@xyo-network/event-kit-xl1": "~2.1.0"
+    "@xyo-network/event-kit-actor": "~2.2.0",
+    "@xyo-network/event-kit-protocol": "~2.2.0",
+    "@xyo-network/event-kit-schemas": "~2.2.0",
+    "@xyo-network/event-kit-statement-graph": "~2.2.0",
+    "@xyo-network/event-kit-xl1": "~2.2.0"
   },
   "devDependencies": {
     "@ariestools/actor": "~2.0.0",
@@ -54,9 +54,9 @@
     "@ariestools/toolchain": "~10.0.8",
     "@ariestools/tsconfig": "~10.0.8",
     "@opentelemetry/api": "~1.9.1",
-    "@types/node": "~26.6.3",
-    "@xyo-network/event-kit-http": "~2.1.0",
-    "@xyo-network/event-kit-testing": "~2.1.0",
+    "@types/node": "~26.6.4",
+    "@xyo-network/event-kit-http": "~2.2.0",
+    "@xyo-network/event-kit-testing": "~2.2.0",
     "@xyo-network/sdk": "~8.0.1",
     "@xyo-network/sdk-protocol": "~8.0.1",
     "@xyo-network/xl1-protocol": "~5.8.0",
@@ -66,12 +66,12 @@
     "@xyo-network/xl1-statement-graph-sdk": "~0.5.4",
     "ajv": "~8.20.0",
     "async-mutex": "~0.5.0",
-    "eslint": "~10.11.0",
+    "eslint": "~10.12.0",
     "eslint-import-resolver-typescript": "~4.4.5",
     "ethers": "~6.17.0",
     "tslib": "~2.8.1",
     "typescript": "~6.0.3",
-    "vite": "~8.3.1",
+    "vite": "~8.3.2",
     "vitest": "~5.0.3",
     "zod": "~4.6.5"
   },
@@ -92,7 +92,7 @@
     "zod": "^4.6"
   },
   "engines": {
-    "node": ">=24"
+    "node": ">=26"
   },
   "publishConfig": {
     "access": "public"