@coinflowlabs/angular 1.13.0 → 1.15.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -5,6 +5,60 @@ import * as i0 from '@angular/core';
5
5
  import { EventEmitter, ElementRef, OnDestroy, SimpleChanges, OnInit, NgZone } from '@angular/core';
6
6
  import { SafeResourceUrl, DomSanitizer } from '@angular/platform-browser';
7
7
 
8
+ /**
9
+ * Outcome of a standalone bank-link session, reported to the merchant's
10
+ * `callbackUrl` as the `bankLinkStatus` query parameter.
11
+ *
12
+ * The customer returns to the same `callbackUrl` whether they linked an
13
+ * account, backed out, or could not be verified, so arriving there is not by
14
+ * itself evidence of a link.
15
+ */
16
+ type BankLinkStatus = 'linked' | 'canceled' | 'failed';
17
+ declare const BANK_LINK_STATUS_PARAM = "bankLinkStatus";
18
+ /**
19
+ * Query parameters a standalone bank-link session appends to the merchant's
20
+ * `callbackUrl`.
21
+ *
22
+ * The return leg carries no secret — only the outcome. The linked accounts and
23
+ * their tokens are read from Get Customer, which is authenticated, so a
24
+ * payment-instrument token never rides a merchant-supplied redirect. The same
25
+ * invariant lets the shared redirect validator allow native-app deep links
26
+ * without a whitelist, so nothing may be added here.
27
+ */
28
+ declare function bankLinkCallbackParams({ status, }: {
29
+ status: BankLinkStatus;
30
+ }): Record<string, string>;
31
+ /**
32
+ * What the hosted bank-linking page does once an account is linked.
33
+ *
34
+ * `emit` is the embedded SDK case: `<CoinflowBankLink>` lives inside the
35
+ * merchant's own checkout, so the page reports the tokens through the
36
+ * accountLinked message and stops. Navigating onward would drop the customer
37
+ * into Coinflow's checkout, which the merchant owns.
38
+ */
39
+ type BankLinkCompletion = 'emit' | 'redirect' | 'returnToApp' | 'returnToCheckout';
40
+ /**
41
+ * Picks the completion behaviour for a finished bank link.
42
+ *
43
+ * `bankLinkOnly` wins over everything: the page was opened purely to link an
44
+ * account, so there is nowhere to send the customer afterwards.
45
+ */
46
+ declare function resolveBankLinkCompletion({ bankLinkOnly, hasCallbackRedirect, isReactNativeLink, }: {
47
+ bankLinkOnly: boolean;
48
+ hasCallbackRedirect: boolean;
49
+ isReactNativeLink: boolean;
50
+ }): BankLinkCompletion;
51
+ /**
52
+ * How long the embedded flow holds the page blank before revealing the linked
53
+ * state.
54
+ *
55
+ * A merchant who unmounts <CoinflowBankLink> on the accountLinked event should
56
+ * never flash Coinflow's confirmation at their user, and a merchant who leaves
57
+ * it mounted should not be left looking at nothing. Long enough to cover the
58
+ * message hop and unmount, short enough not to read as a hang.
59
+ */
60
+ declare const BANK_LINK_REVEAL_DELAY_MS = 500;
61
+
8
62
  declare enum Currency {
9
63
  USD = "USD",
10
64
  AED = "AED",
@@ -193,6 +247,16 @@ interface Cents {
193
247
  interface CurrencyCents extends Cents {
194
248
  currency: Currency;
195
249
  }
250
+ interface LamportsAmount {
251
+ /**
252
+ * Amount of lamports. Must be a whole, non-negative number; as a string it may
253
+ * contain digits only (no sign, decimal point, or exponent).
254
+ * @isInt lamports must be an integer
255
+ * @minimum 0 lamports must be non-negative
256
+ * @pattern ^\d+$ lamports must be a non-negative integer
257
+ */
258
+ lamports: string | number;
259
+ }
196
260
  interface RemainingLimit extends CurrencyCents {
197
261
  type: 'single transaction' | 'daily' | 'monthly';
198
262
  }
@@ -669,6 +733,493 @@ interface MoneyTopUpCartItem {
669
733
  isPresetAmount: boolean;
670
734
  }
671
735
 
736
+ /**
737
+ * The booked hotel details
738
+ */
739
+ interface TravelLodgingHotel {
740
+ /**
741
+ * The name of the hotel
742
+ * Example: The Plaza Hotel
743
+ */
744
+ name: string;
745
+ /**
746
+ * The two-letter code of the country in which the hotel is located
747
+ * Example: US
748
+ * Pattern: ^[A-Z]{2}$
749
+ */
750
+ country: string;
751
+ /**
752
+ * The city in which the hotel is located
753
+ * Example: New York
754
+ */
755
+ city: string;
756
+ }
757
+ /**
758
+ * The lodging details of the travel booking
759
+ */
760
+ interface TravelLodging {
761
+ /**
762
+ * Hotel reservation id
763
+ * Example: X36Q9C
764
+ */
765
+ reservationId: string;
766
+ /**
767
+ * The number of nights booked in the reservation
768
+ * Min value: 1
769
+ * Example: 2
770
+ */
771
+ nights: number;
772
+ /**
773
+ * The check-in date
774
+ * Example: 2022-05-02
775
+ */
776
+ checkInDate: string;
777
+ /**
778
+ * The hour of day in which the check-in is done
779
+ * Example: 18
780
+ * Pattern: ^([01][0-9]|2[0-3])$
781
+ */
782
+ checkInHour: string;
783
+ /**
784
+ * The booked hotel details
785
+ */
786
+ hotel: TravelLodgingHotel;
787
+ /**
788
+ * Indicates whether extras were purchased in the reservation
789
+ */
790
+ wereExtrasPurchased: boolean;
791
+ /**
792
+ * Indicates whether the reservation is refundable
793
+ */
794
+ isRefundable: boolean;
795
+ /**
796
+ * The most luxurious room booked in the reservation
797
+ * Example: Presidential Suite
798
+ */
799
+ highestRoomType: string;
800
+ /**
801
+ * The number of rooms booked in the reservation
802
+ * Min value: 1
803
+ * Example: 2
804
+ */
805
+ numberOfRooms: number;
806
+ /**
807
+ * The number of guests in the reservation
808
+ * Min value: 1
809
+ * Example: 4
810
+ */
811
+ numberOfGuests: number;
812
+ /**
813
+ * The number of kids, out of the number of guests in the reservation
814
+ * Min value: 0
815
+ * Example: 2
816
+ */
817
+ numberOfKids: number;
818
+ }
819
+ /**
820
+ * The trip details of the travel booking
821
+ */
822
+ interface TravelTrip {
823
+ /**
824
+ * The number of flights in the trip
825
+ * Min value: 1
826
+ * Example: 2
827
+ */
828
+ numberOfFlights: number;
829
+ /**
830
+ * The number of checked bags
831
+ * Min value: 0
832
+ * Example: 1
833
+ */
834
+ numberOfCheckedBags: number;
835
+ /**
836
+ * The first-way destination's three-letter IATA airport code
837
+ * Example: JFK
838
+ * Pattern: ^[A-Z]{3}$
839
+ */
840
+ firstWayDestination: string;
841
+ /**
842
+ * `true` if the trip is a round-trip
843
+ * Example: true
844
+ */
845
+ isRoundTrip: boolean;
846
+ /**
847
+ * `luxurious` if the highest bought travel class in the trip is a luxury class (business/first), `economy` otherwise
848
+ * Example: luxurious
849
+ */
850
+ highestClass: 'economy' | 'luxurious';
851
+ /**
852
+ * True if the trip ticket is a flexible ticket
853
+ * Example: true
854
+ */
855
+ isFlexibleTicket: boolean;
856
+ /**
857
+ * True if extras were included in the trip purchase
858
+ * Example: true
859
+ */
860
+ wereExtrasPurchased: boolean;
861
+ }
862
+ /**
863
+ * The first flight details of the trip
864
+ */
865
+ interface TravelFirstFlight {
866
+ /**
867
+ * The number of travelers in the first flight
868
+ * Min value: 1
869
+ * Example: 2
870
+ */
871
+ numberOfTravelers: number;
872
+ /**
873
+ * The timestamp of the departure, in *milliseconds* since the unix epoch
874
+ * Example: 1551398400000
875
+ */
876
+ departureTime: number;
877
+ /**
878
+ * The first-flight departure airport's three-letter IATA code
879
+ * Example: JFK
880
+ * Pattern: ^[A-Z]{3}$
881
+ */
882
+ departureAirport: string;
883
+ /**
884
+ * The first-flight duration, in hours
885
+ * Min value: 0
886
+ * Example: 3.5
887
+ */
888
+ duration: number;
889
+ /**
890
+ * The alphanumeric flight code
891
+ * Example: BA2491A
892
+ * Pattern: ^[A-Z0-9]+$
893
+ */
894
+ flightNumber: string;
895
+ }
896
+ /**
897
+ * Represents a travel booking item in a shopping cart
898
+ */
899
+ interface TravelCartItem {
900
+ /**
901
+ * Denotes the cart item class. The item schema is chosen based on this value.
902
+ * Allowed value: travel
903
+ * Example: travel
904
+ */
905
+ itemClass: 'travel';
906
+ /**
907
+ * The cart items's unique ID
908
+ * Example: 5de33332-546a-4171-8988-2a43d2bfe9c6
909
+ */
910
+ id?: string;
911
+ /**
912
+ * Any additional product data which can be provided, e.g. description, link to image, etc
913
+ * Example: {"any":"data","description":"This is the product description"}
914
+ */
915
+ rawProductData?: AnyObject;
916
+ /**
917
+ * The item's selling price
918
+ */
919
+ sellingPrice: CurrencyAmount;
920
+ /**
921
+ * The item's list price
922
+ */
923
+ listPrice?: CurrencyAmount;
924
+ /**
925
+ * The user's personal info
926
+ */
927
+ recipientInfo?: RecipientInfo;
928
+ /**
929
+ * The lodging details of the travel booking
930
+ */
931
+ lodging: TravelLodging;
932
+ /**
933
+ * The flight ticket's PNR code
934
+ * Example: X36Q9C
935
+ */
936
+ pnr: string;
937
+ /**
938
+ * The trip details of the travel booking
939
+ */
940
+ trip: TravelTrip;
941
+ /**
942
+ * The first flight details of the trip
943
+ */
944
+ firstFlight: TravelFirstFlight;
945
+ }
946
+
947
+ /**
948
+ * Represents a flight ticket item in a shopping cart
949
+ */
950
+ interface FlightTicketCartItem {
951
+ /**
952
+ * Denotes the cart item class. The item schema is chosen based on this value.
953
+ * Allowed value: flightTicket
954
+ * Example: flightTicket
955
+ */
956
+ itemClass: 'flightTicket';
957
+ /**
958
+ * The cart items's unique ID
959
+ * Example: 5de33332-546a-4171-8988-2a43d2bfe9c6
960
+ */
961
+ id?: string;
962
+ /**
963
+ * Any additional product data which can be provided, e.g. description, link to image, etc
964
+ * Example: {"any":"data","description":"This is the product description"}
965
+ */
966
+ rawProductData?: AnyObject;
967
+ /**
968
+ * The item's selling price
969
+ */
970
+ sellingPrice: CurrencyAmount;
971
+ /**
972
+ * The item's list price
973
+ */
974
+ listPrice?: CurrencyAmount;
975
+ /**
976
+ * The user's personal info
977
+ */
978
+ recipientInfo?: RecipientInfo;
979
+ /**
980
+ * The flight ticket's PNR code
981
+ * Example: X36Q9C
982
+ */
983
+ pnr: string;
984
+ /**
985
+ * The trip details of the flight ticket
986
+ */
987
+ trip: TravelTrip;
988
+ /**
989
+ * The first flight details of the trip
990
+ */
991
+ firstFlight: TravelFirstFlight;
992
+ }
993
+
994
+ /**
995
+ * Represents a flight upgrade item in a shopping cart
996
+ */
997
+ interface FlightUpgradeCartItem {
998
+ /**
999
+ * Denotes the cart item class. The item schema is chosen based on this value.
1000
+ * Allowed value: flightUpgrade
1001
+ * Example: flightUpgrade
1002
+ */
1003
+ itemClass: 'flightUpgrade';
1004
+ /**
1005
+ * The cart items's unique ID
1006
+ * Example: 5de33332-546a-4171-8988-2a43d2bfe9c6
1007
+ */
1008
+ id?: string;
1009
+ /**
1010
+ * Any additional product data which can be provided, e.g. description, link to image, etc
1011
+ * Example: {"any":"data","description":"This is the product description"}
1012
+ */
1013
+ rawProductData?: AnyObject;
1014
+ /**
1015
+ * The item's selling price
1016
+ */
1017
+ sellingPrice: CurrencyAmount;
1018
+ /**
1019
+ * The item's list price
1020
+ */
1021
+ listPrice?: CurrencyAmount;
1022
+ /**
1023
+ * The user's personal info
1024
+ */
1025
+ recipientInfo?: RecipientInfo;
1026
+ /**
1027
+ * The flight ticket's PNR code
1028
+ * Example: X36Q9C
1029
+ */
1030
+ pnr?: string;
1031
+ /**
1032
+ * The type of upgrade
1033
+ * Example: changes
1034
+ */
1035
+ upgradeType: 'changes' | 'fareIncrease' | 'baggage' | 'seats' | 'insurance' | 'other';
1036
+ /**
1037
+ * The upgrade description, required when the upgrade type is `other`
1038
+ */
1039
+ description?: string;
1040
+ }
1041
+
1042
+ /**
1043
+ * Represents a lodging reservation item in a shopping cart.
1044
+ * The reservation fields are flattened at the top level of the item.
1045
+ */
1046
+ interface LodgingCartItem extends TravelLodging {
1047
+ /**
1048
+ * Denotes the cart item class. The item schema is chosen based on this value.
1049
+ * Allowed value: lodging
1050
+ * Example: lodging
1051
+ */
1052
+ itemClass: 'lodging';
1053
+ /**
1054
+ * The cart items's unique ID
1055
+ * Example: 5de33332-546a-4171-8988-2a43d2bfe9c6
1056
+ */
1057
+ id?: string;
1058
+ /**
1059
+ * Any additional product data which can be provided, e.g. description, link to image, etc
1060
+ * Example: {"any":"data","description":"This is the product description"}
1061
+ */
1062
+ rawProductData?: AnyObject;
1063
+ /**
1064
+ * The item's selling price
1065
+ */
1066
+ sellingPrice: CurrencyAmount;
1067
+ /**
1068
+ * The item's list price
1069
+ */
1070
+ listPrice?: CurrencyAmount;
1071
+ /**
1072
+ * The user's personal info
1073
+ */
1074
+ recipientInfo?: RecipientInfo;
1075
+ }
1076
+
1077
+ /**
1078
+ * Single source of truth for the card-entry responsive layout.
1079
+ *
1080
+ * The real card-entry form (`UnifiedCardEntry` in the core-flows app) and the
1081
+ * React/Vue/Angular skeleton loaders all render the same grid. Historically the
1082
+ * form drove the inline↔two-row switch from JS (a ResizeObserver toggling React
1083
+ * state) while the skeletons hard-coded their own guesses, so the two drifted.
1084
+ *
1085
+ * This module defines the grid templates and the breakpoint ONCE, as pure data
1086
+ * plus a CSS builder, so every consumer reflows at exactly the same width via a
1087
+ * CSS container query — no JS width measurement, nothing to keep in sync.
1088
+ */
1089
+ type CardEntryInputName = 'card-number' | 'expiration' | 'cvv';
1090
+ /**
1091
+ * Minimum width (px) each field needs before the row is too cramped and the
1092
+ * layout drops to two rows. Mirrors the real form's field sizing.
1093
+ */
1094
+ declare const CARD_ENTRY_MIN_WIDTHS: Record<CardEntryInputName, number>;
1095
+ /** Notional gap (px) between fields, summed into the reflow breakpoint. */
1096
+ declare const CARD_ENTRY_SLOT_GAP_PX = 8;
1097
+ /** Field row height — matches the real form's `3rem` grid rows. */
1098
+ declare const CARD_ENTRY_ROW_HEIGHT = "3rem";
1099
+ declare const CARD_ENTRY_ROW_HEIGHT_PX = 48;
1100
+ /** 1px accent line between rows / between exp & cvv in the two-row layout. */
1101
+ declare const CARD_ENTRY_DIVIDER_PX = 1;
1102
+ /**
1103
+ * The form draws its fields inside a 1px border, so the query container (the
1104
+ * full iframe width) is 2px wider than the field row that `minRowWidth`
1105
+ * describes. The breakpoint bakes this in so form and skeleton flip together.
1106
+ */
1107
+ declare const CARD_ENTRY_BORDER_PX = 1;
1108
+ /**
1109
+ * The form insets its box by this much on every side (Tailwind `m-0.5`) so the
1110
+ * focus ring has room and isn't clipped at the iframe edge. It adds to the box's
1111
+ * rendered height, so the skeleton's height guess includes it to avoid a jump
1112
+ * when the loaded form replaces the skeleton.
1113
+ */
1114
+ declare const CARD_ENTRY_MARGIN_PX = 2;
1115
+ type CardEntryConfig = {
1116
+ /** Mounted fields, in DOM/visual order. */
1117
+ inputs: CardEntryInputName[];
1118
+ /** Whether the animated card-brand icon renders left of the PAN slot. */
1119
+ hasIcon?: boolean;
1120
+ /** Whether the layout may drop to two rows when narrow (default true). */
1121
+ allowTwoRow?: boolean;
1122
+ };
1123
+ type CardEntryDivider = {
1124
+ area: string;
1125
+ orientation: 'v' | 'h';
1126
+ };
1127
+ type CardEntryLayout = {
1128
+ /** grid-template for the wide (inline) layout. */
1129
+ inline: string;
1130
+ /** grid-template for the narrow (two-row) layout, or null if it never reflows. */
1131
+ twoRow: string | null;
1132
+ /**
1133
+ * Container width (px) below which the two-row layout applies, measured on the
1134
+ * query container (full iframe width, incl. the form's border). Null when the
1135
+ * config never reflows.
1136
+ */
1137
+ breakpointPx: number | null;
1138
+ /** grid-area names that hold a field, in DOM order (same in both layouts). */
1139
+ fieldAreas: string[];
1140
+ /** Whether an `icon` area is present (both layouts). */
1141
+ hasIconArea: boolean;
1142
+ /** Accent-line elements shown only in the two-row layout. */
1143
+ twoRowDividers: CardEntryDivider[];
1144
+ };
1145
+ /** Resolve the full layout (templates + breakpoint + areas) for a config. */
1146
+ declare function buildCardEntryLayout({ inputs, hasIcon, allowTwoRow, }: CardEntryConfig): CardEntryLayout;
1147
+ /**
1148
+ * Container-query CSS that switches `gridSelector` between the inline and
1149
+ * two-row templates at the layout's breakpoint. The element matched by
1150
+ * `gridSelector` must be a descendant of a `container-type: inline-size`
1151
+ * ancestor named `containerName`.
1152
+ *
1153
+ * `extraBaseRules` are emitted before the `@container` block (e.g. the default
1154
+ * hidden state of two-row-only dividers); `extraCompactRules` are emitted inside
1155
+ * it (e.g. revealing those dividers / hiding wide-only chrome). Keeping the base
1156
+ * state first ensures the compact rules win when the query matches.
1157
+ */
1158
+ declare function buildCardEntryGridCss({ gridSelector, layout, containerName, extraBaseRules, extraCompactRules, }: {
1159
+ gridSelector: string;
1160
+ layout: CardEntryLayout;
1161
+ containerName?: string;
1162
+ extraBaseRules?: string;
1163
+ extraCompactRules?: string;
1164
+ }): string;
1165
+
1166
+ /**
1167
+ * Single source of truth for the validation errors the card entry shows below
1168
+ * the card box. The same value drives the on-screen message and the
1169
+ * `inputError` iframe message emitted to the parent, so the parent can never
1170
+ * be told about an error the user isn't seeing.
1171
+ */
1172
+
1173
+ type InputErrorWalletCallInfo = {
1174
+ field: CardEntryInputName;
1175
+ message: string;
1176
+ };
1177
+ /** Emitted when a field that was showing an error stops showing it. */
1178
+ type InputValidWalletCallInfo = {
1179
+ field: CardEntryInputName;
1180
+ };
1181
+ declare const CARD_FIELD_ERROR_MESSAGES: {
1182
+ readonly cardNumber: "Card number is invalid. Please double check information.";
1183
+ readonly expiration: "Expiration is invalid. Please double check information.";
1184
+ readonly cvv: "CVV is invalid. Please double check information.";
1185
+ readonly cvvEmpty: "Please enter your CVV to proceed.";
1186
+ };
1187
+ declare function getCardFieldValidationError({ cardError, expirationError, cvvError, cvvEmpty, isCvvOnly, }: {
1188
+ cardError: boolean;
1189
+ expirationError: boolean;
1190
+ cvvError: boolean;
1191
+ cvvEmpty: boolean;
1192
+ isCvvOnly: boolean;
1193
+ }): InputErrorWalletCallInfo | null;
1194
+ /**
1195
+ * An iframe message the card entry should emit for a change in validation
1196
+ * state. `kind` rather than IFrameMessageMethods keeps this module free of a
1197
+ * circular import (CoinflowLibMessageHandlers imports the payload types here).
1198
+ */
1199
+ type CardFieldInputEvent = {
1200
+ kind: 'error';
1201
+ info: InputErrorWalletCallInfo;
1202
+ } | {
1203
+ kind: 'valid';
1204
+ info: InputValidWalletCallInfo;
1205
+ };
1206
+ /**
1207
+ * Derives which messages to emit for a transition between two validation
1208
+ * states, so the parent hears about each change exactly once.
1209
+ *
1210
+ * Nothing is emitted while the state is unchanged (including the pristine
1211
+ * state, where both sides are null), so a field that is never invalid stays
1212
+ * silent and a visible error is not re-sent on every render.
1213
+ *
1214
+ * Only one error is displayed at a time (see getCardFieldValidationError's
1215
+ * precedence), so when the displayed error moves to a different field the
1216
+ * previous field has necessarily become valid and gets its own clear event.
1217
+ */
1218
+ declare function getCardFieldInputEvents({ previous, current, }: {
1219
+ previous: InputErrorWalletCallInfo | null;
1220
+ current: InputErrorWalletCallInfo | null;
1221
+ }): CardFieldInputEvent[];
1222
+
672
1223
  declare enum WithdrawCategory {
673
1224
  USER = "user",
674
1225
  BUSINESS = "business",
@@ -685,7 +1236,9 @@ declare enum WithdrawSpeed {
685
1236
  VENMO = "venmo",
686
1237
  PAYPAL = "paypal",
687
1238
  WIRE = "wire",
688
- INTERAC = "interac"
1239
+ INTERAC = "interac",
1240
+ SWIFT = "swift",
1241
+ CRYPTO = "crypto"
689
1242
  }
690
1243
  declare enum SettlementType {
691
1244
  Credits = "Credits",
@@ -805,6 +1358,8 @@ interface CoinflowTypes {
805
1358
  blockchain?: CoinflowBlockchain | undefined;
806
1359
  handleHeightChange?: (height: string) => void;
807
1360
  theme?: MerchantTheme;
1361
+ /** Your company email address that the customer can contact. */
1362
+ supportEmail?: string;
808
1363
  }
809
1364
  type PartialBy<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
810
1365
  type MergeWithOptionalDiff<A, B> = Pick<A, Extract<keyof A, keyof B>> & Pick<B, Extract<keyof B, keyof A>> & Partial<Omit<A, keyof B>> & Partial<Omit<B, keyof A>>;
@@ -820,6 +1375,39 @@ type AuthDeclinedWalletCallInfo = {
820
1375
  total: string;
821
1376
  };
822
1377
  type OnAuthDeclinedMethod = (args: AuthDeclinedWalletCallInfo) => void | Promise<void>;
1378
+ type OnInputErrorMethod = (args: InputErrorWalletCallInfo) => void | Promise<void>;
1379
+ type OnInputValidMethod = (args: InputValidWalletCallInfo) => void | Promise<void>;
1380
+ /**
1381
+ * Mirrors `LinkedAccountType` in `@coinflow/common`. Redeclared here because
1382
+ * lib-common ships to merchants and cannot depend on the server package.
1383
+ */
1384
+ type AccountLinkedType = 'bank' | 'card' | 'iban' | 'pix' | 'eft' | 'venmo' | 'paypal' | 'wire' | 'interac';
1385
+ interface AccountLinkedInfo {
1386
+ type: AccountLinkedType;
1387
+ /**
1388
+ * The linked bank account tokens, each usable as the `token` field on an ACH
1389
+ * checkout request. Present only for bank links.
1390
+ */
1391
+ tokens?: string[];
1392
+ }
1393
+ type OnAccountLinkedMethod = (info: AccountLinkedInfo) => void;
1394
+ /**
1395
+ * Why a linking session ended without an account.
1396
+ *
1397
+ * Derived from the standalone link's `bankLinkStatus` so the two entry points
1398
+ * cannot drift: a merchant who moves between them meets the same vocabulary.
1399
+ */
1400
+ type AccountNotLinkedReason = Exclude<BankLinkStatus, 'linked'>;
1401
+ interface AccountNotLinkedInfo {
1402
+ type: AccountLinkedType;
1403
+ /**
1404
+ * `canceled` when the customer backed out, `failed` when the account could
1405
+ * not be linked — for example because the account holder's name could not be
1406
+ * verified.
1407
+ */
1408
+ reason: AccountNotLinkedReason;
1409
+ }
1410
+ type OnAccountNotLinkedMethod = (info: AccountNotLinkedInfo) => void;
823
1411
  /** Wallets **/
824
1412
  interface SolanaWallet {
825
1413
  publicKey: PublicKey | null;
@@ -909,11 +1497,11 @@ declare enum ChargebackProtectionAccountType {
909
1497
  PRIVATE = "private",
910
1498
  BUSINESS = "business"
911
1499
  }
912
- type CartItemClassOmitted = NftCartItemClassOmitted | Omit<GiftCardCartItem, 'listPrice'> | CryptoCartItem | MoneyTopUpCartItem;
1500
+ type CartItemClassOmitted = NftCartItemClassOmitted | Omit<GiftCardCartItem, 'listPrice'> | CryptoCartItem | MoneyTopUpCartItem | TravelCartItem | FlightTicketCartItem | FlightUpgradeCartItem | LodgingCartItem;
913
1501
  type ChargebackProtectionItem = CartItemClassOmitted;
914
1502
  type NftCartItemClassOmitted = Omit<nftCartItem, 'sellingPrice' | 'itemClass'>;
915
1503
  type Cart = CartItem[];
916
- type CartItem = Omit<nftCartItem, 'listPrice' | 'sellingPrice'> | Omit<GiftCardCartItem, 'listPrice'> | CryptoCartItem | MoneyTopUpCartItem;
1504
+ type CartItem = Omit<nftCartItem, 'listPrice' | 'sellingPrice'> | Omit<GiftCardCartItem, 'listPrice'> | CryptoCartItem | MoneyTopUpCartItem | TravelCartItem | FlightTicketCartItem | FlightUpgradeCartItem | LodgingCartItem;
917
1505
  declare enum ThreeDsChallengePreference {
918
1506
  NoPreference = "NoPreference",
919
1507
  Frictionless = "Frictionless",
@@ -942,6 +1530,16 @@ interface CoinflowCommonPaymentIntentProps extends Omit<CoinflowTypes, 'blockcha
942
1530
  paymentIntentId: string;
943
1531
  onSuccess?: OnSuccessMethod;
944
1532
  onAuthDeclined?: OnAuthDeclinedMethod;
1533
+ /**
1534
+ * Called whenever a card field (card number, expiration, cvv) shows a
1535
+ * validation error to the user, with the field name and the displayed message.
1536
+ */
1537
+ onInputError?: OnInputErrorMethod;
1538
+ /**
1539
+ * Called when a card field that was showing a validation error stops showing
1540
+ * it, with the field name.
1541
+ */
1542
+ onInputValid?: OnInputValidMethod;
945
1543
  /**
946
1544
  * If true, pre-checks the partial USDC payment checkbox when USDC balance is available.
947
1545
  * If false or undefined, maintains default behavior (unchecked).
@@ -974,10 +1572,25 @@ interface CoinflowCommonPaymentIntentProps extends Omit<CoinflowTypes, 'blockcha
974
1572
  }
975
1573
  interface CoinflowCommonPurchaseProps extends CoinflowTypes {
976
1574
  subtotal?: Subtotal;
1575
+ /**
1576
+ * When true, the Apple Pay button skips the totals (fee quote) fetch and
1577
+ * charges exactly the `subtotal` passed to the component.
1578
+ */
1579
+ useNativeSubtotal?: boolean;
977
1580
  presentment?: Currency;
978
1581
  onSuccess?: OnSuccessMethod;
979
1582
  sessionKey?: string;
980
1583
  onAuthDeclined?: OnAuthDeclinedMethod;
1584
+ /**
1585
+ * Called whenever a card field (card number, expiration, cvv) shows a
1586
+ * validation error to the user, with the field name and the displayed message.
1587
+ */
1588
+ onInputError?: OnInputErrorMethod;
1589
+ /**
1590
+ * Called when a card field that was showing a validation error stops showing
1591
+ * it, with the field name.
1592
+ */
1593
+ onInputValid?: OnInputValidMethod;
981
1594
  webhookInfo?: {
982
1595
  [key: string]: any;
983
1596
  };
@@ -1013,10 +1626,6 @@ interface CoinflowCommonPurchaseProps extends CoinflowTypes {
1013
1626
  */
1014
1627
  deviceId?: string;
1015
1628
  jwtToken?: string;
1016
- /**
1017
- * Your company email address that the customer can contact.
1018
- */
1019
- supportEmail?: string;
1020
1629
  /**
1021
1630
  * If rendering the Coinflow component within multiple nested iframes, all ancestors in the chain must be provided as a comma-separated list.
1022
1631
  *
@@ -1047,6 +1656,13 @@ interface WithGeo {
1047
1656
  lat: number;
1048
1657
  lng: number;
1049
1658
  };
1659
+ /**
1660
+ * Deep link (custom scheme or universal link) that reopens the host app.
1661
+ * Used by browser-handoff checkouts (e.g. Venmo on React Native) so the
1662
+ * standalone checkout page can route the customer back into the app after
1663
+ * the payment app returns them to the browser.
1664
+ */
1665
+ appReturnUrl?: string;
1050
1666
  }
1051
1667
  /**
1052
1668
  * Used for Account Funding Transactions
@@ -1148,12 +1764,22 @@ interface CoinflowCommonWithdrawProps extends CoinflowTypes {
1148
1764
  lat: number;
1149
1765
  lng: number;
1150
1766
  };
1767
+ /**
1768
+ * Deep link (custom scheme or universal link) that reopens the host app.
1769
+ * Used by browser-handoff flows on React Native — Venmo checkout and the
1770
+ * "Log in with PayPal" payout flow — so the standalone page routes the user
1771
+ * back into the app after the payment/login app returns them to the browser.
1772
+ * When omitted, PayPal linking still completes via polling but the user must
1773
+ * switch back to the app manually.
1774
+ */
1775
+ appReturnUrl?: string;
1151
1776
  }
1152
1777
  type WalletTypes = SolanaWallet | EthWallet | StellarWallet;
1153
1778
  interface SolanaWalletProps {
1154
1779
  wallet: SolanaWallet;
1155
1780
  connection: Connection;
1156
1781
  blockchain: 'solana';
1782
+ ownerOverride?: string;
1157
1783
  }
1158
1784
  type CoinflowSolanaWithdrawProps = CoinflowCommonWithdrawProps & SolanaWalletProps;
1159
1785
  interface EvmWalletProps {
@@ -1304,7 +1930,30 @@ interface DecentRedeem extends CommonEvmRedeem {
1304
1930
  * Gas fees for the transaction will be automatically calculated and added to the total charged to the customer. Optionally the merchant can opt to pay for these gas fees.
1305
1931
  */
1306
1932
  type EvmTransactionData = SafeMintRedeem | ReturnedTokenIdRedeem | KnownTokenIdRedeem | NormalRedeem | TokenRedeem | DecentRedeem;
1307
- interface CoinflowIFrameProps extends Omit<CoinflowTypes, 'merchantId' | 'handleHeightChange'>, Pick<CoinflowCommonPurchaseProps, 'chargebackProtectionData' | 'chargebackProtectionAccountType' | 'webhookInfo' | 'subtotal' | 'presentment' | 'customerInfo' | 'settlementType' | 'email' | 'planCode' | 'deviceId' | 'jwtToken' | 'origins' | 'threeDsChallengePreference' | 'supportEmail' | 'allowedPaymentMethods' | 'accountFundingTransaction' | 'partialUsdcChecked' | 'isZeroAuthorization' | 'zeroAuthorizationConfig' | 'depositAmounts'>, Pick<CoinflowCommonWithdrawProps, 'bankAccountLinkRedirect' | 'additionalWallets' | 'transactionSigner' | 'lockAmount' | 'lockDefaultToken' | 'origins' | 'allowedWithdrawSpeeds'>, Pick<CoinflowEvmPurchaseProps, 'authOnly'>, Pick<CoinflowSolanaPurchaseProps, 'rent' | 'nativeSolToConvert' | 'destinationAuthKey' | 'redemptionCheck'>, WithGeo {
1933
+ /**
1934
+ * Props for the embeddable `CoinflowBankLink` component.
1935
+ *
1936
+ * **Web only.** React Native and other mobile integrations cannot embed this
1937
+ * component; send the customer to the standalone bank link URL instead.
1938
+ */
1939
+ interface CoinflowBankLinkProps extends Pick<CoinflowTypes, 'merchantId' | 'env' | 'blockchain' | 'loaderBackground' | 'theme' | 'handleHeightChange'>, Pick<CoinflowCommonPurchaseProps, 'email' | 'customerInfo'> {
1940
+ /** The customer must be authenticated to link a bank account. */
1941
+ sessionKey: string;
1942
+ merchantCss?: string;
1943
+ /**
1944
+ * Called once Plaid linking completes, with the tokens of the newly linked
1945
+ * bank accounts.
1946
+ */
1947
+ onAccountLinked?: OnAccountLinkedMethod | undefined;
1948
+ /**
1949
+ * Called when the session ends without linking an account — the customer
1950
+ * cancelled, or the account could not be linked. The component stays
1951
+ * mounted and does not navigate, so this is where you close or reset your
1952
+ * own UI.
1953
+ */
1954
+ onAccountNotLinked?: OnAccountNotLinkedMethod | undefined;
1955
+ }
1956
+ interface CoinflowIFrameProps extends Omit<CoinflowTypes, 'merchantId' | 'handleHeightChange'>, Pick<CoinflowCommonPurchaseProps, 'chargebackProtectionData' | 'chargebackProtectionAccountType' | 'webhookInfo' | 'subtotal' | 'useNativeSubtotal' | 'presentment' | 'customerInfo' | 'settlementType' | 'email' | 'planCode' | 'deviceId' | 'jwtToken' | 'origins' | 'threeDsChallengePreference' | 'allowedPaymentMethods' | 'accountFundingTransaction' | 'partialUsdcChecked' | 'isZeroAuthorization' | 'zeroAuthorizationConfig' | 'depositAmounts'>, Pick<CoinflowCommonWithdrawProps, 'bankAccountLinkRedirect' | 'additionalWallets' | 'transactionSigner' | 'amount' | 'lockAmount' | 'lockDefaultToken' | 'origins' | 'allowedWithdrawSpeeds'>, Pick<CoinflowEvmPurchaseProps, 'authOnly'>, Pick<CoinflowSolanaPurchaseProps, 'rent' | 'nativeSolToConvert' | 'destinationAuthKey' | 'redemptionCheck'>, WithGeo {
1308
1957
  walletPubkey: string | null | undefined;
1309
1958
  sessionKey?: string;
1310
1959
  route: string;
@@ -1317,7 +1966,28 @@ interface CoinflowIFrameProps extends Omit<CoinflowTypes, 'merchantId' | 'handle
1317
1966
  disableGooglePay?: boolean;
1318
1967
  theme?: MerchantTheme;
1319
1968
  usePermit?: boolean;
1969
+ ownerOverride?: string;
1320
1970
  handleHeightChangeId: string | number;
1971
+ /**
1972
+ * Identifier linking a React Native Apple Pay WebView to its hidden bridge
1973
+ * WebView for subtotal updates relayed through localStorage.
1974
+ */
1975
+ bridgeId?: string;
1976
+ /**
1977
+ * Ends the bank-linking page on its own confirmation instead of continuing
1978
+ * into Coinflow's checkout.
1979
+ *
1980
+ * Internal. `<CoinflowBankLink>` sets it, and so does `POST /checkout/link`'s
1981
+ * bank-link sibling when no `callbackUrl` is given, so neither SDK nor API
1982
+ * integrators ever pass it themselves. It exists because the page is shared
1983
+ * with the in-checkout linking step, where continuing to checkout is right.
1984
+ *
1985
+ * A hand-built iframe URL that omits it drops the customer into a Coinflow
1986
+ * purchase flow once they link, which is wrong inside a merchant's own
1987
+ * checkout. Build the URL from the bank-link endpoint rather than by hand.
1988
+ * The `accountLinked` message carries the tokens either way.
1989
+ */
1990
+ bankLinkOnly?: boolean;
1321
1991
  }
1322
1992
  interface CoinflowIntentsIFrameProps {
1323
1993
  theme?: MerchantTheme;
@@ -1391,8 +2061,13 @@ declare class CoinflowUtils {
1391
2061
  getNSurePartnerId(merchantId: string): Promise<string | undefined>;
1392
2062
  static getCoinflowBaseUrl(env?: CoinflowEnvs): string;
1393
2063
  static getCoinflowAppBaseUrl(env?: CoinflowEnvs): string;
2064
+ static isCoinflowMessageOrigin({ url, fallbackUrl, env, }: {
2065
+ url: string | null | undefined;
2066
+ fallbackUrl: string | null | undefined;
2067
+ env?: CoinflowEnvs;
2068
+ }): boolean;
1394
2069
  static getCoinflowApiUrl(env?: CoinflowEnvs): string;
1395
- static getCoinflowUrl({ walletPubkey, sessionKey, route, routePrefix, env, subtotal, presentment, transaction, blockchain, webhookInfo, email, loaderBackground, handleHeightChangeId, bankAccountLinkRedirect, additionalWallets, chargebackProtectionData, chargebackProtectionAccountType, merchantCss, color, rent, lockDefaultToken, tokens, planCode, disableApplePay, disableGooglePay, customerInfo, settlementType, lockAmount, nativeSolToConvert, theme, usePermit, transactionSigner, authOnly, deviceId, jwtToken, origins, threeDsChallengePreference, supportEmail, destinationAuthKey, allowedPaymentMethods, accountFundingTransaction, partialUsdcChecked, redemptionCheck, allowedWithdrawSpeeds, isZeroAuthorization, zeroAuthorizationConfig, userLocation, depositAmounts, baseUrl, }: CoinflowIFrameProps & {
2070
+ static getCoinflowUrl({ walletPubkey, sessionKey, route, routePrefix, env, subtotal, useNativeSubtotal, presentment, transaction, blockchain, webhookInfo, email, loaderBackground, handleHeightChangeId, bankAccountLinkRedirect, additionalWallets, chargebackProtectionData, chargebackProtectionAccountType, merchantCss, color, rent, lockDefaultToken, tokens, planCode, disableApplePay, disableGooglePay, customerInfo, settlementType, amount, lockAmount, nativeSolToConvert, theme, usePermit, transactionSigner, authOnly, deviceId, jwtToken, origins, threeDsChallengePreference, supportEmail, destinationAuthKey, allowedPaymentMethods, accountFundingTransaction, partialUsdcChecked, redemptionCheck, allowedWithdrawSpeeds, isZeroAuthorization, zeroAuthorizationConfig, userLocation, appReturnUrl, depositAmounts, ownerOverride, bridgeId, bankLinkOnly, baseUrl, }: CoinflowIFrameProps & {
1396
2071
  baseUrl?: string;
1397
2072
  } & WithGeo): string;
1398
2073
  static getCoinflowIntentsUrl({ baseUrl, route, color, theme, env, origins, deviceId, merchantCss, loaderBackground, handleHeightChangeId, }: CoinflowIntentsIFrameProps & {
@@ -1442,6 +2117,14 @@ interface IFrameMessageHandlers {
1442
2117
  handleHeightChange?: (height: string) => void;
1443
2118
  onSuccess: OnSuccessMethod | undefined;
1444
2119
  onAuthDeclined: OnAuthDeclinedMethod | undefined;
2120
+ onInputError?: OnInputErrorMethod | undefined;
2121
+ onInputValid?: OnInputValidMethod | undefined;
2122
+ /**
2123
+ * Called when the customer finishes linking a payment or payout account in
2124
+ * the iframe. For bank links the info carries the linked account tokens.
2125
+ */
2126
+ onAccountLinked?: OnAccountLinkedMethod | undefined;
2127
+ onAccountNotLinked?: OnAccountNotLinkedMethod | undefined;
1445
2128
  /**
1446
2129
  * Called when the iframe opens/closes an in-page overlay (e.g. the PayPal
1447
2130
  * approval modal). `state` is 'open' or 'close'.
@@ -1455,14 +2138,21 @@ declare enum IFrameMessageMethods {
1455
2138
  HeightChange = "heightChange",
1456
2139
  Success = "success",
1457
2140
  AuthDeclined = "authDeclined",
2141
+ InputError = "inputError",
2142
+ InputValid = "inputValid",
1458
2143
  Loaded = "loaded",
1459
2144
  AccountLinked = "accountLinked",
2145
+ AccountNotLinked = "accountNotLinked",
1460
2146
  Redirect = "redirect",
1461
- Overlay = "overlay"
2147
+ Overlay = "overlay",
2148
+ UpdateSubtotal = "updateSubtotal"
1462
2149
  }
1463
2150
  declare function getWalletPubkey(input: Pick<CoinflowPurchaseProps, 'wallet' | 'blockchain'>): string | null | undefined;
1464
2151
  declare function handleIFrameMessage(rawMessage: string, handlers: IFrameMessageHandlers, handleHeightChangeId: string | number): Promise<string> | void;
1465
- declare function getHandlers(props: Pick<CoinflowPurchaseProps, 'wallet' | 'blockchain' | 'onSuccess' | 'onAuthDeclined'>): Omit<IFrameMessageHandlers, 'handleHeightChange'>;
2152
+ declare function getHandlers(props: Pick<CoinflowPurchaseProps, 'wallet' | 'blockchain' | 'onSuccess' | 'onAuthDeclined' | 'onInputError' | 'onInputValid'> & {
2153
+ onAccountLinked?: OnAccountLinkedMethod | undefined;
2154
+ onAccountNotLinked?: OnAccountNotLinkedMethod | undefined;
2155
+ }): Omit<IFrameMessageHandlers, 'handleHeightChange'>;
1466
2156
 
1467
2157
  type EventBusCallback = (event: Event) => void;
1468
2158
  declare class EventBus {
@@ -1576,95 +2266,6 @@ declare function doInitializeCvvOnlyTokenExIframe(args: DoInitializeCvvOnlyToken
1576
2266
  declare function doInitializeTokenExIframe(args: DoInitializeTokenExIframeArgs): Promise<TokenExIframe | undefined>;
1577
2267
  declare function doInitializeTokenExCardOnlyIframe(args: DoInitializeTokenExIframeArgs): Promise<TokenExIframe | undefined>;
1578
2268
 
1579
- /**
1580
- * Single source of truth for the card-entry responsive layout.
1581
- *
1582
- * The real card-entry form (`UnifiedCardEntry` in the core-flows app) and the
1583
- * React/Vue/Angular skeleton loaders all render the same grid. Historically the
1584
- * form drove the inline↔two-row switch from JS (a ResizeObserver toggling React
1585
- * state) while the skeletons hard-coded their own guesses, so the two drifted.
1586
- *
1587
- * This module defines the grid templates and the breakpoint ONCE, as pure data
1588
- * plus a CSS builder, so every consumer reflows at exactly the same width via a
1589
- * CSS container query — no JS width measurement, nothing to keep in sync.
1590
- */
1591
- type CardEntryInputName = 'card-number' | 'expiration' | 'cvv';
1592
- /**
1593
- * Minimum width (px) each field needs before the row is too cramped and the
1594
- * layout drops to two rows. Mirrors the real form's field sizing.
1595
- */
1596
- declare const CARD_ENTRY_MIN_WIDTHS: Record<CardEntryInputName, number>;
1597
- /** Notional gap (px) between fields, summed into the reflow breakpoint. */
1598
- declare const CARD_ENTRY_SLOT_GAP_PX = 8;
1599
- /** Field row height — matches the real form's `3rem` grid rows. */
1600
- declare const CARD_ENTRY_ROW_HEIGHT = "3rem";
1601
- declare const CARD_ENTRY_ROW_HEIGHT_PX = 48;
1602
- /** 1px accent line between rows / between exp & cvv in the two-row layout. */
1603
- declare const CARD_ENTRY_DIVIDER_PX = 1;
1604
- /**
1605
- * The form draws its fields inside a 1px border, so the query container (the
1606
- * full iframe width) is 2px wider than the field row that `minRowWidth`
1607
- * describes. The breakpoint bakes this in so form and skeleton flip together.
1608
- */
1609
- declare const CARD_ENTRY_BORDER_PX = 1;
1610
- /**
1611
- * The form insets its box by this much on every side (Tailwind `m-0.5`) so the
1612
- * focus ring has room and isn't clipped at the iframe edge. It adds to the box's
1613
- * rendered height, so the skeleton's height guess includes it to avoid a jump
1614
- * when the loaded form replaces the skeleton.
1615
- */
1616
- declare const CARD_ENTRY_MARGIN_PX = 2;
1617
- type CardEntryConfig = {
1618
- /** Mounted fields, in DOM/visual order. */
1619
- inputs: CardEntryInputName[];
1620
- /** Whether the animated card-brand icon renders left of the PAN slot. */
1621
- hasIcon?: boolean;
1622
- /** Whether the layout may drop to two rows when narrow (default true). */
1623
- allowTwoRow?: boolean;
1624
- };
1625
- type CardEntryDivider = {
1626
- area: string;
1627
- orientation: 'v' | 'h';
1628
- };
1629
- type CardEntryLayout = {
1630
- /** grid-template for the wide (inline) layout. */
1631
- inline: string;
1632
- /** grid-template for the narrow (two-row) layout, or null if it never reflows. */
1633
- twoRow: string | null;
1634
- /**
1635
- * Container width (px) below which the two-row layout applies, measured on the
1636
- * query container (full iframe width, incl. the form's border). Null when the
1637
- * config never reflows.
1638
- */
1639
- breakpointPx: number | null;
1640
- /** grid-area names that hold a field, in DOM order (same in both layouts). */
1641
- fieldAreas: string[];
1642
- /** Whether an `icon` area is present (both layouts). */
1643
- hasIconArea: boolean;
1644
- /** Accent-line elements shown only in the two-row layout. */
1645
- twoRowDividers: CardEntryDivider[];
1646
- };
1647
- /** Resolve the full layout (templates + breakpoint + areas) for a config. */
1648
- declare function buildCardEntryLayout({ inputs, hasIcon, allowTwoRow, }: CardEntryConfig): CardEntryLayout;
1649
- /**
1650
- * Container-query CSS that switches `gridSelector` between the inline and
1651
- * two-row templates at the layout's breakpoint. The element matched by
1652
- * `gridSelector` must be a descendant of a `container-type: inline-size`
1653
- * ancestor named `containerName`.
1654
- *
1655
- * `extraBaseRules` are emitted before the `@container` block (e.g. the default
1656
- * hidden state of two-row-only dividers); `extraCompactRules` are emitted inside
1657
- * it (e.g. revealing those dividers / hiding wide-only chrome). Keeping the base
1658
- * state first ensures the compact rules win when the query matches.
1659
- */
1660
- declare function buildCardEntryGridCss({ gridSelector, layout, containerName, extraBaseRules, extraCompactRules, }: {
1661
- gridSelector: string;
1662
- layout: CardEntryLayout;
1663
- containerName?: string;
1664
- extraBaseRules?: string;
1665
- extraCompactRules?: string;
1666
- }): string;
1667
-
1668
2269
  /**
1669
2270
  * Framework-agnostic definitions for the V2 card-form skeleton loader.
1670
2271
  *
@@ -1800,6 +2401,41 @@ declare function awaitForterToken({ timeoutMs, intervalMs, }?: {
1800
2401
  intervalMs?: number;
1801
2402
  }): Promise<string | null>;
1802
2403
 
2404
+ /**
2405
+ * A Plaid link token is scoped to exactly one country at mint time, and the
2406
+ * OAuth leg of Plaid Link requires the *same* token the session started with.
2407
+ * So the token has to be cached, which makes it easy to hand a session a token
2408
+ * minted for the wrong rail — a US-scoped token opens the US institution list
2409
+ * no matter which country the caller asked for.
2410
+ *
2411
+ * Caching the country alongside the token lets a reader refuse a token that was
2412
+ * not minted for the rail it needs.
2413
+ */
2414
+ interface CachedLinkToken {
2415
+ token: string;
2416
+ /** Absent for flows that do not choose a rail, and for legacy cache entries. */
2417
+ country?: string;
2418
+ }
2419
+ declare function serializeCachedLinkToken(cached: CachedLinkToken): string;
2420
+ /**
2421
+ * Reads a cache entry, tolerating the bare-token strings written before the
2422
+ * country was recorded. Those have unknown provenance, so they come back with
2423
+ * no country and `canReuseLinkToken` will refuse them for a specific rail.
2424
+ */
2425
+ declare function parseCachedLinkToken(raw: string | null | undefined): CachedLinkToken | null;
2426
+ /**
2427
+ * True when a cached token may be handed to a session for `country`.
2428
+ *
2429
+ * A caller that names a country needs a token minted for that same country;
2430
+ * anything else (a different rail, or an entry whose rail we never recorded)
2431
+ * has to be re-minted. A caller that names no country takes what is cached,
2432
+ * which is what the OAuth leg does when resuming a session already in flight.
2433
+ */
2434
+ declare function canReuseLinkToken({ cached, country, }: {
2435
+ cached: CachedLinkToken | null;
2436
+ country?: string;
2437
+ }): boolean;
2438
+
1803
2439
  declare class CoinflowIFrameComponent {
1804
2440
  private sanitizer;
1805
2441
  iframeProps: CoinflowIFrameProps;
@@ -1812,7 +2448,7 @@ declare class CoinflowIFrameComponent {
1812
2448
  private isLoading;
1813
2449
  constructor(sanitizer: DomSanitizer);
1814
2450
  ngOnInit(): void;
1815
- onPostMessage(event: any): void;
2451
+ onPostMessage(event: MessageEvent): void;
1816
2452
  sendMessage(message: string): void;
1817
2453
  handleIframeLoad(): void;
1818
2454
  static ɵfac: i0.ɵɵFactoryDeclaration<CoinflowIFrameComponent, never>;
@@ -1912,6 +2548,16 @@ interface CardFormArgs {
1912
2548
  variant: CardFormVariant;
1913
2549
  token?: string;
1914
2550
  onLoad?: () => void;
2551
+ /**
2552
+ * Called whenever a card field in the form shows a validation error to the
2553
+ * user, with the field name and the displayed message.
2554
+ */
2555
+ onInputError?: OnInputErrorMethod;
2556
+ /**
2557
+ * Called when a card field that was showing a validation error stops showing
2558
+ * it, with the field name.
2559
+ */
2560
+ onInputValid?: OnInputValidMethod;
1915
2561
  }
1916
2562
  interface CardFormTokenResponse {
1917
2563
  token: string;
@@ -2007,5 +2653,5 @@ type WithOnLoad = {
2007
2653
  onLoad?: () => void | Promise<void>;
2008
2654
  };
2009
2655
 
2010
- export { BankingCurrencies, CARD_ENTRY_BORDER_PX, CARD_ENTRY_DIVIDER_PX, CARD_ENTRY_MARGIN_PX, CARD_ENTRY_MIN_WIDTHS, CARD_ENTRY_ROW_HEIGHT, CARD_ENTRY_ROW_HEIGHT_PX, CARD_ENTRY_SLOT_GAP_PX, CARD_TYPE_MAPPING, COMPACT_SKELETON_HEIGHT_PX, CardType, ChargebackProtectionAccountType, CoinflowApplePayButtonComponent, CoinflowCardForm, CoinflowCardFormV2, CoinflowCardNumberInput, CoinflowCardNumberOnlyInput, CoinflowCvvInputComponent, CoinflowCvvOnlyInputComponent, CoinflowGooglePayButtonComponent, CoinflowIFrameComponent, CoinflowPurchaseComponent, CoinflowPurchaseHistoryComponent, CoinflowPurchaseProtectionComponent, CoinflowUtils, CoinflowWithdrawComponent, CoinflowWithdrawHistoryComponent, Currency, CurrencyToISO4217, DEVICE_ID_HEADER, EventBus, FORTER_TOKEN_HEADER, IFrameMessageMethods, INLINE_SKELETON_HEIGHT_PX, MerchantStyle, PaymentMethods, REFERRER_HEADER, RN_REDIRECT_MESSAGE_NAME, SESSION_ID_HEADER, SKELETON_BOX_STYLE, SKELETON_FADE_MS, SKELETON_LAYOUTS, SKELETON_PULSE_ANIMATION_NAME, SKELETON_ROOT_PADDING_PX, SettlementType, ThreeDsChallengePreference, TokenExCardNumberIframeId, TokenExCvvContainerID, WithdrawCategory, WithdrawCurrencies, WithdrawSpeed, awaitForterToken, buildCardEntryGridCss, buildCardEntryLayout, buildSkeletonCss, captureForterToken, doInitializeCvvOnlyTokenExIframe, doInitializeTokenExCardOnlyIframe, doInitializeTokenExIframe, getCoinflowProtectionHeaders, getCoinflowPurchaseHeaders, getCurrencyDecimals, getCustomerName, getForterToken, getHandlers, getIframeConfig, getSkeletonColors, getSkeletonGridClass, getSkeletonGridTemplate, getWalletPubkey, guessSkeletonHeightPx, handleIFrameMessage, initCoinflowProtection, invertRate, isBankingCurrency, isTypedCurrencyCents, isWithdrawCurrency, isZeroAuthSavedPaymentMethods, isZeroAuthVerifyCard, nftCartItem, paymentMethodLabels, productType, recordFrontendError, setTokenExScriptTag, shouldStackSkeleton };
2011
- export type { AccountFundingTransaction, AnyObject, ArbitrumWalletProps, AuthDeclinedWalletCallInfo, BankingCurrency, BaseWalletProps, CardEntryConfig, CardEntryDivider, CardEntryInputName, CardEntryLayout, CardFormArgs, CardFormInputStyles, CardFormTokenResponse, CardFormVariant, Cart, CartClassOmitted, CartItem, CartItemClassOmitted, Cents, ChargebackProtectionData, ChargebackProtectionItem, CoinflowArbitrumHistoryProps, CoinflowArbitrumPurchaseProps, CoinflowArbitrumWithdrawProps, CoinflowBaseHistoryProps, CoinflowBasePurchaseProps, CoinflowBaseWithdrawProps, CoinflowBlockchain, CoinflowCardNumberInputProps, CoinflowCardTokenResponse, CoinflowCommonPaymentIntentProps, CoinflowCommonPurchaseProps, CoinflowCommonWithdrawProps, CoinflowCvvOnlyInputProps, CoinflowEnvs, CoinflowEthHistoryProps, CoinflowEthPurchaseProps, CoinflowEthWithdrawProps, CoinflowEvmHistoryProps, CoinflowEvmPurchaseProps, CoinflowHistoryProps, CoinflowIFrameProps, CoinflowIntentsIFrameProps, CoinflowMonadHistoryProps, CoinflowMonadPurchaseProps, CoinflowMonadWithdrawProps, CoinflowPolygonHistoryProps, CoinflowPolygonPurchaseProps, CoinflowPolygonWithdrawProps, CoinflowProtectionHeadersType, CoinflowPurchaseHeadersType, CoinflowPurchaseProps, CoinflowSessionKeyHistoryProps, CoinflowSessionKeyPurchaseProps, CoinflowSolanaHistoryProps, CoinflowSolanaPurchaseProps, CoinflowSolanaWithdrawProps, CoinflowStellarHistoryProps, CoinflowStellarPurchaseProps, CoinflowStellarWithdrawProps, CoinflowTempoHistoryProps, CoinflowTempoPurchaseProps, CoinflowTempoWithdrawProps, CoinflowTypes, CoinflowWithdrawProps, CommonDoInitializeTokenExIframeArgs, CommonEvmRedeem, CryptoCartItem, CurrencyCents, CustomerInfo, DecentRedeem, DoInitializeCvvOnlyTokenExIframeArgs, DoInitializeTokenExIframeArgs, EthWallet, EthWalletProps, EventBusCallback, EvmTransactionData, ExchangeRate, FullName, GetIFrameConfigArgs, GiftCardCartItem, IFrameMessageHandlers, KnownTokenIdRedeem, MerchantIdOrCheckoutJwt, MerchantTheme, MergeWithOptionalDiff, MonadWalletProps, NameCustomerInfo, NftCartItemClassOmitted, NormalRedeem, OnAuthDeclinedMethod, OnSuccessMethod, PartialBy, PolygonWalletProps, PurchaseCustomPayInFee, RecipientAftInfo, RemainingLimit, ReturnedTokenIdRedeem, SafeMintRedeem, SkeletonColors, SkeletonLayout, SolanaWallet, SolanaWalletProps, SplitNameCustomerInfo, StellarWallet, StellarWalletProps, Subtotal, TempoWalletProps, TokenExIFrameConfiguration, TokenExIframe, TokenRedeem, TokenSubtotal, TokenizationResponse, TypedCurrencyCents, VersionDetail, WalletCall, WalletTypes, WithGeo, WithOnLoad, WithdrawCurrency, ZeroAuthSavedPaymentMethods, ZeroAuthVerifyCard, ZeroAuthorizationConfig };
2656
+ export { BANK_LINK_REVEAL_DELAY_MS, BANK_LINK_STATUS_PARAM, BankingCurrencies, CARD_ENTRY_BORDER_PX, CARD_ENTRY_DIVIDER_PX, CARD_ENTRY_MARGIN_PX, CARD_ENTRY_MIN_WIDTHS, CARD_ENTRY_ROW_HEIGHT, CARD_ENTRY_ROW_HEIGHT_PX, CARD_ENTRY_SLOT_GAP_PX, CARD_FIELD_ERROR_MESSAGES, CARD_TYPE_MAPPING, COMPACT_SKELETON_HEIGHT_PX, CardType, ChargebackProtectionAccountType, CoinflowApplePayButtonComponent, CoinflowCardForm, CoinflowCardFormV2, CoinflowCardNumberInput, CoinflowCardNumberOnlyInput, CoinflowCvvInputComponent, CoinflowCvvOnlyInputComponent, CoinflowGooglePayButtonComponent, CoinflowIFrameComponent, CoinflowPurchaseComponent, CoinflowPurchaseHistoryComponent, CoinflowPurchaseProtectionComponent, CoinflowUtils, CoinflowWithdrawComponent, CoinflowWithdrawHistoryComponent, Currency, CurrencyToISO4217, DEVICE_ID_HEADER, EventBus, FORTER_TOKEN_HEADER, IFrameMessageMethods, INLINE_SKELETON_HEIGHT_PX, MerchantStyle, PaymentMethods, REFERRER_HEADER, RN_REDIRECT_MESSAGE_NAME, SESSION_ID_HEADER, SKELETON_BOX_STYLE, SKELETON_FADE_MS, SKELETON_LAYOUTS, SKELETON_PULSE_ANIMATION_NAME, SKELETON_ROOT_PADDING_PX, SettlementType, ThreeDsChallengePreference, TokenExCardNumberIframeId, TokenExCvvContainerID, WithdrawCategory, WithdrawCurrencies, WithdrawSpeed, awaitForterToken, bankLinkCallbackParams, buildCardEntryGridCss, buildCardEntryLayout, buildSkeletonCss, canReuseLinkToken, captureForterToken, doInitializeCvvOnlyTokenExIframe, doInitializeTokenExCardOnlyIframe, doInitializeTokenExIframe, getCardFieldInputEvents, getCardFieldValidationError, getCoinflowProtectionHeaders, getCoinflowPurchaseHeaders, getCurrencyDecimals, getCustomerName, getForterToken, getHandlers, getIframeConfig, getSkeletonColors, getSkeletonGridClass, getSkeletonGridTemplate, getWalletPubkey, guessSkeletonHeightPx, handleIFrameMessage, initCoinflowProtection, invertRate, isBankingCurrency, isTypedCurrencyCents, isWithdrawCurrency, isZeroAuthSavedPaymentMethods, isZeroAuthVerifyCard, nftCartItem, parseCachedLinkToken, paymentMethodLabels, productType, recordFrontendError, resolveBankLinkCompletion, serializeCachedLinkToken, setTokenExScriptTag, shouldStackSkeleton };
2657
+ export type { AccountFundingTransaction, AccountLinkedInfo, AccountLinkedType, AccountNotLinkedInfo, AccountNotLinkedReason, AnyObject, ArbitrumWalletProps, AuthDeclinedWalletCallInfo, BankLinkCompletion, BankLinkStatus, BankingCurrency, BaseWalletProps, CachedLinkToken, CardEntryConfig, CardEntryDivider, CardEntryInputName, CardEntryLayout, CardFieldInputEvent, CardFormArgs, CardFormInputStyles, CardFormTokenResponse, CardFormVariant, Cart, CartClassOmitted, CartItem, CartItemClassOmitted, Cents, ChargebackProtectionData, ChargebackProtectionItem, CoinflowArbitrumHistoryProps, CoinflowArbitrumPurchaseProps, CoinflowArbitrumWithdrawProps, CoinflowBankLinkProps, CoinflowBaseHistoryProps, CoinflowBasePurchaseProps, CoinflowBaseWithdrawProps, CoinflowBlockchain, CoinflowCardNumberInputProps, CoinflowCardTokenResponse, CoinflowCommonPaymentIntentProps, CoinflowCommonPurchaseProps, CoinflowCommonWithdrawProps, CoinflowCvvOnlyInputProps, CoinflowEnvs, CoinflowEthHistoryProps, CoinflowEthPurchaseProps, CoinflowEthWithdrawProps, CoinflowEvmHistoryProps, CoinflowEvmPurchaseProps, CoinflowHistoryProps, CoinflowIFrameProps, CoinflowIntentsIFrameProps, CoinflowMonadHistoryProps, CoinflowMonadPurchaseProps, CoinflowMonadWithdrawProps, CoinflowPolygonHistoryProps, CoinflowPolygonPurchaseProps, CoinflowPolygonWithdrawProps, CoinflowProtectionHeadersType, CoinflowPurchaseHeadersType, CoinflowPurchaseProps, CoinflowSessionKeyHistoryProps, CoinflowSessionKeyPurchaseProps, CoinflowSolanaHistoryProps, CoinflowSolanaPurchaseProps, CoinflowSolanaWithdrawProps, CoinflowStellarHistoryProps, CoinflowStellarPurchaseProps, CoinflowStellarWithdrawProps, CoinflowTempoHistoryProps, CoinflowTempoPurchaseProps, CoinflowTempoWithdrawProps, CoinflowTypes, CoinflowWithdrawProps, CommonDoInitializeTokenExIframeArgs, CommonEvmRedeem, CryptoCartItem, CurrencyCents, CustomerInfo, DecentRedeem, DoInitializeCvvOnlyTokenExIframeArgs, DoInitializeTokenExIframeArgs, EthWallet, EthWalletProps, EventBusCallback, EvmTransactionData, ExchangeRate, FlightTicketCartItem, FlightUpgradeCartItem, FullName, GetIFrameConfigArgs, GiftCardCartItem, IFrameMessageHandlers, InputErrorWalletCallInfo, InputValidWalletCallInfo, KnownTokenIdRedeem, LamportsAmount, LodgingCartItem, MerchantIdOrCheckoutJwt, MerchantTheme, MergeWithOptionalDiff, MonadWalletProps, NameCustomerInfo, NftCartItemClassOmitted, NormalRedeem, OnAccountLinkedMethod, OnAccountNotLinkedMethod, OnAuthDeclinedMethod, OnInputErrorMethod, OnInputValidMethod, OnSuccessMethod, PartialBy, PolygonWalletProps, PurchaseCustomPayInFee, RecipientAftInfo, RemainingLimit, ReturnedTokenIdRedeem, SafeMintRedeem, SkeletonColors, SkeletonLayout, SolanaWallet, SolanaWalletProps, SplitNameCustomerInfo, StellarWallet, StellarWalletProps, Subtotal, TempoWalletProps, TokenExIFrameConfiguration, TokenExIframe, TokenRedeem, TokenSubtotal, TokenizationResponse, TravelCartItem, TravelFirstFlight, TravelLodging, TravelLodgingHotel, TravelTrip, TypedCurrencyCents, VersionDetail, WalletCall, WalletTypes, WithGeo, WithOnLoad, WithdrawCurrency, ZeroAuthSavedPaymentMethods, ZeroAuthVerifyCard, ZeroAuthorizationConfig };