@pubflow/core 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -2,6 +2,25 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.3.1] - 2025-10-25
+
+### Added
+- Added `PubflowConfig` as type alias for `PubflowInstanceConfig` (backward compatibility)
+- Added `validateOnStartup` field to `SessionConfig` interface (React Native support)
+- Added alternative field names to `PaginationMeta` interface:
+  - `page` (alternative to `currentPage`)
+  - `limit` (alternative to `perPage`)
+  - `total` (alternative to `totalItems`)
+  - `hasMore` (React Native compatibility)
+
+### Changed
+- Made all `PaginationMeta` fields optional for maximum flexibility
+- Updated documentation to reflect both naming conventions
+
+### Fixed
+- Fixed TypeScript compilation errors in `@pubflow/react-native` package
+- Fixed missing exports for React Native compatibility
+
 ## [0.3.0] - 2025-10-25
 
 ### Added

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

@@ -12,7 +12,10 @@ export * from './config';
 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 { 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,301 @@
+/**
+ * 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 } 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>;
+}

package/dist/payments/client.js

@@ -0,0 +1,477 @@
+"use strict";
+/**
+ * Bridge Payment Client
+ *
+ * Client for interacting with Bridge Payments API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BridgePaymentClient = void 0;
+const client_1 = require("../api/client");
+const adapter_1 = require("../storage/adapter");
+/**
+ * Bridge Payment Client
+ *
+ * Provides a simple interface for interacting with Bridge Payments API
+ */
+class BridgePaymentClient {
+    /**
+     * Create a new Bridge Payment Client
+     *
+     * @param config Client configuration
+     */
+    constructor(config) {
+        this.baseUrl = config.baseUrl;
+        this.guestToken = config.guestToken;
+        this.organizationId = config.organizationId;
+        // Create API client with Pubflow configuration
+        this.apiClient = new client_1.ApiClient({
+            id: config.instanceId || 'bridge-payments',
+            baseUrl: config.baseUrl,
+            headers: config.headers || {},
+            storageConfig: {
+                prefix: 'pubflow',
+                sessionKey: 'session_id'
+            }
+        }, config.storage || new adapter_1.MemoryStorageAdapter());
+    }
+    /**
+     * 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
+     */
+    async request(endpoint, method, body, options) {
+        const requestOptions = {
+            headers: {},
+            includeSession: true,
+            ...options,
+        };
+        // 1. Guest Token (if available) - Uses X-Guest-Token header
+        if (this.guestToken || (options === null || options === void 0 ? void 0 : options.guestToken)) {
+            const token = (options === null || options === void 0 ? void 0 : options.guestToken) || this.guestToken;
+            if (token) {
+                requestOptions.headers['X-Guest-Token'] = token;
+                requestOptions.includeSession = false; // Don't include session for guests
+            }
+        }
+        // 2. Organization ID (if available) - Included in body
+        // ⚠️ NOTE: Only works in Subscriptions and Customers currently
+        // Addresses, Payments and Payment Methods have organization_id hardcoded to null in backend
+        if (body && (this.organizationId || (options === null || options === void 0 ? void 0 : options.organizationId))) {
+            const orgId = (options === null || options === void 0 ? void 0 : options.organizationId) || this.organizationId;
+            // Only include organization_id in endpoints that support it
+            if (endpoint.includes('/subscriptions') || endpoint.includes('/customers')) {
+                body.organization_id = orgId;
+            }
+            // For other endpoints, backend ignores it (hardcoded null)
+            // When implemented in backend, it will work automatically
+        }
+        // 3. ApiClient automatically handles X-Session-ID for authenticated users
+        const response = await this.apiClient.request(`/bridge-payment${endpoint}`, method, body, requestOptions);
+        if (!response.success) {
+            throw new Error(response.error || 'Request failed');
+        }
+        return response.data;
+    }
+    // ============================================================================
+    // PAYMENT INTENTS
+    // ============================================================================
+    /**
+     * Create a payment intent
+     *
+     * @param data Payment intent data
+     * @param options Request options
+     * @returns Payment intent
+     */
+    async createPaymentIntent(data, options) {
+        return this.request('/payments/intents', 'POST', data, options);
+    }
+    /**
+     * Get a payment intent by ID
+     *
+     * @param id Payment intent ID
+     * @param options Request options
+     * @returns Payment intent
+     */
+    async getPaymentIntent(id, options) {
+        return this.request(`/payments/intents/${id}`, 'GET', undefined, options);
+    }
+    /**
+     * List payments
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of payments
+     */
+    async listPayments(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 = `/payments${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get a payment by ID
+     *
+     * @param id Payment ID
+     * @param options Request options
+     * @returns Payment
+     */
+    async getPayment(id, options) {
+        return this.request(`/payments/${id}`, 'GET', undefined, options);
+    }
+    // ============================================================================
+    // PAYMENT METHODS
+    // ============================================================================
+    /**
+     * List payment methods
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of payment methods
+     */
+    async listPaymentMethods(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 = `/payment-methods${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get a payment method by ID
+     *
+     * @param id Payment method ID
+     * @param options Request options
+     * @returns Payment method
+     */
+    async getPaymentMethod(id, options) {
+        return this.request(`/payment-methods/${id}`, 'GET', undefined, options);
+    }
+    /**
+     * Update a payment method
+     *
+     * @param id Payment method ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated payment method
+     */
+    async updatePaymentMethod(id, data, options) {
+        return this.request(`/payment-methods/${id}`, 'PUT', data, options);
+    }
+    /**
+     * Delete a payment method
+     *
+     * @param id Payment method ID
+     * @param options Request options
+     */
+    async deletePaymentMethod(id, options) {
+        await this.request(`/payment-methods/${id}`, 'DELETE', undefined, options);
+    }
+    // ============================================================================
+    // ADDRESSES
+    // ============================================================================
+    /**
+     * Create an address
+     *
+     * @param data Address data
+     * @param options Request options
+     * @returns Created address
+     */
+    async createAddress(data, options) {
+        return this.request('/addresses', 'POST', data, options);
+    }
+    /**
+     * List addresses
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of addresses
+     */
+    async listAddresses(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 = `/addresses${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get an address by ID
+     *
+     * @param id Address ID
+     * @param options Request options
+     * @returns Address
+     */
+    async getAddress(id, options) {
+        return this.request(`/addresses/${id}`, 'GET', undefined, options);
+    }
+    /**
+     * Update an address
+     *
+     * @param id Address ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated address
+     */
+    async updateAddress(id, data, options) {
+        return this.request(`/addresses/${id}`, 'PUT', data, options);
+    }
+    /**
+     * Delete an address
+     *
+     * @param id Address ID
+     * @param options Request options
+     */
+    async deleteAddress(id, options) {
+        await this.request(`/addresses/${id}`, 'DELETE', undefined, options);
+    }
+    // ============================================================================
+    // CUSTOMERS
+    // ============================================================================
+    /**
+     * Create a customer
+     *
+     * @param data Customer data
+     * @param options Request options
+     * @returns Created customer
+     */
+    async createCustomer(data, options) {
+        return this.request('/customers', 'POST', data, options);
+    }
+    /**
+     * List customers
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of customers
+     */
+    async listCustomers(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 = `/customers${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get a customer by ID
+     *
+     * @param id Customer ID
+     * @param options Request options
+     * @returns Customer
+     */
+    async getCustomer(id, options) {
+        return this.request(`/customers/${id}`, 'GET', undefined, options);
+    }
+    /**
+     * Update a customer
+     *
+     * @param id Customer ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated customer
+     */
+    async updateCustomer(id, data, options) {
+        return this.request(`/customers/${id}`, 'PUT', data, options);
+    }
+    /**
+     * Delete a customer
+     *
+     * @param id Customer ID
+     * @param options Request options
+     */
+    async deleteCustomer(id, options) {
+        await this.request(`/customers/${id}`, 'DELETE', undefined, options);
+    }
+    // ============================================================================
+    // SUBSCRIPTIONS
+    // ============================================================================
+    /**
+     * Create a subscription
+     *
+     * @param data Subscription data
+     * @param options Request options
+     * @returns Created subscription
+     */
+    async createSubscription(data, options) {
+        return this.request('/subscriptions', 'POST', data, options);
+    }
+    /**
+     * List subscriptions
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of subscriptions
+     */
+    async listSubscriptions(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 = `/subscriptions${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get a subscription by ID
+     *
+     * @param id Subscription ID
+     * @param options Request options
+     * @returns Subscription
+     */
+    async getSubscription(id, options) {
+        return this.request(`/subscriptions/${id}`, 'GET', undefined, options);
+    }
+    /**
+     * Cancel a subscription
+     *
+     * @param id Subscription ID
+     * @param data Cancel data
+     * @param options Request options
+     * @returns Canceled subscription
+     */
+    async cancelSubscription(id, data, options) {
+        return this.request(`/subscriptions/${id}/cancel`, 'POST', data, options);
+    }
+    // ============================================================================
+    // ORGANIZATIONS
+    // ============================================================================
+    /**
+     * Create an organization
+     *
+     * @param data Organization data
+     * @param options Request options
+     * @returns Created organization
+     */
+    async createOrganization(data, options) {
+        return this.request('/organizations', 'POST', data, options);
+    }
+    /**
+     * List organizations
+     *
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of organizations
+     */
+    async listOrganizations(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 = `/organizations${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Get an organization by ID
+     *
+     * @param id Organization ID
+     * @param options Request options
+     * @returns Organization
+     */
+    async getOrganization(id, options) {
+        return this.request(`/organizations/${id}`, 'GET', undefined, options);
+    }
+    /**
+     * Update an organization
+     *
+     * @param id Organization ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated organization
+     */
+    async updateOrganization(id, data, options) {
+        return this.request(`/organizations/${id}`, 'PUT', data, options);
+    }
+    /**
+     * Delete an organization
+     *
+     * @param id Organization ID
+     * @param options Request options
+     */
+    async deleteOrganization(id, options) {
+        await this.request(`/organizations/${id}`, 'DELETE', undefined, options);
+    }
+    /**
+     * List organization members
+     *
+     * @param organizationId Organization ID
+     * @param params Pagination parameters
+     * @param options Request options
+     * @returns List of organization members
+     */
+    async listOrganizationMembers(organizationId, 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 = `/organizations/${organizationId}/members${queryParams.toString() ? `?${queryParams.toString()}` : ''}`;
+        return this.request(endpoint, 'GET', undefined, options);
+    }
+    /**
+     * Add an organization member
+     *
+     * @param organizationId Organization ID
+     * @param data Member data
+     * @param options Request options
+     * @returns Added member
+     */
+    async addOrganizationMember(organizationId, data, options) {
+        return this.request(`/organizations/${organizationId}/members`, 'POST', data, options);
+    }
+    /**
+     * Update an organization member role
+     *
+     * @param organizationId Organization ID
+     * @param memberId Member ID
+     * @param data Update data
+     * @param options Request options
+     * @returns Updated member
+     */
+    async updateOrganizationMemberRole(organizationId, memberId, data, options) {
+        return this.request(`/organizations/${organizationId}/members/${memberId}`, 'PUT', data, options);
+    }
+    /**
+     * Remove an organization member
+     *
+     * @param organizationId Organization ID
+     * @param memberId Member ID
+     * @param options Request options
+     */
+    async removeOrganizationMember(organizationId, memberId, options) {
+        await this.request(`/organizations/${organizationId}/members/${memberId}`, 'DELETE', undefined, options);
+    }
+    /**
+     * Leave an organization
+     *
+     * @param organizationId Organization ID
+     * @param options Request options
+     */
+    async leaveOrganization(organizationId, options) {
+        await this.request(`/organizations/${organizationId}/leave`, 'POST', undefined, options);
+    }
+    // ============================================================================
+    // GUEST CONVERSION
+    // ============================================================================
+    /**
+     * Convert guest to user
+     *
+     * @param data Conversion data
+     * @param options Request options
+     * @returns Conversion result
+     */
+    async convertGuestToUser(data, options) {
+        return this.request('/guest/convert', 'POST', data, options);
+    }
+}
+exports.BridgePaymentClient = BridgePaymentClient;

package/dist/payments/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Bridge Payments Module
+ *
+ * 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';

package/dist/payments/index.js

@@ -0,0 +1,11 @@
+"use strict";
+/**
+ * Bridge Payments Module
+ *
+ * Exports for Bridge Payments client and types
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BridgePaymentClient = void 0;
+// Export client
+var client_1 = require("./client");
+Object.defineProperty(exports, "BridgePaymentClient", { enumerable: true, get: function () { return client_1.BridgePaymentClient; } });

package/dist/payments/types.d.ts

@@ -0,0 +1,384 @@
+/**
+ * Bridge Payments Types
+ *
+ * TypeScript interfaces for Bridge Payments API
+ */
+import { RequestOptions } from '../api/types';
+/**
+ * Configuration for Bridge Payment Client
+ */
+export interface BridgePaymentConfig {
+    /**
+     * Base URL of the Bridge Payments instance
+     * Example: 'https://your-instance.pubflow.com'
+     */
+    baseUrl: string;
+    /**
+     * Guest token (optional)
+     * If provided, all requests will use X-Guest-Token header
+     */
+    guestToken?: string;
+    /**
+     * Organization ID (optional)
+     *
+     * ✅ SUPPORTED IN:
+     * - Subscriptions (complete)
+     * - Customers (complete)
+     *
+     * ⚠️ NOT SUPPORTED IN (backend hardcoded null):
+     * - Addresses
+     * - Payments (partial - only customers)
+     * - Payment Methods
+     *
+     * The client is prepared for when the backend is updated.
+     */
+    organizationId?: string;
+    /**
+     * Pubflow instance ID (optional)
+     * Default: 'bridge-payments'
+     */
+    instanceId?: string;
+    /**
+     * Custom headers (optional)
+     */
+    headers?: Record<string, string>;
+    /**
+     * Storage adapter (optional, uses Pubflow default)
+     */
+    storage?: any;
+}
+/**
+ * Request options for payment operations
+ */
+export interface PaymentRequestOptions extends RequestOptions {
+    /**
+     * Guest token for this specific request
+     * Overrides the client's guestToken
+     */
+    guestToken?: string;
+    /**
+     * Organization ID for this specific request
+     * Overrides the client's organizationId
+     */
+    organizationId?: string;
+}
+/**
+ * Request to create a payment intent
+ */
+export interface CreatePaymentIntentRequest {
+    total_cents?: number;
+    subtotal_cents?: number;
+    tax_cents?: number;
+    discount_cents?: number;
+    shipping_cents?: number;
+    currency: string;
+    provider_id: string;
+    description?: string;
+    concept?: string;
+    reference_code?: string;
+    category?: string;
+    guest_data?: {
+        email: string;
+        name: string;
+        phone?: string;
+    };
+    payment_method_id?: string;
+    save_payment_method?: boolean;
+    metadata?: Record<string, any>;
+}
+/**
+ * Payment Intent response
+ */
+export interface PaymentIntent {
+    id: string;
+    client_secret: string;
+    status: string;
+    total_cents: number;
+    currency: string;
+    provider_id: string;
+    user_id?: string;
+    guest_email?: string;
+    guest_token?: string;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Payment response
+ */
+export interface Payment {
+    id: string;
+    user_id?: string;
+    guest_email?: string;
+    provider_id: string;
+    provider_payment_id: string;
+    total_cents: number;
+    currency: string;
+    status: string;
+    description?: string;
+    metadata?: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Payment method type
+ */
+export type PaymentMethodType = 'card' | 'bank_account' | 'paypal' | 'apple_pay' | 'google_pay';
+/**
+ * Payment Method response
+ */
+export interface PaymentMethod {
+    id: string;
+    user_id?: string;
+    guest_email?: string;
+    organization_id?: string;
+    provider_id: string;
+    provider_payment_method_id: string;
+    type: PaymentMethodType;
+    last4?: string;
+    brand?: string;
+    exp_month?: number;
+    exp_year?: number;
+    alias?: string;
+    is_default: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Request to update a payment method
+ */
+export interface UpdatePaymentMethodRequest {
+    alias?: string;
+    is_default?: boolean;
+}
+/**
+ * Address type
+ */
+export type AddressType = 'billing' | 'shipping';
+/**
+ * Address response
+ */
+export interface Address {
+    id: string;
+    user_id?: string;
+    guest_email?: string;
+    organization_id?: string;
+    address_type: AddressType;
+    name: string;
+    line1: string;
+    line2?: string;
+    city: string;
+    state?: string;
+    postal_code: string;
+    country: string;
+    phone?: string;
+    is_default: boolean;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Request to create an address
+ */
+export interface CreateAddressRequest {
+    address_type: AddressType;
+    name: string;
+    line1: string;
+    line2?: string;
+    city: string;
+    state?: string;
+    postal_code: string;
+    country: string;
+    phone?: string;
+    is_default?: boolean;
+}
+/**
+ * Request to update an address
+ */
+export interface UpdateAddressRequest {
+    address_type?: AddressType;
+    name?: string;
+    line1?: string;
+    line2?: string;
+    city?: string;
+    state?: string;
+    postal_code?: string;
+    country?: string;
+    phone?: string;
+    is_default?: boolean;
+}
+/**
+ * Customer response
+ */
+export interface Customer {
+    id: string;
+    user_id?: string;
+    guest_email?: string;
+    organization_id?: string;
+    provider_id: string;
+    provider_customer_id: string;
+    email: string;
+    name: string;
+    phone?: string;
+    metadata?: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Request to create a customer
+ */
+export interface CreateCustomerRequest {
+    email: string;
+    name: string;
+    phone?: string;
+    provider_id?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Request to update a customer
+ */
+export interface UpdateCustomerRequest {
+    email?: string;
+    name?: string;
+    phone?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Subscription status
+ */
+export type SubscriptionStatus = 'active' | 'canceled' | 'past_due' | 'unpaid' | 'incomplete' | 'trialing';
+/**
+ * Subscription response
+ */
+export interface Subscription {
+    id: string;
+    user_id?: string;
+    organization_id?: string;
+    customer_id: string;
+    product_id?: string;
+    provider_id: string;
+    provider_subscription_id: string;
+    status: SubscriptionStatus;
+    current_period_start: string;
+    current_period_end: string;
+    cancel_at_period_end: boolean;
+    canceled_at?: string;
+    metadata?: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Request to create a subscription
+ */
+export interface CreateSubscriptionRequest {
+    customer_id: string;
+    product_id?: string;
+    payment_method_id: string;
+    provider_id?: string;
+    trial_days?: number;
+    metadata?: Record<string, any>;
+}
+/**
+ * Request to cancel a subscription
+ */
+export interface CancelSubscriptionRequest {
+    cancel_at_period_end?: boolean;
+    reason?: string;
+}
+/**
+ * Organization role
+ */
+export type OrganizationRole = 'owner' | 'admin' | 'billing' | 'member';
+/**
+ * Organization response
+ */
+export interface Organization {
+    id: string;
+    name: string;
+    business_email?: string;
+    business_phone?: string;
+    tax_id?: string;
+    address?: string;
+    metadata?: Record<string, any>;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Request to create an organization
+ */
+export interface CreateOrganizationRequest {
+    name: string;
+    business_email?: string;
+    business_phone?: string;
+    tax_id?: string;
+    address?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Request to update an organization
+ */
+export interface UpdateOrganizationRequest {
+    name?: string;
+    business_email?: string;
+    business_phone?: string;
+    tax_id?: string;
+    address?: string;
+    metadata?: Record<string, any>;
+}
+/**
+ * Organization member response
+ */
+export interface OrganizationMember {
+    id: string;
+    organization_id: string;
+    user_id: string;
+    role: OrganizationRole;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Request to add an organization member
+ */
+export interface AddOrganizationMemberRequest {
+    email: string;
+    role: OrganizationRole;
+}
+/**
+ * Request to update an organization member role
+ */
+export interface UpdateOrganizationMemberRoleRequest {
+    role: OrganizationRole;
+}
+/**
+ * Request to convert guest to user
+ */
+export interface ConvertGuestToUserRequest {
+    guest_email: string;
+}
+/**
+ * Response from guest conversion
+ */
+export interface ConvertGuestToUserResponse {
+    success: boolean;
+    message: string;
+    payments_count: number;
+    payment_methods_count: number;
+    addresses_count: number;
+}
+/**
+ * Pagination parameters
+ */
+export interface PaginationParams {
+    page?: number;
+    limit?: number;
+}
+/**
+ * List response with pagination
+ */
+export interface ListResponse<T> {
+    data: T[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        hasMore: boolean;
+    };
+}

package/dist/payments/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Bridge Payments Types
+ *
+ * TypeScript interfaces for Bridge Payments API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types.d.ts

@@ -135,6 +135,10 @@ export interface SessionConfig {
      * Whether to validate session automatically
      */
     autoValidate?: boolean;
+    /**
+     * Whether to validate session on startup (React Native)
+     */
+    validateOnStartup?: boolean;
     /**
      * Session validation interval in milliseconds
      */
@@ -204,22 +208,46 @@ export interface PubflowInstanceConfig {
 }
 /**
  * Pagination metadata
+ *
+ * @version 0.3.1 - Made all fields optional for maximum flexibility
+ *
+ * Supports multiple naming conventions:
+ * - Standard: currentPage, totalPages, totalItems, perPage
+ * - Alternative: page, limit, total, hasMore (React Native compatibility)
+ *
+ * At least one set of fields should be provided.
  */
 export interface PaginationMeta {
     /**
-     * Current page number
+     * Current page number (standard format)
+     */
+    currentPage?: number;
+    /**
+     * Current page number (alternative format - React Native)
      */
-    currentPage: number;
+    page?: number;
     /**
      * Total number of pages
      */
-    totalPages: number;
+    totalPages?: number;
+    /**
+     * Total number of items (standard format)
+     */
+    totalItems?: number;
+    /**
+     * Total number of items (alternative format - React Native)
+     */
+    total?: number;
+    /**
+     * Number of items per page (standard format)
+     */
+    perPage?: number;
     /**
-     * Total number of items
+     * Number of items per page (alternative format - React Native)
      */
-    totalItems: number;
+    limit?: number;
     /**
-     * Number of items per page
+     * Whether there are more pages available (React Native)
      */
-    perPage: number;
+    hasMore?: boolean;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pubflow/core",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Core functionality for Pubflow framework",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",