steppler 0.0.1 → 0.1.1

package/README.md

@@ -0,0 +1,15 @@
+# steppler
+
+To install dependencies:
+
+```bash
+bun install
+```
+
+To run:
+
+```bash
+bun run index.ts
+```
+
+This project was created using `bun init` in bun v1.3.10. [Bun](https://bun.com) is a fast all-in-one JavaScript runtime.

package/dist/adapters/generic.d.ts

@@ -0,0 +1,3 @@
+import type { Steppler } from "../client.js";
+export declare function createHandler(client: Steppler): (req: Request) => Promise<Response>;
+//# sourceMappingURL=generic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generic.d.ts","sourceRoot":"","sources":["../../src/adapters/generic.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,wBAAgB,aAAa,CAAC,MAAM,EAAE,QAAQ,uCAK7C"}

package/dist/adapters/generic.js

@@ -0,0 +1,7 @@
+export function createHandler(client) {
+    client._autoRegister().catch((err) => {
+        console.error("[steppler] Auto-registration failed:", err);
+    });
+    return client._createHandler();
+}
+//# sourceMappingURL=generic.js.map

package/dist/adapters/generic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generic.js","sourceRoot":"","sources":["../../src/adapters/generic.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,aAAa,CAAC,MAAgB;IAC7C,MAAM,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACpC,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC,cAAc,EAAE,CAAC;AAChC,CAAC"}

package/dist/adapters/next.d.ts

@@ -0,0 +1,5 @@
+import type { Steppler } from "../client.js";
+export declare function createNextHandler(client: Steppler): {
+    POST: (req: Request) => Promise<Response>;
+};
+//# sourceMappingURL=next.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/adapters/next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,QAAQ;gBAOpC,OAAO;EAEpB"}

package/dist/adapters/next.js

@@ -0,0 +1,10 @@
+export function createNextHandler(client) {
+    client._autoRegister().catch((err) => {
+        console.error("[steppler] Auto-registration failed:", err);
+    });
+    const handle = client._createHandler();
+    return {
+        POST: (req) => handle(req),
+    };
+}
+//# sourceMappingURL=next.js.map

package/dist/adapters/next.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.js","sourceRoot":"","sources":["../../src/adapters/next.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,MAAgB;IACjD,MAAM,CAAC,aAAa,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;QACpC,OAAO,CAAC,KAAK,CAAC,sCAAsC,EAAE,GAAG,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc,EAAE,CAAC;IACvC,OAAO;QACN,IAAI,EAAE,CAAC,GAAY,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC;KACnC,CAAC;AACH,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,18 @@
+import { Steppler as StepplerClient } from "@steppler/api";
+import type { Task, TaskConfig } from "./types.js";
+export declare class Steppler {
+    _registry: Map<string, Task<unknown, unknown>>;
+    _client: StepplerClient;
+    _signingSecret?: string;
+    _projectId: string;
+    constructor(config?: {
+        apiKey?: string;
+        apiUrl?: string;
+        signingSecret?: string;
+        projectId?: string;
+    });
+    task<TPayload = unknown, TResult = unknown>(config: TaskConfig<TPayload, TResult>): Task<TPayload, TResult>;
+    _autoRegister(): Promise<void>;
+    _createHandler(): (req: Request) => Promise<Response>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAG3D,OAAO,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,QAAQ;IACpB,SAAS,sCAA6C;IACtD,OAAO,EAAE,cAAc,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;gBAEP,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;IAiBD,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,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAsCpC,cAAc;CAGd"}

package/dist/client.js

@@ -0,0 +1,64 @@
+import { Steppler as StepplerClient } from "@steppler/api";
+import { createHandler } from "./handler.js";
+import { createTask } from "./task.js";
+export class Steppler {
+    _registry = new Map();
+    _client;
+    _signingSecret;
+    _projectId;
+    constructor(config) {
+        const apiKey = config?.apiKey ?? process.env.STEPPLER_API_KEY ?? "";
+        const apiUrl = config?.apiUrl ?? process.env.STEPPLER_API_URL;
+        const signingSecret = config?.signingSecret ?? process.env.STEPPLER_SIGNING_SECRET;
+        const projectId = config?.projectId ?? process.env.STEPPLER_PROJECT_ID ?? "";
+        this._signingSecret = signingSecret;
+        this._projectId = projectId;
+        this._client = new StepplerClient({
+            bearerAuth: apiKey,
+            ...(apiUrl ? { serverURL: apiUrl } : {}),
+        });
+    }
+    task(config) {
+        const t = createTask(config, this._client);
+        this._registry.set(config.id, t);
+        return t;
+    }
+    async _autoRegister() {
+        if (!this._projectId) {
+            console.warn("[steppler] No projectId set — skipping auto-registration");
+            return;
+        }
+        const triggers = Array.from(this._registry.values()).map((task) => ({
+            handler: task._config.id,
+            name: task._config.id,
+            type: (task._config.cron ? "cron" : "manual"),
+            config: {
+                ...(task._config.queue ? { queue: task._config.queue } : {}),
+                ...(task._config.retry
+                    ? {
+                        retry: {
+                            ...task._config.retry,
+                            backoff: task._config.retry.backoff ?? "exponential",
+                        },
+                    }
+                    : {}),
+                ...(task._config.cron
+                    ? {
+                        cron: typeof task._config.cron === "string"
+                            ? { pattern: task._config.cron }
+                            : task._config.cron,
+                    }
+                    : {}),
+                ...(task._config.timeout ? { timeout: task._config.timeout } : {}),
+            },
+        }));
+        await this._client.triggers.register({
+            projectId: this._projectId,
+            triggers,
+        });
+    }
+    _createHandler() {
+        return createHandler(this._registry, this._signingSecret);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,MAAM,OAAO,QAAQ;IACpB,SAAS,GAAG,IAAI,GAAG,EAAkC,CAAC;IACtD,OAAO,CAAiB;IACxB,cAAc,CAAU;IACxB,UAAU,CAAS;IAEnB,YAAY,MAKX;QACA,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,EAAE,CAAC;QACpE,MAAM,MAAM,GAAG,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;QAC9D,MAAM,aAAa,GAClB,MAAM,EAAE,aAAa,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC;QAC9D,MAAM,SAAS,GACd,MAAM,EAAE,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,CAAC;QAE5D,IAAI,CAAC,cAAc,GAAG,aAAa,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAE5B,IAAI,CAAC,OAAO,GAAG,IAAI,cAAc,CAAC;YACjC,UAAU,EAAE,MAAM;YAClB,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxC,CAAC,CAAC;IACJ,CAAC;IAED,IAAI,CACH,MAAqC;QAErC,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAA2B,CAAC,CAAC;QAC3D,OAAO,CAAC,CAAC;IACV,CAAC;IAED,KAAK,CAAC,aAAa;QAClB,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,IAAI,CAAC,0DAA0D,CAAC,CAAC;YACzE,OAAO;QACR,CAAC;QAED,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACnE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;YACxB,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE;YACrB,IAAI,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAsB;YAClE,MAAM,EAAE;gBACP,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC5D,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK;oBACrB,CAAC,CAAC;wBACA,KAAK,EAAE;4BACN,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK;4BACrB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,IAAI,aAAa;yBACpD;qBACD;oBACF,CAAC,CAAC,EAAE,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI;oBACpB,CAAC,CAAC;wBACA,IAAI,EACH,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ;4BACpC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE;4BAChC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI;qBACrB;oBACF,CAAC,CAAC,EAAE,CAAC;gBACN,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClE;SACD,CAAC,CAAC,CAAC;QAEJ,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACpC,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,QAAQ;SACR,CAAC,CAAC;IACJ,CAAC;IAED,cAAc;QACb,OAAO,aAAa,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,cAAc,CAAC,CAAC;IAC3D,CAAC;CACD"}

package/dist/errors.d.ts

@@ -0,0 +1,7 @@
+export declare class FatalError extends Error {
+    constructor(message: string);
+}
+export declare class StepplerError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI3B;AAED,qBAAa,aAAc,SAAQ,KAAK;gBAC3B,OAAO,EAAE,MAAM;CAI3B"}

package/dist/errors.js

@@ -0,0 +1,13 @@
+export class FatalError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FatalError";
+    }
+}
+export class StepplerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "StepplerError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IACpC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC1B,CAAC;CACD;AAED,MAAM,OAAO,aAAc,SAAQ,KAAK;IACvC,YAAY,OAAe;QAC1B,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC7B,CAAC;CACD"}

package/dist/handler.d.ts

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

package/dist/handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAEvC,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,CA4F7D"}

package/dist/handler.js

@@ -0,0 +1,75 @@
+import { createHmac } from "crypto";
+import { FatalError } from "./errors.js";
+import { createStepHelpers } from "./step.js";
+export function createHandler(registry, signingSecret) {
+    return async function handle(req) {
+        // Verify signature
+        const body = await req.text();
+        if (signingSecret) {
+            const signature = req.headers.get("X-Steppler-Signature");
+            const expected = `sha256=${sign(body, signingSecret)}`;
+            if (signature !== expected) {
+                return new Response("Unauthorized", { status: 401 });
+            }
+        }
+        let parsed;
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch {
+            return new Response("Invalid JSON body", { status: 400 });
+        }
+        const { runId, handler, payload, attempt = 1, state = {} } = parsed;
+        // Find task in registry
+        const task = registry.get(handler);
+        if (!task) {
+            return new Response(`No handler registered for "${handler}"`, {
+                status: 404,
+            });
+        }
+        // Validate payload with zod schema if present
+        if (task._config.schema) {
+            const result = task._config.schema.safeParse(payload);
+            if (!result.success) {
+                return new Response(JSON.stringify({
+                    error: "Payload validation failed",
+                    issues: result.error.issues,
+                }), { status: 400, headers: { "Content-Type": "application/json" } });
+            }
+        }
+        // Build step helpers
+        const pendingEvents = [];
+        const step = createStepHelpers(state, pendingEvents);
+        try {
+            const result = await task._config.run({ payload, runId, attempt, step });
+            return Response.json({
+                result,
+                events: pendingEvents,
+            }, { status: 200 });
+        }
+        catch (err) {
+            // Suspension signal from step.sleep()
+            if (typeof err === "object" &&
+                err !== null &&
+                "__steppler_suspend" in err) {
+                const suspension = err;
+                return Response.json({
+                    suspend: true,
+                    resumeAt: suspension.resumeAt,
+                    events: pendingEvents,
+                }, { status: 202 });
+            }
+            // Fatal error — 4xx, no retry
+            if (err instanceof FatalError) {
+                return new Response(err.message, { status: 400 });
+            }
+            // Everything else — 5xx, DEW will retry
+            const message = err instanceof Error ? err.message : String(err);
+            return new Response(message, { status: 500 });
+        }
+    };
+}
+function sign(body, secret) {
+    return createHmac("sha256", secret).update(body).digest("hex");
+}
+//# sourceMappingURL=handler.js.map

package/dist/handler.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { createHandler } from "./adapters/generic.js";
+export { createNextHandler } from "./adapters/next.js";
+export { Steppler } from "./client.js";
+export { FatalError } from "./errors.js";
+export type { Run, RunContext, RunResult, StepHelpers, Task, TaskConfig, TriggerOptions, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +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,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EACX,GAAG,EACH,UAAU,EACV,SAAS,EACT,WAAW,EACX,IAAI,EACJ,UAAU,EACV,cAAc,GACd,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createHandler } from "./adapters/generic.js";
+export { createNextHandler } from "./adapters/next.js";
+export { Steppler } from "./client.js";
+export { FatalError } from "./errors.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC"}

package/dist/step.d.ts

@@ -0,0 +1,7 @@
+import type { StepHelpers } from "./types.js";
+export type PendingEvent = {
+    type: string;
+    metadata: Record<string, unknown>;
+};
+export declare function createStepHelpers(state: Record<string, unknown>, pendingEvents: PendingEvent[]): StepHelpers;
+//# sourceMappingURL=step.d.ts.map

package/dist/step.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.d.ts","sourceRoot":"","sources":["../src/step.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC;AAEF,wBAAgB,iBAAiB,CAChC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,aAAa,EAAE,YAAY,EAAE,GAC3B,WAAW,CA0Bb"}

package/dist/step.js

@@ -0,0 +1,39 @@
+export function createStepHelpers(state, pendingEvents) {
+    return {
+        async run(id, fn) {
+            if (id in state) {
+                return state[id];
+            }
+            pendingEvents.push({ type: "step_started", metadata: { step: id } });
+            const output = await fn();
+            pendingEvents.push({
+                type: "step_completed",
+                metadata: { step: id, output },
+            });
+            return output;
+        },
+        async sleep(id, duration) {
+            if (id in state)
+                return;
+            const ms = parseDuration(duration);
+            const resumeAt = new Date(Date.now() + ms).toISOString();
+            throw { __steppler_suspend: true, resumeAt, step: id };
+        },
+    };
+}
+function parseDuration(duration) {
+    const units = {
+        ms: 1,
+        s: 1000,
+        m: 60_000,
+        h: 3_600_000,
+        d: 86_400_000,
+    };
+    const match = duration.match(/^(\d+)(ms|s|m|h|d)$/);
+    if (!match)
+        throw new Error(`Invalid duration format: "${duration}". Use e.g. "30s", "5m", "2h"`);
+    const value = parseInt(match[1], 10);
+    const unit = match[2];
+    return value * units[unit];
+}
+//# sourceMappingURL=step.js.map

package/dist/step.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step.js","sourceRoot":"","sources":["../src/step.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,iBAAiB,CAChC,KAA8B,EAC9B,aAA6B;IAE7B,OAAO;QACN,KAAK,CAAC,GAAG,CAAI,EAAU,EAAE,EAAoB;YAC5C,IAAI,EAAE,IAAI,KAAK,EAAE,CAAC;gBACjB,OAAO,KAAK,CAAC,EAAE,CAAM,CAAC;YACvB,CAAC;YAED,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YACrE,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;YAC1B,aAAa,CAAC,IAAI,CAAC;gBAClB,IAAI,EAAE,gBAAgB;gBACtB,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE;aAC9B,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QACf,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,EAAU,EAAE,QAAgB;YACvC,IAAI,EAAE,IAAI,KAAK;gBAAE,OAAO;YAExB,MAAM,EAAE,GAAG,aAAa,CAAC,QAAQ,CAAC,CAAC;YACnC,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAEzD,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QACxD,CAAC;KACD,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACtC,MAAM,KAAK,GAA2B;QACrC,EAAE,EAAE,CAAC;QACL,CAAC,EAAE,IAAI;QACP,CAAC,EAAE,MAAM;QACT,CAAC,EAAE,SAAS;QACZ,CAAC,EAAE,UAAU;KACb,CAAC;IAEF,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK;QACT,MAAM,IAAI,KAAK,CACd,6BAA6B,QAAQ,+BAA+B,CACpE,CAAC;IAEH,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAuB,CAAC;IAE5C,OAAO,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC"}

package/dist/task.d.ts

@@ -0,0 +1,4 @@
+import type { Steppler as StepplerClient } from "@steppler/api";
+import type { Task, TaskConfig } from "./types.js";
+export declare function createTask<TPayload, TResult>(config: TaskConfig<TPayload, TResult>, client: StepplerClient): Task<TPayload, TResult>;
+//# sourceMappingURL=task.d.ts.map

package/dist/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,KAAK,EAGX,IAAI,EACJ,UAAU,EAEV,MAAM,YAAY,CAAC;AAMpB,wBAAgB,UAAU,CAAC,QAAQ,EAAE,OAAO,EAC3C,MAAM,EAAE,UAAU,CAAC,QAAQ,EAAE,OAAO,CAAC,EACrC,MAAM,EAAE,cAAc,GACpB,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAsDzB"}

package/dist/task.js

@@ -0,0 +1,46 @@
+function sleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+export function createTask(config, client) {
+    return {
+        id: config.id,
+        _config: config,
+        async trigger(payload, options = {}) {
+            const validated = config.schema ? config.schema.parse(payload) : payload;
+            const run = await client.runs.create({
+                triggerId: config.id,
+                payload: validated,
+                idempotencyKey: options.idempotencyKey,
+                webhook: options.webhook,
+                tags: options.tags,
+                priority: options.priority,
+                scheduledAt: options.scheduledAt
+                    ? new Date(options.scheduledAt)
+                    : undefined,
+            });
+            return {
+                id: run.id,
+                status: run.status,
+                triggerId: run.triggerId,
+                createdAt: run.createdAt,
+            };
+        },
+        async triggerAndWait(payload, options = {}) {
+            const run = await this.trigger(payload, options);
+            while (true) {
+                const status = await client.runs.status({ id: run.id });
+                if (status.status === "success" || status.status === "failed") {
+                    return {
+                        id: status.id,
+                        status: status.status,
+                        result: status.result,
+                        error: status.error,
+                        finishedAt: status.finishedAt ?? null,
+                    };
+                }
+                await sleep(1000);
+            }
+        },
+    };
+}
+//# sourceMappingURL=task.js.map

package/dist/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../src/task.ts"],"names":[],"mappings":"AASA,SAAS,KAAK,CAAC,EAAU;IACxB,OAAO,IAAI,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,UAAU,CACzB,MAAqC,EACrC,MAAsB;IAEtB,OAAO;QACN,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,OAAO,EAAE,MAAM;QAEf,KAAK,CAAC,OAAO,CACZ,OAAiB,EACjB,UAA0B,EAAE;YAE5B,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAEzE,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC;gBACpC,SAAS,EAAE,MAAM,CAAC,EAAE;gBACpB,OAAO,EAAE,SAAS;gBAClB,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,OAAO,EAAE,OAAO,CAAC,OAAO;gBACxB,IAAI,EAAE,OAAO,CAAC,IAAI;gBAClB,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,WAAW,EAAE,OAAO,CAAC,WAAW;oBAC/B,CAAC,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC;oBAC/B,CAAC,CAAC,SAAS;aACZ,CAAC,CAAC;YAEH,OAAO;gBACN,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,MAAM,EAAE,GAAG,CAAC,MAAuB;gBACnC,SAAS,EAAE,GAAG,CAAC,SAAS;gBACxB,SAAS,EAAE,GAAG,CAAC,SAAS;aACxB,CAAC;QACH,CAAC;QAED,KAAK,CAAC,cAAc,CACnB,OAAiB,EACjB,UAA0B,EAAE;YAE5B,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAEjD,OAAO,IAAI,EAAE,CAAC;gBACb,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;gBAExD,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;oBAC/D,OAAO;wBACN,EAAE,EAAE,MAAM,CAAC,EAAE;wBACb,MAAM,EAAE,MAAM,CAAC,MAA6B;wBAC5C,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,KAAK,EAAE,MAAM,CAAC,KAAK;wBACnB,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI;qBACrC,CAAC;gBACH,CAAC;gBAED,MAAM,KAAK,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,63 @@
+import type { ZodSchema } from "zod";
+export type RunStatus = "pending" | "running" | "success" | "failed";
+export type Run = {
+    id: string;
+    status: RunStatus;
+    triggerId: string;
+    createdAt: string;
+};
+export type RunResult = {
+    id: string;
+    status: RunStatus;
+    result: unknown;
+    error: unknown;
+    finishedAt: string | null;
+};
+export type TriggerOptions = {
+    idempotencyKey?: string;
+    webhook?: string;
+    tags?: string[];
+    priority?: number;
+    scheduledAt?: string;
+};
+export type StepHelpers = {
+    run: <T>(id: string, fn: () => Promise<T>) => Promise<T>;
+    sleep: (id: string, duration: string) => Promise<void>;
+};
+export type RunContext<TPayload = unknown> = {
+    payload: TPayload;
+    runId: string;
+    attempt: number;
+    step: StepHelpers;
+};
+export type TaskConfig<TPayload = unknown, TResult = unknown> = {
+    id: string;
+    schema?: ZodSchema<TPayload>;
+    cron?: string | {
+        pattern: string;
+        timezone?: string;
+    };
+    queue?: {
+        name: string;
+        concurrencyLimit?: number;
+        rateLimit?: {
+            max: number;
+            duration: string;
+        };
+    };
+    retry?: {
+        maxAttempts: number;
+        backoff?: "exponential" | "linear" | "fixed";
+        minTimeoutInMs?: number;
+        maxTimeoutInMs?: number;
+    };
+    timeout?: number;
+    run: (context: RunContext<TPayload>) => Promise<TResult>;
+};
+export type Task<TPayload = unknown, TResult = unknown> = {
+    id: string;
+    _config: TaskConfig<TPayload, TResult>;
+    trigger: (payload: TPayload, options?: TriggerOptions) => Promise<Run>;
+    triggerAndWait: (payload: TPayload, options?: TriggerOptions) => Promise<RunResult>;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,12 +1,35 @@
 {
-  "name": "steppler",
-  "version": "0.0.1",
-  "description": "Reserved package name",
-  "main": "index.js",
-  "keywords": [
-    "placeholder",
-    "reserved"
-  ],
-  "author": "tminusdev",
-  "license": "MIT"
-}
+	"name": "steppler",
+	"version": "0.1.1",
+	"type": "module",
+	"main": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		},
+		"./next": {
+			"import": "./dist/adapters/next.js",
+			"types": "./dist/adapters/next.d.ts"
+		},
+		"./handler": {
+			"import": "./dist/adapters/generic.js",
+			"types": "./dist/adapters/generic.d.ts"
+		}
+	},
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsc",
+		"dev": "tsc --watch"
+	},
+	"dependencies": {
+		"@steppler/api": "latest"
+	},
+	"devDependencies": {
+		"typescript": "^5.0.0",
+		"@types/node": "^22.0.0"
+	}
+}

package/index.js

@@ -1,3 +0,0 @@
-export default function() {
-  console.log('This package is reserved');
-}