runlater-js 0.3.0 → 0.5.0

package/README.md

@@ -151,6 +151,46 @@ const pings = await rl.monitors.pings("monitor-id", 20)
 await rl.monitors.ping("pm_your_token_here")
 ```
 
+### Endpoints (webhook gateway)
+
+```js
+// Create an endpoint with Lua scripting
+const endpoint = await rl.endpoints.create({
+  name: "Stripe webhooks",
+  forward_urls: ["https://myapp.com/webhooks/stripe"],
+  script: `
+function verify(event, secrets)
+  local sig = event.headers["stripe-signature"]
+  if not sig then return false end
+  local ts, hash = sig:match("t=(%d+),v1=(%S+)")
+  if not ts or not hash then return false end
+  local expected = hmac_sha256(secrets.signing_key, ts .. "." .. event.body)
+  return expected == hash
+end
+  `,
+  secrets: { signing_key: "whsec_..." },
+})
+
+console.log(endpoint.inbound_url) // Give this URL to Stripe
+
+// List endpoints
+const { data } = await rl.endpoints.list()
+
+// Update script
+await rl.endpoints.update("endpoint-id", {
+  script: "function filter(event) return true end",
+})
+
+// View events
+const events = await rl.endpoints.events("endpoint-id")
+
+// Replay an event
+await rl.endpoints.replay("endpoint-id", "event-id")
+
+// Delete
+await rl.endpoints.delete("endpoint-id")
+```
+
 ### Declarative sync
 
 Push your task configuration from code. Matched by name.

package/dist/index.d.mts

@@ -11,6 +11,8 @@ interface SendOptions {
     queue?: string;
     callback?: string;
     idempotencyKey?: string;
+    on_failure_url?: string;
+    on_recovery_url?: string;
 }
 interface DelayOptions extends SendOptions {
     delay: string | number;
@@ -29,6 +31,8 @@ interface CronOptions {
     queue?: string;
     callback?: string;
     enabled?: boolean;
+    on_failure_url?: string;
+    on_recovery_url?: string;
 }
 interface TaskResponse {
     task_id: string;
@@ -64,6 +68,8 @@ interface Task {
     queue: string | null;
     notify_on_failure: boolean | null;
     notify_on_recovery: boolean | null;
+    on_failure_url: string | null;
+    on_recovery_url: string | null;
     next_run_at: string | null;
     inserted_at: string;
     updated_at: string;
@@ -108,6 +114,8 @@ interface Monitor {
     enabled: boolean;
     notify_on_failure: boolean | null;
     notify_on_recovery: boolean | null;
+    on_failure_url: string | null;
+    on_recovery_url: string | null;
     last_ping_at: string | null;
     next_expected_at: string | null;
     inserted_at: string;
@@ -148,6 +156,8 @@ interface UpdateTaskOptions {
     enabled?: boolean;
     notify_on_failure?: boolean | null;
     notify_on_recovery?: boolean | null;
+    on_failure_url?: string;
+    on_recovery_url?: string;
     expected_status_codes?: string;
     expected_body_pattern?: string;
 }
@@ -157,6 +167,8 @@ interface CreateMonitorOptions {
     interval?: number;
     grace?: number;
     enabled?: boolean;
+    on_failure_url?: string;
+    on_recovery_url?: string;
 }
 interface UpdateMonitorOptions {
     name?: string;
@@ -167,6 +179,8 @@ interface UpdateMonitorOptions {
     enabled?: boolean;
     notify_on_failure?: boolean | null;
     notify_on_recovery?: boolean | null;
+    on_failure_url?: string;
+    on_recovery_url?: string;
 }
 interface Ping {
     id: string;
@@ -196,6 +210,60 @@ interface SyncResponse {
     updated_count: number;
     deleted_count: number;
 }
+interface Endpoint {
+    id: string;
+    name: string;
+    slug: string;
+    inbound_url: string;
+    forward_urls: string[];
+    enabled: boolean;
+    retry_attempts: number;
+    use_queue: boolean;
+    notify_on_failure: boolean | null;
+    notify_on_recovery: boolean | null;
+    on_failure_url: string | null;
+    on_recovery_url: string | null;
+    forward_headers: Record<string, string> | null;
+    forward_body: string | null;
+    forward_method: string | null;
+    script: string | null;
+    secrets_keys: string[];
+    inserted_at: string;
+    updated_at: string;
+}
+interface CreateEndpointOptions {
+    name: string;
+    forward_urls: string[];
+    retry_attempts?: number;
+    use_queue?: boolean;
+    enabled?: boolean;
+    forward_headers?: Record<string, string>;
+    forward_body?: string;
+    forward_method?: string;
+    script?: string;
+    secrets?: Record<string, string>;
+}
+interface UpdateEndpointOptions {
+    name?: string;
+    forward_urls?: string[];
+    retry_attempts?: number;
+    use_queue?: boolean;
+    enabled?: boolean;
+    forward_headers?: Record<string, string>;
+    forward_body?: string;
+    forward_method?: string;
+    script?: string;
+    secrets?: Record<string, string>;
+}
+interface InboundEvent {
+    id: string;
+    method: string;
+    source_ip: string;
+    received_at: string;
+    task_ids: string[];
+    lua_rejected: boolean;
+    lua_logs: string[];
+}
 declare class RunlaterError extends Error {
     status: number;
     code: string;
@@ -207,6 +275,7 @@ declare class Runlater {
     private baseUrl;
     tasks: Tasks;
     monitors: Monitors;
+    endpoints: Endpoints;
     constructor(options: RunlaterOptions | string);
     /**
      * Send a request immediately with reliable delivery and retries.
@@ -330,5 +399,16 @@ declare class Monitors {
     pings(id: string, limit?: number): Promise<Ping[]>;
     ping(token: string): Promise<PingResponse>;
 }
+declare class Endpoints {
+    private client;
+    constructor(client: Runlater);
+    list(): Promise<ListResponse<Endpoint>>;
+    get(id: string): Promise<Endpoint>;
+    create(options: CreateEndpointOptions): Promise<Endpoint>;
+    update(id: string, options: UpdateEndpointOptions): Promise<Endpoint>;
+    delete(id: string): Promise<void>;
+    events(id: string, limit?: number): Promise<InboundEvent[]>;
+    replay(endpointId: string, eventId: string): Promise<void>;
+}
 
-export { type BatchOptions, type BatchResponse, type CancelQueueResponse, type CreateMonitorOptions, type CronOptions, type CronResponse, type DelayOptions, type Execution, type ListOptions, type ListResponse, type Monitor, type Ping, type PingResponse, Runlater, RunlaterError, type RunlaterOptions, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse, type UpdateMonitorOptions, type UpdateTaskOptions };
+export { type BatchOptions, type BatchResponse, type CancelQueueResponse, type CreateEndpointOptions, type CreateMonitorOptions, type CronOptions, type CronResponse, type DelayOptions, type Endpoint, type Execution, type InboundEvent, type ListOptions, type ListResponse, type Monitor, type Ping, type PingResponse, Runlater, RunlaterError, type RunlaterOptions, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse, type UpdateEndpointOptions, type UpdateMonitorOptions, type UpdateTaskOptions };

package/dist/index.d.ts

@@ -11,6 +11,8 @@ interface SendOptions {
     queue?: string;
     callback?: string;
     idempotencyKey?: string;
+    on_failure_url?: string;
+    on_recovery_url?: string;
 }
 interface DelayOptions extends SendOptions {
     delay: string | number;
@@ -29,6 +31,8 @@ interface CronOptions {
     queue?: string;
     callback?: string;
     enabled?: boolean;
+    on_failure_url?: string;
+    on_recovery_url?: string;
 }
 interface TaskResponse {
     task_id: string;
@@ -64,6 +68,8 @@ interface Task {
     queue: string | null;
     notify_on_failure: boolean | null;
     notify_on_recovery: boolean | null;
+    on_failure_url: string | null;
+    on_recovery_url: string | null;
     next_run_at: string | null;
     inserted_at: string;
     updated_at: string;
@@ -108,6 +114,8 @@ interface Monitor {
     enabled: boolean;
     notify_on_failure: boolean | null;
     notify_on_recovery: boolean | null;
+    on_failure_url: string | null;
+    on_recovery_url: string | null;
     last_ping_at: string | null;
     next_expected_at: string | null;
     inserted_at: string;
@@ -148,6 +156,8 @@ interface UpdateTaskOptions {
     enabled?: boolean;
     notify_on_failure?: boolean | null;
     notify_on_recovery?: boolean | null;
+    on_failure_url?: string;
+    on_recovery_url?: string;
     expected_status_codes?: string;
     expected_body_pattern?: string;
 }
@@ -157,6 +167,8 @@ interface CreateMonitorOptions {
     interval?: number;
     grace?: number;
     enabled?: boolean;
+    on_failure_url?: string;
+    on_recovery_url?: string;
 }
 interface UpdateMonitorOptions {
     name?: string;
@@ -167,6 +179,8 @@ interface UpdateMonitorOptions {
     enabled?: boolean;
     notify_on_failure?: boolean | null;
     notify_on_recovery?: boolean | null;
+    on_failure_url?: string;
+    on_recovery_url?: string;
 }
 interface Ping {
     id: string;
@@ -196,6 +210,60 @@ interface SyncResponse {
     updated_count: number;
     deleted_count: number;
 }
+interface Endpoint {
+    id: string;
+    name: string;
+    slug: string;
+    inbound_url: string;
+    forward_urls: string[];
+    enabled: boolean;
+    retry_attempts: number;
+    use_queue: boolean;
+    notify_on_failure: boolean | null;
+    notify_on_recovery: boolean | null;
+    on_failure_url: string | null;
+    on_recovery_url: string | null;
+    forward_headers: Record<string, string> | null;
+    forward_body: string | null;
+    forward_method: string | null;
+    script: string | null;
+    secrets_keys: string[];
+    inserted_at: string;
+    updated_at: string;
+}
+interface CreateEndpointOptions {
+    name: string;
+    forward_urls: string[];
+    retry_attempts?: number;
+    use_queue?: boolean;
+    enabled?: boolean;
+    forward_headers?: Record<string, string>;
+    forward_body?: string;
+    forward_method?: string;
+    script?: string;
+    secrets?: Record<string, string>;
+}
+interface UpdateEndpointOptions {
+    name?: string;
+    forward_urls?: string[];
+    retry_attempts?: number;
+    use_queue?: boolean;
+    enabled?: boolean;
+    forward_headers?: Record<string, string>;
+    forward_body?: string;
+    forward_method?: string;
+    script?: string;
+    secrets?: Record<string, string>;
+}
+interface InboundEvent {
+    id: string;
+    method: string;
+    source_ip: string;
+    received_at: string;
+    task_ids: string[];
+    lua_rejected: boolean;
+    lua_logs: string[];
+}
 declare class RunlaterError extends Error {
     status: number;
     code: string;
@@ -207,6 +275,7 @@ declare class Runlater {
     private baseUrl;
     tasks: Tasks;
     monitors: Monitors;
+    endpoints: Endpoints;
     constructor(options: RunlaterOptions | string);
     /**
      * Send a request immediately with reliable delivery and retries.
@@ -330,5 +399,16 @@ declare class Monitors {
     pings(id: string, limit?: number): Promise<Ping[]>;
     ping(token: string): Promise<PingResponse>;
 }
+declare class Endpoints {
+    private client;
+    constructor(client: Runlater);
+    list(): Promise<ListResponse<Endpoint>>;
+    get(id: string): Promise<Endpoint>;
+    create(options: CreateEndpointOptions): Promise<Endpoint>;
+    update(id: string, options: UpdateEndpointOptions): Promise<Endpoint>;
+    delete(id: string): Promise<void>;
+    events(id: string, limit?: number): Promise<InboundEvent[]>;
+    replay(endpointId: string, eventId: string): Promise<void>;
+}
 
-export { type BatchOptions, type BatchResponse, type CancelQueueResponse, type CreateMonitorOptions, type CronOptions, type CronResponse, type DelayOptions, type Execution, type ListOptions, type ListResponse, type Monitor, type Ping, type PingResponse, Runlater, RunlaterError, type RunlaterOptions, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse, type UpdateMonitorOptions, type UpdateTaskOptions };
+export { type BatchOptions, type BatchResponse, type CancelQueueResponse, type CreateEndpointOptions, type CreateMonitorOptions, type CronOptions, type CronResponse, type DelayOptions, type Endpoint, type Execution, type InboundEvent, type ListOptions, type ListResponse, type Monitor, type Ping, type PingResponse, Runlater, RunlaterError, type RunlaterOptions, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse, type UpdateEndpointOptions, type UpdateMonitorOptions, type UpdateTaskOptions };

package/dist/index.js

@@ -44,6 +44,7 @@ var Runlater = class {
   baseUrl;
   tasks;
   monitors;
+  endpoints;
   constructor(options) {
     if (typeof options === "string") {
       this.apiKey = options;
@@ -54,6 +55,7 @@ var Runlater = class {
     }
     this.tasks = new Tasks(this);
     this.monitors = new Monitors(this);
+    this.endpoints = new Endpoints(this);
   }
   /**
    * Send a request immediately with reliable delivery and retries.
@@ -386,6 +388,43 @@ var Monitors = class {
     return await response.json();
   }
 };
+var Endpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.request("GET", "/endpoints");
+  }
+  async get(id) {
+    const res = await this.client.request("GET", `/endpoints/${id}`);
+    return res.data;
+  }
+  async create(options) {
+    const res = await this.client.request("POST", "/endpoints", {
+      body: options
+    });
+    return res.data;
+  }
+  async update(id, options) {
+    const res = await this.client.request("PUT", `/endpoints/${id}`, {
+      body: options
+    });
+    return res.data;
+  }
+  async delete(id) {
+    await this.client.request("DELETE", `/endpoints/${id}`);
+  }
+  async events(id, limit = 50) {
+    const res = await this.client.request(
+      "GET",
+      `/endpoints/${id}/events?limit=${limit}`
+    );
+    return res.data;
+  }
+  async replay(endpointId, eventId) {
+    await this.client.request("POST", `/endpoints/${endpointId}/events/${eventId}/replay`);
+  }
+};
 function formatDelay(delay) {
   if (typeof delay === "number") return `${delay}s`;
   return delay;

package/dist/index.mjs

@@ -17,6 +17,7 @@ var Runlater = class {
   baseUrl;
   tasks;
   monitors;
+  endpoints;
   constructor(options) {
     if (typeof options === "string") {
       this.apiKey = options;
@@ -27,6 +28,7 @@ var Runlater = class {
     }
     this.tasks = new Tasks(this);
     this.monitors = new Monitors(this);
+    this.endpoints = new Endpoints(this);
   }
   /**
    * Send a request immediately with reliable delivery and retries.
@@ -359,6 +361,43 @@ var Monitors = class {
     return await response.json();
   }
 };
+var Endpoints = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list() {
+    return this.client.request("GET", "/endpoints");
+  }
+  async get(id) {
+    const res = await this.client.request("GET", `/endpoints/${id}`);
+    return res.data;
+  }
+  async create(options) {
+    const res = await this.client.request("POST", "/endpoints", {
+      body: options
+    });
+    return res.data;
+  }
+  async update(id, options) {
+    const res = await this.client.request("PUT", `/endpoints/${id}`, {
+      body: options
+    });
+    return res.data;
+  }
+  async delete(id) {
+    await this.client.request("DELETE", `/endpoints/${id}`);
+  }
+  async events(id, limit = 50) {
+    const res = await this.client.request(
+      "GET",
+      `/endpoints/${id}/events?limit=${limit}`
+    );
+    return res.data;
+  }
+  async replay(endpointId, eventId) {
+    await this.client.request("POST", `/endpoints/${endpointId}/events/${eventId}/replay`);
+  }
+};
 function formatDelay(delay) {
   if (typeof delay === "number") return `${delay}s`;
   return delay;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runlater-js",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Delayed tasks, cron jobs, and reliable webhooks. No infrastructure required.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",