@contentful/optimization-api-client 0.1.0-alpha → 0.1.0-alpha11

package/README.md

@@ -1,6 +1,6 @@
 <p align="center">
   <a href="https://www.contentful.com/developers/docs/personalization/">
-    <img alt="Contentful Logo" title="Contentful" src="../../contentful-icon.png" width="150">
+    <img alt="Contentful Logo" title="Contentful" src="https://raw.githubusercontent.com/contentful/optimization/v0.1.0-alpha11/contentful-icon.png" width="150">
   </a>
 </p>
 
@@ -10,17 +10,22 @@
 
 <div align="center">
 
-[Readme](./README.md) · [Reference](https://contentful.github.io/optimization) ·
-[Contributing](/CONTRIBUTING.md)
+[Guides](https://contentful.github.io/optimization/documents/Guides.html) ·
+[Reference](https://contentful.github.io/optimization) · [Contributing](https://github.com/contentful/optimization/blob/v0.1.0-alpha11/CONTRIBUTING.md)
 
 </div>
 
+> [!WARNING]
+>
+> The Optimization SDK Suite is pre-release (alpha). Breaking changes may be published at any time.
+
 The Contentful Optimization API Client Library provides methods for interfacing with Contentful's
-Experience and Insights APIs, which serve its Personalization and Analytics products.
+Experience API and Insights API, which serve its Personalization and Analytics products.
 
 > [!NOTE]
 >
-> In the future, the Experience and Insights APIs may be combined behind an Optimization API
+> The Experience API and Insights API are separate today, and this client provides a unified SDK
+> surface for both APIs.
 
 <details>
   <summary>Table of Contents</summary>
@@ -30,8 +35,8 @@ Experience and Insights APIs, which serve its Personalization and Analytics prod
 - [Configuration](#configuration)
   - [Top-level Configuration Options](#top-level-configuration-options)
   - [Fetch Options](#fetch-options)
-  - [Analytics Options](#analytics-options)
-  - [Personalization Options](#personalization-options)
+  - [Insights API Options](#insights-api-options)
+  - [Experience API Options](#experience-api-options)
 - [Working With the APIs](#working-with-the-apis)
   - [Experience API](#experience-api)
     - [Get Profile data](#get-profile-data)
@@ -41,9 +46,7 @@ Experience and Insights APIs, which serve its Personalization and Analytics prod
     - [Upsert Many Profiles](#upsert-many-profiles)
   - [Insights API](#insights-api)
     - [Send Batch Events](#send-batch-events)
-- [Event Builder](#event-builder)
-  - [Event Builder Configuration](#event-builder-configuration)
-    - [Event Builder Configured Methods](#event-builder-configured-methods)
+- [Event Construction](#event-construction)
 
 <!-- mtoc-end -->
 </details>
@@ -72,20 +75,20 @@ const client = new ApiClient({ clientId: 'abc123' })
 
 ### Top-level Configuration Options
 
-| Option            | Required? | Default                       | Description                                                           |
-| ----------------- | --------- | ----------------------------- | --------------------------------------------------------------------- |
-| `analytics`       | No        | See "Analytics Options"       | Configuration specific to the Analytics/Insights API                  |
-| `clientId`        | Yes       | N/A                           | The Ninetailed API Key which can be found in the Ninetailed Admin app |
-| `environment`     | No        | `'main'`                      | The Ninetailed environment configured in the Ninetailed Admin app     |
-| `fetchOptions`    | No        | See "Fetch Options"           | Configuration for Fetch timeout and retry functionality               |
-| `personalization` | No        | See "Personalization Options" | Configuration specific to the Personalization/Experience API          |
+| Option         | Required? | Default                      | Description                                                 |
+| -------------- | --------- | ---------------------------- | ----------------------------------------------------------- |
+| `experience`   | No        | See "Experience API Options" | Configuration specific to the Experience API                |
+| `clientId`     | Yes       | N/A                          | Shared API key for Experience API and Insights API requests |
+| `environment`  | No        | `'main'`                     | The environment identifier                                  |
+| `fetchOptions` | No        | See "Fetch Options"          | Configuration for Fetch timeout and retry functionality     |
+| `insights`     | No        | See "Insights API Options"   | Configuration specific to the Insights API                  |
 
 ### Fetch Options
 
 Fetch options allow for configuration of both a Fetch API-compatible fetch method and the
-retry/timeout logic integrated into the Optimization API Client. Specify the `fetchMethod` when the
-host application environment does not offer a `fetch` method that is compatible with the standard
-Fetch API in its global scope.
+retry/timeout logic integrated into this API client. Specify the `fetchMethod` when the host
+application environment does not offer a `fetch` method that is compatible with the standard Fetch
+API in its global scope.
 
 | Option             | Required? | Default     | Description                                                           |
 | ------------------ | --------- | ----------- | --------------------------------------------------------------------- |
@@ -101,7 +104,16 @@ Configuration method signatures:
 - `fetchMethod`: `(url: string \| URL, init: RequestInit) => Promise<Response>`
 - `onFailedAttempt` and `onRequestTimeout`: `(options: FetchMethodCallbackOptions) => void`
 
-### Analytics Options
+> [!NOTE]
+>
+> Retry behavior is intentionally fixed to HTTP `503` responses (`Service Unavailable`) for the
+> default SDK transport policy. This matches current Experience API and Insights API expectations:
+> `503` is treated as the transient availability signal, while other response classes are handled by
+> caller logic and are intentionally not retried by default. Treat this as deliberate contract
+> behavior, not a transport gap; broaden retry status handling only with an explicit API contract
+> change.
+
+### Insights API Options
 
 | Option          | Required? | Default                                    | Description                                                              |
 | --------------- | --------- | ------------------------------------------ | ------------------------------------------------------------------------ |
@@ -112,7 +124,7 @@ Configuration method signatures:
 
 - `beaconHandler`: `(url: string | URL, data: BatchInsightsEventArray) => boolean`
 
-### Personalization Options
+### Experience API Options
 
 | Option            | Required? | Default                               | Description                                                         |
 | ----------------- | --------- | ------------------------------------- | ------------------------------------------------------------------- |
@@ -131,22 +143,22 @@ Configuration method signatures:
 
 ### Experience API
 
-Experience API methods are scoped to the client's `personalization` member. All singular
-personalization methods return a `Promise` that resolves with the following data:
+Experience API methods are scoped to the client's `experience` member. All singular Experience API
+methods return a `Promise` that resolves with the following data:
 
 ```json
 {
   "profile": {
     /* User profile data */
   },
-  "personalizations": [
+  "selectedOptimizations": [
     {
-      /* Personalization/experience configuration for the associated profile */
+      /* Optimization/Experience API configuration for the associated profile */
     }
   ],
   "changes": [
     {
-      /* Similar to `personalizations` but currently used for Custom Flags */
+      /* Custom Flag changes associated with the evaluated profile */
     }
   ]
 }
@@ -156,21 +168,21 @@ personalization methods return a `Promise` that resolves with the following data
 
 ```ts
 const client = new ApiClient({ clientId: 'abc123' })
-const { profile } = await client.personalization.getProfile('profile-123', { locale: 'de-DE' })
+const { profile } = await client.experience.getProfile('profile-123', { locale: 'de-DE' })
 ```
 
 #### Create a New Profile
 
 ```ts
 const client = new ApiClient({ clientId: 'abc123' })
-const { profile } = await client.personalization.createProfile({ events: [...] }, { locale: 'de-DE' })
+const { profile } = await client.experience.createProfile({ events: [...] }, { locale: 'de-DE' })
 ```
 
 #### Update an Existing Profile
 
 ```ts
 const client = new ApiClient({ clientId: 'abc123' })
-const { profile } = await client.personalization.updateProfile(
+const { profile } = await client.experience.updateProfile(
   {
     profileId: 'profile-123',
     events: [...],
@@ -183,7 +195,7 @@ const { profile } = await client.personalization.updateProfile(
 
 ```ts
 const client = new ApiClient({ clientId: 'abc123' })
-const { profile } = await client.personalization.upsertProfile(
+const { profile } = await client.experience.upsertProfile(
   {
     profileId,
     events: [...],
@@ -195,88 +207,51 @@ const { profile } = await client.personalization.upsertProfile(
 #### Upsert Many Profiles
 
 The `upsertManyProfiles` method returns a `Promise` that resolves with an array of user profiles.
-Each event should have an additional `anonymousId` property set to the associated anonymous ID or
-profile ID.
+The `events` array must contain at least one event. Each event should have an additional
+`anonymousId` property set to the associated anonymous ID or profile ID.
 
 ```ts
 const client = new ApiClient({ clientId: 'abc123' })
-const profiles = await client.personalization.upsertManyProfiles(
-  { events: [...]},
+const profiles = await client.experience.upsertManyProfiles(
+  {
+    events: [
+      {
+        anonymousId: 'anon-123',
+        // valid Experience API event payload fields
+      },
+    ],
+  },
   { locale: 'de-DE' },
 )
 ```
 
 ### Insights API
 
-Insights API methods are scoped to the client's `analytics` member. All analytics methods return a
-`Promise` that resolves to `void` (no value).
+Insights API methods are scoped to the client's `insights` member. The batch send method returns a
+`Promise` that resolves to `boolean`.
 
 #### Send Batch Events
 
 ```ts
 const client = new ApiClient({ clientId: 'abc123' })
-await client.analytics.sendBatchEvents([
+await client.insights.sendBatchEvents([
   {
     profile: { id: 'abc-123', ... },
-    events: [{ type: 'track', ... }],
+    events: [
+      {
+        type: 'component',
+        componentId: 'hero-banner',
+        componentType: 'Entry',
+        variantIndex: 0,
+        ...,
+      },
+    ],
   }
 ])
 ```
 
-## Event Builder
-
-The Event Builder is a helper class that assists in constructing valid events for submission to the
-Experience and Insights APIs.
-
-### Event Builder Configuration
-
-Event Builder configuration options assist in adding contextual data to each event created by a
-builder instance.
-
-| Option              | Required? | Default                         | Description                                                                        |
-| ------------------- | --------- | ------------------------------- | ---------------------------------------------------------------------------------- |
-| `app`               | No        | `undefined`                     | The application definition used to attribute events to a specific consumer app     |
-| `channel`           | Yes       | N/A                             | The channel that identifies where events originate from (e.g. `'web'`, `'mobile'`) |
-| `library`           | Yes       | N/A                             | The client library metadata that is attached to all events                         |
-| `getLocale`         | No        | `() => 'en-US'`                 | Function used to resolve the locale for outgoing events                            |
-| `getPageProperties` | No        | `() => DEFAULT_PAGE_PROPERTIES` | Function that returns the current page properties                                  |
-| `getUserAgent`      | No        | `() => undefined`               | Function used to obtain the current user agent string when applicable              |
-
-The `get*` functions are most useful in stateful environments. Stateless environments should set the
-related data directly via Event Builder method arguments.
-
-The `channel` option may contain one of the following values:
-
-- `web`
-- `mobile`
-- `server`
-
-Configuration method signatures:
-
-- `getLocale`: `() => string | undefined`
-- `getPageProperties`:
-
-  ```ts
-  () => {
-    path: string,
-    query: Record<string, string>,
-    referrer: string,
-    search: string,
-    title?: string,
-    url: string
-  }
-  ```
-
-- `getUserAgent`: `() => string | undefined`
-
-#### Event Builder Configured Methods
-
-- `buildComponentView`: Builds a component view event payload for a Contentful entry-based component
-- `buildFlagView`: Builds a component view payload event for a Custom Flag component
-- `buildIdentify`: Builds an identify event payload to associate a user ID with traits
-- `buildPageView`: Builds a page view event payload
-- `buildTrack`: Builds a track event payload for arbitrary user actions
+## Event Construction
 
-See the
-[Event Builder documentation](../classes/_contentful_optimization-api-client.EventBuilder.html) for
-more information regarding arguments and return values.
+Event-construction helpers (`EventBuilder`) are part of
+[`@contentful/optimization-core`](https://github.com/contentful/optimization/blob/v0.1.0-alpha11/packages/universal/core-sdk/README.md) and environment SDKs that build on top of
+it. This package focuses on API transport and request/response validation.

package/dist/199.mjs

@@ -0,0 +1,2 @@
+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

@@ -0,0 +1,131 @@
+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

@@ -0,0 +1 @@
+{"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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"}

package/dist/api-schemas.cjs

@@ -0,0 +1,60 @@
+"use strict";
+var __webpack_modules__ = {
+    "@contentful/optimization-api-schemas" (module) {
+        module.exports = require("@contentful/optimization-api-schemas");
+    }
+};
+var __webpack_module_cache__ = {};
+function __webpack_require__(moduleId) {
+    var cachedModule = __webpack_module_cache__[moduleId];
+    if (void 0 !== cachedModule) return cachedModule.exports;
+    var module = __webpack_module_cache__[moduleId] = {
+        exports: {}
+    };
+    __webpack_modules__[moduleId](module, module.exports, __webpack_require__);
+    return module.exports;
+}
+(()=>{
+    __webpack_require__.n = (module)=>{
+        var getter = module && module.__esModule ? ()=>module['default'] : ()=>module;
+        __webpack_require__.d(getter, {
+            a: getter
+        });
+        return getter;
+    };
+})();
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+(()=>{
+    __webpack_require__.r(__webpack_exports__);
+    var _contentful_optimization_api_schemas__rspack_import_0 = __webpack_require__("@contentful/optimization-api-schemas");
+    var __rspack_reexport = {};
+    for(const __rspack_import_key in _contentful_optimization_api_schemas__rspack_import_0)if ("default" !== __rspack_import_key) __rspack_reexport[__rspack_import_key] = ()=>_contentful_optimization_api_schemas__rspack_import_0[__rspack_import_key];
+    __webpack_require__.d(__webpack_exports__, __rspack_reexport);
+})();
+for(var __rspack_i in __webpack_exports__)exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});
+
+//# sourceMappingURL=api-schemas.cjs.map

package/dist/api-schemas.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-schemas.cjs","sources":["webpack/runtime/compat_get_default_export","webpack/runtime/define_property_getters","webpack/runtime/has_own_property","webpack/runtime/make_namespace_object"],"sourcesContent":["// getDefaultExport function for compatibility with non-ESM modules\n__webpack_require__.n = (module) => {\n\tvar getter = module && module.__esModule ?\n\t\t() => (module['default']) :\n\t\t() => (module);\n\t__webpack_require__.d(getter, { a: getter });\n\treturn getter;\n};\n","__webpack_require__.d = (exports, definition) => {\n\tfor(var key in definition) {\n        if(__webpack_require__.o(definition, key) && !__webpack_require__.o(exports, key)) {\n            Object.defineProperty(exports, key, { enumerable: true, get: definition[key] });\n        }\n    }\n};","__webpack_require__.o = (obj, prop) => (Object.prototype.hasOwnProperty.call(obj, prop))","// define __esModule on exports\n__webpack_require__.r = (exports) => {\n\tif(typeof Symbol !== 'undefined' && Symbol.toStringTag) {\n\t\tObject.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });\n\t}\n\tObject.defineProperty(exports, '__esModule', { value: true });\n};"],"names":["__webpack_require__","module","getter","definition","key","Object","obj","prop","Symbol"],"mappings":";;;;;;;;;;;;;;;;;IACAA,oBAAoB,CAAC,GAAG,CAACC;QACxB,IAAIC,SAASD,UAAUA,OAAO,UAAU,GACvC,IAAOA,MAAM,CAAC,UAAU,GACxB,IAAOA;QACRD,oBAAoB,CAAC,CAACE,QAAQ;YAAE,GAAGA;QAAO;QAC1C,OAAOA;IACR;;;ICPAF,oBAAoB,CAAC,GAAG,CAAC,UAASG;QACjC,IAAI,IAAIC,OAAOD,WACR,IAAGH,oBAAoB,CAAC,CAACG,YAAYC,QAAQ,CAACJ,oBAAoB,CAAC,CAAC,UAASI,MACzEC,OAAO,cAAc,CAAC,UAASD,KAAK;YAAE,YAAY;YAAM,KAAKD,UAAU,CAACC,IAAI;QAAC;IAGzF;;;ICNAJ,oBAAoB,CAAC,GAAG,CAACM,KAAKC,OAAUF,OAAO,SAAS,CAAC,cAAc,CAAC,IAAI,CAACC,KAAKC;;;ICClFP,oBAAoB,CAAC,GAAG,CAAC;QACxB,IAAG,AAAkB,MAAlB,OAAOQ,UAA0BA,OAAO,WAAW,EACrDH,OAAO,cAAc,CAAC,UAASG,OAAO,WAAW,EAAE;YAAE,OAAO;QAAS;QAEtEH,OAAO,cAAc,CAAC,UAAS,cAAc;YAAE,OAAO;QAAK;IAC5D"}

package/dist/api-schemas.d.cts

@@ -0,0 +1,4 @@
+
+export * from "@contentful/optimization-api-schemas";
+
+export { }

package/dist/api-schemas.d.mts

@@ -0,0 +1,4 @@
+
+export * from "@contentful/optimization-api-schemas";
+
+export { }

package/dist/api-schemas.d.ts

@@ -0,0 +1,4 @@
+
+export * from "@contentful/optimization-api-schemas";
+
+export { }

package/dist/api-schemas.mjs

@@ -0,0 +1,2 @@
+import "./199.mjs";
+export * from "@contentful/optimization-api-schemas";