@degenerate/events 0.2.5 → 0.3.0

package/dist/bridge/index.d.ts

@@ -0,0 +1,3 @@
+export * from './transaction-proposer';
+export * from './scheduler-trigger';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bridge/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC"}

package/dist/bridge/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./transaction-proposer"), exports);
+__exportStar(require("./scheduler-trigger"), exports);

package/dist/bridge/scheduler-trigger.d.ts

@@ -0,0 +1,34 @@
+import { SafeScheduler } from '../scheduler';
+import { TransactionProposalOutcome, TransactionProposalRequest, TransactionProposer } from './transaction-proposer';
+/**
+ * Optional observer of a scheduled proposal's outcome. A fired scheduler task
+ * is synchronous but `propose` is async, so the trigger cannot hand the result
+ * back to whoever scheduled it — these hooks are how a settled or failed
+ * automated proposal becomes visible (logging, metrics, retry policy).
+ */
+export interface SchedulerTriggerObserver {
+    onProposalSettled?(request: TransactionProposalRequest, outcome: TransactionProposalOutcome): void;
+    onProposalFailed?(request: TransactionProposalRequest, error: unknown): void;
+}
+/**
+ * Drives the signed mutation path from the clock. Wraps a {@link SafeScheduler}:
+ * when a scheduled time comes due it asks the injected {@link TransactionProposer}
+ * to submit the proposal — the same gate a human propose hits. The trigger
+ * itself holds no keys and never touches block state; that all lives behind the
+ * port, keeping `events` free of any `sharedata` dependency.
+ */
+export declare class SchedulerTrigger {
+    private readonly scheduler;
+    private readonly proposer;
+    private readonly observer;
+    constructor(scheduler: SafeScheduler, proposer: TransactionProposer, observer?: SchedulerTriggerObserver);
+    /**
+     * Schedule `request` to be proposed at `time`. Returns the scheduler task
+     * id so the caller can {@link cancel} it (e.g. the block closed early).
+     */
+    scheduleProposal(time: Date, request: TransactionProposalRequest): string;
+    /** Cancel a previously scheduled proposal that has not yet fired. */
+    cancel(taskId: string): void;
+    private fire;
+}
+//# sourceMappingURL=scheduler-trigger.d.ts.map

package/dist/bridge/scheduler-trigger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler-trigger.d.ts","sourceRoot":"","sources":["../../src/bridge/scheduler-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACH,0BAA0B,EAC1B,0BAA0B,EAC1B,mBAAmB,EACtB,MAAM,wBAAwB,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACrC,iBAAiB,CAAC,CACd,OAAO,EAAE,0BAA0B,EACnC,OAAO,EAAE,0BAA0B,GACpC,IAAI,CAAC;IACR,gBAAgB,CAAC,CAAC,OAAO,EAAE,0BAA0B,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAChF;AAED;;;;;;GAMG;AACH,qBAAa,gBAAgB;IAErB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ;gBAFR,SAAS,EAAE,aAAa,EACxB,QAAQ,EAAE,mBAAmB,EAC7B,QAAQ,GAAE,wBAA6B;IAG5D;;;OAGG;IACH,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,0BAA0B,GAAG,MAAM;IASzE,qEAAqE;IACrE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;YAId,IAAI;CAQrB"}

package/dist/bridge/scheduler-trigger.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchedulerTrigger = void 0;
+/**
+ * Drives the signed mutation path from the clock. Wraps a {@link SafeScheduler}:
+ * when a scheduled time comes due it asks the injected {@link TransactionProposer}
+ * to submit the proposal — the same gate a human propose hits. The trigger
+ * itself holds no keys and never touches block state; that all lives behind the
+ * port, keeping `events` free of any `sharedata` dependency.
+ */
+class SchedulerTrigger {
+    constructor(scheduler, proposer, observer = {}) {
+        this.scheduler = scheduler;
+        this.proposer = proposer;
+        this.observer = observer;
+    }
+    /**
+     * Schedule `request` to be proposed at `time`. Returns the scheduler task
+     * id so the caller can {@link cancel} it (e.g. the block closed early).
+     */
+    scheduleProposal(time, request) {
+        return this.scheduler.scheduleTask(time, () => {
+            // The scheduler callback is synchronous; the proposal is async, so
+            // fire-and-forget and route the eventual result/failure to the
+            // observer rather than letting a rejection go unhandled.
+            void this.fire(request);
+        });
+    }
+    /** Cancel a previously scheduled proposal that has not yet fired. */
+    cancel(taskId) {
+        this.scheduler.removeTask(taskId);
+    }
+    async fire(request) {
+        try {
+            const outcome = await this.proposer.propose(request);
+            this.observer.onProposalSettled?.(request, outcome);
+        }
+        catch (error) {
+            this.observer.onProposalFailed?.(request, error);
+        }
+    }
+}
+exports.SchedulerTrigger = SchedulerTrigger;

package/dist/bridge/transaction-proposer.d.ts

@@ -0,0 +1,29 @@
+/** The intent a trigger hands to the proposer. */
+export interface TransactionProposalRequest {
+    /** Id of the ShareData block to mutate. */
+    shareDataId: string;
+    /** Stable id of the registered function that produces the proposed state. */
+    functionId: string;
+    /** Input passed to that function (e.g. the close attribution). */
+    input?: unknown;
+}
+/**
+ * Result of attempting an automated proposal. `noOp` distinguishes "the
+ * function had nothing to propose" (e.g. closing an already-closed block) from
+ * a real rule rejection (`accepted: false, noOp: false`), mirroring
+ * `safeSubmitTransaction`'s three-way outcome.
+ */
+export interface TransactionProposalOutcome {
+    accepted: boolean;
+    transactionId: string;
+    noOp: boolean;
+}
+/**
+ * Realizes a {@link TransactionProposalRequest} against the signed mutation
+ * path. The concrete implementation lives in the composition root; everything
+ * in `events` programs against this interface.
+ */
+export interface TransactionProposer {
+    propose(request: TransactionProposalRequest): Promise<TransactionProposalOutcome>;
+}
+//# sourceMappingURL=transaction-proposer.d.ts.map

package/dist/bridge/transaction-proposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-proposer.d.ts","sourceRoot":"","sources":["../../src/bridge/transaction-proposer.ts"],"names":[],"mappings":"AAUA,kDAAkD;AAClD,MAAM,WAAW,0BAA0B;IACvC,2CAA2C;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,OAAO,CAAC;CACjB;AAED;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,OAAO,EAAE,0BAA0B,GAAG,OAAO,CAAC,0BAA0B,CAAC,CAAC;CACrF"}

package/dist/bridge/transaction-proposer.js

@@ -0,0 +1,11 @@
+"use strict";
+// Port between a fired event trigger and the signed ShareData mutation path.
+//
+// `events` deliberately knows nothing about `ShareDataManager`, proof minting,
+// or how a function turns current state into proposed state. A trigger only
+// expresses *intent* — "invoke this function on this block with this input" —
+// and an injected `TransactionProposer` (implemented in the composition root,
+// where `sharedata` is available) realizes it against the same gated path a
+// human proposal uses (`ShareDataManager.applyTransaction`). Keeping this seam
+// here is what lets `events` stay a light leaf with no `sharedata` dependency.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/index.d.ts

@@ -1 +1,4 @@
+export * from './scheduler';
+export * from './task';
+export * from './bridge';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAC;AAM5B,cAAc,QAAQ,CAAC;AAMvB,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -1,5 +1,25 @@
 "use strict";
 //#region Scheduler
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./scheduler"), exports);
 //#endregion Scheduler
 //#region Task
+__exportStar(require("./task"), exports);
 //#endregion Task
+//#region Bridge
+__exportStar(require("./bridge"), exports);
+//#endregion Bridge

package/dist/scheduler/scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/scheduler/scheduler.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,KAAK,CAAkB;IAE/B;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM;IAQtF;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAehC;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,IAAI;IAcnD;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,OAAO;CAYlB"}
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../src/scheduler/scheduler.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,qBAAa,aAAa;IACtB,OAAO,CAAC,KAAK,CAAkB;IAE/B;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,QAAQ,GAAE,MAAM,GAAG,IAAW,GAAG,MAAM;IAQtF;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAehC;;;;;OAKG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,GAAG,IAAI;IAanD;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IAgBxB,OAAO,CAAC,OAAO;CAalB"}

package/dist/scheduler/scheduler.js

@@ -52,15 +52,14 @@ class SafeScheduler {
      */
     updateTaskTime(taskId, newTime) {
         const task = this.tasks.find(task => task.id === taskId);
-        if (task) {
-            if (task.timeoutId) {
-                clearTimeout(task.timeoutId); // Clear the existing timeout
-            }
-            task.time = newTime; // Update the time
-            this.scheduleNextTask(task); // Reschedule the task
-            console.log(`Task ${taskId} rescheduled for ${newTime.toUTCString()}.`);
+        if (!task) {
+            throw new generic_1.TaskNotFoundError(taskId);
+        }
+        if (task.timeoutId) {
+            clearTimeout(task.timeoutId); // Clear the existing timeout
         }
-        throw new generic_1.TaskNotFoundError(taskId);
+        task.time = newTime; // Update the time
+        this.scheduleNextTask(task); // Reschedule the task
     }
     // Helper to schedule the task based on date and time
     /**
@@ -83,7 +82,8 @@ class SafeScheduler {
     }
     // Executes the task and reschedules it if it's a recurring task
     runTask(task) {
-        task.callback();
+        // `callback()` returns the stored function; the trailing () invokes it.
+        task.callback()();
         if (task.interval !== null) {
             // If the task is recurring, reschedule it based on the interval
             task.time = new Date(new Date().getTime() + task.interval);

package/package.json

@@ -1,14 +1,23 @@
 {
   "name": "@degenerate/events",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "This contains the ShareData Adaptive Framework Ecosystem (SAFE) network event code",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
     "build": "rm -rf dist/* && tsc -p tsconfig.pkg.json",
     "compile": "rm -rf dist/* && tsc -p tsconfig.pkg.json",
-    "test": "jest --forceExit --detectOpenHandles --verbose --silent=false --env node --config tsconfig.pkg.json",
-    "test:coverage": "jest --forceExit --coverage --detectOpenHandles --verbose --silent=false --env node  --config tsconfig.pkg.json",
+    "test": "jest --forceExit --detectOpenHandles --verbose --silent=false --env node",
+    "test:coverage": "jest --forceExit --coverage --detectOpenHandles --verbose --silent=false --env node ",
     "test:clearCache": "jest --clearCache"
   },
   "keywords": [
@@ -22,11 +31,11 @@
   "author": "Degenerate Inc.",
   "license": "ISC",
   "devDependencies": {
-    "@types/jest": "^29.5.14",
-    "@types/node": "^22.8.4",
-    "jest": "^29.7.0",
-    "ts-jest": "^29.2.5",
-    "typescript": "^5.6.3"
+    "@types/jest": "^30.0.0",
+    "@types/node": "^22.19.18",
+    "jest": "^30.4.2",
+    "ts-jest": "^29.4.9",
+    "typescript": "^6.0.3"
   },
   "repository": {
     "type": "git",
@@ -37,8 +46,11 @@
   },
   "homepage": "https://github.com/syncrude/safe#readme",
   "dependencies": {
-    "@degenerate/generic": "^0.2.6",
-    "zod": "^3.24.1"
+    "@degenerate/generic": "^0.3.0",
+    "zod": "^4.4.3"
   },
-  "gitHead": "a1ef457f3b707fb642b2e3296239c74bd75614b8"
+  "gitHead": "c33ed2f06679f5bd76c2eccf7054212c1820a014",
+  "engines": {
+    "node": ">=22"
+  }
 }