@edx/frontend-app-subscription-checkout 1.0.0

package/dist/data/hooks/useCheckout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckout.js","sourceRoot":"","sources":["../../../src/data/hooks/useCheckout.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  useCallback, useEffect, useMemo, useRef, useState,\n} from 'react';\nimport type { Ref } from 'react';\nimport type { BillingCycle } from '../../types';\nimport { createCheckoutClient } from '../../utils/checkout';\nimport { loadStripe } from '../../utils/stripe';\nimport {\n  STATUS, STATUS_LABELS, STRIPE_ELEMENT_OPTS, phaseFor, DEFAULTS,\n} from '../../constants';\nimport type {\n  Status, Phase, Cart, BillingInfo, CheckoutClient, StripeLike, StripeElementLike,\n  StripeElementsLike, BillingPlan, CheckoutConsent,\n} from '../../types';\nimport {\n  useCartStatusQuery, useSubscriptionIdQuery, useBillingPlansQuery,\n  useActiveSubscriptionsQuery, useViaxSessionQuery, useCourseDetailQuery,\n} from './useCheckoutQueries';\nimport type { EdxSessionResult } from '../../utils/provision';\nimport { useCheckoutMutations } from './useCheckoutMutations';\n\n/**\n * Read ?course_run_key= from the current URL.\n * Avoid URLSearchParams — it treats bare `+` as a space, which would turn\n * HarvardX+CS50+X into \"HarvardX CS50 X\". decodeURIComponent keeps `+` intact.\n */\nfunction getCourseRunKeyFromUrl(): string | null {\n  if (typeof window === 'undefined') return null;\n  const match = /[?&]course_run_key=([^&]*)/.exec(window.location.search);\n  if (!match) return null;\n  try {\n    // Preserve literal `+` (treat as %2B) then decode %XX sequences.\n    return decodeURIComponent(match[1].replace(/\\+/g, '%2B')).trim() || null;\n  } catch {\n    return match[1].trim() || null;\n  }\n}\n\nexport interface UseCheckoutOptions {\n  apiUrl?: string,\n  edxSessionUrl?: string,\n  stripePublishableKey?: string,\n  onComplete?: (subscriptionBiId: string | null) => void,\n  /** Country code resolved by CheckoutGate — used to show/hide the UK/CA extra checkbox. */\n  userCountry?: string | null,\n  /**\n   * Course run key from the URL (e.g. course-v1:HarvardX+CS50+X).\n   * When omitted, read from ?course_run_key=.\n   */\n  courseRunKey?: string | null,\n}\n\nexport interface UseCheckoutResult {\n  phase: Phase,\n  status: Status | null,\n  statusLabel: string,\n  stripeReady: boolean,\n  /** True once the Stripe card Element iframe is fully initialised and interactive. */\n  cardReady: boolean,\n  notConfigured: boolean,\n  showBanner: boolean,\n  dismissBanner: () => void,\n  error: string,\n  clearError: () => void,\n  cardError: string,\n  lastComment: string,\n  /** Full subscription details including card last 4 — available after SUBSCRIPTION_CREATED. */\n  subscriptionDetails: import('../../types').SubscriptionDetails | null,\n  billing: BillingInfo,\n  setField: (field: keyof BillingInfo, value: string) => void,\n  numberMountRef: Ref<HTMLDivElement>,\n  expiryMountRef: Ref<HTMLDivElement>,\n  cvcMountRef: Ref<HTMLDivElement>,\n  submitting: boolean,\n  /** True from Place order click until a terminal status is reached. */\n  processingSubscription: boolean,\n  placeOrder: (consent: CheckoutConsent) => void,\n  /** Billing plans fetched on mount — includes prices for display in CartSummary. */\n  billingPlans: BillingPlan[],\n  /** Live active subscriber count for display in CartSummary. */\n  activeSubscriberCount: number | null,\n  /** Currently selected billing cycle. */\n  selectedCycle: BillingCycle,\n  /** Switch between monthly and annual billing. */\n  setCycle: (cycle: BillingCycle) => void,\n  /** True once GET /edx-session has returned and the viax token is set. */\n  sessionReady: boolean,\n  /** ISO 3166-1 alpha-2 country code — passed in from CheckoutGate for the UK/CA checkbox. */\n  userCountry: string | null,\n  /** Course details when arrived via ?course_run_key=; null for standard checkout. */\n  course: import('../../types').CourseDetail | null,\n}\n\nexport default function useCheckout(options: UseCheckoutOptions = {}): UseCheckoutResult {\n  const {\n    apiUrl = DEFAULTS.apiUrl,\n    edxSessionUrl,\n    stripePublishableKey,\n    onComplete,\n    userCountry = null,\n    courseRunKey: courseRunKeyProp,\n  } = options;\n\n  const courseRunKey = useMemo(\n    () => courseRunKeyProp ?? getCourseRunKeyFromUrl(),\n    [courseRunKeyProp],\n  );\n\n  const client = useMemo<CheckoutClient | null>(() => {\n    if (!apiUrl) return null;\n    return createCheckoutClient({ apiUrl });\n  }, [apiUrl]);\n\n  const notConfigured = !client || !stripePublishableKey || !edxSessionUrl;\n\n  // Exchange edX session for viax token on page load.\n  const sessionQuery = useViaxSessionQuery(notConfigured ? null : edxSessionUrl!);\n  const sessionReady = !!sessionQuery.data;\n\n  useEffect(() => {\n    if (sessionQuery.data && client) {\n      client.setToken(sessionQuery.data.viaxToken);\n    }\n  }, [sessionQuery.data, client]);\n\n  // Fetch billing plans, subscriber count, and optional course once the viax session is ready.\n  const billingPlansQuery = useBillingPlansQuery(client, sessionReady);\n  const activeSubscriptionsQuery = useActiveSubscriptionsQuery(client, sessionReady);\n  const courseDetailQuery = useCourseDetailQuery(client, sessionReady, courseRunKey);\n\n  // --- state ---\n  const [showBanner, setShowBanner] = useState(true);\n  const [cart, setCart] = useState<Cart | null>(null);\n  const [stripe, setStripe] = useState<StripeLike | null>(null);\n  const [stripeReady, setStripeReady] = useState(false);\n  const [cardReady, setCardReady] = useState(false);\n  const [error, setError] = useState('');\n  const [cardError, setCardError] = useState('');\n  const [billing, setBilling] = useState<BillingInfo>({\n    firstName: '', lastName: '', city: '', zip: '', country: 'US', line1: '', state: '',\n  });\n  const [selectedCycle, setSelectedCycle] = useState<BillingCycle>('monthly');\n  const [processingSubscription, setProcessingSubscription] = useState(false);\n\n  useEffect(() => {\n    if (sessionQuery.error) {\n      setError(sessionQuery.error.message);\n    }\n  }, [sessionQuery.error]);\n\n  const setField = useCallback(\n    (field: keyof BillingInfo, value: string) => setBilling((p: BillingInfo) => ({ ...p, [field]: value })),\n    [],\n  );\n\n  // --- refs ---\n  // Stripe instances — written inside useEffect and mutations.\n  const stripeInstanceRef = useRef<StripeLike | null>(null);\n  const cardNumberElementRef = useRef<StripeElementLike | null>(null);\n  const elementsRef = useRef<StripeElementsLike | null>(null);\n  const elementsMountedRef = useRef(false);\n  // DOM mount targets — passed as ref={} to the Stripe Element host divs.\n  const numberMountRef = useRef<HTMLDivElement | null>(null);\n  const expiryMountRef = useRef<HTMLDivElement | null>(null);\n  const cvcMountRef = useRef<HTMLDivElement | null>(null);\n  const mountedRef = useRef(true);\n  const completedRef = useRef(false);\n  const sessionRef = useRef<EdxSessionResult | null>(null);\n\n  useEffect(() => {\n    sessionRef.current = sessionQuery.data ?? null;\n  }, [sessionQuery.data]);\n\n  // Mirror state into refs so mutations can read current values without stale closures.\n  const cartRef = useRef<Cart | null>(null);\n  const billingRef = useRef<BillingInfo>(billing);\n  useEffect(() => {\n    cartRef.current = cart;\n  }, [cart]);\n  useEffect(() => {\n    billingRef.current = billing;\n  }, [billing]);\n  useEffect(() => {\n    stripeInstanceRef.current = stripe;\n  }, [stripe]);\n\n  // --- server state ---\n  const statusQuery = useCartStatusQuery(client, cart?.biId ?? null);\n  const status: Status | null = statusQuery.data?.status ?? null;\n  const lastComment = statusQuery.data?.lastComment ?? '';\n\n  // Phase is 'ready' until a cart exists, then driven by bpStatus.\n  const phase: Phase = cart ? phaseFor(status, status === STATUS.IN_CART) : 'ready';\n  const subscriptionIdQuery = useSubscriptionIdQuery(\n    client, cart?.biId ?? null, status === STATUS.SUBSCRIPTION_CREATED,\n  );\n\n  // --- mutations ---\n  const { placeOrder: placeMutation } = useCheckoutMutations({\n    client,\n    sessionRef,\n    stripeRef: stripeInstanceRef,\n    cardNumberElRef: cardNumberElementRef,\n    billingRef,\n    setError: (msg: string) => {\n      setProcessingSubscription(false);\n      setError(msg);\n    },\n    setCardError: (msg: string) => {\n      setProcessingSubscription(false);\n      setCardError(msg);\n    },\n    onCartCreated: (created: Cart) => {\n    // Sync the ref immediately so any same-tick readers see the cart\n    // before the setCart → useEffect mirror runs.\n      cartRef.current = created;\n      if (mountedRef.current) setCart(created);\n    },\n  });\n\n  // --- load Stripe.js on mount ---\n  useEffect(() => {\n    mountedRef.current = true;\n    if (!stripePublishableKey) return undefined;\n\n    (async () => {\n      try {\n        const instance = await loadStripe(stripePublishableKey);\n        if (mountedRef.current) {\n          setStripe(instance);\n          setStripeReady(true);\n        }\n      } catch (e: unknown) {\n        if (mountedRef.current) setError((e as Error).message);\n      }\n    })();\n\n    return () => {\n      mountedRef.current = false;\n    };\n  }, [stripePublishableKey]);\n\n  // --- mount Stripe Elements once Stripe is loaded ---\n  useEffect(() => {\n    if (!stripe) return;\n    if (!numberMountRef.current || !expiryMountRef.current || !cvcMountRef.current) return;\n    // Hard guard — never recreate elements once mounted, even if stripe reference changes.\n    if (elementsMountedRef.current) return;\n    elementsMountedRef.current = true;\n\n    setCardReady(false);\n\n    const elements = stripe.elements();\n    elementsRef.current = elements;\n\n    const number = elements.create('cardNumber', { ...STRIPE_ELEMENT_OPTS, showIcon: true });\n    const expiry = elements.create('cardExpiry', STRIPE_ELEMENT_OPTS);\n    const cvc = elements.create('cardCvc', STRIPE_ELEMENT_OPTS);\n\n    number.mount(numberMountRef.current);\n    expiry.mount(expiryMountRef.current);\n    cvc.mount(cvcMountRef.current);\n\n    number.on('ready', () => {\n      if (mountedRef.current) setCardReady(true);\n    });\n    number.on('change', (e: { error?: { message?: string } }) => {\n      if (mountedRef.current) setCardError(e.error?.message || '');\n    });\n\n    cardNumberElementRef.current = number;\n  }, [stripe]);\n\n  // --- on success ---\n  useEffect(() => {\n    if (status !== STATUS.SUBSCRIPTION_CREATED || completedRef.current) return;\n    completedRef.current = true;\n    if (onComplete) onComplete(subscriptionIdQuery.data?.biId ?? null);\n  }, [status, subscriptionIdQuery.data, onComplete]);\n\n  // --- actions ---\n  const placeOrder = useCallback((consent: CheckoutConsent) => {\n    setError('');\n    setCardError('');\n    if (phase === 'failed') setCart(null);\n    setProcessingSubscription(true);\n    placeMutation.mutate(consent);\n  }, [placeMutation, phase]);\n\n  // Turn off processingSubscription once we reach a terminal status.\n  useEffect(() => {\n    if (!status) return;\n    const terminalStatuses: Status[] = [\n      STATUS.SUBSCRIPTION_CREATED,\n      STATUS.STRIPE_FAIL,\n      STATUS.SANCTION_BLOCK,\n    ];\n    if (terminalStatuses.includes(status)) {\n      setProcessingSubscription(false);\n    }\n  }, [status]);\n\n  return {\n    phase,\n    status,\n    statusLabel: (status && STATUS_LABELS[status]) || 'Processing your order…',\n    stripeReady,\n    cardReady,\n    notConfigured,\n    showBanner,\n    dismissBanner: () => setShowBanner(false),\n    error,\n    clearError: () => setError(''),\n    cardError,\n    lastComment,\n    subscriptionDetails: subscriptionIdQuery.data ?? null,\n    billing,\n    setField,\n    numberMountRef,\n    expiryMountRef,\n    cvcMountRef,\n    submitting: placeMutation.isPending,\n    processingSubscription,\n    placeOrder,\n    billingPlans: billingPlansQuery.data?.plans ?? [],\n    activeSubscriberCount: activeSubscriptionsQuery.data?.active ?? null,\n    selectedCycle,\n    setCycle: setSelectedCycle,\n    sessionReady,\n    userCountry,\n    course: courseDetailQuery.data ?? null,\n  };\n}\n"]}

package/dist/data/hooks/useCheckoutGate.d.ts

@@ -0,0 +1,15 @@
+export interface UseCheckoutGateOptions {
+    edxSessionUrl?: string;
+    learnerDashboardUrl?: string;
+}
+export type GateStatus = 'loading' | 'blocked' | 'allowed' | 'error';
+export interface UseCheckoutGateResult {
+    /** 'loading' while session/checks are in flight, 'blocked' if country not allowed, 'allowed' if clear, 'error' if session failed. */
+    gateStatus: GateStatus;
+    /** ISO 3166-1 alpha-2 country code — passed down to Checkout for the UK/CA checkbox. */
+    userCountry: string | null;
+    learnerDashboardUrl: string | undefined;
+    /** Message when gateStatus is 'error' (typically a failed edx-session exchange). */
+    errorMessage: string | null;
+}
+export declare function useCheckoutGate(options?: UseCheckoutGateOptions): UseCheckoutGateResult;

package/dist/data/hooks/useCheckoutGate.js

@@ -0,0 +1,39 @@
+import { ALLOWED_CHECKOUT_COUNTRIES, GATE_CHECK_COUNTRY, } from '../../constants';
+import { useViaxSessionQuery, useUserCountryQuery, } from './useCheckoutQueries';
+export function useCheckoutGate(options = {}) {
+    var _a, _b, _c;
+    const { edxSessionUrl, learnerDashboardUrl, } = options;
+    const sessionQuery = useViaxSessionQuery(edxSessionUrl !== null && edxSessionUrl !== void 0 ? edxSessionUrl : null);
+    const sessionReady = !!sessionQuery.data;
+    const userCountryQuery = useUserCountryQuery(sessionReady && GATE_CHECK_COUNTRY ? (edxSessionUrl !== null && edxSessionUrl !== void 0 ? edxSessionUrl : null) : null, (_b = (_a = sessionQuery.data) === null || _a === void 0 ? void 0 : _a.username) !== null && _b !== void 0 ? _b : null);
+    const userCountry = (_c = userCountryQuery.data) !== null && _c !== void 0 ? _c : null;
+    // Use isLoading (isPending && isFetching), not isPending alone.
+    // In TanStack Query v5, disabled queries with no data stay isPending forever —
+    // e.g. country check when username is missing from the session response.
+    const loading = (!sessionReady && !sessionQuery.isError)
+        || (GATE_CHECK_COUNTRY && userCountryQuery.isLoading);
+    // GATE_CHECK_COUNTRY=false → treat all countries as allowed.
+    const isCountryAllowed = !GATE_CHECK_COUNTRY
+        || userCountry === null
+        || ALLOWED_CHECKOUT_COUNTRIES.includes(userCountry);
+    let gateStatus;
+    if (sessionQuery.isError) {
+        gateStatus = 'error';
+    }
+    else if (loading) {
+        gateStatus = 'loading';
+    }
+    else if (!isCountryAllowed) {
+        gateStatus = 'blocked';
+    }
+    else {
+        gateStatus = 'allowed';
+    }
+    const errorMessage = sessionQuery.isError
+        ? (sessionQuery.error instanceof Error
+            ? sessionQuery.error.message
+            : 'Failed to establish checkout session.')
+        : null;
+    return { gateStatus, userCountry, learnerDashboardUrl, errorMessage };
+}
+//# sourceMappingURL=useCheckoutGate.js.map

package/dist/data/hooks/useCheckoutGate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckoutGate.js","sourceRoot":"","sources":["../../../src/data/hooks/useCheckoutGate.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,0BAA0B,EAC1B,kBAAkB,GACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAmB9B,MAAM,UAAU,eAAe,CAAC,UAAkC,EAAE;;IAClE,MAAM,EACJ,aAAa,EACb,mBAAmB,GACpB,GAAG,OAAO,CAAC;IAEZ,MAAM,YAAY,GAAG,mBAAmB,CAAC,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,IAAI,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC;IAEzC,MAAM,gBAAgB,GAAG,mBAAmB,CAC1C,YAAY,IAAI,kBAAkB,CAAC,CAAC,CAAC,CAAC,aAAa,aAAb,aAAa,cAAb,aAAa,GAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EACnE,MAAA,MAAA,YAAY,CAAC,IAAI,0CAAE,QAAQ,mCAAI,IAAI,CACpC,CAAC;IAEF,MAAM,WAAW,GAAG,MAAA,gBAAgB,CAAC,IAAI,mCAAI,IAAI,CAAC;IAElD,gEAAgE;IAChE,+EAA+E;IAC/E,yEAAyE;IACzE,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC;WACnD,CAAC,kBAAkB,IAAI,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAExD,6DAA6D;IAC7D,MAAM,gBAAgB,GAAG,CAAC,kBAAkB;WACvC,WAAW,KAAK,IAAI;WACpB,0BAA0B,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IAEtD,IAAI,UAAsB,CAAC;IAC3B,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;QACzB,UAAU,GAAG,OAAO,CAAC;IACvB,CAAC;SAAM,IAAI,OAAO,EAAE,CAAC;QACnB,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;SAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC;QAC7B,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;SAAM,CAAC;QACN,UAAU,GAAG,SAAS,CAAC;IACzB,CAAC;IAED,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO;QACvC,CAAC,CAAC,CAAC,YAAY,CAAC,KAAK,YAAY,KAAK;YAClC,CAAC,CAAC,YAAY,CAAC,KAAK,CAAC,OAAO;YAC5B,CAAC,CAAC,uCAAuC,CAAC;QAC9C,CAAC,CAAC,IAAI,CAAC;IAET,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,YAAY,EAAE,CAAC;AACxE,CAAC","sourcesContent":["import {\n  ALLOWED_CHECKOUT_COUNTRIES,\n  GATE_CHECK_COUNTRY,\n} from '../../constants';\nimport {\n  useViaxSessionQuery,\n  useUserCountryQuery,\n} from './useCheckoutQueries';\n\nexport interface UseCheckoutGateOptions {\n  edxSessionUrl?: string,\n  learnerDashboardUrl?: string,\n}\n\nexport type GateStatus = 'loading' | 'blocked' | 'allowed' | 'error';\n\nexport interface UseCheckoutGateResult {\n  /** 'loading' while session/checks are in flight, 'blocked' if country not allowed, 'allowed' if clear, 'error' if session failed. */\n  gateStatus: GateStatus,\n  /** ISO 3166-1 alpha-2 country code — passed down to Checkout for the UK/CA checkbox. */\n  userCountry: string | null,\n  learnerDashboardUrl: string | undefined,\n  /** Message when gateStatus is 'error' (typically a failed edx-session exchange). */\n  errorMessage: string | null,\n}\n\nexport function useCheckoutGate(options: UseCheckoutGateOptions = {}): UseCheckoutGateResult {\n  const {\n    edxSessionUrl,\n    learnerDashboardUrl,\n  } = options;\n\n  const sessionQuery = useViaxSessionQuery(edxSessionUrl ?? null);\n  const sessionReady = !!sessionQuery.data;\n\n  const userCountryQuery = useUserCountryQuery(\n    sessionReady && GATE_CHECK_COUNTRY ? (edxSessionUrl ?? null) : null,\n    sessionQuery.data?.username ?? null,\n  );\n\n  const userCountry = userCountryQuery.data ?? null;\n\n  // Use isLoading (isPending && isFetching), not isPending alone.\n  // In TanStack Query v5, disabled queries with no data stay isPending forever —\n  // e.g. country check when username is missing from the session response.\n  const loading = (!sessionReady && !sessionQuery.isError)\n    || (GATE_CHECK_COUNTRY && userCountryQuery.isLoading);\n\n  // GATE_CHECK_COUNTRY=false → treat all countries as allowed.\n  const isCountryAllowed = !GATE_CHECK_COUNTRY\n    || userCountry === null\n    || ALLOWED_CHECKOUT_COUNTRIES.includes(userCountry);\n\n  let gateStatus: GateStatus;\n  if (sessionQuery.isError) {\n    gateStatus = 'error';\n  } else if (loading) {\n    gateStatus = 'loading';\n  } else if (!isCountryAllowed) {\n    gateStatus = 'blocked';\n  } else {\n    gateStatus = 'allowed';\n  }\n\n  const errorMessage = sessionQuery.isError\n    ? (sessionQuery.error instanceof Error\n        ? sessionQuery.error.message\n        : 'Failed to establish checkout session.')\n    : null;\n\n  return { gateStatus, userCountry, learnerDashboardUrl, errorMessage };\n}\n"]}

package/dist/data/hooks/useCheckoutMutations.d.ts

@@ -0,0 +1,16 @@
+import type { RefObject } from 'react';
+import type { EdxSessionResult } from '../../utils/provision';
+import type { CheckoutClient, StripeLike, StripeElementLike, Cart, BillingInfo, CheckoutConsent } from '../../types';
+export interface CheckoutMutationsCtx {
+    client: CheckoutClient | null;
+    sessionRef: RefObject<EdxSessionResult | null>;
+    stripeRef: RefObject<StripeLike | null>;
+    cardNumberElRef: RefObject<StripeElementLike | null>;
+    billingRef: RefObject<BillingInfo | null>;
+    setError: (msg: string) => void;
+    setCardError: (msg: string) => void;
+    onCartCreated: (cart: Cart) => void;
+}
+export declare function useCheckoutMutations(ctx: CheckoutMutationsCtx): {
+    placeOrder: import("@tanstack/react-query").UseMutationResult<Cart, Error, CheckoutConsent, unknown>;
+};

package/dist/data/hooks/useCheckoutMutations.js

@@ -0,0 +1,131 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+/**
+ * query/useCheckoutMutations.ts — write-side TanStack mutations.
+ *
+ * The placeOrder mutation drives the checkout sequence on button click.
+ * The viax token and customerUid are established on page load via
+ * GET /edx-session and passed in through sessionRef.
+ *
+ *   1. getSalableUid + getBillingPlans (parallel)
+ *   2. createTwouCart
+ *   3. stripe.createPaymentMethod   → pm_xxx
+ *   4. updateTwouCartItem           → billing address + pm_xxx
+ *   5. updateTwouCart               → consent fields (SUBS-228)
+ *   6. startBusinessProcessableTransition('Sanction_Check')
+ */
+import { useMutation, useQueryClient } from '@tanstack/react-query';
+import { STATUS } from '../../constants';
+import { checkoutKeys } from './keys';
+class CardValidationError extends Error {
+}
+function toCartAddress(b) {
+    return {
+        tFirstName: b.firstName,
+        tLastName: b.lastName,
+        upaLine1: b.line1,
+        upaCity: b.city,
+        upaPostcode: b.zip,
+        gadStateOrProvince: b.state,
+        gadCountry: { iso2Code: b.country },
+    };
+}
+function toStripeAddress(b) {
+    return {
+        line1: b.line1 || undefined,
+        city: b.city || undefined,
+        state: b.state || undefined,
+        postal_code: b.zip || undefined,
+        country: b.country || undefined,
+    };
+}
+export function useCheckoutMutations(ctx) {
+    const queryClient = useQueryClient();
+    const optimisticConfirm = (cartBiId) => {
+        queryClient.setQueryData(checkoutKeys.status(cartBiId), (old) => {
+            var _a, _b;
+            return ({
+                status: STATUS.CONFIRM,
+                stripeSubscriptionId: (_a = old === null || old === void 0 ? void 0 : old.stripeSubscriptionId) !== null && _a !== void 0 ? _a : null,
+                lastComment: (_b = old === null || old === void 0 ? void 0 : old.lastComment) !== null && _b !== void 0 ? _b : '',
+            });
+        });
+        queryClient.invalidateQueries({ queryKey: checkoutKeys.status(cartBiId) });
+    };
+    const placeOrder = useMutation({
+        mutationFn: (consent) => __awaiter(this, void 0, void 0, function* () {
+            var _a;
+            const { client, stripeRef, cardNumberElRef, billingRef } = ctx;
+            const stripe = stripeRef.current;
+            const card = cardNumberElRef.current;
+            if (!client || !stripe || !card)
+                throw new Error('Checkout is not ready yet.');
+            const billing = billingRef.current;
+            if (!billing)
+                throw new Error('Billing information is not available. Please refresh and try again.');
+            const session = ctx.sessionRef.current;
+            if (!session) {
+                throw new Error('Checkout session is not ready yet. Please wait a moment and try again.');
+            }
+            const { customerUid } = session;
+            // ── Step 1: Fetch salable(product) uid + billing plans in parallel ─────────────
+            const [productInfo, plansResult] = yield Promise.all([
+                client.getSalableUid('TWOU-SUB-PLAN-001'),
+                client.getBillingPlans(),
+            ]);
+            const salableUid = productInfo.uid;
+            const defaultPlan = (_a = plansResult.plans.find((p) => !p.isTemplate)) !== null && _a !== void 0 ? _a : plansResult.plans[0];
+            if (!defaultPlan)
+                throw new Error('No billing plans available.');
+            const billingPlanUid = defaultPlan.uid;
+            // ── Step 2: Create the cart ───────────────────────────────────────────
+            const createdCart = yield client.createCart({ customerUid, salableUid, billingPlanUid });
+            ctx.onCartCreated(createdCart);
+            // ── Step 3: Tokenize the card (browser → Stripe) ──────────────────────
+            const { paymentMethod, error } = yield stripe.createPaymentMethod({
+                type: 'card',
+                card,
+                billing_details: {
+                    name: `${billing.firstName} ${billing.lastName}`.trim(),
+                    address: toStripeAddress(billing),
+                },
+            });
+            if (error || !paymentMethod) {
+                throw new CardValidationError((error === null || error === void 0 ? void 0 : error.message) || 'There was a problem with your card.');
+            }
+            // ── Step 4: Attach billing address + payment method to cart item ──────
+            const { cartItemUid } = yield client.getCartItem(createdCart.biId);
+            yield client.updateCartItem({
+                cartItemUid,
+                billingAddress: toCartAddress(billing),
+                paymentMethodId: paymentMethod.id,
+            });
+            // ── Step 5: Persist auto-renewal consent on the TwouCart BI ───────────
+            yield client.updateCartConsent({
+                cartUid: createdCart.uid,
+                consent,
+            });
+            // ── Step 6: Fire the backend workflow ─────────────────────────────────
+            yield client.placeOrder(createdCart.uid);
+            return createdCart;
+        }),
+        onSuccess: (cart) => {
+            optimisticConfirm(cart.biId);
+        },
+        onError: (err) => {
+            if (err instanceof CardValidationError)
+                ctx.setCardError(err.message);
+            else
+                ctx.setError(err.message);
+        },
+    });
+    return { placeOrder };
+}
+//# sourceMappingURL=useCheckoutMutations.js.map

package/dist/data/hooks/useCheckoutMutations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckoutMutations.js","sourceRoot":"","sources":["../../../src/data/hooks/useCheckoutMutations.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEpE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAOtC,MAAM,mBAAoB,SAAQ,KAAK;CAAG;AAE1C,SAAS,aAAa,CAAC,CAAc;IACnC,OAAO;QACL,UAAU,EAAE,CAAC,CAAC,SAAS;QACvB,SAAS,EAAE,CAAC,CAAC,QAAQ;QACrB,QAAQ,EAAE,CAAC,CAAC,KAAK;QACjB,OAAO,EAAE,CAAC,CAAC,IAAI;QACf,WAAW,EAAE,CAAC,CAAC,GAAG;QAClB,kBAAkB,EAAE,CAAC,CAAC,KAAK;QAC3B,UAAU,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,CAAc;IACrC,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,SAAS;QAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,SAAS;QACzB,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,SAAS;QAC3B,WAAW,EAAE,CAAC,CAAC,GAAG,IAAI,SAAS;QAC/B,OAAO,EAAE,CAAC,CAAC,OAAO,IAAI,SAAS;KAChC,CAAC;AACJ,CAAC;AAaD,MAAM,UAAU,oBAAoB,CAAC,GAAyB;IAC5D,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAE,EAAE;QAC7C,WAAW,CAAC,YAAY,CAAmB,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE;;YAAC,OAAA,CAAC;gBAClF,MAAM,EAAE,MAAM,CAAC,OAAO;gBACtB,oBAAoB,EAAE,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,oBAAoB,mCAAI,IAAI;gBACvD,WAAW,EAAE,MAAA,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,WAAW,mCAAI,EAAE;aACpC,CAAC,CAAA;SAAA,CAAC,CAAC;QACJ,WAAW,CAAC,iBAAiB,CAAC,EAAE,QAAQ,EAAE,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC7E,CAAC,CAAC;IAEF,MAAM,UAAU,GAAG,WAAW,CAA+B;QAC3D,UAAU,EAAE,CAAO,OAAO,EAAE,EAAE;;YAC5B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,GAAG,GAAG,CAAC;YAC/D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC;YACjC,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC;YACrC,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;YAE/E,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;YACnC,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,qEAAqE,CAAC,CAAC;YAErG,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,OAAO,CAAC;YACvC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CAAC,wEAAwE,CAAC,CAAC;YAC5F,CAAC;YACD,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;YAEhC,kFAAkF;YAClF,MAAM,CAAC,WAAW,EAAE,WAAW,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACnD,MAAM,CAAC,aAAa,CAAC,mBAAmB,CAAC;gBACzC,MAAM,CAAC,eAAe,EAAE;aACzB,CAAC,CAAC;YACH,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC;YACnC,MAAM,WAAW,GAAG,MAAA,WAAW,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,mCAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACzF,IAAI,CAAC,WAAW;gBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACjE,MAAM,cAAc,GAAG,WAAW,CAAC,GAAG,CAAC;YAEvC,yEAAyE;YACzE,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC,CAAC;YACzF,GAAG,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;YAE/B,yEAAyE;YACzE,MAAM,EAAE,aAAa,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC;gBAChE,IAAI,EAAE,MAAM;gBACZ,IAAI;gBACJ,eAAe,EAAE;oBACf,IAAI,EAAE,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE;oBACvD,OAAO,EAAE,eAAe,CAAC,OAAO,CAAC;iBAClC;aACF,CAAC,CAAC;YACH,IAAI,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC5B,MAAM,IAAI,mBAAmB,CAAC,CAAA,KAAK,aAAL,KAAK,uBAAL,KAAK,CAAE,OAAO,KAAI,qCAAqC,CAAC,CAAC;YACzF,CAAC;YAED,yEAAyE;YACzE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YACnE,MAAM,MAAM,CAAC,cAAc,CAAC;gBAC1B,WAAW;gBACX,cAAc,EAAE,aAAa,CAAC,OAAO,CAAC;gBACtC,eAAe,EAAE,aAAa,CAAC,EAAE;aAClC,CAAC,CAAC;YAEH,yEAAyE;YACzE,MAAM,MAAM,CAAC,iBAAiB,CAAC;gBAC7B,OAAO,EAAE,WAAW,CAAC,GAAG;gBACxB,OAAO;aACR,CAAC,CAAC;YAEH,yEAAyE;YACzE,MAAM,MAAM,CAAC,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YAEzC,OAAO,WAAW,CAAC;QACrB,CAAC,CAAA;QACD,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE;YAClB,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACf,IAAI,GAAG,YAAY,mBAAmB;gBAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;;gBACjE,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjC,CAAC;KACF,CAAC,CAAC;IAEH,OAAO,EAAE,UAAU,EAAE,CAAC;AACxB,CAAC","sourcesContent":["/**\n * query/useCheckoutMutations.ts — write-side TanStack mutations.\n *\n * The placeOrder mutation drives the checkout sequence on button click.\n * The viax token and customerUid are established on page load via\n * GET /edx-session and passed in through sessionRef.\n *\n *   1. getSalableUid + getBillingPlans (parallel)\n *   2. createTwouCart\n *   3. stripe.createPaymentMethod   → pm_xxx\n *   4. updateTwouCartItem           → billing address + pm_xxx\n *   5. updateTwouCart               → consent fields (SUBS-228)\n *   6. startBusinessProcessableTransition('Sanction_Check')\n */\nimport { useMutation, useQueryClient } from '@tanstack/react-query';\nimport type { RefObject } from 'react';\nimport { STATUS } from '../../constants';\nimport { checkoutKeys } from './keys';\nimport type { EdxSessionResult } from '../../utils/provision';\nimport type {\n  CheckoutClient, StripeLike, StripeElementLike, Cart, BillingInfo,\n  CartBillingAddress, CartStatusResult, CheckoutConsent,\n} from '../../types';\n\nclass CardValidationError extends Error {}\n\nfunction toCartAddress(b: BillingInfo): CartBillingAddress {\n  return {\n    tFirstName: b.firstName,\n    tLastName: b.lastName,\n    upaLine1: b.line1,\n    upaCity: b.city,\n    upaPostcode: b.zip,\n    gadStateOrProvince: b.state,\n    gadCountry: { iso2Code: b.country },\n  };\n}\n\nfunction toStripeAddress(b: BillingInfo): Record<string, string | undefined> {\n  return {\n    line1: b.line1 || undefined,\n    city: b.city || undefined,\n    state: b.state || undefined,\n    postal_code: b.zip || undefined,\n    country: b.country || undefined,\n  };\n}\n\nexport interface CheckoutMutationsCtx {\n  client: CheckoutClient | null,\n  sessionRef: RefObject<EdxSessionResult | null>,\n  stripeRef: RefObject<StripeLike | null>,\n  cardNumberElRef: RefObject<StripeElementLike | null>,\n  billingRef: RefObject<BillingInfo | null>,\n  setError: (msg: string) => void,\n  setCardError: (msg: string) => void,\n  onCartCreated: (cart: Cart) => void,\n}\n\nexport function useCheckoutMutations(ctx: CheckoutMutationsCtx) {\n  const queryClient = useQueryClient();\n\n  const optimisticConfirm = (cartBiId: string) => {\n    queryClient.setQueryData<CartStatusResult>(checkoutKeys.status(cartBiId), (old) => ({\n      status: STATUS.CONFIRM,\n      stripeSubscriptionId: old?.stripeSubscriptionId ?? null,\n      lastComment: old?.lastComment ?? '',\n    }));\n    queryClient.invalidateQueries({ queryKey: checkoutKeys.status(cartBiId) });\n  };\n\n  const placeOrder = useMutation<Cart, Error, CheckoutConsent>({\n    mutationFn: async (consent) => {\n      const { client, stripeRef, cardNumberElRef, billingRef } = ctx;\n      const stripe = stripeRef.current;\n      const card = cardNumberElRef.current;\n      if (!client || !stripe || !card) throw new Error('Checkout is not ready yet.');\n\n      const billing = billingRef.current;\n      if (!billing) throw new Error('Billing information is not available. Please refresh and try again.');\n\n      const session = ctx.sessionRef.current;\n      if (!session) {\n        throw new Error('Checkout session is not ready yet. Please wait a moment and try again.');\n      }\n      const { customerUid } = session;\n\n      // ── Step 1: Fetch salable(product) uid + billing plans in parallel ─────────────\n      const [productInfo, plansResult] = await Promise.all([\n        client.getSalableUid('TWOU-SUB-PLAN-001'),\n        client.getBillingPlans(),\n      ]);\n      const salableUid = productInfo.uid;\n      const defaultPlan = plansResult.plans.find((p) => !p.isTemplate) ?? plansResult.plans[0];\n      if (!defaultPlan) throw new Error('No billing plans available.');\n      const billingPlanUid = defaultPlan.uid;\n\n      // ── Step 2: Create the cart ───────────────────────────────────────────\n      const createdCart = await client.createCart({ customerUid, salableUid, billingPlanUid });\n      ctx.onCartCreated(createdCart);\n\n      // ── Step 3: Tokenize the card (browser → Stripe) ──────────────────────\n      const { paymentMethod, error } = await stripe.createPaymentMethod({\n        type: 'card',\n        card,\n        billing_details: {\n          name: `${billing.firstName} ${billing.lastName}`.trim(),\n          address: toStripeAddress(billing),\n        },\n      });\n      if (error || !paymentMethod) {\n        throw new CardValidationError(error?.message || 'There was a problem with your card.');\n      }\n\n      // ── Step 4: Attach billing address + payment method to cart item ──────\n      const { cartItemUid } = await client.getCartItem(createdCart.biId);\n      await client.updateCartItem({\n        cartItemUid,\n        billingAddress: toCartAddress(billing),\n        paymentMethodId: paymentMethod.id,\n      });\n\n      // ── Step 5: Persist auto-renewal consent on the TwouCart BI ───────────\n      await client.updateCartConsent({\n        cartUid: createdCart.uid,\n        consent,\n      });\n\n      // ── Step 6: Fire the backend workflow ─────────────────────────────────\n      await client.placeOrder(createdCart.uid);\n\n      return createdCart;\n    },\n    onSuccess: (cart) => {\n      optimisticConfirm(cart.biId);\n    },\n    onError: (err) => {\n      if (err instanceof CardValidationError) ctx.setCardError(err.message);\n      else ctx.setError(err.message);\n    },\n  });\n\n  return { placeOrder };\n}\n"]}

package/dist/data/hooks/useCheckoutQueries.d.ts

@@ -0,0 +1,30 @@
+import type { CheckoutClient, CartStatusResult, BillingPlansResult, CourseDetail } from '../../types';
+/** Exchange edX session cookies for a viax token on page load. */
+export declare function useViaxSessionQuery(sessionUrl: string | null): import("@tanstack/react-query").UseQueryResult<import("../../utils/provision").EdxSessionResult, Error>;
+/**
+ * Fetches billing plans after the viax session is established.
+ * Used to display prices in CartSummary before the user starts checkout.
+ */
+export declare function useBillingPlansQuery(client: CheckoutClient | null, sessionReady: boolean): import("@tanstack/react-query").UseQueryResult<BillingPlansResult, Error>;
+/**
+ * Fetches the live active subscriber count after the viax session is ready.
+ * Refreshes every 5 minutes so the number stays roughly current.
+ */
+export declare function useActiveSubscriptionsQuery(client: CheckoutClient | null, sessionReady: boolean): import("@tanstack/react-query").UseQueryResult<{
+    active: number;
+}, Error>;
+/**
+ * Fetches the user's country from their edX account profile.
+ * Derives the LMS base URL from the session URL (same origin).
+ * Returns null if the fetch fails or the field is absent — checkout stays open in that case.
+ */
+export declare function useUserCountryQuery(sessionUrl: string | null, username: string | null): import("@tanstack/react-query").UseQueryResult<string | null, Error>;
+/** Polls the cart state machine every second; stops on terminal states. */
+export declare function useCartStatusQuery(client: CheckoutClient | null, cartBiId: string | null): import("@tanstack/react-query").UseQueryResult<CartStatusResult, Error>;
+/** Looks up the created subscription biId after success. */
+export declare function useSubscriptionIdQuery(client: CheckoutClient | null, cartBiId: string | null, enabled: boolean): import("@tanstack/react-query").UseQueryResult<import("../../types").SubscriptionDetails | null, Error>;
+/**
+ * Fetches course details when the user arrived via ?course_run_key=.
+ * Skipped entirely when no course key is present (standard checkout).
+ */
+export declare function useCourseDetailQuery(client: CheckoutClient | null, sessionReady: boolean, courseRunKey: string | null): import("@tanstack/react-query").UseQueryResult<CourseDetail | null, Error>;

package/dist/data/hooks/useCheckoutQueries.js

@@ -0,0 +1,97 @@
+/**
+ * query/useCheckoutQueries.ts — read-side TanStack Query hooks.
+ *
+ * useViaxSessionQuery runs on mount to exchange the edX session for a viax
+ * token. Billing plans and subscriber count wait until the session is ready.
+ */
+import { useQuery } from '@tanstack/react-query';
+import { isTerminalStatus } from '../../constants';
+import { checkoutKeys } from './keys';
+import { fetchEdxSession, fetchUserCountry } from '../../utils/provision';
+/** Exchange edX session cookies for a viax token on page load. */
+export function useViaxSessionQuery(sessionUrl) {
+    return useQuery({
+        queryKey: checkoutKeys.viaxSession(),
+        enabled: !!sessionUrl,
+        queryFn: () => fetchEdxSession(sessionUrl),
+        staleTime: 5 * 60 * 1000,
+        retry: 1,
+    });
+}
+/**
+ * Fetches billing plans after the viax session is established.
+ * Used to display prices in CartSummary before the user starts checkout.
+ */
+export function useBillingPlansQuery(client, sessionReady) {
+    return useQuery({
+        queryKey: checkoutKeys.billingPlans(),
+        enabled: !!client && sessionReady,
+        queryFn: () => client.getBillingPlans(),
+        staleTime: Infinity,
+        retry: 2,
+    });
+}
+/**
+ * Fetches the live active subscriber count after the viax session is ready.
+ * Refreshes every 5 minutes so the number stays roughly current.
+ */
+export function useActiveSubscriptionsQuery(client, sessionReady) {
+    return useQuery({
+        queryKey: ['checkout', 'activeSubscriptions'],
+        enabled: !!client && sessionReady,
+        queryFn: () => client.getActiveSubscriptions(),
+        staleTime: 5 * 60 * 1000, // 5 minutes
+        retry: 1,
+    });
+}
+/**
+ * Fetches the user's country from their edX account profile.
+ * Derives the LMS base URL from the session URL (same origin).
+ * Returns null if the fetch fails or the field is absent — checkout stays open in that case.
+ */
+export function useUserCountryQuery(sessionUrl, username) {
+    return useQuery({
+        queryKey: ['checkout', 'userCountry', username],
+        enabled: !!sessionUrl && !!username,
+        queryFn: () => {
+            const lmsBaseUrl = new URL(sessionUrl).origin;
+            return fetchUserCountry(lmsBaseUrl, username);
+        },
+        staleTime: Infinity,
+        retry: 1,
+    });
+}
+/** Polls the cart state machine every second; stops on terminal states. */
+export function useCartStatusQuery(client, cartBiId) {
+    return useQuery({
+        queryKey: checkoutKeys.status(cartBiId !== null && cartBiId !== void 0 ? cartBiId : 'none'),
+        enabled: !!client && !!cartBiId,
+        queryFn: () => client.getCartStatus(cartBiId),
+        refetchInterval: (query) => { var _a, _b; return isTerminalStatus((_b = (_a = query.state.data) === null || _a === void 0 ? void 0 : _a.status) !== null && _b !== void 0 ? _b : null) ? false : 1000; },
+        refetchOnWindowFocus: false,
+        gcTime: 0,
+    });
+}
+/** Looks up the created subscription biId after success. */
+export function useSubscriptionIdQuery(client, cartBiId, enabled) {
+    return useQuery({
+        queryKey: checkoutKeys.subscriptionId(cartBiId !== null && cartBiId !== void 0 ? cartBiId : 'none'),
+        enabled: enabled && !!client && !!cartBiId,
+        queryFn: () => client.findSubscriptionBiId(cartBiId),
+        staleTime: Infinity,
+    });
+}
+/**
+ * Fetches course details when the user arrived via ?course_run_key=.
+ * Skipped entirely when no course key is present (standard checkout).
+ */
+export function useCourseDetailQuery(client, sessionReady, courseRunKey) {
+    return useQuery({
+        queryKey: checkoutKeys.courseDetail(courseRunKey !== null && courseRunKey !== void 0 ? courseRunKey : 'none'),
+        enabled: !!client && sessionReady && !!courseRunKey,
+        queryFn: () => client.getCourseDetail(courseRunKey),
+        staleTime: Infinity,
+        retry: 1,
+    });
+}
+//# sourceMappingURL=useCheckoutQueries.js.map

package/dist/data/hooks/useCheckoutQueries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCheckoutQueries.js","sourceRoot":"","sources":["../../../src/data/hooks/useCheckoutQueries.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * query/useCheckoutQueries.ts — read-side TanStack Query hooks.\n *\n * useViaxSessionQuery runs on mount to exchange the edX session for a viax\n * token. Billing plans and subscriber count wait until the session is ready.\n */\nimport { useQuery } from '@tanstack/react-query';\nimport { isTerminalStatus } from '../../constants';\nimport { checkoutKeys } from './keys';\nimport { fetchEdxSession, fetchUserCountry } from '../../utils/provision';\nimport type { CheckoutClient, CartStatusResult, BillingPlansResult, CourseDetail } from '../../types';\n\n/** Exchange edX session cookies for a viax token on page load. */\nexport function useViaxSessionQuery(sessionUrl: string | null) {\n  return useQuery({\n    queryKey: checkoutKeys.viaxSession(),\n    enabled: !!sessionUrl,\n    queryFn: () => fetchEdxSession(sessionUrl!),\n    staleTime: 5 * 60 * 1000,\n    retry: 1,\n  });\n}\n\n/**\n * Fetches billing plans after the viax session is established.\n * Used to display prices in CartSummary before the user starts checkout.\n */\nexport function useBillingPlansQuery(client: CheckoutClient | null, sessionReady: boolean) {\n  return useQuery({\n    queryKey: checkoutKeys.billingPlans(),\n    enabled: !!client && sessionReady,\n    queryFn: (): Promise<BillingPlansResult> => client!.getBillingPlans(),\n    staleTime: Infinity,\n    retry: 2,\n  });\n}\n\n/**\n * Fetches the live active subscriber count after the viax session is ready.\n * Refreshes every 5 minutes so the number stays roughly current.\n */\nexport function useActiveSubscriptionsQuery(client: CheckoutClient | null, sessionReady: boolean) {\n  return useQuery({\n    queryKey: ['checkout', 'activeSubscriptions'],\n    enabled: !!client && sessionReady,\n    queryFn: () => client!.getActiveSubscriptions(),\n    staleTime: 5 * 60 * 1000, // 5 minutes\n    retry: 1,\n  });\n}\n\n/**\n * Fetches the user's country from their edX account profile.\n * Derives the LMS base URL from the session URL (same origin).\n * Returns null if the fetch fails or the field is absent — checkout stays open in that case.\n */\nexport function useUserCountryQuery(sessionUrl: string | null, username: string | null) {\n  return useQuery({\n    queryKey: ['checkout', 'userCountry', username],\n    enabled: !!sessionUrl && !!username,\n    queryFn: () => {\n      const lmsBaseUrl = new URL(sessionUrl!).origin;\n      return fetchUserCountry(lmsBaseUrl, username!);\n    },\n    staleTime: Infinity,\n    retry: 1,\n  });\n}\n\n/** Polls the cart state machine every second; stops on terminal states. */\nexport function useCartStatusQuery(client: CheckoutClient | null, cartBiId: string | null) {\n  return useQuery({\n    queryKey: checkoutKeys.status(cartBiId ?? 'none'),\n    enabled: !!client && !!cartBiId,\n    queryFn: (): Promise<CartStatusResult> => client!.getCartStatus(cartBiId!),\n    refetchInterval: (query) =>\n      isTerminalStatus(query.state.data?.status ?? null) ? false : 1000,\n    refetchOnWindowFocus: false,\n    gcTime: 0,\n  });\n}\n\n/** Looks up the created subscription biId after success. */\nexport function useSubscriptionIdQuery(\n  client: CheckoutClient | null,\n  cartBiId: string | null,\n  enabled: boolean,\n) {\n  return useQuery({\n    queryKey: checkoutKeys.subscriptionId(cartBiId ?? 'none'),\n    enabled: enabled && !!client && !!cartBiId,\n    queryFn: () => client!.findSubscriptionBiId(cartBiId!),\n    staleTime: Infinity,\n  });\n}\n\n/**\n * Fetches course details when the user arrived via ?course_run_key=.\n * Skipped entirely when no course key is present (standard checkout).\n */\nexport function useCourseDetailQuery(\n  client: CheckoutClient | null,\n  sessionReady: boolean,\n  courseRunKey: string | null,\n) {\n  return useQuery({\n    queryKey: checkoutKeys.courseDetail(courseRunKey ?? 'none'),\n    enabled: !!client && sessionReady && !!courseRunKey,\n    queryFn: (): Promise<CourseDetail | null> => client!.getCourseDetail(courseRunKey!),\n    staleTime: Infinity,\n    retry: 1,\n  });\n}\n"]}

package/dist/data/services/subs/urls.d.ts

@@ -0,0 +1,2 @@
+export function getApiUrl(): string;
+export function getSubsInitApiUrl(): string;

package/dist/data/services/subs/urls.js

@@ -0,0 +1,4 @@
+import { getSiteConfig } from '@openedx/frontend-base';
+export const getApiUrl = () => (`${getSiteConfig().lmsBaseUrl}/api`);
+export const getSubsInitApiUrl = () => (`${getApiUrl()}/subscription/init/`);
+//# sourceMappingURL=urls.js.map

package/dist/data/services/subs/urls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"urls.js","sourceRoot":"","sources":["../../../../src/data/services/subs/urls.js"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,aAAa,EAAE,CAAC,UAAU,MAAM,CAAC,CAAC;AAErE,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,SAAS,EAAE,qBAAqB,CAAC,CAAC","sourcesContent":["import { getSiteConfig } from '@openedx/frontend-base';\n\nexport const getApiUrl = () => (`${getSiteConfig().lmsBaseUrl}/api`);\n\nexport const getSubsInitApiUrl = () => (`${getApiUrl()}/subscription/init/`);\n"]}

package/dist/i18n/index.d.ts

@@ -0,0 +1 @@
+export { default } from './messages';

package/dist/i18n/index.js

@@ -0,0 +1,2 @@
+export { default } from './messages';
+//# sourceMappingURL=index.js.map

package/dist/i18n/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/i18n/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC","sourcesContent":["export { default } from './messages';\n"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { default as subscriptionCheckoutApp } from './app';
+export { default as subscriptionCheckoutRoutes } from './routes';

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default as subscriptionCheckoutApp } from './app';
+export { default as subscriptionCheckoutRoutes } from './routes';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,0BAA0B,EAAE,MAAM,UAAU,CAAC","sourcesContent":["export { default as subscriptionCheckoutApp } from './app';\nexport { default as subscriptionCheckoutRoutes } from './routes';\n"]}

package/dist/messages.d.ts

@@ -0,0 +1,8 @@
+declare const messages: {
+    'template.page.title': {
+        id: string;
+        defaultMessage: string;
+        description: string;
+    };
+};
+export default messages;

package/dist/messages.js

@@ -0,0 +1,10 @@
+import { defineMessages } from '@openedx/frontend-base';
+const messages = defineMessages({
+    'template.page.title': {
+        id: 'template.page.title',
+        defaultMessage: 'Template | {siteName}',
+        description: 'Document title for the template app',
+    },
+});
+export default messages;
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAExD,MAAM,QAAQ,GAAG,cAAc,CAAC;IAC9B,qBAAqB,EAAE;QACrB,EAAE,EAAE,qBAAqB;QACzB,cAAc,EAAE,uBAAuB;QACvC,WAAW,EAAE,qCAAqC;KACnD;CACF,CAAC,CAAC;AAEH,eAAe,QAAQ,CAAC","sourcesContent":["import { defineMessages } from '@openedx/frontend-base';\n\nconst messages = defineMessages({\n  'template.page.title': {\n    id: 'template.page.title',\n    defaultMessage: 'Template | {siteName}',\n    description: 'Document title for the template app',\n  },\n});\n\nexport default messages;\n"]}

package/dist/routes.d.ts

@@ -0,0 +1,18 @@
+declare const routes: {
+    id: string;
+    path: string;
+    loader: (args: any) => Promise<null>;
+    handle: {
+        roles: string[];
+    };
+    lazy(): Promise<{
+        Component: () => import("react/jsx-runtime").JSX.Element;
+    }>;
+    children: {
+        index: boolean;
+        lazy(): Promise<{
+            Component: import("react").FC<{}>;
+        }>;
+    }[];
+}[];
+export default routes;

package/dist/routes.js

@@ -0,0 +1,67 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { authenticatedLoader, getAuthenticatedHttpClient, } from '@openedx/frontend-base';
+import { redirect } from 'react-router-dom';
+import { getSubsInitApiUrl } from './data/services/subs/urls';
+import { subscriptionCheckoutRole } from './constants';
+// loader to check if the user has subscription access
+const subscriptionAccessLoader = () => __awaiter(void 0, void 0, void 0, function* () {
+    try {
+        const { data } = yield getAuthenticatedHttpClient().get(getSubsInitApiUrl());
+        if (data.userSubscription && data.userSubscription.isSubscriber) {
+            throw redirect('/subscription-learner-dashboard'); // redirect to subscription learner dashboard if user have subscription access
+        }
+        return null;
+    }
+    catch (error) {
+        // Let redirect responses bubble up
+        if (error instanceof Response) {
+            throw error;
+        }
+        throw redirect('/learner-dashboard'); // redirect to learner dashboard if an error occurs
+    }
+});
+// composed loader that checks for authentication and subscription access
+const protectedLoader = (args) => __awaiter(void 0, void 0, void 0, function* () {
+    yield authenticatedLoader(args);
+    yield subscriptionAccessLoader();
+    return null;
+});
+const routes = [
+    {
+        id: 'org.openedx.frontend.route.template.main',
+        path: 'checkout-page',
+        loader: protectedLoader,
+        handle: {
+            roles: [subscriptionCheckoutRole],
+        },
+        lazy() {
+            return __awaiter(this, void 0, void 0, function* () {
+                const module = yield import(
+                /* webpackChunkName: "template-main" */ './Main');
+                return { Component: module.default };
+            });
+        },
+        children: [
+            {
+                index: true,
+                lazy() {
+                    return __awaiter(this, void 0, void 0, function* () {
+                        const module = yield import(
+                        /* webpackChunkName: "CheckoutPage" */ './checkoutPage/CheckoutPage');
+                        return { Component: module.default };
+                    });
+                },
+            },
+        ],
+    },
+];
+export default routes;
+//# sourceMappingURL=routes.js.map

package/dist/routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../src/routes.tsx"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EACL,mBAAmB,EACnB,0BAA0B,GAC3B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAEvD,sDAAsD;AACtD,MAAM,wBAAwB,GAAG,GAAS,EAAE;IAC1C,IAAI,CAAC;QACH,MAAM,EAAE,IAAI,EAAE,GACV,MAAM,0BAA0B,EAAE,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,CAAC;QAEhE,IAAI,IAAI,CAAC,gBAAgB,IAAI,IAAI,CAAC,gBAAgB,CAAC,YAAY,EAAE,CAAC;YAChE,MAAM,QAAQ,CAAC,iCAAiC,CAAC,CAAC,CAAC,8EAA8E;QACnI,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,mCAAmC;QACnC,IAAI,KAAK,YAAY,QAAQ,EAAE,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC;QAED,MAAM,QAAQ,CAAC,oBAAoB,CAAC,CAAC,CAAC,mDAAmD;IAC3F,CAAC;AACH,CAAC,CAAA,CAAC;AAEF,yEAAyE;AACzE,MAAM,eAAe,GAAG,CAAO,IAAI,EAAE,EAAE;IACrC,MAAM,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAChC,MAAM,wBAAwB,EAAE,CAAC;IAEjC,OAAO,IAAI,CAAC;AACd,CAAC,CAAA,CAAC;AAEF,MAAM,MAAM,GAAG;IACb;QACE,EAAE,EAAE,0CAA0C;QAC9C,IAAI,EAAE,eAAe;QACrB,MAAM,EAAE,eAAe;QACvB,MAAM,EAAE;YACN,KAAK,EAAE,CAAC,wBAAwB,CAAC;SAClC;QACK,IAAI;;gBACR,MAAM,MAAM,GAAG,MAAM,MAAM;gBACzB,uCAAuC,CAAC,QAAQ,CACjD,CAAC;gBACF,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;YACvC,CAAC;SAAA;QACD,QAAQ,EAAE;YACR;gBACE,KAAK,EAAE,IAAI;gBACL,IAAI;;wBACR,MAAM,MAAM,GAAG,MAAM,MAAM;wBACzB,sCAAsC,CAAC,6BAA6B,CACrE,CAAC;wBACF,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;oBACvC,CAAC;iBAAA;aACF;SACF;KACF;CACF,CAAC;AAEF,eAAe,MAAM,CAAC","sourcesContent":["import {\n  authenticatedLoader,\n  getAuthenticatedHttpClient,\n} from '@openedx/frontend-base';\nimport { redirect } from 'react-router-dom';\n\nimport { getSubsInitApiUrl } from './data/services/subs/urls';\nimport { subscriptionCheckoutRole } from './constants';\n\n// loader to check if the user has subscription access\nconst subscriptionAccessLoader = async () => {\n  try {\n    const { data }\n      = await getAuthenticatedHttpClient().get(getSubsInitApiUrl());\n\n    if (data.userSubscription && data.userSubscription.isSubscriber) {\n      throw redirect('/subscription-learner-dashboard'); // redirect to subscription learner dashboard if user have subscription access\n    }\n\n    return null;\n  } catch (error) {\n    // Let redirect responses bubble up\n    if (error instanceof Response) {\n      throw error;\n    }\n\n    throw redirect('/learner-dashboard'); // redirect to learner dashboard if an error occurs\n  }\n};\n\n// composed loader that checks for authentication and subscription access\nconst protectedLoader = async (args) => {\n  await authenticatedLoader(args);\n  await subscriptionAccessLoader();\n\n  return null;\n};\n\nconst routes = [\n  {\n    id: 'org.openedx.frontend.route.template.main',\n    path: 'checkout-page',\n    loader: protectedLoader,\n    handle: {\n      roles: [subscriptionCheckoutRole],\n    },\n    async lazy() {\n      const module = await import(\n        /* webpackChunkName: \"template-main\" */ './Main'\n      );\n      return { Component: module.default };\n    },\n    children: [\n      {\n        index: true,\n        async lazy() {\n          const module = await import(\n            /* webpackChunkName: \"CheckoutPage\" */ './checkoutPage/CheckoutPage'\n          );\n          return { Component: module.default };\n        },\n      },\n    ],\n  },\n];\n\nexport default routes;\n"]}

package/dist/slots/ExampleSlot/ExampleSlot.d.ts

@@ -0,0 +1,3 @@
+export declare const exampleSlotId = "org.openedx.frontend.slot.template.example.v1";
+declare const ExampleSlot: () => import("react/jsx-runtime").JSX.Element;
+export default ExampleSlot;

package/dist/slots/ExampleSlot/ExampleSlot.js

@@ -0,0 +1,6 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Slot } from '@openedx/frontend-base';
+export const exampleSlotId = 'org.openedx.frontend.slot.template.example.v1';
+const ExampleSlot = () => (_jsx(Slot, { id: exampleSlotId }));
+export default ExampleSlot;
+//# sourceMappingURL=ExampleSlot.js.map

package/dist/slots/ExampleSlot/ExampleSlot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExampleSlot.js","sourceRoot":"","sources":["../../../src/slots/ExampleSlot/ExampleSlot.tsx"],"names":[],"mappings":";AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,wBAAwB,CAAC;AAE9C,MAAM,CAAC,MAAM,aAAa,GAAG,+CAA+C,CAAC;AAE7E,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,CACxB,KAAC,IAAI,IAAC,EAAE,EAAE,aAAa,GAAI,CAC5B,CAAC;AAEF,eAAe,WAAW,CAAC","sourcesContent":["import { Slot } from '@openedx/frontend-base';\n\nexport const exampleSlotId = 'org.openedx.frontend.slot.template.example.v1';\n\nconst ExampleSlot = () => (\n  <Slot id={exampleSlotId} />\n);\n\nexport default ExampleSlot;\n"]}

package/dist/slots.d.ts

@@ -0,0 +1,3 @@
+import { SlotOperation } from '@openedx/frontend-base';
+declare const slots: SlotOperation[];
+export default slots;