@pubflow/core 0.4.0 → 0.4.2

package/dist/auth/two-factor.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Two-Factor Authentication Service
+ *
+ * Thin client over the multi-flowless /auth/two_factor/* endpoints.
+ * All network calls delegate to ApiClient so session cookies are
+ * forwarded automatically.
+ */
+import { ApiClient } from '../api/client';
+import { PubflowInstanceConfig } from '../types';
+import type { TwoFactorMethod, TwoFactorSystemInfo, TwoFactorStartResult, TwoFactorVerifyResult, TwoFactorSetupResult, TwoFactorToggleResult } from './types';
+export declare class TwoFactorService {
+    private apiClient;
+    private basePath;
+    constructor(apiClient: ApiClient, config: PubflowInstanceConfig);
+    /**
+     * GET /auth/two_factor/system
+     * Returns system-level 2FA availability (no auth needed).
+     */
+    getSystem(): Promise<TwoFactorSystemInfo>;
+    /**
+     * GET /auth/two_factor/methods
+     * Returns the authenticated user's configured 2FA methods.
+     */
+    getMethods(): Promise<TwoFactorMethod[]>;
+    /**
+     * POST /auth/two_factor/:method/setup
+     * Begin setup for a 2FA method (email or sms).
+     */
+    setup(method: string, identifier: string): Promise<TwoFactorSetupResult>;
+    /**
+     * POST /auth/two_factor/:method/start
+     * (Re-)send a verification code for an existing method.
+     * Accepts BOTH active and pending sessions (used during login flow).
+     */
+    start(methodId: string, method: string, action?: string): Promise<TwoFactorStartResult>;
+    /**
+     * POST /auth/two_factor/verify
+     * Verify a 2FA code. For action='login' the pending session becomes active.
+     */
+    verify(methodId: string, code: string, action?: string): Promise<TwoFactorVerifyResult>;
+    /**
+     * POST /auth/two_factor/toggle
+     * Enable or disable 2FA for the current user.
+     */
+    toggle(enabled: boolean, verificationCode?: string, verificationMethodId?: string): Promise<TwoFactorToggleResult>;
+    /**
+     * DELETE /auth/two_factor/:id
+     * Remove a 2FA method. Requires verification via another active method.
+     */
+    removeMethod(methodId: string, verificationCode: string, verificationMethodId: string): Promise<{
+        success: boolean;
+        message?: string;
+        error?: string;
+    }>;
+}

package/dist/auth/two-factor.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Two-Factor Authentication Service
+ *
+ * Thin client over the multi-flowless /auth/two_factor/* endpoints.
+ * All network calls delegate to ApiClient so session cookies are
+ * forwarded automatically.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TwoFactorService = void 0;
+class TwoFactorService {
+    constructor(apiClient, config) {
+        this.apiClient = apiClient;
+        this.basePath = `${config.authBasePath || '/auth'}/two_factor`;
+    }
+    // ─── Public (no auth) ──────────────────────────────────────────────────────
+    /**
+     * GET /auth/two_factor/system
+     * Returns system-level 2FA availability (no auth needed).
+     */
+    async getSystem() {
+        const res = await this.apiClient.get(`${this.basePath}/system`, { includeSession: false });
+        if (res.success && res.data)
+            return res.data;
+        return { global_two_factor_enabled: false, available_methods: [] };
+    }
+    // ─── User methods ──────────────────────────────────────────────────────────
+    /**
+     * GET /auth/two_factor/methods
+     * Returns the authenticated user's configured 2FA methods.
+     */
+    async getMethods() {
+        var _a;
+        const res = await this.apiClient.get(`${this.basePath}/methods`);
+        if (res.success && res.data)
+            return (_a = res.data.methods) !== null && _a !== void 0 ? _a : [];
+        return [];
+    }
+    // ─── Setup ────────────────────────────────────────────────────────────────
+    /**
+     * POST /auth/two_factor/:method/setup
+     * Begin setup for a 2FA method (email or sms).
+     */
+    async setup(method, identifier) {
+        const res = await this.apiClient.post(`${this.basePath}/${method}/setup`, { identifier });
+        if (res.success && res.data)
+            return res.data;
+        return { success: false, error: res.error || 'Setup failed' };
+    }
+    // ─── Start / Re-send ───────────────────────────────────────────────────────
+    /**
+     * POST /auth/two_factor/:method/start
+     * (Re-)send a verification code for an existing method.
+     * Accepts BOTH active and pending sessions (used during login flow).
+     */
+    async start(methodId, method, action = 'login') {
+        const res = await this.apiClient.post(`${this.basePath}/${method}/start`, { method_id: methodId, action });
+        if (res.success && res.data)
+            return res.data;
+        return { success: false, error: res.error || 'Failed to send code' };
+    }
+    // ─── Verify ───────────────────────────────────────────────────────────────
+    /**
+     * POST /auth/two_factor/verify
+     * Verify a 2FA code. For action='login' the pending session becomes active.
+     */
+    async verify(methodId, code, action = 'login') {
+        const res = await this.apiClient.post(`${this.basePath}/verify`, { method_id: methodId, code, action });
+        if (res.success && res.data)
+            return res.data;
+        // The server may return 400 with body even on wrong code — surface it
+        return {
+            success: false,
+            verified: false,
+            error: res.error || 'Verification failed',
+        };
+    }
+    // ─── Toggle ───────────────────────────────────────────────────────────────
+    /**
+     * POST /auth/two_factor/toggle
+     * Enable or disable 2FA for the current user.
+     */
+    async toggle(enabled, verificationCode, verificationMethodId) {
+        const res = await this.apiClient.post(`${this.basePath}/toggle`, {
+            two_factor_enabled: enabled,
+            ...(verificationCode && { verification_code: verificationCode }),
+            ...(verificationMethodId && { verification_method_id: verificationMethodId }),
+        });
+        if (res.success && res.data)
+            return res.data;
+        return { success: false, error: res.error || 'Toggle failed' };
+    }
+    // ─── Remove ───────────────────────────────────────────────────────────────
+    /**
+     * DELETE /auth/two_factor/:id
+     * Remove a 2FA method. Requires verification via another active method.
+     */
+    async removeMethod(methodId, verificationCode, verificationMethodId) {
+        const res = await this.apiClient.request(`${this.basePath}/${methodId}`, 'DELETE', {
+            verification_code: verificationCode,
+            verification_method_id: verificationMethodId,
+        });
+        if (res.success && res.data)
+            return res.data;
+        return { success: false, error: res.error || 'Remove failed' };
+    }
+}
+exports.TwoFactorService = TwoFactorService;

package/dist/auth/types.d.ts

@@ -30,7 +30,7 @@ export interface LoginResult {
      */
     success: boolean;
     /**
-     * User data (only present if success is true)
+     * User data (only present if success is true and 2FA is not required)
      */
     user?: User;
     /**
@@ -41,6 +41,16 @@ export interface LoginResult {
      * Error message (only present if success is false)
      */
     error?: string;
+    /**
+     * Whether 2FA verification is required to complete login.
+     * When true, the session is in "pending" status and must be
+     * activated via POST /auth/two_factor/verify.
+     */
+    requires2fa?: boolean;
+    /**
+     * Available 2FA methods the user has configured (present when requires2fa is true)
+     */
+    availableMethods?: TwoFactorMethod[];
 }
 /**
  * Result of a session validation
@@ -248,3 +258,67 @@ export interface RefreshResponse {
      */
     error?: string;
 }
+/**
+ * A 2FA method configured by the user
+ */
+export interface TwoFactorMethod {
+    id: string;
+    method: 'email' | 'sms' | 'totp' | string;
+    status: 'pending_setup' | 'active' | string;
+    identifier?: string | null;
+    last_used_at?: string | null;
+    created_at?: string;
+}
+/**
+ * System-level 2FA information (public endpoint)
+ */
+export interface TwoFactorSystemInfo {
+    global_two_factor_enabled: boolean;
+    available_methods: string[];
+}
+/**
+ * Result of starting a 2FA verification (sending a code)
+ */
+export interface TwoFactorStartResult {
+    success: boolean;
+    method?: string;
+    verification_sent?: boolean;
+    expires_in?: number;
+    message?: string;
+    error?: string;
+}
+/**
+ * Result of verifying a 2FA code
+ */
+export interface TwoFactorVerifyResult {
+    success: boolean;
+    verified?: boolean;
+    session_activated?: boolean;
+    expires_at?: string | null;
+    attempts_remaining?: number;
+    message?: string;
+    error?: string;
+}
+/**
+ * Result of setting up a new 2FA method
+ */
+export interface TwoFactorSetupResult {
+    success: boolean;
+    method_id?: string;
+    method?: string;
+    status?: string;
+    verification_sent?: boolean;
+    expires_in?: number;
+    message?: string;
+    error?: string;
+}
+/**
+ * Result of toggling 2FA for the user
+ */
+export interface TwoFactorToggleResult {
+    success: boolean;
+    two_factor_enabled?: boolean;
+    active_methods?: string[];
+    message?: string;
+    error?: string;
+}

package/dist/index.d.ts

@@ -6,6 +6,7 @@
 export * from './api/client';
 export * from './api/types';
 export * from './auth/service';
+export { TwoFactorService } from './auth/two-factor';
 export * from './bridge/service';
 export * from './bridge/types';
 export * from './config';
@@ -13,7 +14,7 @@ export * from './schema/validator';
 export * from './storage/adapter';
 export type { User, SessionConfig, StorageConfig, PubflowInstanceConfig, PaginationMeta } from './types';
 export type { PubflowInstanceConfig as PubflowConfig } from './types';
-export type { LoginCredentials, LoginResult, SessionValidationResult, SessionRefreshResult, RegistrationData, RegistrationResult, PasswordResetRequestData, PasswordResetData, AuthResponse, SessionResponse, ValidationResponse, RefreshResponse } from './auth/types';
+export type { LoginCredentials, LoginResult, SessionValidationResult, SessionRefreshResult, RegistrationData, RegistrationResult, PasswordResetRequestData, PasswordResetData, AuthResponse, SessionResponse, ValidationResponse, RefreshResponse, TwoFactorMethod, TwoFactorSystemInfo, TwoFactorStartResult, TwoFactorVerifyResult, TwoFactorSetupResult, TwoFactorToggleResult, } from './auth/types';
 export { ApiClient } from './api/client';
 export { AuthService } from './auth/service';
 export { StorageAdapter } from './storage/adapter';

package/dist/index.js

@@ -19,12 +19,14 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.BridgePaymentClient = exports.AuthService = exports.ApiClient = void 0;
+exports.BridgePaymentClient = exports.AuthService = exports.ApiClient = exports.TwoFactorService = void 0;
 // Export API
 __exportStar(require("./api/client"), exports);
 __exportStar(require("./api/types"), exports);
 // Export Auth
 __exportStar(require("./auth/service"), exports);
+var two_factor_1 = require("./auth/two-factor");
+Object.defineProperty(exports, "TwoFactorService", { enumerable: true, get: function () { return two_factor_1.TwoFactorService; } });
 // Export Bridge
 __exportStar(require("./bridge/service"), exports);
 __exportStar(require("./bridge/types"), exports);

package/dist/payments/client.d.ts

@@ -3,7 +3,7 @@
  *
  * Client for interacting with Bridge Payments API
  */
-import { BridgePaymentConfig, PaymentRequestOptions, CreatePaymentIntentRequest, PaymentIntent, Payment, PaymentMethod, UpdatePaymentMethodRequest, Address, CreateAddressRequest, UpdateAddressRequest, Customer, CreateCustomerRequest, UpdateCustomerRequest, Subscription, CreateSubscriptionRequest, CancelSubscriptionRequest, Organization, CreateOrganizationRequest, UpdateOrganizationRequest, OrganizationMember, AddOrganizationMemberRequest, UpdateOrganizationMemberRoleRequest, ConvertGuestToUserRequest, ConvertGuestToUserResponse, PaginationParams } from './types';
+import { BridgePaymentConfig, PaymentRequestOptions, CreatePaymentIntentRequest, PaymentIntent, Payment, PaymentMethod, UpdatePaymentMethodRequest, Address, CreateAddressRequest, UpdateAddressRequest, Customer, CreateCustomerRequest, UpdateCustomerRequest, Subscription, CreateSubscriptionRequest, CancelSubscriptionRequest, Organization, CreateOrganizationRequest, UpdateOrganizationRequest, OrganizationMember, AddOrganizationMemberRequest, UpdateOrganizationMemberRoleRequest, ConvertGuestToUserRequest, ConvertGuestToUserResponse, PaginationParams, BillingSchedule, CreateBillingScheduleRequest, UpdateBillingScheduleRequest, BillingExecution, AccountBalance, CreateAccountBalanceRequest, UpdateAccountBalanceRequest, CreditBalanceRequest, DebitBalanceRequest, AccountTransaction, ProductCost, CreateProductCostRequest, UpdateProductCostRequest, OrderCost, CreateOrderCostRequest, TotalCostResponse } from './types';
 /**
  * Bridge Payment Client
  *
@@ -298,4 +298,226 @@ export declare class BridgePaymentClient {
      * @returns Conversion result
      */
     convertGuestToUser(data: ConvertGuestToUserRequest, options?: PaymentRequestOptions): Promise<ConvertGuestToUserResponse>;
+    /**
+     * List my billing schedules
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of billing schedules
+     */
+    listMySchedules(params?: PaginationParams, options?: PaymentRequestOptions): Promise<BillingSchedule[]>;
+    /**
+     * Get a billing schedule by ID
+     *
+     * @param id Schedule ID
+     * @param options Request options
+     * @returns Billing schedule
+     */
+    getSchedule(id: string, options?: PaymentRequestOptions): Promise<BillingSchedule>;
+    /**
+     * Create a billing schedule
+     *
+     * @param data Schedule data
+     * @param options Request options
+     * @returns Created billing schedule
+     */
+    createSchedule(data: CreateBillingScheduleRequest, options?: PaymentRequestOptions): Promise<BillingSchedule>;
+    /**
+     * Update a billing schedule
+     *
+     * @param id Schedule ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated billing schedule
+     */
+    updateSchedule(id: string, data: UpdateBillingScheduleRequest, options?: PaymentRequestOptions): Promise<BillingSchedule>;
+    /**
+     * Pause a billing schedule
+     *
+     * @param id Schedule ID
+     * @param options Request options
+     * @returns Updated billing schedule
+     */
+    pauseSchedule(id: string, options?: PaymentRequestOptions): Promise<BillingSchedule>;
+    /**
+     * Resume a billing schedule
+     *
+     * @param id Schedule ID
+     * @param options Request options
+     * @returns Updated billing schedule
+     */
+    resumeSchedule(id: string, options?: PaymentRequestOptions): Promise<BillingSchedule>;
+    /**
+     * Delete a billing schedule
+     *
+     * @param id Schedule ID
+     * @param options Request options
+     */
+    deleteSchedule(id: string, options?: PaymentRequestOptions): Promise<void>;
+    /**
+     * Get execution history for a billing schedule
+     *
+     * @param id Schedule ID
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of billing executions
+     */
+    getScheduleExecutions(id: string, params?: PaginationParams, options?: PaymentRequestOptions): Promise<BillingExecution[]>;
+    /**
+     * List my account balances
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of account balances
+     */
+    listMyBalances(params?: PaginationParams, options?: PaymentRequestOptions): Promise<AccountBalance[]>;
+    /**
+     * Get an account balance by ID
+     *
+     * @param id Balance ID
+     * @param options Request options
+     * @returns Account balance
+     */
+    getBalance(id: string, options?: PaymentRequestOptions): Promise<AccountBalance>;
+    /**
+     * Create an account balance
+     *
+     * @param data Balance data
+     * @param options Request options
+     * @returns Created account balance
+     */
+    createBalance(data: CreateAccountBalanceRequest, options?: PaymentRequestOptions): Promise<AccountBalance>;
+    /**
+     * Credit an account balance
+     *
+     * @param id Balance ID
+     * @param data Credit data
+     * @param options Request options
+     * @returns Updated balance and transaction
+     */
+    creditBalance(id: string, data: CreditBalanceRequest, options?: PaymentRequestOptions): Promise<{
+        balance: AccountBalance;
+        transaction: AccountTransaction;
+    }>;
+    /**
+     * Debit an account balance
+     *
+     * @param id Balance ID
+     * @param data Debit data
+     * @param options Request options
+     * @returns Updated balance and transaction
+     */
+    debitBalance(id: string, data: DebitBalanceRequest, options?: PaymentRequestOptions): Promise<{
+        balance: AccountBalance;
+        transaction: AccountTransaction;
+    }>;
+    /**
+     * Update an account balance
+     *
+     * @param id Balance ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated account balance
+     */
+    updateBalance(id: string, data: UpdateAccountBalanceRequest, options?: PaymentRequestOptions): Promise<AccountBalance>;
+    /**
+     * Delete an account balance
+     *
+     * @param id Balance ID
+     * @param options Request options
+     */
+    deleteBalance(id: string, options?: PaymentRequestOptions): Promise<void>;
+    /**
+     * List my account transactions
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of account transactions
+     */
+    listMyTransactions(params?: PaginationParams, options?: PaymentRequestOptions): Promise<AccountTransaction[]>;
+    /**
+     * Get transactions for a specific balance
+     *
+     * @param id Balance ID
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of account transactions
+     */
+    getBalanceTransactions(id: string, params?: PaginationParams, options?: PaymentRequestOptions): Promise<AccountTransaction[]>;
+    /**
+     * Get all costs for a product
+     *
+     * @param productId Product ID
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of product costs
+     */
+    getProductCosts(productId: string, params?: PaginationParams, options?: PaymentRequestOptions): Promise<ProductCost[]>;
+    /**
+     * Get active cost for a product
+     *
+     * @param productId Product ID
+     * @param date Date to check (ISO 8601)
+     * @param options Request options
+     * @returns Active product cost
+     */
+    getActiveProductCost(productId: string, date?: string, options?: PaymentRequestOptions): Promise<ProductCost>;
+    /**
+     * Get total cost for a product
+     *
+     * @param productId Product ID
+     * @param date Date to check (ISO 8601)
+     * @param options Request options
+     * @returns Total cost response
+     */
+    getTotalProductCost(productId: string, date?: string, options?: PaymentRequestOptions): Promise<TotalCostResponse>;
+    /**
+     * Create a product cost
+     *
+     * @param data Product cost data
+     * @param options Request options
+     * @returns Created product cost
+     */
+    createProductCost(data: CreateProductCostRequest, options?: PaymentRequestOptions): Promise<ProductCost>;
+    /**
+     * Update a product cost
+     *
+     * @param id Cost ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated product cost
+     */
+    updateProductCost(id: string, data: UpdateProductCostRequest, options?: PaymentRequestOptions): Promise<ProductCost>;
+    /**
+     * Delete a product cost
+     *
+     * @param id Cost ID
+     * @param options Request options
+     */
+    deleteProductCost(id: string, options?: PaymentRequestOptions): Promise<void>;
+    /**
+     * Get all costs for an order
+     *
+     * @param orderId Order ID
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of order costs
+     */
+    getOrderCosts(orderId: string, params?: PaginationParams, options?: PaymentRequestOptions): Promise<OrderCost[]>;
+    /**
+     * Get total cost for an order
+     *
+     * @param orderId Order ID
+     * @param options Request options
+     * @returns Total cost response
+     */
+    getTotalOrderCost(orderId: string, options?: PaymentRequestOptions): Promise<TotalCostResponse>;
+    /**
+     * Create an order cost
+     *
+     * @param data Order cost data
+     * @param options Request options
+     * @returns Created order cost
+     */
+    createOrderCost(data: CreateOrderCostRequest, options?: PaymentRequestOptions): Promise<OrderCost>;
 }

package/dist/payments/client.js

@@ -473,5 +473,332 @@ class BridgePaymentClient {
     async convertGuestToUser(data, options) {
         return this.request('/guest/convert', 'POST', data, options);
     }
+    // ============================================================================
+    // BILLING SCHEDULES
+    // ============================================================================
+    /**
+     * List my billing schedules
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of billing schedules
+     */
+    async listMySchedules(params, options) {
+        const queryParams = new URLSearchParams();
+        if (params === null || params === void 0 ? void 0 : params.page)
+            queryParams.set('page', params.page.toString());
+        if (params === null || params === void 0 ? void 0 : params.limit)
+            queryParams.set('limit', params.limit.toString());
+        const endpoint = `/billing-schedules/me${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get a billing schedule by ID
+     *
+     * @param id Schedule ID
+     * @param options Request options
+     * @returns Billing schedule
+     */
+    async getSchedule(id, options) {
+        return this.request(`/billing-schedules/${id}`, 'GET', undefined, options);
+    }
+    /**
+     * Create a billing schedule
+     *
+     * @param data Schedule data
+     * @param options Request options
+     * @returns Created billing schedule
+     */
+    async createSchedule(data, options) {
+        return this.request('/billing-schedules', 'POST', data, options);
+    }
+    /**
+     * Update a billing schedule
+     *
+     * @param id Schedule ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated billing schedule
+     */
+    async updateSchedule(id, data, options) {
+        return this.request(`/billing-schedules/${id}`, 'PUT', data, options);
+    }
+    /**
+     * Pause a billing schedule
+     *
+     * @param id Schedule ID
+     * @param options Request options
+     * @returns Updated billing schedule
+     */
+    async pauseSchedule(id, options) {
+        return this.request(`/billing-schedules/${id}/pause`, 'POST', undefined, options);
+    }
+    /**
+     * Resume a billing schedule
+     *
+     * @param id Schedule ID
+     * @param options Request options
+     * @returns Updated billing schedule
+     */
+    async resumeSchedule(id, options) {
+        return this.request(`/billing-schedules/${id}/resume`, 'POST', undefined, options);
+    }
+    /**
+     * Delete a billing schedule
+     *
+     * @param id Schedule ID
+     * @param options Request options
+     */
+    async deleteSchedule(id, options) {
+        await this.request(`/billing-schedules/${id}`, 'DELETE', undefined, options);
+    }
+    /**
+     * Get execution history for a billing schedule
+     *
+     * @param id Schedule ID
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of billing executions
+     */
+    async getScheduleExecutions(id, params, options) {
+        const queryParams = new URLSearchParams();
+        if (params === null || params === void 0 ? void 0 : params.page)
+            queryParams.set('page', params.page.toString());
+        if (params === null || params === void 0 ? void 0 : params.limit)
+            queryParams.set('limit', params.limit.toString());
+        const endpoint = `/billing-schedules/${id}/executions${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    // ============================================================================
+    // ACCOUNT BALANCE
+    // ============================================================================
+    /**
+     * List my account balances
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of account balances
+     */
+    async listMyBalances(params, options) {
+        const queryParams = new URLSearchParams();
+        if (params === null || params === void 0 ? void 0 : params.page)
+            queryParams.set('page', params.page.toString());
+        if (params === null || params === void 0 ? void 0 : params.limit)
+            queryParams.set('limit', params.limit.toString());
+        const endpoint = `/account-balance/me/balances${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get an account balance by ID
+     *
+     * @param id Balance ID
+     * @param options Request options
+     * @returns Account balance
+     */
+    async getBalance(id, options) {
+        return this.request(`/account-balance/${id}`, 'GET', undefined, options);
+    }
+    /**
+     * Create an account balance
+     *
+     * @param data Balance data
+     * @param options Request options
+     * @returns Created account balance
+     */
+    async createBalance(data, options) {
+        return this.request('/account-balance', 'POST', data, options);
+    }
+    /**
+     * Credit an account balance
+     *
+     * @param id Balance ID
+     * @param data Credit data
+     * @param options Request options
+     * @returns Updated balance and transaction
+     */
+    async creditBalance(id, data, options) {
+        return this.request(`/account-balance/${id}/credit`, 'POST', data, options);
+    }
+    /**
+     * Debit an account balance
+     *
+     * @param id Balance ID
+     * @param data Debit data
+     * @param options Request options
+     * @returns Updated balance and transaction
+     */
+    async debitBalance(id, data, options) {
+        return this.request(`/account-balance/${id}/debit`, 'POST', data, options);
+    }
+    /**
+     * Update an account balance
+     *
+     * @param id Balance ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated account balance
+     */
+    async updateBalance(id, data, options) {
+        return this.request(`/account-balance/${id}`, 'PUT', data, options);
+    }
+    /**
+     * Delete an account balance
+     *
+     * @param id Balance ID
+     * @param options Request options
+     */
+    async deleteBalance(id, options) {
+        await this.request(`/account-balance/${id}`, 'DELETE', undefined, options);
+    }
+    /**
+     * List my account transactions
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of account transactions
+     */
+    async listMyTransactions(params, options) {
+        const queryParams = new URLSearchParams();
+        if (params === null || params === void 0 ? void 0 : params.page)
+            queryParams.set('page', params.page.toString());
+        if (params === null || params === void 0 ? void 0 : params.limit)
+            queryParams.set('limit', params.limit.toString());
+        const endpoint = `/account-balance/me/transactions${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get transactions for a specific balance
+     *
+     * @param id Balance ID
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of account transactions
+     */
+    async getBalanceTransactions(id, params, options) {
+        const queryParams = new URLSearchParams();
+        if (params === null || params === void 0 ? void 0 : params.page)
+            queryParams.set('page', params.page.toString());
+        if (params === null || params === void 0 ? void 0 : params.limit)
+            queryParams.set('limit', params.limit.toString());
+        const endpoint = `/account-balance/${id}/transactions${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    // ============================================================================
+    // COST TRACKING
+    // ============================================================================
+    /**
+     * Get all costs for a product
+     *
+     * @param productId Product ID
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of product costs
+     */
+    async getProductCosts(productId, params, options) {
+        const queryParams = new URLSearchParams();
+        if (params === null || params === void 0 ? void 0 : params.page)
+            queryParams.set('page', params.page.toString());
+        if (params === null || params === void 0 ? void 0 : params.limit)
+            queryParams.set('limit', params.limit.toString());
+        const endpoint = `/cost-tracking/products/${productId}/costs${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get active cost for a product
+     *
+     * @param productId Product ID
+     * @param date Date to check (ISO 8601)
+     * @param options Request options
+     * @returns Active product cost
+     */
+    async getActiveProductCost(productId, date, options) {
+        const queryParams = new URLSearchParams();
+        if (date)
+            queryParams.set('date', date);
+        const endpoint = `/cost-tracking/products/${productId}/costs/active${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get total cost for a product
+     *
+     * @param productId Product ID
+     * @param date Date to check (ISO 8601)
+     * @param options Request options
+     * @returns Total cost response
+     */
+    async getTotalProductCost(productId, date, options) {
+        const queryParams = new URLSearchParams();
+        if (date)
+            queryParams.set('date', date);
+        const endpoint = `/cost-tracking/products/${productId}/costs/total${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Create a product cost
+     *
+     * @param data Product cost data
+     * @param options Request options
+     * @returns Created product cost
+     */
+    async createProductCost(data, options) {
+        return this.request('/cost-tracking/products/costs', 'POST', data, options);
+    }
+    /**
+     * Update a product cost
+     *
+     * @param id Cost ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated product cost
+     */
+    async updateProductCost(id, data, options) {
+        return this.request(`/cost-tracking/products/costs/${id}`, 'PUT', data, options);
+    }
+    /**
+     * Delete a product cost
+     *
+     * @param id Cost ID
+     * @param options Request options
+     */
+    async deleteProductCost(id, options) {
+        await this.request(`/cost-tracking/products/costs/${id}`, 'DELETE', undefined, options);
+    }
+    /**
+     * Get all costs for an order
+     *
+     * @param orderId Order ID
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of order costs
+     */
+    async getOrderCosts(orderId, params, options) {
+        const queryParams = new URLSearchParams();
+        if (params === null || params === void 0 ? void 0 : params.page)
+            queryParams.set('page', params.page.toString());
+        if (params === null || params === void 0 ? void 0 : params.limit)
+            queryParams.set('limit', params.limit.toString());
+        const endpoint = `/cost-tracking/orders/${orderId}/costs${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get total cost for an order
+     *
+     * @param orderId Order ID
+     * @param options Request options
+     * @returns Total cost response
+     */
+    async getTotalOrderCost(orderId, options) {
+        return this.request(`/cost-tracking/orders/${orderId}/costs/total`, 'GET', undefined, options);
+    }
+    /**
+     * Create an order cost
+     *
+     * @param data Order cost data
+     * @param options Request options
+     * @returns Created order cost
+     */
+    async createOrderCost(data, options) {
+        return this.request('/cost-tracking/orders/costs', 'POST', data, options);
+    }
 }
 exports.BridgePaymentClient = BridgePaymentClient;

package/dist/payments/index.d.ts

@@ -4,4 +4,4 @@
  * Exports for Bridge Payments client and types
  */
 export { BridgePaymentClient } from './client';
-export type { BridgePaymentConfig, PaymentRequestOptions, CreatePaymentIntentRequest, PaymentIntent, Payment, PaymentMethodType, PaymentMethod, UpdatePaymentMethodRequest, AddressType, Address, CreateAddressRequest, UpdateAddressRequest, Customer, CreateCustomerRequest, UpdateCustomerRequest, SubscriptionStatus, Subscription, CreateSubscriptionRequest, CancelSubscriptionRequest, OrganizationRole, Organization, CreateOrganizationRequest, UpdateOrganizationRequest, OrganizationMember, AddOrganizationMemberRequest, UpdateOrganizationMemberRoleRequest, ConvertGuestToUserRequest, ConvertGuestToUserResponse, PaginationParams, ListResponse } from './types';
+export type { BridgePaymentConfig, PaymentRequestOptions, CreatePaymentIntentRequest, PaymentIntent, Payment, PaymentMethodType, PaymentMethod, UpdatePaymentMethodRequest, AddressType, Address, CreateAddressRequest, UpdateAddressRequest, Customer, CreateCustomerRequest, UpdateCustomerRequest, SubscriptionStatus, Subscription, CreateSubscriptionRequest, CancelSubscriptionRequest, OrganizationRole, Organization, CreateOrganizationRequest, UpdateOrganizationRequest, OrganizationMember, AddOrganizationMemberRequest, UpdateOrganizationMemberRoleRequest, ConvertGuestToUserRequest, ConvertGuestToUserResponse, PaginationParams, ListResponse, ScheduleType, IntervalType, BillingScheduleStatus, BillingSchedule, CreateBillingScheduleRequest, UpdateBillingScheduleRequest, BillingExecution, BalanceType, BalanceStatus, TransactionType, AccountBalance, CreateAccountBalanceRequest, UpdateAccountBalanceRequest, CreditBalanceRequest, DebitBalanceRequest, AccountTransaction, CostType, ProductCost, CreateProductCostRequest, UpdateProductCostRequest, OrderCost, CreateOrderCostRequest, TotalCostResponse } from './types';

package/dist/payments/types.d.ts

@@ -153,7 +153,7 @@ export interface UpdatePaymentMethodRequest {
 /**
  * Address type
  */
-export type AddressType = 'billing' | 'shipping';
+export type AddressType = 'billing' | 'shipping' | 'both';
 /**
  * Address response
  */
@@ -171,6 +171,7 @@ export interface Address {
     postal_code: string;
     country: string;
     phone?: string;
+    email?: string;
     is_default: boolean;
     created_at: string;
     updated_at: string;
@@ -188,6 +189,7 @@ export interface CreateAddressRequest {
     postal_code: string;
     country: string;
     phone?: string;
+    email?: string;
     is_default?: boolean;
 }
 /**
@@ -382,3 +384,268 @@ export interface ListResponse<T> {
         hasMore: boolean;
     };
 }
+/**
+ * Schedule type
+ */
+export type ScheduleType = 'subscription' | 'installment' | 'recurring_invoice' | 'custom';
+/**
+ * Interval type
+ */
+export type IntervalType = 'daily' | 'weekly' | 'monthly' | 'yearly' | 'custom';
+/**
+ * Billing schedule status
+ */
+export type BillingScheduleStatus = 'active' | 'paused' | 'completed' | 'failed' | 'canceled';
+/**
+ * Billing schedule response
+ */
+export interface BillingSchedule {
+    id: string;
+    user_id?: string;
+    organization_id?: string;
+    schedule_type: ScheduleType;
+    amount_cents: number;
+    currency: string;
+    interval_type: IntervalType;
+    interval_count: number;
+    next_billing_date: string;
+    end_date?: string;
+    max_occurrences?: number;
+    current_occurrence: number;
+    payment_method_id?: string;
+    account_balance_id?: string;
+    auto_charge: boolean;
+    send_invoice: boolean;
+    retry_on_failure: boolean;
+    max_retries: number;
+    status: BillingScheduleStatus;
+    last_billing_date?: string;
+    last_billing_status?: string;
+    description?: string;
+    metadata?: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Request to create a billing schedule
+ */
+export interface CreateBillingScheduleRequest {
+    user_id?: string;
+    organization_id?: string;
+    schedule_type: ScheduleType;
+    amount_cents: number;
+    currency?: string;
+    interval_type: IntervalType;
+    interval_count?: number;
+    next_billing_date: string;
+    end_date?: string;
+    max_occurrences?: number;
+    payment_method_id?: string;
+    account_balance_id?: string;
+    auto_charge?: boolean;
+    send_invoice?: boolean;
+    retry_on_failure?: boolean;
+    max_retries?: number;
+    description?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Request to update a billing schedule
+ */
+export interface UpdateBillingScheduleRequest {
+    amount_cents?: number;
+    next_billing_date?: string;
+    end_date?: string;
+    max_occurrences?: number;
+    payment_method_id?: string;
+    account_balance_id?: string;
+    auto_charge?: boolean;
+    send_invoice?: boolean;
+    retry_on_failure?: boolean;
+    max_retries?: number;
+    description?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Billing execution response
+ */
+export interface BillingExecution {
+    id: string;
+    billing_schedule_id: string;
+    execution_date: string;
+    amount_cents: number;
+    currency: string;
+    status: string;
+    payment_id?: string;
+    receipt_id?: string;
+    error_message?: string;
+    retry_count: number;
+    created_at: string;
+}
+/**
+ * Balance type
+ */
+export type BalanceType = 'general' | 'credits' | 'promotional' | 'refund';
+/**
+ * Balance status
+ */
+export type BalanceStatus = 'active' | 'suspended' | 'expired' | 'closed';
+/**
+ * Transaction type
+ */
+export type TransactionType = 'credit' | 'debit' | 'transfer' | 'expiration' | 'adjustment';
+/**
+ * Account balance response
+ */
+export interface AccountBalance {
+    id: string;
+    user_id?: string;
+    organization_id?: string;
+    customer_id?: string;
+    balance_cents: number;
+    currency: string;
+    balance_type: BalanceType;
+    reference_code?: string;
+    status: BalanceStatus;
+    expires_at?: string;
+    metadata?: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Request to create an account balance
+ */
+export interface CreateAccountBalanceRequest {
+    user_id?: string;
+    organization_id?: string;
+    customer_id?: string;
+    balance_type?: BalanceType;
+    balance_cents?: number;
+    currency?: string;
+    reference_code?: string;
+    expires_at?: string;
+    status?: BalanceStatus;
+    metadata?: Record<string, any>;
+}
+/**
+ * Request to update an account balance
+ */
+export interface UpdateAccountBalanceRequest {
+    status?: BalanceStatus;
+    expires_at?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Request to credit a balance
+ */
+export interface CreditBalanceRequest {
+    amount_cents: number;
+    description?: string;
+    reference_code?: string;
+}
+/**
+ * Request to debit a balance
+ */
+export interface DebitBalanceRequest {
+    amount_cents: number;
+    description?: string;
+    allow_negative?: boolean;
+}
+/**
+ * Account transaction response
+ */
+export interface AccountTransaction {
+    id: string;
+    account_balance_id: string;
+    transaction_type: TransactionType;
+    amount_cents: number;
+    balance_before_cents: number;
+    balance_after_cents: number;
+    currency: string;
+    description?: string;
+    reference_code?: string;
+    status: string;
+    metadata?: Record<string, any>;
+    created_at: string;
+}
+/**
+ * Cost type
+ */
+export type CostType = 'fixed' | 'per_unit' | 'per_hour' | 'percentage';
+/**
+ * Product cost response
+ */
+export interface ProductCost {
+    id: string;
+    product_id: string;
+    cost_type: CostType;
+    cost_cents: number;
+    currency: string;
+    effective_from: string;
+    effective_until?: string;
+    category?: string;
+    notes?: string;
+    metadata?: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Request to create a product cost
+ */
+export interface CreateProductCostRequest {
+    product_id: string;
+    cost_type: CostType;
+    cost_cents: number;
+    currency?: string;
+    effective_from?: string;
+    effective_until?: string;
+    category?: string;
+    notes?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Request to update a product cost
+ */
+export interface UpdateProductCostRequest {
+    cost_cents?: number;
+    effective_until?: string;
+    category?: string;
+    notes?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Order cost response
+ */
+export interface OrderCost {
+    id: string;
+    order_id: string;
+    cost_type: CostType;
+    cost_cents: number;
+    currency: string;
+    category?: string;
+    description?: string;
+    metadata?: Record<string, any>;
+    created_at: string;
+}
+/**
+ * Request to create an order cost
+ */
+export interface CreateOrderCostRequest {
+    order_id: string;
+    cost_type: CostType;
+    cost_cents: number;
+    currency?: string;
+    category?: string;
+    description?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Total cost response
+ */
+export interface TotalCostResponse {
+    product_id?: string;
+    order_id?: string;
+    total_cost_cents: number;
+    total_cost_dollars: number;
+    calculated_at?: string;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pubflow/core",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "Core functionality for Pubflow framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -43,4 +43,4 @@
     "url": "https://github.com/pubflow/core/issues"
   },
   "homepage": "https://github.com/pubflow/core#readme"
-}
+}