pepay 0.7.0

package/dist/esm/ws/pepayEventStream.js

@@ -0,0 +1,233 @@
+import { EventEmitter } from './eventEmitter.js';
+/**
+ * PepayEventStream wraps a websocket stream with REST backfill, buffering, and dedupe.
+ */
+export class PepayEventStream extends EventEmitter {
+    constructor(options) {
+        super();
+        this.bufferedEvents = [];
+        this.recovering = false;
+        this.attached = false;
+        this.dedupeSet = new Set();
+        this.dedupeQueue = [];
+        this.socket = options.socket;
+        this.events = options.events;
+        this.params = options.params;
+        this.recovery = options.recovery;
+    }
+    connect() {
+        if (!this.attached) {
+            this.attachSocketHandlers();
+        }
+        void this.bootstrap();
+    }
+    close(code, reason) {
+        this.socket.close(code, reason);
+    }
+    getLastEventId() {
+        return this.lastEventId || this.socket.getLastEventId();
+    }
+    resumeFrom(eventId) {
+        this.lastEventId = eventId;
+        this.socket.setLastEventId(eventId);
+        this.socket.resumeFrom(eventId);
+    }
+    attachSocketHandlers() {
+        this.attached = true;
+        this.socket.on('open', (event) => {
+            this.emit('open', event);
+            void this.maybeRecover();
+        });
+        this.socket.on('close', (event) => this.emit('close', event));
+        this.socket.on('error', (event) => this.emit('error', event));
+        this.socket.on('message', (payload) => this.emit('message', payload));
+        this.socket.on('control', (payload) => this.emit('control', payload));
+        this.socket.on('event', (payload) => this.handleSocketEvent(payload));
+    }
+    async bootstrap() {
+        const cursor = await this.resolveInitialCursor();
+        if (cursor) {
+            this.lastEventId = cursor;
+            this.socket.setLastEventId(cursor);
+        }
+        this.socket.connect();
+    }
+    async resolveInitialCursor() {
+        if (this.recovery?.lastEventId)
+            return this.recovery.lastEventId;
+        const store = this.recovery?.cursorStore;
+        if (store?.load) {
+            try {
+                const stored = await store.load();
+                if (stored)
+                    return stored;
+            }
+            catch (err) {
+                this.recovery?.onRecoveryError?.(err);
+            }
+        }
+        return this.socket.getLastEventId();
+    }
+    handleSocketEvent(event) {
+        if (event?.id) {
+            this.lastEventId = event.id;
+            this.socket.setLastEventId(event.id);
+        }
+        const shouldBuffer = this.recovering && (this.recovery?.bufferWhileBackfill ?? true);
+        if (shouldBuffer) {
+            this.bufferedEvents.push(event);
+            return;
+        }
+        this.emitEvent(event);
+    }
+    async maybeRecover() {
+        if (this.recovery?.enabled === false)
+            return;
+        if (this.recovering)
+            return;
+        const sinceEventId = this.lastEventId || this.socket.getLastEventId();
+        if (!sinceEventId)
+            return;
+        this.recovering = true;
+        this.recovery?.onBackfillStart?.({ sinceEventId });
+        try {
+            const listParams = this.buildListParams();
+            const recoverPromise = this.events.recoverSince(sinceEventId, listParams, {
+                limit: this.recovery?.limit,
+                maxPages: this.recovery?.maxPages,
+                maxEvents: this.recovery?.maxEvents,
+                request: this.recovery?.request,
+                onPage: this.recovery?.onPage
+            });
+            const timeoutMs = this.recovery?.timeoutMs ?? 30000;
+            const recovered = await this.withTimeout(recoverPromise, timeoutMs);
+            for (const event of recovered) {
+                if (!this.matchesRecoveryFilters(event))
+                    continue;
+                this.emitEvent(event);
+            }
+            this.recovery?.onBackfillComplete?.({ recovered: recovered.length });
+        }
+        catch (err) {
+            this.recovery?.onRecoveryError?.(err);
+            this.emit('error', err);
+        }
+        finally {
+            this.recovering = false;
+            this.flushBufferedEvents();
+        }
+    }
+    buildListParams() {
+        const recoveryParams = this.recovery?.listParams || {};
+        const params = this.params || {};
+        const listParams = { ...recoveryParams };
+        const type = typeof params.type === 'string' ? params.type : undefined;
+        const types = typeof params.types === 'string' ? params.types : undefined;
+        if (!listParams.type && (type || types)) {
+            listParams.type = type || types;
+        }
+        const passthroughKeys = ['invoice_id', 'order_id', 'customer_id', 'environment'];
+        for (const key of passthroughKeys) {
+            if (listParams[key] === undefined && params[key] !== undefined) {
+                listParams[key] = params[key];
+            }
+        }
+        return Object.keys(listParams).length ? listParams : undefined;
+    }
+    matchesRecoveryFilters(event) {
+        if (this.recovery?.filter && !this.recovery.filter(event)) {
+            return false;
+        }
+        const params = this.params || {};
+        const invoiceType = typeof params.invoice_type === 'string' ? params.invoice_type : undefined;
+        const walletAddress = typeof params.wallet_address === 'string' ? params.wallet_address : undefined;
+        const walletNetwork = typeof params.wallet_network === 'string' ? params.wallet_network : undefined;
+        if (!invoiceType && !walletAddress && !walletNetwork) {
+            return true;
+        }
+        const dataObject = event?.data?.object;
+        const nestedInvoice = dataObject?.invoice;
+        const nestedWallet = dataObject?.wallet;
+        if (invoiceType) {
+            const candidate = dataObject?.invoice_type ?? nestedInvoice?.invoice_type;
+            if (typeof candidate === 'string' && candidate !== invoiceType)
+                return false;
+        }
+        if (walletAddress) {
+            const candidate = dataObject?.wallet_address ?? nestedWallet?.address;
+            if (typeof candidate === 'string' && candidate.toLowerCase() !== walletAddress.toLowerCase())
+                return false;
+        }
+        if (walletNetwork) {
+            const candidate = dataObject?.wallet_network ?? nestedWallet?.network;
+            if (typeof candidate === 'string' && candidate !== walletNetwork)
+                return false;
+        }
+        return true;
+    }
+    emitEvent(event) {
+        const eventId = event?.id;
+        if (eventId) {
+            this.lastEventId = eventId;
+            this.socket.setLastEventId(eventId);
+        }
+        if (eventId && (this.recovery?.dedupe ?? true)) {
+            if (!this.registerDedupe(eventId))
+                return;
+        }
+        this.emit('event', event);
+        if (eventId) {
+            const store = this.recovery?.cursorStore;
+            if (store?.save) {
+                try {
+                    void Promise.resolve(store.save(eventId)).catch(() => {
+                        // ignore cursor store failures
+                    });
+                }
+                catch {
+                    // ignore cursor store failures
+                }
+            }
+        }
+    }
+    registerDedupe(eventId) {
+        if (this.dedupeSet.has(eventId))
+            return false;
+        this.dedupeSet.add(eventId);
+        this.dedupeQueue.push(eventId);
+        const maxSize = this.recovery?.dedupeWindowSize ?? 10000;
+        if (this.dedupeQueue.length > maxSize) {
+            const removed = this.dedupeQueue.shift();
+            if (removed)
+                this.dedupeSet.delete(removed);
+        }
+        return true;
+    }
+    flushBufferedEvents() {
+        if (!this.bufferedEvents.length)
+            return;
+        const buffered = this.bufferedEvents;
+        this.bufferedEvents = [];
+        for (const event of buffered) {
+            this.emitEvent(event);
+        }
+    }
+    async withTimeout(promise, timeoutMs) {
+        if (!timeoutMs || timeoutMs <= 0)
+            return promise;
+        let timeoutId;
+        const timeoutPromise = new Promise((_, reject) => {
+            timeoutId = setTimeout(() => {
+                reject(new Error('Event recovery timed out'));
+            }, timeoutMs);
+        });
+        try {
+            return await Promise.race([promise, timeoutPromise]);
+        }
+        finally {
+            if (timeoutId)
+                clearTimeout(timeoutId);
+        }
+    }
+}
+//# sourceMappingURL=pepayEventStream.js.map

package/dist/esm/ws/pepayEventStream.js.map

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

package/dist/esm/ws/pepayWebSocket.d.ts

@@ -0,0 +1,37 @@
+import { EventEmitter } from './eventEmitter.js';
+import { PepayRetryConfig, PepayWsEvents } from '../types.js';
+export interface PepayWebSocketOptions {
+    createUrl: (since?: string) => string;
+    webSocketFactory: typeof WebSocket;
+    headers?: Record<string, string>;
+    protocols?: string | string[];
+    autoReconnect?: boolean;
+    autoReplay?: boolean;
+    retry?: PepayRetryConfig;
+    heartbeatMs?: number;
+    idleTimeoutMs?: number;
+    pingMessage?: string;
+}
+export declare class PepayWebSocket extends EventEmitter<PepayWsEvents> {
+    private options;
+    private ws?;
+    private closedByUser;
+    private reconnectAttempts;
+    private lastEventId?;
+    private lastMessageAt;
+    private heartbeatTimer?;
+    private idleTimer?;
+    constructor(options: PepayWebSocketOptions);
+    connect(): void;
+    close(code?: number, reason?: string): void;
+    getLastEventId(): string | undefined;
+    /**
+     * Updates the replay cursor used for auto-replay connections.
+     */
+    setLastEventId(eventId?: string): void;
+    resumeFrom(eventId: string): void;
+    private scheduleReconnect;
+    private startLivenessTimers;
+    private stopLivenessTimers;
+}
+//# sourceMappingURL=pepayWebSocket.d.ts.map

package/dist/esm/ws/pepayWebSocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pepayWebSocket.d.ts","sourceRoot":"","sources":["../../../src/ws/pepayWebSocket.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,WAAW,qBAAqB;IACpC,SAAS,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,MAAM,CAAC;IACtC,gBAAgB,EAAE,OAAO,SAAS,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC9B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,gBAAgB,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,cAAe,SAAQ,YAAY,CAAC,aAAa,CAAC;IAC7D,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,EAAE,CAAC,CAAY;IACvB,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,cAAc,CAAC,CAAS;IAChC,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,OAAO,EAAE,qBAAqB;IAK1C,OAAO,IAAI,IAAI;IAkDf,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAM3C,cAAc,IAAI,MAAM,GAAG,SAAS;IAIpC;;OAEG;IACH,cAAc,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAItC,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAUjC,OAAO,CAAC,iBAAiB;IAMzB,OAAO,CAAC,mBAAmB;IA0B3B,OAAO,CAAC,kBAAkB;CAM3B"}

package/dist/esm/ws/pepayWebSocket.js

@@ -0,0 +1,122 @@
+import { EventEmitter } from './eventEmitter.js';
+import { getRetryDelay } from '../utils.js';
+export class PepayWebSocket extends EventEmitter {
+    constructor(options) {
+        super();
+        this.closedByUser = false;
+        this.reconnectAttempts = 0;
+        this.lastMessageAt = 0;
+        this.options = options;
+    }
+    connect() {
+        this.closedByUser = false;
+        const url = this.options.createUrl(this.options.autoReplay ? this.lastEventId : undefined);
+        const ws = new this.options.webSocketFactory(url, this.options.protocols);
+        this.ws = ws;
+        ws.onopen = (event) => {
+            this.reconnectAttempts = 0;
+            this.lastMessageAt = Date.now();
+            this.startLivenessTimers();
+            this.emit('open', event);
+        };
+        ws.onmessage = (event) => {
+            this.lastMessageAt = Date.now();
+            let payload = event.data;
+            try {
+                if (typeof event.data === 'string') {
+                    payload = JSON.parse(event.data);
+                }
+            }
+            catch {
+                // leave as raw string
+            }
+            this.emit('message', payload);
+            if (payload && typeof payload === 'object') {
+                const obj = payload;
+                if (typeof obj.id === 'string') {
+                    this.lastEventId = obj.id;
+                }
+                if (obj.object === 'event' && typeof obj.id === 'string' && typeof obj.type === 'string') {
+                    this.emit('event', obj);
+                }
+                else if (obj.object === 'ws_control') {
+                    this.emit('control', obj);
+                }
+            }
+        };
+        ws.onerror = (event) => {
+            this.emit('error', event);
+        };
+        ws.onclose = (event) => {
+            this.stopLivenessTimers();
+            this.emit('close', event);
+            if (this.closedByUser)
+                return;
+            if (!this.options.autoReconnect)
+                return;
+            this.scheduleReconnect();
+        };
+    }
+    close(code, reason) {
+        this.closedByUser = true;
+        this.stopLivenessTimers();
+        this.ws?.close(code, reason);
+    }
+    getLastEventId() {
+        return this.lastEventId;
+    }
+    /**
+     * Updates the replay cursor used for auto-replay connections.
+     */
+    setLastEventId(eventId) {
+        this.lastEventId = eventId;
+    }
+    resumeFrom(eventId) {
+        this.lastEventId = eventId;
+        this.closedByUser = false;
+        if (this.ws && this.ws.readyState === WebSocket.OPEN) {
+            this.ws.close(4001, 'resume');
+            return;
+        }
+        this.connect();
+    }
+    scheduleReconnect() {
+        this.reconnectAttempts += 1;
+        const delay = getRetryDelay(this.reconnectAttempts, this.options.retry, undefined);
+        setTimeout(() => this.connect(), delay);
+    }
+    startLivenessTimers() {
+        this.stopLivenessTimers();
+        if (this.options.heartbeatMs && this.options.heartbeatMs > 0) {
+            this.heartbeatTimer = setInterval(() => {
+                if (!this.ws || this.ws.readyState !== WebSocket.OPEN)
+                    return;
+                const wsAny = this.ws;
+                if (typeof wsAny.ping === 'function') {
+                    wsAny.ping();
+                    return;
+                }
+                if (this.options.pingMessage) {
+                    this.ws.send(this.options.pingMessage);
+                }
+            }, this.options.heartbeatMs);
+        }
+        if (this.options.idleTimeoutMs && this.options.idleTimeoutMs > 0) {
+            this.idleTimer = setInterval(() => {
+                const now = Date.now();
+                if (now - this.lastMessageAt > (this.options.idleTimeoutMs || 0)) {
+                    this.ws?.close(4000, 'idle-timeout');
+                }
+            }, Math.max(1000, Math.floor(this.options.idleTimeoutMs / 2)));
+        }
+    }
+    stopLivenessTimers() {
+        if (this.heartbeatTimer)
+            clearInterval(this.heartbeatTimer);
+        if (this.idleTimer)
+            clearInterval(this.idleTimer);
+        this.heartbeatTimer = undefined;
+        this.idleTimer = undefined;
+    }
+}
+//# sourceMappingURL=pepayWebSocket.js.map

package/dist/esm/ws/pepayWebSocket.js.map

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

package/dist/esm/ws/wsResource.d.ts

@@ -0,0 +1,25 @@
+import { PepayHttpClient } from '../http.js';
+import { PepayWebSocket } from './pepayWebSocket.js';
+import { PepayClientConfig, PepayWsConnectOptions } from '../types.js';
+import { PepayEventStream } from './pepayEventStream.js';
+export declare class WsResource {
+    private http;
+    private config;
+    private events;
+    constructor(http: PepayHttpClient, config: PepayClientConfig);
+    updateConfig(config: PepayClientConfig): void;
+    token: {
+        mint: (payload?: {
+            scope?: "merchant" | "commerce";
+            ttlSeconds?: number;
+        }) => Promise<Record<string, unknown>>;
+    };
+    connectMerchantEvents(params?: Record<string, string | number | boolean | undefined>, options?: PepayWsConnectOptions): PepayEventStream;
+    connectCommerceEvents(params?: Record<string, string | number | boolean | undefined>, options?: PepayWsConnectOptions): PepayEventStream;
+    connectPaymentSession(params?: Record<string, string | number | boolean | undefined>): PepayWebSocket;
+    connectMerchantEventsRaw(params?: Record<string, string | number | boolean | undefined>): PepayWebSocket;
+    connectCommerceEventsRaw(params?: Record<string, string | number | boolean | undefined>): PepayWebSocket;
+    private createEventStream;
+    private createSocket;
+}
+//# sourceMappingURL=wsResource.d.ts.map

package/dist/esm/ws/wsResource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wsResource.d.ts","sourceRoot":"","sources":["../../../src/ws/wsResource.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,qBAAqB,EAA0B,MAAM,aAAa,CAAC;AAG/F,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,qBAAa,UAAU;IACrB,OAAO,CAAC,IAAI,CAAkB;IAC9B,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,MAAM,CAAiB;gBAEnB,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,iBAAiB;IAM5D,YAAY,CAAC,MAAM,EAAE,iBAAiB;IAItC,KAAK;yBACc;YAAE,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU,CAAC;YAAC,UAAU,CAAC,EAAE,MAAM,CAAA;SAAE,KAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;MAO5G;IAEF,qBAAqB,CACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,EAC9D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,gBAAgB;IAInB,qBAAqB,CACnB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,EAC9D,OAAO,CAAC,EAAE,qBAAqB,GAC9B,gBAAgB;IAInB,qBAAqB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,cAAc;IAIrG,wBAAwB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,cAAc;IAIxG,wBAAwB,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,GAAG,cAAc;IAIxG,OAAO,CAAC,iBAAiB;IA0CzB,OAAO,CAAC,YAAY;CAgCrB"}

package/dist/esm/ws/wsResource.js

@@ -0,0 +1,100 @@
+import { PepayWebSocket } from './pepayWebSocket.js';
+import { buildQuery, toWebSocketBaseUrl } from '../utils.js';
+import { EventsResource } from '../resources/events.js';
+import { PepayEventStream } from './pepayEventStream.js';
+export class WsResource {
+    constructor(http, config) {
+        this.token = {
+            mint: (payload) => {
+                const body = {};
+                if (payload?.scope)
+                    body.scope = payload.scope;
+                if (payload?.ttlSeconds)
+                    body.ttl_seconds = payload.ttlSeconds;
+                const authScope = payload?.scope === 'commerce' ? 'commerce' : payload?.scope === 'merchant' ? 'merchant' : undefined;
+                return this.http.request('POST', '/api/v1/ws/token', { body, authScope });
+            }
+        };
+        this.http = http;
+        this.config = config;
+        this.events = new EventsResource(http);
+    }
+    updateConfig(config) {
+        this.config = config;
+    }
+    connectMerchantEvents(params, options) {
+        return this.createEventStream('/ws/merchant/events', params, options);
+    }
+    connectCommerceEvents(params, options) {
+        return this.createEventStream('/ws/commerce/events', params, options);
+    }
+    connectPaymentSession(params) {
+        return this.createSocket('/ws/payment', params);
+    }
+    connectMerchantEventsRaw(params) {
+        return this.createSocket('/ws/merchant/events', params);
+    }
+    connectCommerceEventsRaw(params) {
+        return this.createSocket('/ws/commerce/events', params);
+    }
+    createEventStream(path, params, options) {
+        const socket = this.createSocket(path, params, { autoConnect: false });
+        const recovery = { ...(options?.recovery || {}) };
+        const defaultScope = path.includes('/ws/commerce') ? 'commerce' : path.includes('/ws/merchant') ? 'merchant' : undefined;
+        if (defaultScope) {
+            const request = { ...(recovery.request || {}) };
+            if (request.authScope === undefined) {
+                request.authScope = defaultScope;
+            }
+            recovery.request = request;
+        }
+        if (recovery.enabled === undefined) {
+            const hasAuth = defaultScope === 'commerce'
+                ? Boolean(recovery.request?.auth?.commerceApiKey || this.config.commerceApiKey)
+                : defaultScope === 'merchant'
+                    ? Boolean(recovery.request?.auth?.apiKey || this.config.apiKey)
+                    : Boolean(recovery.request?.auth?.apiKey ||
+                        recovery.request?.auth?.commerceApiKey ||
+                        this.config.apiKey ||
+                        this.config.commerceApiKey);
+            if (!hasAuth) {
+                recovery.enabled = false;
+            }
+        }
+        const stream = new PepayEventStream({
+            socket,
+            events: this.events,
+            params,
+            recovery
+        });
+        stream.connect();
+        return stream;
+    }
+    createSocket(path, params, options) {
+        if (!this.config.webSocketFactory) {
+            throw new Error('WebSocket implementation not available. Provide webSocketFactory in Pepay client config.');
+        }
+        const baseUrl = this.config.websocketBaseUrl || toWebSocketBaseUrl(this.config.baseUrl || '');
+        const createUrl = (since) => {
+            const query = { ...(params || {}) };
+            if (since && !query.since)
+                query.since = since;
+            return `${baseUrl}${path}${buildQuery(query)}`;
+        };
+        const socket = new PepayWebSocket({
+            createUrl,
+            webSocketFactory: this.config.webSocketFactory,
+            autoReconnect: true,
+            autoReplay: true,
+            retry: this.config.retry,
+            heartbeatMs: this.config.wsHeartbeatMs,
+            idleTimeoutMs: this.config.wsIdleTimeoutMs,
+            pingMessage: this.config.wsPingMessage
+        });
+        if (options?.autoConnect !== false) {
+            socket.connect();
+        }
+        return socket;
+    }
+}
+//# sourceMappingURL=wsResource.js.map

package/dist/esm/ws/wsResource.js.map

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

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "pepay",
+  "version": "0.7.0",
+  "description": "Pepay API wrapper for Node.js and browsers",
+  "type": "module",
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json && node scripts/rename-cjs.js",
+    "build": "npm run build:esm && npm run build:cjs",
+    "test": "TS_NODE_PROJECT=tsconfig.test.json node --loader ./node_modules/ts-node/esm.mjs ./node_modules/mocha/bin/mocha.js --timeout 1200000 \"tests/*.test.ts\"",
+    "typecheck": "tsc -p tsconfig.type-tests.json --noEmit"
+  },
+  "devDependencies": {
+    "@types/chai": "^5.0.1",
+    "@types/mocha": "^10.0.6",
+    "@types/node": "^20.14.15",
+    "chai": "^5.1.1",
+    "mocha": "^10.4.0",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.6.3"
+  }
+}