@fiatden/openpay 0.0.0-stage → 0.0.2

package/dist/resources/emailTemplates.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailTemplatesResource = void 0;
+class EmailTemplatesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** List all email templates for the authenticated merchant. */
+    async list(params) {
+        return this.client.request('/v1/email-templates', { params });
+    }
+    /** Get a single email template by ID. */
+    async get(id) {
+        return this.client.request(`/v1/email-templates/${id}`);
+    }
+    /** Create a new email template. */
+    async create(params) {
+        return this.client.request('/v1/email-templates', {
+            method: 'POST',
+            body: params,
+        });
+    }
+    /** Update an existing email template. */
+    async update(id, params) {
+        return this.client.request(`/v1/email-templates/${id}`, {
+            method: 'PATCH',
+            body: params,
+        });
+    }
+    /** Soft-delete (deactivate) an email template. */
+    async delete(id) {
+        return this.client.request(`/v1/email-templates/${id}`, { method: 'DELETE' });
+    }
+    /** Preview a template rendered with sample data (returns HTML). */
+    async preview(id) {
+        const response = await fetch(`${this.client.baseUrl}/v1/email-templates/preview/${encodeURIComponent(id)}`, {
+            headers: {
+                Accept: 'text/html',
+                'x-api-key': this.client.apiKey,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Template preview failed: ${response.status}`);
+        }
+        return response.text();
+    }
+}
+exports.EmailTemplatesResource = EmailTemplatesResource;

package/dist/resources/financialAccounts.d.ts

@@ -0,0 +1,49 @@
+import { HttpClient } from '../http';
+export interface FinancialAccount {
+    id: string;
+    merchant_id: string;
+    app_id: string;
+    currency: string;
+    status: 'active' | 'restricted' | 'closed';
+    /** Σ active wallet balances in the workspace (minor units). */
+    balance: number;
+    paid_credits: number;
+    granted_credits: number;
+    wallet_count: number;
+    metadata: Record<string, unknown>;
+    created_at: string;
+    updated_at: string;
+}
+export interface FinancialAccountStatementEntry {
+    id: string;
+    wallet_id: string;
+    app_id: string;
+    customer_id: string;
+    source_type: 'api_credit' | 'checkout_topup' | 'usage_deduction' | 'adjustment' | 'refund' | 'expiration';
+    entry_type: 'credit' | 'debit';
+    amount: number;
+    balance_after: number;
+    credit_type: 'paid' | 'granted' | null;
+    description: string;
+    created_at: string;
+}
+export declare class FinancialAccountsResource {
+    private client;
+    constructor(client: HttpClient);
+    /** List every workspace financial account + derived balances. */
+    list(): Promise<{
+        data: FinancialAccount[];
+    }>;
+    /** Fetch (auto-provisioning) one workspace's financial account. */
+    get(appId: string): Promise<FinancialAccount>;
+    /** Workspace-wide ledger across every wallet (financial-account statement). */
+    statement(appId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        account: FinancialAccount;
+        data: FinancialAccountStatementEntry[];
+        has_more: boolean;
+    }>;
+}
+//# sourceMappingURL=financialAccounts.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"financialAccounts.d.ts","sourceRoot":"","sources":["../../src/resources/financialAccounts.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,QAAQ,GAAG,YAAY,GAAG,QAAQ,CAAC;IAC3C,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,8BAA8B;IAC7C,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,YAAY,GAAG,gBAAgB,GAAG,iBAAiB,GAAG,YAAY,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC1G,UAAU,EAAE,QAAQ,GAAG,OAAO,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAC;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,yBAAyB;IACxB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,iEAAiE;IAC3D,IAAI,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,gBAAgB,EAAE,CAAA;KAAE,CAAC;IAInD,mEAAmE;IAC7D,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAInD,+EAA+E;IACzE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QACpF,OAAO,EAAE,gBAAgB,CAAC;QAC1B,IAAI,EAAE,8BAA8B,EAAE,CAAC;QACvC,QAAQ,EAAE,OAAO,CAAC;KACnB,CAAC;CAGH"}

package/dist/resources/financialAccounts.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FinancialAccountsResource = void 0;
+class FinancialAccountsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** List every workspace financial account + derived balances. */
+    async list() {
+        return this.client.request('/v1/financial-accounts');
+    }
+    /** Fetch (auto-provisioning) one workspace's financial account. */
+    async get(appId) {
+        return this.client.request(`/v1/financial-accounts/${encodeURIComponent(appId)}`);
+    }
+    /** Workspace-wide ledger across every wallet (financial-account statement). */
+    async statement(appId, params) {
+        return this.client.request(`/v1/financial-accounts/${encodeURIComponent(appId)}/statement`, { params });
+    }
+}
+exports.FinancialAccountsResource = FinancialAccountsResource;

package/dist/resources/fx.d.ts

@@ -0,0 +1,34 @@
+import { HttpClient } from '../http';
+export interface FxRate {
+    base: string;
+    target: string;
+    rate: number;
+    source: string;
+    spread: number;
+    scope: 'platform' | 'merchant';
+    /** Null for platform rates; merchant UUID for per-merchant overrides. */
+    merchant_id: string | null;
+}
+export interface SetFxRateParams {
+    base_currency: string;
+    target_currency: string;
+    rate: number;
+    source?: string;
+    expires_at?: string | null;
+}
+/**
+ * Currency exchange rates. GET returns ALL active rates (platform
+ * + per-merchant overrides) when the calling API key belongs to a
+ * merchant. POST creates a per-merchant override for the calling
+ * merchant when the key is merchant-scoped, or a platform-wide
+ * rate when the key is admin-scoped.
+ */
+export declare class FxResource {
+    private client;
+    constructor(client: HttpClient);
+    list(): Promise<{
+        data: FxRate[];
+    }>;
+    set(params: SetFxRateParams): Promise<FxRate>;
+}
+//# sourceMappingURL=fx.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fx.d.ts","sourceRoot":"","sources":["../../src/resources/fx.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAIrC,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,UAAU,GAAG,UAAU,CAAC;IAC/B,yEAAyE;IACzE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAID;;;;;;GAMG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEhC,IAAI,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAInC,GAAG,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC;CAMpD"}

package/dist/resources/fx.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FxResource = void 0;
+// ── Resource ───────────────────────────────────────────────────────
+/**
+ * Currency exchange rates. GET returns ALL active rates (platform
+ * + per-merchant overrides) when the calling API key belongs to a
+ * merchant. POST creates a per-merchant override for the calling
+ * merchant when the key is merchant-scoped, or a platform-wide
+ * rate when the key is admin-scoped.
+ */
+class FxResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async list() {
+        return this.client.request('/v1/analytics/fx-rates');
+    }
+    async set(params) {
+        return this.client.request('/v1/analytics/fx-rates', {
+            method: 'POST',
+            body: params,
+        });
+    }
+}
+exports.FxResource = FxResource;

package/dist/resources/invoices.d.ts

@@ -0,0 +1,32 @@
+import { HttpClient } from '../http';
+import { Invoice, InvoiceLineItem, ListResponse } from '../types';
+export interface InvoiceCreateParams {
+    customer_id?: string | null;
+    currency?: string;
+    net_days?: number;
+    line_items: InvoiceLineItem[];
+    notes?: string | null;
+    metadata?: Record<string, unknown>;
+    app_id?: string | null;
+    status?: 'draft' | 'open';
+}
+export declare class InvoicesResource {
+    private client;
+    constructor(client: HttpClient);
+    /** Issue an invoice with net payment terms. */
+    create(params: InvoiceCreateParams): Promise<Invoice>;
+    /** List invoices, optionally filtered by status or customer. */
+    list(params?: {
+        status?: string;
+        customer_id?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<ListResponse<Invoice>>;
+    /** Retrieve an invoice by id. */
+    retrieve(id: string): Promise<Invoice>;
+    /** Mark an invoice paid (optionally partially, in minor units). */
+    markPaid(id: string, amount?: number): Promise<Invoice>;
+    /** Void an unpaid invoice. */
+    void(id: string, reason?: string): Promise<Invoice>;
+}
+//# sourceMappingURL=invoices.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"invoices.d.ts","sourceRoot":"","sources":["../../src/resources/invoices.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAElE,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,eAAe,EAAE,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;CAC3B;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,+CAA+C;IACzC,MAAM,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3D,gEAAgE;IAC1D,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IAI/H,iCAAiC;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI5C,mEAAmE;IAC7D,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO7D,8BAA8B;IACxB,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAM1D"}

package/dist/resources/invoices.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvoicesResource = void 0;
+class InvoicesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Issue an invoice with net payment terms. */
+    async create(params) {
+        return this.client.request('/v1/invoices', { method: 'POST', body: params });
+    }
+    /** List invoices, optionally filtered by status or customer. */
+    async list(params) {
+        return this.client.request('/v1/invoices', { params });
+    }
+    /** Retrieve an invoice by id. */
+    async retrieve(id) {
+        return this.client.request(`/v1/invoices/${id}`);
+    }
+    /** Mark an invoice paid (optionally partially, in minor units). */
+    async markPaid(id, amount) {
+        return this.client.request(`/v1/invoices/${id}/paid`, {
+            method: 'POST',
+            body: amount !== undefined ? { amount } : {},
+        });
+    }
+    /** Void an unpaid invoice. */
+    async void(id, reason) {
+        return this.client.request(`/v1/invoices/${id}/void`, {
+            method: 'POST',
+            body: reason ? { reason } : {},
+        });
+    }
+}
+exports.InvoicesResource = InvoicesResource;

package/dist/resources/merchants.d.ts

@@ -0,0 +1,95 @@
+import { HttpClient } from '../http';
+import { MerchantCreateParams, Merchant, MerchantBalance, KYCUpdateParams, ListResponse, PayoutPolicy, AutoPayoutSchedule } from '../types';
+export declare class MerchantsResource {
+    private client;
+    constructor(client: HttpClient);
+    /** Register a new merchant. A wallet is auto-created. */
+    create(params: MerchantCreateParams): Promise<Merchant>;
+    /** Retrieve a merchant by ID. */
+    retrieve(id: string): Promise<Merchant>;
+    /** List all merchants. */
+    list(): Promise<ListResponse<Merchant>>;
+    /** Get merchant wallet balance. */
+    balance(id: string): Promise<MerchantBalance>;
+    /** Update merchant KYC / settlement bank details. */
+    updateKYC(id: string, params: KYCUpdateParams): Promise<Merchant>;
+    /** Upload structured KYC documents and move the merchant into review. */
+    updateKYCDocuments(id: string, documents: Record<string, unknown>): Promise<{
+        id: string;
+        kyc_status: string;
+        kyc_documents: Record<string, unknown>;
+    }>;
+    /** Create or refresh a provider subaccount for the merchant. */
+    createSubaccount(id: string, provider: 'paystack' | 'flutterwave' | 'korapay' | 'hyperswitch'): Promise<{
+        merchant_id: string;
+        provider: string;
+        subaccount_code: string;
+    }>;
+    /** Fetch the merchant's effective payout governance policy (minimum + approval). */
+    getPayoutPolicy(id: string): Promise<PayoutPolicy & {
+        effective_minimum: number;
+        effective_approval_threshold: number;
+    }>;
+    /** Fetch the merchant's auto-payout schedule (null when none is configured). */
+    getAutoPayoutSchedule(id: string): Promise<{
+        merchant_id: string;
+        schedule: AutoPayoutSchedule | null;
+    }>;
+    /** Create or update the merchant's auto-payout schedule. */
+    updateAutoPayoutSchedule(id: string, params: {
+        enabled?: boolean;
+        minimum_amount?: number | null;
+        run_hour?: number | null;
+    }): Promise<{
+        merchant_id: string;
+        schedule: AutoPayoutSchedule;
+    }>;
+    /** Disable the merchant's auto-payout schedule. */
+    disableAutoPayoutSchedule(id: string): Promise<{
+        merchant_id: string;
+        schedule: AutoPayoutSchedule;
+        disabled: boolean;
+    }>;
+    /** 8.4 marketplace: onboard a child merchant under this parent. */
+    createChild(id: string, params: {
+        business_name: string;
+        email: string;
+        phone?: string;
+        country?: string;
+        parent_commission_bps?: number;
+    }): Promise<Merchant>;
+    /** List this parent's immediate child merchants. */
+    listChildren(id: string): Promise<{
+        data: Merchant[];
+    }>;
+    /** List the whole descendant subtree (children, grandchildren, ...). */
+    listDescendants(id: string): Promise<{
+        data: Merchant[];
+    }>;
+    /** Update a child merchant's marketplace commission (basis points). */
+    updateChildCommission(id: string, childId: string, parentCommissionBps: number): Promise<Merchant>;
+    /** Detach a child merchant from this parent. */
+    detachChild(id: string, childId: string): Promise<{
+        id: string;
+        detached: boolean;
+    }>;
+    /** Update a merchant's lifecycle status (admin/operator). */
+    updateStatus(id: string, params: {
+        status: string;
+        reason?: string;
+    }): Promise<Merchant>;
+    /** Fetch a merchant's resolved branding. */
+    getBranding(id: string): Promise<Record<string, unknown>>;
+    /** Update a merchant's branding overrides. */
+    updateBranding(id: string, body: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /** List a merchant's transactions (admin/operator view). */
+    listTransactions(id: string, params?: {
+        limit?: number;
+        offset?: number;
+        status?: string;
+    }): Promise<{
+        data: Array<Record<string, unknown>>;
+        has_more: boolean;
+    }>;
+}
+//# sourceMappingURL=merchants.d.ts.map

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

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

package/dist/resources/merchants.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MerchantsResource = void 0;
+class MerchantsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Register a new merchant. A wallet is auto-created. */
+    async create(params) {
+        return this.client.request('/v1/merchants', {
+            method: 'POST',
+            body: params,
+        });
+    }
+    /** Retrieve a merchant by ID. */
+    async retrieve(id) {
+        return this.client.request(`/v1/merchants/${id}`);
+    }
+    /** List all merchants. */
+    async list() {
+        return this.client.request('/v1/merchants');
+    }
+    /** Get merchant wallet balance. */
+    async balance(id) {
+        return this.client.request(`/v1/merchants/${id}/balance`);
+    }
+    /** Update merchant KYC / settlement bank details. */
+    async updateKYC(id, params) {
+        return this.client.request(`/v1/merchants/${id}/kyc`, {
+            method: 'PATCH',
+            body: params,
+        });
+    }
+    /** Upload structured KYC documents and move the merchant into review. */
+    async updateKYCDocuments(id, documents) {
+        return this.client.request(`/v1/merchants/${id}/kyc-documents`, {
+            method: 'PATCH',
+            body: { documents },
+        });
+    }
+    /** Create or refresh a provider subaccount for the merchant. */
+    async createSubaccount(id, provider) {
+        return this.client.request(`/v1/merchants/${id}/subaccount`, {
+            method: 'POST',
+            body: { provider },
+        });
+    }
+    /** Fetch the merchant's effective payout governance policy (minimum + approval). */
+    async getPayoutPolicy(id) {
+        return this.client.request(`/v1/merchants/${id}/payout-policy`);
+    }
+    /** Fetch the merchant's auto-payout schedule (null when none is configured). */
+    async getAutoPayoutSchedule(id) {
+        return this.client.request(`/v1/merchants/${id}/auto-payout-schedule`);
+    }
+    /** Create or update the merchant's auto-payout schedule. */
+    async updateAutoPayoutSchedule(id, params) {
+        return this.client.request(`/v1/merchants/${id}/auto-payout-schedule`, {
+            method: 'PUT',
+            body: params,
+        });
+    }
+    /** Disable the merchant's auto-payout schedule. */
+    async disableAutoPayoutSchedule(id) {
+        return this.client.request(`/v1/merchants/${id}/auto-payout-schedule`, {
+            method: 'DELETE',
+        });
+    }
+    /** 8.4 marketplace: onboard a child merchant under this parent. */
+    async createChild(id, params) {
+        return this.client.request(`/v1/merchants/${id}/children`, {
+            method: 'POST',
+            body: params,
+        });
+    }
+    /** List this parent's immediate child merchants. */
+    async listChildren(id) {
+        return this.client.request(`/v1/merchants/${id}/children`);
+    }
+    /** List the whole descendant subtree (children, grandchildren, ...). */
+    async listDescendants(id) {
+        return this.client.request(`/v1/merchants/${id}/descendants`);
+    }
+    /** Update a child merchant's marketplace commission (basis points). */
+    async updateChildCommission(id, childId, parentCommissionBps) {
+        return this.client.request(`/v1/merchants/${id}/children/${childId}`, {
+            method: 'PATCH',
+            body: { parent_commission_bps: parentCommissionBps },
+        });
+    }
+    /** Detach a child merchant from this parent. */
+    async detachChild(id, childId) {
+        return this.client.request(`/v1/merchants/${id}/children/${childId}`, { method: 'DELETE' });
+    }
+    /** Update a merchant's lifecycle status (admin/operator). */
+    async updateStatus(id, params) {
+        return this.client.request(`/v1/merchants/${id}/status`, { method: 'PATCH', body: params });
+    }
+    /** Fetch a merchant's resolved branding. */
+    async getBranding(id) {
+        return this.client.request(`/v1/merchants/${id}/branding`);
+    }
+    /** Update a merchant's branding overrides. */
+    async updateBranding(id, body) {
+        return this.client.request(`/v1/merchants/${id}/branding`, { method: 'PATCH', body });
+    }
+    /** List a merchant's transactions (admin/operator view). */
+    async listTransactions(id, params) {
+        return this.client.request(`/v1/merchants/${id}/transactions`, { params });
+    }
+}
+exports.MerchantsResource = MerchantsResource;

package/dist/resources/metering.d.ts

@@ -0,0 +1,65 @@
+import { HttpClient } from '../http';
+export interface UsageRecord {
+    metric_name: string;
+    current_count: number;
+    window: string;
+}
+export interface UsageReport {
+    metric_name: string;
+    period: string;
+    period_start: string;
+    period_end: string;
+    usage: {
+        realtime: number;
+        persisted: number;
+        total: number;
+    };
+    meter?: {
+        name: string;
+        price_per_unit: number;
+        aggregation_window: string;
+    };
+    estimated_cost: number;
+}
+export interface MeterCreateParams {
+    name: string;
+    metric_name: string;
+    metric_label?: string;
+    aggregation_window?: 'minute' | 'hour' | 'day' | 'month';
+    price_per_unit?: number;
+}
+export interface Meter {
+    id: string;
+    merchant_id: string;
+    name: string;
+    metric_name: string;
+    metric_label?: string;
+    aggregation_window: string;
+    price_per_unit: number;
+    is_active: boolean;
+    created_at: string;
+}
+export declare class MeteringResource {
+    private client;
+    constructor(client: HttpClient);
+    record(metric_name: string, count?: number, subscription_id?: string, customer_id?: string): Promise<UsageRecord>;
+    report(metric_name: string, period?: 'hour' | 'day' | 'week' | 'month'): Promise<UsageReport>;
+    history(params?: {
+        metric_name?: string;
+        subscription_id?: string;
+        days?: number;
+    }): Promise<{
+        data: any[];
+        has_more: boolean;
+    }>;
+    createMeter(params: MeterCreateParams): Promise<Meter>;
+    listMeters(): Promise<{
+        data: Meter[];
+        has_more: boolean;
+    }>;
+    deactivateMeter(id: string): Promise<{
+        deleted: boolean;
+        meter: Meter;
+    }>;
+}
+//# sourceMappingURL=metering.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metering.d.ts","sourceRoot":"","sources":["../../src/resources/metering.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;KAC5B,CAAC;IACF,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,CAAC;IACzD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAgB;IACf,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEhC,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAOjH,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC;IAM7F,OAAO,CAAC,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,GAAG,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAIhI,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,KAAK,CAAC;IAOtD,UAAU,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC;IAI3D,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,KAAK,EAAE,KAAK,CAAA;KAAE,CAAC;CAG/E"}

package/dist/resources/metering.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeteringResource = void 0;
+class MeteringResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async record(metric_name, count, subscription_id, customer_id) {
+        return this.client.request('/v1/usage/record', {
+            method: 'POST',
+            body: { metric_name, count: count || 1, subscription_id, customer_id },
+        });
+    }
+    async report(metric_name, period) {
+        return this.client.request('/v1/usage/report', {
+            params: { metric_name, period: period || 'day' },
+        });
+    }
+    async history(params) {
+        return this.client.request('/v1/usage/history', { params });
+    }
+    async createMeter(params) {
+        return this.client.request('/v1/meters', {
+            method: 'POST',
+            body: params,
+        });
+    }
+    async listMeters() {
+        return this.client.request('/v1/meters');
+    }
+    async deactivateMeter(id) {
+        return this.client.request(`/v1/meters/${id}`, { method: 'DELETE' });
+    }
+}
+exports.MeteringResource = MeteringResource;

package/dist/resources/paymentLinks.d.ts

@@ -0,0 +1,45 @@
+import { HttpClient } from '../http';
+import { Currency, ListResponse } from '../types';
+export interface PaymentLinkCreateParams {
+    amount: number;
+    currency?: Currency;
+    description?: string;
+    success_url?: string;
+    cancel_url?: string;
+    max_payments?: number;
+    /** Optional key forwarded as the Idempotency-Key header. */
+    idempotency_key?: string;
+}
+export interface PaymentLink {
+    id: string;
+    merchant_id: string;
+    code: string;
+    amount: number;
+    currency: Currency;
+    description?: string;
+    success_url?: string;
+    cancel_url?: string;
+    is_active: boolean;
+    max_payments?: number;
+    payment_count: number;
+    total_collected: number;
+    payment_url: string;
+    created_at: string;
+    updated_at: string;
+}
+export declare class PaymentLinksResource {
+    private client;
+    constructor(client: HttpClient);
+    /** Create a shareable payment link. Returns a payment_url customers can visit. */
+    create(params: PaymentLinkCreateParams): Promise<PaymentLink>;
+    /** List payment links (optionally filtered by active status). */
+    list(params?: {
+        is_active?: boolean;
+        limit?: number;
+    }): Promise<ListResponse<PaymentLink>>;
+    /** Get a single payment link by code. */
+    get(code: string): Promise<PaymentLink>;
+    /** Deactivate a payment link so it stops accepting payments. */
+    deactivate(code: string): Promise<PaymentLink>;
+}
+//# sourceMappingURL=paymentLinks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"paymentLinks.d.ts","sourceRoot":"","sources":["../../src/resources/paymentLinks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAElD,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,oBAAoB;IACnB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,kFAAkF;IAC5E,MAAM,CAAC,MAAM,EAAE,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC;IAQnE,iEAAiE;IAC3D,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;IAIhG,yCAAyC;IACnC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAI7C,gEAAgE;IAC1D,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAKrD"}