@launchdarkly/js-sdk-common 0.1.0

package/dist/internal/events/SummaryCounter.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @internal
+ */
+class SummaryCounter {
+    constructor(count, key, value, defValue, version, variation) {
+        this.count = count;
+        this.key = key;
+        this.value = value;
+        this.version = version;
+        this.variation = variation;
+        this.default = defValue;
+    }
+    increment() {
+        this.count += 1;
+    }
+}
+exports.default = SummaryCounter;
+//# sourceMappingURL=SummaryCounter.js.map

package/dist/internal/events/SummaryCounter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SummaryCounter.js","sourceRoot":"","sources":["../../../src/internal/events/SummaryCounter.ts"],"names":[],"mappings":";;AAAA;;GAEG;AACH,MAAqB,cAAc;IAGjC,YACS,KAAa,EACb,GAAW,EACX,KAAU,EACjB,QAAa,EACN,OAAgB,EAChB,SAAkB;QALlB,UAAK,GAAL,KAAK,CAAQ;QACb,QAAG,GAAH,GAAG,CAAQ;QACX,UAAK,GAAL,KAAK,CAAK;QAEV,YAAO,GAAP,OAAO,CAAS;QAChB,cAAS,GAAT,SAAS,CAAS;QAEzB,IAAI,CAAC,OAAO,GAAG,QAAQ,CAAC;IAC1B,CAAC;IAED,SAAS;QACP,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAClB,CAAC;CACF;AAjBD,iCAiBC"}

package/dist/internal/events/guards.d.ts

@@ -0,0 +1,7 @@
+import InputCustomEvent from './InputCustomEvent';
+import InputEvalEvent from './InputEvalEvent';
+import InputIdentifyEvent from './InputIdentifyEvent';
+export declare function isFeature(u: any): u is InputEvalEvent;
+export declare function isCustom(u: any): u is InputCustomEvent;
+export declare function isIdentify(u: any): u is InputIdentifyEvent;
+//# sourceMappingURL=guards.d.ts.map

package/dist/internal/events/guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.d.ts","sourceRoot":"","sources":["../../../src/internal/events/guards.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAClD,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AAEtD,wBAAgB,SAAS,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,cAAc,CAErD;AAED,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,gBAAgB,CAEtD;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,IAAI,kBAAkB,CAE1D"}

package/dist/internal/events/guards.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isIdentify = exports.isCustom = exports.isFeature = void 0;
+function isFeature(u) {
+    return u.kind === 'feature';
+}
+exports.isFeature = isFeature;
+function isCustom(u) {
+    return u.kind === 'custom';
+}
+exports.isCustom = isCustom;
+function isIdentify(u) {
+    return u.kind === 'identify';
+}
+exports.isIdentify = isIdentify;
+//# sourceMappingURL=guards.js.map

package/dist/internal/events/guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../src/internal/events/guards.ts"],"names":[],"mappings":";;;AAIA,SAAgB,SAAS,CAAC,CAAM;IAC9B,OAAO,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC;AAC9B,CAAC;AAFD,8BAEC;AAED,SAAgB,QAAQ,CAAC,CAAM;IAC7B,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC;AAC7B,CAAC;AAFD,4BAEC;AAED,SAAgB,UAAU,CAAC,CAAM;IAC/B,OAAO,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC;AAC/B,CAAC;AAFD,gCAEC"}

package/dist/internal/events/index.d.ts

@@ -0,0 +1,7 @@
+import InputCustomEvent from './InputCustomEvent';
+import InputEvalEvent from './InputEvalEvent';
+import InputEvent from './InputEvent';
+import InputIdentifyEvent from './InputIdentifyEvent';
+import EventProcessor from './EventProcessor';
+export { InputCustomEvent, InputEvalEvent, InputEvent, InputIdentifyEvent, EventProcessor };
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/events/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/events/index.ts"],"names":[],"mappings":"AAAA,OAAO,gBAAgB,MAAM,oBAAoB,CAAC;AAClD,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAC9C,OAAO,UAAU,MAAM,cAAc,CAAC;AACtC,OAAO,kBAAkB,MAAM,sBAAsB,CAAC;AACtD,OAAO,cAAc,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,kBAAkB,EAAE,cAAc,EAAE,CAAC"}

package/dist/internal/events/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventProcessor = exports.InputIdentifyEvent = exports.InputEvalEvent = exports.InputCustomEvent = void 0;
+const InputCustomEvent_1 = require("./InputCustomEvent");
+exports.InputCustomEvent = InputCustomEvent_1.default;
+const InputEvalEvent_1 = require("./InputEvalEvent");
+exports.InputEvalEvent = InputEvalEvent_1.default;
+const InputIdentifyEvent_1 = require("./InputIdentifyEvent");
+exports.InputIdentifyEvent = InputIdentifyEvent_1.default;
+const EventProcessor_1 = require("./EventProcessor");
+exports.EventProcessor = EventProcessor_1.default;
+//# sourceMappingURL=index.js.map

package/dist/internal/events/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/events/index.ts"],"names":[],"mappings":";;;AAAA,yDAAkD;AAMzC,2BANF,0BAAgB,CAME;AALzB,qDAA8C;AAKnB,yBALpB,wBAAc,CAKoB;AAHzC,6DAAsD;AAGC,6BAHhD,4BAAkB,CAGgD;AAFzE,qDAA8C;AAE6B,yBAFpE,wBAAc,CAEoE"}

package/dist/internal/index.d.ts

@@ -0,0 +1,2 @@
+export * from './events';
+//# sourceMappingURL=index.d.ts.map

package/dist/internal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/internal/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./events"), exports);
+//# sourceMappingURL=index.js.map

package/dist/internal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/internal/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB"}

package/dist/logging/BasicLogger.d.ts

@@ -0,0 +1,27 @@
+import { BasicLoggerOptions, LDLogger } from '../api';
+/**
+ * A basic logger which handles filtering by level.
+ *
+ * With the default options it will write to `console.error`
+ * and it will use the formatting provided by `console.error`.
+ * If the destination is overwritten, then it will use an included
+ * formatter similar to `util.format`.
+ *
+ * If a formatter is available, then that should be overridden
+ * as well for performance.
+ */
+export default class BasicLogger implements LDLogger {
+    private logLevel;
+    private name;
+    private destination?;
+    private formatter?;
+    constructor(options: BasicLoggerOptions);
+    private tryFormat;
+    private tryWrite;
+    private log;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    debug(...args: any[]): void;
+}
+//# sourceMappingURL=BasicLogger.d.ts.map

package/dist/logging/BasicLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicLogger.d.ts","sourceRoot":"","sources":["../../src/logging/BasicLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAatD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,YAAW,QAAQ;IAClD,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,IAAI,CAAS;IAErB,OAAO,CAAC,WAAW,CAAC,CAAyB;IAE7C,OAAO,CAAC,SAAS,CAAC,CAA6B;gBAEnC,OAAO,EAAE,kBAAkB;IAQvC,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,QAAQ;IAShB,OAAO,CAAC,GAAG;IAoBX,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI1B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI1B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAG5B"}

package/dist/logging/BasicLogger.js

@@ -0,0 +1,89 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const format_1 = require("./format");
+const LogPriority = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    none: 4,
+};
+const LevelNames = ['debug', 'info', 'warn', 'error', 'none'];
+/**
+ * A basic logger which handles filtering by level.
+ *
+ * With the default options it will write to `console.error`
+ * and it will use the formatting provided by `console.error`.
+ * If the destination is overwritten, then it will use an included
+ * formatter similar to `util.format`.
+ *
+ * If a formatter is available, then that should be overridden
+ * as well for performance.
+ */
+class BasicLogger {
+    constructor(options) {
+        var _a, _b, _c;
+        this.logLevel = (_b = LogPriority[(_a = options.level) !== null && _a !== void 0 ? _a : 'info']) !== null && _b !== void 0 ? _b : LogPriority.info;
+        this.name = (_c = options.name) !== null && _c !== void 0 ? _c : 'LaunchDarkly';
+        // eslint-disable-next-line no-console
+        this.destination = options.destination;
+        this.formatter = options.formatter;
+    }
+    tryFormat(...args) {
+        var _a;
+        try {
+            if (this.formatter) {
+                // In case the provided formatter fails.
+                return (_a = this.formatter) === null || _a === void 0 ? void 0 : _a.call(this, ...args);
+            }
+            return (0, format_1.default)(...args);
+        }
+        catch (_b) {
+            return (0, format_1.default)(...args);
+        }
+    }
+    tryWrite(msg) {
+        try {
+            this.destination(msg);
+        }
+        catch (_a) {
+            // eslint-disable-next-line no-console
+            console.error(msg);
+        }
+    }
+    log(level, args) {
+        if (level >= this.logLevel) {
+            const prefix = `${LevelNames[level]}: [${this.name}]`;
+            try {
+                if (this.destination) {
+                    this.tryWrite(this.tryFormat(prefix, ...args));
+                }
+                else {
+                    // `console.error` has its own formatter.
+                    // So we don't need to do anything.
+                    // eslint-disable-next-line no-console
+                    console.error(...args);
+                }
+            }
+            catch (_a) {
+                // If all else fails do not break.
+                // eslint-disable-next-line no-console
+                console.error(...args);
+            }
+        }
+    }
+    error(...args) {
+        this.log(LogPriority.error, args);
+    }
+    warn(...args) {
+        this.log(LogPriority.warn, args);
+    }
+    info(...args) {
+        this.log(LogPriority.info, args);
+    }
+    debug(...args) {
+        this.log(LogPriority.debug, args);
+    }
+}
+exports.default = BasicLogger;
+//# sourceMappingURL=BasicLogger.js.map

package/dist/logging/BasicLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BasicLogger.js","sourceRoot":"","sources":["../../src/logging/BasicLogger.ts"],"names":[],"mappings":";;AACA,qCAA8B;AAE9B,MAAM,WAAW,GAAG;IAClB,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,IAAI,EAAE,CAAC;IACP,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;CACR,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AAE9D;;;;;;;;;;GAUG;AACH,MAAqB,WAAW;IAS9B,YAAY,OAA2B;;QACrC,IAAI,CAAC,QAAQ,GAAG,MAAA,WAAW,CAAC,MAAA,OAAO,CAAC,KAAK,mCAAI,MAAM,CAAC,mCAAI,WAAW,CAAC,IAAI,CAAC;QACzE,IAAI,CAAC,IAAI,GAAG,MAAA,OAAO,CAAC,IAAI,mCAAI,cAAc,CAAC;QAC3C,sCAAsC;QACtC,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;IACrC,CAAC;IAEO,SAAS,CAAC,GAAG,IAAW;;QAC9B,IAAI;YACF,IAAI,IAAI,CAAC,SAAS,EAAE;gBAClB,wCAAwC;gBACxC,OAAO,MAAA,IAAI,CAAC,SAAS,qDAAG,GAAG,IAAI,CAAC,CAAC;aAClC;YACD,OAAO,IAAA,gBAAM,EAAC,GAAG,IAAI,CAAC,CAAC;SACxB;QAAC,WAAM;YACN,OAAO,IAAA,gBAAM,EAAC,GAAG,IAAI,CAAC,CAAC;SACxB;IACH,CAAC;IAEO,QAAQ,CAAC,GAAW;QAC1B,IAAI;YACF,IAAI,CAAC,WAAY,CAAC,GAAG,CAAC,CAAC;SACxB;QAAC,WAAM;YACN,sCAAsC;YACtC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;SACpB;IACH,CAAC;IAEO,GAAG,CAAC,KAAa,EAAE,IAAW;QACpC,IAAI,KAAK,IAAI,IAAI,CAAC,QAAQ,EAAE;YAC1B,MAAM,MAAM,GAAG,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,IAAI,GAAG,CAAC;YACtD,IAAI;gBACF,IAAI,IAAI,CAAC,WAAW,EAAE;oBACpB,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;iBAChD;qBAAM;oBACL,yCAAyC;oBACzC,mCAAmC;oBACnC,sCAAsC;oBACtC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;iBACxB;aACF;YAAC,WAAM;gBACN,kCAAkC;gBAClC,sCAAsC;gBACtC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;aACxB;SACF;IACH,CAAC;IAED,KAAK,CAAC,GAAG,IAAW;QAClB,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,GAAG,IAAW;QAClB,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC;CACF;AAzED,8BAyEC"}

package/dist/logging/SafeLogger.d.ts

@@ -0,0 +1,28 @@
+import { LDLogger } from '../api';
+/**
+ * The safeLogger logic exists because we allow the application to pass in a custom logger, but
+ * there is no guarantee that the logger works correctly and if it ever throws exceptions there
+ * could be serious consequences (e.g. an uncaught exception within an error event handler, due
+ * to the SDK trying to log the error, can terminate the application). An exception could result
+ * from faulty logic in the logger implementation, or it could be that this is not a logger at
+ * all but some other kind of object; the former is handled by a catch block that logs an error
+ * message to the SDK's default logger, and we can at least partly guard against the latter by
+ * checking for the presence of required methods at configuration time.
+ */
+export default class SafeLogger implements LDLogger {
+    private logger;
+    private fallback;
+    /**
+     * Construct a safe logger with the specified logger.
+     * @param logger The logger to use.
+     * @param fallback A fallback logger to use in case an issue is  encountered using
+     * the provided logger.
+     */
+    constructor(logger: LDLogger, fallback: LDLogger);
+    private log;
+    error(...args: any[]): void;
+    warn(...args: any[]): void;
+    info(...args: any[]): void;
+    debug(...args: any[]): void;
+}
+//# sourceMappingURL=SafeLogger.d.ts.map

package/dist/logging/SafeLogger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SafeLogger.d.ts","sourceRoot":"","sources":["../../src/logging/SafeLogger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAUlC;;;;;;;;;GASG;AACH,MAAM,CAAC,OAAO,OAAO,UAAW,YAAW,QAAQ;IACjD,OAAO,CAAC,MAAM,CAAW;IAEzB,OAAO,CAAC,QAAQ,CAAW;IAE3B;;;;;OAKG;gBACS,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ;IAchD,OAAO,CAAC,GAAG;IASX,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI3B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI1B,IAAI,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;IAI1B,KAAK,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI;CAG5B"}

package/dist/logging/SafeLogger.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const validators_1 = require("../validators");
+const loggerRequirements = {
+    error: validators_1.TypeValidators.Function,
+    warn: validators_1.TypeValidators.Function,
+    info: validators_1.TypeValidators.Function,
+    debug: validators_1.TypeValidators.Function,
+};
+/**
+ * The safeLogger logic exists because we allow the application to pass in a custom logger, but
+ * there is no guarantee that the logger works correctly and if it ever throws exceptions there
+ * could be serious consequences (e.g. an uncaught exception within an error event handler, due
+ * to the SDK trying to log the error, can terminate the application). An exception could result
+ * from faulty logic in the logger implementation, or it could be that this is not a logger at
+ * all but some other kind of object; the former is handled by a catch block that logs an error
+ * message to the SDK's default logger, and we can at least partly guard against the latter by
+ * checking for the presence of required methods at configuration time.
+ */
+class SafeLogger {
+    /**
+     * Construct a safe logger with the specified logger.
+     * @param logger The logger to use.
+     * @param fallback A fallback logger to use in case an issue is  encountered using
+     * the provided logger.
+     */
+    constructor(logger, fallback) {
+        Object.entries(loggerRequirements).forEach(([level, validator]) => {
+            if (!validator.is(logger[level])) {
+                throw new Error(`Provided logger instance must support logger.${level}(...) method`);
+                // Note that the SDK normally does not throw exceptions to the application, but that rule
+                // does not apply to LDClient.init() which will throw an exception if the parameters are so
+                // invalid that we cannot proceed with creating the client. An invalid logger meets those
+                // criteria since the SDK calls the logger during nearly all of its operations.
+            }
+        });
+        this.logger = logger;
+        this.fallback = fallback;
+    }
+    log(level, args) {
+        try {
+            this.logger[level](...args);
+        }
+        catch (_a) {
+            // If all else fails do not break.
+            this.fallback[level](...args);
+        }
+    }
+    error(...args) {
+        this.log('error', args);
+    }
+    warn(...args) {
+        this.log('warn', args);
+    }
+    info(...args) {
+        this.log('info', args);
+    }
+    debug(...args) {
+        this.log('debug', args);
+    }
+}
+exports.default = SafeLogger;
+//# sourceMappingURL=SafeLogger.js.map

package/dist/logging/SafeLogger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SafeLogger.js","sourceRoot":"","sources":["../../src/logging/SafeLogger.ts"],"names":[],"mappings":";;AACA,8CAA+C;AAE/C,MAAM,kBAAkB,GAAG;IACzB,KAAK,EAAE,2BAAc,CAAC,QAAQ;IAC9B,IAAI,EAAE,2BAAc,CAAC,QAAQ;IAC7B,IAAI,EAAE,2BAAc,CAAC,QAAQ;IAC7B,KAAK,EAAE,2BAAc,CAAC,QAAQ;CAC/B,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAqB,UAAU;IAK7B;;;;;OAKG;IACH,YAAY,MAAgB,EAAE,QAAkB;QAC9C,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,EAAE;YAChE,IAAI,CAAC,SAAS,CAAC,EAAE,CAAE,MAAc,CAAC,KAAK,CAAC,CAAC,EAAE;gBACzC,MAAM,IAAI,KAAK,CAAC,gDAAgD,KAAK,cAAc,CAAC,CAAC;gBACrF,yFAAyF;gBACzF,2FAA2F;gBAC3F,yFAAyF;gBACzF,+EAA+E;aAChF;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAEO,GAAG,CAAC,KAA0C,EAAE,IAAW;QACjE,IAAI;YACF,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;SAC7B;QAAC,WAAM;YACN,kCAAkC;YAClC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;SAC/B;IACH,CAAC;IAED,KAAK,CAAC,GAAG,IAAW;QAClB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,IAAI,CAAC,GAAG,IAAW;QACjB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,GAAG,IAAW;QAClB,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;CACF;AAjDD,6BAiDC"}

package/dist/logging/format.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=format.d.ts.map

package/dist/logging/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/logging/format.ts"],"names":[],"mappings":""}

package/dist/logging/format.js

@@ -0,0 +1,156 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const validators_1 = require("../validators");
+/**
+ * Attempt to produce a string representation of a value.
+ * The format should be roughly comparable to `util.format`
+ * aside from object which will be JSON versus the `util.inspect`
+ * format.
+ * @param val
+ * @returns A string representation of the value if possible.
+ */
+function tryStringify(val) {
+    if (typeof val === 'string') {
+        return val;
+    }
+    if (val === undefined) {
+        return 'undefined';
+    }
+    if (val === null) {
+        return 'null';
+    }
+    if (Object.prototype.hasOwnProperty.call(val, 'toString')) {
+        try {
+            return val.toString();
+        }
+        catch (_a) {
+            /* Keep going */
+        }
+    }
+    if (typeof val === 'bigint') {
+        return `${val}n`;
+    }
+    try {
+        return JSON.stringify(val);
+    }
+    catch (error) {
+        if (error instanceof TypeError && error.message.indexOf('circular') >= 0) {
+            return '[Circular]';
+        }
+        return '[Not Stringifiable]';
+    }
+}
+/**
+ * Attempt to produce a numeric representation.
+ * BigInts have an `n` suffix.
+ * @param val
+ * @returns The numeric representation or 'NaN' if not numeric.
+ */
+function toNumber(val) {
+    // Symbol has to be treated special because it will
+    // throw an exception if an attempt is made to convert it.
+    if (typeof val === 'symbol') {
+        return 'NaN';
+    }
+    if (typeof val === 'bigint') {
+        return `${val}n`;
+    }
+    return String(Number(val));
+}
+/**
+ * Attempt to produce an integer representation.
+ * BigInts have an `n` suffix.
+ * @param val
+ * @returns The integer representation or 'NaN' if not numeric.
+ */
+function toInt(val) {
+    if (typeof val === 'symbol') {
+        return 'NaN';
+    }
+    if (typeof val === 'bigint') {
+        return `${val}n`;
+    }
+    return String(parseInt(val, 10));
+}
+/**
+ * Attempt to produce a float representation.
+ * BigInts have an `n` suffix.
+ * @param val
+ * @returns The integer representation or 'NaN' if not numeric.
+ */
+function toFloat(val) {
+    if (typeof val === 'symbol') {
+        return 'NaN';
+    }
+    return String(parseFloat(val));
+}
+// Based on:
+// https://nodejs.org/api/util.html#utilformatformat-args
+// The result will not match node exactly, but it should get the
+// right information through.
+const escapes = {
+    s: (val) => tryStringify(val),
+    d: (val) => toNumber(val),
+    i: (val) => toInt(val),
+    f: (val) => toFloat(val),
+    j: (val) => tryStringify(val),
+    o: (val) => tryStringify(val),
+    O: (val) => tryStringify(val),
+    c: () => '',
+};
+/**
+ * A basic formatted for use where `util.format` is not available.
+ * This will not be as performant, but it will produce formatted
+ * messages.
+ *
+ * @internal
+ *
+ * @param args
+ * @returns Formatted string.
+ */
+function format(...args) {
+    var _a;
+    const formatString = args.shift();
+    if (validators_1.TypeValidators.String.is(formatString)) {
+        let out = '';
+        let i = 0;
+        while (i < formatString.length) {
+            const char = formatString.charAt(i);
+            if (char === '%') {
+                const nextIndex = i + 1;
+                if (nextIndex < formatString.length) {
+                    const nextChar = formatString.charAt(i + 1);
+                    if (nextChar in escapes && args.length) {
+                        const value = args.shift();
+                        // This rule is for math.
+                        // eslint-disable-next-line no-unsafe-optional-chaining
+                        out += (_a = escapes[nextChar]) === null || _a === void 0 ? void 0 : _a.call(escapes, value);
+                    }
+                    else if (nextChar === '%') {
+                        out += '%';
+                    }
+                    else {
+                        out += `%${nextChar}`;
+                    }
+                    i += 2;
+                }
+            }
+            else {
+                out += char;
+                i += 1;
+            }
+        }
+        // If there are any args left after we exhaust the format string
+        // then just stick those on the end.
+        if (args.length) {
+            if (out.length) {
+                out += ' ';
+            }
+            out += args.map(tryStringify).join(' ');
+        }
+        return out;
+    }
+    return args.map(tryStringify).join(' ');
+}
+exports.default = format;
+//# sourceMappingURL=format.js.map

package/dist/logging/format.js.map

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

package/dist/logging/index.d.ts

@@ -0,0 +1,4 @@
+import BasicLogger from './BasicLogger';
+import SafeLogger from './SafeLogger';
+export { BasicLogger, SafeLogger };
+//# sourceMappingURL=index.d.ts.map

package/dist/logging/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,eAAe,CAAC;AACxC,OAAO,UAAU,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC"}

package/dist/logging/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SafeLogger = exports.BasicLogger = void 0;
+const BasicLogger_1 = require("./BasicLogger");
+exports.BasicLogger = BasicLogger_1.default;
+const SafeLogger_1 = require("./SafeLogger");
+exports.SafeLogger = SafeLogger_1.default;
+//# sourceMappingURL=index.js.map

package/dist/logging/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/logging/index.ts"],"names":[],"mappings":";;;AAAA,+CAAwC;AAG/B,sBAHF,qBAAW,CAGE;AAFpB,6CAAsC;AAEhB,qBAFf,oBAAU,CAEe"}

package/dist/options/ApplicationTags.d.ts

@@ -0,0 +1,15 @@
+import { LDLogger } from '../api';
+/**
+ * Class for managing tags.
+ */
+export default class ApplicationTags {
+    readonly value?: string;
+    constructor(options: {
+        application?: {
+            id?: string;
+            version?: string;
+        };
+        logger?: LDLogger;
+    });
+}
+//# sourceMappingURL=ApplicationTags.d.ts.map

package/dist/options/ApplicationTags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicationTags.d.ts","sourceRoot":"","sources":["../../src/options/ApplicationTags.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAuBlC;;GAEG;AACH,MAAM,CAAC,OAAO,OAAO,eAAe;IAClC,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEnB,OAAO,EAAE;QAAE,WAAW,CAAC,EAAE;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,OAAO,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,MAAM,CAAC,EAAE,QAAQ,CAAA;KAAE;CA+B5F"}

package/dist/options/ApplicationTags.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const validators_1 = require("../validators");
+const OptionMessages_1 = require("./OptionMessages");
+/**
+ * Expression to validate characters that are allowed in tag keys and values.
+ */
+const allowedTagCharacters = /^(\w|\.|-)+$/;
+const regexValidator = validators_1.TypeValidators.stringMatchingRegex(allowedTagCharacters);
+const tagValidator = {
+    is: (u, name) => {
+        if (regexValidator.is(u)) {
+            if (u.length > 64) {
+                return { valid: false, message: OptionMessages_1.default.tagValueTooLong(name) };
+            }
+            return { valid: true };
+        }
+        return { valid: false, message: OptionMessages_1.default.invalidTagValue(name) };
+    },
+};
+/**
+ * Class for managing tags.
+ */
+class ApplicationTags {
+    constructor(options) {
+        var _a, _b;
+        const tags = {};
+        const application = options === null || options === void 0 ? void 0 : options.application;
+        if ((application === null || application === void 0 ? void 0 : application.id) !== null && (application === null || application === void 0 ? void 0 : application.id) !== undefined) {
+            const { valid, message } = tagValidator.is(application.id, 'application.id');
+            if (!valid) {
+                (_a = options.logger) === null || _a === void 0 ? void 0 : _a.warn(message);
+            }
+            else {
+                tags['application-id'] = [application.id];
+            }
+        }
+        if ((application === null || application === void 0 ? void 0 : application.version) !== null && (application === null || application === void 0 ? void 0 : application.version) !== undefined) {
+            const { valid, message } = tagValidator.is(application.version, 'application.version');
+            if (!valid) {
+                (_b = options.logger) === null || _b === void 0 ? void 0 : _b.warn(message);
+            }
+            else {
+                tags['application-version'] = [application.version];
+            }
+        }
+        const tagKeys = Object.keys(tags);
+        if (tagKeys.length) {
+            this.value = tagKeys
+                .sort()
+                .flatMap((key) => tags[key].sort().map((value) => `${key}/${value}`))
+                .join(' ');
+        }
+    }
+}
+exports.default = ApplicationTags;
+//# sourceMappingURL=ApplicationTags.js.map

package/dist/options/ApplicationTags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ApplicationTags.js","sourceRoot":"","sources":["../../src/options/ApplicationTags.ts"],"names":[],"mappings":";;AACA,8CAA+C;AAC/C,qDAA8C;AAE9C;;GAEG;AACH,MAAM,oBAAoB,GAAG,cAAc,CAAC;AAE5C,MAAM,cAAc,GAAG,2BAAc,CAAC,mBAAmB,CAAC,oBAAoB,CAAC,CAAC;AAEhF,MAAM,YAAY,GAAG;IACnB,EAAE,EAAE,CAAC,CAAU,EAAE,IAAY,EAAwC,EAAE;QACrE,IAAI,cAAc,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;YACxB,IAAI,CAAC,CAAC,MAAM,GAAG,EAAE,EAAE;gBACjB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,wBAAc,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;aACxE;YACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;SACxB;QACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,wBAAc,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;IACzE,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAqB,eAAe;IAGlC,YAAY,OAA+E;;QACzF,MAAM,IAAI,GAA6B,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAG,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,WAAW,CAAC;QAEzC,IAAI,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,EAAE,MAAK,IAAI,IAAI,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,EAAE,MAAK,SAAS,EAAE;YAC7D,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC,WAAW,CAAC,EAAE,EAAE,gBAAgB,CAAC,CAAC;YAE7E,IAAI,CAAC,KAAK,EAAE;gBACV,MAAA,OAAO,CAAC,MAAM,0CAAE,IAAI,CAAC,OAAO,CAAC,CAAC;aAC/B;iBAAM;gBACL,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;aAC3C;SACF;QAED,IAAI,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,OAAO,MAAK,IAAI,IAAI,CAAA,WAAW,aAAX,WAAW,uBAAX,WAAW,CAAE,OAAO,MAAK,SAAS,EAAE;YACvE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY,CAAC,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,qBAAqB,CAAC,CAAC;YACvF,IAAI,CAAC,KAAK,EAAE;gBACV,MAAA,OAAO,CAAC,MAAM,0CAAE,IAAI,CAAC,OAAO,CAAC,CAAC;aAC/B;iBAAM;gBACL,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;aACrD;SACF;QAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClC,IAAI,OAAO,CAAC,MAAM,EAAE;YAClB,IAAI,CAAC,KAAK,GAAG,OAAO;iBACjB,IAAI,EAAE;iBACN,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;iBACpE,IAAI,CAAC,GAAG,CAAC,CAAC;SACd;IACH,CAAC;CACF;AAlCD,kCAkCC"}