@coinflowlabs/angular 1.1.4 → 1.1.5

package/lib/coinflow-iframe.component.d.ts

@@ -6,13 +6,17 @@ export declare class CoinflowIFrameComponent {
     private sanitizer;
     iframeProps: CoinflowIFrameProps;
     messageHandlers: IFrameMessageHandlers;
+    onLoad?: () => void | Promise<void>;
+    waitForLoadedMessage?: boolean;
     messageEvent: EventEmitter<any>;
     dynamicUrl?: SafeResourceUrl;
     iframe?: ElementRef<HTMLIFrameElement>;
+    private isLoading;
     constructor(sanitizer: DomSanitizer);
     ngOnInit(): void;
     onPostMessage(event: any): void;
     sendMessage(message: string): void;
+    handleIframeLoad(): void;
     static ɵfac: i0.ɵɵFactoryDeclaration<CoinflowIFrameComponent, never>;
-    static ɵcmp: i0.ɵɵComponentDeclaration<CoinflowIFrameComponent, "lib-coinflow-iframe", never, { "iframeProps": { "alias": "iframeProps"; "required": false; }; "messageHandlers": { "alias": "messageHandlers"; "required": false; }; }, { "messageEvent": "messageEvent"; }, never, never, true, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<CoinflowIFrameComponent, "lib-coinflow-iframe", never, { "iframeProps": { "alias": "iframeProps"; "required": false; }; "messageHandlers": { "alias": "messageHandlers"; "required": false; }; "onLoad": { "alias": "onLoad"; "required": false; }; "waitForLoadedMessage": { "alias": "waitForLoadedMessage"; "required": false; }; }, { "messageEvent": "messageEvent"; }, never, never, true, never>;
 }

package/lib/coinflow-purchase.component.d.ts

@@ -1,7 +1,8 @@
 import { CoinflowIFrameProps, CoinflowPurchaseProps, IFrameMessageHandlers } from './common';
+import { WithOnLoad } from '../public-api';
 import * as i0 from "@angular/core";
 export declare class CoinflowPurchaseComponent {
-    purchaseProps: CoinflowPurchaseProps;
+    purchaseProps: CoinflowPurchaseProps & WithOnLoad;
     iframeProps?: CoinflowIFrameProps;
     messageHandlers?: IFrameMessageHandlers;
     ngOnInit(): void;

package/lib/coinflow-withdraw.component.d.ts

@@ -1,7 +1,8 @@
 import { CoinflowIFrameProps, CoinflowWithdrawProps, IFrameMessageHandlers } from './common';
+import { WithOnLoad } from '../public-api';
 import * as i0 from "@angular/core";
 export declare class CoinflowWithdrawComponent {
-    withdrawProps: CoinflowWithdrawProps;
+    withdrawProps: CoinflowWithdrawProps & WithOnLoad;
     iframeProps?: CoinflowIFrameProps;
     messageHandlers?: IFrameMessageHandlers;
     ngOnInit(): void;

package/lib/common/CoinflowTypes.d.ts

@@ -212,6 +212,17 @@ export interface CoinflowCommonPurchaseProps extends CoinflowTypes {
     origins?: string[];
     threeDsChallengePreference?: ThreeDsChallengePreference;
     destinationAuthKey?: string;
+    accountFundingTransaction?: AccountFundingTransaction;
+}
+/**
+ * Used for Account Funding Transactions
+ */
+export interface AccountFundingTransaction {
+    /**
+     * Recipient information for Account Funding Transactions (AFT).
+     * Required when AFT is enabled and type requires it.
+     */
+    recipientAftInfo?: RecipientAftInfo;
 }
 export interface CoinflowSolanaPurchaseProps extends CoinflowCommonPurchaseProps {
     wallet: SolanaWallet;
@@ -314,27 +325,62 @@ export interface CommonEvmRedeem {
      */
     waitForHash?: boolean;
 }
+/**
+ * (EVM only) If your contract sends the item/service being purchased via a custom "receiver" field, then utilize this object.
+ *
+ * The coinflow contract calls the "to" contract, which transfers the NFT/item to the "receiver" address defined in the contract function arguments.
+ */
 export interface NormalRedeem extends CommonEvmRedeem {
+    /**
+     * Transaction to be called.
+     */
     transaction: {
+        /**
+         * The merchant's whitelisted contract
+         */
         to: string;
+        /**
+         * The data to call this contract with, HEX encoded.
+         *
+         * The coinflow contract calls the "to" contract, contract pulls USDC from msg.sender, and transfers the NFT/item to the "receiver" address defined in the contract function arguments.
+         */
         data: string;
     };
 }
+/**
+ * (EVM only) If your know the ID of the NFT being purchased, then utilize this object.
+ *
+ * The contract transfers the NFT to msg.sender (which is the Coinflow contract), the Coinflow contract fwd's the NFT to the end user's wallet.
+ */
 export interface KnownTokenIdRedeem extends NormalRedeem {
     /**
-     * @minLength 42 Please provide a valid EVM Public Key (42 Characters Long)
-     * @maxLength 42 Please provide a valid EVM Public Key (42 Characters Long)
+     * The address of the Nft's Contract
+     *
+     * @minLength 42 Please provide a valid EVM Address (42 Characters Long)
+     * @maxLength 42 Please provide a valid EVM Address (42 Characters Long)
      */
     nftContract: string;
     /**
+     * The ID of the NFT being purchased. Will be forwarded by the Coinflow contract to the customer's wallet.
+     *
      * @minLength 1 Please provide a valid Nft Id
      */
     nftId: string;
 }
+/**
+ * (EVM only) If your contract mints an NFT via a OpenZeppelin Safe Mint Call, then utilize this object.
+ *
+ * The contract mints the NFT to msg.sender (which is the Coinflow contract), the Coinflow contract picks up the SafeMint event, and fwd's the NFT to the end user's wallet.
+ */
 export interface SafeMintRedeem extends NormalRedeem {
     type: 'safeMint';
     nftContract?: string;
 }
+/**
+ * (EVM only) If your contract returns the NFT ID, then utilize this object.
+ *
+ * The contract mints the NFT to msg.sender (which is the Coinflow contract), the Coinflow contract picks up the returned NFT ID, and fwd's the NFT to the end user's wallet.
+ */
 export interface ReturnedTokenIdRedeem extends NormalRedeem {
     type: 'returned';
     nftContract?: string;
@@ -359,13 +405,13 @@ export interface ReservoirRedeem extends CommonEvmRedeem {
     /** @deprecated Reservoir decided to sunset Reservoir NFT, including their API and associated services, effective October 15, 2025. */
     taker?: string;
 }
-/** @deprecated */
 export interface TokenRedeem extends CommonEvmRedeem {
-    /** @deprecated */
     type: 'token';
-    /** @deprecated */
     destination: string;
 }
+/**
+ * If your contract exists on a chain supported by Decent, pass this object in order to call it.
+ */
 export interface DecentRedeem extends CommonEvmRedeem {
     type: 'decent';
     /**
@@ -398,8 +444,13 @@ export interface DecentRedeem extends CommonEvmRedeem {
         isNative: boolean;
     };
 }
+/**
+ * (EVM only) if you want to execute an EVM transaction on a successful purchase, you can pass a transaction request here.
+ *
+ * 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.
+ */
 export type EvmTransactionData = SafeMintRedeem | ReturnedTokenIdRedeem | KnownTokenIdRedeem | NormalRedeem | TokenRedeem | DecentRedeem | ReservoirRedeem;
-export interface CoinflowIFrameProps extends Omit<CoinflowTypes, 'merchantId' | 'handleHeightChange'>, Pick<CoinflowCommonPurchaseProps, 'chargebackProtectionData' | 'webhookInfo' | 'subtotal' | 'presentment' | 'customerInfo' | 'settlementType' | 'email' | 'planCode' | 'deviceId' | 'jwtToken' | 'origins' | 'threeDsChallengePreference' | 'supportEmail' | 'allowedPaymentMethods'>, Pick<CoinflowCommonWithdrawProps, 'bankAccountLinkRedirect' | 'additionalWallets' | 'transactionSigner' | 'lockAmount' | 'lockDefaultToken' | 'origins'>, Pick<CoinflowEvmPurchaseProps, 'authOnly'>, Pick<CoinflowSolanaPurchaseProps, 'rent' | 'nativeSolToConvert' | 'destinationAuthKey'> {
+export interface CoinflowIFrameProps extends Omit<CoinflowTypes, 'merchantId' | 'handleHeightChange'>, Pick<CoinflowCommonPurchaseProps, 'chargebackProtectionData' | 'webhookInfo' | 'subtotal' | 'presentment' | 'customerInfo' | 'settlementType' | 'email' | 'planCode' | 'deviceId' | 'jwtToken' | 'origins' | 'threeDsChallengePreference' | 'supportEmail' | 'allowedPaymentMethods' | 'accountFundingTransaction'>, Pick<CoinflowCommonWithdrawProps, 'bankAccountLinkRedirect' | 'additionalWallets' | 'transactionSigner' | 'lockAmount' | 'lockDefaultToken' | 'origins'>, Pick<CoinflowEvmPurchaseProps, 'authOnly'>, Pick<CoinflowSolanaPurchaseProps, 'rent' | 'nativeSolToConvert' | 'destinationAuthKey'> {
     walletPubkey: string | null | undefined;
     sessionKey?: string;
     route: string;
@@ -420,4 +471,44 @@ export declare enum CardType {
     AMEX = "AMEX",
     DISCOVER = "DISC"
 }
+export interface RecipientAftInfo {
+    /**
+     * @minLength 2
+     */
+    firstName: string;
+    /**
+     * @minLength 2
+     */
+    lastName: string;
+    /**
+     * @minLength 2
+     */
+    address1: string;
+    /**
+     * @minLength 2
+     */
+    city: string;
+    /**
+     * @minLength 2
+     */
+    postalCode: string;
+    /**
+     * @minLength 2
+     */
+    state?: string;
+    /**
+     * @minLength 2
+     * @maxLength 2
+     */
+    countryCode: string;
+    /**
+     * @pattern ^\d{8}$
+     */
+    dateOfBirth: string;
+    /**
+     * @pattern ^\d+$
+     */
+    phoneNumber?: string;
+    documentReference?: string;
+}
 export {};

package/lib/common/CoinflowUtils.d.ts

@@ -6,7 +6,7 @@ export declare class CoinflowUtils {
     getNSurePartnerId(merchantId: string): Promise<string | undefined>;
     static getCoinflowBaseUrl(env?: CoinflowEnvs): string;
     static getCoinflowApiUrl(env?: CoinflowEnvs): string;
-    static getCoinflowUrl({ walletPubkey, sessionKey, route, routePrefix, env, subtotal, presentment, transaction, blockchain, webhookInfo, email, loaderBackground, handleHeightChangeId, bankAccountLinkRedirect, additionalWallets, chargebackProtectionData, merchantCss, color, rent, lockDefaultToken, tokens, planCode, disableApplePay, disableGooglePay, customerInfo, settlementType, lockAmount, nativeSolToConvert, theme, usePermit, transactionSigner, authOnly, deviceId, jwtToken, origins, threeDsChallengePreference, supportEmail, destinationAuthKey, allowedPaymentMethods, }: CoinflowIFrameProps): string;
+    static getCoinflowUrl({ walletPubkey, sessionKey, route, routePrefix, env, subtotal, presentment, transaction, blockchain, webhookInfo, email, loaderBackground, handleHeightChangeId, bankAccountLinkRedirect, additionalWallets, chargebackProtectionData, merchantCss, color, rent, lockDefaultToken, tokens, planCode, disableApplePay, disableGooglePay, customerInfo, settlementType, lockAmount, nativeSolToConvert, theme, usePermit, transactionSigner, authOnly, deviceId, jwtToken, origins, threeDsChallengePreference, supportEmail, destinationAuthKey, allowedPaymentMethods, accountFundingTransaction, }: CoinflowIFrameProps): string;
     static getTransaction(props: CoinflowPurchaseProps): string | undefined;
     static byBlockchain<T>(blockchain: CoinflowBlockchain, args: {
         solana: T;

package/lib/common/EventBus.d.ts

@@ -0,0 +1,6 @@
+export type EventBusCallback = (event: Event) => void;
+export declare class EventBus {
+    static on(type: string, callback: EventBusCallback): void;
+    static dispatch(type: string, data: any): void;
+    static remove(type: string, callback: EventBusCallback): void;
+}

package/lib/common/index.d.ts

@@ -1,6 +1,7 @@
 export * from './CoinflowTypes';
 export * from './CoinflowUtils';
 export * from './CoinflowLibMessageHandlers';
+export * from './EventBus';
 export * from './card-form/TokenEx';
 export * from './card-form/tokenexHelpers';
 export * from './types/Subtotal';

package/lib/common/types/Subtotal.d.ts

@@ -5,6 +5,7 @@ export declare enum Currency {
     ALL = "ALL",
     ANG = "ANG",
     AOA = "AOA",
+    ARS = "ARS",
     AUD = "AUD",
     AWG = "AWG",
     AZN = "AZN",
@@ -14,18 +15,23 @@ export declare enum Currency {
     BGN = "BGN",
     BHD = "BHD",
     BIF = "BIF",
+    BMD = "BMD",
     BND = "BND",
     BOB = "BOB",
     BRL = "BRL",
+    BSD = "BSD",
     BTN = "BTN",
     BWP = "BWP",
+    BYN = "BYN",
     BZD = "BZD",
     CAD = "CAD",
     CHF = "CHF",
+    CLF = "CLF",
     CLP = "CLP",
     CNY = "CNY",
     COP = "COP",
     CRC = "CRC",
+    CUP = "CUP",
     CVE = "CVE",
     CZK = "CZK",
     DJF = "DJF",
@@ -35,6 +41,7 @@ export declare enum Currency {
     EGP = "EGP",
     ETB = "ETB",
     EUR = "EUR",
+    FJD = "FJD",
     GBP = "GBP",
     GEL = "GEL",
     GHS = "GHS",
@@ -47,6 +54,7 @@ export declare enum Currency {
     HTG = "HTG",
     HUF = "HUF",
     IDR = "IDR",
+    ILS = "ILS",
     INR = "INR",
     IQD = "IQD",
     IRR = "IRR",
@@ -62,6 +70,8 @@ export declare enum Currency {
     KWD = "KWD",
     KYD = "KYD",
     KZT = "KZT",
+    LAK = "LAK",
+    LBP = "LBP",
     LKR = "LKR",
     LRD = "LRD",
     LSL = "LSL",
@@ -75,9 +85,11 @@ export declare enum Currency {
     MOP = "MOP",
     MRU = "MRU",
     MUR = "MUR",
+    MWK = "MWK",
     MVR = "MVR",
     MXN = "MXN",
     MYR = "MYR",
+    MZN = "MZN",
     NAD = "NAD",
     NGN = "NGN",
     NIO = "NIO",
@@ -87,6 +99,7 @@ export declare enum Currency {
     OMR = "OMR",
     PAB = "PAB",
     PEN = "PEN",
+    PGK = "PGK",
     PHP = "PHP",
     PKR = "PKR",
     PLN = "PLN",
@@ -103,6 +116,7 @@ export declare enum Currency {
     SLE = "SLE",
     SLL = "SLL",
     SOS = "SOS",
+    SRD = "SRD",
     STN = "STN",
     SVC = "SVC",
     SYP = "SYP",
@@ -111,6 +125,7 @@ export declare enum Currency {
     TJS = "TJS",
     TMT = "TMT",
     TND = "TND",
+    TOP = "TOP",
     TRY = "TRY",
     TTD = "TTD",
     TWD = "TWD",
@@ -120,13 +135,15 @@ export declare enum Currency {
     UYU = "UYU",
     UZS = "UZS",
     VND = "VND",
+    VUV = "VUV",
     XAF = "XAF",
     XCD = "XCD",
     XOF = "XOF",
     XPF = "XPF",
     YER = "YER",
     ZAR = "ZAR",
-    ZMW = "ZMW"
+    ZMW = "ZMW",
+    ZWL = "ZWL"
 }
 export declare const CurrencyToISO4217: Record<Currency, string>;
 export type WithdrawCurrency = Currency.USD | Currency.EUR | Currency.GBP | Currency.BRL | Currency.CAD;

package/lib/mobile-wallet/coinflow-mobile-wallet-button.component.d.ts

@@ -1,7 +1,8 @@
 import { CoinflowIFrameProps, CoinflowPurchaseProps, IFrameMessageHandlers } from '../common';
+import { WithOnLoad } from '../../public-api';
 import * as i0 from "@angular/core";
 export declare class CoinflowMobileWalletButtonComponent {
-    purchaseProps: CoinflowPurchaseProps & {
+    purchaseProps: CoinflowPurchaseProps & WithOnLoad & {
         color: 'white' | 'black';
         onError?: (message: string) => void;
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@coinflowlabs/angular",
-  "version": "1.1.4",
+  "version": "1.1.5",
   "peerDependencies": {
     "@angular/common": "^17.3.0",
     "@angular/core": "^17.3.0",

package/public-api.d.ts

@@ -10,3 +10,7 @@ export * from './lib/card-form/coinflow-cvv-input.component';
 export * from './lib/card-form/coinflow-cvv-only-input.component';
 export * from './lib/mobile-wallet/coinflow-apple-pay-button.component';
 export * from './lib/mobile-wallet/coinflow-google-pay-button.component';
+export * from './lib/common';
+export type WithOnLoad = {
+    onLoad?: () => void | Promise<void>;
+};