@fun-xyz/fiat-contract 0.9.0 → 0.10.0

package/README.md

@@ -59,8 +59,9 @@ this package is [ENG-5268](https://linear.app/funxyz/issue/ENG-5268).
 6. **Surface kind names the renderer; provider selects the adapter.** Sumsub capture is
    `{ kind: 'KYC_SDK', provider: 'SUMSUB' }`. It is not `URL_EMBED`: the client mounts an SDK,
    not a URL or iframe.
-7. **Quote-screen bounds are explicit exact-money strings.** `QUOTE.limits` carries the minimum and
-   current routing maximum; clients do not infer either from provider metadata or floating point.
+7. **Quote-screen bounds are explicit exact-money strings.** `QUOTE.limits` carries the bounding
+   minimum/maximum plus the exact `serviceableRanges` when a routing set has gaps; clients do not
+   infer capacity from provider metadata or floating point.
 8. **Provider auth is capability-shaped.** SMS uses `SMS_OTP`; provider-owned auth uses
    `PROVIDER_RENDERED` with an optional `AUTH_COMPONENT` surface rather than provider-specific channels.
 

package/dist/{chunk-5QGVY5Z4.mjs → chunk-BAGIBS54.mjs}

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.9.0";
+var version = "0.10.0";
 
 // src/table.ts
 var TABLE_VERSION = version;
@@ -500,4 +500,4 @@ export {
   tableEntry,
   isTerminal
 };
-//# sourceMappingURL=chunk-5QGVY5Z4.mjs.map
+//# sourceMappingURL=chunk-BAGIBS54.mjs.map

package/dist/index.js

@@ -66,6 +66,7 @@ __export(index_exports, {
   PaymentInstructStateSchema: () => PaymentInstructStateSchema,
   PendingOrderStateSchema: () => PendingOrderStateSchema,
   PollSpecSchema: () => PollSpecSchema,
+  QuoteLimitRangeSchema: () => QuoteLimitRangeSchema,
   QuoteLimitsSchema: () => QuoteLimitsSchema,
   QuoteSchema: () => QuoteSchema,
   QuoteStateSchema: () => QuoteStateSchema,
@@ -464,7 +465,13 @@ var $quote = obj({
   expiresAt: import_zod.z.string()
 });
 var QuoteSchema = $quote;
-var $quoteLimits = obj({ min: import_zod.z.string(), max: import_zod.z.string() });
+var $quoteLimitRange = obj({ min: import_zod.z.string(), max: import_zod.z.string() });
+var QuoteLimitRangeSchema = $quoteLimitRange;
+var $quoteLimits = obj({
+  min: import_zod.z.string(),
+  max: import_zod.z.string(),
+  serviceableRanges: import_zod.z.array($quoteLimitRange).min(1).optional()
+});
 var QuoteLimitsSchema = $quoteLimits;
 var $instrument = obj({ brandLabel: import_zod.z.string(), last4: import_zod.z.string() });
 var InstrumentSchema = $instrument;
@@ -772,7 +779,7 @@ var $stepResponse = obj({
 var FiatStepResponseSchema = $stepResponse;
 
 // package.json
-var version = "0.9.0";
+var version = "0.10.0";
 
 // src/table.ts
 var TABLE_VERSION = version;
@@ -1266,7 +1273,17 @@ var FIXTURE_DATA = {
       "kind": "QUOTE",
       "limits": {
         "min": "1.00",
-        "max": "3000.00"
+        "max": "3000.00",
+        "serviceableRanges": [
+          {
+            "min": "1.00",
+            "max": "500.00"
+          },
+          {
+            "min": "1000.00",
+            "max": "3000.00"
+          }
+        ]
       },
       "quote": {
         "quoteRef": "q_8f2",
@@ -1314,7 +1331,13 @@ var FIXTURE_DATA = {
       "kind": "QUOTE",
       "limits": {
         "min": "1.00",
-        "max": "3000.00"
+        "max": "3000.00",
+        "serviceableRanges": [
+          {
+            "min": "1.00",
+            "max": "3000.00"
+          }
+        ]
       },
       "quote": {
         "quoteRef": "q_8f2",
@@ -1829,7 +1852,13 @@ var FIXTURE_DATA = {
       "kind": "QUOTE",
       "limits": {
         "min": "1.00",
-        "max": "3000.00"
+        "max": "3000.00",
+        "serviceableRanges": [
+          {
+            "min": "1.00",
+            "max": "3000.00"
+          }
+        ]
       },
       "quote": {
         "quoteRef": "q_8f2",

package/dist/index.mjs

@@ -12,7 +12,7 @@ import {
   tableEntry,
   unofferedEndpoints,
   unreachableStates
-} from "./chunk-5QGVY5Z4.mjs";
+} from "./chunk-BAGIBS54.mjs";
 
 // src/codes.ts
 var COUNTRY_CURRENCY_LIST = [
@@ -370,7 +370,13 @@ var $quote = obj({
   expiresAt: z.string()
 });
 var QuoteSchema = $quote;
-var $quoteLimits = obj({ min: z.string(), max: z.string() });
+var $quoteLimitRange = obj({ min: z.string(), max: z.string() });
+var QuoteLimitRangeSchema = $quoteLimitRange;
+var $quoteLimits = obj({
+  min: z.string(),
+  max: z.string(),
+  serviceableRanges: z.array($quoteLimitRange).min(1).optional()
+});
 var QuoteLimitsSchema = $quoteLimits;
 var $instrument = obj({ brandLabel: z.string(), last4: z.string() });
 var InstrumentSchema = $instrument;
@@ -684,7 +690,17 @@ var FIXTURE_DATA = {
       "kind": "QUOTE",
       "limits": {
         "min": "1.00",
-        "max": "3000.00"
+        "max": "3000.00",
+        "serviceableRanges": [
+          {
+            "min": "1.00",
+            "max": "500.00"
+          },
+          {
+            "min": "1000.00",
+            "max": "3000.00"
+          }
+        ]
       },
       "quote": {
         "quoteRef": "q_8f2",
@@ -732,7 +748,13 @@ var FIXTURE_DATA = {
       "kind": "QUOTE",
       "limits": {
         "min": "1.00",
-        "max": "3000.00"
+        "max": "3000.00",
+        "serviceableRanges": [
+          {
+            "min": "1.00",
+            "max": "3000.00"
+          }
+        ]
       },
       "quote": {
         "quoteRef": "q_8f2",
@@ -1247,7 +1269,13 @@ var FIXTURE_DATA = {
       "kind": "QUOTE",
       "limits": {
         "min": "1.00",
-        "max": "3000.00"
+        "max": "3000.00",
+        "serviceableRanges": [
+          {
+            "min": "1.00",
+            "max": "3000.00"
+          }
+        ]
       },
       "quote": {
         "quoteRef": "q_8f2",
@@ -1736,6 +1764,7 @@ export {
   PaymentInstructStateSchema,
   PendingOrderStateSchema,
   PollSpecSchema,
+  QuoteLimitRangeSchema,
   QuoteLimitsSchema,
   QuoteSchema,
   QuoteStateSchema,

package/dist/schemas.d.ts

@@ -27,7 +27,7 @@
  * They are module-private, so none of it reaches the published declarations.
  */
 import { z } from 'zod';
-import type { BlockedReason, CryptoAmount, FailureReason, FeeLine, FiatEndpoint, FieldSpec, FlowState, FormDescriptor, FormField, FormFieldType, Instructions, InstructionField, Instrument, JsonValue, FiatAmount, OrderRef, OrderStatus, OrderSummary, PollSpec, FiatProvider, Quote, QuoteLimits, Recovery, Refund, ReportSpec, SelectOption, StatusHistoryEntry, FiatStepResponse, Surface, SurfaceKind, SurfaceProvider, KYCProvider, Transition, TransitionInputs, TransitionParams, Tx } from './types';
+import type { BlockedReason, CryptoAmount, FailureReason, FeeLine, FiatEndpoint, FieldSpec, FlowState, FormDescriptor, FormField, FormFieldType, Instructions, InstructionField, Instrument, JsonValue, FiatAmount, OrderRef, OrderStatus, OrderSummary, PollSpec, FiatProvider, Quote, QuoteLimitRange, QuoteLimits, Recovery, Refund, ReportSpec, SelectOption, StatusHistoryEntry, FiatStepResponse, Surface, SurfaceKind, SurfaceProvider, KYCProvider, Transition, TransitionInputs, TransitionParams, Tx } from './types';
 export declare const JsonSchema: z.ZodType<JsonValue>;
 export declare const HTTP_VERBS: readonly ["GET", "POST"];
 /** `"POST /fiat/session/verify"`, `"GET /fiat/orders/o_31c"` — the verb rides the string. */
@@ -43,6 +43,7 @@ export declare const FiatAmountSchema: z.ZodType<FiatAmount>;
 export declare const CryptoAmountSchema: z.ZodType<CryptoAmount>;
 export declare const FeeLineSchema: z.ZodType<FeeLine>;
 export declare const QuoteSchema: z.ZodType<Quote>;
+export declare const QuoteLimitRangeSchema: z.ZodType<QuoteLimitRange>;
 export declare const QuoteLimitsSchema: z.ZodType<QuoteLimits>;
 export declare const InstrumentSchema: z.ZodType<Instrument>;
 export declare const OrderRefSchema: z.ZodType<OrderRef>;

package/dist/table.js

@@ -36,7 +36,7 @@ __export(table_exports, {
 module.exports = __toCommonJS(table_exports);
 
 // package.json
-var version = "0.9.0";
+var version = "0.10.0";
 
 // src/table.ts
 var TABLE_VERSION = version;

package/dist/table.mjs

@@ -11,7 +11,7 @@ import {
   tableEntry,
   unofferedEndpoints,
   unreachableStates
-} from "./chunk-5QGVY5Z4.mjs";
+} from "./chunk-BAGIBS54.mjs";
 export {
   DOCUMENTED_ENDPOINTS,
   STATE_KEYS,

package/dist/types.d.ts

@@ -151,10 +151,23 @@ export interface Quote {
     paymentMethod: PaymentMethodCategory;
     expiresAt: string;
 }
-/** Input bounds for the quote screen. Decimal strings in the quote currency. */
+/** One inclusive amount interval the current routing set can actually serve. */
+export interface QuoteLimitRange {
+    min: string;
+    max: string;
+}
+/**
+ * Input bounds for the quote screen. Decimal strings in the quote currency.
+ *
+ * `min`/`max` remain the bounding envelope for clients on contract <=0.9. A routing set can have
+ * gaps (one path serves a low interval and another a higher interval), so new emitters also carry
+ * the exact sorted, non-overlapping intervals in `serviceableRanges`. The field is optional only so
+ * an upgraded client can cold-render an older recorded response during a rolling deployment.
+ */
 export interface QuoteLimits {
     min: string;
     max: string;
+    serviceableRanges?: QuoteLimitRange[];
 }
 /** Deferred to the credit-card iteration (FE doc port ledger) — optional wherever it appears. */
 export interface Instrument {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fun-xyz/fiat-contract",
-  "version": "0.9.0",
+  "version": "0.10.0",
   "description": "Published conformance contract for Fun's headless fiat onramp: FlowState/Transition types, zod schemas, the transition table as data, recorded fixtures, assertion helpers.",
   "license": "MIT",
   "repository": {