@waffo/pancake-nextjs 0.1.9 → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (15) hide show
  1. package/CHANGELOG.md +15 -0
  2. package/README.md +56 -54
  3. package/dist/index.cjs +62 -48
  4. package/dist/index.cjs.map +1 -1
  5. package/dist/index.d.cts +92 -63
  6. package/dist/index.d.ts +92 -63
  7. package/dist/index.js +58 -48
  8. package/dist/index.js.map +1 -1
  9. package/dist/server.cjs +16 -10
  10. package/dist/server.cjs.map +1 -1
  11. package/dist/server.d.cts +25 -15
  12. package/dist/server.d.ts +25 -15
  13. package/dist/server.js +14 -10
  14. package/dist/server.js.map +1 -1
  15. package/package.json +1 -1
package/dist/index.cjs.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/use-checkout.ts","../src/checkout-button.tsx","../src/use-buyer.ts","../src/use-buyer-data.ts","../src/use-query.ts","../src/use-merchant-data.ts","../src/webhook.ts"],"sourcesContent":["export { WaffoPancakeProvider } from \"./provider.js\";\nexport { CheckoutButton } from \"./checkout-button.js\";\nexport { useCheckout } from \"./use-checkout.js\";\nexport { useBuyer } from \"./use-buyer.js\";\nexport { useBuyerOrders, useBuyerPayments, useBuyerRefundTickets } from \"./use-buyer-data.js\";\nexport { useMerchantOrders, useMerchantSales, useMerchantSubscriptions } from \"./use-merchant-data.js\";\nexport { Webhook } from \"./webhook.js\";\n\n// Re-export types commonly used in client components\nexport { WaffoPancakeError, TaxCategory, WebhookEventType } from \"@waffo/pancake-ts\";\n\nexport type { PriceInfo, BillingDetail, RequestedAmount, RefundTicketVersionData, WebhookEvent, WebhookEventData } from \"@waffo/pancake-ts\";\n\n// Local types\nexport type {\n CheckoutMode,\n CheckoutBaseOptions,\n LinkCheckoutProps,\n AnonymousCheckoutProps,\n AuthenticatedCheckoutProps,\n CheckoutProps,\n UseCheckoutReturn,\n} from \"./types.js\";\n\nexport type { BuyerConfig, WaffoPancakeProviderProps } from \"./provider.js\";\n\nexport type {\n CheckoutButtonProps,\n LinkCheckoutButtonProps,\n AnonymousCheckoutButtonProps,\n AuthenticatedCheckoutButtonProps,\n} from \"./checkout-button.js\";\n\nexport type { BuyerActionState, UseBuyerReturn } from \"./use-buyer.js\";\n\nexport type { QueryState } from \"./use-query.js\";\n\nexport type { BuyerOnetimeOrder, BuyerSubscriptionOrder, BuyerPayment, BuyerRefundTicket } from \"./use-buyer-data.js\";\n\nexport type {\n MerchantOrder,\n MerchantSubscription,\n SalesOverview,\n SubscriptionOverview,\n MerchantOrdersOptions,\n} from \"./use-merchant-data.js\";\n\nexport type { WebhookConfig } from \"./webhook.js\";\n\n// Server action types (for typing the action prop)\nexport type {\n CheckoutAction,\n CheckoutActionParams,\n CheckoutActionResult,\n BuyerTokenAction,\n BuyerSessionAction,\n MerchantQueryAction,\n} from \"./server.js\";\n","\"use client\";\n\nimport React, { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from \"react\";\n\nimport type { BuyerTokenAction, BuyerSessionAction } from \"./server.js\";\n\n/** Buyer configuration for automatic token management */\nexport interface BuyerConfig {\n /** Buyer identity (email or merchant-provided identifier) */\n identity: string;\n /** Store ID (optional when `productId` is provided) */\n storeId?: string;\n /** Product ID — used to derive the store when `storeId` is omitted */\n productId?: string;\n /** Server action for issuing tokens — from `createBuyerTokenAction()` */\n issueToken: BuyerTokenAction;\n /** Server action for buyer operations — from `createBuyerSessionAction()` */\n sessionAction: BuyerSessionAction;\n}\n\ninterface TokenState {\n token: string;\n expiresAt: number;\n}\n\n/** @internal */\nexport interface PancakeContextValue {\n /** Get a valid buyer token (auto-refreshes if expired) */\n getBuyerToken: () => Promise<string>;\n /** Execute a buyer session operation via server action */\n buyerSessionAction: BuyerSessionAction;\n /** Whether buyer config is provided */\n hasBuyer: boolean;\n /** Whether the initial token is ready */\n isBuyerReady: boolean;\n}\n\n/** @internal Exported for direct useContext access in hooks */\nexport const PancakeContext = createContext<PancakeContextValue | null>(null);\n\n/** Token refresh buffer — refresh 30s before actual expiry */\nconst REFRESH_BUFFER_MS = 30_000;\n\nexport interface WaffoPancakeProviderProps {\n /** Buyer configuration for automatic token management */\n buyer: BuyerConfig;\n children: React.ReactNode;\n}\n\n/**\n * Provider that manages buyer token lifecycle via server actions.\n *\n * Auto-issues session tokens on mount and refreshes before expiry.\n * All buyer hooks (`useBuyer`, `useBuyerOrders`, etc.) read from context.\n *\n * The private key never leaves the server — token issuance and buyer\n * operations are delegated to server actions.\n *\n * @param props - Provider configuration\n * @param props.buyer - Buyer identity and server actions\n * @param props.children - React children\n *\n * @example\n * ```tsx\n * // identity must match what you passed as `buyerIdentity` at checkout time —\n * // buyer-portal lookups are keyed by merchant_provided_buyer_identity\n * <WaffoPancakeProvider buyer={{\n * identity: user.id,\n * storeId: \"STO_xxx\",\n * issueToken, // from createBuyerTokenAction()\n * sessionAction, // from createBuyerSessionAction()\n * }}>\n * <App />\n * </WaffoPancakeProvider>\n * ```\n */\nexport function WaffoPancakeProvider({ buyer, children }: WaffoPancakeProviderProps) {\n const tokenRef = useRef<TokenState | null>(null);\n const refreshPromiseRef = useRef<Promise<string> | null>(null);\n const [isBuyerReady, setIsBuyerReady] = useState(false);\n\n const refreshToken = useCallback(async (): Promise<string> => {\n const result = await buyer.issueToken({\n buyerIdentity: buyer.identity,\n storeId: buyer.storeId,\n productId: buyer.productId,\n });\n\n tokenRef.current = {\n token: result.token,\n expiresAt: new Date(result.expiresAt).getTime(),\n };\n\n return result.token;\n }, [buyer]);\n\n const getBuyerToken = useCallback(async (): Promise<string> => {\n const current = tokenRef.current;\n if (current && Date.now() < current.expiresAt - REFRESH_BUFFER_MS) {\n return current.token;\n }\n\n // Deduplicate concurrent refresh calls\n if (!refreshPromiseRef.current) {\n refreshPromiseRef.current = refreshToken().finally(() => {\n refreshPromiseRef.current = null;\n });\n }\n\n return refreshPromiseRef.current;\n }, [refreshToken]);\n\n // Issue initial token on mount\n useEffect(() => {\n refreshToken()\n .then(() => setIsBuyerReady(true))\n .catch(() => setIsBuyerReady(true));\n }, [refreshToken]);\n\n const value = useMemo<PancakeContextValue>(\n () => ({\n getBuyerToken,\n buyerSessionAction: buyer.sessionAction,\n hasBuyer: true,\n isBuyerReady,\n }),\n [getBuyerToken, buyer.sessionAction, isBuyerReady],\n );\n\n return <PancakeContext.Provider value={value}>{children}</PancakeContext.Provider>;\n}\n\n/**\n * Access the Waffo Pancake context. Must be used within `<WaffoPancakeProvider>`.\n */\nexport function usePancakeContext(): PancakeContextValue {\n const ctx = useContext(PancakeContext);\n if (!ctx) throw new Error(\"usePancakeContext: must be used within <WaffoPancakeProvider>\");\n return ctx;\n}\n","\"use client\";\n\nimport { useCallback, useRef, useState } from \"react\";\n\nimport type { CheckoutProps, LinkCheckoutProps, UseCheckoutReturn } from \"./types.js\";\nimport type { CheckoutSessionResult, AuthenticatedCheckoutResult } from \"@waffo/pancake-ts\";\n\n\nconst LOADING_HTML = `<!DOCTYPE html><html><head><meta charset=\"utf-8\"><title>Loading...</title><style>body{display:flex;align-items:center;justify-content:center;height:100vh;margin:0;font-family:system-ui,sans-serif;background:#f9fafb;color:#6b7280}@media(prefers-color-scheme:dark){body{background:#111827;color:#9ca3af}}</style></head><body><p>Redirecting to checkout...</p></body></html>`;\n\nconst DEFAULT_STOREFRONT_URL = \"https://pancake.waffo.ai\";\n\nconst SDK_FIELDS = new Set([\"action\", \"type\", \"mode\", \"popupLoadingUrl\", \"onSuccess\", \"onError\"]);\n\n/** Extract API checkout params from flattened props, removing SDK-specific fields */\nfunction extractApiParams(args: object): Record<string, unknown> {\n const params: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(args)) {\n if (!SDK_FIELDS.has(key)) params[key] = value;\n }\n return params;\n}\n\n/**\n * Build a product page URL for link checkout.\n */\nfunction buildLinkUrl(props: LinkCheckoutProps): string {\n const base = (props.baseUrl ?? DEFAULT_STOREFRONT_URL).replace(/\\/+$/, \"\");\n const url = new URL(`${base}/store/${props.storeSlug}/product/${props.productId}`);\n\n if (props.currency) url.searchParams.set(\"currency\", props.currency);\n if (props.email) url.searchParams.set(\"email\", props.email);\n if (props.successUrl) url.searchParams.set(\"success_url\", props.successUrl);\n if (props.test) url.searchParams.set(\"test\", \"true\");\n if (props.country) url.searchParams.set(\"country\", props.country);\n if (props.isBusiness) url.searchParams.set(\"is_business\", \"true\");\n\n return url.toString();\n}\n\n/**\n * React hook for triggering a Waffo Pancake checkout flow.\n *\n * Supports three checkout types:\n * - **link**: Builds a product page URL and navigates directly (no API call, synchronous)\n * - **anonymous**: Calls a server action to create a checkout session, then navigates\n * - **authenticated**: Calls a server action to create a session + token, then navigates\n *\n * The private key never leaves the server — anonymous and authenticated modes\n * use a server action created by `createCheckoutAction()`.\n *\n * @param args - Flattened checkout props\n * @returns `{ checkout, isLoading, error }`\n *\n * @example\n * ```tsx\n * // Link checkout — no server action needed\n * const { checkout } = useCheckout({\n * type: \"link\",\n * storeSlug: \"my-store\",\n * productId: \"PROD_xxx\",\n * currency: \"USD\",\n * });\n *\n * // Anonymous checkout — via server action\n * const { checkout, isLoading } = useCheckout({\n * action: checkout, // from createCheckoutAction()\n * productId: \"PROD_xxx\",\n * currency: \"USD\",\n * });\n * ```\n */\nexport function useCheckout(args: CheckoutProps): UseCheckoutReturn {\n const { mode = \"redirect\", popupLoadingUrl, onError } = args;\n const [isLoading, setIsLoading] = useState(false);\n const [error, setError] = useState<Error | null>(null);\n const popupRef = useRef<Window | null>(null);\n\n const checkout = useCallback(() => {\n if (isLoading) return;\n\n // Link checkout — synchronous, no API call\n if (args.type === \"link\") {\n const url = buildLinkUrl(args);\n if (mode === \"popup\") {\n window.open(url, \"_blank\");\n } else {\n window.location.href = url;\n }\n return;\n }\n\n // Anonymous / Authenticated — server action\n if (mode === \"popup\") {\n const loadingUrl = popupLoadingUrl ?? `data:text/html;charset=utf-8,${encodeURIComponent(LOADING_HTML)}`;\n popupRef.current = window.open(loadingUrl, \"_blank\");\n }\n\n setIsLoading(true);\n setError(null);\n\n const { action } = args;\n const params = extractApiParams(args);\n const actionParams = args.type === \"authenticated\" ? { type: \"authenticated\" as const, ...params } : params;\n\n action(actionParams as unknown as Parameters<typeof action>[0])\n .then((result: CheckoutSessionResult | AuthenticatedCheckoutResult) => {\n if (mode === \"popup\" && popupRef.current) {\n popupRef.current.location.href = result.checkoutUrl;\n } else {\n window.location.href = result.checkoutUrl;\n }\n if (\"onSuccess\" in args && args.onSuccess) {\n (args.onSuccess as (r: CheckoutSessionResult | AuthenticatedCheckoutResult) => void)(result);\n }\n })\n .catch((err: Error) => {\n if (mode === \"popup\" && popupRef.current) {\n popupRef.current.close();\n popupRef.current = null;\n }\n setError(err);\n onError?.(err);\n })\n .finally(() => {\n setIsLoading(false);\n });\n }, [args, mode, popupLoadingUrl, onError, isLoading]);\n\n return { checkout, isLoading, error };\n}\n","\"use client\";\n\nimport React from \"react\";\n\nimport { useCheckout } from \"./use-checkout.js\";\n\nimport type { CheckoutProps, LinkCheckoutProps, AnonymousCheckoutProps, AuthenticatedCheckoutProps } from \"./types.js\";\n\ntype CheckoutButtonBaseProps = {\n /** Button content */\n children: React.ReactNode;\n /** Content shown while checkout session is being created */\n loadingChildren?: React.ReactNode;\n /** Additional class name */\n className?: string;\n /** Additional inline styles */\n style?: React.CSSProperties;\n /** Disabled state (merged with isLoading) */\n disabled?: boolean;\n} & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, \"onClick\" | \"disabled\" | \"children\">;\n\n/** Props for CheckoutButton — link mode */\nexport type LinkCheckoutButtonProps = CheckoutButtonBaseProps & LinkCheckoutProps;\n\n/** Props for CheckoutButton — anonymous mode */\nexport type AnonymousCheckoutButtonProps = CheckoutButtonBaseProps & AnonymousCheckoutProps;\n\n/** Props for CheckoutButton — authenticated mode */\nexport type AuthenticatedCheckoutButtonProps = CheckoutButtonBaseProps & AuthenticatedCheckoutProps;\n\nexport type CheckoutButtonProps = LinkCheckoutButtonProps | AnonymousCheckoutButtonProps | AuthenticatedCheckoutButtonProps;\n\n/**\n * A button that triggers a Waffo Pancake checkout flow on click.\n *\n * Three checkout types:\n * - **link**: Instant redirect to product page URL (no server action needed)\n * - **anonymous**: Calls server action to create session, then redirects\n * - **authenticated**: Calls server action to create session + token, then redirects\n *\n * The private key never leaves the server — anonymous and authenticated modes\n * use a server action created by `createCheckoutAction()`.\n *\n * @param props - Flattened checkout props, button content, and optional styling\n *\n * @example\n * ```tsx\n * // Link checkout — no server action needed\n * <CheckoutButton type=\"link\" storeSlug=\"my-store\" productId=\"PROD_xxx\" currency=\"USD\">\n * Buy Now\n * </CheckoutButton>\n *\n * // Anonymous checkout — via server action\n * <CheckoutButton action={checkout} productId=\"PROD_xxx\" currency=\"USD\">\n * Buy Now\n * </CheckoutButton>\n *\n * // Authenticated checkout — via server action\n * <CheckoutButton action={checkout} type=\"authenticated\" productId=\"PROD_xxx\" currency=\"USD\" buyerIdentity=\"userIdInYourSystem\" buyerEmail=\"user@example.com\">\n * Buy Now\n * </CheckoutButton>\n * ```\n */\nexport function CheckoutButton(props: CheckoutButtonProps) {\n const { children, loadingChildren, className, style, disabled, ...checkoutProps } = props;\n\n const { checkout, isLoading } = useCheckout(checkoutProps as CheckoutProps);\n\n return (\n <button type=\"button\" onClick={checkout} disabled={disabled || isLoading} className={className} style={style}>\n {isLoading ? (loadingChildren ?? children) : children}\n </button>\n );\n}\n","\"use client\";\n\nimport { useCallback, useContext, useMemo, useState } from \"react\";\n\nimport { PancakeContext } from \"./provider.js\";\n\nimport type {\n CancelSubscriptionParams,\n CancelSubscriptionResult,\n CancelOnetimeOrderParams,\n CancelOnetimeOrderResult,\n ReactivateSubscriptionParams,\n ReactivateSubscriptionResult,\n CreateRefundTicketParams,\n ResubmitRefundTicketParams,\n RefundTicket,\n GraphQLParams,\n GraphQLResponse,\n} from \"@waffo/pancake-ts\";\n\n/** State of an async buyer action */\nexport interface BuyerActionState<T = unknown> {\n /** Execute the action */\n execute: (params: T) => Promise<void>;\n /** Whether the action is in progress */\n isLoading: boolean;\n /** Error from the last attempt */\n error: Error | null;\n}\n\n/** Return type of useBuyer hook */\nexport interface UseBuyerReturn {\n /** Cancel a subscription order */\n cancelSubscription: BuyerActionState<CancelSubscriptionParams> & { data: CancelSubscriptionResult | null };\n /** Cancel a one-time order */\n cancelOnetimeOrder: BuyerActionState<CancelOnetimeOrderParams> & { data: CancelOnetimeOrderResult | null };\n /** Reactivate a canceling subscription */\n reactivateSubscription: BuyerActionState<ReactivateSubscriptionParams> & { data: ReactivateSubscriptionResult | null };\n /** Create a refund ticket */\n createRefundTicket: BuyerActionState<CreateRefundTicketParams> & { data: RefundTicket | null };\n /** Resubmit a rejected refund ticket */\n resubmitRefundTicket: BuyerActionState<ResubmitRefundTicketParams> & { data: RefundTicket | null };\n /** Execute a GraphQL query */\n query: <T = Record<string, unknown>>(params: GraphQLParams) => Promise<GraphQLResponse<T>>;\n}\n\nfunction useBuyerAction<TParams, TResult>(\n actionFn: (params: TParams) => Promise<TResult>,\n): BuyerActionState<TParams> & { data: TResult | null } {\n const [isLoading, setIsLoading] = useState(false);\n const [error, setError] = useState<Error | null>(null);\n const [data, setData] = useState<TResult | null>(null);\n\n const execute = useCallback(\n async (params: TParams) => {\n setIsLoading(true);\n setError(null);\n try {\n const result = await actionFn(params);\n setData(result);\n } catch (err) {\n setError(err instanceof Error ? err : new Error(String(err)));\n throw err;\n } finally {\n setIsLoading(false);\n }\n },\n [actionFn],\n );\n\n return { execute, isLoading, error, data };\n}\n\n/**\n * React hook for buyer self-service actions.\n *\n * Must be used within `<WaffoPancakeProvider>`. All operations are executed\n * via server actions — the private key never leaves the server.\n *\n * @returns Buyer action handlers with loading/error states\n *\n * @example\n * ```tsx\n * function AccountPage() {\n * const buyer = useBuyer();\n * return (\n * <button onClick={() => buyer.cancelSubscription.execute({ orderId: \"ORD_xxx\" })}>\n * Cancel\n * </button>\n * );\n * }\n * ```\n */\nexport function useBuyer(): UseBuyerReturn {\n const ctx = useContext(PancakeContext);\n if (!ctx) throw new Error(\"useBuyer: must be used within <WaffoPancakeProvider>\");\n\n const { getBuyerToken, buyerSessionAction } = ctx;\n\n const callAction = useCallback(\n async (actionType: string, params: unknown) => {\n const token = await getBuyerToken();\n return buyerSessionAction(token, actionType as never, params);\n },\n [getBuyerToken, buyerSessionAction],\n );\n\n const cancelSubscription = useBuyerAction<CancelSubscriptionParams, CancelSubscriptionResult>(\n useCallback((params) => callAction(\"cancelSubscription\", params) as Promise<CancelSubscriptionResult>, [callAction]),\n );\n\n const cancelOnetimeOrder = useBuyerAction<CancelOnetimeOrderParams, CancelOnetimeOrderResult>(\n useCallback((params) => callAction(\"cancelOnetimeOrder\", params) as Promise<CancelOnetimeOrderResult>, [callAction]),\n );\n\n const reactivateSubscription = useBuyerAction<ReactivateSubscriptionParams, ReactivateSubscriptionResult>(\n useCallback((params) => callAction(\"reactivateSubscription\", params) as Promise<ReactivateSubscriptionResult>, [callAction]),\n );\n\n const createRefundTicket = useBuyerAction<CreateRefundTicketParams, { ticket: RefundTicket }>(\n useCallback((params) => callAction(\"createRefundTicket\", params) as Promise<{ ticket: RefundTicket }>, [callAction]),\n );\n const createRefundTicketMapped = useMemo(\n () => ({ ...createRefundTicket, data: createRefundTicket.data?.ticket ?? null }),\n [createRefundTicket],\n );\n\n const resubmitRefundTicket = useBuyerAction<ResubmitRefundTicketParams, { ticket: RefundTicket }>(\n useCallback((params) => callAction(\"resubmitRefundTicket\", params) as Promise<{ ticket: RefundTicket }>, [callAction]),\n );\n const resubmitRefundTicketMapped = useMemo(\n () => ({ ...resubmitRefundTicket, data: resubmitRefundTicket.data?.ticket ?? null }),\n [resubmitRefundTicket],\n );\n\n const query = useCallback(\n async <T = Record<string, unknown>>(params: GraphQLParams) => {\n const token = await getBuyerToken();\n return buyerSessionAction(token, \"query\", params) as Promise<GraphQLResponse<T>>;\n },\n [getBuyerToken, buyerSessionAction],\n );\n\n return {\n cancelSubscription,\n cancelOnetimeOrder,\n reactivateSubscription,\n createRefundTicket: createRefundTicketMapped,\n resubmitRefundTicket: resubmitRefundTicketMapped,\n query,\n };\n}\n","\"use client\";\n\nimport { useCallback, useContext } from \"react\";\n\nimport { PancakeContext } from \"./provider.js\";\nimport { useQuery } from \"./use-query.js\";\n\nimport type { QueryState } from \"./use-query.js\";\nimport type { GraphQLResponse, RefundTicketVersionData } from \"@waffo/pancake-ts\";\n\n// ============================================================\n// Types\n// ============================================================\n\n/** A buyer's one-time order */\nexport interface BuyerOnetimeOrder {\n id: string;\n status: string;\n currency: string;\n buyerEmail: string;\n product: { id: string; name: string } | null;\n payments: Array<{ id: string; status: string; snapshotDisplayAmount: string; snapshotDisplayCurrency: string; createdAt: string }>;\n createdAt: string;\n}\n\n/** A buyer's subscription order */\nexport interface BuyerSubscriptionOrder {\n id: string;\n status: string;\n currency: string;\n buyerEmail: string;\n currentPeriodStart: string | null;\n currentPeriodEnd: string | null;\n cancelAt: string | null;\n product: { id: string; name: string; billingPeriod: string } | null;\n payments: Array<{ id: string; status: string; snapshotDisplayAmount: string; snapshotDisplayCurrency: string; createdAt: string }>;\n createdAt: string;\n}\n\n/** A buyer's payment record */\nexport interface BuyerPayment {\n id: string;\n orderId: string;\n status: string;\n snapshotDisplayAmount: string;\n snapshotDisplayCurrency: string;\n failureReason: string | null;\n createdAt: string;\n}\n\n/**\n * A buyer's refund ticket.\n *\n * Ticket-level fields are flat; per-version fields (`reason`, `requestedAmount`)\n * live under `versionData` because the buyer can resubmit a rejected ticket and\n * each submission is a versioned record. `versionData` reflects the current\n * (latest) version. The `versionData` shape is shared with `@waffo/pancake-ts`'s\n * `RefundTicketVersionData`.\n */\nexport interface BuyerRefundTicket {\n id: string;\n status: string;\n versionNumber: number | null;\n versionData: RefundTicketVersionData | null;\n createdAt: string;\n}\n\n// ============================================================\n// Queries\n// ============================================================\n\nconst BUYER_ORDERS_QUERY = `query {\n onetimeOrders(limit: 50) {\n id status currency buyerEmail createdAt\n product { id name }\n payments { id status snapshotDisplayAmount snapshotDisplayCurrency createdAt }\n }\n subscriptionOrders(limit: 50) {\n id status currency buyerEmail currentPeriodStart currentPeriodEnd cancelAt createdAt\n product { id name billingPeriod }\n payments { id status snapshotDisplayAmount snapshotDisplayCurrency createdAt }\n }\n}`;\n\nconst BUYER_PAYMENTS_QUERY = `query {\n payments(limit: 50) {\n id orderId status snapshotDisplayAmount snapshotDisplayCurrency failureReason createdAt\n }\n}`;\n\nconst BUYER_REFUND_TICKETS_QUERY = `query {\n refundTickets(limit: 50) {\n id status versionNumber\n versionData {\n reason\n requestedAmount { amount currency }\n }\n createdAt\n }\n}`;\n\n// ============================================================\n// Internal helper\n// ============================================================\n\nfunction useBuyerQuery<T>(query: string): QueryState<T> {\n const ctx = useContext(PancakeContext);\n if (!ctx) throw new Error(\"Buyer data hook: must be used within <WaffoPancakeProvider>\");\n\n const { getBuyerToken, buyerSessionAction, isBuyerReady } = ctx;\n\n const queryFn = useCallback(async () => {\n const token = await getBuyerToken();\n const result = (await buyerSessionAction(token, \"query\", { query })) as unknown as GraphQLResponse<T>;\n return result.data as T;\n }, [getBuyerToken, buyerSessionAction, query]);\n\n return useQuery(queryFn, isBuyerReady);\n}\n\n// ============================================================\n// Hooks\n// ============================================================\n\ninterface BuyerOrdersData {\n onetimeOrders: BuyerOnetimeOrder[];\n subscriptionOrders: BuyerSubscriptionOrder[];\n}\n\n/**\n * Fetch the buyer's order history (one-time + subscription).\n *\n * Must be used within `<WaffoPancakeProvider>`. Token is auto-managed.\n *\n * @returns Orders with product info and payment history\n *\n * @example\n * ```tsx\n * const { data, isLoading, refetch } = useBuyerOrders();\n * // data.onetimeOrders + data.subscriptionOrders\n * ```\n */\nexport function useBuyerOrders(): QueryState<BuyerOrdersData> {\n return useBuyerQuery<BuyerOrdersData>(BUYER_ORDERS_QUERY);\n}\n\n/**\n * Fetch the buyer's payment history.\n *\n * Must be used within `<WaffoPancakeProvider>`. Token is auto-managed.\n *\n * @returns Payment records with amounts and status\n *\n * @example\n * ```tsx\n * const { data: payments, isLoading } = useBuyerPayments();\n * ```\n */\nexport function useBuyerPayments(): QueryState<BuyerPayment[]> {\n const result = useBuyerQuery<{ payments: BuyerPayment[] }>(BUYER_PAYMENTS_QUERY);\n return { ...result, data: result.data?.payments ?? null };\n}\n\n/**\n * Fetch the buyer's refund tickets.\n *\n * Must be used within `<WaffoPancakeProvider>`. Token is auto-managed.\n *\n * @returns Refund tickets with status and requested amounts\n *\n * @example\n * ```tsx\n * const { data: tickets, isLoading } = useBuyerRefundTickets();\n * ```\n */\nexport function useBuyerRefundTickets(): QueryState<BuyerRefundTicket[]> {\n const result = useBuyerQuery<{ refundTickets: BuyerRefundTicket[] }>(BUYER_REFUND_TICKETS_QUERY);\n return { ...result, data: result.data?.refundTickets ?? null };\n}\n","\"use client\";\n\nimport { useCallback, useEffect, useState } from \"react\";\n\n/** Query state with typed data */\nexport interface QueryState<T> {\n data: T | null;\n isLoading: boolean;\n error: Error | null;\n refetch: () => void;\n}\n\n/**\n * Internal hook for async data fetching with loading/error state.\n *\n * @param queryFn - Async function that returns the data\n * @param ready - Whether to start fetching (false = wait)\n * @returns Query state with data, loading, error, and refetch\n */\nexport function useQuery<T>(queryFn: () => Promise<T>, ready: boolean): QueryState<T> {\n const [data, setData] = useState<T | null>(null);\n const [isLoading, setIsLoading] = useState(true);\n const [error, setError] = useState<Error | null>(null);\n\n const fetch = useCallback(() => {\n if (!ready) return;\n setIsLoading(true);\n setError(null);\n queryFn()\n .then(setData)\n .catch((err) => setError(err instanceof Error ? err : new Error(String(err))))\n .finally(() => setIsLoading(false));\n }, [queryFn, ready]);\n\n useEffect(() => {\n fetch();\n }, [fetch]);\n\n return { data, isLoading, error, refetch: fetch };\n}\n","\"use client\";\n\nimport { useCallback } from \"react\";\n\nimport { useQuery } from \"./use-query.js\";\n\nimport type { MerchantQueryAction } from \"./server.js\";\nimport type { QueryState } from \"./use-query.js\";\nimport type { GraphQLResponse } from \"@waffo/pancake-ts\";\n\n// ============================================================\n// Merchant Data Hooks (via server action)\n// ============================================================\n\n/** A merchant's recent order (one-time or subscription) */\nexport interface MerchantOrder {\n id: string;\n status: string;\n currency: string;\n buyerEmail: string;\n testMode: boolean;\n product: { id: string; name: string } | null;\n payments: Array<{ id: string; status: string; snapshotDisplayAmount: string; snapshotDisplayCurrency: string }>;\n createdAt: string;\n}\n\n/**\n * Sales overview statistics.\n *\n * Monetary fields (`totalRevenue`, `revenueByPeriod[].amount`) are returned as\n * display-formatted strings (e.g., `\"9.99\"`), not minor-currency-unit integers.\n * The conversion happens server-side via the GraphQL `currencyDisplayLoader`.\n */\nexport interface SalesOverview {\n totalOrders: number;\n /** Total succeeded payment revenue as display string (e.g., `\"1234.56\"`) */\n totalRevenue: string;\n totalCustomers: number;\n currency: string;\n ordersByStatus: Array<{ status: string; count: number }>;\n /** Revenue by period; `amount` is a display string (e.g., `\"9.99\"`) */\n revenueByPeriod: Array<{ period: string; amount: string }>;\n}\n\n/** Subscription overview */\nexport interface SubscriptionOverview {\n activeCount: number;\n cancelingCount: number;\n pastDueCount: number;\n totalCount: number;\n subscriptions: MerchantSubscription[];\n}\n\n/** A merchant's subscription with status details */\nexport interface MerchantSubscription {\n id: string;\n status: string;\n currency: string;\n buyerEmail: string;\n currentPeriodStart: string | null;\n currentPeriodEnd: string | null;\n cancelAt: string | null;\n product: { id: string; name: string; billingPeriod: string } | null;\n createdAt: string;\n}\n\nexport interface MerchantOrdersOptions {\n /** Store ID to filter by */\n storeId: string;\n /** Max results (default: 20) */\n limit?: number;\n}\n\nconst MERCHANT_ORDERS_QUERY = `query ($storeId: ID!, $limit: Int) {\n onetimeOrders(storeId: $storeId, limit: $limit) {\n id status currency buyerEmail testMode createdAt\n product { id name }\n payments { id status snapshotDisplayAmount snapshotDisplayCurrency }\n }\n subscriptionOrders(storeId: $storeId, limit: $limit) {\n id status currency buyerEmail testMode createdAt\n product { id name }\n payments { id status snapshotDisplayAmount snapshotDisplayCurrency }\n }\n}`;\n\n/**\n * Fetch recent orders for a store (one-time + subscription).\n *\n * @param query - Server action from `createMerchantQueryAction()`\n * @param options - Store ID and optional limit\n * @returns Recent orders with product info and payment summary\n *\n * @example\n * ```tsx\n * const { data, isLoading, refetch } = useMerchantOrders(merchantQuery, { storeId: \"STO_xxx\" });\n * ```\n */\nexport function useMerchantOrders(\n query: MerchantQueryAction,\n options: MerchantOrdersOptions,\n): QueryState<{ onetimeOrders: MerchantOrder[]; subscriptionOrders: MerchantOrder[] }> {\n const { storeId, limit = 20 } = options;\n\n const queryFn = useCallback(async () => {\n const result = (await query({\n query: MERCHANT_ORDERS_QUERY,\n variables: { storeId, limit },\n })) as unknown as GraphQLResponse<{ onetimeOrders: MerchantOrder[]; subscriptionOrders: MerchantOrder[] }>;\n return result.data as { onetimeOrders: MerchantOrder[]; subscriptionOrders: MerchantOrder[] };\n }, [query, storeId, limit]);\n\n return useQuery(queryFn, true);\n}\n\nconst MERCHANT_SALES_QUERY = `query ($storeId: ID!) {\n orderStatistics(storeId: $storeId) {\n totalCount\n countByStatus { status count }\n }\n paymentStatistics(storeId: $storeId) {\n totalSucceededAmount\n totalSucceededCurrency\n totalSucceededCount\n }\n customerAnalysis(storeId: $storeId) {\n totalCustomers\n }\n trendAnalysis(storeId: $storeId) {\n revenueByPeriod { period amount }\n }\n}`;\n\ninterface SalesQueryData {\n orderStatistics: { totalCount: number; countByStatus: Array<{ status: string; count: number }> };\n paymentStatistics: { totalSucceededAmount: string; totalSucceededCurrency: string; totalSucceededCount: number };\n customerAnalysis: { totalCustomers: number };\n trendAnalysis: { revenueByPeriod: Array<{ period: string; amount: string }> };\n}\n\n/**\n * Fetch sales overview for a store.\n *\n * @param query - Server action from `createMerchantQueryAction()`\n * @param storeId - Store ID\n * @returns Aggregated sales statistics\n *\n * @example\n * ```tsx\n * const { data: sales } = useMerchantSales(merchantQuery, \"STO_xxx\");\n * ```\n */\nexport function useMerchantSales(query: MerchantQueryAction, storeId: string): QueryState<SalesOverview> {\n const queryFn = useCallback(async () => {\n const result = (await query({\n query: MERCHANT_SALES_QUERY,\n variables: { storeId },\n })) as unknown as GraphQLResponse<SalesQueryData>;\n const d = result.data as SalesQueryData;\n return {\n totalOrders: d.orderStatistics.totalCount,\n totalRevenue: d.paymentStatistics.totalSucceededAmount,\n totalCustomers: d.customerAnalysis.totalCustomers,\n currency: d.paymentStatistics.totalSucceededCurrency,\n ordersByStatus: d.orderStatistics.countByStatus,\n revenueByPeriod: d.trendAnalysis.revenueByPeriod,\n };\n }, [query, storeId]);\n\n return useQuery(queryFn, true);\n}\n\nconst MERCHANT_SUBSCRIPTIONS_QUERY = `query ($storeId: ID!) {\n subscriptionOrders(storeId: $storeId, limit: 100) {\n id status currency buyerEmail currentPeriodStart currentPeriodEnd cancelAt createdAt\n product { id name billingPeriod }\n }\n}`;\n\n/**\n * Fetch subscription overview for a store.\n *\n * @param query - Server action from `createMerchantQueryAction()`\n * @param storeId - Store ID\n * @returns Subscription counts and detailed list\n *\n * @example\n * ```tsx\n * const { data: subs } = useMerchantSubscriptions(merchantQuery, \"STO_xxx\");\n * ```\n */\nexport function useMerchantSubscriptions(query: MerchantQueryAction, storeId: string): QueryState<SubscriptionOverview> {\n const queryFn = useCallback(async () => {\n const result = (await query({\n query: MERCHANT_SUBSCRIPTIONS_QUERY,\n variables: { storeId },\n })) as unknown as GraphQLResponse<{ subscriptionOrders: MerchantSubscription[] }>;\n const subs = (result.data as { subscriptionOrders: MerchantSubscription[] }).subscriptionOrders;\n return {\n activeCount: subs.filter((s) => s.status === \"active\").length,\n cancelingCount: subs.filter((s) => s.status === \"canceling\").length,\n pastDueCount: subs.filter((s) => s.status === \"past_due\").length,\n totalCount: subs.length,\n subscriptions: subs,\n };\n }, [query, storeId]);\n\n return useQuery(queryFn, true);\n}\n","import { verifyWebhook } from \"@waffo/pancake-ts\";\n\nimport type { VerifyWebhookOptions, WebhookEvent, WebhookEventData } from \"@waffo/pancake-ts\";\n\n/** Handler function for a specific webhook event */\ntype EventHandler<T = WebhookEventData> = (event: WebhookEvent<T>) => void | Promise<void>;\n\n/** Configuration for the Webhook route handler factory */\nexport interface WebhookConfig {\n /** Webhook signature verification options (environment, publicKey, tolerance, etc.) */\n verifyOptions?: VerifyWebhookOptions;\n\n /** Catch-all handler — called for every event regardless of type */\n onPayload?: EventHandler;\n\n /** One-time order first payment succeeded */\n onOrderCompleted?: EventHandler;\n /** Subscription first payment succeeded (newly activated) */\n onSubscriptionActivated?: EventHandler;\n /** Subscription renewal payment succeeded */\n onSubscriptionPaymentSucceeded?: EventHandler;\n /** Buyer initiated cancellation (expires at end of current period) */\n onSubscriptionCanceling?: EventHandler;\n /** Buyer withdrew cancellation (subscription restored) */\n onSubscriptionUncanceled?: EventHandler;\n /** Subscription product changed (upgrade/downgrade) */\n onSubscriptionUpdated?: EventHandler;\n /** Subscription fully terminated */\n onSubscriptionCanceled?: EventHandler;\n /** Renewal payment failed (past due) */\n onSubscriptionPastDue?: EventHandler;\n /** Refund succeeded */\n onRefundSucceeded?: EventHandler;\n /** Refund failed */\n onRefundFailed?: EventHandler;\n}\n\n/* eslint-disable @typescript-eslint/naming-convention -- event type keys use dot notation */\nconst EVENT_HANDLER_MAP: Record<string, keyof WebhookConfig> = {\n \"order.completed\": \"onOrderCompleted\",\n \"subscription.activated\": \"onSubscriptionActivated\",\n \"subscription.payment_succeeded\": \"onSubscriptionPaymentSucceeded\",\n \"subscription.canceling\": \"onSubscriptionCanceling\",\n \"subscription.uncanceled\": \"onSubscriptionUncanceled\",\n \"subscription.updated\": \"onSubscriptionUpdated\",\n \"subscription.canceled\": \"onSubscriptionCanceled\",\n \"subscription.past_due\": \"onSubscriptionPastDue\",\n \"refund.succeeded\": \"onRefundSucceeded\",\n \"refund.failed\": \"onRefundFailed\",\n};\n/* eslint-enable @typescript-eslint/naming-convention */\n\n/**\n * Create a Next.js POST route handler for Waffo Pancake webhooks.\n *\n * Automatically verifies the webhook signature using `@waffo/pancake-ts`,\n * then dispatches to the matching event handler.\n *\n * @param config - Verification options and event handlers\n * @returns A Next.js POST route handler\n *\n * @example\n * ```ts\n * // app/api/webhooks/waffo/route.ts\n * import { Webhook } from \"@waffo/pancake-nextjs\";\n *\n * export const POST = Webhook({\n * verifyOptions: { environment: \"prod\" },\n * onOrderCompleted: async (event) => {\n * console.log(\"Order completed:\", event.data.orderId);\n * // Grant access to the product\n * },\n * onSubscriptionActivated: async (event) => {\n * console.log(\"Subscription activated:\", event.data.orderId);\n * },\n * onRefundSucceeded: async (event) => {\n * console.log(\"Refund succeeded:\", event.data.refundId);\n * // Revoke access\n * },\n * });\n * ```\n */\nexport function Webhook(config: WebhookConfig) {\n return async function POST(request: Request): Promise<Response> {\n const payload = await request.text();\n const signature = request.headers.get(\"x-waffo-signature\");\n\n let event: WebhookEvent;\n try {\n event = verifyWebhook(payload, signature, config.verifyOptions);\n } catch (error) {\n const message = error instanceof Error ? error.message : \"Webhook verification failed\";\n return new Response(JSON.stringify({ error: message }), {\n status: 401,\n headers: { \"Content-Type\": \"application/json\" },\n });\n }\n\n try {\n // Catch-all handler\n if (config.onPayload) {\n await config.onPayload(event);\n }\n\n // Event-specific handler\n const handlerKey = EVENT_HANDLER_MAP[event.eventType];\n if (handlerKey) {\n const handler = config[handlerKey] as EventHandler | undefined;\n if (handler) {\n await handler(event);\n }\n }\n\n return new Response(JSON.stringify({ received: true }), {\n status: 200,\n headers: { \"Content-Type\": \"application/json\" },\n });\n } catch (error) {\n const message = error instanceof Error ? error.message : \"Webhook handler error\";\n return new Response(JSON.stringify({ error: message }), {\n status: 500,\n headers: { \"Content-Type\": \"application/json\" },\n });\n }\n };\n}\n"],"mappings":"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","names":["import_react","import_jsx_runtime","import_react","import_react","import_react","import_react","import_pancake_ts"]}
1
+ {"version":3,"sources":["../src/index.ts","../src/provider.tsx","../src/use-checkout.ts","../src/checkout-button.tsx","../src/use-customer.ts","../src/use-customer-data.ts","../src/use-query.ts","../src/use-merchant-data.ts","../src/webhook.ts"],"sourcesContent":["export { WaffoPancakeProvider } from \"./provider.js\";\nexport { CheckoutButton } from \"./checkout-button.js\";\nexport { useCheckout } from \"./use-checkout.js\";\nexport { useCustomer, useBuyer } from \"./use-customer.js\";\nexport {\n useCustomerOrders,\n useCustomerPayments,\n useCustomerRefundTickets,\n useBuyerOrders,\n useBuyerPayments,\n useBuyerRefundTickets,\n} from \"./use-customer-data.js\";\nexport { useMerchantOrders, useMerchantSales, useMerchantSubscriptions } from \"./use-merchant-data.js\";\nexport { Webhook } from \"./webhook.js\";\n\n// Re-export types commonly used in client components\nexport { WaffoPancakeError, TaxCategory, WebhookEventType } from \"@waffo/pancake-ts\";\n\nexport type { PriceInfo, BillingDetail, RequestedAmount, RefundTicketVersionData, WebhookEvent, WebhookEventData } from \"@waffo/pancake-ts\";\n\n// Local types\nexport type {\n CheckoutMode,\n CheckoutBaseOptions,\n LinkCheckoutProps,\n AnonymousCheckoutProps,\n AuthenticatedCheckoutProps,\n CheckoutProps,\n UseCheckoutReturn,\n} from \"./types.js\";\n\nexport type { CustomerConfig, BuyerConfig, WaffoPancakeProviderProps } from \"./provider.js\";\n\nexport type {\n CheckoutButtonProps,\n LinkCheckoutButtonProps,\n AnonymousCheckoutButtonProps,\n AuthenticatedCheckoutButtonProps,\n} from \"./checkout-button.js\";\n\nexport type { CustomerActionState, UseCustomerReturn, BuyerActionState, UseBuyerReturn } from \"./use-customer.js\";\n\nexport type { QueryState } from \"./use-query.js\";\n\nexport type {\n CustomerOnetimeOrder,\n CustomerSubscriptionOrder,\n CustomerPayment,\n CustomerRefundTicket,\n BuyerOnetimeOrder,\n BuyerSubscriptionOrder,\n BuyerPayment,\n BuyerRefundTicket,\n} from \"./use-customer-data.js\";\n\nexport type {\n MerchantOrder,\n MerchantSubscription,\n SalesOverview,\n SubscriptionOverview,\n MerchantOrdersOptions,\n} from \"./use-merchant-data.js\";\n\nexport type { WebhookConfig } from \"./webhook.js\";\n\n// Server action types (for typing the action prop)\nexport type {\n CheckoutAction,\n CheckoutActionParams,\n CheckoutActionResult,\n CustomerTokenAction,\n CustomerSessionAction,\n BuyerTokenAction,\n BuyerSessionAction,\n MerchantQueryAction,\n} from \"./server.js\";\n","\"use client\";\n\nimport React, { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from \"react\";\n\nimport type { CustomerTokenAction, CustomerSessionAction } from \"./server.js\";\n\n/** Customer configuration for automatic token management */\nexport interface CustomerConfig {\n /** Customer identity (email or merchant-provided identifier) */\n identity: string;\n /** Store ID (optional when `productId` is provided) */\n storeId?: string;\n /** Product ID — used to derive the store when `storeId` is omitted */\n productId?: string;\n /** Server action for issuing tokens — from `createCustomerTokenAction()` */\n issueToken: CustomerTokenAction;\n /** Server action for customer operations — from `createCustomerSessionAction()` */\n sessionAction: CustomerSessionAction;\n}\n\n/** @deprecated Use {@link CustomerConfig} instead. */\nexport type BuyerConfig = CustomerConfig;\n\ninterface TokenState {\n token: string;\n expiresAt: number;\n}\n\n/** @internal */\nexport interface PancakeContextValue {\n /** Get a valid customer token (auto-refreshes if expired) */\n getCustomerToken: () => Promise<string>;\n /** Execute a customer session operation via server action */\n customerSessionAction: CustomerSessionAction;\n /** Whether customer config is provided */\n hasCustomer: boolean;\n /** Whether the initial token is ready */\n isCustomerReady: boolean;\n}\n\n/** @internal Exported for direct useContext access in hooks */\nexport const PancakeContext = createContext<PancakeContextValue | null>(null);\n\n/** Token refresh buffer — refresh 30s before actual expiry */\nconst REFRESH_BUFFER_MS = 30_000;\n\nexport interface WaffoPancakeProviderProps {\n /** Customer configuration for automatic token management */\n customer?: CustomerConfig;\n /** @deprecated Use `customer` instead. */\n buyer?: CustomerConfig;\n children: React.ReactNode;\n}\n\n/**\n * Provider that manages customer token lifecycle via server actions.\n *\n * Auto-issues session tokens on mount and refreshes before expiry.\n * All customer hooks (`useCustomer`, `useCustomerOrders`, etc.) read from context.\n *\n * The private key never leaves the server — token issuance and customer\n * operations are delegated to server actions.\n *\n * @param props - Provider configuration\n * @param props.customer - Customer identity and server actions\n * @param props.buyer - Deprecated alias of `customer`\n * @param props.children - React children\n *\n * @example\n * ```tsx\n * // identity must match what you passed as `buyerIdentity` at checkout time —\n * // customer-portal lookups are keyed by merchant_provided_buyer_identity\n * <WaffoPancakeProvider customer={{\n * identity: user.id,\n * storeId: \"STO_xxx\",\n * issueToken, // from createCustomerTokenAction()\n * sessionAction, // from createCustomerSessionAction()\n * }}>\n * <App />\n * </WaffoPancakeProvider>\n * ```\n */\nexport function WaffoPancakeProvider({ customer, buyer, children }: WaffoPancakeProviderProps) {\n const config = customer ?? buyer;\n if (!config) throw new Error(\"WaffoPancakeProvider: the `customer` prop is required\");\n\n const tokenRef = useRef<TokenState | null>(null);\n const refreshPromiseRef = useRef<Promise<string> | null>(null);\n const [isCustomerReady, setIsCustomerReady] = useState(false);\n\n const refreshToken = useCallback(async (): Promise<string> => {\n const result = await config.issueToken({\n buyerIdentity: config.identity,\n storeId: config.storeId,\n productId: config.productId,\n });\n\n tokenRef.current = {\n token: result.token,\n expiresAt: new Date(result.expiresAt).getTime(),\n };\n\n return result.token;\n }, [config]);\n\n const getCustomerToken = useCallback(async (): Promise<string> => {\n const current = tokenRef.current;\n if (current && Date.now() < current.expiresAt - REFRESH_BUFFER_MS) {\n return current.token;\n }\n\n // Deduplicate concurrent refresh calls\n if (!refreshPromiseRef.current) {\n refreshPromiseRef.current = refreshToken().finally(() => {\n refreshPromiseRef.current = null;\n });\n }\n\n return refreshPromiseRef.current;\n }, [refreshToken]);\n\n // Issue initial token on mount\n useEffect(() => {\n refreshToken()\n .then(() => setIsCustomerReady(true))\n .catch(() => setIsCustomerReady(true));\n }, [refreshToken]);\n\n const value = useMemo<PancakeContextValue>(\n () => ({\n getCustomerToken,\n customerSessionAction: config.sessionAction,\n hasCustomer: true,\n isCustomerReady,\n }),\n [getCustomerToken, config.sessionAction, isCustomerReady],\n );\n\n return <PancakeContext.Provider value={value}>{children}</PancakeContext.Provider>;\n}\n\n/**\n * Access the Waffo Pancake context. Must be used within `<WaffoPancakeProvider>`.\n */\nexport function usePancakeContext(): PancakeContextValue {\n const ctx = useContext(PancakeContext);\n if (!ctx) throw new Error(\"usePancakeContext: must be used within <WaffoPancakeProvider>\");\n return ctx;\n}\n","\"use client\";\n\nimport { useCallback, useRef, useState } from \"react\";\n\nimport type { CheckoutProps, LinkCheckoutProps, UseCheckoutReturn } from \"./types.js\";\nimport type { CheckoutSessionResult, AuthenticatedCheckoutResult } from \"@waffo/pancake-ts\";\n\n\nconst LOADING_HTML = `<!DOCTYPE html><html><head><meta charset=\"utf-8\"><title>Loading...</title><style>body{display:flex;align-items:center;justify-content:center;height:100vh;margin:0;font-family:system-ui,sans-serif;background:#f9fafb;color:#6b7280}@media(prefers-color-scheme:dark){body{background:#111827;color:#9ca3af}}</style></head><body><p>Redirecting to checkout...</p></body></html>`;\n\nconst DEFAULT_STOREFRONT_URL = \"https://pancake.waffo.ai\";\n\nconst SDK_FIELDS = new Set([\"action\", \"type\", \"mode\", \"popupLoadingUrl\", \"onSuccess\", \"onError\"]);\n\n/** Extract API checkout params from flattened props, removing SDK-specific fields */\nfunction extractApiParams(args: object): Record<string, unknown> {\n const params: Record<string, unknown> = {};\n for (const [key, value] of Object.entries(args)) {\n if (!SDK_FIELDS.has(key)) params[key] = value;\n }\n return params;\n}\n\n/**\n * Build a product page URL for link checkout.\n */\nfunction buildLinkUrl(props: LinkCheckoutProps): string {\n const base = (props.baseUrl ?? DEFAULT_STOREFRONT_URL).replace(/\\/+$/, \"\");\n const url = new URL(`${base}/store/${props.storeSlug}/product/${props.productId}`);\n\n if (props.currency) url.searchParams.set(\"currency\", props.currency);\n if (props.email) url.searchParams.set(\"email\", props.email);\n if (props.successUrl) url.searchParams.set(\"success_url\", props.successUrl);\n if (props.test) url.searchParams.set(\"test\", \"true\");\n if (props.country) url.searchParams.set(\"country\", props.country);\n if (props.isBusiness) url.searchParams.set(\"is_business\", \"true\");\n\n return url.toString();\n}\n\n/**\n * React hook for triggering a Waffo Pancake checkout flow.\n *\n * Supports three checkout types:\n * - **link**: Builds a product page URL and navigates directly (no API call, synchronous)\n * - **anonymous**: Calls a server action to create a checkout session, then navigates\n * - **authenticated**: Calls a server action to create a session + token, then navigates\n *\n * The private key never leaves the server — anonymous and authenticated modes\n * use a server action created by `createCheckoutAction()`.\n *\n * @param args - Flattened checkout props\n * @returns `{ checkout, isLoading, error }`\n *\n * @example\n * ```tsx\n * // Link checkout — no server action needed\n * const { checkout } = useCheckout({\n * type: \"link\",\n * storeSlug: \"my-store\",\n * productId: \"PROD_xxx\",\n * currency: \"USD\",\n * });\n *\n * // Anonymous checkout — via server action\n * const { checkout, isLoading } = useCheckout({\n * action: checkout, // from createCheckoutAction()\n * productId: \"PROD_xxx\",\n * currency: \"USD\",\n * });\n * ```\n */\nexport function useCheckout(args: CheckoutProps): UseCheckoutReturn {\n const { mode = \"redirect\", popupLoadingUrl, onError } = args;\n const [isLoading, setIsLoading] = useState(false);\n const [error, setError] = useState<Error | null>(null);\n const popupRef = useRef<Window | null>(null);\n\n const checkout = useCallback(() => {\n if (isLoading) return;\n\n // Link checkout — synchronous, no API call\n if (args.type === \"link\") {\n const url = buildLinkUrl(args);\n if (mode === \"popup\") {\n window.open(url, \"_blank\");\n } else {\n window.location.href = url;\n }\n return;\n }\n\n // Anonymous / Authenticated — server action\n if (mode === \"popup\") {\n const loadingUrl = popupLoadingUrl ?? `data:text/html;charset=utf-8,${encodeURIComponent(LOADING_HTML)}`;\n popupRef.current = window.open(loadingUrl, \"_blank\");\n }\n\n setIsLoading(true);\n setError(null);\n\n const { action } = args;\n const params = extractApiParams(args);\n const actionParams = args.type === \"authenticated\" ? { type: \"authenticated\" as const, ...params } : params;\n\n action(actionParams as unknown as Parameters<typeof action>[0])\n .then((result: CheckoutSessionResult | AuthenticatedCheckoutResult) => {\n if (mode === \"popup\" && popupRef.current) {\n popupRef.current.location.href = result.checkoutUrl;\n } else {\n window.location.href = result.checkoutUrl;\n }\n if (\"onSuccess\" in args && args.onSuccess) {\n (args.onSuccess as (r: CheckoutSessionResult | AuthenticatedCheckoutResult) => void)(result);\n }\n })\n .catch((err: Error) => {\n if (mode === \"popup\" && popupRef.current) {\n popupRef.current.close();\n popupRef.current = null;\n }\n setError(err);\n onError?.(err);\n })\n .finally(() => {\n setIsLoading(false);\n });\n }, [args, mode, popupLoadingUrl, onError, isLoading]);\n\n return { checkout, isLoading, error };\n}\n","\"use client\";\n\nimport React from \"react\";\n\nimport { useCheckout } from \"./use-checkout.js\";\n\nimport type { CheckoutProps, LinkCheckoutProps, AnonymousCheckoutProps, AuthenticatedCheckoutProps } from \"./types.js\";\n\ntype CheckoutButtonBaseProps = {\n /** Button content */\n children: React.ReactNode;\n /** Content shown while checkout session is being created */\n loadingChildren?: React.ReactNode;\n /** Additional class name */\n className?: string;\n /** Additional inline styles */\n style?: React.CSSProperties;\n /** Disabled state (merged with isLoading) */\n disabled?: boolean;\n} & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, \"onClick\" | \"disabled\" | \"children\">;\n\n/** Props for CheckoutButton — link mode */\nexport type LinkCheckoutButtonProps = CheckoutButtonBaseProps & LinkCheckoutProps;\n\n/** Props for CheckoutButton — anonymous mode */\nexport type AnonymousCheckoutButtonProps = CheckoutButtonBaseProps & AnonymousCheckoutProps;\n\n/** Props for CheckoutButton — authenticated mode */\nexport type AuthenticatedCheckoutButtonProps = CheckoutButtonBaseProps & AuthenticatedCheckoutProps;\n\nexport type CheckoutButtonProps = LinkCheckoutButtonProps | AnonymousCheckoutButtonProps | AuthenticatedCheckoutButtonProps;\n\n/**\n * A button that triggers a Waffo Pancake checkout flow on click.\n *\n * Three checkout types:\n * - **link**: Instant redirect to product page URL (no server action needed)\n * - **anonymous**: Calls server action to create session, then redirects\n * - **authenticated**: Calls server action to create session + token, then redirects\n *\n * The private key never leaves the server — anonymous and authenticated modes\n * use a server action created by `createCheckoutAction()`.\n *\n * @param props - Flattened checkout props, button content, and optional styling\n *\n * @example\n * ```tsx\n * // Link checkout — no server action needed\n * <CheckoutButton type=\"link\" storeSlug=\"my-store\" productId=\"PROD_xxx\" currency=\"USD\">\n * Buy Now\n * </CheckoutButton>\n *\n * // Anonymous checkout — via server action\n * <CheckoutButton action={checkout} productId=\"PROD_xxx\" currency=\"USD\">\n * Buy Now\n * </CheckoutButton>\n *\n * // Authenticated checkout — via server action\n * <CheckoutButton action={checkout} type=\"authenticated\" productId=\"PROD_xxx\" currency=\"USD\" buyerIdentity=\"userIdInYourSystem\" buyerEmail=\"user@example.com\">\n * Buy Now\n * </CheckoutButton>\n * ```\n */\nexport function CheckoutButton(props: CheckoutButtonProps) {\n const { children, loadingChildren, className, style, disabled, ...checkoutProps } = props;\n\n const { checkout, isLoading } = useCheckout(checkoutProps as CheckoutProps);\n\n return (\n <button type=\"button\" onClick={checkout} disabled={disabled || isLoading} className={className} style={style}>\n {isLoading ? (loadingChildren ?? children) : children}\n </button>\n );\n}\n","\"use client\";\n\nimport { useCallback, useContext, useMemo, useState } from \"react\";\n\nimport { PancakeContext } from \"./provider.js\";\n\nimport type {\n CancelSubscriptionParams,\n CancelSubscriptionResult,\n CancelOnetimeOrderParams,\n CancelOnetimeOrderResult,\n ReactivateSubscriptionParams,\n ReactivateSubscriptionResult,\n CreateRefundTicketParams,\n ResubmitRefundTicketParams,\n RefundTicket,\n GraphQLParams,\n GraphQLResponse,\n} from \"@waffo/pancake-ts\";\n\n/** State of an async customer action */\nexport interface CustomerActionState<T = unknown> {\n /** Execute the action */\n execute: (params: T) => Promise<void>;\n /** Whether the action is in progress */\n isLoading: boolean;\n /** Error from the last attempt */\n error: Error | null;\n}\n\n/** Return type of useCustomer hook */\nexport interface UseCustomerReturn {\n /** Cancel a subscription order */\n cancelSubscription: CustomerActionState<CancelSubscriptionParams> & { data: CancelSubscriptionResult | null };\n /** Cancel a one-time order */\n cancelOnetimeOrder: CustomerActionState<CancelOnetimeOrderParams> & { data: CancelOnetimeOrderResult | null };\n /** Reactivate a canceling subscription */\n reactivateSubscription: CustomerActionState<ReactivateSubscriptionParams> & { data: ReactivateSubscriptionResult | null };\n /** Create a refund ticket */\n createRefundTicket: CustomerActionState<CreateRefundTicketParams> & { data: RefundTicket | null };\n /** Resubmit a rejected refund ticket */\n resubmitRefundTicket: CustomerActionState<ResubmitRefundTicketParams> & { data: RefundTicket | null };\n /** Execute a GraphQL query */\n query: <T = Record<string, unknown>>(params: GraphQLParams) => Promise<GraphQLResponse<T>>;\n}\n\nfunction useCustomerAction<TParams, TResult>(\n actionFn: (params: TParams) => Promise<TResult>,\n): CustomerActionState<TParams> & { data: TResult | null } {\n const [isLoading, setIsLoading] = useState(false);\n const [error, setError] = useState<Error | null>(null);\n const [data, setData] = useState<TResult | null>(null);\n\n const execute = useCallback(\n async (params: TParams) => {\n setIsLoading(true);\n setError(null);\n try {\n const result = await actionFn(params);\n setData(result);\n } catch (err) {\n setError(err instanceof Error ? err : new Error(String(err)));\n throw err;\n } finally {\n setIsLoading(false);\n }\n },\n [actionFn],\n );\n\n return { execute, isLoading, error, data };\n}\n\n/**\n * React hook for customer self-service actions.\n *\n * Must be used within `<WaffoPancakeProvider>`. All operations are executed\n * via server actions — the private key never leaves the server.\n *\n * @returns Customer action handlers with loading/error states\n *\n * @example\n * ```tsx\n * function AccountPage() {\n * const customer = useCustomer();\n * return (\n * <button onClick={() => customer.cancelSubscription.execute({ orderId: \"ORD_xxx\" })}>\n * Cancel\n * </button>\n * );\n * }\n * ```\n */\nexport function useCustomer(): UseCustomerReturn {\n const ctx = useContext(PancakeContext);\n if (!ctx) throw new Error(\"useCustomer: must be used within <WaffoPancakeProvider>\");\n\n const { getCustomerToken, customerSessionAction } = ctx;\n\n const callAction = useCallback(\n async (actionType: string, params: unknown) => {\n const token = await getCustomerToken();\n return customerSessionAction(token, actionType as never, params);\n },\n [getCustomerToken, customerSessionAction],\n );\n\n const cancelSubscription = useCustomerAction<CancelSubscriptionParams, CancelSubscriptionResult>(\n useCallback((params) => callAction(\"cancelSubscription\", params) as Promise<CancelSubscriptionResult>, [callAction]),\n );\n\n const cancelOnetimeOrder = useCustomerAction<CancelOnetimeOrderParams, CancelOnetimeOrderResult>(\n useCallback((params) => callAction(\"cancelOnetimeOrder\", params) as Promise<CancelOnetimeOrderResult>, [callAction]),\n );\n\n const reactivateSubscription = useCustomerAction<ReactivateSubscriptionParams, ReactivateSubscriptionResult>(\n useCallback((params) => callAction(\"reactivateSubscription\", params) as Promise<ReactivateSubscriptionResult>, [callAction]),\n );\n\n const createRefundTicket = useCustomerAction<CreateRefundTicketParams, { ticket: RefundTicket }>(\n useCallback((params) => callAction(\"createRefundTicket\", params) as Promise<{ ticket: RefundTicket }>, [callAction]),\n );\n const createRefundTicketMapped = useMemo(\n () => ({ ...createRefundTicket, data: createRefundTicket.data?.ticket ?? null }),\n [createRefundTicket],\n );\n\n const resubmitRefundTicket = useCustomerAction<ResubmitRefundTicketParams, { ticket: RefundTicket }>(\n useCallback((params) => callAction(\"resubmitRefundTicket\", params) as Promise<{ ticket: RefundTicket }>, [callAction]),\n );\n const resubmitRefundTicketMapped = useMemo(\n () => ({ ...resubmitRefundTicket, data: resubmitRefundTicket.data?.ticket ?? null }),\n [resubmitRefundTicket],\n );\n\n const query = useCallback(\n async <T = Record<string, unknown>>(params: GraphQLParams) => {\n const token = await getCustomerToken();\n return customerSessionAction(token, \"query\", params) as Promise<GraphQLResponse<T>>;\n },\n [getCustomerToken, customerSessionAction],\n );\n\n return {\n cancelSubscription,\n cancelOnetimeOrder,\n reactivateSubscription,\n createRefundTicket: createRefundTicketMapped,\n resubmitRefundTicket: resubmitRefundTicketMapped,\n query,\n };\n}\n\n// ============================================================\n// Deprecated Aliases\n// ============================================================\n\n/** @deprecated Use {@link CustomerActionState} instead. */\nexport type BuyerActionState<T = unknown> = CustomerActionState<T>;\n\n/** @deprecated Use {@link UseCustomerReturn} instead. */\nexport type UseBuyerReturn = UseCustomerReturn;\n\n/** @deprecated Use {@link useCustomer} instead. */\nexport const useBuyer = useCustomer;\n","\"use client\";\n\nimport { useCallback, useContext } from \"react\";\n\nimport { PancakeContext } from \"./provider.js\";\nimport { useQuery } from \"./use-query.js\";\n\nimport type { QueryState } from \"./use-query.js\";\nimport type { GraphQLResponse, RefundTicketVersionData } from \"@waffo/pancake-ts\";\n\n// ============================================================\n// Types\n// ============================================================\n\n/** A customer's one-time order */\nexport interface CustomerOnetimeOrder {\n id: string;\n status: string;\n currency: string;\n buyerEmail: string;\n product: { id: string; name: string } | null;\n payments: Array<{ id: string; status: string; snapshotDisplayAmount: string; snapshotDisplayCurrency: string; createdAt: string }>;\n createdAt: string;\n}\n\n/** A customer's subscription order */\nexport interface CustomerSubscriptionOrder {\n id: string;\n status: string;\n currency: string;\n buyerEmail: string;\n currentPeriodStart: string | null;\n currentPeriodEnd: string | null;\n cancelAt: string | null;\n product: { id: string; name: string; billingPeriod: string } | null;\n payments: Array<{ id: string; status: string; snapshotDisplayAmount: string; snapshotDisplayCurrency: string; createdAt: string }>;\n createdAt: string;\n}\n\n/** A customer's payment record */\nexport interface CustomerPayment {\n id: string;\n orderId: string;\n status: string;\n snapshotDisplayAmount: string;\n snapshotDisplayCurrency: string;\n failureReason: string | null;\n createdAt: string;\n}\n\n/**\n * A customer's refund ticket.\n *\n * Ticket-level fields are flat; per-version fields (`reason`, `requestedAmount`)\n * live under `versionData` because the customer can resubmit a rejected ticket and\n * each submission is a versioned record. `versionData` reflects the current\n * (latest) version. The `versionData` shape is shared with `@waffo/pancake-ts`'s\n * `RefundTicketVersionData`.\n */\nexport interface CustomerRefundTicket {\n id: string;\n status: string;\n versionNumber: number | null;\n versionData: RefundTicketVersionData | null;\n createdAt: string;\n}\n\n// ============================================================\n// Queries\n// ============================================================\n\nconst CUSTOMER_ORDERS_QUERY = `query {\n onetimeOrders(limit: 50) {\n id status currency buyerEmail createdAt\n product { id name }\n payments { id status snapshotDisplayAmount snapshotDisplayCurrency createdAt }\n }\n subscriptionOrders(limit: 50) {\n id status currency buyerEmail currentPeriodStart currentPeriodEnd cancelAt createdAt\n product { id name billingPeriod }\n payments { id status snapshotDisplayAmount snapshotDisplayCurrency createdAt }\n }\n}`;\n\nconst CUSTOMER_PAYMENTS_QUERY = `query {\n payments(limit: 50) {\n id orderId status snapshotDisplayAmount snapshotDisplayCurrency failureReason createdAt\n }\n}`;\n\nconst CUSTOMER_REFUND_TICKETS_QUERY = `query {\n refundTickets(limit: 50) {\n id status versionNumber\n versionData {\n reason\n requestedAmount { amount currency }\n }\n createdAt\n }\n}`;\n\n// ============================================================\n// Internal helper\n// ============================================================\n\nfunction useCustomerQuery<T>(query: string): QueryState<T> {\n const ctx = useContext(PancakeContext);\n if (!ctx) throw new Error(\"Customer data hook: must be used within <WaffoPancakeProvider>\");\n\n const { getCustomerToken, customerSessionAction, isCustomerReady } = ctx;\n\n const queryFn = useCallback(async () => {\n const token = await getCustomerToken();\n const result = (await customerSessionAction(token, \"query\", { query })) as unknown as GraphQLResponse<T>;\n return result.data as T;\n }, [getCustomerToken, customerSessionAction, query]);\n\n return useQuery(queryFn, isCustomerReady);\n}\n\n// ============================================================\n// Hooks\n// ============================================================\n\ninterface CustomerOrdersData {\n onetimeOrders: CustomerOnetimeOrder[];\n subscriptionOrders: CustomerSubscriptionOrder[];\n}\n\n/**\n * Fetch the customer's order history (one-time + subscription).\n *\n * Must be used within `<WaffoPancakeProvider>`. Token is auto-managed.\n *\n * @returns Orders with product info and payment history\n *\n * @example\n * ```tsx\n * const { data, isLoading, refetch } = useCustomerOrders();\n * // data.onetimeOrders + data.subscriptionOrders\n * ```\n */\nexport function useCustomerOrders(): QueryState<CustomerOrdersData> {\n return useCustomerQuery<CustomerOrdersData>(CUSTOMER_ORDERS_QUERY);\n}\n\n/**\n * Fetch the customer's payment history.\n *\n * Must be used within `<WaffoPancakeProvider>`. Token is auto-managed.\n *\n * @returns Payment records with amounts and status\n *\n * @example\n * ```tsx\n * const { data: payments, isLoading } = useCustomerPayments();\n * ```\n */\nexport function useCustomerPayments(): QueryState<CustomerPayment[]> {\n const result = useCustomerQuery<{ payments: CustomerPayment[] }>(CUSTOMER_PAYMENTS_QUERY);\n return { ...result, data: result.data?.payments ?? null };\n}\n\n/**\n * Fetch the customer's refund tickets.\n *\n * Must be used within `<WaffoPancakeProvider>`. Token is auto-managed.\n *\n * @returns Refund tickets with status and requested amounts\n *\n * @example\n * ```tsx\n * const { data: tickets, isLoading } = useCustomerRefundTickets();\n * ```\n */\nexport function useCustomerRefundTickets(): QueryState<CustomerRefundTicket[]> {\n const result = useCustomerQuery<{ refundTickets: CustomerRefundTicket[] }>(CUSTOMER_REFUND_TICKETS_QUERY);\n return { ...result, data: result.data?.refundTickets ?? null };\n}\n\n// ============================================================\n// Deprecated Aliases\n// ============================================================\n\n/** @deprecated Use {@link CustomerOnetimeOrder} instead. */\nexport type BuyerOnetimeOrder = CustomerOnetimeOrder;\n\n/** @deprecated Use {@link CustomerSubscriptionOrder} instead. */\nexport type BuyerSubscriptionOrder = CustomerSubscriptionOrder;\n\n/** @deprecated Use {@link CustomerPayment} instead. */\nexport type BuyerPayment = CustomerPayment;\n\n/** @deprecated Use {@link CustomerRefundTicket} instead. */\nexport type BuyerRefundTicket = CustomerRefundTicket;\n\n/** @deprecated Use {@link useCustomerOrders} instead. */\nexport const useBuyerOrders = useCustomerOrders;\n\n/** @deprecated Use {@link useCustomerPayments} instead. */\nexport const useBuyerPayments = useCustomerPayments;\n\n/** @deprecated Use {@link useCustomerRefundTickets} instead. */\nexport const useBuyerRefundTickets = useCustomerRefundTickets;\n","\"use client\";\n\nimport { useCallback, useEffect, useState } from \"react\";\n\n/** Query state with typed data */\nexport interface QueryState<T> {\n data: T | null;\n isLoading: boolean;\n error: Error | null;\n refetch: () => void;\n}\n\n/**\n * Internal hook for async data fetching with loading/error state.\n *\n * @param queryFn - Async function that returns the data\n * @param ready - Whether to start fetching (false = wait)\n * @returns Query state with data, loading, error, and refetch\n */\nexport function useQuery<T>(queryFn: () => Promise<T>, ready: boolean): QueryState<T> {\n const [data, setData] = useState<T | null>(null);\n const [isLoading, setIsLoading] = useState(true);\n const [error, setError] = useState<Error | null>(null);\n\n const fetch = useCallback(() => {\n if (!ready) return;\n setIsLoading(true);\n setError(null);\n queryFn()\n .then(setData)\n .catch((err) => setError(err instanceof Error ? err : new Error(String(err))))\n .finally(() => setIsLoading(false));\n }, [queryFn, ready]);\n\n useEffect(() => {\n fetch();\n }, [fetch]);\n\n return { data, isLoading, error, refetch: fetch };\n}\n","\"use client\";\n\nimport { useCallback } from \"react\";\n\nimport { useQuery } from \"./use-query.js\";\n\nimport type { MerchantQueryAction } from \"./server.js\";\nimport type { QueryState } from \"./use-query.js\";\nimport type { GraphQLResponse } from \"@waffo/pancake-ts\";\n\n// ============================================================\n// Merchant Data Hooks (via server action)\n// ============================================================\n\n/** A merchant's recent order (one-time or subscription) */\nexport interface MerchantOrder {\n id: string;\n status: string;\n currency: string;\n buyerEmail: string;\n testMode: boolean;\n product: { id: string; name: string } | null;\n payments: Array<{ id: string; status: string; snapshotDisplayAmount: string; snapshotDisplayCurrency: string }>;\n createdAt: string;\n}\n\n/**\n * Sales overview statistics.\n *\n * Monetary fields (`totalRevenue`, `revenueByPeriod[].amount`) are returned as\n * display-formatted strings (e.g., `\"9.99\"`), not minor-currency-unit integers.\n * The conversion happens server-side via the GraphQL `currencyDisplayLoader`.\n */\nexport interface SalesOverview {\n totalOrders: number;\n /** Total succeeded payment revenue as display string (e.g., `\"1234.56\"`) */\n totalRevenue: string;\n totalCustomers: number;\n currency: string;\n ordersByStatus: Array<{ status: string; count: number }>;\n /** Revenue by period; `amount` is a display string (e.g., `\"9.99\"`) */\n revenueByPeriod: Array<{ period: string; amount: string }>;\n}\n\n/** Subscription overview */\nexport interface SubscriptionOverview {\n activeCount: number;\n cancelingCount: number;\n pastDueCount: number;\n totalCount: number;\n subscriptions: MerchantSubscription[];\n}\n\n/** A merchant's subscription with status details */\nexport interface MerchantSubscription {\n id: string;\n status: string;\n currency: string;\n buyerEmail: string;\n currentPeriodStart: string | null;\n currentPeriodEnd: string | null;\n cancelAt: string | null;\n product: { id: string; name: string; billingPeriod: string } | null;\n createdAt: string;\n}\n\nexport interface MerchantOrdersOptions {\n /** Store ID to filter by */\n storeId: string;\n /** Max results (default: 20) */\n limit?: number;\n}\n\nconst MERCHANT_ORDERS_QUERY = `query ($storeId: ID!, $limit: Int) {\n onetimeOrders(storeId: $storeId, limit: $limit) {\n id status currency buyerEmail testMode createdAt\n product { id name }\n payments { id status snapshotDisplayAmount snapshotDisplayCurrency }\n }\n subscriptionOrders(storeId: $storeId, limit: $limit) {\n id status currency buyerEmail testMode createdAt\n product { id name }\n payments { id status snapshotDisplayAmount snapshotDisplayCurrency }\n }\n}`;\n\n/**\n * Fetch recent orders for a store (one-time + subscription).\n *\n * @param query - Server action from `createMerchantQueryAction()`\n * @param options - Store ID and optional limit\n * @returns Recent orders with product info and payment summary\n *\n * @example\n * ```tsx\n * const { data, isLoading, refetch } = useMerchantOrders(merchantQuery, { storeId: \"STO_xxx\" });\n * ```\n */\nexport function useMerchantOrders(\n query: MerchantQueryAction,\n options: MerchantOrdersOptions,\n): QueryState<{ onetimeOrders: MerchantOrder[]; subscriptionOrders: MerchantOrder[] }> {\n const { storeId, limit = 20 } = options;\n\n const queryFn = useCallback(async () => {\n const result = (await query({\n query: MERCHANT_ORDERS_QUERY,\n variables: { storeId, limit },\n })) as unknown as GraphQLResponse<{ onetimeOrders: MerchantOrder[]; subscriptionOrders: MerchantOrder[] }>;\n return result.data as { onetimeOrders: MerchantOrder[]; subscriptionOrders: MerchantOrder[] };\n }, [query, storeId, limit]);\n\n return useQuery(queryFn, true);\n}\n\nconst MERCHANT_SALES_QUERY = `query ($storeId: ID!) {\n orderStatistics(storeId: $storeId) {\n totalCount\n countByStatus { status count }\n }\n paymentStatistics(storeId: $storeId) {\n totalSucceededAmount\n totalSucceededCurrency\n totalSucceededCount\n }\n customerAnalysis(storeId: $storeId) {\n totalCustomers\n }\n trendAnalysis(storeId: $storeId) {\n revenueByPeriod { period amount }\n }\n}`;\n\ninterface SalesQueryData {\n orderStatistics: { totalCount: number; countByStatus: Array<{ status: string; count: number }> };\n paymentStatistics: { totalSucceededAmount: string; totalSucceededCurrency: string; totalSucceededCount: number };\n customerAnalysis: { totalCustomers: number };\n trendAnalysis: { revenueByPeriod: Array<{ period: string; amount: string }> };\n}\n\n/**\n * Fetch sales overview for a store.\n *\n * @param query - Server action from `createMerchantQueryAction()`\n * @param storeId - Store ID\n * @returns Aggregated sales statistics\n *\n * @example\n * ```tsx\n * const { data: sales } = useMerchantSales(merchantQuery, \"STO_xxx\");\n * ```\n */\nexport function useMerchantSales(query: MerchantQueryAction, storeId: string): QueryState<SalesOverview> {\n const queryFn = useCallback(async () => {\n const result = (await query({\n query: MERCHANT_SALES_QUERY,\n variables: { storeId },\n })) as unknown as GraphQLResponse<SalesQueryData>;\n const d = result.data as SalesQueryData;\n return {\n totalOrders: d.orderStatistics.totalCount,\n totalRevenue: d.paymentStatistics.totalSucceededAmount,\n totalCustomers: d.customerAnalysis.totalCustomers,\n currency: d.paymentStatistics.totalSucceededCurrency,\n ordersByStatus: d.orderStatistics.countByStatus,\n revenueByPeriod: d.trendAnalysis.revenueByPeriod,\n };\n }, [query, storeId]);\n\n return useQuery(queryFn, true);\n}\n\nconst MERCHANT_SUBSCRIPTIONS_QUERY = `query ($storeId: ID!) {\n subscriptionOrders(storeId: $storeId, limit: 100) {\n id status currency buyerEmail currentPeriodStart currentPeriodEnd cancelAt createdAt\n product { id name billingPeriod }\n }\n}`;\n\n/**\n * Fetch subscription overview for a store.\n *\n * @param query - Server action from `createMerchantQueryAction()`\n * @param storeId - Store ID\n * @returns Subscription counts and detailed list\n *\n * @example\n * ```tsx\n * const { data: subs } = useMerchantSubscriptions(merchantQuery, \"STO_xxx\");\n * ```\n */\nexport function useMerchantSubscriptions(query: MerchantQueryAction, storeId: string): QueryState<SubscriptionOverview> {\n const queryFn = useCallback(async () => {\n const result = (await query({\n query: MERCHANT_SUBSCRIPTIONS_QUERY,\n variables: { storeId },\n })) as unknown as GraphQLResponse<{ subscriptionOrders: MerchantSubscription[] }>;\n const subs = (result.data as { subscriptionOrders: MerchantSubscription[] }).subscriptionOrders;\n return {\n activeCount: subs.filter((s) => s.status === \"active\").length,\n cancelingCount: subs.filter((s) => s.status === \"canceling\").length,\n pastDueCount: subs.filter((s) => s.status === \"past_due\").length,\n totalCount: subs.length,\n subscriptions: subs,\n };\n }, [query, storeId]);\n\n return useQuery(queryFn, true);\n}\n","import { verifyWebhook } from \"@waffo/pancake-ts\";\n\nimport type { VerifyWebhookOptions, WebhookEvent, WebhookEventData } from \"@waffo/pancake-ts\";\n\n/** Handler function for a specific webhook event */\ntype EventHandler<T = WebhookEventData> = (event: WebhookEvent<T>) => void | Promise<void>;\n\n/** Configuration for the Webhook route handler factory */\nexport interface WebhookConfig {\n /** Webhook signature verification options (environment, publicKey, tolerance, etc.) */\n verifyOptions?: VerifyWebhookOptions;\n\n /** Catch-all handler — called for every event regardless of type */\n onPayload?: EventHandler;\n\n /** One-time order first payment succeeded */\n onOrderCompleted?: EventHandler;\n /** Subscription first payment succeeded (newly activated) */\n onSubscriptionActivated?: EventHandler;\n /** Subscription renewal payment succeeded */\n onSubscriptionPaymentSucceeded?: EventHandler;\n /** Customer initiated cancellation (expires at end of current period) */\n onSubscriptionCanceling?: EventHandler;\n /** Customer withdrew cancellation (subscription restored) */\n onSubscriptionUncanceled?: EventHandler;\n /** Subscription product changed (upgrade/downgrade) */\n onSubscriptionUpdated?: EventHandler;\n /** Subscription fully terminated */\n onSubscriptionCanceled?: EventHandler;\n /** Renewal payment failed (past due) */\n onSubscriptionPastDue?: EventHandler;\n /** Refund succeeded */\n onRefundSucceeded?: EventHandler;\n /** Refund failed */\n onRefundFailed?: EventHandler;\n}\n\n/* eslint-disable @typescript-eslint/naming-convention -- event type keys use dot notation */\nconst EVENT_HANDLER_MAP: Record<string, keyof WebhookConfig> = {\n \"order.completed\": \"onOrderCompleted\",\n \"subscription.activated\": \"onSubscriptionActivated\",\n \"subscription.payment_succeeded\": \"onSubscriptionPaymentSucceeded\",\n \"subscription.canceling\": \"onSubscriptionCanceling\",\n \"subscription.uncanceled\": \"onSubscriptionUncanceled\",\n \"subscription.updated\": \"onSubscriptionUpdated\",\n \"subscription.canceled\": \"onSubscriptionCanceled\",\n \"subscription.past_due\": \"onSubscriptionPastDue\",\n \"refund.succeeded\": \"onRefundSucceeded\",\n \"refund.failed\": \"onRefundFailed\",\n};\n/* eslint-enable @typescript-eslint/naming-convention */\n\n/**\n * Create a Next.js POST route handler for Waffo Pancake webhooks.\n *\n * Automatically verifies the webhook signature using `@waffo/pancake-ts`,\n * then dispatches to the matching event handler.\n *\n * @param config - Verification options and event handlers\n * @returns A Next.js POST route handler\n *\n * @example\n * ```ts\n * // app/api/webhooks/waffo/route.ts\n * import { Webhook } from \"@waffo/pancake-nextjs\";\n *\n * export const POST = Webhook({\n * verifyOptions: { environment: \"prod\" },\n * onOrderCompleted: async (event) => {\n * console.log(\"Order completed:\", event.data.orderId);\n * // Grant access to the product\n * },\n * onSubscriptionActivated: async (event) => {\n * console.log(\"Subscription activated:\", event.data.orderId);\n * },\n * onRefundSucceeded: async (event) => {\n * console.log(\"Refund succeeded:\", event.data.refundId);\n * // Revoke access\n * },\n * });\n * ```\n */\nexport function Webhook(config: WebhookConfig) {\n return async function POST(request: Request): Promise<Response> {\n const payload = await request.text();\n const signature = request.headers.get(\"x-waffo-signature\");\n\n let event: WebhookEvent;\n try {\n event = verifyWebhook(payload, signature, config.verifyOptions);\n } catch (error) {\n const message = error instanceof Error ? error.message : \"Webhook verification failed\";\n return new Response(JSON.stringify({ error: message }), {\n status: 401,\n headers: { \"Content-Type\": \"application/json\" },\n });\n }\n\n try {\n // Catch-all handler\n if (config.onPayload) {\n await config.onPayload(event);\n }\n\n // Event-specific handler\n const handlerKey = EVENT_HANDLER_MAP[event.eventType];\n if (handlerKey) {\n const handler = config[handlerKey] as EventHandler | undefined;\n if (handler) {\n await handler(event);\n }\n }\n\n return new Response(JSON.stringify({ received: true }), {\n status: 200,\n headers: { \"Content-Type\": \"application/json\" },\n });\n } catch (error) {\n const message = error instanceof Error ? error.message : \"Webhook handler error\";\n return new Response(JSON.stringify({ error: message }), {\n status: 500,\n headers: { \"Content-Type\": \"application/json\" },\n });\n }\n };\n}\n"],"mappings":"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","names":["import_react","import_jsx_runtime","import_react","import_react","import_react","import_react","import_pancake_ts"]}
package/dist/index.d.cts CHANGED
@@ -13,61 +13,70 @@ type CheckoutActionParams = ({
13
13
  type CheckoutActionResult = CheckoutSessionResult | AuthenticatedCheckoutResult;
14
14
  /** Server action signature for checkout */
15
15
  type CheckoutAction = (params: CheckoutActionParams) => Promise<CheckoutActionResult>;
16
- /** Server action signature for issuing buyer tokens */
17
- type BuyerTokenAction = (params: IssueSessionTokenParams) => Promise<SessionToken>;
18
- /** Buyer action types */
19
- type BuyerSessionActionType = "cancelSubscription" | "cancelOnetimeOrder" | "reactivateSubscription" | "createRefundTicket" | "resubmitRefundTicket" | "query";
20
- /** Server action signature for buyer session operations */
21
- type BuyerSessionAction = (token: string, actionType: BuyerSessionActionType, params: unknown) => Promise<unknown>;
16
+ /** Server action signature for issuing customer tokens */
17
+ type CustomerTokenAction = (params: IssueSessionTokenParams) => Promise<SessionToken>;
18
+ /** Customer action types */
19
+ type CustomerSessionActionType = "cancelSubscription" | "cancelOnetimeOrder" | "reactivateSubscription" | "createRefundTicket" | "resubmitRefundTicket" | "query";
20
+ /** Server action signature for customer session operations */
21
+ type CustomerSessionAction = (token: string, actionType: CustomerSessionActionType, params: unknown) => Promise<unknown>;
22
22
  /** Server action signature for merchant GraphQL queries */
23
23
  type MerchantQueryAction = (params: GraphQLParams) => Promise<GraphQLResponse>;
24
+ /** @deprecated Use {@link CustomerTokenAction} instead. */
25
+ type BuyerTokenAction = CustomerTokenAction;
26
+ /** @deprecated Use {@link CustomerSessionAction} instead. */
27
+ type BuyerSessionAction = CustomerSessionAction;
24
28
 
25
- /** Buyer configuration for automatic token management */
26
- interface BuyerConfig {
27
- /** Buyer identity (email or merchant-provided identifier) */
29
+ /** Customer configuration for automatic token management */
30
+ interface CustomerConfig {
31
+ /** Customer identity (email or merchant-provided identifier) */
28
32
  identity: string;
29
33
  /** Store ID (optional when `productId` is provided) */
30
34
  storeId?: string;
31
35
  /** Product ID — used to derive the store when `storeId` is omitted */
32
36
  productId?: string;
33
- /** Server action for issuing tokens — from `createBuyerTokenAction()` */
34
- issueToken: BuyerTokenAction;
35
- /** Server action for buyer operations — from `createBuyerSessionAction()` */
36
- sessionAction: BuyerSessionAction;
37
+ /** Server action for issuing tokens — from `createCustomerTokenAction()` */
38
+ issueToken: CustomerTokenAction;
39
+ /** Server action for customer operations — from `createCustomerSessionAction()` */
40
+ sessionAction: CustomerSessionAction;
37
41
  }
42
+ /** @deprecated Use {@link CustomerConfig} instead. */
43
+ type BuyerConfig = CustomerConfig;
38
44
  interface WaffoPancakeProviderProps {
39
- /** Buyer configuration for automatic token management */
40
- buyer: BuyerConfig;
45
+ /** Customer configuration for automatic token management */
46
+ customer?: CustomerConfig;
47
+ /** @deprecated Use `customer` instead. */
48
+ buyer?: CustomerConfig;
41
49
  children: React.ReactNode;
42
50
  }
43
51
  /**
44
- * Provider that manages buyer token lifecycle via server actions.
52
+ * Provider that manages customer token lifecycle via server actions.
45
53
  *
46
54
  * Auto-issues session tokens on mount and refreshes before expiry.
47
- * All buyer hooks (`useBuyer`, `useBuyerOrders`, etc.) read from context.
55
+ * All customer hooks (`useCustomer`, `useCustomerOrders`, etc.) read from context.
48
56
  *
49
- * The private key never leaves the server — token issuance and buyer
57
+ * The private key never leaves the server — token issuance and customer
50
58
  * operations are delegated to server actions.
51
59
  *
52
60
  * @param props - Provider configuration
53
- * @param props.buyer - Buyer identity and server actions
61
+ * @param props.customer - Customer identity and server actions
62
+ * @param props.buyer - Deprecated alias of `customer`
54
63
  * @param props.children - React children
55
64
  *
56
65
  * @example
57
66
  * ```tsx
58
67
  * // identity must match what you passed as `buyerIdentity` at checkout time —
59
- * // buyer-portal lookups are keyed by merchant_provided_buyer_identity
60
- * <WaffoPancakeProvider buyer={{
68
+ * // customer-portal lookups are keyed by merchant_provided_buyer_identity
69
+ * <WaffoPancakeProvider customer={{
61
70
  * identity: user.id,
62
71
  * storeId: "STO_xxx",
63
- * issueToken, // from createBuyerTokenAction()
64
- * sessionAction, // from createBuyerSessionAction()
72
+ * issueToken, // from createCustomerTokenAction()
73
+ * sessionAction, // from createCustomerSessionAction()
65
74
  * }}>
66
75
  * <App />
67
76
  * </WaffoPancakeProvider>
68
77
  * ```
69
78
  */
70
- declare function WaffoPancakeProvider({ buyer, children }: WaffoPancakeProviderProps): react_jsx_runtime.JSX.Element;
79
+ declare function WaffoPancakeProvider({ customer, buyer, children }: WaffoPancakeProviderProps): react_jsx_runtime.JSX.Element;
71
80
 
72
81
  /** Redirect mode for checkout navigation */
73
82
  type CheckoutMode = "redirect" | "popup";
@@ -92,7 +101,7 @@ interface LinkCheckoutProps extends CheckoutBaseOptions {
92
101
  productId: string;
93
102
  /** Currency code (ISO 4217). If omitted, product page auto-detects. */
94
103
  currency?: string;
95
- /** Pre-fill buyer email */
104
+ /** Pre-fill customer email */
96
105
  email?: string;
97
106
  /** Redirect URL after successful payment */
98
107
  successUrl?: string;
@@ -221,8 +230,8 @@ declare function CheckoutButton(props: CheckoutButtonProps): react_jsx_runtime.J
221
230
  */
222
231
  declare function useCheckout(args: CheckoutProps): UseCheckoutReturn;
223
232
 
224
- /** State of an async buyer action */
225
- interface BuyerActionState<T = unknown> {
233
+ /** State of an async customer action */
234
+ interface CustomerActionState<T = unknown> {
226
235
  /** Execute the action */
227
236
  execute: (params: T) => Promise<void>;
228
237
  /** Whether the action is in progress */
@@ -230,52 +239,58 @@ interface BuyerActionState<T = unknown> {
230
239
  /** Error from the last attempt */
231
240
  error: Error | null;
232
241
  }
233
- /** Return type of useBuyer hook */
234
- interface UseBuyerReturn {
242
+ /** Return type of useCustomer hook */
243
+ interface UseCustomerReturn {
235
244
  /** Cancel a subscription order */
236
- cancelSubscription: BuyerActionState<CancelSubscriptionParams> & {
245
+ cancelSubscription: CustomerActionState<CancelSubscriptionParams> & {
237
246
  data: CancelSubscriptionResult | null;
238
247
  };
239
248
  /** Cancel a one-time order */
240
- cancelOnetimeOrder: BuyerActionState<CancelOnetimeOrderParams> & {
249
+ cancelOnetimeOrder: CustomerActionState<CancelOnetimeOrderParams> & {
241
250
  data: CancelOnetimeOrderResult | null;
242
251
  };
243
252
  /** Reactivate a canceling subscription */
244
- reactivateSubscription: BuyerActionState<ReactivateSubscriptionParams> & {
253
+ reactivateSubscription: CustomerActionState<ReactivateSubscriptionParams> & {
245
254
  data: ReactivateSubscriptionResult | null;
246
255
  };
247
256
  /** Create a refund ticket */
248
- createRefundTicket: BuyerActionState<CreateRefundTicketParams> & {
257
+ createRefundTicket: CustomerActionState<CreateRefundTicketParams> & {
249
258
  data: RefundTicket | null;
250
259
  };
251
260
  /** Resubmit a rejected refund ticket */
252
- resubmitRefundTicket: BuyerActionState<ResubmitRefundTicketParams> & {
261
+ resubmitRefundTicket: CustomerActionState<ResubmitRefundTicketParams> & {
253
262
  data: RefundTicket | null;
254
263
  };
255
264
  /** Execute a GraphQL query */
256
265
  query: <T = Record<string, unknown>>(params: GraphQLParams) => Promise<GraphQLResponse<T>>;
257
266
  }
258
267
  /**
259
- * React hook for buyer self-service actions.
268
+ * React hook for customer self-service actions.
260
269
  *
261
270
  * Must be used within `<WaffoPancakeProvider>`. All operations are executed
262
271
  * via server actions — the private key never leaves the server.
263
272
  *
264
- * @returns Buyer action handlers with loading/error states
273
+ * @returns Customer action handlers with loading/error states
265
274
  *
266
275
  * @example
267
276
  * ```tsx
268
277
  * function AccountPage() {
269
- * const buyer = useBuyer();
278
+ * const customer = useCustomer();
270
279
  * return (
271
- * <button onClick={() => buyer.cancelSubscription.execute({ orderId: "ORD_xxx" })}>
280
+ * <button onClick={() => customer.cancelSubscription.execute({ orderId: "ORD_xxx" })}>
272
281
  * Cancel
273
282
  * </button>
274
283
  * );
275
284
  * }
276
285
  * ```
277
286
  */
278
- declare function useBuyer(): UseBuyerReturn;
287
+ declare function useCustomer(): UseCustomerReturn;
288
+ /** @deprecated Use {@link CustomerActionState} instead. */
289
+ type BuyerActionState<T = unknown> = CustomerActionState<T>;
290
+ /** @deprecated Use {@link UseCustomerReturn} instead. */
291
+ type UseBuyerReturn = UseCustomerReturn;
292
+ /** @deprecated Use {@link useCustomer} instead. */
293
+ declare const useBuyer: typeof useCustomer;
279
294
 
280
295
  /** Query state with typed data */
281
296
  interface QueryState<T> {
@@ -285,8 +300,8 @@ interface QueryState<T> {
285
300
  refetch: () => void;
286
301
  }
287
302
 
288
- /** A buyer's one-time order */
289
- interface BuyerOnetimeOrder {
303
+ /** A customer's one-time order */
304
+ interface CustomerOnetimeOrder {
290
305
  id: string;
291
306
  status: string;
292
307
  currency: string;
@@ -304,8 +319,8 @@ interface BuyerOnetimeOrder {
304
319
  }>;
305
320
  createdAt: string;
306
321
  }
307
- /** A buyer's subscription order */
308
- interface BuyerSubscriptionOrder {
322
+ /** A customer's subscription order */
323
+ interface CustomerSubscriptionOrder {
309
324
  id: string;
310
325
  status: string;
311
326
  currency: string;
@@ -327,8 +342,8 @@ interface BuyerSubscriptionOrder {
327
342
  }>;
328
343
  createdAt: string;
329
344
  }
330
- /** A buyer's payment record */
331
- interface BuyerPayment {
345
+ /** A customer's payment record */
346
+ interface CustomerPayment {
332
347
  id: string;
333
348
  orderId: string;
334
349
  status: string;
@@ -338,27 +353,27 @@ interface BuyerPayment {
338
353
  createdAt: string;
339
354
  }
340
355
  /**
341
- * A buyer's refund ticket.
356
+ * A customer's refund ticket.
342
357
  *
343
358
  * Ticket-level fields are flat; per-version fields (`reason`, `requestedAmount`)
344
- * live under `versionData` because the buyer can resubmit a rejected ticket and
359
+ * live under `versionData` because the customer can resubmit a rejected ticket and
345
360
  * each submission is a versioned record. `versionData` reflects the current
346
361
  * (latest) version. The `versionData` shape is shared with `@waffo/pancake-ts`'s
347
362
  * `RefundTicketVersionData`.
348
363
  */
349
- interface BuyerRefundTicket {
364
+ interface CustomerRefundTicket {
350
365
  id: string;
351
366
  status: string;
352
367
  versionNumber: number | null;
353
368
  versionData: RefundTicketVersionData | null;
354
369
  createdAt: string;
355
370
  }
356
- interface BuyerOrdersData {
357
- onetimeOrders: BuyerOnetimeOrder[];
358
- subscriptionOrders: BuyerSubscriptionOrder[];
371
+ interface CustomerOrdersData {
372
+ onetimeOrders: CustomerOnetimeOrder[];
373
+ subscriptionOrders: CustomerSubscriptionOrder[];
359
374
  }
360
375
  /**
361
- * Fetch the buyer's order history (one-time + subscription).
376
+ * Fetch the customer's order history (one-time + subscription).
362
377
  *
363
378
  * Must be used within `<WaffoPancakeProvider>`. Token is auto-managed.
364
379
  *
@@ -366,13 +381,13 @@ interface BuyerOrdersData {
366
381
  *
367
382
  * @example
368
383
  * ```tsx
369
- * const { data, isLoading, refetch } = useBuyerOrders();
384
+ * const { data, isLoading, refetch } = useCustomerOrders();
370
385
  * // data.onetimeOrders + data.subscriptionOrders
371
386
  * ```
372
387
  */
373
- declare function useBuyerOrders(): QueryState<BuyerOrdersData>;
388
+ declare function useCustomerOrders(): QueryState<CustomerOrdersData>;
374
389
  /**
375
- * Fetch the buyer's payment history.
390
+ * Fetch the customer's payment history.
376
391
  *
377
392
  * Must be used within `<WaffoPancakeProvider>`. Token is auto-managed.
378
393
  *
@@ -380,12 +395,12 @@ declare function useBuyerOrders(): QueryState<BuyerOrdersData>;
380
395
  *
381
396
  * @example
382
397
  * ```tsx
383
- * const { data: payments, isLoading } = useBuyerPayments();
398
+ * const { data: payments, isLoading } = useCustomerPayments();
384
399
  * ```
385
400
  */
386
- declare function useBuyerPayments(): QueryState<BuyerPayment[]>;
401
+ declare function useCustomerPayments(): QueryState<CustomerPayment[]>;
387
402
  /**
388
- * Fetch the buyer's refund tickets.
403
+ * Fetch the customer's refund tickets.
389
404
  *
390
405
  * Must be used within `<WaffoPancakeProvider>`. Token is auto-managed.
391
406
  *
@@ -393,10 +408,24 @@ declare function useBuyerPayments(): QueryState<BuyerPayment[]>;
393
408
  *
394
409
  * @example
395
410
  * ```tsx
396
- * const { data: tickets, isLoading } = useBuyerRefundTickets();
411
+ * const { data: tickets, isLoading } = useCustomerRefundTickets();
397
412
  * ```
398
413
  */
399
- declare function useBuyerRefundTickets(): QueryState<BuyerRefundTicket[]>;
414
+ declare function useCustomerRefundTickets(): QueryState<CustomerRefundTicket[]>;
415
+ /** @deprecated Use {@link CustomerOnetimeOrder} instead. */
416
+ type BuyerOnetimeOrder = CustomerOnetimeOrder;
417
+ /** @deprecated Use {@link CustomerSubscriptionOrder} instead. */
418
+ type BuyerSubscriptionOrder = CustomerSubscriptionOrder;
419
+ /** @deprecated Use {@link CustomerPayment} instead. */
420
+ type BuyerPayment = CustomerPayment;
421
+ /** @deprecated Use {@link CustomerRefundTicket} instead. */
422
+ type BuyerRefundTicket = CustomerRefundTicket;
423
+ /** @deprecated Use {@link useCustomerOrders} instead. */
424
+ declare const useBuyerOrders: typeof useCustomerOrders;
425
+ /** @deprecated Use {@link useCustomerPayments} instead. */
426
+ declare const useBuyerPayments: typeof useCustomerPayments;
427
+ /** @deprecated Use {@link useCustomerRefundTickets} instead. */
428
+ declare const useBuyerRefundTickets: typeof useCustomerRefundTickets;
400
429
 
401
430
  /** A merchant's recent order (one-time or subscription) */
402
431
  interface MerchantOrder {
@@ -527,9 +556,9 @@ interface WebhookConfig {
527
556
  onSubscriptionActivated?: EventHandler;
528
557
  /** Subscription renewal payment succeeded */
529
558
  onSubscriptionPaymentSucceeded?: EventHandler;
530
- /** Buyer initiated cancellation (expires at end of current period) */
559
+ /** Customer initiated cancellation (expires at end of current period) */
531
560
  onSubscriptionCanceling?: EventHandler;
532
- /** Buyer withdrew cancellation (subscription restored) */
561
+ /** Customer withdrew cancellation (subscription restored) */
533
562
  onSubscriptionUncanceled?: EventHandler;
534
563
  /** Subscription product changed (upgrade/downgrade) */
535
564
  onSubscriptionUpdated?: EventHandler;
@@ -574,4 +603,4 @@ interface WebhookConfig {
574
603
  */
575
604
  declare function Webhook(config: WebhookConfig): (request: Request) => Promise<Response>;
576
605
 
577
- export { type AnonymousCheckoutButtonProps, type AnonymousCheckoutProps, type AuthenticatedCheckoutButtonProps, type AuthenticatedCheckoutProps, type BuyerActionState, type BuyerConfig, type BuyerOnetimeOrder, type BuyerPayment, type BuyerRefundTicket, type BuyerSessionAction, type BuyerSubscriptionOrder, type BuyerTokenAction, type CheckoutAction, type CheckoutActionParams, type CheckoutActionResult, type CheckoutBaseOptions, CheckoutButton, type CheckoutButtonProps, type CheckoutMode, type CheckoutProps, type LinkCheckoutButtonProps, type LinkCheckoutProps, type MerchantOrder, type MerchantOrdersOptions, type MerchantQueryAction, type MerchantSubscription, type QueryState, type SalesOverview, type SubscriptionOverview, type UseBuyerReturn, type UseCheckoutReturn, WaffoPancakeProvider, type WaffoPancakeProviderProps, Webhook, type WebhookConfig, useBuyer, useBuyerOrders, useBuyerPayments, useBuyerRefundTickets, useCheckout, useMerchantOrders, useMerchantSales, useMerchantSubscriptions };
606
+ export { type AnonymousCheckoutButtonProps, type AnonymousCheckoutProps, type AuthenticatedCheckoutButtonProps, type AuthenticatedCheckoutProps, type BuyerActionState, type BuyerConfig, type BuyerOnetimeOrder, type BuyerPayment, type BuyerRefundTicket, type BuyerSessionAction, type BuyerSubscriptionOrder, type BuyerTokenAction, type CheckoutAction, type CheckoutActionParams, type CheckoutActionResult, type CheckoutBaseOptions, CheckoutButton, type CheckoutButtonProps, type CheckoutMode, type CheckoutProps, type CustomerActionState, type CustomerConfig, type CustomerOnetimeOrder, type CustomerPayment, type CustomerRefundTicket, type CustomerSessionAction, type CustomerSubscriptionOrder, type CustomerTokenAction, type LinkCheckoutButtonProps, type LinkCheckoutProps, type MerchantOrder, type MerchantOrdersOptions, type MerchantQueryAction, type MerchantSubscription, type QueryState, type SalesOverview, type SubscriptionOverview, type UseBuyerReturn, type UseCheckoutReturn, type UseCustomerReturn, WaffoPancakeProvider, type WaffoPancakeProviderProps, Webhook, type WebhookConfig, useBuyer, useBuyerOrders, useBuyerPayments, useBuyerRefundTickets, useCheckout, useCustomer, useCustomerOrders, useCustomerPayments, useCustomerRefundTickets, useMerchantOrders, useMerchantSales, useMerchantSubscriptions };