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

package/dist/utils/graphqlClient.js

@@ -8,32 +8,43 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 export function createGqlClient({ apiUrl }) {
-    if (!apiUrl)
+    if (!apiUrl) {
         throw new Error('createGqlClient: apiUrl is required');
+    }
     let token = null;
     const setToken = (raw) => {
+        if (!raw) {
+            token = null;
+            return;
+        }
         token = raw.startsWith('Bearer ') ? raw : `Bearer ${raw}`;
     };
-    const gql = (query_1, variables_1, ...args_1) => __awaiter(this, [query_1, variables_1, ...args_1], void 0, function* (query, variables, retry = false) {
+    const gql = (query, variables) => __awaiter(this, void 0, void 0, function* () {
         var _a, _b;
-        if (!token)
-            throw new Error('No viax token available. Please try placing your order again.');
+        const headers = {
+            'Content-Type': 'application/json',
+        };
+        if (token) {
+            headers.Authorization = token;
+        }
         const res = yield fetch(apiUrl, {
             method: 'POST',
-            headers: { 'Content-Type': 'application/json', Authorization: token },
+            headers,
             body: JSON.stringify({ query, variables }),
         });
-        if (res.status === 401 && !retry) {
-            token = null;
-            throw new Error('Session expired. Please try placing your order again.');
+        if (!res.ok) {
+            throw new Error(`VIAX request failed (${res.status}). Please try again.`);
         }
         const json = yield res.json();
         if ((_a = json.errors) === null || _a === void 0 ? void 0 : _a.length) {
-            const msg = ((_b = json.errors[0]) === null || _b === void 0 ? void 0 : _b.message) || 'GraphQL error';
-            throw new Error(msg);
+            throw new Error(((_b = json.errors[0]) === null || _b === void 0 ? void 0 : _b.message) || 'GraphQL error');
         }
         return json.data;
     });
-    return { gql, setToken };
+    return {
+        gql,
+        setToken,
+        hasToken: () => Boolean(token),
+    };
 }
 //# sourceMappingURL=graphqlClient.js.map

package/dist/utils/graphqlClient.js.map

@@ -1 +1 @@
-{"version":3,"file":"graphqlClient.js","sourceRoot":"","sources":["../../src/utils/graphqlClient.ts"],"names":[],"mappings":";;;;;;;;;AAiBA,MAAM,UAAU,eAAe,CAC7B,EAAE,MAAM,EAAsB;IAE9B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IAEpE,IAAI,KAAK,GAAkB,IAAI,CAAC;IAEhC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAQ,EAAE;QACrC,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC;IAC5D,CAAC,CAAC;IAEF,MAAM,GAAG,GAAc,kCAAwC,EAAE,uEAAnC,KAAK,EAAE,SAAS,EAAE,KAAK,GAAG,KAAK;;QAC3D,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,+DAA+D,CAAC,CAAC;QAE7F,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE;YAC9B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,aAAa,EAAE,KAAK,EAAE;YACrE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAC3C,CAAC,CAAC;QAEH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;YACjC,KAAK,GAAG,IAAI,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,uDAAuD,CAAC,CAAC;QAC3E,CAAC;QAED,MAAM,IAAI,GAAgB,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,MAAA,IAAI,CAAC,MAAM,0CAAE,MAAM,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,CAAA,MAAA,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,0CAAE,OAAO,KAAI,eAAe,CAAC;YACvD,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC,CAAA,CAAC;IAEF,OAAO,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC;AAC3B,CAAC","sourcesContent":["/**\n * api/graphqlClient.ts — authed GraphQL client.\n *\n * No token is required at construction. Call setToken(viaxToken) after\n * GET /edx-session returns — typically on checkout page mount.\n *\n * On 401 the token is cleared and the request fails — the mutation will\n * surface the error and the user can retry.\n */\nimport type { GqlRunner } from '../types';\n\ninterface GqlResponse {\n\n  data?: any,\n  errors?: { message?: string }[],\n}\n\nexport function createGqlClient(\n  { apiUrl }: { apiUrl: string },\n): { gql: GqlRunner, setToken: (token: string) => void } {\n  if (!apiUrl) throw new Error('createGqlClient: apiUrl is required');\n\n  let token: string | null = null;\n\n  const setToken = (raw: string): void => {\n    token = raw.startsWith('Bearer ') ? raw : `Bearer ${raw}`;\n  };\n\n  const gql: GqlRunner = async (query, variables, retry = false) => {\n    if (!token) throw new Error('No viax token available. Please try placing your order again.');\n\n    const res = await fetch(apiUrl, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json', Authorization: token },\n      body: JSON.stringify({ query, variables }),\n    });\n\n    if (res.status === 401 && !retry) {\n      token = null;\n      throw new Error('Session expired. Please try placing your order again.');\n    }\n\n    const json: GqlResponse = await res.json();\n    if (json.errors?.length) {\n      const msg = json.errors[0]?.message || 'GraphQL error';\n      throw new Error(msg);\n    }\n    return json.data;\n  };\n\n  return { gql, setToken };\n}\n"]}
+{"version":3,"file":"graphqlClient.js","sourceRoot":"","sources":["../../src/utils/graphqlClient.ts"],"names":[],"mappings":";;;;;;;;;AAmBA,MAAM,UAAU,eAAe,CAC7B,EAAE,MAAM,EAAsB;IAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,KAAK,GAAkB,IAAI,CAAC;IAEhC,MAAM,QAAQ,GAAG,CAAC,GAAkB,EAAQ,EAAE;QAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,KAAK,GAAG,IAAI,CAAC;YACb,OAAO;QACT,CAAC;QACD,KAAK,GAAG,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC;IAC5D,CAAC,CAAC;IAEF,MAAM,GAAG,GAAc,CAAO,KAAK,EAAE,SAAS,EAAE,EAAE;;QAChD,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QACF,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,aAAa,GAAG,KAAK,CAAC;QAChC,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE;YAC9B,MAAM,EAAE,MAAM;YACd,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAC3C,CAAC,CAAC;QAEH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,CAAC,MAAM,sBAAsB,CAAC,CAAC;QAC5E,CAAC;QAED,MAAM,IAAI,GAAgB,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3C,IAAI,MAAA,IAAI,CAAC,MAAM,0CAAE,MAAM,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,CAAA,MAAA,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,0CAAE,OAAO,KAAI,eAAe,CAAC,CAAC;QAC9D,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC,CAAA,CAAC;IAEF,OAAO;QACL,GAAG;QACH,QAAQ;QACR,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;KAC/B,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Minimal GraphQL client for VIAX.\n *\n * Authenticated calls (subscriber check, enrollments, cancel) require setToken()\n * after exchanging the edX session for a Viax JWT.\n */\nimport type { GqlRunner } from '../types';\n\ninterface GqlResponse {\n  data?: any,\n  errors?: { message?: string }[],\n}\n\nexport interface ViaxGqlClient {\n  gql: GqlRunner,\n  setToken: (token: string | null) => void,\n  hasToken: () => boolean,\n}\n\nexport function createGqlClient(\n  { apiUrl }: { apiUrl: string },\n): ViaxGqlClient {\n  if (!apiUrl) {\n    throw new Error('createGqlClient: apiUrl is required');\n  }\n\n  let token: string | null = null;\n\n  const setToken = (raw: string | null): void => {\n    if (!raw) {\n      token = null;\n      return;\n    }\n    token = raw.startsWith('Bearer ') ? raw : `Bearer ${raw}`;\n  };\n\n  const gql: GqlRunner = async (query, variables) => {\n    const headers: Record<string, string> = {\n      'Content-Type': 'application/json',\n    };\n    if (token) {\n      headers.Authorization = token;\n    }\n\n    const res = await fetch(apiUrl, {\n      method: 'POST',\n      headers,\n      body: JSON.stringify({ query, variables }),\n    });\n\n    if (!res.ok) {\n      throw new Error(`VIAX request failed (${res.status}). Please try again.`);\n    }\n\n    const json: GqlResponse = await res.json();\n    if (json.errors?.length) {\n      throw new Error(json.errors[0]?.message || 'GraphQL error');\n    }\n    return json.data;\n  };\n\n  return {\n    gql,\n    setToken,\n    hasToken: () => Boolean(token),\n  };\n}\n"]}

package/dist/utils/invoiceAmount.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Money helpers for TwouInvoice billFinancialCharges amounts.
+ *
+ * Newer invoices store major units (e.g. 11.00); some older rows are still in
+ * minor units / cents (e.g. 11100) pending a backfill.
+ */
+/** Normalize a raw Viax amount into major currency units. */
+export declare function normalizeInvoiceAmount(raw: unknown): number;
+/** Sum fichAmount values from billFinancialCharges. */
+export declare function sumFinancialCharges(charges: {
+    fichAmount?: {
+        amount?: unknown;
+        units?: {
+            code?: string;
+        } | null;
+    } | null;
+}[] | null | undefined): {
+    amount: number;
+    currency: string;
+};
+/** Format major-unit amount for display, e.g. "$59.00 USD". */
+export declare function formatMoney(amount: number, currency?: string, locale?: string): string;

package/dist/utils/invoiceAmount.js

@@ -0,0 +1,59 @@
+/**
+ * Money helpers for TwouInvoice billFinancialCharges amounts.
+ *
+ * Newer invoices store major units (e.g. 11.00); some older rows are still in
+ * minor units / cents (e.g. 11100) pending a backfill.
+ */
+/** Normalize a raw Viax amount into major currency units. */
+export function normalizeInvoiceAmount(raw) {
+    if (raw == null || raw === '') {
+        return 0;
+    }
+    const asString = String(raw).trim();
+    const value = Number(asString);
+    if (!Number.isFinite(value)) {
+        return 0;
+    }
+    // Explicit decimal → already major units (e.g. "11.00", "59.99").
+    if (asString.includes('.')) {
+        return value;
+    }
+    // Whole numbers ≥ 1000 are treated as cents until the backfill lands
+    // (e.g. 11100 → 111.00). Smaller integers stay as major units (e.g. 59).
+    if (Number.isInteger(value) && Math.abs(value) >= 1000) {
+        return value / 100;
+    }
+    return value;
+}
+/** Sum fichAmount values from billFinancialCharges. */
+export function sumFinancialCharges(charges) {
+    if (!Array.isArray(charges) || charges.length === 0) {
+        return { amount: 0, currency: 'USD' };
+    }
+    let total = 0;
+    let currency = 'USD';
+    charges.forEach((charge) => {
+        var _a, _b, _c;
+        total += normalizeInvoiceAmount((_a = charge === null || charge === void 0 ? void 0 : charge.fichAmount) === null || _a === void 0 ? void 0 : _a.amount);
+        const code = (_c = (_b = charge === null || charge === void 0 ? void 0 : charge.fichAmount) === null || _b === void 0 ? void 0 : _b.units) === null || _c === void 0 ? void 0 : _c.code;
+        if (code) {
+            currency = code;
+        }
+    });
+    return { amount: total, currency };
+}
+/** Format major-unit amount for display, e.g. "$59.00 USD". */
+export function formatMoney(amount, currency = 'USD', locale = 'en-US') {
+    try {
+        const formatted = new Intl.NumberFormat(locale, {
+            style: 'currency',
+            currency,
+            currencyDisplay: 'symbol',
+        }).format(amount);
+        return `${formatted} ${currency}`;
+    }
+    catch (_a) {
+        return `$${amount.toFixed(2)} ${currency}`;
+    }
+}
+//# sourceMappingURL=invoiceAmount.js.map

package/dist/utils/invoiceAmount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoiceAmount.js","sourceRoot":"","sources":["../../src/utils/invoiceAmount.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,6DAA6D;AAC7D,MAAM,UAAU,sBAAsB,CAAC,GAAY;IACjD,IAAI,GAAG,IAAI,IAAI,IAAI,GAAG,KAAK,EAAE,EAAE,CAAC;QAC9B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC/B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO,CAAC,CAAC;IACX,CAAC;IAED,kEAAkE;IAClE,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,qEAAqE;IACrE,yEAAyE;IACzE,IAAI,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;QACvD,OAAO,KAAK,GAAG,GAAG,CAAC;IACrB,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,mBAAmB,CACjC,OAA4G;IAE5G,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;IACxC,CAAC;IAED,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;;QACzB,KAAK,IAAI,sBAAsB,CAAC,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,UAAU,0CAAE,MAAM,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAA,MAAA,MAAM,aAAN,MAAM,uBAAN,MAAM,CAAE,UAAU,0CAAE,KAAK,0CAAE,IAAI,CAAC;QAC7C,IAAI,IAAI,EAAE,CAAC;YACT,QAAQ,GAAG,IAAI,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;AACrC,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,WAAW,CACzB,MAAc,EACd,QAAQ,GAAG,KAAK,EAChB,MAAM,GAAG,OAAO;IAEhB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE;YAC9C,KAAK,EAAE,UAAU;YACjB,QAAQ;YACR,eAAe,EAAE,QAAQ;SAC1B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAClB,OAAO,GAAG,SAAS,IAAI,QAAQ,EAAE,CAAC;IACpC,CAAC;IAAC,WAAM,CAAC;QACP,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC","sourcesContent":["/**\n * Money helpers for TwouInvoice billFinancialCharges amounts.\n *\n * Newer invoices store major units (e.g. 11.00); some older rows are still in\n * minor units / cents (e.g. 11100) pending a backfill.\n */\n\n/** Normalize a raw Viax amount into major currency units. */\nexport function normalizeInvoiceAmount(raw: unknown): number {\n  if (raw == null || raw === '') {\n    return 0;\n  }\n\n  const asString = String(raw).trim();\n  const value = Number(asString);\n  if (!Number.isFinite(value)) {\n    return 0;\n  }\n\n  // Explicit decimal → already major units (e.g. \"11.00\", \"59.99\").\n  if (asString.includes('.')) {\n    return value;\n  }\n\n  // Whole numbers ≥ 1000 are treated as cents until the backfill lands\n  // (e.g. 11100 → 111.00). Smaller integers stay as major units (e.g. 59).\n  if (Number.isInteger(value) && Math.abs(value) >= 1000) {\n    return value / 100;\n  }\n\n  return value;\n}\n\n/** Sum fichAmount values from billFinancialCharges. */\nexport function sumFinancialCharges(\n  charges: { fichAmount?: { amount?: unknown, units?: { code?: string } | null } | null }[] | null | undefined,\n): { amount: number, currency: string } {\n  if (!Array.isArray(charges) || charges.length === 0) {\n    return { amount: 0, currency: 'USD' };\n  }\n\n  let total = 0;\n  let currency = 'USD';\n  charges.forEach((charge) => {\n    total += normalizeInvoiceAmount(charge?.fichAmount?.amount);\n    const code = charge?.fichAmount?.units?.code;\n    if (code) {\n      currency = code;\n    }\n  });\n\n  return { amount: total, currency };\n}\n\n/** Format major-unit amount for display, e.g. \"$59.00 USD\". */\nexport function formatMoney(\n  amount: number,\n  currency = 'USD',\n  locale = 'en-US',\n): string {\n  try {\n    const formatted = new Intl.NumberFormat(locale, {\n      style: 'currency',\n      currency,\n      currencyDisplay: 'symbol',\n    }).format(amount);\n    return `${formatted} ${currency}`;\n  } catch {\n    return `$${amount.toFixed(2)} ${currency}`;\n  }\n}\n"]}

package/dist/utils/queries.d.ts

@@ -1,35 +1,40 @@
 /**
- * api/queries.ts — GraphQL documents for the checkout flow.
- * Kept as plain strings so they can be reused, logged, or tested in isolation.
- *
- * Mutation reference (from API doc):
- *   updateTwouCustomer          — toggle Stripe test clock on/off
- *   createTwouCart              — user proceeds to payment
- *   updateTwouCartItem          — attach billing plan / payment method to cart
- *   updateTwouCart              — persist auto-renewal consent (SUBS-228)
- *   startBusinessProcessableTransition — place order
- *   updateTwouCartItem          — retry: attach new payment method
- */
-/** Creates a new cart during checkout. */
-export declare const CREATE_CART = "mutation CreateCart($input: TwouCartInput!) {\n  createTwouCart(input: $input) { biId uid }\n}";
-/** Updates a cart item — attach billing plan / payment method. */
-export declare const UPDATE_CART_ITEM = "mutation UpdateCartItem($input: TwouCartItemInput!) {\n  updateTwouCartItem(input: $input) { uid }\n}";
-/** Persists auto-renewal consent fields on the TwouCart BI (SUBS-228). */
-export declare const UPDATE_CART = "mutation UpdateCart($input: TwouCartInput!) {\n  updateTwouCart(input: $input) { uid }\n}";
-/** Triggers the backend workflow to place the order. */
-export declare const PLACE_ORDER = "mutation PlaceOrder($input: StartBusinessProcessableTransitionInput!) {\n  startBusinessProcessableTransition(input: $input) { uid bpStatus { code } }\n}";
-export declare const GET_CART_ITEM = "query GetCartItem($biId: String!) {\n  getBusinessInteraction(biId: $biId) {\n    uid\n    hiConsistsOf { ... on TwouCartItem { uid } }\n  }\n}";
-export declare const GET_CART_STATUS = "query GetCartStatus($biId: String!) {\n  getBusinessInteraction(biId: $biId) {\n    bpStatus { code }\n    hiConsistsOf { ... on TwouCartItem { tStripeSubscriptionId } }\n    ... on TwouCart {\n      cmComments { edges { node { comText } } }\n    }\n  }\n}";
-export declare const FIND_SUBSCRIPTION = "query FindSubscription($filter: String!) {\n  filterTwouSubscription(_first: 1, _filter: $filter) {\n    edges {\n      node {\n        biId\n        tTrialStart\n        tTrialEnd\n        tRenewalType\n        hiConsistsOf {\n          ... on TwouSubscriptionItem {\n            paybBillingPlan {\n              tStripePriceId\n              bipOwnershipModel { omName }\n            }\n            paybPayment {\n              ... on TwouStripePayment {\n                tStripePaymentMethodId\n                tPaymentMethodLast4\n                tPaymentMethodBrand\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}";
-/** Fetch the viax customer uid by email using filterTwouCustomer. */
-export declare const GET_CUSTOMER = "query GetCustomer($filter: String!) {\n  filterTwouCustomer(_first: 1, _filter: $filter) {\n    edges {\n      node {\n        uid\n        parId\n        parParty {\n          paName\n          paContacts {\n            edges {\n              node {\n                ... on EmailAddressContactMedium {\n                  email\n                }\n              }\n            }\n          }\n          ... on Individual {\n            indFirstName\n            indLastName\n          }\n        }\n      }\n    }\n  }\n}";
-/** Fetch the TwouSubscriptionPlan uid to use as biiSalable in createTwouCart. */
-export declare const GET_PRODUCT = "query GetProduct($maId: String!) {\n  getProduct(maId: $maId) {\n    maName\n    uid\n    ... on TwouSubscriptionPlan {\n      saOwnershipModels {\n        uid\n        omName\n      }\n    }\n  }\n}";
-export declare const GET_BILLING_PLANS = "query GetBillingPlans {\n  filterCustomerBillingPlan(_first: 10) {\n    edges {\n      node {\n        uid\n        tStripePriceId\n        tStripeAmount {\n          amount\n          units { code }\n        }\n        bipIsTemplate\n        bipOwnershipModel { uid omName }\n      }\n    }\n  }\n}";
-/** Fetch the number of active subscriptions — unauthenticated. */
-export declare const GET_ACTIVE_SUBSCRIPTIONS_STATE = "query activeSubscriptions {\n  tActiveSubscriptionsState\n}";
-/** Check whether the currently authenticated user already has an active subscription.
- *  tIsCurrentUserSubscriber is a JSON scalar — returns the full object, no subfield selection allowed. */
+ * GraphQL documents for the manage-subscription MFE.
+ */
+/**
+ * tIsCurrentUserSubscriber is a JSON scalar — returns the full object;
+ * no subfield selection is allowed.
+ */
 export declare const GET_IS_CURRENT_USER_SUBSCRIBER = "query IsCurrentUserSubscriber {\n  tIsCurrentUserSubscriber\n}";
-/** Fetch a course for the enrollment card when ?course_run_key= is present. */
-export declare const GET_COURSE_DETAIL = "query CourseDetail($filter: String!) {\n  filterTwouCourse(_first: 1, _filter: $filter) {\n    edges {\n      node {\n        maId\n        maName\n        maDescription\n        tShortDescription\n        imageUrl\n        tCourseKey\n        tBrandText\n        tPrimarySubjectArea\n        tLevelType\n        tLanguage\n        tPacingType { code }\n        tDurationLow\n        tDurationHigh\n        tDurationUnit { code }\n        tEffortLow\n        tEffortHigh\n        tEffortUnit { code }\n        tUrlCourse\n        tB2cSubscriptionInclusion\n        tHasOfacRestrictions\n        tCatalogActive\n      }\n    }\n  }\n}";
+/**
+ * Enrollments for cancel confirmation.
+ * Build `_filter` client-side, e.g. tSubscriptionBiId IN ('BI…', 'BI…').
+ */
+export declare const GET_SUBSCRIPTION_ENROLLMENTS = "query EnrollmentsForSubscriptions($filter: String!) {\n  filterTwouEnrollment(_first: 200, _filter: $filter) {\n    edges {\n      node {\n        biId\n        tSubscriptionBiId\n        bpStatus { code }\n        tCourseRunKey\n        tCourse {\n          maId\n          maName\n          imageUrl\n          tBrandText\n          tSchools {\n            tName\n            tSortValue\n          }\n        }\n      }\n    }\n  }\n}";
+/**
+ * Invoices for the learner's subscription (payment history).
+ * Filter is inlined client-side: biRelatesTo.biId = '<subscriptionBiId>'.
+ */
+export declare const GET_PAYMENT_HISTORY = "query PaymentHistory($filter: String!, $first: Int!) {\n  filterTwouInvoice(_first: $first, _filter: $filter) {\n    edges {\n      node {\n        biId\n        tStripeInvoiceId\n        bpStatus { code name }\n        billDate\n        billBillingPeriod { start end }\n        billFinancialCharges {\n          fichAmount {\n            amount\n            units { code }\n          }\n        }\n      }\n    }\n  }\n}";
+/**
+ * Cancel the learner's subscription (default: at period end).
+ * Pass `immediate: true` to end access immediately.
+ */
+export declare const CANCEL_SUBSCRIPTION = "mutation CancelSubscription($biId: String!, $immediate: Boolean) {\n  tCancelSubscription(biId: $biId, immediate: $immediate)\n}";
+/**
+ * Resume a cancelled subscription before the period end / cancellation date.
+ */
+export declare const REACTIVATE_SUBSCRIPTION = "mutation ReactivateSubscription($biId: String!) {\n  tReactivateSubscription(biId: $biId)\n}";
+/**
+ * Payment method on an existing subscription (for renew / manage display).
+ */
+export declare const GET_SUBSCRIPTION_PAYMENT_METHOD = "query SubscriptionPaymentMethod($filter: String!) {\n  filterTwouSubscription(_first: 1, _filter: $filter) {\n    edges {\n      node {\n        biId\n        hiConsistsOf {\n          ... on TwouSubscriptionItem {\n            paybPayment {\n              ... on TwouStripePayment {\n                tStripePaymentMethodId\n                tPaymentMethodLast4\n                tPaymentMethodBrand\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}";
+/**
+ * Available customer billing plans (monthly / annual template prices).
+ * Same query as frontend-app-subscription-checkout.
+ */
+export declare const GET_BILLING_PLANS = "query GetBillingPlans {\n  filterCustomerBillingPlan(_first: 10) {\n    edges {\n      node {\n        uid\n        tStripePriceId\n        tStripeAmount {\n          amount\n          units { code }\n        }\n        bipIsTemplate\n        bipOwnershipModel { uid omName }\n      }\n    }\n  }\n}";
+/**
+ * Attach a new Stripe payment method (pm_…) as the subscription default.
+ */
+export declare const UPDATE_SUBSCRIPTION_PAYMENT_METHOD = "mutation UpdateSubscriptionPaymentMethod(\n  $biId: String!\n  $tStripePaymentMethodId: String!\n) {\n  tUpdateSubscriptionPaymentMethod(\n    biId: $biId\n    tStripePaymentMethodId: $tStripePaymentMethodId\n  )\n}";

package/dist/utils/queries.js

@@ -1,62 +1,85 @@
 /**
- * api/queries.ts — GraphQL documents for the checkout flow.
- * Kept as plain strings so they can be reused, logged, or tested in isolation.
- *
- * Mutation reference (from API doc):
- *   updateTwouCustomer          — toggle Stripe test clock on/off
- *   createTwouCart              — user proceeds to payment
- *   updateTwouCartItem          — attach billing plan / payment method to cart
- *   updateTwouCart              — persist auto-renewal consent (SUBS-228)
- *   startBusinessProcessableTransition — place order
- *   updateTwouCartItem          — retry: attach new payment method
+ * GraphQL documents for the manage-subscription MFE.
  */
-// ─── Mutations ────────────────────────────────────────────────────────────────
-/** Creates a new cart during checkout. */
-export const CREATE_CART = `mutation CreateCart($input: TwouCartInput!) {
-  createTwouCart(input: $input) { biId uid }
-}`;
-/** Updates a cart item — attach billing plan / payment method. */
-export const UPDATE_CART_ITEM = `mutation UpdateCartItem($input: TwouCartItemInput!) {
-  updateTwouCartItem(input: $input) { uid }
-}`;
-/** Persists auto-renewal consent fields on the TwouCart BI (SUBS-228). */
-export const UPDATE_CART = `mutation UpdateCart($input: TwouCartInput!) {
-  updateTwouCart(input: $input) { uid }
-}`;
-/** Triggers the backend workflow to place the order. */
-export const PLACE_ORDER = `mutation PlaceOrder($input: StartBusinessProcessableTransitionInput!) {
-  startBusinessProcessableTransition(input: $input) { uid bpStatus { code } }
+/**
+ * tIsCurrentUserSubscriber is a JSON scalar — returns the full object;
+ * no subfield selection is allowed.
+ */
+export const GET_IS_CURRENT_USER_SUBSCRIBER = `query IsCurrentUserSubscriber {
+  tIsCurrentUserSubscriber
 }`;
-// ─── Queries ──────────────────────────────────────────────────────────────────
-export const GET_CART_ITEM = `query GetCartItem($biId: String!) {
-  getBusinessInteraction(biId: $biId) {
-    uid
-    hiConsistsOf { ... on TwouCartItem { uid } }
+/**
+ * Enrollments for cancel confirmation.
+ * Build `_filter` client-side, e.g. tSubscriptionBiId IN ('BI…', 'BI…').
+ */
+export const GET_SUBSCRIPTION_ENROLLMENTS = `query EnrollmentsForSubscriptions($filter: String!) {
+  filterTwouEnrollment(_first: 200, _filter: $filter) {
+    edges {
+      node {
+        biId
+        tSubscriptionBiId
+        bpStatus { code }
+        tCourseRunKey
+        tCourse {
+          maId
+          maName
+          imageUrl
+          tBrandText
+          tSchools {
+            tName
+            tSortValue
+          }
+        }
+      }
+    }
   }
 }`;
-export const GET_CART_STATUS = `query GetCartStatus($biId: String!) {
-  getBusinessInteraction(biId: $biId) {
-    bpStatus { code }
-    hiConsistsOf { ... on TwouCartItem { tStripeSubscriptionId } }
-    ... on TwouCart {
-      cmComments { edges { node { comText } } }
+/**
+ * Invoices for the learner's subscription (payment history).
+ * Filter is inlined client-side: biRelatesTo.biId = '<subscriptionBiId>'.
+ */
+export const GET_PAYMENT_HISTORY = `query PaymentHistory($filter: String!, $first: Int!) {
+  filterTwouInvoice(_first: $first, _filter: $filter) {
+    edges {
+      node {
+        biId
+        tStripeInvoiceId
+        bpStatus { code name }
+        billDate
+        billBillingPeriod { start end }
+        billFinancialCharges {
+          fichAmount {
+            amount
+            units { code }
+          }
+        }
+      }
     }
   }
 }`;
-export const FIND_SUBSCRIPTION = `query FindSubscription($filter: String!) {
+/**
+ * Cancel the learner's subscription (default: at period end).
+ * Pass `immediate: true` to end access immediately.
+ */
+export const CANCEL_SUBSCRIPTION = `mutation CancelSubscription($biId: String!, $immediate: Boolean) {
+  tCancelSubscription(biId: $biId, immediate: $immediate)
+}`;
+/**
+ * Resume a cancelled subscription before the period end / cancellation date.
+ */
+export const REACTIVATE_SUBSCRIPTION = `mutation ReactivateSubscription($biId: String!) {
+  tReactivateSubscription(biId: $biId)
+}`;
+/**
+ * Payment method on an existing subscription (for renew / manage display).
+ */
+export const GET_SUBSCRIPTION_PAYMENT_METHOD = `query SubscriptionPaymentMethod($filter: String!) {
   filterTwouSubscription(_first: 1, _filter: $filter) {
     edges {
       node {
         biId
-        tTrialStart
-        tTrialEnd
-        tRenewalType
         hiConsistsOf {
           ... on TwouSubscriptionItem {
-            paybBillingPlan {
-              tStripePriceId
-              bipOwnershipModel { omName }
-            }
             paybPayment {
               ... on TwouStripePayment {
                 tStripePaymentMethodId
@@ -70,46 +93,10 @@ export const FIND_SUBSCRIPTION = `query FindSubscription($filter: String!) {
     }
   }
 }`;
-/** Fetch the viax customer uid by email using filterTwouCustomer. */
-export const GET_CUSTOMER = `query GetCustomer($filter: String!) {
-  filterTwouCustomer(_first: 1, _filter: $filter) {
-    edges {
-      node {
-        uid
-        parId
-        parParty {
-          paName
-          paContacts {
-            edges {
-              node {
-                ... on EmailAddressContactMedium {
-                  email
-                }
-              }
-            }
-          }
-          ... on Individual {
-            indFirstName
-            indLastName
-          }
-        }
-      }
-    }
-  }
-}`;
-/** Fetch the TwouSubscriptionPlan uid to use as biiSalable in createTwouCart. */
-export const GET_PRODUCT = `query GetProduct($maId: String!) {
-  getProduct(maId: $maId) {
-    maName
-    uid
-    ... on TwouSubscriptionPlan {
-      saOwnershipModels {
-        uid
-        omName
-      }
-    }
-  }
-}`;
+/**
+ * Available customer billing plans (monthly / annual template prices).
+ * Same query as frontend-app-subscription-checkout.
+ */
 export const GET_BILLING_PLANS = `query GetBillingPlans {
   filterCustomerBillingPlan(_first: 10) {
     edges {
@@ -126,43 +113,16 @@ export const GET_BILLING_PLANS = `query GetBillingPlans {
     }
   }
 }`;
-/** Fetch the number of active subscriptions — unauthenticated. */
-export const GET_ACTIVE_SUBSCRIPTIONS_STATE = `query activeSubscriptions {
-  tActiveSubscriptionsState
-}`;
-/** Check whether the currently authenticated user already has an active subscription.
- *  tIsCurrentUserSubscriber is a JSON scalar — returns the full object, no subfield selection allowed. */
-export const GET_IS_CURRENT_USER_SUBSCRIBER = `query IsCurrentUserSubscriber {
-  tIsCurrentUserSubscriber
-}`;
-/** Fetch a course for the enrollment card when ?course_run_key= is present. */
-export const GET_COURSE_DETAIL = `query CourseDetail($filter: String!) {
-  filterTwouCourse(_first: 1, _filter: $filter) {
-    edges {
-      node {
-        maId
-        maName
-        maDescription
-        tShortDescription
-        imageUrl
-        tCourseKey
-        tBrandText
-        tPrimarySubjectArea
-        tLevelType
-        tLanguage
-        tPacingType { code }
-        tDurationLow
-        tDurationHigh
-        tDurationUnit { code }
-        tEffortLow
-        tEffortHigh
-        tEffortUnit { code }
-        tUrlCourse
-        tB2cSubscriptionInclusion
-        tHasOfacRestrictions
-        tCatalogActive
-      }
-    }
-  }
+/**
+ * Attach a new Stripe payment method (pm_…) as the subscription default.
+ */
+export const UPDATE_SUBSCRIPTION_PAYMENT_METHOD = `mutation UpdateSubscriptionPaymentMethod(
+  $biId: String!
+  $tStripePaymentMethodId: String!
+) {
+  tUpdateSubscriptionPaymentMethod(
+    biId: $biId
+    tStripePaymentMethodId: $tStripePaymentMethodId
+  )
 }`;
 //# sourceMappingURL=queries.js.map

package/dist/utils/queries.js.map

@@ -1 +1 @@
-{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../src/utils/queries.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,iFAAiF;AAEjF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,WAAW,GAAG;;EAEzB,CAAC;AAEH,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAG;;EAE9B,CAAC;AAEH,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAG;;EAEzB,CAAC;AAEH,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG;;EAEzB,CAAC;AAEH,iFAAiF;AAEjF,MAAM,CAAC,MAAM,aAAa,GAAG;;;;;EAK3B,CAAC;AAEH,MAAM,CAAC,MAAM,eAAe,GAAG;;;;;;;;EAQ7B,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;EA0B/B,CAAC;AAEH,qEAAqE;AACrE,MAAM,CAAC,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;EAyB1B,CAAC;AAEH,iFAAiF;AACjF,MAAM,CAAC,MAAM,WAAW,GAAG;;;;;;;;;;;EAWzB,CAAC;AAEH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;EAe/B,CAAC;AAEH,kEAAkE;AAClE,MAAM,CAAC,MAAM,8BAA8B,GAAG;;EAE5C,CAAC;AAEH;0GAC0G;AAC1G,MAAM,CAAC,MAAM,8BAA8B,GAAG;;EAE5C,CAAC;AAEH,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA4B/B,CAAC","sourcesContent":["/**\n * api/queries.ts — GraphQL documents for the checkout flow.\n * Kept as plain strings so they can be reused, logged, or tested in isolation.\n *\n * Mutation reference (from API doc):\n *   updateTwouCustomer          — toggle Stripe test clock on/off\n *   createTwouCart              — user proceeds to payment\n *   updateTwouCartItem          — attach billing plan / payment method to cart\n *   updateTwouCart              — persist auto-renewal consent (SUBS-228)\n *   startBusinessProcessableTransition — place order\n *   updateTwouCartItem          — retry: attach new payment method\n */\n\n// ─── Mutations ────────────────────────────────────────────────────────────────\n\n/** Creates a new cart during checkout. */\nexport const CREATE_CART = `mutation CreateCart($input: TwouCartInput!) {\n  createTwouCart(input: $input) { biId uid }\n}`;\n\n/** Updates a cart item — attach billing plan / payment method. */\nexport const UPDATE_CART_ITEM = `mutation UpdateCartItem($input: TwouCartItemInput!) {\n  updateTwouCartItem(input: $input) { uid }\n}`;\n\n/** Persists auto-renewal consent fields on the TwouCart BI (SUBS-228). */\nexport const UPDATE_CART = `mutation UpdateCart($input: TwouCartInput!) {\n  updateTwouCart(input: $input) { uid }\n}`;\n\n/** Triggers the backend workflow to place the order. */\nexport const PLACE_ORDER = `mutation PlaceOrder($input: StartBusinessProcessableTransitionInput!) {\n  startBusinessProcessableTransition(input: $input) { uid bpStatus { code } }\n}`;\n\n// ─── Queries ──────────────────────────────────────────────────────────────────\n\nexport const GET_CART_ITEM = `query GetCartItem($biId: String!) {\n  getBusinessInteraction(biId: $biId) {\n    uid\n    hiConsistsOf { ... on TwouCartItem { uid } }\n  }\n}`;\n\nexport const GET_CART_STATUS = `query GetCartStatus($biId: String!) {\n  getBusinessInteraction(biId: $biId) {\n    bpStatus { code }\n    hiConsistsOf { ... on TwouCartItem { tStripeSubscriptionId } }\n    ... on TwouCart {\n      cmComments { edges { node { comText } } }\n    }\n  }\n}`;\n\nexport const FIND_SUBSCRIPTION = `query FindSubscription($filter: String!) {\n  filterTwouSubscription(_first: 1, _filter: $filter) {\n    edges {\n      node {\n        biId\n        tTrialStart\n        tTrialEnd\n        tRenewalType\n        hiConsistsOf {\n          ... on TwouSubscriptionItem {\n            paybBillingPlan {\n              tStripePriceId\n              bipOwnershipModel { omName }\n            }\n            paybPayment {\n              ... on TwouStripePayment {\n                tStripePaymentMethodId\n                tPaymentMethodLast4\n                tPaymentMethodBrand\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}`;\n\n/** Fetch the viax customer uid by email using filterTwouCustomer. */\nexport const GET_CUSTOMER = `query GetCustomer($filter: String!) {\n  filterTwouCustomer(_first: 1, _filter: $filter) {\n    edges {\n      node {\n        uid\n        parId\n        parParty {\n          paName\n          paContacts {\n            edges {\n              node {\n                ... on EmailAddressContactMedium {\n                  email\n                }\n              }\n            }\n          }\n          ... on Individual {\n            indFirstName\n            indLastName\n          }\n        }\n      }\n    }\n  }\n}`;\n\n/** Fetch the TwouSubscriptionPlan uid to use as biiSalable in createTwouCart. */\nexport const GET_PRODUCT = `query GetProduct($maId: String!) {\n  getProduct(maId: $maId) {\n    maName\n    uid\n    ... on TwouSubscriptionPlan {\n      saOwnershipModels {\n        uid\n        omName\n      }\n    }\n  }\n}`;\n\nexport const GET_BILLING_PLANS = `query GetBillingPlans {\n  filterCustomerBillingPlan(_first: 10) {\n    edges {\n      node {\n        uid\n        tStripePriceId\n        tStripeAmount {\n          amount\n          units { code }\n        }\n        bipIsTemplate\n        bipOwnershipModel { uid omName }\n      }\n    }\n  }\n}`;\n\n/** Fetch the number of active subscriptions — unauthenticated. */\nexport const GET_ACTIVE_SUBSCRIPTIONS_STATE = `query activeSubscriptions {\n  tActiveSubscriptionsState\n}`;\n\n/** Check whether the currently authenticated user already has an active subscription.\n *  tIsCurrentUserSubscriber is a JSON scalar — returns the full object, no subfield selection allowed. */\nexport const GET_IS_CURRENT_USER_SUBSCRIBER = `query IsCurrentUserSubscriber {\n  tIsCurrentUserSubscriber\n}`;\n\n/** Fetch a course for the enrollment card when ?course_run_key= is present. */\nexport const GET_COURSE_DETAIL = `query CourseDetail($filter: String!) {\n  filterTwouCourse(_first: 1, _filter: $filter) {\n    edges {\n      node {\n        maId\n        maName\n        maDescription\n        tShortDescription\n        imageUrl\n        tCourseKey\n        tBrandText\n        tPrimarySubjectArea\n        tLevelType\n        tLanguage\n        tPacingType { code }\n        tDurationLow\n        tDurationHigh\n        tDurationUnit { code }\n        tEffortLow\n        tEffortHigh\n        tEffortUnit { code }\n        tUrlCourse\n        tB2cSubscriptionInclusion\n        tHasOfacRestrictions\n        tCatalogActive\n      }\n    }\n  }\n}`;\n"]}
+{"version":3,"file":"queries.js","sourceRoot":"","sources":["../../src/utils/queries.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;;EAE5C,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG;;;;;;;;;;;;;;;;;;;;;EAqB1C,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;EAkBjC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;EAEjC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;EAErC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;;;;;;;;;;EAmB7C,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;;;;;;;;;;;;;;;EAe/B,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG;;;;;;;;EAQhD,CAAC","sourcesContent":["/**\n * GraphQL documents for the manage-subscription MFE.\n */\n\n/**\n * tIsCurrentUserSubscriber is a JSON scalar — returns the full object;\n * no subfield selection is allowed.\n */\nexport const GET_IS_CURRENT_USER_SUBSCRIBER = `query IsCurrentUserSubscriber {\n  tIsCurrentUserSubscriber\n}`;\n\n/**\n * Enrollments for cancel confirmation.\n * Build `_filter` client-side, e.g. tSubscriptionBiId IN ('BI…', 'BI…').\n */\nexport const GET_SUBSCRIPTION_ENROLLMENTS = `query EnrollmentsForSubscriptions($filter: String!) {\n  filterTwouEnrollment(_first: 200, _filter: $filter) {\n    edges {\n      node {\n        biId\n        tSubscriptionBiId\n        bpStatus { code }\n        tCourseRunKey\n        tCourse {\n          maId\n          maName\n          imageUrl\n          tBrandText\n          tSchools {\n            tName\n            tSortValue\n          }\n        }\n      }\n    }\n  }\n}`;\n\n/**\n * Invoices for the learner's subscription (payment history).\n * Filter is inlined client-side: biRelatesTo.biId = '<subscriptionBiId>'.\n */\nexport const GET_PAYMENT_HISTORY = `query PaymentHistory($filter: String!, $first: Int!) {\n  filterTwouInvoice(_first: $first, _filter: $filter) {\n    edges {\n      node {\n        biId\n        tStripeInvoiceId\n        bpStatus { code name }\n        billDate\n        billBillingPeriod { start end }\n        billFinancialCharges {\n          fichAmount {\n            amount\n            units { code }\n          }\n        }\n      }\n    }\n  }\n}`;\n\n/**\n * Cancel the learner's subscription (default: at period end).\n * Pass `immediate: true` to end access immediately.\n */\nexport const CANCEL_SUBSCRIPTION = `mutation CancelSubscription($biId: String!, $immediate: Boolean) {\n  tCancelSubscription(biId: $biId, immediate: $immediate)\n}`;\n\n/**\n * Resume a cancelled subscription before the period end / cancellation date.\n */\nexport const REACTIVATE_SUBSCRIPTION = `mutation ReactivateSubscription($biId: String!) {\n  tReactivateSubscription(biId: $biId)\n}`;\n\n/**\n * Payment method on an existing subscription (for renew / manage display).\n */\nexport const GET_SUBSCRIPTION_PAYMENT_METHOD = `query SubscriptionPaymentMethod($filter: String!) {\n  filterTwouSubscription(_first: 1, _filter: $filter) {\n    edges {\n      node {\n        biId\n        hiConsistsOf {\n          ... on TwouSubscriptionItem {\n            paybPayment {\n              ... on TwouStripePayment {\n                tStripePaymentMethodId\n                tPaymentMethodLast4\n                tPaymentMethodBrand\n              }\n            }\n          }\n        }\n      }\n    }\n  }\n}`;\n\n/**\n * Available customer billing plans (monthly / annual template prices).\n * Same query as frontend-app-subscription-checkout.\n */\nexport const GET_BILLING_PLANS = `query GetBillingPlans {\n  filterCustomerBillingPlan(_first: 10) {\n    edges {\n      node {\n        uid\n        tStripePriceId\n        tStripeAmount {\n          amount\n          units { code }\n        }\n        bipIsTemplate\n        bipOwnershipModel { uid omName }\n      }\n    }\n  }\n}`;\n\n/**\n * Attach a new Stripe payment method (pm_…) as the subscription default.\n */\nexport const UPDATE_SUBSCRIPTION_PAYMENT_METHOD = `mutation UpdateSubscriptionPaymentMethod(\n  $biId: String!\n  $tStripePaymentMethodId: String!\n) {\n  tUpdateSubscriptionPaymentMethod(\n    biId: $biId\n    tStripePaymentMethodId: $tStripePaymentMethodId\n  )\n}`;\n"]}

package/dist/utils/subscriptionView.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Derive which manage-subscription UI to show from subscriber API data.
+ */
+import type { CurrentUserSubscriberResult, SubscriptionView } from '../types';
+/**
+ * Map subscriber payload → UI view.
+ *
+ * - active: can enroll / ACTIVE / TRIAL / isSubscriber without cancel status
+ * - canceled_access: canceled but period end still in the future (or isSubscriber)
+ * - canceled_expired: previously subscribed, no current access
+ * - none: never subscribed / no useful subscription context
+ */
+export declare function resolveSubscriptionView(subscriber: CurrentUserSubscriberResult | null | undefined): SubscriptionView;
+/** Human-readable plan label from renewal type / status. */
+export declare function resolvePlanLabel(subscriber: CurrentUserSubscriberResult | null | undefined): 'monthly' | 'annual';

package/dist/utils/subscriptionView.js

@@ -0,0 +1,50 @@
+/**
+ * Derive which manage-subscription UI to show from subscriber API data.
+ */
+import { ACTIVE_SUBSCRIPTION_STATUSES, CANCELED_SUBSCRIPTION_STATUSES, } from '../constants';
+import { isFutureDate } from './formatDate';
+/**
+ * Map subscriber payload → UI view.
+ *
+ * - active: can enroll / ACTIVE / TRIAL / isSubscriber without cancel status
+ * - canceled_access: canceled but period end still in the future (or isSubscriber)
+ * - canceled_expired: previously subscribed, no current access
+ * - none: never subscribed / no useful subscription context
+ */
+export function resolveSubscriptionView(subscriber) {
+    var _a;
+    if (!subscriber) {
+        return 'none';
+    }
+    const status = ((_a = subscriber.status) !== null && _a !== void 0 ? _a : '').toUpperCase();
+    const isCanceledStatus = (CANCELED_SUBSCRIPTION_STATUSES.has(status)
+        || status.includes('CANCEL'));
+    if (!isCanceledStatus
+        && (subscriber.canEnroll
+            || subscriber.isSubscriber
+            || ACTIVE_SUBSCRIPTION_STATUSES.has(status))) {
+        return 'active';
+    }
+    const periodStillOpen = isFutureDate(subscriber.currentPeriodEnd)
+        || isFutureDate(subscriber.subscriptionEndDate);
+    if (isCanceledStatus) {
+        if (subscriber.isSubscriber || periodStillOpen) {
+            return 'canceled_access';
+        }
+        return 'canceled_expired';
+    }
+    if (subscriber.subscriptionBiId || subscriber.canceledAt) {
+        return 'canceled_expired';
+    }
+    return 'none';
+}
+/** Human-readable plan label from renewal type / status. */
+export function resolvePlanLabel(subscriber) {
+    var _a;
+    const raw = ((_a = subscriber === null || subscriber === void 0 ? void 0 : subscriber.renewalType) !== null && _a !== void 0 ? _a : '').toLowerCase();
+    if (raw.includes('annual') || raw.includes('year')) {
+        return 'annual';
+    }
+    return 'monthly';
+}
+//# sourceMappingURL=subscriptionView.js.map

package/dist/utils/subscriptionView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriptionView.js","sourceRoot":"","sources":["../../src/utils/subscriptionView.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,4BAA4B,EAC5B,8BAA8B,GAC/B,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,UAA0D;;IAE1D,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAAG,CAAC,MAAA,UAAU,CAAC,MAAM,mCAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IACvD,MAAM,gBAAgB,GAAG,CACvB,8BAA8B,CAAC,GAAG,CAAC,MAAM,CAAC;WACvC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAC7B,CAAC;IAEF,IACE,CAAC,gBAAgB;WACd,CACD,UAAU,CAAC,SAAS;eACjB,UAAU,CAAC,YAAY;eACvB,4BAA4B,CAAC,GAAG,CAAC,MAAM,CAAC,CAC5C,EACD,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,eAAe,GAAG,YAAY,CAAC,UAAU,CAAC,gBAAgB,CAAC;WAC5D,YAAY,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAElD,IAAI,gBAAgB,EAAE,CAAC;QACrB,IAAI,UAAU,CAAC,YAAY,IAAI,eAAe,EAAE,CAAC;YAC/C,OAAO,iBAAiB,CAAC;QAC3B,CAAC;QACD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,IAAI,UAAU,CAAC,gBAAgB,IAAI,UAAU,CAAC,UAAU,EAAE,CAAC;QACzD,OAAO,kBAAkB,CAAC;IAC5B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,gBAAgB,CAC9B,UAA0D;;IAE1D,MAAM,GAAG,GAAG,CAAC,MAAA,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAE,WAAW,mCAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1D,IAAI,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QACnD,OAAO,QAAQ,CAAC;IAClB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["/**\n * Derive which manage-subscription UI to show from subscriber API data.\n */\n\nimport {\n  ACTIVE_SUBSCRIPTION_STATUSES,\n  CANCELED_SUBSCRIPTION_STATUSES,\n} from '../constants';\nimport type { CurrentUserSubscriberResult, SubscriptionView } from '../types';\nimport { isFutureDate } from './formatDate';\n\n/**\n * Map subscriber payload → UI view.\n *\n * - active: can enroll / ACTIVE / TRIAL / isSubscriber without cancel status\n * - canceled_access: canceled but period end still in the future (or isSubscriber)\n * - canceled_expired: previously subscribed, no current access\n * - none: never subscribed / no useful subscription context\n */\nexport function resolveSubscriptionView(\n  subscriber: CurrentUserSubscriberResult | null | undefined,\n): SubscriptionView {\n  if (!subscriber) {\n    return 'none';\n  }\n\n  const status = (subscriber.status ?? '').toUpperCase();\n  const isCanceledStatus = (\n    CANCELED_SUBSCRIPTION_STATUSES.has(status)\n    || status.includes('CANCEL')\n  );\n\n  if (\n    !isCanceledStatus\n    && (\n      subscriber.canEnroll\n      || subscriber.isSubscriber\n      || ACTIVE_SUBSCRIPTION_STATUSES.has(status)\n    )\n  ) {\n    return 'active';\n  }\n\n  const periodStillOpen = isFutureDate(subscriber.currentPeriodEnd)\n    || isFutureDate(subscriber.subscriptionEndDate);\n\n  if (isCanceledStatus) {\n    if (subscriber.isSubscriber || periodStillOpen) {\n      return 'canceled_access';\n    }\n    return 'canceled_expired';\n  }\n\n  if (subscriber.subscriptionBiId || subscriber.canceledAt) {\n    return 'canceled_expired';\n  }\n\n  return 'none';\n}\n\n/** Human-readable plan label from renewal type / status. */\nexport function resolvePlanLabel(\n  subscriber: CurrentUserSubscriberResult | null | undefined,\n): 'monthly' | 'annual' {\n  const raw = (subscriber?.renewalType ?? '').toLowerCase();\n  if (raw.includes('annual') || raw.includes('year')) {\n    return 'annual';\n  }\n  return 'monthly';\n}\n"]}

package/dist/utils/urls.d.ts

@@ -0,0 +1,13 @@
+/**
+ * External / sibling-app URLs for manage-subscription CTAs.
+ */
+/** Checkout / subscribe flow URL (renew + new subscribe). */
+export declare function getCheckoutUrl(): string;
+/** Marketing page for "Learn about edX Subscription". */
+export declare function getLearnMoreUrl(): string;
+/** Learner Help Center (footer link). */
+export declare function getLearnerHelpCenterUrl(): string;
+/** Learner dashboard URL for post-cancel return. */
+export declare function getLearnerDashboardUrl(): string;
+/** Optional change-to-annual checkout deep link. */
+export declare function getChangeToAnnualUrl(): string;