@porulle/core 0.17.0 → 0.19.0

package/dist/index.d.ts

@@ -34,8 +34,9 @@ export { NullJobsAdapter } from "./kernel/jobs/adapter.js";
 export { DrizzleJobsAdapter } from "./kernel/jobs/drizzle-adapter.js";
 export { runPendingJobs } from "./kernel/jobs/runner.js";
 export type { RunPendingJobsArgs } from "./kernel/jobs/runner.js";
-export type { TaskDefinition, TaskContext, TaskJobMeta, TaskRetryConfig, JobProcessingOrder, JobProcessingOrderField, JobProcessingOrderRecord, } from "./kernel/jobs/types.js";
-export { BUILTIN_JOB_TASK_SLUGS } from "./kernel/jobs/types.js";
+export type { TaskDefinition, TaskContext, TaskStep, TaskJobMeta, TaskRetryConfig, JobInstanceStatus, JobProcessingOrder, JobProcessingOrderField, JobProcessingOrderRecord, } from "./kernel/jobs/types.js";
+export { BUILTIN_JOB_TASK_SLUGS, TaskNonRetryableError } from "./kernel/jobs/types.js";
+export { createPassThroughTaskStep } from "./kernel/jobs/step.js";
 export { staleJobReaperTask, runStaleJobReaper, getJobReapThresholdMs, getJobsReaperIntervalMs, } from "./kernel/jobs/reaper.js";
 export { createLocalAPI, LocalAPI } from "./kernel/local-api.js";
 export type { CommerceLocalAPI, LocalAPIOptions } from "./kernel/local-api.js";

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -22,7 +22,8 @@ export { createHookContext } from "./kernel/hooks/create-context.js";
 export { NullJobsAdapter } from "./kernel/jobs/adapter.js";
 export { DrizzleJobsAdapter } from "./kernel/jobs/drizzle-adapter.js";
 export { runPendingJobs } from "./kernel/jobs/runner.js";
-export { BUILTIN_JOB_TASK_SLUGS } from "./kernel/jobs/types.js";
+export { BUILTIN_JOB_TASK_SLUGS, TaskNonRetryableError } from "./kernel/jobs/types.js";
+export { createPassThroughTaskStep } from "./kernel/jobs/step.js";
 export { staleJobReaperTask, runStaleJobReaper, getJobReapThresholdMs, getJobsReaperIntervalMs, } from "./kernel/jobs/reaper.js";
 export { createLocalAPI, LocalAPI } from "./kernel/local-api.js";
 export { createCommerce } from "./runtime/commerce.js";

package/dist/interfaces/rest/router.d.ts

@@ -67,6 +67,7 @@ declare class RouteChain {
     private _input;
     private _query;
     private _params;
+    private _output;
     private _requireAuth;
     private _requiredPermission;
     constructor(method: string, fullPath: string, tag: string, routesList: PluginRouteRegistration[], pluginCtx?: {
@@ -84,6 +85,26 @@ declare class RouteChain {
     query(schema: z.ZodType): this;
     /** Override the auto-detected path parameter schema. */
     params(schema: z.ZodType): this;
+    /**
+     * Declare the shape carried inside the `{ data }` envelope on success.
+     *
+     * Without it the route documents its payload as `any`, and every generated
+     * client sees `data?: unknown` — so a consumer has to hand-maintain a
+     * parallel schema, which is the drift the generated SDK exists to prevent.
+     *
+     * Documentation only: the handler's return value is not validated against
+     * this schema. Validating would mean either stripping unknown keys — silently
+     * changing what goes over the wire for anyone who adopts it — or throwing at
+     * runtime, turning an OpenAPI annotation into a new failure mode. A stale
+     * annotation is the cheaper wrong.
+     *
+     * @example
+     * ```typescript
+     * vendors.get("/{id}").summary("Get").output(VendorSchema)
+     *   .handler(async ({ params, services }) => services.vendor.get(params.id));
+     * ```
+     */
+    output(schema: z.ZodType): this;
     /**
      * Require authentication. The handler's `actor` is guaranteed non-null.
      * Returns 401 if the request has no authenticated actor.

package/dist/interfaces/rest/router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/interfaces/rest/router.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAe,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAwB/E,MAAM,WAAW,mBAAmB;IAClC,mFAAmF;IACnF,KAAK,EAAE,OAAO,CAAC;IACf,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,0DAA0D;IAC1D,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,uFAAuF;IACvF,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC/H,4FAA4F;IAC5F,KAAK,EAAE,MAAM,CAAC;IACd,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,gCAAgC;IAChC,EAAE,EAAE,OAAO,CAAC;IACZ,oCAAoC;IACpC,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,GAAG,EAAE,OAAO,CAAC;CACd;AAID,cAAM,UAAU;IASZ,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,GAAG;IACX,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,SAAS,CAAC;IAZpB,OAAO,CAAC,QAAQ,CAAM;IACtB,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,mBAAmB,CAAqB;gBAEtC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,uBAAuB,EAAE,EACrC,SAAS,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,cAAc,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,YAAA;IAUjG,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE,MAAM;IAEpB,kDAAkD;IAClD,WAAW,CAAC,IAAI,EAAE,MAAM;IAExB,4DAA4D;IAC5D,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO;IAEvB,sCAAsC;IACtC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO;IAEvB,wDAAwD;IACxD,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO;IAExB;;;OAGG;IACH,IAAI;IAEJ;;;;;;;;;;;;OAYG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM;IAMxB;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,IAAI;CAwHlE;AAID,cAAM,UAAU;IAMZ,OAAO,CAAC,GAAG;IALb,OAAO,CAAC,OAAO,CAAiC;IAChD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAA0F;gBAGlG,GAAG,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,SAAS,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,cAAc,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE;YAAE,EAAE,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE;IAiBzG,0EAA0E;IAC1E,IAAI,aAAa;iBAvBc,cAAc;kBAAY,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;YAAM,OAAO;kBAuB9C;IAE/C,OAAO,CAAC,WAAW;IAMnB,GAAG,CAAC,IAAI,EAAE,MAAM;IAChB,IAAI,CAAC,IAAI,EAAE,MAAM;IACjB,KAAK,CAAC,IAAI,EAAE,MAAM;IAClB,MAAM,CAAC,IAAI,EAAE,MAAM;IACnB,GAAG,CAAC,IAAI,EAAE,MAAM;IAEhB,iEAAiE;IACjE,MAAM,IAAI,uBAAuB,EAAE;CACpC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,EAAE,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAAG,UAAU,CAEjK"}
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../../../src/interfaces/rest/router.ts"],"names":[],"mappings":"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"}

package/dist/interfaces/rest/router.js

@@ -56,6 +56,7 @@ class RouteChain {
     _input;
     _query;
     _params;
+    _output;
     _requireAuth = false;
     _requiredPermission;
     constructor(method, fullPath, tag, routesList, pluginCtx) {
@@ -79,6 +80,26 @@ class RouteChain {
     query(schema) { this._query = schema; return this; }
     /** Override the auto-detected path parameter schema. */
     params(schema) { this._params = schema; return this; }
+    /**
+     * Declare the shape carried inside the `{ data }` envelope on success.
+     *
+     * Without it the route documents its payload as `any`, and every generated
+     * client sees `data?: unknown` — so a consumer has to hand-maintain a
+     * parallel schema, which is the drift the generated SDK exists to prevent.
+     *
+     * Documentation only: the handler's return value is not validated against
+     * this schema. Validating would mean either stripping unknown keys — silently
+     * changing what goes over the wire for anyone who adopts it — or throwing at
+     * runtime, turning an OpenAPI annotation into a new failure mode. A stale
+     * annotation is the cheaper wrong.
+     *
+     * @example
+     * ```typescript
+     * vendors.get("/{id}").summary("Get").output(VendorSchema)
+     *   .handler(async ({ params, services }) => services.vendor.get(params.id));
+     * ```
+     */
+    output(schema) { this._output = schema; return this; }
     /**
      * Require authentication. The handler's `actor` is guaranteed non-null.
      * Returns 401 if the request has no authenticated actor.
@@ -126,7 +147,7 @@ class RouteChain {
             ...(this._description ? { description: this._description } : {}),
             ...(Object.keys(request).length > 0 ? { request } : {}),
             responses: {
-                [status]: wrapJson(z.object({ data: z.any() })),
+                [status]: wrapJson(z.object({ data: this._output ?? z.any() })),
                 ...errorResponses,
             },
         });

package/dist/interfaces/rest/schemas/admin-jobs.d.ts

@@ -122,14 +122,14 @@ export declare const listFailedJobsRoute: {
                                 tableName: "commerce_jobs";
                                 dataType: "string";
                                 columnType: "PgText";
-                                data: "pending" | "processing" | "succeeded" | "failed";
+                                data: "pending" | "processing" | "succeeded" | "failed" | "cancelled";
                                 driverParam: string;
                                 notNull: true;
                                 hasDefault: true;
                                 isPrimaryKey: false;
                                 isAutoincrement: false;
                                 hasRuntimeDefault: false;
-                                enumValues: ["pending", "processing", "succeeded", "failed"];
+                                enumValues: ["pending", "processing", "succeeded", "failed", "cancelled"];
                                 baseColumn: never;
                                 identity: undefined;
                                 generated: undefined;

package/dist/interfaces/rest/schemas/responses.d.ts

@@ -2245,14 +2245,14 @@ export declare const JobSchema: import("drizzle-zod").BuildSchema<"select", {
         tableName: "commerce_jobs";
         dataType: "string";
         columnType: "PgText";
-        data: "pending" | "processing" | "succeeded" | "failed";
+        data: "pending" | "processing" | "succeeded" | "failed" | "cancelled";
         driverParam: string;
         notNull: true;
         hasDefault: true;
         isPrimaryKey: false;
         isAutoincrement: false;
         hasRuntimeDefault: false;
-        enumValues: ["pending", "processing", "succeeded", "failed"];
+        enumValues: ["pending", "processing", "succeeded", "failed", "cancelled"];
         baseColumn: never;
         identity: undefined;
         generated: undefined;
@@ -4280,14 +4280,14 @@ export declare const JobListResponse: z.ZodObject<{
             tableName: "commerce_jobs";
             dataType: "string";
             columnType: "PgText";
-            data: "pending" | "processing" | "succeeded" | "failed";
+            data: "pending" | "processing" | "succeeded" | "failed" | "cancelled";
             driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["pending", "processing", "succeeded", "failed"];
+            enumValues: ["pending", "processing", "succeeded", "failed", "cancelled"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;

package/dist/jobs.d.ts

@@ -0,0 +1,5 @@
+export type { JobInstanceStatus, TaskContext, TaskDefinition, TaskJobMeta, TaskRetryConfig, TaskStep, } from "./kernel/jobs/types.js";
+export { TaskNonRetryableError } from "./kernel/jobs/types.js";
+export { createPassThroughTaskStep } from "./kernel/jobs/step.js";
+export type { EnqueueOptions, ExecutionEngine, ExecutionEngineSetup, JobsAdapter, } from "./kernel/jobs/adapter.js";
+//# sourceMappingURL=jobs.d.ts.map

package/dist/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../src/jobs.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,cAAc,EACd,WAAW,EACX,eAAe,EACf,QAAQ,GACT,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,uBAAuB,CAAC;AAClE,YAAY,EACV,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,WAAW,GACZ,MAAM,0BAA0B,CAAC"}

package/dist/jobs.js

@@ -0,0 +1,2 @@
+export { TaskNonRetryableError } from "./kernel/jobs/types.js";
+export { createPassThroughTaskStep } from "./kernel/jobs/step.js";

package/dist/kernel/jobs/adapter.d.ts

@@ -1,7 +1,14 @@
-import type { JobProcessingOrder, TaskContext, TaskDefinition } from "./types.js";
+import type { JobInstanceStatus, JobProcessingOrder, TaskContext, TaskDefinition } from "./types.js";
 /** Enqueue-only surface exposed to hooks and services. */
 export interface JobsAdapter {
     enqueue(taskSlug: string, input: Record<string, unknown>, options: EnqueueOptions): Promise<string>;
+    /** Not every engine can report instance status; absent where it cannot. */
+    status?(jobId: string): Promise<{
+        status: JobInstanceStatus;
+        error?: string;
+    }>;
+    /** Not every engine can cancel an in-flight instance; absent where it cannot. */
+    cancel?(jobId: string): Promise<void>;
 }
 export interface RunJobsOptions {
     queue?: string;
@@ -34,6 +41,11 @@ export interface EnqueueOptions {
     delayMs?: number;
     concurrencyKey?: string;
     supersedes?: boolean;
+    /** Used verbatim as the job id — the `commerce_jobs` row id on the drizzle
+     * engine, the instance id on Cloudflare Workflows — so a caller can address the
+     * job it created ("one generation, one instance"). Must be a UUID on drizzle.
+     * The pg-boss, Inngest and Trigger engines choose their own ids and ignore it. */
+    jobId?: string;
 }
 /**
  * No-op enqueue surface used by isolated hook contexts.

package/dist/kernel/jobs/adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/kernel/jobs/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,OAAO,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACvD,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,uEAAuE;AACvE,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IAC3C,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;CAGnB"}
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../../src/kernel/jobs/adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,0DAA0D;AAC1D,MAAM,WAAW,WAAW;IAC1B,OAAO,CACL,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC,CAAC;IACnB,2EAA2E;IAC3E,MAAM,CAAC,CACL,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC1D,iFAAiF;IACjF,MAAM,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC3C,OAAO,EAAE,WAAW,CAAC;IACrB,eAAe,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED,MAAM,MAAM,eAAe,GACvB;IACE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;CACvD,GACD;IACE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEN,uEAAuE;AACvE,MAAM,WAAW,eAAgB,SAAQ,WAAW;IAClD,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;sFAGkF;IAClF,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,qBAAa,eAAgB,YAAW,WAAW;IAC3C,OAAO,CACX,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,cAAc,GACvB,OAAO,CAAC,MAAM,CAAC;CAGnB"}

package/dist/kernel/jobs/drizzle-adapter.d.ts

@@ -1,5 +1,5 @@
 import type { DrizzleDatabase } from "../database/drizzle-db.js";
-import type { TaskDefinition } from "./types.js";
+import type { JobInstanceStatus, TaskDefinition } from "./types.js";
 import type { EnqueueOptions, ExecutionEngine, ExecutionEngineSetup, RunJobsOptions } from "./adapter.js";
 /**
  * PostgreSQL-backed job queue adapter using the application's own database.
@@ -21,5 +21,13 @@ export declare class DrizzleJobsAdapter implements ExecutionEngine {
     constructor(db: DrizzleDatabase, tasks?: Map<string, TaskDefinition>);
     register(setup: ExecutionEngineSetup): void;
     enqueue(taskSlug: string, input: Record<string, unknown>, options: EnqueueOptions): Promise<string>;
+    status(jobId: string): Promise<{
+        status: JobInstanceStatus;
+        error?: string;
+    }>;
+    /** Cancels a job that has not started yet; a job already `processing` (or
+     * finished) cannot be interrupted from here and is left untouched. The row is
+     * kept so `status()` reports it as `terminated`. */
+    cancel(jobId: string): Promise<void>;
 }
 //# sourceMappingURL=drizzle-adapter.d.ts.map

package/dist/kernel/jobs/drizzle-adapter.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drizzle-adapter.d.ts","sourceRoot":"","sources":["../../../src/kernel/jobs/drizzle-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,cAAc,EACf,MAAM,cAAc,CAAC;AAUtB;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IA4CtD,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,KAAK;IA5Cf,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,oBAAoB,CAAK;IAEjC,QAAQ,CAAC,SAAS;;wBAEK,cAAc;;;;MAmCnC;gBAGQ,EAAE,EAAE,eAAe,EACnB,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAa;IAGxD,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAKrC,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC;CA+CnB"}
+{"version":3,"file":"drizzle-adapter.d.ts","sourceRoot":"","sources":["../../../src/kernel/jobs/drizzle-adapter.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,cAAc,EACf,MAAM,cAAc,CAAC;AAUtB;;;;GAIG;AACH,qBAAa,kBAAmB,YAAW,eAAe;IA4CtD,OAAO,CAAC,EAAE;IACV,OAAO,CAAC,KAAK;IA5Cf,OAAO,CAAC,KAAK,CAAmC;IAChD,OAAO,CAAC,oBAAoB,CAAK;IAEjC,QAAQ,CAAC,SAAS;;wBAEK,cAAc;;;;MAmCnC;gBAGQ,EAAE,EAAE,eAAe,EACnB,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAa;IAGxD,QAAQ,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI;IAKrC,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,MAAM,CAAC;IAiDZ,MAAM,CACV,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC;QAAE,MAAM,EAAE,iBAAiB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAezD;;wDAEoD;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ3C"}

package/dist/kernel/jobs/drizzle-adapter.js

@@ -1,5 +1,5 @@
 import { eq, and } from "drizzle-orm";
-import { OrgResolutionError } from "../errors.js";
+import { OrgResolutionError, CommerceNotFoundError } from "../errors.js";
 import { commerceJobs } from "./schema.js";
 import { runPendingJobs } from "./runner.js";
 import { getJobReapThresholdMs, getJobsReaperIntervalMs, runStaleJobReaper, } from "./reaper.js";
@@ -71,6 +71,7 @@ export class DrizzleJobsAdapter {
         const rows = await this.db
             .insert(commerceJobs)
             .values({
+            ...(options.jobId ? { id: options.jobId } : {}),
             organizationId,
             taskSlug,
             input,
@@ -84,4 +85,34 @@ export class DrizzleJobsAdapter {
             .returning({ id: commerceJobs.id });
         return rows[0].id;
     }
+    async status(jobId) {
+        const [row] = await this.db
+            .select()
+            .from(commerceJobs)
+            .where(eq(commerceJobs.id, jobId))
+            .limit(1);
+        if (!row) {
+            throw new CommerceNotFoundError(`No job found for id ${jobId}`);
+        }
+        return {
+            status: DRIZZLE_JOB_STATUS_MAP[row.status],
+            ...(row.error !== null ? { error: row.error } : {}),
+        };
+    }
+    /** Cancels a job that has not started yet; a job already `processing` (or
+     * finished) cannot be interrupted from here and is left untouched. The row is
+     * kept so `status()` reports it as `terminated`. */
+    async cancel(jobId) {
+        await this.db
+            .update(commerceJobs)
+            .set({ status: "cancelled" })
+            .where(and(eq(commerceJobs.id, jobId), eq(commerceJobs.status, "pending")));
+    }
 }
+const DRIZZLE_JOB_STATUS_MAP = {
+    pending: "queued",
+    processing: "running",
+    succeeded: "complete",
+    failed: "errored",
+    cancelled: "terminated",
+};

package/dist/kernel/jobs/runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/kernel/jobs/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGrE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,eAAe,CAAC;IACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AA4CD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAkNhD"}
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../../src/kernel/jobs/runner.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAKrE,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,eAAe,CAAC;IACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AA4CD;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAoNhD"}

package/dist/kernel/jobs/runner.js

@@ -1,4 +1,6 @@
 import { eq, and, sql } from "drizzle-orm";
+import { TaskNonRetryableError } from "./types.js";
+import { createPassThroughTaskStep } from "./step.js";
 import { commerceJobs } from "./schema.js";
 function isExclusiveTask(task) {
     return Boolean(task?.concurrency && task.concurrency.exclusive !== false);
@@ -115,6 +117,7 @@ export async function runPendingJobs(args) {
         return jobsToRun.sort(compareByProcessingOrder(processingOrder));
     });
     // Phase 2: Execute each claimed job outside the claim transaction
+    const step = createPassThroughTaskStep();
     const outcomes = await Promise.all(claimed.map(async (job) => {
         const task = tasks.get(job.taskSlug);
         if (!task) {
@@ -136,7 +139,7 @@ export async function runPendingJobs(args) {
         try {
             const result = await task.handler({
                 input: job.input,
-                ctx: { logger, db, services },
+                ctx: { logger, db, services, step },
                 job: {
                     attemptNumber: job.attempts + 1,
                     maxAttempts: job.maxAttempts,
@@ -162,7 +165,8 @@ export async function runPendingJobs(args) {
             });
             const attempts = job.attempts + 1;
             const maxAttempts = job.maxAttempts;
-            if (attempts >= maxAttempts) {
+            const nonRetryable = err instanceof TaskNonRetryableError;
+            if (nonRetryable || attempts >= maxAttempts) {
                 await db
                     .update(commerceJobs)
                     .set({

package/dist/kernel/jobs/schema.d.ts

@@ -109,14 +109,14 @@ export declare const commerceJobs: import("drizzle-orm/pg-core").PgTableWithColu
             tableName: "commerce_jobs";
             dataType: "string";
             columnType: "PgText";
-            data: "pending" | "processing" | "succeeded" | "failed";
+            data: "pending" | "processing" | "succeeded" | "failed" | "cancelled";
             driverParam: string;
             notNull: true;
             hasDefault: true;
             isPrimaryKey: false;
             isAutoincrement: false;
             hasRuntimeDefault: false;
-            enumValues: ["pending", "processing", "succeeded", "failed"];
+            enumValues: ["pending", "processing", "succeeded", "failed", "cancelled"];
             baseColumn: never;
             identity: undefined;
             generated: undefined;

package/dist/kernel/jobs/schema.js

@@ -10,7 +10,7 @@ export const commerceJobs = pgTable("commerce_jobs", {
     input: jsonb("input").notNull().default("{}"),
     output: jsonb("output"),
     status: text("status", {
-        enum: ["pending", "processing", "succeeded", "failed"],
+        enum: ["pending", "processing", "succeeded", "failed", "cancelled"],
     })
         .notNull()
         .default("pending"),

package/dist/kernel/jobs/step.d.ts

@@ -0,0 +1,8 @@
+import type { TaskStep } from "./types.js";
+/**
+ * Pass-through `TaskStep` for pull-based engines with no durable step primitive:
+ * `do` runs `fn` immediately, `sleep` waits in-process. Lets a handler written
+ * against `ctx.step` run unchanged on the drizzle engine.
+ */
+export declare function createPassThroughTaskStep(): TaskStep;
+//# sourceMappingURL=step.d.ts.map

package/dist/kernel/jobs/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../../../src/kernel/jobs/step.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;;GAIG;AACH,wBAAgB,yBAAyB,IAAI,QAAQ,CAkBpD"}

package/dist/kernel/jobs/step.js

@@ -0,0 +1,24 @@
+import { TaskNonRetryableError } from "./types.js";
+/**
+ * Pass-through `TaskStep` for pull-based engines with no durable step primitive:
+ * `do` runs `fn` immediately, `sleep` waits in-process. Lets a handler written
+ * against `ctx.step` run unchanged on the drizzle engine.
+ */
+export function createPassThroughTaskStep() {
+    return {
+        async do(_name, fn, options) {
+            try {
+                return await fn();
+            }
+            catch (error) {
+                if (options?.nonRetryable && !(error instanceof TaskNonRetryableError)) {
+                    throw new TaskNonRetryableError(error instanceof Error ? error.message : String(error));
+                }
+                throw error;
+            }
+        },
+        async sleep(_name, ms) {
+            await new Promise((resolve) => setTimeout(resolve, ms));
+        },
+    };
+}

package/dist/kernel/jobs/types.d.ts

@@ -8,7 +8,27 @@ export interface TaskContext {
     logger: Logger;
     db: DrizzleDatabase;
     services: ServiceContainer;
+    /** Durable per-phase execution, backed by the Workflow step on Cloudflare and a
+     * pass-through implementation on the drizzle engine. Absent on engines (pg-boss,
+     * Inngest, Trigger) that have not wired one; a handler that ignores it runs as before. */
+    step?: TaskStep;
 }
+/** Durable, idempotent execution of one phase of a task handler. */
+export interface TaskStep {
+    do<T>(name: string, fn: () => Promise<T>, options?: {
+        retries?: TaskRetryConfig;
+        timeout?: number;
+        nonRetryable?: boolean;
+    }): Promise<T>;
+    sleep(name: string, ms: number): Promise<void>;
+}
+/** Thrown by a task handler (or a step's callback) to signal the failure must not be
+ * retried — the Cloudflare engine maps it to `NonRetryableError`; the drizzle runner
+ * fails the job immediately regardless of remaining attempts. */
+export declare class TaskNonRetryableError extends Error {
+    constructor(message: string);
+}
+export type JobInstanceStatus = "queued" | "running" | "waiting" | "complete" | "errored" | "terminated";
 export interface TaskRetryConfig {
     attempts: number;
     backoff?: {
@@ -44,6 +64,13 @@ export interface TaskDefinition<TInput extends Record<string, unknown> = Record<
         output: TOutput;
     }>;
     retries?: TaskRetryConfig;
+    /** The handler drives its own durable phases through `ctx.step` and keeps every
+     * side effect inside one. A push engine with a step primitive (Cloudflare) then
+     * runs the handler directly — each `ctx.step.do` is a real step with its own
+     * retries and `retries` above is only the per-step default — instead of
+     * wrapping the whole handler in one retried unit; `job.attemptNumber` is then
+     * always 1, because retries happen per step. Pull engines ignore it. */
+    durableSteps?: boolean;
     concurrency?: {
         key: (input: TInput) => string;
         exclusive?: boolean;

package/dist/kernel/jobs/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/kernel/jobs/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAEjE,eAAO,MAAM,sBAAsB;;;CAGzB,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,eAAe,CAAC;IACpB,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,OAAO,GAAG,aAAa,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC5D;AAED,MAAM,WAAW,wBAAwB;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB;AAED,MAAM,MAAM,uBAAuB,GAC/B,WAAW,GACX,WAAW,GACX,UAAU,GACV,UAAU,CAAC;AAEf,MAAM,MAAM,kBAAkB,GAC1B;IACE,KAAK,EAAE,uBAAuB,CAAC;IAC/B,SAAS,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;CAC5B,GACD,CAAC,CACC,IAAI,EAAE,wBAAwB,EAC9B,KAAK,EAAE,wBAAwB,KAC5B,MAAM,CAAC,CAAC;AAEjB,sFAAsF;AACtF,MAAM,WAAW,WAAW;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc,CAC7B,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,OAAO,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAEjE,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,CAAC,IAAI,EAAE;QACd,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,EAAE,WAAW,CAAC;QACjB,GAAG,CAAC,EAAE,WAAW,CAAC;KACnB,KAAK,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IACnC,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B,WAAW,CAAC,EAAE;QACZ,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;QAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,CAAC;CACH"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/kernel/jobs/types.ts"],"names":[],"mappings":"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"}

package/dist/kernel/jobs/types.js

@@ -2,3 +2,12 @@ export const BUILTIN_JOB_TASK_SLUGS = {
     webhookDeliver: "webhooks/deliver",
     staleJobReaper: "jobs/reap-stale",
 };
+/** Thrown by a task handler (or a step's callback) to signal the failure must not be
+ * retried — the Cloudflare engine maps it to `NonRetryableError`; the drizzle runner
+ * fails the job immediately regardless of remaining attempts. */
+export class TaskNonRetryableError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "TaskNonRetryableError";
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@porulle/core",
-  "version": "0.17.0",
+  "version": "0.19.0",
   "license": "MIT",
   "type": "module",
   "exports": {
@@ -33,6 +33,12 @@
       "bun": "./src/drizzle.ts",
       "import": "./dist/drizzle.js",
       "require": "./dist/drizzle.js"
+    },
+    "./jobs": {
+      "types": "./src/jobs.ts",
+      "bun": "./src/jobs.ts",
+      "import": "./dist/jobs.js",
+      "require": "./dist/jobs.js"
     }
   },
   "dependencies": {

package/src/index.ts

@@ -84,13 +84,16 @@ export type { RunPendingJobsArgs } from "./kernel/jobs/runner.js";
 export type {
   TaskDefinition,
   TaskContext,
+  TaskStep,
   TaskJobMeta,
   TaskRetryConfig,
+  JobInstanceStatus,
   JobProcessingOrder,
   JobProcessingOrderField,
   JobProcessingOrderRecord,
 } from "./kernel/jobs/types.js";
-export { BUILTIN_JOB_TASK_SLUGS } from "./kernel/jobs/types.js";
+export { BUILTIN_JOB_TASK_SLUGS, TaskNonRetryableError } from "./kernel/jobs/types.js";
+export { createPassThroughTaskStep } from "./kernel/jobs/step.js";
 export {
   staleJobReaperTask,
   runStaleJobReaper,

package/src/interfaces/rest/router.ts

@@ -85,6 +85,7 @@ class RouteChain {
   private _input: z.ZodType | undefined;
   private _query: z.ZodType | undefined;
   private _params: z.ZodType | undefined;
+  private _output: z.ZodType | undefined;
   private _requireAuth = false;
   private _requiredPermission: string | undefined;
   constructor(
@@ -117,6 +118,27 @@ class RouteChain {
   /** Override the auto-detected path parameter schema. */
   params(schema: z.ZodType) { this._params = schema; return this; }
 
+  /**
+   * Declare the shape carried inside the `{ data }` envelope on success.
+   *
+   * Without it the route documents its payload as `any`, and every generated
+   * client sees `data?: unknown` — so a consumer has to hand-maintain a
+   * parallel schema, which is the drift the generated SDK exists to prevent.
+   *
+   * Documentation only: the handler's return value is not validated against
+   * this schema. Validating would mean either stripping unknown keys — silently
+   * changing what goes over the wire for anyone who adopts it — or throwing at
+   * runtime, turning an OpenAPI annotation into a new failure mode. A stale
+   * annotation is the cheaper wrong.
+   *
+   * @example
+   * ```typescript
+   * vendors.get("/{id}").summary("Get").output(VendorSchema)
+   *   .handler(async ({ params, services }) => services.vendor.get(params.id));
+   * ```
+   */
+  output(schema: z.ZodType) { this._output = schema; return this; }
+
   /**
    * Require authentication. The handler's `actor` is guaranteed non-null.
    * Returns 401 if the request has no authenticated actor.
@@ -165,7 +187,7 @@ class RouteChain {
       ...(this._description ? { description: this._description } : {}),
       ...(Object.keys(request).length > 0 ? { request } : {}),
       responses: {
-        [status]: wrapJson(z.object({ data: z.any() })),
+        [status]: wrapJson(z.object({ data: this._output ?? z.any() })),
         ...errorResponses,
       },
     });

package/src/jobs.ts

@@ -0,0 +1,18 @@
+// Leaf entry for execution engines that run outside Node (Cloudflare Workers):
+// only the job types and the two runtime helpers, none of the server runtime.
+export type {
+  JobInstanceStatus,
+  TaskContext,
+  TaskDefinition,
+  TaskJobMeta,
+  TaskRetryConfig,
+  TaskStep,
+} from "./kernel/jobs/types.js";
+export { TaskNonRetryableError } from "./kernel/jobs/types.js";
+export { createPassThroughTaskStep } from "./kernel/jobs/step.js";
+export type {
+  EnqueueOptions,
+  ExecutionEngine,
+  ExecutionEngineSetup,
+  JobsAdapter,
+} from "./kernel/jobs/adapter.js";

package/src/kernel/jobs/adapter.ts

@@ -1,4 +1,5 @@
 import type {
+  JobInstanceStatus,
   JobProcessingOrder,
   TaskContext,
   TaskDefinition,
@@ -11,6 +12,12 @@ export interface JobsAdapter {
     input: Record<string, unknown>,
     options: EnqueueOptions,
   ): Promise<string>;
+  /** Not every engine can report instance status; absent where it cannot. */
+  status?(
+    jobId: string,
+  ): Promise<{ status: JobInstanceStatus; error?: string }>;
+  /** Not every engine can cancel an in-flight instance; absent where it cannot. */
+  cancel?(jobId: string): Promise<void>;
 }
 
 export interface RunJobsOptions {
@@ -51,6 +58,11 @@ export interface EnqueueOptions {
   delayMs?: number;
   concurrencyKey?: string;
   supersedes?: boolean;
+  /** Used verbatim as the job id — the `commerce_jobs` row id on the drizzle
+   * engine, the instance id on Cloudflare Workflows — so a caller can address the
+   * job it created ("one generation, one instance"). Must be a UUID on drizzle.
+   * The pg-boss, Inngest and Trigger engines choose their own ids and ignore it. */
+  jobId?: string;
 }
 
 /**

package/src/kernel/jobs/drizzle-adapter.ts

@@ -1,13 +1,13 @@
 import { eq, and } from "drizzle-orm";
 import type { DrizzleDatabase } from "../database/drizzle-db.js";
-import type { TaskDefinition } from "./types.js";
+import type { JobInstanceStatus, TaskDefinition } from "./types.js";
 import type {
   EnqueueOptions,
   ExecutionEngine,
   ExecutionEngineSetup,
   RunJobsOptions,
 } from "./adapter.js";
-import { OrgResolutionError } from "../errors.js";
+import { OrgResolutionError, CommerceNotFoundError } from "../errors.js";
 import { commerceJobs } from "./schema.js";
 import { runPendingJobs } from "./runner.js";
 import {
@@ -111,6 +111,7 @@ export class DrizzleJobsAdapter implements ExecutionEngine {
     const rows = await this.db
       .insert(commerceJobs)
       .values({
+        ...(options.jobId ? { id: options.jobId } : {}),
         organizationId,
         taskSlug,
         input,
@@ -125,4 +126,44 @@ export class DrizzleJobsAdapter implements ExecutionEngine {
 
     return rows[0]!.id;
   }
+
+  async status(
+    jobId: string,
+  ): Promise<{ status: JobInstanceStatus; error?: string }> {
+    const [row] = await this.db
+      .select()
+      .from(commerceJobs)
+      .where(eq(commerceJobs.id, jobId))
+      .limit(1);
+    if (!row) {
+      throw new CommerceNotFoundError(`No job found for id ${jobId}`);
+    }
+    return {
+      status: DRIZZLE_JOB_STATUS_MAP[row.status],
+      ...(row.error !== null ? { error: row.error } : {}),
+    };
+  }
+
+  /** Cancels a job that has not started yet; a job already `processing` (or
+   * finished) cannot be interrupted from here and is left untouched. The row is
+   * kept so `status()` reports it as `terminated`. */
+  async cancel(jobId: string): Promise<void> {
+    await this.db
+      .update(commerceJobs)
+      .set({ status: "cancelled" })
+      .where(
+        and(eq(commerceJobs.id, jobId), eq(commerceJobs.status, "pending")),
+      );
+  }
 }
+
+const DRIZZLE_JOB_STATUS_MAP: Record<
+  "pending" | "processing" | "succeeded" | "failed" | "cancelled",
+  JobInstanceStatus
+> = {
+  pending: "queued",
+  processing: "running",
+  succeeded: "complete",
+  failed: "errored",
+  cancelled: "terminated",
+};

package/src/kernel/jobs/runner.ts

@@ -2,6 +2,8 @@ import { eq, and, sql } from "drizzle-orm";
 import type { DrizzleDatabase } from "../database/drizzle-db.js";
 import type { Logger, ServiceContainer } from "../hooks/types.js";
 import type { JobProcessingOrder, TaskDefinition } from "./types.js";
+import { TaskNonRetryableError } from "./types.js";
+import { createPassThroughTaskStep } from "./step.js";
 import { commerceJobs } from "./schema.js";
 
 export interface RunPendingJobsArgs {
@@ -180,6 +182,7 @@ export async function runPendingJobs(
   });
 
   // Phase 2: Execute each claimed job outside the claim transaction
+  const step = createPassThroughTaskStep();
   const outcomes = await Promise.all(
     claimed.map(async (job) => {
       const task = tasks.get(job.taskSlug);
@@ -207,7 +210,7 @@ export async function runPendingJobs(
       try {
         const result = await task.handler({
           input: job.input as Record<string, unknown>,
-          ctx: { logger, db, services },
+          ctx: { logger, db, services, step },
           job: {
             attemptNumber: job.attempts + 1,
             maxAttempts: job.maxAttempts,
@@ -234,8 +237,9 @@ export async function runPendingJobs(
         });
         const attempts = job.attempts + 1;
         const maxAttempts = job.maxAttempts;
+        const nonRetryable = err instanceof TaskNonRetryableError;
 
-        if (attempts >= maxAttempts) {
+        if (nonRetryable || attempts >= maxAttempts) {
           await db
             .update(commerceJobs)
             .set({

package/src/kernel/jobs/schema.ts

@@ -19,7 +19,7 @@ export const commerceJobs = pgTable("commerce_jobs", {
   input: jsonb("input").notNull().default("{}"),
   output: jsonb("output"),
   status: text("status", {
-    enum: ["pending", "processing", "succeeded", "failed"],
+    enum: ["pending", "processing", "succeeded", "failed", "cancelled"],
   })
     .notNull()
     .default("pending"),

package/src/kernel/jobs/step.ts

@@ -0,0 +1,27 @@
+import { TaskNonRetryableError } from "./types.js";
+import type { TaskStep } from "./types.js";
+
+/**
+ * Pass-through `TaskStep` for pull-based engines with no durable step primitive:
+ * `do` runs `fn` immediately, `sleep` waits in-process. Lets a handler written
+ * against `ctx.step` run unchanged on the drizzle engine.
+ */
+export function createPassThroughTaskStep(): TaskStep {
+  return {
+    async do(_name, fn, options) {
+      try {
+        return await fn();
+      } catch (error) {
+        if (options?.nonRetryable && !(error instanceof TaskNonRetryableError)) {
+          throw new TaskNonRetryableError(
+            error instanceof Error ? error.message : String(error),
+          );
+        }
+        throw error;
+      }
+    },
+    async sleep(_name, ms) {
+      await new Promise<void>((resolve) => setTimeout(resolve, ms));
+    },
+  };
+}

package/src/kernel/jobs/types.ts

@@ -10,8 +10,44 @@ export interface TaskContext {
   logger: Logger;
   db: DrizzleDatabase;
   services: ServiceContainer;
+  /** Durable per-phase execution, backed by the Workflow step on Cloudflare and a
+   * pass-through implementation on the drizzle engine. Absent on engines (pg-boss,
+   * Inngest, Trigger) that have not wired one; a handler that ignores it runs as before. */
+  step?: TaskStep;
 }
 
+/** Durable, idempotent execution of one phase of a task handler. */
+export interface TaskStep {
+  do<T>(
+    name: string,
+    fn: () => Promise<T>,
+    options?: {
+      retries?: TaskRetryConfig;
+      timeout?: number;
+      nonRetryable?: boolean;
+    },
+  ): Promise<T>;
+  sleep(name: string, ms: number): Promise<void>;
+}
+
+/** Thrown by a task handler (or a step's callback) to signal the failure must not be
+ * retried — the Cloudflare engine maps it to `NonRetryableError`; the drizzle runner
+ * fails the job immediately regardless of remaining attempts. */
+export class TaskNonRetryableError extends Error {
+  constructor(message: string) {
+    super(message);
+    this.name = "TaskNonRetryableError";
+  }
+}
+
+export type JobInstanceStatus =
+  | "queued"
+  | "running"
+  | "waiting"
+  | "complete"
+  | "errored"
+  | "terminated";
+
 export interface TaskRetryConfig {
   attempts: number;
   backoff?: { type: "fixed" | "exponential"; delay: number };
@@ -59,6 +95,13 @@ export interface TaskDefinition<
     job?: TaskJobMeta;
   }) => Promise<{ output: TOutput }>;
   retries?: TaskRetryConfig;
+  /** The handler drives its own durable phases through `ctx.step` and keeps every
+   * side effect inside one. A push engine with a step primitive (Cloudflare) then
+   * runs the handler directly — each `ctx.step.do` is a real step with its own
+   * retries and `retries` above is only the per-step default — instead of
+   * wrapping the whole handler in one retried unit; `job.attemptNumber` is then
+   * always 1, because retries happen per step. Pull engines ignore it. */
+  durableSteps?: boolean;
   concurrency?: {
     key: (input: TInput) => string;
     exclusive?: boolean;