@fiatden/openpay 0.0.0-stage → 0.0.2

package/dist/resources/auth.js

@@ -0,0 +1,71 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthResource = void 0;
+class AuthResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async register(params) {
+        return this.client.request('/v1/auth/register', {
+            method: 'POST',
+            body: params,
+        });
+    }
+    async login(params) {
+        return this.client.request('/v1/auth/login', {
+            method: 'POST',
+            body: params,
+        });
+    }
+    async me() {
+        return this.client.request('/v1/auth/me');
+    }
+    async refresh(refreshToken) {
+        return this.client.request('/v1/auth/refresh', {
+            method: 'POST',
+            body: { refresh_token: refreshToken },
+        });
+    }
+    async logout(refreshToken) {
+        return this.client.request('/v1/auth/logout', {
+            method: 'POST',
+            body: refreshToken ? { refresh_token: refreshToken } : undefined,
+        });
+    }
+    async verifyEmail(token) {
+        return this.client.request('/v1/auth/verify-email', {
+            method: 'POST',
+            body: { token },
+        });
+    }
+    async resendVerification() {
+        return this.client.request('/v1/auth/resend-verification', {
+            method: 'POST',
+        });
+    }
+    async deleteAccount() {
+        return this.client.request('/v1/auth/account', {
+            method: 'DELETE',
+        });
+    }
+    async changePassword(currentPassword, newPassword) {
+        return this.client.request('/v1/auth/change-password', {
+            method: 'POST',
+            body: { current_password: currentPassword, new_password: newPassword },
+        });
+    }
+    async forgotPassword(email) {
+        return this.client.request('/v1/auth/forgot-password', {
+            method: 'POST',
+            body: { email },
+        });
+    }
+    async resetPassword(token, newPassword) {
+        return this.client.request('/v1/auth/reset-password', {
+            method: 'POST',
+            body: { token, password: newPassword },
+        });
+    }
+}
+exports.AuthResource = AuthResource;

package/dist/resources/billing.d.ts

@@ -0,0 +1,148 @@
+import { HttpClient } from '../http';
+export type BillableAggregationType = 'count_agg' | 'sum_agg' | 'max_agg' | 'unique_count_agg' | 'weighted_sum_agg' | 'latest_agg';
+export interface BillableMetric {
+    id: string;
+    merchant_id: string;
+    app_id: string | null;
+    name: string;
+    code: string;
+    description: string | null;
+    aggregation_type: BillableAggregationType;
+    field_name: string | null;
+    recurring: boolean;
+    weighted_interval: 'seconds' | null;
+    filters: Array<{
+        key: string;
+        values: string[];
+    }>;
+    group_key: string | null;
+    group_values: string[] | null;
+    rounding_function: 'ceil' | 'floor' | 'round' | null;
+    rounding_precision: number | null;
+    expression: string | null;
+    is_active: boolean;
+    created_at: string;
+    updated_at: string;
+}
+export interface BillingEvent {
+    id: string;
+    merchant_id: string;
+    app_id: string | null;
+    transaction_id: string;
+    customer_id: string | null;
+    external_customer_id: string | null;
+    external_subscription_id: string | null;
+    subscription_id: string | null;
+    code: string;
+    billable_metric_id: string | null;
+    timestamp: string;
+    properties: Record<string, unknown>;
+    precise_total_amount_cents: number | null;
+    operation_type: string | null;
+    created_at: string;
+}
+export interface AggregationResult {
+    metric_id: string;
+    code: string;
+    aggregation_type: BillableAggregationType;
+    aggregation_value: number;
+    latest_value?: unknown;
+    event_count: number;
+    period_start: string;
+    period_end: string;
+}
+export interface BillableMetricCreateParams {
+    name: string;
+    code: string;
+    description?: string | null;
+    aggregation_type?: BillableAggregationType;
+    field_name?: string | null;
+    recurring?: boolean;
+    weighted_interval?: 'seconds' | null;
+    filters?: Array<{
+        key: string;
+        values: string[];
+    }>;
+    group_key?: string | null;
+    group_values?: string[] | null;
+    rounding_function?: 'ceil' | 'floor' | 'round' | null;
+    rounding_precision?: number | null;
+    expression?: string | null;
+    app_id?: string | null;
+}
+export interface BillingEventIngestParams {
+    transaction_id: string;
+    code: string;
+    timestamp?: number | string;
+    properties?: Record<string, unknown>;
+    precise_total_amount_cents?: number | null;
+    operation_type?: string | null;
+    customer_id?: string | null;
+    external_customer_id?: string | null;
+    external_subscription_id?: string | null;
+    subscription_id?: string | null;
+    app_id?: string | null;
+}
+export declare class BillingResource {
+    private client;
+    constructor(client: HttpClient);
+    createMetric(params: BillableMetricCreateParams): Promise<BillableMetric>;
+    listMetrics(params?: {
+        app_id?: string;
+        is_active?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        data: BillableMetric[];
+        has_more: boolean;
+    }>;
+    getMetric(id: string): Promise<BillableMetric>;
+    updateMetric(id: string, patch: Partial<Omit<BillableMetricCreateParams, 'code' | 'aggregation_type' | 'app_id'>> & {
+        is_active?: boolean;
+    }): Promise<BillableMetric>;
+    deleteMetric(id: string): Promise<{
+        deleted: boolean;
+    }>;
+    ingestEvent(params: BillingEventIngestParams): Promise<BillingEvent>;
+    ingestEventsBatch(events: BillingEventIngestParams[]): Promise<{
+        data: Array<{
+            event?: BillingEvent;
+            error?: string;
+            duplicate?: boolean;
+        }>;
+        count: number;
+    }>;
+    listEvents(params?: {
+        code?: string;
+        customer_id?: string;
+        external_customer_id?: string;
+        subscription_id?: string;
+        app_id?: string;
+        from?: string;
+        to?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        data: BillingEvent[];
+        has_more: boolean;
+    }>;
+    getEvent(id: string): Promise<BillingEvent>;
+    aggregateMetric(id: string, params?: {
+        from?: string;
+        to?: string;
+        group?: string;
+    }): Promise<AggregationResult>;
+    aggregateMetricByCode(code: string, params?: {
+        from?: string;
+        to?: string;
+        group?: string;
+    }): Promise<AggregationResult>;
+    aggregateAll(params?: {
+        from?: string;
+        to?: string;
+        app_id?: string;
+    }): Promise<{
+        data: AggregationResult[];
+    }>;
+}
+//# sourceMappingURL=billing.d.ts.map

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

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

package/dist/resources/billing.js

@@ -0,0 +1,55 @@
+"use strict";
+// ── Billing Resource ───────────────────────────────────────
+// Lago-style billable metrics + billing events.
+// Matches src/api/billing/routes.ts (migration 047).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BillingResource = void 0;
+class BillingResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    // ── Billable metrics ────────────────────────────────────
+    async createMetric(params) {
+        return this.client.request('/v1/billable-metrics', { method: 'POST', body: params });
+    }
+    async listMetrics(params) {
+        return this.client.request('/v1/billable-metrics', { params });
+    }
+    async getMetric(id) {
+        return this.client.request(`/v1/billable-metrics/${id}`);
+    }
+    async updateMetric(id, patch) {
+        return this.client.request(`/v1/billable-metrics/${id}`, { method: 'PATCH', body: patch });
+    }
+    async deleteMetric(id) {
+        return this.client.request(`/v1/billable-metrics/${id}`, { method: 'DELETE' });
+    }
+    // ── Billing events ──────────────────────────────────────
+    async ingestEvent(params) {
+        return this.client.request('/v1/billing-events', { method: 'POST', body: params });
+    }
+    async ingestEventsBatch(events) {
+        return this.client.request('/v1/billing-events/batch', { method: 'POST', body: { events } });
+    }
+    async listEvents(params) {
+        return this.client.request('/v1/billing-events', { params });
+    }
+    async getEvent(id) {
+        return this.client.request(`/v1/billing-events/${id}`);
+    }
+    // ── Aggregation ─────────────────────────────────────────
+    async aggregateMetric(id, params) {
+        return this.client.request(`/v1/billing/metrics/${id}/aggregation`, { params });
+    }
+    async aggregateMetricByCode(code, params) {
+        // Resolve code→id server-side via aggregation endpoint? The BE aggregation
+        // takes either UUID or code as :id for convenience; the SDK caller should
+        // prefer the id path. This helper is a convenience for Lago code-centric callers.
+        return this.client.request(`/v1/billing/metrics/${encodeURIComponent(code)}/aggregation`, { params });
+    }
+    async aggregateAll(params) {
+        return this.client.request('/v1/billing/aggregation', { params });
+    }
+}
+exports.BillingResource = BillingResource;

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"}