@commet/next 0.1.0

package/README.md

@@ -0,0 +1,57 @@
+<div align="center">
+  <p align="center">
+    <a href="https://commet.co">
+      <img src="https://commet.co/logo-bg-dark.png" height="96">
+      <h3 align="center">@commet/next</h3>
+    </a>
+  </p>
+  <p>Next.js integration for Commet webhooks</p>
+
+  <a href="https://www.npmjs.com/package/@commet/next"><img alt="NPM version" src="https://img.shields.io/npm/v/@commet/next.svg?style=for-the-badge&labelColor=000000"></a>
+  <a href="https://docs.commet.co/docs/library/installation/webhooks"><img alt="Documentation" src="https://img.shields.io/badge/docs-webhooks-blue.svg?style=for-the-badge&labelColor=000000"></a>
+</div>
+
+<br/>
+
+## Installation
+
+```bash
+npm install @commet/next
+```
+
+## Quick Start
+
+```typescript
+// app/api/webhooks/commet/route.ts
+import { Webhooks } from "@commet/next";
+
+export const POST = Webhooks({
+  webhookSecret: process.env.COMMET_WEBHOOK_SECRET!,
+  
+  onSubscriptionActivated: async (payload) => {
+    // Handle subscription activation
+  },
+});
+```
+
+## Documentation
+
+Visit [docs.commet.co/docs/library/installation/webhooks](https://docs.commet.co/docs/library/installation/webhooks) for:
+
+- Complete setup guide
+- Event handler reference
+- TypeScript integration
+- Error handling patterns
+- Testing strategies
+
+## Resources
+
+- [Webhook Documentation](https://docs.commet.co/docs/library/installation/webhooks)
+- [SDK Reference](https://docs.commet.co/docs/library/quickstart)
+- [GitHub](https://github.com/commet-labs/commet)
+- [Issues](https://github.com/commet-labs/commet/issues)
+
+## License
+
+MIT
+

package/dist/index.d.mts

@@ -0,0 +1,149 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { WebhookPayload } from '@commet/node';
+export { WebhookData, WebhookEvent, WebhookPayload } from '@commet/node';
+
+/**
+ * Configuration for the Commet webhook handler
+ */
+interface WebhooksConfig {
+    /**
+     * Webhook secret from your Commet dashboard
+     * Used to verify webhook signatures
+     */
+    webhookSecret: string;
+    /**
+     * Handles the `subscription.activated` webhook event
+     *
+     * Fired when a subscription payment is successful and the subscription becomes active.
+     * This is when you should grant access to your product.
+     *
+     * @param payload - The webhook payload containing subscription data
+     *
+     * @example
+     * ```typescript
+     * onSubscriptionActivated: async (payload) => {
+     *   await db.update(users)
+     *     .set({ isPaid: true })
+     *     .where(eq(users.id, payload.data.externalId));
+     * }
+     * ```
+     */
+    onSubscriptionActivated?: (payload: WebhookPayload) => Promise<void>;
+    /**
+     * Handles the `subscription.canceled` webhook event
+     *
+     * Fired when a subscription is canceled (either by the customer or administratively).
+     * This is when you should revoke access to your product.
+     *
+     * @param payload - The webhook payload containing subscription data
+     *
+     * @example
+     * ```typescript
+     * onSubscriptionCanceled: async (payload) => {
+     *   await db.update(users)
+     *     .set({ isPaid: false })
+     *     .where(eq(users.id, payload.data.externalId));
+     * }
+     * ```
+     */
+    onSubscriptionCanceled?: (payload: WebhookPayload) => Promise<void>;
+    /**
+     * Handles the `subscription.created` webhook event
+     *
+     * Fired when a new subscription is created, but before payment is processed.
+     * Typically used for logging or analytics, not for granting access.
+     *
+     * @param payload - The webhook payload containing subscription data
+     *
+     * @example
+     * ```typescript
+     * onSubscriptionCreated: async (payload) => {
+     *   console.log(`New subscription: ${payload.data.subscriptionId}`);
+     * }
+     * ```
+     */
+    onSubscriptionCreated?: (payload: WebhookPayload) => Promise<void>;
+    /**
+     * Handles the `subscription.updated` webhook event
+     *
+     * Fired when subscription details change (plan, quantity, status, etc.).
+     * Use this to handle upgrades, downgrades, or status transitions.
+     *
+     * @param payload - The webhook payload containing subscription data
+     *
+     * @example
+     * ```typescript
+     * onSubscriptionUpdated: async (payload) => {
+     *   if (payload.data.status === 'active') {
+     *     await handleActivation(payload);
+     *   }
+     * }
+     * ```
+     */
+    onSubscriptionUpdated?: (payload: WebhookPayload) => Promise<void>;
+    /**
+     * Catch-all handler that receives all webhook events
+     *
+     * Useful for logging, analytics, or handling events without specific handlers.
+     * Called in addition to specific event handlers.
+     *
+     * @param payload - The webhook payload
+     *
+     * @example
+     * ```typescript
+     * onPayload: async (payload) => {
+     *   console.log(`Webhook received: ${payload.event}`);
+     *   await analytics.track('webhook_received', { event: payload.event });
+     * }
+     * ```
+     */
+    onPayload?: (payload: WebhookPayload) => Promise<void>;
+    /**
+     * Error handler for webhook processing failures
+     *
+     * Called when signature verification fails or handlers throw errors.
+     * Use this for custom error logging or alerting.
+     *
+     * @param error - The error that occurred
+     * @param payload - The raw payload (may be undefined if parsing failed)
+     *
+     * @example
+     * ```typescript
+     * onError: async (error, payload) => {
+     *   console.error('Webhook error:', error);
+     *   await logger.error('webhook_failed', { error, payload });
+     * }
+     * ```
+     */
+    onError?: (error: Error, payload: unknown) => Promise<void>;
+}
+
+/**
+ * Create a Next.js webhook handler for Commet events
+ *
+ * Automatically verifies signatures, routes events to handlers, and returns proper responses.
+ *
+ * @param config - Webhook configuration with secret and event handlers
+ * @returns Next.js route handler function
+ *
+ * @example
+ * ```typescript
+ * // app/api/webhooks/commet/route.ts
+ * import { Webhooks } from "@commet/next";
+ *
+ * export const POST = Webhooks({
+ *   webhookSecret: process.env.COMMET_WEBHOOK_SECRET!,
+ *   onSubscriptionActivated: async (payload) => {
+ *     // Grant access to user
+ *   },
+ *   onSubscriptionCanceled: async (payload) => {
+ *     // Revoke access from user
+ *   },
+ * });
+ * ```
+ */
+declare const Webhooks: (config: WebhooksConfig) => (request: NextRequest) => Promise<NextResponse<{
+    received: boolean;
+}>>;
+
+export { Webhooks, type WebhooksConfig };

package/dist/index.d.ts

@@ -0,0 +1,149 @@
+import { NextRequest, NextResponse } from 'next/server';
+import { WebhookPayload } from '@commet/node';
+export { WebhookData, WebhookEvent, WebhookPayload } from '@commet/node';
+
+/**
+ * Configuration for the Commet webhook handler
+ */
+interface WebhooksConfig {
+    /**
+     * Webhook secret from your Commet dashboard
+     * Used to verify webhook signatures
+     */
+    webhookSecret: string;
+    /**
+     * Handles the `subscription.activated` webhook event
+     *
+     * Fired when a subscription payment is successful and the subscription becomes active.
+     * This is when you should grant access to your product.
+     *
+     * @param payload - The webhook payload containing subscription data
+     *
+     * @example
+     * ```typescript
+     * onSubscriptionActivated: async (payload) => {
+     *   await db.update(users)
+     *     .set({ isPaid: true })
+     *     .where(eq(users.id, payload.data.externalId));
+     * }
+     * ```
+     */
+    onSubscriptionActivated?: (payload: WebhookPayload) => Promise<void>;
+    /**
+     * Handles the `subscription.canceled` webhook event
+     *
+     * Fired when a subscription is canceled (either by the customer or administratively).
+     * This is when you should revoke access to your product.
+     *
+     * @param payload - The webhook payload containing subscription data
+     *
+     * @example
+     * ```typescript
+     * onSubscriptionCanceled: async (payload) => {
+     *   await db.update(users)
+     *     .set({ isPaid: false })
+     *     .where(eq(users.id, payload.data.externalId));
+     * }
+     * ```
+     */
+    onSubscriptionCanceled?: (payload: WebhookPayload) => Promise<void>;
+    /**
+     * Handles the `subscription.created` webhook event
+     *
+     * Fired when a new subscription is created, but before payment is processed.
+     * Typically used for logging or analytics, not for granting access.
+     *
+     * @param payload - The webhook payload containing subscription data
+     *
+     * @example
+     * ```typescript
+     * onSubscriptionCreated: async (payload) => {
+     *   console.log(`New subscription: ${payload.data.subscriptionId}`);
+     * }
+     * ```
+     */
+    onSubscriptionCreated?: (payload: WebhookPayload) => Promise<void>;
+    /**
+     * Handles the `subscription.updated` webhook event
+     *
+     * Fired when subscription details change (plan, quantity, status, etc.).
+     * Use this to handle upgrades, downgrades, or status transitions.
+     *
+     * @param payload - The webhook payload containing subscription data
+     *
+     * @example
+     * ```typescript
+     * onSubscriptionUpdated: async (payload) => {
+     *   if (payload.data.status === 'active') {
+     *     await handleActivation(payload);
+     *   }
+     * }
+     * ```
+     */
+    onSubscriptionUpdated?: (payload: WebhookPayload) => Promise<void>;
+    /**
+     * Catch-all handler that receives all webhook events
+     *
+     * Useful for logging, analytics, or handling events without specific handlers.
+     * Called in addition to specific event handlers.
+     *
+     * @param payload - The webhook payload
+     *
+     * @example
+     * ```typescript
+     * onPayload: async (payload) => {
+     *   console.log(`Webhook received: ${payload.event}`);
+     *   await analytics.track('webhook_received', { event: payload.event });
+     * }
+     * ```
+     */
+    onPayload?: (payload: WebhookPayload) => Promise<void>;
+    /**
+     * Error handler for webhook processing failures
+     *
+     * Called when signature verification fails or handlers throw errors.
+     * Use this for custom error logging or alerting.
+     *
+     * @param error - The error that occurred
+     * @param payload - The raw payload (may be undefined if parsing failed)
+     *
+     * @example
+     * ```typescript
+     * onError: async (error, payload) => {
+     *   console.error('Webhook error:', error);
+     *   await logger.error('webhook_failed', { error, payload });
+     * }
+     * ```
+     */
+    onError?: (error: Error, payload: unknown) => Promise<void>;
+}
+
+/**
+ * Create a Next.js webhook handler for Commet events
+ *
+ * Automatically verifies signatures, routes events to handlers, and returns proper responses.
+ *
+ * @param config - Webhook configuration with secret and event handlers
+ * @returns Next.js route handler function
+ *
+ * @example
+ * ```typescript
+ * // app/api/webhooks/commet/route.ts
+ * import { Webhooks } from "@commet/next";
+ *
+ * export const POST = Webhooks({
+ *   webhookSecret: process.env.COMMET_WEBHOOK_SECRET!,
+ *   onSubscriptionActivated: async (payload) => {
+ *     // Grant access to user
+ *   },
+ *   onSubscriptionCanceled: async (payload) => {
+ *     // Revoke access from user
+ *   },
+ * });
+ * ```
+ */
+declare const Webhooks: (config: WebhooksConfig) => (request: NextRequest) => Promise<NextResponse<{
+    received: boolean;
+}>>;
+
+export { Webhooks, type WebhooksConfig };

package/dist/index.js

@@ -0,0 +1,142 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  Webhooks: () => Webhooks
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/webhooks.ts
+var import_node = require("@commet/node");
+var import_server = require("next/server");
+var Webhooks = (config) => {
+  const {
+    webhookSecret,
+    onSubscriptionActivated,
+    onSubscriptionCanceled,
+    onSubscriptionCreated,
+    onSubscriptionUpdated,
+    onPayload,
+    onError
+  } = config;
+  const webhooks = new import_node.Webhooks();
+  return async (request) => {
+    try {
+      const rawBody = await request.text();
+      const signature = request.headers.get("x-commet-signature");
+      const isValid = webhooks.verify(rawBody, signature, webhookSecret);
+      if (!isValid) {
+        console.error("[Commet Webhook] Invalid signature");
+        return import_server.NextResponse.json(
+          { received: false, error: "Invalid signature" },
+          { status: 403 }
+        );
+      }
+      let payload;
+      try {
+        payload = JSON.parse(rawBody);
+      } catch (parseError) {
+        console.error("[Commet Webhook] Failed to parse payload:", parseError);
+        if (onError) {
+          await onError(
+            parseError instanceof Error ? parseError : new Error("Failed to parse webhook payload"),
+            rawBody
+          );
+        }
+        return import_server.NextResponse.json(
+          { received: false, error: "Invalid payload" },
+          { status: 400 }
+        );
+      }
+      const promises = [];
+      if (onPayload) {
+        promises.push(onPayload(payload));
+      }
+      switch (payload.event) {
+        case "subscription.activated":
+          if (onSubscriptionActivated) {
+            promises.push(onSubscriptionActivated(payload));
+          }
+          break;
+        case "subscription.canceled":
+          if (onSubscriptionCanceled) {
+            promises.push(onSubscriptionCanceled(payload));
+          }
+          break;
+        case "subscription.created":
+          if (onSubscriptionCreated) {
+            promises.push(onSubscriptionCreated(payload));
+          }
+          break;
+        case "subscription.updated":
+          if (onSubscriptionUpdated) {
+            promises.push(onSubscriptionUpdated(payload));
+          }
+          break;
+        default:
+          console.log(`[Commet Webhook] Unhandled event: ${payload.event}`);
+      }
+      try {
+        await Promise.all(promises);
+      } catch (handlerError) {
+        console.error(
+          "[Commet Webhook] Handler error:",
+          handlerError instanceof Error ? handlerError.message : handlerError
+        );
+        if (onError) {
+          await onError(
+            handlerError instanceof Error ? handlerError : new Error("Handler execution failed"),
+            payload
+          );
+        }
+        return import_server.NextResponse.json(
+          { received: true, warning: "Handler failed" },
+          { status: 200 }
+        );
+      }
+      return import_server.NextResponse.json({ received: true }, { status: 200 });
+    } catch (error) {
+      console.error("[Commet Webhook] Unexpected error:", error);
+      if (onError) {
+        try {
+          await onError(
+            error instanceof Error ? error : new Error("Unexpected error"),
+            void 0
+          );
+        } catch (errorHandlerError) {
+          console.error(
+            "[Commet Webhook] Error handler failed:",
+            errorHandlerError
+          );
+        }
+      }
+      return import_server.NextResponse.json(
+        { received: false, error: "Internal error" },
+        { status: 500 }
+      );
+    }
+  };
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  Webhooks
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/webhooks.ts"],"sourcesContent":["/**\n * @commet/next - Next.js integration for Commet webhooks\n *\n * @example\n * ```typescript\n * import { Webhooks } from \"@commet/next\";\n *\n * export const POST = Webhooks({\n *   webhookSecret: process.env.COMMET_WEBHOOK_SECRET!,\n *   onSubscriptionActivated: async (payload) => {\n *     // Handle activation\n *   },\n * });\n * ```\n *\n * @packageDocumentation\n */\n\nexport { Webhooks } from \"./webhooks\";\nexport type {\n  WebhooksConfig,\n  WebhookPayload,\n  WebhookData,\n  WebhookEvent,\n} from \"./types\";\n","import { Webhooks as CommetWebhooks } from \"@commet/node\";\nimport type { WebhookPayload } from \"@commet/node\";\nimport { type NextRequest, NextResponse } from \"next/server\";\nimport type { WebhooksConfig } from \"./types\";\n\n/**\n * Create a Next.js webhook handler for Commet events\n *\n * Automatically verifies signatures, routes events to handlers, and returns proper responses.\n *\n * @param config - Webhook configuration with secret and event handlers\n * @returns Next.js route handler function\n *\n * @example\n * ```typescript\n * // app/api/webhooks/commet/route.ts\n * import { Webhooks } from \"@commet/next\";\n *\n * export const POST = Webhooks({\n *   webhookSecret: process.env.COMMET_WEBHOOK_SECRET!,\n *   onSubscriptionActivated: async (payload) => {\n *     // Grant access to user\n *   },\n *   onSubscriptionCanceled: async (payload) => {\n *     // Revoke access from user\n *   },\n * });\n * ```\n */\nexport const Webhooks = (config: WebhooksConfig) => {\n  const {\n    webhookSecret,\n    onSubscriptionActivated,\n    onSubscriptionCanceled,\n    onSubscriptionCreated,\n    onSubscriptionUpdated,\n    onPayload,\n    onError,\n  } = config;\n\n  // Create webhook verifier instance\n  const webhooks = new CommetWebhooks();\n\n  return async (request: NextRequest) => {\n    try {\n      // 1. Read raw request body\n      const rawBody = await request.text();\n\n      // 2. Extract signature from headers\n      const signature = request.headers.get(\"x-commet-signature\");\n\n      // 3. Verify signature\n      const isValid = webhooks.verify(rawBody, signature, webhookSecret);\n\n      if (!isValid) {\n        console.error(\"[Commet Webhook] Invalid signature\");\n        return NextResponse.json(\n          { received: false, error: \"Invalid signature\" },\n          { status: 403 },\n        );\n      }\n\n      // 4. Parse payload\n      let payload: WebhookPayload;\n      try {\n        payload = JSON.parse(rawBody) as WebhookPayload;\n      } catch (parseError) {\n        console.error(\"[Commet Webhook] Failed to parse payload:\", parseError);\n        if (onError) {\n          await onError(\n            parseError instanceof Error\n              ? parseError\n              : new Error(\"Failed to parse webhook payload\"),\n            rawBody,\n          );\n        }\n        return NextResponse.json(\n          { received: false, error: \"Invalid payload\" },\n          { status: 400 },\n        );\n      }\n\n      // 5. Collect promises for parallel execution\n      const promises: Promise<void>[] = [];\n\n      // Call catch-all handler if provided\n      if (onPayload) {\n        promises.push(onPayload(payload));\n      }\n\n      // 6. Route to specific event handler\n      switch (payload.event) {\n        case \"subscription.activated\":\n          if (onSubscriptionActivated) {\n            promises.push(onSubscriptionActivated(payload));\n          }\n          break;\n\n        case \"subscription.canceled\":\n          if (onSubscriptionCanceled) {\n            promises.push(onSubscriptionCanceled(payload));\n          }\n          break;\n\n        case \"subscription.created\":\n          if (onSubscriptionCreated) {\n            promises.push(onSubscriptionCreated(payload));\n          }\n          break;\n\n        case \"subscription.updated\":\n          if (onSubscriptionUpdated) {\n            promises.push(onSubscriptionUpdated(payload));\n          }\n          break;\n\n        default:\n          console.log(`[Commet Webhook] Unhandled event: ${payload.event}`);\n      }\n\n      // 7. Execute all handlers in parallel\n      try {\n        await Promise.all(promises);\n      } catch (handlerError) {\n        console.error(\n          \"[Commet Webhook] Handler error:\",\n          handlerError instanceof Error ? handlerError.message : handlerError,\n        );\n        if (onError) {\n          await onError(\n            handlerError instanceof Error\n              ? handlerError\n              : new Error(\"Handler execution failed\"),\n            payload,\n          );\n        }\n        // Still return 200 to prevent retries for handler errors\n        return NextResponse.json(\n          { received: true, warning: \"Handler failed\" },\n          { status: 200 },\n        );\n      }\n\n      // 8. Success response\n      return NextResponse.json({ received: true }, { status: 200 });\n    } catch (error) {\n      console.error(\"[Commet Webhook] Unexpected error:\", error);\n      if (onError) {\n        try {\n          await onError(\n            error instanceof Error ? error : new Error(\"Unexpected error\"),\n            undefined,\n          );\n        } catch (errorHandlerError) {\n          console.error(\n            \"[Commet Webhook] Error handler failed:\",\n            errorHandlerError,\n          );\n        }\n      }\n      return NextResponse.json(\n        { received: false, error: \"Internal error\" },\n        { status: 500 },\n      );\n    }\n  };\n};\n"],"mappings":"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","names":["CommetWebhooks"]}

package/dist/index.mjs

@@ -0,0 +1,115 @@
+// src/webhooks.ts
+import { Webhooks as CommetWebhooks } from "@commet/node";
+import { NextResponse } from "next/server";
+var Webhooks = (config) => {
+  const {
+    webhookSecret,
+    onSubscriptionActivated,
+    onSubscriptionCanceled,
+    onSubscriptionCreated,
+    onSubscriptionUpdated,
+    onPayload,
+    onError
+  } = config;
+  const webhooks = new CommetWebhooks();
+  return async (request) => {
+    try {
+      const rawBody = await request.text();
+      const signature = request.headers.get("x-commet-signature");
+      const isValid = webhooks.verify(rawBody, signature, webhookSecret);
+      if (!isValid) {
+        console.error("[Commet Webhook] Invalid signature");
+        return NextResponse.json(
+          { received: false, error: "Invalid signature" },
+          { status: 403 }
+        );
+      }
+      let payload;
+      try {
+        payload = JSON.parse(rawBody);
+      } catch (parseError) {
+        console.error("[Commet Webhook] Failed to parse payload:", parseError);
+        if (onError) {
+          await onError(
+            parseError instanceof Error ? parseError : new Error("Failed to parse webhook payload"),
+            rawBody
+          );
+        }
+        return NextResponse.json(
+          { received: false, error: "Invalid payload" },
+          { status: 400 }
+        );
+      }
+      const promises = [];
+      if (onPayload) {
+        promises.push(onPayload(payload));
+      }
+      switch (payload.event) {
+        case "subscription.activated":
+          if (onSubscriptionActivated) {
+            promises.push(onSubscriptionActivated(payload));
+          }
+          break;
+        case "subscription.canceled":
+          if (onSubscriptionCanceled) {
+            promises.push(onSubscriptionCanceled(payload));
+          }
+          break;
+        case "subscription.created":
+          if (onSubscriptionCreated) {
+            promises.push(onSubscriptionCreated(payload));
+          }
+          break;
+        case "subscription.updated":
+          if (onSubscriptionUpdated) {
+            promises.push(onSubscriptionUpdated(payload));
+          }
+          break;
+        default:
+          console.log(`[Commet Webhook] Unhandled event: ${payload.event}`);
+      }
+      try {
+        await Promise.all(promises);
+      } catch (handlerError) {
+        console.error(
+          "[Commet Webhook] Handler error:",
+          handlerError instanceof Error ? handlerError.message : handlerError
+        );
+        if (onError) {
+          await onError(
+            handlerError instanceof Error ? handlerError : new Error("Handler execution failed"),
+            payload
+          );
+        }
+        return NextResponse.json(
+          { received: true, warning: "Handler failed" },
+          { status: 200 }
+        );
+      }
+      return NextResponse.json({ received: true }, { status: 200 });
+    } catch (error) {
+      console.error("[Commet Webhook] Unexpected error:", error);
+      if (onError) {
+        try {
+          await onError(
+            error instanceof Error ? error : new Error("Unexpected error"),
+            void 0
+          );
+        } catch (errorHandlerError) {
+          console.error(
+            "[Commet Webhook] Error handler failed:",
+            errorHandlerError
+          );
+        }
+      }
+      return NextResponse.json(
+        { received: false, error: "Internal error" },
+        { status: 500 }
+      );
+    }
+  };
+};
+export {
+  Webhooks
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/webhooks.ts"],"sourcesContent":["import { Webhooks as CommetWebhooks } from \"@commet/node\";\nimport type { WebhookPayload } from \"@commet/node\";\nimport { type NextRequest, NextResponse } from \"next/server\";\nimport type { WebhooksConfig } from \"./types\";\n\n/**\n * Create a Next.js webhook handler for Commet events\n *\n * Automatically verifies signatures, routes events to handlers, and returns proper responses.\n *\n * @param config - Webhook configuration with secret and event handlers\n * @returns Next.js route handler function\n *\n * @example\n * ```typescript\n * // app/api/webhooks/commet/route.ts\n * import { Webhooks } from \"@commet/next\";\n *\n * export const POST = Webhooks({\n *   webhookSecret: process.env.COMMET_WEBHOOK_SECRET!,\n *   onSubscriptionActivated: async (payload) => {\n *     // Grant access to user\n *   },\n *   onSubscriptionCanceled: async (payload) => {\n *     // Revoke access from user\n *   },\n * });\n * ```\n */\nexport const Webhooks = (config: WebhooksConfig) => {\n  const {\n    webhookSecret,\n    onSubscriptionActivated,\n    onSubscriptionCanceled,\n    onSubscriptionCreated,\n    onSubscriptionUpdated,\n    onPayload,\n    onError,\n  } = config;\n\n  // Create webhook verifier instance\n  const webhooks = new CommetWebhooks();\n\n  return async (request: NextRequest) => {\n    try {\n      // 1. Read raw request body\n      const rawBody = await request.text();\n\n      // 2. Extract signature from headers\n      const signature = request.headers.get(\"x-commet-signature\");\n\n      // 3. Verify signature\n      const isValid = webhooks.verify(rawBody, signature, webhookSecret);\n\n      if (!isValid) {\n        console.error(\"[Commet Webhook] Invalid signature\");\n        return NextResponse.json(\n          { received: false, error: \"Invalid signature\" },\n          { status: 403 },\n        );\n      }\n\n      // 4. Parse payload\n      let payload: WebhookPayload;\n      try {\n        payload = JSON.parse(rawBody) as WebhookPayload;\n      } catch (parseError) {\n        console.error(\"[Commet Webhook] Failed to parse payload:\", parseError);\n        if (onError) {\n          await onError(\n            parseError instanceof Error\n              ? parseError\n              : new Error(\"Failed to parse webhook payload\"),\n            rawBody,\n          );\n        }\n        return NextResponse.json(\n          { received: false, error: \"Invalid payload\" },\n          { status: 400 },\n        );\n      }\n\n      // 5. Collect promises for parallel execution\n      const promises: Promise<void>[] = [];\n\n      // Call catch-all handler if provided\n      if (onPayload) {\n        promises.push(onPayload(payload));\n      }\n\n      // 6. Route to specific event handler\n      switch (payload.event) {\n        case \"subscription.activated\":\n          if (onSubscriptionActivated) {\n            promises.push(onSubscriptionActivated(payload));\n          }\n          break;\n\n        case \"subscription.canceled\":\n          if (onSubscriptionCanceled) {\n            promises.push(onSubscriptionCanceled(payload));\n          }\n          break;\n\n        case \"subscription.created\":\n          if (onSubscriptionCreated) {\n            promises.push(onSubscriptionCreated(payload));\n          }\n          break;\n\n        case \"subscription.updated\":\n          if (onSubscriptionUpdated) {\n            promises.push(onSubscriptionUpdated(payload));\n          }\n          break;\n\n        default:\n          console.log(`[Commet Webhook] Unhandled event: ${payload.event}`);\n      }\n\n      // 7. Execute all handlers in parallel\n      try {\n        await Promise.all(promises);\n      } catch (handlerError) {\n        console.error(\n          \"[Commet Webhook] Handler error:\",\n          handlerError instanceof Error ? handlerError.message : handlerError,\n        );\n        if (onError) {\n          await onError(\n            handlerError instanceof Error\n              ? handlerError\n              : new Error(\"Handler execution failed\"),\n            payload,\n          );\n        }\n        // Still return 200 to prevent retries for handler errors\n        return NextResponse.json(\n          { received: true, warning: \"Handler failed\" },\n          { status: 200 },\n        );\n      }\n\n      // 8. Success response\n      return NextResponse.json({ received: true }, { status: 200 });\n    } catch (error) {\n      console.error(\"[Commet Webhook] Unexpected error:\", error);\n      if (onError) {\n        try {\n          await onError(\n            error instanceof Error ? error : new Error(\"Unexpected error\"),\n            undefined,\n          );\n        } catch (errorHandlerError) {\n          console.error(\n            \"[Commet Webhook] Error handler failed:\",\n            errorHandlerError,\n          );\n        }\n      }\n      return NextResponse.json(\n        { received: false, error: \"Internal error\" },\n        { status: 500 },\n      );\n    }\n  };\n};\n"],"mappings":";AAAA,SAAS,YAAY,sBAAsB;AAE3C,SAA2B,oBAAoB;AA2BxC,IAAM,WAAW,CAAC,WAA2B;AAClD,QAAM;AAAA,IACJ;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACF,IAAI;AAGJ,QAAM,WAAW,IAAI,eAAe;AAEpC,SAAO,OAAO,YAAyB;AACrC,QAAI;AAEF,YAAM,UAAU,MAAM,QAAQ,KAAK;AAGnC,YAAM,YAAY,QAAQ,QAAQ,IAAI,oBAAoB;AAG1D,YAAM,UAAU,SAAS,OAAO,SAAS,WAAW,aAAa;AAEjE,UAAI,CAAC,SAAS;AACZ,gBAAQ,MAAM,oCAAoC;AAClD,eAAO,aAAa;AAAA,UAClB,EAAE,UAAU,OAAO,OAAO,oBAAoB;AAAA,UAC9C,EAAE,QAAQ,IAAI;AAAA,QAChB;AAAA,MACF;AAGA,UAAI;AACJ,UAAI;AACF,kBAAU,KAAK,MAAM,OAAO;AAAA,MAC9B,SAAS,YAAY;AACnB,gBAAQ,MAAM,6CAA6C,UAAU;AACrE,YAAI,SAAS;AACX,gBAAM;AAAA,YACJ,sBAAsB,QAClB,aACA,IAAI,MAAM,iCAAiC;AAAA,YAC/C;AAAA,UACF;AAAA,QACF;AACA,eAAO,aAAa;AAAA,UAClB,EAAE,UAAU,OAAO,OAAO,kBAAkB;AAAA,UAC5C,EAAE,QAAQ,IAAI;AAAA,QAChB;AAAA,MACF;AAGA,YAAM,WAA4B,CAAC;AAGnC,UAAI,WAAW;AACb,iBAAS,KAAK,UAAU,OAAO,CAAC;AAAA,MAClC;AAGA,cAAQ,QAAQ,OAAO;AAAA,QACrB,KAAK;AACH,cAAI,yBAAyB;AAC3B,qBAAS,KAAK,wBAAwB,OAAO,CAAC;AAAA,UAChD;AACA;AAAA,QAEF,KAAK;AACH,cAAI,wBAAwB;AAC1B,qBAAS,KAAK,uBAAuB,OAAO,CAAC;AAAA,UAC/C;AACA;AAAA,QAEF,KAAK;AACH,cAAI,uBAAuB;AACzB,qBAAS,KAAK,sBAAsB,OAAO,CAAC;AAAA,UAC9C;AACA;AAAA,QAEF,KAAK;AACH,cAAI,uBAAuB;AACzB,qBAAS,KAAK,sBAAsB,OAAO,CAAC;AAAA,UAC9C;AACA;AAAA,QAEF;AACE,kBAAQ,IAAI,qCAAqC,QAAQ,KAAK,EAAE;AAAA,MACpE;AAGA,UAAI;AACF,cAAM,QAAQ,IAAI,QAAQ;AAAA,MAC5B,SAAS,cAAc;AACrB,gBAAQ;AAAA,UACN;AAAA,UACA,wBAAwB,QAAQ,aAAa,UAAU;AAAA,QACzD;AACA,YAAI,SAAS;AACX,gBAAM;AAAA,YACJ,wBAAwB,QACpB,eACA,IAAI,MAAM,0BAA0B;AAAA,YACxC;AAAA,UACF;AAAA,QACF;AAEA,eAAO,aAAa;AAAA,UAClB,EAAE,UAAU,MAAM,SAAS,iBAAiB;AAAA,UAC5C,EAAE,QAAQ,IAAI;AAAA,QAChB;AAAA,MACF;AAGA,aAAO,aAAa,KAAK,EAAE,UAAU,KAAK,GAAG,EAAE,QAAQ,IAAI,CAAC;AAAA,IAC9D,SAAS,OAAO;AACd,cAAQ,MAAM,sCAAsC,KAAK;AACzD,UAAI,SAAS;AACX,YAAI;AACF,gBAAM;AAAA,YACJ,iBAAiB,QAAQ,QAAQ,IAAI,MAAM,kBAAkB;AAAA,YAC7D;AAAA,UACF;AAAA,QACF,SAAS,mBAAmB;AAC1B,kBAAQ;AAAA,YACN;AAAA,YACA;AAAA,UACF;AAAA,QACF;AAAA,MACF;AACA,aAAO,aAAa;AAAA,QAClB,EAAE,UAAU,OAAO,OAAO,iBAAiB;AAAA,QAC3C,EAAE,QAAQ,IAAI;AAAA,MAChB;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@commet/next",
+  "version": "0.1.0",
+  "description": "Next.js integration for Commet billing platform",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "biome lint src/",
+    "lint:fix": "biome lint --write src/",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "keywords": ["commet", "billing", "nextjs", "webhooks", "typescript"],
+  "author": "Commet Team",
+  "license": "MIT",
+  "dependencies": {
+    "@commet/node": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "24.10.1",
+    "next": "15.1.3",
+    "tsup": "8.5.0",
+    "typescript": "5.9.3",
+    "vitest": "2.1.8"
+  },
+  "peerDependencies": {
+    "next": ">=14.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "homepage": "https://commet.co",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/commet-labs/commet.git",
+    "directory": "packages/next"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}