@vaultsandbox/client 0.5.0

package/dist/client.d.ts

@@ -0,0 +1,231 @@
+/**
+ * VaultSandboxClient - Main entry point for the SDK
+ */
+import { EventEmitter } from 'events';
+import { Inbox } from './inbox.js';
+import type { ClientConfig, CreateInboxOptions, ServerInfo, Subscription, IEmail, ExportedInboxData } from './types/index.js';
+/**
+ * An event emitter for monitoring multiple inboxes simultaneously.
+ * @emits email - When a new email arrives in any of the monitored inboxes.
+ *
+ * @example
+ * const monitor = client.monitorInboxes([inbox1, inbox2]);
+ * monitor.on('email', (inbox, email) => {
+ *  console.log(`New email in ${inbox.emailAddress}: ${email.subject}`);
+ * });
+ * // To stop monitoring:
+ * monitor.unsubscribe();
+ */
+export declare class InboxMonitor extends EventEmitter {
+    private subscriptions;
+    /**
+     * @internal
+     * Adds a subscription to the monitor.
+     * @param subscription - The subscription to add.
+     */
+    addSubscription(subscription: Subscription): void;
+    /**
+     * Unsubscribes from all monitored inboxes and cleans up resources.
+     */
+    unsubscribe(): void;
+    /**
+     * @internal
+     * Emits an 'email' event for a specific inbox.
+     * @param inbox - The inbox that received the email.
+     * @param email - The email that was received.
+     */
+    emitEmail(inbox: Inbox, email: IEmail): void;
+}
+/**
+ * The main client for interacting with the VaultSandbox API.
+ *
+ * This class provides methods for creating and managing inboxes,
+ * as well as for monitoring them for new emails.
+ */
+export declare class VaultSandboxClient {
+    private apiClient;
+    private config;
+    private serverPublicKey;
+    private inboxes;
+    private strategy;
+    /**
+     * Creates a new VaultSandboxClient instance.
+     * @param config - The client configuration.
+     */
+    constructor(config: ClientConfig);
+    /**
+     * Initializes the client by fetching server info and creating a delivery strategy.
+     * This method is called automatically when needed and should not be called directly.
+     * @private
+     */
+    private ensureInitialized;
+    /**
+     * Creates the appropriate delivery strategy based on configuration.
+     * SSE for email events (/api/events) is always available on the server.
+     * @private
+     */
+    private createStrategy;
+    /**
+     * Creates a new, temporary email inbox.
+     *
+     * This method generates a new quantum-safe keypair, registers the inbox
+     * with the VaultSandbox server, and returns an `Inbox` instance.
+     *
+     * @param options - Optional parameters for inbox creation.
+     * @returns A promise that resolves to a new `Inbox` instance.
+     * @example
+     * const inbox = await client.createInbox({ ttl: 3600 }); // Inbox expires in 1 hour
+     */
+    createInbox(options?: CreateInboxOptions): Promise<Inbox>;
+    /**
+     * Deletes all inboxes associated with the current API key.
+     *
+     * @returns A promise that resolves to the number of inboxes deleted.
+     */
+    deleteAllInboxes(): Promise<number>;
+    /**
+     * Retrieves information about the VaultSandbox server.
+     *
+     * @returns A promise that resolves to the server information.
+     */
+    getServerInfo(): Promise<ServerInfo>;
+    /**
+     * Checks if the configured API key is valid.
+     *
+     * @returns A promise that resolves to `true` if the API key is valid, `false` otherwise.
+     */
+    checkKey(): Promise<boolean>;
+    /**
+     * Monitors multiple inboxes simultaneously for new emails.
+     *
+     * @param inboxes - An array of `Inbox` instances to monitor.
+     * @returns An `InboxMonitor` instance that emits 'email' events.
+     */
+    monitorInboxes(inboxes: Inbox[]): InboxMonitor;
+    /**
+     * Exports an inbox's data for backup or sharing purposes.
+     *
+     * @param inboxOrEmail - Either an Inbox instance or an email address string
+     * @returns The exported inbox data containing all necessary information to import the inbox
+     * @throws {InboxNotFoundError} If the inbox is not found in the client
+     * @example
+     * const exportedData = client.exportInbox(inbox);
+     * // or
+     * const exportedData = client.exportInbox('test@example.com');
+     */
+    exportInbox(inboxOrEmail: Inbox | string): ExportedInboxData;
+    /**
+     * Imports an inbox from exported data.
+     *
+     * @param data - The exported inbox data
+     * @returns A promise that resolves to the imported Inbox instance
+     * @throws {InvalidImportDataError} If the data is invalid or malformed
+     * @throws {InboxAlreadyExistsError} If an inbox with this email already exists
+     * @example
+     * const importedInbox = await client.importInbox(exportedData);
+     */
+    importInbox(data: ExportedInboxData): Promise<Inbox>;
+    /**
+     * Validates that all required fields are present and non-empty in the exported inbox data.
+     * @private
+     * @param data - The exported inbox data to validate
+     * @throws {InvalidImportDataError} If any required field is missing, not a string, or empty
+     */
+    private validateRequiredFields;
+    /**
+     * Ensures the public key is present in the exported data, deriving it from the secret key if necessary.
+     * In ML-KEM (Kyber), the public key is embedded in the secret key, so we can extract it if missing.
+     * @private
+     * @param data - The exported inbox data (will be mutated to add publicKeyB64 if missing)
+     * @throws {InvalidImportDataError} If the secret key is invalid or derivation fails
+     */
+    private ensurePublicKeyPresent;
+    /**
+     * Validates that the timestamp fields contain valid ISO 8601 date strings.
+     * @private
+     * @param data - The exported inbox data containing timestamps to validate
+     * @throws {InvalidImportDataError} If either timestamp is not a valid date format
+     */
+    private validateTimestamps;
+    /**
+     * Checks that an inbox with the given email address is not already tracked by this client.
+     * @private
+     * @param emailAddress - The email address to check
+     * @throws {InboxAlreadyExistsError} If an inbox with this email address already exists
+     */
+    private checkInboxDoesNotExist;
+    /**
+     * Validates that the server public key in the exported data matches the current server's key.
+     * This prevents importing inboxes that were created for a different VaultSandbox server.
+     * @private
+     * @param serverSigPk - The server public key from the exported data
+     * @throws {InvalidImportDataError} If the server public keys don't match
+     */
+    private validateServerPublicKey;
+    /**
+     * Decodes the cryptographic keys from base64 and validates their lengths.
+     * @private
+     * @param data - The exported inbox data containing base64-encoded keys
+     * @returns A keypair object with decoded keys and base64url-encoded public key
+     * @throws {InvalidImportDataError} If keys cannot be decoded or have invalid lengths
+     */
+    private decodeAndValidateKeys;
+    /**
+     * Decodes a base64-encoded cryptographic key to a byte array.
+     * @private
+     * @param keyB64 - The base64-encoded key string
+     * @param keyType - The type of key (e.g., 'public', 'secret') for error messages
+     * @returns The decoded key as a Uint8Array
+     * @throws {InvalidImportDataError} If the base64 string is malformed
+     */
+    private decodeBase64Key;
+    /**
+     * Validates that a cryptographic key has the expected byte length.
+     * @private
+     * @param key - The decoded key to validate
+     * @param expectedLength - The expected length in bytes
+     * @param keyType - The type of key (e.g., 'public', 'secret') for error messages
+     * @throws {InvalidImportDataError} If the key length doesn't match the expected length
+     */
+    private validateKeyLength;
+    /**
+     * Constructs an InboxData object from exported data.
+     * @private
+     * @param data - The exported inbox data
+     * @returns An InboxData object ready for creating an Inbox instance
+     */
+    private buildInboxData;
+    /**
+     * Creates a new Inbox instance, configures it with the delivery strategy, and adds it to tracking.
+     * @private
+     * @param inboxData - The inbox metadata
+     * @param keypair - The cryptographic keypair for the inbox
+     * @returns The newly created and tracked Inbox instance
+     */
+    private createAndTrackInbox;
+    /**
+     * Exports an inbox to a JSON file.
+     *
+     * @param inboxOrEmail - Either an Inbox instance or an email address string
+     * @param filePath - The path where the file should be written
+     * @throws {InboxNotFoundError} If the inbox is not found in the client
+     * @example
+     * await client.exportInboxToFile(inbox, './inbox-backup.json');
+     */
+    exportInboxToFile(inboxOrEmail: Inbox | string, filePath: string): Promise<void>;
+    /**
+     * Imports an inbox from a JSON file.
+     *
+     * @param filePath - The path to the exported inbox JSON file
+     * @returns A promise that resolves to the imported Inbox instance
+     * @throws {InvalidImportDataError} If the file cannot be read or parsed
+     * @throws {InboxAlreadyExistsError} If an inbox with this email already exists
+     * @example
+     * const importedInbox = await client.importInboxFromFile('./inbox-backup.json');
+     */
+    importInboxFromFile(filePath: string): Promise<Inbox>;
+    /**
+     * Closes the client, terminates any active connections, and cleans up resources.
+     */
+    close(): Promise<void>;
+}

package/dist/client.js

@@ -0,0 +1,432 @@
+/**
+ * VaultSandboxClient - Main entry point for the SDK
+ */
+import { EventEmitter } from 'events';
+import { readFile, writeFile } from 'fs/promises';
+import createDebug from 'debug';
+import { ApiClient } from './http/api-client.js';
+import { Inbox } from './inbox.js';
+import { generateKeypair, PUBLIC_KEY_SIZE, SECRET_KEY_SIZE, derivePublicKeyFromSecret } from './crypto/keypair.js';
+import { toBase64Url, toBase64, fromBase64 } from './crypto/utils.js';
+import { SSEStrategy } from './strategies/sse-strategy.js';
+import { PollingStrategy } from './strategies/polling-strategy.js';
+import { InboxNotFoundError, InboxAlreadyExistsError, InvalidImportDataError, StrategyError } from './types/index.js';
+const debug = createDebug('vaultsandbox:client');
+/**
+ * An event emitter for monitoring multiple inboxes simultaneously.
+ * @emits email - When a new email arrives in any of the monitored inboxes.
+ *
+ * @example
+ * const monitor = client.monitorInboxes([inbox1, inbox2]);
+ * monitor.on('email', (inbox, email) => {
+ *  console.log(`New email in ${inbox.emailAddress}: ${email.subject}`);
+ * });
+ * // To stop monitoring:
+ * monitor.unsubscribe();
+ */
+export class InboxMonitor extends EventEmitter {
+    subscriptions = [];
+    /**
+     * @internal
+     * Adds a subscription to the monitor.
+     * @param subscription - The subscription to add.
+     */
+    addSubscription(subscription) {
+        this.subscriptions.push(subscription);
+    }
+    /**
+     * Unsubscribes from all monitored inboxes and cleans up resources.
+     */
+    unsubscribe() {
+        this.subscriptions.forEach((sub) => sub.unsubscribe());
+        this.subscriptions = [];
+        this.removeAllListeners();
+    }
+    /**
+     * @internal
+     * Emits an 'email' event for a specific inbox.
+     * @param inbox - The inbox that received the email.
+     * @param email - The email that was received.
+     */
+    emitEmail(inbox, email) {
+        this.emit('email', inbox, email);
+    }
+}
+/**
+ * The main client for interacting with the VaultSandbox API.
+ *
+ * This class provides methods for creating and managing inboxes,
+ * as well as for monitoring them for new emails.
+ */
+export class VaultSandboxClient {
+    apiClient;
+    config;
+    serverPublicKey = null;
+    inboxes = new Map();
+    strategy = null;
+    /**
+     * Creates a new VaultSandboxClient instance.
+     * @param config - The client configuration.
+     */
+    constructor(config) {
+        this.config = config;
+        this.apiClient = new ApiClient(config);
+    }
+    /**
+     * Initializes the client by fetching server info and creating a delivery strategy.
+     * This method is called automatically when needed and should not be called directly.
+     * @private
+     */
+    async ensureInitialized() {
+        if (this.serverPublicKey) {
+            return;
+        }
+        const serverInfo = await this.apiClient.getServerInfo();
+        this.serverPublicKey = serverInfo.serverSigPk;
+        // Create delivery strategy based on config
+        // Note: SSE for email events (/api/events) is always available
+        this.strategy = this.createStrategy();
+    }
+    /**
+     * Creates the appropriate delivery strategy based on configuration.
+     * SSE for email events (/api/events) is always available on the server.
+     * @private
+     */
+    createStrategy() {
+        const strategyType = this.config.strategy ?? 'auto';
+        // SSE strategy (default for 'auto' and 'sse')
+        if (strategyType === 'sse' || strategyType === 'auto') {
+            debug('Using SSE strategy for real-time delivery');
+            return new SSEStrategy(this.apiClient, {
+                url: this.config.url,
+                apiKey: this.config.apiKey,
+                reconnectInterval: this.config.sseReconnectInterval ?? 5000,
+                maxReconnectAttempts: this.config.sseMaxReconnectAttempts ?? 10,
+                backoffMultiplier: 2,
+            });
+        }
+        // Polling strategy (explicit only)
+        debug('Using polling strategy');
+        return new PollingStrategy(this.apiClient, {
+            initialInterval: this.config.pollingInterval ?? 2000,
+            maxBackoff: 30000,
+            backoffMultiplier: 1.5,
+            jitterFactor: 0.3,
+        });
+    }
+    /**
+     * Creates a new, temporary email inbox.
+     *
+     * This method generates a new quantum-safe keypair, registers the inbox
+     * with the VaultSandbox server, and returns an `Inbox` instance.
+     *
+     * @param options - Optional parameters for inbox creation.
+     * @returns A promise that resolves to a new `Inbox` instance.
+     * @example
+     * const inbox = await client.createInbox({ ttl: 3600 }); // Inbox expires in 1 hour
+     */
+    async createInbox(options = {}) {
+        await this.ensureInitialized();
+        // Generate keypair
+        const keypair = generateKeypair();
+        // Create inbox on server
+        const inboxData = await this.apiClient.createInbox(keypair.publicKeyB64, options.ttl, options.emailAddress);
+        // Create Inbox instance (use serverSigPk from response)
+        const inbox = new Inbox(inboxData, keypair, this.apiClient, inboxData.serverSigPk);
+        // Set delivery strategy
+        if (this.strategy) {
+            inbox.setStrategy(this.strategy);
+        }
+        // Track inbox
+        this.inboxes.set(inbox.emailAddress, inbox);
+        return inbox;
+    }
+    /**
+     * Deletes all inboxes associated with the current API key.
+     *
+     * @returns A promise that resolves to the number of inboxes deleted.
+     */
+    async deleteAllInboxes() {
+        const result = await this.apiClient.deleteAllInboxes();
+        this.inboxes.clear();
+        return result.deleted;
+    }
+    /**
+     * Retrieves information about the VaultSandbox server.
+     *
+     * @returns A promise that resolves to the server information.
+     */
+    async getServerInfo() {
+        return this.apiClient.getServerInfo();
+    }
+    /**
+     * Checks if the configured API key is valid.
+     *
+     * @returns A promise that resolves to `true` if the API key is valid, `false` otherwise.
+     */
+    async checkKey() {
+        return this.apiClient.checkKey();
+    }
+    /**
+     * Monitors multiple inboxes simultaneously for new emails.
+     *
+     * @param inboxes - An array of `Inbox` instances to monitor.
+     * @returns An `InboxMonitor` instance that emits 'email' events.
+     */
+    monitorInboxes(inboxes) {
+        if (!this.strategy) {
+            throw new StrategyError('No delivery strategy available. Client not initialized.');
+        }
+        const monitor = new InboxMonitor();
+        // Subscribe to each inbox
+        for (const inbox of inboxes) {
+            const subscription = inbox.onNewEmail((email) => {
+                monitor.emitEmail(inbox, email);
+            });
+            monitor.addSubscription(subscription);
+        }
+        return monitor;
+    }
+    /**
+     * Exports an inbox's data for backup or sharing purposes.
+     *
+     * @param inboxOrEmail - Either an Inbox instance or an email address string
+     * @returns The exported inbox data containing all necessary information to import the inbox
+     * @throws {InboxNotFoundError} If the inbox is not found in the client
+     * @example
+     * const exportedData = client.exportInbox(inbox);
+     * // or
+     * const exportedData = client.exportInbox('test@example.com');
+     */
+    exportInbox(inboxOrEmail) {
+        // Get the inbox instance
+        const emailAddress = typeof inboxOrEmail === 'string' ? inboxOrEmail : inboxOrEmail.emailAddress;
+        const inbox = this.inboxes.get(emailAddress);
+        if (!inbox) {
+            throw new InboxNotFoundError(`Inbox not found: ${emailAddress}`);
+        }
+        return inbox.export();
+    }
+    /**
+     * Imports an inbox from exported data.
+     *
+     * @param data - The exported inbox data
+     * @returns A promise that resolves to the imported Inbox instance
+     * @throws {InvalidImportDataError} If the data is invalid or malformed
+     * @throws {InboxAlreadyExistsError} If an inbox with this email already exists
+     * @example
+     * const importedInbox = await client.importInbox(exportedData);
+     */
+    async importInbox(data) {
+        this.validateRequiredFields(data);
+        this.ensurePublicKeyPresent(data);
+        this.validateTimestamps(data);
+        this.checkInboxDoesNotExist(data.emailAddress);
+        await this.ensureInitialized();
+        this.validateServerPublicKey(data.serverSigPk);
+        const keypair = this.decodeAndValidateKeys(data);
+        const inboxData = this.buildInboxData(data);
+        return this.createAndTrackInbox(inboxData, keypair);
+    }
+    /**
+     * Validates that all required fields are present and non-empty in the exported inbox data.
+     * @private
+     * @param data - The exported inbox data to validate
+     * @throws {InvalidImportDataError} If any required field is missing, not a string, or empty
+     */
+    validateRequiredFields(data) {
+        const requiredFields = [
+            'emailAddress',
+            'expiresAt',
+            'inboxHash',
+            'serverSigPk',
+            'secretKeyB64',
+            'exportedAt',
+        ];
+        for (const field of requiredFields) {
+            if (!data[field] || typeof data[field] !== 'string' || data[field].trim() === '') {
+                throw new InvalidImportDataError(`Missing or invalid field: ${field}`);
+            }
+        }
+    }
+    /**
+     * Ensures the public key is present in the exported data, deriving it from the secret key if necessary.
+     * In ML-KEM (Kyber), the public key is embedded in the secret key, so we can extract it if missing.
+     * @private
+     * @param data - The exported inbox data (will be mutated to add publicKeyB64 if missing)
+     * @throws {InvalidImportDataError} If the secret key is invalid or derivation fails
+     */
+    ensurePublicKeyPresent(data) {
+        if (data.publicKeyB64) {
+            return;
+        }
+        try {
+            const secretKeyBytes = fromBase64(data.secretKeyB64);
+            const publicKeyBytes = derivePublicKeyFromSecret(secretKeyBytes);
+            data.publicKeyB64 = toBase64(publicKeyBytes);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new InvalidImportDataError(`Failed to derive public key from secret key: ${message}`);
+        }
+    }
+    /**
+     * Validates that the timestamp fields contain valid ISO 8601 date strings.
+     * @private
+     * @param data - The exported inbox data containing timestamps to validate
+     * @throws {InvalidImportDataError} If either timestamp is not a valid date format
+     */
+    validateTimestamps(data) {
+        try {
+            new Date(data.expiresAt).toISOString();
+            new Date(data.exportedAt).toISOString();
+        }
+        catch {
+            throw new InvalidImportDataError('Invalid timestamp format');
+        }
+    }
+    /**
+     * Checks that an inbox with the given email address is not already tracked by this client.
+     * @private
+     * @param emailAddress - The email address to check
+     * @throws {InboxAlreadyExistsError} If an inbox with this email address already exists
+     */
+    checkInboxDoesNotExist(emailAddress) {
+        if (this.inboxes.has(emailAddress)) {
+            throw new InboxAlreadyExistsError(`Inbox already exists: ${emailAddress}`);
+        }
+    }
+    /**
+     * Validates that the server public key in the exported data matches the current server's key.
+     * This prevents importing inboxes that were created for a different VaultSandbox server.
+     * @private
+     * @param serverSigPk - The server public key from the exported data
+     * @throws {InvalidImportDataError} If the server public keys don't match
+     */
+    validateServerPublicKey(serverSigPk) {
+        if (serverSigPk !== this.serverPublicKey) {
+            throw new InvalidImportDataError('Server public key mismatch. This inbox was created for a different server.');
+        }
+    }
+    /**
+     * Decodes the cryptographic keys from base64 and validates their lengths.
+     * @private
+     * @param data - The exported inbox data containing base64-encoded keys
+     * @returns A keypair object with decoded keys and base64url-encoded public key
+     * @throws {InvalidImportDataError} If keys cannot be decoded or have invalid lengths
+     */
+    decodeAndValidateKeys(data) {
+        const publicKey = this.decodeBase64Key(data.publicKeyB64, 'public');
+        const secretKey = this.decodeBase64Key(data.secretKeyB64, 'secret');
+        this.validateKeyLength(publicKey, PUBLIC_KEY_SIZE, 'public');
+        this.validateKeyLength(secretKey, SECRET_KEY_SIZE, 'secret');
+        return {
+            publicKey,
+            secretKey,
+            publicKeyB64: toBase64Url(publicKey),
+        };
+    }
+    /**
+     * Decodes a base64-encoded cryptographic key to a byte array.
+     * @private
+     * @param keyB64 - The base64-encoded key string
+     * @param keyType - The type of key (e.g., 'public', 'secret') for error messages
+     * @returns The decoded key as a Uint8Array
+     * @throws {InvalidImportDataError} If the base64 string is malformed
+     */
+    decodeBase64Key(keyB64, keyType) {
+        try {
+            return fromBase64(keyB64);
+        }
+        catch {
+            throw new InvalidImportDataError(`Invalid base64 encoding in ${keyType} key`);
+        }
+    }
+    /**
+     * Validates that a cryptographic key has the expected byte length.
+     * @private
+     * @param key - The decoded key to validate
+     * @param expectedLength - The expected length in bytes
+     * @param keyType - The type of key (e.g., 'public', 'secret') for error messages
+     * @throws {InvalidImportDataError} If the key length doesn't match the expected length
+     */
+    validateKeyLength(key, expectedLength, keyType) {
+        if (key.length !== expectedLength) {
+            throw new InvalidImportDataError(`Invalid ${keyType} key length: expected ${expectedLength}, got ${key.length}`);
+        }
+    }
+    /**
+     * Constructs an InboxData object from exported data.
+     * @private
+     * @param data - The exported inbox data
+     * @returns An InboxData object ready for creating an Inbox instance
+     */
+    buildInboxData(data) {
+        return {
+            emailAddress: data.emailAddress,
+            expiresAt: data.expiresAt,
+            inboxHash: data.inboxHash,
+            serverSigPk: data.serverSigPk,
+        };
+    }
+    /**
+     * Creates a new Inbox instance, configures it with the delivery strategy, and adds it to tracking.
+     * @private
+     * @param inboxData - The inbox metadata
+     * @param keypair - The cryptographic keypair for the inbox
+     * @returns The newly created and tracked Inbox instance
+     */
+    createAndTrackInbox(inboxData, keypair) {
+        const inbox = new Inbox(inboxData, keypair, this.apiClient, inboxData.serverSigPk);
+        if (this.strategy) {
+            inbox.setStrategy(this.strategy);
+        }
+        this.inboxes.set(inbox.emailAddress, inbox);
+        return inbox;
+    }
+    /**
+     * Exports an inbox to a JSON file.
+     *
+     * @param inboxOrEmail - Either an Inbox instance or an email address string
+     * @param filePath - The path where the file should be written
+     * @throws {InboxNotFoundError} If the inbox is not found in the client
+     * @example
+     * await client.exportInboxToFile(inbox, './inbox-backup.json');
+     */
+    async exportInboxToFile(inboxOrEmail, filePath) {
+        const data = this.exportInbox(inboxOrEmail);
+        const json = JSON.stringify(data, null, 2);
+        await writeFile(filePath, json, 'utf-8');
+    }
+    /**
+     * Imports an inbox from a JSON file.
+     *
+     * @param filePath - The path to the exported inbox JSON file
+     * @returns A promise that resolves to the imported Inbox instance
+     * @throws {InvalidImportDataError} If the file cannot be read or parsed
+     * @throws {InboxAlreadyExistsError} If an inbox with this email already exists
+     * @example
+     * const importedInbox = await client.importInboxFromFile('./inbox-backup.json');
+     */
+    async importInboxFromFile(filePath) {
+        let data;
+        try {
+            const fileContents = await readFile(filePath, 'utf-8');
+            data = JSON.parse(fileContents);
+        }
+        catch (error) {
+            throw new InvalidImportDataError(`Failed to read or parse file: ${error instanceof Error ? error.message : 'Unknown error'}`);
+        }
+        return await this.importInbox(data);
+    }
+    /**
+     * Closes the client, terminates any active connections, and cleans up resources.
+     */
+    async close() {
+        if (this.strategy) {
+            this.strategy.close();
+        }
+        this.inboxes.clear();
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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