@fiatden/openpay 0.0.0-stage → 0.0.2

package/dist/resources/referrals.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReferralsResource = void 0;
+class ReferralsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async myReferral() {
+        return this.client.request('/v1/merchants/me/referral');
+    }
+    async commissions() {
+        return this.client.request('/v1/merchants/me/referral/commissions');
+    }
+}
+exports.ReferralsResource = ReferralsResource;

package/dist/resources/riskReview.d.ts

@@ -0,0 +1,96 @@
+import { HttpClient } from '../http';
+import { Currency, Provider } from '../types';
+export interface RiskReviewTransaction {
+    id: string;
+    reference: string;
+    amount: number;
+    currency: Currency;
+    provider: Provider;
+    status: string;
+    customer_email: string;
+    customer_name: string | null;
+    channel: string | null;
+    risk_score: number;
+    risk_flags: Record<string, unknown>;
+    risk_review_status: 'flagged' | 'reviewing' | 'approved' | 'declined';
+    merchant_name: string | null;
+    created_at: string;
+}
+export interface RiskReviewDetail {
+    transaction: RiskReviewTransaction & {
+        merchant_email: string;
+        merchant_id: string;
+        provider_reference: string | null;
+        fee: number;
+        net_amount: number;
+    };
+    reviews: Array<{
+        id: string;
+        transaction_id: string;
+        transaction_reference: string;
+        risk_score: number;
+        risk_flags: Record<string, unknown>;
+        reviewer_email: string;
+        action: 'flagged' | 'approved' | 'declined';
+        reason: string;
+        created_at: string;
+    }>;
+}
+export interface RiskReviewStats {
+    flagged: number;
+    reviewing: number;
+    approved_today: number;
+    declined_today: number;
+    avg_flagged_score: number;
+    max_flagged_score: number;
+}
+export interface RiskReviewListParams {
+    status?: 'flagged' | 'reviewing' | 'approved' | 'declined';
+    min_score?: number;
+    limit?: number;
+    offset?: number;
+}
+export interface RiskReviewListResponse {
+    data: RiskReviewTransaction[];
+    total: number;
+    has_more: boolean;
+}
+export declare class RiskReviewResource {
+    private client;
+    constructor(client: HttpClient);
+    /** List flagged transactions in the risk review queue (admin-only). */
+    list(params?: RiskReviewListParams): Promise<RiskReviewListResponse>;
+    /** Get full detail for a transaction, including review history. */
+    get(id: string): Promise<RiskReviewDetail>;
+    /** Approve a flagged transaction (admin-only). */
+    approve(id: string, reason?: string): Promise<{
+        transaction_id: string;
+        reference: string;
+        status: 'approved';
+    }>;
+    /** Decline a flagged transaction — also marks the transaction as failed. */
+    decline(id: string, reason?: string): Promise<{
+        transaction_id: string;
+        reference: string;
+        status: 'declined';
+    }>;
+    /** Get summary stats for the risk review queue. */
+    stats(): Promise<RiskReviewStats>;
+    /** Bulk approve up to 100 flagged transactions (admin). */
+    bulkApprove(ids: string[], reason?: string): Promise<{
+        approved: number;
+        results: Array<{
+            id: string;
+            status: string;
+        }>;
+    }>;
+    /** Bulk decline up to 100 flagged transactions (admin). Marks each as failed. */
+    bulkDecline(ids: string[], reason?: string): Promise<{
+        declined: number;
+        results: Array<{
+            id: string;
+            status: string;
+        }>;
+    }>;
+}
+//# sourceMappingURL=riskReview.d.ts.map

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

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

package/dist/resources/riskReview.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RiskReviewResource = void 0;
+class RiskReviewResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** List flagged transactions in the risk review queue (admin-only). */
+    async list(params) {
+        return this.client.request('/v1/risk-review', { params });
+    }
+    /** Get full detail for a transaction, including review history. */
+    async get(id) {
+        return this.client.request(`/v1/risk-review/${id}`);
+    }
+    /** Approve a flagged transaction (admin-only). */
+    async approve(id, reason) {
+        return this.client.request(`/v1/risk-review/${id}/approve`, {
+            method: 'POST',
+            body: { reason },
+        });
+    }
+    /** Decline a flagged transaction — also marks the transaction as failed. */
+    async decline(id, reason) {
+        return this.client.request(`/v1/risk-review/${id}/decline`, {
+            method: 'POST',
+            body: { reason },
+        });
+    }
+    /** Get summary stats for the risk review queue. */
+    async stats() {
+        return this.client.request('/v1/risk-review/stats');
+    }
+    /** Bulk approve up to 100 flagged transactions (admin). */
+    async bulkApprove(ids, reason) {
+        return this.client.request('/v1/risk-review/bulk-approve', { method: 'POST', body: { ids, reason } });
+    }
+    /** Bulk decline up to 100 flagged transactions (admin). Marks each as failed. */
+    async bulkDecline(ids, reason) {
+        return this.client.request('/v1/risk-review/bulk-decline', { method: 'POST', body: { ids, reason } });
+    }
+}
+exports.RiskReviewResource = RiskReviewResource;

package/dist/resources/roles.d.ts

@@ -0,0 +1,59 @@
+import { HttpClient } from '../http';
+export interface PermissionEntry {
+    key: string;
+    description: string;
+}
+export interface CustomRole {
+    id: string;
+    merchant_id: string;
+    name: string;
+    description: string | null;
+    permissions: string[];
+    created_at: string;
+    updated_at: string;
+}
+export interface RoleCreateParams {
+    name: string;
+    description?: string;
+    permissions?: string[];
+    merchant_id?: string;
+}
+export interface RoleAssignParams {
+    api_key_id?: string;
+    apply_to_merchant?: boolean;
+}
+/**
+ * 8.4 Custom roles (RBAC). Merchants define named permission sets and bind
+ * them to their session or to individual API keys.
+ */
+export declare class RolesResource {
+    private client;
+    constructor(client: HttpClient);
+    /** List the assignable permission catalogue. */
+    listPermissions(): Promise<{
+        data: PermissionEntry[];
+    }>;
+    /** List the merchant's custom roles. */
+    list(params?: {
+        merchant_id?: string;
+    }): Promise<{
+        data: CustomRole[];
+    }>;
+    /** Create a custom role. */
+    create(params: RoleCreateParams): Promise<CustomRole>;
+    /** Retrieve a custom role. */
+    retrieve(id: string): Promise<CustomRole>;
+    /** Update a custom role's name, description or permissions. */
+    update(id: string, params: Partial<RoleCreateParams>): Promise<CustomRole>;
+    /** Delete a custom role and detach any bindings to it. */
+    remove(id: string): Promise<{
+        id: string;
+        deleted: boolean;
+    }>;
+    /** Bind a role to the merchant session and/or an API key. */
+    assign(id: string, params: RoleAssignParams): Promise<{
+        role_id: string;
+        applied: Record<string, string>;
+    }>;
+}
+//# sourceMappingURL=roles.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"roles.d.ts","sourceRoot":"","sources":["../../src/resources/roles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED;;;GAGG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,gDAAgD;IAC1C,eAAe,IAAI,OAAO,CAAC;QAAE,IAAI,EAAE,eAAe,EAAE,CAAA;KAAE,CAAC;IAI7D,wCAAwC;IAClC,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IAI9E,4BAA4B;IACtB,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAI3D,8BAA8B;IACxB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/C,+DAA+D;IACzD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;IAIhF,0DAA0D;IACpD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IAInE,6DAA6D;IACvD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,CAAC;CAGlH"}

package/dist/resources/roles.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RolesResource = void 0;
+/**
+ * 8.4 Custom roles (RBAC). Merchants define named permission sets and bind
+ * them to their session or to individual API keys.
+ */
+class RolesResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** List the assignable permission catalogue. */
+    async listPermissions() {
+        return this.client.request('/v1/permissions');
+    }
+    /** List the merchant's custom roles. */
+    async list(params) {
+        return this.client.request('/v1/roles', { params });
+    }
+    /** Create a custom role. */
+    async create(params) {
+        return this.client.request('/v1/roles', { method: 'POST', body: params });
+    }
+    /** Retrieve a custom role. */
+    async retrieve(id) {
+        return this.client.request(`/v1/roles/${id}`);
+    }
+    /** Update a custom role's name, description or permissions. */
+    async update(id, params) {
+        return this.client.request(`/v1/roles/${id}`, { method: 'PATCH', body: params });
+    }
+    /** Delete a custom role and detach any bindings to it. */
+    async remove(id) {
+        return this.client.request(`/v1/roles/${id}`, { method: 'DELETE' });
+    }
+    /** Bind a role to the merchant session and/or an API key. */
+    async assign(id, params) {
+        return this.client.request(`/v1/roles/${id}/assign`, { method: 'POST', body: params });
+    }
+}
+exports.RolesResource = RolesResource;

package/dist/resources/status.d.ts

@@ -0,0 +1,20 @@
+import { HttpClient } from '../http';
+export interface PublicStatus {
+    status: 'operational' | 'degraded';
+    platform: string;
+    timestamp: string;
+    services: {
+        database: 'operational' | 'unavailable';
+        redis: 'operational' | 'unavailable';
+        providers: Record<string, {
+            status: string;
+        }>;
+    };
+}
+export declare class StatusResource {
+    private client;
+    constructor(client: HttpClient);
+    /** Fetch the public status snapshot as JSON. */
+    get(): Promise<PublicStatus>;
+}
+//# sourceMappingURL=status.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/resources/status.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,aAAa,GAAG,UAAU,CAAC;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE;QACR,QAAQ,EAAE,aAAa,GAAG,aAAa,CAAC;QACxC,KAAK,EAAE,aAAa,GAAG,aAAa,CAAC;QACrC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAC/C,CAAC;CACH;AAED,qBAAa,cAAc;IACb,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,gDAAgD;IAC1C,GAAG,IAAI,OAAO,CAAC,YAAY,CAAC;CAGnC"}

package/dist/resources/status.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StatusResource = void 0;
+class StatusResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Fetch the public status snapshot as JSON. */
+    async get() {
+        return this.client.request('/status');
+    }
+}
+exports.StatusResource = StatusResource;

package/dist/resources/subscriptions.d.ts

@@ -0,0 +1,46 @@
+import { HttpClient } from '../http';
+import { PlanCreateParams, Plan, SubscriptionCreateParams, Subscription, ListResponse } from '../types';
+export declare class SubscriptionsResource {
+    private client;
+    constructor(client: HttpClient);
+    /** Create a subscription plan. */
+    createPlan(params: PlanCreateParams): Promise<Plan>;
+    /** List plans, optionally filtered by merchant. */
+    listPlans(merchantId?: string): Promise<ListResponse<Plan>>;
+    /** Retrieve a plan by id. */
+    getPlan(id: string): Promise<Plan>;
+    /** Update a plan's mutable fields (name, amount, interval, active flag). */
+    updatePlan(id: string, patch: Partial<Omit<PlanCreateParams, 'merchant_id'>>): Promise<Plan>;
+    /** Create a subscription (must tokenize card first via charges.tokenize). */
+    create(params: SubscriptionCreateParams): Promise<Subscription>;
+    /** List subscriptions, optionally filtered by customer or status. */
+    list(params?: {
+        customer_id?: string;
+        status?: string;
+    }): Promise<ListResponse<Subscription>>;
+    /** Pause an active subscription (optionally with a scheduled resume date). */
+    pause(id: string, body?: {
+        resume_at?: string;
+        reason?: string;
+    }): Promise<Subscription>;
+    /** Resume a previously paused subscription. */
+    resume(id: string): Promise<Subscription>;
+    /** Change plans with a durable proration credit and idempotency key. */
+    changePlan(id: string, planId: string, idempotencyKey?: string): Promise<{
+        change: Record<string, unknown>;
+        idempotent: boolean;
+        proration?: {
+            unused_credit: number;
+            prior_credit_balance: number;
+            credit_applied: number;
+            charge_due_next_billing: number;
+            credit_balance: number;
+        };
+        subscription?: Subscription & {
+            credit_balance?: number;
+        };
+    }>;
+    /** Cancel an active subscription. */
+    cancel(id: string): Promise<Subscription>;
+}
+//# sourceMappingURL=subscriptions.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptions.d.ts","sourceRoot":"","sources":["../../src/resources/subscriptions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EACL,gBAAgB,EAAE,IAAI,EACtB,wBAAwB,EAAE,YAAY,EACtC,YAAY,EACb,MAAM,UAAU,CAAC;AAElB,qBAAa,qBAAqB;IACpB,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,kCAAkC;IAC5B,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzD,mDAAmD;IAC7C,SAAS,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;IAMjE,6BAA6B;IACvB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxC,4EAA4E;IACtE,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,aAAa,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlG,6EAA6E;IACvE,MAAM,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,YAAY,CAAC;IAOrE,qEAAqE;IAC/D,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,CAAC;IAInG,8EAA8E;IACxE,KAAK,CACT,EAAE,EAAE,MAAM,EACV,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7C,OAAO,CAAC,YAAY,CAAC;IAOxB,+CAA+C;IACzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAM/C,wEAAwE;IAClE,UAAU,CACd,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,GACtB,OAAO,CAAC;QACT,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,UAAU,EAAE,OAAO,CAAC;QACpB,SAAS,CAAC,EAAE;YACV,aAAa,EAAE,MAAM,CAAC;YACtB,oBAAoB,EAAE,MAAM,CAAC;YAC7B,cAAc,EAAE,MAAM,CAAC;YACvB,uBAAuB,EAAE,MAAM,CAAC;YAChC,cAAc,EAAE,MAAM,CAAC;SACxB,CAAC;QACF,YAAY,CAAC,EAAE,YAAY,GAAG;YAAE,cAAc,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3D,CAAC;IAQF,qCAAqC;IAC/B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;CAKhD"}

package/dist/resources/subscriptions.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SubscriptionsResource = void 0;
+class SubscriptionsResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Create a subscription plan. */
+    async createPlan(params) {
+        return this.client.request('/v1/plans', {
+            method: 'POST',
+            body: params,
+        });
+    }
+    /** List plans, optionally filtered by merchant. */
+    async listPlans(merchantId) {
+        return this.client.request('/v1/plans', {
+            params: merchantId ? { merchant_id: merchantId } : undefined,
+        });
+    }
+    /** Retrieve a plan by id. */
+    async getPlan(id) {
+        return this.client.request(`/v1/plans/${id}`);
+    }
+    /** Update a plan's mutable fields (name, amount, interval, active flag). */
+    async updatePlan(id, patch) {
+        return this.client.request(`/v1/plans/${id}`, { method: 'PATCH', body: patch });
+    }
+    /** Create a subscription (must tokenize card first via charges.tokenize). */
+    async create(params) {
+        return this.client.request('/v1/subscriptions', {
+            method: 'POST',
+            body: params,
+        });
+    }
+    /** List subscriptions, optionally filtered by customer or status. */
+    async list(params) {
+        return this.client.request('/v1/subscriptions', { params });
+    }
+    /** Pause an active subscription (optionally with a scheduled resume date). */
+    async pause(id, body) {
+        return this.client.request(`/v1/subscriptions/${id}/pause`, {
+            method: 'POST',
+            body: body || {},
+        });
+    }
+    /** Resume a previously paused subscription. */
+    async resume(id) {
+        return this.client.request(`/v1/subscriptions/${id}/resume`, {
+            method: 'POST',
+        });
+    }
+    /** Change plans with a durable proration credit and idempotency key. */
+    async changePlan(id, planId, idempotencyKey) {
+        return this.client.request(`/v1/subscriptions/${id}/change-plan`, {
+            method: 'POST',
+            body: { plan_id: planId },
+            idempotencyKey,
+        });
+    }
+    /** Cancel an active subscription. */
+    async cancel(id) {
+        return this.client.request(`/v1/subscriptions/${id}/cancel`, {
+            method: 'POST',
+        });
+    }
+}
+exports.SubscriptionsResource = SubscriptionsResource;

package/dist/resources/totp.d.ts

@@ -0,0 +1,36 @@
+import { HttpClient } from '../http';
+export interface TotpSetup {
+    qr_code_data_url: string;
+    secret: string;
+    setup_instructions: string;
+}
+export interface TotpStatus {
+    enabled: boolean;
+}
+export interface TotpChallengeResult {
+    token: string;
+    refresh_token: string;
+    merchant: Record<string, unknown>;
+    admin?: boolean;
+}
+export declare class TotpResource {
+    private client;
+    constructor(client: HttpClient);
+    /** Start 2FA setup — returns a QR code and secret to scan into an authenticator app. */
+    setup(): Promise<TotpSetup>;
+    /** Verify a TOTP code to complete setup and enable 2FA. */
+    verify(code: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /** Disable 2FA (requires a valid TOTP code). */
+    disable(code: string): Promise<{
+        success: boolean;
+        message: string;
+    }>;
+    /** Check whether 2FA is enabled on the account. */
+    status(): Promise<TotpStatus>;
+    /** Submit a TOTP code during login challenge to complete authentication. */
+    submitChallenge(tempToken: string, code: string): Promise<TotpChallengeResult>;
+}
+//# sourceMappingURL=totp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"totp.d.ts","sourceRoot":"","sources":["../../src/resources/totp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAErC,MAAM,WAAW,SAAS;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAEtC,wFAAwF;IAClF,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC;IAMjC,2DAA2D;IACrD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAO1E,gDAAgD;IAC1C,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAO3E,mDAAmD;IAC7C,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC;IAInC,4EAA4E;IACtE,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAMrF"}

package/dist/resources/totp.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TotpResource = void 0;
+class TotpResource {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /** Start 2FA setup — returns a QR code and secret to scan into an authenticator app. */
+    async setup() {
+        return this.client.request('/v1/auth/2fa/setup', {
+            method: 'POST',
+        });
+    }
+    /** Verify a TOTP code to complete setup and enable 2FA. */
+    async verify(code) {
+        return this.client.request('/v1/auth/2fa/verify', {
+            method: 'POST',
+            body: { code },
+        });
+    }
+    /** Disable 2FA (requires a valid TOTP code). */
+    async disable(code) {
+        return this.client.request('/v1/auth/2fa/disable', {
+            method: 'POST',
+            body: { code },
+        });
+    }
+    /** Check whether 2FA is enabled on the account. */
+    async status() {
+        return this.client.request('/v1/auth/2fa/status');
+    }
+    /** Submit a TOTP code during login challenge to complete authentication. */
+    async submitChallenge(tempToken, code) {
+        return this.client.request('/v1/auth/2fa/challenge', {
+            method: 'POST',
+            body: { temp_token: tempToken, code },
+        });
+    }
+}
+exports.TotpResource = TotpResource;

package/dist/resources/wallets.d.ts

@@ -0,0 +1,128 @@
+import { HttpClient } from '../http';
+export interface CustomerWallet {
+    id: string;
+    merchant_id: string;
+    app_id: string;
+    customer_id: string;
+    currency: string;
+    balance: number;
+    paid_credits: number;
+    granted_credits: number;
+    status: 'active' | 'terminated';
+    expires_at: string | null;
+    terminated_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+export interface CustomerWalletTransaction {
+    id: string;
+    wallet_id: string;
+    merchant_id: string;
+    app_id: string;
+    customer_id: string;
+    source_type: 'api_credit' | 'checkout_topup' | 'usage_deduction' | 'adjustment' | 'refund' | 'expiration';
+    transaction_id: string | null;
+    billing_event_id: string | null;
+    entry_type: 'credit' | 'debit';
+    amount: number;
+    balance_after: number;
+    credit_type: 'paid' | 'granted' | null;
+    description: string;
+    metadata: Record<string, unknown>;
+    created_at: string;
+}
+export interface WalletCheckout {
+    session_id: string;
+    reference: string;
+    checkout_url: string;
+    authorization_url: string | null;
+    provider: string;
+    amount: number;
+    currency: string;
+    app_id: string;
+    expires_at: string;
+}
+export declare class WalletsResource {
+    private client;
+    constructor(client: HttpClient);
+    /** List customer wallets. Filter to a workspace with `app_id`. */
+    list(params?: {
+        app_id?: string;
+        limit?: number;
+        offset?: number;
+        status?: 'active' | 'terminated';
+    }): Promise<{
+        data: CustomerWallet[];
+        has_more: boolean;
+        total: number;
+    }>;
+    /** Fetch (or auto-create) a customer's wallet in a workspace. */
+    get(appId: string, customerId: string): Promise<CustomerWallet>;
+    /** Top up via API credit (immediate, source_type=api_credit). */
+    topup(appId: string, customerId: string, params: {
+        amount: number;
+        description?: string;
+        credit_type?: 'paid' | 'granted';
+        expires_at?: string | null;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        wallet: CustomerWallet;
+        transaction: CustomerWalletTransaction;
+    }>;
+    /** Mint a checkout for a wallet top-up. Payment credits the wallet via webhook (source_type=checkout_topup). */
+    createCheckout(appId: string, customerId: string, params: {
+        amount: number;
+        currency?: string;
+        success_url?: string;
+        cancel_url?: string;
+        customer_name?: string;
+    }): Promise<{
+        wallet: CustomerWallet;
+        checkout: WalletCheckout;
+    }>;
+    /**
+     * Debit the wallet to allow a platform action. Returns 402 when balance is
+     * insufficient — the caller should surface “top up your wallet”.
+     */
+    debit(appId: string, customerId: string, params: {
+        amount: number;
+        description?: string;
+        billing_event_id?: string | null;
+        metadata?: Record<string, unknown>;
+    }): Promise<{
+        wallet: CustomerWallet;
+        transaction: CustomerWalletTransaction;
+        allowed: boolean;
+        current_balance: number;
+    }>;
+    /** Dry-run allowance check without mutating the balance. */
+    check(appId: string, customerId: string, params: {
+        amount: number;
+    }): Promise<{
+        allowed: boolean;
+        current_balance: number;
+        required_amount: number;
+        wallet: CustomerWallet | null;
+        currency: string | null;
+    }>;
+    /** Wallet ledger history within a workspace. */
+    transactions(appId: string, customerId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        data: CustomerWalletTransaction[];
+        wallet: CustomerWallet | null;
+        has_more: boolean;
+    }>;
+    /** Export wallets as CSV (tenant-scoped, ≤10k). Filter to a workspace with `app_id`. */
+    exportCsv(params?: {
+        app_id?: string;
+        status?: 'active' | 'terminated';
+        search?: string;
+    }): Promise<string>;
+    /** Export a customer's wallet ledger as CSV (≤10k). */
+    exportLedgerCsv(appId: string, customerId: string): Promise<string>;
+    /** Terminate the wallet — no further credits or debits. */
+    terminate(appId: string, customerId: string): Promise<CustomerWallet>;
+}
+//# sourceMappingURL=wallets.d.ts.map

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

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