@fun-xyz/fiat-contract 0.23.0 → 0.25.0

package/dist/routing.d.ts

@@ -21,7 +21,7 @@ import type { CountryCode, FiatCurrencyCode, PaymentMethodCategory } from './cod
 import type { FiatAmount, FiatProvider, QuoteLimitRange } from './types';
 export declare const ROUTING_ENDPOINTS: {
     readonly table: "GET /fiat/routing/table";
-    /** Temporary: each provider's `intent` route replaces it. */
+    /** Temporary: `POST /fiat/next` replaces it for each provider that moves there. */
     readonly quote: "POST /fiat/routing/quote";
 };
 /**
@@ -82,13 +82,8 @@ export interface FiatRoutingTableResponse {
     /** In request order, duplicates removed. */
     methods: RoutingTableMethod[];
 }
-/**
- * The `POST /fiat/quote` body plus the one `provider` to price, which is the interval's first
- * provider, and never `routingOverrides`. The response is the same `FiatStepResponse` as
- * `POST /fiat/quote`; a refusal is a `FiatRoutingQuoteErrorBody`.
- */
-export interface FiatRoutingQuoteRequest {
-    provider: RoutingProvider;
+/** The `POST /fiat/quote` body without `routingOverrides`: everything but which providers to price. */
+export interface FiatRoutingQuoteTerms {
     fiatCurrency: FiatCurrencyCode;
     /** A positive decimal string with no leading zero, exponent or sign (`"20"`, `"20.5"`). */
     fiatAmount: string;
@@ -107,6 +102,25 @@ export interface FiatRoutingQuoteRequest {
     };
     prepareSessionAuth?: boolean;
 }
+/**
+ * `POST /fiat/routing/quote`: the terms plus which providers to price, in one of two forms.
+ *
+ * - `providers`: the interval's providers, best first. The backend prices the first, and falls
+ *   through to the next on a refusal that is that provider's alone (a `FiatNoRouteError` of any
+ *   `reason`, or either amount error), as the client did before. It answers the first provider that
+ *   prices, or the last provider's refusal. Any other refusal stops at once.
+ * - `provider`: one provider only, with no fall-through. Kept for clients that fall through themselves.
+ *
+ * The response is the same `FiatStepResponse` as `POST /fiat/quote`, and its `provider` names the
+ * one that priced. A refusal is a `FiatRoutingQuoteErrorBody`.
+ */
+export type FiatRoutingQuoteRequest = FiatRoutingQuoteTerms & ({
+    providers: RoutingProvider[];
+    provider?: never;
+} | {
+    provider: RoutingProvider;
+    providers?: never;
+});
 /** One serviceable range of the named provider. `userMax` is this buyer's own ceiling inside it, `null` when unmeasured. */
 export interface RoutingServiceableRange {
     min: FiatAmount;
@@ -160,8 +174,9 @@ export type RoutingFaultErrorBody = ErrorBodyFields & {
 export type FiatRoutingTableErrorBody = RoutingRateLimitedErrorBody | RoutingFaultErrorBody;
 /**
  * `POST /fiat/routing/quote` refusals. A `FiatNoRouteError` (any `reason`) or either amount error is
- * the named provider's alone: quote the interval's next provider. Anything else stops the fall-through:
- * a validation or auth refusal, a 5xx, or no provider left to try.
+ * the named provider's alone, so the next provider may still price: with `providers` the backend
+ * tries it, with `provider` the client does. Anything else stops the fall-through: a validation or
+ * auth refusal, a 5xx, or no provider left to try.
  */
 export type FiatRoutingQuoteErrorBody = RoutingNoRouteErrorBody | RoutingAmountErrorBody | RoutingFaultErrorBody;
 export {};

package/dist/routing.js

@@ -25,7 +25,7 @@ __export(routing_exports, {
 module.exports = __toCommonJS(routing_exports);
 var ROUTING_ENDPOINTS = {
   table: "GET /fiat/routing/table",
-  /** Temporary: each provider's `intent` route replaces it. */
+  /** Temporary: `POST /fiat/next` replaces it for each provider that moves there. */
   quote: "POST /fiat/routing/quote"
 };
 //# sourceMappingURL=routing.js.map

package/dist/routing.mjs

@@ -1,6 +1,6 @@
 import {
   ROUTING_ENDPOINTS
-} from "./chunk-KYE2HYV5.mjs";
+} from "./chunk-WEXD7UEE.mjs";
 export {
   ROUTING_ENDPOINTS
 };

package/dist/schemas.d.ts

@@ -28,9 +28,9 @@
  */
 import { z } from 'zod';
 import type { UsStateCode } from './codes';
-import type { BlockedReason, CryptoAmount, FailureReason, FeeLine, FiatAmount, FiatEndpoint, FiatProvider, FiatStepResponse, FieldSpec, FlowState, FormDescriptor, FormField, FormFieldType, InstructionField, Instructions, Instrument, JsonValue, KYCProvider, OrderRef, OrderStatus, OrderSummary, PollSpec, PreparedPayment, PaymentSurface, Quote, QuoteLimitRange, QuoteLimits, Recovery, Refund, ReportSpec, SelectOption, StatusHistoryEntry, Surface, PreferredIdentityDocument, KycFieldId, ClientExecutedDelivery, KycSdkResultReport, SurfaceKind, SurfaceProvider, TermsAcceptance, Transition, TransitionInputs, TransitionParams, Tx } from './types';
+import type { BlockedReason, CryptoAmount, FailureReason, FeeLine, FiatAmount, FiatEndpoint, FiatProvider, FiatStepResponse, FieldSpec, FlowState, FormDescriptor, FormField, FormFieldType, InstructionField, Instructions, Instrument, JsonValue, KYCProvider, OrderRef, OrderStatus, OrderSummary, PollSpec, PreparedPayment, PaymentSurface, Quote, QuoteLimitRange, QuoteLimits, Recovery, Refund, ReportSpec, SelectOption, StatusHistoryEntry, Surface, PreferredIdentityDocument, KycFieldId, ClientExecutedDelivery, KycSdkResultReport, SurfaceKind, SurfaceProvider, TermsAcceptance, Transition, TransitionInputs, TransitionParams, Tx, FiatGeo, FiatNextRequest } from './types';
 import type { FiatTermsErrorBody, FiatTermsRequest, FiatTermsResponse, TermsDocument, TermsDocumentAcceptance } from './terms';
-import type { FiatRoutingQuoteErrorBody, FiatRoutingQuoteRequest, FiatRoutingTableErrorBody, FiatRoutingTableQuery, FiatRoutingTableResponse } from './routing';
+import type { FiatRoutingQuoteErrorBody, FiatRoutingQuoteRequest, FiatRoutingQuoteTerms, FiatRoutingTableErrorBody, FiatRoutingTableQuery, FiatRoutingTableResponse } from './routing';
 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. */
@@ -114,9 +114,12 @@ export declare const FiatTermsResponseSchema: z.ZodType<FiatTermsResponse>;
 export declare const FiatTermsErrorBodySchema: z.ZodType<FiatTermsErrorBody>;
 export declare const FiatRoutingTableQuerySchema: z.ZodType<FiatRoutingTableQuery>;
 export declare const FiatRoutingTableResponseSchema: z.ZodType<FiatRoutingTableResponse>;
+export declare const FiatRoutingQuoteTermsSchema: z.ZodType<FiatRoutingQuoteTerms>;
 export declare const FiatRoutingQuoteRequestSchema: z.ZodType<FiatRoutingQuoteRequest>;
 export declare const FiatRoutingTableErrorBodySchema: z.ZodType<FiatRoutingTableErrorBody>;
 export declare const FiatRoutingQuoteErrorBodySchema: z.ZodType<FiatRoutingQuoteErrorBody>;
+export declare const FiatGeoSchema: z.ZodType<FiatGeo>;
+export declare const FiatNextRequestSchema: z.ZodType<FiatNextRequest>;
 export declare const FiatStepResponseSchema: z.ZodType<FiatStepResponse>;
 export {};
 //# sourceMappingURL=schemas.d.ts.map

package/dist/table.js

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

package/dist/table.mjs

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

package/dist/terms.d.ts

@@ -2,7 +2,7 @@
  * The platform terms route: `POST /fiat/terms`, shared by every provider.
  *
  * A checkout shows the user documents to accept. `CHECKOUT` documents are the constants below;
- * `KYC` documents arrive in a provider flow's `TERMS` response. The user's Continue tap is the
+ * `KYC` documents arrive in a provider flow's consent prompt. The user's Continue tap is the
  * acceptance, and the client records it here before the next provider call. A repeat writes nothing.
  *
  * Zero runtime dependencies, so production React Native code can import it. The zod schemas are
@@ -39,7 +39,7 @@ export interface FiatTermsRequest {
     /** One per document the screen showed, each document at most once. */
     acceptances: TermsDocumentAcceptance[];
 }
-/** The recorded document ids. The client then calls the provider's `intent`. */
+/** The recorded document ids. The client then calls `POST /fiat/next`. */
 export interface FiatTermsResponse {
     recorded: string[];
 }

package/dist/terms.mjs

@@ -3,7 +3,7 @@ import {
   FUN_KYC_CONSENT_DOCUMENTS,
   PROVIDER_CHECKOUT_DOCUMENTS,
   PUBLISHED_TERMS_DOCUMENTS
-} from "./chunk-5GRPYE2U.mjs";
+} from "./chunk-CRNKRIKR.mjs";
 export {
   FIAT_TERMS_ENDPOINT,
   FUN_KYC_CONSENT_DOCUMENTS,

package/dist/types.d.ts

@@ -715,7 +715,7 @@ export type FiatStepResponse = (FiatStepResponseBase & {
     /** Optional future payment artifact; never one of this response's currently active transitions. */
     preparedPayment?: PreparedPayment;
     /**
-     * The provider runs its own flow from here (`POST /fiat/providers/{provider}/intent`). Present
+     * The provider runs its own flow from here (`POST /fiat/next`). Present
      * only on a `QUOTE`, when the request's `handoffs` named this provider; the response then
      * carries no transitions.
      */
@@ -723,5 +723,20 @@ export type FiatStepResponse = (FiatStepResponseBase & {
         provider: FiatProvider;
     };
 });
+/** The geo endpoint's response, sent on every `/next` request. `alpha2` is ISO 3166-1 alpha-2. */
+export type FiatGeo = {
+    alpha2: string;
+    region?: string;
+    ip?: string;
+};
+/**
+ * The body of every `POST /fiat/next`: `provider`, `geo`, and the provider's own request, which
+ * names its `action`. Each provider defines its actions and their fields (`./moonpay`).
+ */
+export type FiatNextRequest = {
+    provider: FiatProvider;
+    action: string;
+    geo: FiatGeo;
+} & Record<string, unknown>;
 export {};
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fun-xyz/fiat-contract",
-  "version": "0.23.0",
+  "version": "0.25.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": {

package/dist/chunk-3HCZ6JBJ.mjs

@@ -1,9 +0,0 @@
-// src/providers/moonpay.ts
-var MOONPAY_ENDPOINTS = {
-  intent: "POST /fiat/providers/moonpay/intent"
-};
-
-export {
-  MOONPAY_ENDPOINTS
-};
-//# sourceMappingURL=chunk-3HCZ6JBJ.mjs.map