@contentful/optimization-core 0.1.0-alpha → 0.1.0-alpha10

package/dist/analytics/AnalyticsStateful.d.ts

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

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

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

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

package/dist/analytics/AnalyticsStateless.d.ts

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

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

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

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

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

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

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

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

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

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

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

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

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,MAAM,EAAE,KAAK,OAAO,EAAE,MAAM,WAAW,CAAA;AAE7E,cAAc,qCAAqC,CAAA;AACnD,cAAc,QAAQ,CAAA;AACtB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AAEjC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -1,15 +0,0 @@
-export { batch, effect, signals } from './signals';
-export * from '@contentful/optimization-api-client';
-export * from 'logger';
-export * from './analytics';
-export * from './CoreBase';
-export * from './CoreStateful';
-export * from './CoreStateless';
-export * from './global-constants';
-export * from './lib/decorators';
-export * from './lib/interceptor';
-export * from './lib/value-presence';
-export * from './personalization';
-export { default as CoreStateful } from './CoreStateful';
-export { default as CoreStateless } from './CoreStateless';
-//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAA6B,MAAM,WAAW,CAAA;AAE7E,cAAc,qCAAqC,CAAA;AACnD,cAAc,QAAQ,CAAA;AACtB,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,oBAAoB,CAAA;AAClC,cAAc,kBAAkB,CAAA;AAChC,cAAc,mBAAmB,CAAA;AACjC,cAAc,sBAAsB,CAAA;AACpC,cAAc,mBAAmB,CAAA;AAEjC,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAA;AACxD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/lib/decorators/guardedBy.d.ts

@@ -1,113 +0,0 @@
-/**
- * A callback invoked when a method call is blocked by {@link guardedBy}.
- *
- * @param methodName - The name of the method that was attempted.
- * @param args - The readonly array of arguments supplied to the blocked call.
- * @returns Nothing.
- *
- * @public
- */
-type BlockHandler = (methodName: string, args: readonly unknown[]) => void;
-/**
- * The original method implementation.
- *
- * @typeParam A - The parameter tuple of the original method.
- * @typeParam R - The return type of the original method.
- * @param value - The method being decorated.
- * @param context - The Stage-3 decorator context for a class method.
- * @returns Nothing.
- *
- * @remarks
- * Users do not call this directly; it's returned by {@link guardedBy}.
- */
-type GuardedByFunction<T extends object> = <A extends readonly unknown[], R>(value: (...args: A) => R, context: ClassMethodDecoratorContext<T, (...args: A) => R>) => void;
-/**
- * Options that tweak the behavior of {@link guardedBy}.
- *
- * @typeParam T - The instance type on which the decorator is applied.
- *
- * @public
- */
-export interface GuardedByOptions<T extends object> {
-    /**
-     * Inverts the predicate result.
-     *
-     * When `true`, a truthy predicate result **blocks** the method.
-     * When `false` (default) or omitted, a truthy predicate result **allows** the method.
-     *
-     * @defaultValue `false`
-     * @remarks
-     * This option is useful when the predicate expresses a *forbid* condition
-     * (e.g. "isLocked" or "isDestroyed") rather than an *allow* condition.
-     */
-    readonly invert?: boolean;
-    /**
-     * Either a function to call when a method is blocked, or the name/symbol of
-     * an instance method on `this` to call when blocked.
-     *
-     * Both forms are **synchronous** and receive `(methodName, argsArray)`.
-     * If omitted, blocked calls fail silently (i.e., return `undefined` or
-     * `Promise<undefined>` for async methods).
-     *
-     * @remarks
-     * - If a property key is supplied and the instance does not have a callable at that key,
-     *   the hook is ignored.
-     * - The hook **must not** be `async`; any async work should be scheduled manually.
-     */
-    readonly onBlocked?: BlockHandler | (keyof T & (string | symbol));
-}
-/**
- * Decorator factory that **guards** class methods behind a synchronous predicate.
- *
- * When a decorated method is invoked:
- * - If the predicate returns a value that evaluates to **allowed** (see `invert`), the original
- *   method is executed and its result is returned.
- * - If the call is **blocked**, the optional `onBlocked` hook is invoked (if configured) and:
- *   - `undefined` is returned for sync methods; or
- *   - `Promise<undefined>` is returned for async methods (to preserve `await` compatibility).
- *
- * @typeParam T - The instance type that owns both the predicate and the decorated method.
- *
- * @param predicateName - The name (string or symbol) of a **synchronous** instance method on `this`
- * that acts as the predicate. It is called as `this[predicateName](methodName, argsArray)`.
- * @param opts - Optional {@link GuardedByOptions | options} to configure inversion and `onBlocked`.
- *
- * @returns A methods-only class decorator compatible with Stage-3 decorators that wraps the method.
- *
- * @throws TypeError
- * Thrown at initialization time (first instance construction) if `predicateName` does not resolve
- * to a **synchronous function** on the instance.
- *
- * @remarks
- * - This is a **methods-only** decorator; applying it to accessors/fields is a no-op.
- * - The decorator preserves the original method's sync/async shape.
- * - The predicate is invoked with `(decoratedMethodName, argsArray)` to support context-aware checks.
- *
- * @example
- * Here, `canRun` allows the call when it returns truthy:
- * ```ts
- * class Runner {
- *   canRun(method: string, _args: readonly unknown[]) { return method !== 'stop'; }
- *
- *   @guardedBy<Runner>('canRun')
- *   go() { console.log('running'); }
- * }
- * ```
- *
- * @example
- * Invert the predicate and call a handler on block:
- * ```ts
- * class Door {
- *   isLocked() { return true } // truthy means "locked"
- *   onBlocked(method: string) { console.warn(`${method} blocked`) }
- *
- *   @guardedBy<Door>('isLocked', { invert: true, onBlocked: 'onBlocked' })
- *   open() { /* ... *\/ }
- * }
- * ```
- *
- * @public
- */
-export declare function guardedBy<T extends object>(predicateName: keyof T & (string | symbol), opts?: GuardedByOptions<T>): GuardedByFunction<T>;
-export {};
-//# sourceMappingURL=guardedBy.d.ts.map