@happyvertical/smrt-jobs 0.49.2 → 0.49.4

package/dist/durable-payload-integrity.d.ts

@@ -0,0 +1,16 @@
+export interface DurableJobPayloadIntegrity {
+    version: 1;
+    keyId: string;
+    signature: string;
+}
+export interface DurableJobPayloadSigner {
+    readonly keyId: string;
+    sign(payload: unknown): DurableJobPayloadIntegrity;
+    verify(payload: unknown, integrity: DurableJobPayloadIntegrity): boolean;
+}
+/** Create a deterministic HMAC signer for JSON job payloads. The key is never persisted. */
+export declare function createHmacDurableJobPayloadSigner(options: {
+    keyId: string;
+    key: string | Uint8Array;
+}): DurableJobPayloadSigner;
+//# sourceMappingURL=durable-payload-integrity.d.ts.map

package/dist/durable-payload-integrity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"durable-payload-integrity.d.ts","sourceRoot":"","sources":["../src/durable-payload-integrity.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,IAAI,CAAC,OAAO,EAAE,OAAO,GAAG,0BAA0B,CAAC;IACnD,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,0BAA0B,GAAG,OAAO,CAAC;CAC1E;AAED,4FAA4F;AAC5F,wBAAgB,iCAAiC,CAAC,OAAO,EAAE;IACzD,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,GAAG,UAAU,CAAC;CAC1B,GAAG,uBAAuB,CAyC1B"}

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export { assertWithinTenantCreationCap, type BackgroundEligibleClass, backgroundEligible, clampRetries, DEFAULT_TENANT_JOB_CAP, getBackgroundEligibleMethods, isBackgroundEligibleMethod, MAX_JOB_RETRIES, markBackgroundEligible, TenantJobCapExceededError, } from './background-policy.js';
+export { createHmacDurableJobPayloadSigner, type DurableJobPayloadIntegrity, type DurableJobPayloadSigner, } from './durable-payload-integrity.js';
 export { redactErrorForPersistence, redactErrorMessage, } from './error-redaction.js';
 export { type AcceptedForgeDelivery, type AcceptForgeDeliveryInput, type ClaimForgeDeliveryOptions, ForgeDelivery, ForgeDeliveryCollection, type ForgeDeliveryStatus, type ForgeObservation, type ForgeProjectionAuditEvent, type ForgeProjectionAuditHook, ForgeProjectionCheckpoint, type ForgeProjectionContext, ForgeProjectionRuntime, type ForgeProjectionRuntimeOptions, type ForgeProjector, } from './forge-projection.js';
 export { JobBuilder, type Priority, parseDelay, priorityToNumber, } from './job-builder.js';
@@ -7,7 +8,7 @@ export { type JobContext, JobContextLogger, type JobEventInput, type JobExecutio
 export { type CreateMcpTaskInput, createMcpTaskResult, getMcpTaskMarker, MCP_TASKS_EXTENSION, type McpTask, McpTaskCancelledError, type McpTaskJobMarker, McpTaskNotFoundError, type McpTaskStatus, McpTaskStore, requestMcpTaskInput, taskFromJob, } from './mcp-task.js';
 export { type BackgroundCapable, type BgOptions, withBackgroundJobs, } from './object-extension.js';
 export { DEFAULT_JOB_RETENTION, DEFAULT_RETENTION_SWEEP_INTERVAL_MS, JOB_EVENTS_RETENTION_TASK, JOBS_RETENTION_TASK, type JobRetentionOptions, type RetentionSweeper, type RetentionSweeperOptions, registerJobRetentionTasks, startRetentionSweeper, unregisterJobRetentionTasks, } from './retention.js';
-export { createTaskRunner, JobTimeoutError, TaskRunner, type TaskRunnerConfig, type TaskRunnerEvents, } from './runner.js';
+export { createTaskRunner, getActiveJobExecutionContext, isRunnerExecutionContext, JobTimeoutError, TaskRunner, type TaskRunnerConfig, type TaskRunnerEvents, } from './runner.js';
 export { createScheduleRunner, getNextCronDate, type ScheduleInfo, ScheduleRunner, type ScheduleRunnerConfig, type ScheduleRunnerEvents, validateCronExpression, } from './schedule-runner.js';
 export { type ClaimReadyOptions, type JobStatus, type ListReadyOptions, SmrtJob, SmrtJobCollection, type SmrtJobData, type TimeoutBehavior, } from './smrt-job.js';
 export { type JobEventCursor, type ListJobEventsOptions, SmrtJobEvent, SmrtJobEventCollection, type SmrtJobEventData, type SmrtJobEventLevel, type SmrtJobEventType, } from './smrt-job-event.js';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAKH,OAAO,wBAAwB,CAAC;AAYhC,OAAO,EACL,6BAA6B,EAC7B,KAAK,uBAAuB,EAC5B,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,aAAa,EACb,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,UAAU,EACV,KAAK,QAAQ,EACb,UAAU,EACV,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,SAAS,EACT,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,KAAK,UAAU,EACf,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,OAAO,EACZ,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,oBAAoB,EACpB,KAAK,aAAa,EAClB,YAAY,EACZ,mBAAmB,EACnB,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,mCAAmC,EACnC,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,OAAO,EACP,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,YAAY,EACZ,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,KAAK,mBAAmB,EACxB,UAAU,EACV,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAKH,OAAO,wBAAwB,CAAC;AAYhC,OAAO,EACL,6BAA6B,EAC7B,KAAK,uBAAuB,EAC5B,kBAAkB,EAClB,YAAY,EACZ,sBAAsB,EACtB,4BAA4B,EAC5B,0BAA0B,EAC1B,eAAe,EACf,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,iCAAiC,EACjC,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,GAC7B,MAAM,gCAAgC,CAAC;AAExC,OAAO,EACL,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,aAAa,EACb,uBAAuB,EACvB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,yBAAyB,EACzB,KAAK,sBAAsB,EAC3B,sBAAsB,EACtB,KAAK,6BAA6B,EAClC,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,UAAU,EACV,KAAK,QAAQ,EACb,UAAU,EACV,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,SAAS,EACT,KAAK,SAAS,EACd,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,KAAK,UAAU,EACf,gBAAgB,EAChB,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,KAAK,OAAO,EACZ,qBAAqB,EACrB,KAAK,gBAAgB,EACrB,oBAAoB,EACpB,KAAK,aAAa,EAClB,YAAY,EACZ,mBAAmB,EACnB,WAAW,GACZ,MAAM,eAAe,CAAC;AAEvB,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,qBAAqB,EACrB,mCAAmC,EACnC,yBAAyB,EACzB,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,GAC5B,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,gBAAgB,EAChB,4BAA4B,EAC5B,wBAAwB,EACxB,eAAe,EACf,UAAU,EACV,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,KAAK,YAAY,EACjB,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,OAAO,EACP,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,eAAe,GACrB,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,YAAY,EACZ,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,GACtB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,KAAK,mBAAmB,EACxB,UAAU,EACV,oBAAoB,GACrB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EACL,eAAe,EACf,aAAa,EACb,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}

package/dist/index.js

@@ -1,12 +1,65 @@
-import { A as MAX_JOB_RETRIES, C as startRetentionSweeper, D as SmrtJob, E as SmrtJobEventCollection, F as getBackgroundEligibleMethods, I as isBackgroundEligibleMethod, L as markBackgroundEligible, M as assertWithinTenantCreationCap, N as backgroundEligible, O as SmrtJobCollection, P as clampRetries, S as registerJobRetentionTasks, T as SmrtJobEvent, _ as redactErrorMessage, a as SmrtWorker, b as JOBS_RETENTION_TASK, c as McpTaskCancelledError, d as createMcpTaskResult, f as getMcpTaskMarker, g as redactErrorForPersistence, h as JobContextLogger, i as DEFAULT_TASK_HEARTBEAT_INTERVAL_MS, j as TenantJobCapExceededError, k as DEFAULT_TENANT_JOB_CAP, l as McpTaskNotFoundError, m as taskFromJob, n as TaskRunner, o as SmrtWorkerCollection, p as requestMcpTaskInput, r as createTaskRunner, s as MCP_TASKS_EXTENSION, t as JobTimeoutError, u as McpTaskStore, v as DEFAULT_JOB_RETENTION, w as unregisterJobRetentionTasks, x as JOB_EVENTS_RETENTION_TASK, y as DEFAULT_RETENTION_SWEEP_INTERVAL_MS } from "./chunks/runner-BsYIDzhc.js";
+import { A as SmrtJobCollection, C as JOB_EVENTS_RETENTION_TASK, D as SmrtJobEvent, E as unregisterJobRetentionTasks, F as backgroundEligible, I as clampRetries, L as getBackgroundEligibleMethods, M as MAX_JOB_RETRIES, N as TenantJobCapExceededError, O as SmrtJobEventCollection, P as assertWithinTenantCreationCap, R as isBackgroundEligibleMethod, S as JOBS_RETENTION_TASK, T as startRetentionSweeper, _ as JobContextLogger, a as isRunnerExecutionContext, b as DEFAULT_JOB_RETENTION, c as SmrtWorkerCollection, d as McpTaskNotFoundError, f as McpTaskStore, g as taskFromJob, h as requestMcpTaskInput, i as getActiveJobExecutionContext, j as DEFAULT_TENANT_JOB_CAP, k as SmrtJob, l as MCP_TASKS_EXTENSION, m as getMcpTaskMarker, n as TaskRunner, o as DEFAULT_TASK_HEARTBEAT_INTERVAL_MS, p as createMcpTaskResult, r as createTaskRunner, s as SmrtWorker, t as JobTimeoutError, u as McpTaskCancelledError, v as redactErrorForPersistence, w as registerJobRetentionTasks, x as DEFAULT_RETENTION_SWEEP_INTERVAL_MS, y as redactErrorMessage, z as markBackgroundEligible } from "./chunks/runner-DPSBS7Wf.js";
 import { c as unregisterLiveWorker, i as registerLiveWorker, n as isWorkerAlive, t as createWorkerKey } from "./chunks/worker-liveness-C1Gjnhax.js";
 import { ObjectRegistry, SmrtCollection, SmrtObject, detectEngine, field, smrt } from "@happyvertical/smrt-core";
 import { createLogger } from "@happyvertical/logger";
 import { TenantScoped, requireTenant, tenantId, withTenant } from "@happyvertical/smrt-tenancy";
-import { randomUUID } from "node:crypto";
+import { createHmac, randomUUID, timingSafeEqual } from "node:crypto";
 import { exponential } from "@happyvertical/jobs";
 import { createId } from "@happyvertical/utils";
 import { EventEmitter } from "node:events";
+//#region src/durable-payload-integrity.ts
+function createHmacDurableJobPayloadSigner(options) {
+	if (!options.keyId || options.keyId.length > 256) throw new Error("Durable job integrity keyId must contain 1-256 characters");
+	if ((typeof options.key === "string" ? Buffer.byteLength(options.key) : options.key.byteLength) < 32) throw new Error("Durable job integrity key must contain at least 32 bytes");
+	const signature = (payload) => createHmac("sha256", options.key).update(canonicalJson(payload)).digest("base64url");
+	return Object.freeze({
+		keyId: options.keyId,
+		sign(payload) {
+			return {
+				version: 1,
+				keyId: options.keyId,
+				signature: signature(payload)
+			};
+		},
+		verify(payload, integrity) {
+			if (integrity?.version !== 1 || integrity.keyId !== options.keyId || typeof integrity.signature !== "string") return false;
+			const expected = Buffer.from(signature(payload));
+			const actual = Buffer.from(integrity.signature);
+			return actual.length === expected.length && timingSafeEqual(actual, expected);
+		}
+	});
+}
+function canonicalJson(value) {
+	let persisted;
+	try {
+		persisted = JSON.stringify(value);
+	} catch {
+		throw new Error("Durable job integrity payload must be acyclic JSON");
+	}
+	if (persisted === void 0) throw new Error("Durable job integrity payload must be JSON-serializable");
+	const seen = /* @__PURE__ */ new Set();
+	const canonicalize = (item, inArray = false) => {
+		if (item === null || typeof item === "string" || typeof item === "boolean") return item;
+		if (typeof item === "number") return Number.isFinite(item) ? item : null;
+		if (item === void 0 || typeof item === "function" || typeof item === "symbol") return inArray ? null : void 0;
+		if (typeof item !== "object" || seen.has(item)) throw new Error("Durable job integrity payload must be acyclic JSON");
+		seen.add(item);
+		if (Array.isArray(item)) {
+			const result2 = item.map((entry) => canonicalize(entry, true));
+			seen.delete(item);
+			return result2;
+		}
+		const result = /* @__PURE__ */ Object.create(null);
+		for (const key of Object.keys(item).sort()) {
+			const entry = canonicalize(item[key]);
+			if (entry !== void 0) result[key] = entry;
+		}
+		seen.delete(item);
+		return result;
+	};
+	return JSON.stringify(canonicalize(JSON.parse(persisted)));
+}
+//#endregion
 //#region src/forge-projection.ts
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -1182,6 +1235,6 @@ function createScheduleRunner(config) {
 //#region src/index.ts
 registerJobRetentionTasks();
 //#endregion
-export { DEFAULT_JOB_RETENTION, DEFAULT_RETENTION_SWEEP_INTERVAL_MS, DEFAULT_TENANT_JOB_CAP, ForgeDelivery, ForgeDeliveryCollection, ForgeProjectionCheckpoint, ForgeProjectionRuntime, JOBS_RETENTION_TASK, JOB_EVENTS_RETENTION_TASK, JobBuilder, JobContextLogger, JobHandle, JobTimeoutError, MAX_JOB_RETRIES, MCP_TASKS_EXTENSION, McpTaskCancelledError, McpTaskNotFoundError, McpTaskStore, ScheduleRunner, SmrtJob, SmrtJobCollection, SmrtJobEvent, SmrtJobEventCollection, SmrtWorker, SmrtWorkerCollection, TaskRunner, TenantJobCapExceededError, assertWithinTenantCreationCap, backgroundEligible, clampRetries, createMcpTaskResult, createScheduleRunner, createTaskRunner, createWorkerKey, getBackgroundEligibleMethods, getMcpTaskMarker, getNextCronDate, isBackgroundEligibleMethod, isWorkerAlive, markBackgroundEligible, parseDelay, priorityToNumber, redactErrorForPersistence, redactErrorMessage, registerJobRetentionTasks, registerLiveWorker, requestMcpTaskInput, startRetentionSweeper, taskFromJob, unregisterJobRetentionTasks, unregisterLiveWorker, validateCronExpression, withBackgroundJobs };
+export { DEFAULT_JOB_RETENTION, DEFAULT_RETENTION_SWEEP_INTERVAL_MS, DEFAULT_TENANT_JOB_CAP, ForgeDelivery, ForgeDeliveryCollection, ForgeProjectionCheckpoint, ForgeProjectionRuntime, JOBS_RETENTION_TASK, JOB_EVENTS_RETENTION_TASK, JobBuilder, JobContextLogger, JobHandle, JobTimeoutError, MAX_JOB_RETRIES, MCP_TASKS_EXTENSION, McpTaskCancelledError, McpTaskNotFoundError, McpTaskStore, ScheduleRunner, SmrtJob, SmrtJobCollection, SmrtJobEvent, SmrtJobEventCollection, SmrtWorker, SmrtWorkerCollection, TaskRunner, TenantJobCapExceededError, assertWithinTenantCreationCap, backgroundEligible, clampRetries, createHmacDurableJobPayloadSigner, createMcpTaskResult, createScheduleRunner, createTaskRunner, createWorkerKey, getActiveJobExecutionContext, getBackgroundEligibleMethods, getMcpTaskMarker, getNextCronDate, isBackgroundEligibleMethod, isRunnerExecutionContext, isWorkerAlive, markBackgroundEligible, parseDelay, priorityToNumber, redactErrorForPersistence, redactErrorMessage, registerJobRetentionTasks, registerLiveWorker, requestMcpTaskInput, startRetentionSweeper, taskFromJob, unregisterJobRetentionTasks, unregisterLiveWorker, validateCronExpression, withBackgroundJobs };
 
 //# sourceMappingURL=index.js.map