@fiatden/openpay 0.0.0-stage → 0.0.1

package/dist/resources/charges.d.ts

@@ -0,0 +1,67 @@
+import { HttpClient } from '../http';
+import { ChargeCreateParams, Charge, TokenizeParams, TokenizeResult, RefundParams, Refund, ListParams, ListResponse } from '../types';
+export declare class ChargesResource {
+    private client;
+    constructor(client: HttpClient);
+    /** Create a one-time payment. Returns a checkout URL to redirect the customer to. */
+    create(params: ChargeCreateParams): Promise<Charge>;
+    /** Retrieve a single charge by reference. */
+    retrieve(reference: string): Promise<Charge>;
+    /** List charges with optional filters. */
+    list(params?: ListParams & {
+        merchant_id?: string;
+        status?: string;
+        provider?: string;
+    }): Promise<ListResponse<Charge>>;
+    /** Refund a successful charge. Pass amount for partial refund. */
+    refund(reference: string, params?: RefundParams): Promise<Refund>;
+    /**
+     * Manually retry a failed charge that opted in to retries
+     * (`retry_on_failure: true`). Returns the new attempt's reference.
+     */
+    retry(reference: string): Promise<{
+        reference: string;
+        retry_reference: string;
+        status: string;
+    }>;
+    /**
+     * Capture an authorized charge (8.2 auth-then-capture). Omit `amount` to
+     * capture the full authorized amount, or pass a smaller amount for a
+     * partial capture — the remainder is released.
+     */
+    capture(reference: string, params?: {
+        amount?: number;
+    }): Promise<{
+        reference: string;
+        status: string;
+        authorized_amount: number;
+        captured_amount: number;
+        currency: string;
+        partially_captured: boolean;
+    }>;
+    /** Void an authorized (uncaptured) charge, releasing the hold. */
+    void(reference: string): Promise<{
+        reference: string;
+        status: string;
+    }>;
+    /** Tokenize a card for future recurring charges (first step for subscriptions). */
+    tokenize(params: TokenizeParams): Promise<TokenizeResult>;
+    /** Export transactions as CSV. Returns raw CSV text. */
+    exportCsv(params?: {
+        merchant_id?: string;
+        status?: string;
+        provider?: string;
+        search?: string;
+        start_date?: string;
+        end_date?: string;
+    }): Promise<string>;
+    /** Get an HTML or JSON invoice/receipt for a charge. */
+    invoice(reference: string, format?: 'html' | 'json'): Promise<any>;
+    /** Send an invoice/receipt email to the customer for a charge. */
+    sendInvoice(reference: string): Promise<{
+        reference: string;
+        sent: boolean;
+        message: string;
+    }>;
+}
+//# sourceMappingURL=charges.d.ts.map

package/dist/resources/charges.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"charges.d.ts","sourceRoot":"","sources":["../../src/resources/charges.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EACL,kBAAkB,EAAE,MAAM,EAAE,cAAc,EAAE,cAAc,EAC1D,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAC/C,MAAM,UAAU,CAAC;AAElB,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,qFAAqF;IAC/E,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzD,6CAA6C;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIlD,0CAA0C;IACpC,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG;QAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAIjC,kEAAkE;IAC5D,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAQvE;;;OAGG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAIvG;;;;OAIG;IACG,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QACtE,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;QACf,iBAAiB,EAAE,MAAM,CAAC;QAC1B,eAAe,EAAE,MAAM,CAAC;QACxB,QAAQ,EAAE,MAAM,CAAC;QACjB,kBAAkB,EAAE,OAAO,CAAC;KAC7B,CAAC;IAOF,kEAAkE;IAC5D,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAI7E,mFAAmF;IAC7E,QAAQ,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAO/D,wDAAwD;IAClD,SAAS,CAAC,MAAM,CAAC,EAAE;QACvB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,MAAM,CAAC;IAkBnB,wDAAwD;IAClD,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,GAAG,MAAe,GAAG,OAAO,CAAC,GAAG,CAAC;IAchF,kEAAkE;IAC5D,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAKrG"}

package/dist/resources/charges.js

@@ -0,0 +1,103 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChargesResource = void 0;
+class ChargesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Create a one-time payment. Returns a checkout URL to redirect the customer to. */
+    async create(params) {
+        return this.client.request('/v1/charges', {
+            method: 'POST',
+            body: params,
+            idempotencyKey: params.idempotency_key,
+        });
+    }
+    /** Retrieve a single charge by reference. */
+    async retrieve(reference) {
+        return this.client.request(`/v1/charges/${reference}`);
+    }
+    /** List charges with optional filters. */
+    async list(params) {
+        return this.client.request('/v1/charges', { params });
+    }
+    /** Refund a successful charge. Pass amount for partial refund. */
+    async refund(reference, params) {
+        return this.client.request(`/v1/charges/${reference}/refund`, {
+            method: 'POST',
+            body: params || {},
+            idempotencyKey: params?.idempotency_key,
+        });
+    }
+    /**
+     * Manually retry a failed charge that opted in to retries
+     * (`retry_on_failure: true`). Returns the new attempt's reference.
+     */
+    async retry(reference) {
+        return this.client.request(`/v1/charges/${reference}/retry`, { method: 'POST' });
+    }
+    /**
+     * Capture an authorized charge (8.2 auth-then-capture). Omit `amount` to
+     * capture the full authorized amount, or pass a smaller amount for a
+     * partial capture — the remainder is released.
+     */
+    async capture(reference, params) {
+        return this.client.request(`/v1/charges/${reference}/capture`, {
+            method: 'POST',
+            body: params || {},
+        });
+    }
+    /** Void an authorized (uncaptured) charge, releasing the hold. */
+    async void(reference) {
+        return this.client.request(`/v1/charges/${reference}/void`, { method: 'POST' });
+    }
+    /** Tokenize a card for future recurring charges (first step for subscriptions). */
+    async tokenize(params) {
+        return this.client.request('/v1/charges/tokenize', {
+            method: 'POST',
+            body: params,
+        });
+    }
+    /** Export transactions as CSV. Returns raw CSV text. */
+    async exportCsv(params) {
+        // CSV export returns raw text, not JSON
+        const qs = params
+            ? '?' + Object.entries(params)
+                .filter(([, v]) => v !== undefined)
+                .map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`)
+                .join('&')
+            : '';
+        const response = await fetch(`${this.client.baseUrl}/v1/charges/export${qs}`, {
+            headers: {
+                'x-api-key': this.client.apiKey,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Export failed: ${response.status}`);
+        }
+        return response.text();
+    }
+    /** Get an HTML or JSON invoice/receipt for a charge. */
+    async invoice(reference, format = 'json') {
+        if (format === 'html') {
+            const response = await fetch(`${this.client.baseUrl}/v1/charges/${encodeURIComponent(reference)}/invoice`, {
+                headers: {
+                    Accept: 'text/html',
+                    'x-api-key': this.client.apiKey,
+                },
+            });
+            if (!response.ok)
+                throw new Error(`Invoice failed: ${response.status}`);
+            return response.text();
+        }
+        return this.client.request(`/v1/charges/${encodeURIComponent(reference)}/invoice`);
+    }
+    /** Send an invoice/receipt email to the customer for a charge. */
+    async sendInvoice(reference) {
+        return this.client.request(`/v1/charges/${encodeURIComponent(reference)}/invoice/send`, {
+            method: 'POST',
+        });
+    }
+}
+exports.ChargesResource = ChargesResource;

package/dist/resources/checkout.d.ts

@@ -0,0 +1,80 @@
+import { HttpClient } from '../http';
+import { Currency } from '../types';
+export interface CheckoutSession {
+    session_id: string;
+    checkout_url: string;
+    reference: string;
+}
+export interface CheckoutSessionParams {
+    amount: number;
+    email: string;
+    currency?: Currency;
+    customer_name?: string;
+    merchant_id?: string;
+    success_url?: string;
+    cancel_url?: string;
+    metadata?: Record<string, unknown>;
+    referral_code?: string;
+    coupon_code?: string;
+    provider_preference?: 'paystack' | 'flutterwave' | 'korapay' | 'hyperswitch';
+    /** 8.2 multi-currency checkout: presentment currencies the payer may pick. */
+    accepted_currencies?: Currency[];
+    /** 8.2 guest saved cards: save the payer's card on success (default true). */
+    save_card?: boolean;
+    /** 5.2 consent tracking: capture the payer's consent decisions. */
+    consent?: {
+        data_processing?: boolean;
+        marketing_email?: boolean;
+        analytics?: boolean;
+        third_party_sharing?: boolean;
+    };
+    /** Optional key forwarded as the Idempotency-Key header. */
+    idempotency_key?: string;
+}
+export interface CheckoutSessionDetail {
+    id: string;
+    reference: string;
+    merchant_id?: string;
+    amount: number;
+    currency: string;
+    net_amount: number;
+    discount_amount: number;
+    coupon_id?: string;
+    customer_email: string;
+    customer_name?: string;
+    provider: string;
+    status: string;
+    authorization_url?: string;
+    checkout_url?: string;
+    success_url?: string;
+    cancel_url?: string;
+    metadata: Record<string, unknown>;
+    expires_at: string;
+    created_at: string;
+    transaction_status: string;
+    hosted_url: string;
+}
+export declare class CheckoutResource {
+    private client;
+    constructor(client: HttpClient);
+    create(params: CheckoutSessionParams): Promise<CheckoutSession>;
+    get(id: string): Promise<CheckoutSessionDetail>;
+    /**
+     * 8.2 multiple currency checkout: switch an open session's presentment
+     * currency to one advertised in `accepted_currencies`. The amount is
+     * FX-converted and the provider session is re-initialised.
+     */
+    switchCurrency(id: string, currency: Currency): Promise<{
+        session_id: string;
+        reference: string;
+        currency: string;
+        amount: number;
+        net_amount: number;
+        exchange_rate: number;
+        checkout_url: string;
+        authorization_url: string | null;
+    }>;
+    /** Get the hosted payment page URL for a session. */
+    hostedUrl(sessionId: string, baseUrl?: string): string;
+}
+//# sourceMappingURL=checkout.d.ts.map

package/dist/resources/checkout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.d.ts","sourceRoot":"","sources":["../../src/resources/checkout.ts"],"names":[],"mappings":"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"}

package/dist/resources/checkout.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckoutResource = void 0;
+class CheckoutResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(params) {
+        return this.client.request('/v1/checkout/sessions', {
+            method: 'POST',
+            body: params,
+            idempotencyKey: params.idempotency_key,
+        });
+    }
+    async get(id) {
+        return this.client.request(`/v1/checkout/sessions/${id}`);
+    }
+    /**
+     * 8.2 multiple currency checkout: switch an open session's presentment
+     * currency to one advertised in `accepted_currencies`. The amount is
+     * FX-converted and the provider session is re-initialised.
+     */
+    async switchCurrency(id, currency) {
+        return this.client.request(`/v1/checkout/sessions/${id}/currency`, {
+            method: 'POST',
+            body: { currency },
+        });
+    }
+    /** Get the hosted payment page URL for a session. */
+    hostedUrl(sessionId, baseUrl) {
+        const base = baseUrl || 'http://localhost:3000';
+        return `${base.replace(/\/$/, '')}/pay/${sessionId}`;
+    }
+}
+exports.CheckoutResource = CheckoutResource;

package/dist/resources/coupons.d.ts

@@ -0,0 +1,66 @@
+import { HttpClient } from '../http';
+import { ListResponse } from '../types';
+export interface CouponCreateParams {
+    code: string;
+    discount_type: 'percentage' | 'fixed';
+    discount_value: number;
+    description?: string;
+    max_discount_amount?: number;
+    applies_to?: 'all' | 'plan' | 'first_payment';
+    plan_id?: string;
+    min_amount?: number;
+    max_uses?: number;
+    max_uses_per_customer?: number;
+    starts_at?: string;
+    expires_at?: string;
+}
+export interface Coupon {
+    id: string;
+    merchant_id: string;
+    code: string;
+    description?: string;
+    discount_type: 'percentage' | 'fixed';
+    discount_value: number;
+    max_discount_amount?: number;
+    applies_to: string;
+    plan_id?: string;
+    min_amount: number;
+    max_uses?: number;
+    max_uses_per_customer: number;
+    is_active: boolean;
+    total_used: number;
+    created_at: string;
+}
+export interface CouponValidation {
+    valid: boolean;
+    coupon?: Coupon;
+    discount_amount?: number;
+    final_amount?: number;
+}
+export interface CouponValidateParams {
+    code: string;
+    amount: number;
+    plan_id?: string;
+    customer_id?: string;
+}
+export declare class CouponsResource {
+    private client;
+    constructor(client: HttpClient);
+    create(params: CouponCreateParams): Promise<Coupon>;
+    list(params?: {
+        is_active?: boolean;
+        code?: string;
+    }): Promise<ListResponse<Coupon>>;
+    get(id: string): Promise<Coupon>;
+    update(id: string, params: {
+        is_active?: boolean;
+        max_uses?: number;
+        description?: string;
+    }): Promise<Coupon>;
+    deactivate(id: string): Promise<{
+        deleted: boolean;
+        coupon: Coupon;
+    }>;
+    validate(params: CouponValidateParams): Promise<CouponValidation>;
+}
+//# sourceMappingURL=coupons.d.ts.map

package/dist/resources/coupons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coupons.d.ts","sourceRoot":"","sources":["../../src/resources/coupons.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAY,YAAY,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,YAAY,GAAG,OAAO,CAAC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,eAAe,CAAC;IAC9C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,YAAY,GAAG,OAAO,CAAC;IACtC,cAAc,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,eAAe;IACd,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEhC,MAAM,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,MAAM,CAAC;IAOnD,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAIpF,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAIhC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAO7G,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IAMrE,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAMxE"}

package/dist/resources/coupons.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CouponsResource = void 0;
+class CouponsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async create(params) {
+        return this.client.request('/v1/coupons', {
+            method: 'POST',
+            body: params,
+        });
+    }
+    async list(params) {
+        return this.client.request('/v1/coupons', { params });
+    }
+    async get(id) {
+        return this.client.request(`/v1/coupons/${id}`);
+    }
+    async update(id, params) {
+        return this.client.request(`/v1/coupons/${id}`, {
+            method: 'PATCH',
+            body: params,
+        });
+    }
+    async deactivate(id) {
+        return this.client.request(`/v1/coupons/${id}`, {
+            method: 'DELETE',
+        });
+    }
+    async validate(params) {
+        return this.client.request('/v1/coupons/validate', {
+            method: 'POST',
+            body: params,
+        });
+    }
+}
+exports.CouponsResource = CouponsResource;

package/dist/resources/currencies.d.ts

@@ -0,0 +1,45 @@
+import { HttpClient } from '../http';
+export interface CurrencyRecord {
+    code: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    is_active: boolean;
+    is_fiat: boolean;
+    sort_order: number;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Admin-managed ISO 4217 currency registry. GET returns the active
+ * list to anyone with an API key. POST/PATCH/DELETE are admin-only
+ * and let operators onboard new currencies and deactivate retired
+ * ones without a schema migration.
+ */
+export declare class CurrenciesResource {
+    private client;
+    constructor(client: HttpClient);
+    list(): Promise<{
+        data: CurrencyRecord[];
+    }>;
+    /**
+     * Upsert. If the currency code exists, its other fields are
+     * overwritten; otherwise it's inserted. Admin-only.
+     */
+    upsert(body: Omit<CurrencyRecord, 'created_at' | 'updated_at'>): Promise<CurrencyRecord>;
+    /**
+     * Partial update of a currency's metadata (name, symbol, decimals,
+     * sort_order, is_active, is_fiat). Code is immutable. Admin-only.
+     */
+    update(code: string, body: Partial<Omit<CurrencyRecord, 'code' | 'created_at' | 'updated_at'>>): Promise<CurrencyRecord>;
+    /**
+     * Soft delete: sets is_active=false. The currency stays in the DB
+     * for audit history; fx-service validates only against active codes
+     * so this takes effect immediately for new settlements.
+     */
+    deactivate(code: string): Promise<{
+        code: string;
+        is_active: false;
+    }>;
+}
+//# sourceMappingURL=currencies.d.ts.map

package/dist/resources/currencies.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currencies.d.ts","sourceRoot":"","sources":["../../src/resources/currencies.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIrC,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAID;;;;;GAKG;AACH,qBAAa,kBAAkB;IACjB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEhC,IAAI,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,cAAc,EAAE,CAAA;KAAE,CAAC;IAIjD;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,GAAG,YAAY,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAO9F;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC;IAO9H;;;;OAIG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,CAAA;KAAE,CAAC;CAM5E"}

package/dist/resources/currencies.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CurrenciesResource = void 0;
+// ── Resource ───────────────────────────────────────────────────────
+/**
+ * Admin-managed ISO 4217 currency registry. GET returns the active
+ * list to anyone with an API key. POST/PATCH/DELETE are admin-only
+ * and let operators onboard new currencies and deactivate retired
+ * ones without a schema migration.
+ */
+class CurrenciesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async list() {
+        return this.client.request('/v1/currencies');
+    }
+    /**
+     * Upsert. If the currency code exists, its other fields are
+     * overwritten; otherwise it's inserted. Admin-only.
+     */
+    async upsert(body) {
+        return this.client.request('/v1/currencies', {
+            method: 'POST',
+            body,
+        });
+    }
+    /**
+     * Partial update of a currency's metadata (name, symbol, decimals,
+     * sort_order, is_active, is_fiat). Code is immutable. Admin-only.
+     */
+    async update(code, body) {
+        return this.client.request(`/v1/currencies/${encodeURIComponent(code)}`, {
+            method: 'PATCH',
+            body,
+        });
+    }
+    /**
+     * Soft delete: sets is_active=false. The currency stays in the DB
+     * for audit history; fx-service validates only against active codes
+     * so this takes effect immediately for new settlements.
+     */
+    async deactivate(code) {
+        return this.client.request(`/v1/currencies/${encodeURIComponent(code)}`, { method: 'DELETE' });
+    }
+}
+exports.CurrenciesResource = CurrenciesResource;

package/dist/resources/customers.d.ts

@@ -0,0 +1,135 @@
+import { HttpClient } from '../http';
+import { TransactionSdk as Transaction, SubscriptionSdk as Subscription, DisputeSdk as Dispute } from '../types';
+export interface Customer {
+    id: string;
+    email: string;
+    name: string | null;
+    phone: string | null;
+    default_app_id: string | null;
+    metadata: Record<string, unknown>;
+    first_seen_at: string;
+    last_seen_at: string;
+    transaction_count: number;
+    successful_payment_count: number;
+    failed_payment_count: number;
+    refund_count: number;
+    dispute_count: number;
+    subscription_count: number;
+    payment_method_count: number;
+    lifetime_spend_cents: number;
+    risk_score: number;
+    risk_signals: Record<string, unknown>;
+    acquisition_source: string | null;
+    acquisition_referral_code: string | null;
+    gdpr_erased_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface PaymentMethod {
+    id: string;
+    provider: 'paystack' | 'flutterwave' | 'korapay' | 'hyperswitch';
+    card_type: string | null;
+    last4: string | null;
+    exp_month: string | null;
+    exp_year: string | null;
+    bin: string | null;
+    bank_name: string | null;
+    brand: string | null;
+    reusable: boolean;
+    is_default: boolean;
+    first_used_at: string | null;
+    last_used_at: string | null;
+    usage_count: number;
+    app_id: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface CustomerRiskScore {
+    id: string;
+    risk_score: number;
+    risk_signals: {
+        dispute_rate: number;
+        failure_rate: number;
+        refund_rate: number;
+        dispute_count: number;
+        successful_payments: number;
+        failed_payments: number;
+        refunded_payments: number;
+        computed_at: string;
+    };
+}
+export interface CustomerExportPayload {
+    generated_at: string;
+    customer_id: string;
+    customer: Customer | null;
+    transactions: Transaction[];
+    payment_methods: Omit<PaymentMethod, 'auth_token'>[];
+    subscriptions: Subscription[];
+    disputes: Dispute[];
+}
+export declare class CustomersResource {
+    private client;
+    constructor(client: HttpClient);
+    list(params?: {
+        search?: string;
+        email?: string;
+        sort?: 'last_seen' | 'first_seen' | 'lifetime_spend_cents' | 'risk_score' | 'transaction_count';
+        order?: 'asc' | 'desc';
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        data: Customer[];
+        has_more: boolean;
+    }>;
+    get(id: string): Promise<Customer>;
+    paymentMethods(id: string): Promise<{
+        data: PaymentMethod[];
+    }>;
+    transactions(id: string, params?: {
+        limit?: number;
+        offset?: number;
+        status?: string;
+        type?: string;
+    }): Promise<{
+        data: Transaction[];
+        has_more: boolean;
+    }>;
+    subscriptions(id: string): Promise<{
+        data: (Subscription & {
+            plan_name: string;
+            plan_amount: number;
+            plan_currency: string;
+        })[];
+    }>;
+    disputes(id: string): Promise<{
+        data: (Dispute & {
+            evidence_submissions_count: number;
+        })[];
+    }>;
+    recomputeRisk(id: string): Promise<CustomerRiskScore>;
+    update(id: string, body: {
+        name?: string;
+        phone?: string;
+        metadata?: Record<string, unknown>;
+        default_app_id?: string | null;
+    }): Promise<Customer>;
+    exportData(id: string): Promise<{
+        export_id: string;
+        payload: CustomerExportPayload;
+    }>;
+    erase(id: string): Promise<{
+        id: string;
+        erased_at: string;
+        erasure_hash: string;
+        message: string;
+    }>;
+    /** Export customers as CSV — mirrors GET /v1/customers/export (same filters as list). Returns raw CSV text. */
+    exportCsv(params?: {
+        search?: string;
+        email?: string;
+        app_id?: string;
+        start_date?: string;
+        end_date?: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=customers.d.ts.map

package/dist/resources/customers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"customers.d.ts","sourceRoot":"","sources":["../../src/resources/customers.ts"],"names":[],"mappings":"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"}