@steadlake/run 0.2.1 → 0.3.1

package/README.md

@@ -1,15 +1,239 @@
-# steppler
+# @steadlake/run
 
-To install dependencies:
+Durable task execution for your backend. Define tasks with steps, retries, scheduling, and event-driven workflows — without managing infrastructure.
+
+## Install
 
 ```bash
-bun install
+npm install @steadlake/run
 ```
 
-To run:
+## Setup
 
-```bash
-bun run index.ts
+**Environment variables:**
+
+```
+STEADLAKE_API_KEY=sk_live_...
+STEADLAKE_PROJECT_ID=proj_...
+```
+
+## Quick start
+
+### 1. Define tasks
+
+```ts
+// tasks/send-email.ts
+import { task } from "@steadlake/run";
+import { z } from "zod";
+
+export const sendEmail = task({
+  id: "send-email",
+  schema: z.object({ to: z.string().email(), subject: z.string() }),
+  run: async ({ payload }) => {
+    await emailService.send(payload.to, payload.subject);
+    return { sent: true };
+  },
+});
+```
+
+### 2. Mount the handler
+
+**Next.js**
+```ts
+// app/api/steadlake/route.ts
+import { createNextHandler } from "@steadlake/run/adapters/next";
+import { sendEmail } from "@/tasks/send-email";
+
+export const { POST } = createNextHandler({
+  baseUrl: process.env.APP_URL!,
+  tasks: [sendEmail],
+});
+```
+
+**Hono / Generic**
+```ts
+import { createHandler } from "@steadlake/run/adapters/generic";
+import { sendEmail } from "./tasks/send-email";
+
+const handler = createHandler({
+  baseUrl: process.env.APP_URL!,
+  tasks: [sendEmail],
+});
+
+app.post("/api/steadlake", (c) => handler(c.req.raw));
+```
+
+**Cloudflare Workers**
+```ts
+import { createWorkerHandler } from "@steadlake/run/adapters/worker";
+import { sendEmail } from "./tasks/send-email";
+
+const handler = createWorkerHandler({ tasks: [sendEmail] });
+
+export default {
+  fetch(req: Request, env: Env) {
+    if (new URL(req.url).pathname === "/api/steadlake") {
+      return handler(req, env, env.WORKER_URL);
+    }
+    return app.fetch(req, env);
+  },
+};
+```
+
+### 3. Trigger
+
+```ts
+// anywhere in your server code
+import { sendEmail } from "@/tasks/send-email";
+
+await sendEmail.trigger({ to: "user@example.com", subject: "Welcome!" });
+```
+
+---
+
+## Steps
+
+Break long tasks into named, durable steps. Completed steps are replayed from state on retry — they never re-execute.
+
+```ts
+export const importUsers = task({
+  id: "import-users",
+  run: async ({ payload, step }) => {
+    const users = await step.run("fetch", () => api.getUsers(payload.source));
+    const valid = await step.run("validate", () => users.filter(isValid));
+    await step.run("insert", () => db.users.bulkInsert(valid));
+    return { imported: valid.length };
+  },
+});
+```
+
+### Sleep
+
+```ts
+await step.sleep("wait", "3d");        // duration: ms, s, m, h, d
+await step.sleepUntil("until", date);  // Date | ISO string
+```
+
+### Wait for external event
+
+```ts
+const shipment = await step.waitForEvent<{ trackingId: string }>("shipped", {
+  event: "order.shipped",
+  timeout: "7d",
+});
+```
+
+Resume by calling `run.sendEvent("order.shipped", { trackingId: "..." })`.
+
+### Human approval
+
+```ts
+const { approved } = await step.approve("review", {
+  title: "Approve $10,000 payout?",
+  timeout: "24h",
+});
+```
+
+Resume by calling `client.resolveApproval(runId, stepId, true)`.
+
+### Emit events to other runs
+
+```ts
+step.emit("order.shipped", { trackingId: "TRK123" });
 ```
 
-This project was created using `bun init` in bun v1.3.10. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.
+---
+
+## Retries
+
+```ts
+export const chargeCustomer = task({
+  id: "charge-customer",
+  retry: {
+    maxAttempts: 5,
+    backoff: "exponential", // "exponential" | "linear" | "fixed"
+  },
+  run: async ({ payload }) => {
+    await stripe.charges.create({ amount: payload.amount });
+  },
+});
+```
+
+Throw `FatalError` to fail permanently without retrying. Throw `RetryableError` to retry explicitly.
+
+---
+
+## Cron
+
+```ts
+export const dailyReport = task({
+  id: "daily-report",
+  cron: "0 9 * * 1-5",
+  run: async () => { ... },
+});
+
+// With timezone
+export const digest = task({
+  id: "digest",
+  cron: { pattern: "0 8 * * *", timezone: "America/New_York" },
+  run: async () => { ... },
+});
+```
+
+---
+
+## Queues
+
+```ts
+export const processVideo = task({
+  id: "process-video",
+  queue: {
+    name: "video",
+    concurrencyLimit: 3,
+    rateLimit: { max: 100, duration: "1h" },
+  },
+  run: async ({ payload }) => { ... },
+});
+```
+
+---
+
+## Trigger options
+
+```ts
+await sendEmail.trigger(payload, {
+  idempotencyKey: `email-${userId}`,
+  webhook: "https://myapp.com/webhooks/done",
+  tags: ["transactional"],
+  priority: 10,
+  scheduledAt: new Date(Date.now() + 60_000).toISOString(),
+});
+```
+
+Wait for result:
+
+```ts
+const result = await sendEmail.triggerAndWait(payload, { timeoutMs: 30_000 });
+console.log(result.status); // "success" | "failed"
+console.log(result.result);
+```
+
+---
+
+## Error types
+
+| | HTTP | DEW behaviour |
+|---|---|---|
+| `FatalError` | 400 | Permanent failure, no retry |
+| `RetryableError` | 500 | Explicit retry request |
+| Any other error | 500 | Retry if attempts remain |
+
+---
+
+## Environment variables
+
+| Variable | Description |
+|---|---|
+| `STEADLAKE_API_KEY` | Your project API key |
+| `STEADLAKE_PROJECT_ID` | Your project ID |
+| `STEADLAKE_API_URL` | Override platform URL (self-hosted) |

package/dist/adapters/generic.d.ts

@@ -1,3 +1,24 @@
 import type { Steadlake } from "../client.js";
-export declare function createHandler(client: Steadlake): (req: Request) => Promise<Response>;
+import type { Task } from "../types.js";
+export interface HandlerOptions {
+    baseUrl: string;
+    tasks?: Task<unknown, unknown>[];
+}
+/**
+ * Creates a generic fetch handler compatible with any framework that uses
+ * the standard Web API Request/Response interface (Hono, Fastify, Express, etc).
+ *
+ * @example
+ * // Hono
+ * import { createHandler } from '@steadlake/run/adapters/generic'
+ * import { sendEmail } from './tasks/send-email'
+ *
+ * const dewHandler = createHandler({
+ *   baseUrl: process.env.APP_URL!,
+ *   tasks: [sendEmail],
+ * })
+ *
+ * app.post('/api/steadlake', (c) => dewHandler(c.req.raw))
+ */
+export declare function createHandler(clientOrOptions: Steadlake | HandlerOptions, options?: HandlerOptions): (req: Request) => Promise<Response>;
 //# sourceMappingURL=generic.d.ts.map

package/dist/adapters/generic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../src/adapters/generic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,uCAG9C"}
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../src/adapters/generic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,WAAW,cAAc;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,eAAe,EAAE,SAAS,GAAG,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,uCAWlG"}

package/dist/adapters/generic.js

@@ -1,5 +1,28 @@
-import { registerWithRetry } from "./register.js";
-export function createHandler(client) {
-    registerWithRetry(client);
-    return client._createHandler();
+import { getDefaultClient } from "../default.js";
+import { registerWithRetry } from "./utils/register.js";
+/**
+ * Creates a generic fetch handler compatible with any framework that uses
+ * the standard Web API Request/Response interface (Hono, Fastify, Express, etc).
+ *
+ * @example
+ * // Hono
+ * import { createHandler } from '@steadlake/run/adapters/generic'
+ * import { sendEmail } from './tasks/send-email'
+ *
+ * const dewHandler = createHandler({
+ *   baseUrl: process.env.APP_URL!,
+ *   tasks: [sendEmail],
+ * })
+ *
+ * app.post('/api/steadlake', (c) => dewHandler(c.req.raw))
+ */
+export function createHandler(clientOrOptions, options) {
+    const isClient = clientOrOptions instanceof Object && "_registry" in clientOrOptions;
+    const c = isClient ? clientOrOptions : getDefaultClient();
+    const opts = isClient ? options : clientOrOptions;
+    for (const task of opts.tasks ?? []) {
+        c._registry.set(task.id, task);
+    }
+    registerWithRetry(c, opts.baseUrl);
+    return c._createHandler();
 }

package/dist/adapters/next.d.ts

@@ -1,5 +1,24 @@
 import type { Steadlake } from "../client.js";
-export declare function createNextHandler(client: Steadlake): {
+import type { Task } from "../types.js";
+export interface NextHandlerOptions {
+    baseUrl: string;
+    tasks?: Task<unknown, unknown>[];
+}
+/**
+ * Creates a route handler for Next.js App Router.
+ *
+ * @example
+ * // app/api/steadlake/route.ts
+ * import { createNextHandler } from '@steadlake/run/adapters/next'
+ * import { sendEmail } from './tasks/send-email'
+ * import { processOrder } from './tasks/process-order'
+ *
+ * export const { POST } = createNextHandler({
+ *   baseUrl: process.env.APP_URL!,
+ *   tasks: [sendEmail, processOrder],
+ * })
+ */
+export declare function createNextHandler(clientOrOptions: Steadlake | NextHandlerOptions, options?: NextHandlerOptions): {
     POST: (req: Request) => Promise<Response>;
 };
 //# sourceMappingURL=next.d.ts.map

package/dist/adapters/next.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/adapters/next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAG9C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS;gBAG7B,OAAO;EAC5B"}
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/adapters/next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,eAAe,EAAE,SAAS,GAAG,kBAAkB,EAAE,OAAO,CAAC,EAAE,kBAAkB;gBAWzF,OAAO;EAC5B"}

package/dist/adapters/next.js

@@ -1,6 +1,27 @@
-import { registerWithRetry } from "./register.js";
-export function createNextHandler(client) {
-    registerWithRetry(client);
-    const handle = client._createHandler();
+import { getDefaultClient } from "../default.js";
+import { registerWithRetry } from "./utils/register.js";
+/**
+ * Creates a route handler for Next.js App Router.
+ *
+ * @example
+ * // app/api/steadlake/route.ts
+ * import { createNextHandler } from '@steadlake/run/adapters/next'
+ * import { sendEmail } from './tasks/send-email'
+ * import { processOrder } from './tasks/process-order'
+ *
+ * export const { POST } = createNextHandler({
+ *   baseUrl: process.env.APP_URL!,
+ *   tasks: [sendEmail, processOrder],
+ * })
+ */
+export function createNextHandler(clientOrOptions, options) {
+    const isClient = clientOrOptions instanceof Object && "_registry" in clientOrOptions;
+    const c = isClient ? clientOrOptions : getDefaultClient();
+    const opts = isClient ? options : clientOrOptions;
+    for (const task of opts.tasks ?? []) {
+        c._registry.set(task.id, task);
+    }
+    registerWithRetry(c, opts.baseUrl);
+    const handle = c._createHandler();
     return { POST: (req) => handle(req) };
 }

package/dist/adapters/utils/register.d.ts

@@ -0,0 +1,3 @@
+import type { Steadlake } from "../../client.js";
+export declare function registerWithRetry(client: Steadlake, baseUrl?: string, attempts?: number): Promise<void>;
+//# sourceMappingURL=register.d.ts.map

package/dist/adapters/utils/register.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../../src/adapters/utils/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,SAAI,iBAoBxF"}

package/dist/adapters/{register.js → utils/register.js}

@@ -1,7 +1,7 @@
-export async function registerWithRetry(client, attempts = 3) {
+export async function registerWithRetry(client, baseUrl, attempts = 3) {
     for (let i = 1; i <= attempts; i++) {
         try {
-            await client._autoRegister();
+            await client._autoRegister(baseUrl);
             return;
         }
         catch (err) {

package/dist/adapters/worker.d.ts

@@ -0,0 +1,31 @@
+import { Steadlake } from "../client.js";
+import type { Task } from "../types.js";
+export interface WorkerEnv {
+    STEADLAKE_API_KEY: string;
+    STEADLAKE_PROJECT_ID: string;
+    STEADLAKE_API_URL?: string;
+}
+export interface WorkerHandlerOptions {
+    tasks?: Task<unknown, unknown>[];
+}
+/**
+ * Creates a handler for Cloudflare Workers.
+ * Reads STEADLAKE_API_KEY, STEADLAKE_PROJECT_ID from worker env bindings.
+ *
+ * @example
+ * import { createWorkerHandler } from '@steadlake/run/adapters/worker'
+ * import { sendEmail } from './tasks/send-email'
+ *
+ * const dewHandler = createWorkerHandler({ tasks: [sendEmail] })
+ *
+ * export default {
+ *   fetch(req: Request, env: Env) {
+ *     if (new URL(req.url).pathname === '/api/steadlake') {
+ *       return dewHandler(req, env, env.WORKER_URL)
+ *     }
+ *     return app.fetch(req, env)
+ *   }
+ * }
+ */
+export declare function createWorkerHandler<TEnv extends WorkerEnv>(clientOrOptions?: Steadlake | WorkerHandlerOptions): (req: Request, env: TEnv, baseUrl: string) => Promise<Response>;
+//# sourceMappingURL=worker.d.ts.map

package/dist/adapters/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/adapters/worker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,MAAM,WAAW,SAAS;IACzB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB;IACpC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,SAAS,SAAS,EACzD,eAAe,CAAC,EAAE,SAAS,GAAG,oBAAoB,IAEpC,KAAK,OAAO,EAAE,KAAK,IAAI,EAAE,SAAS,MAAM,KAAG,OAAO,CAAC,QAAQ,CAAC,CAoB1E"}

package/dist/adapters/worker.js

@@ -0,0 +1,41 @@
+import { Steadlake } from "../client.js";
+import { configure, getDefaultClient } from "../default.js";
+import { registerWithRetry } from "./utils/register.js";
+/**
+ * Creates a handler for Cloudflare Workers.
+ * Reads STEADLAKE_API_KEY, STEADLAKE_PROJECT_ID from worker env bindings.
+ *
+ * @example
+ * import { createWorkerHandler } from '@steadlake/run/adapters/worker'
+ * import { sendEmail } from './tasks/send-email'
+ *
+ * const dewHandler = createWorkerHandler({ tasks: [sendEmail] })
+ *
+ * export default {
+ *   fetch(req: Request, env: Env) {
+ *     if (new URL(req.url).pathname === '/api/steadlake') {
+ *       return dewHandler(req, env, env.WORKER_URL)
+ *     }
+ *     return app.fetch(req, env)
+ *   }
+ * }
+ */
+export function createWorkerHandler(clientOrOptions) {
+    return async (req, env, baseUrl) => {
+        const isClient = clientOrOptions instanceof Steadlake;
+        const c = isClient ? clientOrOptions : getDefaultClient();
+        const opts = isClient ? undefined : clientOrOptions;
+        if (!isClient) {
+            configure({
+                apiKey: env.STEADLAKE_API_KEY,
+                projectId: env.STEADLAKE_PROJECT_ID,
+                apiUrl: env.STEADLAKE_API_URL,
+            });
+        }
+        for (const task of opts?.tasks ?? []) {
+            c._registry.set(task.id, task);
+        }
+        await registerWithRetry(c, baseUrl);
+        return c._createHandler()(req);
+    };
+}

package/dist/client.d.ts

@@ -3,7 +3,6 @@ import type { Task, TaskConfig } from "./types.js";
 export declare class Steadlake {
     _registry: Map<string, Task<unknown, unknown>>;
     _client: SteadlakeClient;
-    _signingSecret?: string;
     _projectId: string;
     _apiUrl?: string;
     _apiKey: string;
@@ -12,15 +11,14 @@ export declare class Steadlake {
     constructor(config?: {
         apiKey?: string;
         apiUrl?: string;
-        signingSecret?: string;
         projectId?: string;
     });
     task<TPayload = unknown, TResult = unknown>(config: TaskConfig<TPayload, TResult>): Task<TPayload, TResult>;
     sendEvent(runId: string, event: string, data?: unknown): Promise<void>;
     resolveApproval(runId: string, stepId: string, approved: boolean, approvedBy?: string): Promise<void>;
     _api(method: string, path: string, body?: unknown): Promise<unknown>;
-    _autoRegister(): Promise<void>;
-    init(): Promise<void>;
+    _autoRegister(baseUrl?: string): Promise<void>;
+    init(baseUrl?: string): Promise<void>;
     _createHandler(): (req: Request) => Promise<Response>;
 }
 //# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG/D,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGnD,qBAAa,SAAS;IACrB,SAAS,sCAA6C;IACtD,OAAO,EAAE,eAAe,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAQ;IAC/C,qBAAqB,UAAS;gBAElB,MAAM,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;QACvB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB;IA6BD,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACzC,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,GACnC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC;IAMpB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAcpE,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IA2D9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3B,cAAc;CAGd"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAG/D,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAGnD,qBAAa,SAAS;IACrB,SAAS,sCAA6C;IACtD,OAAO,EAAE,eAAe,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAQ;IAC/C,qBAAqB,UAAS;gBAElB,MAAM,CAAC,EAAE;QACpB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,CAAC;KACnB;IAsBD,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACzC,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,GACnC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC;IAMpB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAcpE,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4D9C,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,cAAc;CAGd"}

package/dist/client.js

@@ -4,7 +4,6 @@ import { createTask } from "./task.js";
 export class Steadlake {
     _registry = new Map();
     _client;
-    _signingSecret;
     _projectId;
     _apiUrl;
     _apiKey;
@@ -13,7 +12,6 @@ export class Steadlake {
     constructor(config) {
         const apiKey = config?.apiKey ?? process.env.STEADLAKE_API_KEY ?? "";
         const apiUrl = config?.apiUrl ?? process.env.STEADLAKE_API_URL;
-        const signingSecret = config?.signingSecret ?? process.env.STEADLAKE_SIGNING_SECRET;
         const projectId = config?.projectId ?? process.env.STEADLAKE_PROJECT_ID ?? "";
         if (!apiKey) {
             console.warn("[steadlake] No API key set — provide apiKey or set STEADLAKE_API_KEY");
@@ -21,12 +19,8 @@ export class Steadlake {
         if (!projectId) {
             console.warn("[steadlake] No project ID set — provide projectId or set STEADLAKE_PROJECT_ID");
         }
-        if (!signingSecret) {
-            console.warn("[steadlake] No signing secret set — requests from DEW will not be verified. Set STEADLAKE_SIGNING_SECRET in production.");
-        }
         this._apiKey = apiKey;
         this._apiUrl = apiUrl;
-        this._signingSecret = signingSecret;
         this._projectId = projectId;
         this._client = new SteadlakeClient({
             bearerAuth: apiKey,
@@ -58,7 +52,7 @@ export class Steadlake {
             throw new Error(`API ${method} ${path} failed: ${res.status}`);
         return res.json();
     }
-    async _autoRegister() {
+    async _autoRegister(baseUrl) {
         if (!this._projectId) {
             console.warn("[steadlake] No projectId set — skipping auto-registration");
             return;
@@ -103,16 +97,17 @@ export class Steadlake {
             });
             await this._client.triggers.register({
                 projectId: this._projectId,
+                ...(baseUrl ? { apiUrl: baseUrl } : {}),
                 triggers,
             });
             this._registrationComplete = true;
         })();
         await this._registrationLock;
     }
-    async init() {
-        await this._autoRegister();
+    async init(baseUrl) {
+        await this._autoRegister(baseUrl);
     }
     _createHandler() {
-        return createHandler(this._registry, this._signingSecret);
+        return createHandler(this._registry);
     }
 }

package/dist/default.d.ts

@@ -0,0 +1,6 @@
+import { Steadlake } from "./client.js";
+import type { TaskConfig, Task } from "./types.js";
+export declare function getDefaultClient(): Steadlake;
+export declare function configure(config: ConstructorParameters<typeof Steadlake>[0]): void;
+export declare function task<TPayload = unknown, TResult = unknown>(config: TaskConfig<TPayload, TResult>): Task<TPayload, TResult>;
+//# sourceMappingURL=default.d.ts.map

package/dist/default.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"default.d.ts","sourceRoot":"","sources":["../src/default.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAInD,wBAAgB,gBAAgB,IAAI,SAAS,CAG5C;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,qBAAqB,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAElF;AAED,wBAAgB,IAAI,CAAC,QAAQ,GAAG,OAAO,EAAE,OAAO,GAAG,OAAO,EACzD,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,GACnC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAEzB"}

package/dist/default.js

@@ -0,0 +1,13 @@
+import { Steadlake } from "./client.js";
+let _default = null;
+export function getDefaultClient() {
+    if (!_default)
+        _default = new Steadlake();
+    return _default;
+}
+export function configure(config) {
+    _default = new Steadlake(config);
+}
+export function task(config) {
+    return getDefaultClient().task(config);
+}

package/dist/handler.d.ts

@@ -1,3 +1,3 @@
 import type { Task } from "./types.js";
-export declare function createHandler(registry: Map<string, Task<unknown, unknown>>, signingSecret?: string): (req: Request) => Promise<Response>;
+export declare function createHandler(registry: Map<string, Task<unknown, unknown>>): (req: Request) => Promise<Response>;
 //# sourceMappingURL=handler.d.ts.map

package/dist/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAoB,MAAM,YAAY,CAAC;AAEzD,wBAAgB,aAAa,CAC5B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,EAC7C,aAAa,CAAC,EAAE,MAAM,IAEO,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CA0E7D"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAoB,MAAM,YAAY,CAAC;AAEzD,wBAAgB,aAAa,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,IAC7C,KAAK,OAAO,KAAG,OAAO,CAAC,QAAQ,CAAC,CAkE7D"}

package/dist/handler.js

@@ -1,16 +1,8 @@
-import { createHmac } from "node:crypto";
 import { FatalError, RetryableError } from "./errors.js";
 import { createStepHelpers } from "./step.js";
-export function createHandler(registry, signingSecret) {
+export function createHandler(registry) {
     return async function handle(req) {
         const body = await req.text();
-        if (signingSecret) {
-            const signature = req.headers.get("X-Steadlake-Signature");
-            const expected = `sha256=${sign(body, signingSecret)}`;
-            if (signature !== expected) {
-                return new Response("Unauthorized", { status: 401 });
-            }
-        }
         let parsed;
         try {
             parsed = JSON.parse(body);
@@ -59,6 +51,3 @@ export function createHandler(registry, signingSecret) {
 function isSuspension(err) {
     return typeof err === "object" && err !== null && "__steadlake_suspend" in err;
 }
-function sign(body, secret) {
-    return createHmac("sha256", secret).update(body).digest("hex");
-}

package/dist/index.d.ts

@@ -1,6 +1,7 @@
 export { createHandler } from "./adapters/generic.js";
 export { createNextHandler } from "./adapters/next.js";
 export { Steadlake } from "./client.js";
+export { task, configure, getDefaultClient } from "./default.js";
 export { FatalError, RetryableError, SteadlakeError } from "./errors.js";
 export type { Run, RunContext, RunResult, RunStatus, StepHelpers, SuspendReason, SuspensionSignal, Task, TaskConfig, TaskHooks, TriggerOptions, } from "./types.js";
 //# 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":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EACX,GAAG,EACH,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,SAAS,EACT,cAAc,GACd,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EACX,GAAG,EACH,UAAU,EACV,SAAS,EACT,SAAS,EACT,WAAW,EACX,aAAa,EACb,gBAAgB,EAChB,IAAI,EACJ,UAAU,EACV,SAAS,EACT,cAAc,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,4 +1,5 @@
 export { createHandler } from "./adapters/generic.js";
 export { createNextHandler } from "./adapters/next.js";
 export { Steadlake } from "./client.js";
+export { task, configure, getDefaultClient } from "./default.js";
 export { FatalError, RetryableError, SteadlakeError } from "./errors.js";

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@steadlake/run",
-	"version": "0.2.1",
+	"version": "0.3.1",
 	"description": "Durable task execution SDK for Steadlake — define tasks with steps, retries, scheduling, and event-driven workflows.",
 	"files": [
 		"dist"
@@ -13,13 +13,17 @@
 			"import": "./dist/index.js",
 			"types": "./dist/index.d.ts"
 		},
-		"./next": {
+		"./adapters/next": {
 			"import": "./dist/adapters/next.js",
 			"types": "./dist/adapters/next.d.ts"
 		},
-		"./handler": {
+		"./adapters/generic": {
 			"import": "./dist/adapters/generic.js",
 			"types": "./dist/adapters/generic.d.ts"
+		},
+		"./adapters/worker": {
+			"import": "./dist/adapters/worker.js",
+			"types": "./dist/adapters/worker.d.ts"
 		}
 	},
 	"publishConfig": {
@@ -29,13 +33,17 @@
 		"build": "tsc",
 		"dev": "tsc --watch",
 		"format": "oxfmt .",
-		"format:check": "oxfmt --check ."
+		"format:check": "oxfmt --check .",
+		"changeset": "changeset",
+		"version": "changeset version",
+		"release": "npm run build && changeset publish"
 	},
 	"dependencies": {
 		"@steadlake/core": "^0.3.2",
 		"oxfmt": "^0.44.0"
 	},
 	"devDependencies": {
+		"@changesets/cli": "^2.27.12",
 		"@types/node": "^25.9.3",
 		"typescript": "^6.0.3"
 	}

package/dist/adapters/register.d.ts

@@ -1,3 +0,0 @@
-import type { Steadlake } from "../client.js";
-export declare function registerWithRetry(client: Steadlake, attempts?: number): Promise<void>;
-//# sourceMappingURL=register.d.ts.map

package/dist/adapters/register.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"register.d.ts","sourceRoot":"","sources":["../../src/adapters/register.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9C,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,SAAI,iBAoBtE"}