@edx/frontend-app-subscription-checkout 1.0.0

package/dist/constants.js

@@ -0,0 +1,276 @@
+export const appId = 'org.openedx.frontend.app.subscription.checkout';
+export const subscriptionCheckoutRole = 'org.openedx.frontend.role.subscription.checkout';
+// --- Cart BI state machine ---------------------------------------------------
+export const STATUS = {
+    IN_CART: 'IN_CART',
+    CONFIRM: 'CONFIRM',
+    SANCTION_STARTED: 'SANCTION_STARTED',
+    SANCTION_PASSED: 'SANCTION_PASSED',
+    SANCTION_BLOCK: 'SANCTION_BLOCK',
+    STRIPE_STARTED: 'STRIPE_STARTED',
+    STRIPE_SUBSCRIBED: 'STRIPE_SUBSCRIBED',
+    STRIPE_CONFIRMATION_REQUIRED: 'STRIPE_CONFIRMATION_REQUIRED',
+    STRIPE_FAIL: 'STRIPE_FAIL',
+    SUBSCRIPTION_CREATED: 'SUBSCRIPTION_CREATED',
+};
+export const TERMINAL_STATES = [
+    STATUS.SUBSCRIPTION_CREATED,
+    STATUS.SANCTION_BLOCK,
+    STATUS.STRIPE_FAIL,
+];
+export const STATUS_LABELS = {
+    IN_CART: 'Cart created',
+    CONFIRM: 'Order confirmed',
+    SANCTION_STARTED: 'Checking sanctions…',
+    SANCTION_PASSED: 'Sanctions passed — setting up your account…',
+    SANCTION_BLOCK: 'Order blocked',
+    STRIPE_STARTED: 'Setting up your subscription…',
+    STRIPE_CONFIRMATION_REQUIRED: 'Card verification required',
+    STRIPE_SUBSCRIBED: 'Card verified — finalizing…',
+    STRIPE_FAIL: 'Payment failed',
+    SUBSCRIPTION_CREATED: 'Subscription created',
+};
+export const isTerminalStatus = (status) => TERMINAL_STATES.includes(status);
+/** UI phase derived from the raw bpStatus code + cart readiness. */
+export function phaseFor(status, ready) {
+    if (status === STATUS.SUBSCRIPTION_CREATED)
+        return 'success';
+    if (status === STATUS.SANCTION_BLOCK)
+        return 'blocked';
+    if (status === STATUS.STRIPE_FAIL)
+        return 'failed';
+    if (status && status !== STATUS.IN_CART)
+        return 'processing';
+    return ready ? 'ready' : 'init';
+}
+// --- Dev defaults (match the local test harness) -----------------------------
+export const DEFAULTS = {
+    apiUrl: '/api/graphql',
+    confirmIntentUrl: '/api/stripe/confirm-pi',
+    customerUid: '019d2bde-f769-743d-88f9-8bf0d1a7a002',
+    salableUid: '019d2ce7-05bc-7dd6-b141-e32df9ac86c1',
+    billingPlanUid: '019d2ce7-05c0-7188-81b0-8eb747b41b0f',
+};
+export const LS_KEYS = { biId: 'twou.cartBiId', uid: 'twou.cartUid' };
+// ─── Checkout gate feature flags (dev controls) ───────────────────────────────
+// Set to false during development to bypass the country gate check.
+// Should be true in production. Subscriber access is enforced outside this app.
+/** When false, the country check is skipped — all countries can access checkout. */
+export const GATE_CHECK_COUNTRY = true;
+/**
+ * ISO 3166-1 alpha-2 country codes that are permitted to complete checkout.
+ * Add or remove codes here to open or restrict access by country.
+ * e.g. ['US', 'CA', 'GB'] to allow US, Canada, and UK.
+ */
+export const ALLOWED_CHECKOUT_COUNTRIES = ['US', 'CA'];
+/**
+ * ISO 3166-1 alpha-2 country codes that require the extra billing-consent checkbox.
+ * Add or remove codes here to control which residents see the second checkbox.
+ */
+export const COUNTRIES_REQUIRING_EXTRA_CONFIRM = ['GB', 'CA'];
+export const COUNTRIES = [
+    ['AF', 'Afghanistan'],
+    ['AL', 'Albania'],
+    ['DZ', 'Algeria'],
+    ['AD', 'Andorra'],
+    ['AO', 'Angola'],
+    ['AG', 'Antigua and Barbuda'],
+    ['AR', 'Argentina'],
+    ['AM', 'Armenia'],
+    ['AU', 'Australia'],
+    ['AT', 'Austria'],
+    ['AZ', 'Azerbaijan'],
+    ['BS', 'Bahamas'],
+    ['BH', 'Bahrain'],
+    ['BD', 'Bangladesh'],
+    ['BB', 'Barbados'],
+    ['BY', 'Belarus'],
+    ['BE', 'Belgium'],
+    ['BZ', 'Belize'],
+    ['BJ', 'Benin'],
+    ['BT', 'Bhutan'],
+    ['BO', 'Bolivia'],
+    ['BA', 'Bosnia and Herzegovina'],
+    ['BW', 'Botswana'],
+    ['BR', 'Brazil'],
+    ['BN', 'Brunei'],
+    ['BG', 'Bulgaria'],
+    ['BF', 'Burkina Faso'],
+    ['BI', 'Burundi'],
+    ['CV', 'Cabo Verde'],
+    ['KH', 'Cambodia'],
+    ['CM', 'Cameroon'],
+    ['CA', 'Canada'],
+    ['CF', 'Central African Republic'],
+    ['TD', 'Chad'],
+    ['CL', 'Chile'],
+    ['CN', 'China'],
+    ['CO', 'Colombia'],
+    ['KM', 'Comoros'],
+    ['CG', 'Congo (Congo-Brazzaville)'],
+    ['CR', 'Costa Rica'],
+    ['HR', 'Croatia'],
+    ['CU', 'Cuba'],
+    ['CY', 'Cyprus'],
+    ['CZ', 'Czechia (Czech Republic)'],
+    ['CD', 'Democratic Republic of the Congo'],
+    ['DK', 'Denmark'],
+    ['DJ', 'Djibouti'],
+    ['DM', 'Dominica'],
+    ['DO', 'Dominican Republic'],
+    ['EC', 'Ecuador'],
+    ['EG', 'Egypt'],
+    ['SV', 'El Salvador'],
+    ['GQ', 'Equatorial Guinea'],
+    ['ER', 'Eritrea'],
+    ['EE', 'Estonia'],
+    ['SZ', 'Eswatini'],
+    ['ET', 'Ethiopia'],
+    ['FJ', 'Fiji'],
+    ['FI', 'Finland'],
+    ['FR', 'France'],
+    ['GA', 'Gabon'],
+    ['GM', 'Gambia'],
+    ['GE', 'Georgia'],
+    ['DE', 'Germany'],
+    ['GH', 'Ghana'],
+    ['GR', 'Greece'],
+    ['GD', 'Grenada'],
+    ['GT', 'Guatemala'],
+    ['GN', 'Guinea'],
+    ['GW', 'Guinea-Bissau'],
+    ['GY', 'Guyana'],
+    ['HT', 'Haiti'],
+    ['VA', 'Holy See (Vatican City)'],
+    ['HN', 'Honduras'],
+    ['HU', 'Hungary'],
+    ['IS', 'Iceland'],
+    ['IN', 'India'],
+    ['ID', 'Indonesia'],
+    ['IR', 'Iran'],
+    ['IQ', 'Iraq'],
+    ['IE', 'Ireland'],
+    ['IL', 'Israel'],
+    ['IT', 'Italy'],
+    ['CI', "Ivory Coast (Côte d'Ivoire)"],
+    ['JM', 'Jamaica'],
+    ['JP', 'Japan'],
+    ['JO', 'Jordan'],
+    ['KZ', 'Kazakhstan'],
+    ['KE', 'Kenya'],
+    ['KI', 'Kiribati'],
+    ['KW', 'Kuwait'],
+    ['KG', 'Kyrgyzstan'],
+    ['LA', 'Laos'],
+    ['LV', 'Latvia'],
+    ['LB', 'Lebanon'],
+    ['LS', 'Lesotho'],
+    ['LR', 'Liberia'],
+    ['LY', 'Libya'],
+    ['LI', 'Liechtenstein'],
+    ['LT', 'Lithuania'],
+    ['LU', 'Luxembourg'],
+    ['MG', 'Madagascar'],
+    ['MW', 'Malawi'],
+    ['MY', 'Malaysia'],
+    ['MV', 'Maldives'],
+    ['ML', 'Mali'],
+    ['MT', 'Malta'],
+    ['MH', 'Marshall Islands'],
+    ['MR', 'Mauritania'],
+    ['MU', 'Mauritius'],
+    ['MX', 'Mexico'],
+    ['FM', 'Micronesia'],
+    ['MD', 'Moldova'],
+    ['MC', 'Monaco'],
+    ['MN', 'Mongolia'],
+    ['ME', 'Montenegro'],
+    ['MA', 'Morocco'],
+    ['MZ', 'Mozambique'],
+    ['MM', 'Myanmar (Burma)'],
+    ['NA', 'Namibia'],
+    ['NR', 'Nauru'],
+    ['NP', 'Nepal'],
+    ['NL', 'Netherlands'],
+    ['NZ', 'New Zealand'],
+    ['NI', 'Nicaragua'],
+    ['NE', 'Niger'],
+    ['NG', 'Nigeria'],
+    ['KP', 'North Korea'],
+    ['MK', 'North Macedonia'],
+    ['NO', 'Norway'],
+    ['OM', 'Oman'],
+    ['PK', 'Pakistan'],
+    ['PW', 'Palau'],
+    ['PS', 'Palestine State'],
+    ['PA', 'Panama'],
+    ['PG', 'Papua New Guinea'],
+    ['PY', 'Paraguay'],
+    ['PE', 'Peru'],
+    ['PH', 'Philippines'],
+    ['PL', 'Poland'],
+    ['PT', 'Portugal'],
+    ['QA', 'Qatar'],
+    ['RO', 'Romania'],
+    ['RU', 'Russia'],
+    ['RW', 'Rwanda'],
+    ['KN', 'Saint Kitts and Nevis'],
+    ['LC', 'Saint Lucia'],
+    ['VC', 'Saint Vincent and the Grenadines'],
+    ['WS', 'Samoa'],
+    ['SM', 'San Marino'],
+    ['ST', 'Sao Tome and Principe'],
+    ['SA', 'Saudi Arabia'],
+    ['SN', 'Senegal'],
+    ['RS', 'Serbia'],
+    ['SC', 'Seychelles'],
+    ['SL', 'Sierra Leone'],
+    ['SG', 'Singapore'],
+    ['SK', 'Slovakia'],
+    ['SI', 'Slovenia'],
+    ['SB', 'Solomon Islands'],
+    ['SO', 'Somalia'],
+    ['ZA', 'South Africa'],
+    ['KR', 'South Korea'],
+    ['SS', 'South Sudan'],
+    ['ES', 'Spain'],
+    ['LK', 'Sri Lanka'],
+    ['SD', 'Sudan'],
+    ['SR', 'Suriname'],
+    ['SE', 'Sweden'],
+    ['CH', 'Switzerland'],
+    ['SY', 'Syria'],
+    ['TJ', 'Tajikistan'],
+    ['TZ', 'Tanzania'],
+    ['TH', 'Thailand'],
+    ['TL', 'Timor-Leste'],
+    ['TG', 'Togo'],
+    ['TO', 'Tonga'],
+    ['TT', 'Trinidad and Tobago'],
+    ['TN', 'Tunisia'],
+    ['TR', 'Turkey'],
+    ['TM', 'Turkmenistan'],
+    ['TV', 'Tuvalu'],
+    ['UG', 'Uganda'],
+    ['UA', 'Ukraine'],
+    ['AE', 'United Arab Emirates'],
+    ['GB', 'United Kingdom'],
+    ['US', 'United States'],
+    ['UY', 'Uruguay'],
+    ['UZ', 'Uzbekistan'],
+    ['VU', 'Vanuatu'],
+    ['VE', 'Venezuela'],
+    ['VN', 'Vietnam'],
+    ['YE', 'Yemen'],
+    ['ZM', 'Zambia'],
+    ['ZW', 'Zimbabwe'],
+];
+// --- Stripe Element presentation ---------------------------------------------
+// A div that hosts a Stripe Element but reads like a Paragon input.
+export const STRIPE_FIELD_STYLE = {
+    height: 'auto', minHeight: '2.875rem', display: 'flex', alignItems: 'center',
+};
+export const STRIPE_ELEMENT_OPTS = {
+    style: { base: { fontSize: '16px', color: '#1a1a1a', '::placeholder': { color: '#8f8f8f' } } },
+};
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"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","sourcesContent":["import type { CSSProperties } from 'react';\n\nexport const appId = 'org.openedx.frontend.app.subscription.checkout';\nexport const subscriptionCheckoutRole = 'org.openedx.frontend.role.subscription.checkout';\n\n// --- Cart BI state machine ---------------------------------------------------\nexport const STATUS = {\n  IN_CART: 'IN_CART',\n  CONFIRM: 'CONFIRM',\n  SANCTION_STARTED: 'SANCTION_STARTED',\n  SANCTION_PASSED: 'SANCTION_PASSED',\n  SANCTION_BLOCK: 'SANCTION_BLOCK',\n  STRIPE_STARTED: 'STRIPE_STARTED',\n  STRIPE_SUBSCRIBED: 'STRIPE_SUBSCRIBED',\n  STRIPE_CONFIRMATION_REQUIRED: 'STRIPE_CONFIRMATION_REQUIRED',\n  STRIPE_FAIL: 'STRIPE_FAIL',\n  SUBSCRIPTION_CREATED: 'SUBSCRIPTION_CREATED',\n} as const;\n\nexport type Status = typeof STATUS[keyof typeof STATUS];\n\nexport type Phase = 'init' | 'ready' | 'processing' | 'threeds' | 'success' | 'blocked' | 'failed';\n\nexport const TERMINAL_STATES: Status[] = [\n  STATUS.SUBSCRIPTION_CREATED,\n  STATUS.SANCTION_BLOCK,\n  STATUS.STRIPE_FAIL,\n];\n\nexport const STATUS_LABELS: Record<string, string> = {\n  IN_CART: 'Cart created',\n  CONFIRM: 'Order confirmed',\n  SANCTION_STARTED: 'Checking sanctions…',\n  SANCTION_PASSED: 'Sanctions passed — setting up your account…',\n  SANCTION_BLOCK: 'Order blocked',\n  STRIPE_STARTED: 'Setting up your subscription…',\n  STRIPE_CONFIRMATION_REQUIRED: 'Card verification required',\n  STRIPE_SUBSCRIBED: 'Card verified — finalizing…',\n  STRIPE_FAIL: 'Payment failed',\n  SUBSCRIPTION_CREATED: 'Subscription created',\n};\n\nexport const isTerminalStatus = (status: Status | null | undefined): boolean =>\n  TERMINAL_STATES.includes(status as Status);\n\n/** UI phase derived from the raw bpStatus code + cart readiness. */\nexport function phaseFor(status: Status | null, ready: boolean): Phase {\n  if (status === STATUS.SUBSCRIPTION_CREATED) return 'success';\n  if (status === STATUS.SANCTION_BLOCK) return 'blocked';\n  if (status === STATUS.STRIPE_FAIL) return 'failed';\n  if (status && status !== STATUS.IN_CART) return 'processing';\n  return ready ? 'ready' : 'init';\n}\n\n// --- Dev defaults (match the local test harness) -----------------------------\nexport const DEFAULTS = {\n  apiUrl: '/api/graphql',\n  confirmIntentUrl: '/api/stripe/confirm-pi',\n  customerUid: '019d2bde-f769-743d-88f9-8bf0d1a7a002',\n  salableUid: '019d2ce7-05bc-7dd6-b141-e32df9ac86c1',\n  billingPlanUid: '019d2ce7-05c0-7188-81b0-8eb747b41b0f',\n};\n\nexport const LS_KEYS = { biId: 'twou.cartBiId', uid: 'twou.cartUid' };\n\n// ─── Checkout gate feature flags (dev controls) ───────────────────────────────\n// Set to false during development to bypass the country gate check.\n// Should be true in production. Subscriber access is enforced outside this app.\n\n/** When false, the country check is skipped — all countries can access checkout. */\nexport const GATE_CHECK_COUNTRY = true;\n\n/**\n * ISO 3166-1 alpha-2 country codes that are permitted to complete checkout.\n * Add or remove codes here to open or restrict access by country.\n * e.g. ['US', 'CA', 'GB'] to allow US, Canada, and UK.\n */\nexport const ALLOWED_CHECKOUT_COUNTRIES: readonly string[] = ['US', 'CA'];\n\n/**\n * ISO 3166-1 alpha-2 country codes that require the extra billing-consent checkbox.\n * Add or remove codes here to control which residents see the second checkbox.\n */\nexport const COUNTRIES_REQUIRING_EXTRA_CONFIRM: readonly string[] = ['GB', 'CA'];\n\nexport const COUNTRIES: readonly (readonly [string, string])[] = [\n  ['AF', 'Afghanistan'],\n  ['AL', 'Albania'],\n  ['DZ', 'Algeria'],\n  ['AD', 'Andorra'],\n  ['AO', 'Angola'],\n  ['AG', 'Antigua and Barbuda'],\n  ['AR', 'Argentina'],\n  ['AM', 'Armenia'],\n  ['AU', 'Australia'],\n  ['AT', 'Austria'],\n  ['AZ', 'Azerbaijan'],\n  ['BS', 'Bahamas'],\n  ['BH', 'Bahrain'],\n  ['BD', 'Bangladesh'],\n  ['BB', 'Barbados'],\n  ['BY', 'Belarus'],\n  ['BE', 'Belgium'],\n  ['BZ', 'Belize'],\n  ['BJ', 'Benin'],\n  ['BT', 'Bhutan'],\n  ['BO', 'Bolivia'],\n  ['BA', 'Bosnia and Herzegovina'],\n  ['BW', 'Botswana'],\n  ['BR', 'Brazil'],\n  ['BN', 'Brunei'],\n  ['BG', 'Bulgaria'],\n  ['BF', 'Burkina Faso'],\n  ['BI', 'Burundi'],\n  ['CV', 'Cabo Verde'],\n  ['KH', 'Cambodia'],\n  ['CM', 'Cameroon'],\n  ['CA', 'Canada'],\n  ['CF', 'Central African Republic'],\n  ['TD', 'Chad'],\n  ['CL', 'Chile'],\n  ['CN', 'China'],\n  ['CO', 'Colombia'],\n  ['KM', 'Comoros'],\n  ['CG', 'Congo (Congo-Brazzaville)'],\n  ['CR', 'Costa Rica'],\n  ['HR', 'Croatia'],\n  ['CU', 'Cuba'],\n  ['CY', 'Cyprus'],\n  ['CZ', 'Czechia (Czech Republic)'],\n  ['CD', 'Democratic Republic of the Congo'],\n  ['DK', 'Denmark'],\n  ['DJ', 'Djibouti'],\n  ['DM', 'Dominica'],\n  ['DO', 'Dominican Republic'],\n  ['EC', 'Ecuador'],\n  ['EG', 'Egypt'],\n  ['SV', 'El Salvador'],\n  ['GQ', 'Equatorial Guinea'],\n  ['ER', 'Eritrea'],\n  ['EE', 'Estonia'],\n  ['SZ', 'Eswatini'],\n  ['ET', 'Ethiopia'],\n  ['FJ', 'Fiji'],\n  ['FI', 'Finland'],\n  ['FR', 'France'],\n  ['GA', 'Gabon'],\n  ['GM', 'Gambia'],\n  ['GE', 'Georgia'],\n  ['DE', 'Germany'],\n  ['GH', 'Ghana'],\n  ['GR', 'Greece'],\n  ['GD', 'Grenada'],\n  ['GT', 'Guatemala'],\n  ['GN', 'Guinea'],\n  ['GW', 'Guinea-Bissau'],\n  ['GY', 'Guyana'],\n  ['HT', 'Haiti'],\n  ['VA', 'Holy See (Vatican City)'],\n  ['HN', 'Honduras'],\n  ['HU', 'Hungary'],\n  ['IS', 'Iceland'],\n  ['IN', 'India'],\n  ['ID', 'Indonesia'],\n  ['IR', 'Iran'],\n  ['IQ', 'Iraq'],\n  ['IE', 'Ireland'],\n  ['IL', 'Israel'],\n  ['IT', 'Italy'],\n  ['CI', \"Ivory Coast (Côte d'Ivoire)\"],\n  ['JM', 'Jamaica'],\n  ['JP', 'Japan'],\n  ['JO', 'Jordan'],\n  ['KZ', 'Kazakhstan'],\n  ['KE', 'Kenya'],\n  ['KI', 'Kiribati'],\n  ['KW', 'Kuwait'],\n  ['KG', 'Kyrgyzstan'],\n  ['LA', 'Laos'],\n  ['LV', 'Latvia'],\n  ['LB', 'Lebanon'],\n  ['LS', 'Lesotho'],\n  ['LR', 'Liberia'],\n  ['LY', 'Libya'],\n  ['LI', 'Liechtenstein'],\n  ['LT', 'Lithuania'],\n  ['LU', 'Luxembourg'],\n  ['MG', 'Madagascar'],\n  ['MW', 'Malawi'],\n  ['MY', 'Malaysia'],\n  ['MV', 'Maldives'],\n  ['ML', 'Mali'],\n  ['MT', 'Malta'],\n  ['MH', 'Marshall Islands'],\n  ['MR', 'Mauritania'],\n  ['MU', 'Mauritius'],\n  ['MX', 'Mexico'],\n  ['FM', 'Micronesia'],\n  ['MD', 'Moldova'],\n  ['MC', 'Monaco'],\n  ['MN', 'Mongolia'],\n  ['ME', 'Montenegro'],\n  ['MA', 'Morocco'],\n  ['MZ', 'Mozambique'],\n  ['MM', 'Myanmar (Burma)'],\n  ['NA', 'Namibia'],\n  ['NR', 'Nauru'],\n  ['NP', 'Nepal'],\n  ['NL', 'Netherlands'],\n  ['NZ', 'New Zealand'],\n  ['NI', 'Nicaragua'],\n  ['NE', 'Niger'],\n  ['NG', 'Nigeria'],\n  ['KP', 'North Korea'],\n  ['MK', 'North Macedonia'],\n  ['NO', 'Norway'],\n  ['OM', 'Oman'],\n  ['PK', 'Pakistan'],\n  ['PW', 'Palau'],\n  ['PS', 'Palestine State'],\n  ['PA', 'Panama'],\n  ['PG', 'Papua New Guinea'],\n  ['PY', 'Paraguay'],\n  ['PE', 'Peru'],\n  ['PH', 'Philippines'],\n  ['PL', 'Poland'],\n  ['PT', 'Portugal'],\n  ['QA', 'Qatar'],\n  ['RO', 'Romania'],\n  ['RU', 'Russia'],\n  ['RW', 'Rwanda'],\n  ['KN', 'Saint Kitts and Nevis'],\n  ['LC', 'Saint Lucia'],\n  ['VC', 'Saint Vincent and the Grenadines'],\n  ['WS', 'Samoa'],\n  ['SM', 'San Marino'],\n  ['ST', 'Sao Tome and Principe'],\n  ['SA', 'Saudi Arabia'],\n  ['SN', 'Senegal'],\n  ['RS', 'Serbia'],\n  ['SC', 'Seychelles'],\n  ['SL', 'Sierra Leone'],\n  ['SG', 'Singapore'],\n  ['SK', 'Slovakia'],\n  ['SI', 'Slovenia'],\n  ['SB', 'Solomon Islands'],\n  ['SO', 'Somalia'],\n  ['ZA', 'South Africa'],\n  ['KR', 'South Korea'],\n  ['SS', 'South Sudan'],\n  ['ES', 'Spain'],\n  ['LK', 'Sri Lanka'],\n  ['SD', 'Sudan'],\n  ['SR', 'Suriname'],\n  ['SE', 'Sweden'],\n  ['CH', 'Switzerland'],\n  ['SY', 'Syria'],\n  ['TJ', 'Tajikistan'],\n  ['TZ', 'Tanzania'],\n  ['TH', 'Thailand'],\n  ['TL', 'Timor-Leste'],\n  ['TG', 'Togo'],\n  ['TO', 'Tonga'],\n  ['TT', 'Trinidad and Tobago'],\n  ['TN', 'Tunisia'],\n  ['TR', 'Turkey'],\n  ['TM', 'Turkmenistan'],\n  ['TV', 'Tuvalu'],\n  ['UG', 'Uganda'],\n  ['UA', 'Ukraine'],\n  ['AE', 'United Arab Emirates'],\n  ['GB', 'United Kingdom'],\n  ['US', 'United States'],\n  ['UY', 'Uruguay'],\n  ['UZ', 'Uzbekistan'],\n  ['VU', 'Vanuatu'],\n  ['VE', 'Venezuela'],\n  ['VN', 'Vietnam'],\n  ['YE', 'Yemen'],\n  ['ZM', 'Zambia'],\n  ['ZW', 'Zimbabwe'],\n];\n\n// --- Stripe Element presentation ---------------------------------------------\n// A div that hosts a Stripe Element but reads like a Paragon input.\nexport const STRIPE_FIELD_STYLE: CSSProperties = {\n  height: 'auto', minHeight: '2.875rem', display: 'flex', alignItems: 'center',\n};\nexport const STRIPE_ELEMENT_OPTS = {\n  style: { base: { fontSize: '16px', color: '#1a1a1a', '::placeholder': { color: '#8f8f8f' } } },\n};\n"]}

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

@@ -0,0 +1,14 @@
+/**
+ * query/keys.ts — typed query-key factory for the checkout module.
+ */
+export declare const checkoutKeys: {
+    all: readonly ["checkout"];
+    status: (cartBiId: string) => readonly ["checkout", "status", string];
+    clientSecret: (subscriptionId: string) => readonly ["checkout", "clientSecret", string];
+    subscriptionId: (cartBiId: string) => readonly ["checkout", "subscriptionId", string];
+    customer: (userEmail: string) => readonly ["checkout", "customer", string];
+    salable: (maId: string) => readonly ["checkout", "salable", string];
+    billingPlans: () => readonly ["checkout", "billingPlans"];
+    viaxSession: () => readonly ["checkout", "viaxSession"];
+    courseDetail: (courseKey: string) => readonly ["checkout", "courseDetail", string];
+};

package/dist/data/hooks/keys.js

@@ -0,0 +1,15 @@
+/**
+ * query/keys.ts — typed query-key factory for the checkout module.
+ */
+export const checkoutKeys = {
+    all: ['checkout'],
+    status: (cartBiId) => ['checkout', 'status', cartBiId],
+    clientSecret: (subscriptionId) => ['checkout', 'clientSecret', subscriptionId],
+    subscriptionId: (cartBiId) => ['checkout', 'subscriptionId', cartBiId],
+    customer: (userEmail) => ['checkout', 'customer', userEmail],
+    salable: (maId) => ['checkout', 'salable', maId],
+    billingPlans: () => ['checkout', 'billingPlans'],
+    viaxSession: () => ['checkout', 'viaxSession'],
+    courseDetail: (courseKey) => ['checkout', 'courseDetail', courseKey],
+};
+//# sourceMappingURL=keys.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/data/hooks/keys.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,GAAG,EAAE,CAAC,UAAU,CAAU;IAC1B,MAAM,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,QAAQ,CAAU;IACvE,YAAY,EAAE,CAAC,cAAsB,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,CAAU;IAC/F,cAAc,EAAE,CAAC,QAAgB,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,gBAAgB,EAAE,QAAQ,CAAU;IACvF,QAAQ,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,UAAU,EAAE,SAAS,CAAU;IAC7E,OAAO,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,SAAS,EAAE,IAAI,CAAU;IACjE,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,cAAc,CAAU;IACzD,WAAW,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,aAAa,CAAU;IACvD,YAAY,EAAE,CAAC,SAAiB,EAAE,EAAE,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,CAAU;CACtF,CAAC","sourcesContent":["/**\n * query/keys.ts — typed query-key factory for the checkout module.\n */\nexport const checkoutKeys = {\n  all: ['checkout'] as const,\n  status: (cartBiId: string) => ['checkout', 'status', cartBiId] as const,\n  clientSecret: (subscriptionId: string) => ['checkout', 'clientSecret', subscriptionId] as const,\n  subscriptionId: (cartBiId: string) => ['checkout', 'subscriptionId', cartBiId] as const,\n  customer: (userEmail: string) => ['checkout', 'customer', userEmail] as const,\n  salable: (maId: string) => ['checkout', 'salable', maId] as const,\n  billingPlans: () => ['checkout', 'billingPlans'] as const,\n  viaxSession: () => ['checkout', 'viaxSession'] as const,\n  courseDetail: (courseKey: string) => ['checkout', 'courseDetail', courseKey] as const,\n};\n"]}

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

@@ -0,0 +1,57 @@
+import type { Ref } from 'react';
+import type { BillingCycle } from '../../types';
+import type { Status, Phase, BillingInfo, BillingPlan, CheckoutConsent } from '../../types';
+export interface UseCheckoutOptions {
+    apiUrl?: string;
+    edxSessionUrl?: string;
+    stripePublishableKey?: string;
+    onComplete?: (subscriptionBiId: string | null) => void;
+    /** Country code resolved by CheckoutGate — used to show/hide the UK/CA extra checkbox. */
+    userCountry?: string | null;
+    /**
+     * Course run key from the URL (e.g. course-v1:HarvardX+CS50+X).
+     * When omitted, read from ?course_run_key=.
+     */
+    courseRunKey?: string | null;
+}
+export interface UseCheckoutResult {
+    phase: Phase;
+    status: Status | null;
+    statusLabel: string;
+    stripeReady: boolean;
+    /** True once the Stripe card Element iframe is fully initialised and interactive. */
+    cardReady: boolean;
+    notConfigured: boolean;
+    showBanner: boolean;
+    dismissBanner: () => void;
+    error: string;
+    clearError: () => void;
+    cardError: string;
+    lastComment: string;
+    /** Full subscription details including card last 4 — available after SUBSCRIPTION_CREATED. */
+    subscriptionDetails: import('../../types').SubscriptionDetails | null;
+    billing: BillingInfo;
+    setField: (field: keyof BillingInfo, value: string) => void;
+    numberMountRef: Ref<HTMLDivElement>;
+    expiryMountRef: Ref<HTMLDivElement>;
+    cvcMountRef: Ref<HTMLDivElement>;
+    submitting: boolean;
+    /** True from Place order click until a terminal status is reached. */
+    processingSubscription: boolean;
+    placeOrder: (consent: CheckoutConsent) => void;
+    /** Billing plans fetched on mount — includes prices for display in CartSummary. */
+    billingPlans: BillingPlan[];
+    /** Live active subscriber count for display in CartSummary. */
+    activeSubscriberCount: number | null;
+    /** Currently selected billing cycle. */
+    selectedCycle: BillingCycle;
+    /** Switch between monthly and annual billing. */
+    setCycle: (cycle: BillingCycle) => void;
+    /** True once GET /edx-session has returned and the viax token is set. */
+    sessionReady: boolean;
+    /** ISO 3166-1 alpha-2 country code — passed in from CheckoutGate for the UK/CA checkbox. */
+    userCountry: string | null;
+    /** Course details when arrived via ?course_run_key=; null for standard checkout. */
+    course: import('../../types').CourseDetail | null;
+}
+export default function useCheckout(options?: UseCheckoutOptions): UseCheckoutResult;

package/dist/data/hooks/useCheckout.js

@@ -0,0 +1,249 @@
+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 { useCallback, useEffect, useMemo, useRef, useState, } from 'react';
+import { createCheckoutClient } from '../../utils/checkout';
+import { loadStripe } from '../../utils/stripe';
+import { STATUS, STATUS_LABELS, STRIPE_ELEMENT_OPTS, phaseFor, DEFAULTS, } from '../../constants';
+import { useCartStatusQuery, useSubscriptionIdQuery, useBillingPlansQuery, useActiveSubscriptionsQuery, useViaxSessionQuery, useCourseDetailQuery, } from './useCheckoutQueries';
+import { useCheckoutMutations } from './useCheckoutMutations';
+/**
+ * Read ?course_run_key= from the current URL.
+ * Avoid URLSearchParams — it treats bare `+` as a space, which would turn
+ * HarvardX+CS50+X into "HarvardX CS50 X". decodeURIComponent keeps `+` intact.
+ */
+function getCourseRunKeyFromUrl() {
+    if (typeof window === 'undefined')
+        return null;
+    const match = /[?&]course_run_key=([^&]*)/.exec(window.location.search);
+    if (!match)
+        return null;
+    try {
+        // Preserve literal `+` (treat as %2B) then decode %XX sequences.
+        return decodeURIComponent(match[1].replace(/\+/g, '%2B')).trim() || null;
+    }
+    catch (_a) {
+        return match[1].trim() || null;
+    }
+}
+export default function useCheckout(options = {}) {
+    var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m;
+    const { apiUrl = DEFAULTS.apiUrl, edxSessionUrl, stripePublishableKey, onComplete, userCountry = null, courseRunKey: courseRunKeyProp, } = options;
+    const courseRunKey = useMemo(() => courseRunKeyProp !== null && courseRunKeyProp !== void 0 ? courseRunKeyProp : getCourseRunKeyFromUrl(), [courseRunKeyProp]);
+    const client = useMemo(() => {
+        if (!apiUrl)
+            return null;
+        return createCheckoutClient({ apiUrl });
+    }, [apiUrl]);
+    const notConfigured = !client || !stripePublishableKey || !edxSessionUrl;
+    // Exchange edX session for viax token on page load.
+    const sessionQuery = useViaxSessionQuery(notConfigured ? null : edxSessionUrl);
+    const sessionReady = !!sessionQuery.data;
+    useEffect(() => {
+        if (sessionQuery.data && client) {
+            client.setToken(sessionQuery.data.viaxToken);
+        }
+    }, [sessionQuery.data, client]);
+    // Fetch billing plans, subscriber count, and optional course once the viax session is ready.
+    const billingPlansQuery = useBillingPlansQuery(client, sessionReady);
+    const activeSubscriptionsQuery = useActiveSubscriptionsQuery(client, sessionReady);
+    const courseDetailQuery = useCourseDetailQuery(client, sessionReady, courseRunKey);
+    // --- state ---
+    const [showBanner, setShowBanner] = useState(true);
+    const [cart, setCart] = useState(null);
+    const [stripe, setStripe] = useState(null);
+    const [stripeReady, setStripeReady] = useState(false);
+    const [cardReady, setCardReady] = useState(false);
+    const [error, setError] = useState('');
+    const [cardError, setCardError] = useState('');
+    const [billing, setBilling] = useState({
+        firstName: '', lastName: '', city: '', zip: '', country: 'US', line1: '', state: '',
+    });
+    const [selectedCycle, setSelectedCycle] = useState('monthly');
+    const [processingSubscription, setProcessingSubscription] = useState(false);
+    useEffect(() => {
+        if (sessionQuery.error) {
+            setError(sessionQuery.error.message);
+        }
+    }, [sessionQuery.error]);
+    const setField = useCallback((field, value) => setBilling((p) => (Object.assign(Object.assign({}, p), { [field]: value }))), []);
+    // --- refs ---
+    // Stripe instances — written inside useEffect and mutations.
+    const stripeInstanceRef = useRef(null);
+    const cardNumberElementRef = useRef(null);
+    const elementsRef = useRef(null);
+    const elementsMountedRef = useRef(false);
+    // DOM mount targets — passed as ref={} to the Stripe Element host divs.
+    const numberMountRef = useRef(null);
+    const expiryMountRef = useRef(null);
+    const cvcMountRef = useRef(null);
+    const mountedRef = useRef(true);
+    const completedRef = useRef(false);
+    const sessionRef = useRef(null);
+    useEffect(() => {
+        var _a;
+        sessionRef.current = (_a = sessionQuery.data) !== null && _a !== void 0 ? _a : null;
+    }, [sessionQuery.data]);
+    // Mirror state into refs so mutations can read current values without stale closures.
+    const cartRef = useRef(null);
+    const billingRef = useRef(billing);
+    useEffect(() => {
+        cartRef.current = cart;
+    }, [cart]);
+    useEffect(() => {
+        billingRef.current = billing;
+    }, [billing]);
+    useEffect(() => {
+        stripeInstanceRef.current = stripe;
+    }, [stripe]);
+    // --- server state ---
+    const statusQuery = useCartStatusQuery(client, (_a = cart === null || cart === void 0 ? void 0 : cart.biId) !== null && _a !== void 0 ? _a : null);
+    const status = (_c = (_b = statusQuery.data) === null || _b === void 0 ? void 0 : _b.status) !== null && _c !== void 0 ? _c : null;
+    const lastComment = (_e = (_d = statusQuery.data) === null || _d === void 0 ? void 0 : _d.lastComment) !== null && _e !== void 0 ? _e : '';
+    // Phase is 'ready' until a cart exists, then driven by bpStatus.
+    const phase = cart ? phaseFor(status, status === STATUS.IN_CART) : 'ready';
+    const subscriptionIdQuery = useSubscriptionIdQuery(client, (_f = cart === null || cart === void 0 ? void 0 : cart.biId) !== null && _f !== void 0 ? _f : null, status === STATUS.SUBSCRIPTION_CREATED);
+    // --- mutations ---
+    const { placeOrder: placeMutation } = useCheckoutMutations({
+        client,
+        sessionRef,
+        stripeRef: stripeInstanceRef,
+        cardNumberElRef: cardNumberElementRef,
+        billingRef,
+        setError: (msg) => {
+            setProcessingSubscription(false);
+            setError(msg);
+        },
+        setCardError: (msg) => {
+            setProcessingSubscription(false);
+            setCardError(msg);
+        },
+        onCartCreated: (created) => {
+            // Sync the ref immediately so any same-tick readers see the cart
+            // before the setCart → useEffect mirror runs.
+            cartRef.current = created;
+            if (mountedRef.current)
+                setCart(created);
+        },
+    });
+    // --- load Stripe.js on mount ---
+    useEffect(() => {
+        mountedRef.current = true;
+        if (!stripePublishableKey)
+            return undefined;
+        (() => __awaiter(this, void 0, void 0, function* () {
+            try {
+                const instance = yield loadStripe(stripePublishableKey);
+                if (mountedRef.current) {
+                    setStripe(instance);
+                    setStripeReady(true);
+                }
+            }
+            catch (e) {
+                if (mountedRef.current)
+                    setError(e.message);
+            }
+        }))();
+        return () => {
+            mountedRef.current = false;
+        };
+    }, [stripePublishableKey]);
+    // --- mount Stripe Elements once Stripe is loaded ---
+    useEffect(() => {
+        if (!stripe)
+            return;
+        if (!numberMountRef.current || !expiryMountRef.current || !cvcMountRef.current)
+            return;
+        // Hard guard — never recreate elements once mounted, even if stripe reference changes.
+        if (elementsMountedRef.current)
+            return;
+        elementsMountedRef.current = true;
+        setCardReady(false);
+        const elements = stripe.elements();
+        elementsRef.current = elements;
+        const number = elements.create('cardNumber', Object.assign(Object.assign({}, STRIPE_ELEMENT_OPTS), { showIcon: true }));
+        const expiry = elements.create('cardExpiry', STRIPE_ELEMENT_OPTS);
+        const cvc = elements.create('cardCvc', STRIPE_ELEMENT_OPTS);
+        number.mount(numberMountRef.current);
+        expiry.mount(expiryMountRef.current);
+        cvc.mount(cvcMountRef.current);
+        number.on('ready', () => {
+            if (mountedRef.current)
+                setCardReady(true);
+        });
+        number.on('change', (e) => {
+            var _a;
+            if (mountedRef.current)
+                setCardError(((_a = e.error) === null || _a === void 0 ? void 0 : _a.message) || '');
+        });
+        cardNumberElementRef.current = number;
+    }, [stripe]);
+    // --- on success ---
+    useEffect(() => {
+        var _a, _b;
+        if (status !== STATUS.SUBSCRIPTION_CREATED || completedRef.current)
+            return;
+        completedRef.current = true;
+        if (onComplete)
+            onComplete((_b = (_a = subscriptionIdQuery.data) === null || _a === void 0 ? void 0 : _a.biId) !== null && _b !== void 0 ? _b : null);
+    }, [status, subscriptionIdQuery.data, onComplete]);
+    // --- actions ---
+    const placeOrder = useCallback((consent) => {
+        setError('');
+        setCardError('');
+        if (phase === 'failed')
+            setCart(null);
+        setProcessingSubscription(true);
+        placeMutation.mutate(consent);
+    }, [placeMutation, phase]);
+    // Turn off processingSubscription once we reach a terminal status.
+    useEffect(() => {
+        if (!status)
+            return;
+        const terminalStatuses = [
+            STATUS.SUBSCRIPTION_CREATED,
+            STATUS.STRIPE_FAIL,
+            STATUS.SANCTION_BLOCK,
+        ];
+        if (terminalStatuses.includes(status)) {
+            setProcessingSubscription(false);
+        }
+    }, [status]);
+    return {
+        phase,
+        status,
+        statusLabel: (status && STATUS_LABELS[status]) || 'Processing your order…',
+        stripeReady,
+        cardReady,
+        notConfigured,
+        showBanner,
+        dismissBanner: () => setShowBanner(false),
+        error,
+        clearError: () => setError(''),
+        cardError,
+        lastComment,
+        subscriptionDetails: (_g = subscriptionIdQuery.data) !== null && _g !== void 0 ? _g : null,
+        billing,
+        setField,
+        numberMountRef,
+        expiryMountRef,
+        cvcMountRef,
+        submitting: placeMutation.isPending,
+        processingSubscription,
+        placeOrder,
+        billingPlans: (_j = (_h = billingPlansQuery.data) === null || _h === void 0 ? void 0 : _h.plans) !== null && _j !== void 0 ? _j : [],
+        activeSubscriberCount: (_l = (_k = activeSubscriptionsQuery.data) === null || _k === void 0 ? void 0 : _k.active) !== null && _l !== void 0 ? _l : null,
+        selectedCycle,
+        setCycle: setSelectedCycle,
+        sessionReady,
+        userCountry,
+        course: (_m = courseDetailQuery.data) !== null && _m !== void 0 ? _m : null,
+    };
+}
+//# sourceMappingURL=useCheckout.js.map