@fun-xyz/fiat-contract 0.22.0 → 0.22.2

package/README.md

@@ -127,22 +127,24 @@ three kinds:
 | --- | --- | --- |
 | `observe` | `checkout`, and `credentials` (`customerId`, `accessToken`) once the SDK has them | writes nothing new |
 | `kyc` | `checkout`, `credentials`, `values` keyed by `KycFieldId` (no form id) | drops values MoonPay no longer asks for |
-| `order` | `orderId`, `transactionId?`, `quotedAmount` | returns the recorded order |
+| `order` | `orderId`, `transactionId?`, `quotedAmount`, `geo?` (the checkout's) | returns the recorded order |
 
 `observe` and `kyc` answer a `MoonPayStepResponse`, which says what the backend needs next:
 
 | `status` | Carries | The client then |
 | --- | --- | --- |
 | `TERMS` | `stage`, `documents` (at least one, all at `stage`) | sends `POST /fiat/terms`, then `observe` |
-| `SDK_AUTH` | `sessionToken`, `quoteInput` | runs the MoonPay connection check, then `observe` with credentials |
-| `KYC` | `fields`, `fieldErrors?` (each naming a field in `fields`) | shows the shared form, then sends `kyc` |
+| `SDK_AUTH` | `sessionToken`, `quoteInput`, `resetConnection?` (`true` when the device's MoonPay connection is another buyer's) | resets the connection when asked, runs the MoonPay connection check, then `observe` with credentials |
+| `KYC` | `fields`, `fieldErrors?` (each naming a field in `fields`, with `code?` `PHONE_IN_USE` on `PHONE_NUMBER` or `TAX_ID_IN_USE` on `TAX_IDENTIFIER` when another MoonPay customer holds the value) | shows the shared form, then sends `kyc` |
 | `PENDING` | `retryAfterMs` (at most 60 s) | sends `observe` after the delay, never `kyc` again |
 | `READY` | `orderId`, `quoteInput` | mounts Apple Pay, then sends `order` after the charge |
 | `REFUSED` | `reason` (`NOT_ELIGIBLE`, `DOCUMENTS_REQUIRED`, `FINAL_REJECTION`, `CUSTOMER_MISMATCH`), `recovery: REQUOTE \| NONE` | exits the provider flow |
 
 `order` runs after every charge attempt, a failed one too, and answers a `MoonPayOrderResponse`.
 `transactionId` is optional because a failed charge may have none; without it the backend records the
-failed charges MoonPay lists for `orderId`. `quotedAmount` is the fiat amount the quote showed. A
+failed charges MoonPay lists for `orderId`. `quotedAmount` is the fiat amount the quote showed.
+`geo` is the same object `observe` sends in `checkout`; the order records its `alpha2` as its
+country, and no country without it. A
 failed charge answers `DONE` with the order in `FAILED`, and the client requotes for a new `orderId`.
 After a failed charge with no `transactionId`, the client caps its `PENDING` polls.
 

package/dist/{chunk-SJ7V3YOM.mjs → chunk-3HCZ6JBJ.mjs}

@@ -6,4 +6,4 @@ var MOONPAY_ENDPOINTS = {
 export {
   MOONPAY_ENDPOINTS
 };
-//# sourceMappingURL=chunk-SJ7V3YOM.mjs.map
+//# sourceMappingURL=chunk-3HCZ6JBJ.mjs.map

package/dist/{chunk-7OUDI3JX.mjs → chunk-DTHUNDA7.mjs}

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.22.0";
+var version = "0.22.2";
 
 // src/table.ts
 var TABLE_VERSION = version;
@@ -514,4 +514,4 @@ export {
   tableEntry,
   isTerminal
 };
-//# sourceMappingURL=chunk-7OUDI3JX.mjs.map
+//# sourceMappingURL=chunk-DTHUNDA7.mjs.map

package/dist/index.js

@@ -1067,7 +1067,7 @@ var $stepResponse = import_zod.z.union([$providerBoundStepResponse, $blockedStep
 var FiatStepResponseSchema = $stepResponse;
 
 // package.json
-var version = "0.22.0";
+var version = "0.22.2";
 
 // src/table.ts
 var TABLE_VERSION = version;
@@ -2681,11 +2681,12 @@ var FIAT_CURRENCY_CODES2 = Object.keys(FIAT_CURRENCY_NAMES);
 var obj2 = (shape) => import_zod2.z.object(shape).strict();
 var $nonEmpty = import_zod2.z.string().refine((value) => value.trim().length > 0, "must not be blank");
 var hasUniqueIds2 = (ids) => new Set(ids).size === ids.length;
+var $geo = obj2({ alpha2: import_zod2.z.string().regex(/^[A-Z]{2}$/), region: $nonEmpty.optional(), ip: $nonEmpty.optional() });
 var $checkout = obj2({
   amount: FiatAmountSchema,
   destination: obj2({ asset: $nonEmpty, network: $nonEmpty }),
   paymentMethod: import_zod2.z.literal("apple_pay"),
-  geo: obj2({ alpha2: import_zod2.z.string().regex(/^[A-Z]{2}$/), region: $nonEmpty.optional(), ip: $nonEmpty.optional() })
+  geo: $geo
 });
 var MoonPayCheckoutSchema = $checkout;
 var $credentials = obj2({ customerId: $nonEmpty, accessToken: $nonEmpty });
@@ -2698,7 +2699,13 @@ var $intentRequest = import_zod2.z.discriminatedUnion("kind", [
     credentials: $credentials,
     values: import_zod2.z.record(KycFieldIdSchema, import_zod2.z.string()).refine((values) => Object.keys(values).length > 0, "values must not be empty")
   }),
-  obj2({ kind: import_zod2.z.literal("order"), orderId: $nonEmpty, transactionId: $nonEmpty.optional(), quotedAmount: FiatAmountSchema })
+  obj2({
+    kind: import_zod2.z.literal("order"),
+    orderId: $nonEmpty,
+    transactionId: $nonEmpty.optional(),
+    quotedAmount: FiatAmountSchema,
+    geo: $geo.optional()
+  })
 ]);
 var MoonPayIntentRequestSchema = $intentRequest;
 var $quoteInput = obj2({
@@ -2711,11 +2718,12 @@ var $quoteInput = obj2({
 var MoonPayQuoteInputSchema = $quoteInput;
 var $stepRefusal = import_zod2.z.enum(["NOT_ELIGIBLE", "DOCUMENTS_REQUIRED", "FINAL_REJECTION", "CUSTOMER_MISMATCH"]);
 var $orderRefusal = import_zod2.z.enum(["CUSTOMER_MISMATCH", "WALLET_MISMATCH", "UNRECORDABLE"]);
-var $fieldError = obj2({ fieldId: $nonEmpty, message: $nonEmpty });
+var FIELD_OF_CODE = { PHONE_IN_USE: "PHONE_NUMBER", TAX_ID_IN_USE: "TAX_IDENTIFIER" };
+var $fieldError = obj2({ fieldId: $nonEmpty, message: $nonEmpty, code: import_zod2.z.enum(["PHONE_IN_USE", "TAX_ID_IN_USE"]).optional() });
 var $pending = obj2({ status: import_zod2.z.literal("PENDING"), retryAfterMs: import_zod2.z.number().int().positive().max(6e4) });
 var $stepStatus = import_zod2.z.discriminatedUnion("status", [
   obj2({ status: import_zod2.z.literal("TERMS"), stage: import_zod2.z.enum(["CHECKOUT", "KYC"]), documents: import_zod2.z.array(TermsDocumentSchema).min(1) }),
-  obj2({ status: import_zod2.z.literal("SDK_AUTH"), sessionToken: $nonEmpty, quoteInput: $quoteInput }),
+  obj2({ status: import_zod2.z.literal("SDK_AUTH"), sessionToken: $nonEmpty, quoteInput: $quoteInput, resetConnection: import_zod2.z.literal(true).optional() }),
   obj2({ status: import_zod2.z.literal("KYC"), fields: import_zod2.z.array(FormFieldSchema).min(1), fieldErrors: import_zod2.z.array($fieldError).min(1).optional() }),
   $pending,
   obj2({ status: import_zod2.z.literal("READY"), orderId: $nonEmpty, quoteInput: $quoteInput }),
@@ -2738,6 +2746,9 @@ var $stepResponse2 = $stepStatus.superRefine((response, context) => {
     if (response.fieldErrors?.some((error) => !fieldIds.includes(error.fieldId))) {
       context.addIssue({ code: "custom", path: ["fieldErrors"], message: "a field error must name a field in this response" });
     }
+    if (response.fieldErrors?.some((error) => error.code && FIELD_OF_CODE[error.code] !== error.fieldId)) {
+      context.addIssue({ code: "custom", path: ["fieldErrors"], message: "a field error code must match its field" });
+    }
   }
 });
 var MoonPayStepResponseSchema = $stepResponse2;

package/dist/index.mjs

@@ -12,10 +12,10 @@ import {
   tableEntry,
   unofferedEndpoints,
   unreachableStates
-} from "./chunk-7OUDI3JX.mjs";
+} from "./chunk-DTHUNDA7.mjs";
 import {
   MOONPAY_ENDPOINTS
-} from "./chunk-SJ7V3YOM.mjs";
+} from "./chunk-3HCZ6JBJ.mjs";
 import {
   FIAT_TERMS_ENDPOINT,
   FUN_KYC_CONSENT_DOCUMENTS,
@@ -2021,11 +2021,12 @@ var FIAT_CURRENCY_CODES2 = Object.keys(FIAT_CURRENCY_NAMES);
 var obj2 = (shape) => z2.object(shape).strict();
 var $nonEmpty = z2.string().refine((value) => value.trim().length > 0, "must not be blank");
 var hasUniqueIds2 = (ids) => new Set(ids).size === ids.length;
+var $geo = obj2({ alpha2: z2.string().regex(/^[A-Z]{2}$/), region: $nonEmpty.optional(), ip: $nonEmpty.optional() });
 var $checkout = obj2({
   amount: FiatAmountSchema,
   destination: obj2({ asset: $nonEmpty, network: $nonEmpty }),
   paymentMethod: z2.literal("apple_pay"),
-  geo: obj2({ alpha2: z2.string().regex(/^[A-Z]{2}$/), region: $nonEmpty.optional(), ip: $nonEmpty.optional() })
+  geo: $geo
 });
 var MoonPayCheckoutSchema = $checkout;
 var $credentials = obj2({ customerId: $nonEmpty, accessToken: $nonEmpty });
@@ -2038,7 +2039,13 @@ var $intentRequest = z2.discriminatedUnion("kind", [
     credentials: $credentials,
     values: z2.record(KycFieldIdSchema, z2.string()).refine((values) => Object.keys(values).length > 0, "values must not be empty")
   }),
-  obj2({ kind: z2.literal("order"), orderId: $nonEmpty, transactionId: $nonEmpty.optional(), quotedAmount: FiatAmountSchema })
+  obj2({
+    kind: z2.literal("order"),
+    orderId: $nonEmpty,
+    transactionId: $nonEmpty.optional(),
+    quotedAmount: FiatAmountSchema,
+    geo: $geo.optional()
+  })
 ]);
 var MoonPayIntentRequestSchema = $intentRequest;
 var $quoteInput = obj2({
@@ -2051,11 +2058,12 @@ var $quoteInput = obj2({
 var MoonPayQuoteInputSchema = $quoteInput;
 var $stepRefusal = z2.enum(["NOT_ELIGIBLE", "DOCUMENTS_REQUIRED", "FINAL_REJECTION", "CUSTOMER_MISMATCH"]);
 var $orderRefusal = z2.enum(["CUSTOMER_MISMATCH", "WALLET_MISMATCH", "UNRECORDABLE"]);
-var $fieldError = obj2({ fieldId: $nonEmpty, message: $nonEmpty });
+var FIELD_OF_CODE = { PHONE_IN_USE: "PHONE_NUMBER", TAX_ID_IN_USE: "TAX_IDENTIFIER" };
+var $fieldError = obj2({ fieldId: $nonEmpty, message: $nonEmpty, code: z2.enum(["PHONE_IN_USE", "TAX_ID_IN_USE"]).optional() });
 var $pending = obj2({ status: z2.literal("PENDING"), retryAfterMs: z2.number().int().positive().max(6e4) });
 var $stepStatus = z2.discriminatedUnion("status", [
   obj2({ status: z2.literal("TERMS"), stage: z2.enum(["CHECKOUT", "KYC"]), documents: z2.array(TermsDocumentSchema).min(1) }),
-  obj2({ status: z2.literal("SDK_AUTH"), sessionToken: $nonEmpty, quoteInput: $quoteInput }),
+  obj2({ status: z2.literal("SDK_AUTH"), sessionToken: $nonEmpty, quoteInput: $quoteInput, resetConnection: z2.literal(true).optional() }),
   obj2({ status: z2.literal("KYC"), fields: z2.array(FormFieldSchema).min(1), fieldErrors: z2.array($fieldError).min(1).optional() }),
   $pending,
   obj2({ status: z2.literal("READY"), orderId: $nonEmpty, quoteInput: $quoteInput }),
@@ -2078,6 +2086,9 @@ var $stepResponse2 = $stepStatus.superRefine((response, context) => {
     if (response.fieldErrors?.some((error) => !fieldIds.includes(error.fieldId))) {
       context.addIssue({ code: "custom", path: ["fieldErrors"], message: "a field error must name a field in this response" });
     }
+    if (response.fieldErrors?.some((error) => error.code && FIELD_OF_CODE[error.code] !== error.fieldId)) {
+      context.addIssue({ code: "custom", path: ["fieldErrors"], message: "a field error code must match its field" });
+    }
   }
 });
 var MoonPayStepResponseSchema = $stepResponse2;

package/dist/providers/moonpay.d.ts

@@ -60,13 +60,15 @@ export type MoonPayIntentRequest =
 /**
  * After every charge attempt, a failed one too. `transactionId` is from the Apple Pay event when it
  * has one; without it the backend records the failed charges MoonPay lists for `orderId`.
- * `quotedAmount` is the fiat amount the buyer saw on the quote.
+ * `quotedAmount` is the fiat amount the buyer saw on the quote. `geo` is the checkout's, as sent on
+ * `observe`; the order records its `alpha2`, and no country when it is absent.
  */
  | {
     kind: 'order';
     orderId: string;
     transactionId?: string;
     quotedAmount: FiatAmount;
+    geo?: MoonPayCheckout['geo'];
 };
 export type MoonPayIntentKind = MoonPayIntentRequest['kind'];
 /**
@@ -101,10 +103,16 @@ export type MoonPayStepRefusal = 'NOT_ELIGIBLE' | 'DOCUMENTS_REQUIRED' | 'FINAL_
  * assertion's. `UNRECORDABLE`: a charge no retry can record, held for refund review.
  */
 export type MoonPayOrderRefusal = 'CUSTOMER_MISMATCH' | 'WALLET_MISMATCH' | 'UNRECORDABLE';
-/** A reason on one field of a `KYC` response. `fieldId` names a field in that response. */
+/** Another MoonPay customer already holds the value; only a different one goes through. */
+export type MoonPayFieldErrorCode = 'PHONE_IN_USE' | 'TAX_ID_IN_USE';
+/**
+ * A reason on one field of a `KYC` response. `fieldId` names a field in that response. `code` is set
+ * only for a refusal the client words itself: `PHONE_IN_USE` on `PHONE_NUMBER`, `TAX_ID_IN_USE` on `TAX_IDENTIFIER`.
+ */
 export interface MoonPayFieldError {
     fieldId: string;
     message: string;
+    code?: MoonPayFieldErrorCode;
 }
 /** The answer to `observe` and `kyc`. */
 export type MoonPayStepResponse = 
@@ -114,11 +122,15 @@ export type MoonPayStepResponse =
     stage: TermsStage;
     documents: TermsDocument[];
 }
-/** Run the MoonPay connection check with `sessionToken`, then `observe` with the credentials. */
+/**
+ * Run the MoonPay connection check with `sessionToken`, then `observe` with the credentials.
+ * `resetConnection`: the device's connection is another buyer's, so reset it before the check.
+ */
  | {
     status: 'SDK_AUTH';
     sessionToken: string;
     quoteInput: MoonPayQuoteInput;
+    resetConnection?: true;
 }
 /** Show the shared form, then send `kyc`. */
  | {

package/dist/providers/moonpay.mjs

@@ -1,6 +1,6 @@
 import {
   MOONPAY_ENDPOINTS
-} from "../chunk-SJ7V3YOM.mjs";
+} from "../chunk-3HCZ6JBJ.mjs";
 export {
   MOONPAY_ENDPOINTS
 };

package/dist/table.js

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

package/dist/table.mjs

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

package/package.json

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