Price

Price takes a typed product record plus a destination country and returns a landed-cost quote in the target currency.

Contract

type PriceQuoteInput = {
  productId: string;
  destinationCountry: string;      // ISO-3166-1 alpha-2
  destinationCurrency?: string;    // default inferred from country
  asOf?: string;                   // RFC-3339; default "now"
  tariffs?: 'default' | { tableId: string };
};

type PriceQuoteOutput = {
  productId: string;
  destinationCurrency: string;
  amount: number;                  // landed cost in destination currency, minor units
  breakdown: {
    goodsAmount: number;
    fxRateUsed: number;
    dutyRateUsed: number;
    dutyAmount: number;
    taxAmount: number;
    shippingAmount: number;
  };
  rules: Array<{ id: string; description: string }>;
  confidenceSignals: Array<{ field: string; confidence: number; source: string }>;
};

Deterministic replay

Price is replayable. Given the same input and asOf, the output is stable. This lets operators reconcile catalogs against historical rates and lets agents cache quote decisions confidently.

Benchmarks

• Fixture baseline: 3.47 ms — KZT quote from 4 pricing rules (card in /proof).
• 2 confidence signals captured on the Price.quote primitive.

Release maturity

Price is GA.