@paykit-sdk/xendit 1.0.0

package/dist/utils/mapper.mjs

@@ -0,0 +1,162 @@
+import { omitInternalMetadata, parseJSON, PAYKIT_METADATA_KEY, Schema, billingModeSchema } from '@paykit-sdk/core';
+
+// src/utils/mapper.ts
+var paymentStatusMap = {
+  PENDING: "pending",
+  PAID: "succeeded",
+  SETTLED: "succeeded",
+  EXPIRED: "canceled"
+};
+var subscriptionStatusMap = {
+  ACTIVE: "active",
+  INACTIVE: "canceled",
+  PENDING: "pending",
+  REQUIRES_ACTION: "pending"
+};
+var resolveCustomerFromEmail = (email) => email ? { email } : null;
+var Payment$inboundSchema = (data, overridePaymentUrl) => {
+  const rawMeta = data.metadata ?? {};
+  const metadata = omitInternalMetadata(rawMeta);
+  let itemId = null;
+  const paykitMeta = parseJSON(
+    rawMeta[PAYKIT_METADATA_KEY],
+    Schema.object({ item_id: Schema.string().optional() })
+  );
+  if (paykitMeta) itemId = paykitMeta.item_id ?? null;
+  const status = paymentStatusMap[data.status] ?? "pending";
+  return {
+    id: data.id,
+    amount: data.amount,
+    currency: data.currency,
+    customer: resolveCustomerFromEmail(
+      data.payer_email ?? data.customer?.email
+    ),
+    status,
+    metadata,
+    item_id: itemId,
+    requires_action: status === "pending",
+    payment_url: overridePaymentUrl ?? null
+  };
+};
+var Checkout$inboundSchema = (data) => {
+  const rawMeta = data.metadata ?? {};
+  const metadata = omitInternalMetadata(rawMeta);
+  let itemId = "";
+  let quantity = 1;
+  let type = null;
+  const paykitMeta = parseJSON(
+    rawMeta[PAYKIT_METADATA_KEY],
+    Schema.object({
+      item_id: Schema.string().optional(),
+      quantity: Schema.number().optional(),
+      type: billingModeSchema.optional()
+    })
+  );
+  if (paykitMeta) {
+    itemId = paykitMeta.item_id ?? "";
+    quantity = paykitMeta.quantity ?? 1;
+    type = paykitMeta.type ?? null;
+  }
+  return {
+    id: data.id,
+    customer: resolveCustomerFromEmail(
+      data.payer_email ?? data.customer?.email
+    ),
+    payment_url: data.invoice_url,
+    metadata: Object.keys(metadata).length > 0 ? metadata : null,
+    session_type: type ?? "one_time",
+    products: [{ id: itemId, quantity }],
+    currency: data.currency,
+    amount: data.amount
+  };
+};
+var Customer$inboundSchema = (data) => {
+  const rawMeta = data.metadata ?? {};
+  const metadata = omitInternalMetadata(rawMeta);
+  const name = [
+    data.individual_detail?.given_names,
+    data.individual_detail?.surname
+  ].filter(Boolean).join(" ");
+  return {
+    id: data.id,
+    email: data.email ?? "",
+    name,
+    phone: data.mobile_number ?? data.phone_number ?? null,
+    metadata,
+    created_at: new Date(data.created),
+    updated_at: new Date(data.updated),
+    // Xendit-native fields with no PayKit core equivalent.
+    custom_fields: { type: data.type ?? null }
+  };
+};
+var recurringIntervalUnitMap = {
+  DAY: "day",
+  WEEK: "week",
+  MONTH: "month"
+};
+var Subscription$inboundSchema = (data) => {
+  const rawMeta = data.metadata ?? {};
+  const metadata = omitInternalMetadata(rawMeta);
+  const status = subscriptionStatusMap[data.status] ?? "pending";
+  const periodAnchor = data.schedule.anchor_date ? new Date(data.schedule.anchor_date) : /* @__PURE__ */ new Date(0);
+  const authAction = data.actions?.find(
+    (action) => action.action === "AUTH"
+  );
+  return {
+    id: data.id,
+    customer: { id: data.customer_id },
+    amount: data.amount,
+    currency: data.currency,
+    status,
+    current_period_start: periodAnchor,
+    current_period_end: periodAnchor,
+    item_id: data.description ?? data.reference_id,
+    billing_interval: recurringIntervalUnitMap[data.schedule.interval] ?? "month",
+    metadata: Object.keys(metadata).length > 0 ? metadata : null,
+    custom_fields: {
+      payment_tokens: data.payment_tokens,
+      recurring_cycle_count: data.recurring_cycle_count ?? null,
+      failed_cycle_action: data.failed_cycle_action ?? null
+    },
+    requires_action: status === "pending" || data.status === "REQUIRES_ACTION",
+    payment_url: authAction?.url ?? null
+  };
+};
+var Refund$inboundSchema = (data) => {
+  const rawMeta = data.metadata ?? {};
+  const metadata = omitInternalMetadata(rawMeta);
+  return {
+    id: data.id,
+    amount: data.amount,
+    currency: data.currency,
+    reason: data.reason ?? null,
+    metadata: Object.keys(metadata).length > 0 ? metadata : null
+  };
+};
+var Invoice$inboundSchema = (data) => {
+  const rawMeta = data.metadata ?? {};
+  const metadata = omitInternalMetadata(rawMeta);
+  return {
+    id: data.id,
+    customer: resolveCustomerFromEmail(
+      data.payer_email ?? data.customer?.email
+    ),
+    subscription_id: data.recurring_payment_id ?? null,
+    billing_mode: data.recurring_payment_id ? "recurring" : "one_time",
+    amount_paid: data.paid_amount ?? data.amount,
+    currency: data.currency,
+    status: "paid",
+    paid_at: data.paid_at ?? data.updated,
+    line_items: data.items?.map((item) => ({
+      id: item.name,
+      quantity: item.quantity
+    })) ?? null,
+    metadata: Object.keys(metadata).length > 0 ? metadata : null,
+    custom_fields: {
+      payment_method: data.payment_method ?? null,
+      payment_channel: data.payment_channel ?? null
+    }
+  };
+};
+
+export { Checkout$inboundSchema, Customer$inboundSchema, Invoice$inboundSchema, Payment$inboundSchema, Refund$inboundSchema, Subscription$inboundSchema };

package/dist/xendit-provider.d.mts

@@ -0,0 +1,50 @@
+import { AbstractPayKitProvider, PayKitProvider, ProviderMetadataRegistry, PaykitProviderOptions, CreateCheckoutSchema, Checkout, UpdateCheckoutSchema, CreateCustomerParams, Customer, UpdateCustomerParams, CreateSubscriptionSchema, Subscription, UpdateSubscriptionSchema, CreatePaymentSchema, Payment, UpdatePaymentSchema, CapturePaymentSchema, CreateRefundSchema, Refund, WebhookHandlerConfig, WebhookEventPayload } from '@paykit-sdk/core';
+import { XenditPaymentToken, XenditRawEvents } from './schema.mjs';
+
+interface XenditMetadata extends ProviderMetadataRegistry {
+    subscription: {
+        payment_tokens?: XenditPaymentToken[];
+    };
+}
+interface XenditOptions extends PaykitProviderOptions {
+    /**
+     * Xendit secret key, e.g. `xnd_development_...` or `xnd_production_...`
+     */
+    secretKey: string;
+}
+declare class XenditProvider extends AbstractPayKitProvider implements PayKitProvider<XenditMetadata, null, XenditRawEvents> {
+    readonly providerName = "xendit";
+    private readonly _client;
+    private readonly opts;
+    readonly isSandbox: boolean;
+    constructor(opts: XenditOptions);
+    get _native(): null;
+    private unwrap;
+    private createInvoice;
+    createCheckout: (params: CreateCheckoutSchema<XenditMetadata["checkout"]>) => Promise<Checkout>;
+    retrieveCheckout: (id: string) => Promise<Checkout | null>;
+    updateCheckout: (_id: string, _params: UpdateCheckoutSchema<XenditMetadata["checkout"]>) => Promise<Checkout>;
+    deleteCheckout: (id: string) => Promise<null>;
+    createCustomer: (params: CreateCustomerParams<XenditMetadata["customer"]>) => Promise<Customer>;
+    retrieveCustomer: (id: string) => Promise<Customer | null>;
+    updateCustomer: (id: string, params: UpdateCustomerParams<XenditMetadata["customer"]>) => Promise<Customer>;
+    deleteCustomer: (_id: string) => Promise<null>;
+    private recurringHeaders;
+    createSubscription: (params: CreateSubscriptionSchema<XenditMetadata["subscription"]>) => Promise<Subscription>;
+    retrieveSubscription: (id: string) => Promise<Subscription | null>;
+    updateSubscription: (id: string, params: UpdateSubscriptionSchema<XenditMetadata["subscription"]>) => Promise<Subscription>;
+    cancelSubscription: (id: string) => Promise<Subscription>;
+    deleteSubscription: (id: string) => Promise<null>;
+    createPayment: (params: CreatePaymentSchema<XenditMetadata["payment"]>) => Promise<Payment>;
+    retrievePayment: (id: string) => Promise<Payment | null>;
+    updatePayment: (_id: string, _params: UpdatePaymentSchema<XenditMetadata["payment"]>) => Promise<Payment>;
+    deletePayment: (_id: string) => Promise<null>;
+    capturePayment: (_id: string, _params: CapturePaymentSchema) => Promise<Payment>;
+    cancelPayment: (id: string) => Promise<Payment>;
+    createRefund: (params: CreateRefundSchema<XenditMetadata["refund"]>) => Promise<Refund>;
+    handleWebhook: (payload: WebhookHandlerConfig, webhookSecret: string | null) => Promise<Array<WebhookEventPayload<XenditRawEvents>>>;
+    private safeStringEqual;
+    private mapToStandardEvents;
+}
+
+export { type XenditOptions, XenditProvider };

package/dist/xendit-provider.d.ts

@@ -0,0 +1,50 @@
+import { AbstractPayKitProvider, PayKitProvider, ProviderMetadataRegistry, PaykitProviderOptions, CreateCheckoutSchema, Checkout, UpdateCheckoutSchema, CreateCustomerParams, Customer, UpdateCustomerParams, CreateSubscriptionSchema, Subscription, UpdateSubscriptionSchema, CreatePaymentSchema, Payment, UpdatePaymentSchema, CapturePaymentSchema, CreateRefundSchema, Refund, WebhookHandlerConfig, WebhookEventPayload } from '@paykit-sdk/core';
+import { XenditPaymentToken, XenditRawEvents } from './schema.js';
+
+interface XenditMetadata extends ProviderMetadataRegistry {
+    subscription: {
+        payment_tokens?: XenditPaymentToken[];
+    };
+}
+interface XenditOptions extends PaykitProviderOptions {
+    /**
+     * Xendit secret key, e.g. `xnd_development_...` or `xnd_production_...`
+     */
+    secretKey: string;
+}
+declare class XenditProvider extends AbstractPayKitProvider implements PayKitProvider<XenditMetadata, null, XenditRawEvents> {
+    readonly providerName = "xendit";
+    private readonly _client;
+    private readonly opts;
+    readonly isSandbox: boolean;
+    constructor(opts: XenditOptions);
+    get _native(): null;
+    private unwrap;
+    private createInvoice;
+    createCheckout: (params: CreateCheckoutSchema<XenditMetadata["checkout"]>) => Promise<Checkout>;
+    retrieveCheckout: (id: string) => Promise<Checkout | null>;
+    updateCheckout: (_id: string, _params: UpdateCheckoutSchema<XenditMetadata["checkout"]>) => Promise<Checkout>;
+    deleteCheckout: (id: string) => Promise<null>;
+    createCustomer: (params: CreateCustomerParams<XenditMetadata["customer"]>) => Promise<Customer>;
+    retrieveCustomer: (id: string) => Promise<Customer | null>;
+    updateCustomer: (id: string, params: UpdateCustomerParams<XenditMetadata["customer"]>) => Promise<Customer>;
+    deleteCustomer: (_id: string) => Promise<null>;
+    private recurringHeaders;
+    createSubscription: (params: CreateSubscriptionSchema<XenditMetadata["subscription"]>) => Promise<Subscription>;
+    retrieveSubscription: (id: string) => Promise<Subscription | null>;
+    updateSubscription: (id: string, params: UpdateSubscriptionSchema<XenditMetadata["subscription"]>) => Promise<Subscription>;
+    cancelSubscription: (id: string) => Promise<Subscription>;
+    deleteSubscription: (id: string) => Promise<null>;
+    createPayment: (params: CreatePaymentSchema<XenditMetadata["payment"]>) => Promise<Payment>;
+    retrievePayment: (id: string) => Promise<Payment | null>;
+    updatePayment: (_id: string, _params: UpdatePaymentSchema<XenditMetadata["payment"]>) => Promise<Payment>;
+    deletePayment: (_id: string) => Promise<null>;
+    capturePayment: (_id: string, _params: CapturePaymentSchema) => Promise<Payment>;
+    cancelPayment: (id: string) => Promise<Payment>;
+    createRefund: (params: CreateRefundSchema<XenditMetadata["refund"]>) => Promise<Refund>;
+    handleWebhook: (payload: WebhookHandlerConfig, webhookSecret: string | null) => Promise<Array<WebhookEventPayload<XenditRawEvents>>>;
+    private safeStringEqual;
+    private mapToStandardEvents;
+}
+
+export { type XenditOptions, XenditProvider };