@edx/frontend-app-subscription-checkout 1.0.0

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"","sourcesContent":["import type { Status, Phase } from './constants';\n\nexport type { Status, Phase };\n\n// --- Bootstrap domain --------------------------------------------------------\nexport interface TwouCustomerContact {\n  email?: string,\n}\n\nexport interface TwouCustomerParty {\n  paName: string,\n  indFirstName?: string,\n  indLastName?: string,\n  paContacts: { edges: { node: TwouCustomerContact }[] },\n}\n\nexport interface TwouCustomer {\n  uid: string,\n  parId: string,\n  parParty: TwouCustomerParty,\n}\n\nexport type GqlRunner = (query: string, variables?: Record<string, unknown>, retry?: boolean) => Promise<any>;\n\n// --- Cart domain -------------------------------------------------------------\nexport interface Cart {\n  biId: string,\n  uid: string,\n}\n\nexport interface CartIds {\n  customerUid: string,\n  salableUid: string,\n  billingPlanUid: string,\n}\n\nexport type BillingCycle = 'monthly' | 'annual';\n\nexport type BillingPeriod = 'MONTHLY' | 'ANNUAL' | 'QUARTERLY' | string;\n\nexport interface BillingPlanOwnershipModel {\n  uid: string,\n  omName: string,\n}\n\nexport interface BillingPlan {\n  uid: string,\n  stripePriceId: string,\n  /** Price amount e.g. \"39.99\" */\n  amount: string,\n  /** Currency code e.g. \"USD\" */\n  currency: string,\n  isTemplate: boolean,\n  ownershipModel: BillingPlanOwnershipModel,\n}\n\nexport interface SubscriptionDetails {\n  biId: string, // \"BI301ZDAD6CMICG2\"\n  trialStart: string | null,\n  trialEnd: string | null,\n  renewalType: string | null, // \"Annual\" | \"Monthly\"\n  cardLast4: string | null, // \"4242\"\n  cardBrand: string | null, // \"visa\" | \"mastercard\" etc\n  stripePaymentMethodId: string | null,\n  planName: string | null, // \"Monthly Subscription\"\n}\n\nexport interface CurrentUserSubscriberResult {\n  isSubscriber: boolean,\n  subscriptionBiId: string | null,\n  status: string | null,\n  subscriptionStartDate: string | null,\n  currentPeriodEnd: string | null,\n}\n\n/** Course shown on checkout / post-checkout when arriving via ?course_run_key=. */\nexport interface CourseDetail {\n  maId: string,\n  maName: string,\n  maDescription: string | null,\n  tShortDescription: string | null,\n  imageUrl: string | null,\n  tCourseKey: string | null,\n  tBrandText: string | null,\n  tPrimarySubjectArea: string | null,\n  tLevelType: string | null,\n  tLanguage: string | null,\n  tPacingType: string | null,\n  tDurationLow: number | null,\n  tDurationHigh: number | null,\n  tDurationUnit: string | null,\n  tEffortLow: number | null,\n  tEffortHigh: number | null,\n  tEffortUnit: string | null,\n  tUrlCourse: string | null,\n  tB2cSubscriptionInclusion: boolean | null,\n  tHasOfacRestrictions: boolean | null,\n  tCatalogActive: boolean | null,\n}\n\n/** Returned by getBillingPlans — all available plans for the product. */\nexport interface BillingPlansResult {\n  plans: BillingPlan[],\n}\n\n/** Returned by getSalableUid — the product uid and its ownership models. */\nexport interface ProductInfo {\n  uid: string,\n  maName: string,\n  ownershipModels: { uid: string, omName: string }[],\n}\n\nexport interface CartStatusResult {\n  status: Status | null,\n  stripeSubscriptionId: string | null,\n  lastComment: string,\n}\n\nexport interface CartBillingAddress {\n  tFirstName: string,\n  tLastName: string,\n  upaLine1: string,\n  upaCity: string,\n  upaPostcode: string,\n  gadStateOrProvince: string,\n  gadCountry: { iso2Code: string },\n}\n\nexport interface UpdateCartItemArgs {\n  cartItemUid: string,\n  billingAddress?: CartBillingAddress,\n  paymentMethodId?: string,\n}\n\n/** Auto-renewal consent captured on TwouCart at checkout confirmation (SUBS-228). */\nexport interface CheckoutConsent {\n  /** Main auto-renewal checkbox — always required at submit. */\n  tConsentRecurring: boolean,\n  /** UK/CA resident checkbox; null when that checkbox is not shown. */\n  tConsentUkCa: boolean | null,\n  /** ISO-8601 timestamp when consent was captured. */\n  tConsentAt: string,\n  /** Exact disclosure text shown to the learner (audit trail). */\n  tConsentText: string,\n}\n\nexport interface UpdateCartConsentArgs {\n  cartUid: string,\n  consent: CheckoutConsent,\n}\n\nexport interface BillingInfo {\n  firstName: string,\n  lastName: string,\n  city: string,\n  zip: string,\n  country: string,\n  line1: string,\n  state: string,\n}\n\n// --- Checkout client surface -------------------------------------------------\nexport interface CheckoutClient {\n  gql: GqlRunner,\n  setToken: (token: string) => void,\n  createCart: (vars: CartIds) => Promise<Cart>,\n  getCartItem: (biId: string) => Promise<{ cartUid: string, cartItemUid: string }>,\n  updateCartItem: (args: UpdateCartItemArgs) => Promise<void>,\n  updateCartConsent: (args: UpdateCartConsentArgs) => Promise<void>,\n  placeOrder: (cartUid: string) => Promise<unknown>,\n  getCartStatus: (biId: string) => Promise<CartStatusResult>,\n  findSubscriptionBiId: (biId: string) => Promise<SubscriptionDetails | null>,\n  getSalableUid: (maId: string) => Promise<ProductInfo>,\n  getBillingPlans: () => Promise<BillingPlansResult>,\n  getActiveSubscriptions: () => Promise<{ active: number }>,\n  isCurrentUserSubscriber: () => Promise<CurrentUserSubscriberResult | null>,\n  getCourseDetail: (courseKey: string) => Promise<CourseDetail | null>,\n}\n\nexport interface DevAuth {\n  iamUrl: string,\n  clientId: string,\n  clientSecret: string,\n}\n\n// --- Minimal Stripe.js types -------------------------------------------------\n// Just the surface this module uses. If you depend on `@stripe/stripe-js`,\n// you can replace these with its richer types.\nexport interface StripeElementChangeEvent {\n  error?: { message?: string },\n  [key: string]: unknown,\n}\n\nexport interface StripeElementLike {\n  mount: (node: HTMLElement) => void,\n  on: (event: string, handler: (e: StripeElementChangeEvent) => void) => void,\n  unmount?: () => void,\n}\n\nexport interface StripeElementsLike {\n  create: (type: string, options?: Record<string, unknown>) => StripeElementLike,\n}\n\nexport interface StripeError {\n  message?: string,\n  code?: string,\n}\n\nexport interface PaymentMethodResult {\n  paymentMethod?: { id: string },\n  error?: StripeError,\n}\n\nexport interface ConfirmResult {\n  error?: StripeError,\n  setupIntent?: unknown,\n  paymentIntent?: unknown,\n}\n\nexport interface CreatePaymentMethodParams {\n  type: 'card',\n  card: StripeElementLike,\n  billing_details?: Record<string, unknown>,\n}\n\nexport interface StripeLike {\n  elements: () => StripeElementsLike,\n  createPaymentMethod: (params: CreatePaymentMethodParams) => Promise<PaymentMethodResult>,\n  confirmCardSetup: (clientSecret: string) => Promise<ConfirmResult>,\n  confirmCardPayment: (clientSecret: string) => Promise<ConfirmResult>,\n}\n\ndeclare global {\n  interface Window {\n    Stripe?: (publishableKey: string) => StripeLike,\n  }\n}\n\nexport interface TrialDateRange {\n  /** e.g. \"June 22, 2026\" */\n  displayStart: string,\n  /** e.g. \"June 29, 2026\" */\n  displayEnd: string,\n}\n"]}

package/dist/utils/auth.d.ts

@@ -0,0 +1,7 @@
+import type { CheckoutClient } from '../types';
+interface CheckoutClientConfig {
+    apiUrl: string;
+    confirmIntentUrl?: string;
+}
+export declare function createCheckoutClient({ apiUrl }: CheckoutClientConfig): CheckoutClient;
+export {};

package/dist/utils/auth.js

@@ -0,0 +1,28 @@
+/**
+ * api/index.ts — composes the pieces into a single checkout client and
+ * re-exports the API utilities.
+ */
+import { createGqlClient } from './graphqlClient';
+import * as cart from './cartApi';
+import * as bootstrap from './bootstrapApi';
+export function createCheckoutClient({ apiUrl }) {
+    const { gql, setToken } = createGqlClient({ apiUrl });
+    const fetchStatus = (biId) => cart.getCartStatus(gql, biId);
+    return {
+        gql,
+        setToken,
+        createCart: (vars) => cart.createCart(gql, vars),
+        getCartItem: (biId) => cart.getCartItem(gql, biId),
+        updateCartItem: (args) => cart.updateCartItem(gql, args),
+        updateCartConsent: (args) => cart.updateCartConsent(gql, args),
+        placeOrder: (cartUid) => cart.placeOrder(gql, cartUid),
+        getCartStatus: fetchStatus,
+        findSubscriptionBiId: (biId) => cart.findSubscriptionBiId(gql, biId),
+        getSalableUid: (maId) => bootstrap.getSalableUid(gql, maId),
+        getBillingPlans: () => bootstrap.getBillingPlans(gql),
+        getActiveSubscriptions: () => bootstrap.getActiveSubscriptions(gql),
+        isCurrentUserSubscriber: () => bootstrap.isCurrentUserSubscriber(gql),
+        getCourseDetail: (courseKey) => bootstrap.getCourseDetail(gql, courseKey),
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/utils/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/utils/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAU5C,MAAM,UAAU,oBAAoB,CAClC,EAAE,MAAM,EAAwB;IAEhC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAEpE,OAAO;QACL,GAAG;QACH,QAAQ;QACR,UAAU,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC;QACzD,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC;QAClD,cAAc,EAAE,CAAC,IAAwB,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC;QAC5E,iBAAiB,EAAE,CAAC,IAA2B,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC;QACrF,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;QACtD,aAAa,EAAE,WAAW;QAC1B,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC;QACpE,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC;QAC3D,eAAe,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC;QACrD,sBAAsB,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,GAAG,CAAC;QACnE,uBAAuB,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,uBAAuB,CAAC,GAAG,CAAC;QACrE,eAAe,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC;KAC1E,CAAC;AACJ,CAAC","sourcesContent":["/**\n * api/index.ts — composes the pieces into a single checkout client and\n * re-exports the API utilities.\n */\nimport { createGqlClient } from './graphqlClient';\nimport * as cart from './cartApi';\nimport * as bootstrap from './bootstrapApi';\nimport type {\n  CheckoutClient, CartIds, UpdateCartItemArgs, UpdateCartConsentArgs,\n} from '../types';\n\ninterface CheckoutClientConfig {\n  apiUrl: string,\n  confirmIntentUrl?: string,\n}\n\nexport function createCheckoutClient(\n  { apiUrl }: CheckoutClientConfig,\n): CheckoutClient {\n  const { gql, setToken } = createGqlClient({ apiUrl });\n  const fetchStatus = (biId: string) => cart.getCartStatus(gql, biId);\n\n  return {\n    gql,\n    setToken,\n    createCart: (vars: CartIds) => cart.createCart(gql, vars),\n    getCartItem: (biId) => cart.getCartItem(gql, biId),\n    updateCartItem: (args: UpdateCartItemArgs) => cart.updateCartItem(gql, args),\n    updateCartConsent: (args: UpdateCartConsentArgs) => cart.updateCartConsent(gql, args),\n    placeOrder: (cartUid) => cart.placeOrder(gql, cartUid),\n    getCartStatus: fetchStatus,\n    findSubscriptionBiId: (biId) => cart.findSubscriptionBiId(gql, biId),\n    getSalableUid: (maId) => bootstrap.getSalableUid(gql, maId),\n    getBillingPlans: () => bootstrap.getBillingPlans(gql),\n    getActiveSubscriptions: () => bootstrap.getActiveSubscriptions(gql),\n    isCurrentUserSubscriber: () => bootstrap.isCurrentUserSubscriber(gql),\n    getCourseDetail: (courseKey) => bootstrap.getCourseDetail(gql, courseKey),\n  };\n}\n"]}

package/dist/utils/billingDetails.d.ts

@@ -0,0 +1,30 @@
+import type { BillingPlan, BillingCycle } from '../types';
+export interface PlanPrice {
+    uid: string;
+    stripePriceId: string;
+    amount: string;
+    currency: string;
+    label: string;
+}
+/**
+ * getPlanPrice — returns the price for the selected billing cycle.
+ *
+ * Matches plans by looking for "annual"/"year" or "month" in omName.
+ * Falls back to the first plan if no match is found.
+ *
+ * @example
+ *   getPlanPrice(billingPlans, 'monthly')
+ *   // → { uid: '...', amount: '11', currency: 'USD', label: '$11 USD/month' }
+ *
+ *   getPlanPrice(billingPlans, 'annual')
+ *   // → { uid: '...', amount: '111', currency: 'USD', label: '$111 USD/year' }
+ */
+export declare function getPlanPrice(plans: BillingPlan[], cycle: BillingCycle): PlanPrice | null;
+/**
+ * getRenewalLabel — returns a "Then $X/month" style label for CartSummary.
+ *
+ * @example
+ *   getRenewalLabel(billingPlans, 'monthly') // → "Then $11 USD/month"
+ *   getRenewalLabel(billingPlans, 'annual')  // → "Then $111 USD/year"
+ */
+export declare function getRenewalLabel(plans: BillingPlan[], cycle: BillingCycle): string;

package/dist/utils/billingDetails.js

@@ -0,0 +1,47 @@
+/**
+ * getPlanPrice — returns the price for the selected billing cycle.
+ *
+ * Matches plans by looking for "annual"/"year" or "month" in omName.
+ * Falls back to the first plan if no match is found.
+ *
+ * @example
+ *   getPlanPrice(billingPlans, 'monthly')
+ *   // → { uid: '...', amount: '11', currency: 'USD', label: '$11 USD/month' }
+ *
+ *   getPlanPrice(billingPlans, 'annual')
+ *   // → { uid: '...', amount: '111', currency: 'USD', label: '$111 USD/year' }
+ */
+export function getPlanPrice(plans, cycle) {
+    var _a;
+    if (!plans.length)
+        return null;
+    const isAnnual = cycle === 'annual';
+    const match = (_a = plans.find((p) => {
+        var _a, _b;
+        const name = (_b = (_a = p.ownershipModel.omName) === null || _a === void 0 ? void 0 : _a.toLowerCase()) !== null && _b !== void 0 ? _b : '';
+        return isAnnual
+            ? name.includes('annual') || name.includes('year')
+            : name.includes('month');
+    })) !== null && _a !== void 0 ? _a : plans[0];
+    return {
+        uid: match.uid,
+        stripePriceId: match.stripePriceId,
+        amount: match.amount,
+        currency: match.currency,
+        label: `$${match.amount} ${match.currency}/${isAnnual ? 'year' : 'month'}`,
+    };
+}
+/**
+ * getRenewalLabel — returns a "Then $X/month" style label for CartSummary.
+ *
+ * @example
+ *   getRenewalLabel(billingPlans, 'monthly') // → "Then $11 USD/month"
+ *   getRenewalLabel(billingPlans, 'annual')  // → "Then $111 USD/year"
+ */
+export function getRenewalLabel(plans, cycle) {
+    const price = getPlanPrice(plans, cycle);
+    if (!price)
+        return '';
+    return `Then $${price.amount} ${price.currency}/${cycle === 'annual' ? 'year' : 'month'}`;
+}
+//# sourceMappingURL=billingDetails.js.map

package/dist/utils/billingDetails.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billingDetails.js","sourceRoot":"","sources":["../../src/utils/billingDetails.ts"],"names":[],"mappings":"AAUA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAoB,EACpB,KAAmB;;IAEnB,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAE/B,MAAM,QAAQ,GAAG,KAAK,KAAK,QAAQ,CAAC;IAEpC,MAAM,KAAK,GAAG,MAAA,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;;QAC7B,MAAM,IAAI,GAAG,MAAA,MAAA,CAAC,CAAC,cAAc,CAAC,MAAM,0CAAE,WAAW,EAAE,mCAAI,EAAE,CAAC;QAC1D,OAAO,QAAQ;YACb,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;YAClD,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC,CAAC,mCAAI,KAAK,CAAC,CAAC,CAAC,CAAC;IAEf,OAAO;QACL,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE;KAC3E,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAoB,EACpB,KAAmB;IAEnB,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,OAAO,SAAS,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC5F,CAAC","sourcesContent":["import type { BillingPlan, BillingCycle } from '../types';\n\nexport interface PlanPrice {\n  uid: string,\n  stripePriceId: string,\n  amount: string,\n  currency: string,\n  label: string, // e.g. \"$11 USD/month\"\n}\n\n/**\n * getPlanPrice — returns the price for the selected billing cycle.\n *\n * Matches plans by looking for \"annual\"/\"year\" or \"month\" in omName.\n * Falls back to the first plan if no match is found.\n *\n * @example\n *   getPlanPrice(billingPlans, 'monthly')\n *   // → { uid: '...', amount: '11', currency: 'USD', label: '$11 USD/month' }\n *\n *   getPlanPrice(billingPlans, 'annual')\n *   // → { uid: '...', amount: '111', currency: 'USD', label: '$111 USD/year' }\n */\nexport function getPlanPrice(\n  plans: BillingPlan[],\n  cycle: BillingCycle,\n): PlanPrice | null {\n  if (!plans.length) return null;\n\n  const isAnnual = cycle === 'annual';\n\n  const match = plans.find((p) => {\n    const name = p.ownershipModel.omName?.toLowerCase() ?? '';\n    return isAnnual\n      ? name.includes('annual') || name.includes('year')\n      : name.includes('month');\n  }) ?? plans[0];\n\n  return {\n    uid: match.uid,\n    stripePriceId: match.stripePriceId,\n    amount: match.amount,\n    currency: match.currency,\n    label: `$${match.amount} ${match.currency}/${isAnnual ? 'year' : 'month'}`,\n  };\n}\n\n/**\n * getRenewalLabel — returns a \"Then $X/month\" style label for CartSummary.\n *\n * @example\n *   getRenewalLabel(billingPlans, 'monthly') // → \"Then $11 USD/month\"\n *   getRenewalLabel(billingPlans, 'annual')  // → \"Then $111 USD/year\"\n */\nexport function getRenewalLabel(\n  plans: BillingPlan[],\n  cycle: BillingCycle,\n): string {\n  const price = getPlanPrice(plans, cycle);\n  if (!price) return '';\n  return `Then $${price.amount} ${price.currency}/${cycle === 'annual' ? 'year' : 'month'}`;\n}\n"]}

package/dist/utils/bootstrapApi.d.ts

@@ -0,0 +1,20 @@
+import type { GqlRunner, BillingPlansResult, ProductInfo, CurrentUserSubscriberResult, CourseDetail } from '../types';
+/** Resolve the viax customer uid for the authenticated user by email. */
+export declare function getCustomerUid(gql: GqlRunner, userEmail: string): Promise<string>;
+/**
+ * Fetch the TwouSubscriptionPlan uid to use as biiSalable in createTwouCart.
+ * The maId is the product market-area identifier, e.g. "TWOU-SUB-PLAN-001".
+ * The returned `uid` is passed as biiSalable when creating the cart.
+ */
+export declare function getSalableUid(gql: GqlRunner, maId: string): Promise<ProductInfo>;
+/** Fetch all available customer billing plans. */
+export declare function getBillingPlans(gql: GqlRunner): Promise<BillingPlansResult>;
+/** Check whether the currently authenticated user already has an active subscription. */
+export declare function isCurrentUserSubscriber(gql: GqlRunner): Promise<CurrentUserSubscriberResult | null>;
+/** Fetch the number of active subscriptions. */
+export declare function getActiveSubscriptions(gql: GqlRunner): Promise<{
+    active: number;
+}>;
+/** Fetch course details for the enrollment card by tCourseKey.
+ *  Sends the course key to Viax exactly as provided (e.g. HarvardX+CS50+X). */
+export declare function getCourseDetail(gql: GqlRunner, courseKey: string): Promise<CourseDetail | null>;

package/dist/utils/bootstrapApi.js

@@ -0,0 +1,142 @@
+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());
+    });
+};
+/**
+ * api/bootstrapApi.ts — fetch the runtime ids needed to create a cart.
+ *
+ * customerUid    — looked up by the user's email from their viax party record.
+ * salableUid     — the product uid from getProduct(maId), used as biiSalable.
+ * billingPlanUid — selected from filterCustomerBillingPlan by the caller.
+ */
+import { GET_CUSTOMER, GET_BILLING_PLANS, GET_PRODUCT, GET_ACTIVE_SUBSCRIPTIONS_STATE, GET_IS_CURRENT_USER_SUBSCRIBER, GET_COURSE_DETAIL } from './queries';
+/** Resolve the viax customer uid for the authenticated user by email. */
+export function getCustomerUid(gql, userEmail) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c;
+        const filter = `parParty.paContacts.email = '${userEmail}'`;
+        const data = yield gql(GET_CUSTOMER, { filter });
+        const node = (_c = (_b = (_a = data === null || data === void 0 ? void 0 : data.filterTwouCustomer) === null || _a === void 0 ? void 0 : _a.edges) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.node;
+        if (!(node === null || node === void 0 ? void 0 : node.uid))
+            throw new Error(`No viax customer found for ${userEmail}. Ensure your account is linked.`);
+        return node.uid;
+    });
+}
+/**
+ * Fetch the TwouSubscriptionPlan uid to use as biiSalable in createTwouCart.
+ * The maId is the product market-area identifier, e.g. "TWOU-SUB-PLAN-001".
+ * The returned `uid` is passed as biiSalable when creating the cart.
+ */
+export function getSalableUid(gql, maId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const data = yield gql(GET_PRODUCT, { maId });
+        const product = data === null || data === void 0 ? void 0 : data.getProduct;
+        if (!(product === null || product === void 0 ? void 0 : product.uid))
+            throw new Error(`Product "${maId}" not found.`);
+        return {
+            uid: product.uid,
+            maName: (_a = product.maName) !== null && _a !== void 0 ? _a : '',
+            ownershipModels: ((_b = product.saOwnershipModels) !== null && _b !== void 0 ? _b : []).map((m) => ({ uid: m.uid, omName: m.omName })),
+        };
+    });
+}
+/** Fetch all available customer billing plans. */
+export function getBillingPlans(gql) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const data = yield gql(GET_BILLING_PLANS);
+        const edges = (_b = (_a = data === null || data === void 0 ? void 0 : data.filterCustomerBillingPlan) === null || _a === void 0 ? void 0 : _a.edges) !== null && _b !== void 0 ? _b : [];
+        if (!edges.length)
+            throw new Error('No billing plans found.');
+        const plans = edges.map(({ node }) => {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j;
+            return ({
+                uid: node.uid,
+                stripePriceId: node.tStripePriceId,
+                amount: (_b = (_a = node.tStripeAmount) === null || _a === void 0 ? void 0 : _a.amount) !== null && _b !== void 0 ? _b : '0',
+                currency: (_e = (_d = (_c = node.tStripeAmount) === null || _c === void 0 ? void 0 : _c.units) === null || _d === void 0 ? void 0 : _d.code) !== null && _e !== void 0 ? _e : 'USD',
+                isTemplate: node.bipIsTemplate,
+                ownershipModel: {
+                    uid: (_g = (_f = node.bipOwnershipModel) === null || _f === void 0 ? void 0 : _f.uid) !== null && _g !== void 0 ? _g : '',
+                    omName: (_j = (_h = node.bipOwnershipModel) === null || _h === void 0 ? void 0 : _h.omName) !== null && _j !== void 0 ? _j : '',
+                },
+            });
+        });
+        return { plans };
+    });
+}
+/** Check whether the currently authenticated user already has an active subscription. */
+export function isCurrentUserSubscriber(gql) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const data = yield gql(GET_IS_CURRENT_USER_SUBSCRIBER);
+        const result = data === null || data === void 0 ? void 0 : data.tIsCurrentUserSubscriber;
+        if (!result)
+            return null;
+        return {
+            isSubscriber: result.isSubscriber === true,
+            subscriptionBiId: (_a = result.subscriptionBiId) !== null && _a !== void 0 ? _a : null,
+            status: (_b = result.status) !== null && _b !== void 0 ? _b : null,
+            subscriptionStartDate: (_c = result.subscriptionStartDate) !== null && _c !== void 0 ? _c : null,
+            currentPeriodEnd: (_d = result.currentPeriodEnd) !== null && _d !== void 0 ? _d : null,
+        };
+    });
+}
+/** Fetch the number of active subscriptions. */
+export function getActiveSubscriptions(gql) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const data = yield gql(GET_ACTIVE_SUBSCRIPTIONS_STATE);
+        const active = (_a = data === null || data === void 0 ? void 0 : data.tActiveSubscriptionsState) === null || _a === void 0 ? void 0 : _a.active;
+        if (typeof active !== 'number') {
+            throw new Error('Unexpected response shape for tActiveSubscriptionsState');
+        }
+        return { active };
+    });
+}
+/** Fetch course details for the enrollment card by tCourseKey.
+ *  Sends the course key to Viax exactly as provided (e.g. HarvardX+CS50+X). */
+export function getCourseDetail(gql, courseKey) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1;
+        const key = courseKey.trim();
+        if (!key)
+            return null;
+        // Escape single quotes for the filter string only — do not alter `+` or other chars.
+        const filter = `tCourseKey = '${key.replace(/'/g, "''")}'`;
+        const data = yield gql(GET_COURSE_DETAIL, { filter });
+        const node = (_c = (_b = (_a = data === null || data === void 0 ? void 0 : data.filterTwouCourse) === null || _a === void 0 ? void 0 : _a.edges) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.node;
+        if (!(node === null || node === void 0 ? void 0 : node.maId))
+            return null;
+        return {
+            maId: node.maId,
+            maName: (_d = node.maName) !== null && _d !== void 0 ? _d : '',
+            maDescription: (_e = node.maDescription) !== null && _e !== void 0 ? _e : null,
+            tShortDescription: (_f = node.tShortDescription) !== null && _f !== void 0 ? _f : null,
+            imageUrl: (_g = node.imageUrl) !== null && _g !== void 0 ? _g : null,
+            tCourseKey: (_h = node.tCourseKey) !== null && _h !== void 0 ? _h : null,
+            tBrandText: (_j = node.tBrandText) !== null && _j !== void 0 ? _j : null,
+            tPrimarySubjectArea: (_k = node.tPrimarySubjectArea) !== null && _k !== void 0 ? _k : null,
+            tLevelType: (_l = node.tLevelType) !== null && _l !== void 0 ? _l : null,
+            tLanguage: (_m = node.tLanguage) !== null && _m !== void 0 ? _m : null,
+            tPacingType: (_p = (_o = node.tPacingType) === null || _o === void 0 ? void 0 : _o.code) !== null && _p !== void 0 ? _p : null,
+            tDurationLow: (_q = node.tDurationLow) !== null && _q !== void 0 ? _q : null,
+            tDurationHigh: (_r = node.tDurationHigh) !== null && _r !== void 0 ? _r : null,
+            tDurationUnit: (_t = (_s = node.tDurationUnit) === null || _s === void 0 ? void 0 : _s.code) !== null && _t !== void 0 ? _t : null,
+            tEffortLow: (_u = node.tEffortLow) !== null && _u !== void 0 ? _u : null,
+            tEffortHigh: (_v = node.tEffortHigh) !== null && _v !== void 0 ? _v : null,
+            tEffortUnit: (_x = (_w = node.tEffortUnit) === null || _w === void 0 ? void 0 : _w.code) !== null && _x !== void 0 ? _x : null,
+            tUrlCourse: (_y = node.tUrlCourse) !== null && _y !== void 0 ? _y : null,
+            tB2cSubscriptionInclusion: (_z = node.tB2cSubscriptionInclusion) !== null && _z !== void 0 ? _z : null,
+            tHasOfacRestrictions: (_0 = node.tHasOfacRestrictions) !== null && _0 !== void 0 ? _0 : null,
+            tCatalogActive: (_1 = node.tCatalogActive) !== null && _1 !== void 0 ? _1 : null,
+        };
+    });
+}
+//# sourceMappingURL=bootstrapApi.js.map

package/dist/utils/bootstrapApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrapApi.js","sourceRoot":"","sources":["../../src/utils/bootstrapApi.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * api/bootstrapApi.ts — fetch the runtime ids needed to create a cart.\n *\n * customerUid    — looked up by the user's email from their viax party record.\n * salableUid     — the product uid from getProduct(maId), used as biiSalable.\n * billingPlanUid — selected from filterCustomerBillingPlan by the caller.\n */\nimport { GET_CUSTOMER, GET_BILLING_PLANS, GET_PRODUCT, GET_ACTIVE_SUBSCRIPTIONS_STATE, GET_IS_CURRENT_USER_SUBSCRIBER, GET_COURSE_DETAIL } from './queries';\nimport type { GqlRunner, BillingPlansResult, BillingPlan, TwouCustomer, ProductInfo, CurrentUserSubscriberResult, CourseDetail } from '../types';\n\n/** Resolve the viax customer uid for the authenticated user by email. */\nexport async function getCustomerUid(gql: GqlRunner, userEmail: string): Promise<string> {\n  const filter = `parParty.paContacts.email = '${userEmail}'`;\n  const data = await gql(GET_CUSTOMER, { filter });\n  const node: TwouCustomer | undefined = data?.filterTwouCustomer?.edges?.[0]?.node;\n  if (!node?.uid) throw new Error(`No viax customer found for ${userEmail}. Ensure your account is linked.`);\n  return node.uid;\n}\n\n/**\n * Fetch the TwouSubscriptionPlan uid to use as biiSalable in createTwouCart.\n * The maId is the product market-area identifier, e.g. \"TWOU-SUB-PLAN-001\".\n * The returned `uid` is passed as biiSalable when creating the cart.\n */\nexport async function getSalableUid(gql: GqlRunner, maId: string): Promise<ProductInfo> {\n  const data = await gql(GET_PRODUCT, { maId });\n  const product = data?.getProduct;\n  if (!product?.uid) throw new Error(`Product \"${maId}\" not found.`);\n  return {\n    uid: product.uid,\n    maName: product.maName ?? '',\n    ownershipModels: (product.saOwnershipModels ?? []).map(\n      (m: { uid: string, omName: string }) => ({ uid: m.uid, omName: m.omName }),\n    ),\n  };\n}\n\n/** Fetch all available customer billing plans. */\nexport async function getBillingPlans(gql: GqlRunner): Promise<BillingPlansResult> {\n  const data = await gql(GET_BILLING_PLANS);\n  const edges: {\n    node: {\n      uid: string,\n      tStripePriceId: string,\n      tStripeAmount?: { amount: string, units?: { code: string } },\n      bipIsTemplate: boolean,\n      bipOwnershipModel?: { uid: string, omName: string },\n    },\n  }[] = data?.filterCustomerBillingPlan?.edges ?? [];\n\n  if (!edges.length) throw new Error('No billing plans found.');\n\n  const plans: BillingPlan[] = edges.map(({ node }) => ({\n    uid: node.uid,\n    stripePriceId: node.tStripePriceId,\n    amount: node.tStripeAmount?.amount ?? '0',\n    currency: node.tStripeAmount?.units?.code ?? 'USD',\n    isTemplate: node.bipIsTemplate,\n    ownershipModel: {\n      uid: node.bipOwnershipModel?.uid ?? '',\n      omName: node.bipOwnershipModel?.omName ?? '',\n    },\n  }));\n\n  return { plans };\n}\n\n/** Check whether the currently authenticated user already has an active subscription. */\nexport async function isCurrentUserSubscriber(gql: GqlRunner): Promise<CurrentUserSubscriberResult | null> {\n  const data = await gql(GET_IS_CURRENT_USER_SUBSCRIBER);\n  const result = data?.tIsCurrentUserSubscriber;\n  if (!result) return null;\n  return {\n    isSubscriber: result.isSubscriber === true,\n    subscriptionBiId: result.subscriptionBiId ?? null,\n    status: result.status ?? null,\n    subscriptionStartDate: result.subscriptionStartDate ?? null,\n    currentPeriodEnd: result.currentPeriodEnd ?? null,\n  };\n}\n\n/** Fetch the number of active subscriptions. */\nexport async function getActiveSubscriptions(gql: GqlRunner): Promise<{ active: number }> {\n  const data = await gql(GET_ACTIVE_SUBSCRIPTIONS_STATE);\n  const active = data?.tActiveSubscriptionsState?.active;\n  if (typeof active !== 'number') {\n    throw new Error('Unexpected response shape for tActiveSubscriptionsState');\n  }\n  return { active };\n}\n\n/** Fetch course details for the enrollment card by tCourseKey.\n *  Sends the course key to Viax exactly as provided (e.g. HarvardX+CS50+X). */\nexport async function getCourseDetail(gql: GqlRunner, courseKey: string): Promise<CourseDetail | null> {\n  const key = courseKey.trim();\n  if (!key) return null;\n\n  // Escape single quotes for the filter string only — do not alter `+` or other chars.\n  const filter = `tCourseKey = '${key.replace(/'/g, \"''\")}'`;\n  const data = await gql(GET_COURSE_DETAIL, { filter });\n  const node = data?.filterTwouCourse?.edges?.[0]?.node;\n  if (!node?.maId) return null;\n\n  return {\n    maId: node.maId,\n    maName: node.maName ?? '',\n    maDescription: node.maDescription ?? null,\n    tShortDescription: node.tShortDescription ?? null,\n    imageUrl: node.imageUrl ?? null,\n    tCourseKey: node.tCourseKey ?? null,\n    tBrandText: node.tBrandText ?? null,\n    tPrimarySubjectArea: node.tPrimarySubjectArea ?? null,\n    tLevelType: node.tLevelType ?? null,\n    tLanguage: node.tLanguage ?? null,\n    tPacingType: node.tPacingType?.code ?? null,\n    tDurationLow: node.tDurationLow ?? null,\n    tDurationHigh: node.tDurationHigh ?? null,\n    tDurationUnit: node.tDurationUnit?.code ?? null,\n    tEffortLow: node.tEffortLow ?? null,\n    tEffortHigh: node.tEffortHigh ?? null,\n    tEffortUnit: node.tEffortUnit?.code ?? null,\n    tUrlCourse: node.tUrlCourse ?? null,\n    tB2cSubscriptionInclusion: node.tB2cSubscriptionInclusion ?? null,\n    tHasOfacRestrictions: node.tHasOfacRestrictions ?? null,\n    tCatalogActive: node.tCatalogActive ?? null,\n  };\n}\n"]}

package/dist/utils/cartApi.d.ts

@@ -0,0 +1,16 @@
+import type { GqlRunner, Cart, CartIds, CartStatusResult, UpdateCartItemArgs, UpdateCartConsentArgs, SubscriptionDetails } from '../types';
+/** createTwouCart → { biId, uid } */
+export declare function createCart(gql: GqlRunner, { customerUid, salableUid, billingPlanUid }: CartIds): Promise<Cart>;
+/** → { cartUid, cartItemUid } */
+export declare function getCartItem(gql: GqlRunner, biId: string): Promise<{
+    cartUid: string;
+    cartItemUid: string;
+}>;
+export declare function updateCartItem(gql: GqlRunner, { cartItemUid, billingAddress, paymentMethodId }: UpdateCartItemArgs): Promise<void>;
+/** Persist checkout consent checkboxes onto the TwouCart BI. */
+export declare function updateCartConsent(gql: GqlRunner, { cartUid, consent }: UpdateCartConsentArgs): Promise<void>;
+/** "Place order" — triggers the server-side workflow. */
+export declare function placeOrder(gql: GqlRunner, cartUid: string): Promise<unknown>;
+/** → { status, stripeSubscriptionId, lastComment } */
+export declare function getCartStatus(gql: GqlRunner, biId: string): Promise<CartStatusResult>;
+export declare function findSubscriptionBiId(gql: GqlRunner, cartBiId: string): Promise<SubscriptionDetails | null>;

package/dist/utils/cartApi.js

@@ -0,0 +1,118 @@
+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());
+    });
+};
+/**
+ * api/cartApi.ts — one function per checkout operation.
+ * Each takes the `gql` runner as its first argument so they stay pure and
+ * independently testable (mock `gql`, assert the variables).
+ */
+import { CREATE_CART, GET_CART_ITEM, UPDATE_CART_ITEM, UPDATE_CART, PLACE_ORDER, GET_CART_STATUS, FIND_SUBSCRIPTION, } from './queries';
+/** createTwouCart → { biId, uid } */
+export function createCart(gql_1, _a) {
+    return __awaiter(this, arguments, void 0, function* (gql, { customerUid, salableUid, billingPlanUid }) {
+        const data = yield gql(CREATE_CART, {
+            input: {
+                prPartyPrimary: { uid: customerUid },
+                hiConsistsOf: [{ biiSalable: { uid: salableUid }, paybBillingPlan: { uid: billingPlanUid } }],
+            },
+        });
+        return data.createTwouCart;
+    });
+}
+/** → { cartUid, cartItemUid } */
+export function getCartItem(gql, biId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b;
+        const data = yield gql(GET_CART_ITEM, { biId });
+        const bi = data.getBusinessInteraction;
+        const cartUid = bi === null || bi === void 0 ? void 0 : bi.uid;
+        const cartItemUid = (_b = (_a = bi === null || bi === void 0 ? void 0 : bi.hiConsistsOf) === null || _a === void 0 ? void 0 : _a[0]) === null || _b === void 0 ? void 0 : _b.uid;
+        if (!cartUid || !cartItemUid) {
+            throw new Error(`Cart item not found for cart "${biId}".`);
+        }
+        return { cartUid, cartItemUid };
+    });
+}
+export function updateCartItem(gql_1, _a) {
+    return __awaiter(this, arguments, void 0, function* (gql, { cartItemUid, billingAddress, paymentMethodId }) {
+        const input = { uid: cartItemUid };
+        if (billingAddress)
+            input.paybBillingAddress = Object.assign({ typeName: 'ViaxUrbanPropertyAddress' }, billingAddress);
+        if (paymentMethodId)
+            input.paybPayment = { tStripePaymentMethodId: paymentMethodId };
+        yield gql(UPDATE_CART_ITEM, { input });
+    });
+}
+/** Persist checkout consent checkboxes onto the TwouCart BI. */
+export function updateCartConsent(gql_1, _a) {
+    return __awaiter(this, arguments, void 0, function* (gql, { cartUid, consent }) {
+        yield gql(UPDATE_CART, {
+            input: {
+                uid: cartUid,
+                tConsentRecurring: consent.tConsentRecurring,
+                tConsentUkCa: consent.tConsentUkCa,
+                tConsentAt: consent.tConsentAt,
+                tConsentText: consent.tConsentText,
+            },
+        });
+    });
+}
+/** "Place order" — triggers the server-side workflow. */
+export function placeOrder(gql, cartUid) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const data = yield gql(PLACE_ORDER, {
+            input: {
+                businessProcessable: { uid: cartUid, typeName: 'TwouCart' },
+                transitionCode: 'Sanction_Check',
+            },
+        });
+        return data.startBusinessProcessableTransition;
+    });
+}
+/** → { status, stripeSubscriptionId, lastComment } */
+export function getCartStatus(gql, biId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g;
+        const data = yield gql(GET_CART_STATUS, { biId });
+        const bi = (data === null || data === void 0 ? void 0 : data.getBusinessInteraction) || {};
+        const comments = ((_b = (_a = bi.cmComments) === null || _a === void 0 ? void 0 : _a.edges) === null || _b === void 0 ? void 0 : _b.map((e) => e.node.comText)) || [];
+        return {
+            status: ((_d = (_c = bi.bpStatus) === null || _c === void 0 ? void 0 : _c.code) !== null && _d !== void 0 ? _d : null),
+            stripeSubscriptionId: (_g = (_f = (_e = bi.hiConsistsOf) === null || _e === void 0 ? void 0 : _e[0]) === null || _f === void 0 ? void 0 : _f.tStripeSubscriptionId) !== null && _g !== void 0 ? _g : null,
+            lastComment: comments.length ? comments[comments.length - 1] : '',
+        };
+    });
+}
+export function findSubscriptionBiId(gql, cartBiId) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o;
+        try {
+            const data = yield gql(FIND_SUBSCRIPTION, { filter: `biRelatesTo.biId = '${cartBiId}'` });
+            const node = (_c = (_b = (_a = data === null || data === void 0 ? void 0 : data.filterTwouSubscription) === null || _a === void 0 ? void 0 : _a.edges) === null || _b === void 0 ? void 0 : _b[0]) === null || _c === void 0 ? void 0 : _c.node;
+            if (!(node === null || node === void 0 ? void 0 : node.biId))
+                return null;
+            const item = (_d = node.hiConsistsOf) === null || _d === void 0 ? void 0 : _d[0];
+            const payment = item === null || item === void 0 ? void 0 : item.paybPayment;
+            return {
+                biId: node.biId,
+                trialStart: (_e = node.tTrialStart) !== null && _e !== void 0 ? _e : null,
+                trialEnd: (_f = node.tTrialEnd) !== null && _f !== void 0 ? _f : null,
+                renewalType: (_g = node.tRenewalType) !== null && _g !== void 0 ? _g : null,
+                cardLast4: (_h = payment === null || payment === void 0 ? void 0 : payment.tPaymentMethodLast4) !== null && _h !== void 0 ? _h : null, // ← last four digits
+                cardBrand: (_j = payment === null || payment === void 0 ? void 0 : payment.tPaymentMethodBrand) !== null && _j !== void 0 ? _j : null, // ← card type (Visa, Mastercard etc)
+                stripePaymentMethodId: (_k = payment === null || payment === void 0 ? void 0 : payment.tStripePaymentMethodId) !== null && _k !== void 0 ? _k : null,
+                planName: (_o = (_m = (_l = item === null || item === void 0 ? void 0 : item.paybBillingPlan) === null || _l === void 0 ? void 0 : _l.bipOwnershipModel) === null || _m === void 0 ? void 0 : _m.omName) !== null && _o !== void 0 ? _o : null,
+            };
+        }
+        catch (_p) {
+            return null;
+        }
+    });
+}
+//# sourceMappingURL=cartApi.js.map

package/dist/utils/cartApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cartApi.js","sourceRoot":"","sources":["../../src/utils/cartApi.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * api/cartApi.ts — one function per checkout operation.\n * Each takes the `gql` runner as its first argument so they stay pure and\n * independently testable (mock `gql`, assert the variables).\n */\nimport {\n  CREATE_CART, GET_CART_ITEM, UPDATE_CART_ITEM, UPDATE_CART,\n  PLACE_ORDER, GET_CART_STATUS, FIND_SUBSCRIPTION,\n} from './queries';\nimport type {\n  GqlRunner, Cart, CartIds, CartStatusResult, UpdateCartItemArgs,\n  UpdateCartConsentArgs, Status, SubscriptionDetails,\n} from '../types';\n\n/** createTwouCart → { biId, uid } */\nexport async function createCart(gql: GqlRunner, { customerUid, salableUid, billingPlanUid }: CartIds): Promise<Cart> {\n  const data = await gql(CREATE_CART, {\n    input: {\n      prPartyPrimary: { uid: customerUid },\n      hiConsistsOf: [{ biiSalable: { uid: salableUid }, paybBillingPlan: { uid: billingPlanUid } }],\n    },\n  });\n  return data.createTwouCart as Cart;\n}\n\n/** → { cartUid, cartItemUid } */\nexport async function getCartItem(gql: GqlRunner, biId: string): Promise<{ cartUid: string, cartItemUid: string }> {\n  const data = await gql(GET_CART_ITEM, { biId });\n  const bi = data.getBusinessInteraction;\n  const cartUid = bi?.uid as string | undefined;\n  const cartItemUid = bi?.hiConsistsOf?.[0]?.uid as string | undefined;\n\n  if (!cartUid || !cartItemUid) {\n    throw new Error(`Cart item not found for cart \"${biId}\".`);\n  }\n\n  return { cartUid, cartItemUid };\n}\n\nexport async function updateCartItem(\n  gql: GqlRunner,\n  { cartItemUid, billingAddress, paymentMethodId }: UpdateCartItemArgs,\n): Promise<void> {\n  const input: Record<string, unknown> = { uid: cartItemUid };\n  if (billingAddress) input.paybBillingAddress = { typeName: 'ViaxUrbanPropertyAddress', ...billingAddress };\n  if (paymentMethodId) input.paybPayment = { tStripePaymentMethodId: paymentMethodId };\n  await gql(UPDATE_CART_ITEM, { input });\n}\n\n/** Persist checkout consent checkboxes onto the TwouCart BI. */\nexport async function updateCartConsent(\n  gql: GqlRunner,\n  { cartUid, consent }: UpdateCartConsentArgs,\n): Promise<void> {\n  await gql(UPDATE_CART, {\n    input: {\n      uid: cartUid,\n      tConsentRecurring: consent.tConsentRecurring,\n      tConsentUkCa: consent.tConsentUkCa,\n      tConsentAt: consent.tConsentAt,\n      tConsentText: consent.tConsentText,\n    },\n  });\n}\n\n/** \"Place order\" — triggers the server-side workflow. */\nexport async function placeOrder(gql: GqlRunner, cartUid: string): Promise<unknown> {\n  const data = await gql(PLACE_ORDER, {\n    input: {\n      businessProcessable: { uid: cartUid, typeName: 'TwouCart' },\n      transitionCode: 'Sanction_Check',\n    },\n  });\n  return data.startBusinessProcessableTransition;\n}\n\n/** → { status, stripeSubscriptionId, lastComment } */\nexport async function getCartStatus(gql: GqlRunner, biId: string): Promise<CartStatusResult> {\n  const data = await gql(GET_CART_STATUS, { biId });\n  const bi = data?.getBusinessInteraction || {};\n  const comments: string[] = bi.cmComments?.edges?.map((e: { node: { comText: string } }) => e.node.comText) || [];\n  return {\n    status: (bi.bpStatus?.code ?? null) as Status | null,\n    stripeSubscriptionId: bi.hiConsistsOf?.[0]?.tStripeSubscriptionId ?? null,\n    lastComment: comments.length ? comments[comments.length - 1] : '',\n  };\n}\n\nexport async function findSubscriptionBiId(gql: GqlRunner, cartBiId: string): Promise<SubscriptionDetails | null> {\n  try {\n    const data = await gql(FIND_SUBSCRIPTION, { filter: `biRelatesTo.biId = '${cartBiId}'` });\n    const node = data?.filterTwouSubscription?.edges?.[0]?.node;\n    if (!node?.biId) return null;\n\n    const item = node.hiConsistsOf?.[0];\n    const payment = item?.paybPayment;\n\n    return {\n      biId: node.biId,\n      trialStart: node.tTrialStart ?? null,\n      trialEnd: node.tTrialEnd ?? null,\n      renewalType: node.tRenewalType ?? null,\n      cardLast4: payment?.tPaymentMethodLast4 ?? null, // ← last four digits\n      cardBrand: payment?.tPaymentMethodBrand ?? null, // ← card type (Visa, Mastercard etc)\n      stripePaymentMethodId: payment?.tStripePaymentMethodId ?? null,\n      planName: item?.paybBillingPlan?.bipOwnershipModel?.omName ?? null,\n    };\n  } catch {\n    return null;\n  }\n}\n"]}

package/dist/utils/checkout.d.ts

@@ -0,0 +1,6 @@
+import type { CheckoutClient } from '../types';
+interface CheckoutClientConfig {
+    apiUrl: string;
+}
+export declare function createCheckoutClient({ apiUrl }: CheckoutClientConfig): CheckoutClient;
+export {};

package/dist/utils/checkout.js

@@ -0,0 +1,28 @@
+/**
+ * api/index.ts — composes the pieces into a single checkout client and
+ * re-exports the API utilities.
+ */
+import { createGqlClient } from './graphqlClient';
+import * as cart from './cartApi';
+import * as bootstrap from './bootstrapApi';
+export function createCheckoutClient({ apiUrl }) {
+    const { gql, setToken } = createGqlClient({ apiUrl });
+    const fetchStatus = (biId) => cart.getCartStatus(gql, biId);
+    return {
+        gql,
+        setToken,
+        createCart: (vars) => cart.createCart(gql, vars),
+        getCartItem: (biId) => cart.getCartItem(gql, biId),
+        updateCartItem: (args) => cart.updateCartItem(gql, args),
+        updateCartConsent: (args) => cart.updateCartConsent(gql, args),
+        placeOrder: (cartUid) => cart.placeOrder(gql, cartUid),
+        getCartStatus: fetchStatus,
+        findSubscriptionBiId: (biId) => cart.findSubscriptionBiId(gql, biId),
+        getSalableUid: (maId) => bootstrap.getSalableUid(gql, maId),
+        getBillingPlans: () => bootstrap.getBillingPlans(gql),
+        getActiveSubscriptions: () => bootstrap.getActiveSubscriptions(gql),
+        isCurrentUserSubscriber: () => bootstrap.isCurrentUserSubscriber(gql),
+        getCourseDetail: (courseKey) => bootstrap.getCourseDetail(gql, courseKey),
+    };
+}
+//# sourceMappingURL=checkout.js.map

package/dist/utils/checkout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"checkout.js","sourceRoot":"","sources":["../../src/utils/checkout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAS5C,MAAM,UAAU,oBAAoB,CAClC,EAAE,MAAM,EAAwB;IAEhC,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACtD,MAAM,WAAW,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAEpE,OAAO;QACL,GAAG;QACH,QAAQ;QACR,UAAU,EAAE,CAAC,IAAa,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC;QACzD,WAAW,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC;QAClD,cAAc,EAAE,CAAC,IAAwB,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,CAAC;QAC5E,iBAAiB,EAAE,CAAC,IAA2B,EAAE,EAAE,CAAC,IAAI,CAAC,iBAAiB,CAAC,GAAG,EAAE,IAAI,CAAC;QACrF,UAAU,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;QACtD,aAAa,EAAE,WAAW;QAC1B,oBAAoB,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,IAAI,CAAC;QACpE,aAAa,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC;QAC3D,eAAe,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,CAAC;QACrD,sBAAsB,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,sBAAsB,CAAC,GAAG,CAAC;QACnE,uBAAuB,EAAE,GAAG,EAAE,CAAC,SAAS,CAAC,uBAAuB,CAAC,GAAG,CAAC;QACrE,eAAe,EAAE,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,SAAS,CAAC;KAC1E,CAAC;AACJ,CAAC","sourcesContent":["/**\n * api/index.ts — composes the pieces into a single checkout client and\n * re-exports the API utilities.\n */\nimport { createGqlClient } from './graphqlClient';\nimport * as cart from './cartApi';\nimport * as bootstrap from './bootstrapApi';\nimport type {\n  CheckoutClient, CartIds, UpdateCartItemArgs, UpdateCartConsentArgs,\n} from '../types';\n\ninterface CheckoutClientConfig {\n  apiUrl: string,\n}\n\nexport function createCheckoutClient(\n  { apiUrl }: CheckoutClientConfig,\n): CheckoutClient {\n  const { gql, setToken } = createGqlClient({ apiUrl });\n  const fetchStatus = (biId: string) => cart.getCartStatus(gql, biId);\n\n  return {\n    gql,\n    setToken,\n    createCart: (vars: CartIds) => cart.createCart(gql, vars),\n    getCartItem: (biId) => cart.getCartItem(gql, biId),\n    updateCartItem: (args: UpdateCartItemArgs) => cart.updateCartItem(gql, args),\n    updateCartConsent: (args: UpdateCartConsentArgs) => cart.updateCartConsent(gql, args),\n    placeOrder: (cartUid) => cart.placeOrder(gql, cartUid),\n    getCartStatus: fetchStatus,\n    findSubscriptionBiId: (biId) => cart.findSubscriptionBiId(gql, biId),\n    getSalableUid: (maId) => bootstrap.getSalableUid(gql, maId),\n    getBillingPlans: () => bootstrap.getBillingPlans(gql),\n    getActiveSubscriptions: () => bootstrap.getActiveSubscriptions(gql),\n    isCurrentUserSubscriber: () => bootstrap.isCurrentUserSubscriber(gql),\n    getCourseDetail: (courseKey) => bootstrap.getCourseDetail(gql, courseKey),\n  };\n}\n"]}

package/dist/utils/fetchActiveSubscriptions.d.ts

@@ -0,0 +1,4 @@
+export interface ActiveSubscriptionsResult {
+    active: number;
+}
+export declare function fetchActiveSubscriptions(apiUrl: string): Promise<ActiveSubscriptionsResult>;

package/dist/utils/fetchActiveSubscriptions.js

@@ -0,0 +1,36 @@
+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());
+    });
+};
+/**
+ * api/fetchActiveSubscriptions.ts
+ *
+ * Fetches the number of active subscriptions without authentication.
+ * Used on mount to show the live learner count in CartSummary.
+ */
+import { GET_ACTIVE_SUBSCRIPTIONS_STATE } from './queries';
+export function fetchActiveSubscriptions(apiUrl) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a, _b, _c, _d;
+        const res = yield fetch(apiUrl, {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({ query: GET_ACTIVE_SUBSCRIPTIONS_STATE }),
+        });
+        if (!res.ok)
+            throw new Error(`Failed to fetch active subscriptions (${res.status})`);
+        const json = yield res.json();
+        if ((_a = json.errors) === null || _a === void 0 ? void 0 : _a.length)
+            throw new Error(((_b = json.errors[0]) === null || _b === void 0 ? void 0 : _b.message) || 'GraphQL error');
+        const active = (_d = (_c = json.data) === null || _c === void 0 ? void 0 : _c.tActiveSubscriptionsState) === null || _d === void 0 ? void 0 : _d.active;
+        if (typeof active !== 'number')
+            throw new Error('Unexpected response shape for tActiveSubscriptionsState');
+        return { active };
+    });
+}
+//# sourceMappingURL=fetchActiveSubscriptions.js.map

package/dist/utils/fetchActiveSubscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetchActiveSubscriptions.js","sourceRoot":"","sources":["../../src/utils/fetchActiveSubscriptions.ts"],"names":[],"mappings":";;;;;;;;;AAAA;;;;;GAKG;AACH,OAAO,EAAE,8BAA8B,EAAE,MAAM,WAAW,CAAC;AAM3D,MAAM,UAAgB,wBAAwB,CAC5C,MAAc;;;QAEd,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE;YAC9B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,8BAA8B,EAAE,CAAC;SAChE,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;QAErF,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,MAAA,IAAI,CAAC,MAAM,0CAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,CAAA,MAAA,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,0CAAE,OAAO,KAAI,eAAe,CAAC,CAAC;QAErF,MAAM,MAAM,GAAG,MAAA,MAAA,IAAI,CAAC,IAAI,0CAAE,yBAAyB,0CAAE,MAAM,CAAC;QAC5D,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAE3G,OAAO,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC;CAAA","sourcesContent":["/**\n * api/fetchActiveSubscriptions.ts\n *\n * Fetches the number of active subscriptions without authentication.\n * Used on mount to show the live learner count in CartSummary.\n */\nimport { GET_ACTIVE_SUBSCRIPTIONS_STATE } from './queries';\n\nexport interface ActiveSubscriptionsResult {\n  active: number,\n}\n\nexport async function fetchActiveSubscriptions(\n  apiUrl: string,\n): Promise<ActiveSubscriptionsResult> {\n  const res = await fetch(apiUrl, {\n    method: 'POST',\n    headers: { 'Content-Type': 'application/json' },\n    body: JSON.stringify({ query: GET_ACTIVE_SUBSCRIPTIONS_STATE }),\n  });\n\n  if (!res.ok) throw new Error(`Failed to fetch active subscriptions (${res.status})`);\n\n  const json = await res.json();\n  if (json.errors?.length) throw new Error(json.errors[0]?.message || 'GraphQL error');\n\n  const active = json.data?.tActiveSubscriptionsState?.active;\n  if (typeof active !== 'number') throw new Error('Unexpected response shape for tActiveSubscriptionsState');\n\n  return { active };\n}\n"]}

package/dist/utils/fetchBillingPlans.d.ts

@@ -0,0 +1,2 @@
+import type { BillingPlansResult } from '../types';
+export declare function fetchBillingPlans(apiUrl: string): Promise<BillingPlansResult>;