@coinflowlabs/angular 1.13.0 → 1.14.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.
|
@@ -669,6 +669,493 @@ interface MoneyTopUpCartItem {
|
|
|
669
669
|
isPresetAmount: boolean;
|
|
670
670
|
}
|
|
671
671
|
|
|
672
|
+
/**
|
|
673
|
+
* The booked hotel details
|
|
674
|
+
*/
|
|
675
|
+
interface TravelLodgingHotel {
|
|
676
|
+
/**
|
|
677
|
+
* The name of the hotel
|
|
678
|
+
* Example: The Plaza Hotel
|
|
679
|
+
*/
|
|
680
|
+
name: string;
|
|
681
|
+
/**
|
|
682
|
+
* The two-letter code of the country in which the hotel is located
|
|
683
|
+
* Example: US
|
|
684
|
+
* Pattern: ^[A-Z]{2}$
|
|
685
|
+
*/
|
|
686
|
+
country: string;
|
|
687
|
+
/**
|
|
688
|
+
* The city in which the hotel is located
|
|
689
|
+
* Example: New York
|
|
690
|
+
*/
|
|
691
|
+
city: string;
|
|
692
|
+
}
|
|
693
|
+
/**
|
|
694
|
+
* The lodging details of the travel booking
|
|
695
|
+
*/
|
|
696
|
+
interface TravelLodging {
|
|
697
|
+
/**
|
|
698
|
+
* Hotel reservation id
|
|
699
|
+
* Example: X36Q9C
|
|
700
|
+
*/
|
|
701
|
+
reservationId: string;
|
|
702
|
+
/**
|
|
703
|
+
* The number of nights booked in the reservation
|
|
704
|
+
* Min value: 1
|
|
705
|
+
* Example: 2
|
|
706
|
+
*/
|
|
707
|
+
nights: number;
|
|
708
|
+
/**
|
|
709
|
+
* The check-in date
|
|
710
|
+
* Example: 2022-05-02
|
|
711
|
+
*/
|
|
712
|
+
checkInDate: string;
|
|
713
|
+
/**
|
|
714
|
+
* The hour of day in which the check-in is done
|
|
715
|
+
* Example: 18
|
|
716
|
+
* Pattern: ^([01][0-9]|2[0-3])$
|
|
717
|
+
*/
|
|
718
|
+
checkInHour: string;
|
|
719
|
+
/**
|
|
720
|
+
* The booked hotel details
|
|
721
|
+
*/
|
|
722
|
+
hotel: TravelLodgingHotel;
|
|
723
|
+
/**
|
|
724
|
+
* Indicates whether extras were purchased in the reservation
|
|
725
|
+
*/
|
|
726
|
+
wereExtrasPurchased: boolean;
|
|
727
|
+
/**
|
|
728
|
+
* Indicates whether the reservation is refundable
|
|
729
|
+
*/
|
|
730
|
+
isRefundable: boolean;
|
|
731
|
+
/**
|
|
732
|
+
* The most luxurious room booked in the reservation
|
|
733
|
+
* Example: Presidential Suite
|
|
734
|
+
*/
|
|
735
|
+
highestRoomType: string;
|
|
736
|
+
/**
|
|
737
|
+
* The number of rooms booked in the reservation
|
|
738
|
+
* Min value: 1
|
|
739
|
+
* Example: 2
|
|
740
|
+
*/
|
|
741
|
+
numberOfRooms: number;
|
|
742
|
+
/**
|
|
743
|
+
* The number of guests in the reservation
|
|
744
|
+
* Min value: 1
|
|
745
|
+
* Example: 4
|
|
746
|
+
*/
|
|
747
|
+
numberOfGuests: number;
|
|
748
|
+
/**
|
|
749
|
+
* The number of kids, out of the number of guests in the reservation
|
|
750
|
+
* Min value: 0
|
|
751
|
+
* Example: 2
|
|
752
|
+
*/
|
|
753
|
+
numberOfKids: number;
|
|
754
|
+
}
|
|
755
|
+
/**
|
|
756
|
+
* The trip details of the travel booking
|
|
757
|
+
*/
|
|
758
|
+
interface TravelTrip {
|
|
759
|
+
/**
|
|
760
|
+
* The number of flights in the trip
|
|
761
|
+
* Min value: 1
|
|
762
|
+
* Example: 2
|
|
763
|
+
*/
|
|
764
|
+
numberOfFlights: number;
|
|
765
|
+
/**
|
|
766
|
+
* The number of checked bags
|
|
767
|
+
* Min value: 0
|
|
768
|
+
* Example: 1
|
|
769
|
+
*/
|
|
770
|
+
numberOfCheckedBags: number;
|
|
771
|
+
/**
|
|
772
|
+
* The first-way destination's three-letter IATA airport code
|
|
773
|
+
* Example: JFK
|
|
774
|
+
* Pattern: ^[A-Z]{3}$
|
|
775
|
+
*/
|
|
776
|
+
firstWayDestination: string;
|
|
777
|
+
/**
|
|
778
|
+
* `true` if the trip is a round-trip
|
|
779
|
+
* Example: true
|
|
780
|
+
*/
|
|
781
|
+
isRoundTrip: boolean;
|
|
782
|
+
/**
|
|
783
|
+
* `luxurious` if the highest bought travel class in the trip is a luxury class (business/first), `economy` otherwise
|
|
784
|
+
* Example: luxurious
|
|
785
|
+
*/
|
|
786
|
+
highestClass: 'economy' | 'luxurious';
|
|
787
|
+
/**
|
|
788
|
+
* True if the trip ticket is a flexible ticket
|
|
789
|
+
* Example: true
|
|
790
|
+
*/
|
|
791
|
+
isFlexibleTicket: boolean;
|
|
792
|
+
/**
|
|
793
|
+
* True if extras were included in the trip purchase
|
|
794
|
+
* Example: true
|
|
795
|
+
*/
|
|
796
|
+
wereExtrasPurchased: boolean;
|
|
797
|
+
}
|
|
798
|
+
/**
|
|
799
|
+
* The first flight details of the trip
|
|
800
|
+
*/
|
|
801
|
+
interface TravelFirstFlight {
|
|
802
|
+
/**
|
|
803
|
+
* The number of travelers in the first flight
|
|
804
|
+
* Min value: 1
|
|
805
|
+
* Example: 2
|
|
806
|
+
*/
|
|
807
|
+
numberOfTravelers: number;
|
|
808
|
+
/**
|
|
809
|
+
* The timestamp of the departure, in *milliseconds* since the unix epoch
|
|
810
|
+
* Example: 1551398400000
|
|
811
|
+
*/
|
|
812
|
+
departureTime: number;
|
|
813
|
+
/**
|
|
814
|
+
* The first-flight departure airport's three-letter IATA code
|
|
815
|
+
* Example: JFK
|
|
816
|
+
* Pattern: ^[A-Z]{3}$
|
|
817
|
+
*/
|
|
818
|
+
departureAirport: string;
|
|
819
|
+
/**
|
|
820
|
+
* The first-flight duration, in hours
|
|
821
|
+
* Min value: 0
|
|
822
|
+
* Example: 3.5
|
|
823
|
+
*/
|
|
824
|
+
duration: number;
|
|
825
|
+
/**
|
|
826
|
+
* The alphanumeric flight code
|
|
827
|
+
* Example: BA2491A
|
|
828
|
+
* Pattern: ^[A-Z0-9]+$
|
|
829
|
+
*/
|
|
830
|
+
flightNumber: string;
|
|
831
|
+
}
|
|
832
|
+
/**
|
|
833
|
+
* Represents a travel booking item in a shopping cart
|
|
834
|
+
*/
|
|
835
|
+
interface TravelCartItem {
|
|
836
|
+
/**
|
|
837
|
+
* Denotes the cart item class. The item schema is chosen based on this value.
|
|
838
|
+
* Allowed value: travel
|
|
839
|
+
* Example: travel
|
|
840
|
+
*/
|
|
841
|
+
itemClass: 'travel';
|
|
842
|
+
/**
|
|
843
|
+
* The cart items's unique ID
|
|
844
|
+
* Example: 5de33332-546a-4171-8988-2a43d2bfe9c6
|
|
845
|
+
*/
|
|
846
|
+
id?: string;
|
|
847
|
+
/**
|
|
848
|
+
* Any additional product data which can be provided, e.g. description, link to image, etc
|
|
849
|
+
* Example: {"any":"data","description":"This is the product description"}
|
|
850
|
+
*/
|
|
851
|
+
rawProductData?: AnyObject;
|
|
852
|
+
/**
|
|
853
|
+
* The item's selling price
|
|
854
|
+
*/
|
|
855
|
+
sellingPrice: CurrencyAmount;
|
|
856
|
+
/**
|
|
857
|
+
* The item's list price
|
|
858
|
+
*/
|
|
859
|
+
listPrice?: CurrencyAmount;
|
|
860
|
+
/**
|
|
861
|
+
* The user's personal info
|
|
862
|
+
*/
|
|
863
|
+
recipientInfo?: RecipientInfo;
|
|
864
|
+
/**
|
|
865
|
+
* The lodging details of the travel booking
|
|
866
|
+
*/
|
|
867
|
+
lodging: TravelLodging;
|
|
868
|
+
/**
|
|
869
|
+
* The flight ticket's PNR code
|
|
870
|
+
* Example: X36Q9C
|
|
871
|
+
*/
|
|
872
|
+
pnr: string;
|
|
873
|
+
/**
|
|
874
|
+
* The trip details of the travel booking
|
|
875
|
+
*/
|
|
876
|
+
trip: TravelTrip;
|
|
877
|
+
/**
|
|
878
|
+
* The first flight details of the trip
|
|
879
|
+
*/
|
|
880
|
+
firstFlight: TravelFirstFlight;
|
|
881
|
+
}
|
|
882
|
+
|
|
883
|
+
/**
|
|
884
|
+
* Represents a flight ticket item in a shopping cart
|
|
885
|
+
*/
|
|
886
|
+
interface FlightTicketCartItem {
|
|
887
|
+
/**
|
|
888
|
+
* Denotes the cart item class. The item schema is chosen based on this value.
|
|
889
|
+
* Allowed value: flightTicket
|
|
890
|
+
* Example: flightTicket
|
|
891
|
+
*/
|
|
892
|
+
itemClass: 'flightTicket';
|
|
893
|
+
/**
|
|
894
|
+
* The cart items's unique ID
|
|
895
|
+
* Example: 5de33332-546a-4171-8988-2a43d2bfe9c6
|
|
896
|
+
*/
|
|
897
|
+
id?: string;
|
|
898
|
+
/**
|
|
899
|
+
* Any additional product data which can be provided, e.g. description, link to image, etc
|
|
900
|
+
* Example: {"any":"data","description":"This is the product description"}
|
|
901
|
+
*/
|
|
902
|
+
rawProductData?: AnyObject;
|
|
903
|
+
/**
|
|
904
|
+
* The item's selling price
|
|
905
|
+
*/
|
|
906
|
+
sellingPrice: CurrencyAmount;
|
|
907
|
+
/**
|
|
908
|
+
* The item's list price
|
|
909
|
+
*/
|
|
910
|
+
listPrice?: CurrencyAmount;
|
|
911
|
+
/**
|
|
912
|
+
* The user's personal info
|
|
913
|
+
*/
|
|
914
|
+
recipientInfo?: RecipientInfo;
|
|
915
|
+
/**
|
|
916
|
+
* The flight ticket's PNR code
|
|
917
|
+
* Example: X36Q9C
|
|
918
|
+
*/
|
|
919
|
+
pnr: string;
|
|
920
|
+
/**
|
|
921
|
+
* The trip details of the flight ticket
|
|
922
|
+
*/
|
|
923
|
+
trip: TravelTrip;
|
|
924
|
+
/**
|
|
925
|
+
* The first flight details of the trip
|
|
926
|
+
*/
|
|
927
|
+
firstFlight: TravelFirstFlight;
|
|
928
|
+
}
|
|
929
|
+
|
|
930
|
+
/**
|
|
931
|
+
* Represents a flight upgrade item in a shopping cart
|
|
932
|
+
*/
|
|
933
|
+
interface FlightUpgradeCartItem {
|
|
934
|
+
/**
|
|
935
|
+
* Denotes the cart item class. The item schema is chosen based on this value.
|
|
936
|
+
* Allowed value: flightUpgrade
|
|
937
|
+
* Example: flightUpgrade
|
|
938
|
+
*/
|
|
939
|
+
itemClass: 'flightUpgrade';
|
|
940
|
+
/**
|
|
941
|
+
* The cart items's unique ID
|
|
942
|
+
* Example: 5de33332-546a-4171-8988-2a43d2bfe9c6
|
|
943
|
+
*/
|
|
944
|
+
id?: string;
|
|
945
|
+
/**
|
|
946
|
+
* Any additional product data which can be provided, e.g. description, link to image, etc
|
|
947
|
+
* Example: {"any":"data","description":"This is the product description"}
|
|
948
|
+
*/
|
|
949
|
+
rawProductData?: AnyObject;
|
|
950
|
+
/**
|
|
951
|
+
* The item's selling price
|
|
952
|
+
*/
|
|
953
|
+
sellingPrice: CurrencyAmount;
|
|
954
|
+
/**
|
|
955
|
+
* The item's list price
|
|
956
|
+
*/
|
|
957
|
+
listPrice?: CurrencyAmount;
|
|
958
|
+
/**
|
|
959
|
+
* The user's personal info
|
|
960
|
+
*/
|
|
961
|
+
recipientInfo?: RecipientInfo;
|
|
962
|
+
/**
|
|
963
|
+
* The flight ticket's PNR code
|
|
964
|
+
* Example: X36Q9C
|
|
965
|
+
*/
|
|
966
|
+
pnr?: string;
|
|
967
|
+
/**
|
|
968
|
+
* The type of upgrade
|
|
969
|
+
* Example: changes
|
|
970
|
+
*/
|
|
971
|
+
upgradeType: 'changes' | 'fareIncrease' | 'baggage' | 'seats' | 'insurance' | 'other';
|
|
972
|
+
/**
|
|
973
|
+
* The upgrade description, required when the upgrade type is `other`
|
|
974
|
+
*/
|
|
975
|
+
description?: string;
|
|
976
|
+
}
|
|
977
|
+
|
|
978
|
+
/**
|
|
979
|
+
* Represents a lodging reservation item in a shopping cart.
|
|
980
|
+
* The reservation fields are flattened at the top level of the item.
|
|
981
|
+
*/
|
|
982
|
+
interface LodgingCartItem extends TravelLodging {
|
|
983
|
+
/**
|
|
984
|
+
* Denotes the cart item class. The item schema is chosen based on this value.
|
|
985
|
+
* Allowed value: lodging
|
|
986
|
+
* Example: lodging
|
|
987
|
+
*/
|
|
988
|
+
itemClass: 'lodging';
|
|
989
|
+
/**
|
|
990
|
+
* The cart items's unique ID
|
|
991
|
+
* Example: 5de33332-546a-4171-8988-2a43d2bfe9c6
|
|
992
|
+
*/
|
|
993
|
+
id?: string;
|
|
994
|
+
/**
|
|
995
|
+
* Any additional product data which can be provided, e.g. description, link to image, etc
|
|
996
|
+
* Example: {"any":"data","description":"This is the product description"}
|
|
997
|
+
*/
|
|
998
|
+
rawProductData?: AnyObject;
|
|
999
|
+
/**
|
|
1000
|
+
* The item's selling price
|
|
1001
|
+
*/
|
|
1002
|
+
sellingPrice: CurrencyAmount;
|
|
1003
|
+
/**
|
|
1004
|
+
* The item's list price
|
|
1005
|
+
*/
|
|
1006
|
+
listPrice?: CurrencyAmount;
|
|
1007
|
+
/**
|
|
1008
|
+
* The user's personal info
|
|
1009
|
+
*/
|
|
1010
|
+
recipientInfo?: RecipientInfo;
|
|
1011
|
+
}
|
|
1012
|
+
|
|
1013
|
+
/**
|
|
1014
|
+
* Single source of truth for the card-entry responsive layout.
|
|
1015
|
+
*
|
|
1016
|
+
* The real card-entry form (`UnifiedCardEntry` in the core-flows app) and the
|
|
1017
|
+
* React/Vue/Angular skeleton loaders all render the same grid. Historically the
|
|
1018
|
+
* form drove the inline↔two-row switch from JS (a ResizeObserver toggling React
|
|
1019
|
+
* state) while the skeletons hard-coded their own guesses, so the two drifted.
|
|
1020
|
+
*
|
|
1021
|
+
* This module defines the grid templates and the breakpoint ONCE, as pure data
|
|
1022
|
+
* plus a CSS builder, so every consumer reflows at exactly the same width via a
|
|
1023
|
+
* CSS container query — no JS width measurement, nothing to keep in sync.
|
|
1024
|
+
*/
|
|
1025
|
+
type CardEntryInputName = 'card-number' | 'expiration' | 'cvv';
|
|
1026
|
+
/**
|
|
1027
|
+
* Minimum width (px) each field needs before the row is too cramped and the
|
|
1028
|
+
* layout drops to two rows. Mirrors the real form's field sizing.
|
|
1029
|
+
*/
|
|
1030
|
+
declare const CARD_ENTRY_MIN_WIDTHS: Record<CardEntryInputName, number>;
|
|
1031
|
+
/** Notional gap (px) between fields, summed into the reflow breakpoint. */
|
|
1032
|
+
declare const CARD_ENTRY_SLOT_GAP_PX = 8;
|
|
1033
|
+
/** Field row height — matches the real form's `3rem` grid rows. */
|
|
1034
|
+
declare const CARD_ENTRY_ROW_HEIGHT = "3rem";
|
|
1035
|
+
declare const CARD_ENTRY_ROW_HEIGHT_PX = 48;
|
|
1036
|
+
/** 1px accent line between rows / between exp & cvv in the two-row layout. */
|
|
1037
|
+
declare const CARD_ENTRY_DIVIDER_PX = 1;
|
|
1038
|
+
/**
|
|
1039
|
+
* The form draws its fields inside a 1px border, so the query container (the
|
|
1040
|
+
* full iframe width) is 2px wider than the field row that `minRowWidth`
|
|
1041
|
+
* describes. The breakpoint bakes this in so form and skeleton flip together.
|
|
1042
|
+
*/
|
|
1043
|
+
declare const CARD_ENTRY_BORDER_PX = 1;
|
|
1044
|
+
/**
|
|
1045
|
+
* The form insets its box by this much on every side (Tailwind `m-0.5`) so the
|
|
1046
|
+
* focus ring has room and isn't clipped at the iframe edge. It adds to the box's
|
|
1047
|
+
* rendered height, so the skeleton's height guess includes it to avoid a jump
|
|
1048
|
+
* when the loaded form replaces the skeleton.
|
|
1049
|
+
*/
|
|
1050
|
+
declare const CARD_ENTRY_MARGIN_PX = 2;
|
|
1051
|
+
type CardEntryConfig = {
|
|
1052
|
+
/** Mounted fields, in DOM/visual order. */
|
|
1053
|
+
inputs: CardEntryInputName[];
|
|
1054
|
+
/** Whether the animated card-brand icon renders left of the PAN slot. */
|
|
1055
|
+
hasIcon?: boolean;
|
|
1056
|
+
/** Whether the layout may drop to two rows when narrow (default true). */
|
|
1057
|
+
allowTwoRow?: boolean;
|
|
1058
|
+
};
|
|
1059
|
+
type CardEntryDivider = {
|
|
1060
|
+
area: string;
|
|
1061
|
+
orientation: 'v' | 'h';
|
|
1062
|
+
};
|
|
1063
|
+
type CardEntryLayout = {
|
|
1064
|
+
/** grid-template for the wide (inline) layout. */
|
|
1065
|
+
inline: string;
|
|
1066
|
+
/** grid-template for the narrow (two-row) layout, or null if it never reflows. */
|
|
1067
|
+
twoRow: string | null;
|
|
1068
|
+
/**
|
|
1069
|
+
* Container width (px) below which the two-row layout applies, measured on the
|
|
1070
|
+
* query container (full iframe width, incl. the form's border). Null when the
|
|
1071
|
+
* config never reflows.
|
|
1072
|
+
*/
|
|
1073
|
+
breakpointPx: number | null;
|
|
1074
|
+
/** grid-area names that hold a field, in DOM order (same in both layouts). */
|
|
1075
|
+
fieldAreas: string[];
|
|
1076
|
+
/** Whether an `icon` area is present (both layouts). */
|
|
1077
|
+
hasIconArea: boolean;
|
|
1078
|
+
/** Accent-line elements shown only in the two-row layout. */
|
|
1079
|
+
twoRowDividers: CardEntryDivider[];
|
|
1080
|
+
};
|
|
1081
|
+
/** Resolve the full layout (templates + breakpoint + areas) for a config. */
|
|
1082
|
+
declare function buildCardEntryLayout({ inputs, hasIcon, allowTwoRow, }: CardEntryConfig): CardEntryLayout;
|
|
1083
|
+
/**
|
|
1084
|
+
* Container-query CSS that switches `gridSelector` between the inline and
|
|
1085
|
+
* two-row templates at the layout's breakpoint. The element matched by
|
|
1086
|
+
* `gridSelector` must be a descendant of a `container-type: inline-size`
|
|
1087
|
+
* ancestor named `containerName`.
|
|
1088
|
+
*
|
|
1089
|
+
* `extraBaseRules` are emitted before the `@container` block (e.g. the default
|
|
1090
|
+
* hidden state of two-row-only dividers); `extraCompactRules` are emitted inside
|
|
1091
|
+
* it (e.g. revealing those dividers / hiding wide-only chrome). Keeping the base
|
|
1092
|
+
* state first ensures the compact rules win when the query matches.
|
|
1093
|
+
*/
|
|
1094
|
+
declare function buildCardEntryGridCss({ gridSelector, layout, containerName, extraBaseRules, extraCompactRules, }: {
|
|
1095
|
+
gridSelector: string;
|
|
1096
|
+
layout: CardEntryLayout;
|
|
1097
|
+
containerName?: string;
|
|
1098
|
+
extraBaseRules?: string;
|
|
1099
|
+
extraCompactRules?: string;
|
|
1100
|
+
}): string;
|
|
1101
|
+
|
|
1102
|
+
/**
|
|
1103
|
+
* Single source of truth for the validation errors the card entry shows below
|
|
1104
|
+
* the card box. The same value drives the on-screen message and the
|
|
1105
|
+
* `inputError` iframe message emitted to the parent, so the parent can never
|
|
1106
|
+
* be told about an error the user isn't seeing.
|
|
1107
|
+
*/
|
|
1108
|
+
|
|
1109
|
+
type InputErrorWalletCallInfo = {
|
|
1110
|
+
field: CardEntryInputName;
|
|
1111
|
+
message: string;
|
|
1112
|
+
};
|
|
1113
|
+
/** Emitted when a field that was showing an error stops showing it. */
|
|
1114
|
+
type InputValidWalletCallInfo = {
|
|
1115
|
+
field: CardEntryInputName;
|
|
1116
|
+
};
|
|
1117
|
+
declare const CARD_FIELD_ERROR_MESSAGES: {
|
|
1118
|
+
readonly cardNumber: "Card number is invalid. Please double check information.";
|
|
1119
|
+
readonly expiration: "Expiration is invalid. Please double check information.";
|
|
1120
|
+
readonly cvv: "CVV is invalid. Please double check information.";
|
|
1121
|
+
readonly cvvEmpty: "Please enter your CVV to proceed.";
|
|
1122
|
+
};
|
|
1123
|
+
declare function getCardFieldValidationError({ cardError, expirationError, cvvError, cvvEmpty, isCvvOnly, }: {
|
|
1124
|
+
cardError: boolean;
|
|
1125
|
+
expirationError: boolean;
|
|
1126
|
+
cvvError: boolean;
|
|
1127
|
+
cvvEmpty: boolean;
|
|
1128
|
+
isCvvOnly: boolean;
|
|
1129
|
+
}): InputErrorWalletCallInfo | null;
|
|
1130
|
+
/**
|
|
1131
|
+
* An iframe message the card entry should emit for a change in validation
|
|
1132
|
+
* state. `kind` rather than IFrameMessageMethods keeps this module free of a
|
|
1133
|
+
* circular import (CoinflowLibMessageHandlers imports the payload types here).
|
|
1134
|
+
*/
|
|
1135
|
+
type CardFieldInputEvent = {
|
|
1136
|
+
kind: 'error';
|
|
1137
|
+
info: InputErrorWalletCallInfo;
|
|
1138
|
+
} | {
|
|
1139
|
+
kind: 'valid';
|
|
1140
|
+
info: InputValidWalletCallInfo;
|
|
1141
|
+
};
|
|
1142
|
+
/**
|
|
1143
|
+
* Derives which messages to emit for a transition between two validation
|
|
1144
|
+
* states, so the parent hears about each change exactly once.
|
|
1145
|
+
*
|
|
1146
|
+
* Nothing is emitted while the state is unchanged (including the pristine
|
|
1147
|
+
* state, where both sides are null), so a field that is never invalid stays
|
|
1148
|
+
* silent and a visible error is not re-sent on every render.
|
|
1149
|
+
*
|
|
1150
|
+
* Only one error is displayed at a time (see getCardFieldValidationError's
|
|
1151
|
+
* precedence), so when the displayed error moves to a different field the
|
|
1152
|
+
* previous field has necessarily become valid and gets its own clear event.
|
|
1153
|
+
*/
|
|
1154
|
+
declare function getCardFieldInputEvents({ previous, current, }: {
|
|
1155
|
+
previous: InputErrorWalletCallInfo | null;
|
|
1156
|
+
current: InputErrorWalletCallInfo | null;
|
|
1157
|
+
}): CardFieldInputEvent[];
|
|
1158
|
+
|
|
672
1159
|
declare enum WithdrawCategory {
|
|
673
1160
|
USER = "user",
|
|
674
1161
|
BUSINESS = "business",
|
|
@@ -685,7 +1172,8 @@ declare enum WithdrawSpeed {
|
|
|
685
1172
|
VENMO = "venmo",
|
|
686
1173
|
PAYPAL = "paypal",
|
|
687
1174
|
WIRE = "wire",
|
|
688
|
-
INTERAC = "interac"
|
|
1175
|
+
INTERAC = "interac",
|
|
1176
|
+
SWIFT = "swift"
|
|
689
1177
|
}
|
|
690
1178
|
declare enum SettlementType {
|
|
691
1179
|
Credits = "Credits",
|
|
@@ -820,6 +1308,8 @@ type AuthDeclinedWalletCallInfo = {
|
|
|
820
1308
|
total: string;
|
|
821
1309
|
};
|
|
822
1310
|
type OnAuthDeclinedMethod = (args: AuthDeclinedWalletCallInfo) => void | Promise<void>;
|
|
1311
|
+
type OnInputErrorMethod = (args: InputErrorWalletCallInfo) => void | Promise<void>;
|
|
1312
|
+
type OnInputValidMethod = (args: InputValidWalletCallInfo) => void | Promise<void>;
|
|
823
1313
|
/** Wallets **/
|
|
824
1314
|
interface SolanaWallet {
|
|
825
1315
|
publicKey: PublicKey | null;
|
|
@@ -909,11 +1399,11 @@ declare enum ChargebackProtectionAccountType {
|
|
|
909
1399
|
PRIVATE = "private",
|
|
910
1400
|
BUSINESS = "business"
|
|
911
1401
|
}
|
|
912
|
-
type CartItemClassOmitted = NftCartItemClassOmitted | Omit<GiftCardCartItem, 'listPrice'> | CryptoCartItem | MoneyTopUpCartItem;
|
|
1402
|
+
type CartItemClassOmitted = NftCartItemClassOmitted | Omit<GiftCardCartItem, 'listPrice'> | CryptoCartItem | MoneyTopUpCartItem | TravelCartItem | FlightTicketCartItem | FlightUpgradeCartItem | LodgingCartItem;
|
|
913
1403
|
type ChargebackProtectionItem = CartItemClassOmitted;
|
|
914
1404
|
type NftCartItemClassOmitted = Omit<nftCartItem, 'sellingPrice' | 'itemClass'>;
|
|
915
1405
|
type Cart = CartItem[];
|
|
916
|
-
type CartItem = Omit<nftCartItem, 'listPrice' | 'sellingPrice'> | Omit<GiftCardCartItem, 'listPrice'> | CryptoCartItem | MoneyTopUpCartItem;
|
|
1406
|
+
type CartItem = Omit<nftCartItem, 'listPrice' | 'sellingPrice'> | Omit<GiftCardCartItem, 'listPrice'> | CryptoCartItem | MoneyTopUpCartItem | TravelCartItem | FlightTicketCartItem | FlightUpgradeCartItem | LodgingCartItem;
|
|
917
1407
|
declare enum ThreeDsChallengePreference {
|
|
918
1408
|
NoPreference = "NoPreference",
|
|
919
1409
|
Frictionless = "Frictionless",
|
|
@@ -942,6 +1432,16 @@ interface CoinflowCommonPaymentIntentProps extends Omit<CoinflowTypes, 'blockcha
|
|
|
942
1432
|
paymentIntentId: string;
|
|
943
1433
|
onSuccess?: OnSuccessMethod;
|
|
944
1434
|
onAuthDeclined?: OnAuthDeclinedMethod;
|
|
1435
|
+
/**
|
|
1436
|
+
* Called whenever a card field (card number, expiration, cvv) shows a
|
|
1437
|
+
* validation error to the user, with the field name and the displayed message.
|
|
1438
|
+
*/
|
|
1439
|
+
onInputError?: OnInputErrorMethod;
|
|
1440
|
+
/**
|
|
1441
|
+
* Called when a card field that was showing a validation error stops showing
|
|
1442
|
+
* it, with the field name.
|
|
1443
|
+
*/
|
|
1444
|
+
onInputValid?: OnInputValidMethod;
|
|
945
1445
|
/**
|
|
946
1446
|
* If true, pre-checks the partial USDC payment checkbox when USDC balance is available.
|
|
947
1447
|
* If false or undefined, maintains default behavior (unchecked).
|
|
@@ -974,10 +1474,25 @@ interface CoinflowCommonPaymentIntentProps extends Omit<CoinflowTypes, 'blockcha
|
|
|
974
1474
|
}
|
|
975
1475
|
interface CoinflowCommonPurchaseProps extends CoinflowTypes {
|
|
976
1476
|
subtotal?: Subtotal;
|
|
1477
|
+
/**
|
|
1478
|
+
* When true, the Apple Pay button skips the totals (fee quote) fetch and
|
|
1479
|
+
* charges exactly the `subtotal` passed to the component.
|
|
1480
|
+
*/
|
|
1481
|
+
useNativeSubtotal?: boolean;
|
|
977
1482
|
presentment?: Currency;
|
|
978
1483
|
onSuccess?: OnSuccessMethod;
|
|
979
1484
|
sessionKey?: string;
|
|
980
1485
|
onAuthDeclined?: OnAuthDeclinedMethod;
|
|
1486
|
+
/**
|
|
1487
|
+
* Called whenever a card field (card number, expiration, cvv) shows a
|
|
1488
|
+
* validation error to the user, with the field name and the displayed message.
|
|
1489
|
+
*/
|
|
1490
|
+
onInputError?: OnInputErrorMethod;
|
|
1491
|
+
/**
|
|
1492
|
+
* Called when a card field that was showing a validation error stops showing
|
|
1493
|
+
* it, with the field name.
|
|
1494
|
+
*/
|
|
1495
|
+
onInputValid?: OnInputValidMethod;
|
|
981
1496
|
webhookInfo?: {
|
|
982
1497
|
[key: string]: any;
|
|
983
1498
|
};
|
|
@@ -1047,6 +1562,13 @@ interface WithGeo {
|
|
|
1047
1562
|
lat: number;
|
|
1048
1563
|
lng: number;
|
|
1049
1564
|
};
|
|
1565
|
+
/**
|
|
1566
|
+
* Deep link (custom scheme or universal link) that reopens the host app.
|
|
1567
|
+
* Used by browser-handoff checkouts (e.g. Venmo on React Native) so the
|
|
1568
|
+
* standalone checkout page can route the customer back into the app after
|
|
1569
|
+
* the payment app returns them to the browser.
|
|
1570
|
+
*/
|
|
1571
|
+
appReturnUrl?: string;
|
|
1050
1572
|
}
|
|
1051
1573
|
/**
|
|
1052
1574
|
* Used for Account Funding Transactions
|
|
@@ -1148,12 +1670,22 @@ interface CoinflowCommonWithdrawProps extends CoinflowTypes {
|
|
|
1148
1670
|
lat: number;
|
|
1149
1671
|
lng: number;
|
|
1150
1672
|
};
|
|
1673
|
+
/**
|
|
1674
|
+
* Deep link (custom scheme or universal link) that reopens the host app.
|
|
1675
|
+
* Used by browser-handoff flows on React Native — Venmo checkout and the
|
|
1676
|
+
* "Log in with PayPal" payout flow — so the standalone page routes the user
|
|
1677
|
+
* back into the app after the payment/login app returns them to the browser.
|
|
1678
|
+
* When omitted, PayPal linking still completes via polling but the user must
|
|
1679
|
+
* switch back to the app manually.
|
|
1680
|
+
*/
|
|
1681
|
+
appReturnUrl?: string;
|
|
1151
1682
|
}
|
|
1152
1683
|
type WalletTypes = SolanaWallet | EthWallet | StellarWallet;
|
|
1153
1684
|
interface SolanaWalletProps {
|
|
1154
1685
|
wallet: SolanaWallet;
|
|
1155
1686
|
connection: Connection;
|
|
1156
1687
|
blockchain: 'solana';
|
|
1688
|
+
ownerOverride?: string;
|
|
1157
1689
|
}
|
|
1158
1690
|
type CoinflowSolanaWithdrawProps = CoinflowCommonWithdrawProps & SolanaWalletProps;
|
|
1159
1691
|
interface EvmWalletProps {
|
|
@@ -1304,7 +1836,7 @@ interface DecentRedeem extends CommonEvmRedeem {
|
|
|
1304
1836
|
* 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
1837
|
*/
|
|
1306
1838
|
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 {
|
|
1839
|
+
interface CoinflowIFrameProps extends Omit<CoinflowTypes, 'merchantId' | 'handleHeightChange'>, Pick<CoinflowCommonPurchaseProps, 'chargebackProtectionData' | 'chargebackProtectionAccountType' | 'webhookInfo' | 'subtotal' | 'useNativeSubtotal' | '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 {
|
|
1308
1840
|
walletPubkey: string | null | undefined;
|
|
1309
1841
|
sessionKey?: string;
|
|
1310
1842
|
route: string;
|
|
@@ -1317,7 +1849,13 @@ interface CoinflowIFrameProps extends Omit<CoinflowTypes, 'merchantId' | 'handle
|
|
|
1317
1849
|
disableGooglePay?: boolean;
|
|
1318
1850
|
theme?: MerchantTheme;
|
|
1319
1851
|
usePermit?: boolean;
|
|
1852
|
+
ownerOverride?: string;
|
|
1320
1853
|
handleHeightChangeId: string | number;
|
|
1854
|
+
/**
|
|
1855
|
+
* Identifier linking a React Native Apple Pay WebView to its hidden bridge
|
|
1856
|
+
* WebView for subtotal updates relayed through localStorage.
|
|
1857
|
+
*/
|
|
1858
|
+
bridgeId?: string;
|
|
1321
1859
|
}
|
|
1322
1860
|
interface CoinflowIntentsIFrameProps {
|
|
1323
1861
|
theme?: MerchantTheme;
|
|
@@ -1392,7 +1930,7 @@ declare class CoinflowUtils {
|
|
|
1392
1930
|
static getCoinflowBaseUrl(env?: CoinflowEnvs): string;
|
|
1393
1931
|
static getCoinflowAppBaseUrl(env?: CoinflowEnvs): string;
|
|
1394
1932
|
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 & {
|
|
1933
|
+
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, lockAmount, nativeSolToConvert, theme, usePermit, transactionSigner, authOnly, deviceId, jwtToken, origins, threeDsChallengePreference, supportEmail, destinationAuthKey, allowedPaymentMethods, accountFundingTransaction, partialUsdcChecked, redemptionCheck, allowedWithdrawSpeeds, isZeroAuthorization, zeroAuthorizationConfig, userLocation, appReturnUrl, depositAmounts, ownerOverride, bridgeId, baseUrl, }: CoinflowIFrameProps & {
|
|
1396
1934
|
baseUrl?: string;
|
|
1397
1935
|
} & WithGeo): string;
|
|
1398
1936
|
static getCoinflowIntentsUrl({ baseUrl, route, color, theme, env, origins, deviceId, merchantCss, loaderBackground, handleHeightChangeId, }: CoinflowIntentsIFrameProps & {
|
|
@@ -1442,6 +1980,8 @@ interface IFrameMessageHandlers {
|
|
|
1442
1980
|
handleHeightChange?: (height: string) => void;
|
|
1443
1981
|
onSuccess: OnSuccessMethod | undefined;
|
|
1444
1982
|
onAuthDeclined: OnAuthDeclinedMethod | undefined;
|
|
1983
|
+
onInputError?: OnInputErrorMethod | undefined;
|
|
1984
|
+
onInputValid?: OnInputValidMethod | undefined;
|
|
1445
1985
|
/**
|
|
1446
1986
|
* Called when the iframe opens/closes an in-page overlay (e.g. the PayPal
|
|
1447
1987
|
* approval modal). `state` is 'open' or 'close'.
|
|
@@ -1455,14 +1995,17 @@ declare enum IFrameMessageMethods {
|
|
|
1455
1995
|
HeightChange = "heightChange",
|
|
1456
1996
|
Success = "success",
|
|
1457
1997
|
AuthDeclined = "authDeclined",
|
|
1998
|
+
InputError = "inputError",
|
|
1999
|
+
InputValid = "inputValid",
|
|
1458
2000
|
Loaded = "loaded",
|
|
1459
2001
|
AccountLinked = "accountLinked",
|
|
1460
2002
|
Redirect = "redirect",
|
|
1461
|
-
Overlay = "overlay"
|
|
2003
|
+
Overlay = "overlay",
|
|
2004
|
+
UpdateSubtotal = "updateSubtotal"
|
|
1462
2005
|
}
|
|
1463
2006
|
declare function getWalletPubkey(input: Pick<CoinflowPurchaseProps, 'wallet' | 'blockchain'>): string | null | undefined;
|
|
1464
2007
|
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'>;
|
|
2008
|
+
declare function getHandlers(props: Pick<CoinflowPurchaseProps, 'wallet' | 'blockchain' | 'onSuccess' | 'onAuthDeclined' | 'onInputError' | 'onInputValid'>): Omit<IFrameMessageHandlers, 'handleHeightChange'>;
|
|
1466
2009
|
|
|
1467
2010
|
type EventBusCallback = (event: Event) => void;
|
|
1468
2011
|
declare class EventBus {
|
|
@@ -1576,95 +2119,6 @@ declare function doInitializeCvvOnlyTokenExIframe(args: DoInitializeCvvOnlyToken
|
|
|
1576
2119
|
declare function doInitializeTokenExIframe(args: DoInitializeTokenExIframeArgs): Promise<TokenExIframe | undefined>;
|
|
1577
2120
|
declare function doInitializeTokenExCardOnlyIframe(args: DoInitializeTokenExIframeArgs): Promise<TokenExIframe | undefined>;
|
|
1578
2121
|
|
|
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
2122
|
/**
|
|
1669
2123
|
* Framework-agnostic definitions for the V2 card-form skeleton loader.
|
|
1670
2124
|
*
|
|
@@ -1800,6 +2254,41 @@ declare function awaitForterToken({ timeoutMs, intervalMs, }?: {
|
|
|
1800
2254
|
intervalMs?: number;
|
|
1801
2255
|
}): Promise<string | null>;
|
|
1802
2256
|
|
|
2257
|
+
/**
|
|
2258
|
+
* A Plaid link token is scoped to exactly one country at mint time, and the
|
|
2259
|
+
* OAuth leg of Plaid Link requires the *same* token the session started with.
|
|
2260
|
+
* So the token has to be cached, which makes it easy to hand a session a token
|
|
2261
|
+
* minted for the wrong rail — a US-scoped token opens the US institution list
|
|
2262
|
+
* no matter which country the caller asked for.
|
|
2263
|
+
*
|
|
2264
|
+
* Caching the country alongside the token lets a reader refuse a token that was
|
|
2265
|
+
* not minted for the rail it needs.
|
|
2266
|
+
*/
|
|
2267
|
+
interface CachedLinkToken {
|
|
2268
|
+
token: string;
|
|
2269
|
+
/** Absent for flows that do not choose a rail, and for legacy cache entries. */
|
|
2270
|
+
country?: string;
|
|
2271
|
+
}
|
|
2272
|
+
declare function serializeCachedLinkToken(cached: CachedLinkToken): string;
|
|
2273
|
+
/**
|
|
2274
|
+
* Reads a cache entry, tolerating the bare-token strings written before the
|
|
2275
|
+
* country was recorded. Those have unknown provenance, so they come back with
|
|
2276
|
+
* no country and `canReuseLinkToken` will refuse them for a specific rail.
|
|
2277
|
+
*/
|
|
2278
|
+
declare function parseCachedLinkToken(raw: string | null | undefined): CachedLinkToken | null;
|
|
2279
|
+
/**
|
|
2280
|
+
* True when a cached token may be handed to a session for `country`.
|
|
2281
|
+
*
|
|
2282
|
+
* A caller that names a country needs a token minted for that same country;
|
|
2283
|
+
* anything else (a different rail, or an entry whose rail we never recorded)
|
|
2284
|
+
* has to be re-minted. A caller that names no country takes what is cached,
|
|
2285
|
+
* which is what the OAuth leg does when resuming a session already in flight.
|
|
2286
|
+
*/
|
|
2287
|
+
declare function canReuseLinkToken({ cached, country, }: {
|
|
2288
|
+
cached: CachedLinkToken | null;
|
|
2289
|
+
country?: string;
|
|
2290
|
+
}): boolean;
|
|
2291
|
+
|
|
1803
2292
|
declare class CoinflowIFrameComponent {
|
|
1804
2293
|
private sanitizer;
|
|
1805
2294
|
iframeProps: CoinflowIFrameProps;
|
|
@@ -1912,6 +2401,16 @@ interface CardFormArgs {
|
|
|
1912
2401
|
variant: CardFormVariant;
|
|
1913
2402
|
token?: string;
|
|
1914
2403
|
onLoad?: () => void;
|
|
2404
|
+
/**
|
|
2405
|
+
* Called whenever a card field in the form shows a validation error to the
|
|
2406
|
+
* user, with the field name and the displayed message.
|
|
2407
|
+
*/
|
|
2408
|
+
onInputError?: OnInputErrorMethod;
|
|
2409
|
+
/**
|
|
2410
|
+
* Called when a card field that was showing a validation error stops showing
|
|
2411
|
+
* it, with the field name.
|
|
2412
|
+
*/
|
|
2413
|
+
onInputValid?: OnInputValidMethod;
|
|
1915
2414
|
}
|
|
1916
2415
|
interface CardFormTokenResponse {
|
|
1917
2416
|
token: string;
|
|
@@ -2007,5 +2506,5 @@ type WithOnLoad = {
|
|
|
2007
2506
|
onLoad?: () => void | Promise<void>;
|
|
2008
2507
|
};
|
|
2009
2508
|
|
|
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 };
|
|
2509
|
+
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_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, 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, serializeCachedLinkToken, setTokenExScriptTag, shouldStackSkeleton };
|
|
2510
|
+
export type { AccountFundingTransaction, AnyObject, ArbitrumWalletProps, AuthDeclinedWalletCallInfo, BankingCurrency, BaseWalletProps, CachedLinkToken, CardEntryConfig, CardEntryDivider, CardEntryInputName, CardEntryLayout, CardFieldInputEvent, 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, FlightTicketCartItem, FlightUpgradeCartItem, FullName, GetIFrameConfigArgs, GiftCardCartItem, IFrameMessageHandlers, InputErrorWalletCallInfo, InputValidWalletCallInfo, KnownTokenIdRedeem, LodgingCartItem, MerchantIdOrCheckoutJwt, MerchantTheme, MergeWithOptionalDiff, MonadWalletProps, NameCustomerInfo, NftCartItemClassOmitted, NormalRedeem, 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 };
|