@fc3/mmcadi 0.1.0 → 0.1.2

package/dist/src/lib/logger/logger.js

@@ -0,0 +1,174 @@
+"use strict";
+/**
+ * The Logger class is exactly what it sounds like: you can use it to log
+ * messages from the Node.js environment. Please use this instead of calling
+ * console.log() or process.stdout.write(), etc.
+ *
+ * In development, the Logger class will pretty-print output logs for you
+ * to view in the console. In production, the Logger will print JSON-formatted
+ * message objects.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const events_1 = require("events");
+const environment_1 = require("./../environment/index.js");
+const feature_1 = __importDefault(require("./../feature/index.js"));
+const log_level_1 = __importDefault(require("./enum/log-level.js"));
+const formatter_1 = __importDefault(require("./formatter.js"));
+class Logger extends events_1.EventEmitter {
+    static setErrorReporter(error_reporter) {
+        this.error_reporter = error_reporter;
+    }
+    static getErrorReporter() {
+        if (this.error_reporter === undefined) {
+            throw new Error('Tried to read error reporter, but it was not set');
+        }
+        return this.error_reporter;
+    }
+    static hasErrorReporter() {
+        return this.error_reporter !== undefined;
+    }
+    constructor() {
+        super();
+        this.bindHandlers();
+    }
+    setUniqueId(unique_id) {
+        this.unique_id = unique_id;
+        return this;
+    }
+    setRemoteAddress(remote_address) {
+        this.remote_address = remote_address;
+        return this;
+    }
+    setOrigin(origin) {
+        this.origin = origin;
+        return this;
+    }
+    error(message) {
+        if (message instanceof Error) {
+            message = message.toString();
+        }
+        return void this.writeMessage(message, log_level_1.default.ERROR);
+    }
+    warn(message) {
+        return void this.writeMessage(message, log_level_1.default.WARNING);
+    }
+    info(message) {
+        return void this.writeMessage(message, log_level_1.default.INFO);
+    }
+    success(message) {
+        return void this.writeMessage(message, log_level_1.default.SUCCESS);
+    }
+    writeMessage(body, log_level) {
+        const unique_id = this.getUniqueId();
+        const remote_address = this.getRemoteAddress();
+        const origin = this.getOrigin();
+        const timestamp = Date.now();
+        const message = {
+            unique_id,
+            remote_address,
+            origin,
+            timestamp,
+            log_level
+        };
+        if (typeof body === 'string') {
+            Object.assign(message, {
+                body
+            });
+        }
+        else {
+            Object.assign(message, body);
+        }
+        if (log_level === log_level_1.default.ERROR && this.shouldReportErrors()) {
+            this.reportError(message);
+        }
+        const serialized_message = this.serializeMessage(message);
+        process.stdout.write(`${serialized_message}\n`);
+    }
+    errorAndExit(error) {
+        this.error(error);
+        if (error instanceof Error && error.stack !== undefined) {
+            this.error(error.stack);
+        }
+        process.exit(1);
+    }
+    successAndExit(message) {
+        this.success(message);
+        process.exit(0);
+    }
+    bindHandlers() {
+        this.errorAndExit = this.errorAndExit.bind(this);
+        this.successAndExit = this.successAndExit.bind(this);
+    }
+    getUniqueId() {
+        return this.unique_id;
+    }
+    getRemoteAddress() {
+        return this.remote_address;
+    }
+    getOrigin() {
+        return this.origin;
+    }
+    shouldLogAsJson() {
+        if (!feature_1.default.isEnabled('logger.json_logging')) {
+            return false;
+        }
+        return (0, environment_1.isProductionOrStaging)();
+    }
+    serializeMessage(message) {
+        if (this.shouldLogAsJson()) {
+            return this.serializeMessageAsJson(message);
+        }
+        else {
+            return this.serializeMessageAsHumanReadableText(message);
+        }
+    }
+    serializeMessageAsJson(message) {
+        const trimmed_message = this.trimExtraWhitespaceFromMessage(message);
+        return JSON.stringify(trimmed_message);
+    }
+    serializeMessageAsHumanReadableText(message) {
+        const text = this.trimExtraWhitespaceFromLoggableValue(message.body);
+        const id = message.unique_id || message.remote_address;
+        const parts = [];
+        parts.push(`[${message.timestamp}]`);
+        if (id) {
+            parts.push(`[${id}]`);
+        }
+        parts.push(text);
+        const formatted_message = parts.join(' ');
+        const formatter = new formatter_1.default(formatted_message, message.log_level);
+        return formatter.format();
+    }
+    trimExtraWhitespaceFromMessage(input_message) {
+        const result = {};
+        for (const key in input_message) {
+            const value = input_message[key];
+            result[key] = this.trimExtraWhitespaceFromLoggableValue(value);
+        }
+        return result;
+    }
+    trimExtraWhitespaceFromLoggableValue(value) {
+        if (typeof value !== 'string') {
+            return value;
+        }
+        return value.replace(/\s+/g, ' ').trim();
+    }
+    shouldReportErrors() {
+        if (!Logger.hasErrorReporter()) {
+            return false;
+        }
+        return (0, environment_1.isProductionOrStaging)();
+    }
+    reportError(error) {
+        Logger.getErrorReporter().notify(error.message, {
+            meta_data: {
+                unique_id: error.unique_id
+            }
+        });
+    }
+}
+exports.default = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/src/lib/logger/logger.js.map

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

package/dist/src/lib/logger/type/error-parameters.d.ts

@@ -0,0 +1,7 @@
+import { LoggableValue } from './loggable-value';
+interface ErrorParameters {
+    meta_data: {
+        [key: string]: LoggableValue;
+    };
+}
+export default ErrorParameters;

package/dist/src/lib/logger/type/error-parameters.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=error-parameters.js.map

package/dist/src/lib/logger/type/error-parameters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-parameters.js","sourceRoot":"","sources":["../../../../../src/lib/logger/type/error-parameters.ts"],"names":[],"mappings":""}

package/dist/src/lib/logger/type/loggable-data.d.ts

@@ -0,0 +1,4 @@
+import { LoggableValue } from './loggable-value';
+export default interface LoggableData {
+    [key: string]: LoggableValue;
+}

package/dist/src/lib/logger/type/loggable-data.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=loggable-data.js.map

package/dist/src/lib/logger/type/loggable-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggable-data.js","sourceRoot":"","sources":["../../../../../src/lib/logger/type/loggable-data.ts"],"names":[],"mappings":""}

package/dist/src/lib/logger/type/loggable-value.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=loggable-value.js.map

package/dist/src/lib/logger/type/loggable-value.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loggable-value.js","sourceRoot":"","sources":["../../../../../src/lib/logger/type/loggable-value.ts"],"names":[],"mappings":""}

package/dist/src/lib/metrics/dispatcher.d.ts

@@ -0,0 +1,40 @@
+/**
+ * This class is a wrapper around the StatsD calls that we need to make
+ * from a Node.js process in order to power things like Datadog dashboards, etc.
+ *
+ * It basically exists to provide an abstract interface over the `node-statsd`
+ * third-party library.
+ */
+import TagMap from './type/tag-map';
+import DispatcherSettings from './type/dispatcher-settings';
+declare class MetricsDispatcher {
+    private static instance;
+    static getInstance(): MetricsDispatcher;
+    static setInstance(instance: MetricsDispatcher): void;
+    private settings;
+    private client;
+    private logger;
+    constructor(partial_settings?: Partial<DispatcherSettings>);
+    mute(): this;
+    unmute(): this;
+    gauge(metric_name: string, value: number, tags?: TagMap): this;
+    increment(metric_name: string, amount?: number, tags?: TagMap): this;
+    decrement(metric_name: string, amount?: number, tags?: TagMap): this;
+    timing(metric_name: string, milliseconds: number, tags?: TagMap): this;
+    disconnect(): void;
+    private getClient;
+    private createClient;
+    private getHost;
+    private getPort;
+    private getDispatchMode;
+    private setDispatchMode;
+    private getTags;
+    private getSettings;
+    private prepareTags;
+    private combineTags;
+    private concatenateTags;
+    private shouldCacheDns;
+    private shouldMock;
+    private getLogger;
+}
+export default MetricsDispatcher;

package/dist/src/lib/metrics/dispatcher.js

@@ -0,0 +1,188 @@
+"use strict";
+/**
+ * This class is a wrapper around the StatsD calls that we need to make
+ * from a Node.js process in order to power things like Datadog dashboards, etc.
+ *
+ * It basically exists to provide an abstract interface over the `node-statsd`
+ * third-party library.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_statsd_1 = require("node-statsd");
+const logger_1 = __importDefault(require("./../logger/index.js"));
+const environment_1 = require("./../environment/index.js");
+const feature_1 = __importDefault(require("./../feature/index.js"));
+const dispatch_mode_1 = __importDefault(require("./enum/dispatch-mode.js"));
+const settings_hydrator_1 = __importDefault(require("./settings-hydrator.js"));
+class MetricsDispatcher {
+    static getInstance() {
+        if (this.instance === undefined) {
+            this.instance = new MetricsDispatcher();
+        }
+        return this.instance;
+    }
+    static setInstance(instance) {
+        if (this.instance) {
+            this.instance.disconnect();
+        }
+        this.instance = instance;
+    }
+    constructor(partial_settings) {
+        if (partial_settings === undefined) {
+            partial_settings = {};
+        }
+        const hydrator = new settings_hydrator_1.default(partial_settings);
+        this.settings = hydrator.hydrate();
+    }
+    mute() {
+        this.setDispatchMode(dispatch_mode_1.default.MUTED);
+        return this;
+    }
+    unmute() {
+        this.setDispatchMode(dispatch_mode_1.default.UNMUTED);
+        return this;
+    }
+    gauge(metric_name, value, tags) {
+        const prepared_tags = this.prepareTags(metric_name, tags);
+        this.getClient().gauge(metric_name, value, prepared_tags);
+        return this;
+    }
+    increment(metric_name, amount, tags) {
+        if (amount === undefined) {
+            amount = 1;
+        }
+        else if (amount < 0) {
+            throw new Error(`Must specify positive amount to increment (got ${amount})`);
+        }
+        const prepared_tags = this.prepareTags(metric_name, tags);
+        this.getClient().increment(metric_name, amount, prepared_tags);
+        return this;
+    }
+    decrement(metric_name, amount, tags) {
+        if (amount === undefined) {
+            amount = -1;
+        }
+        else if (amount > 0) {
+            throw new Error(`Must specify negative value to decrement (got ${amount})`);
+        }
+        const prepared_tags = this.prepareTags(metric_name, tags);
+        this.getClient().decrement(metric_name, amount * -1, prepared_tags);
+        return this;
+    }
+    timing(metric_name, milliseconds, tags) {
+        const prepared_tags = this.prepareTags(metric_name, tags);
+        this.getClient().timing(metric_name, milliseconds, prepared_tags);
+        return this;
+    }
+    disconnect() {
+        if (this.client) {
+            this.client.close();
+        }
+    }
+    getClient() {
+        if (!this.client) {
+            this.client = this.createClient();
+        }
+        return this.client;
+    }
+    createClient() {
+        const client_properties = {
+            host: this.getHost(),
+            port: this.getPort(),
+            // eslint-disable-next-line @typescript-eslint/naming-convention
+            cacheDns: this.shouldCacheDns(),
+            mock: this.shouldMock()
+        };
+        const client = new node_statsd_1.StatsD(client_properties);
+        // Manually unref the underlying UDP socket to allow the process to close
+        // even if the StatsD connection is still open.
+        // TODO: Should we use ShutdownManager hooks for this instead?
+        client.socket.unref();
+        return client;
+    }
+    getHost() {
+        const settings = this.getSettings();
+        return settings.host;
+    }
+    getPort() {
+        const settings = this.getSettings();
+        return settings.port;
+    }
+    getDispatchMode() {
+        const settings = this.getSettings();
+        return settings.dispatch_mode;
+    }
+    setDispatchMode(dispatch_mode) {
+        const settings = this.getSettings();
+        this.settings = {
+            ...settings,
+            dispatch_mode
+        };
+    }
+    getTags() {
+        const settings = this.getSettings();
+        return settings.tags;
+    }
+    getSettings() {
+        return this.settings;
+    }
+    prepareTags(metric_name, ephemeral_tags) {
+        if (!feature_1.default.isEnabled('metric_tags')) {
+            if (ephemeral_tags === undefined) {
+                return [];
+            }
+            // Just because these are very noisy:
+            switch (metric_name) {
+                case 'incoming_responses':
+                case 'outgoing_responses':
+                case 'incoming_response_time':
+                case 'outgoing_response_time':
+                    return [];
+            }
+            const tag_keys = Object.keys(ephemeral_tags);
+            if (tag_keys.length > 0) {
+                const logger = this.getLogger();
+                const serialized_tags = tag_keys.join(', ');
+                logger.warn(`
+					Metric tags are disabled!
+					Received the following tags for metric "${metric_name}":
+					${serialized_tags}
+				`);
+            }
+            return [];
+        }
+        const persistent_tags = this.getTags();
+        if (ephemeral_tags === undefined) {
+            return this.concatenateTags(persistent_tags);
+        }
+        const combined_tags = this.combineTags(persistent_tags, ephemeral_tags);
+        return this.concatenateTags(combined_tags);
+    }
+    combineTags(persistent_tags, ephemeral_tags) {
+        const result = {};
+        Object.assign(result, persistent_tags);
+        Object.assign(result, ephemeral_tags);
+        return result;
+    }
+    concatenateTags(tags) {
+        return Object.keys(tags).map((key) => {
+            return `${key}:${tags[key]}`;
+        });
+    }
+    shouldCacheDns() {
+        return (0, environment_1.isProduction)();
+    }
+    shouldMock() {
+        return this.getDispatchMode() === dispatch_mode_1.default.MUTED;
+    }
+    getLogger() {
+        if (this.logger === undefined) {
+            this.logger = new logger_1.default();
+        }
+        return this.logger;
+    }
+}
+exports.default = MetricsDispatcher;
+//# sourceMappingURL=dispatcher.js.map

package/dist/src/lib/metrics/dispatcher.js.map

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

package/dist/src/lib/metrics/enum/dispatch-mode.d.ts

@@ -0,0 +1,5 @@
+declare enum DispatchMode {
+    MUTED = "muted",
+    UNMUTED = "unmuted"
+}
+export default DispatchMode;

package/dist/src/lib/metrics/enum/dispatch-mode.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var DispatchMode;
+(function (DispatchMode) {
+    DispatchMode["MUTED"] = "muted";
+    DispatchMode["UNMUTED"] = "unmuted";
+})(DispatchMode || (DispatchMode = {}));
+exports.default = DispatchMode;
+//# sourceMappingURL=dispatch-mode.js.map

package/dist/src/lib/metrics/enum/dispatch-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatch-mode.js","sourceRoot":"","sources":["../../../../../src/lib/metrics/enum/dispatch-mode.ts"],"names":[],"mappings":";;AAAA,IAAK,YAGJ;AAHD,WAAK,YAAY;IAChB,+BAAe,CAAA;IACf,mCAAmB,CAAA;AACpB,CAAC,EAHI,YAAY,KAAZ,YAAY,QAGhB;AAED,kBAAe,YAAY,CAAC"}

package/dist/src/lib/metrics/index.d.ts

@@ -0,0 +1,2 @@
+export { default as TagMap } from './type/tag-map';
+export { default as Dispatcher } from './dispatcher';

package/dist/src/lib/metrics/index.js

@@ -0,0 +1,9 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Dispatcher = void 0;
+var dispatcher_1 = require("./dispatcher.js");
+Object.defineProperty(exports, "Dispatcher", { enumerable: true, get: function () { return __importDefault(dispatcher_1).default; } });
+//# sourceMappingURL=index.js.map

package/dist/src/lib/metrics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/metrics/index.ts"],"names":[],"mappings":";;;;;;AACA,qDAA6D;AAArD,yHAAA,OAAO,OAAc"}

package/dist/src/lib/metrics/settings-hydrator.d.ts

@@ -0,0 +1,12 @@
+import DispatcherSettings from './type/dispatcher-settings';
+declare class SettingsHydrator {
+    private partial_settings;
+    constructor(partial_settings: Partial<DispatcherSettings>);
+    hydrate(): DispatcherSettings;
+    private getDefaultHost;
+    private getDefaultPort;
+    private getDefaultTags;
+    private getDefaultDispatchMode;
+    private getPartialSettings;
+}
+export default SettingsHydrator;

package/dist/src/lib/metrics/settings-hydrator.js

@@ -0,0 +1,44 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const dispatch_mode_1 = __importDefault(require("./enum/dispatch-mode.js"));
+class SettingsHydrator {
+    constructor(partial_settings) {
+        this.partial_settings = partial_settings;
+    }
+    hydrate() {
+        const partial_settings = this.getPartialSettings();
+        const host = this.getDefaultHost();
+        const port = this.getDefaultPort();
+        const tags = this.getDefaultTags();
+        const dispatch_mode = this.getDefaultDispatchMode();
+        const prefix = '';
+        return {
+            host,
+            port,
+            tags,
+            dispatch_mode,
+            prefix,
+            ...partial_settings
+        };
+    }
+    getDefaultHost() {
+        return 'localhost';
+    }
+    getDefaultPort() {
+        return 1234;
+    }
+    getDefaultTags() {
+        return {};
+    }
+    getDefaultDispatchMode() {
+        return dispatch_mode_1.default.UNMUTED;
+    }
+    getPartialSettings() {
+        return this.partial_settings;
+    }
+}
+exports.default = SettingsHydrator;
+//# sourceMappingURL=settings-hydrator.js.map

package/dist/src/lib/metrics/settings-hydrator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings-hydrator.js","sourceRoot":"","sources":["../../../../src/lib/metrics/settings-hydrator.ts"],"names":[],"mappings":";;;;;AACA,mFAA0D;AAG1D,MAAM,gBAAgB;IAGrB,YAAmB,gBAA6C;QAC/D,IAAI,CAAC,gBAAgB,GAAG,gBAAgB,CAAC;IAC1C,CAAC;IAEM,OAAO;QACb,MAAM,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC;QACnC,MAAM,aAAa,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACpD,MAAM,MAAM,GAAG,EAAE,CAAC;QAElB,OAAO;YACN,IAAI;YACJ,IAAI;YACJ,IAAI;YACJ,aAAa;YACb,MAAM;YACN,GAAG,gBAAgB;SACnB,CAAC;IACH,CAAC;IAEO,cAAc;QACrB,OAAO,WAAW,CAAC;IACpB,CAAC;IAEO,cAAc;QACrB,OAAO,IAAI,CAAC;IACb,CAAC;IAEO,cAAc;QACrB,OAAO,EAAE,CAAC;IACX,CAAC;IAEO,sBAAsB;QAC7B,OAAO,uBAAY,CAAC,OAAO,CAAC;IAC7B,CAAC;IAEO,kBAAkB;QACzB,OAAO,IAAI,CAAC,gBAAgB,CAAC;IAC9B,CAAC;CACD;AAED,kBAAe,gBAAgB,CAAC"}

package/dist/src/lib/metrics/type/dispatcher-settings.d.ts

@@ -0,0 +1,10 @@
+import TagMap from './tag-map';
+import DispatchMode from './../enum/dispatch-mode';
+interface DispatcherSettings {
+    readonly host: string;
+    readonly port: number;
+    readonly prefix: string;
+    readonly tags: TagMap;
+    readonly dispatch_mode: DispatchMode;
+}
+export default DispatcherSettings;

package/dist/src/lib/metrics/type/dispatcher-settings.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=dispatcher-settings.js.map

package/dist/src/lib/metrics/type/dispatcher-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher-settings.js","sourceRoot":"","sources":["../../../../../src/lib/metrics/type/dispatcher-settings.ts"],"names":[],"mappings":""}

package/dist/src/lib/metrics/type/tag-map.d.ts

@@ -0,0 +1,4 @@
+interface TagMap {
+    [key: string]: string | number;
+}
+export default TagMap;

package/dist/src/lib/metrics/type/tag-map.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=tag-map.js.map

package/dist/src/lib/metrics/type/tag-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tag-map.js","sourceRoot":"","sources":["../../../../../src/lib/metrics/type/tag-map.ts"],"names":[],"mappings":""}

package/dist/src/lib/network/bootstrap.js

@@ -0,0 +1,3 @@
+"use strict";
+throw new Error('Not implemented');
+//# sourceMappingURL=bootstrap.js.map

package/dist/src/lib/network/bootstrap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.js","sourceRoot":"","sources":["../../../../src/lib/network/bootstrap.ts"],"names":[],"mappings":";AAAA,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC"}

package/dist/src/lib/network/enum/connection-status.d.ts

@@ -0,0 +1,13 @@
+declare enum ConnectionStatus {
+    NOT_CONNECTED = "not_connected",
+    SEARCHING = "searching",
+    CONNECTING = "connecting",
+    CONNECTED = "connected",
+    NOT_AUTHENTICATED = "not_authenticated",
+    AUTHENTICATING = "authenticating",
+    AUTHENTICATED = "authenticated",
+    DISCONNECTING = "disconnecting",
+    DISCONNECTED = "disconnected",
+    FAILED_TO_CONNECT = "failed_to_connect"
+}
+export default ConnectionStatus;

package/dist/src/lib/network/enum/connection-status.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+var ConnectionStatus;
+(function (ConnectionStatus) {
+    ConnectionStatus["NOT_CONNECTED"] = "not_connected";
+    ConnectionStatus["SEARCHING"] = "searching";
+    ConnectionStatus["CONNECTING"] = "connecting";
+    ConnectionStatus["CONNECTED"] = "connected";
+    ConnectionStatus["NOT_AUTHENTICATED"] = "not_authenticated";
+    ConnectionStatus["AUTHENTICATING"] = "authenticating";
+    ConnectionStatus["AUTHENTICATED"] = "authenticated";
+    ConnectionStatus["DISCONNECTING"] = "disconnecting";
+    ConnectionStatus["DISCONNECTED"] = "disconnected";
+    ConnectionStatus["FAILED_TO_CONNECT"] = "failed_to_connect";
+})(ConnectionStatus || (ConnectionStatus = {}));
+exports.default = ConnectionStatus;
+//# sourceMappingURL=connection-status.js.map

package/dist/src/lib/network/enum/connection-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection-status.js","sourceRoot":"","sources":["../../../../../src/lib/network/enum/connection-status.ts"],"names":[],"mappings":";;AAAA,IAAK,gBAWJ;AAXD,WAAK,gBAAgB;IACpB,mDAA+B,CAAA;IAC/B,2CAAuB,CAAA;IACvB,6CAAyB,CAAA;IACzB,2CAAuB,CAAA;IACvB,2DAAuC,CAAA;IACvC,qDAAiC,CAAA;IACjC,mDAA+B,CAAA;IAC/B,mDAA+B,CAAA;IAC/B,iDAA6B,CAAA;IAC7B,2DAAuC,CAAA;AACxC,CAAC,EAXI,gBAAgB,KAAhB,gBAAgB,QAWpB;AAED,kBAAe,gBAAgB,CAAC"}