@fastaar/nextjs 0.1.0

package/dist/components.cjs

@@ -0,0 +1,37 @@
+"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);
+var components_exports = {};
+__export(components_exports, {
+  CheckoutButton: () => CheckoutButton
+});
+module.exports = __toCommonJS(components_exports);
+var import_jsx_runtime = require("react/jsx-runtime");
+var import_actions = require("./actions");
+function CheckoutButton({
+  paymentParams,
+  children,
+  ...buttonProps
+}) {
+  return /* @__PURE__ */ (0, import_jsx_runtime.jsx)("form", { action: import_actions.createCheckoutRedirect.bind(null, paymentParams), style: { display: "inline-block" }, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)("button", { type: "submit", ...buttonProps, children: children ?? "Pay with Fastaar" }) });
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CheckoutButton
+});
+//# sourceMappingURL=components.cjs.map

package/dist/components.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components.tsx"],"sourcesContent":["import React from 'react';\nimport { createCheckoutRedirect } from './actions';\nimport { CreatePaymentParams } from './types';\n\nexport interface CheckoutButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  /**\n   * Payment parameters such as amount, invoice_id, success_url, cancel_url, and metadata.\n   */\n  paymentParams: CreatePaymentParams;\n\n  /**\n   * Content of the button. Defaults to 'Pay with Fastaar'.\n   */\n  children?: React.ReactNode;\n}\n\n/**\n * A React Server Component that renders a checkout button.\n * Clicking the button invokes a Server Action that creates a payment\n * and redirects the user to the Fastaar checkout page.\n */\nexport function CheckoutButton({\n  paymentParams,\n  children,\n  ...buttonProps\n}: CheckoutButtonProps) {\n  return (\n    <form action={createCheckoutRedirect.bind(null, paymentParams)} style={{ display: 'inline-block' }}>\n      <button type=\"submit\" {...buttonProps}>\n        {children ?? 'Pay with Fastaar'}\n      </button>\n    </form>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AA4BM;AA3BN,qBAAuC;AAoBhC,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAwB;AACtB,SACE,4CAAC,UAAK,QAAQ,sCAAuB,KAAK,MAAM,aAAa,GAAG,OAAO,EAAE,SAAS,eAAe,GAC/F,sDAAC,YAAO,MAAK,UAAU,GAAG,aACvB,sBAAY,oBACf,GACF;AAEJ;","names":[]}

package/dist/components.d.cts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { CreatePaymentParams } from './types.cjs';
+
+interface CheckoutButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    /**
+     * Payment parameters such as amount, invoice_id, success_url, cancel_url, and metadata.
+     */
+    paymentParams: CreatePaymentParams;
+    /**
+     * Content of the button. Defaults to 'Pay with Fastaar'.
+     */
+    children?: React.ReactNode;
+}
+/**
+ * A React Server Component that renders a checkout button.
+ * Clicking the button invokes a Server Action that creates a payment
+ * and redirects the user to the Fastaar checkout page.
+ */
+declare function CheckoutButton({ paymentParams, children, ...buttonProps }: CheckoutButtonProps): React.JSX.Element;
+
+export { CheckoutButton, type CheckoutButtonProps };

package/dist/components.d.ts

@@ -0,0 +1,21 @@
+import React from 'react';
+import { CreatePaymentParams } from './types.js';
+
+interface CheckoutButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {
+    /**
+     * Payment parameters such as amount, invoice_id, success_url, cancel_url, and metadata.
+     */
+    paymentParams: CreatePaymentParams;
+    /**
+     * Content of the button. Defaults to 'Pay with Fastaar'.
+     */
+    children?: React.ReactNode;
+}
+/**
+ * A React Server Component that renders a checkout button.
+ * Clicking the button invokes a Server Action that creates a payment
+ * and redirects the user to the Fastaar checkout page.
+ */
+declare function CheckoutButton({ paymentParams, children, ...buttonProps }: CheckoutButtonProps): React.JSX.Element;
+
+export { CheckoutButton, type CheckoutButtonProps };

package/dist/components.js

@@ -0,0 +1,13 @@
+import { jsx } from "react/jsx-runtime";
+import { createCheckoutRedirect } from "./actions";
+function CheckoutButton({
+  paymentParams,
+  children,
+  ...buttonProps
+}) {
+  return /* @__PURE__ */ jsx("form", { action: createCheckoutRedirect.bind(null, paymentParams), style: { display: "inline-block" }, children: /* @__PURE__ */ jsx("button", { type: "submit", ...buttonProps, children: children ?? "Pay with Fastaar" }) });
+}
+export {
+  CheckoutButton
+};
+//# sourceMappingURL=components.js.map

package/dist/components.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components.tsx"],"sourcesContent":["import React from 'react';\nimport { createCheckoutRedirect } from './actions';\nimport { CreatePaymentParams } from './types';\n\nexport interface CheckoutButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement> {\n  /**\n   * Payment parameters such as amount, invoice_id, success_url, cancel_url, and metadata.\n   */\n  paymentParams: CreatePaymentParams;\n\n  /**\n   * Content of the button. Defaults to 'Pay with Fastaar'.\n   */\n  children?: React.ReactNode;\n}\n\n/**\n * A React Server Component that renders a checkout button.\n * Clicking the button invokes a Server Action that creates a payment\n * and redirects the user to the Fastaar checkout page.\n */\nexport function CheckoutButton({\n  paymentParams,\n  children,\n  ...buttonProps\n}: CheckoutButtonProps) {\n  return (\n    <form action={createCheckoutRedirect.bind(null, paymentParams)} style={{ display: 'inline-block' }}>\n      <button type=\"submit\" {...buttonProps}>\n        {children ?? 'Pay with Fastaar'}\n      </button>\n    </form>\n  );\n}\n"],"mappings":"AA4BM;AA3BN,SAAS,8BAA8B;AAoBhC,SAAS,eAAe;AAAA,EAC7B;AAAA,EACA;AAAA,EACA,GAAG;AACL,GAAwB;AACtB,SACE,oBAAC,UAAK,QAAQ,uBAAuB,KAAK,MAAM,aAAa,GAAG,OAAO,EAAE,SAAS,eAAe,GAC/F,8BAAC,YAAO,MAAK,UAAU,GAAG,aACvB,sBAAY,oBACf,GACF;AAEJ;","names":[]}

package/dist/index.cjs

@@ -0,0 +1,31 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require("./types"), module.exports);
+__reExport(index_exports, require("./client"), module.exports);
+__reExport(index_exports, require("./webhook"), module.exports);
+__reExport(index_exports, require("./actions"), module.exports);
+__reExport(index_exports, require("./components"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ...require("./types"),
+  ...require("./client"),
+  ...require("./webhook"),
+  ...require("./actions"),
+  ...require("./components")
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './types';\nexport * from './client';\nexport * from './webhook';\nexport * from './actions';\nexport * from './components';\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,oBAAd;AACA,0BAAc,qBADd;AAEA,0BAAc,sBAFd;AAGA,0BAAc,sBAHd;AAIA,0BAAc,yBAJd;","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,6 @@
+export { CreatePaymentParams, FastaarClientOptions, ListPaymentsParams, Payment, WebhookEvent } from './types.cjs';
+export { FastaarClient, FastaarError, getFastaarClient } from './client.cjs';
+export { verifyNextWebhook, verifyWebhookSignature } from './webhook.cjs';
+export { createCheckoutRedirect } from './actions.cjs';
+export { CheckoutButton, CheckoutButtonProps } from './components.cjs';
+import 'react';

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { CreatePaymentParams, FastaarClientOptions, ListPaymentsParams, Payment, WebhookEvent } from './types.js';
+export { FastaarClient, FastaarError, getFastaarClient } from './client.js';
+export { verifyNextWebhook, verifyWebhookSignature } from './webhook.js';
+export { createCheckoutRedirect } from './actions.js';
+export { CheckoutButton, CheckoutButtonProps } from './components.js';
+import 'react';

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./types";
+export * from "./client";
+export * from "./webhook";
+export * from "./actions";
+export * from "./components";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './types';\nexport * from './client';\nexport * from './webhook';\nexport * from './actions';\nexport * from './components';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;","names":[]}

package/dist/types.cjs

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+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);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);
+//# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * Configuration options for the Fastaar client.\n */\nexport interface FastaarClientOptions {\n  /**\n   * Timeout in milliseconds for API requests. Defaults to 15000.\n   */\n  timeoutMs?: number;\n}\n\n/**\n * Parameters for creating a new payment.\n */\nexport interface CreatePaymentParams {\n  /**\n   * The amount to charge (can be a number or string representation of a decimal).\n   */\n  amount: number | string;\n\n  /**\n   * Your custom reference identifier for the invoice/order.\n   * Supplying the same invoice_id will retrieve the existing payment intent\n   * instead of creating a duplicate, ensuring idempotency.\n   */\n  invoice_id?: string;\n\n  /**\n   * The URL to redirect the customer to upon successful payment completion.\n   */\n  success_url?: string;\n\n  /**\n   * The URL to redirect the customer to if they cancel the checkout process.\n   */\n  cancel_url?: string;\n\n  /**\n   * Arbitrary key-value metadata to attach to the payment.\n   */\n  metadata?: Record<string, string>;\n}\n\n/**\n * Parameters for querying the list of payments.\n */\nexport interface ListPaymentsParams extends Record<string, string | number | undefined> {\n  /**\n   * Filter payments by status (e.g., 'completed', 'pending', 'cancelled').\n   */\n  status?: string;\n\n  /**\n   * Filter payments by your custom invoice/order reference.\n   */\n  invoice_id?: string;\n\n  /**\n   * Number of payments to return per page.\n   */\n  per_page?: number;\n\n  /**\n   * Page number to retrieve (for pagination).\n   */\n  page?: number;\n}\n\n/**\n * Representation of a payment object returned by the Fastaar API.\n */\nexport interface Payment {\n  /**\n   * Unique Fastaar transaction identifier.\n   */\n  id: string;\n\n  /**\n   * The transaction amount.\n   */\n  amount: string;\n\n  /**\n   * The associated invoice ID supplied when the payment was created.\n   */\n  invoice_id?: string;\n\n  /**\n   * The current status of the payment (e.g., 'completed', 'pending', 'cancelled').\n   */\n  status: string;\n\n  /**\n   * The secure hosted checkout URL where the customer completes payment.\n   */\n  checkout_url: string;\n\n  /**\n   * The customer's mobile number, if paid (e.g. bKash or Nagad wallet number).\n   */\n  wallet_number?: string;\n\n  /**\n   * The payment method used (e.g., 'bkash', 'nagad').\n   */\n  payment_method?: string;\n\n  /**\n   * Transaction ID from the mobile operator/gateway (e.g. bKash trxID).\n   */\n  trx_id?: string;\n\n  /**\n   * Indicates whether this payment is live or test mode.\n   */\n  livemode: boolean;\n\n  /**\n   * Arbitrary metadata stored on the payment.\n   */\n  metadata?: Record<string, string>;\n\n  /**\n   * Payment creation timestamp.\n   */\n  created_at: string;\n\n  /**\n   * Payment completion timestamp (if completed).\n   */\n  completed_at?: string;\n}\n\n/**\n * Structure of a Fastaar Webhook event request body.\n */\nexport interface WebhookEvent {\n  /**\n   * The type of event (e.g., 'payment.completed').\n   */\n  event: string;\n\n  /**\n   * Indicates whether this event occurred in live mode or test mode.\n   */\n  livemode: boolean;\n\n  /**\n   * The payment object details associated with this event.\n   */\n  data: Payment;\n}\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}

package/dist/types.d.cts

@@ -0,0 +1,129 @@
+/**
+ * Configuration options for the Fastaar client.
+ */
+interface FastaarClientOptions {
+    /**
+     * Timeout in milliseconds for API requests. Defaults to 15000.
+     */
+    timeoutMs?: number;
+}
+/**
+ * Parameters for creating a new payment.
+ */
+interface CreatePaymentParams {
+    /**
+     * The amount to charge (can be a number or string representation of a decimal).
+     */
+    amount: number | string;
+    /**
+     * Your custom reference identifier for the invoice/order.
+     * Supplying the same invoice_id will retrieve the existing payment intent
+     * instead of creating a duplicate, ensuring idempotency.
+     */
+    invoice_id?: string;
+    /**
+     * The URL to redirect the customer to upon successful payment completion.
+     */
+    success_url?: string;
+    /**
+     * The URL to redirect the customer to if they cancel the checkout process.
+     */
+    cancel_url?: string;
+    /**
+     * Arbitrary key-value metadata to attach to the payment.
+     */
+    metadata?: Record<string, string>;
+}
+/**
+ * Parameters for querying the list of payments.
+ */
+interface ListPaymentsParams extends Record<string, string | number | undefined> {
+    /**
+     * Filter payments by status (e.g., 'completed', 'pending', 'cancelled').
+     */
+    status?: string;
+    /**
+     * Filter payments by your custom invoice/order reference.
+     */
+    invoice_id?: string;
+    /**
+     * Number of payments to return per page.
+     */
+    per_page?: number;
+    /**
+     * Page number to retrieve (for pagination).
+     */
+    page?: number;
+}
+/**
+ * Representation of a payment object returned by the Fastaar API.
+ */
+interface Payment {
+    /**
+     * Unique Fastaar transaction identifier.
+     */
+    id: string;
+    /**
+     * The transaction amount.
+     */
+    amount: string;
+    /**
+     * The associated invoice ID supplied when the payment was created.
+     */
+    invoice_id?: string;
+    /**
+     * The current status of the payment (e.g., 'completed', 'pending', 'cancelled').
+     */
+    status: string;
+    /**
+     * The secure hosted checkout URL where the customer completes payment.
+     */
+    checkout_url: string;
+    /**
+     * The customer's mobile number, if paid (e.g. bKash or Nagad wallet number).
+     */
+    wallet_number?: string;
+    /**
+     * The payment method used (e.g., 'bkash', 'nagad').
+     */
+    payment_method?: string;
+    /**
+     * Transaction ID from the mobile operator/gateway (e.g. bKash trxID).
+     */
+    trx_id?: string;
+    /**
+     * Indicates whether this payment is live or test mode.
+     */
+    livemode: boolean;
+    /**
+     * Arbitrary metadata stored on the payment.
+     */
+    metadata?: Record<string, string>;
+    /**
+     * Payment creation timestamp.
+     */
+    created_at: string;
+    /**
+     * Payment completion timestamp (if completed).
+     */
+    completed_at?: string;
+}
+/**
+ * Structure of a Fastaar Webhook event request body.
+ */
+interface WebhookEvent {
+    /**
+     * The type of event (e.g., 'payment.completed').
+     */
+    event: string;
+    /**
+     * Indicates whether this event occurred in live mode or test mode.
+     */
+    livemode: boolean;
+    /**
+     * The payment object details associated with this event.
+     */
+    data: Payment;
+}
+
+export type { CreatePaymentParams, FastaarClientOptions, ListPaymentsParams, Payment, WebhookEvent };

package/dist/types.d.ts

@@ -0,0 +1,129 @@
+/**
+ * Configuration options for the Fastaar client.
+ */
+interface FastaarClientOptions {
+    /**
+     * Timeout in milliseconds for API requests. Defaults to 15000.
+     */
+    timeoutMs?: number;
+}
+/**
+ * Parameters for creating a new payment.
+ */
+interface CreatePaymentParams {
+    /**
+     * The amount to charge (can be a number or string representation of a decimal).
+     */
+    amount: number | string;
+    /**
+     * Your custom reference identifier for the invoice/order.
+     * Supplying the same invoice_id will retrieve the existing payment intent
+     * instead of creating a duplicate, ensuring idempotency.
+     */
+    invoice_id?: string;
+    /**
+     * The URL to redirect the customer to upon successful payment completion.
+     */
+    success_url?: string;
+    /**
+     * The URL to redirect the customer to if they cancel the checkout process.
+     */
+    cancel_url?: string;
+    /**
+     * Arbitrary key-value metadata to attach to the payment.
+     */
+    metadata?: Record<string, string>;
+}
+/**
+ * Parameters for querying the list of payments.
+ */
+interface ListPaymentsParams extends Record<string, string | number | undefined> {
+    /**
+     * Filter payments by status (e.g., 'completed', 'pending', 'cancelled').
+     */
+    status?: string;
+    /**
+     * Filter payments by your custom invoice/order reference.
+     */
+    invoice_id?: string;
+    /**
+     * Number of payments to return per page.
+     */
+    per_page?: number;
+    /**
+     * Page number to retrieve (for pagination).
+     */
+    page?: number;
+}
+/**
+ * Representation of a payment object returned by the Fastaar API.
+ */
+interface Payment {
+    /**
+     * Unique Fastaar transaction identifier.
+     */
+    id: string;
+    /**
+     * The transaction amount.
+     */
+    amount: string;
+    /**
+     * The associated invoice ID supplied when the payment was created.
+     */
+    invoice_id?: string;
+    /**
+     * The current status of the payment (e.g., 'completed', 'pending', 'cancelled').
+     */
+    status: string;
+    /**
+     * The secure hosted checkout URL where the customer completes payment.
+     */
+    checkout_url: string;
+    /**
+     * The customer's mobile number, if paid (e.g. bKash or Nagad wallet number).
+     */
+    wallet_number?: string;
+    /**
+     * The payment method used (e.g., 'bkash', 'nagad').
+     */
+    payment_method?: string;
+    /**
+     * Transaction ID from the mobile operator/gateway (e.g. bKash trxID).
+     */
+    trx_id?: string;
+    /**
+     * Indicates whether this payment is live or test mode.
+     */
+    livemode: boolean;
+    /**
+     * Arbitrary metadata stored on the payment.
+     */
+    metadata?: Record<string, string>;
+    /**
+     * Payment creation timestamp.
+     */
+    created_at: string;
+    /**
+     * Payment completion timestamp (if completed).
+     */
+    completed_at?: string;
+}
+/**
+ * Structure of a Fastaar Webhook event request body.
+ */
+interface WebhookEvent {
+    /**
+     * The type of event (e.g., 'payment.completed').
+     */
+    event: string;
+    /**
+     * Indicates whether this event occurred in live mode or test mode.
+     */
+    livemode: boolean;
+    /**
+     * The payment object details associated with this event.
+     */
+    data: Payment;
+}
+
+export type { CreatePaymentParams, FastaarClientOptions, ListPaymentsParams, Payment, WebhookEvent };

package/dist/types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/webhook.cjs

@@ -0,0 +1,79 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var webhook_exports = {};
+__export(webhook_exports, {
+  verifyNextWebhook: () => verifyNextWebhook,
+  verifyWebhookSignature: () => verifyWebhookSignature
+});
+module.exports = __toCommonJS(webhook_exports);
+var import_node_crypto = __toESM(require("node:crypto"), 1);
+function verifyWebhookSignature(secret, rawBody, signatureHeader, toleranceSeconds = 300) {
+  const match = /^t=(\d+),v1=([a-f0-9]{64})$/.exec(signatureHeader ?? "");
+  if (!match) {
+    return false;
+  }
+  const timestamp = Number(match[1]);
+  if (Math.abs(Date.now() / 1e3 - timestamp) > toleranceSeconds) {
+    return false;
+  }
+  const expected = import_node_crypto.default.createHmac("sha256", secret).update(`${timestamp}.${rawBody}`).digest("hex");
+  try {
+    return import_node_crypto.default.timingSafeEqual(Buffer.from(expected), Buffer.from(match[2]));
+  } catch {
+    return false;
+  }
+}
+async function verifyNextWebhook(req, secret) {
+  const webhookSecret = secret ?? process.env.FASTAAR_WEBHOOK_SECRET;
+  if (!webhookSecret) {
+    throw new Error("Fastaar webhook secret is required for verification.");
+  }
+  const signature = req.headers.get("x-fastaar-signature") || req.headers.get("X-Fastaar-Signature");
+  if (!signature) {
+    return { isValid: false, event: null };
+  }
+  try {
+    const clonedReq = req.clone();
+    const rawBody = await clonedReq.text();
+    const isValid = verifyWebhookSignature(webhookSecret, rawBody, signature);
+    if (!isValid) {
+      return { isValid: false, event: null };
+    }
+    const event = JSON.parse(rawBody);
+    return { isValid: true, event };
+  } catch {
+    return { isValid: false, event: null };
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  verifyNextWebhook,
+  verifyWebhookSignature
+});
+//# sourceMappingURL=webhook.cjs.map

package/dist/webhook.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/webhook.ts"],"sourcesContent":["import crypto from 'node:crypto';\nimport { WebhookEvent } from './types';\n\n/**\n * Verify the X-Fastaar-Signature header (`t=<ts>,v1=<hmac>`) against the\n * raw request body using your merchant webhook secret.\n *\n * @param secret Your merchant webhook secret\n * @param rawBody The raw request body string or Buffer\n * @param signatureHeader The value of the X-Fastaar-Signature header\n * @param toleranceSeconds Allowed drift in seconds. Defaults to 300 (5 minutes).\n * @returns boolean\n */\nexport function verifyWebhookSignature(\n  secret: string,\n  rawBody: string | Buffer,\n  signatureHeader: string | null | undefined,\n  toleranceSeconds = 300\n): boolean {\n  const match = /^t=(\\d+),v1=([a-f0-9]{64})$/.exec(signatureHeader ?? '');\n\n  if (!match) {\n    return false;\n  }\n\n  const timestamp = Number(match[1]);\n\n  if (Math.abs(Date.now() / 1000 - timestamp) > toleranceSeconds) {\n    return false;\n  }\n\n  const expected = crypto\n    .createHmac('sha256', secret)\n    .update(`${timestamp}.${rawBody}`)\n    .digest('hex');\n\n  try {\n    return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(match[2]));\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Verifies and parses a webhook event request from a Next.js App Router Route Handler.\n * It automatically reads the request's raw text body, verifies the signature, and\n * returns the parsed event object.\n *\n * @param req The Request (or NextRequest) object from the Route Handler\n * @param secret The webhook secret. Defaults to process.env.FASTAAR_WEBHOOK_SECRET.\n * @returns {Promise<{ isValid: boolean; event: WebhookEvent | null }>}\n */\nexport async function verifyNextWebhook(\n  req: Request,\n  secret?: string\n): Promise<{ isValid: boolean; event: WebhookEvent | null }> {\n  const webhookSecret = secret ?? process.env.FASTAAR_WEBHOOK_SECRET;\n  if (!webhookSecret) {\n    throw new Error('Fastaar webhook secret is required for verification.');\n  }\n\n  const signature = req.headers.get('x-fastaar-signature') || req.headers.get('X-Fastaar-Signature');\n  if (!signature) {\n    return { isValid: false, event: null };\n  }\n\n  try {\n    // Clone the request to avoid locking the stream if accessed again\n    const clonedReq = req.clone();\n    const rawBody = await clonedReq.text();\n\n    const isValid = verifyWebhookSignature(webhookSecret, rawBody, signature);\n    if (!isValid) {\n      return { isValid: false, event: null };\n    }\n\n    const event = JSON.parse(rawBody) as WebhookEvent;\n    return { isValid: true, event };\n  } catch {\n    return { isValid: false, event: null };\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,yBAAmB;AAaZ,SAAS,uBACd,QACA,SACA,iBACA,mBAAmB,KACV;AACT,QAAM,QAAQ,8BAA8B,KAAK,mBAAmB,EAAE;AAEtE,MAAI,CAAC,OAAO;AACV,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,OAAO,MAAM,CAAC,CAAC;AAEjC,MAAI,KAAK,IAAI,KAAK,IAAI,IAAI,MAAO,SAAS,IAAI,kBAAkB;AAC9D,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,mBAAAA,QACd,WAAW,UAAU,MAAM,EAC3B,OAAO,GAAG,SAAS,IAAI,OAAO,EAAE,EAChC,OAAO,KAAK;AAEf,MAAI;AACF,WAAO,mBAAAA,QAAO,gBAAgB,OAAO,KAAK,QAAQ,GAAG,OAAO,KAAK,MAAM,CAAC,CAAC,CAAC;AAAA,EAC5E,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AAWA,eAAsB,kBACpB,KACA,QAC2D;AAC3D,QAAM,gBAAgB,UAAU,QAAQ,IAAI;AAC5C,MAAI,CAAC,eAAe;AAClB,UAAM,IAAI,MAAM,sDAAsD;AAAA,EACxE;AAEA,QAAM,YAAY,IAAI,QAAQ,IAAI,qBAAqB,KAAK,IAAI,QAAQ,IAAI,qBAAqB;AACjG,MAAI,CAAC,WAAW;AACd,WAAO,EAAE,SAAS,OAAO,OAAO,KAAK;AAAA,EACvC;AAEA,MAAI;AAEF,UAAM,YAAY,IAAI,MAAM;AAC5B,UAAM,UAAU,MAAM,UAAU,KAAK;AAErC,UAAM,UAAU,uBAAuB,eAAe,SAAS,SAAS;AACxE,QAAI,CAAC,SAAS;AACZ,aAAO,EAAE,SAAS,OAAO,OAAO,KAAK;AAAA,IACvC;AAEA,UAAM,QAAQ,KAAK,MAAM,OAAO;AAChC,WAAO,EAAE,SAAS,MAAM,MAAM;AAAA,EAChC,QAAQ;AACN,WAAO,EAAE,SAAS,OAAO,OAAO,KAAK;AAAA,EACvC;AACF;","names":["crypto"]}

package/dist/webhook.d.cts

@@ -0,0 +1,28 @@
+import { WebhookEvent } from './types.cjs';
+
+/**
+ * Verify the X-Fastaar-Signature header (`t=<ts>,v1=<hmac>`) against the
+ * raw request body using your merchant webhook secret.
+ *
+ * @param secret Your merchant webhook secret
+ * @param rawBody The raw request body string or Buffer
+ * @param signatureHeader The value of the X-Fastaar-Signature header
+ * @param toleranceSeconds Allowed drift in seconds. Defaults to 300 (5 minutes).
+ * @returns boolean
+ */
+declare function verifyWebhookSignature(secret: string, rawBody: string | Buffer, signatureHeader: string | null | undefined, toleranceSeconds?: number): boolean;
+/**
+ * Verifies and parses a webhook event request from a Next.js App Router Route Handler.
+ * It automatically reads the request's raw text body, verifies the signature, and
+ * returns the parsed event object.
+ *
+ * @param req The Request (or NextRequest) object from the Route Handler
+ * @param secret The webhook secret. Defaults to process.env.FASTAAR_WEBHOOK_SECRET.
+ * @returns {Promise<{ isValid: boolean; event: WebhookEvent | null }>}
+ */
+declare function verifyNextWebhook(req: Request, secret?: string): Promise<{
+    isValid: boolean;
+    event: WebhookEvent | null;
+}>;
+
+export { verifyNextWebhook, verifyWebhookSignature };

package/dist/webhook.d.ts

@@ -0,0 +1,28 @@
+import { WebhookEvent } from './types.js';
+
+/**
+ * Verify the X-Fastaar-Signature header (`t=<ts>,v1=<hmac>`) against the
+ * raw request body using your merchant webhook secret.
+ *
+ * @param secret Your merchant webhook secret
+ * @param rawBody The raw request body string or Buffer
+ * @param signatureHeader The value of the X-Fastaar-Signature header
+ * @param toleranceSeconds Allowed drift in seconds. Defaults to 300 (5 minutes).
+ * @returns boolean
+ */
+declare function verifyWebhookSignature(secret: string, rawBody: string | Buffer, signatureHeader: string | null | undefined, toleranceSeconds?: number): boolean;
+/**
+ * Verifies and parses a webhook event request from a Next.js App Router Route Handler.
+ * It automatically reads the request's raw text body, verifies the signature, and
+ * returns the parsed event object.
+ *
+ * @param req The Request (or NextRequest) object from the Route Handler
+ * @param secret The webhook secret. Defaults to process.env.FASTAAR_WEBHOOK_SECRET.
+ * @returns {Promise<{ isValid: boolean; event: WebhookEvent | null }>}
+ */
+declare function verifyNextWebhook(req: Request, secret?: string): Promise<{
+    isValid: boolean;
+    event: WebhookEvent | null;
+}>;
+
+export { verifyNextWebhook, verifyWebhookSignature };

package/dist/webhook.js

@@ -0,0 +1,44 @@
+import crypto from "node:crypto";
+function verifyWebhookSignature(secret, rawBody, signatureHeader, toleranceSeconds = 300) {
+  const match = /^t=(\d+),v1=([a-f0-9]{64})$/.exec(signatureHeader ?? "");
+  if (!match) {
+    return false;
+  }
+  const timestamp = Number(match[1]);
+  if (Math.abs(Date.now() / 1e3 - timestamp) > toleranceSeconds) {
+    return false;
+  }
+  const expected = crypto.createHmac("sha256", secret).update(`${timestamp}.${rawBody}`).digest("hex");
+  try {
+    return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(match[2]));
+  } catch {
+    return false;
+  }
+}
+async function verifyNextWebhook(req, secret) {
+  const webhookSecret = secret ?? process.env.FASTAAR_WEBHOOK_SECRET;
+  if (!webhookSecret) {
+    throw new Error("Fastaar webhook secret is required for verification.");
+  }
+  const signature = req.headers.get("x-fastaar-signature") || req.headers.get("X-Fastaar-Signature");
+  if (!signature) {
+    return { isValid: false, event: null };
+  }
+  try {
+    const clonedReq = req.clone();
+    const rawBody = await clonedReq.text();
+    const isValid = verifyWebhookSignature(webhookSecret, rawBody, signature);
+    if (!isValid) {
+      return { isValid: false, event: null };
+    }
+    const event = JSON.parse(rawBody);
+    return { isValid: true, event };
+  } catch {
+    return { isValid: false, event: null };
+  }
+}
+export {
+  verifyNextWebhook,
+  verifyWebhookSignature
+};
+//# sourceMappingURL=webhook.js.map