@digilogiclabs/saas-factory-payments 1.2.7 → 1.2.9

package/dist/{events-CMenJqgf.d.mts → events-Ba-jqIgC.d.mts}

@@ -517,4 +517,4 @@ type PaymentEvent = {
     error: PaymentError;
 };
 
-export { type ActiveSubscriptionStatus as A, type BillingAddress as B, type CheckoutParams as C, type StripeError as D, type Invoice as E, type PaymentError as F, type PaymentEvent as G, type InactiveSubscriptionStatus as I, type PricingPlan as P, SubscriptionStatus as S, type WebhookEvent as W, type PaymentsConfig as a, type PaymentProviderType as b, type CheckoutSession as c, type CustomerCreateParams as d, type Customer as e, type SubscriptionCreateParams as f, type Subscription as g, type SubscriptionUpdateParams as h, PaymentErrorType as i, PaymentsError as j, type PaymentMethod as k, type SubscriptionItem as l, type ProblematicSubscriptionStatus as m, type IncompleteSubscriptionStatus as n, ACTIVE_STATUSES as o, INACTIVE_STATUSES as p, PROBLEMATIC_STATUSES as q, INCOMPLETE_STATUSES as r, isActiveSubscription as s, isInactiveSubscription as t, isProblematicSubscription as u, isIncompleteSubscription as v, type CustomerUpdateParams as w, type StripeConfig as x, type CheckoutSessionParams as y, type PaymentIntentParams as z };
+export { type ActiveSubscriptionStatus as A, type BillingAddress as B, type CheckoutParams as C, type StripeError as D, type Invoice as E, type PaymentEvent as F, type PaymentError as G, type InactiveSubscriptionStatus as I, type PricingPlan as P, SubscriptionStatus as S, type WebhookEvent as W, type PaymentsConfig as a, type PaymentProviderType as b, type CheckoutSession as c, type CustomerCreateParams as d, type Customer as e, type SubscriptionCreateParams as f, type Subscription as g, type SubscriptionUpdateParams as h, PaymentErrorType as i, PaymentsError as j, type PaymentMethod as k, type SubscriptionItem as l, type ProblematicSubscriptionStatus as m, type IncompleteSubscriptionStatus as n, ACTIVE_STATUSES as o, INACTIVE_STATUSES as p, PROBLEMATIC_STATUSES as q, INCOMPLETE_STATUSES as r, isActiveSubscription as s, isInactiveSubscription as t, isProblematicSubscription as u, isIncompleteSubscription as v, type CustomerUpdateParams as w, type StripeConfig as x, type CheckoutSessionParams as y, type PaymentIntentParams as z };

package/dist/{events-CMenJqgf.d.ts → events-Ba-jqIgC.d.ts}

@@ -517,4 +517,4 @@ type PaymentEvent = {
     error: PaymentError;
 };
 
-export { type ActiveSubscriptionStatus as A, type BillingAddress as B, type CheckoutParams as C, type StripeError as D, type Invoice as E, type PaymentError as F, type PaymentEvent as G, type InactiveSubscriptionStatus as I, type PricingPlan as P, SubscriptionStatus as S, type WebhookEvent as W, type PaymentsConfig as a, type PaymentProviderType as b, type CheckoutSession as c, type CustomerCreateParams as d, type Customer as e, type SubscriptionCreateParams as f, type Subscription as g, type SubscriptionUpdateParams as h, PaymentErrorType as i, PaymentsError as j, type PaymentMethod as k, type SubscriptionItem as l, type ProblematicSubscriptionStatus as m, type IncompleteSubscriptionStatus as n, ACTIVE_STATUSES as o, INACTIVE_STATUSES as p, PROBLEMATIC_STATUSES as q, INCOMPLETE_STATUSES as r, isActiveSubscription as s, isInactiveSubscription as t, isProblematicSubscription as u, isIncompleteSubscription as v, type CustomerUpdateParams as w, type StripeConfig as x, type CheckoutSessionParams as y, type PaymentIntentParams as z };
+export { type ActiveSubscriptionStatus as A, type BillingAddress as B, type CheckoutParams as C, type StripeError as D, type Invoice as E, type PaymentEvent as F, type PaymentError as G, type InactiveSubscriptionStatus as I, type PricingPlan as P, SubscriptionStatus as S, type WebhookEvent as W, type PaymentsConfig as a, type PaymentProviderType as b, type CheckoutSession as c, type CustomerCreateParams as d, type Customer as e, type SubscriptionCreateParams as f, type Subscription as g, type SubscriptionUpdateParams as h, PaymentErrorType as i, PaymentsError as j, type PaymentMethod as k, type SubscriptionItem as l, type ProblematicSubscriptionStatus as m, type IncompleteSubscriptionStatus as n, ACTIVE_STATUSES as o, INACTIVE_STATUSES as p, PROBLEMATIC_STATUSES as q, INCOMPLETE_STATUSES as r, isActiveSubscription as s, isInactiveSubscription as t, isProblematicSubscription as u, isIncompleteSubscription as v, type CustomerUpdateParams as w, type StripeConfig as x, type CheckoutSessionParams as y, type PaymentIntentParams as z };

package/dist/index.d.mts

@@ -1,7 +1,81 @@
-import { P as PricingPlan, a as PaymentsConfig, S as SubscriptionStatus, b as PaymentProviderType, C as CheckoutParams, c as CheckoutSession, d as CustomerCreateParams, e as Customer, f as SubscriptionCreateParams, g as Subscription, h as SubscriptionUpdateParams, i as PaymentErrorType, j as PaymentsError, k as PaymentMethod } from './events-CMenJqgf.mjs';
-export { o as ACTIVE_STATUSES, A as ActiveSubscriptionStatus, B as BillingAddress, y as CheckoutSessionParams, w as CustomerUpdateParams, p as INACTIVE_STATUSES, r as INCOMPLETE_STATUSES, I as InactiveSubscriptionStatus, n as IncompleteSubscriptionStatus, E as Invoice, q as PROBLEMATIC_STATUSES, F as PaymentError, G as PaymentEvent, z as PaymentIntentParams, m as ProblematicSubscriptionStatus, x as StripeConfig, D as StripeError, l as SubscriptionItem, W as WebhookEvent, s as isActiveSubscription, t as isInactiveSubscription, v as isIncompleteSubscription, u as isProblematicSubscription } from './events-CMenJqgf.mjs';
-import { P as PaymentProvider } from './provider-C7F6btFU.mjs';
-export { b as PaymentsProviderActions, a as PaymentsProviderState, c as PaymentsStore } from './provider-C7F6btFU.mjs';
+import { ILogger, IMetrics, ICache } from '@digilogiclabs/platform-core';
+export { AccountCapabilities, AccountLink, AccountType, Address, Balance, BalanceAmount, BankAccountDetails, BillingDetails, BusinessProfile, CapturePaymentIntentOptions, CardBrand, CardDetails, ConfirmPaymentIntentOptions, ConnectedAccount, ConnectedAccountStatus, CreateAccountLinkOptions, CreateConnectedAccountOptions, CreateCustomerOptions, CreatePaymentIntentOptions, CreatePayoutOptions, CreateRefundOptions, CreateTransferOptions, Customer, IPayment, MemoryPayment, PaymentConfig, PaymentError, PaymentErrorCode, PaymentErrorMessages, PaymentEventType, PaymentIntent, PaymentMethod, PaymentMethodType, PaymentStatus, PaymentWebhookEvent, Payout, PayoutStatus, Refund, RefundReason, RefundStatus, StripePayment, StripePaymentConfig, TosAcceptance, Transfer, TransferStatus, UpdateCustomerOptions, UpdatePaymentIntentOptions, VerifyWebhookOptions, createPaymentError, formatAmount, generatePaymentId, isPaymentError } from '@digilogiclabs/platform-core';
+import { P as PricingPlan, a as PaymentsConfig, S as SubscriptionStatus, b as PaymentProviderType, C as CheckoutParams, c as CheckoutSession, d as CustomerCreateParams, e as Customer, f as SubscriptionCreateParams, g as Subscription, h as SubscriptionUpdateParams, i as PaymentErrorType, j as PaymentsError, k as PaymentMethod } from './events-Ba-jqIgC.mjs';
+export { o as ACTIVE_STATUSES, A as ActiveSubscriptionStatus, B as BillingAddress, y as CheckoutSessionParams, w as CustomerUpdateParams, p as INACTIVE_STATUSES, r as INCOMPLETE_STATUSES, I as InactiveSubscriptionStatus, n as IncompleteSubscriptionStatus, E as Invoice, q as PROBLEMATIC_STATUSES, F as PaymentEvent, z as PaymentIntentParams, m as ProblematicSubscriptionStatus, x as StripeConfig, D as StripeError, l as SubscriptionItem, W as WebhookEvent, s as isActiveSubscription, t as isInactiveSubscription, v as isIncompleteSubscription, u as isProblematicSubscription } from './events-Ba-jqIgC.mjs';
+import { P as PaymentProvider } from './provider-CrxmH4d_.mjs';
+export { b as PaymentsProviderActions, a as PaymentsProviderState, c as PaymentsStore } from './provider-CrxmH4d_.mjs';
+
+/**
+ * Platform Core Integration
+ *
+ * Optional integration with @digilogiclabs/platform-core for:
+ * - Logging (payment events, webhook processing)
+ * - Metrics (payment success/failure tracking, revenue metrics)
+ * - Cache (subscription status caching)
+ */
+
+interface PlatformServices {
+    logger?: ILogger;
+    metrics?: IMetrics;
+    cache?: ICache;
+}
+/**
+ * Set the platform services for payments package to use
+ *
+ * @example
+ * ```typescript
+ * import { createPlatform } from '@digilogiclabs/platform-core';
+ * import { setPlatform } from '@digilogiclabs/saas-factory-payments';
+ *
+ * const platform = createPlatform();
+ * setPlatform({
+ *   logger: platform.logger,
+ *   metrics: platform.metrics,
+ *   cache: platform.cache,
+ * });
+ * ```
+ */
+declare function setPlatform(services: PlatformServices): void;
+/**
+ * Clear platform services (useful for testing)
+ */
+declare function clearPlatform(): void;
+/**
+ * Check if platform services are configured
+ */
+declare function hasPlatform(): boolean;
+/**
+ * Log a payment event if logger is configured
+ */
+declare function logPaymentEvent(level: 'debug' | 'info' | 'warn' | 'error', message: string, meta?: Record<string, unknown>): void;
+/**
+ * Track a payment metric if metrics are configured
+ */
+declare function trackPaymentMetric(name: string, value?: number, tags?: Record<string, string | number | boolean>): void;
+/**
+ * Track payment revenue
+ */
+declare function trackRevenue(amount: number, currency: string, tags?: Record<string, string | number | boolean>): void;
+/**
+ * Cache subscription status
+ */
+declare function cacheSubscriptionStatus(customerId: string, status: string, ttl?: number): Promise<void>;
+/**
+ * Get cached subscription status
+ */
+declare function getCachedSubscriptionStatus(customerId: string): Promise<string | null>;
+/**
+ * Track webhook processing
+ */
+declare function trackWebhookEvent(eventType: string, success: boolean, duration?: number): void;
+/**
+ * Track checkout session
+ */
+declare function trackCheckoutSession(success: boolean, tags?: Record<string, string | number | boolean>): void;
+/**
+ * Track subscription events
+ */
+declare function trackSubscriptionEvent(event: 'created' | 'updated' | 'canceled' | 'renewed', tags?: Record<string, string | number | boolean>): void;
 
 declare const STRIPE_API_VERSION = "2023-10-16";
 declare const PAYMENT_METHODS: {
@@ -241,4 +315,4 @@ declare class MockPaymentProvider extends BasePaymentProvider implements Payment
     listSubscriptions(customerId: string, status?: SubscriptionStatus): Promise<Subscription[]>;
 }
 
-export { BILLING_INTERVALS, CHECKOUT_MODE, CURRENCY_SYMBOLS, CheckoutParams, CheckoutSession, Customer, CustomerCreateParams, DEFAULT_CURRENCY, ERROR_MESSAGES, type EnvironmentConfig, INVOICE_STATUS, MockPaymentProvider, PAYMENT_METHODS, PaymentErrorType, PaymentMethod, PaymentProvider, PaymentProviderFactory, PaymentProviderType, PaymentsConfig, PaymentsError, PricingPlan, STRIPE_API_VERSION, SUBSCRIPTION_STATUS, StripePaymentProvider, Subscription, SubscriptionCreateParams, SubscriptionStatus, SubscriptionUpdateParams, WEBHOOK_EVENTS, calculateTax, formatAmountWithTax, formatBillingInterval, formatCardBrand, formatCurrency, formatDate, formatPaymentMethodDisplay, formatPricingPlan, formatRelativeTime, formatSubscriptionStatus, formatTaxRate, formatTrialPeriod, getEnvironmentConfig, isClient, isDevelopment, isProduction, isServer, truncateText, validateAmount, validateCard, validateCurrentEnvironment, validateEmail, validateEnvironment, validatePaymentsConfig, validatePhoneNumber, validatePricingPlan, validateStripeId };
+export { BILLING_INTERVALS, CHECKOUT_MODE, CURRENCY_SYMBOLS, CheckoutParams, CheckoutSession, CustomerCreateParams, DEFAULT_CURRENCY, ERROR_MESSAGES, type EnvironmentConfig, INVOICE_STATUS, MockPaymentProvider, PAYMENT_METHODS, PaymentErrorType, PaymentProvider, PaymentProviderFactory, PaymentProviderType, PaymentsConfig, PaymentsError, PricingPlan, STRIPE_API_VERSION, SUBSCRIPTION_STATUS, StripePaymentProvider, Subscription, SubscriptionCreateParams, SubscriptionStatus, SubscriptionUpdateParams, WEBHOOK_EVENTS, cacheSubscriptionStatus, calculateTax, clearPlatform, formatAmountWithTax, formatBillingInterval, formatCardBrand, formatCurrency, formatDate, formatPaymentMethodDisplay, formatPricingPlan, formatRelativeTime, formatSubscriptionStatus, formatTaxRate, formatTrialPeriod, getCachedSubscriptionStatus, getEnvironmentConfig, hasPlatform, isClient, isDevelopment, isProduction, isServer, logPaymentEvent, setPlatform, trackCheckoutSession, trackPaymentMetric, trackRevenue, trackSubscriptionEvent, trackWebhookEvent, truncateText, validateAmount, validateCard, validateCurrentEnvironment, validateEmail, validateEnvironment, validatePaymentsConfig, validatePhoneNumber, validatePricingPlan, validateStripeId };

package/dist/index.d.ts

@@ -1,7 +1,81 @@
-import { P as PricingPlan, a as PaymentsConfig, S as SubscriptionStatus, b as PaymentProviderType, C as CheckoutParams, c as CheckoutSession, d as CustomerCreateParams, e as Customer, f as SubscriptionCreateParams, g as Subscription, h as SubscriptionUpdateParams, i as PaymentErrorType, j as PaymentsError, k as PaymentMethod } from './events-CMenJqgf.js';
-export { o as ACTIVE_STATUSES, A as ActiveSubscriptionStatus, B as BillingAddress, y as CheckoutSessionParams, w as CustomerUpdateParams, p as INACTIVE_STATUSES, r as INCOMPLETE_STATUSES, I as InactiveSubscriptionStatus, n as IncompleteSubscriptionStatus, E as Invoice, q as PROBLEMATIC_STATUSES, F as PaymentError, G as PaymentEvent, z as PaymentIntentParams, m as ProblematicSubscriptionStatus, x as StripeConfig, D as StripeError, l as SubscriptionItem, W as WebhookEvent, s as isActiveSubscription, t as isInactiveSubscription, v as isIncompleteSubscription, u as isProblematicSubscription } from './events-CMenJqgf.js';
-import { P as PaymentProvider } from './provider-DlAIraLE.js';
-export { b as PaymentsProviderActions, a as PaymentsProviderState, c as PaymentsStore } from './provider-DlAIraLE.js';
+import { ILogger, IMetrics, ICache } from '@digilogiclabs/platform-core';
+export { AccountCapabilities, AccountLink, AccountType, Address, Balance, BalanceAmount, BankAccountDetails, BillingDetails, BusinessProfile, CapturePaymentIntentOptions, CardBrand, CardDetails, ConfirmPaymentIntentOptions, ConnectedAccount, ConnectedAccountStatus, CreateAccountLinkOptions, CreateConnectedAccountOptions, CreateCustomerOptions, CreatePaymentIntentOptions, CreatePayoutOptions, CreateRefundOptions, CreateTransferOptions, Customer, IPayment, MemoryPayment, PaymentConfig, PaymentError, PaymentErrorCode, PaymentErrorMessages, PaymentEventType, PaymentIntent, PaymentMethod, PaymentMethodType, PaymentStatus, PaymentWebhookEvent, Payout, PayoutStatus, Refund, RefundReason, RefundStatus, StripePayment, StripePaymentConfig, TosAcceptance, Transfer, TransferStatus, UpdateCustomerOptions, UpdatePaymentIntentOptions, VerifyWebhookOptions, createPaymentError, formatAmount, generatePaymentId, isPaymentError } from '@digilogiclabs/platform-core';
+import { P as PricingPlan, a as PaymentsConfig, S as SubscriptionStatus, b as PaymentProviderType, C as CheckoutParams, c as CheckoutSession, d as CustomerCreateParams, e as Customer, f as SubscriptionCreateParams, g as Subscription, h as SubscriptionUpdateParams, i as PaymentErrorType, j as PaymentsError, k as PaymentMethod } from './events-Ba-jqIgC.js';
+export { o as ACTIVE_STATUSES, A as ActiveSubscriptionStatus, B as BillingAddress, y as CheckoutSessionParams, w as CustomerUpdateParams, p as INACTIVE_STATUSES, r as INCOMPLETE_STATUSES, I as InactiveSubscriptionStatus, n as IncompleteSubscriptionStatus, E as Invoice, q as PROBLEMATIC_STATUSES, F as PaymentEvent, z as PaymentIntentParams, m as ProblematicSubscriptionStatus, x as StripeConfig, D as StripeError, l as SubscriptionItem, W as WebhookEvent, s as isActiveSubscription, t as isInactiveSubscription, v as isIncompleteSubscription, u as isProblematicSubscription } from './events-Ba-jqIgC.js';
+import { P as PaymentProvider } from './provider-CsOkAYe8.js';
+export { b as PaymentsProviderActions, a as PaymentsProviderState, c as PaymentsStore } from './provider-CsOkAYe8.js';
+
+/**
+ * Platform Core Integration
+ *
+ * Optional integration with @digilogiclabs/platform-core for:
+ * - Logging (payment events, webhook processing)
+ * - Metrics (payment success/failure tracking, revenue metrics)
+ * - Cache (subscription status caching)
+ */
+
+interface PlatformServices {
+    logger?: ILogger;
+    metrics?: IMetrics;
+    cache?: ICache;
+}
+/**
+ * Set the platform services for payments package to use
+ *
+ * @example
+ * ```typescript
+ * import { createPlatform } from '@digilogiclabs/platform-core';
+ * import { setPlatform } from '@digilogiclabs/saas-factory-payments';
+ *
+ * const platform = createPlatform();
+ * setPlatform({
+ *   logger: platform.logger,
+ *   metrics: platform.metrics,
+ *   cache: platform.cache,
+ * });
+ * ```
+ */
+declare function setPlatform(services: PlatformServices): void;
+/**
+ * Clear platform services (useful for testing)
+ */
+declare function clearPlatform(): void;
+/**
+ * Check if platform services are configured
+ */
+declare function hasPlatform(): boolean;
+/**
+ * Log a payment event if logger is configured
+ */
+declare function logPaymentEvent(level: 'debug' | 'info' | 'warn' | 'error', message: string, meta?: Record<string, unknown>): void;
+/**
+ * Track a payment metric if metrics are configured
+ */
+declare function trackPaymentMetric(name: string, value?: number, tags?: Record<string, string | number | boolean>): void;
+/**
+ * Track payment revenue
+ */
+declare function trackRevenue(amount: number, currency: string, tags?: Record<string, string | number | boolean>): void;
+/**
+ * Cache subscription status
+ */
+declare function cacheSubscriptionStatus(customerId: string, status: string, ttl?: number): Promise<void>;
+/**
+ * Get cached subscription status
+ */
+declare function getCachedSubscriptionStatus(customerId: string): Promise<string | null>;
+/**
+ * Track webhook processing
+ */
+declare function trackWebhookEvent(eventType: string, success: boolean, duration?: number): void;
+/**
+ * Track checkout session
+ */
+declare function trackCheckoutSession(success: boolean, tags?: Record<string, string | number | boolean>): void;
+/**
+ * Track subscription events
+ */
+declare function trackSubscriptionEvent(event: 'created' | 'updated' | 'canceled' | 'renewed', tags?: Record<string, string | number | boolean>): void;
 
 declare const STRIPE_API_VERSION = "2023-10-16";
 declare const PAYMENT_METHODS: {
@@ -241,4 +315,4 @@ declare class MockPaymentProvider extends BasePaymentProvider implements Payment
     listSubscriptions(customerId: string, status?: SubscriptionStatus): Promise<Subscription[]>;
 }
 
-export { BILLING_INTERVALS, CHECKOUT_MODE, CURRENCY_SYMBOLS, CheckoutParams, CheckoutSession, Customer, CustomerCreateParams, DEFAULT_CURRENCY, ERROR_MESSAGES, type EnvironmentConfig, INVOICE_STATUS, MockPaymentProvider, PAYMENT_METHODS, PaymentErrorType, PaymentMethod, PaymentProvider, PaymentProviderFactory, PaymentProviderType, PaymentsConfig, PaymentsError, PricingPlan, STRIPE_API_VERSION, SUBSCRIPTION_STATUS, StripePaymentProvider, Subscription, SubscriptionCreateParams, SubscriptionStatus, SubscriptionUpdateParams, WEBHOOK_EVENTS, calculateTax, formatAmountWithTax, formatBillingInterval, formatCardBrand, formatCurrency, formatDate, formatPaymentMethodDisplay, formatPricingPlan, formatRelativeTime, formatSubscriptionStatus, formatTaxRate, formatTrialPeriod, getEnvironmentConfig, isClient, isDevelopment, isProduction, isServer, truncateText, validateAmount, validateCard, validateCurrentEnvironment, validateEmail, validateEnvironment, validatePaymentsConfig, validatePhoneNumber, validatePricingPlan, validateStripeId };
+export { BILLING_INTERVALS, CHECKOUT_MODE, CURRENCY_SYMBOLS, CheckoutParams, CheckoutSession, CustomerCreateParams, DEFAULT_CURRENCY, ERROR_MESSAGES, type EnvironmentConfig, INVOICE_STATUS, MockPaymentProvider, PAYMENT_METHODS, PaymentErrorType, PaymentProvider, PaymentProviderFactory, PaymentProviderType, PaymentsConfig, PaymentsError, PricingPlan, STRIPE_API_VERSION, SUBSCRIPTION_STATUS, StripePaymentProvider, Subscription, SubscriptionCreateParams, SubscriptionStatus, SubscriptionUpdateParams, WEBHOOK_EVENTS, cacheSubscriptionStatus, calculateTax, clearPlatform, formatAmountWithTax, formatBillingInterval, formatCardBrand, formatCurrency, formatDate, formatPaymentMethodDisplay, formatPricingPlan, formatRelativeTime, formatSubscriptionStatus, formatTaxRate, formatTrialPeriod, getCachedSubscriptionStatus, getEnvironmentConfig, hasPlatform, isClient, isDevelopment, isProduction, isServer, logPaymentEvent, setPlatform, trackCheckoutSession, trackPaymentMetric, trackRevenue, trackSubscriptionEvent, trackWebhookEvent, truncateText, validateAmount, validateCard, validateCurrentEnvironment, validateEmail, validateEnvironment, validatePaymentsConfig, validatePhoneNumber, validatePricingPlan, validateStripeId };