@contentful/optimization-core 0.1.0-alpha

package/dist/ProductBase.js

@@ -0,0 +1,50 @@
+import ValuePresence from './lib/value-presence/ValuePresence';
+/**
+ * Default allow‑list of event types that can be emitted without explicit consent.
+ *
+ * @internal
+ * @privateRemarks These defaults are only applied when a consumer does not provide
+ * {@link ProductConfig.allowedEventTypes}.
+ */
+const defaultAllowedEvents = ['page', 'identify'];
+/**
+ * Shared base for all product implementations.
+ *
+ * @internal
+ * @remarks
+ * This abstract class is not exported as part of the public API surface.
+ * Concrete implementations (e.g., analytics) should extend this class and
+ * expose their own public methods.
+ */
+class ProductBase {
+    /**
+     * Allow‑list of event {@link AnalyticsEventType | type keys} permitted when consent is not present.
+     */
+    allowedEventTypes;
+    /** Event builder used to construct strongly‑typed events. */
+    builder;
+    /** Optimization API client used to send events to the Experience and Insights APIs. */
+    api;
+    /**
+     * Deduplication helper used to track previously seen values within optional
+     * scopes
+     */
+    duplicationDetector;
+    /** Interceptors that can mutate/augment outgoing events or optimization state. */
+    interceptors;
+    /**
+     * Creates a new product base instance.
+     *
+     * @param options - Options for configuring the functionality common among products.
+     */
+    constructor(options) {
+        const { api, builder, config, interceptors } = options;
+        this.allowedEventTypes = config?.allowedEventTypes ?? defaultAllowedEvents;
+        this.api = api;
+        this.builder = builder;
+        this.duplicationDetector = new ValuePresence(config?.preventedComponentEvents);
+        this.interceptors = interceptors;
+    }
+}
+export default ProductBase;
+//# sourceMappingURL=ProductBase.js.map

package/dist/ProductBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductBase.js","sourceRoot":"","sources":["../src/ProductBase.ts"],"names":[],"mappings":"AAOA,OAAO,aAAa,MAAM,oCAAoC,CAAA;AAS9D;;;;;;GAMG;AACH,MAAM,oBAAoB,GAAgB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;AA6C9D;;;;;;;;GAQG;AACH,MAAe,WAAW;IACxB;;OAEG;IACgB,iBAAiB,CAAW;IAE/C,6DAA6D;IAC1C,OAAO,CAAc;IAExC,uFAAuF;IACpE,GAAG,CAAW;IAEjC;;;OAGG;IACM,mBAAmB,CAAe;IAE3C,kFAAkF;IACzE,YAAY,CAAuB;IAE5C;;;;OAIG;IACH,YAAY,OAA2B;QACrC,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAA;QACtD,IAAI,CAAC,iBAAiB,GAAG,MAAM,EAAE,iBAAiB,IAAI,oBAAoB,CAAA;QAC1E,IAAI,CAAC,GAAG,GAAG,GAAG,CAAA;QACd,IAAI,CAAC,OAAO,GAAG,OAAO,CAAA;QACtB,IAAI,CAAC,mBAAmB,GAAG,IAAI,aAAa,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAAA;QAC9E,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;IAClC,CAAC;CACF;AAED,eAAe,WAAW,CAAA"}

package/dist/analytics/AnalyticsBase.d.ts

@@ -0,0 +1,35 @@
+import type { ComponentViewBuilderArgs } from '@contentful/optimization-api-client';
+import ProductBase from '../ProductBase';
+/**
+ * Base class for analytics implementations (internal).
+ *
+ * @internal
+ * @remarks
+ * Concrete analytics classes should implement the component/flag view tracking
+ * methods below. This base is not part of the public API.
+ */
+declare abstract class AnalyticsBase extends ProductBase {
+    /**
+     * Track a UI component view event.
+     *
+     * @param payload - Component view builder arguments.
+     * @param duplicationScope - Optional string used to scope duplication used in Stateful
+     * implementations.
+     * @privateRemarks
+     * Duplication prevention should be handled in Stateful implementations
+     */
+    abstract trackComponentView(payload: ComponentViewBuilderArgs, duplicationScope?: string): Promise<void> | void;
+    /**
+     * Track a flag (feature) view event.
+     *
+     * @param payload - Flag view builder arguments.
+     * @param duplicationScope - Optional string used to scope duplication used in Stateful
+     * implementations.
+     * @returns A promise that resolves when processing is complete (or `void`).
+     * @privateRemarks
+     * Duplication prevention should be handled in Stateful implementations
+     */
+    abstract trackFlagView(payload: ComponentViewBuilderArgs, duplicationScope?: string): Promise<void> | void;
+}
+export default AnalyticsBase;
+//# sourceMappingURL=AnalyticsBase.d.ts.map

package/dist/analytics/AnalyticsBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsBase.d.ts","sourceRoot":"","sources":["../../src/analytics/AnalyticsBase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAA;AACnF,OAAO,WAAW,MAAM,gBAAgB,CAAA;AAExC;;;;;;;GAOG;AACH,uBAAe,aAAc,SAAQ,WAAW;IAC9C;;;;;;;;OAQG;IACH,QAAQ,CAAC,kBAAkB,CACzB,OAAO,EAAE,wBAAwB,EACjC,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAEvB;;;;;;;;;OASG;IACH,QAAQ,CAAC,aAAa,CACpB,OAAO,EAAE,wBAAwB,EACjC,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;CACxB;AAED,eAAe,aAAa,CAAA"}

package/dist/analytics/AnalyticsBase.js

@@ -0,0 +1,13 @@
+import ProductBase from '../ProductBase';
+/**
+ * Base class for analytics implementations (internal).
+ *
+ * @internal
+ * @remarks
+ * Concrete analytics classes should implement the component/flag view tracking
+ * methods below. This base is not part of the public API.
+ */
+class AnalyticsBase extends ProductBase {
+}
+export default AnalyticsBase;
+//# sourceMappingURL=AnalyticsBase.js.map

package/dist/analytics/AnalyticsBase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsBase.js","sourceRoot":"","sources":["../../src/analytics/AnalyticsBase.ts"],"names":[],"mappings":"AACA,OAAO,WAAW,MAAM,gBAAgB,CAAA;AAExC;;;;;;;GAOG;AACH,MAAe,aAAc,SAAQ,WAAW;CA6B/C;AAED,eAAe,aAAa,CAAA"}

package/dist/analytics/AnalyticsStateful.d.ts

@@ -0,0 +1,138 @@
+import { InsightsEvent as AnalyticsEvent, type ComponentViewBuilderArgs, type ExperienceEvent as PersonalizationEvent, type Profile } from '@contentful/optimization-api-client';
+import type { ConsentGuard } from '../Consent';
+import type { ProductBaseOptions, ProductConfig } from '../ProductBase';
+import { type Observable } from '../signals';
+import AnalyticsBase from './AnalyticsBase';
+/**
+ * Default analytics state values applied at construction time.
+ *
+ * @public
+ */
+export interface AnalyticsProductConfigDefaults {
+    /** Whether analytics collection is allowed by default. */
+    consent?: boolean;
+    /** Default profile to associate with events. */
+    profile?: Profile;
+}
+/**
+ * Configuration for the stateful analytics implementation.
+ *
+ * @public
+ */
+export interface AnalyticsProductConfig extends ProductConfig {
+    /**
+     * Default signal values applied on initialization.
+     */
+    defaults?: AnalyticsProductConfigDefaults;
+}
+/**
+ * Observables exposed by the stateful analytics product.
+ *
+ * @public
+ */
+export interface AnalyticsStates {
+    /** Observable stream of the latest {@link AnalyticsEvent} or {@link PersonalizationEvent} (or `undefined`). */
+    eventStream: Observable<AnalyticsEvent | PersonalizationEvent | undefined>;
+    /** Observable stream of the active {@link Profile} (or `undefined`). */
+    profile: Observable<Profile | undefined>;
+}
+/**
+ * Options for configuring {@link AnalyticsStateful} functionality.
+ *
+ * @public
+ * @see {@link ProductBaseOptions}
+ */
+export type AnalyticsStatefulOptions = ProductBaseOptions & {
+    /** Configuration specific to the Analytics product */
+    config?: AnalyticsProductConfig;
+};
+/**
+ * Analytics implementation that maintains local state (consent, profile) and
+ * queues events until flushed or the queue reaches a maximum size.
+ *
+ * @public
+ */
+declare class AnalyticsStateful extends AnalyticsBase implements ConsentGuard {
+    /** In‑memory queue keyed by profile. */
+    private readonly queue;
+    /** Exposed observable state references. */
+    readonly states: AnalyticsStates;
+    /**
+     * Create a new stateful analytics instance.
+     *
+     * @param options - Options to configure the analytics product for stateful environments.
+     */
+    constructor(options: AnalyticsStatefulOptions);
+    /**
+     * Reset analytics‑related signals and the last emitted event.
+     */
+    reset(): void;
+    /**
+     * Determine whether the named operation is permitted based on consent and
+     * allowed event type configuration.
+     *
+     * @param name - The method name; `'trackComponentView'` is normalized
+     * to `'component'` for allow‑list checks.
+     * @returns `true` if the operation is permitted; otherwise `false`.
+     */
+    hasConsent(name: string): boolean;
+    /**
+     * Hook invoked when an operation is blocked due to missing consent.
+     *
+     * @param name - The blocked operation name.
+     * @param payload - The original arguments supplied to the operation.
+     */
+    onBlockedByConsent(name: string, payload: unknown[]): void;
+    /**
+     * Guard used to suppress duplicate component/flag view events based on a
+     * duplication key and the component identifier.
+     *
+     * @param _name - The operation name (unused).
+     * @param payload - Tuple of [builderArgs, duplicationScope].
+     * @returns `true` if the event is NOT a duplicate and should proceed.
+     */
+    isNotDuplicated(_name: string, payload: [ComponentViewBuilderArgs, string]): boolean;
+    /**
+     * Hook invoked when an operation is blocked by the duplication guard.
+     *
+     * @param name - The blocked operation name.
+     * @param payload - The original arguments supplied to the operation.
+     */
+    onBlockedByDuplication(name: string, payload: unknown[]): void;
+    /**
+     * Queue a component view event for the active profile.
+     *
+     * @param payload - Component view builder arguments.
+     * @param _duplicationScope - Optional string used to scope duplication (used
+     * by guards); an empty string `''` is converted to the `undefined` scope
+     */
+    trackComponentView(payload: ComponentViewBuilderArgs, _duplicationScope?: string): Promise<void>;
+    /**
+     * Queue a flag view event for the active profile.
+     *
+     * @param payload - Flag view builder arguments.
+     * @param _duplicationScope - Optional string used to scope duplication (used
+     * by guards); an empty string `''` is converted to the `undefined` scope
+     */
+    trackFlagView(payload: ComponentViewBuilderArgs, _duplicationScope?: string): Promise<void>;
+    /**
+     * Intercept, validate, and place an event into the profile‑scoped queue; then
+     * trigger a size‑based flush if necessary.
+     *
+     * @param event - The event to enqueue.
+     */
+    private enqueueEvent;
+    /**
+     * Flush the queue automatically when the total number of queued events
+     * reaches {@link MAX_QUEUED_EVENTS}.
+     */
+    private flushMaxEvents;
+    /**
+     * Send all queued events grouped by profile and clear the queue.
+     * @remarks Only under rare circumstances should there be more than one
+     * profile in a stateful application.
+     */
+    flush(): Promise<void>;
+}
+export default AnalyticsStateful;
+//# sourceMappingURL=AnalyticsStateful.d.ts.map

package/dist/analytics/AnalyticsStateful.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsStateful.d.ts","sourceRoot":"","sources":["../../src/analytics/AnalyticsStateful.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,IAAI,cAAc,EAE/B,KAAK,wBAAwB,EAE7B,KAAK,eAAe,IAAI,oBAAoB,EAC5C,KAAK,OAAO,EACb,MAAM,qCAAqC,CAAA;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C,OAAO,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA;AACvE,OAAO,EAQL,KAAK,UAAU,EAChB,MAAM,YAAY,CAAA;AACnB,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAI3C;;;;GAIG;AACH,MAAM,WAAW,8BAA8B;IAC7C,0DAA0D;IAC1D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAuB,SAAQ,aAAa;IAC3D;;OAEG;IACH,QAAQ,CAAC,EAAE,8BAA8B,CAAA;CAC1C;AAED;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,+GAA+G;IAC/G,WAAW,EAAE,UAAU,CAAC,cAAc,GAAG,oBAAoB,GAAG,SAAS,CAAC,CAAA;IAC1E,wEAAwE;IACxE,OAAO,EAAE,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;CACzC;AAED;;;;;GAKG;AACH,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,GAAG;IAC1D,sDAAsD;IACtD,MAAM,CAAC,EAAE,sBAAsB,CAAA;CAChC,CAAA;AAOD;;;;;GAKG;AACH,cAAM,iBAAkB,SAAQ,aAAc,YAAW,YAAY;IACnE,wCAAwC;IACxC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyC;IAE/D,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,eAAe,CAG/B;IAED;;;;OAIG;gBACS,OAAO,EAAE,wBAAwB;IA2B7C;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IASjC;;;;;OAKG;IACH,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI;IAM1D;;;;;;;OAOG;IACH,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,wBAAwB,EAAE,MAAM,CAAC,GAAG,OAAO;IAUpF;;;;;OAKG;IACH,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,IAAI;IAQ9D;;;;;;OAMG;IAGG,kBAAkB,CACtB,OAAO,EAAE,wBAAwB,EACjC,iBAAiB,SAAK,GACrB,OAAO,CAAC,IAAI,CAAC;IAMhB;;;;;;OAMG;IAGG,aAAa,CAAC,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,SAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAM7F;;;;;OAKG;YACW,YAAY;IA4B1B;;;OAGG;YACW,cAAc;IAI5B;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B;AAED,eAAe,iBAAiB,CAAA"}

package/dist/analytics/AnalyticsStateful.js

@@ -0,0 +1,179 @@
+import { InsightsEvent as AnalyticsEvent, } from '@contentful/optimization-api-client';
+import { createScopedLogger } from 'logger';
+import { guardedBy } from '../lib/decorators';
+import { batch, consent, effect, event as eventSignal, online as onlineSignal, profile as profileSignal, toObservable, } from '../signals';
+import AnalyticsBase from './AnalyticsBase';
+const logger = createScopedLogger('Analytics');
+/**
+ * Maximum number of queued events before an automatic flush is triggered.
+ */
+const MAX_QUEUED_EVENTS = 25;
+/**
+ * Analytics implementation that maintains local state (consent, profile) and
+ * queues events until flushed or the queue reaches a maximum size.
+ *
+ * @public
+ */
+class AnalyticsStateful extends AnalyticsBase {
+    /** In‑memory queue keyed by profile. */
+    queue = new Map();
+    /** Exposed observable state references. */
+    states = {
+        eventStream: toObservable(eventSignal),
+        profile: toObservable(profileSignal),
+    };
+    /**
+     * Create a new stateful analytics instance.
+     *
+     * @param options - Options to configure the analytics product for stateful environments.
+     */
+    constructor(options) {
+        const { api, builder, config, interceptors } = options;
+        super({ api, builder, config, interceptors });
+        const { defaults } = config ?? {};
+        if (defaults?.profile !== undefined) {
+            const { profile: defaultProfile } = defaults;
+            profileSignal.value = defaultProfile;
+        }
+        effect(() => {
+            const id = profileSignal.value?.id;
+            logger.info(`Analytics ${consent.value ? 'will' : 'will not'} be collected due to consent (${consent.value})`);
+            logger.debug(`Profile ${id && `with ID ${id}`} has been ${id ? 'set' : 'cleared'}`);
+        });
+        effect(() => {
+            if (onlineSignal.value)
+                void this.flush();
+        });
+    }
+    /**
+     * Reset analytics‑related signals and the last emitted event.
+     */
+    reset() {
+        batch(() => {
+            eventSignal.value = undefined;
+            profileSignal.value = undefined;
+        });
+    }
+    /**
+     * Determine whether the named operation is permitted based on consent and
+     * allowed event type configuration.
+     *
+     * @param name - The method name; `'trackComponentView'` is normalized
+     * to `'component'` for allow‑list checks.
+     * @returns `true` if the operation is permitted; otherwise `false`.
+     */
+    hasConsent(name) {
+        return (!!consent.value ||
+            (this.allowedEventTypes ?? []).includes(name === 'trackComponentView' || name === 'trackFlagView' ? 'component' : name));
+    }
+    /**
+     * Hook invoked when an operation is blocked due to missing consent.
+     *
+     * @param name - The blocked operation name.
+     * @param payload - The original arguments supplied to the operation.
+     */
+    onBlockedByConsent(name, payload) {
+        logger.warn(`Event "${name}" was blocked due to lack of consent; payload: ${JSON.stringify(payload)}`);
+    }
+    /**
+     * Guard used to suppress duplicate component/flag view events based on a
+     * duplication key and the component identifier.
+     *
+     * @param _name - The operation name (unused).
+     * @param payload - Tuple of [builderArgs, duplicationScope].
+     * @returns `true` if the event is NOT a duplicate and should proceed.
+     */
+    isNotDuplicated(_name, payload) {
+        const [{ componentId: value }, duplicationScope] = payload;
+        const isDuplicated = this.duplicationDetector.isPresent(duplicationScope, value);
+        if (!isDuplicated)
+            this.duplicationDetector.addValue(duplicationScope, value);
+        return !isDuplicated;
+    }
+    /**
+     * Hook invoked when an operation is blocked by the duplication guard.
+     *
+     * @param name - The blocked operation name.
+     * @param payload - The original arguments supplied to the operation.
+     */
+    onBlockedByDuplication(name, payload) {
+        const componentType = name === 'trackFlagView' ? 'flag' : 'component';
+        logger.debug(`Duplicate "${componentType} view" event detected, skipping; payload: ${JSON.stringify(payload)}`);
+    }
+    /**
+     * Queue a component view event for the active profile.
+     *
+     * @param payload - Component view builder arguments.
+     * @param _duplicationScope - Optional string used to scope duplication (used
+     * by guards); an empty string `''` is converted to the `undefined` scope
+     */
+    @guardedBy('isNotDuplicated', { onBlocked: 'onBlockedByDuplication' })
+    @guardedBy('hasConsent', { onBlocked: 'onBlockedByConsent' })
+    async trackComponentView(payload, _duplicationScope = '') {
+        logger.info(`Processing "component view" event for ${payload.componentId}`);
+        await this.enqueueEvent(this.builder.buildComponentView(payload));
+    }
+    /**
+     * Queue a flag view event for the active profile.
+     *
+     * @param payload - Flag view builder arguments.
+     * @param _duplicationScope - Optional string used to scope duplication (used
+     * by guards); an empty string `''` is converted to the `undefined` scope
+     */
+    @guardedBy('isNotDuplicated', { onBlocked: 'onBlockedByDuplication' })
+    @guardedBy('hasConsent', { onBlocked: 'onBlockedByConsent' })
+    async trackFlagView(payload, _duplicationScope = '') {
+        logger.debug(`Processing "flag view" event for ${payload.componentId}`);
+        await this.enqueueEvent(this.builder.buildFlagView(payload));
+    }
+    /**
+     * Intercept, validate, and place an event into the profile‑scoped queue; then
+     * trigger a size‑based flush if necessary.
+     *
+     * @param event - The event to enqueue.
+     */
+    async enqueueEvent(event) {
+        const { value: profile } = profileSignal;
+        if (!profile) {
+            logger.warn('Attempting to emit an event without an Optimization profile');
+            return;
+        }
+        const intercepted = await this.interceptors.event.run(event);
+        const validEvent = AnalyticsEvent.parse(intercepted);
+        logger.debug(`Queueing ${validEvent.type} event for profile ${profile.id}`, validEvent);
+        const profileEventQueue = this.queue.get(profile);
+        eventSignal.value = validEvent;
+        if (profileEventQueue) {
+            profileEventQueue.push(validEvent);
+        }
+        else {
+            this.queue.set(profile, [validEvent]);
+        }
+        await this.flushMaxEvents();
+    }
+    /**
+     * Flush the queue automatically when the total number of queued events
+     * reaches {@link MAX_QUEUED_EVENTS}.
+     */
+    async flushMaxEvents() {
+        if (this.queue.values().toArray().flat().length >= MAX_QUEUED_EVENTS)
+            await this.flush();
+    }
+    /**
+     * Send all queued events grouped by profile and clear the queue.
+     * @remarks Only under rare circumstances should there be more than one
+     * profile in a stateful application.
+     */
+    async flush() {
+        logger.debug('Flushing event queue');
+        const batches = [];
+        this.queue.forEach((events, profile) => batches.push({ profile, events }));
+        if (!batches.length)
+            return;
+        const sendSuccess = await this.api.insights.sendBatchEvents(batches);
+        if (sendSuccess)
+            this.queue.clear();
+    }
+}
+export default AnalyticsStateful;
+//# sourceMappingURL=AnalyticsStateful.js.map

package/dist/analytics/AnalyticsStateful.js.map

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

package/dist/analytics/AnalyticsStateless.d.ts

@@ -0,0 +1,48 @@
+import { type ComponentViewBuilderArgs, type PartialProfile } from '@contentful/optimization-api-client';
+import AnalyticsBase from './AnalyticsBase';
+/**
+ * Arguments for tracking a component/flag view in stateless mode.
+ *
+ * @public
+ * @remarks
+ * The `profile` is optional; when omitted, the APIs may infer identity via
+ * other means.
+ */
+export type TrackViewArgs = ComponentViewBuilderArgs & {
+    profile?: PartialProfile;
+};
+/**
+ * Stateless analytics implementation that sends each event immediately in a
+ * single‑event batch.
+ *
+ * @public
+ */
+declare class AnalyticsStateless extends AnalyticsBase {
+    /**
+     * Build, intercept, validate, and send a component view event.
+     *
+     * @param args - {@link TrackViewArgs} used to build the event. Includes an
+     * optional partial profile.
+     * @returns A promise that resolves once the batch has been sent.
+     */
+    trackComponentView(args: TrackViewArgs): Promise<void>;
+    /**
+     * Build, intercept, validate, and send a flag view event.
+     *
+     * @param args - {@link TrackViewArgs} used to build the event. Includes an
+     * optional partial profile.
+     * @returns A promise that resolves once the batch has been sent.
+     */
+    trackFlagView(args: TrackViewArgs): Promise<void>;
+    /**
+     * Send a single {@link InsightsEvent} wrapped in a one‑item batch.
+     *
+     * @param event - The event to send.
+     * @param profile - Optional partial profile to attach to the batch.
+     * @returns A promise that resolves when the API call completes.
+     * @internal
+     */
+    private sendBatchEvent;
+}
+export default AnalyticsStateless;
+//# sourceMappingURL=AnalyticsStateless.d.ts.map

package/dist/analytics/AnalyticsStateless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsStateless.d.ts","sourceRoot":"","sources":["../../src/analytics/AnalyticsStateless.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,wBAAwB,EAG7B,KAAK,cAAc,EACpB,MAAM,qCAAqC,CAAA;AAE5C,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAI3C;;;;;;;GAOG;AACH,MAAM,MAAM,aAAa,GAAG,wBAAwB,GAAG;IAAE,OAAO,CAAC,EAAE,cAAc,CAAA;CAAE,CAAA;AAEnF;;;;;GAKG;AACH,cAAM,kBAAmB,SAAQ,aAAa;IAC5C;;;;;;OAMG;IACG,kBAAkB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAc5D;;;;;;OAMG;IACG,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAcvD;;;;;;;OAOG;YACW,cAAc;CAU7B;AAED,eAAe,kBAAkB,CAAA"}

package/dist/analytics/AnalyticsStateless.js

@@ -0,0 +1,61 @@
+import { BatchInsightsEventArray, ComponentViewEvent, } from '@contentful/optimization-api-client';
+import { createScopedLogger } from 'logger';
+import AnalyticsBase from './AnalyticsBase';
+const logger = createScopedLogger('Analytics');
+/**
+ * Stateless analytics implementation that sends each event immediately in a
+ * single‑event batch.
+ *
+ * @public
+ */
+class AnalyticsStateless extends AnalyticsBase {
+    /**
+     * Build, intercept, validate, and send a component view event.
+     *
+     * @param args - {@link TrackViewArgs} used to build the event. Includes an
+     * optional partial profile.
+     * @returns A promise that resolves once the batch has been sent.
+     */
+    async trackComponentView(args) {
+        logger.info('Processing "component view" event');
+        const { profile, ...builderArgs } = args;
+        const event = this.builder.buildComponentView(builderArgs);
+        const intercepted = await this.interceptors.event.run(event);
+        const parsed = ComponentViewEvent.parse(intercepted);
+        await this.sendBatchEvent(parsed, profile);
+    }
+    /**
+     * Build, intercept, validate, and send a flag view event.
+     *
+     * @param args - {@link TrackViewArgs} used to build the event. Includes an
+     * optional partial profile.
+     * @returns A promise that resolves once the batch has been sent.
+     */
+    async trackFlagView(args) {
+        logger.debug('Processing "flag view" event');
+        const { profile, ...builderArgs } = args;
+        const event = this.builder.buildFlagView(builderArgs);
+        const intercepted = await this.interceptors.event.run(event);
+        const parsed = ComponentViewEvent.parse(intercepted);
+        await this.sendBatchEvent(parsed, profile);
+    }
+    /**
+     * Send a single {@link InsightsEvent} wrapped in a one‑item batch.
+     *
+     * @param event - The event to send.
+     * @param profile - Optional partial profile to attach to the batch.
+     * @returns A promise that resolves when the API call completes.
+     * @internal
+     */
+    async sendBatchEvent(event, profile) {
+        const batchEvent = BatchInsightsEventArray.parse([
+            {
+                profile,
+                events: [event],
+            },
+        ]);
+        await this.api.insights.sendBatchEvents(batchEvent);
+    }
+}
+export default AnalyticsStateless;
+//# sourceMappingURL=AnalyticsStateless.js.map

package/dist/analytics/AnalyticsStateless.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AnalyticsStateless.js","sourceRoot":"","sources":["../../src/analytics/AnalyticsStateless.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,uBAAuB,EAEvB,kBAAkB,GAGnB,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAC3C,OAAO,aAAa,MAAM,iBAAiB,CAAA;AAE3C,MAAM,MAAM,GAAG,kBAAkB,CAAC,WAAW,CAAC,CAAA;AAY9C;;;;;GAKG;AACH,MAAM,kBAAmB,SAAQ,aAAa;IAC5C;;;;;;OAMG;IACH,KAAK,CAAC,kBAAkB,CAAC,IAAmB;QAC1C,MAAM,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAA;QAEhD,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,CAAA;QAExC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAA;QAE1D,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAE5D,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QAEpD,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5C,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CAAC,IAAmB;QACrC,MAAM,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAA;QAE5C,MAAM,EAAE,OAAO,EAAE,GAAG,WAAW,EAAE,GAAG,IAAI,CAAA;QAExC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAA;QAErD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;QAE5D,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;QAEpD,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5C,CAAC;IAED;;;;;;;OAOG;IACK,KAAK,CAAC,cAAc,CAAC,KAAoB,EAAE,OAAwB;QACzE,MAAM,UAAU,GAA4B,uBAAuB,CAAC,KAAK,CAAC;YACxE;gBACE,OAAO;gBACP,MAAM,EAAE,CAAC,KAAK,CAAC;aAChB;SACF,CAAC,CAAA;QAEF,MAAM,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,CAAC,CAAA;IACrD,CAAC;CACF;AAED,eAAe,kBAAkB,CAAA"}

package/dist/analytics/index.d.ts

@@ -0,0 +1,5 @@
+export * from './AnalyticsStateful';
+export { default as AnalyticsStateful } from './AnalyticsStateful';
+export * from './AnalyticsStateless';
+export { default as AnalyticsStateless } from './AnalyticsStateless';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAElE,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/analytics/index.js

@@ -0,0 +1,5 @@
+export * from './AnalyticsStateful';
+export { default as AnalyticsStateful } from './AnalyticsStateful';
+export * from './AnalyticsStateless';
+export { default as AnalyticsStateless } from './AnalyticsStateless';
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/analytics/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAElE,cAAc,sBAAsB,CAAA;AACpC,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/global-constants.d.ts

@@ -0,0 +1,18 @@
+export declare const OPTIMIZATION_CORE_SDK_VERSION: string;
+/**
+ * Anonymous-ID cookie name used by the Optimization Core.
+ *
+ * @public
+ * @remarks
+ * This constant represents the cookie key used by the Optimization Framework
+ * to persist an anonymous identifier for tracking personalization and analytics
+ * events when no explicit profile is known.
+ *
+ * @example
+ * ```ts
+ * import { ANONYMOUS_ID_COOKIE } from '@contentful/optimization-core'
+ * const profileId = request.cookies[ANONYMOUS_ID_COOKIE]
+ * ```
+ */
+export declare const ANONYMOUS_ID_COOKIE = "ctfl-opt-aid";
+//# sourceMappingURL=global-constants.d.ts.map

package/dist/global-constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-constants.d.ts","sourceRoot":"","sources":["../src/global-constants.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,6BAA6B,QACyC,CAAA;AAEnF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,iBAAiB,CAAA"}

package/dist/global-constants.js

@@ -0,0 +1,18 @@
+export const OPTIMIZATION_CORE_SDK_VERSION = typeof __OPTIMIZATION_VERSION__ === 'string' ? __OPTIMIZATION_VERSION__ : '0.0.0';
+/**
+ * Anonymous-ID cookie name used by the Optimization Core.
+ *
+ * @public
+ * @remarks
+ * This constant represents the cookie key used by the Optimization Framework
+ * to persist an anonymous identifier for tracking personalization and analytics
+ * events when no explicit profile is known.
+ *
+ * @example
+ * ```ts
+ * import { ANONYMOUS_ID_COOKIE } from '@contentful/optimization-core'
+ * const profileId = request.cookies[ANONYMOUS_ID_COOKIE]
+ * ```
+ */
+export const ANONYMOUS_ID_COOKIE = 'ctfl-opt-aid';
+//# sourceMappingURL=global-constants.js.map

package/dist/global-constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"global-constants.js","sourceRoot":"","sources":["../src/global-constants.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,MAAM,6BAA6B,GACxC,OAAO,wBAAwB,KAAK,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,OAAO,CAAA;AAEnF;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,cAAc,CAAA"}