stripe-pwa-elements 3.0.0 → 3.1.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.
Files changed (186) hide show
  1. package/dist/cjs/error-FFC4kSs5.js +18 -0
  2. package/dist/cjs/error-FFC4kSs5.js.map +1 -0
  3. package/dist/cjs/factory-Hsw0e7-d.js +3825 -0
  4. package/dist/cjs/factory-Hsw0e7-d.js.map +1 -0
  5. package/dist/cjs/{index-BmB5d_Yj.js → index-Ba1pBePA.js} +4 -4
  6. package/dist/cjs/{index-BmB5d_Yj.js.map → index-Ba1pBePA.js.map} +1 -1
  7. package/dist/cjs/{index-CQkz7IJv.js → index-C1haN5iF.js} +5 -2
  8. package/dist/cjs/index-C1haN5iF.js.map +1 -0
  9. package/dist/cjs/ion-icon.cjs.entry.js +1 -1
  10. package/dist/cjs/loader.cjs.js +2 -2
  11. package/dist/cjs/stripe-address-element.cjs.entry.js +288 -0
  12. package/dist/cjs/stripe-address-element.entry.cjs.js.map +1 -0
  13. package/dist/cjs/stripe-card-element-modal.cjs.entry.js +1 -1
  14. package/dist/cjs/stripe-card-element.stripe-modal.entry.cjs.js.map +1 -1
  15. package/dist/cjs/stripe-card-element_2.cjs.entry.js +48 -3278
  16. package/dist/cjs/stripe-currency-selector.cjs.entry.js +186 -0
  17. package/dist/cjs/stripe-currency-selector.entry.cjs.js.map +1 -0
  18. package/dist/cjs/stripe-elements.cjs.js +2 -2
  19. package/dist/cjs/stripe-express-checkout-element.cjs.entry.js +294 -0
  20. package/dist/cjs/stripe-express-checkout-element.entry.cjs.js.map +1 -0
  21. package/dist/cjs/stripe-link-authentication-element.cjs.entry.js +222 -0
  22. package/dist/cjs/stripe-link-authentication-element.entry.cjs.js.map +1 -0
  23. package/dist/cjs/stripe-payment-element.cjs.entry.js +469 -0
  24. package/dist/cjs/stripe-payment-element.entry.cjs.js.map +1 -0
  25. package/dist/cjs/stripe-payment-request-button.cjs.entry.js +2 -2
  26. package/dist/collection/collection-manifest.json +5 -0
  27. package/dist/collection/components/stripe-address-element/stripe-address-element.css +73 -0
  28. package/dist/collection/components/stripe-address-element/stripe-address-element.js +711 -0
  29. package/dist/collection/components/stripe-address-element/stripe-address-element.js.map +1 -0
  30. package/dist/collection/components/stripe-card-element/stripe-card-element.css +16 -8
  31. package/dist/collection/components/stripe-card-element/stripe-card-element.js +32 -8
  32. package/dist/collection/components/stripe-card-element/stripe-card-element.js.map +1 -1
  33. package/dist/collection/components/stripe-currency-selector/stripe-currency-selector.css +44 -0
  34. package/dist/collection/components/stripe-currency-selector/stripe-currency-selector.js +477 -0
  35. package/dist/collection/components/stripe-currency-selector/stripe-currency-selector.js.map +1 -0
  36. package/dist/collection/components/stripe-express-checkout-element/stripe-express-checkout-element.css +36 -0
  37. package/dist/collection/components/stripe-express-checkout-element/stripe-express-checkout-element.js +787 -0
  38. package/dist/collection/components/stripe-express-checkout-element/stripe-express-checkout-element.js.map +1 -0
  39. package/dist/collection/components/stripe-link-authentication-element/stripe-link-authentication-element.css +49 -0
  40. package/dist/collection/components/stripe-link-authentication-element/stripe-link-authentication-element.js +545 -0
  41. package/dist/collection/components/stripe-link-authentication-element/stripe-link-authentication-element.js.map +1 -0
  42. package/dist/collection/components/stripe-modal/stripe-modal.css +16 -14
  43. package/dist/collection/components/stripe-modal/stripe-modal.js +3 -2
  44. package/dist/collection/components/stripe-modal/stripe-modal.js.map +1 -1
  45. package/dist/collection/components/stripe-payment-element/stripe-payment-element.css +78 -0
  46. package/dist/collection/components/stripe-payment-element/stripe-payment-element.js +979 -0
  47. package/dist/collection/components/stripe-payment-element/stripe-payment-element.js.map +1 -0
  48. package/dist/collection/interfaces.js.map +1 -1
  49. package/dist/collection/services/address-element-manager.js +83 -0
  50. package/dist/collection/services/address-element-manager.js.map +1 -0
  51. package/dist/collection/services/card-element-manager.js +4 -34
  52. package/dist/collection/services/card-element-manager.js.map +1 -1
  53. package/dist/collection/services/currency-selector-element-manager.js +92 -0
  54. package/dist/collection/services/currency-selector-element-manager.js.map +1 -0
  55. package/dist/collection/services/express-checkout-element-manager.js +131 -0
  56. package/dist/collection/services/express-checkout-element-manager.js.map +1 -0
  57. package/dist/collection/services/factory.js +40 -0
  58. package/dist/collection/services/factory.js.map +1 -1
  59. package/dist/collection/services/interfaces.js.map +1 -1
  60. package/dist/collection/services/link-authentication-element-manager.js +93 -0
  61. package/dist/collection/services/link-authentication-element-manager.js.map +1 -0
  62. package/dist/collection/services/payment-element-manager.js +95 -0
  63. package/dist/collection/services/payment-element-manager.js.map +1 -0
  64. package/dist/collection/services/stripe-service.js +51 -2
  65. package/dist/collection/services/stripe-service.js.map +1 -1
  66. package/dist/collection/utils/element-finder.js +32 -0
  67. package/dist/collection/utils/element-finder.js.map +1 -0
  68. package/dist/collection/utils/error.js.map +1 -1
  69. package/dist/collection/utils/i18n.js +2 -2
  70. package/dist/collection/utils/i18n.js.map +1 -1
  71. package/dist/collection/utils/platform.js.map +1 -1
  72. package/dist/collection/utils/utils.js +1 -1
  73. package/dist/collection/utils/utils.js.map +1 -1
  74. package/dist/components/error.js +16 -0
  75. package/dist/components/error.js.map +1 -0
  76. package/dist/components/factory.js +3736 -0
  77. package/dist/components/factory.js.map +1 -0
  78. package/dist/{esm/index-C5QyifTT.js → components/index2.js} +4 -4
  79. package/dist/components/index2.js.map +1 -0
  80. package/dist/components/stripe-address-element.d.ts +11 -0
  81. package/dist/components/stripe-address-element.js +327 -0
  82. package/dist/components/stripe-address-element.js.map +1 -0
  83. package/dist/components/stripe-card-element2.js +37 -3183
  84. package/dist/components/stripe-card-element2.js.map +1 -1
  85. package/dist/components/stripe-currency-selector.d.ts +11 -0
  86. package/dist/components/stripe-currency-selector.js +218 -0
  87. package/dist/components/stripe-currency-selector.js.map +1 -0
  88. package/dist/components/stripe-express-checkout-element.d.ts +11 -0
  89. package/dist/components/stripe-express-checkout-element.js +332 -0
  90. package/dist/components/stripe-express-checkout-element.js.map +1 -0
  91. package/dist/components/stripe-link-authentication-element.d.ts +11 -0
  92. package/dist/components/stripe-link-authentication-element.js +256 -0
  93. package/dist/components/stripe-link-authentication-element.js.map +1 -0
  94. package/dist/components/stripe-modal2.js +4 -3
  95. package/dist/components/stripe-modal2.js.map +1 -1
  96. package/dist/components/stripe-payment-element.d.ts +11 -0
  97. package/dist/components/stripe-payment-element.js +510 -0
  98. package/dist/components/stripe-payment-element.js.map +1 -0
  99. package/dist/components/stripe-payment-request-button2.js +2 -189
  100. package/dist/components/stripe-payment-request-button2.js.map +1 -1
  101. package/dist/components/utils.js.map +1 -1
  102. package/dist/esm/error-XRfh5Wrs.js +16 -0
  103. package/dist/esm/error-XRfh5Wrs.js.map +1 -0
  104. package/dist/esm/factory-Li_TGt9P.js +3821 -0
  105. package/dist/esm/factory-Li_TGt9P.js.map +1 -0
  106. package/dist/esm/index-BHDCxQOb.js +192 -0
  107. package/dist/esm/{index-C5QyifTT.js.map → index-BHDCxQOb.js.map} +1 -1
  108. package/dist/esm/{index-DB2hiILr.js → index-Dkis4t79.js} +5 -2
  109. package/dist/esm/index-Dkis4t79.js.map +1 -0
  110. package/dist/esm/ion-icon.entry.js +1 -1
  111. package/dist/esm/loader.js +3 -3
  112. package/dist/esm/stripe-address-element.entry.js +286 -0
  113. package/dist/esm/stripe-address-element.entry.js.map +1 -0
  114. package/dist/esm/stripe-card-element-modal.entry.js +1 -1
  115. package/dist/esm/stripe-card-element.stripe-modal.entry.js.map +1 -1
  116. package/dist/esm/stripe-card-element_2.entry.js +41 -3271
  117. package/dist/esm/stripe-currency-selector.entry.js +184 -0
  118. package/dist/esm/stripe-currency-selector.entry.js.map +1 -0
  119. package/dist/esm/stripe-elements.js +3 -3
  120. package/dist/esm/stripe-express-checkout-element.entry.js +292 -0
  121. package/dist/esm/stripe-express-checkout-element.entry.js.map +1 -0
  122. package/dist/esm/stripe-link-authentication-element.entry.js +220 -0
  123. package/dist/esm/stripe-link-authentication-element.entry.js.map +1 -0
  124. package/dist/esm/stripe-payment-element.entry.js +467 -0
  125. package/dist/esm/stripe-payment-element.entry.js.map +1 -0
  126. package/dist/esm/stripe-payment-request-button.entry.js +2 -2
  127. package/dist/stripe-elements/{p-b598431f.entry.js → p-01d63033.entry.js} +2 -2
  128. package/dist/stripe-elements/p-1b8f9c7f.entry.js +2 -0
  129. package/dist/stripe-elements/p-1b8f9c7f.entry.js.map +1 -0
  130. package/dist/stripe-elements/{p-5beb3870.entry.js → p-37008853.entry.js} +2 -2
  131. package/dist/stripe-elements/p-5d152193.entry.js +2 -0
  132. package/dist/stripe-elements/p-5d152193.entry.js.map +1 -0
  133. package/dist/stripe-elements/p-623f13e6.entry.js +2 -0
  134. package/dist/stripe-elements/p-623f13e6.entry.js.map +1 -0
  135. package/dist/stripe-elements/p-809c9f2f.entry.js +2 -0
  136. package/dist/stripe-elements/p-809c9f2f.entry.js.map +1 -0
  137. package/dist/stripe-elements/{p-C5QyifTT.js → p-BHDCxQOb.js} +2 -2
  138. package/dist/stripe-elements/{p-C5QyifTT.js.map → p-BHDCxQOb.js.map} +1 -1
  139. package/dist/stripe-elements/p-Dkis4t79.js +3 -0
  140. package/dist/stripe-elements/p-Dkis4t79.js.map +1 -0
  141. package/dist/stripe-elements/p-WnA32N4v.js +2 -0
  142. package/dist/stripe-elements/p-WnA32N4v.js.map +1 -0
  143. package/dist/stripe-elements/p-XRfh5Wrs.js +2 -0
  144. package/dist/stripe-elements/p-XRfh5Wrs.js.map +1 -0
  145. package/dist/stripe-elements/p-ba41e196.entry.js +2 -0
  146. package/dist/stripe-elements/p-ba41e196.entry.js.map +1 -0
  147. package/dist/stripe-elements/{p-bb923a08.entry.js → p-bb1bc49a.entry.js} +2 -2
  148. package/dist/stripe-elements/p-f21ea941.entry.js +2 -0
  149. package/dist/stripe-elements/p-f21ea941.entry.js.map +1 -0
  150. package/dist/stripe-elements/stripe-address-element.entry.esm.js.map +1 -0
  151. package/dist/stripe-elements/stripe-card-element.stripe-modal.entry.esm.js.map +1 -1
  152. package/dist/stripe-elements/stripe-currency-selector.entry.esm.js.map +1 -0
  153. package/dist/stripe-elements/stripe-elements.esm.js +1 -1
  154. package/dist/stripe-elements/stripe-express-checkout-element.entry.esm.js.map +1 -0
  155. package/dist/stripe-elements/stripe-link-authentication-element.entry.esm.js.map +1 -0
  156. package/dist/stripe-elements/stripe-payment-element.entry.esm.js.map +1 -0
  157. package/dist/types/components/stripe-address-element/stripe-address-element.d.ts +195 -0
  158. package/dist/types/components/stripe-card-element/stripe-card-element.d.ts +3 -1
  159. package/dist/types/components/stripe-currency-selector/stripe-currency-selector.d.ts +127 -0
  160. package/dist/types/components/stripe-express-checkout-element/stripe-express-checkout-element.d.ts +232 -0
  161. package/dist/types/components/stripe-link-authentication-element/stripe-link-authentication-element.d.ts +143 -0
  162. package/dist/types/components/stripe-payment-element/stripe-payment-element.d.ts +295 -0
  163. package/dist/types/components.d.ts +836 -6
  164. package/dist/types/interfaces.d.ts +23 -1
  165. package/dist/types/services/address-element-manager.d.ts +44 -0
  166. package/dist/types/services/card-element-manager.d.ts +0 -8
  167. package/dist/types/services/currency-selector-element-manager.d.ts +45 -0
  168. package/dist/types/services/express-checkout-element-manager.d.ts +50 -0
  169. package/dist/types/services/factory.d.ts +26 -1
  170. package/dist/types/services/interfaces.d.ts +263 -2
  171. package/dist/types/services/link-authentication-element-manager.d.ts +51 -0
  172. package/dist/types/services/payment-element-manager.d.ts +46 -0
  173. package/dist/types/services/stripe-service.d.ts +17 -3
  174. package/dist/types/utils/element-finder.d.ts +8 -0
  175. package/dist/types/utils/error.d.ts +1 -1
  176. package/dist/types/utils/platform.d.ts +2 -2
  177. package/package.json +12 -3
  178. package/dist/cjs/index-CQkz7IJv.js.map +0 -1
  179. package/dist/esm/index-DB2hiILr.js.map +0 -1
  180. package/dist/stripe-elements/p-263cf51d.entry.js +0 -2
  181. package/dist/stripe-elements/p-263cf51d.entry.js.map +0 -1
  182. package/dist/stripe-elements/p-DB2hiILr.js +0 -3
  183. package/dist/stripe-elements/p-DB2hiILr.js.map +0 -1
  184. /package/dist/stripe-elements/{p-b598431f.entry.js.map → p-01d63033.entry.js.map} +0 -0
  185. /package/dist/stripe-elements/{p-5beb3870.entry.js.map → p-37008853.entry.js.map} +0 -0
  186. /package/dist/stripe-elements/{p-bb923a08.entry.js.map → p-bb1bc49a.entry.js.map} +0 -0
@@ -1,4 +1,4 @@
1
- import { Stripe, StripeCardCvcElement, StripeCardExpiryElement, StripeCardNumberElement, PaymentRequestPaymentMethodEvent, PaymentRequestShippingOptionEvent, PaymentRequestShippingAddressEvent, PaymentRequestOptions, PaymentIntentResult, SetupIntentResult } from '@stripe/stripe-js';
1
+ import { Stripe, StripeCardCvcElement, StripeCardExpiryElement, StripeCardNumberElement, StripeLinkAuthenticationElement, PaymentRequestPaymentMethodEvent, PaymentRequestShippingOptionEvent, PaymentRequestShippingAddressEvent, PaymentRequestOptions, PaymentIntentResult, SetupIntentResult } from '@stripe/stripe-js';
2
2
  /**
3
3
  * Internal util types
4
4
  */
@@ -58,3 +58,25 @@ export type DefaultFormSubmitResult = Error | PaymentIntentResult | SetupIntentR
58
58
  export type InitStripeOptions = {
59
59
  stripeAccount?: string;
60
60
  };
61
+ /**
62
+ * Event object of Link Authentication Element 'change' event
63
+ */
64
+ export type LinkAuthenticationElementChangeEvent = {
65
+ stripe: Stripe;
66
+ linkAuthenticationElement: StripeLinkAuthenticationElement;
67
+ email?: string;
68
+ };
69
+ /**
70
+ * Handler function of the Link Authentication Element 'change' event
71
+ */
72
+ export type LinkAuthenticationElementChangeHandler = (event: LinkAuthenticationElementChangeEvent) => Promise<void> | void;
73
+ /**
74
+ * Currency Selector Element change event data
75
+ */
76
+ export type CurrencySelectorChangeEvent = {
77
+ currency: string;
78
+ };
79
+ /**
80
+ * Currency Selector Element change handler
81
+ */
82
+ export type CurrencySelectorChangeHandler = (props: CurrencySelectorChangeEvent) => Promise<void>;
@@ -0,0 +1,44 @@
1
+ import type { IAddressElementManager, IStripeService, AddressElementState } from './interfaces';
2
+ import { StripeAddressElement } from '@stripe/stripe-js';
3
+ /**
4
+ * Address Element Manager
5
+ * Manages Stripe Address Element
6
+ * with dependency injection of StripeService
7
+ */
8
+ export declare class AddressElementManager implements IAddressElementManager {
9
+ private stripeService;
10
+ private addressElement?;
11
+ private store;
12
+ /**
13
+ * Constructor with dependency injection
14
+ * @param stripeService - Injected Stripe service instance
15
+ */
16
+ constructor(stripeService: IStripeService);
17
+ /**
18
+ * Get current address element state (reactive)
19
+ */
20
+ getState(): AddressElementState;
21
+ /**
22
+ * Initialize and mount address element to DOM
23
+ * @param containerElement - Parent element containing mount point
24
+ * @param options - Address element options
25
+ * @returns Promise resolving to address element instance
26
+ */
27
+ initialize(containerElement: HTMLElement, options?: import('@stripe/stripe-js').StripeAddressElementOptions): Promise<StripeAddressElement>;
28
+ /**
29
+ * Get mounted address element instance
30
+ */
31
+ getElement(): StripeAddressElement | undefined;
32
+ /**
33
+ * Set error message (triggers reactivity)
34
+ */
35
+ setError(message: string): void;
36
+ /**
37
+ * Clear error message (triggers reactivity)
38
+ */
39
+ clearError(): void;
40
+ /**
41
+ * Unmount address element
42
+ */
43
+ unmount(): void;
44
+ }
@@ -45,12 +45,4 @@ export declare class CardElementManager implements ICardElementManager {
45
45
  * Uses store.set() to trigger reactivity
46
46
  */
47
47
  private handleCardError;
48
- /**
49
- * Wait for an element to appear in the DOM
50
- * @param containerElement - Parent element to search in
51
- * @param selector - CSS selector
52
- * @param timeout - Timeout in milliseconds (default: 5000ms)
53
- * @returns Promise that resolves to the found element or rejects on timeout
54
- */
55
- private findElement;
56
48
  }
@@ -0,0 +1,45 @@
1
+ import type { ICurrencySelectorElementManager, IStripeService, CurrencySelectorElementState } from './interfaces';
2
+ import { StripeCurrencySelectorElement } from '@stripe/stripe-js';
3
+ /**
4
+ * Currency Selector Element Manager
5
+ * Manages Stripe Currency Selector Element
6
+ * with dependency injection of StripeService
7
+ */
8
+ export declare class CurrencySelectorElementManager implements ICurrencySelectorElementManager {
9
+ private stripeService;
10
+ private currencySelectorElement?;
11
+ private store;
12
+ /**
13
+ * Constructor with dependency injection
14
+ * @param stripeService - Injected Stripe service instance
15
+ */
16
+ constructor(stripeService: IStripeService);
17
+ /**
18
+ * Get current currency selector element state (reactive)
19
+ */
20
+ getState(): CurrencySelectorElementState;
21
+ /**
22
+ * Initialize and mount currency selector element to DOM
23
+ * @param containerElement - Parent element containing mount point
24
+ * @param options - Currency selector element options
25
+ * @returns Promise resolving to currency selector element instance
26
+ * Note: StripeCurrencySelectorElementOptions is not yet exported in @stripe/stripe-js v8.6.0
27
+ */
28
+ initialize(containerElement: HTMLElement, options?: any): Promise<StripeCurrencySelectorElement>;
29
+ /**
30
+ * Get mounted currency selector element instance
31
+ */
32
+ getElement(): StripeCurrencySelectorElement | undefined;
33
+ /**
34
+ * Set error message (triggers reactivity)
35
+ */
36
+ setError(message: string): void;
37
+ /**
38
+ * Clear error message (triggers reactivity)
39
+ */
40
+ clearError(): void;
41
+ /**
42
+ * Unmount currency selector element
43
+ */
44
+ unmount(): void;
45
+ }
@@ -0,0 +1,50 @@
1
+ import type { IExpressCheckoutElementManager, IStripeService, ExpressCheckoutElementOptions, ExpressCheckoutElementState, ExpressCheckoutElementEventHandlers } from './interfaces';
2
+ import { StripeExpressCheckoutElement } from '@stripe/stripe-js';
3
+ /**
4
+ * Express Checkout Element Manager
5
+ * Manages Stripe Express Checkout Element
6
+ * with dependency injection of StripeService
7
+ */
8
+ export declare class ExpressCheckoutElementManager implements IExpressCheckoutElementManager {
9
+ private stripeService;
10
+ private expressCheckoutElement?;
11
+ private store;
12
+ /**
13
+ * Constructor with dependency injection
14
+ * @param stripeService - Injected Stripe service instance
15
+ */
16
+ constructor(stripeService: IStripeService);
17
+ /**
18
+ * Get current express checkout element state (reactive)
19
+ */
20
+ getState(): ExpressCheckoutElementState;
21
+ /**
22
+ * Initialize and mount express checkout element to DOM
23
+ * @param containerElement - Parent element containing mount point
24
+ * @param options - Express Checkout Element configuration options
25
+ * @param eventHandlers - Event handlers for element events
26
+ * @returns Promise resolving to express checkout element instance
27
+ */
28
+ initialize(containerElement: HTMLElement, options: ExpressCheckoutElementOptions, eventHandlers?: ExpressCheckoutElementEventHandlers): Promise<StripeExpressCheckoutElement>;
29
+ /**
30
+ * Get mounted express checkout element instance
31
+ */
32
+ getElement(): StripeExpressCheckoutElement | undefined;
33
+ /**
34
+ * Update element options dynamically
35
+ * @param options - Partial options to update
36
+ */
37
+ update(options: Partial<ExpressCheckoutElementOptions>): void;
38
+ /**
39
+ * Set error message (triggers reactivity)
40
+ */
41
+ setError(message: string): void;
42
+ /**
43
+ * Clear error message (triggers reactivity)
44
+ */
45
+ clearError(): void;
46
+ /**
47
+ * Unmount express checkout element
48
+ */
49
+ unmount(): void;
50
+ }
@@ -1,4 +1,4 @@
1
- import type { IStripeService, ICardElementManager } from './interfaces';
1
+ import type { IStripeService, ICardElementManager, IPaymentElementManager, IAddressElementManager, ILinkAuthenticationElementManager, ICurrencySelectorElementManager, IExpressCheckoutElementManager } from './interfaces';
2
2
  /**
3
3
  * Service Factory
4
4
  * Creates service instances with proper dependency injection
@@ -14,6 +14,31 @@ export declare class ServiceFactory {
14
14
  * @param stripeService - Injected StripeService dependency
15
15
  */
16
16
  createCardElementManager(stripeService: IStripeService): ICardElementManager;
17
+ /**
18
+ * Create a new PaymentElementManager instance
19
+ * @param stripeService - Injected StripeService dependency
20
+ */
21
+ createPaymentElementManager(stripeService: IStripeService): IPaymentElementManager;
22
+ /**
23
+ * Create a new AddressElementManager instance
24
+ * @param stripeService - Injected StripeService dependency
25
+ */
26
+ createAddressElementManager(stripeService: IStripeService): IAddressElementManager;
27
+ /**
28
+ * Create a new LinkAuthenticationElementManager instance
29
+ * @param stripeService - Injected StripeService dependency
30
+ */
31
+ createLinkAuthenticationElementManager(stripeService: IStripeService): ILinkAuthenticationElementManager;
32
+ /**
33
+ * Create a new CurrencySelectorElementManager instance
34
+ * @param stripeService - Injected StripeService dependency
35
+ */
36
+ createCurrencySelectorElementManager(stripeService: IStripeService): ICurrencySelectorElementManager;
37
+ /**
38
+ * Create a new ExpressCheckoutElementManager instance
39
+ * @param stripeService - Injected StripeService dependency
40
+ */
41
+ createExpressCheckoutElementManager(stripeService: IStripeService): IExpressCheckoutElementManager;
17
42
  }
18
43
  /**
19
44
  * Default factory instance
@@ -1,5 +1,11 @@
1
- import { Stripe, StripeElements, StripeCardNumberElement, StripeCardExpiryElement, StripeCardCvcElement } from '@stripe/stripe-js';
1
+ import { Stripe, StripeElements, StripeCardNumberElement, StripeCardExpiryElement, StripeCardCvcElement, StripePaymentElement, StripeAddressElement, StripeLinkAuthenticationElement, StripeCurrencySelectorElement, StripeExpressCheckoutElement, StripeExpressCheckoutElementConfirmEvent, StripeExpressCheckoutElementClickEvent, StripeExpressCheckoutElementShippingAddressChangeEvent, StripeExpressCheckoutElementShippingRateChangeEvent, StripeCheckout, StripeCheckoutElementsOptions } from '@stripe/stripe-js';
2
2
  import { ProgressStatus } from '../interfaces';
3
+ /**
4
+ * Checkout session initialization options
5
+ */
6
+ export type CheckoutSessionOptions = {
7
+ elementsOptions?: StripeCheckoutElementsOptions;
8
+ };
3
9
  /**
4
10
  * Stripe service state
5
11
  */
@@ -10,6 +16,14 @@ export type StripeServiceState = {
10
16
  loadStripeStatus: ProgressStatus;
11
17
  stripe?: Stripe;
12
18
  elements?: StripeElements;
19
+ /**
20
+ * Checkout instance for Checkout Session mode
21
+ */
22
+ checkout?: StripeCheckout;
23
+ /**
24
+ * Whether the service is initialized with Checkout Session
25
+ */
26
+ isCheckoutSession?: boolean;
13
27
  };
14
28
  /**
15
29
  * Card element instances
@@ -26,6 +40,26 @@ export type CardElementState = {
26
40
  errorMessage: string;
27
41
  errorSource?: 'cardNumber' | 'cardExpiry' | 'cardCvc';
28
42
  };
43
+ /**
44
+ * Payment element state
45
+ */
46
+ export type PaymentElementState = {
47
+ errorMessage: string;
48
+ };
49
+ /**
50
+ * Address element state
51
+ */
52
+ export type AddressElementState = {
53
+ errorMessage: string;
54
+ isComplete: boolean;
55
+ };
56
+ /**
57
+ * Link Authentication element state
58
+ */
59
+ export type LinkAuthenticationElementState = {
60
+ errorMessage: string;
61
+ email?: string;
62
+ };
29
63
  /**
30
64
  * Core Stripe service interface
31
65
  * Manages Stripe.js initialization and Elements instance
@@ -36,12 +70,22 @@ export interface IStripeService {
36
70
  */
37
71
  readonly state: StripeServiceState;
38
72
  /**
39
- * Initialize Stripe.js
73
+ * Initialize Stripe.js with Payment Intent mode
40
74
  */
41
75
  initialize(publishableKey: string, options?: {
42
76
  stripeAccount?: string;
43
77
  applicationName?: string;
44
78
  }): Promise<void>;
79
+ /**
80
+ * Initialize Stripe.js with Checkout Session mode
81
+ * @param publishableKey - Your Stripe publishable API key
82
+ * @param checkoutSessionClientSecret - The client secret from Checkout Session
83
+ * @param options - Optional configuration
84
+ */
85
+ initializeWithCheckoutSession(publishableKey: string, checkoutSessionClientSecret: string, options?: {
86
+ stripeAccount?: string;
87
+ applicationName?: string;
88
+ } & CheckoutSessionOptions): Promise<void>;
45
89
  /**
46
90
  * Register state change listener
47
91
  */
@@ -54,6 +98,10 @@ export interface IStripeService {
54
98
  * Get Elements instance
55
99
  */
56
100
  getElements(): StripeElements | undefined;
101
+ /**
102
+ * Get Checkout instance (for Checkout Session mode)
103
+ */
104
+ getCheckout(): StripeCheckout | undefined;
57
105
  /**
58
106
  * Reset service (for testing)
59
107
  */
@@ -93,3 +141,216 @@ export interface ICardElementManager {
93
141
  */
94
142
  unmount(): void;
95
143
  }
144
+ /**
145
+ * Payment Element manager interface
146
+ * Manages the unified Stripe Payment Element
147
+ */
148
+ export interface IPaymentElementManager {
149
+ /**
150
+ * Get payment element state
151
+ */
152
+ getState(): PaymentElementState;
153
+ /**
154
+ * Initialize and mount payment element
155
+ * Supports both Payment Intent mode and Checkout Session mode
156
+ */
157
+ initialize(containerElement: HTMLElement, options?: import('@stripe/stripe-js').StripePaymentElementOptions | import('@stripe/stripe-js').StripeCheckoutPaymentElementOptions): Promise<StripePaymentElement>;
158
+ /**
159
+ * Get mounted payment element
160
+ */
161
+ getElement(): StripePaymentElement | undefined;
162
+ /**
163
+ * Set error message
164
+ */
165
+ setError(message: string): void;
166
+ /**
167
+ * Clear error message
168
+ */
169
+ clearError(): void;
170
+ /**
171
+ * Unmount payment element
172
+ */
173
+ unmount(): void;
174
+ }
175
+ /**
176
+ * Address Element manager interface
177
+ * Manages Stripe Address Element
178
+ */
179
+ export interface IAddressElementManager {
180
+ /**
181
+ * Get address element state
182
+ */
183
+ getState(): AddressElementState;
184
+ /**
185
+ * Initialize and mount address element
186
+ */
187
+ initialize(containerElement: HTMLElement, options?: import('@stripe/stripe-js').StripeAddressElementOptions): Promise<StripeAddressElement>;
188
+ /**
189
+ * Get mounted address element
190
+ */
191
+ getElement(): StripeAddressElement | undefined;
192
+ /**
193
+ * Set error message
194
+ */
195
+ setError(message: string): void;
196
+ /**
197
+ * Clear error message
198
+ */
199
+ clearError(): void;
200
+ /**
201
+ * Unmount address element
202
+ */
203
+ unmount(): void;
204
+ }
205
+ /**
206
+ * Link Authentication Element manager interface
207
+ * Manages Stripe Link Authentication Element for email collection and Link authentication
208
+ */
209
+ export interface ILinkAuthenticationElementManager {
210
+ /**
211
+ * Get link authentication element state
212
+ */
213
+ getState(): LinkAuthenticationElementState;
214
+ /**
215
+ * Register state change listener
216
+ */
217
+ onChange<K extends keyof LinkAuthenticationElementState>(key: K, callback: (newValue: LinkAuthenticationElementState[K]) => void): () => void;
218
+ /**
219
+ * Initialize and mount link authentication element
220
+ */
221
+ initialize(containerElement: HTMLElement, options?: import('@stripe/stripe-js').StripeLinkAuthenticationElementOptions): Promise<StripeLinkAuthenticationElement>;
222
+ /**
223
+ * Get mounted link authentication element
224
+ */
225
+ getElement(): StripeLinkAuthenticationElement | undefined;
226
+ /**
227
+ * Set error message
228
+ */
229
+ setError(message: string): void;
230
+ /**
231
+ * Clear error message
232
+ */
233
+ clearError(): void;
234
+ /**
235
+ * Unmount link authentication element
236
+ */
237
+ unmount(): void;
238
+ }
239
+ /**
240
+ * Currency Selector element state
241
+ */
242
+ export type CurrencySelectorElementState = {
243
+ errorMessage: string;
244
+ selectedCurrency?: string;
245
+ };
246
+ /**
247
+ * Currency Selector Element manager interface
248
+ * Manages Stripe Currency Selector Element
249
+ */
250
+ export interface ICurrencySelectorElementManager {
251
+ /**
252
+ * Get currency selector element state
253
+ */
254
+ getState(): CurrencySelectorElementState;
255
+ /**
256
+ * Initialize and mount currency selector element
257
+ * Note: StripeCurrencySelectorElementOptions is not yet exported in @stripe/stripe-js v8.6.0
258
+ */
259
+ initialize(containerElement: HTMLElement, options?: any): Promise<StripeCurrencySelectorElement>;
260
+ /**
261
+ * Get mounted currency selector element
262
+ */
263
+ getElement(): StripeCurrencySelectorElement | undefined;
264
+ /**
265
+ * Set error message
266
+ */
267
+ setError(message: string): void;
268
+ /**
269
+ * Clear error message
270
+ */
271
+ clearError(): void;
272
+ /**
273
+ * Unmount currency selector element
274
+ */
275
+ unmount(): void;
276
+ }
277
+ /**
278
+ * Express Checkout Element options
279
+ */
280
+ export type ExpressCheckoutElementOptions = {
281
+ mode?: 'payment' | 'setup' | 'subscription';
282
+ amount?: number;
283
+ currency?: string;
284
+ paymentMethods?: {
285
+ applePay?: 'never' | 'always' | 'auto';
286
+ googlePay?: 'never' | 'always' | 'auto';
287
+ link?: 'never' | 'always' | 'auto';
288
+ paypal?: 'never' | 'always' | 'auto';
289
+ amazonPay?: 'never' | 'always' | 'auto';
290
+ };
291
+ buttonType?: {
292
+ applePay?: 'buy' | 'donate' | 'plain' | 'book' | 'check-out' | 'subscribe';
293
+ googlePay?: 'buy' | 'donate' | 'plain' | 'book' | 'checkout' | 'order' | 'pay' | 'subscribe';
294
+ };
295
+ buttonTheme?: {
296
+ applePay?: 'black' | 'white' | 'white-outline';
297
+ googlePay?: 'black' | 'white';
298
+ };
299
+ buttonHeight?: string | number;
300
+ layout?: {
301
+ maxColumns?: number;
302
+ maxRows?: number;
303
+ overflow?: 'auto' | 'never';
304
+ };
305
+ };
306
+ /**
307
+ * Express Checkout Element state
308
+ */
309
+ export type ExpressCheckoutElementState = {
310
+ errorMessage: string;
311
+ isReady: boolean;
312
+ };
313
+ /**
314
+ * Express Checkout Element event handlers
315
+ */
316
+ export type ExpressCheckoutElementEventHandlers = {
317
+ onConfirm?: (event: StripeExpressCheckoutElementConfirmEvent) => void | Promise<void>;
318
+ onClick?: (event: StripeExpressCheckoutElementClickEvent) => void | Promise<void>;
319
+ onCancel?: () => void | Promise<void>;
320
+ onShippingAddressChange?: (event: StripeExpressCheckoutElementShippingAddressChangeEvent) => void | Promise<void>;
321
+ onShippingRateChange?: (event: StripeExpressCheckoutElementShippingRateChangeEvent) => void | Promise<void>;
322
+ };
323
+ /**
324
+ * Express Checkout Element manager interface
325
+ * Manages Stripe Express Checkout Element
326
+ */
327
+ export interface IExpressCheckoutElementManager {
328
+ /**
329
+ * Get express checkout element state
330
+ */
331
+ getState(): ExpressCheckoutElementState;
332
+ /**
333
+ * Initialize and mount express checkout element
334
+ */
335
+ initialize(containerElement: HTMLElement, options: ExpressCheckoutElementOptions, eventHandlers?: ExpressCheckoutElementEventHandlers): Promise<StripeExpressCheckoutElement>;
336
+ /**
337
+ * Get mounted express checkout element
338
+ */
339
+ getElement(): StripeExpressCheckoutElement | undefined;
340
+ /**
341
+ * Update element options
342
+ */
343
+ update(options: Partial<ExpressCheckoutElementOptions>): void;
344
+ /**
345
+ * Set error message
346
+ */
347
+ setError(message: string): void;
348
+ /**
349
+ * Clear error message
350
+ */
351
+ clearError(): void;
352
+ /**
353
+ * Unmount express checkout element
354
+ */
355
+ unmount(): void;
356
+ }
@@ -0,0 +1,51 @@
1
+ import type { ILinkAuthenticationElementManager, IStripeService, LinkAuthenticationElementState } from './interfaces';
2
+ import type { StripeLinkAuthenticationElement, StripeLinkAuthenticationElementOptions } from '@stripe/stripe-js';
3
+ /**
4
+ * Link Authentication Element Manager
5
+ * Manages Stripe Link Authentication Element for email collection and Link authentication
6
+ * with dependency injection of StripeService
7
+ */
8
+ export declare class LinkAuthenticationElementManager implements ILinkAuthenticationElementManager {
9
+ private stripeService;
10
+ private linkAuthenticationElement?;
11
+ private store;
12
+ /**
13
+ * Constructor with dependency injection
14
+ * @param stripeService - Injected Stripe service instance
15
+ */
16
+ constructor(stripeService: IStripeService);
17
+ /**
18
+ * Get current link authentication element state (reactive)
19
+ */
20
+ getState(): LinkAuthenticationElementState;
21
+ /**
22
+ * Register state change listener
23
+ * @param key - State property to watch
24
+ * @param callback - Callback function invoked when property changes
25
+ * @returns Unsubscribe function
26
+ */
27
+ onChange<K extends keyof LinkAuthenticationElementState>(key: K, callback: (newValue: LinkAuthenticationElementState[K]) => void): () => void;
28
+ /**
29
+ * Initialize and mount link authentication element to DOM
30
+ * @param containerElement - Parent element containing mount point
31
+ * @param options - Optional configuration for Link Authentication Element
32
+ * @returns Promise resolving to link authentication element instance
33
+ */
34
+ initialize(containerElement: HTMLElement, options?: StripeLinkAuthenticationElementOptions): Promise<StripeLinkAuthenticationElement>;
35
+ /**
36
+ * Get mounted link authentication element instance
37
+ */
38
+ getElement(): StripeLinkAuthenticationElement | undefined;
39
+ /**
40
+ * Set error message (triggers reactivity)
41
+ */
42
+ setError(message: string): void;
43
+ /**
44
+ * Clear error message (triggers reactivity)
45
+ */
46
+ clearError(): void;
47
+ /**
48
+ * Unmount link authentication element
49
+ */
50
+ unmount(): void;
51
+ }
@@ -0,0 +1,46 @@
1
+ import type { IPaymentElementManager, IStripeService, PaymentElementState } from './interfaces';
2
+ import type { StripePaymentElement, StripePaymentElementOptions, StripeCheckoutPaymentElementOptions } from '@stripe/stripe-js';
3
+ /**
4
+ * Payment Element Manager
5
+ * Manages Stripe Payment Element (unified payment form)
6
+ * with dependency injection of StripeService
7
+ * Supports both Payment Intent mode and Checkout Session mode
8
+ */
9
+ export declare class PaymentElementManager implements IPaymentElementManager {
10
+ private stripeService;
11
+ private paymentElement?;
12
+ private store;
13
+ /**
14
+ * Constructor with dependency injection
15
+ * @param stripeService - Injected Stripe service instance
16
+ */
17
+ constructor(stripeService: IStripeService);
18
+ /**
19
+ * Get current payment element state (reactive)
20
+ */
21
+ getState(): PaymentElementState;
22
+ /**
23
+ * Initialize and mount payment element to DOM
24
+ * Supports both Payment Intent mode and Checkout Session mode
25
+ * @param containerElement - Parent element containing mount point
26
+ * @param options - Optional payment element options
27
+ * @returns Promise resolving to payment element instance
28
+ */
29
+ initialize(containerElement: HTMLElement, options?: StripePaymentElementOptions | StripeCheckoutPaymentElementOptions): Promise<StripePaymentElement>;
30
+ /**
31
+ * Get mounted payment element instance
32
+ */
33
+ getElement(): StripePaymentElement | undefined;
34
+ /**
35
+ * Set error message (triggers reactivity)
36
+ */
37
+ setError(message: string): void;
38
+ /**
39
+ * Clear error message (triggers reactivity)
40
+ */
41
+ clearError(): void;
42
+ /**
43
+ * Unmount payment element
44
+ */
45
+ unmount(): void;
46
+ }
@@ -1,5 +1,5 @@
1
- import { Stripe, StripeElements } from '@stripe/stripe-js';
2
- import type { IStripeService, StripeServiceState } from './interfaces';
1
+ import { Stripe, StripeElements, StripeCheckout } from '@stripe/stripe-js';
2
+ import type { IStripeService, StripeServiceState, CheckoutSessionOptions } from './interfaces';
3
3
  /**
4
4
  * Core Stripe Service
5
5
  * Manages Stripe.js initialization and Elements instance only
@@ -21,7 +21,7 @@ declare class StripeServiceClass implements IStripeService {
21
21
  */
22
22
  onChange<K extends keyof StripeServiceState>(key: K, callback: (newValue: StripeServiceState[K]) => void): () => void;
23
23
  /**
24
- * Initialize Stripe.js client
24
+ * Initialize Stripe.js client with Payment Intent mode
25
25
  * @param publishableKey - Your Stripe publishable API key
26
26
  * @param options - Optional configuration
27
27
  */
@@ -29,6 +29,16 @@ declare class StripeServiceClass implements IStripeService {
29
29
  stripeAccount?: string;
30
30
  applicationName?: string;
31
31
  }): Promise<void>;
32
+ /**
33
+ * Initialize Stripe.js client with Checkout Session mode
34
+ * @param publishableKey - Your Stripe publishable API key
35
+ * @param checkoutSessionClientSecret - The client secret from Checkout Session
36
+ * @param options - Optional configuration
37
+ */
38
+ initializeWithCheckoutSession(publishableKey: string, checkoutSessionClientSecret: string, options?: {
39
+ stripeAccount?: string;
40
+ applicationName?: string;
41
+ } & CheckoutSessionOptions): Promise<void>;
32
42
  /**
33
43
  * Get the current Stripe instance
34
44
  */
@@ -37,6 +47,10 @@ declare class StripeServiceClass implements IStripeService {
37
47
  * Get the current Elements instance
38
48
  */
39
49
  getElements(): StripeElements | undefined;
50
+ /**
51
+ * Get the current Checkout instance (for Checkout Session mode)
52
+ */
53
+ getCheckout(): StripeCheckout | undefined;
40
54
  /**
41
55
  * Reset the service to initial state
42
56
  * Useful for testing and cleanup
@@ -0,0 +1,8 @@
1
+ /**
2
+ * Wait for an element to appear in the DOM
3
+ * @param containerElement - Parent element to search in
4
+ * @param selector - CSS selector
5
+ * @param timeout - Timeout in milliseconds (default: 5000ms)
6
+ * @returns Promise that resolves to the found element or rejects on timeout
7
+ */
8
+ export declare function findElement(containerElement: HTMLElement, selector: string, timeout?: number): Promise<HTMLElement>;
@@ -1,4 +1,4 @@
1
- import { StripeError } from "@stripe/stripe-js";
1
+ import { StripeError } from '@stripe/stripe-js';
2
2
  export declare class StripeAPIError extends Error {
3
3
  code: string;
4
4
  docUrl: string;