runlater-js 0.11.0 → 0.13.0

package/README.md

@@ -1,6 +1,6 @@
 # runlater-js
 
-Official Node.js SDK for [Runlater](https://runlater.eu) — delayed tasks, cron jobs, and reliable webhooks for any Node.js app. No Redis. No infrastructure. Just HTTP.
+Official Node.js SDK for [Runlater](https://runlater.eu) — delayed tasks, cron jobs, message queues, and reliable webhooks for any Node.js app. No Redis. No infrastructure. Just HTTP.
 
 [Documentation](https://runlater.eu/docs) | [Dashboard](https://runlater.eu) | [npm](https://www.npmjs.com/package/runlater-js)
 
@@ -63,7 +63,7 @@ const result = await rl.send("https://myapp.com/api/webhook", {
   body: { key: "value" }, // automatically JSON-serialized
   retries: 5,             // default: server default
   timeout: 30000,         // ms, default: 30000
-  queue: "emails",        // optional: serialize execution within a queue
+  lane: "emails",         // optional: serialize execution within a lane
   callback: "https://myapp.com/api/on-complete", // optional: receive result
 })
 // => { task_id, execution_id, status, scheduled_for }
@@ -129,6 +129,62 @@ const executions = await rl.tasks.executions("task-id")
 await rl.tasks.delete("task-id")
 ```
 
+### Message queues
+
+Produce and consume messages with at-least-once delivery, visibility timeout, and dead-letter support.
+
+```js
+// Create a queue
+const queue = await rl.queues.create({
+  name: "order-events",
+  visibility_timeout_seconds: 30,
+  max_receives: 5,
+})
+
+// Enqueue a message
+await rl.queues.enqueue("order-events", { orderId: 123, action: "process" })
+
+// Enqueue multiple messages
+await rl.queues.enqueueBatch("order-events", [
+  { orderId: 124, action: "process" },
+  { orderId: 125, action: "process" },
+])
+
+// Receive messages (long-polling supported)
+const messages = await rl.queues.receive("order-events", { max: 5, wait: 10 })
+
+for (const msg of messages) {
+  // Process the message...
+  console.log(msg.body)
+
+  // Acknowledge when done
+  await rl.queues.ack("order-events", msg.receipt_handle)
+}
+
+// Nack a message to release it back to the queue
+await rl.queues.nack("order-events", msg.receipt_handle)
+
+// Batch acknowledge
+await rl.queues.ackBatch("order-events", ["receipt_1", "receipt_2"])
+
+// Get queue stats
+const stats = await rl.queues.stats("order-events")
+// => { available, locked, completed, dead, total, avg_time_in_queue_seconds, avg_processing_time_seconds }
+
+// List all queues
+const queues = await rl.queues.list()
+
+// Pause / resume
+await rl.queues.pause("order-events")
+await rl.queues.resume("order-events")
+
+// Browse messages
+const msgs = await rl.queues.messages("order-events", { status: "available", limit: 10 })
+
+// Delete a queue
+await rl.queues.delete("order-events")
+```
+
 ### Monitors (dead man's switch)
 
 ```js

package/dist/index.d.mts

@@ -8,7 +8,7 @@ interface SendOptions {
     body?: unknown;
     retries?: number;
     timeout?: number;
-    queue?: string;
+    lane?: string;
     callback?: string;
     idempotencyKey?: string;
     on_failure_url?: string;
@@ -31,7 +31,7 @@ interface CronOptions {
     body?: unknown;
     timeout?: number;
     retries?: number;
-    queue?: string;
+    lane?: string;
     callback?: string;
     enabled?: boolean;
     on_failure_url?: string;
@@ -126,7 +126,7 @@ interface Task {
     timeout_ms: number;
     retry_attempts: number;
     callback_url: string | null;
-    queue: string | null;
+    lane: string | null;
     notify_on_failure: boolean | null;
     notify_on_recovery: boolean | null;
     on_failure_url: string | null;
@@ -149,7 +149,7 @@ interface Execution {
     script_logs: string[];
 }
 interface ListOptions {
-    queue?: string;
+    lane?: string;
     limit?: number;
     offset?: number;
 }
@@ -192,7 +192,7 @@ interface BatchTask {
     name?: string;
 }
 interface BatchOptions {
-    queue: string;
+    lane: string;
     tasks: BatchTask[];
     method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
     headers?: Record<string, string>;
@@ -203,11 +203,11 @@ interface BatchOptions {
     callback?: string;
 }
 interface BatchResponse {
-    queue: string;
+    lane: string;
     created: number;
     scheduled_for: string;
 }
-interface CancelQueueResponse {
+interface CancelLaneResponse {
     cancelled: number;
 }
 interface UpdateTaskOptions {
@@ -221,7 +221,7 @@ interface UpdateTaskOptions {
     timeout_ms?: number;
     retry_attempts?: number;
     callback_url?: string;
-    queue?: string;
+    lane?: string;
     enabled?: boolean;
     notify_on_failure?: boolean | null;
     notify_on_recovery?: boolean | null;
@@ -289,7 +289,7 @@ interface Endpoint {
     enabled: boolean;
     paused: boolean;
     retry_attempts: number;
-    use_queue: boolean;
+    use_lane: boolean;
     notify_on_failure: boolean | null;
     notify_on_recovery: boolean | null;
     on_failure_url: string | null;
@@ -306,7 +306,7 @@ interface CreateEndpointOptions {
     name: string;
     forward_urls: string[];
     retry_attempts?: number;
-    use_queue?: boolean;
+    use_lane?: boolean;
     enabled?: boolean;
     forward_headers?: Record<string, string>;
     forward_body?: string;
@@ -318,7 +318,7 @@ interface UpdateEndpointOptions {
     name?: string;
     forward_urls?: string[];
     retry_attempts?: number;
-    use_queue?: boolean;
+    use_lane?: boolean;
     enabled?: boolean;
     forward_headers?: Record<string, string>;
     forward_body?: string;
@@ -335,6 +335,66 @@ interface InboundEvent {
     lua_rejected: boolean;
     lua_logs: string[];
 }
+interface MessageQueue {
+    id: string;
+    name: string;
+    slug: string;
+    visibility_timeout_seconds: number;
+    max_receives: number;
+    paused: boolean;
+    inserted_at: string;
+    updated_at: string;
+}
+interface CreateMessageQueueOptions {
+    name: string;
+    visibility_timeout_seconds?: number;
+    max_receives?: number;
+}
+interface UpdateMessageQueueOptions {
+    name?: string;
+    visibility_timeout_seconds?: number;
+    max_receives?: number;
+}
+interface MqMessage {
+    id: string;
+    body: unknown;
+    status: string;
+    run_at: string | null;
+    receipt_handle: string | null;
+    receive_count: number;
+    locked_until: string | null;
+    first_received_at: string | null;
+    completed_at: string | null;
+    inserted_at: string;
+}
+interface MqEnqueueOptions {
+    /** Delay before the message becomes available. Supports "30s", "5m", "2h", "1d" or seconds as number. Max 7 days. Mutually exclusive with run_at. */
+    delay?: string | number;
+    /** ISO 8601 datetime when the message becomes available. Must be future, max 7 days. Mutually exclusive with delay. */
+    run_at?: string;
+}
+interface MqStats {
+    available: number;
+    locked: number;
+    completed: number;
+    dead: number;
+    total: number;
+    avg_time_in_queue_seconds: number | null;
+    avg_processing_time_seconds: number | null;
+}
+interface MqReceiveOptions {
+    max?: number;
+    wait?: number;
+}
+interface MqListMessagesOptions {
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+interface MqBatchAckResponse {
+    acknowledged: number;
+    failed: number;
+}
 declare class RunlaterError extends Error {
     status: number;
     code: string;
@@ -348,6 +408,7 @@ declare class Runlater {
     monitors: Monitors;
     endpoints: Endpoints;
     schedules: Schedules;
+    queues: MessageQueues;
     constructor(options: RunlaterOptions | string);
     /**
      * Send a request immediately with reliable delivery and retries.
@@ -433,11 +494,11 @@ declare class Tasks {
      * optionally override method, headers, body, and name. Top-level
      * settings serve as defaults.
      *
-     * Use the queue name with `cancelQueue()` to cancel them as a group.
+     * Use the lane name with `cancelLane()` to cancel them as a group.
      *
      * ```js
      * await rl.tasks.batch({
-     *   queue: "march-newsletter",
+     *   lane: "march-newsletter",
      *   method: "POST",
      *   run_at: "2026-03-01T09:00:00Z",
      *   tasks: [
@@ -449,16 +510,16 @@ declare class Tasks {
      */
     batch(options: BatchOptions): Promise<BatchResponse>;
     /**
-     * Cancel all tasks in a queue.
+     * Cancel all tasks in a lane.
      *
-     * Soft-deletes every task in the queue and removes their pending executions.
+     * Soft-deletes every task in the lane and removes their pending executions.
      *
      * ```js
-     * const { cancelled } = await rl.tasks.cancelQueue("march-newsletter")
+     * const { cancelled } = await rl.tasks.cancelLane("march-newsletter")
      * console.log(`Cancelled ${cancelled} tasks`)
      * ```
      */
-    cancelQueue(queue: string): Promise<CancelQueueResponse>;
+    cancelLane(lane: string): Promise<CancelLaneResponse>;
 }
 declare class Schedules {
     private client;
@@ -495,5 +556,45 @@ declare class Endpoints {
     pause(id: string): Promise<Endpoint>;
     resume(id: string): Promise<Endpoint>;
 }
+declare class MessageQueues {
+    private client;
+    constructor(client: Runlater);
+    /** List all message queues. */
+    list(): Promise<MessageQueue[]>;
+    /** Create a new message queue. */
+    create(options: CreateMessageQueueOptions): Promise<MessageQueue>;
+    /** Get a message queue by slug. */
+    get(slug: string): Promise<MessageQueue>;
+    /** Update a message queue. */
+    update(slug: string, options: UpdateMessageQueueOptions): Promise<MessageQueue>;
+    /** Delete a message queue. */
+    delete(slug: string): Promise<void>;
+    /** Get queue statistics. */
+    stats(slug: string): Promise<MqStats>;
+    /** Enqueue a single message. Optionally delay or schedule for a future time. */
+    enqueue(slug: string, body: unknown, options?: MqEnqueueOptions): Promise<MqMessage>;
+    /** Enqueue multiple messages at once. Each message can have its own delay/run_at. */
+    enqueueBatch(slug: string, messages: Array<{
+        body: unknown;
+    } & MqEnqueueOptions>): Promise<{
+        enqueued: number;
+    }>;
+    /** Receive messages from the queue. */
+    receive(slug: string, options?: MqReceiveOptions): Promise<MqMessage[]>;
+    /** Acknowledge (complete) a message by receipt handle. */
+    ack(slug: string, receiptHandle: string): Promise<void>;
+    /** Nack (release) a message back to the queue. */
+    nack(slug: string, receiptHandle: string): Promise<void>;
+    /** Acknowledge multiple messages at once. */
+    ackBatch(slug: string, receiptHandles: string[]): Promise<MqBatchAckResponse>;
+    /** List messages in the queue with optional filtering. */
+    messages(slug: string, options?: MqListMessagesOptions): Promise<MqMessage[]>;
+    /** Get a specific message by ID. */
+    getMessage(slug: string, id: string): Promise<MqMessage>;
+    /** Pause the queue. */
+    pause(slug: string): Promise<MessageQueue>;
+    /** Resume a paused queue. */
+    resume(slug: string): Promise<MessageQueue>;
+}
 
-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 };
+export { type BatchOptions, type BatchResponse, type BatchTask, type CancelLaneResponse, type CreateEndpointOptions, type CreateMessageQueueOptions, type CreateMonitorOptions, type CreateScheduleOptions, type CronOptions, type CronResponse, type DelayOptions, type Endpoint, type Execution, type InboundEvent, type ListOptions, type ListResponse, type MessageQueue, type Monitor, type MqBatchAckResponse, type MqEnqueueOptions, type MqListMessagesOptions, type MqMessage, type MqReceiveOptions, type MqStats, 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 UpdateMessageQueueOptions, type UpdateMonitorOptions, type UpdateScheduleOptions, type UpdateTaskOptions };

package/dist/index.d.ts

@@ -8,7 +8,7 @@ interface SendOptions {
     body?: unknown;
     retries?: number;
     timeout?: number;
-    queue?: string;
+    lane?: string;
     callback?: string;
     idempotencyKey?: string;
     on_failure_url?: string;
@@ -31,7 +31,7 @@ interface CronOptions {
     body?: unknown;
     timeout?: number;
     retries?: number;
-    queue?: string;
+    lane?: string;
     callback?: string;
     enabled?: boolean;
     on_failure_url?: string;
@@ -126,7 +126,7 @@ interface Task {
     timeout_ms: number;
     retry_attempts: number;
     callback_url: string | null;
-    queue: string | null;
+    lane: string | null;
     notify_on_failure: boolean | null;
     notify_on_recovery: boolean | null;
     on_failure_url: string | null;
@@ -149,7 +149,7 @@ interface Execution {
     script_logs: string[];
 }
 interface ListOptions {
-    queue?: string;
+    lane?: string;
     limit?: number;
     offset?: number;
 }
@@ -192,7 +192,7 @@ interface BatchTask {
     name?: string;
 }
 interface BatchOptions {
-    queue: string;
+    lane: string;
     tasks: BatchTask[];
     method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
     headers?: Record<string, string>;
@@ -203,11 +203,11 @@ interface BatchOptions {
     callback?: string;
 }
 interface BatchResponse {
-    queue: string;
+    lane: string;
     created: number;
     scheduled_for: string;
 }
-interface CancelQueueResponse {
+interface CancelLaneResponse {
     cancelled: number;
 }
 interface UpdateTaskOptions {
@@ -221,7 +221,7 @@ interface UpdateTaskOptions {
     timeout_ms?: number;
     retry_attempts?: number;
     callback_url?: string;
-    queue?: string;
+    lane?: string;
     enabled?: boolean;
     notify_on_failure?: boolean | null;
     notify_on_recovery?: boolean | null;
@@ -289,7 +289,7 @@ interface Endpoint {
     enabled: boolean;
     paused: boolean;
     retry_attempts: number;
-    use_queue: boolean;
+    use_lane: boolean;
     notify_on_failure: boolean | null;
     notify_on_recovery: boolean | null;
     on_failure_url: string | null;
@@ -306,7 +306,7 @@ interface CreateEndpointOptions {
     name: string;
     forward_urls: string[];
     retry_attempts?: number;
-    use_queue?: boolean;
+    use_lane?: boolean;
     enabled?: boolean;
     forward_headers?: Record<string, string>;
     forward_body?: string;
@@ -318,7 +318,7 @@ interface UpdateEndpointOptions {
     name?: string;
     forward_urls?: string[];
     retry_attempts?: number;
-    use_queue?: boolean;
+    use_lane?: boolean;
     enabled?: boolean;
     forward_headers?: Record<string, string>;
     forward_body?: string;
@@ -335,6 +335,66 @@ interface InboundEvent {
     lua_rejected: boolean;
     lua_logs: string[];
 }
+interface MessageQueue {
+    id: string;
+    name: string;
+    slug: string;
+    visibility_timeout_seconds: number;
+    max_receives: number;
+    paused: boolean;
+    inserted_at: string;
+    updated_at: string;
+}
+interface CreateMessageQueueOptions {
+    name: string;
+    visibility_timeout_seconds?: number;
+    max_receives?: number;
+}
+interface UpdateMessageQueueOptions {
+    name?: string;
+    visibility_timeout_seconds?: number;
+    max_receives?: number;
+}
+interface MqMessage {
+    id: string;
+    body: unknown;
+    status: string;
+    run_at: string | null;
+    receipt_handle: string | null;
+    receive_count: number;
+    locked_until: string | null;
+    first_received_at: string | null;
+    completed_at: string | null;
+    inserted_at: string;
+}
+interface MqEnqueueOptions {
+    /** Delay before the message becomes available. Supports "30s", "5m", "2h", "1d" or seconds as number. Max 7 days. Mutually exclusive with run_at. */
+    delay?: string | number;
+    /** ISO 8601 datetime when the message becomes available. Must be future, max 7 days. Mutually exclusive with delay. */
+    run_at?: string;
+}
+interface MqStats {
+    available: number;
+    locked: number;
+    completed: number;
+    dead: number;
+    total: number;
+    avg_time_in_queue_seconds: number | null;
+    avg_processing_time_seconds: number | null;
+}
+interface MqReceiveOptions {
+    max?: number;
+    wait?: number;
+}
+interface MqListMessagesOptions {
+    status?: string;
+    limit?: number;
+    offset?: number;
+}
+interface MqBatchAckResponse {
+    acknowledged: number;
+    failed: number;
+}
 declare class RunlaterError extends Error {
     status: number;
     code: string;
@@ -348,6 +408,7 @@ declare class Runlater {
     monitors: Monitors;
     endpoints: Endpoints;
     schedules: Schedules;
+    queues: MessageQueues;
     constructor(options: RunlaterOptions | string);
     /**
      * Send a request immediately with reliable delivery and retries.
@@ -433,11 +494,11 @@ declare class Tasks {
      * optionally override method, headers, body, and name. Top-level
      * settings serve as defaults.
      *
-     * Use the queue name with `cancelQueue()` to cancel them as a group.
+     * Use the lane name with `cancelLane()` to cancel them as a group.
      *
      * ```js
      * await rl.tasks.batch({
-     *   queue: "march-newsletter",
+     *   lane: "march-newsletter",
      *   method: "POST",
      *   run_at: "2026-03-01T09:00:00Z",
      *   tasks: [
@@ -449,16 +510,16 @@ declare class Tasks {
      */
     batch(options: BatchOptions): Promise<BatchResponse>;
     /**
-     * Cancel all tasks in a queue.
+     * Cancel all tasks in a lane.
      *
-     * Soft-deletes every task in the queue and removes their pending executions.
+     * Soft-deletes every task in the lane and removes their pending executions.
      *
      * ```js
-     * const { cancelled } = await rl.tasks.cancelQueue("march-newsletter")
+     * const { cancelled } = await rl.tasks.cancelLane("march-newsletter")
      * console.log(`Cancelled ${cancelled} tasks`)
      * ```
      */
-    cancelQueue(queue: string): Promise<CancelQueueResponse>;
+    cancelLane(lane: string): Promise<CancelLaneResponse>;
 }
 declare class Schedules {
     private client;
@@ -495,5 +556,45 @@ declare class Endpoints {
     pause(id: string): Promise<Endpoint>;
     resume(id: string): Promise<Endpoint>;
 }
+declare class MessageQueues {
+    private client;
+    constructor(client: Runlater);
+    /** List all message queues. */
+    list(): Promise<MessageQueue[]>;
+    /** Create a new message queue. */
+    create(options: CreateMessageQueueOptions): Promise<MessageQueue>;
+    /** Get a message queue by slug. */
+    get(slug: string): Promise<MessageQueue>;
+    /** Update a message queue. */
+    update(slug: string, options: UpdateMessageQueueOptions): Promise<MessageQueue>;
+    /** Delete a message queue. */
+    delete(slug: string): Promise<void>;
+    /** Get queue statistics. */
+    stats(slug: string): Promise<MqStats>;
+    /** Enqueue a single message. Optionally delay or schedule for a future time. */
+    enqueue(slug: string, body: unknown, options?: MqEnqueueOptions): Promise<MqMessage>;
+    /** Enqueue multiple messages at once. Each message can have its own delay/run_at. */
+    enqueueBatch(slug: string, messages: Array<{
+        body: unknown;
+    } & MqEnqueueOptions>): Promise<{
+        enqueued: number;
+    }>;
+    /** Receive messages from the queue. */
+    receive(slug: string, options?: MqReceiveOptions): Promise<MqMessage[]>;
+    /** Acknowledge (complete) a message by receipt handle. */
+    ack(slug: string, receiptHandle: string): Promise<void>;
+    /** Nack (release) a message back to the queue. */
+    nack(slug: string, receiptHandle: string): Promise<void>;
+    /** Acknowledge multiple messages at once. */
+    ackBatch(slug: string, receiptHandles: string[]): Promise<MqBatchAckResponse>;
+    /** List messages in the queue with optional filtering. */
+    messages(slug: string, options?: MqListMessagesOptions): Promise<MqMessage[]>;
+    /** Get a specific message by ID. */
+    getMessage(slug: string, id: string): Promise<MqMessage>;
+    /** Pause the queue. */
+    pause(slug: string): Promise<MessageQueue>;
+    /** Resume a paused queue. */
+    resume(slug: string): Promise<MessageQueue>;
+}
 
-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 };
+export { type BatchOptions, type BatchResponse, type BatchTask, type CancelLaneResponse, type CreateEndpointOptions, type CreateMessageQueueOptions, type CreateMonitorOptions, type CreateScheduleOptions, type CronOptions, type CronResponse, type DelayOptions, type Endpoint, type Execution, type InboundEvent, type ListOptions, type ListResponse, type MessageQueue, type Monitor, type MqBatchAckResponse, type MqEnqueueOptions, type MqListMessagesOptions, type MqMessage, type MqReceiveOptions, type MqStats, 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 UpdateMessageQueueOptions, type UpdateMonitorOptions, type UpdateScheduleOptions, type UpdateTaskOptions };

package/dist/index.js

@@ -46,6 +46,7 @@ var Runlater = class {
   monitors;
   endpoints;
   schedules;
+  queues;
   constructor(options) {
     if (typeof options === "string") {
       this.apiKey = options;
@@ -58,6 +59,7 @@ var Runlater = class {
     this.monitors = new Monitors(this);
     this.endpoints = new Endpoints(this);
     this.schedules = new Schedules(this);
+    this.queues = new MessageQueues(this);
   }
   /**
    * Send a request immediately with reliable delivery and retries.
@@ -142,7 +144,7 @@ var Runlater = class {
         body: options.body != null ? JSON.stringify(options.body) : void 0,
         timeout_ms: options.timeout,
         retry_attempts: options.retries,
-        queue: options.queue,
+        lane: options.lane,
         callback_url: options.callback,
         enabled: options.enabled,
         script: options.script
@@ -175,7 +177,7 @@ var Runlater = class {
         body: t.body != null ? JSON.stringify(t.body) : void 0,
         timeout_ms: t.timeout,
         retry_attempts: t.retries,
-        queue: t.queue,
+        lane: t.lane,
         callback_url: t.callback,
         enabled: t.enabled,
         script: t.script
@@ -210,7 +212,7 @@ var Runlater = class {
       body: options.body != null ? JSON.stringify(options.body) : void 0,
       timeout_ms: options.timeout,
       retry_attempts: options.retries,
-      queue: options.queue,
+      lane: options.lane,
       callback_url: options.callback,
       script: options.script,
       debounce: options.debounce != null ? formatDelay(options.debounce) : void 0,
@@ -222,7 +224,7 @@ var Runlater = class {
     const headers = {
       Authorization: `Bearer ${this.apiKey}`,
       "Content-Type": "application/json",
-      "User-Agent": "runlater-js/0.11.0"
+      "User-Agent": "runlater-js/0.12.0"
     };
     if (options.idempotencyKey) {
       headers["Idempotency-Key"] = options.idempotencyKey;
@@ -253,7 +255,7 @@ var Tasks = class {
   }
   async list(options = {}) {
     const params = new URLSearchParams();
-    if (options.queue != null) params.set("queue", options.queue);
+    if (options.lane != null) params.set("lane", options.lane);
     if (options.limit != null) params.set("limit", String(options.limit));
     if (options.offset != null) params.set("offset", String(options.offset));
     const query = params.toString();
@@ -291,11 +293,11 @@ var Tasks = class {
    * optionally override method, headers, body, and name. Top-level
    * settings serve as defaults.
    *
-   * Use the queue name with `cancelQueue()` to cancel them as a group.
+   * Use the lane name with `cancelLane()` to cancel them as a group.
    *
    * ```js
    * await rl.tasks.batch({
-   *   queue: "march-newsletter",
+   *   lane: "march-newsletter",
    *   method: "POST",
    *   run_at: "2026-03-01T09:00:00Z",
    *   tasks: [
@@ -307,7 +309,7 @@ var Tasks = class {
    */
   async batch(options) {
     const body = {
-      queue: options.queue,
+      lane: options.lane,
       tasks: options.tasks.map((t) => ({
         url: t.url,
         method: t.method,
@@ -333,19 +335,19 @@ var Tasks = class {
     return res.data;
   }
   /**
-   * Cancel all tasks in a queue.
+   * Cancel all tasks in a lane.
    *
-   * Soft-deletes every task in the queue and removes their pending executions.
+   * Soft-deletes every task in the lane and removes their pending executions.
    *
    * ```js
-   * const { cancelled } = await rl.tasks.cancelQueue("march-newsletter")
+   * const { cancelled } = await rl.tasks.cancelLane("march-newsletter")
    * console.log(`Cancelled ${cancelled} tasks`)
    * ```
    */
-  async cancelQueue(queue) {
+  async cancelLane(lane) {
     const res = await this.client.request(
       "DELETE",
-      `/tasks?queue=${encodeURIComponent(queue)}`
+      `/tasks?lane=${encodeURIComponent(lane)}`
     );
     return res.data;
   }
@@ -504,6 +506,135 @@ var Endpoints = class {
     return res.data;
   }
 };
+var MessageQueues = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List all message queues. */
+  async list() {
+    const res = await this.client.request("GET", "/mq");
+    return res.data;
+  }
+  /** Create a new message queue. */
+  async create(options) {
+    const res = await this.client.request("POST", "/mq", {
+      body: options
+    });
+    return res.data;
+  }
+  /** Get a message queue by slug. */
+  async get(slug) {
+    const res = await this.client.request("GET", `/mq/${slug}`);
+    return res.data;
+  }
+  /** Update a message queue. */
+  async update(slug, options) {
+    const res = await this.client.request("PATCH", `/mq/${slug}`, {
+      body: options
+    });
+    return res.data;
+  }
+  /** Delete a message queue. */
+  async delete(slug) {
+    await this.client.request("DELETE", `/mq/${slug}`);
+  }
+  /** Get queue statistics. */
+  async stats(slug) {
+    const res = await this.client.request("GET", `/mq/${slug}/stats`);
+    return res.data;
+  }
+  /** Enqueue a single message. Optionally delay or schedule for a future time. */
+  async enqueue(slug, body, options) {
+    const payload = { body };
+    if (options?.delay != null) payload.delay = formatDelay(options.delay);
+    if (options?.run_at != null) payload.run_at = options.run_at;
+    const res = await this.client.request("POST", `/mq/${slug}/messages`, {
+      body: payload
+    });
+    return res.data;
+  }
+  /** Enqueue multiple messages at once. Each message can have its own delay/run_at. */
+  async enqueueBatch(slug, messages) {
+    const formatted = messages.map((m) => {
+      const msg = { body: m.body };
+      if (m.delay != null) msg.delay = formatDelay(m.delay);
+      if (m.run_at != null) msg.run_at = m.run_at;
+      return msg;
+    });
+    const res = await this.client.request(
+      "POST",
+      `/mq/${slug}/messages/batch`,
+      { body: { messages: formatted } }
+    );
+    return res.data;
+  }
+  /** Receive messages from the queue. */
+  async receive(slug, options = {}) {
+    const params = new URLSearchParams();
+    if (options.max != null) params.set("max", String(options.max));
+    if (options.wait != null) params.set("wait", String(options.wait));
+    const query = params.toString();
+    const res = await this.client.request(
+      "GET",
+      `/mq/${slug}/receive${query ? `?${query}` : ""}`
+    );
+    return res.data;
+  }
+  /** Acknowledge (complete) a message by receipt handle. */
+  async ack(slug, receiptHandle) {
+    await this.client.request("DELETE", `/mq/${slug}/ack/${receiptHandle}`);
+  }
+  /** Nack (release) a message back to the queue. */
+  async nack(slug, receiptHandle) {
+    await this.client.request("POST", `/mq/${slug}/nack/${receiptHandle}`);
+  }
+  /** Acknowledge multiple messages at once. */
+  async ackBatch(slug, receiptHandles) {
+    const res = await this.client.request(
+      "POST",
+      `/mq/${slug}/ack/batch`,
+      { body: { receipt_handles: receiptHandles } }
+    );
+    return res.data;
+  }
+  /** List messages in the queue with optional filtering. */
+  async messages(slug, options = {}) {
+    const params = new URLSearchParams();
+    if (options.status != null) params.set("status", options.status);
+    if (options.limit != null) params.set("limit", String(options.limit));
+    if (options.offset != null) params.set("offset", String(options.offset));
+    const query = params.toString();
+    const res = await this.client.request(
+      "GET",
+      `/mq/${slug}/messages${query ? `?${query}` : ""}`
+    );
+    return res.data;
+  }
+  /** Get a specific message by ID. */
+  async getMessage(slug, id) {
+    const res = await this.client.request(
+      "GET",
+      `/mq/${slug}/messages/${id}`
+    );
+    return res.data;
+  }
+  /** Pause the queue. */
+  async pause(slug) {
+    const res = await this.client.request(
+      "POST",
+      `/mq/${slug}/pause`
+    );
+    return res.data;
+  }
+  /** Resume a paused queue. */
+  async resume(slug) {
+    const res = await this.client.request(
+      "POST",
+      `/mq/${slug}/resume`
+    );
+    return res.data;
+  }
+};
 function formatDelay(delay) {
   if (typeof delay === "number") return `${delay}s`;
   return delay;

package/dist/index.mjs

@@ -19,6 +19,7 @@ var Runlater = class {
   monitors;
   endpoints;
   schedules;
+  queues;
   constructor(options) {
     if (typeof options === "string") {
       this.apiKey = options;
@@ -31,6 +32,7 @@ var Runlater = class {
     this.monitors = new Monitors(this);
     this.endpoints = new Endpoints(this);
     this.schedules = new Schedules(this);
+    this.queues = new MessageQueues(this);
   }
   /**
    * Send a request immediately with reliable delivery and retries.
@@ -115,7 +117,7 @@ var Runlater = class {
         body: options.body != null ? JSON.stringify(options.body) : void 0,
         timeout_ms: options.timeout,
         retry_attempts: options.retries,
-        queue: options.queue,
+        lane: options.lane,
         callback_url: options.callback,
         enabled: options.enabled,
         script: options.script
@@ -148,7 +150,7 @@ var Runlater = class {
         body: t.body != null ? JSON.stringify(t.body) : void 0,
         timeout_ms: t.timeout,
         retry_attempts: t.retries,
-        queue: t.queue,
+        lane: t.lane,
         callback_url: t.callback,
         enabled: t.enabled,
         script: t.script
@@ -183,7 +185,7 @@ var Runlater = class {
       body: options.body != null ? JSON.stringify(options.body) : void 0,
       timeout_ms: options.timeout,
       retry_attempts: options.retries,
-      queue: options.queue,
+      lane: options.lane,
       callback_url: options.callback,
       script: options.script,
       debounce: options.debounce != null ? formatDelay(options.debounce) : void 0,
@@ -195,7 +197,7 @@ var Runlater = class {
     const headers = {
       Authorization: `Bearer ${this.apiKey}`,
       "Content-Type": "application/json",
-      "User-Agent": "runlater-js/0.11.0"
+      "User-Agent": "runlater-js/0.12.0"
     };
     if (options.idempotencyKey) {
       headers["Idempotency-Key"] = options.idempotencyKey;
@@ -226,7 +228,7 @@ var Tasks = class {
   }
   async list(options = {}) {
     const params = new URLSearchParams();
-    if (options.queue != null) params.set("queue", options.queue);
+    if (options.lane != null) params.set("lane", options.lane);
     if (options.limit != null) params.set("limit", String(options.limit));
     if (options.offset != null) params.set("offset", String(options.offset));
     const query = params.toString();
@@ -264,11 +266,11 @@ var Tasks = class {
    * optionally override method, headers, body, and name. Top-level
    * settings serve as defaults.
    *
-   * Use the queue name with `cancelQueue()` to cancel them as a group.
+   * Use the lane name with `cancelLane()` to cancel them as a group.
    *
    * ```js
    * await rl.tasks.batch({
-   *   queue: "march-newsletter",
+   *   lane: "march-newsletter",
    *   method: "POST",
    *   run_at: "2026-03-01T09:00:00Z",
    *   tasks: [
@@ -280,7 +282,7 @@ var Tasks = class {
    */
   async batch(options) {
     const body = {
-      queue: options.queue,
+      lane: options.lane,
       tasks: options.tasks.map((t) => ({
         url: t.url,
         method: t.method,
@@ -306,19 +308,19 @@ var Tasks = class {
     return res.data;
   }
   /**
-   * Cancel all tasks in a queue.
+   * Cancel all tasks in a lane.
    *
-   * Soft-deletes every task in the queue and removes their pending executions.
+   * Soft-deletes every task in the lane and removes their pending executions.
    *
    * ```js
-   * const { cancelled } = await rl.tasks.cancelQueue("march-newsletter")
+   * const { cancelled } = await rl.tasks.cancelLane("march-newsletter")
    * console.log(`Cancelled ${cancelled} tasks`)
    * ```
    */
-  async cancelQueue(queue) {
+  async cancelLane(lane) {
     const res = await this.client.request(
       "DELETE",
-      `/tasks?queue=${encodeURIComponent(queue)}`
+      `/tasks?lane=${encodeURIComponent(lane)}`
     );
     return res.data;
   }
@@ -477,6 +479,135 @@ var Endpoints = class {
     return res.data;
   }
 };
+var MessageQueues = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /** List all message queues. */
+  async list() {
+    const res = await this.client.request("GET", "/mq");
+    return res.data;
+  }
+  /** Create a new message queue. */
+  async create(options) {
+    const res = await this.client.request("POST", "/mq", {
+      body: options
+    });
+    return res.data;
+  }
+  /** Get a message queue by slug. */
+  async get(slug) {
+    const res = await this.client.request("GET", `/mq/${slug}`);
+    return res.data;
+  }
+  /** Update a message queue. */
+  async update(slug, options) {
+    const res = await this.client.request("PATCH", `/mq/${slug}`, {
+      body: options
+    });
+    return res.data;
+  }
+  /** Delete a message queue. */
+  async delete(slug) {
+    await this.client.request("DELETE", `/mq/${slug}`);
+  }
+  /** Get queue statistics. */
+  async stats(slug) {
+    const res = await this.client.request("GET", `/mq/${slug}/stats`);
+    return res.data;
+  }
+  /** Enqueue a single message. Optionally delay or schedule for a future time. */
+  async enqueue(slug, body, options) {
+    const payload = { body };
+    if (options?.delay != null) payload.delay = formatDelay(options.delay);
+    if (options?.run_at != null) payload.run_at = options.run_at;
+    const res = await this.client.request("POST", `/mq/${slug}/messages`, {
+      body: payload
+    });
+    return res.data;
+  }
+  /** Enqueue multiple messages at once. Each message can have its own delay/run_at. */
+  async enqueueBatch(slug, messages) {
+    const formatted = messages.map((m) => {
+      const msg = { body: m.body };
+      if (m.delay != null) msg.delay = formatDelay(m.delay);
+      if (m.run_at != null) msg.run_at = m.run_at;
+      return msg;
+    });
+    const res = await this.client.request(
+      "POST",
+      `/mq/${slug}/messages/batch`,
+      { body: { messages: formatted } }
+    );
+    return res.data;
+  }
+  /** Receive messages from the queue. */
+  async receive(slug, options = {}) {
+    const params = new URLSearchParams();
+    if (options.max != null) params.set("max", String(options.max));
+    if (options.wait != null) params.set("wait", String(options.wait));
+    const query = params.toString();
+    const res = await this.client.request(
+      "GET",
+      `/mq/${slug}/receive${query ? `?${query}` : ""}`
+    );
+    return res.data;
+  }
+  /** Acknowledge (complete) a message by receipt handle. */
+  async ack(slug, receiptHandle) {
+    await this.client.request("DELETE", `/mq/${slug}/ack/${receiptHandle}`);
+  }
+  /** Nack (release) a message back to the queue. */
+  async nack(slug, receiptHandle) {
+    await this.client.request("POST", `/mq/${slug}/nack/${receiptHandle}`);
+  }
+  /** Acknowledge multiple messages at once. */
+  async ackBatch(slug, receiptHandles) {
+    const res = await this.client.request(
+      "POST",
+      `/mq/${slug}/ack/batch`,
+      { body: { receipt_handles: receiptHandles } }
+    );
+    return res.data;
+  }
+  /** List messages in the queue with optional filtering. */
+  async messages(slug, options = {}) {
+    const params = new URLSearchParams();
+    if (options.status != null) params.set("status", options.status);
+    if (options.limit != null) params.set("limit", String(options.limit));
+    if (options.offset != null) params.set("offset", String(options.offset));
+    const query = params.toString();
+    const res = await this.client.request(
+      "GET",
+      `/mq/${slug}/messages${query ? `?${query}` : ""}`
+    );
+    return res.data;
+  }
+  /** Get a specific message by ID. */
+  async getMessage(slug, id) {
+    const res = await this.client.request(
+      "GET",
+      `/mq/${slug}/messages/${id}`
+    );
+    return res.data;
+  }
+  /** Pause the queue. */
+  async pause(slug) {
+    const res = await this.client.request(
+      "POST",
+      `/mq/${slug}/pause`
+    );
+    return res.data;
+  }
+  /** Resume a paused queue. */
+  async resume(slug) {
+    const res = await this.client.request(
+      "POST",
+      `/mq/${slug}/resume`
+    );
+    return res.data;
+  }
+};
 function formatDelay(delay) {
   if (typeof delay === "number") return `${delay}s`;
   return delay;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "runlater-js",
-  "version": "0.11.0",
-  "description": "Delayed tasks, cron jobs, and reliable webhooks. No infrastructure required.",
+  "version": "0.13.0",
+  "description": "Delayed tasks, cron jobs, message queues, and reliable webhooks. No infrastructure required.",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
   "types": "./dist/index.d.ts",