@fun-xyz/fiat-contract 0.22.2 → 0.24.0

package/dist/index.mjs

@@ -12,16 +12,19 @@ import {
   tableEntry,
   unofferedEndpoints,
   unreachableStates
-} from "./chunk-DTHUNDA7.mjs";
+} from "./chunk-IPOPANXS.mjs";
 import {
   MOONPAY_ENDPOINTS
-} from "./chunk-3HCZ6JBJ.mjs";
+} from "./chunk-T5JAYOWY.mjs";
 import {
   FIAT_TERMS_ENDPOINT,
   FUN_KYC_CONSENT_DOCUMENTS,
   PROVIDER_CHECKOUT_DOCUMENTS,
   PUBLISHED_TERMS_DOCUMENTS
-} from "./chunk-5GRPYE2U.mjs";
+} from "./chunk-CRNKRIKR.mjs";
+import {
+  ROUTING_ENDPOINTS
+} from "./chunk-5UEPWL7B.mjs";
 
 // src/codes.ts
 var US_STATE_CODES = [
@@ -859,6 +862,8 @@ var $providerBoundFlowState = z.union([
 var $flowState = z.union([$providerBoundFlowState, $blockedState]);
 var FlowStateSchema = $flowState;
 var $nonBlank = z.string().refine((value) => value.trim().length > 0, "must not be blank");
+var $isoInstant = z.string().datetime({ offset: true });
+var $errorBodyFields = { errorMsg: z.string(), reqId: z.string().optional() };
 var $termsStage = z.enum(["CHECKOUT", "KYC"]);
 var $termsDocument = obj({
   id: $nonBlank,
@@ -874,7 +879,7 @@ var $termsAcceptance = obj({
   documentId: $nonBlank,
   version: $nonBlank,
   contentDigest: $nonBlank,
-  acceptedAt: z.string().datetime({ offset: true })
+  acceptedAt: $isoInstant
 });
 var TermsDocumentAcceptanceSchema = $termsAcceptance;
 var $termsRequest = obj({
@@ -886,12 +891,121 @@ var $termsResponse = obj({ recorded: z.array($nonBlank) });
 var FiatTermsResponseSchema = $termsResponse;
 var $termsErrorBody = obj({
   errorCode: $nonBlank,
-  errorMsg: z.string(),
-  reqId: z.string().optional(),
+  ...$errorBodyFields,
   reason: z.enum(["STALE_TERMS", "INVALID_REQUEST", "RATE_LIMITED", "PROVIDER_UNAVAILABLE"]),
   recovery: z.enum(["RETRY", "REQUOTE", "NONE"])
 });
 var FiatTermsErrorBodySchema = $termsErrorBody;
+var $decimalAmount = z.string().regex(/^(?:0|[1-9]\d*)(?:\.\d+)?$/, "must be a decimal string");
+var compareDecimals = (left, right) => {
+  const [leftWhole = "", leftFraction = ""] = left.split(".");
+  const [rightWhole = "", rightFraction = ""] = right.split(".");
+  if (leftWhole.length !== rightWhole.length) return leftWhole.length - rightWhole.length;
+  const width = Math.max(leftFraction.length, rightFraction.length);
+  const leftDigits = leftWhole + leftFraction.padEnd(width, "0");
+  const rightDigits = rightWhole + rightFraction.padEnd(width, "0");
+  return leftDigits < rightDigits ? -1 : leftDigits > rightDigits ? 1 : 0;
+};
+var $countryCode = z.enum(Object.keys(CountryCode));
+var $routingProvider = $provider.extract(["TRANSAK", "BANXA", "MOONPAY", "STRIPE", "COINBASE"]);
+var $optionalGeoField = z.union([$nonBlank, z.literal("")]).optional();
+var US_REGION_REQUIRED = "a US buyer needs a US state code as region";
+var hasUsRegion = (country, region) => country !== "US" || UsStateCodeSchema.safeParse(region).success;
+var $routingTableQuery = obj({
+  fiatCurrencyCode: z.enum(FIAT_CURRENCY_CODES).optional(),
+  cryptoCurrencyCode: $nonBlank,
+  chainId: $nonBlank,
+  country: $countryCode,
+  region: $optionalGeoField,
+  methods: z.string().refine(
+    (methods) => methods.split(",").every((method) => PAYMENT_METHOD_CATEGORIES.includes(method.trim())),
+    "must be comma-separated payment method categories"
+  )
+}).refine((query) => hasUsRegion(query.country, query.region), { message: US_REGION_REQUIRED, path: ["region"] });
+var FiatRoutingTableQuerySchema = $routingTableQuery;
+var $routingTableProvider = obj({
+  provider: $routingProvider,
+  next: z.enum(["READY", "AUTH", "DECLARATIVE_KYC", "DOCUMENTARY_KYC", "PENDING_REVIEW"]),
+  visibility: z.enum(["COMPLETE", "PARTIAL", "AUTH_GATED"])
+});
+var $routingTableInterval = obj({
+  min: $decimalAmount,
+  max: $decimalAmount,
+  providers: z.array($routingTableProvider).min(1).refine((providers) => hasUniqueIds(providers.map((entry) => entry.provider)), "each provider is listed once")
+}).refine((interval) => compareDecimals(interval.min, interval.max) <= 0, { message: "min must not exceed max", path: ["max"] });
+var $routingTableMethod = obj({
+  method: z.enum(PAYMENT_METHOD_CATEGORIES),
+  unavailableReason: z.enum(["USER_LIMIT", "KYC_REJECTED", "PROVIDER_OUTAGE", "NOT_SERVED"]).optional(),
+  intervals: z.array($routingTableInterval).superRefine((intervals, context) => {
+    intervals.forEach((interval, index) => {
+      const previous = intervals[index - 1];
+      if (previous !== void 0 && compareDecimals(interval.min, previous.max) <= 0) {
+        context.addIssue({ code: "custom", path: [index, "min"], message: "intervals are sorted and do not overlap" });
+      }
+    });
+  })
+}).refine((method) => method.unavailableReason === void 0 || method.intervals.length === 0, {
+  message: "unavailableReason only with no interval",
+  path: ["unavailableReason"]
+});
+var $routingTableResponse = obj({
+  expiresAt: $isoInstant,
+  methods: z.array($routingTableMethod).refine((methods) => hasUniqueIds(methods.map((entry) => entry.method)), "each method is listed once")
+});
+var FiatRoutingTableResponseSchema = $routingTableResponse;
+var $routingQuoteRequest = obj({
+  provider: $routingProvider,
+  fiatCurrency: z.enum(FIAT_CURRENCY_CODES),
+  fiatAmount: $decimalAmount.refine((amount) => Number(amount) > 0, "must be positive"),
+  cryptoCurrencyCode: $nonBlank,
+  chainId: $nonBlank,
+  paymentMethodId: z.enum(PAYMENT_METHOD_CATEGORIES),
+  geo: obj({ alpha2: $countryCode, region: $optionalGeoField, ip: $optionalGeoField, city: z.string().optional() }).refine(
+    (geo) => hasUsRegion(geo.alpha2, geo.region),
+    { message: US_REGION_REQUIRED, path: ["region"] }
+  ),
+  prepareSessionAuth: z.boolean().optional()
+});
+var FiatRoutingQuoteRequestSchema = $routingQuoteRequest;
+var $routingServiceableRange = obj({ min: $money, max: $money, userMax: $money.nullable().optional() });
+var $noRouteFields = {
+  ...$errorBodyFields,
+  errorCode: z.literal("FiatNoRouteError"),
+  serviceableRanges: z.array($routingServiceableRange),
+  retryable: z.boolean()
+};
+var $routingNoRouteErrorBody = z.union([
+  obj({ ...$noRouteFields, reason: z.enum(["NO_CANDIDATE", "PROVIDER_DECLINED", "PROVIDER_OUTAGE", "KYC_REJECTED"]) }),
+  obj({ ...$noRouteFields, reason: z.literal("USER_LIMIT"), code: z.literal("LIMITS_EXCEEDED"), recovery: z.literal("REQUOTE") })
+]);
+var $amountErrorFields = { ...$errorBodyFields, fiatCurrencyCode: z.enum(FIAT_CURRENCY_CODES) };
+var $routingAmountErrorBody = z.union([
+  obj({ ...$amountErrorFields, errorCode: z.literal("FiatAmountBelowMinimumError"), minFiatAmount: $decimalAmount }),
+  obj({ ...$amountErrorFields, errorCode: z.literal("FiatAmountAboveMaximumError"), maxFiatAmount: $decimalAmount })
+]);
+var $routingRateLimitedErrorBody = obj({
+  ...$errorBodyFields,
+  errorCode: z.literal("TooManyRequestsError"),
+  retryAfterSeconds: z.number().int().positive().optional()
+});
+var ROUTING_ERROR_CODES = [
+  "FiatNoRouteError",
+  "FiatAmountBelowMinimumError",
+  "FiatAmountAboveMaximumError",
+  "TooManyRequestsError"
+];
+var $routingFaultErrorBody = obj({
+  ...$errorBodyFields,
+  errorCode: $nonBlank.refine((code) => !ROUTING_ERROR_CODES.includes(code), "this errorCode carries its own fields")
+});
+var $routingTableErrorBody = z.union([$routingRateLimitedErrorBody, $routingFaultErrorBody]);
+var FiatRoutingTableErrorBodySchema = $routingTableErrorBody;
+var $routingQuoteErrorBody = z.union([$routingNoRouteErrorBody, $routingAmountErrorBody, $routingFaultErrorBody]);
+var FiatRoutingQuoteErrorBodySchema = $routingQuoteErrorBody;
+var $fiatGeo = obj({ alpha2: z.string().regex(/^[A-Z]{2}$/), region: $nonBlank.optional(), ip: $nonBlank.optional() });
+var FiatGeoSchema = $fiatGeo;
+var $nextRequest = z.object({ provider: $provider, action: $nonBlank, geo: $fiatGeo }).catchall(z.unknown());
+var FiatNextRequestSchema = $nextRequest;
 var $providerBoundStepResponse = obj({
   state: $providerBoundFlowState,
   provider: $provider,
@@ -2021,33 +2135,17 @@ 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: $geo
+  paymentMethod: z2.literal("apple_pay")
 });
 var MoonPayCheckoutSchema = $checkout;
 var $credentials = obj2({ customerId: $nonEmpty, accessToken: $nonEmpty });
 var MoonPaySdkCredentialsSchema = $credentials;
-var $intentRequest = z2.discriminatedUnion("kind", [
-  obj2({ kind: z2.literal("observe"), checkout: $checkout, credentials: $credentials.optional() }),
-  obj2({
-    kind: z2.literal("kyc"),
-    checkout: $checkout,
-    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,
-    geo: $geo.optional()
-  })
-]);
-var MoonPayIntentRequestSchema = $intentRequest;
+var $context = { checkout: $checkout, credentials: $credentials.optional() };
+var $requestContext = obj2($context);
+var MoonPayRequestContextSchema = $requestContext;
 var $quoteInput = obj2({
   source: obj2({ asset: obj2({ code: z2.enum(FIAT_CURRENCY_CODES2) }), amount: $nonEmpty }),
   destination: obj2({ asset: obj2({ code: $nonEmpty }) }),
@@ -2056,50 +2154,103 @@ var $quoteInput = obj2({
   feeBehavior: z2.literal("inclusive")
 });
 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 $observeFields = { action: z2.literal("observe") };
+var $consentFields = {
+  action: z2.literal("consent"),
+  acceptances: z2.array(TermsDocumentAcceptanceSchema).min(1).refine((acceptances) => hasUniqueIds2(acceptances.map((acceptance) => acceptance.documentId)), "each document is accepted once")
+};
+var $connectFields = { action: z2.literal("connect"), customerId: $nonEmpty, accessToken: $nonEmpty };
+var $kycFields = {
+  action: z2.literal("kyc"),
+  credentials: $credentials,
+  values: z2.record(KycFieldIdSchema, z2.string()).refine((values) => Object.keys(values).length > 0, "values must not be empty")
+};
+var $orderFields = { action: z2.literal("order"), orderId: $nonEmpty, quotedAmount: FiatAmountSchema, transactionId: $nonEmpty.optional() };
+var $observeRequest = obj2({ ...$context, ...$observeFields });
+var $consentRequest = obj2({ ...$context, ...$consentFields });
+var $connectRequest = obj2({ ...$context, ...$connectFields });
+var $kycRequest = obj2({ ...$context, ...$kycFields });
+var $orderRequest = obj2({ ...$context, ...$orderFields });
+var MoonPayObserveRequestSchema = $observeRequest;
+var MoonPayConsentRequestSchema = $consentRequest;
+var MoonPayConnectRequestSchema = $connectRequest;
+var MoonPayKycRequestSchema = $kycRequest;
+var MoonPayOrderRequestSchema = $orderRequest;
+var $request = z2.discriminatedUnion("action", [$observeRequest, $consentRequest, $connectRequest, $kycRequest, $orderRequest]);
+var MoonPayRequestSchema = $request;
+var $envelope = { provider: z2.literal("MOONPAY"), geo: FiatGeoSchema, ...$context };
+var $nextRequest2 = z2.discriminatedUnion("action", [
+  obj2({ ...$envelope, ...$observeFields }),
+  obj2({ ...$envelope, ...$consentFields }),
+  obj2({ ...$envelope, ...$connectFields }),
+  obj2({ ...$envelope, ...$kycFields }),
+  obj2({ ...$envelope, ...$orderFields })
+]);
+var MoonPayNextRequestSchema = $nextRequest2;
 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, 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 }),
-  obj2({ status: z2.literal("REFUSED"), reason: $stepRefusal, recovery: z2.enum(["REQUOTE", "NONE"]) })
-]);
-var $stepResponse2 = $stepStatus.superRefine((response, context) => {
-  if (response.status === "TERMS") {
-    if (!hasUniqueIds2(response.documents.map((document) => document.id))) {
-      context.addIssue({ code: "custom", path: ["documents"], message: "document ids must be unique" });
-    }
-    if (response.documents.some((document) => document.stage !== response.stage)) {
-      context.addIssue({ code: "custom", path: ["documents"], message: "every document must be at the response stage" });
-    }
+var $consentShape = obj2({ next: z2.literal("consent"), documents: z2.array(TermsDocumentSchema).min(1) });
+var $connectPrompt = obj2({
+  next: z2.literal("connect"),
+  sessionToken: $nonEmpty,
+  quoteInput: $quoteInput,
+  resetConnection: z2.literal(true).optional()
+});
+var $kycShape = obj2({ next: z2.literal("kyc"), fields: z2.array(FormFieldSchema).min(1), fieldErrors: z2.array($fieldError).min(1).optional() });
+var $waitPrompt = obj2({ next: z2.literal("wait"), retryAfterMs: z2.number().int().positive().max(6e4) });
+var $orderPrompt = obj2({ next: z2.literal("order"), orderId: $nonEmpty, quoteInput: $quoteInput });
+var checkConsent = (prompt, context) => {
+  if (!hasUniqueIds2(prompt.documents.map((document) => document.id))) {
+    context.addIssue({ code: "custom", path: ["documents"], message: "document ids must be unique" });
   }
-  if (response.status === "KYC") {
-    const fieldIds = response.fields.map((field) => field.id);
-    if (!hasUniqueIds2(fieldIds)) {
-      context.addIssue({ code: "custom", path: ["fields"], message: "field ids must be unique" });
-    }
-    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 checkKyc = (prompt, context) => {
+  const fieldIds = prompt.fields.map((field) => field.id);
+  if (!hasUniqueIds2(fieldIds)) {
+    context.addIssue({ code: "custom", path: ["fields"], message: "field ids must be unique" });
+  }
+  if (prompt.fieldErrors?.some((error) => !fieldIds.includes(error.fieldId))) {
+    context.addIssue({ code: "custom", path: ["fieldErrors"], message: "a field error must name a field in this prompt" });
   }
+  if (prompt.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 MoonPayConsentPromptSchema = $consentShape.superRefine(checkConsent);
+var MoonPayConnectPromptSchema = $connectPrompt;
+var MoonPayKycPromptSchema = $kycShape.superRefine(checkKyc);
+var MoonPayWaitPromptSchema = $waitPrompt;
+var MoonPayOrderPromptSchema = $orderPrompt;
+var checkPrompt = (response, context) => {
+  if (response.next === "consent") checkConsent(response, context);
+  if (response.next === "kyc") checkKyc(response, context);
+};
+var $promptOptions = [$consentShape, $connectPrompt, $kycShape, $waitPrompt, $orderPrompt];
+var $prompt = z2.discriminatedUnion("next", [...$promptOptions]).superRefine(checkPrompt);
+var MoonPayPromptSchema = $prompt;
+var $done = obj2({ next: z2.literal("done"), order: FiatStepResponseSchema });
+var MoonPayDoneSchema = $done;
+var $stepRefused = obj2({
+  next: z2.literal("refused"),
+  reason: z2.enum(["NOT_ELIGIBLE", "DOCUMENTS_REQUIRED", "FINAL_REJECTION", "CUSTOMER_MISMATCH"]),
+  recovery: z2.enum(["REQUOTE", "NONE"])
+});
+var $orderRefused = obj2({
+  next: z2.literal("refused"),
+  reason: z2.enum(["CUSTOMER_MISMATCH", "WALLET_MISMATCH", "UNRECORDABLE"]),
+  recovery: z2.literal("NONE")
 });
+var $stepResponse2 = z2.discriminatedUnion("next", [...$promptOptions, $stepRefused]).superRefine(checkPrompt);
 var MoonPayStepResponseSchema = $stepResponse2;
-var $orderResponse = z2.discriminatedUnion("status", [
-  obj2({ status: z2.literal("DONE"), order: FiatStepResponseSchema }),
-  $pending,
-  obj2({ status: z2.literal("REFUSED"), reason: $orderRefusal, recovery: z2.literal("NONE") })
-]);
+var $orderResponse = z2.discriminatedUnion("next", [$done, $orderPrompt, $orderRefused]);
 var MoonPayOrderResponseSchema = $orderResponse;
-var $intentResponse = z2.union([$stepResponse2, $orderResponse]);
-var MoonPayIntentResponseSchema = $intentResponse;
+var MoonPayResponseSchemaFor = {
+  observe: MoonPayStepResponseSchema,
+  consent: MoonPayStepResponseSchema,
+  connect: MoonPayStepResponseSchema,
+  kyc: MoonPayStepResponseSchema,
+  order: MoonPayOrderResponseSchema
+};
 var $faultFields = {
   reason: z2.enum(["SESSION_BUDGET_SPENT", "RATE_LIMITED", "PROVIDER_UNAVAILABLE", "INVALID_REQUEST"]),
   recovery: z2.enum(["RETRY", "REQUOTE", "NONE"])
@@ -2131,7 +2282,14 @@ export {
   FiatAmountSchema,
   FiatCurrencyCode,
   FiatEndpointSchema,
+  FiatGeoSchema,
+  FiatNextRequestSchema,
   FiatProviderSchema,
+  FiatRoutingQuoteErrorBodySchema,
+  FiatRoutingQuoteRequestSchema,
+  FiatRoutingTableErrorBodySchema,
+  FiatRoutingTableQuerySchema,
+  FiatRoutingTableResponseSchema,
   FiatStepResponseSchema,
   FiatTermsErrorBodySchema,
   FiatTermsRequestSchema,
@@ -2156,14 +2314,28 @@ export {
   KycSdkResultReportSchema,
   MOONPAY_ENDPOINTS,
   MoonPayCheckoutSchema,
+  MoonPayConnectPromptSchema,
+  MoonPayConnectRequestSchema,
+  MoonPayConsentPromptSchema,
+  MoonPayConsentRequestSchema,
+  MoonPayDoneSchema,
   MoonPayErrorBodySchema,
   MoonPayFaultSchema,
-  MoonPayIntentRequestSchema,
-  MoonPayIntentResponseSchema,
+  MoonPayKycPromptSchema,
+  MoonPayKycRequestSchema,
+  MoonPayNextRequestSchema,
+  MoonPayObserveRequestSchema,
+  MoonPayOrderPromptSchema,
+  MoonPayOrderRequestSchema,
   MoonPayOrderResponseSchema,
+  MoonPayPromptSchema,
   MoonPayQuoteInputSchema,
+  MoonPayRequestContextSchema,
+  MoonPayRequestSchema,
+  MoonPayResponseSchemaFor,
   MoonPaySdkCredentialsSchema,
   MoonPayStepResponseSchema,
+  MoonPayWaitPromptSchema,
   OrderAwaitingConfirmationStateSchema,
   OrderCreatedStateSchema,
   OrderRefSchema,
@@ -2183,6 +2355,7 @@ export {
   QuoteLimitsSchema,
   QuoteSchema,
   QuoteStateSchema,
+  ROUTING_ENDPOINTS,
   RecoverySchema,
   RefundSchema,
   ReportSpecSchema,