@parsrun/queue 0.1.0

package/dist/adapters/qstash.js

@@ -0,0 +1,379 @@
+// src/types.ts
+import {
+  type,
+  jobStatus,
+  job,
+  jobOptions,
+  addJobRequest,
+  jobProgressUpdate,
+  queueStats,
+  queueListOptions,
+  redisQueueConfig,
+  workerOptions,
+  queueConfig
+} from "@parsrun/types";
+var QueueError = class extends Error {
+  constructor(message, code, cause) {
+    super(message);
+    this.code = code;
+    this.cause = cause;
+    this.name = "QueueError";
+  }
+};
+var QueueErrorCodes = {
+  SEND_FAILED: "SEND_FAILED",
+  RECEIVE_FAILED: "RECEIVE_FAILED",
+  ACK_FAILED: "ACK_FAILED",
+  INVALID_CONFIG: "INVALID_CONFIG",
+  QUEUE_FULL: "QUEUE_FULL",
+  MESSAGE_NOT_FOUND: "MESSAGE_NOT_FOUND",
+  NOT_IMPLEMENTED: "NOT_IMPLEMENTED"
+};
+
+// src/adapters/qstash.ts
+var QStashAdapter = class {
+  type = "qstash";
+  name = "qstash";
+  token;
+  destinationUrl;
+  baseUrl = "https://qstash.upstash.io/v2";
+  constructor(config) {
+    this.token = config.token;
+    this.destinationUrl = config.destinationUrl;
+  }
+  async send(body, options) {
+    try {
+      const headers = {
+        Authorization: `Bearer ${this.token}`,
+        "Content-Type": "application/json"
+      };
+      if (options?.delaySeconds) {
+        headers["Upstash-Delay"] = `${options.delaySeconds}s`;
+      }
+      if (options?.deduplicationId) {
+        headers["Upstash-Deduplication-Id"] = options.deduplicationId;
+      }
+      if (options?.metadata) {
+        for (const [key, value] of Object.entries(options.metadata)) {
+          if (typeof value === "string") {
+            headers[`Upstash-Forward-${key}`] = value;
+          }
+        }
+      }
+      const response = await fetch(
+        `${this.baseUrl}/publish/${encodeURIComponent(this.destinationUrl)}`,
+        {
+          method: "POST",
+          headers,
+          body: JSON.stringify(body)
+        }
+      );
+      if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`QStash API error: ${error}`);
+      }
+      const result = await response.json();
+      return result.messageId;
+    } catch (err) {
+      throw new QueueError(
+        `QStash send failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        QueueErrorCodes.SEND_FAILED,
+        err
+      );
+    }
+  }
+  async sendBatch(messages) {
+    try {
+      const batchMessages = messages.map((m) => {
+        const headers = {
+          "Content-Type": "application/json"
+        };
+        if (m.options?.delaySeconds) {
+          headers["Upstash-Delay"] = `${m.options.delaySeconds}s`;
+        }
+        if (m.options?.deduplicationId) {
+          headers["Upstash-Deduplication-Id"] = m.options.deduplicationId;
+        }
+        return {
+          destination: this.destinationUrl,
+          headers,
+          body: JSON.stringify(m.body)
+        };
+      });
+      const response = await fetch(`${this.baseUrl}/batch`, {
+        method: "POST",
+        headers: {
+          Authorization: `Bearer ${this.token}`,
+          "Content-Type": "application/json"
+        },
+        body: JSON.stringify(batchMessages)
+      });
+      if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`QStash API error: ${error}`);
+      }
+      const results = await response.json();
+      const messageIds = [];
+      const errors = [];
+      let successful = 0;
+      let failed = 0;
+      for (let i = 0; i < results.length; i++) {
+        const result = results[i];
+        if (result?.messageId) {
+          messageIds.push(result.messageId);
+          successful++;
+        } else {
+          failed++;
+          errors.push({
+            index: i,
+            error: result?.error ?? "Unknown error"
+          });
+        }
+      }
+      return {
+        total: messages.length,
+        successful,
+        failed,
+        messageIds,
+        errors
+      };
+    } catch (err) {
+      throw new QueueError(
+        `QStash batch send failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        QueueErrorCodes.SEND_FAILED,
+        err
+      );
+    }
+  }
+  /**
+   * Schedule a message for future delivery
+   */
+  async schedule(body, cronExpression, options) {
+    try {
+      const headers = {
+        Authorization: `Bearer ${this.token}`,
+        "Content-Type": "application/json",
+        "Upstash-Cron": cronExpression
+      };
+      if (options?.deduplicationId) {
+        headers["Upstash-Deduplication-Id"] = options.deduplicationId;
+      }
+      const response = await fetch(
+        `${this.baseUrl}/schedules/${encodeURIComponent(this.destinationUrl)}`,
+        {
+          method: "POST",
+          headers,
+          body: JSON.stringify(body)
+        }
+      );
+      if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`QStash API error: ${error}`);
+      }
+      const result = await response.json();
+      return result.scheduleId;
+    } catch (err) {
+      throw new QueueError(
+        `QStash schedule failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        QueueErrorCodes.SEND_FAILED,
+        err
+      );
+    }
+  }
+  /**
+   * Delete a scheduled message
+   */
+  async deleteSchedule(scheduleId) {
+    try {
+      const response = await fetch(`${this.baseUrl}/schedules/${scheduleId}`, {
+        method: "DELETE",
+        headers: {
+          Authorization: `Bearer ${this.token}`
+        }
+      });
+      if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`QStash API error: ${error}`);
+      }
+    } catch (err) {
+      throw new QueueError(
+        `QStash delete schedule failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        QueueErrorCodes.SEND_FAILED,
+        err
+      );
+    }
+  }
+  /**
+   * List all schedules
+   */
+  async listSchedules() {
+    try {
+      const response = await fetch(`${this.baseUrl}/schedules`, {
+        headers: {
+          Authorization: `Bearer ${this.token}`
+        }
+      });
+      if (!response.ok) {
+        const error = await response.text();
+        throw new Error(`QStash API error: ${error}`);
+      }
+      return await response.json();
+    } catch (err) {
+      throw new QueueError(
+        `QStash list schedules failed: ${err instanceof Error ? err.message : "Unknown error"}`,
+        QueueErrorCodes.SEND_FAILED,
+        err
+      );
+    }
+  }
+};
+var QStashReceiver = class {
+  currentSigningKey;
+  nextSigningKey;
+  constructor(config) {
+    this.currentSigningKey = config.currentSigningKey;
+    this.nextSigningKey = config.nextSigningKey;
+  }
+  /**
+   * Verify a request from QStash and extract the message
+   */
+  async verify(request) {
+    const signature = request.headers.get("Upstash-Signature");
+    if (!signature) {
+      return null;
+    }
+    const body = await request.text();
+    const isValid = await this.verifySignature(body, signature, this.currentSigningKey) || await this.verifySignature(body, signature, this.nextSigningKey);
+    if (!isValid) {
+      return null;
+    }
+    const messageId = request.headers.get("Upstash-Message-Id") ?? `qstash-${Date.now()}`;
+    const retryCount = parseInt(
+      request.headers.get("Upstash-Retried") ?? "0",
+      10
+    );
+    let parsedBody;
+    try {
+      parsedBody = JSON.parse(body);
+    } catch {
+      parsedBody = body;
+    }
+    return {
+      id: messageId,
+      body: parsedBody,
+      timestamp: /* @__PURE__ */ new Date(),
+      attempts: retryCount + 1
+    };
+  }
+  async verifySignature(body, signature, key) {
+    try {
+      const parts = signature.split(".");
+      if (parts.length !== 3) {
+        return false;
+      }
+      const [headerB64, payloadB64, signatureB64] = parts;
+      if (!headerB64 || !payloadB64 || !signatureB64) {
+        return false;
+      }
+      const encoder = new TextEncoder();
+      const keyData = encoder.encode(key);
+      const cryptoKey = await crypto.subtle.importKey(
+        "raw",
+        keyData,
+        { name: "HMAC", hash: "SHA-256" },
+        false,
+        ["verify"]
+      );
+      const signatureData = this.base64UrlDecode(signatureB64);
+      const dataToVerify = encoder.encode(`${headerB64}.${payloadB64}`);
+      const isValid = await crypto.subtle.verify(
+        "HMAC",
+        cryptoKey,
+        signatureData,
+        dataToVerify
+      );
+      if (!isValid) {
+        return false;
+      }
+      const payload = JSON.parse(atob(payloadB64));
+      const now = Math.floor(Date.now() / 1e3);
+      if (payload.exp && payload.exp < now) {
+        return false;
+      }
+      if (payload.nbf && payload.nbf > now) {
+        return false;
+      }
+      if (payload.body) {
+        const bodyHash = await this.sha256(body);
+        const expectedHash = this.base64UrlEncode(
+          new Uint8Array(
+            atob(payload.body).split("").map((c) => c.charCodeAt(0))
+          )
+        );
+        if (bodyHash !== expectedHash && payload.body !== bodyHash) {
+          const directHash = await this.sha256Base64(body);
+          if (directHash !== payload.body) {
+            return false;
+          }
+        }
+      }
+      return true;
+    } catch {
+      return false;
+    }
+  }
+  base64UrlDecode(str) {
+    const base64 = str.replace(/-/g, "+").replace(/_/g, "/");
+    const padding = (4 - base64.length % 4) % 4;
+    const padded = base64 + "=".repeat(padding);
+    const binary = atob(padded);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+      bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+  }
+  base64UrlEncode(data) {
+    let binary = "";
+    for (let i = 0; i < data.length; i++) {
+      const byte = data[i];
+      if (byte !== void 0) {
+        binary += String.fromCharCode(byte);
+      }
+    }
+    return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+  }
+  async sha256(message) {
+    const encoder = new TextEncoder();
+    const data = encoder.encode(message);
+    const hash = await crypto.subtle.digest("SHA-256", data);
+    return this.base64UrlEncode(new Uint8Array(hash));
+  }
+  async sha256Base64(message) {
+    const encoder = new TextEncoder();
+    const data = encoder.encode(message);
+    const hash = await crypto.subtle.digest("SHA-256", data);
+    let binary = "";
+    const bytes = new Uint8Array(hash);
+    for (let i = 0; i < bytes.length; i++) {
+      const byte = bytes[i];
+      if (byte !== void 0) {
+        binary += String.fromCharCode(byte);
+      }
+    }
+    return btoa(binary);
+  }
+};
+function createQStashAdapter(config) {
+  return new QStashAdapter(config);
+}
+function createQStashReceiver(config) {
+  return new QStashReceiver(config);
+}
+export {
+  QStashAdapter,
+  QStashReceiver,
+  createQStashAdapter,
+  createQStashReceiver
+};
+//# sourceMappingURL=qstash.js.map

package/dist/adapters/qstash.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types.ts","../../src/adapters/qstash.ts"],"sourcesContent":["/**\n * @parsrun/queue - Type Definitions\n * Queue types and interfaces\n */\n\n// Re-export types from @parsrun/types for convenience\nexport {\n  type,\n  jobStatus,\n  job,\n  jobOptions,\n  addJobRequest,\n  jobProgressUpdate,\n  queueStats as parsQueueStats,\n  queueListOptions,\n  redisQueueConfig,\n  workerOptions,\n  queueConfig,\n  type JobStatus,\n  type Job,\n  type JobOptions,\n  type AddJobRequest,\n  type JobProgressUpdate,\n  type QueueStats as ParsQueueStats,\n  type QueueListOptions,\n  type RedisQueueConfig,\n  type WorkerOptions,\n  type QueueConfig,\n} from \"@parsrun/types\";\n\n/**\n * Queue adapter type\n */\nexport type QueueAdapterType = \"memory\" | \"cloudflare\" | \"qstash\";\n\n/**\n * Message payload\n */\nexport interface QueueMessage<T = unknown> {\n  /** Unique message ID */\n  id: string;\n  /** Message payload */\n  body: T;\n  /** Message timestamp */\n  timestamp: Date;\n  /** Number of delivery attempts */\n  attempts: number;\n  /** Optional delay before processing (seconds) */\n  delaySeconds?: number | undefined;\n  /** Optional deduplication ID */\n  deduplicationId?: string | undefined;\n  /** Custom metadata */\n  metadata?: Record<string, unknown> | undefined;\n}\n\n/**\n * Send message options\n */\nexport interface SendMessageOptions {\n  /** Delay before message is available (seconds) */\n  delaySeconds?: number | undefined;\n  /** Deduplication ID (prevents duplicate processing) */\n  deduplicationId?: string | undefined;\n  /** Custom metadata */\n  metadata?: Record<string, unknown> | undefined;\n  /** Priority (higher = more important) */\n  priority?: number | undefined;\n}\n\n/**\n * Batch send result\n */\nexport interface BatchSendResult {\n  /** Total messages sent */\n  total: number;\n  /** Successfully sent */\n  successful: number;\n  /** Failed to send */\n  failed: number;\n  /** Individual message IDs */\n  messageIds: string[];\n  /** Failed messages with errors */\n  errors: Array<{ index: number; error: string }>;\n}\n\n/**\n * Message handler function\n */\nexport type MessageHandler<T = unknown> = (\n  message: QueueMessage<T>\n) => void | Promise<void>;\n\n/**\n * Consumer options\n */\nexport interface ConsumerOptions {\n  /** Maximum messages to process per batch */\n  batchSize?: number | undefined;\n  /** Visibility timeout (seconds) - how long a message is hidden while processing */\n  visibilityTimeout?: number | undefined;\n  /** Polling interval (ms) for pull-based queues */\n  pollingInterval?: number | undefined;\n  /** Maximum retries before dead-letter */\n  maxRetries?: number | undefined;\n  /** Concurrency - how many messages to process in parallel */\n  concurrency?: number | undefined;\n}\n\n/**\n * Queue adapter interface\n */\nexport interface QueueAdapter<T = unknown> {\n  /** Adapter type */\n  readonly type: QueueAdapterType;\n\n  /** Queue name */\n  readonly name: string;\n\n  /**\n   * Send a message to the queue\n   */\n  send(body: T, options?: SendMessageOptions): Promise<string>;\n\n  /**\n   * Send multiple messages at once\n   */\n  sendBatch?(messages: Array<{ body: T; options?: SendMessageOptions }>): Promise<BatchSendResult>;\n\n  /**\n   * Receive messages from the queue (pull-based)\n   * Used for manual message processing\n   */\n  receive?(maxMessages?: number, visibilityTimeout?: number): Promise<QueueMessage<T>[]>;\n\n  /**\n   * Acknowledge message processing (mark as complete)\n   */\n  ack?(messageId: string): Promise<void>;\n\n  /**\n   * Acknowledge multiple messages\n   */\n  ackBatch?(messageIds: string[]): Promise<void>;\n\n  /**\n   * Return message to queue (negative acknowledgement)\n   * Optionally with delay\n   */\n  nack?(messageId: string, delaySeconds?: number): Promise<void>;\n\n  /**\n   * Start consuming messages (push-based)\n   * For adapters that support push-based processing\n   */\n  consume?(handler: MessageHandler<T>, options?: ConsumerOptions): Promise<void>;\n\n  /**\n   * Stop consuming messages\n   */\n  stopConsuming?(): Promise<void>;\n\n  /**\n   * Get queue statistics\n   */\n  getStats?(): Promise<QueueStats>;\n\n  /**\n   * Purge all messages from queue\n   */\n  purge?(): Promise<void>;\n\n  /**\n   * Close/cleanup adapter resources\n   */\n  close?(): Promise<void>;\n}\n\n/**\n * Queue statistics\n */\nexport interface QueueStats {\n  /** Approximate number of messages in queue */\n  messageCount: number;\n  /** Messages currently being processed */\n  inFlightCount?: number | undefined;\n  /** Messages in dead-letter queue */\n  deadLetterCount?: number | undefined;\n}\n\n/**\n * Queue service configuration\n */\nexport interface QueueServiceConfig<T = unknown> {\n  /** Queue adapter to use */\n  adapter: QueueAdapter<T>;\n  /** Enable debug logging */\n  debug?: boolean | undefined;\n}\n\n/**\n * Memory queue configuration\n */\nexport interface MemoryQueueConfig {\n  /** Queue name */\n  name: string;\n  /** Maximum queue size (default: unlimited) */\n  maxSize?: number | undefined;\n  /** Default visibility timeout (seconds) */\n  visibilityTimeout?: number | undefined;\n}\n\n/**\n * Cloudflare Queue configuration\n */\nexport interface CloudflareQueueConfig {\n  /** Queue binding from environment */\n  queue: CloudflareQueue;\n}\n\n/**\n * Cloudflare Queue interface (from Workers runtime)\n */\nexport interface CloudflareQueue<T = unknown> {\n  send(message: T, options?: { delaySeconds?: number | undefined; contentType?: string | undefined }): Promise<void>;\n  sendBatch(messages: Array<{ body: T; delaySeconds?: number | undefined; contentType?: string | undefined }>): Promise<void>;\n}\n\n/**\n * Cloudflare Queue batch\n */\nexport interface CloudflareMessageBatch<T = unknown> {\n  readonly queue: string;\n  readonly messages: Array<CloudflareMessage<T>>;\n  ackAll(): void;\n  retryAll(): void;\n}\n\n/**\n * Cloudflare Queue message\n */\nexport interface CloudflareMessage<T = unknown> {\n  readonly id: string;\n  readonly timestamp: Date;\n  readonly body: T;\n  readonly attempts: number;\n  ack(): void;\n  retry(): void;\n}\n\n/**\n * QStash configuration\n */\nexport interface QStashConfig {\n  /** QStash token */\n  token: string;\n  /** Destination URL for message delivery */\n  destinationUrl: string;\n  /** Current request URL (for signature verification) */\n  currentSigningKey?: string | undefined;\n  /** Next signing key (for signature verification) */\n  nextSigningKey?: string | undefined;\n}\n\n/**\n * Queue error\n */\nexport class QueueError extends Error {\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly cause?: unknown\n  ) {\n    super(message);\n    this.name = \"QueueError\";\n  }\n}\n\n/**\n * Common queue error codes\n */\nexport const QueueErrorCodes = {\n  SEND_FAILED: \"SEND_FAILED\",\n  RECEIVE_FAILED: \"RECEIVE_FAILED\",\n  ACK_FAILED: \"ACK_FAILED\",\n  INVALID_CONFIG: \"INVALID_CONFIG\",\n  QUEUE_FULL: \"QUEUE_FULL\",\n  MESSAGE_NOT_FOUND: \"MESSAGE_NOT_FOUND\",\n  NOT_IMPLEMENTED: \"NOT_IMPLEMENTED\",\n} as const;\n","/**\n * @parsrun/queue - QStash Adapter\n * Edge-compatible Upstash QStash adapter using fetch API\n */\n\nimport type {\n  BatchSendResult,\n  QStashConfig,\n  QueueAdapter,\n  QueueMessage,\n  SendMessageOptions,\n} from \"../types.js\";\nimport { QueueError, QueueErrorCodes } from \"../types.js\";\n\n/**\n * QStash Queue Adapter\n * Edge-compatible using HTTP API\n *\n * QStash is a serverless message queue that delivers messages via HTTP webhooks.\n * Messages are sent to QStash which then delivers them to your endpoint.\n *\n * @example\n * ```typescript\n * const queue = new QStashAdapter({\n *   token: process.env.QSTASH_TOKEN,\n *   destinationUrl: 'https://myapp.com/api/webhooks/queue',\n * });\n *\n * await queue.send({ userId: '123', action: 'welcome-email' });\n * ```\n */\nexport class QStashAdapter<T = unknown> implements QueueAdapter<T> {\n  readonly type = \"qstash\" as const;\n  readonly name = \"qstash\";\n\n  private token: string;\n  private destinationUrl: string;\n  private baseUrl = \"https://qstash.upstash.io/v2\";\n\n  constructor(config: QStashConfig) {\n    this.token = config.token;\n    this.destinationUrl = config.destinationUrl;\n  }\n\n  async send(body: T, options?: SendMessageOptions): Promise<string> {\n    try {\n      const headers: Record<string, string> = {\n        Authorization: `Bearer ${this.token}`,\n        \"Content-Type\": \"application/json\",\n      };\n\n      // Add delay\n      if (options?.delaySeconds) {\n        headers[\"Upstash-Delay\"] = `${options.delaySeconds}s`;\n      }\n\n      // Add deduplication\n      if (options?.deduplicationId) {\n        headers[\"Upstash-Deduplication-Id\"] = options.deduplicationId;\n      }\n\n      // Add custom headers from metadata\n      if (options?.metadata) {\n        for (const [key, value] of Object.entries(options.metadata)) {\n          if (typeof value === \"string\") {\n            headers[`Upstash-Forward-${key}`] = value;\n          }\n        }\n      }\n\n      const response = await fetch(\n        `${this.baseUrl}/publish/${encodeURIComponent(this.destinationUrl)}`,\n        {\n          method: \"POST\",\n          headers,\n          body: JSON.stringify(body),\n        }\n      );\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new Error(`QStash API error: ${error}`);\n      }\n\n      const result = await response.json() as { messageId: string };\n      return result.messageId;\n    } catch (err) {\n      throw new QueueError(\n        `QStash send failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        QueueErrorCodes.SEND_FAILED,\n        err\n      );\n    }\n  }\n\n  async sendBatch(\n    messages: Array<{ body: T; options?: SendMessageOptions }>\n  ): Promise<BatchSendResult> {\n    try {\n      const batchMessages = messages.map((m) => {\n        const headers: Record<string, string> = {\n          \"Content-Type\": \"application/json\",\n        };\n\n        if (m.options?.delaySeconds) {\n          headers[\"Upstash-Delay\"] = `${m.options.delaySeconds}s`;\n        }\n\n        if (m.options?.deduplicationId) {\n          headers[\"Upstash-Deduplication-Id\"] = m.options.deduplicationId;\n        }\n\n        return {\n          destination: this.destinationUrl,\n          headers,\n          body: JSON.stringify(m.body),\n        };\n      });\n\n      const response = await fetch(`${this.baseUrl}/batch`, {\n        method: \"POST\",\n        headers: {\n          Authorization: `Bearer ${this.token}`,\n          \"Content-Type\": \"application/json\",\n        },\n        body: JSON.stringify(batchMessages),\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new Error(`QStash API error: ${error}`);\n      }\n\n      const results = await response.json() as Array<{\n        messageId?: string;\n        error?: string;\n      }>;\n\n      const messageIds: string[] = [];\n      const errors: Array<{ index: number; error: string }> = [];\n      let successful = 0;\n      let failed = 0;\n\n      for (let i = 0; i < results.length; i++) {\n        const result = results[i];\n        if (result?.messageId) {\n          messageIds.push(result.messageId);\n          successful++;\n        } else {\n          failed++;\n          errors.push({\n            index: i,\n            error: result?.error ?? \"Unknown error\",\n          });\n        }\n      }\n\n      return {\n        total: messages.length,\n        successful,\n        failed,\n        messageIds,\n        errors,\n      };\n    } catch (err) {\n      throw new QueueError(\n        `QStash batch send failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        QueueErrorCodes.SEND_FAILED,\n        err\n      );\n    }\n  }\n\n  /**\n   * Schedule a message for future delivery\n   */\n  async schedule(\n    body: T,\n    cronExpression: string,\n    options?: Omit<SendMessageOptions, \"delaySeconds\">\n  ): Promise<string> {\n    try {\n      const headers: Record<string, string> = {\n        Authorization: `Bearer ${this.token}`,\n        \"Content-Type\": \"application/json\",\n        \"Upstash-Cron\": cronExpression,\n      };\n\n      if (options?.deduplicationId) {\n        headers[\"Upstash-Deduplication-Id\"] = options.deduplicationId;\n      }\n\n      const response = await fetch(\n        `${this.baseUrl}/schedules/${encodeURIComponent(this.destinationUrl)}`,\n        {\n          method: \"POST\",\n          headers,\n          body: JSON.stringify(body),\n        }\n      );\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new Error(`QStash API error: ${error}`);\n      }\n\n      const result = await response.json() as { scheduleId: string };\n      return result.scheduleId;\n    } catch (err) {\n      throw new QueueError(\n        `QStash schedule failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        QueueErrorCodes.SEND_FAILED,\n        err\n      );\n    }\n  }\n\n  /**\n   * Delete a scheduled message\n   */\n  async deleteSchedule(scheduleId: string): Promise<void> {\n    try {\n      const response = await fetch(`${this.baseUrl}/schedules/${scheduleId}`, {\n        method: \"DELETE\",\n        headers: {\n          Authorization: `Bearer ${this.token}`,\n        },\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new Error(`QStash API error: ${error}`);\n      }\n    } catch (err) {\n      throw new QueueError(\n        `QStash delete schedule failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        QueueErrorCodes.SEND_FAILED,\n        err\n      );\n    }\n  }\n\n  /**\n   * List all schedules\n   */\n  async listSchedules(): Promise<\n    Array<{\n      scheduleId: string;\n      cron: string;\n      destination: string;\n      body?: string;\n      createdAt: number;\n    }>\n  > {\n    try {\n      const response = await fetch(`${this.baseUrl}/schedules`, {\n        headers: {\n          Authorization: `Bearer ${this.token}`,\n        },\n      });\n\n      if (!response.ok) {\n        const error = await response.text();\n        throw new Error(`QStash API error: ${error}`);\n      }\n\n      return await response.json() as Array<{\n        scheduleId: string;\n        cron: string;\n        destination: string;\n        body?: string;\n        createdAt: number;\n      }>;\n    } catch (err) {\n      throw new QueueError(\n        `QStash list schedules failed: ${err instanceof Error ? err.message : \"Unknown error\"}`,\n        QueueErrorCodes.SEND_FAILED,\n        err\n      );\n    }\n  }\n}\n\n/**\n * QStash Message Receiver\n * Helper for receiving and verifying messages in your webhook endpoint\n *\n * @example\n * ```typescript\n * // In your API route\n * const receiver = new QStashReceiver({\n *   currentSigningKey: process.env.QSTASH_CURRENT_SIGNING_KEY,\n *   nextSigningKey: process.env.QSTASH_NEXT_SIGNING_KEY,\n * });\n *\n * export async function POST(request: Request) {\n *   const message = await receiver.verify(request);\n *   if (!message) {\n *     return new Response('Invalid signature', { status: 401 });\n *   }\n *\n *   // Process the message\n *   console.log(message.body);\n *   return new Response('OK');\n * }\n * ```\n */\nexport class QStashReceiver<T = unknown> {\n  private currentSigningKey: string;\n  private nextSigningKey: string;\n\n  constructor(config: { currentSigningKey: string; nextSigningKey: string }) {\n    this.currentSigningKey = config.currentSigningKey;\n    this.nextSigningKey = config.nextSigningKey;\n  }\n\n  /**\n   * Verify a request from QStash and extract the message\n   */\n  async verify(request: Request): Promise<QueueMessage<T> | null> {\n    const signature = request.headers.get(\"Upstash-Signature\");\n\n    if (!signature) {\n      return null;\n    }\n\n    const body = await request.text();\n\n    // Try current key first, then next key\n    const isValid =\n      (await this.verifySignature(body, signature, this.currentSigningKey)) ||\n      (await this.verifySignature(body, signature, this.nextSigningKey));\n\n    if (!isValid) {\n      return null;\n    }\n\n    const messageId = request.headers.get(\"Upstash-Message-Id\") ?? `qstash-${Date.now()}`;\n    const retryCount = parseInt(\n      request.headers.get(\"Upstash-Retried\") ?? \"0\",\n      10\n    );\n\n    let parsedBody: T;\n    try {\n      parsedBody = JSON.parse(body) as T;\n    } catch {\n      parsedBody = body as T;\n    }\n\n    return {\n      id: messageId,\n      body: parsedBody,\n      timestamp: new Date(),\n      attempts: retryCount + 1,\n    };\n  }\n\n  private async verifySignature(\n    body: string,\n    signature: string,\n    key: string\n  ): Promise<boolean> {\n    try {\n      // Parse JWT-like signature\n      const parts = signature.split(\".\");\n      if (parts.length !== 3) {\n        return false;\n      }\n\n      const [headerB64, payloadB64, signatureB64] = parts;\n      if (!headerB64 || !payloadB64 || !signatureB64) {\n        return false;\n      }\n\n      // Verify signature using Web Crypto API\n      const encoder = new TextEncoder();\n      const keyData = encoder.encode(key);\n\n      const cryptoKey = await crypto.subtle.importKey(\n        \"raw\",\n        keyData,\n        { name: \"HMAC\", hash: \"SHA-256\" },\n        false,\n        [\"verify\"]\n      );\n\n      const signatureData = this.base64UrlDecode(signatureB64);\n      const dataToVerify = encoder.encode(`${headerB64}.${payloadB64}`);\n\n      const isValid = await crypto.subtle.verify(\n        \"HMAC\",\n        cryptoKey,\n        signatureData,\n        dataToVerify\n      );\n\n      if (!isValid) {\n        return false;\n      }\n\n      // Verify payload contains correct body hash\n      const payload = JSON.parse(atob(payloadB64)) as {\n        body?: string;\n        iss?: string;\n        sub?: string;\n        exp?: number;\n        nbf?: number;\n        iat?: number;\n      };\n\n      // Check expiration\n      const now = Math.floor(Date.now() / 1000);\n      if (payload.exp && payload.exp < now) {\n        return false;\n      }\n\n      // Check not before\n      if (payload.nbf && payload.nbf > now) {\n        return false;\n      }\n\n      // Verify body hash\n      if (payload.body) {\n        const bodyHash = await this.sha256(body);\n        const expectedHash = this.base64UrlEncode(\n          new Uint8Array(\n            atob(payload.body)\n              .split(\"\")\n              .map((c) => c.charCodeAt(0))\n          )\n        );\n\n        if (bodyHash !== expectedHash && payload.body !== bodyHash) {\n          // Also try direct comparison\n          const directHash = await this.sha256Base64(body);\n          if (directHash !== payload.body) {\n            return false;\n          }\n        }\n      }\n\n      return true;\n    } catch {\n      return false;\n    }\n  }\n\n  private base64UrlDecode(str: string): Uint8Array {\n    const base64 = str.replace(/-/g, \"+\").replace(/_/g, \"/\");\n    const padding = (4 - (base64.length % 4)) % 4;\n    const padded = base64 + \"=\".repeat(padding);\n    const binary = atob(padded);\n    const bytes = new Uint8Array(binary.length);\n    for (let i = 0; i < binary.length; i++) {\n      bytes[i] = binary.charCodeAt(i);\n    }\n    return bytes;\n  }\n\n  private base64UrlEncode(data: Uint8Array): string {\n    let binary = \"\";\n    for (let i = 0; i < data.length; i++) {\n      const byte = data[i];\n      if (byte !== undefined) {\n        binary += String.fromCharCode(byte);\n      }\n    }\n    return btoa(binary).replace(/\\+/g, \"-\").replace(/\\//g, \"_\").replace(/=+$/, \"\");\n  }\n\n  private async sha256(message: string): Promise<string> {\n    const encoder = new TextEncoder();\n    const data = encoder.encode(message);\n    const hash = await crypto.subtle.digest(\"SHA-256\", data);\n    return this.base64UrlEncode(new Uint8Array(hash));\n  }\n\n  private async sha256Base64(message: string): Promise<string> {\n    const encoder = new TextEncoder();\n    const data = encoder.encode(message);\n    const hash = await crypto.subtle.digest(\"SHA-256\", data);\n    let binary = \"\";\n    const bytes = new Uint8Array(hash);\n    for (let i = 0; i < bytes.length; i++) {\n      const byte = bytes[i];\n      if (byte !== undefined) {\n        binary += String.fromCharCode(byte);\n      }\n    }\n    return btoa(binary);\n  }\n}\n\n/**\n * Create a QStash queue adapter\n */\nexport function createQStashAdapter<T = unknown>(\n  config: QStashConfig\n): QStashAdapter<T> {\n  return new QStashAdapter<T>(config);\n}\n\n/**\n * Create a QStash receiver for webhook verification\n */\nexport function createQStashReceiver<T = unknown>(config: {\n  currentSigningKey: string;\n  nextSigningKey: string;\n}): QStashReceiver<T> {\n  return new QStashReceiver<T>(config);\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,123 @@
+import { QueueServiceConfig, SendMessageOptions, BatchSendResult, QueueMessage, MessageHandler, ConsumerOptions, QueueStats } from './types.js';
+export { CloudflareMessage, CloudflareMessageBatch, CloudflareQueue, CloudflareQueueConfig, MemoryQueueConfig, QStashConfig, QueueAdapter, QueueAdapterType, QueueError, QueueErrorCodes } from './types.js';
+export { MemoryQueueAdapter, createMemoryQueueAdapter } from './adapters/memory.js';
+export { CloudflareQueueAdapter, CloudflareQueueProcessor, createCloudflareQueueAdapter, createCloudflareQueueProcessor } from './adapters/cloudflare.js';
+export { QStashAdapter, QStashReceiver, createQStashAdapter, createQStashReceiver } from './adapters/qstash.js';
+export { AddJobRequest, Job, JobOptions, JobProgressUpdate, JobStatus, QueueStats as ParsQueueStats, QueueConfig, QueueListOptions, RedisQueueConfig, WorkerOptions, addJobRequest, job, jobOptions, jobProgressUpdate, jobStatus, queueStats as parsQueueStats, queueConfig, queueListOptions, redisQueueConfig, type, workerOptions } from '@parsrun/types';
+
+/**
+ * @parsrun/queue
+ * Edge-compatible message queues for Pars
+ *
+ * Supports multiple adapters:
+ * - Memory (development)
+ * - Cloudflare Queues (Workers)
+ * - Upstash QStash (Edge/Serverless)
+ *
+ * @example
+ * ```typescript
+ * import { createQueueService, createMemoryQueueAdapter } from '@parsrun/queue';
+ *
+ * const queue = createQueueService({
+ *   adapter: createMemoryQueueAdapter({ name: 'tasks' }),
+ * });
+ *
+ * await queue.send({ userId: '123', action: 'send-email' });
+ * ```
+ */
+
+/**
+ * Queue Service
+ * High-level queue service with adapter abstraction
+ */
+declare class QueueService<T = unknown> {
+    private adapter;
+    private debug;
+    constructor(config: QueueServiceConfig<T>);
+    /**
+     * Get adapter type
+     */
+    get adapterType(): string;
+    /**
+     * Get queue name
+     */
+    get name(): string;
+    /**
+     * Send a message to the queue
+     */
+    send(body: T, options?: SendMessageOptions): Promise<string>;
+    /**
+     * Send multiple messages at once
+     */
+    sendBatch(messages: Array<{
+        body: T;
+        options?: SendMessageOptions;
+    }>): Promise<BatchSendResult>;
+    /**
+     * Receive messages from the queue (pull-based)
+     */
+    receive(maxMessages?: number, visibilityTimeout?: number): Promise<QueueMessage<T>[]>;
+    /**
+     * Acknowledge message processing (mark as complete)
+     */
+    ack(messageId: string): Promise<void>;
+    /**
+     * Acknowledge multiple messages
+     */
+    ackBatch(messageIds: string[]): Promise<void>;
+    /**
+     * Return message to queue (negative acknowledgement)
+     */
+    nack(messageId: string, delaySeconds?: number): Promise<void>;
+    /**
+     * Start consuming messages (push-based)
+     */
+    consume(handler: MessageHandler<T>, options?: ConsumerOptions): Promise<void>;
+    /**
+     * Stop consuming messages
+     */
+    stopConsuming(): Promise<void>;
+    /**
+     * Get queue statistics
+     */
+    getStats(): Promise<QueueStats>;
+    /**
+     * Purge all messages from queue
+     */
+    purge(): Promise<void>;
+    /**
+     * Close/cleanup queue resources
+     */
+    close(): Promise<void>;
+}
+/**
+ * Create a queue service
+ *
+ * @example
+ * ```typescript
+ * // With Memory (development)
+ * const queue = createQueueService({
+ *   adapter: createMemoryQueueAdapter({ name: 'tasks' }),
+ * });
+ *
+ * // With Cloudflare Queues (Workers)
+ * const queue = createQueueService({
+ *   adapter: createCloudflareQueueAdapter({ queue: env.MY_QUEUE }),
+ * });
+ *
+ * // With QStash (Edge)
+ * const queue = createQueueService({
+ *   adapter: createQStashAdapter({
+ *     token: process.env.QSTASH_TOKEN,
+ *     destinationUrl: 'https://myapp.com/api/queue',
+ *   }),
+ * });
+ * ```
+ */
+declare function createQueueService<T = unknown>(config: QueueServiceConfig<T>): QueueService<T>;
+declare const _default: {
+    QueueService: typeof QueueService;
+    createQueueService: typeof createQueueService;
+};
+
+export { BatchSendResult, ConsumerOptions, MessageHandler, QueueMessage, QueueService, QueueServiceConfig, QueueStats, SendMessageOptions, createQueueService, _default as default };