@paykit-sdk/paystack 1.0.0

package/dist/schema.js

@@ -0,0 +1,2 @@
+'use strict';
+

package/dist/schema.mjs

@@ -0,0 +1 @@
+

package/dist/utils/mapper.d.mts

@@ -0,0 +1,14 @@
+import { Customer, Payment, Checkout, Subscription, Refund, Invoice } from '@paykit-sdk/core';
+import { PaystackCustomer, PaystackTransaction, PaystackInitializeResponse, PaystackSubscription, PaystackRefund } from '../schema.mjs';
+
+declare const paykitCustomer$InboundSchema: (data: PaystackCustomer) => Customer;
+declare const paykitPayment$InboundSchema: (data: PaystackTransaction, overridePaymentUrl?: string | null) => Payment;
+declare const paykitCheckout$InboundSchema: (init: PaystackInitializeResponse, transaction: Partial<PaystackTransaction> & {
+    currency?: string;
+    amount?: number;
+}) => Checkout;
+declare const paykitSubscription$InboundSchema: (data: PaystackSubscription) => Subscription;
+declare const paykitRefund$InboundSchema: (data: PaystackRefund, fallbackCurrency: string) => Refund;
+declare const paykitInvoice$InboundSchema: (data: PaystackTransaction) => Invoice;
+
+export { paykitCheckout$InboundSchema, paykitCustomer$InboundSchema, paykitInvoice$InboundSchema, paykitPayment$InboundSchema, paykitRefund$InboundSchema, paykitSubscription$InboundSchema };

package/dist/utils/mapper.d.ts

@@ -0,0 +1,14 @@
+import { Customer, Payment, Checkout, Subscription, Refund, Invoice } from '@paykit-sdk/core';
+import { PaystackCustomer, PaystackTransaction, PaystackInitializeResponse, PaystackSubscription, PaystackRefund } from '../schema.js';
+
+declare const paykitCustomer$InboundSchema: (data: PaystackCustomer) => Customer;
+declare const paykitPayment$InboundSchema: (data: PaystackTransaction, overridePaymentUrl?: string | null) => Payment;
+declare const paykitCheckout$InboundSchema: (init: PaystackInitializeResponse, transaction: Partial<PaystackTransaction> & {
+    currency?: string;
+    amount?: number;
+}) => Checkout;
+declare const paykitSubscription$InboundSchema: (data: PaystackSubscription) => Subscription;
+declare const paykitRefund$InboundSchema: (data: PaystackRefund, fallbackCurrency: string) => Refund;
+declare const paykitInvoice$InboundSchema: (data: PaystackTransaction) => Invoice;
+
+export { paykitCheckout$InboundSchema, paykitCustomer$InboundSchema, paykitInvoice$InboundSchema, paykitPayment$InboundSchema, paykitRefund$InboundSchema, paykitSubscription$InboundSchema };

package/dist/utils/mapper.js

@@ -0,0 +1,171 @@
+'use strict';
+
+var core = require('@paykit-sdk/core');
+
+// src/utils/mapper.ts
+var paykitCustomer$InboundSchema = (data) => {
+  const { fullName } = core.parseCustomerName({
+    name: [data.first_name, data.last_name].filter(Boolean).join(" ") || "",
+    email: data.email
+  });
+  return {
+    id: data.customer_code,
+    email: data.email,
+    name: fullName,
+    phone: data.phone ?? "",
+    metadata: data.metadata ?? void 0,
+    created_at: new Date(data.created_at),
+    updated_at: data.updated_at ? new Date(data.updated_at) : null
+  };
+};
+var paystackStatusMap = {
+  success: "succeeded",
+  failed: "failed",
+  pending: "pending",
+  abandoned: "canceled"
+};
+var paykitPayment$InboundSchema = (data, overridePaymentUrl) => {
+  const rawMetadata = core.parseJSON(
+    data.metadata,
+    core.Schema.record(core.Schema.string(), core.Schema.unknown())
+  ) ?? {};
+  const metadata = core.omitInternalMetadata(rawMetadata);
+  let itemId = null;
+  const paykitMeta = core.parseJSON(
+    rawMetadata[core.PAYKIT_METADATA_KEY],
+    core.Schema.object({
+      item_id: core.Schema.string().optional()
+    })
+  );
+  if (paykitMeta) {
+    itemId = paykitMeta.item_id ?? null;
+  }
+  const status = paystackStatusMap[data.status] ?? "pending";
+  return {
+    id: data.reference,
+    amount: data.amount,
+    currency: data.currency,
+    customer: data.customer?.email ?? "",
+    status,
+    metadata,
+    item_id: itemId,
+    requires_action: status === "pending",
+    payment_url: overridePaymentUrl ?? null
+  };
+};
+var paykitCheckout$InboundSchema = (init, transaction) => {
+  const rawMetadata = core.parseJSON(
+    transaction.metadata,
+    core.Schema.record(core.Schema.string(), core.Schema.unknown())
+  ) ?? {};
+  const metadata = core.omitInternalMetadata(rawMetadata);
+  let itemId = "";
+  let quantity = 1;
+  let type = null;
+  const paykitMeta = core.parseJSON(
+    rawMetadata[core.PAYKIT_METADATA_KEY],
+    core.Schema.object({
+      item_id: core.Schema.string().optional(),
+      quantity: core.Schema.number().optional(),
+      type: core.billingModeSchema.optional()
+    })
+  );
+  if (paykitMeta && typeof paykitMeta === "string") {
+    const parsed = core.parseJSON(
+      paykitMeta,
+      core.Schema.object({
+        item_id: core.Schema.string().optional(),
+        quantity: core.Schema.number().optional(),
+        type: core.billingModeSchema.optional()
+      })
+    );
+    if (parsed) {
+      itemId = parsed.item_id ?? "";
+      quantity = parsed.quantity ?? 1;
+      type = parsed.type ?? null;
+    }
+  }
+  return {
+    id: init.reference,
+    customer: { email: transaction.customer?.email ?? "" },
+    payment_url: init.authorization_url,
+    metadata: Object.keys(metadata).length > 0 ? metadata : null,
+    session_type: type ?? "one_time",
+    products: [{ id: itemId, quantity }],
+    currency: transaction.currency ?? "NGN",
+    amount: transaction.amount ?? 0
+  };
+};
+var paystackIntervalMap = {
+  daily: "day",
+  weekly: "week",
+  monthly: "month",
+  annually: "year",
+  quarterly: {
+    type: "custom",
+    durationMs: 3 * 30 * 24 * 60 * 60 * 1e3
+  },
+  biannually: {
+    type: "custom",
+    durationMs: 6 * 30 * 24 * 60 * 60 * 1e3
+  }
+};
+var paystackSubscriptionStatusMap = {
+  active: "active",
+  "non-renewing": "canceled",
+  cancelled: "canceled",
+  attention: "past_due",
+  completed: "expired"
+};
+var paykitSubscription$InboundSchema = (data) => {
+  const nextPaymentDate = data.next_payment_date ? new Date(data.next_payment_date) : /* @__PURE__ */ new Date();
+  return {
+    id: data.subscription_code,
+    customer: data.customer?.email ?? "",
+    amount: data.amount,
+    currency: data.currency || data.plan?.currency || "NGN",
+    status: paystackSubscriptionStatusMap[data.status] ?? "active",
+    current_period_start: new Date(data.createdAt),
+    current_period_end: nextPaymentDate,
+    item_id: data.plan?.plan_code ?? "",
+    billing_interval: paystackIntervalMap[data.plan?.interval] ?? "month",
+    metadata: null,
+    custom_fields: null,
+    requires_action: false,
+    payment_url: null
+  };
+};
+var paykitRefund$InboundSchema = (data, fallbackCurrency) => ({
+  id: String(data.id),
+  amount: data.amount,
+  currency: data.currency || fallbackCurrency,
+  reason: data.customer_note || data.merchant_note || null,
+  metadata: null
+});
+var paykitInvoice$InboundSchema = (data) => {
+  const rawMetadata = core.parseJSON(
+    data.metadata,
+    core.Schema.record(core.Schema.string(), core.Schema.unknown())
+  ) ?? {};
+  const metadata = core.omitInternalMetadata(rawMetadata);
+  return {
+    id: String(data.id),
+    customer: data.customer?.email ?? "",
+    subscription_id: null,
+    billing_mode: "one_time",
+    amount_paid: data.amount,
+    currency: data.currency,
+    status: "paid",
+    paid_at: data.paid_at ?? (/* @__PURE__ */ new Date()).toISOString(),
+    line_items: null,
+    metadata: Object.keys(metadata).length > 0 ? metadata : null,
+    custom_fields: null
+  };
+};
+
+exports.paykitCheckout$InboundSchema = paykitCheckout$InboundSchema;
+exports.paykitCustomer$InboundSchema = paykitCustomer$InboundSchema;
+exports.paykitInvoice$InboundSchema = paykitInvoice$InboundSchema;
+exports.paykitPayment$InboundSchema = paykitPayment$InboundSchema;
+exports.paykitRefund$InboundSchema = paykitRefund$InboundSchema;
+exports.paykitSubscription$InboundSchema = paykitSubscription$InboundSchema;

package/dist/utils/mapper.mjs

@@ -0,0 +1,164 @@
+import { parseCustomerName, parseJSON, Schema, omitInternalMetadata, PAYKIT_METADATA_KEY, billingModeSchema } from '@paykit-sdk/core';
+
+// src/utils/mapper.ts
+var paykitCustomer$InboundSchema = (data) => {
+  const { fullName } = parseCustomerName({
+    name: [data.first_name, data.last_name].filter(Boolean).join(" ") || "",
+    email: data.email
+  });
+  return {
+    id: data.customer_code,
+    email: data.email,
+    name: fullName,
+    phone: data.phone ?? "",
+    metadata: data.metadata ?? void 0,
+    created_at: new Date(data.created_at),
+    updated_at: data.updated_at ? new Date(data.updated_at) : null
+  };
+};
+var paystackStatusMap = {
+  success: "succeeded",
+  failed: "failed",
+  pending: "pending",
+  abandoned: "canceled"
+};
+var paykitPayment$InboundSchema = (data, overridePaymentUrl) => {
+  const rawMetadata = parseJSON(
+    data.metadata,
+    Schema.record(Schema.string(), Schema.unknown())
+  ) ?? {};
+  const metadata = omitInternalMetadata(rawMetadata);
+  let itemId = null;
+  const paykitMeta = parseJSON(
+    rawMetadata[PAYKIT_METADATA_KEY],
+    Schema.object({
+      item_id: Schema.string().optional()
+    })
+  );
+  if (paykitMeta) {
+    itemId = paykitMeta.item_id ?? null;
+  }
+  const status = paystackStatusMap[data.status] ?? "pending";
+  return {
+    id: data.reference,
+    amount: data.amount,
+    currency: data.currency,
+    customer: data.customer?.email ?? "",
+    status,
+    metadata,
+    item_id: itemId,
+    requires_action: status === "pending",
+    payment_url: overridePaymentUrl ?? null
+  };
+};
+var paykitCheckout$InboundSchema = (init, transaction) => {
+  const rawMetadata = parseJSON(
+    transaction.metadata,
+    Schema.record(Schema.string(), Schema.unknown())
+  ) ?? {};
+  const metadata = omitInternalMetadata(rawMetadata);
+  let itemId = "";
+  let quantity = 1;
+  let type = null;
+  const paykitMeta = parseJSON(
+    rawMetadata[PAYKIT_METADATA_KEY],
+    Schema.object({
+      item_id: Schema.string().optional(),
+      quantity: Schema.number().optional(),
+      type: billingModeSchema.optional()
+    })
+  );
+  if (paykitMeta && typeof paykitMeta === "string") {
+    const parsed = parseJSON(
+      paykitMeta,
+      Schema.object({
+        item_id: Schema.string().optional(),
+        quantity: Schema.number().optional(),
+        type: billingModeSchema.optional()
+      })
+    );
+    if (parsed) {
+      itemId = parsed.item_id ?? "";
+      quantity = parsed.quantity ?? 1;
+      type = parsed.type ?? null;
+    }
+  }
+  return {
+    id: init.reference,
+    customer: { email: transaction.customer?.email ?? "" },
+    payment_url: init.authorization_url,
+    metadata: Object.keys(metadata).length > 0 ? metadata : null,
+    session_type: type ?? "one_time",
+    products: [{ id: itemId, quantity }],
+    currency: transaction.currency ?? "NGN",
+    amount: transaction.amount ?? 0
+  };
+};
+var paystackIntervalMap = {
+  daily: "day",
+  weekly: "week",
+  monthly: "month",
+  annually: "year",
+  quarterly: {
+    type: "custom",
+    durationMs: 3 * 30 * 24 * 60 * 60 * 1e3
+  },
+  biannually: {
+    type: "custom",
+    durationMs: 6 * 30 * 24 * 60 * 60 * 1e3
+  }
+};
+var paystackSubscriptionStatusMap = {
+  active: "active",
+  "non-renewing": "canceled",
+  cancelled: "canceled",
+  attention: "past_due",
+  completed: "expired"
+};
+var paykitSubscription$InboundSchema = (data) => {
+  const nextPaymentDate = data.next_payment_date ? new Date(data.next_payment_date) : /* @__PURE__ */ new Date();
+  return {
+    id: data.subscription_code,
+    customer: data.customer?.email ?? "",
+    amount: data.amount,
+    currency: data.currency || data.plan?.currency || "NGN",
+    status: paystackSubscriptionStatusMap[data.status] ?? "active",
+    current_period_start: new Date(data.createdAt),
+    current_period_end: nextPaymentDate,
+    item_id: data.plan?.plan_code ?? "",
+    billing_interval: paystackIntervalMap[data.plan?.interval] ?? "month",
+    metadata: null,
+    custom_fields: null,
+    requires_action: false,
+    payment_url: null
+  };
+};
+var paykitRefund$InboundSchema = (data, fallbackCurrency) => ({
+  id: String(data.id),
+  amount: data.amount,
+  currency: data.currency || fallbackCurrency,
+  reason: data.customer_note || data.merchant_note || null,
+  metadata: null
+});
+var paykitInvoice$InboundSchema = (data) => {
+  const rawMetadata = parseJSON(
+    data.metadata,
+    Schema.record(Schema.string(), Schema.unknown())
+  ) ?? {};
+  const metadata = omitInternalMetadata(rawMetadata);
+  return {
+    id: String(data.id),
+    customer: data.customer?.email ?? "",
+    subscription_id: null,
+    billing_mode: "one_time",
+    amount_paid: data.amount,
+    currency: data.currency,
+    status: "paid",
+    paid_at: data.paid_at ?? (/* @__PURE__ */ new Date()).toISOString(),
+    line_items: null,
+    metadata: Object.keys(metadata).length > 0 ? metadata : null,
+    custom_fields: null
+  };
+};
+
+export { paykitCheckout$InboundSchema, paykitCustomer$InboundSchema, paykitInvoice$InboundSchema, paykitPayment$InboundSchema, paykitRefund$InboundSchema, paykitSubscription$InboundSchema };

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@paykit-sdk/paystack",
+  "version": "1.0.0",
+  "description": "Paystack provider for PayKit",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup"
+  },
+  "keywords": [
+    "paystack",
+    "paykit",
+    "payment",
+    "typescript"
+  ],
+  "author": "Emmanuel Odii",
+  "license": "ISC",
+  "peerDependencies": {
+    "@paykit-sdk/core": ">=1.1.102"
+  },
+  "devDependencies": {
+    "@paykit-sdk/core": "workspace:*",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "zod": "^3.24.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/usepaykit/paykit-sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/usepaykit/paykit-sdk/issues"
+  }
+}