flintn-checkout 0.0.7 → 0.0.9

package/dist/index.d.ts

@@ -7,11 +7,13 @@ declare const EventType: {
     readonly PAYMENT_ERROR: "PAYMENT_ERROR";
     readonly PAYMENT_CANCELLED: "PAYMENT_CANCELLED";
     readonly REDIRECT: "REDIRECT";
+    readonly RESIZE: "RESIZE";
 };
 type TEventType = (typeof EventType)[keyof typeof EventType];
 declare const CheckoutFormVariant: {
     readonly DEFAULT: "DEFAULT";
     readonly LIST: "LIST";
+    readonly RADIO: "RADIO";
 };
 type TCheckoutFormVariant = (typeof CheckoutFormVariant)[keyof typeof CheckoutFormVariant];
 interface FormFields {
@@ -65,24 +67,109 @@ interface FlintNPaymentOptions {
     onError?: (error: PaymentError) => void;
     debug?: boolean;
 }
+declare const FieldType: {
+    readonly CARD_NUMBER: "card-number";
+    readonly EXPIRY: "expiry";
+    readonly CVV: "cvv";
+};
+type TFieldType = (typeof FieldType)[keyof typeof FieldType];
+declare const FieldEventType: {
+    readonly FIELD_CONFIG: "FIELD_CONFIG";
+    readonly FIELD_VALIDATE: "FIELD_VALIDATE";
+    readonly FIELD_SUBMIT: "FIELD_SUBMIT";
+    readonly FIELD_FOCUS_REQUEST: "FIELD_FOCUS_REQUEST";
+    readonly FIELD_CLEAR: "FIELD_CLEAR";
+    readonly FIELD_READY: "FIELD_READY";
+    readonly FIELD_CHANGE: "FIELD_CHANGE";
+    readonly FIELD_FOCUS: "FIELD_FOCUS";
+    readonly FIELD_BLUR: "FIELD_BLUR";
+    readonly FIELD_VALIDATION: "FIELD_VALIDATION";
+    readonly FIELD_SUBMIT_RESULT: "FIELD_SUBMIT_RESULT";
+    readonly FIELD_HEIGHT: "FIELD_HEIGHT";
+};
+type TFieldEventType = (typeof FieldEventType)[keyof typeof FieldEventType];
+interface FieldOptions {
+    placeholder?: string;
+    disabled?: boolean;
+}
+interface FieldState {
+    isEmpty: boolean;
+    isValid: boolean;
+    isFocused: boolean;
+    error: string | null;
+}
+interface FieldChangeEvent {
+    fieldType: TFieldType;
+    isEmpty: boolean;
+    isValid: boolean;
+    isFocused: boolean;
+    error: string | null;
+    cardBrand?: string;
+}
+interface FieldValidationResult {
+    fieldType: TFieldType;
+    isValid: boolean;
+    error: string | null;
+}
+interface FieldsValidationResult {
+    isValid: boolean;
+    errors: Partial<Record<TFieldType, string | null>>;
+}
+interface SubmitOptions {
+    cardholderName?: string;
+}
+interface FlintNFieldsConfig {
+    clientSessionId: string;
+    styles?: FormStyles;
+}
+interface FlintNFieldsOptions {
+    origin?: string;
+    config: FlintNFieldsConfig;
+    onPayment?: (result: PaymentResult) => void;
+    onReady?: () => void;
+    onChange?: (event: FieldChangeEvent) => void;
+    onFocus?: (fieldType: TFieldType) => void;
+    onBlur?: (fieldType: TFieldType, state: FieldState) => void;
+    onError?: (error: PaymentError) => void;
+    debug?: boolean;
+}
 
-declare class FlintNPayment {
-    private options;
-    private origin;
-    private iframe;
-    private container;
-    private isReady;
-    private messageHandler;
-    constructor(options: FlintNPaymentOptions);
+interface FlintNPayment {
     mount(selector: string | HTMLElement): void;
     unmount(): void;
     getIsReady(): boolean;
-    private handleMessage;
-    private isValidRedirectUrl;
-    private handlePaymentResult;
-    private sendConfig;
-    private log;
 }
+declare function createFlintNPayment(options: FlintNPaymentOptions): FlintNPayment;
+
+interface FlintNFieldInternalCallbacks {
+    onReady: (fieldType: TFieldType) => void;
+    onChange: (event: FieldChangeEvent) => void;
+    onFocus: (fieldType: TFieldType) => void;
+    onBlur: (fieldType: TFieldType, state: FieldState) => void;
+    onHeight: (fieldType: TFieldType, height: number) => void;
+}
+interface FlintNField {
+    mount(selector: string | HTMLElement): void;
+    unmount(): void;
+    focus(): void;
+    clear(): void;
+    getState(): FieldState;
+    getFieldType(): TFieldType;
+    _sendMessage(type: string, payload: unknown): void;
+    _getIframe(): HTMLIFrameElement | null;
+    _handleMessage(type: string, payload: Record<string, unknown>): void;
+}
+declare function createFlintNField(fieldType: TFieldType, origin: string, clientSessionId: string, options: FieldOptions, callbacks: FlintNFieldInternalCallbacks, debug?: boolean, formStyles?: FormStyles): FlintNField;
+
+interface FlintNFields {
+    createField(fieldType: TFieldType, options?: FieldOptions): FlintNField;
+    getField(fieldType: TFieldType): FlintNField | undefined;
+    validate(): Promise<FieldsValidationResult>;
+    submit(options?: SubmitOptions, skipValidation?: boolean): Promise<PaymentResult>;
+    unmount(): void;
+    getIsReady(): boolean;
+}
+declare function createFlintNFields(options: FlintNFieldsOptions): FlintNFields;
 
 declare const parseOrigin: (origin: string) => string;
 declare const buildIframeSrc: (origin: string) => string;
@@ -92,4 +179,4 @@ declare const validateConfig: (config: {
 }) => void;
 declare const sanitizeToken: (token: string) => string;
 
-export { CheckoutFormVariant, EventType, type FlintNConfig, FlintNPayment, type FlintNPaymentOptions, type FormFields, type FormStyles, type PaymentError, type PaymentResult, type TCheckoutFormVariant, type TEventType, buildIframeSrc, createIframeElement, parseOrigin, sanitizeToken, validateConfig };
+export { CheckoutFormVariant, EventType, type FieldChangeEvent, FieldEventType, type FieldOptions, type FieldState, FieldType, type FieldValidationResult, type FieldsValidationResult, type FlintNConfig, type FlintNField, type FlintNFieldInternalCallbacks, type FlintNFields, type FlintNFieldsConfig, type FlintNFieldsOptions, type FlintNPayment, type FlintNPaymentOptions, type FormFields, type FormStyles, type PaymentError, type PaymentResult, type SubmitOptions, type TCheckoutFormVariant, type TEventType, type TFieldEventType, type TFieldType, buildIframeSrc, createFlintNField, createFlintNFields, createFlintNPayment, createIframeElement, parseOrigin, sanitizeToken, validateConfig };