runlater-js 0.12.0 → 0.13.0

package/dist/index.d.mts

@@ -359,6 +359,7 @@ interface MqMessage {
     id: string;
     body: unknown;
     status: string;
+    run_at: string | null;
     receipt_handle: string | null;
     receive_count: number;
     locked_until: string | null;
@@ -366,6 +367,12 @@ interface MqMessage {
     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;
@@ -564,10 +571,12 @@ declare class MessageQueues {
     delete(slug: string): Promise<void>;
     /** Get queue statistics. */
     stats(slug: string): Promise<MqStats>;
-    /** Enqueue a single message. */
-    enqueue(slug: string, body: unknown): Promise<MqMessage>;
-    /** Enqueue multiple messages at once. */
-    enqueueBatch(slug: string, messages: unknown[]): Promise<{
+    /** 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. */
@@ -588,4 +597,4 @@ declare class MessageQueues {
     resume(slug: string): Promise<MessageQueue>;
 }
 
-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 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 };
+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

@@ -359,6 +359,7 @@ interface MqMessage {
     id: string;
     body: unknown;
     status: string;
+    run_at: string | null;
     receipt_handle: string | null;
     receive_count: number;
     locked_until: string | null;
@@ -366,6 +367,12 @@ interface MqMessage {
     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;
@@ -564,10 +571,12 @@ declare class MessageQueues {
     delete(slug: string): Promise<void>;
     /** Get queue statistics. */
     stats(slug: string): Promise<MqStats>;
-    /** Enqueue a single message. */
-    enqueue(slug: string, body: unknown): Promise<MqMessage>;
-    /** Enqueue multiple messages at once. */
-    enqueueBatch(slug: string, messages: unknown[]): Promise<{
+    /** 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. */
@@ -588,4 +597,4 @@ declare class MessageQueues {
     resume(slug: string): Promise<MessageQueue>;
 }
 
-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 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 };
+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

@@ -543,19 +543,28 @@ var MessageQueues = class {
     const res = await this.client.request("GET", `/mq/${slug}/stats`);
     return res.data;
   }
-  /** Enqueue a single message. */
-  async enqueue(slug, body) {
+  /** 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: { body }
+      body: payload
     });
     return res.data;
   }
-  /** Enqueue multiple messages at once. */
+  /** 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 } }
+      { body: { messages: formatted } }
     );
     return res.data;
   }

package/dist/index.mjs

@@ -516,19 +516,28 @@ var MessageQueues = class {
     const res = await this.client.request("GET", `/mq/${slug}/stats`);
     return res.data;
   }
-  /** Enqueue a single message. */
-  async enqueue(slug, body) {
+  /** 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: { body }
+      body: payload
     });
     return res.data;
   }
-  /** Enqueue multiple messages at once. */
+  /** 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 } }
+      { body: { messages: formatted } }
     );
     return res.data;
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runlater-js",
-  "version": "0.12.0",
+  "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",