runlater-js 0.2.0 → 0.4.0

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,11 +114,33 @@ 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;
     updated_at: string;
 }
+interface BatchOptions {
+    url: string;
+    queue: string;
+    items: unknown[];
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    run_at?: string | Date;
+    delay?: string | number;
+    timeout?: number;
+    retries?: number;
+    callback?: string;
+}
+interface BatchResponse {
+    queue: string;
+    created: number;
+    scheduled_for: string;
+}
+interface CancelQueueResponse {
+    cancelled: number;
+}
 interface UpdateTaskOptions {
     name?: string;
     url?: string;
@@ -128,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;
 }
@@ -137,6 +167,8 @@ interface CreateMonitorOptions {
     interval?: number;
     grace?: number;
     enabled?: boolean;
+    on_failure_url?: string;
+    on_recovery_url?: string;
 }
 interface UpdateMonitorOptions {
     name?: string;
@@ -147,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;
@@ -267,6 +301,37 @@ declare class Tasks {
     trigger(id: string): Promise<TriggerResponse>;
     update(id: string, options: UpdateTaskOptions): Promise<Task>;
     executions(id: string, limit?: number): Promise<Execution[]>;
+    /**
+     * Create many tasks at once with shared configuration.
+     *
+     * Each item in the array becomes the request body for one task.
+     * All tasks share the same URL, method, headers, timing, and queue.
+     * Use the queue name with `cancelQueue()` to cancel them as a group.
+     *
+     * ```js
+     * await rl.tasks.batch({
+     *   url: "https://myapp.com/api/send-email",
+     *   queue: "march-newsletter",
+     *   run_at: "2026-03-01T09:00:00Z",
+     *   items: [
+     *     { to: "user1@example.com", name: "Alice" },
+     *     { to: "user2@example.com", name: "Bob" },
+     *   ]
+     * })
+     * ```
+     */
+    batch(options: BatchOptions): Promise<BatchResponse>;
+    /**
+     * Cancel all tasks in a queue.
+     *
+     * Soft-deletes every task in the queue and removes their pending executions.
+     *
+     * ```js
+     * const { cancelled } = await rl.tasks.cancelQueue("march-newsletter")
+     * console.log(`Cancelled ${cancelled} tasks`)
+     * ```
+     */
+    cancelQueue(queue: string): Promise<CancelQueueResponse>;
 }
 declare class Monitors {
     private client;
@@ -280,4 +345,4 @@ declare class Monitors {
     ping(token: string): Promise<PingResponse>;
 }
 
-export { 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 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 };

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,11 +114,33 @@ 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;
     updated_at: string;
 }
+interface BatchOptions {
+    url: string;
+    queue: string;
+    items: unknown[];
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    run_at?: string | Date;
+    delay?: string | number;
+    timeout?: number;
+    retries?: number;
+    callback?: string;
+}
+interface BatchResponse {
+    queue: string;
+    created: number;
+    scheduled_for: string;
+}
+interface CancelQueueResponse {
+    cancelled: number;
+}
 interface UpdateTaskOptions {
     name?: string;
     url?: string;
@@ -128,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;
 }
@@ -137,6 +167,8 @@ interface CreateMonitorOptions {
     interval?: number;
     grace?: number;
     enabled?: boolean;
+    on_failure_url?: string;
+    on_recovery_url?: string;
 }
 interface UpdateMonitorOptions {
     name?: string;
@@ -147,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;
@@ -267,6 +301,37 @@ declare class Tasks {
     trigger(id: string): Promise<TriggerResponse>;
     update(id: string, options: UpdateTaskOptions): Promise<Task>;
     executions(id: string, limit?: number): Promise<Execution[]>;
+    /**
+     * Create many tasks at once with shared configuration.
+     *
+     * Each item in the array becomes the request body for one task.
+     * All tasks share the same URL, method, headers, timing, and queue.
+     * Use the queue name with `cancelQueue()` to cancel them as a group.
+     *
+     * ```js
+     * await rl.tasks.batch({
+     *   url: "https://myapp.com/api/send-email",
+     *   queue: "march-newsletter",
+     *   run_at: "2026-03-01T09:00:00Z",
+     *   items: [
+     *     { to: "user1@example.com", name: "Alice" },
+     *     { to: "user2@example.com", name: "Bob" },
+     *   ]
+     * })
+     * ```
+     */
+    batch(options: BatchOptions): Promise<BatchResponse>;
+    /**
+     * Cancel all tasks in a queue.
+     *
+     * Soft-deletes every task in the queue and removes their pending executions.
+     *
+     * ```js
+     * const { cancelled } = await rl.tasks.cancelQueue("march-newsletter")
+     * console.log(`Cancelled ${cancelled} tasks`)
+     * ```
+     */
+    cancelQueue(queue: string): Promise<CancelQueueResponse>;
 }
 declare class Monitors {
     private client;
@@ -280,4 +345,4 @@ declare class Monitors {
     ping(token: string): Promise<PingResponse>;
 }
 
-export { 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 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 };

package/dist/index.js

@@ -278,6 +278,64 @@ var Tasks = class {
     );
     return res.data;
   }
+  /**
+   * Create many tasks at once with shared configuration.
+   *
+   * Each item in the array becomes the request body for one task.
+   * All tasks share the same URL, method, headers, timing, and queue.
+   * Use the queue name with `cancelQueue()` to cancel them as a group.
+   *
+   * ```js
+   * await rl.tasks.batch({
+   *   url: "https://myapp.com/api/send-email",
+   *   queue: "march-newsletter",
+   *   run_at: "2026-03-01T09:00:00Z",
+   *   items: [
+   *     { to: "user1@example.com", name: "Alice" },
+   *     { to: "user2@example.com", name: "Bob" },
+   *   ]
+   * })
+   * ```
+   */
+  async batch(options) {
+    const body = {
+      url: options.url,
+      queue: options.queue,
+      items: options.items,
+      method: options.method ?? "POST",
+      headers: options.headers,
+      timeout_ms: options.timeout,
+      retry_attempts: options.retries,
+      callback_url: options.callback
+    };
+    if (options.run_at != null) {
+      body.run_at = options.run_at instanceof Date ? options.run_at.toISOString() : options.run_at;
+    }
+    if (options.delay != null) {
+      body.delay = formatDelay(options.delay);
+    }
+    const res = await this.client.request("POST", "/tasks/batch", {
+      body
+    });
+    return res.data;
+  }
+  /**
+   * Cancel all tasks in a queue.
+   *
+   * Soft-deletes every task in the queue and removes their pending executions.
+   *
+   * ```js
+   * const { cancelled } = await rl.tasks.cancelQueue("march-newsletter")
+   * console.log(`Cancelled ${cancelled} tasks`)
+   * ```
+   */
+  async cancelQueue(queue) {
+    const res = await this.client.request(
+      "DELETE",
+      `/tasks?queue=${encodeURIComponent(queue)}`
+    );
+    return res.data;
+  }
 };
 var Monitors = class {
   constructor(client) {

package/dist/index.mjs

@@ -251,6 +251,64 @@ var Tasks = class {
     );
     return res.data;
   }
+  /**
+   * Create many tasks at once with shared configuration.
+   *
+   * Each item in the array becomes the request body for one task.
+   * All tasks share the same URL, method, headers, timing, and queue.
+   * Use the queue name with `cancelQueue()` to cancel them as a group.
+   *
+   * ```js
+   * await rl.tasks.batch({
+   *   url: "https://myapp.com/api/send-email",
+   *   queue: "march-newsletter",
+   *   run_at: "2026-03-01T09:00:00Z",
+   *   items: [
+   *     { to: "user1@example.com", name: "Alice" },
+   *     { to: "user2@example.com", name: "Bob" },
+   *   ]
+   * })
+   * ```
+   */
+  async batch(options) {
+    const body = {
+      url: options.url,
+      queue: options.queue,
+      items: options.items,
+      method: options.method ?? "POST",
+      headers: options.headers,
+      timeout_ms: options.timeout,
+      retry_attempts: options.retries,
+      callback_url: options.callback
+    };
+    if (options.run_at != null) {
+      body.run_at = options.run_at instanceof Date ? options.run_at.toISOString() : options.run_at;
+    }
+    if (options.delay != null) {
+      body.delay = formatDelay(options.delay);
+    }
+    const res = await this.client.request("POST", "/tasks/batch", {
+      body
+    });
+    return res.data;
+  }
+  /**
+   * Cancel all tasks in a queue.
+   *
+   * Soft-deletes every task in the queue and removes their pending executions.
+   *
+   * ```js
+   * const { cancelled } = await rl.tasks.cancelQueue("march-newsletter")
+   * console.log(`Cancelled ${cancelled} tasks`)
+   * ```
+   */
+  async cancelQueue(queue) {
+    const res = await this.client.request(
+      "DELETE",
+      `/tasks?queue=${encodeURIComponent(queue)}`
+    );
+    return res.data;
+  }
 };
 var Monitors = class {
   constructor(client) {

package/package.json

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