@pay-com/js 1.2.0 → 1.2.2

package/lib/dts/types/index.d.ts

@@ -227,6 +227,28 @@ export interface ApmStyle {
   input?: PayCssConfig
 }
 
+type JssObject = {
+  [K in keyof PayCssConfig]?: PayCssConfig[K]
+} & {
+  [selector: `& ${string}`]: JssObject | string | number | undefined
+}
+
+type CheckboxStyleOverrides = {
+  ':selected'?: CSS.Properties
+} & CSS.Properties
+
+export type DynamicFieldStyles = {
+  label?: CSS.Properties
+  input?: CSS.Properties
+  date?: CSS.Properties
+  select?: JssObject
+  radio?: {
+    color?: CSS.Properties['color']
+    label?: CSS.Properties
+  }
+  checkbox?: CheckboxStyleOverrides
+}
+
 export interface UniversalOpts {
   container: string
   cardForm?: Omit<RenderOpts, 'container' | 'style'>
@@ -270,6 +292,7 @@ export interface UniversalOpts {
       }
     }
     ctp?: CTPStyles
+    paymentMethodFields?: DynamicFieldStyles
   }
   paymentMethods?: Array<string>
   alternatives?: 'button' | 'radio'
@@ -497,10 +520,15 @@ export type AddressType = {
   postalCode: string
 }
 
+export type HeadlessPaymentOptions = {
+  saveSourceForFutureUse?: boolean
+}
+
 export type HeadlessFn = (
   method: string,
   paymentMethodData?: unknown,
-  billingDetails?: AddressType
+  billingDetails?: AddressType,
+  options?: HeadlessPaymentOptions
 ) => Promise<unknown>
 
 export type CanMakePaymentsFn = () => Promise<unknown>
@@ -556,6 +584,70 @@ export type HeadlessCtpObject = {
   STATUS_DECLINED: CtpCompletePaymentStatus.declined
 }
 
+export type CustomFieldType = 'input' | 'date' | 'checkbox' | 'radio' | 'select'
+
+export type CustomFieldsOptions = {
+  label: string
+  value: string
+}
+
+export type CustomField = {
+  id: string
+  placeholder?: string
+  label?: string
+  type?: CustomFieldType
+  inputType?: string
+  options?: CustomFieldsOptions[]
+  description?: string
+  validation?: CustomFieldsValidation
+}
+
+export type CustomFieldsValidation = {
+  required?: boolean
+  max?: number
+  min?: number
+  maxLength?: number
+  minLength?: number
+  pattern?: string
+}
+
+export type CardBrand =
+  | 'visa'
+  | 'mastercard'
+  | 'amex'
+  | 'discover'
+  | 'jcl'
+  | 'unionpay'
+
+export type PaymentMethod = {
+  paymentMethodType: string
+  name: string
+  redirect?: boolean
+  fields?: CustomField[]
+  supportedCardBrands?: CardBrand[]
+}
+
+export type ExistingCard = {
+  bin: string
+  brand: CardBrand
+  cardholderCurrency: string
+  country: string
+  issuerName: string
+  expMonth: string
+  expYear: string
+  last4: string
+  fingerprint: string
+  funding: 'prepaid' | 'debit' | 'credit' | 'charge'
+  network: CardBrand
+  payout: string
+}
+
+export type ExistingSource = {
+  id: string
+  type: string
+  card?: ExistingCard
+}
+
 export type CheckoutObject = {
   on: ListenerFn
   once: ListenerFn
@@ -576,6 +668,8 @@ export type CheckoutObject = {
   pay: PayFn
   headless: HeadlessFn
   ctp: (params: InitHeadlessCtpParams) => Promise<HeadlessCtpObject>
+  getPaymentMethods: () => Promise<PaymentMethod[]>
+  getExistingSources: () => Promise<ExistingSource[]>
 }
 
 export type CheckoutFunction = (opts: CheckoutOpts) => CheckoutObject

package/lib/index.d.ts

@@ -232,6 +232,28 @@ interface ApmStyle {
   input?: PayCssConfig
 }
 
+type JssObject = {
+  [K in keyof PayCssConfig]?: PayCssConfig[K]
+} & {
+  [selector: `& ${string}`]: JssObject | string | number | undefined
+}
+
+type CheckboxStyleOverrides = {
+  ':selected'?: CSS.Properties
+} & CSS.Properties
+
+type DynamicFieldStyles = {
+  label?: CSS.Properties
+  input?: CSS.Properties
+  date?: CSS.Properties
+  select?: JssObject
+  radio?: {
+    color?: CSS.Properties['color']
+    label?: CSS.Properties
+  }
+  checkbox?: CheckboxStyleOverrides
+}
+
 interface UniversalOpts {
   container: string
   cardForm?: Omit<RenderOpts, 'container' | 'style'>
@@ -275,6 +297,7 @@ interface UniversalOpts {
       }
     }
     ctp?: CTPStyles
+    paymentMethodFields?: DynamicFieldStyles
   }
   paymentMethods?: Array<string>
   alternatives?: 'button' | 'radio'
@@ -496,10 +519,15 @@ type AddressType = {
   postalCode: string
 }
 
+type HeadlessPaymentOptions = {
+  saveSourceForFutureUse?: boolean
+}
+
 type HeadlessFn = (
   method: string,
   paymentMethodData?: unknown,
-  billingDetails?: AddressType
+  billingDetails?: AddressType,
+  options?: HeadlessPaymentOptions
 ) => Promise<unknown>
 
 type CanMakePaymentsFn = () => Promise<unknown>
@@ -555,6 +583,70 @@ type HeadlessCtpObject = {
   STATUS_DECLINED: CtpCompletePaymentStatus.declined
 }
 
+type CustomFieldType = 'input' | 'date' | 'checkbox' | 'radio' | 'select'
+
+type CustomFieldsOptions = {
+  label: string
+  value: string
+}
+
+type CustomField = {
+  id: string
+  placeholder?: string
+  label?: string
+  type?: CustomFieldType
+  inputType?: string
+  options?: CustomFieldsOptions[]
+  description?: string
+  validation?: CustomFieldsValidation
+}
+
+type CustomFieldsValidation = {
+  required?: boolean
+  max?: number
+  min?: number
+  maxLength?: number
+  minLength?: number
+  pattern?: string
+}
+
+type CardBrand =
+  | 'visa'
+  | 'mastercard'
+  | 'amex'
+  | 'discover'
+  | 'jcl'
+  | 'unionpay'
+
+type PaymentMethod = {
+  paymentMethodType: string
+  name: string
+  redirect?: boolean
+  fields?: CustomField[]
+  supportedCardBrands?: CardBrand[]
+}
+
+type ExistingCard = {
+  bin: string
+  brand: CardBrand
+  cardholderCurrency: string
+  country: string
+  issuerName: string
+  expMonth: string
+  expYear: string
+  last4: string
+  fingerprint: string
+  funding: 'prepaid' | 'debit' | 'credit' | 'charge'
+  network: CardBrand
+  payout: string
+}
+
+type ExistingSource = {
+  id: string
+  type: string
+  card?: ExistingCard
+}
+
 type CheckoutObject = {
   on: ListenerFn
   once: ListenerFn
@@ -575,6 +667,8 @@ type CheckoutObject = {
   pay: PayFn
   headless: HeadlessFn
   ctp: (params: InitHeadlessCtpParams) => Promise<HeadlessCtpObject>
+  getPaymentMethods: () => Promise<PaymentMethod[]>
+  getExistingSources: () => Promise<ExistingSource[]>
 }
 
 type CheckoutFunction = (opts: CheckoutOpts) => CheckoutObject

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pay-com/js",
-  "version": "1.2.0",
+  "version": "1.2.2",
   "description": "Pay.com JS loading utility",
   "keywords": [
     "Pay.com",