runlater-js 0.10.0 → 0.11.0

package/dist/index.d.mts

@@ -184,10 +184,16 @@ interface Monitor {
     inserted_at: string;
     updated_at: string;
 }
-interface BatchOptions {
+interface BatchTask {
     url: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: unknown;
+    name?: string;
+}
+interface BatchOptions {
     queue: string;
-    items: unknown[];
+    tasks: BatchTask[];
     method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
     headers?: Record<string, string>;
     run_at?: string | Date;
@@ -423,20 +429,20 @@ declare class Tasks {
     update(id: string, options: UpdateTaskOptions): Promise<Task>;
     executions(id: string, limit?: number): Promise<Execution[]>;
     /**
-     * Create many tasks at once with shared configuration.
+     * Create many tasks at once. Each task defines its own URL and can
+     * optionally override method, headers, body, and name. Top-level
+     * settings serve as defaults.
      *
-     * 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",
+     *   method: "POST",
      *   run_at: "2026-03-01T09:00:00Z",
-     *   items: [
-     *     { to: "user1@example.com", name: "Alice" },
-     *     { to: "user2@example.com", name: "Bob" },
+     *   tasks: [
+     *     { url: "https://myapp.com/api/send-email", body: { to: "alice@example.com" } },
+     *     { url: "https://myapp.com/api/send-sms", body: { to: "+1234567890" } },
      *   ]
      * })
      * ```
@@ -490,4 +496,4 @@ declare class Endpoints {
     resume(id: string): Promise<Endpoint>;
 }
 
-export { type BatchOptions, type BatchResponse, type CancelQueueResponse, type CreateEndpointOptions, type CreateMonitorOptions, type CreateScheduleOptions, 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 Schedule, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse, type UpdateEndpointOptions, type UpdateMonitorOptions, type UpdateScheduleOptions, type UpdateTaskOptions };
+export { type BatchOptions, type BatchResponse, type BatchTask, type CancelQueueResponse, type CreateEndpointOptions, type CreateMonitorOptions, type CreateScheduleOptions, 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 Schedule, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse, type UpdateEndpointOptions, type UpdateMonitorOptions, type UpdateScheduleOptions, type UpdateTaskOptions };

package/dist/index.d.ts

@@ -184,10 +184,16 @@ interface Monitor {
     inserted_at: string;
     updated_at: string;
 }
-interface BatchOptions {
+interface BatchTask {
     url: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: unknown;
+    name?: string;
+}
+interface BatchOptions {
     queue: string;
-    items: unknown[];
+    tasks: BatchTask[];
     method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
     headers?: Record<string, string>;
     run_at?: string | Date;
@@ -423,20 +429,20 @@ declare class Tasks {
     update(id: string, options: UpdateTaskOptions): Promise<Task>;
     executions(id: string, limit?: number): Promise<Execution[]>;
     /**
-     * Create many tasks at once with shared configuration.
+     * Create many tasks at once. Each task defines its own URL and can
+     * optionally override method, headers, body, and name. Top-level
+     * settings serve as defaults.
      *
-     * 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",
+     *   method: "POST",
      *   run_at: "2026-03-01T09:00:00Z",
-     *   items: [
-     *     { to: "user1@example.com", name: "Alice" },
-     *     { to: "user2@example.com", name: "Bob" },
+     *   tasks: [
+     *     { url: "https://myapp.com/api/send-email", body: { to: "alice@example.com" } },
+     *     { url: "https://myapp.com/api/send-sms", body: { to: "+1234567890" } },
      *   ]
      * })
      * ```
@@ -490,4 +496,4 @@ declare class Endpoints {
     resume(id: string): Promise<Endpoint>;
 }
 
-export { type BatchOptions, type BatchResponse, type CancelQueueResponse, type CreateEndpointOptions, type CreateMonitorOptions, type CreateScheduleOptions, 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 Schedule, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse, type UpdateEndpointOptions, type UpdateMonitorOptions, type UpdateScheduleOptions, type UpdateTaskOptions };
+export { type BatchOptions, type BatchResponse, type BatchTask, type CancelQueueResponse, type CreateEndpointOptions, type CreateMonitorOptions, type CreateScheduleOptions, 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 Schedule, type ScheduleOptions, type SendOptions, type SyncOptions, type SyncResponse, type Task, type TaskResponse, type TriggerResponse, type UpdateEndpointOptions, type UpdateMonitorOptions, type UpdateScheduleOptions, type UpdateTaskOptions };

package/dist/index.js

@@ -222,7 +222,7 @@ var Runlater = class {
     const headers = {
       Authorization: `Bearer ${this.apiKey}`,
       "Content-Type": "application/json",
-      "User-Agent": "runlater-js/0.1.0"
+      "User-Agent": "runlater-js/0.11.0"
     };
     if (options.idempotencyKey) {
       headers["Idempotency-Key"] = options.idempotencyKey;
@@ -287,29 +287,34 @@ var Tasks = class {
     return res.data;
   }
   /**
-   * Create many tasks at once with shared configuration.
+   * Create many tasks at once. Each task defines its own URL and can
+   * optionally override method, headers, body, and name. Top-level
+   * settings serve as defaults.
    *
-   * 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",
+   *   method: "POST",
    *   run_at: "2026-03-01T09:00:00Z",
-   *   items: [
-   *     { to: "user1@example.com", name: "Alice" },
-   *     { to: "user2@example.com", name: "Bob" },
+   *   tasks: [
+   *     { url: "https://myapp.com/api/send-email", body: { to: "alice@example.com" } },
+   *     { url: "https://myapp.com/api/send-sms", body: { to: "+1234567890" } },
    *   ]
    * })
    * ```
    */
   async batch(options) {
     const body = {
-      url: options.url,
       queue: options.queue,
-      items: options.items,
+      tasks: options.tasks.map((t) => ({
+        url: t.url,
+        method: t.method,
+        headers: t.headers,
+        body: t.body != null ? typeof t.body === "string" ? t.body : JSON.stringify(t.body) : void 0,
+        name: t.name
+      })),
       method: options.method ?? "POST",
       headers: options.headers,
       timeout_ms: options.timeout,

package/dist/index.mjs

@@ -195,7 +195,7 @@ var Runlater = class {
     const headers = {
       Authorization: `Bearer ${this.apiKey}`,
       "Content-Type": "application/json",
-      "User-Agent": "runlater-js/0.1.0"
+      "User-Agent": "runlater-js/0.11.0"
     };
     if (options.idempotencyKey) {
       headers["Idempotency-Key"] = options.idempotencyKey;
@@ -260,29 +260,34 @@ var Tasks = class {
     return res.data;
   }
   /**
-   * Create many tasks at once with shared configuration.
+   * Create many tasks at once. Each task defines its own URL and can
+   * optionally override method, headers, body, and name. Top-level
+   * settings serve as defaults.
    *
-   * 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",
+   *   method: "POST",
    *   run_at: "2026-03-01T09:00:00Z",
-   *   items: [
-   *     { to: "user1@example.com", name: "Alice" },
-   *     { to: "user2@example.com", name: "Bob" },
+   *   tasks: [
+   *     { url: "https://myapp.com/api/send-email", body: { to: "alice@example.com" } },
+   *     { url: "https://myapp.com/api/send-sms", body: { to: "+1234567890" } },
    *   ]
    * })
    * ```
    */
   async batch(options) {
     const body = {
-      url: options.url,
       queue: options.queue,
-      items: options.items,
+      tasks: options.tasks.map((t) => ({
+        url: t.url,
+        method: t.method,
+        headers: t.headers,
+        body: t.body != null ? typeof t.body === "string" ? t.body : JSON.stringify(t.body) : void 0,
+        name: t.name
+      })),
       method: options.method ?? "POST",
       headers: options.headers,
       timeout_ms: options.timeout,

package/package.json

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