@paydock/client-sdk 1.104.3-beta → 1.105.1

package/lib/widget/configuration.js

@@ -0,0 +1,260 @@
+import { AccessToken } from './../helper/access-token';
+import { API_URL, Env } from '../configs/env/env';
+import { SDK } from '../configs/sdk';
+import { ObjectHelper } from '../helper/object';
+import { FORM_FIELD, SUPPORTED_CHECKOUT_META_COLLECTION, } from "../components/param";
+/**
+ * List of available payment source types
+ *
+ * @type {object}
+ * @param {string} CARD=card
+ * @param {string} BANK_ACCOUNT=bank_account
+ * @param {string} CHECKOUT=checkout
+ */
+export const PAYMENT_TYPE = {
+    CARD: 'card',
+    GIFT_CARD: 'gift_card',
+    BANK_ACCOUNT: 'bank_account',
+    CHECKOUT: 'checkout',
+};
+/**
+ * Purposes
+ * @type {object}
+ * @param {string} PAYMENT_SOURCE=payment_source
+ * @param {string} CARD_PAYMENT_SOURCE_WITH_CVV=card_payment_source_with_cvv
+ * @param {string} CARD_PAYMENT_SOURCE_WITHOUT_CVV=card_payment_source_without_cvv
+ * */
+export const PURPOSE = {
+    PAYMENT_SOURCE: 'payment_source',
+    CARD_PAYMENT_SOURCE_WITH_CVV: 'card_payment_source_with_cvv',
+    CARD_PAYMENT_SOURCE_WITHOUT_CVV: 'card_payment_source_without_cvv',
+};
+const CONFIGURATION_LINK = '/v1/remote-action/configs';
+/**
+ * Class Configuration include methods for creating configuration token
+ * @constructor
+ *
+ * @example
+ * var config = new Configuration('gatewayId'); // short
+ *
+ * var config = new Configuration('gatewayId', 'bank_account', 'paymentSource'); // extend
+ *
+ * var config = new Configuration('not_configured'); // without gateway
+ *
+ * @param {string} [gatewayID=default] - gateway ID. By default or if put 'default', it will use the selected default gateway. If put 'not_configured', it won’t use gateway to create downstream token.
+ * @param {string} paymentType - Type of payment source which shows in widget form. Available parameters [PAYMENT_TYPE]{@link PAYMENT_TYPE}
+ * @param {string} purpose - Param which describes payment purpose. By default uses Available parameters [PURPOSE]{@link PURPOSE}
+ */
+class Configuration {
+    /** @constructs */ // constructs added for correct parse classes jsdoc2md
+    constructor(gatewayID = 'default', paymentType = PAYMENT_TYPE.CARD, purpose = PURPOSE.PAYMENT_SOURCE) {
+        if (ObjectHelper.values(PAYMENT_TYPE).indexOf(paymentType) === -1)
+            throw new Error('unsupported payment type');
+        else if (paymentType === PAYMENT_TYPE.CHECKOUT)
+            throw new Error('Payment type "checkout" is deprecated. Use CheckoutButton for this type of payments https://www.npmjs.com/package/@paydock/client-sdk#checkout-button');
+        if (ObjectHelper.values(PURPOSE).indexOf(purpose) === -1)
+            throw new Error('unsupported purpose');
+        this.env = new Env(API_URL);
+        this.configs = {
+            purpose: purpose,
+            meta: {},
+            dynamic_fields_position: true,
+            predefined_fields: {
+                gateway_id: gatewayID,
+                type: paymentType,
+                card_scheme: null,
+                card_processing_network: null,
+            },
+        };
+    }
+    static createEachToken(accessToken, configs, cb, errorCb = (errors) => { }) {
+        let tokens = new Array(configs.length);
+        let errors = [];
+        let counter = 0;
+        for (let index in configs) {
+            if (configs.hasOwnProperty(index))
+                configs[index].createToken(accessToken, (token) => {
+                    tokens[index] = token;
+                    counter++;
+                    if (configs.length === counter)
+                        Configuration.finishCreatingEachToken(tokens, errors, cb, errorCb);
+                }, (err) => {
+                    errors.push(`gateway: ${configs[index].getConfigs().predefined_fields.gateway_id} | ${err}`);
+                    counter++;
+                    if (configs.length === counter)
+                        Configuration.finishCreatingEachToken(tokens, errors, cb, errorCb);
+                });
+        }
+    }
+    static finishCreatingEachToken(tokens, errors, cb, errorCb) {
+        if (errors.length >= 1)
+            errorCb(errors);
+        else
+            cb(tokens);
+    }
+    /**
+     * Destination, where customer will receive all successful responses.
+     * Response will contain “data” object with “payment_source” or other parameters, in depending on 'purpose'
+     *
+     * @example
+     * config.setWebHookDestination('http://google.com');
+     *
+     * @param {string} url - Your endpoint for post request.
+     */
+    setWebHookDestination(url) {
+        this.configs.webhook_destination = url;
+    }
+    /**
+     * URL to which the Customer will be redirected to after the success finish
+     *
+     * @example
+     * config.setSuccessRedirectUrl('google.com/search?q=success');
+     *
+     * @param {string}  url
+     */
+    setSuccessRedirectUrl(url) {
+        this.configs.success_redirect_url = url;
+    }
+    /**
+     * URL to which the Customer will be redirected to if an error is triggered in the process of operation
+     *
+     * @example
+     * config.setErrorRedirectUrl('google.com/search?q=error');
+     *
+     * @param {string} url
+     */
+    setErrorRedirectUrl(url) {
+        this.configs.error_redirect_url = url;
+    }
+    /**
+     *  Set list with widget form field, which will be shown in form. Also you can set the required validation for these fields
+     *
+     * @example
+     * config.setFormFields(['phone', 'email', 'first_name*']);
+     *
+     * @param {string[]} fields - name of fields which can be shown in a widget.
+     *   If after a name of a field, you put “*”, this field will be required on client-side.
+     *   (For validation, you can specify any fields, even those that are shown by default: card_number, expiration, etc... ) [FORM_FIELD]{@link FORM_FIELD}
+     */
+    setFormFields(fields) {
+        if (!Array.isArray(this.configs.defined_form_fields))
+            this.configs.defined_form_fields = [];
+        for (let index in fields) {
+            if (!fields.hasOwnProperty(index))
+                continue;
+            if (ObjectHelper.values(FORM_FIELD).indexOf(fields[index].replace('*', '')) !== -1)
+                this.configs.defined_form_fields.push(fields[index]);
+            else
+                console.warn(`Configuration::setFormFields: unsupported form field ${fields[index]}`);
+        }
+    }
+    /**
+     * Method for setting meta information for checkout page
+     *
+     * @example
+     * config.setMeta({
+            brand_name: 'paydock',
+            reference: '15',
+            email: 'wault@paydock.com'
+        });
+     *
+     * @param {IPayPalMeta | IZipmoneyMeta | IAfterpayMeta | IBamboraMeta} object -
+     *    data which can be shown on checkout page [IPayPalMeta]{@link IPayPalMeta} [IZipmoneyMeta]{@link IZipmoneyMeta} [IAfterpayMeta]{@link IAfterpayMeta} [IBamboraMeta]{@link IBamboraMeta}
+     */
+    setMeta(meta) {
+        for (let key in meta) {
+            if (!meta.hasOwnProperty(key))
+                continue;
+            if (SUPPORTED_CHECKOUT_META_COLLECTION.indexOf(key) !== -1)
+                this.configs.meta[key] = meta[key];
+            else
+                console.warn(`Configuration::setMeta: unsupported meta key ${key}`);
+        }
+    }
+    /**
+     * Current method can change environment. By default environment = sandbox.
+     * Also we can change domain alias for this environment. By default domain_alias = paydock.com
+     *
+     * @example
+     * config.setEnv('production');
+     * @param {string} env - sandbox, production
+     * @param {string} [alias] - Own domain alias
+     */
+    setEnv(env, alias) {
+        this.env.setEnv(env, alias);
+    }
+    /**
+     * Title for tab which can be set instead of default
+     *
+     * @example
+     * config.setLabel('custom label');
+     *
+     * @param {string} label - Text label for tab
+     */
+    setLabel(label) {
+        this.configs.label = label;
+    }
+    getEnv() {
+        return this.env.getEnv();
+    }
+    /**
+     * createToken - method which exactly create payment one time token
+     *
+     * @example
+     * config.createToken('582035346f65cdd57ee81192d6e5w65w4e5',
+     *  function (data) {
+     *      console.log(data);
+     *  }, function (error) {
+     *      console.log(error);
+     * });
+     *
+     * @param {string} accessToken - Customer access token or public key which provided for each client
+     * @param {createToken~requestCallback} cb - The callback that handles the success response.
+     * @param {createToken~requestCallback} errorCb - The callback that handles the failed response.
+     */
+    createToken(accessToken, cb, errorCb = (err) => { }) {
+        this.send(accessToken, (data, status) => {
+            if (status >= 200 && status < 300)
+                return cb(data.resource.data.configuration_token);
+            if (typeof data.error === "undefined" || typeof data.error.message === "undefined")
+                errorCb('unknown error');
+            else
+                errorCb(data.error.message);
+        });
+    }
+    send(accessToken, cb) {
+        let request = new XMLHttpRequest();
+        request.open('POST', this.getUrl(), true);
+        request.setRequestHeader('Content-Type', 'application/json; charset=UTF-8');
+        request.setRequestHeader(AccessToken.getAccessHeaderNameByToken(accessToken), accessToken);
+        if (SDK.version) {
+            request.setRequestHeader(SDK.headerKeys.version, SDK.version);
+            request.setRequestHeader(SDK.headerKeys.type, SDK.type);
+        }
+        request.send(JSON.stringify(this.getConfigs()));
+        request.onload = () => {
+            let res = {};
+            try {
+                res = JSON.parse(request.responseText);
+            }
+            catch (e) { }
+            cb(res, request.status);
+        };
+    }
+    getConfigs() {
+        return this.configs;
+    }
+    getUrl() {
+        return this.env.getConf().url + CONFIGURATION_LINK;
+    }
+    setGiftCardSchemeData(giftCardScheme, processingNetwork) {
+        if (this.configs.predefined_fields.type !== PAYMENT_TYPE.GIFT_CARD)
+            throw new Error('unsupported payment type');
+        if (!giftCardScheme || !processingNetwork)
+            throw new Error('');
+        this.configs.predefined_fields.card_scheme = giftCardScheme;
+        this.configs.predefined_fields.card_processing_network = processingNetwork;
+    }
+}
+export { Configuration };
+//# sourceMappingURL=../../src/lib/widget/configuration.js.map

package/lib/widget/configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.js","sourceRoot":"","sources":["../../widget/configuration.ts"],"names":[],"mappings":"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"}

package/lib/widget/html-multi-widget.d.ts

@@ -0,0 +1,336 @@
+import { MultiWidget } from "./multi-widget";
+import { Container } from "../components/container";
+import { IFrame } from "../components/iframe";
+import { IFrameEvent, IEventData } from "../components/iframe-event";
+import { Trigger, ITriggerData } from "../components/trigger";
+import { IFormValidation, IFormValues, ValidatorFieldsMapKey } from '../components/param';
+export interface IEventMetaData extends IEventData {
+    configuration_token: string;
+    type: string;
+    account_name?: string;
+    account_number?: string;
+    card_number_last4?: string;
+    card_number_length?: number;
+    card_scheme?: string;
+    gateway_type?: string;
+}
+export interface IEventAfterLoadData extends IEventData {
+}
+export interface IEventFinishData extends IEventData {
+    payment_source: string;
+}
+/**
+ * Interface of data from validation event.
+ *
+ * @interface IFormValidation
+ *
+ * @param {string} event The name of the event.
+ * @param {string} message_source A system variable that identifies the event source.
+ * @param {string} purpose A system variable that states the purpose of the event.
+ * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
+ * @param {boolean} [form_valid] Indicates wether or not the form is valid.
+ * @param {Array<string>} [invalid_fields] Names of form fields with invalid data.
+ * @param {Array<string>} [invalid_showed_fields] Names of invalid form fields which are already displaying the error.
+ * @param {Partial<Record<CardValidatorValue | GenericValidatorValue, Array<string>>>} [validators] Object containing validator identifiers as keys and the fields subject to that validator as an array of form field names.
+ *  See list of available [Generic Vallidators]{@link GENERIC_VALIDATORS} and [Card Validators]{@link CARD_VALIDATORS},
+ */
+/**
+ * Contains basic information associated with the event and additional meta data
+ * specific to the event. E.g., card info, gateway info, etc.
+ *
+ * @interface IEventMetaData
+ *
+ * @param {string} event The name of the event.
+ * @param {string} purpose A system variable that states the purpose of the event.
+ * @param {string} message_source A system variable that identifies the event source.
+ * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
+ * @param {string} configuration_token Token received from our API with widget data
+ * @param {string} type Payment type 'card', 'bank_account'
+ * @param {string} gateway_type Gateway type
+ * @param {string} [card_number_last4] Last 4 digit of your card
+ * @param {string} [card_scheme] Card scheme, e.g., (Visa, Mastercard and American Express (AmEx))
+ * @param {number} [card_number_length] Card number length
+ * @param {string} [account_name] Bank account account name
+ * @param {string} [account_number] Bank account account number
+ * */
+/**
+ * Interface of data from event.
+ * @interface IEventAfterLoadData
+ *
+ * @param {string} event The name of the event.
+ * @param {string} purpose A system variable that states the purpose of the event.
+ * @param {string} message_source A system variable that identifies the event source.
+ * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
+ * */
+/**
+ * Interface of data from event.
+ * @interface IEventFinishData
+ *
+ * @param {string} event The name of the event.
+ * @param {string} purpose A system variable that states the purpose of the event.
+ * @param {string} message_source A system variable that identifies the event source.
+ * @param {string} [ref_id] Custom unique value that identifies result of processed operation.
+ * @param {string} payment_source One time token. Result from this endpoint [API docs](https://docs.paydock.com/#tokens)
+ * */
+/**
+ * List of available event's name
+ * @const EVENT
+ *
+ * @type {object}
+ * @param {string} AFTER_LOAD=afterLoad
+ * @param {string} SUBMIT=submit
+ * @param {string} FINISH=finish
+ * @param {string} VALIDATION=validation
+ * @param {string} VALIDATION_ERROR=validationError
+ * @param {string} SYSTEM_ERROR=systemError
+ * @param {string} META_CHANGE=metaChange
+ * @param {string} RESIZE=resize
+ */
+/**
+ * List of available event's name
+ * @const VAULT_DISPLAY_EVENT
+ *
+ * @type {object}
+ * @param {string} AFTER_LOAD=afterLoad
+ * @param {string} SYSTEM_ERROR=system_error
+ * @param {string} CVV_SECURE_CODE_REQUESTED=cvv_secure_code_requested
+ * @param {string} CARD_NUMBER_SECURE_CODE_REQUESTED=card_number_secure_code_requested
+ * @param {string} ACCESS_FORBIDDEN=access_forbidden
+ * @param {string} SESSION_EXPIRED=systemError
+ * @param {string} SYSTEM_ERROR=session_expired
+ * @param {string} OPERATION_FORBIDDEN=operation_forbidden
+ */
+/**
+ * Class HtmlMultiWidget include method for working with html
+ * @constructor
+ * @extends MultiWidget
+ *
+ * @param {string} selector - Selector of html element. Container for widget
+ * @param {string} publicKey - PayDock users public key
+ * @param {(Configuration | string | Configuration[] | string[])} conf - exemplar[s] Configuration class OR configuration token
+ * @example
+ * var widget = new MultiWidget('#widget', 'publicKey','configurationToken'); // With a pre-created configuration token
+ *
+ * var widget = new MultiWidget('#widget', 'publicKey',['configurationToken', 'configurationToken2']); // With pre-created configuration tokens
+ *
+ * var widget = new MultiWidget('#widget', 'publicKey', new Configuration('gatewayId')); With Configuration
+ *
+ * var widget = new MultiWidget('#widget', 'publicKey',[ With Configurations
+ *      Configuration(), // default gateway_id,
+ *      Configuration('not_configured'), // without gateway,
+ *      Configuration('gatewayId'),
+ *      Configuration('gatewayId', 'bank_account')
+ * ]);
+ */
+declare class HtmlMultiWidget extends MultiWidget {
+    protected container: Container;
+    protected iFrame: IFrame;
+    protected triggerElement: Trigger;
+    protected event: IFrameEvent;
+    protected validationData: IFormValidation;
+    /** @constructs */ constructor(selector: string, publicKey: string, conf: any);
+    /**
+     * Loads the widget.
+     *
+     * Calling this method results in an iframe element being inserted and rendered in the DOM.
+     */
+    load(): void;
+    /**
+     * Registers a form validation callback for validation events.
+     */
+    protected afterLoad(): void;
+    /**
+     * Listen to events of widget
+     *
+     * @example
+     *
+     * ```javascript
+     * widget.on('form_submit', function (data) {
+     *      console.log(data);
+     * });
+     * ```
+     *
+     * @example
+     *
+     * ```javascript
+     * widget.on('form_submit').then(function (data) {
+     *      console.log(data);
+     * });
+     * ```
+     *
+     * @typedef {(data: IEventData | IEventMetaData | IEventFinishData | IFormValidation) => void} EventListenerCallback
+     *
+     * @param {string} eventName - The name of the event that should be listened. Available event names [EVENT]{@link EVENT}.
+     * @param {EventListenerCallback} [cb] - A function to be invoked whenever the event occurs.
+     *
+     * @return {Promise<IEventData | IEventMetaData | IEventFinishData | IFormValidation> | void}
+     */
+    on(eventName: string): Promise<IEventData | IEventMetaData | IEventFinishData | IFormValidation>;
+    on(eventName: string, cb: (data: IEventData | IEventMetaData | IEventFinishData | IFormValidation) => void): any;
+    /**
+     * Registers callback that will be invoked for every trigger.
+     *
+     * @param {'submit_form' | 'tab'} triggers - The Widget element identifier that caused the trigger.
+     * @param {ITriggerData} data - Data that will be sent to the widget when the trigger occurs.
+     */
+    trigger(triggerName: string, data?: ITriggerData): void;
+    /**
+     * Gets a reference to the form current validation state.
+     *
+     * !Warning: do not directly modify the values of the returned object.
+     *
+     * @return {IFormValidation} Form validation object
+     */
+    getValidationState(): IFormValidation;
+    /**
+     * Checks if a given form is valid.
+     *
+     * A form is valid if all form fields are valid.
+     *
+     * @return {boolean} Indicates wether or not form is valid.
+     */
+    isValidForm(): boolean;
+    /**
+     * Using this method you can check if a specific form field is invalid
+     *
+     * @param {string} field - Field name
+     * @return {boolean} Field is invalid
+     */
+    isInvalidField(field?: string): boolean;
+    /**
+     * Checks if a given form field is displaying an error.
+     *
+     * @param {string} field - The form field name
+     *
+     * @return {boolean} Indicates wether or not the Error message is being displayed on the associated field.
+     */
+    isFieldErrorShowed(field?: string): boolean;
+    /**
+     * Checks if a given form field is valid or invalid by name.
+     *
+     * @param {string} field - The form field name
+     * @param validator - The name of the validator.
+     *
+     * @return {boolean} Indicates wether or not the field is invalid based on validator intepretation.
+     */
+    isInvalidFieldByValidator(field: string, validator: ValidatorFieldsMapKey): boolean;
+    /**
+     * Hides the widget.
+     *
+     * E.g., use this method to hide the widget after it loads.
+     *
+     * @param {boolean} [saveSize=false] Wether the original iframe element size should be saved before being hidden.
+     */
+    hide(saveSize: boolean): void;
+    /**
+     * Shows the widget.
+     *
+     * E.g., use this method to show the widget after it was explicitly hidden.
+     */
+    show(): void;
+    /**
+     * Reloads the widget.
+     */
+    reload(): void;
+    /**
+     * Hides the specified Widget elements by their identifier.
+     *
+     * @example
+     *
+     * ```javascript
+     * widget.hideElements(['submit_button', 'email']);
+     * ```
+     *
+     * @param {string[]} elements - List of element which can be hidden [ELEMENT]{@link ELEMENT} || [FORM_FIELD]{@link FORM_FIELD}
+     */
+    hideElements(elements: string[]): void;
+    /**
+     * Shows the specified Widget elements by their identifier.
+     *
+     * @example
+     *
+     * ```javascript
+     * widget.showElements(['submit_button', 'email']);
+     * ```
+     *
+     * @param {string[]} elements - List of elements which can be showed [ELEMENT]{@link ELEMENT} || [FORM_FIELD]{@link FORM_FIELD}
+     */
+    showElements(elements: string[]): void;
+    /**
+     * Updates the form field values inside the widget.
+     *
+     * @example
+     *
+     * ```javascript
+     * widget.updateFormValues({
+     *   email: 'predefined@email.com',
+     *   card_name: 'Houston'
+     * });
+     *```
+     *
+     * @param {IFormValues} fieldValues - Fields with values
+     */
+    updateFormValues(fieldValues: IFormValues): void;
+    /**
+     * Updates a single form field values inside the widget by the form field name.
+     *
+     * @example
+     *
+     * ```javascript
+     * widget.updateFormValue("card_name", "John Doe");
+     *```
+     *
+     * @param {string} key - The form field name
+     * @param {string} value - The form field value
+     */
+    updateFormValue(key: string, value: string): void;
+    /**
+     * Inserts the event data (after finish event) onto the input field associated with the provided CSS selector.
+     *
+     * @param {string} selector - A CSS selector. E.g., ".my-class", "#my-id", or others
+     * @param {string} dataType - The data type of IEventData object.
+     */
+    onFinishInsert(selector: string, dataType: string): void;
+    /**
+     * Intercepts a form submission and delegates processing to the widget.
+     *
+     * An simplified example of the process:
+     * - User clicks submit button in your form
+     * - This implicitly triggers a submission to the widget
+     * - The widget submits your form
+     *
+     * @note The widget's submit button will be hidden.
+     *
+     * @param {string} selector - css selector of your form
+     *
+     * @example
+     *
+     * ```html
+     * <body>
+     *  <form id="myForm">
+     *      <input name="amount">
+     *      <button type="submit">Submit</button>
+     *  </form>
+     *  <script>
+     *     widget.interceptSubmitForm('#myForm');
+     *  </script>
+     * </body>
+     * ```
+     */
+    interceptSubmitForm(selector: string): void;
+    /**
+     * This method hides a submit button and automatically execute form submit
+     */
+    useCheckoutAutoSubmit(): void;
+    /**
+     * Use this method for resize iFrame according content height
+     *
+     * @example
+     *
+     * ```javascript
+     * widget.useAutoResize();
+     *```
+     */
+    useAutoResize(): void;
+}
+export { HtmlMultiWidget };