@picked/client 0.0.1-dev.1786072899095 → 0.0.1-dev.1786601464574

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

@@ -1,129 +1,13 @@
 /**
- * @file Types for the dynamic-experiences plugin: project config shapes returned by the Picked API.
- */
-import type { ExperienceStep } from '../../entities/step/step';
-import type { Field } from '../../entities/field/field';
-import type { ExperienceEdge, ExperienceNode, ExperienceTarget } from '../../entities/experience/experience';
-import type { Condition } from '../../entities/condition/condition';
-import type { LogicRule, LogicValue } from '../../logic-engine';
-/**
- * Wire-format step as returned by the Picked API. Matches {@link ExperienceStep}
- * except that fields are still referenced by ID — the plugin resolves them to
- * keys against `ProjectConfig.fields` at registration time.
- *
- * `fieldIds` is optional: layout-only steps (driven purely by `layoutName`) omit it.
- *
- * `layoutContentId` is the wire-format reference to a CMS Content record. The actual
- * content blob is delivered by `dynamicExperiencesPlugin`'s content resolution chain
- * (virtual data module, preview-token API fetch, or direct API fetch) and registered
- * via `client.registerContent`. Steps' derived `layoutContentStore` resolves reactively
- * against the registry at render time.
- */
-export type ApiExperienceStep = Omit<ExperienceStep, 'fieldKeys' | 'layoutContentStore'> & {
-    fieldIds?: string[];
-};
-export interface ProjectConfigFeature {
-    id: string;
-    name: string;
-    enabled: boolean;
-    weight: number;
-    version: number;
-}
-export type ProjectConfigNode = ExperienceNode;
-/**
- * An experience payload as returned by the API.
- * Steps are referenced by ID only; the full step definitions live in the
- * top-level `steps` array of ProjectConfig.
- * Conditions are referenced by nodes via `conditionId`; the full condition
- * definitions live in the top-level `conditions` array of ProjectConfig.
- */
-export interface ProjectConfigExperience {
-    id: string;
-    key: string;
-    name: string;
-    componentName: string;
-    nodes: ProjectConfigNode[];
-    edges: ExperienceEdge[];
-    /** Decision logic that controls whether this experience is initialised. */
-    condition: LogicRule | LogicValue;
-    /** Logic that controls the initial open state of the experience. */
-    initializeOpen: LogicRule | LogicValue;
-    /** DOM targets this experience mounts into. */
-    targets: ExperienceTarget[];
-}
-export interface ProjectConfig {
-    id: string;
-    name: string;
-    status: string;
-    versionId: string;
-    workspaceId: string;
-    features: ProjectConfigFeature[];
-    /** Experience definitions with steps and conditions referenced by ID. */
-    experiences: ProjectConfigExperience[];
-    /** Global step definitions shared across experiences. */
-    steps: ApiExperienceStep[];
-    /** Global field definitions shared across steps. */
-    fields: Field[];
-    /** Global condition definitions referenced by experience flow nodes. */
-    conditions: Condition[];
-    actions: Array<{
-        id: string;
-        name: string;
-        key: string;
-    }>;
-    /**
-     * Origins permitted to push live-preview content patches into this page, issued by the API on the
-     * preview surface only. The preview receiver validates every inbound message against this list;
-     * absent or empty means no embedder is trusted and the channel stays closed.
-     */
-    previewEmbedderOrigins?: string[];
-}
-export interface DynamicExperiencesPluginOptions {
-    apiUrl?: string;
-    projectConfig?: ProjectConfig;
-    /**
-     * Customer-supplied content fetcher. When provided, supersedes both the virtual
-     * data module and the runtime API for per-experience content resolution.
-     * Customers using this override are responsible for project ↔ content version
-     * consistency. Receives the resolved experience and the current preview token
-     * (when present) so the customer can decide preview semantics themselves.
-     */
-    getContent?: (experience: {
-        id: string;
-        key: string;
-    }, options?: {
-        previewToken?: string;
-    }) => Promise<ExperienceContentResponse | null>;
-}
-export interface FetchProjectOptions {
-    previewToken?: string;
-    headers?: Record<string, string>;
-    /** Abort signal applied to the underlying `fetch` (for example an `AbortSignal.timeout` deadline). */
-    signal?: AbortSignal;
-}
-/**
- * Wire-format content blob as returned by the Picked API content endpoint.
- */
-export interface ContentBlob {
-    id: string;
-    /** The `key` of the Content Model that produced this entry, or `null` when unresolved. */
-    contentModelKey: string | null;
-    data: Record<string, unknown>;
-}
-/**
- * Wire-format response shape for `GET /api/v1/projects/:projectId/experiences/:experienceId/content`.
- * The response is agnostic of step structure — step ↔ content mapping is encoded in the
- * project blob via `Step.layoutContentId`.
+ * @file Plugin-specific types for the dynamic-experiences plugin.
  *
- * `versionId` is the published workspace version id on the published surface and
- * `null` on the preview surface, where there is no published version (mirroring
- * how the preview project-config payload surfaces `versionId: null`).
+ * The wire-format shapes the Delivery API returns live in `@picked/delivery-api-client`,
+ * which stays runtime-agnostic. This file re-exports them under the names the SDK uses and
+ * adds the types that only mean something inside the client: the content loader and the
+ * virtual data module `@picked/vite-plugin-picked` generates.
  */
-export interface ExperienceContentResponse {
-    experienceId: string;
-    versionId: string | null;
-    content: ContentBlob[];
-}
+import type { ExperienceContentResponse, ProjectConfig } from '@picked/delivery-api-client';
+export type { ApiExperienceStep, ContentBlob, ExperienceContentResponse, FetchProjectOptions, ProjectConfig, ProjectConfigExperience, ProjectConfigFeature, ProjectConfigNode, } from '@picked/delivery-api-client';
 /**
  * Function that resolves an experience's content blobs. Set on the Picked client by
  * `dynamicExperiencesPlugin` (selecting from virtual module, getContent override, or API)
@@ -136,6 +20,20 @@ export type ContentLoader = (experience: {
 }, options?: {
     previewToken?: string;
 }) => Promise<ExperienceContentResponse | null>;
+/**
+ * Provenance the virtual data module records about the snapshot it carries: which build
+ * flavour produced it, when, and which workspace version it was taken from.
+ */
+export interface PickedManifestMetadata {
+    /** `'build'` when build-mode prefetch JSON was used, `'dev'` when the dev-mode fetch was. */
+    mode: 'dev' | 'build';
+    /** ISO 8601 timestamp from the manifest. `null` in dev mode, where no manifest is written. */
+    fetchedAt: string | null;
+    /** The `versionId` the snapshot was taken from, when known. */
+    projectVersionId: string | null;
+    /** The `workspaceId` the snapshot was taken from, when known. */
+    workspaceId: string | null;
+}
 /**
  * Optional-fields surface of the virtual data module exposed by `@picked/vite-plugin-picked`.
  * The shape is identical between dev (`vite serve`) and build (`vite build`) modes.
@@ -143,11 +41,6 @@ export type ContentLoader = (experience: {
 export interface VirtualPickedData {
     projectConfig: ProjectConfig;
     experienceContent: ContentLoader;
-    manifestMetadata: {
-        mode: 'dev' | 'build';
-        fetchedAt: string | null;
-        projectVersionId: string | null;
-        workspaceId: string | null;
-    };
+    manifestMetadata: PickedManifestMetadata;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,yBAAyB,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAE3F,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,6BAA6B,CAAA;AAEpC;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG,CAC1B,UAAU,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACvC,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,KAChC,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;AAE9C;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,6FAA6F;IAC7F,IAAI,EAAE,KAAK,GAAG,OAAO,CAAA;IACrB,8FAA8F;IAC9F,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,+DAA+D;IAC/D,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,iEAAiE;IACjE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,aAAa,CAAA;IAC5B,iBAAiB,EAAE,aAAa,CAAA;IAChC,gBAAgB,EAAE,sBAAsB,CAAA;CACzC"}

package/dist/types/schema-registry.d.ts

@@ -0,0 +1,190 @@
+/** @file Schema registry types augmented by generated `picked-env.d.ts`. */
+import type { Content } from './entities/content/content';
+import type { FieldValue as ResponseFieldValue } from './entities/field/field';
+/**
+ * Augmented by generated `picked-env.d.ts`. Empty by default.
+ *
+ * @example
+ * // After codegen:
+ * // interface PickedSchemaRegistry {
+ * //   contentModels: { 'welcome-page': WelcomePageContent }
+ * // }
+ */
+export interface PickedSchemaRegistry {
+}
+type ContentModelsMap = PickedSchemaRegistry extends {
+    contentModels: infer M extends Record<string, unknown>;
+} ? M : Record<string, Record<string, unknown>>;
+type StepContentModelsMap = PickedSchemaRegistry extends {
+    stepContentModels: infer S extends Record<string, string>;
+} ? S : Record<string, string>;
+type StepFieldKeysMap = PickedSchemaRegistry extends {
+    stepFieldKeys: infer S extends Record<string, string>;
+} ? S : Record<string, string>;
+type FieldValuesMap = PickedSchemaRegistry extends {
+    fieldValues: infer F extends Record<string, unknown>;
+} ? F : never;
+/**
+ * Widens a key union so it still accepts a key the workspace does not declare.
+ *
+ * Features, actions, fields, steps and experiences can all be defined in the application
+ * rather than the workspace — `createClient({ features })` and `client.registerField()`
+ * among them — and those keys are absent from the generated schema. Intersecting with an
+ * object type keeps TypeScript from collapsing `K | string` down to `string`, so an editor
+ * still suggests the workspace's keys while any other string is accepted.
+ *
+ * The `Known*` union beside each key type stays closed, for a caller that wants only what
+ * the workspace declares.
+ */
+type AnyString = string & Record<never, never>;
+/**
+ * Feature keys the workspace declares. Closed: a locally-defined feature is not in it.
+ *
+ * @example
+ * type Keys = KnownFeatureKeys
+ */
+export type KnownFeatureKeys = PickedSchemaRegistry extends {
+    featureKeys: infer K extends string;
+} ? K : string;
+/**
+ * Feature keys — the workspace union when augmented, plus any locally-defined key.
+ *
+ * @example
+ * type Keys = FeatureKeys
+ */
+export type FeatureKeys = PickedSchemaRegistry extends {
+    featureKeys: infer K extends string;
+} ? K | AnyString : string;
+/**
+ * Step keys the workspace declares. Closed: a locally-registered step is not in it.
+ *
+ * @example
+ * type Keys = KnownStepKeys
+ */
+export type KnownStepKeys = PickedSchemaRegistry extends {
+    stepKeys: infer K extends string;
+} ? K : string;
+/**
+ * Step keys — the workspace union when augmented, plus any locally-registered key.
+ *
+ * @example
+ * type Keys = StepKeys
+ */
+export type StepKeys = PickedSchemaRegistry extends {
+    stepKeys: infer K extends string;
+} ? K | AnyString : string;
+/**
+ * Action keys the workspace declares. Closed: an action the app registers on its own is
+ * not in it.
+ *
+ * @example
+ * type Keys = KnownActionKeys
+ */
+export type KnownActionKeys = PickedSchemaRegistry extends {
+    actionKeys: infer K extends string;
+} ? K : string;
+/**
+ * Action keys — the workspace union when augmented, plus any key the app registers.
+ *
+ * @example
+ * type Keys = ActionKeys
+ */
+export type ActionKeys = PickedSchemaRegistry extends {
+    actionKeys: infer K extends string;
+} ? K | AnyString : string;
+/**
+ * Experience keys the workspace declares. Closed: a locally-registered experience is not
+ * in it.
+ *
+ * @example
+ * type Keys = KnownExperienceKeys
+ */
+export type KnownExperienceKeys = PickedSchemaRegistry extends {
+    experienceKeys: infer K extends string;
+} ? K : string;
+/**
+ * Experience keys — the workspace union when augmented, plus any locally-registered key.
+ *
+ * @example
+ * type Keys = ExperienceKeys
+ */
+export type ExperienceKeys = PickedSchemaRegistry extends {
+    experienceKeys: infer K extends string;
+} ? K | AnyString : string;
+/**
+ * Field keys the workspace declares. Closed: a locally-registered field is not in it.
+ *
+ * @example
+ * type Keys = KnownFieldKeys
+ */
+export type KnownFieldKeys = FieldValuesMap extends never ? string : keyof FieldValuesMap & string;
+/**
+ * Field keys — the workspace union when augmented, plus any locally-registered key.
+ *
+ * A key outside the workspace reads as the general {@link FieldValueFor} value type, which
+ * is how every value resolver here already treats one.
+ *
+ * @example
+ * type Keys = FieldKeys
+ */
+export type FieldKeys = FieldValuesMap extends never ? string : KnownFieldKeys | AnyString;
+/**
+ * Union of every content model bound to a step layout.
+ *
+ * @example
+ * type Union = StepLayoutContent
+ */
+export type StepLayoutContent = ContentModelsMap[StepContentModelsMap[keyof StepContentModelsMap] & keyof ContentModelsMap];
+/**
+ * Content type for a specific step key, via the step -> model map.
+ *
+ * @param {PropertyKey} K - Step key from the workspace schema.
+ * @example
+ * type Main = ContentForStep<'main'>
+ */
+export type ContentForStep<K extends PropertyKey> = K extends keyof StepContentModelsMap ? ContentModelsMap[StepContentModelsMap[K] & keyof ContentModelsMap] : StepLayoutContent;
+/**
+ * Field keys bound to a specific step key, via the step → field-keys map.
+ * Falls back to all workspace {@link FieldKeys} when the registry has no
+ * `stepFieldKeys` entry for `K` (old snapshots / unaugmented clients).
+ *
+ * @param {PropertyKey} K - Step key from the workspace schema.
+ * @example
+ * type MainFields = FieldKeysForStep<'main'>
+ */
+export type FieldKeysForStep<K extends PropertyKey> = K extends keyof StepFieldKeysMap ? StepFieldKeysMap[K] & KnownFieldKeys : FieldKeys;
+/**
+ * Value type for a field key (always optional at read time).
+ *
+ * @param {PropertyKey} K - Field key from the workspace schema.
+ * @example
+ * type Email = FieldValueFor<'email'>
+ */
+export type FieldValueFor<K extends PropertyKey> = FieldValuesMap extends never ? ResponseFieldValue : K extends keyof FieldValuesMap ? FieldValuesMap[K] | null : ResponseFieldValue;
+/**
+ * A `Content` record whose `data` is narrowed to `TData`.
+ *
+ * @param {unknown} TData - Explicit content model shape.
+ * @example
+ * type Typed = TypedContent<WelcomePageContent>
+ */
+export type TypedContent<TData> = Omit<Content, 'data'> & {
+    data: TData;
+};
+/**
+ * The Content record a `reference` field value points at.
+ *
+ * A generated pointer carries the target's shape on its optional `data` member, so the
+ * referenced record narrows to that shape. A value the generator knows nothing about —
+ * an unaugmented client, or a field that accepts any Content Model — falls back to the
+ * untyped {@link Content}. A repeatable field resolves through its element type.
+ *
+ * @param {unknown} TValue - The raw `reference` field value read from a content blob.
+ * @example
+ * type Author = ReferencedContent<WelcomePageContent['author']>
+ */
+export type ReferencedContent<TValue> = NonNullable<TValue> extends readonly (infer TElement)[] ? ReferencedContent<TElement> : NonNullable<TValue> extends {
+    data?: infer TData;
+} ? [NonNullable<TData>] extends [never] ? Content : TypedContent<NonNullable<TData>> : Content;
+export type { StepContentModelsMap };
+//# sourceMappingURL=schema-registry.d.ts.map

package/dist/types/schema-registry.d.ts.map

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

package/dist/types/server/index.d.ts

@@ -1,12 +1,12 @@
 import type { Picked } from '../picked';
 import type { ExperienceInstance } from '../entities/experience-instance/experience-instance';
 import type { AdaptedComponent } from '../entities/component/component';
-export { serialize, type PickedSnapshot, type SerializeParams, type SerializeAttributes, type SerializeLocation, type SerializeGetContent, } from './serialize';
+export { serialize, type PickedSnapshot, type SerializeParams, type SerializeAttributes, type SerializeLocation, } from './serialize';
 export { createExperienceInstance } from '../entities/experience-instance/experience-instance';
 export type { ExperienceInstance } from '../entities/experience-instance/experience-instance';
 export { registerProjectConfig } from '../plugins/dynamic-experiences/plugin';
 export { hashRule, evaluateConditionMemo, isExperienceActive, ruleReferencesAction, ruleReferencesActionDeep, } from '../lifecycle/condition-selection';
-export type { ContentBlob, ProjectConfig, ProjectConfigExperience, ExperienceContentResponse, } from '../plugins/dynamic-experiences/types';
+export type { ContentBlob, ExperienceContentResponse, ProjectConfig, ProjectConfigExperience, } from '@picked/delivery-api-client';
 export interface Renderer<T = AdaptedComponent<string, unknown>> {
     isValidComponent: (component: AdaptedComponent<string, unknown>) => boolean;
     render: (component: T, client: Picked, experience: ExperienceInstance) => Promise<{

package/dist/types/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAA;AAE7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAEvE,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,qDAAqD,CAAA;AAC9F,YAAY,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAA;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAC7E,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,kCAAkC,CAAA;AACzC,YAAY,EACV,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,sCAAsC,CAAA;AA0B7C,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,gBAAgB,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAA;IAC3E,MAAM,EAAE,CACN,SAAS,EAAE,CAAC,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,kBAAkB,KAC3B,OAAO,CAAC;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACb,CAAC,CAAA;CACH;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoJ/E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/server/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AACvC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAA;AAE7F,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAA;AAEvE,OAAO,EACL,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,GACvB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,wBAAwB,EAAE,MAAM,qDAAqD,CAAA;AAC9F,YAAY,EAAE,kBAAkB,EAAE,MAAM,qDAAqD,CAAA;AAC7F,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAA;AAC7E,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,kBAAkB,EAClB,oBAAoB,EACpB,wBAAwB,GACzB,MAAM,kCAAkC,CAAA;AACzC,YAAY,EACV,WAAW,EACX,yBAAyB,EACzB,aAAa,EACb,uBAAuB,GACxB,MAAM,6BAA6B,CAAA;AA0BpC,MAAM,WAAW,QAAQ,CAAC,CAAC,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC;IAC7D,gBAAgB,EAAE,CAAC,SAAS,EAAE,gBAAgB,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAA;IAC3E,MAAM,EAAE,CACN,SAAS,EAAE,CAAC,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,kBAAkB,KAC3B,OAAO,CAAC;QACX,IAAI,EAAE,MAAM,CAAA;QACZ,IAAI,EAAE,MAAM,CAAA;KACb,CAAC,CAAA;CACH;AAmBD;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoJ/E"}

package/dist/types/server/serialize.d.ts

@@ -1,5 +1,15 @@
+/**
+ * @file Server-side `serialize` helper: synchronously registers a project config, selects the
+ * experiences whose conditions pass for a given URL, fetches content for the selected
+ * experiences that reference CMS layout content, and returns a plain-JSON snapshot for SSR
+ * hydration.
+ *
+ * The snapshot is plain JSON: `projectConfig` travels so the client renders against the exact
+ * config the server selected with (critical for preview), and `conditionResults` carries the
+ * memoized selection so the client's first paint reuses the server's results without re-evaluating.
+ */
+import type { ContentBlob, ProjectConfig } from '@picked/delivery-api-client';
 import type { Picked } from '../picked';
-import type { ContentBlob, ExperienceContentResponse, ProjectConfig } from '../plugins/dynamic-experiences/types';
 /** Subset of `Location` fields that can be injected into the selection context. */
 export interface SerializeLocation {
     href: string;
@@ -16,31 +26,19 @@ export interface SerializeLocation {
 export interface SerializeAttributes {
     location?: Partial<SerializeLocation>;
 }
-/** Customer-supplied content fetcher used in place of the runtime API during serialization. */
-export type SerializeGetContent = (experience: {
-    id: string;
-    key: string;
-}, options?: {
-    previewToken?: string;
-}) => Promise<ExperienceContentResponse | null>;
 /** Parameters for {@link serialize}. */
 export interface SerializeParams {
-    /** The project config to register and select against. */
-    projectConfig: ProjectConfig;
     /** URL attributes injected into the selection context. */
     attributes?: SerializeAttributes;
-    /** Optional content fetcher; falls back to the runtime API when omitted. */
-    getContent?: SerializeGetContent;
     /**
-     * Preview token forwarded to the default API content fetch (and to a custom `getContent`), so
-     * preview (unpublished) content resolves during preview SSR. The server has no `searchParams`,
-     * so the token cannot be recovered otherwise.
+     * Preview token for this request, so preview (unpublished) config and content resolve during
+     * preview SSR. The server has no `searchParams`, so the token cannot be recovered otherwise.
      */
     previewToken?: string;
     /**
-     * Per-content-fetch timeout in milliseconds for the default API path, so a slow or hung upstream
-     * cannot stall the SSR render indefinitely. On timeout the blob is skipped and the render
-     * proceeds (matching the existing null-tolerant path). Defaults to {@link DEFAULT_CONTENT_TIMEOUT_MS}.
+     * Per-content-fetch timeout in milliseconds for the API path, so a slow or hung upstream cannot
+     * stall the SSR render indefinitely. On timeout the blob is skipped and the render proceeds.
+     * Defaults to {@link DEFAULT_CONTENT_TIMEOUT_MS}.
      */
     timeoutMs?: number;
 }
@@ -52,33 +50,38 @@ export interface PickedSnapshot {
     versionId: string | null;
     /** The project config the server selected with (travels for preview parity). */
     projectConfig: ProjectConfig;
-    /** Deduped content blobs for the selected experiences. */
+    /**
+     * Deduped content blobs for the selected experiences — the steps' own layout
+     * content and every entry reached from it through a `reference` field. The
+     * client provider seeds the whole array into the content registry, so both
+     * resolve identically on the server render and the first client paint.
+     */
     content: ContentBlob[];
     /** Memoized condition-evaluation results keyed by rule hash. */
     conditionResults: Record<string, boolean>;
 }
 /**
- * Registers a project config, selects experiences whose conditions pass for the given URL,
- * fetches content for the selected experiences that reference CMS layout content, and returns
- * a plain-JSON snapshot for SSR hydration.
+ * Selects the experiences whose conditions pass for a URL and returns a plain-JSON snapshot for
+ * SSR hydration.
+ *
+ * Config and content both resolve through the client, which keeps them on one source: a bundled
+ * render cannot pair a bundled config with API-fetched content from a newer publish. Content is
+ * deduped by blob id, and each API read carries a deadline so a slow upstream cannot stall the
+ * render.
  *
- * Registration is synchronous (no `client.start()`), so the client's stores are populated
- * before selection. The condition-results store is reset at entry so a client reused across
- * requests never seeds one request's selection with another's; `serialize` still expects a
- * per-request client (concurrent calls on one client are not supported). Each experience's own
- * condition is evaluated through the memoized evaluator against the injected URL; client-level
- * precondition/condition are not evaluated here in v1. Content is fetched via the `getContent`
- * override when provided, otherwise via the runtime API (with `previewToken` forwarded and a
- * per-fetch timeout so a slow upstream cannot stall the render), and deduped by blob id.
+ * Registration is synchronous (no `client.start()`), so the client's stores are populated before
+ * selection. The condition-results store is reset at entry, and `serialize` expects a per-request
+ * client — concurrent calls on one client are not supported. Each experience's own condition is
+ * evaluated through the memoized evaluator against the injected URL; client-level
+ * precondition/condition are not evaluated here in v1.
  *
- * @param {Picked} client - The Picked client to register and select with.
- * @param {SerializeParams} params - Project config, URL attributes, and optional content fetcher.
+ * @param {Picked} client - The Picked client to select with, and to resolve data through.
+ * @param {SerializeParams} [params] - URL attributes, preview token, and content timeout.
  * @returns {Promise<PickedSnapshot>} The plain-JSON snapshot of config, content, and condition results.
  * @example
  * const snapshot = await serialize(client, {
- *   projectConfig,
  *   attributes: { location: { pathname: '/promo' } },
  * })
  */
-export declare function serialize(client: Picked, params: SerializeParams): Promise<PickedSnapshot>;
+export declare function serialize(client: Picked, params?: SerializeParams): Promise<PickedSnapshot>;
 //# sourceMappingURL=serialize.d.ts.map

package/dist/types/server/serialize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/server/serialize.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAOvC,OAAO,KAAK,EACV,WAAW,EACX,yBAAyB,EACzB,aAAa,EAEd,MAAM,sCAAsC,CAAA;AAE7C,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACtC;AAED,+FAA+F;AAC/F,MAAM,MAAM,mBAAmB,GAAG,CAChC,UAAU,EAAE;IACV,EAAE,EAAE,MAAM,CAAA;IACV,GAAG,EAAE,MAAM,CAAA;CACZ,EACD,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,KAChC,OAAO,CAAC,yBAAyB,GAAG,IAAI,CAAC,CAAA;AAK9C,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,yDAAyD;IACzD,aAAa,EAAE,aAAa,CAAA;IAC5B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,mBAAmB,CAAA;IAChC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,mBAAmB,CAAA;IAChC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qFAAqF;IACrF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,gFAAgF;IAChF,aAAa,EAAE,aAAa,CAAA;IAC5B,0DAA0D;IAC1D,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAoCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAgEhG"}
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../../../src/server/serialize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EACV,WAAW,EACX,aAAa,EAEd,MAAM,6BAA6B,CAAA;AAEpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAKvC,mFAAmF;AACnF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;IACd,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;CACb;AAED,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,CAAA;CACtC;AAKD,wCAAwC;AACxC,MAAM,WAAW,eAAe;IAC9B,0DAA0D;IAC1D,UAAU,CAAC,EAAE,mBAAmB,CAAA;IAChC;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,qFAAqF;IACrF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,gFAAgF;IAChF,aAAa,EAAE,aAAa,CAAA;IAC5B;;;;;OAKG;IACH,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,gEAAgE;IAChE,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC1C;AAoCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,SAAS,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,eAAoB,GAC3B,OAAO,CAAC,cAAc,CAAC,CA6EzB"}

package/dist/types/typed-content.d.ts

@@ -0,0 +1,17 @@
+/** @file Bridges untyped content registry stores to codegen-narrowed consumer types. */
+import type { Store } from 'effector';
+import type { Content } from './entities/content/content';
+import type { TypedContent } from './schema-registry';
+/**
+ * Maps an untyped content store to a codegen-narrowed `TypedContent` store. The
+ * `TData` narrowing is compile-time only (no runtime shape check); records whose
+ * `data` is not an object map to `null`.
+ *
+ * @template {Record<string, unknown>} TData
+ * @param {Store<Content | null>} store - Registry store from `client.contents.getById`.
+ * @returns {Store<TypedContent<TData> | null>} Store whose `data` is narrowed to `TData`.
+ * @example
+ * const banner = toTypedContentStore<WelcomePage>(client.contents.getById('lc_banner'))
+ */
+export declare function toTypedContentStore<TData extends Record<string, unknown>>(store: Store<Content | null>): Store<TypedContent<TData> | null>;
+//# sourceMappingURL=typed-content.d.ts.map

package/dist/types/typed-content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-content.d.ts","sourceRoot":"","sources":["../../src/typed-content.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAA;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,4BAA4B,CAAA;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAoBrD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACvE,KAAK,EAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,GAC3B,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAWnC"}

package/dist/types/utils/picked-config.d.ts

@@ -1,10 +1,27 @@
 /** @file Resolves the project id for a Picked client from options, window config, or script tag attributes. */
 import type { CreateClientOptions } from '../client';
+/** Subset of {@link CreateClientOptions} exposed on `window.pickedConfig`. */
+interface WindowPickedConfig {
+    organizationId?: string;
+    projectId?: string;
+    previewToken?: string;
+    apiUrl?: string;
+    dashboardUrl?: string;
+    documentationSiteUrl?: string;
+}
 declare global {
     interface Window {
-        pickedConfig?: Partial<CreateClientOptions>;
+        pickedConfig?: WindowPickedConfig;
     }
 }
+/**
+ * Reads `window.pickedConfig` when running in a browser.
+ *
+ * @template ExtendedPickedConfig - Additional keys consumers attach to the window config.
+ * @returns {Readonly<Partial<CreateClientOptions> & ExtendedPickedConfig> | undefined} The window config, if set.
+ * @example
+ * getPickedConfig<{ theme: string }>()?.theme
+ */
 export declare function getPickedConfig<ExtendedPickedConfig extends Record<string, unknown> | undefined>(): Readonly<Partial<CreateClientOptions> & ExtendedPickedConfig> | undefined;
 /**
  * Resolves the Picked project id from the supplied options, falling back to
@@ -18,4 +35,5 @@ export declare function getPickedConfig<ExtendedPickedConfig extends Record<stri
  * getCreateClientProjectId({ projectId: 'proj-abc' })
  */
 export declare function getCreateClientProjectId(options: CreateClientOptions): string;
+export {};
 //# sourceMappingURL=picked-config.d.ts.map

package/dist/types/utils/picked-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"picked-config.d.ts","sourceRoot":"","sources":["../../../src/utils/picked-config.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAGpD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,YAAY,CAAC,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAA;KAC5C;CACF;AAED,wBAAgB,eAAe,CAC7B,oBAAoB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,+EAUjE;AA4BD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAqB7E"}
+{"version":3,"file":"picked-config.d.ts","sourceRoot":"","sources":["../../../src/utils/picked-config.ts"],"names":[],"mappings":"AAAA,+GAA+G;AAC/G,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AAGpD,8EAA8E;AAC9E,UAAU,kBAAkB;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,YAAY,CAAC,EAAE,kBAAkB,CAAA;KAClC;CACF;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,oBAAoB,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,+EAUjE;AAyCD;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,mBAAmB,GAAG,MAAM,CAqB7E"}

package/dist/version-BLzNWQ-j.cjs

@@ -0,0 +1 @@
+var e=()=>`0.0.1-dev.1786601464574`;Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return e}});

package/dist/version-IAAIvoH9.js

@@ -0,0 +1,4 @@
+//#region src/utils/version.ts
+var e = () => "0.0.1-dev.1786601464574";
+//#endregion
+export { e as t };

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@picked/client",
-  "version": "0.0.1-dev.1786072899095",
+  "version": "0.0.1-dev.1786601464574",
   "dependencies": {
+    "@picked/delivery-api-client": "0.0.1-dev.1786601464574",
     "@withease/factories": "^1.0.5"
   },
   "devDependencies": {
@@ -126,6 +127,7 @@
       "duplicates"
     ],
     "ignoreDependencies": [
+      "@picked/delivery-api-client",
       "@repo/eslint-config",
       "@repo/typescript-config",
       "@testing-library/dom",
@@ -171,8 +173,8 @@
   "size-limit": [
     {
       "path": "dist/esm/index.js",
-      "limit": "16 kB",
-      "name": "index (incl. lazily-loaded preview channel; see AGENTS.md)"
+      "limit": "18 kB",
+      "name": "index (incl. lazily-loaded preview channel and data provider; see AGENTS.md)"
     },
     {
       "path": "dist/esm/server/index.js",