@owlmeans/payment 0.1.18-rc.29 → 0.1.18-rc.30

package/README.md

@@ -8,7 +8,7 @@ server integration (`@owlmeans/server-payment`) implements against these contrac
 ## Installation
 
 ```bash
-bun add @owlmeans/payment@^0.1.18-rc.29
+bun add @owlmeans/payment@^0.1.18-rc.30
 ```
 
 ## Concepts
@@ -129,7 +129,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.28
+npx @owlmeans/agent-skills@^0.1.18-rc.29
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/payment",
-  "version": "0.1.18-rc.29",
-  "generatedAt": "2026-09-16T17:32:31.941Z",
+  "version": "0.1.18-rc.30",
+  "generatedAt": "2026-09-18T19:03:53.989Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/payment/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/payment
 
 **Layer:** Core
-**Install:** `"@owlmeans/payment": "^0.1.18-rc.29"` in `dependencies`
+**Install:** `"@owlmeans/payment": "^0.1.18-rc.30"` in `dependencies`
 
 The contracts half of payments: the catalogue (products, plans, localizations), amount- and
 quantity-priced checkout, and the entitlement model — plan capabilities, counted limits, promos,
@@ -35,6 +35,9 @@ admission, the usage ledger, the two gate services — is the `entitlements` ski
 | `capabilityViewsOf` · `limitViewsOf` · `entitlementViewOf` · `reviveEntitlementView` · `capabilityOf` · `limitOf` · `hasLimitRoom` | Pure view builders and readers. |
 | `CreateCheckoutBody` (`planSku`) · `CreateCheckoutResponse` · `PortalLinkBody` · `PortalLinkResponse` (+ schemas) | Wire shapes an application's own checkout and portal protocols use. |
 | `CheckoutPricingMode` · `AmountCheckoutPolicy` / `QuantityCheckoutPolicy` (+ schemas) · `assertAmountCheckoutPolicy` · `assertQuantityCheckoutPolicy` · `assertCheckoutAmount` · `chargeAmountMinor` | Checkout pricing policies and their validation. |
+| `PricingPolicy` (+ schema) · `DEFAULT_PRICING_POLICY` · `assertPricingPolicy` · `TaxBehavior` · `TaxEstimateStatus` · `TaxType` (+ schemas) | Declared tax/currency behaviour (see § Pricing policy and tax estimate). |
+| `PriceEstimate` · `PriceEstimateBody` · `TaxEstimate` · `TaxRateEstimate` (+ schemas) · `estimateOf` · `ratePpmOf` | The tax/local-currency estimate read model and its pure math. |
+| `COUNTRY_CURRENCIES` · `currencyOfCountry` · `COUNTRY_CODES` · `CountrySchema` | ISO 3166-1 → ISO 4217 reference map for a country picker. |
 | `EntitlementRefusal` · `CapabilityRequired` · `LimitExhausted` | Refusals — all `AuthForbidden`. |
 | `PaymentError` · `PaygateError` · `UnknownPaygate` · `PaygateMappingError` · `WebhookSetupError` · `PortalUnavailable` · `ProductError` · `UnknownProduct` · `UnknownPlan` · `PlanRequired` · `PlanRankConflict` · `LimitUnknown` · `LimitMisdeclared` · `PaymentIdentificationError` · `SubscriptionError` · `UnknownSubscription` | Faults (500), except `PortalUnavailable` (409). Importing the package registers every type's message under `errors.<type>` in the seven languages. |
 
@@ -206,6 +209,35 @@ to `amountMinor`, not the adjusted checkout subtotal or tax-inclusive total.
 Quantity checkout remains supported. It uses its reusable unit price and quantity policy; do not
 infer a pricing mode from the presence of `amountMinor`.
 
+## Pricing policy and tax estimate
+
+`PricingPolicy` (a `PRICING_POLICY_RECORD_ID` singleton config record, `declarePaymentPricing` in
+`@owlmeans/server-payment`) is what a checkout-owning application declares once for tax and
+currency behaviour: `tax.automatic` (Stripe Tax on the session), `tax.behavior` (a synced price's
+`TaxBehavior.Exclusive`/`Inclusive`, absent = leave it `unspecified`), `tax.collectTaxId`,
+`tax.estimate` / `currency.estimate` (serve a tax/local-currency estimate endpoint — the estimate
+requires `tax.automatic`, the currency one requires `currency.adaptive`), `currency.adaptive`
+(Stripe Adaptive Pricing on the session). `PaymentService.pricingPolicy()` reads the declared record
+or `DEFAULT_PRICING_POLICY` — the fixed behaviour every checkout had before this policy existed
+(automatic tax and tax-id collection on, no forced behavior, no Adaptive Pricing, no estimate), so
+an application that declares nothing sees no change.
+
+`PriceEstimate` (built by `@owlmeans/server-payment`'s gateway, `estimatePrice`) is the read model:
+`country`/`source` (`'request'`/`'customer'`), `currency`, `behavior`, `tax: TaxEstimate` (`status`
+one of `TaxEstimateStatus` — `taxed`/`reverse-charge`/`none`/`at-checkout`/`location-required` —
+plus `subtotalMinor`/`taxMinor`/`totalMinor`, `scalable`, and `rates: TaxRateEstimate[]` with
+`ratePpm` parsed by `ratePpmOf` from Stripe's `percentage_decimal`, never `Number(x) * 10_000`),
+and an optional `local` (currency + `exchangeRate`, from Stripe's FX Quotes). The pure helper
+`estimateOf(amountMinor, estimate)` re-derives tax and a total for a DIFFERENT amount than the
+estimate's own reference one — exact only when `scalable` and the behavior is `Exclusive`; both
+`taxMinor`/`totalMinor` come back `null` otherwise, meaning "computed at checkout", never a wrong
+number. When the source estimate carries `local`, the result's own `local` gives the subtotal, tax
+and total in THAT currency (`subtotalAmount`/`taxAmount`/`totalAmount`, major units) alongside the
+integration-currency ones — a UI shows one or the other, marking the local figures `≈`, never both
+side by side. `COUNTRY_CURRENCIES` / `currencyOfCountry` / `COUNTRY_CODES` is a reference ISO 3166-1 →
+ISO 4217 map for a country picker and the local-currency lookup — not a Stripe list, and a country
+absent from it still gets a tax estimate, just no local-currency line.
+
 ## `shallowAuthentication` identifies, it does not authorize
 
 It reads the `profileId` out of an envelope token WITHOUT verifying the signature, and throws

package/build/advertise.js

@@ -1,7 +1,14 @@
 import { CONFIG_RECORD } from '@owlmeans/context';
 import { apiConfigPlugin, every } from '@owlmeans/api-config';
-import { L10N_RECORD_TYPE, PLAN_RECORD_TYPE, PRODUCT_RECORD_TYPE } from './consts.js';
-const advertisedRecordTypes = new Set([L10N_RECORD_TYPE, PLAN_RECORD_TYPE, PRODUCT_RECORD_TYPE]);
+import { L10N_RECORD_TYPE, PLAN_RECORD_TYPE, PRICING_POLICY_RECORD_TYPE, PRODUCT_RECORD_TYPE } from './consts.js';
+/**
+ * The pricing policy record carries only flags and TTLs (never a Stripe secret, an API version, or
+ * a migration switch — those stay in a backend-only plugin), so advertising it to the browser is
+ * safe.
+ */
+const advertisedRecordTypes = new Set([
+    L10N_RECORD_TYPE, PLAN_RECORD_TYPE, PRODUCT_RECORD_TYPE, PRICING_POLICY_RECORD_TYPE,
+]);
 apiConfigPlugin({
     allow: {
         [CONFIG_RECORD]: every(true, value => value != null && typeof value === 'object'

package/build/advertise.js.map

@@ -1 +1 @@
-{"version":3,"file":"advertise.js","sourceRoot":"","sources":["../src/advertise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAErF,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,CAAC,CAAC,CAAA;AAEhG,eAAe,CAAC;IACd,KAAK,EAAE;QACL,CAAC,aAAa,CAAC,EAAE,KAAK,CACpB,IAAI,EACJ,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;eAC9C,qBAAqB,CAAC,GAAG,CAAE,KAAiC,CAAC,UAAU,IAAI,EAAE,CAAC,CACpF;KACF;CACF,CAAC,CAAA"}
+{"version":3,"file":"advertise.js","sourceRoot":"","sources":["../src/advertise.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAA;AAC7D,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,0BAA0B,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAEjH;;;;GAIG;AACH,MAAM,qBAAqB,GAAG,IAAI,GAAG,CAAC;IACpC,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,0BAA0B;CACpF,CAAC,CAAA;AAEF,eAAe,CAAC;IACd,KAAK,EAAE;QACL,CAAC,aAAa,CAAC,EAAE,KAAK,CACpB,IAAI,EACJ,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;eAC9C,qBAAqB,CAAC,GAAG,CAAE,KAAiC,CAAC,UAAU,IAAI,EAAE,CAAC,CACpF;KACF;CACF,CAAC,CAAA"}

package/build/consts.d.ts

@@ -71,6 +71,32 @@ export declare enum PortalFlow {
     Change = "change",
     PaymentMethod = "payment-method"
 }
+/** Whether a price's amount includes tax, or tax is added on top — never inferred, always declared. */
+export declare enum TaxBehavior {
+    Exclusive = "exclusive",
+    Inclusive = "inclusive"
+}
+/** What a price estimate says about tax at one billing country. */
+export declare enum TaxEstimateStatus {
+    /** Tax is due and its rate(s) are in `TaxEstimate.rates`. */
+    Taxed = "taxed",
+    /** No tax because the buyer's tax id shifts liability to them (EU/GB reverse charge). */
+    ReverseCharge = "reverse-charge",
+    /** No tax for any other reason (not registered there, exempt, zero-rated). */
+    None = "none",
+    /** The gateway could not resolve a rate from what it was given; the real total shows at checkout. */
+    AtCheckout = "at-checkout",
+    /** No country was given and none could be inferred from the entity's paygate customer. */
+    LocationRequired = "location-required"
+}
+/** A tax type a rate carries, collapsed from Stripe's finer `tax_type` for display. */
+export declare enum TaxType {
+    Vat = "vat",
+    Gst = "gst",
+    SalesTax = "sales-tax",
+    /** Any other Stripe `tax_type` (excise, lease, tourism, …). */
+    Tax = "tax"
+}
 /** The paygate alias of subscriptions the application grants itself (a free plan, a comp). */
 export declare const INTERNAL_PAYGATE = "internal";
 export declare const ProductTypeSchema: JSONSchemaType<ProductType>;
@@ -82,6 +108,9 @@ export declare const SubscriptionStatusSchema: JSONSchemaType<SubscriptionStatus
 export declare const LimitKindSchema: JSONSchemaType<LimitKind>;
 export declare const LimitWindowSchema: JSONSchemaType<LimitWindow>;
 export declare const PortalFlowSchema: JSONSchemaType<PortalFlow>;
+export declare const TaxBehaviorSchema: JSONSchemaType<TaxBehavior>;
+export declare const TaxEstimateStatusSchema: JSONSchemaType<TaxEstimateStatus>;
+export declare const TaxTypeSchema: JSONSchemaType<TaxType>;
 export declare const ProductTitleSchema: JSONSchemaType<string>;
 export declare const ProductDescriptionSchema: JSONSchemaType<string>;
 export declare const LocalizationLngSchema: JSONSchemaType<string>;
@@ -91,6 +120,9 @@ export declare const PLAN_RECORD_TYPE = "plan";
 export declare const PLAN_RECORD_PREFIX = "plan";
 export declare const L10N_RECORD_TYPE = "l10n";
 export declare const L10N_RECORD_PREFIX = "l10n";
+/** A singleton record: at most one per configuration, at this fixed id. */
+export declare const PRICING_POLICY_RECORD_TYPE = "pricing-policy";
+export declare const PRICING_POLICY_RECORD_ID = "pricing-policy";
 export declare const DEFAULT_ALIAS = "payment";
 export declare const PAYMENT_SERVICE = "payment";
 //# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

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

package/build/consts.js

@@ -84,6 +84,35 @@ export var PortalFlow;
     PortalFlow["Change"] = "change";
     PortalFlow["PaymentMethod"] = "payment-method";
 })(PortalFlow || (PortalFlow = {}));
+/** Whether a price's amount includes tax, or tax is added on top — never inferred, always declared. */
+export var TaxBehavior;
+(function (TaxBehavior) {
+    TaxBehavior["Exclusive"] = "exclusive";
+    TaxBehavior["Inclusive"] = "inclusive";
+})(TaxBehavior || (TaxBehavior = {}));
+/** What a price estimate says about tax at one billing country. */
+export var TaxEstimateStatus;
+(function (TaxEstimateStatus) {
+    /** Tax is due and its rate(s) are in `TaxEstimate.rates`. */
+    TaxEstimateStatus["Taxed"] = "taxed";
+    /** No tax because the buyer's tax id shifts liability to them (EU/GB reverse charge). */
+    TaxEstimateStatus["ReverseCharge"] = "reverse-charge";
+    /** No tax for any other reason (not registered there, exempt, zero-rated). */
+    TaxEstimateStatus["None"] = "none";
+    /** The gateway could not resolve a rate from what it was given; the real total shows at checkout. */
+    TaxEstimateStatus["AtCheckout"] = "at-checkout";
+    /** No country was given and none could be inferred from the entity's paygate customer. */
+    TaxEstimateStatus["LocationRequired"] = "location-required";
+})(TaxEstimateStatus || (TaxEstimateStatus = {}));
+/** A tax type a rate carries, collapsed from Stripe's finer `tax_type` for display. */
+export var TaxType;
+(function (TaxType) {
+    TaxType["Vat"] = "vat";
+    TaxType["Gst"] = "gst";
+    TaxType["SalesTax"] = "sales-tax";
+    /** Any other Stripe `tax_type` (excise, lease, tourism, …). */
+    TaxType["Tax"] = "tax";
+})(TaxType || (TaxType = {}));
 /** The paygate alias of subscriptions the application grants itself (a free plan, a comp). */
 export const INTERNAL_PAYGATE = 'internal';
 export const ProductTypeSchema = {
@@ -122,6 +151,18 @@ export const PortalFlowSchema = {
     type: 'string',
     enum: Object.values(PortalFlow)
 };
+export const TaxBehaviorSchema = {
+    type: 'string',
+    enum: Object.values(TaxBehavior)
+};
+export const TaxEstimateStatusSchema = {
+    type: 'string',
+    enum: Object.values(TaxEstimateStatus)
+};
+export const TaxTypeSchema = {
+    type: 'string',
+    enum: Object.values(TaxType)
+};
 export const ProductTitleSchema = {
     type: 'string', minLength: 1, maxLength: 128
 };
@@ -137,6 +178,9 @@ export const PLAN_RECORD_TYPE = 'plan';
 export const PLAN_RECORD_PREFIX = PLAN_RECORD_TYPE;
 export const L10N_RECORD_TYPE = 'l10n';
 export const L10N_RECORD_PREFIX = L10N_RECORD_TYPE;
+/** A singleton record: at most one per configuration, at this fixed id. */
+export const PRICING_POLICY_RECORD_TYPE = 'pricing-policy';
+export const PRICING_POLICY_RECORD_ID = PRICING_POLICY_RECORD_TYPE;
 export const DEFAULT_ALIAS = 'payment';
 export const PAYMENT_SERVICE = DEFAULT_ALIAS;
 //# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,WAIX;AAJD,WAAY,WAAW;IACrB,gCAAiB,CAAA;IACjB,kCAAmB,CAAA;IACnB,wCAAyB,CAAA;AAC3B,CAAC,EAJW,WAAW,KAAX,WAAW,QAItB;AAED,MAAM,CAAN,IAAY,mBAGX;AAHD,WAAY,mBAAmB;IAC7B,4CAAqB,CAAA;IACrB,wCAAiB,CAAA;AACnB,CAAC,EAHW,mBAAmB,KAAnB,mBAAmB,QAG9B;AAED,MAAM,CAAN,IAAY,iBAIX;AAJD,WAAY,iBAAiB;IAC3B,wCAAmB,CAAA;IACnB,kCAAa,CAAA;IACb,qDAAgC,CAAA;AAClC,CAAC,EAJW,iBAAiB,KAAjB,iBAAiB,QAI5B;AAED,MAAM,CAAN,IAAY,UAOX;AAPD,WAAY,UAAU;IACpB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,mCAAqB,CAAA;IACrB,uCAAyB,CAAA;IACzB,qCAAuB,CAAA;AACzB,CAAC,EAPW,UAAU,KAAV,UAAU,QAOrB;AAED,MAAM,CAAN,IAAY,YAUX;AAVD,WAAY,YAAY;IACtB,mCAAmB,CAAA;IACnB,iCAAiB,CAAA;IACjB,qCAAqB,CAAA;IACrB,qCAAqB,CAAA;IACrB;;;OAGG;IACH,yCAAyB,CAAA;AAC3B,CAAC,EAVW,YAAY,KAAZ,YAAY,QAUvB;AAED,MAAM,CAAN,IAAY,kBAYX;AAZD,WAAY,kBAAkB;IAC5B,yCAAmB,CAAA;IACnB,qCAAe,CAAA;IACf,2CAAqB,CAAA;IACrB,yCAAmB,CAAA;IACnB,mEAAmE;IACnE,6CAAuB,CAAA;IACvB,yCAAmB,CAAA;IACnB,qCAAe,CAAA;IACf,uCAAiB,CAAA;IACjB,oEAAoE;IACpE,0CAAoB,CAAA;AACtB,CAAC,EAZW,kBAAkB,KAAlB,kBAAkB,QAY7B;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,kBAAkB,GAAkC,MAAM,CAAC,MAAM,CAAC;IAC7E,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,CAAC,OAAO;CAChF,CAAC,CAAA;AAEF,2DAA2D;AAC3D,MAAM,CAAC,MAAM,iBAAiB,GAAkC,MAAM,CAAC,MAAM,CAAC;IAC5E,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,CAAC,KAAK;IACjF,kBAAkB,CAAC,OAAO;CAC3B,CAAC,CAAA;AAEF,oCAAoC;AACpC,MAAM,CAAN,IAAY,SAOX;AAPD,WAAY,SAAS;IACnB,uDAAuD;IACvD,8BAAiB,CAAA;IACjB,iFAAiF;IACjF,kCAAqB,CAAA;IACrB,mFAAmF;IACnF,oCAAuB,CAAA;AACzB,CAAC,EAPW,SAAS,KAAT,SAAS,QAOpB;AAED,6DAA6D;AAC7D,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,0BAAW,CAAA;IACX,8BAAe,CAAA;AACjB,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB;AAED,qDAAqD;AACrD,MAAM,CAAN,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,+BAAiB,CAAA;IACjB,8CAAgC,CAAA;AAClC,CAAC,EANW,UAAU,KAAV,UAAU,QAMrB;AAED,uGAAuG;AACvG,MAAM,CAAN,IAAY,WAGX;AAHD,WAAY,WAAW;IACrB,sCAAuB,CAAA;IACvB,sCAAuB,CAAA;AACzB,CAAC,EAHW,WAAW,KAAX,WAAW,QAGtB;AAED,mEAAmE;AACnE,MAAM,CAAN,IAAY,iBAWX;AAXD,WAAY,iBAAiB;IAC3B,6DAA6D;IAC7D,oCAAe,CAAA;IACf,yFAAyF;IACzF,qDAAgC,CAAA;IAChC,8EAA8E;IAC9E,kCAAa,CAAA;IACb,qGAAqG;IACrG,+CAA0B,CAAA;IAC1B,0FAA0F;IAC1F,2DAAsC,CAAA;AACxC,CAAC,EAXW,iBAAiB,KAAjB,iBAAiB,QAW5B;AAED,uFAAuF;AACvF,MAAM,CAAN,IAAY,OAMX;AAND,WAAY,OAAO;IACjB,sBAAW,CAAA;IACX,sBAAW,CAAA;IACX,iCAAsB,CAAA;IACtB,+DAA+D;IAC/D,sBAAW,CAAA;AACb,CAAC,EANW,OAAO,KAAP,OAAO,QAMlB;AAED,8FAA8F;AAC9F,MAAM,CAAC,MAAM,gBAAgB,GAAG,UAAU,CAAA;AAE1C,MAAM,CAAC,MAAM,iBAAiB,GAAgC;IAC5D,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;CACjC,CAAA;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAwC;IAC5E,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,mBAAmB,CAAC;CACzC,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAsC;IACxE,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC;CACvC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAA+B;IAC1D,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;CAChC,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAiC;IAC9D,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;CAClC,CAAA;AAED,MAAM,CAAC,MAAM,wBAAwB,GAAuC;IAC1E,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC;CACxC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAA8B;IACxD,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;CAC/B,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAgC;IAC5D,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;CACjC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAA+B;IAC1D,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;CAChC,CAAA;AAED,MAAM,CAAC,MAAM,iBAAiB,GAAgC;IAC5D,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC;CACjC,CAAA;AAED,MAAM,CAAC,MAAM,uBAAuB,GAAsC;IACxE,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,iBAAiB,CAAC;CACvC,CAAA;AAED,MAAM,CAAC,MAAM,aAAa,GAA4B;IACpD,IAAI,EAAE,QAAQ;IACd,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;CAC7B,CAAA;AAED,MAAM,CAAC,MAAM,kBAAkB,GAA2B;IACxD,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG;CAC7C,CAAA;AAED,MAAM,CAAC,MAAM,wBAAwB,GAA2B;IAC9D,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI;CAC9D,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,EAAE,SAAS,EAAE,CAAC;CAC3C,CAAA;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,SAAS,CAAA;AAC5C,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAA;AAExD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAA;AACtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAA;AAElD,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAA;AACtC,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAA;AAElD,2EAA2E;AAC3E,MAAM,CAAC,MAAM,0BAA0B,GAAG,gBAAgB,CAAA;AAC1D,MAAM,CAAC,MAAM,wBAAwB,GAAG,0BAA0B,CAAA;AAElE,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAA;AAEtC,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAA"}

package/build/countries.d.ts

@@ -0,0 +1,22 @@
+import type { JSONSchemaType } from 'ajv';
+/**
+ * ISO 3166-1 alpha-2 country code → lowercase ISO 4217 currency code — the currency circulating in
+ * that country, for the "≈ local total" line of a price estimate. Not a Stripe list: Stripe Tax can
+ * compute a rate for a country this map has no entry for (or none at all, `location-required`), and
+ * `currencyOfCountry` returning `null` just means the estimate carries no local-currency line, never
+ * a rejected request.
+ *
+ * A territory that circulates another country's currency (Ecuador, Kosovo, Puerto Rico, …) is
+ * mapped to that currency, not left out.
+ */
+export declare const COUNTRY_CURRENCIES: Readonly<Record<string, string>>;
+export declare const COUNTRY_CODES: readonly string[];
+/** The lowercase ISO 4217 currency of a country, or `null` when this map has no entry for it. */
+export declare const currencyOfCountry: (country: string) => string | null;
+/**
+ * A permissive ISO 3166-1 alpha-2 shape (two uppercase letters) — not restricted to
+ * `COUNTRY_CURRENCIES`, so a country this map cannot name a currency for is still a valid request;
+ * it only loses the local-currency line of its estimate.
+ */
+export declare const CountrySchema: JSONSchemaType<string>;
+//# sourceMappingURL=countries.d.ts.map

package/build/countries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"countries.d.ts","sourceRoot":"","sources":["../src/countries.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,KAAK,CAAA;AAEzC;;;;;;;;;GASG;AACH,eAAO,MAAM,kBAAkB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA2C9D,CAAA;AAEF,eAAO,MAAM,aAAa,EAAE,SAAS,MAAM,EAA0D,CAAA;AAErG,iGAAiG;AACjG,eAAO,MAAM,iBAAiB,YAAa,MAAM,KAAG,MAAM,GAAG,IACV,CAAA;AAEnD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,cAAc,CAAC,MAAM,CAEhD,CAAA"}

package/build/countries.js

@@ -0,0 +1,66 @@
+/**
+ * ISO 3166-1 alpha-2 country code → lowercase ISO 4217 currency code — the currency circulating in
+ * that country, for the "≈ local total" line of a price estimate. Not a Stripe list: Stripe Tax can
+ * compute a rate for a country this map has no entry for (or none at all, `location-required`), and
+ * `currencyOfCountry` returning `null` just means the estimate carries no local-currency line, never
+ * a rejected request.
+ *
+ * A territory that circulates another country's currency (Ecuador, Kosovo, Puerto Rico, …) is
+ * mapped to that currency, not left out.
+ */
+export const COUNTRY_CURRENCIES = Object.freeze({
+    AD: 'eur', AE: 'aed', AF: 'afn', AG: 'xcd', AI: 'xcd', AL: 'all', AM: 'amd', AO: 'aoa',
+    AR: 'ars', AS: 'usd', AT: 'eur', AU: 'aud', AW: 'awg', AX: 'eur', AZ: 'azn',
+    BA: 'bam', BB: 'bbd', BD: 'bdt', BE: 'eur', BF: 'xof', BG: 'bgn', BH: 'bhd', BI: 'bif',
+    BJ: 'xof', BL: 'eur', BM: 'bmd', BN: 'bnd', BO: 'bob', BQ: 'usd', BR: 'brl', BS: 'bsd',
+    BT: 'btn', BW: 'bwp', BY: 'byn', BZ: 'bzd',
+    CA: 'cad', CD: 'cdf', CF: 'xaf', CG: 'xaf', CH: 'chf', CI: 'xof', CK: 'nzd', CL: 'clp',
+    CM: 'xaf', CN: 'cny', CO: 'cop', CR: 'crc', CU: 'cup', CV: 'cve', CW: 'ang', CY: 'eur',
+    CZ: 'czk',
+    DE: 'eur', DJ: 'djf', DK: 'dkk', DM: 'xcd', DO: 'dop', DZ: 'dzd',
+    EC: 'usd', EE: 'eur', EG: 'egp', EH: 'mad', ER: 'ern', ES: 'eur', ET: 'etb',
+    FI: 'eur', FJ: 'fjd', FK: 'fkp', FM: 'usd', FO: 'dkk', FR: 'eur',
+    GA: 'xaf', GB: 'gbp', GD: 'xcd', GE: 'gel', GF: 'eur', GG: 'gbp', GH: 'ghs', GI: 'gip',
+    GL: 'dkk', GM: 'gmd', GN: 'gnf', GP: 'eur', GQ: 'xaf', GR: 'eur', GT: 'gtq', GU: 'usd',
+    GW: 'xof', GY: 'gyd',
+    HK: 'hkd', HN: 'hnl', HR: 'eur', HT: 'htg', HU: 'huf',
+    ID: 'idr', IE: 'eur', IL: 'ils', IM: 'gbp', IN: 'inr', IQ: 'iqd', IR: 'irr', IS: 'isk',
+    IT: 'eur',
+    JE: 'gbp', JM: 'jmd', JO: 'jod', JP: 'jpy',
+    KE: 'kes', KG: 'kgs', KH: 'khr', KI: 'aud', KM: 'kmf', KN: 'xcd', KP: 'kpw', KR: 'krw',
+    KW: 'kwd', KY: 'kyd', KZ: 'kzt',
+    LA: 'lak', LB: 'lbp', LC: 'xcd', LI: 'chf', LK: 'lkr', LR: 'lrd', LS: 'lsl', LT: 'eur',
+    LU: 'eur', LV: 'eur', LY: 'lyd',
+    MA: 'mad', MC: 'eur', MD: 'mdl', ME: 'eur', MF: 'eur', MG: 'mga', MH: 'usd', MK: 'mkd',
+    ML: 'xof', MM: 'mmk', MN: 'mnt', MO: 'mop', MQ: 'eur', MR: 'mru', MS: 'xcd', MT: 'eur',
+    MU: 'mur', MV: 'mvr', MW: 'mwk', MX: 'mxn', MY: 'myr', MZ: 'mzn',
+    NA: 'nad', NC: 'xpf', NE: 'xof', NG: 'ngn', NI: 'nio', NL: 'eur', NO: 'nok', NP: 'npr',
+    NR: 'aud', NU: 'nzd', NZ: 'nzd',
+    OM: 'omr',
+    PA: 'pab', PE: 'pen', PF: 'xpf', PG: 'pgk', PH: 'php', PK: 'pkr', PL: 'pln', PR: 'usd',
+    PS: 'ils', PT: 'eur', PW: 'usd', PY: 'pyg',
+    QA: 'qar',
+    RE: 'eur', RO: 'ron', RS: 'rsd', RU: 'rub', RW: 'rwf',
+    SA: 'sar', SB: 'sbd', SC: 'scr', SD: 'sdg', SE: 'sek', SG: 'sgd', SH: 'shp', SI: 'eur',
+    SK: 'eur', SL: 'sle', SM: 'eur', SN: 'xof', SO: 'sos', SR: 'srd', SS: 'ssp', ST: 'stn',
+    SV: 'usd', SX: 'ang', SY: 'syp', SZ: 'szl',
+    TC: 'usd', TD: 'xaf', TG: 'xof', TH: 'thb', TJ: 'tjs', TK: 'nzd', TL: 'usd', TM: 'tmt',
+    TN: 'tnd', TO: 'top', TR: 'try', TT: 'ttd', TV: 'aud', TW: 'twd', TZ: 'tzs',
+    UA: 'uah', UG: 'ugx', US: 'usd', UY: 'uyu', UZ: 'uzs',
+    VA: 'eur', VC: 'xcd', VE: 'ves', VG: 'usd', VI: 'usd', VN: 'vnd', VU: 'vuv',
+    WF: 'xpf', WS: 'wst',
+    YE: 'yer', YT: 'eur',
+    ZA: 'zar', ZM: 'zmw', ZW: 'zwl',
+});
+export const COUNTRY_CODES = Object.freeze(Object.keys(COUNTRY_CURRENCIES).sort());
+/** The lowercase ISO 4217 currency of a country, or `null` when this map has no entry for it. */
+export const currencyOfCountry = (country) => COUNTRY_CURRENCIES[country.toUpperCase()] ?? null;
+/**
+ * A permissive ISO 3166-1 alpha-2 shape (two uppercase letters) — not restricted to
+ * `COUNTRY_CURRENCIES`, so a country this map cannot name a currency for is still a valid request;
+ * it only loses the local-currency line of its estimate.
+ */
+export const CountrySchema = {
+    type: 'string', pattern: '^[A-Z]{2}$',
+};
+//# sourceMappingURL=countries.js.map

package/build/countries.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"countries.js","sourceRoot":"","sources":["../src/countries.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAqC,MAAM,CAAC,MAAM,CAAC;IAChF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAC3E,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAC1C,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAChE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAC3E,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAChE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACpB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACrD,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAC1C,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAC/B,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAC/B,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAChE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAC/B,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAC1C,EAAE,EAAE,KAAK;IACT,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACrD,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAC1C,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACtF,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAC3E,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACrD,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IAC3E,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACpB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;IACpB,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK;CAChC,CAAC,CAAA;AAEF,MAAM,CAAC,MAAM,aAAa,GAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;AAErG,iGAAiG;AACjG,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAiB,EAAE,CAClE,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,IAAI,IAAI,CAAA;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY;CACtC,CAAA"}

package/build/estimate.d.ts

@@ -0,0 +1,57 @@
+import type { PriceEstimate, PricingPolicy } from './types.js';
+/**
+ * Preserves today's fixed behavior for every consumer that declares no policy: automatic tax and
+ * tax-id collection stay on for every checkout (`taxOptions` before this policy existed), no
+ * `behavior` is forced onto a synced price, no Adaptive Pricing, and the estimate endpoints are off
+ * (a new capability, opt-in only).
+ */
+export declare const DEFAULT_PRICING_POLICY: PricingPolicy;
+/**
+ * @throws PaymentError when a tax estimate is served without automatic tax, a currency estimate is
+ * served without Adaptive Pricing, or a TTL is not a positive integer.
+ */
+export declare const assertPricingPolicy: (policy: PricingPolicy) => PricingPolicy;
+/**
+ * Stripe's `percentage_decimal` (e.g. `"23"`, `"8.875"`) as parts per million — `1_000_000` is
+ * `100%` — parsed digit by digit so it is exact where a float parse (`Number(x) * 10_000`) is not.
+ * Fractional digits past the fourth are truncated, not rounded: a quarter of a hundredth of a
+ * percent is already far finer than any real tax rate.
+ *
+ * @throws PaymentError when the string is not a plain (unsigned, non-exponential) decimal.
+ */
+export declare const ratePpmOf: (percentageDecimal: string) => number;
+export interface AmountEstimate {
+    subtotalMinor: number;
+    /** `null` when `estimate` cannot be rescaled to this amount (see `TaxEstimate.scalable`). */
+    taxMinor: number | null;
+    totalMinor: number | null;
+    /**
+     * The subtotal, tax and total in the country's own currency, in major units — present only
+     * alongside a non-`null` `totalMinor`. A UI showing `local` shows ONLY `local` for the tax and
+     * total (marked `≈`, since it is Stripe's own rate at read time, not the checkout rate); the
+     * integration-currency amounts stay the reference for bookkeeping, never a second figure to show
+     * alongside the converted one.
+     */
+    local?: {
+        currency: string;
+        subtotalAmount: number;
+        taxAmount: number;
+        totalAmount: number;
+    };
+}
+/**
+ * Re-derive tax and the local-currency total for `amountMinor` from a `PriceEstimate` already
+ * fetched for the SAME product/plan/country, so a UI can re-price a custom amount (the credit
+ * dialog) without a second Stripe Tax call ($0.05 each).
+ *
+ * Exact for `amountMinor === estimate.tax.subtotalMinor` (Stripe's own numbers, echoed back).
+ * Otherwise exact only for `TaxBehavior.Exclusive` with `estimate.tax.scalable` — a linear
+ * percentage rate scales; a flat fee, a reduced-rate portion, or several inclusive rates do not, and
+ * neither does rescaling an inclusive amount (its tax portion is carved OUT of the total by a
+ * different formula this helper does not attempt). Both cases return `null` amounts, meaning
+ * "computed at checkout".
+ *
+ * @throws PaymentError when `amountMinor` is not a non-negative safe integer.
+ */
+export declare const estimateOf: (amountMinor: number, estimate: PriceEstimate) => AmountEstimate;
+//# sourceMappingURL=estimate.d.ts.map

package/build/estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../src/estimate.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE9D;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAGlB,CAAA;AAEnB;;;GAGG;AACH,eAAO,MAAM,mBAAmB,WAAY,aAAa,KAAG,aAa3D,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,SAAS,sBAAuB,MAAM,KAAG,MAYrD,CAAA;AAKD,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAA;IACrB,6FAA6F;IAC7F,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB;;;;;;OAMG;IACH,KAAK,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAA;CAC7F;AAED;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,UAAU,gBAAiB,MAAM,YAAY,aAAa,KAAG,cA0BzE,CAAA"}

package/build/estimate.js

@@ -0,0 +1,93 @@
+import { PaymentError } from './errors.js';
+import { TaxBehavior } from './consts.js';
+/**
+ * Preserves today's fixed behavior for every consumer that declares no policy: automatic tax and
+ * tax-id collection stay on for every checkout (`taxOptions` before this policy existed), no
+ * `behavior` is forced onto a synced price, no Adaptive Pricing, and the estimate endpoints are off
+ * (a new capability, opt-in only).
+ */
+export const DEFAULT_PRICING_POLICY = Object.freeze({
+    tax: Object.freeze({ automatic: true, collectTaxId: true, estimate: false }),
+    currency: Object.freeze({ estimate: false }),
+});
+/**
+ * @throws PaymentError when a tax estimate is served without automatic tax, a currency estimate is
+ * served without Adaptive Pricing, or a TTL is not a positive integer.
+ */
+export const assertPricingPolicy = (policy) => {
+    if (policy.tax.estimate && !policy.tax.automatic) {
+        throw new PaymentError('pricing-policy:tax-estimate-requires-automatic');
+    }
+    if (policy.currency.estimate && policy.currency.adaptive !== true) {
+        throw new PaymentError('pricing-policy:currency-estimate-requires-adaptive');
+    }
+    for (const ttl of [policy.tax.estimateTtlSeconds, policy.currency.estimateTtlSeconds]) {
+        if (ttl != null && (!Number.isSafeInteger(ttl) || ttl < 1)) {
+            throw new PaymentError('pricing-policy:ttl');
+        }
+    }
+    return policy;
+};
+/**
+ * Stripe's `percentage_decimal` (e.g. `"23"`, `"8.875"`) as parts per million — `1_000_000` is
+ * `100%` — parsed digit by digit so it is exact where a float parse (`Number(x) * 10_000`) is not.
+ * Fractional digits past the fourth are truncated, not rounded: a quarter of a hundredth of a
+ * percent is already far finer than any real tax rate.
+ *
+ * @throws PaymentError when the string is not a plain (unsigned, non-exponential) decimal.
+ */
+export const ratePpmOf = (percentageDecimal) => {
+    const match = /^(\d+)(?:\.(\d+))?$/.exec(percentageDecimal.trim());
+    if (match == null) {
+        throw new PaymentError('tax-rate:percentage');
+    }
+    const [, whole, fraction = ''] = match;
+    const fractionPpm = Number(`${fraction}0000`.slice(0, 4));
+    const ppm = Number(whole) * 10_000 + fractionPpm;
+    if (!Number.isSafeInteger(ppm)) {
+        throw new PaymentError('tax-rate:percentage');
+    }
+    return ppm;
+};
+/** Stripe's own convention for a tax amount: half a unit rounds up. */
+const roundHalfUp = (value) => Math.floor(value + 0.5);
+/**
+ * Re-derive tax and the local-currency total for `amountMinor` from a `PriceEstimate` already
+ * fetched for the SAME product/plan/country, so a UI can re-price a custom amount (the credit
+ * dialog) without a second Stripe Tax call ($0.05 each).
+ *
+ * Exact for `amountMinor === estimate.tax.subtotalMinor` (Stripe's own numbers, echoed back).
+ * Otherwise exact only for `TaxBehavior.Exclusive` with `estimate.tax.scalable` — a linear
+ * percentage rate scales; a flat fee, a reduced-rate portion, or several inclusive rates do not, and
+ * neither does rescaling an inclusive amount (its tax portion is carved OUT of the total by a
+ * different formula this helper does not attempt). Both cases return `null` amounts, meaning
+ * "computed at checkout".
+ *
+ * @throws PaymentError when `amountMinor` is not a non-negative safe integer.
+ */
+export const estimateOf = (amountMinor, estimate) => {
+    if (!Number.isSafeInteger(amountMinor) || amountMinor < 0) {
+        throw new PaymentError('price-estimate:amount');
+    }
+    const { tax, behavior, local } = estimate;
+    const sameAmount = amountMinor === tax.subtotalMinor;
+    const rescalable = sameAmount || (behavior === TaxBehavior.Exclusive && tax.scalable);
+    if (!rescalable) {
+        return { subtotalMinor: amountMinor, taxMinor: null, totalMinor: null };
+    }
+    // `sameAmount` trusts Stripe's own numbers outright; otherwise only Exclusive ever reaches here
+    // (`rescalable` above excludes an Inclusive amount that differs from the reference).
+    const taxMinor = sameAmount ? tax.taxMinor : tax.rates.reduce((sum, rate) => sum + roundHalfUp(amountMinor * rate.ratePpm / 1_000_000), 0);
+    const totalMinor = sameAmount ? tax.totalMinor : amountMinor + taxMinor;
+    const result = { subtotalMinor: amountMinor, taxMinor, totalMinor };
+    if (local != null) {
+        result.local = {
+            currency: local.currency,
+            subtotalAmount: amountMinor / 100 / local.exchangeRate,
+            taxAmount: taxMinor / 100 / local.exchangeRate,
+            totalAmount: totalMinor / 100 / local.exchangeRate,
+        };
+    }
+    return result;
+};
+//# sourceMappingURL=estimate.js.map

package/build/estimate.js.map

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

package/build/index.d.ts

@@ -11,4 +11,6 @@ export * from './pricing.js';
 export * from './promo.js';
 export * from './limit.js';
 export * from './view.js';
+export * from './countries.js';
+export * from './estimate.js';
 //# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,mBAAmB,YAAY,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA"}

package/build/index.js

@@ -10,4 +10,6 @@ export * from './pricing.js';
 export * from './promo.js';
 export * from './limit.js';
 export * from './view.js';
+export * from './countries.js';
+export * from './estimate.js';
 //# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,kBAAkB,CAAA;AAChC,cAAc,cAAc,CAAA;AAC5B,cAAc,WAAW,CAAA;AACzB,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA"}

package/build/model/estimate.d.ts

@@ -0,0 +1,5 @@
+import type { PriceEstimate, PriceEstimateBody, PricingPolicy } from '../types.js';
+export declare const PricingPolicySchema: import("@owlmeans/entrypoint").EntrypointSchema<PricingPolicy>;
+export declare const PriceEstimateBodySchema: import("@owlmeans/entrypoint").EntrypointSchema<PriceEstimateBody>;
+export declare const PriceEstimateSchema: import("@owlmeans/entrypoint").EntrypointSchema<PriceEstimate>;
+//# sourceMappingURL=estimate.d.ts.map

package/build/model/estimate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"estimate.d.ts","sourceRoot":"","sources":["../../src/model/estimate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,aAAa,EAAgC,MAAM,aAAa,CAAA;AAMhH,eAAO,MAAM,mBAAmB,gEA4BG,CAAA;AAEnC,eAAO,MAAM,uBAAuB,oEAQG,CAAA;AA6BvC,eAAO,MAAM,mBAAmB,gEAsBG,CAAA"}