runlater-js 0.9.0 → 0.11.0

package/dist/index.d.mts

@@ -56,6 +56,62 @@ interface CronResponse {
     inserted_at: string;
     updated_at: string;
 }
+interface Schedule {
+    id: string;
+    name: string;
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body: string | null;
+    cron: string;
+    enabled: boolean;
+    timeout_ms: number;
+    callback_url: string | null;
+    expected_status_codes: string | null;
+    expected_body_pattern: string | null;
+    notify_on_failure: boolean | null;
+    notify_on_recovery: boolean | null;
+    on_failure_url: string | null;
+    on_recovery_url: string | null;
+    script: string | null;
+    next_run_at: string | null;
+    inserted_at: string;
+    updated_at: string;
+}
+interface CreateScheduleOptions {
+    url: string;
+    cron: string;
+    name?: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeout?: number;
+    callback?: string;
+    enabled?: boolean;
+    on_failure_url?: string;
+    on_recovery_url?: string;
+    expected_status_codes?: string;
+    expected_body_pattern?: string;
+    script?: string;
+}
+interface UpdateScheduleOptions {
+    name?: string;
+    url?: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: string;
+    cron?: string;
+    timeout_ms?: number;
+    callback_url?: string;
+    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;
+    script?: string | null;
+}
 interface Task {
     id: string;
     name: string;
@@ -128,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;
@@ -199,12 +261,12 @@ interface PingResponse {
     monitor: string;
 }
 interface SyncOptions {
-    tasks?: CronOptions[];
+    schedules?: CronOptions[];
     monitors?: CreateMonitorOptions[];
     deleteRemoved?: boolean;
 }
 interface SyncResponse {
-    tasks: {
+    schedules: {
         created: string[];
         updated: string[];
         deleted: string[];
@@ -285,6 +347,7 @@ declare class Runlater {
     tasks: Tasks;
     monitors: Monitors;
     endpoints: Endpoints;
+    schedules: Schedules;
     constructor(options: RunlaterOptions | string);
     /**
      * Send a request immediately with reliable delivery and retries.
@@ -339,7 +402,7 @@ declare class Runlater {
      *
      * ```js
      * await rl.sync({
-     *   tasks: [
+     *   schedules: [
      *     { name: "daily-report", url: "https://...", schedule: "0 9 * * *" }
      *   ],
      *   deleteRemoved: true
@@ -366,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" } },
      *   ]
      * })
      * ```
@@ -397,6 +460,17 @@ declare class Tasks {
      */
     cancelQueue(queue: string): Promise<CancelQueueResponse>;
 }
+declare class Schedules {
+    private client;
+    constructor(client: Runlater);
+    list(options?: ListOptions): Promise<ListResponse<Schedule>>;
+    get(id: string): Promise<Schedule>;
+    create(options: CreateScheduleOptions): Promise<Schedule>;
+    update(id: string, options: UpdateScheduleOptions): Promise<Schedule>;
+    delete(id: string): Promise<void>;
+    trigger(id: string): Promise<TriggerResponse>;
+    executions(id: string, limit?: number): Promise<Execution[]>;
+}
 declare class Monitors {
     private client;
     constructor(client: Runlater);
@@ -422,4 +496,4 @@ declare class Endpoints {
     resume(id: string): Promise<Endpoint>;
 }
 
-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 };
+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

@@ -56,6 +56,62 @@ interface CronResponse {
     inserted_at: string;
     updated_at: string;
 }
+interface Schedule {
+    id: string;
+    name: string;
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    body: string | null;
+    cron: string;
+    enabled: boolean;
+    timeout_ms: number;
+    callback_url: string | null;
+    expected_status_codes: string | null;
+    expected_body_pattern: string | null;
+    notify_on_failure: boolean | null;
+    notify_on_recovery: boolean | null;
+    on_failure_url: string | null;
+    on_recovery_url: string | null;
+    script: string | null;
+    next_run_at: string | null;
+    inserted_at: string;
+    updated_at: string;
+}
+interface CreateScheduleOptions {
+    url: string;
+    cron: string;
+    name?: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: unknown;
+    timeout?: number;
+    callback?: string;
+    enabled?: boolean;
+    on_failure_url?: string;
+    on_recovery_url?: string;
+    expected_status_codes?: string;
+    expected_body_pattern?: string;
+    script?: string;
+}
+interface UpdateScheduleOptions {
+    name?: string;
+    url?: string;
+    method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+    headers?: Record<string, string>;
+    body?: string;
+    cron?: string;
+    timeout_ms?: number;
+    callback_url?: string;
+    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;
+    script?: string | null;
+}
 interface Task {
     id: string;
     name: string;
@@ -128,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;
@@ -199,12 +261,12 @@ interface PingResponse {
     monitor: string;
 }
 interface SyncOptions {
-    tasks?: CronOptions[];
+    schedules?: CronOptions[];
     monitors?: CreateMonitorOptions[];
     deleteRemoved?: boolean;
 }
 interface SyncResponse {
-    tasks: {
+    schedules: {
         created: string[];
         updated: string[];
         deleted: string[];
@@ -285,6 +347,7 @@ declare class Runlater {
     tasks: Tasks;
     monitors: Monitors;
     endpoints: Endpoints;
+    schedules: Schedules;
     constructor(options: RunlaterOptions | string);
     /**
      * Send a request immediately with reliable delivery and retries.
@@ -339,7 +402,7 @@ declare class Runlater {
      *
      * ```js
      * await rl.sync({
-     *   tasks: [
+     *   schedules: [
      *     { name: "daily-report", url: "https://...", schedule: "0 9 * * *" }
      *   ],
      *   deleteRemoved: true
@@ -366,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" } },
      *   ]
      * })
      * ```
@@ -397,6 +460,17 @@ declare class Tasks {
      */
     cancelQueue(queue: string): Promise<CancelQueueResponse>;
 }
+declare class Schedules {
+    private client;
+    constructor(client: Runlater);
+    list(options?: ListOptions): Promise<ListResponse<Schedule>>;
+    get(id: string): Promise<Schedule>;
+    create(options: CreateScheduleOptions): Promise<Schedule>;
+    update(id: string, options: UpdateScheduleOptions): Promise<Schedule>;
+    delete(id: string): Promise<void>;
+    trigger(id: string): Promise<TriggerResponse>;
+    executions(id: string, limit?: number): Promise<Execution[]>;
+}
 declare class Monitors {
     private client;
     constructor(client: Runlater);
@@ -422,4 +496,4 @@ declare class Endpoints {
     resume(id: string): Promise<Endpoint>;
 }
 
-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 };
+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

@@ -45,6 +45,7 @@ var Runlater = class {
   tasks;
   monitors;
   endpoints;
+  schedules;
   constructor(options) {
     if (typeof options === "string") {
       this.apiKey = options;
@@ -56,6 +57,7 @@ var Runlater = class {
     this.tasks = new Tasks(this);
     this.monitors = new Monitors(this);
     this.endpoints = new Endpoints(this);
+    this.schedules = new Schedules(this);
   }
   /**
    * Send a request immediately with reliable delivery and retries.
@@ -130,7 +132,7 @@ var Runlater = class {
    * ```
    */
   async cron(name, options) {
-    const res = await this.request("POST", "/tasks", {
+    const res = await this.request("POST", "/schedules", {
       body: {
         name,
         url: options.url,
@@ -153,7 +155,7 @@ var Runlater = class {
    *
    * ```js
    * await rl.sync({
-   *   tasks: [
+   *   schedules: [
    *     { name: "daily-report", url: "https://...", schedule: "0 9 * * *" }
    *   ],
    *   deleteRemoved: true
@@ -162,8 +164,8 @@ var Runlater = class {
    */
   async sync(options) {
     const body = {};
-    if (options.tasks) {
-      body.tasks = options.tasks.map((t) => ({
+    if (options.schedules) {
+      body.schedules = options.schedules.map((t) => ({
         name: t.url,
         // name defaults to url if not in CronOptions
         url: t.url,
@@ -220,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;
@@ -285,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,
@@ -343,6 +350,66 @@ var Tasks = class {
     return res.data;
   }
 };
+var Schedules = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit != null) params.set("limit", String(options.limit));
+    if (options.offset != null) params.set("offset", String(options.offset));
+    const query = params.toString();
+    return this.client.request("GET", `/schedules${query ? `?${query}` : ""}`);
+  }
+  async get(id) {
+    const res = await this.client.request("GET", `/schedules/${id}`);
+    return res.data;
+  }
+  async create(options) {
+    const res = await this.client.request("POST", "/schedules", {
+      body: {
+        name: options.name,
+        url: options.url,
+        method: options.method ?? "GET",
+        cron: options.cron,
+        headers: options.headers,
+        body: options.body != null ? JSON.stringify(options.body) : void 0,
+        timeout_ms: options.timeout,
+        callback_url: options.callback,
+        enabled: options.enabled,
+        expected_status_codes: options.expected_status_codes,
+        expected_body_pattern: options.expected_body_pattern,
+        on_failure_url: options.on_failure_url,
+        on_recovery_url: options.on_recovery_url,
+        script: options.script
+      }
+    });
+    return res.data;
+  }
+  async update(id, options) {
+    const res = await this.client.request("PUT", `/schedules/${id}`, {
+      body: options
+    });
+    return res.data;
+  }
+  async delete(id) {
+    await this.client.request("DELETE", `/schedules/${id}`);
+  }
+  async trigger(id) {
+    const res = await this.client.request(
+      "POST",
+      `/schedules/${id}/trigger`
+    );
+    return res.data;
+  }
+  async executions(id, limit = 50) {
+    const res = await this.client.request(
+      "GET",
+      `/schedules/${id}/executions?limit=${limit}`
+    );
+    return res.data;
+  }
+};
 var Monitors = class {
   constructor(client) {
     this.client = client;

package/dist/index.mjs

@@ -18,6 +18,7 @@ var Runlater = class {
   tasks;
   monitors;
   endpoints;
+  schedules;
   constructor(options) {
     if (typeof options === "string") {
       this.apiKey = options;
@@ -29,6 +30,7 @@ var Runlater = class {
     this.tasks = new Tasks(this);
     this.monitors = new Monitors(this);
     this.endpoints = new Endpoints(this);
+    this.schedules = new Schedules(this);
   }
   /**
    * Send a request immediately with reliable delivery and retries.
@@ -103,7 +105,7 @@ var Runlater = class {
    * ```
    */
   async cron(name, options) {
-    const res = await this.request("POST", "/tasks", {
+    const res = await this.request("POST", "/schedules", {
       body: {
         name,
         url: options.url,
@@ -126,7 +128,7 @@ var Runlater = class {
    *
    * ```js
    * await rl.sync({
-   *   tasks: [
+   *   schedules: [
    *     { name: "daily-report", url: "https://...", schedule: "0 9 * * *" }
    *   ],
    *   deleteRemoved: true
@@ -135,8 +137,8 @@ var Runlater = class {
    */
   async sync(options) {
     const body = {};
-    if (options.tasks) {
-      body.tasks = options.tasks.map((t) => ({
+    if (options.schedules) {
+      body.schedules = options.schedules.map((t) => ({
         name: t.url,
         // name defaults to url if not in CronOptions
         url: t.url,
@@ -193,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;
@@ -258,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,
@@ -316,6 +323,66 @@ var Tasks = class {
     return res.data;
   }
 };
+var Schedules = class {
+  constructor(client) {
+    this.client = client;
+  }
+  async list(options = {}) {
+    const params = new URLSearchParams();
+    if (options.limit != null) params.set("limit", String(options.limit));
+    if (options.offset != null) params.set("offset", String(options.offset));
+    const query = params.toString();
+    return this.client.request("GET", `/schedules${query ? `?${query}` : ""}`);
+  }
+  async get(id) {
+    const res = await this.client.request("GET", `/schedules/${id}`);
+    return res.data;
+  }
+  async create(options) {
+    const res = await this.client.request("POST", "/schedules", {
+      body: {
+        name: options.name,
+        url: options.url,
+        method: options.method ?? "GET",
+        cron: options.cron,
+        headers: options.headers,
+        body: options.body != null ? JSON.stringify(options.body) : void 0,
+        timeout_ms: options.timeout,
+        callback_url: options.callback,
+        enabled: options.enabled,
+        expected_status_codes: options.expected_status_codes,
+        expected_body_pattern: options.expected_body_pattern,
+        on_failure_url: options.on_failure_url,
+        on_recovery_url: options.on_recovery_url,
+        script: options.script
+      }
+    });
+    return res.data;
+  }
+  async update(id, options) {
+    const res = await this.client.request("PUT", `/schedules/${id}`, {
+      body: options
+    });
+    return res.data;
+  }
+  async delete(id) {
+    await this.client.request("DELETE", `/schedules/${id}`);
+  }
+  async trigger(id) {
+    const res = await this.client.request(
+      "POST",
+      `/schedules/${id}/trigger`
+    );
+    return res.data;
+  }
+  async executions(id, limit = 50) {
+    const res = await this.client.request(
+      "GET",
+      `/schedules/${id}/executions?limit=${limit}`
+    );
+    return res.data;
+  }
+};
 var Monitors = class {
   constructor(client) {
     this.client = client;

package/package.json

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