@blocklet/payment-react-headless 1.26.0

package/lib/checkout/index.js

@@ -0,0 +1,182 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "CheckoutProvider", {
+  enumerable: true,
+  get: function () {
+    return _context.CheckoutProvider;
+  }
+});
+Object.defineProperty(exports, "getPriceUnitAmountByCurrency", {
+  enumerable: true,
+  get: function () {
+    return _format.getPriceUnitAmountByCurrency;
+  }
+});
+Object.defineProperty(exports, "useBillingInterval", {
+  enumerable: true,
+  get: function () {
+    return _useBillingInterval.useBillingInterval;
+  }
+});
+Object.defineProperty(exports, "useCheckout", {
+  enumerable: true,
+  get: function () {
+    return _useCheckout.useCheckout;
+  }
+});
+Object.defineProperty(exports, "useCheckoutSession", {
+  enumerable: true,
+  get: function () {
+    return _useCheckoutSession.useCheckoutSession;
+  }
+});
+Object.defineProperty(exports, "useCheckoutStatus", {
+  enumerable: true,
+  get: function () {
+    return _useCheckoutStatus.useCheckoutStatus;
+  }
+});
+Object.defineProperty(exports, "useCrossSell", {
+  enumerable: true,
+  get: function () {
+    return _useCrossSell.useCrossSell;
+  }
+});
+Object.defineProperty(exports, "useCustomerForm", {
+  enumerable: true,
+  get: function () {
+    return _useCustomerForm.useCustomerForm;
+  }
+});
+Object.defineProperty(exports, "useCustomerFormContext", {
+  enumerable: true,
+  get: function () {
+    return _context.useCustomerFormContext;
+  }
+});
+Object.defineProperty(exports, "useCustomerFormFeature", {
+  enumerable: true,
+  get: function () {
+    return _useCustomerFormFeature.useCustomerFormFeature;
+  }
+});
+Object.defineProperty(exports, "useExchangeRate", {
+  enumerable: true,
+  get: function () {
+    return _useExchangeRate.useExchangeRate;
+  }
+});
+Object.defineProperty(exports, "useExchangeRateContext", {
+  enumerable: true,
+  get: function () {
+    return _context.useExchangeRateContext;
+  }
+});
+Object.defineProperty(exports, "useLineItems", {
+  enumerable: true,
+  get: function () {
+    return _useLineItems.useLineItems;
+  }
+});
+Object.defineProperty(exports, "usePaymentMethod", {
+  enumerable: true,
+  get: function () {
+    return _usePaymentMethod.usePaymentMethod;
+  }
+});
+Object.defineProperty(exports, "usePaymentMethodContext", {
+  enumerable: true,
+  get: function () {
+    return _context.usePaymentMethodContext;
+  }
+});
+Object.defineProperty(exports, "usePaymentMethodFeature", {
+  enumerable: true,
+  get: function () {
+    return _usePaymentMethodFeature.usePaymentMethodFeature;
+  }
+});
+Object.defineProperty(exports, "usePricing", {
+  enumerable: true,
+  get: function () {
+    return _usePricing.usePricing;
+  }
+});
+Object.defineProperty(exports, "usePricingFeature", {
+  enumerable: true,
+  get: function () {
+    return _usePricingFeature.usePricingFeature;
+  }
+});
+Object.defineProperty(exports, "useProduct", {
+  enumerable: true,
+  get: function () {
+    return _useProduct.useProduct;
+  }
+});
+Object.defineProperty(exports, "usePromotion", {
+  enumerable: true,
+  get: function () {
+    return _usePromotion.usePromotion;
+  }
+});
+Object.defineProperty(exports, "useSessionContext", {
+  enumerable: true,
+  get: function () {
+    return _context.useSessionContext;
+  }
+});
+Object.defineProperty(exports, "useSlippage", {
+  enumerable: true,
+  get: function () {
+    return _useSlippage.useSlippage;
+  }
+});
+Object.defineProperty(exports, "useSubmit", {
+  enumerable: true,
+  get: function () {
+    return _useSubmit.useSubmit;
+  }
+});
+Object.defineProperty(exports, "useSubmitContext", {
+  enumerable: true,
+  get: function () {
+    return _context.useSubmitContext;
+  }
+});
+Object.defineProperty(exports, "useSubmitFeature", {
+  enumerable: true,
+  get: function () {
+    return _useSubmitFeature.useSubmitFeature;
+  }
+});
+Object.defineProperty(exports, "useUpsell", {
+  enumerable: true,
+  get: function () {
+    return _useUpsell.useUpsell;
+  }
+});
+var _context = require("./context");
+var _useCheckout = require("./hooks/useCheckout");
+var _useCheckoutSession = require("./hooks/useCheckoutSession");
+var _usePaymentMethod = require("./hooks/usePaymentMethod");
+var _usePricing = require("./hooks/usePricing");
+var _useCustomerForm = require("./hooks/useCustomerForm");
+var _useSubmit = require("./hooks/useSubmit");
+var _useProduct = require("./hooks/useProduct");
+var _useLineItems = require("./hooks/useLineItems");
+var _useBillingInterval = require("./hooks/useBillingInterval");
+var _useUpsell = require("./hooks/useUpsell");
+var _useCrossSell = require("./hooks/useCrossSell");
+var _usePromotion = require("./hooks/usePromotion");
+var _useExchangeRate = require("./hooks/useExchangeRate");
+var _useSlippage = require("./hooks/useSlippage");
+var _useCheckoutStatus = require("./hooks/useCheckoutStatus");
+var _usePricingFeature = require("./hooks/usePricingFeature");
+var _usePaymentMethodFeature = require("./hooks/usePaymentMethodFeature");
+var _useCustomerFormFeature = require("./hooks/useCustomerFormFeature");
+var _useSubmitFeature = require("./hooks/useSubmitFeature");
+var _format = require("../shared/format");

package/lib/checkout/types.d.ts

@@ -0,0 +1,262 @@
+import type { TLineItemExpanded, TPaymentMethodExpanded, TPaymentCurrency, TPrice, TCheckoutSessionExpanded, TPaymentIntent, TCustomer } from '@blocklet/payment-types';
+export type SubmitStatus = 'idle' | 'submitting' | 'confirming_price' | 'confirming_fast_pay' | 'credit_insufficient' | 'waiting_did' | 'waiting_stripe' | 'completed' | 'failed';
+export type SubmitContext = {
+    type: 'price_change';
+    changePercent: number;
+} | {
+    type: 'fast_pay';
+    payType: 'balance' | 'delegation' | 'credit';
+    amount: string;
+    payer: string;
+} | {
+    type: 'credit_insufficient';
+    available: string;
+    required: string;
+} | {
+    type: 'stripe';
+    clientSecret: string;
+    intentType?: 'payment_intent' | 'setup_intent';
+} | {
+    type: 'did_connect';
+    action: string;
+    checkpointId: string;
+    extraParams: Record<string, unknown>;
+} | {
+    type: 'error';
+    message: string;
+    code?: string;
+} | null;
+export interface FieldConfig {
+    name: string;
+    type: 'text' | 'email' | 'phone' | 'select' | 'country';
+    required: boolean;
+    options?: Array<{
+        value: string;
+        label: string;
+    }>;
+    group?: string;
+}
+export type CheckoutFormData = {
+    customer_name: string;
+    customer_email?: string;
+    customer_phone?: string;
+    payment_method: string;
+    payment_currency: string;
+    billing_address?: {
+        country: string;
+        state?: string;
+        city?: string;
+        line1?: string;
+        line2?: string;
+        postal_code: string;
+    };
+};
+export type CheckoutResult = {
+    checkoutSession: TCheckoutSessionExpanded;
+    paymentMethods: TPaymentMethodExpanded[];
+    paymentIntent?: TPaymentIntent;
+    customer?: TCustomer;
+    quotes?: Record<string, {
+        quote_id: string;
+        expires_at: number;
+        quoted_amount: string;
+        exchange_rate?: string;
+        rate_provider_name?: string;
+        rate_provider_id?: string;
+    }>;
+    rateUnavailable?: boolean;
+};
+export interface UseCheckoutReturn {
+    isLoading: boolean;
+    error: string | null;
+    /** Structured error code: 'SESSION_EXPIRED' | 'EMPTY_LINE_ITEMS' | null */
+    errorCode: 'SESSION_EXPIRED' | 'EMPTY_LINE_ITEMS' | null;
+    refresh: () => Promise<void>;
+    vendorCount: number;
+    product: {
+        name: string;
+        description: string;
+        images: string[];
+        features: Array<{
+            name: string;
+            icon?: string;
+        }>;
+        billing: {
+            mode: 'payment' | 'subscription';
+            interval: 'month' | 'year' | 'week' | 'day' | null;
+            intervalCount: number;
+            displayInterval: string;
+        };
+        metadata: Record<string, string>;
+    } | null;
+    lineItems: {
+        items: Array<TLineItemExpanded & {
+            adjustable_quantity?: {
+                enabled: boolean;
+                minimum?: number;
+                maximum?: number;
+            };
+        }>;
+        updateQuantity: (itemId: string, qty: number) => Promise<void>;
+        upsell: (fromId: string, toId: string) => Promise<void>;
+        downsell: (priceId: string) => Promise<void>;
+        billingInterval: {
+            current: 'month' | 'year' | 'week' | 'day' | null;
+            available: Array<{
+                interval: 'month' | 'year' | 'week' | 'day';
+                priceId: string;
+                amount: string;
+                savings: string | null;
+            }>;
+            switch: (interval: 'month' | 'year' | 'week' | 'day') => Promise<void>;
+        } | null;
+        crossSellItem: TPrice | null;
+        crossSellRequired: boolean;
+        addCrossSell: () => Promise<void>;
+        removeCrossSell: () => Promise<void>;
+    };
+    paymentMethod: {
+        current: TPaymentMethodExpanded;
+        currency: TPaymentCurrency;
+        available: TPaymentMethodExpanded[];
+        currencies: TPaymentCurrency[];
+        isStripe: boolean;
+        isCrypto: boolean;
+        isCredit: boolean;
+        setType: (type: 'stripe' | 'crypto') => Promise<void>;
+        types: Array<{
+            type: 'stripe' | 'crypto';
+            label: string;
+            currencies: TPaymentCurrency[];
+            active: boolean;
+        }>;
+        setCurrency: (currencyId: string) => Promise<void>;
+    };
+    stripe: {
+        publishableKey: string | null;
+        clientSecret: string | null;
+        status: 'idle' | 'ready' | 'processing' | 'succeeded' | 'failed';
+    } | null;
+    pricing: {
+        subtotal: string;
+        discount: string | null;
+        tax: {
+            amount: string;
+            rate: number;
+            inclusive: boolean;
+        } | null;
+        staking: string | null;
+        total: string;
+        usdEquivalent: string | null;
+        hasDynamicPricing: boolean;
+        rate: {
+            value: string | null;
+            display: string | null;
+            provider: string | null;
+            providerDisplay: string | null;
+            fetchedAt: number | null;
+            status: 'loading' | 'available' | 'unavailable';
+            refresh: () => Promise<void>;
+        };
+        quote: {
+            locked: boolean;
+            lockedAt: number | null;
+            expiresAt: number | null;
+            expired: boolean;
+            baseCurrency: string | null;
+        };
+        slippage: {
+            percent: number;
+            set: (config: {
+                mode: string;
+                percent: number;
+            }) => Promise<void>;
+        };
+        promotion: {
+            applied: boolean;
+            code: string | null;
+            active: boolean;
+            inactiveReason: string | null;
+            apply: (code: string) => Promise<{
+                success: boolean;
+                error?: string;
+            }>;
+            remove: () => Promise<void>;
+        };
+        trial: {
+            active: boolean;
+            days: number;
+            afterTrialPrice: string | null;
+            afterTrialInterval: string | null;
+        };
+    };
+    form: {
+        fields: FieldConfig[];
+        values: CheckoutFormData;
+        onChange: (field: string, value: string | boolean | Record<string, string>) => void;
+        errors: Partial<Record<string, string>>;
+        touched: Record<string, boolean>;
+        validate: () => Promise<boolean>;
+        validateField: (field: string) => Promise<void>;
+    };
+    submit: {
+        status: SubmitStatus;
+        context: SubmitContext;
+        execute: () => Promise<void>;
+        confirm: () => Promise<void>;
+        cancel: () => void;
+        result: CheckoutResult | null;
+        retry: () => Promise<void>;
+        reset: () => void;
+        stripeConfirm: () => Promise<void>;
+        stripeCancel: () => Promise<void>;
+        vendorStatus: {
+            payment_status: string;
+            session_status: string;
+            vendors: Array<{
+                success: boolean;
+                status: 'delivered' | 'pending' | 'failed';
+                progress: number;
+                message: string;
+                appUrl?: string;
+                title?: string;
+                name?: string;
+                vendorType: string;
+            }>;
+            error: string | null;
+            isAllCompleted: boolean;
+            hasFailed: boolean;
+        } | null;
+    };
+    subscription: {
+        mode: 'payment' | 'subscription' | 'setup';
+        showStake: boolean;
+        confirmMessage: string;
+    } | null;
+    pageInfo: {
+        formPurposeDescription?: {
+            en: string;
+            zh: string;
+        };
+        showProductFeatures: boolean;
+    } | null;
+    canSubmit: boolean;
+    isCompleted: boolean;
+    isDonation: boolean;
+    setDonationAmount: (priceId: string, amount: string) => Promise<void>;
+    customer: {
+        name: string;
+        email: string;
+        phone: string;
+        address: {
+            country: string;
+            state: string;
+            city: string;
+            line1: string;
+            line2: string;
+            postal_code: string;
+        };
+    } | null;
+    livemode: boolean;
+    session: TCheckoutSessionExpanded | null;
+}

package/lib/checkout/types.js

@@ -0,0 +1 @@
+"use strict";

package/lib/index.d.ts

@@ -0,0 +1 @@
+export { type UseCheckoutReturn, type SubmitStatus, type SubmitContext, type FieldConfig, type CheckoutFormData, type CheckoutResult, type UseCheckoutSessionReturn, type SessionData, type UsePaymentMethodReturn, type UsePricingReturn, type UseCustomerFormReturn, type UseSubmitReturn, type UseProductReturn, type UseLineItemsReturn, type UseBillingIntervalReturn, type BillingIntervalData, type UseUpsellReturn, type UseCrossSellReturn, type UsePromotionReturn, type UseExchangeRateReturn, type UseSlippageReturn, type UseCheckoutStatusReturn, type UsePricingFeatureReturn, type CheckoutProviderProps, CheckoutProvider, useSessionContext, usePaymentMethodContext, useExchangeRateContext, useCustomerFormContext, useSubmitContext, useCheckout, useCheckoutSession, usePaymentMethod, usePricing, useCustomerForm, useSubmit, useProduct, useLineItems, useBillingInterval, useUpsell, useCrossSell, usePromotion, useExchangeRate, useSlippage, useCheckoutStatus, usePricingFeature, usePaymentMethodFeature, useCustomerFormFeature, useSubmitFeature, getPriceUnitAmountByCurrency, } from './checkout';

package/lib/index.js

@@ -0,0 +1,162 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "CheckoutProvider", {
+  enumerable: true,
+  get: function () {
+    return _checkout.CheckoutProvider;
+  }
+});
+Object.defineProperty(exports, "getPriceUnitAmountByCurrency", {
+  enumerable: true,
+  get: function () {
+    return _checkout.getPriceUnitAmountByCurrency;
+  }
+});
+Object.defineProperty(exports, "useBillingInterval", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useBillingInterval;
+  }
+});
+Object.defineProperty(exports, "useCheckout", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useCheckout;
+  }
+});
+Object.defineProperty(exports, "useCheckoutSession", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useCheckoutSession;
+  }
+});
+Object.defineProperty(exports, "useCheckoutStatus", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useCheckoutStatus;
+  }
+});
+Object.defineProperty(exports, "useCrossSell", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useCrossSell;
+  }
+});
+Object.defineProperty(exports, "useCustomerForm", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useCustomerForm;
+  }
+});
+Object.defineProperty(exports, "useCustomerFormContext", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useCustomerFormContext;
+  }
+});
+Object.defineProperty(exports, "useCustomerFormFeature", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useCustomerFormFeature;
+  }
+});
+Object.defineProperty(exports, "useExchangeRate", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useExchangeRate;
+  }
+});
+Object.defineProperty(exports, "useExchangeRateContext", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useExchangeRateContext;
+  }
+});
+Object.defineProperty(exports, "useLineItems", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useLineItems;
+  }
+});
+Object.defineProperty(exports, "usePaymentMethod", {
+  enumerable: true,
+  get: function () {
+    return _checkout.usePaymentMethod;
+  }
+});
+Object.defineProperty(exports, "usePaymentMethodContext", {
+  enumerable: true,
+  get: function () {
+    return _checkout.usePaymentMethodContext;
+  }
+});
+Object.defineProperty(exports, "usePaymentMethodFeature", {
+  enumerable: true,
+  get: function () {
+    return _checkout.usePaymentMethodFeature;
+  }
+});
+Object.defineProperty(exports, "usePricing", {
+  enumerable: true,
+  get: function () {
+    return _checkout.usePricing;
+  }
+});
+Object.defineProperty(exports, "usePricingFeature", {
+  enumerable: true,
+  get: function () {
+    return _checkout.usePricingFeature;
+  }
+});
+Object.defineProperty(exports, "useProduct", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useProduct;
+  }
+});
+Object.defineProperty(exports, "usePromotion", {
+  enumerable: true,
+  get: function () {
+    return _checkout.usePromotion;
+  }
+});
+Object.defineProperty(exports, "useSessionContext", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useSessionContext;
+  }
+});
+Object.defineProperty(exports, "useSlippage", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useSlippage;
+  }
+});
+Object.defineProperty(exports, "useSubmit", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useSubmit;
+  }
+});
+Object.defineProperty(exports, "useSubmitContext", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useSubmitContext;
+  }
+});
+Object.defineProperty(exports, "useSubmitFeature", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useSubmitFeature;
+  }
+});
+Object.defineProperty(exports, "useUpsell", {
+  enumerable: true,
+  get: function () {
+    return _checkout.useUpsell;
+  }
+});
+var _checkout = require("./checkout");

package/lib/shared/api.d.ts

@@ -0,0 +1,41 @@
+declare global {
+    interface Window {
+        blocklet?: {
+            prefix?: string;
+            componentId?: string;
+            componentMountPoints?: Array<{
+                did: string;
+                mountPoint: string;
+            }>;
+            appName?: string;
+            languages?: string[];
+        };
+        __PAYMENT_KIT_AUTH_TOKEN?: string;
+        __PAYMENT_KIT_BASE_URL?: string;
+    }
+}
+export declare function getPrefix(): string;
+export declare function getLocale(languages?: string[]): string;
+declare const api: import("axios").AxiosInstance;
+export default api;
+export declare const API: {
+    readonly START_PAYMENT_LINK: (id: string) => string;
+    readonly RETRIEVE_SESSION: (id: string) => string;
+    readonly SWITCH_CURRENCY: (id: string) => string;
+    readonly SUBMIT: (id: string) => string;
+    readonly DONATE_SUBMIT: (id: string) => string;
+    readonly FAST_CHECKOUT_CONFIRM: (id: string) => string;
+    readonly EXCHANGE_RATE: (id: string) => string;
+    readonly ADJUST_QUANTITY: (id: string) => string;
+    readonly UPSELL: (id: string) => string;
+    readonly DOWNSELL: (id: string) => string;
+    readonly CROSS_SELL: (id: string) => string;
+    readonly CHANGE_AMOUNT: (id: string) => string;
+    readonly SLIPPAGE: (id: string) => string;
+    readonly ABORT_STRIPE: (id: string) => string;
+    readonly RECALCULATE_PROMOTION_SESSION: (id: string) => string;
+    readonly APPLY_PROMOTION: (id: string) => string;
+    readonly REMOVE_PROMOTION: (id: string) => string;
+    readonly CUSTOMER_ME: "/api/customers/me";
+    readonly VENDOR_ORDER_STATUS: (id: string) => string;
+};