@deepgram/sdk 3.3.5 → 3.4.1

package/dist/main/packages/ListenLiveClient.d.ts

@@ -0,0 +1,58 @@
+import { AbstractLiveClient } from "./AbstractLiveClient";
+import type { LiveSchema, LiveConfigOptions, DeepgramClientOptions } from "../lib/types";
+/**
+ * The `ListenLiveClient` class extends the `AbstractLiveClient` class and provides functionality for setting up and managing a WebSocket connection for live transcription.
+ *
+ * The constructor takes in `DeepgramClientOptions` and an optional `LiveSchema` object, as well as an optional `endpoint` string. It then calls the `connect` method of the parent `AbstractLiveClient` class to establish the WebSocket connection.
+ *
+ * The `setupConnection` method is responsible for handling the various events that can occur on the WebSocket connection, such as opening, closing, and receiving messages. It sets up event handlers for these events and emits the appropriate events based on the message type.
+ *
+ * The `configure` method allows you to send additional configuration options to the connected session, such as enabling numerals.
+ *
+ * The `keepAlive` method sends a "KeepAlive" message to the server to maintain the connection.
+ *
+ * The `requestClose` method requests the server to close the connection.
+ *
+ * The `finish` method is deprecated as of version 3.4 and will be removed in version 4.0. Use `requestClose` instead.
+ */
+export declare class ListenLiveClient extends AbstractLiveClient {
+    namespace: string;
+    /**
+     * Constructs a new `ListenLiveClient` instance with the provided options.
+     *
+     * @param options - The `DeepgramClientOptions` to use for the client connection.
+     * @param transcriptionOptions - An optional `LiveSchema` object containing additional configuration options for the live transcription.
+     * @param endpoint - An optional string representing the WebSocket endpoint to connect to. Defaults to `:version/listen`.
+     */
+    constructor(options: DeepgramClientOptions, transcriptionOptions?: LiveSchema, endpoint?: string);
+    /**
+     * Sets up the connection event handlers.
+     * This method is responsible for handling the various events that can occur on the WebSocket connection, such as opening, closing, and receiving messages.
+     * - When the connection is opened, it emits the `LiveTranscriptionEvents.Open` event.
+     * - When the connection is closed, it emits the `LiveTranscriptionEvents.Close` event.
+     * - When an error occurs on the connection, it emits the `LiveTranscriptionEvents.Error` event.
+     * - When a message is received, it parses the message and emits the appropriate event based on the message type, such as `LiveTranscriptionEvents.Metadata`, `LiveTranscriptionEvents.Transcript`, `LiveTranscriptionEvents.UtteranceEnd`, and `LiveTranscriptionEvents.SpeechStarted`.
+     */
+    setupConnection(): void;
+    /**
+     * Sends additional config to the connected session.
+     *
+     * @param config - The configuration options to apply to the LiveClient.
+     * @param config.numerals - We currently only support numerals.
+     */
+    configure(config: LiveConfigOptions): void;
+    /**
+     * Sends a "KeepAlive" message to the server to maintain the connection.
+     */
+    keepAlive(): void;
+    /**
+     * @deprecated Since version 3.4. Will be removed in version 4.0. Use `close` instead.
+     */
+    finish(): void;
+    /**
+     * Requests the server close the connection.
+     */
+    requestClose(): void;
+}
+export { ListenLiveClient as LiveClient };
+//# sourceMappingURL=ListenLiveClient.d.ts.map

package/dist/main/packages/ListenLiveClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListenLiveClient.d.ts","sourceRoot":"","sources":["../../../src/packages/ListenLiveClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAEzF;;;;;;;;;;;;;;GAcG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IAC/C,SAAS,EAAE,MAAM,CAAY;IAEpC;;;;;;OAMG;gBAED,OAAO,EAAE,qBAAqB,EAC9B,oBAAoB,GAAE,UAAe,EACrC,QAAQ,GAAE,MAA0B;IAOtC;;;;;;;OAOG;IACI,eAAe,IAAI,IAAI;IAwC9B;;;;;OAKG;IACI,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IASjD;;OAEG;IACI,SAAS,IAAI,IAAI;IAQxB;;OAEG;IACI,MAAM,IAAI,IAAI;IAIrB;;OAEG;IACI,YAAY,IAAI,IAAI;CAO5B;AAED,OAAO,EAAE,gBAAgB,IAAI,UAAU,EAAE,CAAC"}

package/dist/main/packages/ListenLiveClient.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LiveClient = exports.ListenLiveClient = void 0;
+const AbstractLiveClient_1 = require("./AbstractLiveClient");
+const enums_1 = require("../lib/enums");
+/**
+ * The `ListenLiveClient` class extends the `AbstractLiveClient` class and provides functionality for setting up and managing a WebSocket connection for live transcription.
+ *
+ * The constructor takes in `DeepgramClientOptions` and an optional `LiveSchema` object, as well as an optional `endpoint` string. It then calls the `connect` method of the parent `AbstractLiveClient` class to establish the WebSocket connection.
+ *
+ * The `setupConnection` method is responsible for handling the various events that can occur on the WebSocket connection, such as opening, closing, and receiving messages. It sets up event handlers for these events and emits the appropriate events based on the message type.
+ *
+ * The `configure` method allows you to send additional configuration options to the connected session, such as enabling numerals.
+ *
+ * The `keepAlive` method sends a "KeepAlive" message to the server to maintain the connection.
+ *
+ * The `requestClose` method requests the server to close the connection.
+ *
+ * The `finish` method is deprecated as of version 3.4 and will be removed in version 4.0. Use `requestClose` instead.
+ */
+class ListenLiveClient extends AbstractLiveClient_1.AbstractLiveClient {
+    /**
+     * Constructs a new `ListenLiveClient` instance with the provided options.
+     *
+     * @param options - The `DeepgramClientOptions` to use for the client connection.
+     * @param transcriptionOptions - An optional `LiveSchema` object containing additional configuration options for the live transcription.
+     * @param endpoint - An optional string representing the WebSocket endpoint to connect to. Defaults to `:version/listen`.
+     */
+    constructor(options, transcriptionOptions = {}, endpoint = ":version/listen") {
+        super(options);
+        this.namespace = "listen";
+        this.connect(transcriptionOptions, endpoint);
+    }
+    /**
+     * Sets up the connection event handlers.
+     * This method is responsible for handling the various events that can occur on the WebSocket connection, such as opening, closing, and receiving messages.
+     * - When the connection is opened, it emits the `LiveTranscriptionEvents.Open` event.
+     * - When the connection is closed, it emits the `LiveTranscriptionEvents.Close` event.
+     * - When an error occurs on the connection, it emits the `LiveTranscriptionEvents.Error` event.
+     * - When a message is received, it parses the message and emits the appropriate event based on the message type, such as `LiveTranscriptionEvents.Metadata`, `LiveTranscriptionEvents.Transcript`, `LiveTranscriptionEvents.UtteranceEnd`, and `LiveTranscriptionEvents.SpeechStarted`.
+     */
+    setupConnection() {
+        if (this.conn) {
+            this.conn.onopen = () => {
+                this.emit(enums_1.LiveTranscriptionEvents.Open, this);
+            };
+            this.conn.onclose = (event) => {
+                this.emit(enums_1.LiveTranscriptionEvents.Close, event);
+            };
+            this.conn.onerror = (event) => {
+                this.emit(enums_1.LiveTranscriptionEvents.Error, event);
+            };
+            this.conn.onmessage = (event) => {
+                try {
+                    const data = JSON.parse(event.data.toString());
+                    if (data.type === enums_1.LiveTranscriptionEvents.Metadata) {
+                        this.emit(enums_1.LiveTranscriptionEvents.Metadata, data);
+                    }
+                    else if (data.type === enums_1.LiveTranscriptionEvents.Transcript) {
+                        this.emit(enums_1.LiveTranscriptionEvents.Transcript, data);
+                    }
+                    else if (data.type === enums_1.LiveTranscriptionEvents.UtteranceEnd) {
+                        this.emit(enums_1.LiveTranscriptionEvents.UtteranceEnd, data);
+                    }
+                    else if (data.type === enums_1.LiveTranscriptionEvents.SpeechStarted) {
+                        this.emit(enums_1.LiveTranscriptionEvents.SpeechStarted, data);
+                    }
+                    else {
+                        this.emit(enums_1.LiveTranscriptionEvents.Unhandled, data);
+                    }
+                }
+                catch (error) {
+                    this.emit(enums_1.LiveTranscriptionEvents.Error, {
+                        event,
+                        message: "Unable to parse `data` as JSON.",
+                        error,
+                    });
+                }
+            };
+        }
+    }
+    /**
+     * Sends additional config to the connected session.
+     *
+     * @param config - The configuration options to apply to the LiveClient.
+     * @param config.numerals - We currently only support numerals.
+     */
+    configure(config) {
+        this.send(JSON.stringify({
+            type: "Configure",
+            processors: config,
+        }));
+    }
+    /**
+     * Sends a "KeepAlive" message to the server to maintain the connection.
+     */
+    keepAlive() {
+        this.send(JSON.stringify({
+            type: "KeepAlive",
+        }));
+    }
+    /**
+     * @deprecated Since version 3.4. Will be removed in version 4.0. Use `close` instead.
+     */
+    finish() {
+        this.requestClose();
+    }
+    /**
+     * Requests the server close the connection.
+     */
+    requestClose() {
+        this.send(JSON.stringify({
+            type: "CloseStream",
+        }));
+    }
+}
+exports.ListenLiveClient = ListenLiveClient;
+exports.LiveClient = ListenLiveClient;
+//# sourceMappingURL=ListenLiveClient.js.map

package/dist/main/packages/ListenLiveClient.js.map

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

package/dist/main/packages/ListenRestClient.d.ts

@@ -0,0 +1,57 @@
+import { CallbackUrl } from "../lib/helpers";
+import type { AsyncPrerecordedResponse, DeepgramResponse, FileSource, PrerecordedSchema, SyncPrerecordedResponse, UrlSource } from "../lib/types";
+import { AbstractRestClient } from "./AbstractRestClient";
+/**
+ * The `ListenRestClient` class extends the `AbstractRestClient` class and provides methods for transcribing audio from URLs or files using the Deepgram API.
+ *
+ * The `transcribeUrl` method is used to transcribe audio from a URL synchronously. It takes a `UrlSource` object as the source, an optional `PrerecordedSchema` object as options, and an optional endpoint string. It returns a `DeepgramResponse` object containing the transcription result or an error.
+ *
+ * The `transcribeFile` method is used to transcribe audio from a file synchronously. It takes a `FileSource` object as the source, an optional `PrerecordedSchema` object as options, and an optional endpoint string. It returns a `DeepgramResponse` object containing the transcription result or an error.
+ *
+ * The `transcribeUrlCallback` method is used to transcribe audio from a URL asynchronously. It takes a `UrlSource` object as the source, a `CallbackUrl` object as the callback, an optional `PrerecordedSchema` object as options, and an optional endpoint string. It returns a `DeepgramResponse` object containing the transcription result or an error.
+ *
+ * The `transcribeFileCallback` method is used to transcribe audio from a file asynchronously. It takes a `FileSource` object as the source, a `CallbackUrl` object as the callback, an optional `PrerecordedSchema` object as options, and an optional endpoint string. It returns a `DeepgramResponse` object containing the transcription result or an error.
+ */
+export declare class ListenRestClient extends AbstractRestClient {
+    namespace: string;
+    /**
+     * Transcribes audio from a URL synchronously.
+     *
+     * @param source - The URL source object containing the audio URL to transcribe.
+     * @param options - An optional `PrerecordedSchema` object containing additional options for the transcription.
+     * @param endpoint - An optional endpoint string to use for the transcription request.
+     * @returns A `DeepgramResponse` object containing the transcription result or an error.
+     */
+    transcribeUrl(source: UrlSource, options?: PrerecordedSchema, endpoint?: string): Promise<DeepgramResponse<SyncPrerecordedResponse>>;
+    /**
+     * Transcribes audio from a file asynchronously.
+     *
+     * @param source - The file source object containing the audio file to transcribe.
+     * @param options - An optional `PrerecordedSchema` object containing additional options for the transcription.
+     * @param endpoint - An optional endpoint string to use for the transcription request.
+     * @returns A `DeepgramResponse` object containing the transcription result or an error.
+     */
+    transcribeFile(source: FileSource, options?: PrerecordedSchema, endpoint?: string): Promise<DeepgramResponse<SyncPrerecordedResponse>>;
+    /**
+     * Transcribes audio from a URL asynchronously.
+     *
+     * @param source - The URL source object containing the audio file to transcribe.
+     * @param callback - The callback URL to receive the transcription result.
+     * @param options - An optional `PrerecordedSchema` object containing additional options for the transcription.
+     * @param endpoint - An optional endpoint string to use for the transcription request.
+     * @returns A `DeepgramResponse` object containing the transcription result or an error.
+     */
+    transcribeUrlCallback(source: UrlSource, callback: CallbackUrl, options?: PrerecordedSchema, endpoint?: string): Promise<DeepgramResponse<AsyncPrerecordedResponse>>;
+    /**
+     * Transcribes audio from a file asynchronously.
+     *
+     * @param source - The file source object containing the audio file to transcribe.
+     * @param callback - The callback URL to receive the transcription result.
+     * @param options - An optional `PrerecordedSchema` object containing additional options for the transcription.
+     * @param endpoint - An optional endpoint string to use for the transcription request.
+     * @returns A `DeepgramResponse` object containing the transcription result or an error.
+     */
+    transcribeFileCallback(source: FileSource, callback: CallbackUrl, options?: PrerecordedSchema, endpoint?: string): Promise<DeepgramResponse<AsyncPrerecordedResponse>>;
+}
+export { ListenRestClient as PrerecordedClient };
+//# sourceMappingURL=ListenRestClient.d.ts.map

package/dist/main/packages/ListenRestClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListenRestClient.d.ts","sourceRoot":"","sources":["../../../src/packages/ListenRestClient.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA6B,MAAM,gBAAgB,CAAC;AAExE,OAAO,KAAK,EACV,wBAAwB,EACxB,gBAAgB,EAEhB,UAAU,EACV,iBAAiB,EACjB,uBAAuB,EACvB,SAAS,EACV,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D;;;;;;;;;;GAUG;AACH,qBAAa,gBAAiB,SAAQ,kBAAkB;IAC/C,SAAS,EAAE,MAAM,CAAY;IAEpC;;;;;;;OAOG;IACG,aAAa,CACjB,MAAM,EAAE,SAAS,EACjB,OAAO,CAAC,EAAE,iBAAiB,EAC3B,QAAQ,SAAoB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,CAAC;IA+BrD;;;;;;;OAOG;IACG,cAAc,CAClB,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,iBAAiB,EAC3B,QAAQ,SAAoB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,uBAAuB,CAAC,CAAC;IA+BrD;;;;;;;;OAQG;IACG,qBAAqB,CACzB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,iBAAiB,EAC3B,QAAQ,SAAoB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;IA6BtD;;;;;;;;OAQG;IACG,sBAAsB,CAC1B,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,WAAW,EACrB,OAAO,CAAC,EAAE,iBAAiB,EAC3B,QAAQ,SAAoB,GAC3B,OAAO,CAAC,gBAAgB,CAAC,wBAAwB,CAAC,CAAC;CA4BvD;AAED,OAAO,EAAE,gBAAgB,IAAI,iBAAiB,EAAE,CAAC"}

package/dist/main/packages/ListenRestClient.js

@@ -0,0 +1,167 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PrerecordedClient = exports.ListenRestClient = void 0;
+const helpers_1 = require("../lib/helpers");
+const errors_1 = require("../lib/errors");
+const AbstractRestClient_1 = require("./AbstractRestClient");
+/**
+ * The `ListenRestClient` class extends the `AbstractRestClient` class and provides methods for transcribing audio from URLs or files using the Deepgram API.
+ *
+ * The `transcribeUrl` method is used to transcribe audio from a URL synchronously. It takes a `UrlSource` object as the source, an optional `PrerecordedSchema` object as options, and an optional endpoint string. It returns a `DeepgramResponse` object containing the transcription result or an error.
+ *
+ * The `transcribeFile` method is used to transcribe audio from a file synchronously. It takes a `FileSource` object as the source, an optional `PrerecordedSchema` object as options, and an optional endpoint string. It returns a `DeepgramResponse` object containing the transcription result or an error.
+ *
+ * The `transcribeUrlCallback` method is used to transcribe audio from a URL asynchronously. It takes a `UrlSource` object as the source, a `CallbackUrl` object as the callback, an optional `PrerecordedSchema` object as options, and an optional endpoint string. It returns a `DeepgramResponse` object containing the transcription result or an error.
+ *
+ * The `transcribeFileCallback` method is used to transcribe audio from a file asynchronously. It takes a `FileSource` object as the source, a `CallbackUrl` object as the callback, an optional `PrerecordedSchema` object as options, and an optional endpoint string. It returns a `DeepgramResponse` object containing the transcription result or an error.
+ */
+class ListenRestClient extends AbstractRestClient_1.AbstractRestClient {
+    constructor() {
+        super(...arguments);
+        this.namespace = "listen";
+    }
+    /**
+     * Transcribes audio from a URL synchronously.
+     *
+     * @param source - The URL source object containing the audio URL to transcribe.
+     * @param options - An optional `PrerecordedSchema` object containing additional options for the transcription.
+     * @param endpoint - An optional endpoint string to use for the transcription request.
+     * @returns A `DeepgramResponse` object containing the transcription result or an error.
+     */
+    transcribeUrl(source, options, endpoint = ":version/listen") {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                let body;
+                if ((0, helpers_1.isUrlSource)(source)) {
+                    body = JSON.stringify(source);
+                }
+                else {
+                    throw new errors_1.DeepgramError("Unknown transcription source type");
+                }
+                if (options !== undefined && "callback" in options) {
+                    throw new errors_1.DeepgramError("Callback cannot be provided as an option to a synchronous transcription. Use `transcribeUrlCallback` or `transcribeFileCallback` instead.");
+                }
+                const requestUrl = this.getRequestUrl(endpoint, {}, Object.assign({}, options));
+                const result = yield this.post(requestUrl, body).then((result) => result.json());
+                return { result, error: null };
+            }
+            catch (error) {
+                if ((0, errors_1.isDeepgramError)(error)) {
+                    return { result: null, error };
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * Transcribes audio from a file asynchronously.
+     *
+     * @param source - The file source object containing the audio file to transcribe.
+     * @param options - An optional `PrerecordedSchema` object containing additional options for the transcription.
+     * @param endpoint - An optional endpoint string to use for the transcription request.
+     * @returns A `DeepgramResponse` object containing the transcription result or an error.
+     */
+    transcribeFile(source, options, endpoint = ":version/listen") {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                let body;
+                if ((0, helpers_1.isFileSource)(source)) {
+                    body = source;
+                }
+                else {
+                    throw new errors_1.DeepgramError("Unknown transcription source type");
+                }
+                if (options !== undefined && "callback" in options) {
+                    throw new errors_1.DeepgramError("Callback cannot be provided as an option to a synchronous transcription. Use `transcribeUrlCallback` or `transcribeFileCallback` instead.");
+                }
+                const requestUrl = this.getRequestUrl(endpoint, {}, Object.assign({}, options));
+                const result = yield this.post(requestUrl, body, {
+                    headers: { "Content-Type": "deepgram/audio+video" },
+                }).then((result) => result.json());
+                return { result, error: null };
+            }
+            catch (error) {
+                if ((0, errors_1.isDeepgramError)(error)) {
+                    return { result: null, error };
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * Transcribes audio from a URL asynchronously.
+     *
+     * @param source - The URL source object containing the audio file to transcribe.
+     * @param callback - The callback URL to receive the transcription result.
+     * @param options - An optional `PrerecordedSchema` object containing additional options for the transcription.
+     * @param endpoint - An optional endpoint string to use for the transcription request.
+     * @returns A `DeepgramResponse` object containing the transcription result or an error.
+     */
+    transcribeUrlCallback(source, callback, options, endpoint = ":version/listen") {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                let body;
+                if ((0, helpers_1.isUrlSource)(source)) {
+                    body = JSON.stringify(source);
+                }
+                else {
+                    throw new errors_1.DeepgramError("Unknown transcription source type");
+                }
+                const requestUrl = this.getRequestUrl(endpoint, {}, Object.assign(Object.assign({}, options), { callback: callback.toString() }));
+                const result = yield this.post(requestUrl, body).then((result) => result.json());
+                return { result, error: null };
+            }
+            catch (error) {
+                if ((0, errors_1.isDeepgramError)(error)) {
+                    return { result: null, error };
+                }
+                throw error;
+            }
+        });
+    }
+    /**
+     * Transcribes audio from a file asynchronously.
+     *
+     * @param source - The file source object containing the audio file to transcribe.
+     * @param callback - The callback URL to receive the transcription result.
+     * @param options - An optional `PrerecordedSchema` object containing additional options for the transcription.
+     * @param endpoint - An optional endpoint string to use for the transcription request.
+     * @returns A `DeepgramResponse` object containing the transcription result or an error.
+     */
+    transcribeFileCallback(source, callback, options, endpoint = ":version/listen") {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                let body;
+                if ((0, helpers_1.isFileSource)(source)) {
+                    body = source;
+                }
+                else {
+                    throw new errors_1.DeepgramError("Unknown transcription source type");
+                }
+                const requestUrl = this.getRequestUrl(endpoint, {}, Object.assign(Object.assign({}, options), { callback: callback.toString() }));
+                const result = yield this.post(requestUrl, body, {
+                    headers: { "Content-Type": "deepgram/audio+video" },
+                }).then((result) => result.json());
+                return { result, error: null };
+            }
+            catch (error) {
+                if ((0, errors_1.isDeepgramError)(error)) {
+                    return { result: null, error };
+                }
+                throw error;
+            }
+        });
+    }
+}
+exports.ListenRestClient = ListenRestClient;
+exports.PrerecordedClient = ListenRestClient;
+//# sourceMappingURL=ListenRestClient.js.map

package/dist/main/packages/ListenRestClient.js.map

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