@picked/client 0.0.62-next.1 → 0.0.62-next.10

package/dist/types/picked.d.ts

@@ -1,215 +1,176 @@
+import { Effect, EventCallable, Store, StoreWritable } from 'effector';
 import { Experience, LaunchExperienceOptions } from './entities/experience/experience';
 import { Plugin, PluginConfigIndex } from './entities/plugin/plugin';
 import { CreateClientOptions } from './client';
 import { AdaptedComponent } from './entities/component/component';
 import { Framework } from './entities/framework/framework';
-import { StateSnapshot } from './utils/state-snaphot';
+import { StateSnapshot } from './lifecycle/state-snapshot';
+import { EvaluateRuleLogicParams } from './lifecycle/rules-logic';
+import { LifecycleStage } from './lifecycle/lifecycle';
 import { Predicate } from './entities/predicate/predicate';
 import { Feature } from './entities/feature/feature';
 import { EventBusPayload, EventHistoryStore } from './utils/events';
 import { Field } from './entities/field/field';
 import { ExperienceStep } from './entities/step/step';
+import { Content } from './entities/content/content';
+import { ContentLoader } from './plugins/dynamic-experiences/types';
 import { Action } from './entities/action/action';
 import { Condition } from './entities/condition/condition';
-import { SessionStore } from './utils/user-session';
-import { LogicRule } from './logic-engine';
+import { SessionEntity } from './entities/session/session';
+/**
+ * Provenance metadata describing where the Picked client's project config and
+ * content came from. Set by `dynamicExperiencesPlugin` when the Vite plugin's
+ * virtual data module is available; remains `null` otherwise.
+ */
+export interface PickedDataSource {
+    /** `'build'` when build-mode prefetch JSON was used, `'dev'` when the dev-mode runtime fetch was used. */
+    mode: 'dev' | 'build';
+    /** ISO 8601 timestamp from the manifest. `null` in dev mode where no manifest is written. */
+    fetchedAt: string | null;
+    /** The `versionId` recorded by the source, when known. */
+    projectVersionId: string | null;
+    /** The `workspaceId` recorded by the source, when known. */
+    workspaceId: string | null;
+}
 export declare class Picked {
     static readonly logger: (level: "log" | "warn" | "info" | "error", ...args: Parameters<Console["log"]>) => void;
     private readonly options;
-    isReady: boolean;
+    /**
+     * Provenance metadata for the data backing this client. Populated by
+     * `dynamicExperiencesPlugin` when the Vite plugin's virtual data module is
+     * resolvable; remains `null` when the SDK is using the runtime API path.
+     */
+    dataSource: PickedDataSource | null;
+    /**
+     * Content fetcher selected by `dynamicExperiencesPlugin`'s resolution chain. Called
+     * by each experience's `prepareExperienceContentFx` (fired in parallel with
+     * `initialiseFx` by the per-experience sample graph). `undefined` when no plugin
+     * has registered one yet.
+     */
+    contentLoader?: ContentLoader;
     private readonly plugins;
-    private readonly pluginStartHooks;
-    readonly eventBus: import('effector').EventCallable<EventBusPayload>;
+    readonly eventBus: EventCallable<EventBusPayload>;
     readonly events: EventHistoryStore;
-    readonly organizationId: string;
     readonly projectId: string;
     readonly apiUrl: string;
     readonly dashboardUrl: string;
     readonly documentationSiteUrl: string;
-    readonly session?: SessionStore | null;
-    readonly precondition?: LogicRule | boolean;
-    readonly condition?: LogicRule | boolean;
-    preconditionPassed?: boolean;
+    readonly session: SessionEntity;
     readonly searchParams: import('.').PickedSearchParams;
     readonly history: {
-        push: import('effector').EventCallable<{
+        push: EventCallable<{
             experienceId: string;
             node: import('.').ExperienceNode;
         }>;
-        replace: import('effector').EventCallable<{
+        replace: EventCallable<{
             experienceId: string;
             node: import('.').ExperienceNode;
         }>;
-        back: import('effector').EventCallable<{
+        back: EventCallable<{
             experienceId?: string;
         }>;
-        restore: import('effector').EventCallable<{
+        restore: EventCallable<{
             entries: import('.').HistoryEntry[];
         }>;
-        entriesStore: import('effector').Store<import('.').HistoryEntry[]>;
+        entriesStore: Store<import('.').HistoryEntry[]>;
     };
     readonly components: {
-        register: (name: string, component: AdaptedComponent) => void;
-        getByName: (name: string) => import('effector').Store<{
+        register: EventCallable<{
+            name: string;
+            component: AdaptedComponent;
+        }>;
+        getByName: (name: string) => Store<{
             name: string;
             component: AdaptedComponent;
         } | undefined>;
-        listStore: import('effector').Store<{
+        listStore: Store<{
             name: string;
             component: AdaptedComponent<string, unknown>;
-            frameworkStore: import('effector').Store<Framework | undefined>;
+            frameworkStore: Store<Framework | undefined>;
         }[]>;
     };
     readonly experienceInstances: {
         spawn: (experience: import('.').ExperienceStore, target: HTMLElement, options?: LaunchExperienceOptions) => void;
-        getByExperienceKey: (key: Experience["key"]) => import('effector').Store<import('.').ExperienceInstance[]>;
-        getByExperienceId: (id: Experience["id"]) => import('effector').Store<import('.').ExperienceInstance[]>;
-        listStore: import('effector').Store<import('.').ExperienceInstance[]>;
+        getByExperienceKey: (key: Experience["key"]) => Store<import('.').ExperienceInstance[]>;
+        getByExperienceId: (id: Experience["id"]) => Store<import('.').ExperienceInstance[]>;
+        listStore: Store<import('.').ExperienceInstance[]>;
     };
     readonly experiences: {
-        register: (experience: Experience) => void;
-        get: (id: Experience["id"]) => import('effector').Store<{
-            id: string;
-            key: string;
-            name: string;
-            configStore: import('effector').Store<{
-                name: string;
-                decisionLogic: import('./logic-engine').LogicValue | LogicRule;
-                targetSelectors: import('.').ExperienceTarget[];
-                initializeOpenLogic: import('./logic-engine').LogicValue | LogicRule;
-            }>;
-            treeStore: import('effector').Store<{
-                steps: ExperienceStep[];
-                nodes: import('.').ExperienceNode[];
-                edges: import('.').ExperienceEdge[];
-                conditions: Condition[];
-            }>;
-            componentStore: import('effector').Store<{
-                name: string;
-                component: AdaptedComponent<string, unknown>;
-                frameworkStore: import('effector').Store<Framework | undefined>;
-            } | undefined>;
-            actions: import('.').ExperienceAction[];
-            merge: import('effector').EventCallable<{
-                experience: Partial<Experience>;
-                strategy: "override";
-            }>;
-        } | undefined>;
-        getById: (id: Experience["id"]) => import('effector').Store<{
-            id: string;
-            key: string;
-            name: string;
-            configStore: import('effector').Store<{
-                name: string;
-                decisionLogic: import('./logic-engine').LogicValue | LogicRule;
-                targetSelectors: import('.').ExperienceTarget[];
-                initializeOpenLogic: import('./logic-engine').LogicValue | LogicRule;
-            }>;
-            treeStore: import('effector').Store<{
-                steps: ExperienceStep[];
-                nodes: import('.').ExperienceNode[];
-                edges: import('.').ExperienceEdge[];
-                conditions: Condition[];
-            }>;
-            componentStore: import('effector').Store<{
-                name: string;
-                component: AdaptedComponent<string, unknown>;
-                frameworkStore: import('effector').Store<Framework | undefined>;
-            } | undefined>;
-            actions: import('.').ExperienceAction[];
-            merge: import('effector').EventCallable<{
-                experience: Partial<Experience>;
-                strategy: "override";
-            }>;
-        } | undefined>;
-        getByKey: (key: Experience["key"]) => import('effector').Store<import('.').ExperienceStore | undefined>;
-        launch: import('effector').Effect<{
+        register: EventCallable<Experience>;
+        get: (id: Experience["id"]) => Store<import('.').ExperienceStore | undefined>;
+        getById: (id: Experience["id"]) => Store<import('.').ExperienceStore | undefined>;
+        getByKey: (key: Experience["key"]) => Store<import('.').ExperienceStore | undefined>;
+        launch: Effect<{
             key: string;
             options?: LaunchExperienceOptions;
         } | {
             id: string;
             options?: LaunchExperienceOptions;
         }, void, Error>;
-        open: import('effector').Effect<{
+        open: Effect<{
             key: string;
             options?: import('./exports').OpenExperienceOptions;
         } | {
             id: string;
             options?: import('./exports').OpenExperienceOptions;
         }, void, Error>;
-        listStore: import('effector').Store<{
-            id: string;
-            key: string;
-            name: string;
-            configStore: import('effector').Store<{
-                name: string;
-                decisionLogic: import('./logic-engine').LogicValue | LogicRule;
-                targetSelectors: import('.').ExperienceTarget[];
-                initializeOpenLogic: import('./logic-engine').LogicValue | LogicRule;
-            }>;
-            treeStore: import('effector').Store<{
-                steps: ExperienceStep[];
-                nodes: import('.').ExperienceNode[];
-                edges: import('.').ExperienceEdge[];
-                conditions: Condition[];
-            }>;
-            componentStore: import('effector').Store<{
-                name: string;
-                component: AdaptedComponent<string, unknown>;
-                frameworkStore: import('effector').Store<Framework | undefined>;
-            } | undefined>;
-            actions: import('.').ExperienceAction[];
-            merge: import('effector').EventCallable<{
-                experience: Partial<Experience>;
-                strategy: "override";
-            }>;
-        }[]>;
+        listStore: Store<import('.').ExperienceStore[]>;
+        initialiseExperiencesFx: Effect<void, void, Error>;
     };
     readonly frameworks: {
-        register: (name: string, framework: Framework) => void;
-        getByName: (name: string) => import('effector').Store<Framework | undefined>;
-        listStore: import('effector').Store<Framework[]>;
+        register: EventCallable<{
+            name: string;
+            framework: Framework;
+        }>;
+        getByName: (name: string) => Store<Framework | undefined>;
+        listStore: Store<Framework[]>;
     };
     readonly predicates: {
-        register: (name: string, predicate: Predicate) => void;
-        getByName: (name: string) => import('effector').Store<Predicate | undefined>;
-        listStore: import('effector').Store<{
+        register: EventCallable<{
+            name: string;
+            predicate: Predicate;
+        }>;
+        getByName: (name: string) => Store<Predicate | undefined>;
+        listStore: Store<{
             name: string;
             predicate: Predicate;
         }[]>;
-        getEvokablePredicate: (predicateName: string) => import('effector').Store<() => ReturnType<Predicate>>;
+        getEvokablePredicate: (predicateName: string) => Store<() => ReturnType<Predicate>>;
     };
     readonly features: {
-        register: (id: string, feature: Feature) => void;
-        getById: (id: string) => import('effector').Store<import('.').FeatureBucket | undefined>;
-        getByName: (name: string) => import('effector').Store<import('.').FeatureIndexItem | undefined>;
-        listStore: import('effector').Store<import('.').FeatureBucket[]>;
-        getEvokableFeature: (featureName: string) => import('effector').Store<() => Promise<boolean | string | undefined>>;
+        register: EventCallable<{
+            id: string;
+            feature: Feature;
+        }>;
+        getById: (id: string) => Store<import('.').FeatureBucket | undefined>;
+        getByName: (name: string) => Store<import('.').FeatureIndexItem | undefined>;
+        listStore: Store<import('.').FeatureBucket[]>;
+        getEvokableFeature: (featureName: string) => Store<() => Promise<boolean | string | undefined>>;
     };
     readonly conditions: {
         register: (condition: Condition) => void;
-        getById: (id: Condition["id"]) => import('effector').Store<Condition | null>;
-        getByKey: (key: Condition["key"]) => import('effector').Store<Condition | null>;
-        listStore: import('effector').Store<Condition[]>;
-        indexStore: import('effector').StoreWritable<{
+        getById: (id: Condition["id"]) => Store<Condition | null>;
+        getByKey: (key: Condition["key"]) => Store<Condition | null>;
+        listStore: Store<Condition[]>;
+        indexStore: StoreWritable<{
             [id: string]: Condition;
         }>;
     };
     readonly fields: {
         register: (field: Field) => void;
         update: (key: import('.').FieldBase["key"], updates: Partial<Field>) => void;
-        getById: (id: import('.').FieldBase["id"]) => import('effector').Store<Field | null>;
-        getByKey: (key: import('.').FieldBase["key"]) => import('effector').Store<Field | null>;
-        listStore: import('effector').Store<Field[]>;
-        getByName: (name: import('.').FieldBase["name"]) => import('effector').Store<Field | null>;
+        getById: (id: import('.').FieldBase["id"]) => Store<Field | null>;
+        getByKey: (key: import('.').FieldBase["key"]) => Store<Field | null>;
+        listStore: Store<Field[]>;
+        getByName: (name: import('.').FieldBase["name"]) => Store<Field | null>;
     };
     readonly responses: {
         register: {
             (fieldKey: Field["key"], response: import('.').Response): void;
             (payload: Record<Field["key"], import('.').Response>, response?: never): void;
         };
-        clearAll: import('effector').EventCallable<void>;
-        clear: import('effector').EventCallable<string>;
+        clearAll: EventCallable<void>;
+        clear: EventCallable<string>;
         commit: (responsesToCommit: import('.').CommitResponses) => Promise<{
             errors: import('.').ValidationError[];
         }>;
@@ -217,36 +178,71 @@ export declare class Picked {
             responsesToCommit: import('.').CommitResponses;
             validationErrors: import('.').ValidationError[];
         }>;
-        listStore: import('effector').Store<{
+        listStore: Store<{
             fieldKey: string;
             value: import('.').FieldValue;
         }[]>;
-        getAllStore: import('effector').Store<{
+        getAllStore: Store<{
             [fieldKey: string]: import('.').FieldValue;
         }>;
-        getByFieldId: (id: Field["id"]) => import('effector').Store<import('.').FieldValue>;
-        getByFieldKey: (key: Field["key"]) => import('effector').Store<import('.').FieldValue>;
-        getByFieldName: (fieldName: Field["name"]) => import('effector').Store<import('.').FieldValue>;
+        getByFieldId: (id: Field["id"]) => Store<import('.').FieldValue>;
+        getByFieldKey: (key: Field["key"]) => Store<import('.').FieldValue>;
+        getByFieldName: (fieldName: Field["name"]) => Store<import('.').FieldValue>;
     };
     readonly steps: {
         register: (step: ExperienceStep) => void;
-        getById: (id: ExperienceStep["id"]) => import('effector').Store<ExperienceStep | null>;
-        getByKey: (key: ExperienceStep["key"]) => import('effector').Store<ExperienceStep | null>;
-        listStore: import('effector').Store<ExperienceStep[]>;
-        indexStore: import('effector').StoreWritable<{
+        getById: (id: ExperienceStep["id"]) => Store<ExperienceStep | null>;
+        getByKey: (key: ExperienceStep["key"]) => Store<ExperienceStep | null>;
+        listStore: Store<ExperienceStep[]>;
+        indexStore: StoreWritable<{
             [id: string]: ExperienceStep;
         }>;
     };
+    readonly contents: {
+        register: (content: Content) => void;
+        getById: (id: Content["id"]) => Store<Content | null>;
+        listStore: Store<Content[]>;
+        indexStore: StoreWritable<{
+            [id: string]: Content;
+        }>;
+    };
     readonly actions: {
-        register: (key: string, action: Action) => void;
-        getByKey: (key: string) => import('effector').Store<Action | undefined>;
-        listStore: import('effector').Store<import('.').ActionIndexItem[]>;
+        register: EventCallable<{
+            key: string;
+            action: Action;
+        }>;
+        getByKey: (key: string) => Store<Action | undefined>;
+        listStore: Store<import('.').ActionIndexItem[]>;
         getEvokableAction: (actionKey: string, options?: {
             experience: import('.').ExperienceInstance;
-        }) => import('effector').Store<() => ReturnType<Action>>;
+        }) => Store<() => ReturnType<Action>>;
     };
+    readonly stateSnapshotStore: Store<StateSnapshot>;
+    readonly evaluateRuleLogicFx: Effect<EvaluateRuleLogicParams, unknown, Error>;
+    /** Public trigger — fires the start chain. `await allSettled(client.start, { scope })` resolves once the chain has fully settled. */
+    readonly start: EventCallable<void>;
+    /** Reactive store of the readiness flag. */
+    readonly readyStore: StoreWritable<boolean>;
+    /** Reactive store of the precondition-gate result (`undefined` until `start` is fired). */
+    readonly preconditionPassedStore: StoreWritable<boolean | undefined>;
+    /** Reactive store of the condition-gate result (`undefined` until `start` is fired). */
+    readonly conditionPassedStore: StoreWritable<boolean | undefined>;
+    /** Reactive store of the current lifecycle stage. */
+    readonly lifecycleStageStore: StoreWritable<LifecycleStage>;
+    private readonly lifecycle;
+    /**
+     * Effect that interpolates a template string against the latest responses plus a caller-supplied context. Source is `responses.listStore` so renders are scope-aware and pick up the latest committed responses without `.getState()`.
+     *
+     * @example
+     * ```typescript
+     * const greeting = await client.renderStringFx({ template: 'Hi {{name}}', context: { name: 'Mae' } })
+     * ```
+     */
+    readonly renderStringFx: Effect<{
+        template: string;
+        context?: Record<string, unknown>;
+    }, string, Error>;
     constructor(options: CreateClientOptions);
-    start: () => void;
     registerFramework: (framework: Framework) => void;
     registerComponent: (name: string, component: AdaptedComponent) => void;
     registerPlugin: (plugin: Plugin) => void;
@@ -255,9 +251,9 @@ export declare class Picked {
     registerCondition: (condition: Condition) => void;
     registerField: (field: Field) => void;
     registerStep: (step: ExperienceStep) => void;
+    registerContent: (content: Content) => void;
     registerAction: (key: string, action: Action) => void;
     registerExperience: (experience: Experience) => void;
-    getStateSnapshot: () => StateSnapshot;
     /**
      * Launches an experience by ID.
      *
@@ -300,53 +296,11 @@ export declare class Picked {
      * ```
      */
     openExperienceByKey: (experienceKey: string) => Promise<void>;
-    private runPluginStartHooks;
-    private evaluateGate;
     private setupPlugins;
     private setupFeatures;
     private setupPredicates;
     private setupActions;
     private setupComponents;
     getPluginConfig: (pluginName: string) => PluginConfigIndex[string] | Record<string, unknown>;
-    /**
-     * Interpolates a template string using values from the client's response store and/or a provided context.
-     * Supports dot-notation, modifiers, and executing functions found in the context.
-     *
-     * Sources:
-     * - responses.*: Loaded automatically from the client's internal response store by fieldId (e.g. {{ responses.email }}).
-     * - Context: Any non-responses.* key must be supplied in the context; nested dot-notation is supported.
-     * - Functions: If a context value is a function, it is invoked and its result is rendered.
-     *
-     * Placeholders:
-     * - {{ key | modifier: arg | modifier2: arg2 }} with modifiers applied left-to-right.
-     *
-     * Modifiers:
-     * - default: Use the argument when the value is null, undefined, NaN, or empty string; otherwise return the value as a string.
-     * - append: Append the argument (space-separated) when the value is non-empty.
-     * - prepend: Prepend the argument (space-separated) when the value is non-empty.
-     * - upper: Uppercase string values.
-     * - lower: Lowercase string values.
-     * - capitalize: Capitalize the first letter of string values.
-     * - list: Format Arrays, Maps, and Sets via Intl.ListFormat (Maps render as key: value pairs).
-     *
-     * Behavior:
-     * - Empty values (null, undefined, empty string, NaN) render as empty. Numeric 0 renders as "0", boolean false renders as "false", and boolean true renders as "true".
-     * - Objects and arrays are JSON-stringified; Maps/Sets serialize to {} unless the list modifier is used.
-     * - Unknown modifiers are ignored.
-     *
-     * @param template Template containing placeholders.
-     * @param context Optional data for interpolation. Non-responses.* keys belong here; function values are executed.
-     * @returns Interpolated string.
-     * @example
-     * renderString("Hello {{ name | default: 'Guest' | capitalize }}! Email: {{ responses.email | lower }}.", { name: "ALICE" })
-     * // => "Hello Alice! Email: alice@example.com."
-     * @example
-     * renderString("User: {{ getName | capitalize }}", { getName: () => "alice" })
-     * // => "User: Alice"
-     * @example
-     * renderString("Fruits: {{ fruits | list }}", { fruits: ["apple", "banana", "cherry"] })
-     * // => "Fruits: apple, banana, and cherry"
-     */
-    renderString: (template: string, context?: Record<string, unknown>) => string;
 }
 //# sourceMappingURL=picked.d.ts.map

package/dist/types/picked.d.ts.map

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

package/dist/types/plugins/dom-observer/index.d.ts

@@ -0,0 +1,3 @@
+/** @file Public entrypoint for the dom-observer plugin. */
+export { domObserverPlugin } from './plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/plugins/dom-observer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dom-observer/index.ts"],"names":[],"mappings":"AAAA,2DAA2D;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA"}

package/dist/types/plugins/dom-observer/plugin.d.ts

@@ -0,0 +1,50 @@
+import { Plugin } from '../../entities/plugin/plugin';
+/**
+ * Watches the document for `childList` mutations and reconciles experiences
+ * whose declared target selectors match newly added DOM subtrees. Each
+ * matching experience runs through its per-experience `shouldInitialiseFx`,
+ * and on `true` is handed to its `initialiseFx(undefined)`.
+ *
+ * Scope: lazy-mounted target hosts that arrive after the initial bulk init
+ * in `picked.ts`. Route-driven re-initialisation (decisionLogic depending
+ * on `location.pathname`, lifecycle event re-fires, plugin start hooks)
+ * is the responsibility of `singlePageAppPlugin`, which calls
+ * `client.start()` on history events. Pair the two plugins to cover both.
+ *
+ * Pipeline:
+ *  - Each experience's `configStore.watch()` pushes its trimmed selectors
+ *    into a reactive `Store<Map<id, string[]>>`. Empty / whitespace-only
+ *    selectors are filtered out.
+ *  - A single `MutationObserver` collects `Element` instances from
+ *    `childList.addedNodes` across one animation frame, then fires a
+ *    single `mutationObserved` event carrying the collected elements.
+ *  - `sample` filters registered experiences to those whose selectors
+ *    match at least one added element via `el.matches` or
+ *    `el.querySelector`. Malformed selectors are skipped per-experience
+ *    without poisoning the rest of the batch. The matched array is
+ *    routed straight into `reconcileMatchedFx` via `sample.target`.
+ *  - `reconcileMatchedFx` invokes each experience's
+ *    `shouldInitialiseFx`, and on `true` its `initialiseFx(undefined)`.
+ *    `initialiseFx` is idempotent: tagged target elements are skipped
+ *    on subsequent passes.
+ *
+ * Setup is deferred until `document.body` is parsed, so SDKs loaded from
+ * `<head>` without `defer` (the standard Shopify-theme / GTM-template
+ * pattern) still install once the body becomes available.
+ *
+ * No-ops outside browser environments and on partial-DOM runtimes that
+ * lack `MutationObserver` or `requestAnimationFrame`. `MutationObserver`
+ * does not cross shadow root or iframe boundaries, so experiences whose
+ * target lives inside a shadow tree or a cross-origin frame are not
+ * reconciled by this plugin.
+ *
+ * @returns {Plugin} The plugin.
+ * @example
+ * ```typescript
+ * createClient({
+ *   plugins: [domObserverPlugin()]
+ * })
+ * ```
+ */
+export declare const domObserverPlugin: () => Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugins/dom-observer/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dom-observer/plugin.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAK1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,iBAAiB,QAAO,MAiBpC,CAAA"}

package/dist/types/plugins/dynamic-experiences/index.d.ts

@@ -1,4 +1,5 @@
-export { dynamicExperiencesPlugin, fetchProject } from './plugin';
+/** @file Public exports for the dynamic-experiences plugin (project config + per-experience content resolution). */
+export { dynamicExperiencesPlugin, fetchExperienceContent, fetchProject } from './plugin';
 export { createClientHeaders } from '../../utils/client-headers';
 export type * from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/types/plugins/dynamic-experiences/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,mBAAmB,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/index.ts"],"names":[],"mappings":"AAAA,oHAAoH;AACpH,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AACzF,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAChE,mBAAmB,SAAS,CAAA"}

package/dist/types/plugins/dynamic-experiences/plugin.d.ts

@@ -1,5 +1,5 @@
 import { Plugin } from '../../entities/plugin/plugin';
-import { DynamicExperiencesPluginOptions, FetchProjectOptions, ProjectConfig } from './types';
+import { DynamicExperiencesPluginOptions, ExperienceContentResponse, FetchProjectOptions, ProjectConfig } from './types';
 /**
  * Fetches the project configuration from the Picked REST API.
  *
@@ -16,6 +16,23 @@ import { DynamicExperiencesPluginOptions, FetchProjectOptions, ProjectConfig } f
  * ```
  */
 export declare function fetchProject(apiUrl: string, projectId: string, options?: FetchProjectOptions): Promise<ProjectConfig | null>;
+/**
+ * Fetches per-experience content from the Picked API.
+ *
+ * Returns `null` on network failure, non-OK responses, or invalid JSON shape — preserving
+ * the failure-tolerant policy: experiences still render, layouts handle null defensively.
+ *
+ * @param {string} apiUrl - Base URL for the Picked API.
+ * @param {string} projectId - Project ID to fetch content for.
+ * @param {string} experienceId - Experience ID whose content to fetch.
+ * @param {FetchProjectOptions} [options] - Optional headers and preview token.
+ * @returns {Promise<ExperienceContentResponse | null>} Validated content response, or `null` on any failure.
+ * @example
+ * ```typescript
+ * const content = await fetchExperienceContent('https://api.picked.app', 'proj_1', 'exp_1')
+ * ```
+ */
+export declare function fetchExperienceContent(apiUrl: string, projectId: string, experienceId: string, options?: FetchProjectOptions): Promise<ExperienceContentResponse | null>;
 /**
  * Plugin that fetches project configuration from the Picked REST API and registers
  * features, steps, fields, and experiences with the client.

package/dist/types/plugins/dynamic-experiences/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/plugin.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAK1D,OAAO,KAAK,EACV,+BAA+B,EAC/B,mBAAmB,EACnB,aAAa,EAGd,MAAM,SAAS,CAAA;AA4VhB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAmC/B;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,+BAA+B,GAAG,MAAM,CAgD1F"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/plugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAK1D,OAAO,KAAK,EAEV,+BAA+B,EAC/B,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EAId,MAAM,SAAS,CAAA;AAsThB;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAmC/B;AAoBD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,mBAAmB,GAC5B,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAsC3C;AAkPD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,+BAA+B,GAAG,MAAM,CAoC1F"}