@siyegs/pay-kit 0.1.0

package/dist/index.js

@@ -0,0 +1,457 @@
+// src/client.ts
+import { randomUUID } from "crypto";
+
+// src/errors.ts
+function isRetryableError(err) {
+  if (!(err instanceof PayKitError)) return false;
+  if (err.code === "network_error") return true;
+  if (typeof err.statusCode === "number") {
+    return err.statusCode >= 500 || err.statusCode === 429;
+  }
+  return false;
+}
+var PayKitError = class extends Error {
+  code;
+  provider;
+  statusCode;
+  raw;
+  constructor(message, options) {
+    super(message, options.cause !== void 0 ? { cause: options.cause } : void 0);
+    this.name = "PayKitError";
+    this.code = options.code;
+    this.provider = options.provider;
+    this.statusCode = options.statusCode;
+    this.raw = options.raw;
+  }
+};
+
+// src/providers/paystack.ts
+import { createHmac } from "crypto";
+
+// src/internal.ts
+import { timingSafeEqual } from "crypto";
+async function providerRequest(ctx, provider, url, init) {
+  let res;
+  try {
+    res = await ctx.fetch(url, {
+      ...init,
+      headers: {
+        Authorization: `Bearer ${ctx.secretKey}`,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        ...init.headers ?? {}
+      }
+    });
+  } catch (err) {
+    throw new PayKitError(`Network error calling ${provider}`, {
+      code: "network_error",
+      provider,
+      cause: err
+    });
+  }
+  let body = {};
+  try {
+    body = await res.json();
+  } catch {
+    body = {};
+  }
+  if (!res.ok || body.status === false || body.status === "error") {
+    const message = typeof body.message === "string" ? body.message : `${provider} request failed (${res.status})`;
+    throw new PayKitError(message, {
+      code: "provider_error",
+      provider,
+      statusCode: res.status,
+      raw: body
+    });
+  }
+  return body;
+}
+function safeEqual(a, b) {
+  const ba = Buffer.from(a);
+  const bb = Buffer.from(b);
+  if (ba.length !== bb.length) return false;
+  return timingSafeEqual(ba, bb);
+}
+
+// src/providers/paystack.ts
+var PAYSTACK_BASE = "https://api.paystack.co";
+function mapStatus(raw) {
+  switch (raw) {
+    case "success":
+      return "success";
+    case "failed":
+      return "failed";
+    case "abandoned":
+      return "abandoned";
+    default:
+      return "pending";
+  }
+}
+function mapEventType(event) {
+  return typeof event === "string" && event.length > 0 ? event : "unknown";
+}
+function mapRefundStatus(raw) {
+  switch (raw) {
+    case "processed":
+    case "success":
+      return "processed";
+    case "failed":
+      return "failed";
+    default:
+      return "pending";
+  }
+}
+function createPaystackProvider(ctx) {
+  const base = ctx.baseUrl ?? PAYSTACK_BASE;
+  return {
+    name: "paystack",
+    async initialize(params) {
+      const reference = params.reference ?? ctx.generateReference();
+      const body = await providerRequest(ctx, "paystack", `${base}/transaction/initialize`, {
+        method: "POST",
+        body: JSON.stringify({
+          amount: params.amount,
+          email: params.email,
+          currency: params.currency ?? "NGN",
+          reference,
+          callback_url: params.callbackUrl,
+          metadata: params.metadata
+        })
+      });
+      const data = body.data ?? {};
+      return {
+        reference: String(data.reference ?? reference),
+        authorizationUrl: String(data.authorization_url ?? ""),
+        accessCode: data.access_code ? String(data.access_code) : void 0,
+        raw: body
+      };
+    },
+    async verify(reference) {
+      const body = await providerRequest(
+        ctx,
+        "paystack",
+        `${base}/transaction/verify/${encodeURIComponent(reference)}`,
+        { method: "GET" }
+      );
+      const data = body.data ?? {};
+      const customer = data.customer ?? {};
+      return {
+        reference: String(data.reference ?? reference),
+        status: mapStatus(data.status),
+        amount: Number(data.amount ?? 0),
+        currency: String(data.currency ?? ""),
+        paidAt: data.paid_at ? String(data.paid_at) : void 0,
+        channel: data.channel ? String(data.channel) : void 0,
+        customer: { email: customer.email ? String(customer.email) : void 0 },
+        raw: body
+      };
+    },
+    async refund(reference, options) {
+      const body = await providerRequest(ctx, "paystack", `${base}/refund`, {
+        method: "POST",
+        body: JSON.stringify({
+          transaction: reference,
+          ...options?.amount !== void 0 ? { amount: options.amount } : {}
+        })
+      });
+      const data = body.data ?? {};
+      const transaction = data.transaction ?? {};
+      return {
+        reference: String(transaction.reference ?? reference),
+        status: mapRefundStatus(data.status),
+        amount: data.amount !== void 0 ? Number(data.amount) : void 0,
+        raw: body
+      };
+    },
+    constructWebhookEvent(rawBody, signature) {
+      const expected = createHmac("sha512", ctx.secretKey).update(rawBody).digest("hex");
+      if (!signature || !safeEqual(expected, signature)) {
+        throw new PayKitError("Invalid Paystack webhook signature", {
+          code: "invalid_signature",
+          provider: "paystack"
+        });
+      }
+      let event;
+      try {
+        event = JSON.parse(rawBody);
+      } catch (err) {
+        throw new PayKitError("Malformed Paystack webhook body", {
+          code: "provider_error",
+          provider: "paystack",
+          cause: err
+        });
+      }
+      const data = event.data ?? {};
+      return {
+        type: mapEventType(event.event),
+        reference: String(data.reference ?? ""),
+        status: data.status ? mapStatus(data.status) : void 0,
+        amount: data.amount !== void 0 ? Number(data.amount) : void 0,
+        currency: data.currency ? String(data.currency) : void 0,
+        raw: event
+      };
+    }
+  };
+}
+
+// src/providers/flutterwave.ts
+var FLUTTERWAVE_BASE = "https://api.flutterwave.com";
+function toMajor(subunits) {
+  return subunits / 100;
+}
+function toSubunits(major) {
+  return Math.round(Number(major ?? 0) * 100);
+}
+function mapStatus2(raw) {
+  switch (raw) {
+    case "successful":
+    case "success":
+      return "success";
+    case "failed":
+      return "failed";
+    default:
+      return "pending";
+  }
+}
+function mapEventType2(status) {
+  if (status === "success") return "charge.success";
+  if (status === "failed") return "charge.failed";
+  return "unknown";
+}
+function mapRefundStatus2(raw) {
+  switch (raw) {
+    case "completed":
+    case "successful":
+    case "success":
+    case "processed":
+      return "processed";
+    case "failed":
+      return "failed";
+    default:
+      return "pending";
+  }
+}
+function createFlutterwaveProvider(ctx) {
+  const base = ctx.baseUrl ?? FLUTTERWAVE_BASE;
+  return {
+    name: "flutterwave",
+    async initialize(params) {
+      const reference = params.reference ?? ctx.generateReference();
+      const body = await providerRequest(ctx, "flutterwave", `${base}/v3/payments`, {
+        method: "POST",
+        body: JSON.stringify({
+          tx_ref: reference,
+          amount: toMajor(params.amount),
+          currency: params.currency ?? "NGN",
+          redirect_url: params.callbackUrl,
+          customer: { email: params.email },
+          meta: params.metadata
+        })
+      });
+      const data = body.data ?? {};
+      return {
+        reference,
+        authorizationUrl: String(data.link ?? ""),
+        raw: body
+      };
+    },
+    async verify(reference) {
+      const body = await providerRequest(
+        ctx,
+        "flutterwave",
+        `${base}/v3/transactions/verify_by_reference?tx_ref=${encodeURIComponent(reference)}`,
+        { method: "GET" }
+      );
+      const data = body.data ?? {};
+      const customer = data.customer ?? {};
+      return {
+        reference: String(data.tx_ref ?? reference),
+        status: mapStatus2(data.status),
+        amount: toSubunits(data.amount),
+        currency: String(data.currency ?? ""),
+        paidAt: data.created_at ? String(data.created_at) : void 0,
+        channel: data.payment_type ? String(data.payment_type) : void 0,
+        customer: { email: customer.email ? String(customer.email) : void 0 },
+        raw: body
+      };
+    },
+    async refund(reference, options) {
+      const verifyBody = await providerRequest(
+        ctx,
+        "flutterwave",
+        `${base}/v3/transactions/verify_by_reference?tx_ref=${encodeURIComponent(reference)}`,
+        { method: "GET" }
+      );
+      const verifyData = verifyBody.data ?? {};
+      const id = verifyData.id;
+      if (id === void 0 || id === null) {
+        throw new PayKitError(
+          `No Flutterwave transaction found for reference "${reference}"`,
+          { code: "provider_error", provider: "flutterwave", raw: verifyBody }
+        );
+      }
+      const body = await providerRequest(
+        ctx,
+        "flutterwave",
+        `${base}/v3/transactions/${encodeURIComponent(String(id))}/refund`,
+        {
+          method: "POST",
+          body: JSON.stringify(
+            options?.amount !== void 0 ? { amount: toMajor(options.amount) } : {}
+          )
+        }
+      );
+      const data = body.data ?? {};
+      const refunded = data.amount_refunded ?? data.amount;
+      return {
+        reference,
+        status: mapRefundStatus2(data.status),
+        amount: refunded !== void 0 ? toSubunits(refunded) : void 0,
+        raw: body
+      };
+    },
+    constructWebhookEvent(rawBody, signature) {
+      if (!ctx.webhookSecret) {
+        throw new PayKitError(
+          "Flutterwave webhook verification requires `webhookSecret` (your Secret hash)",
+          { code: "config_error", provider: "flutterwave" }
+        );
+      }
+      if (!signature || !safeEqual(ctx.webhookSecret, signature)) {
+        throw new PayKitError("Invalid Flutterwave webhook signature", {
+          code: "invalid_signature",
+          provider: "flutterwave"
+        });
+      }
+      let event;
+      try {
+        event = JSON.parse(rawBody);
+      } catch (err) {
+        throw new PayKitError("Malformed Flutterwave webhook body", {
+          code: "provider_error",
+          provider: "flutterwave",
+          cause: err
+        });
+      }
+      const data = event.data ?? {};
+      const status = mapStatus2(data.status);
+      return {
+        type: mapEventType2(status),
+        reference: String(data.tx_ref ?? ""),
+        status,
+        amount: data.amount !== void 0 ? toSubunits(data.amount) : void 0,
+        currency: data.currency ? String(data.currency) : void 0,
+        raw: event
+      };
+    }
+  };
+}
+
+// src/client.ts
+function resolveProvider(config, ctx) {
+  switch (config.provider) {
+    case "paystack":
+      return createPaystackProvider(ctx);
+    case "flutterwave":
+      return createFlutterwaveProvider(ctx);
+    default:
+      throw new PayKitError(`Unknown provider: ${String(config.provider)}`, {
+        code: "config_error"
+      });
+  }
+}
+function createPayClient(config) {
+  if (!config.secretKey) {
+    throw new PayKitError("`secretKey` is required", { code: "config_error" });
+  }
+  const fetchImpl = config.fetch ?? globalThis.fetch;
+  if (typeof fetchImpl !== "function") {
+    throw new PayKitError(
+      "No fetch implementation found. Use Node >= 18 or pass `config.fetch`.",
+      { code: "config_error" }
+    );
+  }
+  const ctx = {
+    secretKey: config.secretKey,
+    webhookSecret: config.webhookSecret,
+    baseUrl: config.baseUrl,
+    fetch: fetchImpl,
+    generateReference: config.generateReference ?? (() => `pk_${randomUUID().replace(/-/g, "")}`)
+  };
+  const provider = resolveProvider(config, ctx);
+  return {
+    provider: provider.name,
+    initialize: (params) => provider.initialize(params),
+    verify: (reference) => provider.verify(reference),
+    refund: (reference, options) => provider.refund(reference, options),
+    webhooks: {
+      construct: (rawBody, signature) => provider.constructWebhookEvent(rawBody, signature)
+    }
+  };
+}
+
+// src/fallback.ts
+function createFallbackClient(config) {
+  if (!config.providers || config.providers.length === 0) {
+    throw new PayKitError("createFallbackClient requires at least one provider", {
+      code: "config_error"
+    });
+  }
+  const clients = /* @__PURE__ */ new Map();
+  const order = [];
+  for (const entry of config.providers) {
+    if (clients.has(entry.provider)) continue;
+    clients.set(
+      entry.provider,
+      createPayClient({
+        provider: entry.provider,
+        secretKey: entry.secretKey,
+        webhookSecret: entry.webhookSecret,
+        baseUrl: entry.baseUrl,
+        fetch: config.fetch,
+        generateReference: config.generateReference
+      })
+    );
+    order.push(entry.provider);
+  }
+  function getClient(provider) {
+    const client = clients.get(provider);
+    if (!client) {
+      throw new PayKitError(
+        `Provider "${provider}" is not configured on this fallback client`,
+        { code: "config_error" }
+      );
+    }
+    return client;
+  }
+  return {
+    async initialize(params) {
+      let lastError;
+      for (const provider of order) {
+        try {
+          const result = await getClient(provider).initialize(params);
+          return { ...result, provider };
+        } catch (err) {
+          lastError = err;
+          if (!isRetryableError(err)) throw err;
+        }
+      }
+      throw lastError ?? new PayKitError("All providers failed to initialize the payment", {
+        code: "provider_error"
+      });
+    },
+    verify: (provider, reference) => getClient(provider).verify(reference),
+    refund: (provider, reference, options) => getClient(provider).refund(reference, options),
+    webhooks: {
+      construct: (provider, rawBody, signature) => getClient(provider).webhooks.construct(rawBody, signature)
+    },
+    client: getClient
+  };
+}
+export {
+  PayKitError,
+  createFallbackClient,
+  createPayClient,
+  isRetryableError
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/errors.ts","../src/providers/paystack.ts","../src/internal.ts","../src/providers/flutterwave.ts","../src/fallback.ts"],"sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { PayKitError } from \"./errors\";\nimport { createPaystackProvider } from \"./providers/paystack\";\nimport { createFlutterwaveProvider } from \"./providers/flutterwave\";\nimport type {\n  PayClient,\n  PayClientConfig,\n  PaymentProvider,\n  ProviderContext,\n} from \"./types\";\n\nfunction resolveProvider(config: PayClientConfig, ctx: ProviderContext): PaymentProvider {\n  switch (config.provider) {\n    case \"paystack\":\n      return createPaystackProvider(ctx);\n    case \"flutterwave\":\n      return createFlutterwaveProvider(ctx);\n    default:\n      throw new PayKitError(`Unknown provider: ${String(config.provider)}`, {\n        code: \"config_error\",\n      });\n  }\n}\n\n/**\n * Create a payment client bound to a single provider.\n *\n * @example\n * const pay = createPayClient({ provider: \"paystack\", secretKey: process.env.PAYSTACK_SECRET_KEY! });\n * const { authorizationUrl, reference } = await pay.initialize({ amount: 500000, email: \"a@b.com\" });\n */\nexport function createPayClient(config: PayClientConfig): PayClient {\n  if (!config.secretKey) {\n    throw new PayKitError(\"`secretKey` is required\", { code: \"config_error\" });\n  }\n\n  const fetchImpl = config.fetch ?? globalThis.fetch;\n  if (typeof fetchImpl !== \"function\") {\n    throw new PayKitError(\n      \"No fetch implementation found. Use Node >= 18 or pass `config.fetch`.\",\n      { code: \"config_error\" },\n    );\n  }\n\n  const ctx: ProviderContext = {\n    secretKey: config.secretKey,\n    webhookSecret: config.webhookSecret,\n    baseUrl: config.baseUrl,\n    fetch: fetchImpl,\n    generateReference:\n      config.generateReference ?? (() => `pk_${randomUUID().replace(/-/g, \"\")}`),\n  };\n\n  const provider = resolveProvider(config, ctx);\n\n  return {\n    provider: provider.name,\n    initialize: (params) => provider.initialize(params),\n    verify: (reference) => provider.verify(reference),\n    refund: (reference, options) => provider.refund(reference, options),\n    webhooks: {\n      construct: (rawBody, signature) => provider.constructWebhookEvent(rawBody, signature),\n    },\n  };\n}\n","export type PayKitErrorCode =\n  | \"provider_error\"\n  | \"network_error\"\n  | \"invalid_signature\"\n  | \"config_error\"\n  | \"verification_failed\";\n\nexport interface PayKitErrorOptions {\n  code: PayKitErrorCode;\n  provider?: string;\n  statusCode?: number;\n  raw?: unknown;\n  cause?: unknown;\n}\n\n/**\n * Whether an error is worth retrying on another provider: network failures and\n * outage-like HTTP statuses (5xx, 429). Client errors (4xx) are not retryable -\n * they would fail the same way everywhere.\n */\nexport function isRetryableError(err: unknown): boolean {\n  if (!(err instanceof PayKitError)) return false;\n  if (err.code === \"network_error\") return true;\n  if (typeof err.statusCode === \"number\") {\n    return err.statusCode >= 500 || err.statusCode === 429;\n  }\n  return false;\n}\n\n/** Single error type surfaced by pay-kit, with a machine-readable `code`. */\nexport class PayKitError extends Error {\n  readonly code: PayKitErrorCode;\n  readonly provider?: string;\n  readonly statusCode?: number;\n  readonly raw?: unknown;\n\n  constructor(message: string, options: PayKitErrorOptions) {\n    super(message, options.cause !== undefined ? { cause: options.cause } : undefined);\n    this.name = \"PayKitError\";\n    this.code = options.code;\n    this.provider = options.provider;\n    this.statusCode = options.statusCode;\n    this.raw = options.raw;\n  }\n}\n","import { createHmac } from \"node:crypto\";\nimport { PayKitError } from \"../errors\";\nimport { providerRequest, safeEqual } from \"../internal\";\nimport type {\n  InitializeParams,\n  InitializeResult,\n  PaymentProvider,\n  PaymentStatus,\n  ProviderContext,\n  RefundOptions,\n  RefundResult,\n  RefundStatus,\n  VerifyResult,\n  WebhookEvent,\n  WebhookEventType,\n} from \"../types\";\n\nconst PAYSTACK_BASE = \"https://api.paystack.co\";\n\n/** Paystack uses subunits (kobo) natively - matches pay-kit's canonical unit. */\nfunction mapStatus(raw: unknown): PaymentStatus {\n  switch (raw) {\n    case \"success\":\n      return \"success\";\n    case \"failed\":\n      return \"failed\";\n    case \"abandoned\":\n      return \"abandoned\";\n    default:\n      return \"pending\";\n  }\n}\n\nfunction mapEventType(event: unknown): WebhookEventType {\n  return typeof event === \"string\" && event.length > 0 ? event : \"unknown\";\n}\n\nfunction mapRefundStatus(raw: unknown): RefundStatus {\n  switch (raw) {\n    case \"processed\":\n    case \"success\":\n      return \"processed\";\n    case \"failed\":\n      return \"failed\";\n    default:\n      return \"pending\";\n  }\n}\n\nexport function createPaystackProvider(ctx: ProviderContext): PaymentProvider {\n  const base = ctx.baseUrl ?? PAYSTACK_BASE;\n\n  return {\n    name: \"paystack\",\n\n    async initialize(params: InitializeParams): Promise<InitializeResult> {\n      const reference = params.reference ?? ctx.generateReference();\n      const body = await providerRequest(ctx, \"paystack\", `${base}/transaction/initialize`, {\n        method: \"POST\",\n        body: JSON.stringify({\n          amount: params.amount,\n          email: params.email,\n          currency: params.currency ?? \"NGN\",\n          reference,\n          callback_url: params.callbackUrl,\n          metadata: params.metadata,\n        }),\n      });\n\n      const data = (body.data ?? {}) as Record<string, unknown>;\n      return {\n        reference: String(data.reference ?? reference),\n        authorizationUrl: String(data.authorization_url ?? \"\"),\n        accessCode: data.access_code ? String(data.access_code) : undefined,\n        raw: body,\n      };\n    },\n\n    async verify(reference: string): Promise<VerifyResult> {\n      const body = await providerRequest(\n        ctx,\n        \"paystack\",\n        `${base}/transaction/verify/${encodeURIComponent(reference)}`,\n        { method: \"GET\" },\n      );\n\n      const data = (body.data ?? {}) as Record<string, unknown>;\n      const customer = (data.customer ?? {}) as Record<string, unknown>;\n      return {\n        reference: String(data.reference ?? reference),\n        status: mapStatus(data.status),\n        amount: Number(data.amount ?? 0),\n        currency: String(data.currency ?? \"\"),\n        paidAt: data.paid_at ? String(data.paid_at) : undefined,\n        channel: data.channel ? String(data.channel) : undefined,\n        customer: { email: customer.email ? String(customer.email) : undefined },\n        raw: body,\n      };\n    },\n\n    async refund(reference: string, options?: RefundOptions): Promise<RefundResult> {\n      const body = await providerRequest(ctx, \"paystack\", `${base}/refund`, {\n        method: \"POST\",\n        body: JSON.stringify({\n          transaction: reference,\n          ...(options?.amount !== undefined ? { amount: options.amount } : {}),\n        }),\n      });\n\n      const data = (body.data ?? {}) as Record<string, unknown>;\n      const transaction = (data.transaction ?? {}) as Record<string, unknown>;\n      return {\n        reference: String(transaction.reference ?? reference),\n        status: mapRefundStatus(data.status),\n        amount: data.amount !== undefined ? Number(data.amount) : undefined,\n        raw: body,\n      };\n    },\n\n    constructWebhookEvent(rawBody: string, signature: string): WebhookEvent {\n      const expected = createHmac(\"sha512\", ctx.secretKey).update(rawBody).digest(\"hex\");\n      if (!signature || !safeEqual(expected, signature)) {\n        throw new PayKitError(\"Invalid Paystack webhook signature\", {\n          code: \"invalid_signature\",\n          provider: \"paystack\",\n        });\n      }\n\n      let event: Record<string, unknown>;\n      try {\n        event = JSON.parse(rawBody) as Record<string, unknown>;\n      } catch (err) {\n        throw new PayKitError(\"Malformed Paystack webhook body\", {\n          code: \"provider_error\",\n          provider: \"paystack\",\n          cause: err,\n        });\n      }\n\n      const data = (event.data ?? {}) as Record<string, unknown>;\n      return {\n        type: mapEventType(event.event),\n        reference: String(data.reference ?? \"\"),\n        status: data.status ? mapStatus(data.status) : undefined,\n        amount: data.amount !== undefined ? Number(data.amount) : undefined,\n        currency: data.currency ? String(data.currency) : undefined,\n        raw: event,\n      };\n    },\n  };\n}\n","import { timingSafeEqual } from \"node:crypto\";\nimport { PayKitError } from \"./errors\";\nimport type { ProviderContext, ProviderName } from \"./types\";\n\n/**\n * Authenticated JSON request to a provider, with normalized error handling.\n * Both Paystack and Flutterwave use `Authorization: Bearer <secret>` and signal\n * application-level failure in the body (`status: false` / `status: \"error\"`),\n * so we treat those as errors even on HTTP 200.\n */\nexport async function providerRequest(\n  ctx: ProviderContext,\n  provider: ProviderName,\n  url: string,\n  init: RequestInit,\n): Promise<Record<string, unknown>> {\n  let res: Response;\n  try {\n    res = await ctx.fetch(url, {\n      ...init,\n      headers: {\n        Authorization: `Bearer ${ctx.secretKey}`,\n        \"Content-Type\": \"application/json\",\n        Accept: \"application/json\",\n        ...(init.headers ?? {}),\n      },\n    });\n  } catch (err) {\n    throw new PayKitError(`Network error calling ${provider}`, {\n      code: \"network_error\",\n      provider,\n      cause: err,\n    });\n  }\n\n  let body: Record<string, unknown> = {};\n  try {\n    body = (await res.json()) as Record<string, unknown>;\n  } catch {\n    body = {};\n  }\n\n  if (!res.ok || body.status === false || body.status === \"error\") {\n    const message =\n      typeof body.message === \"string\"\n        ? body.message\n        : `${provider} request failed (${res.status})`;\n    throw new PayKitError(message, {\n      code: \"provider_error\",\n      provider,\n      statusCode: res.status,\n      raw: body,\n    });\n  }\n\n  return body;\n}\n\n/** Constant-time comparison of two hex/string signatures. */\nexport function safeEqual(a: string, b: string): boolean {\n  const ba = Buffer.from(a);\n  const bb = Buffer.from(b);\n  if (ba.length !== bb.length) return false;\n  return timingSafeEqual(ba, bb);\n}\n","import { PayKitError } from \"../errors\";\nimport { providerRequest, safeEqual } from \"../internal\";\nimport type {\n  InitializeParams,\n  InitializeResult,\n  PaymentProvider,\n  PaymentStatus,\n  ProviderContext,\n  RefundOptions,\n  RefundResult,\n  RefundStatus,\n  VerifyResult,\n  WebhookEvent,\n  WebhookEventType,\n} from \"../types\";\n\nconst FLUTTERWAVE_BASE = \"https://api.flutterwave.com\";\n\n/**\n * Flutterwave works in major currency units (naira, not kobo), so pay-kit\n * converts to/from its canonical subunit representation at the boundary.\n */\nfunction toMajor(subunits: number): number {\n  return subunits / 100;\n}\nfunction toSubunits(major: unknown): number {\n  return Math.round(Number(major ?? 0) * 100);\n}\n\nfunction mapStatus(raw: unknown): PaymentStatus {\n  switch (raw) {\n    case \"successful\":\n    case \"success\":\n      return \"success\";\n    case \"failed\":\n      return \"failed\";\n    default:\n      return \"pending\";\n  }\n}\n\nfunction mapEventType(status: PaymentStatus): WebhookEventType {\n  if (status === \"success\") return \"charge.success\";\n  if (status === \"failed\") return \"charge.failed\";\n  return \"unknown\";\n}\n\nfunction mapRefundStatus(raw: unknown): RefundStatus {\n  switch (raw) {\n    case \"completed\":\n    case \"successful\":\n    case \"success\":\n    case \"processed\":\n      return \"processed\";\n    case \"failed\":\n      return \"failed\";\n    default:\n      return \"pending\";\n  }\n}\n\nexport function createFlutterwaveProvider(ctx: ProviderContext): PaymentProvider {\n  const base = ctx.baseUrl ?? FLUTTERWAVE_BASE;\n\n  return {\n    name: \"flutterwave\",\n\n    async initialize(params: InitializeParams): Promise<InitializeResult> {\n      const reference = params.reference ?? ctx.generateReference();\n      const body = await providerRequest(ctx, \"flutterwave\", `${base}/v3/payments`, {\n        method: \"POST\",\n        body: JSON.stringify({\n          tx_ref: reference,\n          amount: toMajor(params.amount),\n          currency: params.currency ?? \"NGN\",\n          redirect_url: params.callbackUrl,\n          customer: { email: params.email },\n          meta: params.metadata,\n        }),\n      });\n\n      const data = (body.data ?? {}) as Record<string, unknown>;\n      return {\n        reference,\n        authorizationUrl: String(data.link ?? \"\"),\n        raw: body,\n      };\n    },\n\n    async verify(reference: string): Promise<VerifyResult> {\n      const body = await providerRequest(\n        ctx,\n        \"flutterwave\",\n        `${base}/v3/transactions/verify_by_reference?tx_ref=${encodeURIComponent(reference)}`,\n        { method: \"GET\" },\n      );\n\n      const data = (body.data ?? {}) as Record<string, unknown>;\n      const customer = (data.customer ?? {}) as Record<string, unknown>;\n      return {\n        reference: String(data.tx_ref ?? reference),\n        status: mapStatus(data.status),\n        amount: toSubunits(data.amount),\n        currency: String(data.currency ?? \"\"),\n        paidAt: data.created_at ? String(data.created_at) : undefined,\n        channel: data.payment_type ? String(data.payment_type) : undefined,\n        customer: { email: customer.email ? String(customer.email) : undefined },\n        raw: body,\n      };\n    },\n\n    async refund(reference: string, options?: RefundOptions): Promise<RefundResult> {\n      // Flutterwave refunds are keyed by the numeric transaction id, not tx_ref,\n      // so resolve the id from the reference first.\n      const verifyBody = await providerRequest(\n        ctx,\n        \"flutterwave\",\n        `${base}/v3/transactions/verify_by_reference?tx_ref=${encodeURIComponent(reference)}`,\n        { method: \"GET\" },\n      );\n      const verifyData = (verifyBody.data ?? {}) as Record<string, unknown>;\n      const id = verifyData.id;\n      if (id === undefined || id === null) {\n        throw new PayKitError(\n          `No Flutterwave transaction found for reference \"${reference}\"`,\n          { code: \"provider_error\", provider: \"flutterwave\", raw: verifyBody },\n        );\n      }\n\n      const body = await providerRequest(\n        ctx,\n        \"flutterwave\",\n        `${base}/v3/transactions/${encodeURIComponent(String(id))}/refund`,\n        {\n          method: \"POST\",\n          body: JSON.stringify(\n            options?.amount !== undefined ? { amount: toMajor(options.amount) } : {},\n          ),\n        },\n      );\n\n      const data = (body.data ?? {}) as Record<string, unknown>;\n      const refunded = data.amount_refunded ?? data.amount;\n      return {\n        reference,\n        status: mapRefundStatus(data.status),\n        amount: refunded !== undefined ? toSubunits(refunded) : undefined,\n        raw: body,\n      };\n    },\n\n    constructWebhookEvent(rawBody: string, signature: string): WebhookEvent {\n      // Flutterwave sends the \"Secret hash\" verbatim in the `verif-hash` header.\n      if (!ctx.webhookSecret) {\n        throw new PayKitError(\n          \"Flutterwave webhook verification requires `webhookSecret` (your Secret hash)\",\n          { code: \"config_error\", provider: \"flutterwave\" },\n        );\n      }\n      if (!signature || !safeEqual(ctx.webhookSecret, signature)) {\n        throw new PayKitError(\"Invalid Flutterwave webhook signature\", {\n          code: \"invalid_signature\",\n          provider: \"flutterwave\",\n        });\n      }\n\n      let event: Record<string, unknown>;\n      try {\n        event = JSON.parse(rawBody) as Record<string, unknown>;\n      } catch (err) {\n        throw new PayKitError(\"Malformed Flutterwave webhook body\", {\n          code: \"provider_error\",\n          provider: \"flutterwave\",\n          cause: err,\n        });\n      }\n\n      const data = (event.data ?? {}) as Record<string, unknown>;\n      const status = mapStatus(data.status);\n      return {\n        type: mapEventType(status),\n        reference: String(data.tx_ref ?? \"\"),\n        status,\n        amount: data.amount !== undefined ? toSubunits(data.amount) : undefined,\n        currency: data.currency ? String(data.currency) : undefined,\n        raw: event,\n      };\n    },\n  };\n}\n","import { createPayClient } from \"./client\";\nimport { PayKitError, isRetryableError } from \"./errors\";\nimport type {\n  FallbackClient,\n  FallbackClientConfig,\n  FallbackInitializeResult,\n  InitializeParams,\n  PayClient,\n  ProviderName,\n} from \"./types\";\n\n/**\n * Create a resilient client that tries multiple providers in order.\n *\n * `initialize` falls through to the next provider on outage-like failures\n * (network errors, HTTP 5xx/429) and returns the provider that succeeded.\n * Route `verify`/`refund`/`webhooks` for that transaction back to the same\n * provider - a charge started on Paystack can only be verified on Paystack.\n *\n * @example\n * const pay = createFallbackClient({\n *   providers: [\n *     { provider: \"paystack\", secretKey: process.env.PAYSTACK_SECRET_KEY! },\n *     { provider: \"flutterwave\", secretKey: process.env.FLW_SECRET_KEY! },\n *   ],\n * });\n * const { reference, provider } = await pay.initialize({ amount: 500000, email: \"a@b.com\" });\n * // persist { reference, provider }, then later:\n * const result = await pay.verify(provider, reference);\n */\nexport function createFallbackClient(config: FallbackClientConfig): FallbackClient {\n  if (!config.providers || config.providers.length === 0) {\n    throw new PayKitError(\"createFallbackClient requires at least one provider\", {\n      code: \"config_error\",\n    });\n  }\n\n  const clients = new Map<ProviderName, PayClient>();\n  const order: ProviderName[] = [];\n\n  for (const entry of config.providers) {\n    if (clients.has(entry.provider)) continue; // ignore duplicates, keep first\n    clients.set(\n      entry.provider,\n      createPayClient({\n        provider: entry.provider,\n        secretKey: entry.secretKey,\n        webhookSecret: entry.webhookSecret,\n        baseUrl: entry.baseUrl,\n        fetch: config.fetch,\n        generateReference: config.generateReference,\n      }),\n    );\n    order.push(entry.provider);\n  }\n\n  function getClient(provider: ProviderName): PayClient {\n    const client = clients.get(provider);\n    if (!client) {\n      throw new PayKitError(\n        `Provider \"${provider}\" is not configured on this fallback client`,\n        { code: \"config_error\" },\n      );\n    }\n    return client;\n  }\n\n  return {\n    async initialize(params: InitializeParams): Promise<FallbackInitializeResult> {\n      let lastError: unknown;\n      for (const provider of order) {\n        try {\n          const result = await getClient(provider).initialize(params);\n          return { ...result, provider };\n        } catch (err) {\n          lastError = err;\n          // A client error (4xx) would fail the same way everywhere - stop.\n          if (!isRetryableError(err)) throw err;\n          // Otherwise fall through to the next provider.\n        }\n      }\n      throw (\n        lastError ??\n        new PayKitError(\"All providers failed to initialize the payment\", {\n          code: \"provider_error\",\n        })\n      );\n    },\n\n    verify: (provider, reference) => getClient(provider).verify(reference),\n\n    refund: (provider, reference, options) => getClient(provider).refund(reference, options),\n\n    webhooks: {\n      construct: (provider, rawBody, signature) =>\n        getClient(provider).webhooks.construct(rawBody, signature),\n    },\n\n    client: getClient,\n  };\n}\n"],"mappings":"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","names":["mapStatus","mapEventType","mapRefundStatus"]}

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "@siyegs/pay-kit",
+  "version": "0.1.0",
+  "description": "One typed SDK for African payment rails - unified Paystack & Flutterwave: initialize, verify, refund, and signature-verified webhooks, with provider fallback.",
+  "type": "module",
+  "sideEffects": false,
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/siyegs/pay-kit.git"
+  },
+  "homepage": "https://github.com/siyegs/pay-kit#readme",
+  "bugs": {
+    "url": "https://github.com/siyegs/pay-kit/issues"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run typecheck && bun run test && bun run build"
+  },
+  "keywords": [
+    "paystack",
+    "flutterwave",
+    "payments",
+    "payment-gateway",
+    "nigeria",
+    "africa",
+    "fintech",
+    "typescript",
+    "sdk",
+    "webhooks"
+  ],
+  "author": "Iyegere Success Karboloo",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.1.0",
+    "tsup": "^8.1.0",
+    "typescript": "^5.4.5"
+  }
+}