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

package/dist/personalization/PersonalizationStateless.js

@@ -1,98 +0,0 @@
-import { ComponentViewEvent, IdentifyEvent, PageViewEvent, ScreenViewEvent, TrackEvent, } from '@contentful/optimization-api-client';
-import { createScopedLogger } from 'logger';
-import PersonalizationBase from './PersonalizationBase';
-const logger = createScopedLogger('Personalization');
-/**
- * Stateless personalization implementation that immediately validates and sends
- * a single event to the Experience API, upserting the profile as needed.
- *
- * @public
- * @remarks
- * Each public method constructs a strongly-typed event via the shared builder,
- * runs it through event interceptors, and performs a profile upsert using the
- * Experience API. If an anonymous ID is available from the builder, it will be
- * preferred as the `profileId` unless an explicit profile is provided.
- */
-class PersonalizationStateless extends PersonalizationBase {
-    /**
-     * Identify the current profile/visitor to associate traits with a profile.
-     *
-     * @param payload - Identify builder arguments with an optional partial
-     * profile to attach to the upsert request.
-     * @returns The resulting {@link OptimizationData} for the identified user.
-     */
-    async identify(payload) {
-        logger.info('Sending "identify" event');
-        const { profile, ...builderArgs } = payload;
-        const event = IdentifyEvent.parse(this.builder.buildIdentify(builderArgs));
-        return await this.upsertProfile(event, profile);
-    }
-    /**
-     * Record a page view.
-     *
-     * @param payload - Page view builder arguments with an optional partial profile.
-     * @returns The evaluated {@link OptimizationData} for this page view.
-     */
-    async page(payload) {
-        logger.info('Sending "page" event');
-        const { profile, ...builderArgs } = payload;
-        const event = PageViewEvent.parse(this.builder.buildPageView(builderArgs));
-        return await this.upsertProfile(event, profile);
-    }
-    /**
-     * Record a screen view.
-     *
-     * @param payload - Screen view builder arguments with an optional partial profile.
-     * @returns The evaluated {@link OptimizationData} for this screen view.
-     */
-    async screen(payload) {
-        logger.info(`Sending "screen" event for "${payload.name}"`);
-        const { profile, ...builderArgs } = payload;
-        const event = ScreenViewEvent.parse(this.builder.buildScreenView(builderArgs));
-        return await this.upsertProfile(event, profile);
-    }
-    /**
-     * Record a custom track event.
-     *
-     * @param payload - Track builder arguments with an optional partial profile.
-     * @returns The evaluated {@link OptimizationData} for this event.
-     */
-    async track(payload) {
-        logger.info(`Sending "track" event "${payload.event}"`);
-        const { profile, ...builderArgs } = payload;
-        const event = TrackEvent.parse(this.builder.buildTrack(builderArgs));
-        return await this.upsertProfile(event, profile);
-    }
-    /**
-     * Record a "sticky" component view.
-     *
-     * @param payload - Component view builder arguments with an optional partial profile.
-     * @returns The evaluated {@link OptimizationData} for this component view.
-     */
-    async trackComponentView(payload) {
-        logger.info('Sending "track personalization" event');
-        const { profile, ...builderArgs } = payload;
-        const event = ComponentViewEvent.parse(this.builder.buildComponentView(builderArgs));
-        return await this.upsertProfile(event, profile);
-    }
-    /**
-     * Intercept, validate, and upsert the profile with a single personalization
-     * event.
-     *
-     * @param event - The {@link PersonalizationEvent} to submit.
-     * @param profile - Optional partial profile. If omitted, the anonymous ID from
-     * the builder (when present) is used as the `profileId`.
-     * @returns The {@link OptimizationData} returned by the Experience API.
-     * @internal
-     */
-    async upsertProfile(event, profile) {
-        const intercepted = await this.interceptors.event.run(event);
-        const data = await this.api.experience.upsertProfile({
-            profileId: profile?.id,
-            events: [intercepted],
-        });
-        return data;
-    }
-}
-export default PersonalizationStateless;
-//# sourceMappingURL=PersonalizationStateless.js.map

package/dist/personalization/PersonalizationStateless.js.map

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

package/dist/personalization/index.d.ts

@@ -1,6 +0,0 @@
-export * from './resolvers';
-export * from './PersonalizationStateful';
-export { default as PersonalizationStateful } from './PersonalizationStateful';
-export * from './PersonalizationStateless';
-export { default as PersonalizationStateless } from './PersonalizationStateless';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/personalization/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAE3B,cAAc,2BAA2B,CAAA;AACzC,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAE9E,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/personalization/index.js

@@ -1,6 +0,0 @@
-export * from './resolvers';
-export * from './PersonalizationStateful';
-export { default as PersonalizationStateful } from './PersonalizationStateful';
-export * from './PersonalizationStateless';
-export { default as PersonalizationStateless } from './PersonalizationStateless';
-//# sourceMappingURL=index.js.map

package/dist/personalization/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/personalization/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAA;AAE3B,cAAc,2BAA2B,CAAA;AACzC,OAAO,EAAE,OAAO,IAAI,uBAAuB,EAAE,MAAM,2BAA2B,CAAA;AAE9E,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,OAAO,IAAI,wBAAwB,EAAE,MAAM,4BAA4B,CAAA"}

package/dist/personalization/resolvers/FlagsResolver.d.ts

@@ -1,35 +0,0 @@
-import type { ChangeArray, Flags } from '@contentful/optimization-api-client';
-/**
- * Resolves a {@link Flags} map from a list of optimization changes.
- *
- * @public
- * @remarks
- * Given an Optimization {@link ChangeArray}, this utility flattens the list into a
- * simple key–value object suitable for quick lookups in client code. When `changes`
- * is `undefined`, an empty object is returned. If a change value is wrapped in an
- * object like `{ value: { ... } }`, this resolver unwraps it to the underlying object.
- */
-declare const FlagsResolver: {
-    /**
-     * Build a flattened map of flag keys to values from a change list.
-     *
-     * @param changes - The change list returned by the optimization service.
-     * @returns A map of flag keys to their resolved values.
-     * @example
-     * ```ts
-     * const flags = FlagsResolver.resolve(data.changes)
-     * if (flags['theme'] === 'dark') enableDarkMode()
-     * ```
-     * @example
-     * // Handles wrapped values produced by the API
-     * ```ts
-     * const flags = FlagsResolver.resolve([
-     *   { type: 'Variable', key: 'price', value: { value: { amount: 10, currency: 'USD' } } }
-     * ])
-     * console.log(flags.price.amount) // 10
-     * ```
-     */
-    resolve(changes?: ChangeArray): Flags;
-};
-export default FlagsResolver;
-//# sourceMappingURL=FlagsResolver.d.ts.map

package/dist/personalization/resolvers/FlagsResolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"FlagsResolver.d.ts","sourceRoot":"","sources":["../../../src/personalization/resolvers/FlagsResolver.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAA;AAE7E;;;;;;;;;GASG;AACH,QAAA,MAAM,aAAa;IACjB;;;;;;;;;;;;;;;;;;OAkBG;sBACe,WAAW,GAAG,KAAK;CAiBtC,CAAA;AAED,eAAe,aAAa,CAAA"}

package/dist/personalization/resolvers/FlagsResolver.js

@@ -1,47 +0,0 @@
-/**
- * Resolves a {@link Flags} map from a list of optimization changes.
- *
- * @public
- * @remarks
- * Given an Optimization {@link ChangeArray}, this utility flattens the list into a
- * simple key–value object suitable for quick lookups in client code. When `changes`
- * is `undefined`, an empty object is returned. If a change value is wrapped in an
- * object like `{ value: { ... } }`, this resolver unwraps it to the underlying object.
- */
-const FlagsResolver = {
-    /**
-     * Build a flattened map of flag keys to values from a change list.
-     *
-     * @param changes - The change list returned by the optimization service.
-     * @returns A map of flag keys to their resolved values.
-     * @example
-     * ```ts
-     * const flags = FlagsResolver.resolve(data.changes)
-     * if (flags['theme'] === 'dark') enableDarkMode()
-     * ```
-     * @example
-     * // Handles wrapped values produced by the API
-     * ```ts
-     * const flags = FlagsResolver.resolve([
-     *   { type: 'Variable', key: 'price', value: { value: { amount: 10, currency: 'USD' } } }
-     * ])
-     * console.log(flags.price.amount) // 10
-     * ```
-     */
-    resolve(changes) {
-        if (!changes)
-            return {};
-        return changes.reduce((acc, { key, value }) => {
-            const actualValue = typeof value === 'object' &&
-                value !== null &&
-                'value' in value &&
-                typeof value.value === 'object'
-                ? value.value
-                : value;
-            acc[key] = actualValue;
-            return acc;
-        }, {});
-    },
-};
-export default FlagsResolver;
-//# sourceMappingURL=FlagsResolver.js.map

package/dist/personalization/resolvers/FlagsResolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"FlagsResolver.js","sourceRoot":"","sources":["../../../src/personalization/resolvers/FlagsResolver.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,MAAM,aAAa,GAAG;IACpB;;;;;;;;;;;;;;;;;;OAkBG;IACH,OAAO,CAAC,OAAqB;QAC3B,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAA;QAEvB,OAAO,OAAO,CAAC,MAAM,CAAQ,CAAC,GAAG,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;YACnD,MAAM,WAAW,GACf,OAAO,KAAK,KAAK,QAAQ;gBACzB,KAAK,KAAK,IAAI;gBACd,OAAO,IAAI,KAAK;gBAChB,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ;gBAC7B,CAAC,CAAC,KAAK,CAAC,KAAK;gBACb,CAAC,CAAC,KAAK,CAAA;YAEX,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAA;YAEtB,OAAO,GAAG,CAAA;QACZ,CAAC,EAAE,EAAE,CAAC,CAAA;IACR,CAAC;CACF,CAAA;AAED,eAAe,aAAa,CAAA"}

package/dist/personalization/resolvers/MergeTagValueResolver.d.ts

@@ -1,74 +0,0 @@
-import { MergeTagEntry, Profile } from '@contentful/optimization-api-client';
-/**
- * Resolves merge tag values from a {@link Profile}.
- *
- * @public
- * @remarks
- * *Merge tags* are references to user profile data that may be embedded in content
- * and expanded at runtime. This resolver normalizes the merge-tag identifier into
- * a set of candidate selectors and searches the profile for a matching value.
- * Result values are returned as strings; numeric/boolean primitives are stringified.
- */
-declare const MergeTagValueResolver: {
-    /**
-     * Type guard to ensure the input is a {@link MergeTagEntry}.
-     *
-     * @param embeddedEntryNodeTarget - Unknown value to validate.
-     * @returns `true` if the input is a valid merge-tag entry.
-     * @example
-     * ```ts
-     * if (MergeTagValueResolver.isMergeTagEntry(node)) {
-     *   // safe to read fields
-     * }
-     * ```
-     */
-    isMergeTagEntry(embeddedEntryNodeTarget: unknown): embeddedEntryNodeTarget is MergeTagEntry;
-    /**
-     * Generate a list of candidate selectors for a merge-tag ID.
-     *
-     * @param id - Merge-tag identifier (segments separated by `_`).
-     * @returns Array of dot-path selectors to try against a profile.
-     * @example
-     * ```ts
-     * // "profile_name_first" -> [
-     * //   'profile',
-     * //   'profile.name',
-     * //   'profile.name.first'
-     * // ]
-     * const selectors = MergeTagValueResolver.normalizeSelectors('profile_name_first')
-     * ```
-     */
-    normalizeSelectors(id: string): string[];
-    /**
-     * Look up a merge-tag value from a profile using normalized selectors.
-     *
-     * @param id - Merge-tag identifier.
-     * @param profile - Profile from which to resolve the value.
-     * @returns A stringified primitive if found; otherwise `undefined`.
-     * @example
-     * ```ts
-     * const value = MergeTagValueResolver.getValueFromProfile('user_email', profile)
-     * if (value) sendEmailTo(value)
-     * ```
-     * @remarks
-     * Only string/number/boolean primitives are returned; objects/arrays are ignored.
-     */
-    getValueFromProfile(id: string, profile?: Profile): string | undefined;
-    /**
-     * Resolve the display value for a merge-tag entry using the provided profile,
-     * falling back to the entry's configured `nt_fallback` when necessary.
-     *
-     * @param mergeTagEntry - The merge-tag entry to resolve.
-     * @param profile - Optional profile used for lookup.
-     * @returns The resolved string, or `undefined` if the entry is invalid and no
-     * fallback is available.
-     * @example
-     * ```ts
-     * const text = MergeTagValueResolver.resolve(entry, profile)
-     * render(text ?? 'Guest')
-     * ```
-     */
-    resolve(mergeTagEntry: MergeTagEntry | undefined, profile?: Profile): string | undefined;
-};
-export default MergeTagValueResolver;
-//# sourceMappingURL=MergeTagValueResolver.d.ts.map

package/dist/personalization/resolvers/MergeTagValueResolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MergeTagValueResolver.d.ts","sourceRoot":"","sources":["../../../src/personalization/resolvers/MergeTagValueResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAA;AAS5E;;;;;;;;;GASG;AACH,QAAA,MAAM,qBAAqB;IACzB;;;;;;;;;;;OAWG;6CACsC,OAAO,GAAG,uBAAuB,IAAI,aAAa;IAI3F;;;;;;;;;;;;;;OAcG;2BACoB,MAAM,GAAG,MAAM,EAAE;IASxC;;;;;;;;;;;;;OAaG;4BACqB,MAAM,YAAY,OAAO,GAAG,MAAM,GAAG,SAAS;IAiBtE;;;;;;;;;;;;;OAaG;2BACoB,aAAa,GAAG,SAAS,YAAY,OAAO,GAAG,MAAM,GAAG,SAAS;CAoBzF,CAAA;AAED,eAAe,qBAAqB,CAAA"}

package/dist/personalization/resolvers/MergeTagValueResolver.js

@@ -1,109 +0,0 @@
-import { MergeTagEntry, Profile } from '@contentful/optimization-api-client';
-import { get } from 'es-toolkit/compat';
-import { createScopedLogger } from 'logger';
-const logger = createScopedLogger('Personalization');
-/** Base string for log messages when merge-tag resolution fails. */
-const RESOLUTION_WARNING_BASE = 'Could not resolve Merge Tag value:';
-/**
- * Resolves merge tag values from a {@link Profile}.
- *
- * @public
- * @remarks
- * *Merge tags* are references to user profile data that may be embedded in content
- * and expanded at runtime. This resolver normalizes the merge-tag identifier into
- * a set of candidate selectors and searches the profile for a matching value.
- * Result values are returned as strings; numeric/boolean primitives are stringified.
- */
-const MergeTagValueResolver = {
-    /**
-     * Type guard to ensure the input is a {@link MergeTagEntry}.
-     *
-     * @param embeddedEntryNodeTarget - Unknown value to validate.
-     * @returns `true` if the input is a valid merge-tag entry.
-     * @example
-     * ```ts
-     * if (MergeTagValueResolver.isMergeTagEntry(node)) {
-     *   // safe to read fields
-     * }
-     * ```
-     */
-    isMergeTagEntry(embeddedEntryNodeTarget) {
-        return MergeTagEntry.safeParse(embeddedEntryNodeTarget).success;
-    },
-    /**
-     * Generate a list of candidate selectors for a merge-tag ID.
-     *
-     * @param id - Merge-tag identifier (segments separated by `_`).
-     * @returns Array of dot-path selectors to try against a profile.
-     * @example
-     * ```ts
-     * // "profile_name_first" -> [
-     * //   'profile',
-     * //   'profile.name',
-     * //   'profile.name.first'
-     * // ]
-     * const selectors = MergeTagValueResolver.normalizeSelectors('profile_name_first')
-     * ```
-     */
-    normalizeSelectors(id) {
-        return id.split('_').map((_path, index, paths) => {
-            const dotPath = paths.slice(0, index).join('.');
-            const underScorePath = paths.slice(index).join('_');
-            return [dotPath, underScorePath].filter((path) => path !== '').join('.');
-        });
-    },
-    /**
-     * Look up a merge-tag value from a profile using normalized selectors.
-     *
-     * @param id - Merge-tag identifier.
-     * @param profile - Profile from which to resolve the value.
-     * @returns A stringified primitive if found; otherwise `undefined`.
-     * @example
-     * ```ts
-     * const value = MergeTagValueResolver.getValueFromProfile('user_email', profile)
-     * if (value) sendEmailTo(value)
-     * ```
-     * @remarks
-     * Only string/number/boolean primitives are returned; objects/arrays are ignored.
-     */
-    getValueFromProfile(id, profile) {
-        const selectors = MergeTagValueResolver.normalizeSelectors(id);
-        const matchingSelector = selectors.find((selector) => get(profile, selector));
-        if (!matchingSelector)
-            return undefined;
-        const value = get(profile, matchingSelector);
-        if (!value ||
-            (typeof value !== 'string' && typeof value !== 'number' && typeof value !== 'boolean'))
-            return undefined;
-        return `${value}`;
-    },
-    /**
-     * Resolve the display value for a merge-tag entry using the provided profile,
-     * falling back to the entry's configured `nt_fallback` when necessary.
-     *
-     * @param mergeTagEntry - The merge-tag entry to resolve.
-     * @param profile - Optional profile used for lookup.
-     * @returns The resolved string, or `undefined` if the entry is invalid and no
-     * fallback is available.
-     * @example
-     * ```ts
-     * const text = MergeTagValueResolver.resolve(entry, profile)
-     * render(text ?? 'Guest')
-     * ```
-     */
-    resolve(mergeTagEntry, profile) {
-        if (!MergeTagValueResolver.isMergeTagEntry(mergeTagEntry)) {
-            logger.warn(`${RESOLUTION_WARNING_BASE} supplied entry is not a Merge Tag entry`);
-            return;
-        }
-        const { fields: { nt_fallback: fallback }, } = mergeTagEntry;
-        if (!Profile.safeParse(profile).success) {
-            logger.warn(`${RESOLUTION_WARNING_BASE} no valid profile`);
-            return fallback;
-        }
-        return (MergeTagValueResolver.getValueFromProfile(mergeTagEntry.fields.nt_mergetag_id, profile) ??
-            fallback);
-    },
-};
-export default MergeTagValueResolver;
-//# sourceMappingURL=MergeTagValueResolver.js.map

package/dist/personalization/resolvers/MergeTagValueResolver.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"MergeTagValueResolver.js","sourceRoot":"","sources":["../../../src/personalization/resolvers/MergeTagValueResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,MAAM,qCAAqC,CAAA;AAC5E,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAA;AACvC,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAA;AAE3C,MAAM,MAAM,GAAG,kBAAkB,CAAC,iBAAiB,CAAC,CAAA;AAEpD,oEAAoE;AACpE,MAAM,uBAAuB,GAAG,oCAAoC,CAAA;AAEpE;;;;;;;;;GASG;AACH,MAAM,qBAAqB,GAAG;IAC5B;;;;;;;;;;;OAWG;IACH,eAAe,CAAC,uBAAgC;QAC9C,OAAO,aAAa,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC,OAAO,CAAA;IACjE,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,kBAAkB,CAAC,EAAU;QAC3B,OAAO,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;YAC/C,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAC/C,MAAM,cAAc,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YAEnD,OAAO,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC1E,CAAC,CAAC,CAAA;IACJ,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,mBAAmB,CAAC,EAAU,EAAE,OAAiB;QAC/C,MAAM,SAAS,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAA;QAC9D,MAAM,gBAAgB,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAA;QAE7E,IAAI,CAAC,gBAAgB;YAAE,OAAO,SAAS,CAAA;QAEvC,MAAM,KAAK,GAAY,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC,CAAA;QAErD,IACE,CAAC,KAAK;YACN,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,CAAC;YAEtF,OAAO,SAAS,CAAA;QAElB,OAAO,GAAG,KAAK,EAAE,CAAA;IACnB,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,OAAO,CAAC,aAAwC,EAAE,OAAiB;QACjE,IAAI,CAAC,qBAAqB,CAAC,eAAe,CAAC,aAAa,CAAC,EAAE,CAAC;YAC1D,MAAM,CAAC,IAAI,CAAC,GAAG,uBAAuB,0CAA0C,CAAC,CAAA;YACjF,OAAM;QACR,CAAC;QAED,MAAM,EACJ,MAAM,EAAE,EAAE,WAAW,EAAE,QAAQ,EAAE,GAClC,GAAG,aAAa,CAAA;QAEjB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC;YACxC,MAAM,CAAC,IAAI,CAAC,GAAG,uBAAuB,mBAAmB,CAAC,CAAA;YAC1D,OAAO,QAAQ,CAAA;QACjB,CAAC;QAED,OAAO,CACL,qBAAqB,CAAC,mBAAmB,CAAC,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,OAAO,CAAC;YACvF,QAAQ,CACT,CAAA;IACH,CAAC;CACF,CAAA;AAED,eAAe,qBAAqB,CAAA"}

package/dist/personalization/resolvers/PersonalizedEntryResolver.d.ts

@@ -1,142 +0,0 @@
-import { type EntryReplacementVariant, type PersonalizationEntry, type PersonalizedEntry, type SelectedPersonalization, type SelectedPersonalizationArray } from '@contentful/optimization-api-client';
-import type { ChainModifiers, Entry, EntrySkeletonType, LocaleCode } from 'contentful';
-/**
- * Result returned by {@link PersonalizedEntryResolver.resolve}.
- *
- * @typeParam S - Entry skeleton type.
- * @typeParam M - Chain modifiers.
- * @typeParam L - Locale code.
- * @public
- */
-export interface ResolvedData<S extends EntrySkeletonType, M extends ChainModifiers = ChainModifiers, L extends LocaleCode = LocaleCode> {
-    /** The baseline or resolved variant entry. */
-    entry: Entry<S, M, L>;
-    /** The selected personalization metadata, if a non‑baseline variant was chosen. */
-    personalization?: SelectedPersonalization;
-}
-/**
- * Resolve a personalized Contentful entry to the correct variant for the current
- * selections.
- *
- * @public
- * @remarks
- * Given a baseline {@link PersonalizedEntry} and a set of selected personalizations
- * (variants per experience), this resolver finds the matching replacement variant
- * for the component configured against the baseline entry.
- *
- * **Variant indexing**: `variantIndex` in {@link SelectedPersonalization} is treated as
- * 1‑based (index 1 = first variant). A value of `0` indicates baseline.
- */
-declare const PersonalizedEntryResolver: {
-    /**
-     * Find the personalization entry corresponding to one of the selected experiences.
-     *
-     * @param params - Object containing the baseline personalized entry and the selections.
-     * @param skipValidation - When `true`, skip type/shape validation for perf.
-     * @returns The matching {@link PersonalizationEntry}, or `undefined` if not found/invalid.
-     * @example
-     * ```ts
-     * const personalizationEntry = PersonalizedEntryResolver.getPersonalizationEntry({
-     *   personalizedEntry: entry,
-     *   selectedPersonalizations
-     * })
-     * ```
-     * @remarks
-     * A personalization entry is a personalization configuration object supplied in a
-     * `PersonalizedEntry.nt_experiences` array. A personalized entry may relate to
-     * multiple personalizations.
-     */
-    getPersonalizationEntry({ personalizedEntry, selectedPersonalizations, }: {
-        personalizedEntry: PersonalizedEntry;
-        selectedPersonalizations: SelectedPersonalizationArray;
-    }, skipValidation?: boolean): PersonalizationEntry | undefined;
-    /**
-     * Look up the selection metadata for a specific personalization entry.
-     *
-     * @param params - Object with the target personalization entry and selections.
-     * @param skipValidation - When `true`, skip type checks.
-     * @returns The matching {@link SelectedPersonalization}, if present.
-     * @example
-     * ```ts
-     * const selectedPersonalization = PersonalizedEntryResolver.getSelectedPersonalization({
-     *   personalizationEntry,
-     *   selectedPersonalizations
-     * })
-     * ```
-     * @remarks
-     * Selected personalizations are supplied by the Experience API in the
-     * `experiences` response data property.
-     */
-    getSelectedPersonalization({ personalizationEntry, selectedPersonalizations, }: {
-        personalizationEntry: PersonalizationEntry;
-        selectedPersonalizations: SelectedPersonalizationArray;
-    }, skipValidation?: boolean): SelectedPersonalization | undefined;
-    /**
-     * Get the replacement variant config for the given selection index.
-     *
-     * @param params - Baseline entry, personalization entry, and 1‑based variant index.
-     * @param skipValidation - When `true`, skip type checks.
-     * @returns The {@link EntryReplacementVariant} for the component, if any.
-     * @example
-     * ```ts
-     * const selectedVariant = PersonalizedEntryResolver.getSelectedVariant({
-     *   personalizedEntry: entry,
-     *   personalizationEntry,
-     *   selectedVariantIndex: 2 // second variant (1‑based)
-     * })
-     * ```
-     * @remarks
-     * Entry replacement variants are variant configurations specified in a
-     * personalization configuration component's `variants` array supplied by the
-     * personalized entry via its `nt_config` field.
-     */
-    getSelectedVariant({ personalizedEntry, personalizationEntry, selectedVariantIndex, }: {
-        personalizedEntry: PersonalizedEntry;
-        personalizationEntry: PersonalizationEntry;
-        selectedVariantIndex: number;
-    }, skipValidation?: boolean): EntryReplacementVariant | undefined;
-    /**
-     * Resolve the concrete Contentful entry that corresponds to a selected variant.
-     *
-     * @typeParam S - Entry skeleton type.
-     * @typeParam M - Chain modifiers.
-     * @typeParam L - Locale code.
-     * @param params - Personalization entry and selected variant.
-     * @param skipValidation - When `true`, skip type checks.
-     * @returns The resolved entry typed as {@link Entry} or `undefined`.
-     * @example
-     * ```ts
-     * const selectedVariantEntry = PersonalizedEntryResolver.getSelectedVariantEntry<{ fields: unknown }>({
-     *   personalizationEntry,
-     *   selectedVariant
-     * })
-     * ```
-     * @remarks
-     * A personalized entry will resolve either to the baseline (the entry
-     * supplied as `personalizedEntry`) or the selected variant.
-     */
-    getSelectedVariantEntry<S extends EntrySkeletonType, M extends ChainModifiers = ChainModifiers, L extends LocaleCode = string>({ personalizationEntry, selectedVariant, }: {
-        personalizationEntry: PersonalizationEntry;
-        selectedVariant: EntryReplacementVariant;
-    }, skipValidation?: boolean): Entry<S, M, L> | undefined;
-    /**
-     * Resolve the selected entry (baseline or variant) for a personalized entry
-     * and optional selected personalizations, returning both the entry and the
-     * personalization metadata.
-     *
-     * @typeParam S - Entry skeleton type.
-     * @typeParam M - Chain modifiers.
-     * @typeParam L - Locale code.
-     * @param entry - The baseline personalized entry.
-     * @param selectedPersonalizations - Optional selections for the current profile.
-     * @returns An object containing the resolved entry and (if chosen) the selection.
-     * @example
-     * ```ts
-     * const { entry: personalizedEntry, personalization } = PersonalizedEntryResolver.resolve(entry, selections)
-     * if (personalization) console.log('Variant index', personalization.variantIndex)
-     * ```
-     */
-    resolve<S extends EntrySkeletonType, M extends ChainModifiers = ChainModifiers, L extends LocaleCode = string>(entry: Entry<S, M, L>, selectedPersonalizations?: SelectedPersonalizationArray): ResolvedData<S, M, L>;
-};
-export default PersonalizedEntryResolver;
-//# sourceMappingURL=PersonalizedEntryResolver.d.ts.map

package/dist/personalization/resolvers/PersonalizedEntryResolver.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"PersonalizedEntryResolver.d.ts","sourceRoot":"","sources":["../../../src/personalization/resolvers/PersonalizedEntryResolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,uBAAuB,EAM5B,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,4BAA4B,EAClC,MAAM,qCAAqC,CAAA;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAKtF;;;;;;;GAOG;AACH,MAAM,WAAW,YAAY,CAC3B,CAAC,SAAS,iBAAiB,EAC3B,CAAC,SAAS,cAAc,GAAG,cAAc,EACzC,CAAC,SAAS,UAAU,GAAG,UAAU;IAEjC,8CAA8C;IAC9C,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IACrB,mFAAmF;IACnF,eAAe,CAAC,EAAE,uBAAuB,CAAA;CAC1C;AAKD;;;;;;;;;;;;GAYG;AACH,QAAA,MAAM,yBAAyB;IAC7B;;;;;;;;;;;;;;;;;OAiBG;8EAKE;QACD,iBAAiB,EAAE,iBAAiB,CAAA;QACpC,wBAAwB,EAAE,4BAA4B,CAAA;KACvD,6BAEA,oBAAoB,GAAG,SAAS;IAkBnC;;;;;;;;;;;;;;;;OAgBG;oFAKE;QACD,oBAAoB,EAAE,oBAAoB,CAAA;QAC1C,wBAAwB,EAAE,4BAA4B,CAAA;KACvD,6BAEA,uBAAuB,GAAG,SAAS;IActC;;;;;;;;;;;;;;;;;;OAkBG;2FAME;QACD,iBAAiB,EAAE,iBAAiB,CAAA;QACpC,oBAAoB,EAAE,oBAAoB,CAAA;QAC1C,oBAAoB,EAAE,MAAM,CAAA;KAC7B,6BAEA,uBAAuB,GAAG,SAAS;IAmBtC;;;;;;;;;;;;;;;;;;;OAmBG;4BAED,CAAC,SAAS,iBAAiB,EAC3B,CAAC,SAAS,cAAc,mBACxB,CAAC,SAAS,UAAU,uDAKjB;QACD,oBAAoB,EAAE,oBAAoB,CAAA;QAC1C,eAAe,EAAE,uBAAuB,CAAA;KACzC,6BAEA,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,SAAS;IAc7B;;;;;;;;;;;;;;;;OAgBG;YAED,CAAC,SAAS,iBAAiB,EAC3B,CAAC,SAAS,cAAc,mBACxB,CAAC,SAAS,UAAU,kBAEb,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,6BACM,4BAA4B,GACtD,YAAY,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;CAmFzB,CAAA;AAED,eAAe,yBAAyB,CAAA"}