@coinflowlabs/angular 1.12.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.
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { PublicKey, Transaction, VersionedTransaction, Signer, Connection } from '@solana/web3.js';
|
|
2
2
|
import { Properties } from 'csstype';
|
|
3
|
+
import * as _coinflowlabs_angular from '@coinflowlabs/angular';
|
|
3
4
|
import * as i0 from '@angular/core';
|
|
4
|
-
import { EventEmitter, ElementRef, OnDestroy, SimpleChanges, OnInit } from '@angular/core';
|
|
5
|
+
import { EventEmitter, ElementRef, OnDestroy, SimpleChanges, OnInit, NgZone } from '@angular/core';
|
|
5
6
|
import { SafeResourceUrl, DomSanitizer } from '@angular/platform-browser';
|
|
6
|
-
import * as _coinflowlabs_angular from '@coinflowlabs/angular';
|
|
7
7
|
|
|
8
8
|
declare enum Currency {
|
|
9
9
|
USD = "USD",
|
|
@@ -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,6 +2119,111 @@ 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
|
|
|
2122
|
+
/**
|
|
2123
|
+
* Framework-agnostic definitions for the V2 card-form skeleton loader.
|
|
2124
|
+
*
|
|
2125
|
+
* The React, Vue, and Angular libraries all render the same skeleton while the
|
|
2126
|
+
* card-form iframe loads. The grid templates and breakpoint come from the shared
|
|
2127
|
+
* {@link buildCardEntryLayout} — the SAME source of truth the real form uses —
|
|
2128
|
+
* so the skeleton reflows at exactly the width the loaded form does. Only the
|
|
2129
|
+
* box styling and per-framework wiring live here.
|
|
2130
|
+
*/
|
|
2131
|
+
type CardFormVariant = 'card-form' | 'card-number-form' | 'cvv-form';
|
|
2132
|
+
declare const INLINE_SKELETON_HEIGHT_PX: number;
|
|
2133
|
+
/** Two-row layouts are a second field row plus the 1px divider taller. */
|
|
2134
|
+
declare const COMPACT_SKELETON_HEIGHT_PX: number;
|
|
2135
|
+
type SkeletonLayout = {
|
|
2136
|
+
/** Single-row grid used at the iframe's default (wide) width. */
|
|
2137
|
+
inline: string;
|
|
2138
|
+
/** Two-row grid applied below `compactMaxWidthPx`; omitted when it never reflows. */
|
|
2139
|
+
compact?: string;
|
|
2140
|
+
/** Container width (px) below which the two-row grid applies. */
|
|
2141
|
+
compactMaxWidthPx?: number;
|
|
2142
|
+
/** grid-area names to render one skeleton box for, in DOM order (same in both layouts). */
|
|
2143
|
+
areas: string[];
|
|
2144
|
+
};
|
|
2145
|
+
declare const SKELETON_LAYOUTS: Record<CardFormVariant, SkeletonLayout>;
|
|
2146
|
+
/** Name of the shared pulse keyframes; referenced by the box `animation`. */
|
|
2147
|
+
declare const SKELETON_PULSE_ANIMATION_NAME = "coinflow-card-form-skeleton-pulse";
|
|
2148
|
+
/**
|
|
2149
|
+
* Duration (ms) of the skeleton's opacity fade-out. Matches the `opacity 300ms`
|
|
2150
|
+
* transition each renderer applies. Renderers unmount the skeleton on
|
|
2151
|
+
* `transitionend`, but that event can be skipped (reduced-motion, an ancestor
|
|
2152
|
+
* `display:none`, or opacity already 0) — so they also use this as a fallback
|
|
2153
|
+
* timeout to force the unmount and avoid a stuck (invisible) skeleton.
|
|
2154
|
+
*/
|
|
2155
|
+
declare const SKELETON_FADE_MS = 300;
|
|
2156
|
+
/**
|
|
2157
|
+
* Whether the given container width would trigger the variant's two-row layout.
|
|
2158
|
+
* Mirrors the real form's container query (`width < breakpoint`). Variants
|
|
2159
|
+
* without a two-row layout never reflow.
|
|
2160
|
+
*/
|
|
2161
|
+
declare function shouldStackSkeleton({ variant, width, }: {
|
|
2162
|
+
variant: CardFormVariant;
|
|
2163
|
+
width: number;
|
|
2164
|
+
}): boolean;
|
|
2165
|
+
/**
|
|
2166
|
+
* Height to guess before the iframe reports its real height. The two-row layout
|
|
2167
|
+
* is a field row plus divider taller than the inline one.
|
|
2168
|
+
*/
|
|
2169
|
+
declare function guessSkeletonHeightPx({ variant, width, }: {
|
|
2170
|
+
variant: CardFormVariant;
|
|
2171
|
+
width: number;
|
|
2172
|
+
}): number;
|
|
2173
|
+
/**
|
|
2174
|
+
* The `grid-template` to apply for the given container width. Frameworks that
|
|
2175
|
+
* drive the layout from JS (Vue, Angular) call this from their resize observer;
|
|
2176
|
+
* React instead injects a CSS container query via {@link buildSkeletonCss}.
|
|
2177
|
+
*/
|
|
2178
|
+
declare function getSkeletonGridTemplate({ variant, width, }: {
|
|
2179
|
+
variant: CardFormVariant;
|
|
2180
|
+
width: number;
|
|
2181
|
+
}): string;
|
|
2182
|
+
/** Stable class name for a variant's skeleton grid element. */
|
|
2183
|
+
declare function getSkeletonGridClass(variant: CardFormVariant): string;
|
|
2184
|
+
/**
|
|
2185
|
+
* CSS (keyframes + grid + container-query breakpoint) for the container-query
|
|
2186
|
+
* driven renderer used by React, where the skeleton root is a query container.
|
|
2187
|
+
*/
|
|
2188
|
+
declare function buildSkeletonCss(variant: CardFormVariant): string;
|
|
2189
|
+
/**
|
|
2190
|
+
* Padding (px) to inset the skeleton grid by, applied on the skeleton root. It
|
|
2191
|
+
* equals the form's own chrome — its `m-0.5` margin plus 1px border — so the
|
|
2192
|
+
* boxes land in the same area the real fields will, and the grid fills the root
|
|
2193
|
+
* exactly (no dead space that would make the boxes look too short).
|
|
2194
|
+
*/
|
|
2195
|
+
declare const SKELETON_ROOT_PADDING_PX: number;
|
|
2196
|
+
/**
|
|
2197
|
+
* Inline style for each skeleton box, MINUS the `background` — the fill color is
|
|
2198
|
+
* theme-dependent (see {@link getSkeletonColors}) so each renderer merges it in.
|
|
2199
|
+
* A hairline margin keeps a subtle gap between boxes while letting them fill
|
|
2200
|
+
* nearly the full field height (the root padding handles the outer inset). Uses
|
|
2201
|
+
* string units so it renders identically in React, Vue, and Angular.
|
|
2202
|
+
*/
|
|
2203
|
+
declare const SKELETON_BOX_STYLE: {
|
|
2204
|
+
readonly minWidth: "0";
|
|
2205
|
+
readonly margin: "1px";
|
|
2206
|
+
readonly borderRadius: "4px";
|
|
2207
|
+
readonly opacity: "1";
|
|
2208
|
+
readonly animation: "coinflow-card-form-skeleton-pulse 1.5s ease-in-out infinite";
|
|
2209
|
+
};
|
|
2210
|
+
type SkeletonColors = {
|
|
2211
|
+
/** Faint backdrop behind the boxes. */
|
|
2212
|
+
backdrop: string;
|
|
2213
|
+
/** Box fill. */
|
|
2214
|
+
box: string;
|
|
2215
|
+
};
|
|
2216
|
+
/**
|
|
2217
|
+
* Best-effort skeleton palette. The skeleton renders in the SDK (parent), so it
|
|
2218
|
+
* can't see the form's resolved colors — it only has the optional `theme` the
|
|
2219
|
+
* integrator passed. When `theme.background` is a parseable color we tint the
|
|
2220
|
+
* skeleton light-on-dark or dark-on-light to match; otherwise we fall back to a
|
|
2221
|
+
* neutral mid-grey that stays visible on any surface.
|
|
2222
|
+
*/
|
|
2223
|
+
declare function getSkeletonColors(theme?: {
|
|
2224
|
+
background?: string;
|
|
2225
|
+
}): SkeletonColors;
|
|
2226
|
+
|
|
1579
2227
|
declare const DEVICE_ID_HEADER = "x-device-id";
|
|
1580
2228
|
declare const SESSION_ID_HEADER = "x-session-id";
|
|
1581
2229
|
declare const REFERRER_HEADER = "x-coinflow-referrer";
|
|
@@ -1606,6 +2254,41 @@ declare function awaitForterToken({ timeoutMs, intervalMs, }?: {
|
|
|
1606
2254
|
intervalMs?: number;
|
|
1607
2255
|
}): Promise<string | null>;
|
|
1608
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
|
+
|
|
1609
2292
|
declare class CoinflowIFrameComponent {
|
|
1610
2293
|
private sanitizer;
|
|
1611
2294
|
iframeProps: CoinflowIFrameProps;
|
|
@@ -1715,25 +2398,82 @@ interface CardFormArgs {
|
|
|
1715
2398
|
merchantId: string;
|
|
1716
2399
|
env?: CoinflowEnvs;
|
|
1717
2400
|
theme?: MerchantTheme;
|
|
1718
|
-
variant:
|
|
2401
|
+
variant: CardFormVariant;
|
|
1719
2402
|
token?: string;
|
|
1720
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;
|
|
1721
2414
|
}
|
|
1722
2415
|
interface CardFormTokenResponse {
|
|
1723
2416
|
token: string;
|
|
1724
2417
|
expMonth?: string;
|
|
1725
2418
|
expYear?: string;
|
|
1726
2419
|
}
|
|
1727
|
-
declare class CoinflowCardForm implements OnInit {
|
|
2420
|
+
declare class CoinflowCardForm implements OnInit, OnDestroy {
|
|
1728
2421
|
private sanitizer;
|
|
2422
|
+
private zone;
|
|
1729
2423
|
args: CardFormArgs;
|
|
1730
2424
|
iframeRef: ElementRef<HTMLIFrameElement>;
|
|
2425
|
+
wrapperRef: ElementRef<HTMLElement>;
|
|
1731
2426
|
url?: SafeResourceUrl;
|
|
1732
2427
|
loaded: boolean;
|
|
1733
2428
|
iframeHeight: number | null;
|
|
1734
|
-
|
|
2429
|
+
private layout;
|
|
2430
|
+
areas: string[];
|
|
2431
|
+
private guessHeight;
|
|
2432
|
+
private gridTemplate;
|
|
2433
|
+
rendered: boolean;
|
|
2434
|
+
private observer;
|
|
2435
|
+
private unmountTimer;
|
|
2436
|
+
constructor(sanitizer: DomSanitizer, zone: NgZone);
|
|
1735
2437
|
ngOnInit(): void;
|
|
2438
|
+
ngOnDestroy(): void;
|
|
2439
|
+
get height(): string;
|
|
2440
|
+
get skeletonRootStyle(): {
|
|
2441
|
+
position: string;
|
|
2442
|
+
top: number;
|
|
2443
|
+
left: number;
|
|
2444
|
+
width: string;
|
|
2445
|
+
height: string;
|
|
2446
|
+
display: string;
|
|
2447
|
+
pointerEvents: string;
|
|
2448
|
+
flexDirection: string;
|
|
2449
|
+
gap: string;
|
|
2450
|
+
padding: string;
|
|
2451
|
+
boxSizing: string;
|
|
2452
|
+
borderRadius: string;
|
|
2453
|
+
background: string;
|
|
2454
|
+
opacity: string;
|
|
2455
|
+
transition: string;
|
|
2456
|
+
};
|
|
2457
|
+
get gridStyle(): {
|
|
2458
|
+
display: string;
|
|
2459
|
+
gap: number;
|
|
2460
|
+
flex: number;
|
|
2461
|
+
width: string;
|
|
2462
|
+
gridTemplate: string;
|
|
2463
|
+
};
|
|
2464
|
+
get skeletonColors(): _coinflowlabs_angular.SkeletonColors;
|
|
2465
|
+
boxStyle(area: string): {
|
|
2466
|
+
background: string;
|
|
2467
|
+
gridArea: string;
|
|
2468
|
+
minWidth: "0";
|
|
2469
|
+
margin: "1px";
|
|
2470
|
+
borderRadius: "4px";
|
|
2471
|
+
opacity: "1";
|
|
2472
|
+
animation: "coinflow-card-form-skeleton-pulse 1.5s ease-in-out infinite";
|
|
2473
|
+
};
|
|
1736
2474
|
onMessage(event: MessageEvent): void;
|
|
2475
|
+
onSkeletonTransitionEnd(e: TransitionEvent): void;
|
|
2476
|
+
private observeWidth;
|
|
1737
2477
|
private buildUrl;
|
|
1738
2478
|
private handleMessage;
|
|
1739
2479
|
tokenize(): Promise<CardFormTokenResponse>;
|
|
@@ -1766,5 +2506,5 @@ type WithOnLoad = {
|
|
|
1766
2506
|
onLoad?: () => void | Promise<void>;
|
|
1767
2507
|
};
|
|
1768
2508
|
|
|
1769
|
-
export { BankingCurrencies, CARD_TYPE_MAPPING, 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, MerchantStyle, PaymentMethods, REFERRER_HEADER, RN_REDIRECT_MESSAGE_NAME, SESSION_ID_HEADER, SettlementType, ThreeDsChallengePreference, TokenExCardNumberIframeId, TokenExCvvContainerID, WithdrawCategory, WithdrawCurrencies, WithdrawSpeed, awaitForterToken, captureForterToken, doInitializeCvvOnlyTokenExIframe, doInitializeTokenExCardOnlyIframe, doInitializeTokenExIframe, getCoinflowProtectionHeaders, getCoinflowPurchaseHeaders, getCurrencyDecimals, getCustomerName, getForterToken, getHandlers, getIframeConfig, getWalletPubkey, handleIFrameMessage, initCoinflowProtection, invertRate, isBankingCurrency, isTypedCurrencyCents, isWithdrawCurrency, isZeroAuthSavedPaymentMethods, isZeroAuthVerifyCard, nftCartItem, paymentMethodLabels, productType, recordFrontendError, setTokenExScriptTag };
|
|
1770
|
-
export type { AccountFundingTransaction, AnyObject, ArbitrumWalletProps, AuthDeclinedWalletCallInfo, BankingCurrency, BaseWalletProps, CardFormArgs, CardFormInputStyles, CardFormTokenResponse, 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, 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 };
|