@matter/general 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/cjs/log/Logger.d.ts

@@ -0,0 +1,220 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { LogLevel } from "./LogLevel.js";
+/**
+ * Log messages to the console.  This is the default logging mechanism.
+ */
+export declare function consoleLogger(level: LogLevel, formattedLog: string): void;
+export declare namespace consoleLogger {
+    /**
+     * The target for consoleLogger.
+     */
+    let console: Console;
+}
+/**
+ * Definition of one registered Logger.
+ */
+type LoggerDefinition = {
+    logIdentifier: string;
+    logFormatter: (now: Date, level: LogLevel, facility: string, prefix: string, ...values: any[]) => string;
+    log: (level: LogLevel, formattedLog: string) => void;
+    defaultLogLevel: LogLevel;
+    logLevels: {
+        [facility: string]: LogLevel;
+    };
+};
+/**
+ * Logger that can be used to emit traces.
+ *
+ * The class supports adding multiple loggers for different targets. A default logger (identifier "default") is added on
+ * startup which logs to "console".
+ *
+ * Usage:
+ *
+ *   const facility = Logger.get("loggerName");
+ *   facility.debug("My debug message", "my extra value to log");
+ *
+ * The configuration of the default logger can be adjusted by using the static properties of the Logger class:
+ *
+ *   - Logger.defaultLogLevel sets the default log level for all the facility
+ *   - Logger.logLevels = { loggerName: Level.DEBUG } can set the level for the specific loggers
+ *   - Logger.format = Format.ANSI enables colorization via ANSI escape sequences in default formatter
+ *
+ * For additional loggers, use Logger.addLogger() to add a new logger with a specific identifier. Afterwards the
+ * configuration of these can be adjusted using static methods with the identifier as first parameter:
+ *
+ *   - Logger.setFormatForLogger("loggerName", Format.ANSI)
+ *   - Logger.setLogLevelsForLogger("loggerName", { loggerName: Level.DEBUG })
+ *   - Logger.setDefaultLoglevelForLogger("loggerName", Level.DEBUG)
+ */
+export declare class Logger {
+    private readonly name;
+    static logger: LoggerDefinition[];
+    static nestingLevel: number;
+    /** Add additional logger to the list of loggers including the default configuration. */
+    static addLogger(identifier: string, logger: (level: LogLevel, formattedLog: string) => void, options?: {
+        defaultLogLevel?: LogLevel;
+        logLevels?: {
+            [facility: string]: LogLevel;
+        };
+        logFormat?: string;
+    }): void;
+    static removeLogger(identifier: string): void;
+    /**
+     * Get the logger with the matching identifier.
+     * @param identifier The identifier of the logger
+     */
+    static getLoggerforIdentifier(identifier: string): LoggerDefinition;
+    /**
+     * Set log level using configuration-style level name for the default logger.
+     */
+    static set level(level: number | string);
+    /**
+     * Set logFormatter using configuration-style format name.
+     *
+     * @param format the name of the formatter (see Format enum)
+     */
+    static set format(format: string);
+    /**
+     * Set facility loglevels for the default logger.
+     * @param levels The levels to set
+     */
+    static set logLevels(levels: {
+        [facility: string]: LogLevel;
+    });
+    /**
+     * Get facility loglevels for the default logger.
+     */
+    static get logLevels(): {
+        [facility: string]: LogLevel;
+    };
+    /**
+     * Set default loglevel for the default logger.
+     *
+     * @param level The level to set
+     */
+    static set defaultLogLevel(level: LogLevel);
+    /**
+     * Get default loglevel for the default logger.
+     */
+    static get defaultLogLevel(): LogLevel;
+    /**
+     * Set the log function for the default logger.
+     *
+     * @param log The log function to set
+     */
+    static set log(log: (level: LogLevel, formattedLog: string) => void);
+    /**
+     * Get the log function for the default logger.
+     */
+    static get log(): (level: LogLevel, formattedLog: string) => void;
+    /**
+     * Set the log formatter for the default logger.
+     *
+     * @param logFormatter
+     */
+    static set logFormatter(logFormatter: (now: Date, level: LogLevel, facility: string, nestingPrefix: string, values: any[]) => string);
+    /**
+     * Get the log formatter for the default logger.
+     */
+    static get logFormatter(): (now: Date, level: LogLevel, facility: string, nestingPrefix: string, values: any[]) => string;
+    /**
+     * Set logFormatter using configuration-style format name for the logger with the matching identifier.
+     *
+     * @param identifier The identifier of the logger
+     * @param format the name of the formatter (see Format enum)
+     */
+    static setFormatForLogger(identifier: string, format: string): void;
+    /**
+     * Set default loglevel for the logger with the matching identifier.
+     *
+     * @param identifier The identifier of the logger
+     * @param level The level to set
+     */
+    static setDefaultLoglevelForLogger(identifier: string, level: LogLevel): void;
+    /**
+     * Set facility loglevels for the logger with the matching identifier.
+     *
+     * @param identifier The identifier of the logger
+     * @param levels The levels to set
+     */
+    static setLogLevelsForLogger(identifier: string, levels: {
+        [facility: string]: LogLevel;
+    }): void;
+    /**
+     * Set the log function for the logger with the matching identifier.
+     *
+     * @param identifier The identifier of the logger
+     * @param log The log function to set
+     */
+    static setLogger(identifier: string, log: (level: LogLevel, formattedLog: string) => void): void;
+    /**
+     * Set the log formatter for the logger with the matching identifier.
+     *
+     * @param identifier The identifier of the logger
+     * @param logFormatter The log formatter to set
+     */
+    static setLogFormatterForLogger(identifier: string, logFormatter: (now: Date, level: LogLevel, facility: string, nestingPrefix: string, values: any[]) => string): void;
+    /**
+     * Create a new facility.
+     *
+     * @param name the name of the facility
+     * @returns a new facility
+     */
+    static get(name: string): Logger;
+    /**
+     * Stringify a value (BigInt aware) as JSON.
+     *
+     * @param data the value to stringify
+     * @returns the stringified value
+     */
+    static toJSON(data: any): string;
+    /**
+     * Mask a string with a given character. If unmaskedLength is provided then these number of characters will be
+     * shown unmasked.
+     *
+     * @param str String to mask
+     * @param maskChar character to mask with
+     * @param unmaskedLength number of characters to show unmasked in the beginning
+     */
+    static maskString(str: string, maskChar?: string, unmaskedLength?: number): string;
+    /**
+     * Perform operations in a nested logging context.  Messages will be
+     * indented while the context executes.
+     */
+    static nest<T>(context: () => T): T;
+    /**
+     * Async version of nest().
+     */
+    static nestAsync(context: () => Promise<any>): Promise<any>;
+    /**
+     * Unhandled error reporter.
+     *
+     * Some environments do not report full error details such as {@link Error#cause} and {@link AggregateError#errors}.
+     *
+     * To ensure these details are always recorded somewhere, unhandled errors may be reported here.
+     *
+     * To disable this behavior replace this function.
+     */
+    static reportUnhandledError(error: Error): void;
+    /**
+     * Invoke logic and return any log messages produced.
+     */
+    static capture(fn: () => void, fromLogger?: string): {
+        level: LogLevel;
+        message: string;
+    }[];
+    constructor(name: string);
+    debug: (...values: any[]) => void;
+    info: (...values: any[]) => void;
+    notice: (...values: any[]) => void;
+    warn: (...values: any[]) => void;
+    error: (...values: any[]) => void;
+    fatal: (...values: any[]) => void;
+    private log;
+}
+export {};
+//# sourceMappingURL=Logger.d.ts.map

package/dist/cjs/log/Logger.d.ts.map

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

package/dist/cjs/log/Logger.js

@@ -0,0 +1,401 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Logger_exports = {};
+__export(Logger_exports, {
+  Logger: () => Logger,
+  consoleLogger: () => consoleLogger
+});
+module.exports = __toCommonJS(Logger_exports);
+var import_MatterError = require("../MatterError.js");
+var import_Time = require("../time/Time.js");
+var import_Bytes = require("../util/Bytes.js");
+var import_Diagnostic = require("./Diagnostic.js");
+var import_LogFormat = require("./LogFormat.js");
+var import_LogLevel = require("./LogLevel.js");
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+function consoleLogger(level, formattedLog) {
+  const console2 = consoleLogger.console;
+  switch (level) {
+    case import_LogLevel.LogLevel.DEBUG:
+      console2.debug(formattedLog);
+      break;
+    case import_LogLevel.LogLevel.INFO:
+      console2.info(formattedLog);
+      break;
+    case import_LogLevel.LogLevel.NOTICE:
+      console2.info(formattedLog);
+      break;
+    case import_LogLevel.LogLevel.WARN:
+      console2.warn(formattedLog);
+      break;
+    case import_LogLevel.LogLevel.ERROR:
+      console2.error(formattedLog);
+      break;
+    case import_LogLevel.LogLevel.FATAL:
+      console2.error(formattedLog);
+      break;
+  }
+}
+const globalConsole = console;
+((consoleLogger2) => {
+  consoleLogger2.console = globalConsole;
+})(consoleLogger || (consoleLogger = {}));
+function logFormatterFor(formatName) {
+  const format = (0, import_LogFormat.LogFormat)(formatName);
+  return (now, level, facility, prefix, ...values) => format(import_Diagnostic.Diagnostic.message({ now, level, facility, prefix, values }));
+}
+class Logger {
+  constructor(name) {
+    this.name = name;
+  }
+  static logger = new Array({
+    logIdentifier: "default",
+    logFormatter: import_LogFormat.LogFormat.plain,
+    log: consoleLogger,
+    defaultLogLevel: import_LogLevel.LogLevel.DEBUG,
+    logLevels: {}
+  });
+  static nestingLevel = 0;
+  /** Add additional logger to the list of loggers including the default configuration. */
+  static addLogger(identifier, logger, options) {
+    if (Logger.logger.some((logger2) => logger2.logIdentifier === identifier)) {
+      throw new import_MatterError.NotImplementedError(`Logger "${identifier}" already exists`);
+    }
+    Logger.logger.push({
+      logIdentifier: identifier,
+      logFormatter: logFormatterFor(options?.logFormat ?? import_LogFormat.LogFormat.PLAIN),
+      log: logger,
+      defaultLogLevel: options?.defaultLogLevel ?? import_LogLevel.LogLevel.DEBUG,
+      logLevels: options?.logLevels ?? {}
+    });
+  }
+  static removeLogger(identifier) {
+    const index = Logger.logger.findIndex((logger) => logger.logIdentifier === identifier);
+    if (index === -1) {
+      throw new import_MatterError.NotImplementedError(`Logger "${identifier}" does not exist`);
+    }
+    Logger.logger.splice(index, 1);
+  }
+  /**
+   * Get the logger with the matching identifier.
+   * @param identifier The identifier of the logger
+   */
+  static getLoggerforIdentifier(identifier) {
+    const logger = Logger.logger.find((logger2) => logger2.logIdentifier === identifier);
+    if (logger === void 0) {
+      throw new import_MatterError.NotImplementedError(`Unknown logger "${identifier}"`);
+    }
+    return logger;
+  }
+  /**
+   * Set log level using configuration-style level name for the default logger.
+   */
+  static set level(level) {
+    if (level === void 0) {
+      level = import_LogLevel.LogLevel.DEBUG;
+    }
+    let levelNum;
+    if (typeof level === "string") {
+      if (level.match(/^[0-9]+$/)) {
+        levelNum = Number.parseInt(level);
+      } else {
+        levelNum = import_LogLevel.LogLevel[level.toUpperCase()];
+        if (levelNum === void 0) {
+          throw new import_MatterError.ImplementationError(`Unsupported log level "${level}"`);
+        }
+      }
+    } else {
+      levelNum = level;
+    }
+    if (import_LogLevel.LogLevel[levelNum] === void 0) {
+      throw new import_MatterError.ImplementationError(`Unsupported log level "${level}"`);
+    }
+    Logger.defaultLogLevel = levelNum;
+  }
+  /**
+   * Set logFormatter using configuration-style format name.
+   *
+   * @param format the name of the formatter (see Format enum)
+   */
+  static set format(format) {
+    Logger.setLogFormatterForLogger("default", logFormatterFor(format));
+  }
+  /**
+   * Set facility loglevels for the default logger.
+   * @param levels The levels to set
+   */
+  static set logLevels(levels) {
+    Logger.setLogLevelsForLogger("default", levels);
+  }
+  /**
+   * Get facility loglevels for the default logger.
+   */
+  static get logLevels() {
+    return Logger.getLoggerforIdentifier("default").logLevels;
+  }
+  /**
+   * Set default loglevel for the default logger.
+   *
+   * @param level The level to set
+   */
+  static set defaultLogLevel(level) {
+    Logger.setDefaultLoglevelForLogger("default", level);
+  }
+  /**
+   * Get default loglevel for the default logger.
+   */
+  static get defaultLogLevel() {
+    return Logger.getLoggerforIdentifier("default").defaultLogLevel;
+  }
+  /**
+   * Set the log function for the default logger.
+   *
+   * @param log The log function to set
+   */
+  static set log(log) {
+    Logger.setLogger("default", log);
+  }
+  /**
+   * Get the log function for the default logger.
+   */
+  static get log() {
+    return Logger.getLoggerforIdentifier("default").log;
+  }
+  /**
+   * Set the log formatter for the default logger.
+   *
+   * @param logFormatter
+   */
+  static set logFormatter(logFormatter) {
+    Logger.setLogFormatterForLogger("default", logFormatter);
+  }
+  /**
+   * Get the log formatter for the default logger.
+   */
+  static get logFormatter() {
+    return Logger.getLoggerforIdentifier("default").logFormatter;
+  }
+  /**
+   * Set logFormatter using configuration-style format name for the logger with the matching identifier.
+   *
+   * @param identifier The identifier of the logger
+   * @param format the name of the formatter (see Format enum)
+   */
+  static setFormatForLogger(identifier, format) {
+    const logger = Logger.logger.find((logger2) => logger2.logIdentifier === identifier);
+    if (logger) {
+      logger.logFormatter = logFormatterFor(format);
+    } else {
+      throw new import_MatterError.NotImplementedError(`Unknown logger "${identifier}"`);
+    }
+  }
+  /**
+   * Set default loglevel for the logger with the matching identifier.
+   *
+   * @param identifier The identifier of the logger
+   * @param level The level to set
+   */
+  static setDefaultLoglevelForLogger(identifier, level) {
+    const logger = Logger.logger.find((logger2) => logger2.logIdentifier === identifier);
+    if (logger) {
+      logger.defaultLogLevel = level;
+    } else {
+      throw new import_MatterError.NotImplementedError(`Unknown logger "${identifier}"`);
+    }
+  }
+  /**
+   * Set facility loglevels for the logger with the matching identifier.
+   *
+   * @param identifier The identifier of the logger
+   * @param levels The levels to set
+   */
+  static setLogLevelsForLogger(identifier, levels) {
+    const logger = Logger.logger.find((logger2) => logger2.logIdentifier === identifier);
+    if (logger) {
+      logger.logLevels = levels;
+    } else {
+      throw new import_MatterError.NotImplementedError(`Unknown logger "${identifier}"`);
+    }
+  }
+  /**
+   * Set the log function for the logger with the matching identifier.
+   *
+   * @param identifier The identifier of the logger
+   * @param log The log function to set
+   */
+  static setLogger(identifier, log) {
+    const logger = Logger.logger.find((logger2) => logger2.logIdentifier === identifier);
+    if (logger) {
+      logger.log = log;
+    } else {
+      throw new import_MatterError.NotImplementedError(`Unknown logger "${identifier}"`);
+    }
+  }
+  /**
+   * Set the log formatter for the logger with the matching identifier.
+   *
+   * @param identifier The identifier of the logger
+   * @param logFormatter The log formatter to set
+   */
+  static setLogFormatterForLogger(identifier, logFormatter) {
+    const logger = Logger.logger.find((logger2) => logger2.logIdentifier === identifier);
+    if (logger) {
+      logger.logFormatter = logFormatter;
+    } else {
+      throw new import_MatterError.NotImplementedError(`Unknown logger "${identifier}"`);
+    }
+  }
+  /**
+   * Create a new facility.
+   *
+   * @param name the name of the facility
+   * @returns a new facility
+   */
+  static get(name) {
+    return new Logger(name);
+  }
+  /**
+   * Stringify a value (BigInt aware) as JSON.
+   *
+   * @param data the value to stringify
+   * @returns the stringified value
+   */
+  static toJSON(data) {
+    return JSON.stringify(data, (_, value) => {
+      if (typeof value === "bigint") {
+        return value.toString();
+      }
+      if (value instanceof Uint8Array) {
+        return import_Bytes.Bytes.toHex(value);
+      }
+      if (value === void 0) {
+        return "undefined";
+      }
+      return value;
+    });
+  }
+  /**
+   * Mask a string with a given character. If unmaskedLength is provided then these number of characters will be
+   * shown unmasked.
+   *
+   * @param str String to mask
+   * @param maskChar character to mask with
+   * @param unmaskedLength number of characters to show unmasked in the beginning
+   */
+  static maskString(str, maskChar = "*", unmaskedLength) {
+    return str.substring(0, unmaskedLength ?? 0) + str.substring(unmaskedLength ?? 0).replace(/./g, maskChar);
+  }
+  /**
+   * Perform operations in a nested logging context.  Messages will be
+   * indented while the context executes.
+   */
+  static nest(context) {
+    this.nestingLevel++;
+    try {
+      return context();
+    } finally {
+      this.nestingLevel--;
+    }
+  }
+  /**
+   * Async version of nest().
+   */
+  static async nestAsync(context) {
+    this.nestingLevel++;
+    try {
+      return await context();
+    } finally {
+      this.nestingLevel--;
+    }
+  }
+  /**
+   * Unhandled error reporter.
+   *
+   * Some environments do not report full error details such as {@link Error#cause} and {@link AggregateError#errors}.
+   *
+   * To ensure these details are always recorded somewhere, unhandled errors may be reported here.
+   *
+   * To disable this behavior replace this function.
+   */
+  static reportUnhandledError(error) {
+    try {
+      Logger.get("Logger").fatal("Unhandled error detected:", error);
+    } catch (e) {
+    }
+  }
+  /**
+   * Invoke logic and return any log messages produced.
+   */
+  static capture(fn, fromLogger = "default") {
+    if (!Logger) {
+      throw new Error("No logger loaded, cannot capture logs");
+    }
+    const logger = Logger.getLoggerforIdentifier(fromLogger);
+    const actualLogSettings = {
+      logFormatter: logger.logFormatter,
+      log: logger.log,
+      defaultLogLevel: logger.defaultLogLevel,
+      logLevels: { ...logger.logLevels }
+    };
+    try {
+      Logger.setFormatForLogger(fromLogger, import_LogFormat.LogFormat.PLAIN);
+      const captured = new Array();
+      Logger.setLogger(
+        fromLogger,
+        (level, message) => captured.push({
+          level,
+          message: message.replace(/\d{4}-\d\d-\d\d \d\d:\d\d:\d\d\.\d\d\d/, "xxxx-xx-xx xx:xx:xx.xxx")
+        })
+      );
+      fn();
+      return captured;
+    } finally {
+      Logger.setLogFormatterForLogger(fromLogger, actualLogSettings.logFormatter);
+      Logger.setDefaultLoglevelForLogger(fromLogger, actualLogSettings.defaultLogLevel);
+      Logger.setLogLevelsForLogger(fromLogger, actualLogSettings.logLevels);
+      Logger.setLogger(fromLogger, actualLogSettings.log);
+    }
+  }
+  debug = (...values) => this.log(import_LogLevel.LogLevel.DEBUG, values);
+  info = (...values) => this.log(import_LogLevel.LogLevel.INFO, values);
+  notice = (...values) => this.log(import_LogLevel.LogLevel.NOTICE, values);
+  warn = (...values) => this.log(import_LogLevel.LogLevel.WARN, values);
+  error = (...values) => this.log(import_LogLevel.LogLevel.ERROR, values);
+  fatal = (...values) => this.log(import_LogLevel.LogLevel.FATAL, values);
+  log(level, values) {
+    Logger.logger.forEach((logger) => {
+      if (level < (logger.logLevels[this.name] ?? logger.defaultLogLevel)) return;
+      logger.log(level, logger.logFormatter(import_Time.Time.now(), level, this.name, nestingPrefix(), values));
+    });
+  }
+}
+if (typeof MatterHooks !== "undefined") {
+  MatterHooks.loggerSetup?.(Logger);
+}
+function nestingPrefix() {
+  if (Logger.nestingLevel) {
+    return "\u23B8".padEnd(Logger.nestingLevel * 2);
+  }
+  return "";
+}
+//# sourceMappingURL=Logger.js.map

package/dist/cjs/log/Logger.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/log/Logger.ts"],
+  "mappings": "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",
+  "names": ["console", "consoleLogger", "logger"]
+}

package/dist/cjs/log/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Diagnostic.js";
+export * from "./DiagnosticSource.js";
+export * from "./LogFormat.js";
+export * from "./Logger.js";
+export * from "./LogLevel.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/log/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/log/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC"}

package/dist/cjs/log/index.js

@@ -0,0 +1,28 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var log_exports = {};
+module.exports = __toCommonJS(log_exports);
+__reExport(log_exports, require("./Diagnostic.js"), module.exports);
+__reExport(log_exports, require("./DiagnosticSource.js"), module.exports);
+__reExport(log_exports, require("./LogFormat.js"), module.exports);
+__reExport(log_exports, require("./Logger.js"), module.exports);
+__reExport(log_exports, require("./LogLevel.js"), module.exports);
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+//# sourceMappingURL=index.js.map