@funnelfox/billing 0.1.0

package/dist/funnelfox-billing.d.ts

@@ -0,0 +1,204 @@
+/**
+ * TypeScript definitions for @funnelfox/billing SDK
+ */
+
+export interface SDKConfig {
+  orgId: string;
+  baseUrl?: string;
+  region?: string;
+  sandbox?: boolean;
+}
+
+export interface APIConfig {
+  baseUrl?: string;
+  region?: string;
+}
+
+export interface Customer {
+  email: string;
+  externalId: string;
+  countryCode?: string;
+}
+
+export interface CheckoutConfig {
+  customer: Customer;
+  priceId: string;
+  container: string;
+  clientMetadata?: Record<string, any>;
+  universalCheckoutOptions?: PrimerCheckoutOptions;
+}
+
+export interface CheckoutConfigWithCallbacks extends CheckoutConfig {
+  onSuccess?: (result: PaymentResult) => void;
+  onError?: (error: Error) => void;
+  onStatusChange?: (newState: CheckoutState, oldState?: CheckoutState) => void;
+  onDestroy?: () => void;
+}
+
+export interface CreateCheckoutOptions extends CheckoutConfigWithCallbacks {
+  orgId?: string;
+  apiConfig?: APIConfig;
+}
+
+export interface PrimerCheckoutOptions {
+  paymentHandling?: 'MANUAL' | 'AUTO';
+  apiVersion?: string;
+  paypal?: {
+    buttonColor?: 'blue' | 'gold' | 'silver' | 'white' | 'black';
+    paymentFlow?: 'PREFER_VAULT' | 'VAULT_ONLY' | 'CHECKOUT_ONLY';
+  };
+}
+
+export interface PaymentResult {
+  orderId: string;
+  status: 'succeeded' | 'failed' | 'cancelled' | 'processing';
+  transactionId?: string;
+  failureReason?: string;
+  metadata?: Record<string, any>;
+}
+
+export type CheckoutEventName =
+  | 'success'
+  | 'error'
+  | 'status-change'
+  | 'destroy';
+
+export type CheckoutState =
+  | 'initializing'
+  | 'ready'
+  | 'processing'
+  | 'action_required'
+  | 'updating'
+  | 'completed'
+  | 'error'
+  | 'destroyed';
+
+export interface CheckoutStatus {
+  id: string;
+  state: CheckoutState;
+  orderId: string | null;
+  priceId: string;
+  isDestroyed: boolean;
+}
+
+export interface CheckoutInstance {
+  readonly id: string;
+  readonly state: CheckoutState;
+  readonly orderId: string | null;
+  readonly isDestroyed: boolean;
+
+  updatePrice(newPriceId: string): Promise<void>;
+  getStatus(): CheckoutStatus;
+  destroy(): Promise<void>;
+  getContainer(): Element | null;
+  isInState(state: CheckoutState): boolean;
+  isReady(): boolean;
+  isProcessing(): boolean;
+
+  on(eventName: 'success', handler: (result: PaymentResult) => void): this;
+  on(eventName: 'error', handler: (error: Error) => void): this;
+  on(
+    eventName: 'status-change',
+    handler: (newState: CheckoutState, oldState?: CheckoutState) => void
+  ): this;
+  on(eventName: 'destroy', handler: () => void): this;
+  on(eventName: CheckoutEventName, handler: (...args: any[]) => void): this;
+
+  off(eventName: CheckoutEventName, handler?: Function): this;
+  once(eventName: CheckoutEventName, handler: Function): this;
+}
+
+// Error classes
+export declare class FunnefoxSDKError extends Error {
+  code: string;
+  details: any;
+  constructor(message: string, code?: string, details?: any);
+}
+
+export declare class ValidationError extends FunnefoxSDKError {
+  field: string;
+  value: any;
+  constructor(field: string, message: string, value?: any);
+}
+
+export declare class APIError extends FunnefoxSDKError {
+  statusCode: number | null;
+  errorCode: string | null;
+  errorType: string | null;
+  requestId: string | null;
+  response: any;
+  constructor(
+    message: string,
+    statusCode?: number | null,
+    options?: {
+      errorCode?: string;
+      errorType?: string;
+      requestId?: string;
+      response?: any;
+    }
+  );
+}
+
+export declare class PrimerError extends FunnefoxSDKError {
+  primerError: any;
+  constructor(message: string, primerError?: any);
+}
+
+export declare class CheckoutError extends FunnefoxSDKError {
+  phase: string | null;
+  constructor(message: string, phase?: string);
+}
+
+export declare class ConfigurationError extends FunnefoxSDKError {
+  constructor(message: string);
+}
+
+export declare class NetworkError extends FunnefoxSDKError {
+  originalError: any;
+  constructor(message: string, originalError?: any);
+}
+
+// Constants
+export declare const SDK_VERSION: string;
+export declare const CHECKOUT_STATES: Record<string, CheckoutState>;
+export declare const EVENTS: Record<string, CheckoutEventName>;
+export declare const ERROR_CODES: Record<string, string>;
+
+// Individual function exports
+export declare function configure(config: SDKConfig): void;
+export declare function createCheckout(
+  options: CreateCheckoutOptions
+): Promise<CheckoutInstance>;
+export declare function showUniversalCheckout(
+  clientToken: string,
+  options: any
+): Promise<any>;
+
+export interface CreateClientSessionOptions {
+  priceId: string;
+  externalId: string;
+  email: string;
+  orgId?: string;
+  apiConfig?: APIConfig;
+  clientMetadata?: Record<string, any>;
+  countryCode?: string;
+}
+
+export interface ClientSessionData {
+  clientToken: string;
+  orderId: string;
+  type: string;
+}
+
+export declare function createClientSession(params: CreateClientSessionOptions): Promise<ClientSessionData>;
+
+// Billing namespace
+export declare const Billing: {
+  configure: typeof configure;
+  createCheckout: typeof createCheckout;
+  showUniversalCheckout: typeof showUniversalCheckout;
+  createClientSession: typeof createClientSession;
+};
+
+// Default export is Billing namespace
+export default Billing;

package/dist/funnelfox-billing.esm.d.ts

@@ -0,0 +1,2 @@
+// Re-export all types for ESM build
+export * from './funnelfox-billing';