@pubflow/core 0.3.1 → 0.4.1

package/README.md

@@ -2,6 +2,12 @@
 
 Core functionality for the Pubflow framework.
 
+## 📚 Documentation
+
+- **Flowless (Authentication Backend)**: [https://flowless.dev/](https://flowless.dev/)
+- **Flowfull Client Libraries**: [https://clients.flowfull.dev/](https://clients.flowfull.dev/)
+- **Bridge Payments**: [https://bridgepayments.dev/](https://bridgepayments.dev/)
+
 ## Overview
 
 `@pubflow/core` provides the foundation for the Pubflow framework, including:
@@ -10,6 +16,7 @@ Core functionality for the Pubflow framework.
 - API client for making authenticated HTTP requests
 - Authentication service for user management and session handling
 - Bridge API service for standardized CRUD operations
+- **Bridge Payment Client** for payment processing (NEW in v0.4.0)
 - Schema validation using Zod
 - Storage adapter interface for different storage mechanisms
 - Utility functions for common tasks
@@ -161,4 +168,41 @@ const result = validateWithSchema(schemas.create, {
 if (!result.success) {
   console.error(result.errors);
 }
-```
+```
+
+### Bridge Payments (NEW in v0.4.0)
+
+```typescript
+import { BridgePaymentClient } from '@pubflow/core';
+
+// Create payment client
+const paymentClient = new BridgePaymentClient({
+  baseUrl: 'https://payments.example.com',
+  storage: new LocalStorageAdapter() // Optional, defaults to MemoryStorage
+});
+
+// Create payment intent
+const intent = await paymentClient.createPaymentIntent({
+  total_cents: 2000, // $20.00
+  currency: 'USD',
+  description: 'Premium Subscription',
+  provider_id: 'stripe'
+});
+
+// List payment methods
+const methods = await paymentClient.listPaymentMethods();
+
+// Create subscription
+const subscription = await paymentClient.createSubscription({
+  plan_id: 'plan_premium_monthly',
+  payment_method_id: 'pm_123'
+});
+
+// Manage organizations (multi-tenant)
+const org = await paymentClient.createOrganization({
+  name: 'Acme Corp',
+  email: 'billing@acme.com'
+});
+```
+
+For complete payment integration examples, see the [Bridge Payments documentation](https://bridgepayments.dev/).

package/dist/index.d.ts

@@ -17,3 +17,5 @@ export type { LoginCredentials, LoginResult, SessionValidationResult, SessionRef
 export { ApiClient } from './api/client';
 export { AuthService } from './auth/service';
 export { StorageAdapter } from './storage/adapter';
+export * from './payments';
+export { BridgePaymentClient } from './payments/client';

package/dist/index.js

@@ -19,7 +19,7 @@ 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.AuthService = exports.ApiClient = void 0;
+exports.BridgePaymentClient = exports.AuthService = exports.ApiClient = void 0;
 // Export API
 __exportStar(require("./api/client"), exports);
 __exportStar(require("./api/types"), exports);
@@ -40,3 +40,7 @@ Object.defineProperty(exports, "ApiClient", { enumerable: true, get: function ()
 // Export auth service
 var service_1 = require("./auth/service");
 Object.defineProperty(exports, "AuthService", { enumerable: true, get: function () { return service_1.AuthService; } });
+// Export Bridge Payments
+__exportStar(require("./payments"), exports);
+var client_2 = require("./payments/client");
+Object.defineProperty(exports, "BridgePaymentClient", { enumerable: true, get: function () { return client_2.BridgePaymentClient; } });

package/dist/payments/client.d.ts

@@ -0,0 +1,523 @@
+/**
+ * Bridge Payment Client
+ *
+ * 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, BillingSchedule, CreateBillingScheduleRequest, UpdateBillingScheduleRequest, BillingExecution, AccountBalance, CreateAccountBalanceRequest, UpdateAccountBalanceRequest, CreditBalanceRequest, DebitBalanceRequest, AccountTransaction, ProductCost, CreateProductCostRequest, UpdateProductCostRequest, OrderCost, CreateOrderCostRequest, TotalCostResponse } from './types';
+/**
+ * Bridge Payment Client
+ *
+ * Provides a simple interface for interacting with Bridge Payments API
+ */
+export declare class BridgePaymentClient {
+    private apiClient;
+    private guestToken?;
+    private organizationId?;
+    private baseUrl;
+    /**
+     * Create a new Bridge Payment Client
+     *
+     * @param config Client configuration
+     */
+    constructor(config: BridgePaymentConfig);
+    /**
+     * Make a request to the Bridge Payments API
+     *
+     * @param endpoint API endpoint
+     * @param method HTTP method
+     * @param body Request body
+     * @param options Request options
+     * @returns Response data
+     */
+    private request;
+    /**
+     * Create a payment intent
+     *
+     * @param data Payment intent data
+     * @param options Request options
+     * @returns Payment intent
+     */
+    createPaymentIntent(data: CreatePaymentIntentRequest, options?: PaymentRequestOptions): Promise<PaymentIntent>;
+    /**
+     * Get a payment intent by ID
+     *
+     * @param id Payment intent ID
+     * @param options Request options
+     * @returns Payment intent
+     */
+    getPaymentIntent(id: string, options?: PaymentRequestOptions): Promise<PaymentIntent>;
+    /**
+     * List payments
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of payments
+     */
+    listPayments(params?: PaginationParams, options?: PaymentRequestOptions): Promise<Payment[]>;
+    /**
+     * Get a payment by ID
+     *
+     * @param id Payment ID
+     * @param options Request options
+     * @returns Payment
+     */
+    getPayment(id: string, options?: PaymentRequestOptions): Promise<Payment>;
+    /**
+     * List payment methods
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of payment methods
+     */
+    listPaymentMethods(params?: PaginationParams, options?: PaymentRequestOptions): Promise<PaymentMethod[]>;
+    /**
+     * Get a payment method by ID
+     *
+     * @param id Payment method ID
+     * @param options Request options
+     * @returns Payment method
+     */
+    getPaymentMethod(id: string, options?: PaymentRequestOptions): Promise<PaymentMethod>;
+    /**
+     * Update a payment method
+     *
+     * @param id Payment method ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated payment method
+     */
+    updatePaymentMethod(id: string, data: UpdatePaymentMethodRequest, options?: PaymentRequestOptions): Promise<PaymentMethod>;
+    /**
+     * Delete a payment method
+     *
+     * @param id Payment method ID
+     * @param options Request options
+     */
+    deletePaymentMethod(id: string, options?: PaymentRequestOptions): Promise<void>;
+    /**
+     * Create an address
+     *
+     * @param data Address data
+     * @param options Request options
+     * @returns Created address
+     */
+    createAddress(data: CreateAddressRequest, options?: PaymentRequestOptions): Promise<Address>;
+    /**
+     * List addresses
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of addresses
+     */
+    listAddresses(params?: PaginationParams, options?: PaymentRequestOptions): Promise<Address[]>;
+    /**
+     * Get an address by ID
+     *
+     * @param id Address ID
+     * @param options Request options
+     * @returns Address
+     */
+    getAddress(id: string, options?: PaymentRequestOptions): Promise<Address>;
+    /**
+     * Update an address
+     *
+     * @param id Address ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated address
+     */
+    updateAddress(id: string, data: UpdateAddressRequest, options?: PaymentRequestOptions): Promise<Address>;
+    /**
+     * Delete an address
+     *
+     * @param id Address ID
+     * @param options Request options
+     */
+    deleteAddress(id: string, options?: PaymentRequestOptions): Promise<void>;
+    /**
+     * Create a customer
+     *
+     * @param data Customer data
+     * @param options Request options
+     * @returns Created customer
+     */
+    createCustomer(data: CreateCustomerRequest, options?: PaymentRequestOptions): Promise<Customer>;
+    /**
+     * List customers
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of customers
+     */
+    listCustomers(params?: PaginationParams, options?: PaymentRequestOptions): Promise<Customer[]>;
+    /**
+     * Get a customer by ID
+     *
+     * @param id Customer ID
+     * @param options Request options
+     * @returns Customer
+     */
+    getCustomer(id: string, options?: PaymentRequestOptions): Promise<Customer>;
+    /**
+     * Update a customer
+     *
+     * @param id Customer ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated customer
+     */
+    updateCustomer(id: string, data: UpdateCustomerRequest, options?: PaymentRequestOptions): Promise<Customer>;
+    /**
+     * Delete a customer
+     *
+     * @param id Customer ID
+     * @param options Request options
+     */
+    deleteCustomer(id: string, options?: PaymentRequestOptions): Promise<void>;
+    /**
+     * Create a subscription
+     *
+     * @param data Subscription data
+     * @param options Request options
+     * @returns Created subscription
+     */
+    createSubscription(data: CreateSubscriptionRequest, options?: PaymentRequestOptions): Promise<Subscription>;
+    /**
+     * List subscriptions
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of subscriptions
+     */
+    listSubscriptions(params?: PaginationParams, options?: PaymentRequestOptions): Promise<Subscription[]>;
+    /**
+     * Get a subscription by ID
+     *
+     * @param id Subscription ID
+     * @param options Request options
+     * @returns Subscription
+     */
+    getSubscription(id: string, options?: PaymentRequestOptions): Promise<Subscription>;
+    /**
+     * Cancel a subscription
+     *
+     * @param id Subscription ID
+     * @param data Cancel data
+     * @param options Request options
+     * @returns Canceled subscription
+     */
+    cancelSubscription(id: string, data?: CancelSubscriptionRequest, options?: PaymentRequestOptions): Promise<Subscription>;
+    /**
+     * Create an organization
+     *
+     * @param data Organization data
+     * @param options Request options
+     * @returns Created organization
+     */
+    createOrganization(data: CreateOrganizationRequest, options?: PaymentRequestOptions): Promise<Organization>;
+    /**
+     * List organizations
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of organizations
+     */
+    listOrganizations(params?: PaginationParams, options?: PaymentRequestOptions): Promise<Organization[]>;
+    /**
+     * Get an organization by ID
+     *
+     * @param id Organization ID
+     * @param options Request options
+     * @returns Organization
+     */
+    getOrganization(id: string, options?: PaymentRequestOptions): Promise<Organization>;
+    /**
+     * Update an organization
+     *
+     * @param id Organization ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated organization
+     */
+    updateOrganization(id: string, data: UpdateOrganizationRequest, options?: PaymentRequestOptions): Promise<Organization>;
+    /**
+     * Delete an organization
+     *
+     * @param id Organization ID
+     * @param options Request options
+     */
+    deleteOrganization(id: string, options?: PaymentRequestOptions): Promise<void>;
+    /**
+     * List organization members
+     *
+     * @param organizationId Organization ID
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of organization members
+     */
+    listOrganizationMembers(organizationId: string, params?: PaginationParams, options?: PaymentRequestOptions): Promise<OrganizationMember[]>;
+    /**
+     * Add an organization member
+     *
+     * @param organizationId Organization ID
+     * @param data Member data
+     * @param options Request options
+     * @returns Added member
+     */
+    addOrganizationMember(organizationId: string, data: AddOrganizationMemberRequest, options?: PaymentRequestOptions): Promise<OrganizationMember>;
+    /**
+     * Update an organization member role
+     *
+     * @param organizationId Organization ID
+     * @param memberId Member ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated member
+     */
+    updateOrganizationMemberRole(organizationId: string, memberId: string, data: UpdateOrganizationMemberRoleRequest, options?: PaymentRequestOptions): Promise<OrganizationMember>;
+    /**
+     * Remove an organization member
+     *
+     * @param organizationId Organization ID
+     * @param memberId Member ID
+     * @param options Request options
+     */
+    removeOrganizationMember(organizationId: string, memberId: string, options?: PaymentRequestOptions): Promise<void>;
+    /**
+     * Leave an organization
+     *
+     * @param organizationId Organization ID
+     * @param options Request options
+     */
+    leaveOrganization(organizationId: string, options?: PaymentRequestOptions): Promise<void>;
+    /**
+     * Convert guest to user
+     *
+     * @param data Conversion data
+     * @param options Request options
+     * @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>;
+}