@contentful/optimization-core 0.1.0-alpha

package/dist/CoreBase.js

@@ -0,0 +1,151 @@
+import { ApiClient, EventBuilder, } from '@contentful/optimization-api-client';
+import { ConsoleLogSink, logger } from 'logger';
+import { OPTIMIZATION_CORE_SDK_VERSION } from './global-constants';
+import { InterceptorManager } from './lib/interceptor';
+/**
+ * Internal base that wires the API client, event builder, and logging.
+ *
+ * @internal
+ */
+class CoreBase {
+    /** Shared Optimization API client instance. */
+    api;
+    /** Shared event builder instance. */
+    eventBuilder;
+    /** Resolved core configuration (minus any name metadata). */
+    config;
+    interceptors = {
+        event: new InterceptorManager(),
+        state: new InterceptorManager(),
+    };
+    /**
+     * Create the core with API client and logging preconfigured.
+     *
+     * @param config - Core configuration including API and builder options.
+     * @example
+     * ```ts
+     * const sdk = new CoreStateless({ clientId: 'abc123', environment: 'prod' })
+     * ```
+     */
+    constructor(config) {
+        this.config = config;
+        const { analytics, personalization, eventBuilder, logLevel, environment, clientId } = config;
+        logger.addSink(new ConsoleLogSink(logLevel));
+        const apiConfig = {
+            ...analytics,
+            ...personalization,
+            clientId,
+            environment,
+        };
+        this.api = new ApiClient(apiConfig);
+        this.eventBuilder = new EventBuilder(eventBuilder ?? {
+            channel: 'server',
+            library: { name: 'Optimization Core', version: OPTIMIZATION_CORE_SDK_VERSION },
+        });
+    }
+    /**
+     * Get the value of a custom flag derived from a set of optimization changes.
+     *
+     * @param name - The flag key to resolve.
+     * @param changes - Optional change list to resolve from
+     * @returns The resolved JSON value for the flag if available.
+     * @remarks
+     * This is a convenience wrapper around personalization’s flag resolution.
+     */
+    getCustomFlag(name, changes) {
+        return this.personalization.getCustomFlag(name, changes);
+    }
+    /**
+     * Resolve a Contentful entry to the appropriate personalized variant (or
+     * return the baseline entry if no matching variant is selected).
+     *
+     * @typeParam S - Entry skeleton type.
+     * @typeParam M - Chain modifiers.
+     * @typeParam L - Locale code.
+     * @param entry - The baseline entry to resolve.
+     * @param personalizations - Optional selection array for the current profile.
+     * @returns {@link ResolvedData} containing the resolved entry and
+     *   personalization metadata (if any).
+     */
+    personalizeEntry(entry, personalizations) {
+        return this.personalization.personalizeEntry(entry, personalizations);
+    }
+    /**
+     * Resolve a merge-tag value from the given entry node and profile.
+     *
+     * @param embeddedEntryNodeTarget - The merge-tag entry node to resolve.
+     * @param profile - Optional profile used for value lookup.
+     * @returns The resolved value (typically a string) or `undefined` if not found.
+     */
+    getMergeTagValue(embeddedEntryNodeTarget, profile) {
+        return this.personalization.getMergeTagValue(embeddedEntryNodeTarget, profile);
+    }
+    /**
+     * Convenience wrapper for sending an `identify` event via personalization.
+     *
+     * @param payload - Identify builder arguments.
+     * @returns The resulting {@link OptimizationData} for the identified user.
+     */
+    async identify(payload) {
+        return await this.personalization.identify(payload);
+    }
+    /**
+     * Convenience wrapper for sending a `page` event via personalization.
+     *
+     * @param payload - Page view builder arguments.
+     * @returns The evaluated {@link OptimizationData} for this page view.
+     */
+    async page(payload) {
+        return await this.personalization.page(payload);
+    }
+    /**
+     * Convenience wrapper for sending a `screen` event via personalization.
+     *
+     * @param payload - Screen view builder arguments.
+     * @returns The evaluated {@link OptimizationData} for this screen view.
+     */
+    async screen(payload) {
+        return await this.personalization.screen(payload);
+    }
+    /**
+     * Convenience wrapper for sending a custom `track` event via personalization.
+     *
+     * @param payload - Track builder arguments.
+     * @returns The evaluated {@link OptimizationData} for this event.
+     */
+    async track(payload) {
+        return await this.personalization.track(payload);
+    }
+    /**
+     * Track a component view in both personalization and analytics.
+     *
+     * @param payload - Component view builder arguments. When `payload.sticky` is
+     *   `true`, the event will also be sent via personalization as a sticky
+     *   component view.
+     * @param duplicationScope - Optional string used to scope duplication used in Stateful
+     * implementations
+     * @returns A promise that resolves when all delegated calls complete.
+     * @remarks
+     * The sticky behavior is delegated to personalization; analytics is always
+     * invoked regardless of `sticky`.
+     */
+    async trackComponentView(payload, duplicationScope) {
+        if (payload.sticky) {
+            return await this.personalization.trackComponentView(payload, duplicationScope);
+        }
+        await this.analytics.trackComponentView(payload, duplicationScope);
+    }
+    /**
+     * Track a feature flag view via analytics.
+     *
+     * @param payload - Component view builder arguments used to build the flag view event.
+     * @param duplicationScope - Optional string used to scope duplication used in Stateful
+     * implementations
+     * @returns A promise that resolves when processing completes.
+     */
+    async trackFlagView(payload, duplicationScope) {
+        await this.analytics.trackFlagView(payload, duplicationScope);
+    }
+}
+export default CoreBase;
+//# sourceMappingURL=CoreBase.js.map

package/dist/CoreBase.js.map

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

package/dist/CoreStateful.d.ts

@@ -0,0 +1,142 @@
+import type { InsightsEvent as AnalyticsEvent, ChangeArray, ExperienceEvent as PersonalizationEvent, Profile, SelectedPersonalizationArray } from '@contentful/optimization-api-client';
+import { AnalyticsStateful, type AnalyticsStates } from './analytics';
+import type { ConsentController } from './Consent';
+import CoreBase, { type CoreConfig } from './CoreBase';
+import { PersonalizationStateful, type PersonalizationProductConfig, type PersonalizationStates } from './personalization';
+import type { ProductConfig } from './ProductBase';
+import { type Observable, type Signals } from './signals';
+/**
+ * Interface for objects that can be registered with the preview panel system.
+ * When registered, the object receives direct access to SDK signals for state manipulation.
+ *
+ * @public
+ */
+export interface PreviewPanelSignalObject {
+    /** Signals instance that will be populated by registerPreviewPanel */
+    signals: Signals | null;
+}
+/**
+ * Combined observable state exposed by the stateful core.
+ *
+ * @public
+ * @see {@link AnalyticsStates}
+ * @see {@link PersonalizationStates}
+ */
+export interface CoreStates extends AnalyticsStates, PersonalizationStates {
+    /** Current consent value (if any). */
+    consent: Observable<boolean | undefined>;
+    /** Stream of the most recent event emitted (analytics or personalization). */
+    eventStream: Observable<AnalyticsEvent | PersonalizationEvent | undefined>;
+}
+/**
+ * Default values used to preconfigure the stateful core and products.
+ *
+ * @public
+ */
+export interface CoreConfigDefaults {
+    /** Global consent default applied at construction time. */
+    consent?: boolean;
+    /** Default active profile used for personalization and analytics. */
+    profile?: Profile;
+    /** Initial diff of changes produced by the service. */
+    changes?: ChangeArray;
+    /** Preselected personalization variants (e.g., winning treatments). */
+    personalizations?: SelectedPersonalizationArray;
+}
+/**
+ * Configuration for {@link CoreStateful}.
+ *
+ * @public
+ * @see {@link CoreConfig}
+ */
+export interface CoreStatefulConfig extends CoreConfig {
+    /**
+     * Allow-listed event type strings permitted when consent is not set.
+     *
+     * @see {@link ProductConfig.allowedEventTypes}
+     */
+    allowedEventTypes?: ProductConfig['allowedEventTypes'];
+    /** Optional set of default values applied on initialization. */
+    defaults?: CoreConfigDefaults;
+    /** Function used to obtain an anonymous user identifier. */
+    getAnonymousId?: PersonalizationProductConfig['getAnonymousId'];
+    /**
+     * Initial duplication prevention configuration for component events.
+     *
+     * @see {@link ProductConfig.preventedComponentEvents}
+     */
+    preventedComponentEvents?: ProductConfig['preventedComponentEvents'];
+}
+/**
+ * Core runtime that constructs stateful product instances and exposes shared
+ * states, including consent and the event stream.
+ *
+ * @public
+ * @remarks
+ * @see {@link CoreBase}
+ * @see {@link ConsentController}
+ */
+declare class CoreStateful extends CoreBase implements ConsentController {
+    /** Stateful analytics product. */
+    readonly analytics: AnalyticsStateful;
+    /** Stateful personalization product. */
+    readonly personalization: PersonalizationStateful;
+    /**
+     * Create a stateful core with optional default consent and product defaults.
+     *
+     * @param config - Core and defaults configuration.
+     * @example
+     * ```ts
+     * const core = new CoreStateful({
+     *   clientId: 'app',
+     *   environment: 'prod',
+     *   defaults: { consent: true }
+     * })
+     * core.consent(true)
+     * ```
+     */
+    constructor(config: CoreStatefulConfig);
+    /**
+     * Expose merged observable state for consumers.
+     */
+    get states(): CoreStates;
+    /**
+     * Reset internal state. Consent is intentionally preserved.
+     *
+     * @remarks
+     * Resetting personalization also resets analytics dependencies as a
+     * consequence of the current shared-state design.
+     */
+    reset(): void;
+    /**
+     * Flush the queues for both the analytics and personalization products.
+     * @remarks
+     * The personalization queue is only populated if events have been triggered
+     * while a device is offline.
+     */
+    flush(): Promise<void>;
+    /**
+     * Update consent state
+     *
+     * @param accept - `true` if the user has granted consent; `false` otherwise.
+     */
+    consent(accept: boolean): void;
+    /**
+     * Update online state
+     *
+     * @param isOnline - `true` if the browser is online; `false` otherwise.
+     */
+    protected online(isOnline: boolean): void;
+    /**
+     * Register a preview panel compatible object to receive direct signal access.
+     * This enables the preview panel to modify SDK state for testing and simulation.
+     *
+     * @param previewPanel - An object implementing PreviewPanelSignalObject
+     * @remarks
+     * This method is intended for use by the Preview Panel component.
+     * Direct signal access allows immediate state updates without API calls.
+     */
+    registerPreviewPanel(previewPanel: PreviewPanelSignalObject): void;
+}
+export default CoreStateful;
+//# sourceMappingURL=CoreStateful.d.ts.map

package/dist/CoreStateful.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreStateful.d.ts","sourceRoot":"","sources":["../src/CoreStateful.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,IAAI,cAAc,EAC/B,WAAW,EACX,eAAe,IAAI,oBAAoB,EACvC,OAAO,EACP,4BAA4B,EAC7B,MAAM,qCAAqC,CAAA;AAC5C,OAAO,EAAE,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,aAAa,CAAA;AACrE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAA;AAClD,OAAO,QAAQ,EAAE,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,EACL,uBAAuB,EACvB,KAAK,4BAA4B,EACjC,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAWL,KAAK,UAAU,EACf,KAAK,OAAO,EACb,MAAM,WAAW,CAAA;AAElB;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,sEAAsE;IACtE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;CACxB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,UAAW,SAAQ,eAAe,EAAE,qBAAqB;IACxE,sCAAsC;IACtC,OAAO,EAAE,UAAU,CAAC,OAAO,GAAG,SAAS,CAAC,CAAA;IACxC,8EAA8E;IAC9E,WAAW,EAAE,UAAU,CAAC,cAAc,GAAG,oBAAoB,GAAG,SAAS,CAAC,CAAA;CAC3E;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,qEAAqE;IACrE,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,uDAAuD;IACvD,OAAO,CAAC,EAAE,WAAW,CAAA;IACrB,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,4BAA4B,CAAA;CAChD;AAED;;;;;GAKG;AACH,MAAM,WAAW,kBAAmB,SAAQ,UAAU;IACpD;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,aAAa,CAAC,mBAAmB,CAAC,CAAA;IAEtD,gEAAgE;IAChE,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAE7B,4DAA4D;IAC5D,cAAc,CAAC,EAAE,4BAA4B,CAAC,gBAAgB,CAAC,CAAA;IAE/D;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,aAAa,CAAC,0BAA0B,CAAC,CAAA;CACrE;AAED;;;;;;;;GAQG;AACH,cAAM,YAAa,SAAQ,QAAS,YAAW,iBAAiB;IAC9D,kCAAkC;IAClC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAA;IACrC,wCAAwC;IACxC,QAAQ,CAAC,eAAe,EAAE,uBAAuB,CAAA;IAEjD;;;;;;;;;;;;;OAaG;gBACS,MAAM,EAAE,kBAAkB;IA0CtC;;OAEG;IACH,IAAI,MAAM,IAAI,UAAU,CAQvB;IAED;;;;;;OAMG;IACH,KAAK,IAAI,IAAI;IASb;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B;;;;OAIG;IACH,OAAO,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAI9B;;;;OAIG;IACH,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAIzC;;;;;;;;OAQG;IACH,oBAAoB,CAAC,YAAY,EAAE,wBAAwB,GAAG,IAAI;CAGnE;AAED,eAAe,YAAY,CAAA"}

package/dist/CoreStateful.js

@@ -0,0 +1,137 @@
+import { AnalyticsStateful } from './analytics';
+import CoreBase from './CoreBase';
+import { PersonalizationStateful, } from './personalization';
+import { batch, changes, consent, event, flags, online, personalizations, profile, signals, toObservable, } from './signals';
+/**
+ * Core runtime that constructs stateful product instances and exposes shared
+ * states, including consent and the event stream.
+ *
+ * @public
+ * @remarks
+ * @see {@link CoreBase}
+ * @see {@link ConsentController}
+ */
+class CoreStateful extends CoreBase {
+    /** Stateful analytics product. */
+    analytics;
+    /** Stateful personalization product. */
+    personalization;
+    /**
+     * Create a stateful core with optional default consent and product defaults.
+     *
+     * @param config - Core and defaults configuration.
+     * @example
+     * ```ts
+     * const core = new CoreStateful({
+     *   clientId: 'app',
+     *   environment: 'prod',
+     *   defaults: { consent: true }
+     * })
+     * core.consent(true)
+     * ```
+     */
+    constructor(config) {
+        super(config);
+        const { allowedEventTypes, defaults, getAnonymousId, preventedComponentEvents } = config;
+        if (defaults?.consent !== undefined) {
+            const { consent: defaultConsent } = defaults;
+            consent.value = defaultConsent;
+        }
+        this.analytics = new AnalyticsStateful({
+            api: this.api,
+            builder: this.eventBuilder,
+            config: {
+                allowedEventTypes,
+                preventedComponentEvents,
+                defaults: {
+                    consent: defaults?.consent,
+                    profile: defaults?.profile,
+                },
+            },
+            interceptors: this.interceptors,
+        });
+        this.personalization = new PersonalizationStateful({
+            api: this.api,
+            builder: this.eventBuilder,
+            config: {
+                allowedEventTypes,
+                getAnonymousId,
+                preventedComponentEvents,
+                defaults: {
+                    consent: defaults?.consent,
+                    changes: defaults?.changes,
+                    profile: defaults?.profile,
+                    personalizations: defaults?.personalizations,
+                },
+            },
+            interceptors: this.interceptors,
+        });
+    }
+    /**
+     * Expose merged observable state for consumers.
+     */
+    get states() {
+        return {
+            consent: toObservable(consent),
+            eventStream: toObservable(event),
+            flags: toObservable(flags),
+            personalizations: toObservable(personalizations),
+            profile: toObservable(profile),
+        };
+    }
+    /**
+     * Reset internal state. Consent is intentionally preserved.
+     *
+     * @remarks
+     * Resetting personalization also resets analytics dependencies as a
+     * consequence of the current shared-state design.
+     */
+    reset() {
+        batch(() => {
+            event.value = undefined;
+            changes.value = undefined;
+            profile.value = undefined;
+            personalizations.value = undefined;
+        });
+    }
+    /**
+     * Flush the queues for both the analytics and personalization products.
+     * @remarks
+     * The personalization queue is only populated if events have been triggered
+     * while a device is offline.
+     */
+    async flush() {
+        await this.analytics.flush();
+        await this.personalization.flush();
+    }
+    /**
+     * Update consent state
+     *
+     * @param accept - `true` if the user has granted consent; `false` otherwise.
+     */
+    consent(accept) {
+        consent.value = accept;
+    }
+    /**
+     * Update online state
+     *
+     * @param isOnline - `true` if the browser is online; `false` otherwise.
+     */
+    online(isOnline) {
+        online.value = isOnline;
+    }
+    /**
+     * Register a preview panel compatible object to receive direct signal access.
+     * This enables the preview panel to modify SDK state for testing and simulation.
+     *
+     * @param previewPanel - An object implementing PreviewPanelSignalObject
+     * @remarks
+     * This method is intended for use by the Preview Panel component.
+     * Direct signal access allows immediate state updates without API calls.
+     */
+    registerPreviewPanel(previewPanel) {
+        previewPanel.signals = signals;
+    }
+}
+export default CoreStateful;
+//# sourceMappingURL=CoreStateful.js.map

package/dist/CoreStateful.js.map

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

package/dist/CoreStateless.d.ts

@@ -0,0 +1,53 @@
+import type { EventBuilderConfig } from '@contentful/optimization-api-client';
+import { AnalyticsStateless } from './analytics';
+import CoreBase, { type CoreConfig } from './CoreBase';
+import { PersonalizationStateless } from './personalization';
+/**
+ * Configuration for the Node-specific Optimization SDK.
+ *
+ * @public
+ * @remarks
+ * This configuration extends {@link CoreConfig} but allows partial overrides
+ * of the event-builder configuration. SDKs commonly inject their own library
+ * metadata or channel definitions.
+ */
+export interface CoreStatelessConfig extends CoreConfig {
+    /**
+     * Override configuration for the analytics (Insights) API client. Omits
+     * `beaconHandler`.
+     */
+    analytics?: Omit<CoreConfig['analytics'], 'beaconHandler'>;
+    /**
+     * Overrides for the event builder configuration. Omits methods that are only
+     * useful in stateful environments.
+     */
+    eventBuilder?: Omit<EventBuilderConfig, 'getLocale' | 'getPageProperties' | 'getUserAgent'>;
+}
+/**
+ * Core runtime that constructs product instances for stateless environments.
+ *
+ * @public
+ * @see {@link CoreBase}
+ */
+declare class CoreStateless extends CoreBase {
+    /** Stateless analytics product. */
+    readonly analytics: AnalyticsStateless;
+    /** Stateless personalization product. */
+    readonly personalization: PersonalizationStateless;
+    /**
+     * Create a stateless core. Product instances share the same API client and
+     * event builder configured in {@link CoreBase}.
+     *
+     * @param config - Stateless Core configuration.
+     * @example
+     * ```ts
+     * const sdk = new CoreStateless({ clientId: 'app', environment: 'prod' })
+     * core.analytics.trackFlagView({ componentId: 'hero' })
+     * // or
+     * core.trackFlagView({ componentId: 'hero' })
+     * ```
+     */
+    constructor(config: CoreStatelessConfig);
+}
+export default CoreStateless;
+//# sourceMappingURL=CoreStateless.d.ts.map

package/dist/CoreStateless.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreStateless.d.ts","sourceRoot":"","sources":["../src/CoreStateless.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAA;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,QAAQ,EAAE,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAA;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAE5D;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD;;;OAGG;IACH,SAAS,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,eAAe,CAAC,CAAA;IAE1D;;;OAGG;IACH,YAAY,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,WAAW,GAAG,mBAAmB,GAAG,cAAc,CAAC,CAAA;CAC5F;AAED;;;;;GAKG;AACH,cAAM,aAAc,SAAQ,QAAQ;IAClC,mCAAmC;IACnC,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAA;IACtC,yCAAyC;IACzC,QAAQ,CAAC,eAAe,EAAE,wBAAwB,CAAA;IAElD;;;;;;;;;;;;OAYG;gBACS,MAAM,EAAE,mBAAmB;CAexC;AAED,eAAe,aAAa,CAAA"}

package/dist/CoreStateless.js

@@ -0,0 +1,43 @@
+import { AnalyticsStateless } from './analytics';
+import CoreBase from './CoreBase';
+import { PersonalizationStateless } from './personalization';
+/**
+ * Core runtime that constructs product instances for stateless environments.
+ *
+ * @public
+ * @see {@link CoreBase}
+ */
+class CoreStateless extends CoreBase {
+    /** Stateless analytics product. */
+    analytics;
+    /** Stateless personalization product. */
+    personalization;
+    /**
+     * Create a stateless core. Product instances share the same API client and
+     * event builder configured in {@link CoreBase}.
+     *
+     * @param config - Stateless Core configuration.
+     * @example
+     * ```ts
+     * const sdk = new CoreStateless({ clientId: 'app', environment: 'prod' })
+     * core.analytics.trackFlagView({ componentId: 'hero' })
+     * // or
+     * core.trackFlagView({ componentId: 'hero' })
+     * ```
+     */
+    constructor(config) {
+        super(config);
+        this.analytics = new AnalyticsStateless({
+            api: this.api,
+            builder: this.eventBuilder,
+            interceptors: this.interceptors,
+        });
+        this.personalization = new PersonalizationStateless({
+            api: this.api,
+            builder: this.eventBuilder,
+            interceptors: this.interceptors,
+        });
+    }
+}
+export default CoreStateless;
+//# sourceMappingURL=CoreStateless.js.map

package/dist/CoreStateless.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CoreStateless.js","sourceRoot":"","sources":["../src/CoreStateless.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAChD,OAAO,QAA6B,MAAM,YAAY,CAAA;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAyB5D;;;;;GAKG;AACH,MAAM,aAAc,SAAQ,QAAQ;IAClC,mCAAmC;IAC1B,SAAS,CAAoB;IACtC,yCAAyC;IAChC,eAAe,CAA0B;IAElD;;;;;;;;;;;;OAYG;IACH,YAAY,MAA2B;QACrC,KAAK,CAAC,MAAM,CAAC,CAAA;QAEb,IAAI,CAAC,SAAS,GAAG,IAAI,kBAAkB,CAAC;YACtC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAA;QAEF,IAAI,CAAC,eAAe,GAAG,IAAI,wBAAwB,CAAC;YAClD,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,OAAO,EAAE,IAAI,CAAC,YAAY;YAC1B,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAA;IACJ,CAAC;CACF;AAED,eAAe,aAAa,CAAA"}

package/dist/ProductBase.d.ts

@@ -0,0 +1,83 @@
+import type { InsightsEventType as AnalyticsEventType, ApiClient, EventBuilder, ExperienceEventType as PersonalizationEventType } from '@contentful/optimization-api-client';
+import type { LifecycleInterceptors } from './CoreBase';
+import ValuePresence from './lib/value-presence/ValuePresence';
+/**
+ * Union of all event {@link AnalyticsEventType | type keys} that this package may emit.
+ *
+ * @public
+ */
+export type EventType = AnalyticsEventType | PersonalizationEventType;
+/**
+ * Common configuration for all product implementations.
+ *
+ * @public
+ */
+export interface ProductConfig {
+    /**
+     * The set of event type strings that are allowed to be sent even if consent is
+     * not granted.
+     *
+     * @defaultValue `['page', 'identify']`
+     * @remarks These types are compared against the `type` property of events.
+     */
+    allowedEventTypes?: EventType[];
+    /**
+     * A map of duplication keys to a list of component IDs that should be
+     * considered duplicates and therefore suppressed.
+     *
+     * @remarks
+     * The actual duplication check is performed by {@link ValuePresence}. The
+     * keys of this record are used as duplication scopes. An empty string `''`
+     * is converted to an `indefined` scope when specific scopes are not required.
+     */
+    preventedComponentEvents?: Record<string, string[]>;
+}
+/**
+ * Options for configuring the common functionality of {@link ProductBase} descendents.
+ *
+ * @public
+ */
+export interface ProductBaseOptions {
+    /** Optimization API client. */
+    api: ApiClient;
+    /** Event builder for constructing events. */
+    builder: EventBuilder;
+    /** Optional configuration for allow‑lists and duplication prevention. */
+    config?: ProductConfig;
+    /** Lifecycle container for event and state interceptors. */
+    interceptors: LifecycleInterceptors;
+}
+/**
+ * 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.
+ */
+declare abstract class ProductBase {
+    /**
+     * Allow‑list of event {@link AnalyticsEventType | type keys} permitted when consent is not present.
+     */
+    protected readonly allowedEventTypes?: string[];
+    /** Event builder used to construct strongly‑typed events. */
+    protected readonly builder: EventBuilder;
+    /** Optimization API client used to send events to the Experience and Insights APIs. */
+    protected readonly api: ApiClient;
+    /**
+     * Deduplication helper used to track previously seen values within optional
+     * scopes
+     */
+    readonly duplicationDetector: ValuePresence;
+    /** Interceptors that can mutate/augment outgoing events or optimization state. */
+    readonly interceptors: LifecycleInterceptors;
+    /**
+     * Creates a new product base instance.
+     *
+     * @param options - Options for configuring the functionality common among products.
+     */
+    constructor(options: ProductBaseOptions);
+}
+export default ProductBase;
+//# sourceMappingURL=ProductBase.d.ts.map

package/dist/ProductBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProductBase.d.ts","sourceRoot":"","sources":["../src/ProductBase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,IAAI,kBAAkB,EACvC,SAAS,EACT,YAAY,EACZ,mBAAmB,IAAI,wBAAwB,EAChD,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA;AACvD,OAAO,aAAa,MAAM,oCAAoC,CAAA;AAE9D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,kBAAkB,GAAG,wBAAwB,CAAA;AAWrE;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,SAAS,EAAE,CAAA;IAE/B;;;;;;;;OAQG;IACH,wBAAwB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACpD;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,+BAA+B;IAC/B,GAAG,EAAE,SAAS,CAAA;IACd,6CAA6C;IAC7C,OAAO,EAAE,YAAY,CAAA;IACrB,yEAAyE;IACzE,MAAM,CAAC,EAAE,aAAa,CAAA;IACtB,4DAA4D;IAC5D,YAAY,EAAE,qBAAqB,CAAA;CACpC;AAED;;;;;;;;GAQG;AACH,uBAAe,WAAW;IACxB;;OAEG;IACH,SAAS,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAE/C,6DAA6D;IAC7D,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAExC,uFAAuF;IACvF,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAA;IAEjC;;;OAGG;IACH,QAAQ,CAAC,mBAAmB,EAAE,aAAa,CAAA;IAE3C,kFAAkF;IAClF,QAAQ,CAAC,YAAY,EAAE,qBAAqB,CAAA;IAE5C;;;;OAIG;gBACS,OAAO,EAAE,kBAAkB;CAQxC;AAED,eAAe,WAAW,CAAA"}