@edx/frontend-app-subscription-manage 1.3.2 → 1.4.0

package/dist/types.d.ts

@@ -1,39 +1,68 @@
-import type { Status, Phase } from './constants';
-export type { Status, Phase };
-export interface TwouCustomerContact {
-    email?: string;
-}
-export interface TwouCustomerParty {
-    paName: string;
-    indFirstName?: string;
-    indLastName?: string;
-    paContacts: {
-        edges: {
-            node: TwouCustomerContact;
-        }[];
-    };
-}
-export interface TwouCustomer {
-    uid: string;
-    parId: string;
-    parParty: TwouCustomerParty;
-}
-export type GqlRunner = (query: string, variables?: Record<string, unknown>, retry?: boolean) => Promise<any>;
-export interface Cart {
+/**
+ * Manage Subscription — domain types for Viax subscriber + enrollment data.
+ */
+/** GraphQL runner used by VIAX fetchers. */
+export type GqlRunner = (query: string, variables?: Record<string, unknown>) => Promise<any>;
+/** Result of `tIsCurrentUserSubscriber` (JSON scalar). */
+export interface CurrentUserSubscriberResult {
+    /** Has/expects access — drive manage vs upsell messaging. */
+    isSubscriber: boolean;
+    /** Enrollable right now (ACTIVE / TRIAL_ACTIVE). */
+    canEnroll: boolean;
+    subscriptionBiId: string | null;
+    status: string | null;
+    currentPeriodEnd: string | null;
+    subscriptionStartDate: string | null;
+    subscriptionEndDate: string | null;
+    /** Optional plan label from API when present. */
+    renewalType?: string | null;
+    /** Optional cancel timestamp when present. */
+    canceledAt?: string | null;
+    /** Optional price display amount when present. */
+    amount?: string | null;
+    currency?: string | null;
+}
+/** Normalized enrollment for the cancel confirmation course list. */
+export interface SubscriptionEnrollment {
     biId: string;
-    uid: string;
+    courseMaId: string | null;
+    courseName: string | null;
+    courseSlug: string | null;
+    /** Course card / thumbnail image. */
+    imageUrl: string | null;
+    orgName: string | null;
+    orgLogoUrl: string | null;
+    courseRunKey: string | null;
+    /** TwouEnrollment bpStatus.code (ACTIVE, COMPLETED, …). */
+    status: string | null;
+    /** True when bpStatus.code is COMPLETED. */
+    hasCertificate: boolean;
+    certificateUrl: string | null;
 }
-export interface CartIds {
-    customerUid: string;
-    salableUid: string;
-    billingPlanUid: string;
+/** Normalized invoice row for the Payment history tab. */
+export interface PaymentHistoryItem {
+    biId: string;
+    /** Display order number, e.g. EDX-BI3X25N5SY30OSIK */
+    orderNumber: string;
+    stripeInvoiceId: string | null;
+    status: string | null;
+    billDate: string | null;
+    periodStart: string | null;
+    periodEnd: string | null;
+    /** Charged amount in major currency units (e.g. 59.00). */
+    amount: number;
+    currency: string;
+    isTrial: boolean;
 }
+/** UI view derived from subscriber status. */
+export type SubscriptionView = 'none' | 'active' | 'canceled_access' | 'canceled_expired';
+export type ManageTab = 'subscription' | 'payment-history';
 export type BillingCycle = 'monthly' | 'annual';
-export type BillingPeriod = 'MONTHLY' | 'ANNUAL' | 'QUARTERLY' | string;
 export interface BillingPlanOwnershipModel {
     uid: string;
     omName: string;
 }
+/** Normalized row from `filterCustomerBillingPlan`. */
 export interface BillingPlan {
     uid: string;
     stripePriceId: string;
@@ -44,179 +73,6 @@ export interface BillingPlan {
     isTemplate: boolean;
     ownershipModel: BillingPlanOwnershipModel;
 }
-export interface SubscriptionDetails {
-    biId: string;
-    trialStart: string | null;
-    trialEnd: string | null;
-    renewalType: string | null;
-    cardLast4: string | null;
-    cardBrand: string | null;
-    stripePaymentMethodId: string | null;
-    planName: string | null;
-}
-export interface CurrentUserSubscriberResult {
-    isSubscriber: boolean;
-    subscriptionBiId: string | null;
-    status: string | null;
-    subscriptionStartDate: string | null;
-    currentPeriodEnd: string | null;
-}
-/** Course shown on checkout / post-checkout when arriving via ?course_run_key=. */
-export interface CourseDetail {
-    maId: string;
-    maName: string;
-    maDescription: string | null;
-    tShortDescription: string | null;
-    imageUrl: string | null;
-    tCourseKey: string | null;
-    tBrandText: string | null;
-    tPrimarySubjectArea: string | null;
-    tLevelType: string | null;
-    tLanguage: string | null;
-    tPacingType: string | null;
-    tDurationLow: number | null;
-    tDurationHigh: number | null;
-    tDurationUnit: string | null;
-    tEffortLow: number | null;
-    tEffortHigh: number | null;
-    tEffortUnit: string | null;
-    tUrlCourse: string | null;
-    tB2cSubscriptionInclusion: boolean | null;
-    tHasOfacRestrictions: boolean | null;
-    tCatalogActive: boolean | null;
-}
-/** Returned by getBillingPlans — all available plans for the product. */
 export interface BillingPlansResult {
     plans: BillingPlan[];
 }
-/** Returned by getSalableUid — the product uid and its ownership models. */
-export interface ProductInfo {
-    uid: string;
-    maName: string;
-    ownershipModels: {
-        uid: string;
-        omName: string;
-    }[];
-}
-export interface CartStatusResult {
-    status: Status | null;
-    stripeSubscriptionId: string | null;
-    lastComment: string;
-}
-export interface CartBillingAddress {
-    tFirstName: string;
-    tLastName: string;
-    upaLine1: string;
-    upaCity: string;
-    upaPostcode: string;
-    gadStateOrProvince: string;
-    gadCountry: {
-        iso2Code: string;
-    };
-}
-export interface UpdateCartItemArgs {
-    cartItemUid: string;
-    billingAddress?: CartBillingAddress;
-    paymentMethodId?: string;
-}
-/** Auto-renewal consent captured on TwouCart at checkout confirmation (SUBS-228). */
-export interface CheckoutConsent {
-    /** Main auto-renewal checkbox — always required at submit. */
-    tConsentRecurring: boolean;
-    /** UK/CA resident checkbox; null when that checkbox is not shown. */
-    tConsentUkCa: boolean | null;
-    /** ISO-8601 timestamp when consent was captured. */
-    tConsentAt: string;
-    /** Exact disclosure text shown to the learner (audit trail). */
-    tConsentText: string;
-}
-export interface UpdateCartConsentArgs {
-    cartUid: string;
-    consent: CheckoutConsent;
-}
-export interface BillingInfo {
-    firstName: string;
-    lastName: string;
-    city: string;
-    zip: string;
-    country: string;
-    line1: string;
-    state: string;
-}
-export interface CheckoutClient {
-    gql: GqlRunner;
-    setToken: (token: string) => void;
-    createCart: (vars: CartIds) => Promise<Cart>;
-    getCartItem: (biId: string) => Promise<{
-        cartUid: string;
-        cartItemUid: string;
-    }>;
-    updateCartItem: (args: UpdateCartItemArgs) => Promise<void>;
-    updateCartConsent: (args: UpdateCartConsentArgs) => Promise<void>;
-    placeOrder: (cartUid: string) => Promise<unknown>;
-    getCartStatus: (biId: string) => Promise<CartStatusResult>;
-    findSubscriptionBiId: (biId: string) => Promise<SubscriptionDetails | null>;
-    getSalableUid: (maId: string) => Promise<ProductInfo>;
-    getBillingPlans: () => Promise<BillingPlansResult>;
-    getActiveSubscriptions: () => Promise<{
-        active: number;
-    }>;
-    isCurrentUserSubscriber: () => Promise<CurrentUserSubscriberResult | null>;
-    getCourseDetail: (courseKey: string) => Promise<CourseDetail | null>;
-}
-export interface DevAuth {
-    iamUrl: string;
-    clientId: string;
-    clientSecret: string;
-}
-export interface StripeElementChangeEvent {
-    error?: {
-        message?: string;
-    };
-    [key: string]: unknown;
-}
-export interface StripeElementLike {
-    mount: (node: HTMLElement) => void;
-    on: (event: string, handler: (e: StripeElementChangeEvent) => void) => void;
-    unmount?: () => void;
-}
-export interface StripeElementsLike {
-    create: (type: string, options?: Record<string, unknown>) => StripeElementLike;
-}
-export interface StripeError {
-    message?: string;
-    code?: string;
-}
-export interface PaymentMethodResult {
-    paymentMethod?: {
-        id: string;
-    };
-    error?: StripeError;
-}
-export interface ConfirmResult {
-    error?: StripeError;
-    setupIntent?: unknown;
-    paymentIntent?: unknown;
-}
-export interface CreatePaymentMethodParams {
-    type: 'card';
-    card: StripeElementLike;
-    billing_details?: Record<string, unknown>;
-}
-export interface StripeLike {
-    elements: () => StripeElementsLike;
-    createPaymentMethod: (params: CreatePaymentMethodParams) => Promise<PaymentMethodResult>;
-    confirmCardSetup: (clientSecret: string) => Promise<ConfirmResult>;
-    confirmCardPayment: (clientSecret: string) => Promise<ConfirmResult>;
-}
-declare global {
-    interface Window {
-        Stripe?: (publishableKey: string) => StripeLike;
-    }
-}
-export interface TrialDateRange {
-    /** e.g. "June 22, 2026" */
-    displayStart: string;
-    /** e.g. "June 29, 2026" */
-    displayEnd: string;
-}

package/dist/types.js

@@ -1,2 +1,5 @@
+/**
+ * Manage Subscription — domain types for Viax subscriber + enrollment data.
+ */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +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"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG","sourcesContent":["/**\n * Manage Subscription — domain types for Viax subscriber + enrollment data.\n */\n\n/** GraphQL runner used by VIAX fetchers. */\nexport type GqlRunner = (\n  query: string,\n  variables?: Record<string, unknown>,\n) => Promise<any>;\n\n/** Result of `tIsCurrentUserSubscriber` (JSON scalar). */\nexport interface CurrentUserSubscriberResult {\n  /** Has/expects access — drive manage vs upsell messaging. */\n  isSubscriber: boolean,\n  /** Enrollable right now (ACTIVE / TRIAL_ACTIVE). */\n  canEnroll: boolean,\n  subscriptionBiId: string | null,\n  status: string | null,\n  currentPeriodEnd: string | null,\n  subscriptionStartDate: string | null,\n  subscriptionEndDate: string | null,\n  /** Optional plan label from API when present. */\n  renewalType?: string | null,\n  /** Optional cancel timestamp when present. */\n  canceledAt?: string | null,\n  /** Optional price display amount when present. */\n  amount?: string | null,\n  currency?: string | null,\n}\n\n/** Normalized enrollment for the cancel confirmation course list. */\nexport interface SubscriptionEnrollment {\n  biId: string,\n  courseMaId: string | null,\n  courseName: string | null,\n  courseSlug: string | null,\n  /** Course card / thumbnail image. */\n  imageUrl: string | null,\n  orgName: string | null,\n  orgLogoUrl: string | null,\n  courseRunKey: string | null,\n  /** TwouEnrollment bpStatus.code (ACTIVE, COMPLETED, …). */\n  status: string | null,\n  /** True when bpStatus.code is COMPLETED. */\n  hasCertificate: boolean,\n  certificateUrl: string | null,\n}\n\n/** Normalized invoice row for the Payment history tab. */\nexport interface PaymentHistoryItem {\n  biId: string,\n  /** Display order number, e.g. EDX-BI3X25N5SY30OSIK */\n  orderNumber: string,\n  stripeInvoiceId: string | null,\n  status: string | null,\n  billDate: string | null,\n  periodStart: string | null,\n  periodEnd: string | null,\n  /** Charged amount in major currency units (e.g. 59.00). */\n  amount: number,\n  currency: string,\n  isTrial: boolean,\n}\n\n/** UI view derived from subscriber status. */\nexport type SubscriptionView =\n  | 'none'\n  | 'active'\n  | 'canceled_access'\n  | 'canceled_expired';\n\nexport type ManageTab = 'subscription' | 'payment-history';\n\nexport type BillingCycle = 'monthly' | 'annual';\n\nexport interface BillingPlanOwnershipModel {\n  uid: string,\n  omName: string,\n}\n\n/** Normalized row from `filterCustomerBillingPlan`. */\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 BillingPlansResult {\n  plans: BillingPlan[],\n}\n"]}

package/dist/utils/billingDetails.d.ts

@@ -1,4 +1,4 @@
-import type { BillingPlan, BillingCycle } from '../types';
+import type { BillingCycle, BillingPlan } from '../types';
 export interface PlanPrice {
     uid: string;
     stripePriceId: string;
@@ -7,24 +7,7 @@ export interface PlanPrice {
     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' }
+ * Returns the price for the selected billing cycle.
+ * Matches plans by "annual"/"year" or "month" in omName; falls back to first plan.
  */
 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

@@ -1,20 +1,12 @@
 /**
- * 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' }
+ * Returns the price for the selected billing cycle.
+ * Matches plans by "annual"/"year" or "month" in omName; falls back to first plan.
  */
 export function getPlanPrice(plans, cycle) {
     var _a;
-    if (!plans.length)
+    if (!plans.length) {
         return null;
+    }
     const isAnnual = cycle === 'annual';
     const match = (_a = plans.find((p) => {
         var _a, _b;
@@ -31,17 +23,4 @@ export function getPlanPrice(plans, cycle) {
         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

@@ -1 +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"]}
+{"version":3,"file":"billingDetails.js","sourceRoot":"","sources":["../../src/utils/billingDetails.ts"],"names":[],"mappings":"AAUA;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAoB,EACpB,KAAmB;;IAEnB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,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","sourcesContent":["import type { BillingCycle, BillingPlan } from '../types';\n\nexport interface PlanPrice {\n  uid: string,\n  stripePriceId: string,\n  amount: string,\n  currency: string,\n  label: string,\n}\n\n/**\n * Returns the price for the selected billing cycle.\n * Matches plans by \"annual\"/\"year\" or \"month\" in omName; falls back to first plan.\n */\nexport function getPlanPrice(\n  plans: BillingPlan[],\n  cycle: BillingCycle,\n): PlanPrice | null {\n  if (!plans.length) {\n    return null;\n  }\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"]}

package/dist/utils/edxSession.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Exchange the learner's edX session for a Viax JWT.
+ *
+ * Dev uses POST with a hardcoded JWT payload (local LMS cookie exchange is
+ * unavailable). Stage/prod use POST with browser session cookies.
+ */
+export interface EdxSessionResult {
+    viaxToken: string;
+    customerUid: string;
+    partyUid?: string;
+    edxUserId?: string;
+    username?: string;
+    email?: string;
+}
+/** LMS edx-session endpoint for the current site. */
+export declare function getEdxSessionUrl(): string;
+/** Exchange the learner's edX session for a Viax token. */
+export declare function fetchEdxSession(sessionUrl: string): Promise<EdxSessionResult>;

package/dist/utils/edxSession.js

@@ -0,0 +1,72 @@
+/**
+ * Exchange the learner's edX session for a Viax JWT.
+ *
+ * Dev uses POST with a hardcoded JWT payload (local LMS cookie exchange is
+ * unavailable). Stage/prod use POST with browser session cookies.
+ */
+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 { EnvironmentTypes, getSiteConfig } from '@openedx/frontend-base';
+/** Hardcoded edX JWT used only for local/dev against Viax (same pattern as enroll/checkout MFEs). */
+const DEV_SESSION_BODY = {
+    payload: 'eyJhbGciOiJSUzUxMiIsImtpZCI6Imxtc3N0YWdlMDAyIiwidHlwIjoiSldUIn0.eyJhdWQiOiJJbmtvY3VqTGlreXVjc0Vkd2lXYXRkZWJyRWFja21ldkxha0R1aWZLb29zaGtha1dvdyIsImV4cCI6MTc4NjEzNTQ1NywiZ3JhbnRfdHlwZSI6InBhc3N3b3JkIiwiaWF0IjoxNzg2MTMxODU3LCJpc3MiOiJodHRwczovL2NvdXJzZXMuc3RhZ2UuZWR4Lm9yZy9vYXV0aDIiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJhZGV2Z2FuIiwic2NvcGVzIjpbInVzZXJfaWQiLCJlbWFpbCIsInByb2ZpbGUiXSwidmVyc2lvbiI6IjEuMi4wIiwic3ViIjoiYmRlNjcwYTRiNmYxYjc0OTExYWZhZGY4NDM4YmFmZTkiLCJmaWx0ZXJzIjpbInVzZXI6bWUiXSwiaXNfcmVzdHJpY3RlZCI6ZmFsc2UsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJ1c2VyX2lkIjo1MjgzMTE5LCJlbWFpbCI6ImFkZXZnYW5AMnUuY29tIiwibmFtZSI6IkFrYXNoIERldmdhbiIsImZhbWlseV9uYW1lIjoiRGV2Z2FuIiwiZ2l2ZW5fbmFtZSI6IkFrYXNoIiwiYWRtaW5pc3RyYXRvciI6ZmFsc2UsInN1cGVydXNlciI6ZmFsc2V9',
+    signature: 'RY64FgDMT-gRKJ6aObjUcocYqHjU3E2R_A2nxZL1BwJZgSDT1mMZMY_9HYZh8F0bAM9IFSQ1B3yP6PtcQnYsA2iYXK6_LyhG07l5qu6GRU7W99-Dq8CxLX9viJrKVj3CgGfc9bIUultlM-fjy-iZBTqDqe-DO2NHLvE-rd3b_d7cRTrhEtZ6HYkFWJXy5YOo8vxV46X4kM56jHGSq1Leixvc0ksa-NKn4AMHNSfGv_mQA16DN-Ou_uEl9CdHURGD4vOPDYE7xZt5JiwKZ3i1jzJfgMdpPgCYvYeC-5dr95_s-LaJnN6va9k3u9RFRnYKTfhHPgtSR4q7qTCzNABQqQ'
+};
+function parseSessionResponse(data) {
+    var _a, _b, _c, _d;
+    const viaxToken = ((_c = (_b = (_a = data.viaxToken) !== null && _a !== void 0 ? _a : data.token) !== null && _b !== void 0 ? _b : data.access_token) !== null && _c !== void 0 ? _c : data.accessToken);
+    const customerUid = ((_d = data.customerUid) !== null && _d !== void 0 ? _d : data.customer_uid);
+    if (!viaxToken) {
+        throw new Error('Session response missing viax token.');
+    }
+    if (!customerUid) {
+        throw new Error('Session response missing customerUid.');
+    }
+    return {
+        viaxToken,
+        customerUid,
+        partyUid: data.partyUid,
+        edxUserId: data.edxUserId,
+        username: data.username,
+        email: data.email,
+    };
+}
+function isDevelopment() {
+    return getSiteConfig().environment === EnvironmentTypes.DEVELOPMENT;
+}
+/** LMS edx-session endpoint for the current site. */
+export function getEdxSessionUrl() {
+    return isDevelopment()
+        ? 'https://courses.stage.edx.org/api/edx-session'
+        : `${getSiteConfig().lmsBaseUrl}/api/edx-session`;
+}
+/** Exchange the learner's edX session for a Viax token. */
+export function fetchEdxSession(sessionUrl) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const res = yield fetch(sessionUrl, {
+            method: 'POST',
+            credentials: 'include',
+            headers: {
+                Accept: 'application/json',
+                'Content-Type': 'application/json',
+            },
+            body: isDevelopment() ? JSON.stringify(DEV_SESSION_BODY) : undefined,
+        });
+        if (!res.ok) {
+            throw new Error(`Failed to establish session (${res.status}). Please log into edX and try again.`);
+        }
+        const data = yield res.json();
+        if (data.error) {
+            throw new Error(String(data.error));
+        }
+        return parseSessionResponse(data);
+    });
+}
+//# sourceMappingURL=edxSession.js.map

package/dist/utils/edxSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edxSession.js","sourceRoot":"","sources":["../../src/utils/edxSession.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;;;;;;;;;;AAEH,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAWzE,qGAAqG;AACrG,MAAM,gBAAgB,GAAG;IACvB,OAAO,EAAE,suBAAsuB;IAC/uB,SAAS,EAAE,wVAAwV;CACpW,CAAC;AAEF,SAAS,oBAAoB,CAAC,IAA6B;;IACzD,MAAM,SAAS,GAAG,CAChB,MAAA,MAAA,MAAA,IAAI,CAAC,SAAS,mCAAI,IAAI,CAAC,KAAK,mCAAI,IAAI,CAAC,YAAY,mCAAI,IAAI,CAAC,WAAW,CAChD,CAAC;IACxB,MAAM,WAAW,GAAG,CAAC,MAAA,IAAI,CAAC,WAAW,mCAAI,IAAI,CAAC,YAAY,CAAuB,CAAC;IAElF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;IAC3D,CAAC;IAED,OAAO;QACL,SAAS;QACT,WAAW;QACX,QAAQ,EAAE,IAAI,CAAC,QAA8B;QAC7C,SAAS,EAAE,IAAI,CAAC,SAA+B;QAC/C,QAAQ,EAAE,IAAI,CAAC,QAA8B;QAC7C,KAAK,EAAE,IAAI,CAAC,KAA2B;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,aAAa;IACpB,OAAO,aAAa,EAAE,CAAC,WAAW,KAAK,gBAAgB,CAAC,WAAW,CAAC;AACtE,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,gBAAgB;IAC9B,OAAO,aAAa,EAAE;QACpB,CAAC,CAAC,+CAA+C;QACjD,CAAC,CAAC,GAAG,aAAa,EAAE,CAAC,UAAU,kBAAkB,CAAC;AACtD,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAgB,eAAe,CAAC,UAAkB;;QACtD,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,UAAU,EAAE;YAClC,MAAM,EAAE,MAAM;YACd,WAAW,EAAE,SAAS;YACtB,OAAO,EAAE;gBACP,MAAM,EAAE,kBAAkB;gBAC1B,cAAc,EAAE,kBAAkB;aACnC;YACD,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS;SACrE,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CACb,gCAAgC,GAAG,CAAC,MAAM,uCAAuC,CAClF,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAkD,CAAC;QAC9E,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;QACtC,CAAC;QAED,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CAAA","sourcesContent":["/**\n * Exchange the learner's edX session for a Viax JWT.\n *\n * Dev uses POST with a hardcoded JWT payload (local LMS cookie exchange is\n * unavailable). Stage/prod use POST with browser session cookies.\n */\n\nimport { EnvironmentTypes, getSiteConfig } from '@openedx/frontend-base';\n\nexport interface EdxSessionResult {\n  viaxToken: string,\n  customerUid: string,\n  partyUid?: string,\n  edxUserId?: string,\n  username?: string,\n  email?: string,\n}\n\n/** Hardcoded edX JWT used only for local/dev against Viax (same pattern as enroll/checkout MFEs). */\nconst DEV_SESSION_BODY = {\n  payload: 'eyJhbGciOiJSUzUxMiIsImtpZCI6Imxtc3N0YWdlMDAyIiwidHlwIjoiSldUIn0.eyJhdWQiOiJJbmtvY3VqTGlreXVjc0Vkd2lXYXRkZWJyRWFja21ldkxha0R1aWZLb29zaGtha1dvdyIsImV4cCI6MTc4NjEzNTQ1NywiZ3JhbnRfdHlwZSI6InBhc3N3b3JkIiwiaWF0IjoxNzg2MTMxODU3LCJpc3MiOiJodHRwczovL2NvdXJzZXMuc3RhZ2UuZWR4Lm9yZy9vYXV0aDIiLCJwcmVmZXJyZWRfdXNlcm5hbWUiOiJhZGV2Z2FuIiwic2NvcGVzIjpbInVzZXJfaWQiLCJlbWFpbCIsInByb2ZpbGUiXSwidmVyc2lvbiI6IjEuMi4wIiwic3ViIjoiYmRlNjcwYTRiNmYxYjc0OTExYWZhZGY4NDM4YmFmZTkiLCJmaWx0ZXJzIjpbInVzZXI6bWUiXSwiaXNfcmVzdHJpY3RlZCI6ZmFsc2UsImVtYWlsX3ZlcmlmaWVkIjp0cnVlLCJ1c2VyX2lkIjo1MjgzMTE5LCJlbWFpbCI6ImFkZXZnYW5AMnUuY29tIiwibmFtZSI6IkFrYXNoIERldmdhbiIsImZhbWlseV9uYW1lIjoiRGV2Z2FuIiwiZ2l2ZW5fbmFtZSI6IkFrYXNoIiwiYWRtaW5pc3RyYXRvciI6ZmFsc2UsInN1cGVydXNlciI6ZmFsc2V9',\n  signature: 'RY64FgDMT-gRKJ6aObjUcocYqHjU3E2R_A2nxZL1BwJZgSDT1mMZMY_9HYZh8F0bAM9IFSQ1B3yP6PtcQnYsA2iYXK6_LyhG07l5qu6GRU7W99-Dq8CxLX9viJrKVj3CgGfc9bIUultlM-fjy-iZBTqDqe-DO2NHLvE-rd3b_d7cRTrhEtZ6HYkFWJXy5YOo8vxV46X4kM56jHGSq1Leixvc0ksa-NKn4AMHNSfGv_mQA16DN-Ou_uEl9CdHURGD4vOPDYE7xZt5JiwKZ3i1jzJfgMdpPgCYvYeC-5dr95_s-LaJnN6va9k3u9RFRnYKTfhHPgtSR4q7qTCzNABQqQ'\n};\n\nfunction parseSessionResponse(data: Record<string, unknown>): EdxSessionResult {\n  const viaxToken = (\n    data.viaxToken ?? data.token ?? data.access_token ?? data.accessToken\n  ) as string | undefined;\n  const customerUid = (data.customerUid ?? data.customer_uid) as string | undefined;\n\n  if (!viaxToken) {\n    throw new Error('Session response missing viax token.');\n  }\n  if (!customerUid) {\n    throw new Error('Session response missing customerUid.');\n  }\n\n  return {\n    viaxToken,\n    customerUid,\n    partyUid: data.partyUid as string | undefined,\n    edxUserId: data.edxUserId as string | undefined,\n    username: data.username as string | undefined,\n    email: data.email as string | undefined,\n  };\n}\n\nfunction isDevelopment(): boolean {\n  return getSiteConfig().environment === EnvironmentTypes.DEVELOPMENT;\n}\n\n/** LMS edx-session endpoint for the current site. */\nexport function getEdxSessionUrl(): string {\n  return isDevelopment()\n    ? 'https://courses.stage.edx.org/api/edx-session'\n    : `${getSiteConfig().lmsBaseUrl}/api/edx-session`;\n}\n\n/** Exchange the learner's edX session for a Viax token. */\nexport async function fetchEdxSession(sessionUrl: string): Promise<EdxSessionResult> {\n  const res = await fetch(sessionUrl, {\n    method: 'POST',\n    credentials: 'include',\n    headers: {\n      Accept: 'application/json',\n      'Content-Type': 'application/json',\n    },\n    body: isDevelopment() ? JSON.stringify(DEV_SESSION_BODY) : undefined,\n  });\n\n  if (!res.ok) {\n    throw new Error(\n      `Failed to establish session (${res.status}). Please log into edX and try again.`,\n    );\n  }\n\n  const data = await res.json() as Record<string, unknown> & { error?: string };\n  if (data.error) {\n    throw new Error(String(data.error));\n  }\n\n  return parseSessionResponse(data);\n}\n"]}

package/dist/utils/formatDate.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Format ISO date strings for manage-subscription copy.
+ */
+/**
+ * Formats a date for display, e.g. "April 13, 2027".
+ * Uses the calendar date from YYYY-MM-DD to avoid timezone day-shift.
+ * Returns null when the value cannot be parsed.
+ */
+export declare function formatDisplayDate(value: string | null | undefined, locale?: string): string | null;
+/**
+ * Formats a date as MM/DD/YYYY (en-US), e.g. "10/13/2026".
+ * Returns null when the value cannot be parsed.
+ */
+export declare function formatNumericDate(value: string | null | undefined, locale?: string): string | null;
+/** True when the ISO date is strictly in the future. */
+export declare function isFutureDate(value: string | null | undefined): boolean;

package/dist/utils/formatDate.js

@@ -0,0 +1,69 @@
+/**
+ * Format ISO date strings for manage-subscription copy.
+ */
+function parseDate(value) {
+    const dateOnly = /^(\d{4})-(\d{2})-(\d{2})/.exec(value);
+    let date;
+    if (dateOnly) {
+        const year = Number(dateOnly[1]);
+        const month = Number(dateOnly[2]) - 1;
+        const day = Number(dateOnly[3]);
+        date = new Date(year, month, day);
+    }
+    else {
+        date = new Date(value);
+    }
+    if (Number.isNaN(date.getTime())) {
+        return null;
+    }
+    return date;
+}
+/**
+ * Formats a date for display, e.g. "April 13, 2027".
+ * Uses the calendar date from YYYY-MM-DD to avoid timezone day-shift.
+ * Returns null when the value cannot be parsed.
+ */
+export function formatDisplayDate(value, locale = 'en-US') {
+    if (!value) {
+        return null;
+    }
+    const date = parseDate(value);
+    if (!date) {
+        return null;
+    }
+    return new Intl.DateTimeFormat(locale, {
+        month: 'long',
+        day: 'numeric',
+        year: 'numeric',
+    }).format(date);
+}
+/**
+ * Formats a date as MM/DD/YYYY (en-US), e.g. "10/13/2026".
+ * Returns null when the value cannot be parsed.
+ */
+export function formatNumericDate(value, locale = 'en-US') {
+    if (!value) {
+        return null;
+    }
+    const date = parseDate(value);
+    if (!date) {
+        return null;
+    }
+    return new Intl.DateTimeFormat(locale, {
+        month: '2-digit',
+        day: '2-digit',
+        year: 'numeric',
+    }).format(date);
+}
+/** True when the ISO date is strictly in the future. */
+export function isFutureDate(value) {
+    if (!value) {
+        return false;
+    }
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+        return false;
+    }
+    return date.getTime() > Date.now();
+}
+//# sourceMappingURL=formatDate.js.map

package/dist/utils/formatDate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatDate.js","sourceRoot":"","sources":["../../src/utils/formatDate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,SAAS,SAAS,CAAC,KAAa;IAC9B,MAAM,QAAQ,GAAG,0BAA0B,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxD,IAAI,IAAU,CAAC;IACf,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAgC,EAChC,MAAM,GAAG,OAAO;IAEhB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE;QACrC,KAAK,EAAE,MAAM;QACb,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;KAChB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAgC,EAChC,MAAM,GAAG,OAAO;IAEhB,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9B,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE;QACrC,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;QACd,IAAI,EAAE,SAAS;KAChB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AAClB,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,KAAgC;IAC3D,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC7B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;AACrC,CAAC","sourcesContent":["/**\n * Format ISO date strings for manage-subscription copy.\n */\n\nfunction parseDate(value: string): Date | null {\n  const dateOnly = /^(\\d{4})-(\\d{2})-(\\d{2})/.exec(value);\n  let date: Date;\n  if (dateOnly) {\n    const year = Number(dateOnly[1]);\n    const month = Number(dateOnly[2]) - 1;\n    const day = Number(dateOnly[3]);\n    date = new Date(year, month, day);\n  } else {\n    date = new Date(value);\n  }\n\n  if (Number.isNaN(date.getTime())) {\n    return null;\n  }\n  return date;\n}\n\n/**\n * Formats a date for display, e.g. \"April 13, 2027\".\n * Uses the calendar date from YYYY-MM-DD to avoid timezone day-shift.\n * Returns null when the value cannot be parsed.\n */\nexport function formatDisplayDate(\n  value: string | null | undefined,\n  locale = 'en-US',\n): string | null {\n  if (!value) {\n    return null;\n  }\n\n  const date = parseDate(value);\n  if (!date) {\n    return null;\n  }\n\n  return new Intl.DateTimeFormat(locale, {\n    month: 'long',\n    day: 'numeric',\n    year: 'numeric',\n  }).format(date);\n}\n\n/**\n * Formats a date as MM/DD/YYYY (en-US), e.g. \"10/13/2026\".\n * Returns null when the value cannot be parsed.\n */\nexport function formatNumericDate(\n  value: string | null | undefined,\n  locale = 'en-US',\n): string | null {\n  if (!value) {\n    return null;\n  }\n\n  const date = parseDate(value);\n  if (!date) {\n    return null;\n  }\n\n  return new Intl.DateTimeFormat(locale, {\n    month: '2-digit',\n    day: '2-digit',\n    year: 'numeric',\n  }).format(date);\n}\n\n/** True when the ISO date is strictly in the future. */\nexport function isFutureDate(value: string | null | undefined): boolean {\n  if (!value) {\n    return false;\n  }\n  const date = new Date(value);\n  if (Number.isNaN(date.getTime())) {\n    return false;\n  }\n  return date.getTime() > Date.now();\n}\n"]}

package/dist/utils/graphqlClient.d.ts

@@ -1,16 +1,15 @@
 /**
- * api/graphqlClient.ts — authed GraphQL client.
+ * Minimal GraphQL client for VIAX.
  *
- * No token is required at construction. Call setToken(viaxToken) after
- * GET /edx-session returns — typically on checkout page mount.
- *
- * On 401 the token is cleared and the request fails — the mutation will
- * surface the error and the user can retry.
+ * Authenticated calls (subscriber check, enrollments, cancel) require setToken()
+ * after exchanging the edX session for a Viax JWT.
  */
 import type { GqlRunner } from '../types';
+export interface ViaxGqlClient {
+    gql: GqlRunner;
+    setToken: (token: string | null) => void;
+    hasToken: () => boolean;
+}
 export declare function createGqlClient({ apiUrl }: {
     apiUrl: string;
-}): {
-    gql: GqlRunner;
-    setToken: (token: string) => void;
-};
+}): ViaxGqlClient;