@zerohash-sdk/csp-fiat-withdrawals-js 0.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.
package/README.md ADDED
@@ -0,0 +1,7 @@
1
+ # @zerohash-sdk/csp-fiat-withdrawals-js
2
+
3
+ This library was generated with [Nx](https://nx.dev).
4
+
5
+ ## Running unit tests
6
+
7
+ Run `nx test @zerohash-sdk/csp-fiat-withdrawals-js` to execute the unit tests via [Vitest](https://vitest.dev/).
@@ -0,0 +1,485 @@
1
+ /**
2
+ * Zerohash CSP Fiat Withdrawals JavaScript SDK
3
+ *
4
+ * A programmatic JavaScript SDK for integrating the CSP Fiat Withdrawals widget
5
+ * into web applications without requiring HTML custom elements.
6
+ *
7
+ * @packageDocumentation
8
+ */
9
+
10
+ /**
11
+ * Generic app event structure
12
+ * @template TType - Event type string
13
+ * @template TData - Event data payload
14
+ */
15
+ declare type AppEvent<TType extends string = string, TData = Record<string, unknown>> = {
16
+ /** The type of event that occurred */
17
+ type: TType;
18
+ /** Data associated with the event */
19
+ data: TData;
20
+ };
21
+
22
+ /**
23
+ * Configuration options for the SDK
24
+ */
25
+ declare interface BaseConfig<TEvent = AppEvent> extends CommonCallbacks<TEvent> {
26
+ /**
27
+ * JWT token used for authentication
28
+ */
29
+ jwt: string;
30
+
31
+ /**
32
+ * Target environment
33
+ * @default 'production'
34
+ */
35
+ env?: Environment;
36
+
37
+ /**
38
+ * Theme mode
39
+ * @default 'auto'
40
+ *
41
+ * Available themes:
42
+ * - `'auto'` - Automatically detect system preference (light/dark mode)
43
+ * - `'light'` - Force light theme
44
+ * - `'dark'` - Force dark theme
45
+ */
46
+ theme?: Theme;
47
+ }
48
+
49
+ declare type BaseErrorMessageKeys =
50
+ | 'ALREADY_RENDERED'
51
+ | 'NOT_RENDERED'
52
+ | 'INVALID_CONTAINER'
53
+ | 'SCRIPT_LOAD_FAILED'
54
+ | 'WEB_COMPONENT_NOT_DEFINED';
55
+
56
+ declare abstract class BaseJsSdk<Config extends BaseConfig<never> = BaseConfig> {
57
+ private config: Config;
58
+ private state: SdkState;
59
+ private scriptLoadingPromise?: Promise<void>;
60
+
61
+ protected abstract errorMessages: Record<BaseErrorMessageKeys, string>;
62
+ protected abstract scriptUrls: Record<string, string>;
63
+ protected abstract webComponentTag: string;
64
+
65
+ constructor(config: Config) {
66
+ if (!config.jwt || typeof config.jwt !== 'string') {
67
+ throw new Error(INVALID_JWT_ERROR_MESSAGE);
68
+ }
69
+
70
+ this.config = {
71
+ ...config,
72
+ env: config.env || DEFAULT_ENVIRONMENT,
73
+ theme: config.theme,
74
+ };
75
+
76
+ this.state = {
77
+ initialized: false,
78
+ scriptLoaded: false,
79
+ container: null,
80
+ element: null,
81
+ };
82
+ }
83
+
84
+ /**
85
+ * Render the widget to a container element
86
+ * @param container - The container element to render the widget into
87
+ * @returns Promise that resolves when the widget is rendered
88
+ */
89
+ async render(container: HTMLElement): Promise<void> {
90
+ // Validate container
91
+ if (!container || !(container instanceof HTMLElement)) {
92
+ throw new Error(this.errorMessages.INVALID_CONTAINER);
93
+ }
94
+
95
+ // Check if already rendered
96
+ if (this.state.initialized) {
97
+ throw new Error(this.errorMessages.ALREADY_RENDERED);
98
+ }
99
+
100
+ try {
101
+ // Ensure script is loaded
102
+ await this.ensureScriptLoaded();
103
+
104
+ // Create and append the web component
105
+ const element = this.createWebComponent();
106
+
107
+ // Clear the container and append the element
108
+ container.innerHTML = '';
109
+ container.appendChild(element);
110
+
111
+ // Update state
112
+ this.state.container = container;
113
+ this.state.element = element;
114
+ this.state.initialized = true;
115
+ } catch (error) {
116
+ console.error('Failed to render widget:', error);
117
+ throw error;
118
+ }
119
+ }
120
+
121
+ /**
122
+ * Update the configuration of the widget
123
+ * @param config - Partial configuration to update
124
+ * @returns void
125
+ */
126
+ updateConfig(config: Partial<Config>): void {
127
+ if (!this.state.initialized || !this.state.element) {
128
+ throw new Error(this.errorMessages.NOT_RENDERED);
129
+ }
130
+
131
+ const element = this.state.element as SdkElement<Config>;
132
+
133
+ Object.entries(config).forEach(([key, value]) => {
134
+ if (value) {
135
+ this.config[key as keyof Config] = value;
136
+ element[key as keyof Config] = value;
137
+ }
138
+ });
139
+ }
140
+
141
+ /**
142
+ * Destroy the widget and clean up resources
143
+ */
144
+ destroy(): void {
145
+ if (!this.state.initialized) {
146
+ return; // Nothing to destroy
147
+ }
148
+
149
+ // Remove the element from the container
150
+ if (this.state.element && this.state.element.parentNode) {
151
+ this.state.element.parentNode.removeChild(this.state.element);
152
+ }
153
+
154
+ // Clear the container
155
+ if (this.state.container) {
156
+ this.state.container.innerHTML = '';
157
+ }
158
+
159
+ // Reset state
160
+ this.state.container = null;
161
+ this.state.element = null;
162
+ this.state.initialized = false;
163
+ }
164
+
165
+ /**
166
+ * Check if the widget is currently rendered
167
+ * @returns True if the widget is rendered, false otherwise
168
+ */
169
+ isRendered(): boolean {
170
+ return this.state.initialized;
171
+ }
172
+
173
+ /**
174
+ * Get the current configuration
175
+ * @returns The current configuration object
176
+ */
177
+ getConfig(): Readonly<Config> {
178
+ return { ...this.config };
179
+ }
180
+
181
+ private getEnvironment(): Environment {
182
+ return this.config.env || DEFAULT_ENVIRONMENT;
183
+ }
184
+
185
+ private getScriptId() {
186
+ return `${this.webComponentTag}-script-${this.getEnvironment()}`;
187
+ }
188
+
189
+ private isScriptLoaded() {
190
+ return !!document.getElementById(this.getScriptId());
191
+ }
192
+
193
+ private getWebComponent() {
194
+ return customElements.get(this.webComponentTag);
195
+ }
196
+
197
+ private getScriptUrl() {
198
+ // Support local development with Vite
199
+ if (typeof import.meta !== 'undefined' && import.meta.env?.['VITE_INTERNAL_BUILD'] === 'true') {
200
+ return import.meta.env['VITE_SCRIPT_URL'] || this.scriptUrls[this.getEnvironment()];
201
+ }
202
+
203
+ return this.scriptUrls[this.getEnvironment()];
204
+ }
205
+
206
+ private async loadScript() {
207
+ if (this.isScriptLoaded()) {
208
+ return;
209
+ }
210
+
211
+ if (this.scriptLoadingPromise) {
212
+ return this.scriptLoadingPromise;
213
+ }
214
+
215
+ this.scriptLoadingPromise = new Promise<void>((resolve, reject) => {
216
+ const script = document.createElement('script');
217
+ script.id = this.getScriptId();
218
+ script.src = this.getScriptUrl();
219
+ script.type = 'module';
220
+ script.async = true;
221
+
222
+ script.onload = () => {
223
+ setTimeout(() => {
224
+ if (this.getWebComponent()) {
225
+ resolve();
226
+ } else {
227
+ reject(new Error(this.errorMessages.WEB_COMPONENT_NOT_DEFINED));
228
+ }
229
+ }, 0);
230
+ };
231
+
232
+ script.onerror = () => {
233
+ this.scriptLoadingPromise = undefined;
234
+ reject(new Error(`${this.errorMessages.SCRIPT_LOAD_FAILED} (${this.getEnvironment()})`));
235
+ };
236
+
237
+ document.head.appendChild(script);
238
+ });
239
+
240
+ try {
241
+ await this.scriptLoadingPromise;
242
+ } catch (error) {
243
+ this.scriptLoadingPromise = undefined;
244
+ throw error;
245
+ }
246
+
247
+ return this.scriptLoadingPromise;
248
+ }
249
+
250
+ private async waitForWebComponent(timeout = 5000) {
251
+ if (this.getWebComponent()) {
252
+ return;
253
+ }
254
+
255
+ return new Promise<void>((resolve, reject) => {
256
+ const timeoutId = setTimeout(() => {
257
+ reject(new Error(`Timeout waiting for ${this.webComponentTag} to be defined`));
258
+ }, timeout);
259
+
260
+ customElements
261
+ .whenDefined(this.webComponentTag)
262
+ .then(() => {
263
+ clearTimeout(timeoutId);
264
+ resolve();
265
+ })
266
+ .catch((error) => {
267
+ clearTimeout(timeoutId);
268
+ reject(error);
269
+ });
270
+ });
271
+ }
272
+
273
+ /**
274
+ * Load the web component script if not already loaded
275
+ */
276
+ protected async ensureScriptLoaded(): Promise<void> {
277
+ if (this.state.scriptLoaded) {
278
+ return;
279
+ }
280
+
281
+ try {
282
+ await this.loadScript();
283
+ await this.waitForWebComponent();
284
+ this.state.scriptLoaded = true;
285
+ } catch (error) {
286
+ console.error('Failed to load Connect script:', error);
287
+ throw error;
288
+ }
289
+ }
290
+
291
+ private createWebComponent() {
292
+ const element = document.createElement(this.webComponentTag) as SdkElement<Config>;
293
+
294
+ Object.entries(this.config).forEach(([key, value]) => {
295
+ if (value) {
296
+ element[key as keyof Config] = value;
297
+ }
298
+ });
299
+
300
+ return element;
301
+ }
302
+ }
303
+
304
+ /**
305
+ * Common callback function types shared across all Connect apps
306
+ * @template TEvent - The event type for onEvent callback
307
+ */
308
+ declare type CommonCallbacks<TEvent = AppEvent> = {
309
+ /** Called when an error occurs */
310
+ onError?: (error: ErrorPayload) => void;
311
+ /** Called when the component is closed */
312
+ onClose?: () => void;
313
+ /** Called when a general event occurs */
314
+ onEvent?: (event: TEvent) => void;
315
+ /** Called when the widget has loaded and is ready */
316
+ onLoaded?: () => void;
317
+ };
318
+
319
+ /**
320
+ * CspFiatWithdrawals SDK class for programmatic control of the Zerohash CSP Fiat Withdrawals widget.
321
+ *
322
+ * Renders the `zerohash-csp-fiat-withdrawals` web component, which handles the iframe
323
+ * and postMessage communication internally.
324
+ *
325
+ * @example
326
+ * ```javascript
327
+ * const cspFiatWithdrawals = new CspFiatWithdrawals({
328
+ * jwt: 'your-jwt-token',
329
+ * env: 'prod',
330
+ * theme: 'auto',
331
+ * onCompleted: ({ amountWithdrawn, assetSymbol }) =>
332
+ * console.log('Withdrew', amountWithdrawn, assetSymbol),
333
+ * onClose: () => console.log('Closed'),
334
+ * onError: ({ errorCode, reason }) => console.error(errorCode, reason),
335
+ * });
336
+ *
337
+ * // Render to a container
338
+ * await cspFiatWithdrawals.render(document.getElementById('csp-fiat-withdrawals-container'));
339
+ *
340
+ * // Update configuration
341
+ * cspFiatWithdrawals.updateConfig({ jwt: 'new-token', theme: 'dark' });
342
+ *
343
+ * // Clean up
344
+ * cspFiatWithdrawals.destroy();
345
+ * ```
346
+ */
347
+ declare class CspFiatWithdrawals extends BaseJsSdk<CspFiatWithdrawalsConfig> {
348
+ protected errorMessages: {
349
+ ALREADY_RENDERED: string;
350
+ NOT_RENDERED: string;
351
+ INVALID_CONTAINER: string;
352
+ SCRIPT_LOAD_FAILED: string;
353
+ WEB_COMPONENT_NOT_DEFINED: string;
354
+ };
355
+ protected scriptUrls: {
356
+ local: string;
357
+ dev: string;
358
+ cert: string;
359
+ prod: string;
360
+ sandbox: string;
361
+ production: string;
362
+ };
363
+ protected webComponentTag: string;
364
+ /**
365
+ * Render the CspFiatWithdrawals widget to a container element
366
+ * @param container - The container element to render the widget into
367
+ * @returns Promise that resolves when the widget is rendered
368
+ */
369
+ render(container: HTMLElement): Promise<void>;
370
+ /**
371
+ * Update the configuration of the CspFiatWithdrawals widget
372
+ * @param config - Partial configuration to update
373
+ */
374
+ updateConfig(config: Partial<CspFiatWithdrawalsConfig>): void;
375
+ /**
376
+ * Get the current configuration
377
+ * @returns The current configuration object
378
+ */
379
+ getConfig(): Readonly<CspFiatWithdrawalsConfig>;
380
+ /**
381
+ * Check if the CspFiatWithdrawals widget is currently rendered
382
+ * @returns True if the widget is rendered, false otherwise
383
+ */
384
+ isRendered(): boolean;
385
+ /**
386
+ * Destroy the CspFiatWithdrawals widget and clean up resources
387
+ */
388
+ destroy(): void;
389
+ }
390
+ export { CspFiatWithdrawals }
391
+ export default CspFiatWithdrawals;
392
+
393
+ declare type CspFiatWithdrawalsCallbacks = CommonCallbacks<CspFiatWithdrawalsEvent> & {
394
+ /** Called when the flow is successfully completed */
395
+ onCompleted?: (data: CspFiatWithdrawalsCompletedData) => void;
396
+ /** Called when the widget has loaded and is ready */
397
+ onLoaded?: () => void;
398
+ };
399
+
400
+ declare type CspFiatWithdrawalsCompletedData = {
401
+ /** Amount withdrawn as a string */
402
+ amountWithdrawn: string;
403
+ /** Symbol of the fiat currency that was withdrawn (e.g. 'USD') */
404
+ assetSymbol: string;
405
+ };
406
+
407
+ export declare interface CspFiatWithdrawalsConfig extends BaseConfig<CspFiatWithdrawalsEvent>, CspFiatWithdrawalsCallbacks {
408
+ }
409
+
410
+ /**
411
+ * CSP fiat withdrawals event structure
412
+ */
413
+ declare type CspFiatWithdrawalsEvent = AppEvent<CspFiatWithdrawalsEventType>;
414
+
415
+ /**
416
+ * CSP fiat withdrawals event type literals
417
+ */
418
+ declare type CspFiatWithdrawalsEventType = string;
419
+
420
+ /**
421
+ * Environment configuration for the SDK
422
+ */
423
+ export declare type Environment = 'local' | 'dev' | 'cert' | 'prod' | 'sandbox' | 'production';
424
+
425
+ /**
426
+ * Generic error codes for all Connect applications
427
+ */
428
+ export declare enum ErrorCode {
429
+ /** Network connectivity error */
430
+ NETWORK_ERROR = 'network_error',
431
+ /** Authentication or session expired error */
432
+ AUTH_ERROR = 'auth_error',
433
+ /** Resource not found error */
434
+ NOT_FOUND_ERROR = 'not_found_error',
435
+ /** Validation error from user input */
436
+ VALIDATION_ERROR = 'validation_error',
437
+ /** Server error (5xx) */
438
+ SERVER_ERROR = 'server_error',
439
+ /** Client error (4xx) */
440
+ CLIENT_ERROR = 'client_error',
441
+ /** Unknown or unexpected error */
442
+ UNKNOWN_ERROR = 'unknown_error',
443
+ }
444
+
445
+ /**
446
+ * Generic error payload structure for error callbacks
447
+ */
448
+ declare type ErrorPayload = {
449
+ /** Error code indicating the type of error */
450
+ errorCode: ErrorCode;
451
+ /** Human-readable reason for the error */
452
+ reason: string;
453
+ };
454
+
455
+ /**
456
+ * Generic HTMLElement representing a web component with custom config
457
+ */
458
+ declare type SdkElement<Config extends BaseConfig<never>> = HTMLElement & Config;
459
+
460
+ /**
461
+ * Internal state of the SDK
462
+ */
463
+ declare interface SdkState {
464
+ /** Whether the SDK is initialized */
465
+ initialized: boolean;
466
+ /** Whether the web component script is loaded */
467
+ scriptLoaded: boolean;
468
+ /** The container element where the widget is rendered */
469
+ container: HTMLElement | null;
470
+ /** The web component element */
471
+ element: HTMLElement | null;
472
+ }
473
+
474
+ /**
475
+ * Theme configuration for the SDK
476
+ *
477
+ * - `"auto"` - Automatically detect system preference (light/dark mode)
478
+ * - `"light"` - Force light theme
479
+ * - `"dark"` - Force dark theme
480
+ */
481
+ declare type Theme = 'auto' | 'light' | 'dark';
482
+
483
+ export declare type ZerohashCspFiatWithdrawalsElement = SdkElement<CspFiatWithdrawalsConfig>;
484
+
485
+ export { }
package/dist/index.js ADDED
@@ -0,0 +1,200 @@
1
+ const n = "production", d = "JWT token is required and must be a string.";
2
+ class h {
3
+ config;
4
+ state;
5
+ scriptLoadingPromise;
6
+ constructor(e) {
7
+ if (!e.jwt || typeof e.jwt != "string")
8
+ throw new Error(d);
9
+ this.config = {
10
+ ...e,
11
+ env: e.env || n,
12
+ theme: e.theme
13
+ }, this.state = {
14
+ initialized: !1,
15
+ scriptLoaded: !1,
16
+ container: null,
17
+ element: null
18
+ };
19
+ }
20
+ /**
21
+ * Render the widget to a container element
22
+ * @param container - The container element to render the widget into
23
+ * @returns Promise that resolves when the widget is rendered
24
+ */
25
+ async render(e) {
26
+ if (!e || !(e instanceof HTMLElement))
27
+ throw new Error(this.errorMessages.INVALID_CONTAINER);
28
+ if (this.state.initialized)
29
+ throw new Error(this.errorMessages.ALREADY_RENDERED);
30
+ try {
31
+ await this.ensureScriptLoaded();
32
+ const i = this.createWebComponent();
33
+ e.innerHTML = "", e.appendChild(i), this.state.container = e, this.state.element = i, this.state.initialized = !0;
34
+ } catch (i) {
35
+ throw console.error("Failed to render widget:", i), i;
36
+ }
37
+ }
38
+ /**
39
+ * Update the configuration of the widget
40
+ * @param config - Partial configuration to update
41
+ * @returns void
42
+ */
43
+ updateConfig(e) {
44
+ if (!this.state.initialized || !this.state.element)
45
+ throw new Error(this.errorMessages.NOT_RENDERED);
46
+ const i = this.state.element;
47
+ Object.entries(e).forEach(([t, s]) => {
48
+ s && (this.config[t] = s, i[t] = s);
49
+ });
50
+ }
51
+ /**
52
+ * Destroy the widget and clean up resources
53
+ */
54
+ destroy() {
55
+ this.state.initialized && (this.state.element && this.state.element.parentNode && this.state.element.parentNode.removeChild(this.state.element), this.state.container && (this.state.container.innerHTML = ""), this.state.container = null, this.state.element = null, this.state.initialized = !1);
56
+ }
57
+ /**
58
+ * Check if the widget is currently rendered
59
+ * @returns True if the widget is rendered, false otherwise
60
+ */
61
+ isRendered() {
62
+ return this.state.initialized;
63
+ }
64
+ /**
65
+ * Get the current configuration
66
+ * @returns The current configuration object
67
+ */
68
+ getConfig() {
69
+ return { ...this.config };
70
+ }
71
+ getEnvironment() {
72
+ return this.config.env || n;
73
+ }
74
+ getScriptId() {
75
+ return `${this.webComponentTag}-script-${this.getEnvironment()}`;
76
+ }
77
+ isScriptLoaded() {
78
+ return !!document.getElementById(this.getScriptId());
79
+ }
80
+ getWebComponent() {
81
+ return customElements.get(this.webComponentTag);
82
+ }
83
+ getScriptUrl() {
84
+ return this.scriptUrls[this.getEnvironment()];
85
+ }
86
+ async loadScript() {
87
+ if (!this.isScriptLoaded()) {
88
+ if (this.scriptLoadingPromise)
89
+ return this.scriptLoadingPromise;
90
+ this.scriptLoadingPromise = new Promise((e, i) => {
91
+ const t = document.createElement("script");
92
+ t.id = this.getScriptId(), t.src = this.getScriptUrl(), t.type = "module", t.async = !0, t.onload = () => {
93
+ setTimeout(() => {
94
+ this.getWebComponent() ? e() : i(new Error(this.errorMessages.WEB_COMPONENT_NOT_DEFINED));
95
+ }, 0);
96
+ }, t.onerror = () => {
97
+ this.scriptLoadingPromise = void 0, i(new Error(`${this.errorMessages.SCRIPT_LOAD_FAILED} (${this.getEnvironment()})`));
98
+ }, document.head.appendChild(t);
99
+ });
100
+ try {
101
+ await this.scriptLoadingPromise;
102
+ } catch (e) {
103
+ throw this.scriptLoadingPromise = void 0, e;
104
+ }
105
+ return this.scriptLoadingPromise;
106
+ }
107
+ }
108
+ async waitForWebComponent(e = 5e3) {
109
+ if (!this.getWebComponent())
110
+ return new Promise((i, t) => {
111
+ const s = setTimeout(() => {
112
+ t(new Error(`Timeout waiting for ${this.webComponentTag} to be defined`));
113
+ }, e);
114
+ customElements.whenDefined(this.webComponentTag).then(() => {
115
+ clearTimeout(s), i();
116
+ }).catch((a) => {
117
+ clearTimeout(s), t(a);
118
+ });
119
+ });
120
+ }
121
+ /**
122
+ * Load the web component script if not already loaded
123
+ */
124
+ async ensureScriptLoaded() {
125
+ if (!this.state.scriptLoaded)
126
+ try {
127
+ await this.loadScript(), await this.waitForWebComponent(), this.state.scriptLoaded = !0;
128
+ } catch (e) {
129
+ throw console.error("Failed to load Connect script:", e), e;
130
+ }
131
+ }
132
+ createWebComponent() {
133
+ const e = document.createElement(this.webComponentTag);
134
+ return Object.entries(this.config).forEach(([i, t]) => {
135
+ t && (e[i] = t);
136
+ }), e;
137
+ }
138
+ }
139
+ var o;
140
+ (function(r) {
141
+ r.NETWORK_ERROR = "network_error", r.AUTH_ERROR = "auth_error", r.NOT_FOUND_ERROR = "not_found_error", r.VALIDATION_ERROR = "validation_error", r.SERVER_ERROR = "server_error", r.CLIENT_ERROR = "client_error", r.UNKNOWN_ERROR = "unknown_error";
142
+ })(o || (o = {}));
143
+ class c extends h {
144
+ errorMessages = {
145
+ ALREADY_RENDERED: "CspFiatWithdrawals widget is already rendered. Call destroy() before rendering again.",
146
+ NOT_RENDERED: "CspFiatWithdrawals widget is not rendered. Call render() first.",
147
+ INVALID_CONTAINER: "Invalid container element provided.",
148
+ SCRIPT_LOAD_FAILED: "Failed to load the Zerohash CspFiatWithdrawals script.",
149
+ WEB_COMPONENT_NOT_DEFINED: "Web component is not defined. Script may not be loaded."
150
+ };
151
+ scriptUrls = {
152
+ local: "http://localhost:5173/csp-fiat-withdrawals-web/index.js",
153
+ dev: "https://connect-sdk.dev.0hash.com/csp-fiat-withdrawals-web/index.js",
154
+ cert: "https://sdk.sandbox.connect.xyz/csp-fiat-withdrawals-web/index.js",
155
+ prod: "https://sdk.connect.xyz/csp-fiat-withdrawals-web/index.js",
156
+ sandbox: "https://sdk.sandbox.connect.xyz/csp-fiat-withdrawals-web/index.js",
157
+ production: "https://sdk.connect.xyz/csp-fiat-withdrawals-web/index.js"
158
+ };
159
+ webComponentTag = "zerohash-csp-fiat-withdrawals";
160
+ /**
161
+ * Render the CspFiatWithdrawals widget to a container element
162
+ * @param container - The container element to render the widget into
163
+ * @returns Promise that resolves when the widget is rendered
164
+ */
165
+ render(e) {
166
+ return super.render(e);
167
+ }
168
+ /**
169
+ * Update the configuration of the CspFiatWithdrawals widget
170
+ * @param config - Partial configuration to update
171
+ */
172
+ updateConfig(e) {
173
+ return super.updateConfig(e);
174
+ }
175
+ /**
176
+ * Get the current configuration
177
+ * @returns The current configuration object
178
+ */
179
+ getConfig() {
180
+ return super.getConfig();
181
+ }
182
+ /**
183
+ * Check if the CspFiatWithdrawals widget is currently rendered
184
+ * @returns True if the widget is rendered, false otherwise
185
+ */
186
+ isRendered() {
187
+ return super.isRendered();
188
+ }
189
+ /**
190
+ * Destroy the CspFiatWithdrawals widget and clean up resources
191
+ */
192
+ destroy() {
193
+ return super.destroy();
194
+ }
195
+ }
196
+ export {
197
+ c as CspFiatWithdrawals,
198
+ o as ErrorCode,
199
+ c as default
200
+ };
@@ -0,0 +1 @@
1
+ (function(r,n){typeof exports=="object"&&typeof module<"u"?n(exports):typeof define=="function"&&define.amd?define(["exports"],n):(r=typeof globalThis<"u"?globalThis:r||self,n(r.CspFiatWithdrawals={}))})(this,(function(r){"use strict";const n="production",d="JWT token is required and must be a string.";class h{config;state;scriptLoadingPromise;constructor(e){if(!e.jwt||typeof e.jwt!="string")throw new Error(d);this.config={...e,env:e.env||n,theme:e.theme},this.state={initialized:!1,scriptLoaded:!1,container:null,element:null}}async render(e){if(!e||!(e instanceof HTMLElement))throw new Error(this.errorMessages.INVALID_CONTAINER);if(this.state.initialized)throw new Error(this.errorMessages.ALREADY_RENDERED);try{await this.ensureScriptLoaded();const i=this.createWebComponent();e.innerHTML="",e.appendChild(i),this.state.container=e,this.state.element=i,this.state.initialized=!0}catch(i){throw console.error("Failed to render widget:",i),i}}updateConfig(e){if(!this.state.initialized||!this.state.element)throw new Error(this.errorMessages.NOT_RENDERED);const i=this.state.element;Object.entries(e).forEach(([t,o])=>{o&&(this.config[t]=o,i[t]=o)})}destroy(){this.state.initialized&&(this.state.element&&this.state.element.parentNode&&this.state.element.parentNode.removeChild(this.state.element),this.state.container&&(this.state.container.innerHTML=""),this.state.container=null,this.state.element=null,this.state.initialized=!1)}isRendered(){return this.state.initialized}getConfig(){return{...this.config}}getEnvironment(){return this.config.env||n}getScriptId(){return`${this.webComponentTag}-script-${this.getEnvironment()}`}isScriptLoaded(){return!!document.getElementById(this.getScriptId())}getWebComponent(){return customElements.get(this.webComponentTag)}getScriptUrl(){return this.scriptUrls[this.getEnvironment()]}async loadScript(){if(!this.isScriptLoaded()){if(this.scriptLoadingPromise)return this.scriptLoadingPromise;this.scriptLoadingPromise=new Promise((e,i)=>{const t=document.createElement("script");t.id=this.getScriptId(),t.src=this.getScriptUrl(),t.type="module",t.async=!0,t.onload=()=>{setTimeout(()=>{this.getWebComponent()?e():i(new Error(this.errorMessages.WEB_COMPONENT_NOT_DEFINED))},0)},t.onerror=()=>{this.scriptLoadingPromise=void 0,i(new Error(`${this.errorMessages.SCRIPT_LOAD_FAILED} (${this.getEnvironment()})`))},document.head.appendChild(t)});try{await this.scriptLoadingPromise}catch(e){throw this.scriptLoadingPromise=void 0,e}return this.scriptLoadingPromise}}async waitForWebComponent(e=5e3){if(!this.getWebComponent())return new Promise((i,t)=>{const o=setTimeout(()=>{t(new Error(`Timeout waiting for ${this.webComponentTag} to be defined`))},e);customElements.whenDefined(this.webComponentTag).then(()=>{clearTimeout(o),i()}).catch(c=>{clearTimeout(o),t(c)})})}async ensureScriptLoaded(){if(!this.state.scriptLoaded)try{await this.loadScript(),await this.waitForWebComponent(),this.state.scriptLoaded=!0}catch(e){throw console.error("Failed to load Connect script:",e),e}}createWebComponent(){const e=document.createElement(this.webComponentTag);return Object.entries(this.config).forEach(([i,t])=>{t&&(e[i]=t)}),e}}r.ErrorCode=void 0,(function(s){s.NETWORK_ERROR="network_error",s.AUTH_ERROR="auth_error",s.NOT_FOUND_ERROR="not_found_error",s.VALIDATION_ERROR="validation_error",s.SERVER_ERROR="server_error",s.CLIENT_ERROR="client_error",s.UNKNOWN_ERROR="unknown_error"})(r.ErrorCode||(r.ErrorCode={}));class a extends h{errorMessages={ALREADY_RENDERED:"CspFiatWithdrawals widget is already rendered. Call destroy() before rendering again.",NOT_RENDERED:"CspFiatWithdrawals widget is not rendered. Call render() first.",INVALID_CONTAINER:"Invalid container element provided.",SCRIPT_LOAD_FAILED:"Failed to load the Zerohash CspFiatWithdrawals script.",WEB_COMPONENT_NOT_DEFINED:"Web component is not defined. Script may not be loaded."};scriptUrls={local:"http://localhost:5173/csp-fiat-withdrawals-web/index.js",dev:"https://connect-sdk.dev.0hash.com/csp-fiat-withdrawals-web/index.js",cert:"https://sdk.sandbox.connect.xyz/csp-fiat-withdrawals-web/index.js",prod:"https://sdk.connect.xyz/csp-fiat-withdrawals-web/index.js",sandbox:"https://sdk.sandbox.connect.xyz/csp-fiat-withdrawals-web/index.js",production:"https://sdk.connect.xyz/csp-fiat-withdrawals-web/index.js"};webComponentTag="zerohash-csp-fiat-withdrawals";render(e){return super.render(e)}updateConfig(e){return super.updateConfig(e)}getConfig(){return super.getConfig()}isRendered(){return super.isRendered()}destroy(){return super.destroy()}}r.CspFiatWithdrawals=a,r.default=a,Object.defineProperties(r,{__esModule:{value:!0},[Symbol.toStringTag]:{value:"Module"}})}));
package/package.json ADDED
@@ -0,0 +1,26 @@
1
+ {
2
+ "name": "@zerohash-sdk/csp-fiat-withdrawals-js",
3
+ "version": "0.1.0",
4
+ "private": false,
5
+ "type": "module",
6
+ "main": "./dist/index.js",
7
+ "module": "./dist/index.js",
8
+ "types": "./dist/index.d.ts",
9
+ "license": "MIT",
10
+ "exports": {
11
+ "./package.json": "./package.json",
12
+ ".": {
13
+ "types": "./dist/index.d.ts",
14
+ "import": "./dist/index.js",
15
+ "require": "./dist/index.umd.js",
16
+ "default": "./dist/index.js"
17
+ }
18
+ },
19
+ "files": [
20
+ "dist",
21
+ "!**/*.tsbuildinfo"
22
+ ],
23
+ "nx": {
24
+ "name": "csp-fiat-withdrawals-js"
25
+ }
26
+ }