@fiatden/openpay 0.0.0-stage → 0.0.2

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/currencyPortfolio.d.ts

@@ -0,0 +1,62 @@
+import { HttpClient } from '../http';
+export interface PortfolioCurrency {
+    id?: string;
+    currency_code: string;
+    is_base: boolean;
+    is_enabled: boolean;
+    custom_symbol: string | null;
+    custom_decimals: number | null;
+}
+export interface CatalogCurrency {
+    code: string;
+    name: string;
+    symbol: string;
+    decimals: number;
+    in_portfolio: boolean;
+    enabled: boolean;
+    custom_symbol: string | null;
+    custom_decimals: number | null;
+}
+export declare class CurrencyPortfolioResource {
+    private client;
+    constructor(client: HttpClient);
+    /** The merchant's enabled currencies and their base currency. */
+    getPortfolio(): Promise<{
+        data: PortfolioCurrency[];
+        base_currency: string | null;
+    }>;
+    /** Every currency the merchant can enable (platform registry + custom). */
+    getCatalog(): Promise<{
+        data: CatalogCurrency[];
+    }>;
+    /** Enable / upsert a currency in the portfolio (optionally as base). */
+    enable(params: {
+        currency_code: string;
+        is_base?: boolean;
+        custom_symbol?: string | null;
+        custom_decimals?: number | null;
+    }): Promise<{
+        data: PortfolioCurrency[];
+        base_currency: string | null;
+    }>;
+    /** Update presentation overrides or membership for a currency. */
+    update(code: string, patch: {
+        custom_symbol?: string | null;
+        custom_decimals?: number | null;
+        is_enabled?: boolean;
+    }): Promise<{
+        data: PortfolioCurrency[];
+        base_currency: string | null;
+    }>;
+    /** Remove a currency from the portfolio. */
+    remove(code: string): Promise<{
+        data: PortfolioCurrency[];
+        base_currency: string | null;
+    }>;
+    /** Select the merchant's base (settlement) currency. */
+    setBase(currencyCode: string): Promise<{
+        data: PortfolioCurrency[];
+        base_currency: string;
+    }>;
+}
+//# sourceMappingURL=currencyPortfolio.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"currencyPortfolio.d.ts","sourceRoot":"","sources":["../../src/resources/currencyPortfolio.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,OAAO,CAAC;IACpB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;CAChC;AAED,qBAAa,yBAAyB;IACxB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,iEAAiE;IAC3D,YAAY,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAI1F,2EAA2E;IACrE,UAAU,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC;IAIxD,wEAAwE;IAClE,MAAM,CAAC,MAAM,EAAE;QACnB,aAAa,EAAE,MAAM,CAAC;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACjC,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAIxE,kEAAkE;IAC5D,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAIjM,4CAA4C;IACtC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IAIhG,wDAAwD;IAClD,OAAO,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,iBAAiB,EAAE,CAAC;QAAC,aAAa,EAAE,MAAM,CAAA;KAAE,CAAC;CAGnG"}

package/dist/resources/currencyPortfolio.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CurrencyPortfolioResource = void 0;
+class CurrencyPortfolioResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** The merchant's enabled currencies and their base currency. */
+    async getPortfolio() {
+        return this.client.request('/v1/currencies/portfolio');
+    }
+    /** Every currency the merchant can enable (platform registry + custom). */
+    async getCatalog() {
+        return this.client.request('/v1/currencies/catalog');
+    }
+    /** Enable / upsert a currency in the portfolio (optionally as base). */
+    async enable(params) {
+        return this.client.request('/v1/currencies/portfolio', { method: 'POST', body: params });
+    }
+    /** Update presentation overrides or membership for a currency. */
+    async update(code, patch) {
+        return this.client.request(`/v1/currencies/portfolio/${encodeURIComponent(code)}`, { method: 'PATCH', body: patch });
+    }
+    /** Remove a currency from the portfolio. */
+    async remove(code) {
+        return this.client.request(`/v1/currencies/portfolio/${encodeURIComponent(code)}`, { method: 'DELETE' });
+    }
+    /** Select the merchant's base (settlement) currency. */
+    async setBase(currencyCode) {
+        return this.client.request('/v1/currencies/portfolio/base', { method: 'POST', body: { currency_code: currencyCode } });
+    }
+}
+exports.CurrencyPortfolioResource = CurrencyPortfolioResource;

package/dist/resources/customers.d.ts

@@ -0,0 +1,171 @@
+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;
+    }>;
+    /** List a customer's custom-field values, optionally for one workspace. */
+    listCustomFields(id: string, params?: {
+        app_id?: string;
+    }): Promise<{
+        data: Array<{
+            id: string;
+            customer_id: string;
+            app_id: string;
+            field_key: string;
+            field_value: unknown;
+            created_at: string;
+            updated_at: string;
+        }>;
+    }>;
+    /** Write a typed custom-field value (the field must be declared on the app schema). */
+    setCustomField(id: string, fieldKey: string, params: {
+        app_id: string;
+        value: unknown;
+    }): Promise<Record<string, unknown>>;
+    /** Remove a custom-field value. */
+    deleteCustomField(id: string, fieldKey: string, params: {
+        app_id: string;
+    }): Promise<{
+        deleted: boolean;
+    }>;
+    /** List the customer's consent records. */
+    listConsents(id: string): Promise<{
+        data: Array<Record<string, unknown>>;
+    }>;
+    /** Record a consent decision for a purpose. */
+    recordConsent(id: string, params: {
+        purpose: string;
+        granted: boolean;
+        policy_version?: string;
+        source?: string;
+    }): Promise<Record<string, unknown>>;
+    /** 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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"}

package/dist/resources/customers.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomersResource = void 0;
+class CustomersResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async list(params) {
+        const qs = params ? '?' + new URLSearchParams(params).toString() : '';
+        return this.client.request(`/v1/customers${qs}`);
+    }
+    async get(id) {
+        return this.client.request(`/v1/customers/${id}`);
+    }
+    async paymentMethods(id) {
+        return this.client.request(`/v1/customers/${id}/payment-methods`);
+    }
+    async transactions(id, params) {
+        const qs = params ? '?' + new URLSearchParams(params).toString() : '';
+        return this.client.request(`/v1/customers/${id}/transactions${qs}`);
+    }
+    async subscriptions(id) {
+        return this.client.request(`/v1/customers/${id}/subscriptions`);
+    }
+    async disputes(id) {
+        return this.client.request(`/v1/customers/${id}/disputes`);
+    }
+    async recomputeRisk(id) {
+        return this.client.request(`/v1/customers/${id}/risk-score`, { method: 'POST' });
+    }
+    async update(id, body) {
+        return this.client.request(`/v1/customers/${id}`, { method: 'PATCH', body });
+    }
+    async exportData(id) {
+        return this.client.request(`/v1/customers/${id}/export`, { method: 'POST' });
+    }
+    async erase(id) {
+        return this.client.request(`/v1/customers/${id}/erase`, { method: 'POST' });
+    }
+    // ── Per-app typed custom fields (migration 022) ───────────
+    /** List a customer's custom-field values, optionally for one workspace. */
+    async listCustomFields(id, params) {
+        return this.client.request(`/v1/customers/${id}/custom-fields`, { params });
+    }
+    /** Write a typed custom-field value (the field must be declared on the app schema). */
+    async setCustomField(id, fieldKey, params) {
+        return this.client.request(`/v1/customers/${id}/custom-fields/${encodeURIComponent(fieldKey)}`, { method: 'PUT', body: params });
+    }
+    /** Remove a custom-field value. */
+    async deleteCustomField(id, fieldKey, params) {
+        return this.client.request(`/v1/customers/${id}/custom-fields/${encodeURIComponent(fieldKey)}`, { method: 'DELETE', params: { app_id: params.app_id } });
+    }
+    // ── Consent tracking (5.2) ────────────────────────────────
+    /** List the customer's consent records. */
+    async listConsents(id) {
+        return this.client.request(`/v1/customers/${id}/consents`);
+    }
+    /** Record a consent decision for a purpose. */
+    async recordConsent(id, params) {
+        return this.client.request(`/v1/customers/${id}/consents`, { method: 'POST', body: params });
+    }
+    /** Export customers as CSV — mirrors GET /v1/customers/export (same filters as list). Returns raw CSV text. */
+    async exportCsv(params) {
+        const qs = params ? '?' + Object.entries(params).filter(([, v]) => v !== undefined).map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`).join('&') : '';
+        const res = await fetch(`${this.client.baseUrl}/v1/customers/export${qs}`, { headers: { 'x-api-key': this.client.apiKey } });
+        if (!res.ok)
+            throw new Error(`Customers export failed: ${res.status}`);
+        return res.text();
+    }
+}
+exports.CustomersResource = CustomersResource;

package/dist/resources/disputes.d.ts

@@ -0,0 +1,48 @@
+import { HttpClient } from '../http';
+import { Dispute, DisputeEvidenceSubmissionSdk as DisputeEvidenceSubmission, ListResponse } from '../types';
+export declare class DisputesResource {
+    private client;
+    constructor(client: HttpClient);
+    /** List all disputes, optionally filtered by status or provider. */
+    list(params?: {
+        status?: string;
+        provider?: string;
+    }): Promise<ListResponse<Dispute>>;
+    /** Fetch a single dispute with its full evidence submissions history. */
+    get(id: string): Promise<Dispute & {
+        evidence_submissions: DisputeEvidenceSubmission[];
+    }>;
+    /**
+     * Submit an evidence packet for a dispute. Compiles a structured
+     * packet from the linked transaction (refund history, customer
+     * info, prior submissions) and persists it. Best-effort calls
+     * provider.submitDisputeEvidence when the provider exposes one.
+     */
+    submitEvidence(disputeId: string, submission: {
+        narrative: string;
+        evidence?: Record<string, unknown>;
+        file_urls?: string[];
+        auto_generate?: boolean;
+        template_version?: string;
+    }): Promise<DisputeEvidenceSubmission>;
+    /** List every evidence submission attempt for a dispute. */
+    listEvidenceSubmissions(disputeId: string): Promise<{
+        data: DisputeEvidenceSubmission[];
+    }>;
+    /**
+     * Mark a packet as hand-submitted to the upstream provider's
+     * dashboard. Used for providers without a public API endpoint
+     * for evidence submission (most of them today).
+     */
+    markSubmitted(disputeId: string, submissionId: string): Promise<DisputeEvidenceSubmission>;
+    /** Export disputes as CSV — mirrors GET /v1/disputes/export (status/provider/app_id/search/date). Returns raw CSV text. */
+    exportCsv(params?: {
+        status?: string;
+        provider?: string;
+        app_id?: string;
+        search?: string;
+        start_date?: string;
+        end_date?: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=disputes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"disputes.d.ts","sourceRoot":"","sources":["../../src/resources/disputes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,4BAA4B,IAAI,yBAAyB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAE5G,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,oEAAoE;IAC9D,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAI3F,yEAAyE;IACnE,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG;QAAE,oBAAoB,EAAE,yBAAyB,EAAE,CAAA;KAAE,CAAC;IAI/F;;;;;OAKG;IACG,cAAc,CAClB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE;QACV,SAAS,EAAE,MAAM,CAAC;QAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACnC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,aAAa,CAAC,EAAE,OAAO,CAAC;QACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,GACA,OAAO,CAAC,yBAAyB,CAAC;IAOrC,4DAA4D;IACtD,uBAAuB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,yBAAyB,EAAE,CAAA;KAAE,CAAC;IAIhG;;;;OAIG;IACG,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,yBAAyB,CAAC;IAOhG,2HAA2H;IACrH,SAAS,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;CAM5J"}

package/dist/resources/disputes.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DisputesResource = void 0;
+class DisputesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** List all disputes, optionally filtered by status or provider. */
+    async list(params) {
+        return this.client.request('/v1/disputes', { params });
+    }
+    /** Fetch a single dispute with its full evidence submissions history. */
+    async get(id) {
+        return this.client.request(`/v1/disputes/${id}`);
+    }
+    /**
+     * Submit an evidence packet for a dispute. Compiles a structured
+     * packet from the linked transaction (refund history, customer
+     * info, prior submissions) and persists it. Best-effort calls
+     * provider.submitDisputeEvidence when the provider exposes one.
+     */
+    async submitEvidence(disputeId, submission) {
+        return this.client.request(`/v1/disputes/${disputeId}/evidence`, { method: 'POST', body: submission });
+    }
+    /** List every evidence submission attempt for a dispute. */
+    async listEvidenceSubmissions(disputeId) {
+        return this.client.request(`/v1/disputes/${disputeId}/evidence-submissions`);
+    }
+    /**
+     * Mark a packet as hand-submitted to the upstream provider's
+     * dashboard. Used for providers without a public API endpoint
+     * for evidence submission (most of them today).
+     */
+    async markSubmitted(disputeId, submissionId) {
+        return this.client.request(`/v1/disputes/${disputeId}/evidence-submissions/${submissionId}/mark-submitted`, { method: 'POST' });
+    }
+    /** Export disputes as CSV — mirrors GET /v1/disputes/export (status/provider/app_id/search/date). Returns raw CSV text. */
+    async exportCsv(params) {
+        const qs = params ? '?' + Object.entries(params).filter(([, v]) => v !== undefined).map(([k, v]) => `${encodeURIComponent(k)}=${encodeURIComponent(String(v))}`).join('&') : '';
+        const res = await fetch(`${this.client.baseUrl}/v1/disputes/export${qs}`, { headers: { 'x-api-key': this.client.apiKey } });
+        if (!res.ok)
+            throw new Error(`Disputes export failed: ${res.status}`);
+        return res.text();
+    }
+}
+exports.DisputesResource = DisputesResource;

package/dist/resources/emailTemplates.d.ts

@@ -0,0 +1,55 @@
+import { HttpClient } from '../http';
+import { ListResponse } from '../types';
+export type EmailTemplateType = 'welcome' | 'payment_receipt' | 'password_reset' | 'payment_failed' | 'verification' | 'custom';
+export interface EmailTemplate {
+    id: string;
+    merchant_id: string;
+    name: string;
+    template_type: EmailTemplateType;
+    subject_template: string;
+    html_content: string;
+    variables: string[];
+    is_default: boolean;
+    is_active: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface EmailTemplateCreateParams {
+    name: string;
+    template_type: EmailTemplateType;
+    subject_template: string;
+    html_content: string;
+    variables?: string[];
+    is_default?: boolean;
+}
+export interface EmailTemplateUpdateParams {
+    name?: string;
+    subject_template?: string;
+    html_content?: string;
+    variables?: string[];
+    is_default?: boolean;
+    is_active?: boolean;
+}
+export declare class EmailTemplatesResource {
+    private client;
+    constructor(client: HttpClient);
+    /** List all email templates for the authenticated merchant. */
+    list(params?: {
+        template_type?: EmailTemplateType;
+        limit?: number;
+    }): Promise<ListResponse<EmailTemplate>>;
+    /** Get a single email template by ID. */
+    get(id: string): Promise<EmailTemplate>;
+    /** Create a new email template. */
+    create(params: EmailTemplateCreateParams): Promise<EmailTemplate>;
+    /** Update an existing email template. */
+    update(id: string, params: EmailTemplateUpdateParams): Promise<EmailTemplate>;
+    /** Soft-delete (deactivate) an email template. */
+    delete(id: string): Promise<{
+        deleted: boolean;
+        id: string;
+    }>;
+    /** Preview a template rendered with sample data (returns HTML). */
+    preview(id: string): Promise<string>;
+}
+//# sourceMappingURL=emailTemplates.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"emailTemplates.d.ts","sourceRoot":"","sources":["../../src/resources/emailTemplates.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAExC,MAAM,MAAM,iBAAiB,GACzB,SAAS,GACT,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,cAAc,GACd,QAAQ,CAAC;AAEb,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,iBAAiB,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,iBAAiB,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,qBAAa,sBAAsB;IACrB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,+DAA+D;IACzD,IAAI,CAAC,MAAM,CAAC,EAAE;QAClB,aAAa,CAAC,EAAE,iBAAiB,CAAC;QAClC,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC;IAIxC,yCAAyC;IACnC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAI7C,mCAAmC;IAC7B,MAAM,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAOvE,yCAAyC;IACnC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAOnF,kDAAkD;IAC5C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAOnE,mEAAmE;IAC7D,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAe3C"}