@mj-biz-apps/orders-entities 5.23.1 → 5.25.0

package/dist/billing-location.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Billing location — the facts a sale needs to be placed in a taxing jurisdiction.
+ *
+ * A card sale taken with no location can never be assigned to a state or country afterwards, so
+ * the self-serve checkout refuses to take payment without one. Country is ISO 3166-1 alpha-2;
+ * the region is the ISO 3166-2 subdivision code WITHOUT its country prefix (`IL`, not `US-IL`),
+ * because that is the form `TaxJurisdiction.RegionCode` holds and jurisdiction matching compares
+ * the two directly.
+ *
+ * The lists live here, beside the entities, so the widget's pickers and the server's check read
+ * the same data and cannot disagree about what a valid location is.
+ *
+ * @module @mj-biz-apps/orders-entities/billing-location
+ */
+/** A country or subdivision as a picker shows it. */
+export interface LocationOption {
+    Code: string;
+    Name: string;
+}
+/** A location that passed {@link CheckBillingLocation}, normalised to upper-case codes. */
+export interface BillingLocation {
+    Country: string;
+    StateProvince: string | null;
+    PostalCode: string | null;
+}
+export type BillingLocationCheck = {
+    Valid: true;
+    Location: BillingLocation;
+} | {
+    Valid: false;
+    Reason: string;
+};
+/** ISO 3166-1 alpha-2, by English short name. */
+export declare const BILLING_COUNTRIES: ReadonlyArray<LocationOption>;
+/** ISO 3166-2 subdivisions, country prefix removed. Only the countries that require one are listed. */
+export declare const BILLING_SUBDIVISIONS: Readonly<Record<string, ReadonlyArray<LocationOption>>>;
+/** The subdivisions to offer for a country — empty when the country does not require one. */
+export declare function BillingSubdivisionsFor(countryCode: string | null | undefined): ReadonlyArray<LocationOption>;
+/** True when the country's sales cannot be placed without a state or province. */
+export declare function BillingSubdivisionRequired(countryCode: string | null | undefined): boolean;
+/** True when the country's postal code is required, and so shape-checked. */
+export declare function BillingPostalCodeRequired(countryCode: string | null | undefined): boolean;
+/**
+ * Check a caller-supplied location and normalise it.
+ *
+ * Accepts only codes from the lists above: a free-text region such as "Illinois" is refused,
+ * because a name cannot be matched to a jurisdiction and a mistyped one would silently match none.
+ */
+export declare function CheckBillingLocation(input: unknown): BillingLocationCheck;
+//# sourceMappingURL=billing-location.d.ts.map

package/dist/billing-location.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-location.d.ts","sourceRoot":"","sources":["../src/billing-location.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,qDAAqD;AACrD,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,2FAA2F;AAC3F,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC7B;AAED,MAAM,MAAM,oBAAoB,GAC1B;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,eAAe,CAAA;CAAE,GAC1C;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEvC,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,EAAE,aAAa,CAAC,cAAc,CA0P3D,CAAC;AAEF,uGAAuG;AACvG,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC,CAqFxF,CAAC;AAcF,6FAA6F;AAC7F,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,aAAa,CAAC,cAAc,CAAC,CAE5G;AAED,kFAAkF;AAClF,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAE1F;AAED,6EAA6E;AAC7E,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAEzF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,oBAAoB,CAoBzE"}

package/dist/billing-location.js

@@ -0,0 +1,439 @@
+/**
+ * Billing location — the facts a sale needs to be placed in a taxing jurisdiction.
+ *
+ * A card sale taken with no location can never be assigned to a state or country afterwards, so
+ * the self-serve checkout refuses to take payment without one. Country is ISO 3166-1 alpha-2;
+ * the region is the ISO 3166-2 subdivision code WITHOUT its country prefix (`IL`, not `US-IL`),
+ * because that is the form `TaxJurisdiction.RegionCode` holds and jurisdiction matching compares
+ * the two directly.
+ *
+ * The lists live here, beside the entities, so the widget's pickers and the server's check read
+ * the same data and cannot disagree about what a valid location is.
+ *
+ * @module @mj-biz-apps/orders-entities/billing-location
+ */
+/** ISO 3166-1 alpha-2, by English short name. */
+export const BILLING_COUNTRIES = [
+    { Code: 'AF', Name: 'Afghanistan' },
+    { Code: 'AX', Name: 'Åland Islands' },
+    { Code: 'AL', Name: 'Albania' },
+    { Code: 'DZ', Name: 'Algeria' },
+    { Code: 'AS', Name: 'American Samoa' },
+    { Code: 'AD', Name: 'Andorra' },
+    { Code: 'AO', Name: 'Angola' },
+    { Code: 'AI', Name: 'Anguilla' },
+    { Code: 'AQ', Name: 'Antarctica' },
+    { Code: 'AG', Name: 'Antigua and Barbuda' },
+    { Code: 'AR', Name: 'Argentina' },
+    { Code: 'AM', Name: 'Armenia' },
+    { Code: 'AW', Name: 'Aruba' },
+    { Code: 'AU', Name: 'Australia' },
+    { Code: 'AT', Name: 'Austria' },
+    { Code: 'AZ', Name: 'Azerbaijan' },
+    { Code: 'BS', Name: 'Bahamas' },
+    { Code: 'BH', Name: 'Bahrain' },
+    { Code: 'BD', Name: 'Bangladesh' },
+    { Code: 'BB', Name: 'Barbados' },
+    { Code: 'BY', Name: 'Belarus' },
+    { Code: 'BE', Name: 'Belgium' },
+    { Code: 'BZ', Name: 'Belize' },
+    { Code: 'BJ', Name: 'Benin' },
+    { Code: 'BM', Name: 'Bermuda' },
+    { Code: 'BT', Name: 'Bhutan' },
+    { Code: 'BO', Name: 'Bolivia' },
+    { Code: 'BQ', Name: 'Bonaire, Sint Eustatius and Saba' },
+    { Code: 'BA', Name: 'Bosnia and Herzegovina' },
+    { Code: 'BW', Name: 'Botswana' },
+    { Code: 'BV', Name: 'Bouvet Island' },
+    { Code: 'BR', Name: 'Brazil' },
+    { Code: 'IO', Name: 'British Indian Ocean Territory' },
+    { Code: 'BN', Name: 'Brunei Darussalam' },
+    { Code: 'BG', Name: 'Bulgaria' },
+    { Code: 'BF', Name: 'Burkina Faso' },
+    { Code: 'BI', Name: 'Burundi' },
+    { Code: 'CV', Name: 'Cabo Verde' },
+    { Code: 'KH', Name: 'Cambodia' },
+    { Code: 'CM', Name: 'Cameroon' },
+    { Code: 'CA', Name: 'Canada' },
+    { Code: 'KY', Name: 'Cayman Islands' },
+    { Code: 'CF', Name: 'Central African Republic' },
+    { Code: 'TD', Name: 'Chad' },
+    { Code: 'CL', Name: 'Chile' },
+    { Code: 'CN', Name: 'China' },
+    { Code: 'CX', Name: 'Christmas Island' },
+    { Code: 'CC', Name: 'Cocos (Keeling) Islands' },
+    { Code: 'CO', Name: 'Colombia' },
+    { Code: 'KM', Name: 'Comoros' },
+    { Code: 'CG', Name: 'Congo' },
+    { Code: 'CD', Name: 'Congo, Democratic Republic of the' },
+    { Code: 'CK', Name: 'Cook Islands' },
+    { Code: 'CR', Name: 'Costa Rica' },
+    { Code: 'CI', Name: "Côte d'Ivoire" },
+    { Code: 'HR', Name: 'Croatia' },
+    { Code: 'CU', Name: 'Cuba' },
+    { Code: 'CW', Name: 'Curaçao' },
+    { Code: 'CY', Name: 'Cyprus' },
+    { Code: 'CZ', Name: 'Czechia' },
+    { Code: 'DK', Name: 'Denmark' },
+    { Code: 'DJ', Name: 'Djibouti' },
+    { Code: 'DM', Name: 'Dominica' },
+    { Code: 'DO', Name: 'Dominican Republic' },
+    { Code: 'EC', Name: 'Ecuador' },
+    { Code: 'EG', Name: 'Egypt' },
+    { Code: 'SV', Name: 'El Salvador' },
+    { Code: 'GQ', Name: 'Equatorial Guinea' },
+    { Code: 'ER', Name: 'Eritrea' },
+    { Code: 'EE', Name: 'Estonia' },
+    { Code: 'SZ', Name: 'Eswatini' },
+    { Code: 'ET', Name: 'Ethiopia' },
+    { Code: 'FK', Name: 'Falkland Islands (Malvinas)' },
+    { Code: 'FO', Name: 'Faroe Islands' },
+    { Code: 'FJ', Name: 'Fiji' },
+    { Code: 'FI', Name: 'Finland' },
+    { Code: 'FR', Name: 'France' },
+    { Code: 'GF', Name: 'French Guiana' },
+    { Code: 'PF', Name: 'French Polynesia' },
+    { Code: 'TF', Name: 'French Southern Territories' },
+    { Code: 'GA', Name: 'Gabon' },
+    { Code: 'GM', Name: 'Gambia' },
+    { Code: 'GE', Name: 'Georgia' },
+    { Code: 'DE', Name: 'Germany' },
+    { Code: 'GH', Name: 'Ghana' },
+    { Code: 'GI', Name: 'Gibraltar' },
+    { Code: 'GR', Name: 'Greece' },
+    { Code: 'GL', Name: 'Greenland' },
+    { Code: 'GD', Name: 'Grenada' },
+    { Code: 'GP', Name: 'Guadeloupe' },
+    { Code: 'GU', Name: 'Guam' },
+    { Code: 'GT', Name: 'Guatemala' },
+    { Code: 'GG', Name: 'Guernsey' },
+    { Code: 'GN', Name: 'Guinea' },
+    { Code: 'GW', Name: 'Guinea-Bissau' },
+    { Code: 'GY', Name: 'Guyana' },
+    { Code: 'HT', Name: 'Haiti' },
+    { Code: 'HM', Name: 'Heard Island and McDonald Islands' },
+    { Code: 'VA', Name: 'Holy See' },
+    { Code: 'HN', Name: 'Honduras' },
+    { Code: 'HK', Name: 'Hong Kong' },
+    { Code: 'HU', Name: 'Hungary' },
+    { Code: 'IS', Name: 'Iceland' },
+    { Code: 'IN', Name: 'India' },
+    { Code: 'ID', Name: 'Indonesia' },
+    { Code: 'IR', Name: 'Iran' },
+    { Code: 'IQ', Name: 'Iraq' },
+    { Code: 'IE', Name: 'Ireland' },
+    { Code: 'IM', Name: 'Isle of Man' },
+    { Code: 'IL', Name: 'Israel' },
+    { Code: 'IT', Name: 'Italy' },
+    { Code: 'JM', Name: 'Jamaica' },
+    { Code: 'JP', Name: 'Japan' },
+    { Code: 'JE', Name: 'Jersey' },
+    { Code: 'JO', Name: 'Jordan' },
+    { Code: 'KZ', Name: 'Kazakhstan' },
+    { Code: 'KE', Name: 'Kenya' },
+    { Code: 'KI', Name: 'Kiribati' },
+    { Code: 'KP', Name: 'Korea, Democratic People\'s Republic of' },
+    { Code: 'KR', Name: 'Korea, Republic of' },
+    { Code: 'KW', Name: 'Kuwait' },
+    { Code: 'KG', Name: 'Kyrgyzstan' },
+    { Code: 'LA', Name: "Lao People's Democratic Republic" },
+    { Code: 'LV', Name: 'Latvia' },
+    { Code: 'LB', Name: 'Lebanon' },
+    { Code: 'LS', Name: 'Lesotho' },
+    { Code: 'LR', Name: 'Liberia' },
+    { Code: 'LY', Name: 'Libya' },
+    { Code: 'LI', Name: 'Liechtenstein' },
+    { Code: 'LT', Name: 'Lithuania' },
+    { Code: 'LU', Name: 'Luxembourg' },
+    { Code: 'MO', Name: 'Macao' },
+    { Code: 'MG', Name: 'Madagascar' },
+    { Code: 'MW', Name: 'Malawi' },
+    { Code: 'MY', Name: 'Malaysia' },
+    { Code: 'MV', Name: 'Maldives' },
+    { Code: 'ML', Name: 'Mali' },
+    { Code: 'MT', Name: 'Malta' },
+    { Code: 'MH', Name: 'Marshall Islands' },
+    { Code: 'MQ', Name: 'Martinique' },
+    { Code: 'MR', Name: 'Mauritania' },
+    { Code: 'MU', Name: 'Mauritius' },
+    { Code: 'YT', Name: 'Mayotte' },
+    { Code: 'MX', Name: 'Mexico' },
+    { Code: 'FM', Name: 'Micronesia' },
+    { Code: 'MD', Name: 'Moldova' },
+    { Code: 'MC', Name: 'Monaco' },
+    { Code: 'MN', Name: 'Mongolia' },
+    { Code: 'ME', Name: 'Montenegro' },
+    { Code: 'MS', Name: 'Montserrat' },
+    { Code: 'MA', Name: 'Morocco' },
+    { Code: 'MZ', Name: 'Mozambique' },
+    { Code: 'MM', Name: 'Myanmar' },
+    { Code: 'NA', Name: 'Namibia' },
+    { Code: 'NR', Name: 'Nauru' },
+    { Code: 'NP', Name: 'Nepal' },
+    { Code: 'NL', Name: 'Netherlands' },
+    { Code: 'NC', Name: 'New Caledonia' },
+    { Code: 'NZ', Name: 'New Zealand' },
+    { Code: 'NI', Name: 'Nicaragua' },
+    { Code: 'NE', Name: 'Niger' },
+    { Code: 'NG', Name: 'Nigeria' },
+    { Code: 'NU', Name: 'Niue' },
+    { Code: 'NF', Name: 'Norfolk Island' },
+    { Code: 'MK', Name: 'North Macedonia' },
+    { Code: 'MP', Name: 'Northern Mariana Islands' },
+    { Code: 'NO', Name: 'Norway' },
+    { Code: 'OM', Name: 'Oman' },
+    { Code: 'PK', Name: 'Pakistan' },
+    { Code: 'PW', Name: 'Palau' },
+    { Code: 'PS', Name: 'Palestine, State of' },
+    { Code: 'PA', Name: 'Panama' },
+    { Code: 'PG', Name: 'Papua New Guinea' },
+    { Code: 'PY', Name: 'Paraguay' },
+    { Code: 'PE', Name: 'Peru' },
+    { Code: 'PH', Name: 'Philippines' },
+    { Code: 'PN', Name: 'Pitcairn' },
+    { Code: 'PL', Name: 'Poland' },
+    { Code: 'PT', Name: 'Portugal' },
+    { Code: 'PR', Name: 'Puerto Rico' },
+    { Code: 'QA', Name: 'Qatar' },
+    { Code: 'RE', Name: 'Réunion' },
+    { Code: 'RO', Name: 'Romania' },
+    { Code: 'RU', Name: 'Russian Federation' },
+    { Code: 'RW', Name: 'Rwanda' },
+    { Code: 'BL', Name: 'Saint Barthélemy' },
+    { Code: 'SH', Name: 'Saint Helena, Ascension and Tristan da Cunha' },
+    { Code: 'KN', Name: 'Saint Kitts and Nevis' },
+    { Code: 'LC', Name: 'Saint Lucia' },
+    { Code: 'MF', Name: 'Saint Martin (French part)' },
+    { Code: 'PM', Name: 'Saint Pierre and Miquelon' },
+    { Code: 'VC', Name: 'Saint Vincent and the Grenadines' },
+    { Code: 'WS', Name: 'Samoa' },
+    { Code: 'SM', Name: 'San Marino' },
+    { Code: 'ST', Name: 'Sao Tome and Principe' },
+    { Code: 'SA', Name: 'Saudi Arabia' },
+    { Code: 'SN', Name: 'Senegal' },
+    { Code: 'RS', Name: 'Serbia' },
+    { Code: 'SC', Name: 'Seychelles' },
+    { Code: 'SL', Name: 'Sierra Leone' },
+    { Code: 'SG', Name: 'Singapore' },
+    { Code: 'SX', Name: 'Sint Maarten (Dutch part)' },
+    { Code: 'SK', Name: 'Slovakia' },
+    { Code: 'SI', Name: 'Slovenia' },
+    { Code: 'SB', Name: 'Solomon Islands' },
+    { Code: 'SO', Name: 'Somalia' },
+    { Code: 'ZA', Name: 'South Africa' },
+    { Code: 'GS', Name: 'South Georgia and the South Sandwich Islands' },
+    { Code: 'SS', Name: 'South Sudan' },
+    { Code: 'ES', Name: 'Spain' },
+    { Code: 'LK', Name: 'Sri Lanka' },
+    { Code: 'SD', Name: 'Sudan' },
+    { Code: 'SR', Name: 'Suriname' },
+    { Code: 'SJ', Name: 'Svalbard and Jan Mayen' },
+    { Code: 'SE', Name: 'Sweden' },
+    { Code: 'CH', Name: 'Switzerland' },
+    { Code: 'SY', Name: 'Syrian Arab Republic' },
+    { Code: 'TW', Name: 'Taiwan' },
+    { Code: 'TJ', Name: 'Tajikistan' },
+    { Code: 'TZ', Name: 'Tanzania' },
+    { Code: 'TH', Name: 'Thailand' },
+    { Code: 'TL', Name: 'Timor-Leste' },
+    { Code: 'TG', Name: 'Togo' },
+    { Code: 'TK', Name: 'Tokelau' },
+    { Code: 'TO', Name: 'Tonga' },
+    { Code: 'TT', Name: 'Trinidad and Tobago' },
+    { Code: 'TN', Name: 'Tunisia' },
+    { Code: 'TR', Name: 'Türkiye' },
+    { Code: 'TM', Name: 'Turkmenistan' },
+    { Code: 'TC', Name: 'Turks and Caicos Islands' },
+    { Code: 'TV', Name: 'Tuvalu' },
+    { Code: 'UG', Name: 'Uganda' },
+    { Code: 'UA', Name: 'Ukraine' },
+    { Code: 'AE', Name: 'United Arab Emirates' },
+    { Code: 'GB', Name: 'United Kingdom' },
+    { Code: 'US', Name: 'United States' },
+    { Code: 'UM', Name: 'United States Minor Outlying Islands' },
+    { Code: 'UY', Name: 'Uruguay' },
+    { Code: 'UZ', Name: 'Uzbekistan' },
+    { Code: 'VU', Name: 'Vanuatu' },
+    { Code: 'VE', Name: 'Venezuela' },
+    { Code: 'VN', Name: 'Viet Nam' },
+    { Code: 'VG', Name: 'Virgin Islands (British)' },
+    { Code: 'VI', Name: 'Virgin Islands (U.S.)' },
+    { Code: 'WF', Name: 'Wallis and Futuna' },
+    { Code: 'EH', Name: 'Western Sahara' },
+    { Code: 'YE', Name: 'Yemen' },
+    { Code: 'ZM', Name: 'Zambia' },
+    { Code: 'ZW', Name: 'Zimbabwe' },
+];
+/** ISO 3166-2 subdivisions, country prefix removed. Only the countries that require one are listed. */
+export const BILLING_SUBDIVISIONS = {
+    US: [
+        { Code: 'AL', Name: 'Alabama' },
+        { Code: 'AK', Name: 'Alaska' },
+        { Code: 'AS', Name: 'American Samoa' },
+        { Code: 'AZ', Name: 'Arizona' },
+        { Code: 'AR', Name: 'Arkansas' },
+        { Code: 'CA', Name: 'California' },
+        { Code: 'CO', Name: 'Colorado' },
+        { Code: 'CT', Name: 'Connecticut' },
+        { Code: 'DE', Name: 'Delaware' },
+        { Code: 'DC', Name: 'District of Columbia' },
+        { Code: 'FL', Name: 'Florida' },
+        { Code: 'GA', Name: 'Georgia' },
+        { Code: 'GU', Name: 'Guam' },
+        { Code: 'HI', Name: 'Hawaii' },
+        { Code: 'ID', Name: 'Idaho' },
+        { Code: 'IL', Name: 'Illinois' },
+        { Code: 'IN', Name: 'Indiana' },
+        { Code: 'IA', Name: 'Iowa' },
+        { Code: 'KS', Name: 'Kansas' },
+        { Code: 'KY', Name: 'Kentucky' },
+        { Code: 'LA', Name: 'Louisiana' },
+        { Code: 'ME', Name: 'Maine' },
+        { Code: 'MD', Name: 'Maryland' },
+        { Code: 'MA', Name: 'Massachusetts' },
+        { Code: 'MI', Name: 'Michigan' },
+        { Code: 'MN', Name: 'Minnesota' },
+        { Code: 'MS', Name: 'Mississippi' },
+        { Code: 'MO', Name: 'Missouri' },
+        { Code: 'MT', Name: 'Montana' },
+        { Code: 'NE', Name: 'Nebraska' },
+        { Code: 'NV', Name: 'Nevada' },
+        { Code: 'NH', Name: 'New Hampshire' },
+        { Code: 'NJ', Name: 'New Jersey' },
+        { Code: 'NM', Name: 'New Mexico' },
+        { Code: 'NY', Name: 'New York' },
+        { Code: 'NC', Name: 'North Carolina' },
+        { Code: 'ND', Name: 'North Dakota' },
+        { Code: 'MP', Name: 'Northern Mariana Islands' },
+        { Code: 'OH', Name: 'Ohio' },
+        { Code: 'OK', Name: 'Oklahoma' },
+        { Code: 'OR', Name: 'Oregon' },
+        { Code: 'PA', Name: 'Pennsylvania' },
+        { Code: 'PR', Name: 'Puerto Rico' },
+        { Code: 'RI', Name: 'Rhode Island' },
+        { Code: 'SC', Name: 'South Carolina' },
+        { Code: 'SD', Name: 'South Dakota' },
+        { Code: 'TN', Name: 'Tennessee' },
+        { Code: 'TX', Name: 'Texas' },
+        { Code: 'UM', Name: 'United States Minor Outlying Islands' },
+        { Code: 'UT', Name: 'Utah' },
+        { Code: 'VT', Name: 'Vermont' },
+        { Code: 'VI', Name: 'Virgin Islands, U.S.' },
+        { Code: 'VA', Name: 'Virginia' },
+        { Code: 'WA', Name: 'Washington' },
+        { Code: 'WV', Name: 'West Virginia' },
+        { Code: 'WI', Name: 'Wisconsin' },
+        { Code: 'WY', Name: 'Wyoming' },
+    ],
+    CA: [
+        { Code: 'AB', Name: 'Alberta' },
+        { Code: 'BC', Name: 'British Columbia' },
+        { Code: 'MB', Name: 'Manitoba' },
+        { Code: 'NB', Name: 'New Brunswick' },
+        { Code: 'NL', Name: 'Newfoundland and Labrador' },
+        { Code: 'NT', Name: 'Northwest Territories' },
+        { Code: 'NS', Name: 'Nova Scotia' },
+        { Code: 'NU', Name: 'Nunavut' },
+        { Code: 'ON', Name: 'Ontario' },
+        { Code: 'PE', Name: 'Prince Edward Island' },
+        { Code: 'QC', Name: 'Quebec' },
+        { Code: 'SK', Name: 'Saskatchewan' },
+        { Code: 'YT', Name: 'Yukon' },
+    ],
+    AU: [
+        { Code: 'ACT', Name: 'Australian Capital Territory' },
+        { Code: 'NSW', Name: 'New South Wales' },
+        { Code: 'NT', Name: 'Northern Territory' },
+        { Code: 'QLD', Name: 'Queensland' },
+        { Code: 'SA', Name: 'South Australia' },
+        { Code: 'TAS', Name: 'Tasmania' },
+        { Code: 'VIC', Name: 'Victoria' },
+        { Code: 'WA', Name: 'Western Australia' },
+    ],
+};
+/** Postal-code shape for the countries that require one. Elsewhere a postal code is optional. */
+const REQUIRED_POSTAL_PATTERNS = {
+    US: /^\d{5}(-\d{4})?$/,
+    CA: /^[A-Z]\d[A-Z] ?\d[A-Z]\d$/,
+    AU: /^\d{4}$/,
+};
+/** Matches `Address.PostalCode NVARCHAR(20)`. */
+const MAX_POSTAL_CODE_LENGTH = 20;
+const COUNTRY_CODES = new Set(BILLING_COUNTRIES.map((c) => c.Code));
+/** The subdivisions to offer for a country — empty when the country does not require one. */
+export function BillingSubdivisionsFor(countryCode) {
+    return BILLING_SUBDIVISIONS[(countryCode ?? '').trim().toUpperCase()] ?? [];
+}
+/** True when the country's sales cannot be placed without a state or province. */
+export function BillingSubdivisionRequired(countryCode) {
+    return BillingSubdivisionsFor(countryCode).length > 0;
+}
+/** True when the country's postal code is required, and so shape-checked. */
+export function BillingPostalCodeRequired(countryCode) {
+    return (countryCode ?? '').trim().toUpperCase() in REQUIRED_POSTAL_PATTERNS;
+}
+/**
+ * Check a caller-supplied location and normalise it.
+ *
+ * Accepts only codes from the lists above: a free-text region such as "Illinois" is refused,
+ * because a name cannot be matched to a jurisdiction and a mistyped one would silently match none.
+ */
+export function CheckBillingLocation(input) {
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        return { Valid: false, Reason: 'A billing country is required.' };
+    }
+    const raw = input;
+    const country = upperText(raw['Country']);
+    if (!country) {
+        return { Valid: false, Reason: 'A billing country is required.' };
+    }
+    if (!COUNTRY_CODES.has(country)) {
+        return { Valid: false, Reason: `'${country}' is not an ISO 3166-1 alpha-2 country code.` };
+    }
+    const region = checkRegion(country, upperText(raw['StateProvince']));
+    if (region.Valid === false)
+        return { Valid: false, Reason: region.Reason };
+    const postal = checkPostalCode(country, upperText(raw['PostalCode']));
+    if (postal.Valid === false)
+        return { Valid: false, Reason: postal.Reason };
+    return { Valid: true, Location: { Country: country, StateProvince: region.Value, PostalCode: postal.Value } };
+}
+function checkRegion(country, region) {
+    const options = BillingSubdivisionsFor(country);
+    if (options.length === 0) {
+        // No list for this country, so nothing a region could be checked against — it is not stored.
+        return { Valid: true, Value: null };
+    }
+    if (!region) {
+        return { Valid: false, Reason: `A state or province is required for ${country}.` };
+    }
+    // Tolerate the full ISO 3166-2 form ('US-IL') by removing the country prefix.
+    const code = region.startsWith(`${country}-`) ? region.slice(country.length + 1) : region;
+    if (!options.some((o) => o.Code === code)) {
+        return { Valid: false, Reason: `'${region}' is not a state or province code for ${country}.` };
+    }
+    return { Valid: true, Value: code };
+}
+function checkPostalCode(country, postal) {
+    const pattern = REQUIRED_POSTAL_PATTERNS[country];
+    if (!pattern) {
+        if (postal && postal.length > MAX_POSTAL_CODE_LENGTH) {
+            return { Valid: false, Reason: `A postal code may be at most ${MAX_POSTAL_CODE_LENGTH} characters.` };
+        }
+        return { Valid: true, Value: postal };
+    }
+    if (!postal) {
+        return { Valid: false, Reason: `A postal code is required for ${country}.` };
+    }
+    if (!pattern.test(postal)) {
+        return { Valid: false, Reason: `'${postal}' is not a valid postal code for ${country}.` };
+    }
+    return { Valid: true, Value: postal };
+}
+function upperText(value) {
+    if (typeof value !== 'string')
+        return null;
+    const trimmed = value.trim().toUpperCase();
+    return trimmed.length > 0 ? trimmed : null;
+}
+//# sourceMappingURL=billing-location.js.map

package/dist/billing-location.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"billing-location.js","sourceRoot":"","sources":["../src/billing-location.ts"],"names":[],"mappings":"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"}

package/dist/configuration-types.d.ts

@@ -105,8 +105,40 @@ export interface CheckoutWidgetConfiguration {
     allowQuantity?: boolean;
     maxQuantity?: number;
     stripePublishableKey?: string;
+    /**
+     * Wording of the automatic-renewal agreement the buyer must accept before paying — for a widget
+     * selling an auto-renewing subscription. When set, the widget shows a required checkbox with this
+     * text, the server refuses to open a payment intent without the buyer's agreement, and the
+     * checkout session records this server-side text and the time of agreement. Unset means no
+     * checkbox.
+     */
+    autoRenewConsentText?: string;
+    /**
+     * When true, the widget shows a promotion-code field and the anonymous draft accepts one code
+     * (validated, priced and booked server-side by the promotion engine). Absent or false: codes are
+     * refused.
+     */
+    allowCoupons?: boolean;
     successMessage?: string;
+    /**
+     * What the success screen says about the buyer's access while it is provisioned after the
+     * confirm (#325). Shown only when a registered outbound consumer gates access; each has a default.
+     */
+    accessMessages?: {
+        pending?: string;
+        ready?: string;
+        failed?: string;
+    };
+    /**
+     * Where the public checkout sends the buyer once the order is confirmed. The order number is
+     * appended as `order=<number>`, so the landing page knows which order completed.
+     */
     redirectUrl?: string;
+    /**
+     * Ask the payment gateway to send its own receipt to the buyer's e-mail (Stripe:
+     * `receipt_email`). Off by default: a host that sends its own receipt would otherwise send two.
+     */
+    sendReceipt?: boolean;
     extensionEntityName?: string;
     /**
      * Metadata-driven form field specs — auto-discovered from the product type's extension
@@ -161,6 +193,12 @@ export interface CheckoutWidgetConfiguration {
      * Turnstile secret for verification to run — fail-closed when it is not).
      */
     requireTurnstile?: boolean;
+    /**
+     * `@RegisterClass` key of the `BaseCheckoutMemberDiscountResolver` that verifies a host's
+     * member token and names the promotion code it earns. Server-side only. A draft that carries a
+     * member token is refused when this is unset or names an unregistered class.
+     */
+    memberDiscountResolver?: string;
     /**
      * Custom UI section containing JS hooks, scoped CSS, theme tokens, and component overrides.
      */

package/dist/configuration-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configuration-types.d.ts","sourceRoot":"","sources":["../src/configuration-types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configuration-types.d.ts","sourceRoot":"","sources":["../src/configuration-types.ts"],"names":[],"mappings":"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"}