@contentful/optimization-api-client 1.1.0 → 2.0.0

package/dist/logger.mjs

@@ -1 +1,131 @@
-export { ConsoleLogSink, LogSink, Logger, createScopedLogger, default, logLevelSeverity, logger } from "./649.mjs";
+class LogSink {
+}
+const logger_LogSink = LogSink;
+class Logger {
+    name = '@contentful/optimization';
+    PREFIX_PARTS = [
+        'Ctfl',
+        'O10n'
+    ];
+    DELIMITER = ':';
+    sinks = [];
+    assembleLocationPrefix(logLocation) {
+        return `[${[
+            ...this.PREFIX_PARTS,
+            logLocation
+        ].join(this.DELIMITER)}]`;
+    }
+    addSink(sink) {
+        this.sinks = [
+            ...this.sinks.filter((existingSink)=>existingSink.name !== sink.name),
+            sink
+        ];
+    }
+    removeSink(name) {
+        this.sinks = this.sinks.filter((sink)=>sink.name !== name);
+    }
+    removeSinks() {
+        this.sinks = [];
+    }
+    debug(logLocation, message, ...args) {
+        this.emit('debug', logLocation, message, ...args);
+    }
+    info(logLocation, message, ...args) {
+        this.emit('info', logLocation, message, ...args);
+    }
+    log(logLocation, message, ...args) {
+        this.emit('log', logLocation, message, ...args);
+    }
+    warn(logLocation, message, ...args) {
+        this.emit('warn', logLocation, message, ...args);
+    }
+    error(logLocation, message, ...args) {
+        this.emit('error', logLocation, message, ...args);
+    }
+    fatal(logLocation, message, ...args) {
+        this.emit('fatal', logLocation, message, ...args);
+    }
+    emit(level, logLocation, message, ...args) {
+        this.onLogEvent({
+            name: this.name,
+            level,
+            messages: [
+                `${this.assembleLocationPrefix(logLocation)} ${String(message)}`,
+                ...args
+            ]
+        });
+    }
+    onLogEvent(event) {
+        this.sinks.forEach((sink)=>{
+            sink.ingest(event);
+        });
+    }
+}
+const logger = new Logger();
+function createScopedLogger(location) {
+    return {
+        debug: (message, ...args)=>{
+            logger.debug(location, message, ...args);
+        },
+        info: (message, ...args)=>{
+            logger.info(location, message, ...args);
+        },
+        log: (message, ...args)=>{
+            logger.log(location, message, ...args);
+        },
+        warn: (message, ...args)=>{
+            logger.warn(location, message, ...args);
+        },
+        error: (message, ...args)=>{
+            logger.error(location, message, ...args);
+        },
+        fatal: (message, ...args)=>{
+            logger.fatal(location, message, ...args);
+        }
+    };
+}
+const logLevelSeverity = {
+    fatal: 60,
+    error: 50,
+    warn: 40,
+    info: 30,
+    debug: 20,
+    log: 10
+};
+const consoleMap = {
+    debug: (...args)=>{
+        console.debug(...args);
+    },
+    info: (...args)=>{
+        console.info(...args);
+    },
+    log: (...args)=>{
+        console.log(...args);
+    },
+    warn: (...args)=>{
+        console.warn(...args);
+    },
+    error: (...args)=>{
+        console.error(...args);
+    },
+    fatal: (...args)=>{
+        console.error(...args);
+    }
+};
+class ConsoleLogSink extends logger_LogSink {
+    name = 'ConsoleLogSink';
+    verbosity;
+    constructor(verbosity){
+        super();
+        this.verbosity = verbosity ?? 'error';
+    }
+    ingest(event) {
+        if (logLevelSeverity[event.level] < logLevelSeverity[this.verbosity]) return;
+        consoleMap[event.level](...event.messages);
+    }
+}
+const lib_logger = Logger;
+export default lib_logger;
+export { ConsoleLogSink, Logger, createScopedLogger, logLevelSeverity, logger, logger_LogSink as LogSink };
+
+//# sourceMappingURL=logger.mjs.map

package/dist/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.mjs","sources":["../src/lib/logger/LogSink.ts","../src/lib/logger/Logger.ts","../src/lib/logger/logging.ts","../src/lib/logger/ConsoleLogSink.ts","../src/lib/logger/index.ts"],"sourcesContent":["import type { LogEvent } from './logging'\n\n/**\n * Abstract base class for log sinks that receive and process log events.\n *\n * @example\n * ```typescript\n * class MyCustomSink extends LogSink {\n *   name = 'MyCustomSink'\n *\n *   ingest(event: LogEvent): void {\n *     // process the event\n *   }\n * }\n * ```\n *\n * @public\n */\nabstract class LogSink {\n  /** Display name used to identify this sink for addition and removal. */\n  abstract name: string\n\n  /**\n   * Processes an incoming log event.\n   *\n   * @param event - The log event to process.\n   * @returns Nothing.\n   */\n  abstract ingest(event: LogEvent): void\n}\n\nexport default LogSink\n","import type LogSink from './LogSink'\nimport type { LogEvent, LogLevels } from './logging'\n\n/**\n * Central logger that routes log events through registered {@link LogSink} instances.\n *\n * @example\n * ```typescript\n * import { logger } from '@contentful/optimization-api-client/logger'\n *\n * logger.info('MyModule', 'Application started')\n * ```\n *\n * @public\n */\nexport class Logger {\n  /** The logger's identifier, used as the event scope name. */\n  readonly name = '@contentful/optimization'\n\n  private readonly PREFIX_PARTS = ['Ctfl', 'O10n']\n  private readonly DELIMITER = ':'\n  private sinks: LogSink[] = []\n\n  private assembleLocationPrefix(logLocation: string): string {\n    return `[${[...this.PREFIX_PARTS, logLocation].join(this.DELIMITER)}]`\n  }\n\n  /**\n   * Registers a log sink. If a sink with the same name already exists, it is replaced.\n   *\n   * @param sink - The {@link LogSink} instance to register.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * import { logger, ConsoleLogSink } from '@contentful/optimization-api-client/logger'\n   *\n   * logger.addSink(new ConsoleLogSink('debug'))\n   * ```\n   */\n  public addSink(sink: LogSink): void {\n    this.sinks = [...this.sinks.filter((existingSink) => existingSink.name !== sink.name), sink]\n  }\n\n  /**\n   * Removes a registered sink by name.\n   *\n   * @param name - The name of the sink to remove.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.removeSink('ConsoleLogSink')\n   * ```\n   */\n  public removeSink(name: string): void {\n    this.sinks = this.sinks.filter((sink) => sink.name !== name)\n  }\n\n  /**\n   * Removes all registered sinks.\n   *\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.removeSinks()\n   * ```\n   */\n  public removeSinks(): void {\n    this.sinks = []\n  }\n\n  /**\n   * Logs a message at the debug level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.debug('MyModule', 'Debugging value', someVariable)\n   * ```\n   */\n  public debug(logLocation: string, message: string, ...args: unknown[]): void {\n    this.emit('debug', logLocation, message, ...args)\n  }\n\n  /**\n   * Logs a message at the info level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.info('MyModule', 'Operation completed')\n   * ```\n   */\n  public info(logLocation: string, message: string, ...args: unknown[]): void {\n    this.emit('info', logLocation, message, ...args)\n  }\n\n  /**\n   * Logs a message at the log level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.log('MyModule', 'General log entry')\n   * ```\n   */\n  public log(logLocation: string, message: string, ...args: unknown[]): void {\n    this.emit('log', logLocation, message, ...args)\n  }\n\n  /**\n   * Logs a message at the warn level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.warn('MyModule', 'Deprecated method called')\n   * ```\n   */\n  public warn(logLocation: string, message: string, ...args: unknown[]): void {\n    this.emit('warn', logLocation, message, ...args)\n  }\n\n  /**\n   * Logs a message at the error level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message or Error object.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.error('MyModule', new Error('Something failed'))\n   * ```\n   */\n  public error(logLocation: string, message: string | Error, ...args: unknown[]): void {\n    this.emit('error', logLocation, message, ...args)\n  }\n\n  /**\n   * Logs a message at the fatal level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message or Error object.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.fatal('MyModule', new Error('Unrecoverable failure'))\n   * ```\n   */\n  public fatal(logLocation: string, message: string | Error, ...args: unknown[]): void {\n    this.emit('fatal', logLocation, message, ...args)\n  }\n\n  private emit(\n    level: LogLevels,\n    logLocation: string,\n    message: string | Error,\n    ...args: unknown[]\n  ): void {\n    this.onLogEvent({\n      name: this.name,\n      level,\n      messages: [`${this.assembleLocationPrefix(logLocation)} ${String(message)}`, ...args],\n    })\n  }\n\n  private onLogEvent(event: LogEvent): void {\n    this.sinks.forEach((sink) => {\n      sink.ingest(event)\n    })\n  }\n}\n\n/**\n * Shared singleton {@link Logger} instance used across the SDK.\n *\n * @public\n */\nexport const logger = new Logger()\n\n/**\n * A location-scoped logger interface whose methods omit the `logLocation` parameter.\n *\n * @public\n */\nexport interface ScopedLogger {\n  /** Logs at debug level. */\n  debug: (message: string, ...args: unknown[]) => void\n  /** Logs at info level. */\n  info: (message: string, ...args: unknown[]) => void\n  /** Logs at log level. */\n  log: (message: string, ...args: unknown[]) => void\n  /** Logs at warn level. */\n  warn: (message: string, ...args: unknown[]) => void\n  /** Logs at error level. */\n  error: (message: string | Error, ...args: unknown[]) => void\n  /** Logs at fatal level. */\n  fatal: (message: string | Error, ...args: unknown[]) => void\n}\n\n/**\n * Creates a {@link ScopedLogger} that automatically prepends the given location to every log call.\n *\n * @param location - The module or component identifier to prepend.\n * @returns A {@link ScopedLogger} bound to the specified location.\n *\n * @example\n * ```typescript\n * import { createScopedLogger } from '@contentful/optimization-api-client/logger'\n *\n * const log = createScopedLogger('MyModule')\n * log.info('Initialization complete')\n * ```\n *\n * @public\n */\nexport function createScopedLogger(location: string): ScopedLogger {\n  return {\n    debug: (message: string, ...args: unknown[]) => {\n      logger.debug(location, message, ...args)\n    },\n    info: (message: string, ...args: unknown[]) => {\n      logger.info(location, message, ...args)\n    },\n    log: (message: string, ...args: unknown[]) => {\n      logger.log(location, message, ...args)\n    },\n    warn: (message: string, ...args: unknown[]) => {\n      logger.warn(location, message, ...args)\n    },\n    error: (message: string | Error, ...args: unknown[]) => {\n      logger.error(location, message, ...args)\n    },\n    fatal: (message: string | Error, ...args: unknown[]) => {\n      logger.fatal(location, message, ...args)\n    },\n  }\n}\n","/**\n * Supported log levels ordered from highest to lowest severity.\n *\n * @public\n */\nexport type LogLevels = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'log'\n\n/**\n * A log event emitted by the logger package.\n *\n * @public\n */\nexport interface LogEvent {\n  /** Logger scope name. */\n  name: string\n  /** Event severity level. */\n  level: LogLevels\n  /** Event payload, where the first entry is the formatted message. */\n  messages: unknown[]\n  /** Optional additional context attached by sinks or middleware. */\n  [other: string]: unknown\n}\n\n/**\n * Numeric severity map used for log-level threshold comparisons.\n *\n * @public\n */\nexport const logLevelSeverity: Readonly<Record<LogLevels, number>> = {\n  fatal: 60,\n  error: 50,\n  warn: 40,\n  info: 30,\n  debug: 20,\n  log: 10,\n}\n","/* eslint-disable no-console -- using console */\nimport { logLevelSeverity, type LogEvent, type LogLevels } from './logging'\nimport LogSink from './LogSink'\n\nconst consoleMap = {\n  debug: (...args: unknown[]) => {\n    console.debug(...args)\n  },\n  info: (...args: unknown[]) => {\n    console.info(...args)\n  },\n  log: (...args: unknown[]) => {\n    console.log(...args)\n  },\n  warn: (...args: unknown[]) => {\n    console.warn(...args)\n  },\n  error: (...args: unknown[]) => {\n    console.error(...args)\n  },\n  fatal: (...args: unknown[]) => {\n    console.error(...args)\n  },\n}\n\n/**\n * A {@link LogSink} that writes log events to the browser or Node.js console,\n * filtering by a configurable verbosity threshold.\n *\n * @example\n * ```typescript\n * import { logger, ConsoleLogSink } from '@contentful/optimization-api-client/logger'\n *\n * logger.addSink(new ConsoleLogSink('debug'))\n * ```\n *\n * @public\n */\nexport class ConsoleLogSink extends LogSink {\n  /** Identifies this sink when registered with the {@link Logger}. */\n  public name = 'ConsoleLogSink'\n\n  /**\n   * Minimum log level required for events to be output.\n   *\n   * @defaultValue 'error'\n   */\n  readonly verbosity: LogLevels\n\n  /**\n   * Creates a new ConsoleLogSink.\n   *\n   * @param verbosity - Minimum log level to output.\n   */\n  constructor(verbosity?: LogLevels) {\n    super()\n\n    this.verbosity = verbosity ?? 'error'\n  }\n\n  /**\n   * Writes a log event to the console if its level meets the verbosity threshold.\n   *\n   * @param event - The log event to process.\n   * @returns Nothing.\n   */\n  ingest(event: LogEvent): void {\n    if (logLevelSeverity[event.level] < logLevelSeverity[this.verbosity]) return\n\n    consoleMap[event.level](...event.messages)\n  }\n}\n","import LogSink from './LogSink'\nimport { Logger } from './Logger'\n\nexport * from './ConsoleLogSink'\nexport * from './LogSink'\nexport * from './Logger'\nexport * from './logging'\n\nexport { LogSink }\nexport default Logger\n"],"names":["LogSink","Logger","logLocation","sink","existingSink","name","message","args","level","String","event","logger","createScopedLogger","location","logLevelSeverity","consoleMap","console","ConsoleLogSink","verbosity"],"mappings":"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"}

package/dist/u~0.mjs

@@ -0,0 +1,6 @@
+function isVariableChange(change) {
+    return 'Variable' === change.type;
+}
+export { isVariableChange };
+
+//# sourceMappingURL=u~0.mjs.map

package/dist/u~0.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"u~0.mjs","sources":["../src/schemas/experience/change/isVariableChange.ts"],"sourcesContent":["import type { Change, VariableChange } from './Change'\n\n/**\n * Determines whether a change represents a variable-backed optimization.\n *\n * @public\n */\nexport function isVariableChange(change: Change): change is VariableChange {\n  return change.type === 'Variable'\n}\n"],"names":["isVariableChange","change"],"mappings":"AAOO,SAASA,iBAAiBC,MAAc;IAC7C,OAAOA,AAAgB,eAAhBA,OAAO,IAAI;AACpB"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@contentful/optimization-api-client",
   "description": "API client for Contentful Optimization services",
-  "version": "1.1.0",
+  "version": "2.0.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -33,6 +33,16 @@
         "default": "./dist/logger.cjs"
       }
     },
+    "./guards": {
+      "import": {
+        "types": "./dist/guards.d.mts",
+        "default": "./dist/guards.mjs"
+      },
+      "require": {
+        "types": "./dist/guards.d.cts",
+        "default": "./dist/guards.cjs"
+      }
+    },
     "./api-schemas": {
       "import": {
         "types": "./dist/api-schemas.d.mts",
@@ -52,12 +62,39 @@
   "buildTools": {
     "bundleSize": {
       "gzipBudgets": {
+        "guards.cjs": 550,
+        "guards.mjs": 200,
         "index.cjs": 5000,
         "index.mjs": 4700
       }
     }
   },
   "dependencies": {
-    "@contentful/optimization-api-schemas": "1.1.0"
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "build-tools": "0.0.0",
+    "@microsoft/api-extractor": "^7.59.1",
+    "@rsdoctor/cli": "^1.6.4",
+    "@rslib/core": "^1.0.1",
+    "@types/node": "^24.0.13",
+    "@rstest/core": "^0.12.0",
+    "@rstest/coverage-istanbul": "^0.12.0",
+    "mocks": "0.0.0",
+    "msw": "^2.12.10",
+    "rimraf": "^6.1.3",
+    "tslib": "^2.8.1",
+    "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "build": "pnpm clean; pnpm build:dist",
+    "build:ci": "pnpm build:dist",
+    "build:dist": "rslib build && build-tools emit-dual-dts ./dist",
+    "build:rsdoctor": "RSDOCTOR=true rslib build && build-tools emit-dual-dts ./dist",
+    "clean": "rimraf ./.rsdoctor ./.rslib ./.rstack ./dist ./coverage .tsbuildinfo ./node_modules/.cache/rspack",
+    "size:check": "pnpm build:dist && build-tools bundle-size",
+    "size:report": "build-tools bundle-size --report-only",
+    "test:unit": "rstest run --coverage",
+    "typecheck": "tsc --noEmit"
   }
 }

package/dist/199.mjs

@@ -1,2 +0,0 @@
-import * as __rspack_external__contentful_optimization_api_schemas_66dcf407 from "@contentful/optimization-api-schemas";
-export { __rspack_external__contentful_optimization_api_schemas_66dcf407 };

package/dist/649.mjs

@@ -1,131 +0,0 @@
-class LogSink {
-}
-const logger_LogSink = LogSink;
-class Logger {
-    name = '@contentful/optimization';
-    PREFIX_PARTS = [
-        'Ctfl',
-        'O10n'
-    ];
-    DELIMITER = ':';
-    sinks = [];
-    assembleLocationPrefix(logLocation) {
-        return `[${[
-            ...this.PREFIX_PARTS,
-            logLocation
-        ].join(this.DELIMITER)}]`;
-    }
-    addSink(sink) {
-        this.sinks = [
-            ...this.sinks.filter((existingSink)=>existingSink.name !== sink.name),
-            sink
-        ];
-    }
-    removeSink(name) {
-        this.sinks = this.sinks.filter((sink)=>sink.name !== name);
-    }
-    removeSinks() {
-        this.sinks = [];
-    }
-    debug(logLocation, message, ...args) {
-        this.emit('debug', logLocation, message, ...args);
-    }
-    info(logLocation, message, ...args) {
-        this.emit('info', logLocation, message, ...args);
-    }
-    log(logLocation, message, ...args) {
-        this.emit('log', logLocation, message, ...args);
-    }
-    warn(logLocation, message, ...args) {
-        this.emit('warn', logLocation, message, ...args);
-    }
-    error(logLocation, message, ...args) {
-        this.emit('error', logLocation, message, ...args);
-    }
-    fatal(logLocation, message, ...args) {
-        this.emit('fatal', logLocation, message, ...args);
-    }
-    emit(level, logLocation, message, ...args) {
-        this.onLogEvent({
-            name: this.name,
-            level,
-            messages: [
-                `${this.assembleLocationPrefix(logLocation)} ${String(message)}`,
-                ...args
-            ]
-        });
-    }
-    onLogEvent(event) {
-        this.sinks.forEach((sink)=>{
-            sink.ingest(event);
-        });
-    }
-}
-const logger = new Logger();
-function createScopedLogger(location) {
-    return {
-        debug: (message, ...args)=>{
-            logger.debug(location, message, ...args);
-        },
-        info: (message, ...args)=>{
-            logger.info(location, message, ...args);
-        },
-        log: (message, ...args)=>{
-            logger.log(location, message, ...args);
-        },
-        warn: (message, ...args)=>{
-            logger.warn(location, message, ...args);
-        },
-        error: (message, ...args)=>{
-            logger.error(location, message, ...args);
-        },
-        fatal: (message, ...args)=>{
-            logger.fatal(location, message, ...args);
-        }
-    };
-}
-const logLevelSeverity = {
-    fatal: 60,
-    error: 50,
-    warn: 40,
-    info: 30,
-    debug: 20,
-    log: 10
-};
-const consoleMap = {
-    debug: (...args)=>{
-        console.debug(...args);
-    },
-    info: (...args)=>{
-        console.info(...args);
-    },
-    log: (...args)=>{
-        console.log(...args);
-    },
-    warn: (...args)=>{
-        console.warn(...args);
-    },
-    error: (...args)=>{
-        console.error(...args);
-    },
-    fatal: (...args)=>{
-        console.error(...args);
-    }
-};
-class ConsoleLogSink extends logger_LogSink {
-    name = 'ConsoleLogSink';
-    verbosity;
-    constructor(verbosity){
-        super();
-        this.verbosity = verbosity ?? 'error';
-    }
-    ingest(event) {
-        if (logLevelSeverity[event.level] < logLevelSeverity[this.verbosity]) return;
-        consoleMap[event.level](...event.messages);
-    }
-}
-const lib_logger = Logger;
-export default lib_logger;
-export { ConsoleLogSink, Logger, createScopedLogger, logLevelSeverity, logger, logger_LogSink as LogSink };
-
-//# sourceMappingURL=649.mjs.map

package/dist/649.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"649.mjs","sources":["../src/lib/logger/LogSink.ts","../src/lib/logger/Logger.ts","../src/lib/logger/logging.ts","../src/lib/logger/ConsoleLogSink.ts","../src/lib/logger/index.ts"],"sourcesContent":["import type { LogEvent } from './logging'\n\n/**\n * Abstract base class for log sinks that receive and process log events.\n *\n * @example\n * ```typescript\n * class MyCustomSink extends LogSink {\n *   name = 'MyCustomSink'\n *\n *   ingest(event: LogEvent): void {\n *     // process the event\n *   }\n * }\n * ```\n *\n * @public\n */\nabstract class LogSink {\n  /** Display name used to identify this sink for addition and removal. */\n  abstract name: string\n\n  /**\n   * Processes an incoming log event.\n   *\n   * @param event - The log event to process.\n   * @returns Nothing.\n   */\n  abstract ingest(event: LogEvent): void\n}\n\nexport default LogSink\n","import type LogSink from './LogSink'\nimport type { LogEvent, LogLevels } from './logging'\n\n/**\n * Central logger that routes log events through registered {@link LogSink} instances.\n *\n * @example\n * ```typescript\n * import { logger } from '@contentful/optimization-api-client/logger'\n *\n * logger.info('MyModule', 'Application started')\n * ```\n *\n * @public\n */\nexport class Logger {\n  /** The logger's identifier, used as the event scope name. */\n  readonly name = '@contentful/optimization'\n\n  private readonly PREFIX_PARTS = ['Ctfl', 'O10n']\n  private readonly DELIMITER = ':'\n  private sinks: LogSink[] = []\n\n  private assembleLocationPrefix(logLocation: string): string {\n    return `[${[...this.PREFIX_PARTS, logLocation].join(this.DELIMITER)}]`\n  }\n\n  /**\n   * Registers a log sink. If a sink with the same name already exists, it is replaced.\n   *\n   * @param sink - The {@link LogSink} instance to register.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * import { logger, ConsoleLogSink } from '@contentful/optimization-api-client/logger'\n   *\n   * logger.addSink(new ConsoleLogSink('debug'))\n   * ```\n   */\n  public addSink(sink: LogSink): void {\n    this.sinks = [...this.sinks.filter((existingSink) => existingSink.name !== sink.name), sink]\n  }\n\n  /**\n   * Removes a registered sink by name.\n   *\n   * @param name - The name of the sink to remove.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.removeSink('ConsoleLogSink')\n   * ```\n   */\n  public removeSink(name: string): void {\n    this.sinks = this.sinks.filter((sink) => sink.name !== name)\n  }\n\n  /**\n   * Removes all registered sinks.\n   *\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.removeSinks()\n   * ```\n   */\n  public removeSinks(): void {\n    this.sinks = []\n  }\n\n  /**\n   * Logs a message at the debug level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.debug('MyModule', 'Debugging value', someVariable)\n   * ```\n   */\n  public debug(logLocation: string, message: string, ...args: unknown[]): void {\n    this.emit('debug', logLocation, message, ...args)\n  }\n\n  /**\n   * Logs a message at the info level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.info('MyModule', 'Operation completed')\n   * ```\n   */\n  public info(logLocation: string, message: string, ...args: unknown[]): void {\n    this.emit('info', logLocation, message, ...args)\n  }\n\n  /**\n   * Logs a message at the log level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.log('MyModule', 'General log entry')\n   * ```\n   */\n  public log(logLocation: string, message: string, ...args: unknown[]): void {\n    this.emit('log', logLocation, message, ...args)\n  }\n\n  /**\n   * Logs a message at the warn level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.warn('MyModule', 'Deprecated method called')\n   * ```\n   */\n  public warn(logLocation: string, message: string, ...args: unknown[]): void {\n    this.emit('warn', logLocation, message, ...args)\n  }\n\n  /**\n   * Logs a message at the error level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message or Error object.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.error('MyModule', new Error('Something failed'))\n   * ```\n   */\n  public error(logLocation: string, message: string | Error, ...args: unknown[]): void {\n    this.emit('error', logLocation, message, ...args)\n  }\n\n  /**\n   * Logs a message at the fatal level.\n   *\n   * @param logLocation - The module or component identifier.\n   * @param message - The log message or Error object.\n   * @param args - Additional arguments forwarded in the log event.\n   * @returns Nothing.\n   *\n   * @example\n   * ```typescript\n   * logger.fatal('MyModule', new Error('Unrecoverable failure'))\n   * ```\n   */\n  public fatal(logLocation: string, message: string | Error, ...args: unknown[]): void {\n    this.emit('fatal', logLocation, message, ...args)\n  }\n\n  private emit(\n    level: LogLevels,\n    logLocation: string,\n    message: string | Error,\n    ...args: unknown[]\n  ): void {\n    this.onLogEvent({\n      name: this.name,\n      level,\n      messages: [`${this.assembleLocationPrefix(logLocation)} ${String(message)}`, ...args],\n    })\n  }\n\n  private onLogEvent(event: LogEvent): void {\n    this.sinks.forEach((sink) => {\n      sink.ingest(event)\n    })\n  }\n}\n\n/**\n * Shared singleton {@link Logger} instance used across the SDK.\n *\n * @public\n */\nexport const logger = new Logger()\n\n/**\n * A location-scoped logger interface whose methods omit the `logLocation` parameter.\n *\n * @public\n */\nexport interface ScopedLogger {\n  /** Logs at debug level. */\n  debug: (message: string, ...args: unknown[]) => void\n  /** Logs at info level. */\n  info: (message: string, ...args: unknown[]) => void\n  /** Logs at log level. */\n  log: (message: string, ...args: unknown[]) => void\n  /** Logs at warn level. */\n  warn: (message: string, ...args: unknown[]) => void\n  /** Logs at error level. */\n  error: (message: string | Error, ...args: unknown[]) => void\n  /** Logs at fatal level. */\n  fatal: (message: string | Error, ...args: unknown[]) => void\n}\n\n/**\n * Creates a {@link ScopedLogger} that automatically prepends the given location to every log call.\n *\n * @param location - The module or component identifier to prepend.\n * @returns A {@link ScopedLogger} bound to the specified location.\n *\n * @example\n * ```typescript\n * import { createScopedLogger } from '@contentful/optimization-api-client/logger'\n *\n * const log = createScopedLogger('MyModule')\n * log.info('Initialization complete')\n * ```\n *\n * @public\n */\nexport function createScopedLogger(location: string): ScopedLogger {\n  return {\n    debug: (message: string, ...args: unknown[]) => {\n      logger.debug(location, message, ...args)\n    },\n    info: (message: string, ...args: unknown[]) => {\n      logger.info(location, message, ...args)\n    },\n    log: (message: string, ...args: unknown[]) => {\n      logger.log(location, message, ...args)\n    },\n    warn: (message: string, ...args: unknown[]) => {\n      logger.warn(location, message, ...args)\n    },\n    error: (message: string | Error, ...args: unknown[]) => {\n      logger.error(location, message, ...args)\n    },\n    fatal: (message: string | Error, ...args: unknown[]) => {\n      logger.fatal(location, message, ...args)\n    },\n  }\n}\n","/**\n * Supported log levels ordered from highest to lowest severity.\n *\n * @public\n */\nexport type LogLevels = 'fatal' | 'error' | 'warn' | 'info' | 'debug' | 'log'\n\n/**\n * A log event emitted by the logger package.\n *\n * @public\n */\nexport interface LogEvent {\n  /** Logger scope name. */\n  name: string\n  /** Event severity level. */\n  level: LogLevels\n  /** Event payload, where the first entry is the formatted message. */\n  messages: unknown[]\n  /** Optional additional context attached by sinks or middleware. */\n  [other: string]: unknown\n}\n\n/**\n * Numeric severity map used for log-level threshold comparisons.\n *\n * @public\n */\nexport const logLevelSeverity: Readonly<Record<LogLevels, number>> = {\n  fatal: 60,\n  error: 50,\n  warn: 40,\n  info: 30,\n  debug: 20,\n  log: 10,\n}\n","/* eslint-disable no-console -- using console */\nimport { logLevelSeverity, type LogEvent, type LogLevels } from './logging'\nimport LogSink from './LogSink'\n\nconst consoleMap = {\n  debug: (...args: unknown[]) => {\n    console.debug(...args)\n  },\n  info: (...args: unknown[]) => {\n    console.info(...args)\n  },\n  log: (...args: unknown[]) => {\n    console.log(...args)\n  },\n  warn: (...args: unknown[]) => {\n    console.warn(...args)\n  },\n  error: (...args: unknown[]) => {\n    console.error(...args)\n  },\n  fatal: (...args: unknown[]) => {\n    console.error(...args)\n  },\n}\n\n/**\n * A {@link LogSink} that writes log events to the browser or Node.js console,\n * filtering by a configurable verbosity threshold.\n *\n * @example\n * ```typescript\n * import { logger, ConsoleLogSink } from '@contentful/optimization-api-client/logger'\n *\n * logger.addSink(new ConsoleLogSink('debug'))\n * ```\n *\n * @public\n */\nexport class ConsoleLogSink extends LogSink {\n  /** Identifies this sink when registered with the {@link Logger}. */\n  public name = 'ConsoleLogSink'\n\n  /**\n   * Minimum log level required for events to be output.\n   *\n   * @defaultValue 'error'\n   */\n  readonly verbosity: LogLevels\n\n  /**\n   * Creates a new ConsoleLogSink.\n   *\n   * @param verbosity - Minimum log level to output.\n   */\n  constructor(verbosity?: LogLevels) {\n    super()\n\n    this.verbosity = verbosity ?? 'error'\n  }\n\n  /**\n   * Writes a log event to the console if its level meets the verbosity threshold.\n   *\n   * @param event - The log event to process.\n   * @returns Nothing.\n   */\n  ingest(event: LogEvent): void {\n    if (logLevelSeverity[event.level] < logLevelSeverity[this.verbosity]) return\n\n    consoleMap[event.level](...event.messages)\n  }\n}\n","import LogSink from './LogSink'\nimport { Logger } from './Logger'\n\nexport * from './ConsoleLogSink'\nexport * from './LogSink'\nexport * from './Logger'\nexport * from './logging'\n\nexport { LogSink }\nexport default Logger\n"],"names":["LogSink","Logger","logLocation","sink","existingSink","name","message","args","level","String","event","logger","createScopedLogger","location","logLevelSeverity","consoleMap","console","ConsoleLogSink","verbosity"],"mappings":"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"}