@pubflow/core 0.4.0 → 0.4.1

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

@@ -382,3 +382,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.1",
   "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"
-}
+}