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

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

@@ -1,7 +1,6 @@
 import type { Plugin } from '../../entities/plugin/plugin';
 import type { Picked } from '../../picked';
-import type { ProjectConfig } from './types';
-export { fetchProject, fetchExperienceContent } from '../../data-source/api';
+import type { DynamicExperiencesPluginOptions, ExperienceContentResponse, FetchProjectOptions, ProjectConfig } from './types';
 /**
  * Synchronously registers a complete project config with the client: features, conditions,
  * fields, steps, and experiences, in dependency order.
@@ -25,14 +24,46 @@ export declare function registerProjectConfig(client: Picked, config: ProjectCon
     sessionId: string;
 }): void;
 /**
- * Plugin that resolves project configuration through the client and registers features,
- * steps, fields, and experiences with it.
+ * Fetches the project configuration from the Picked REST API.
  *
- * Resolution runs during the `onStart` hook, before experience initialisation, and reads
- * whichever source the client resolves to — the build-time bundle when one registered itself,
- * the Picked API otherwise. Search param feature overrides take precedence over resolved
- * values.
+ * Returns `null` on network failure, non-OK responses, or invalid JSON shape.
+ * Connection-refused errors from local URLs are suppressed silently.
  *
+ * @param {string} apiUrl - Base URL for the Picked API.
+ * @param {string} projectId - Project ID to fetch config for.
+ * @param {FetchProjectOptions} [options] - Optional headers and preview token.
+ * @returns {Promise<ProjectConfig | null>} Validated project config, or `null` on any failure.
+ * @example
+ * ```typescript
+ * const config = await fetchProject('https://api.picked.app', 'proj_123')
+ * ```
+ */
+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, preview token, and abort signal.
+ * @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.
+ *
+ * Features are fetched during the `onStart` hook, before experience initialisation.
+ * Search param feature overrides take precedence over API-provided values.
+ *
+ * @param {DynamicExperiencesPluginOptions} [options] - Optional plugin configuration.
  * @returns {Plugin} A configured Picked plugin.
  * @example
  * ```typescript
@@ -45,5 +76,5 @@ export declare function registerProjectConfig(client: Picked, config: ProjectCon
  * })
  * ```
  */
-export declare function dynamicExperiencesPlugin(): Plugin;
+export declare function dynamicExperiencesPlugin(options?: DynamicExperiencesPluginOptions): Plugin;
 //# sourceMappingURL=plugin.d.ts.map

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":"AAKA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAG1C,OAAO,KAAK,EAGV,aAAa,EAGd,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAyI5E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACjD,IAAI,CAMN;AAoMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CA4DjD"}
+{"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;AAC1D,OAAO,KAAK,EAAE,MAAM,EAAoB,MAAM,cAAc,CAAA;AAI5D,OAAO,KAAK,EAEV,+BAA+B,EAC/B,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EAId,MAAM,SAAS,CAAA;AA4JhB;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GACjD,IAAI,CAMN;AAyJD;;;;;;;;;;;;;;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;AA4QD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,CAAC,EAAE,+BAA+B,GAAG,MAAM,CAsC1F"}

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

@@ -78,6 +78,23 @@ export interface ProjectConfig {
      */
     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>;
@@ -119,20 +136,6 @@ 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.
@@ -140,6 +143,11 @@ export interface PickedManifestMetadata {
 export interface VirtualPickedData {
     projectConfig: ProjectConfig;
     experienceContent: ContentLoader;
-    manifestMetadata: PickedManifestMetadata;
+    manifestMetadata: {
+        mode: 'dev' | 'build';
+        fetchedAt: string | null;
+        projectVersionId: string | null;
+        workspaceId: string | null;
+    };
 }
 //# 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":"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"}

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

@@ -1,7 +1,7 @@
 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, } from './serialize';
+export { serialize, type PickedSnapshot, type SerializeParams, type SerializeAttributes, type SerializeLocation, type SerializeGetContent, } 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';

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,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,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,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"}

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

@@ -1,5 +1,5 @@
 import type { Picked } from '../picked';
-import type { ContentBlob, ProjectConfig } from '../plugins/dynamic-experiences/types';
+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,19 +16,31 @@ 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 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.
+     * 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.
      */
     previewToken?: string;
     /**
-     * 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}.
+     * 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}.
      */
     timeoutMs?: number;
 }
@@ -68,5 +80,5 @@ export interface PickedSnapshot {
  *   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;AAIvC,OAAO,KAAK,EACV,WAAW,EACX,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;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,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,CAC7B,MAAM,EAAE,MAAM,EACd,MAAM,GAAE,eAAoB,GAC3B,OAAO,CAAC,cAAc,CAAC,CA0EzB"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picked/client",
-  "version": "0.0.1-dev.1786065500148",
+  "version": "0.0.1-dev.1786072899095",
   "dependencies": {
     "@withease/factories": "^1.0.5"
   },

package/dist/plugin-EFn9ALEF.cjs

@@ -1 +0,0 @@
-require("./logger-CSTvAyyB.cjs");let e=require("effector");function t(e){let t=2166136261;for(let n of e)t^=n.codePointAt(0)??0,t=Math.imul(t,16777619);return t>>>0}function n(e){let t=e;return t^=t>>>16,t=Math.imul(t,2246822507),t^=t>>>13,t=Math.imul(t,3266489909),t^=t>>>16,t>>>0}function r(e,r){return n(t(`${e}:${r}`))%100}function i(e,t){return t<=0?!1:t>=100||e<t}function a(e,t){if(Array.isArray(t.conditions))for(let n of t.conditions)e.registerCondition(n)}function o(e,t){e.registerExperience({id:t.id,key:t.key,name:t.name,targets:t.targets,nodes:t.nodes,edges:t.edges,condition:t.condition,initializeOpen:t.initializeOpen,componentName:t.componentName})}function s(e,t){if(Array.isArray(t.fields))for(let n of t.fields)e.registerField(n)}function c(e,t){if(!Array.isArray(t.steps))return;let n=new Map(t.fields.map(e=>[e.id,e.key]));for(let r of t.steps){let t=[];for(let e of r.fieldIds??[]){let i=n.get(e);if(i===void 0){`${r.key}${e}`;continue}t.push(i)}let i=r.layoutContentId?e.contents.getById(r.layoutContentId):null;e.registerStep({id:r.id,key:r.key,name:r.name,fieldKeys:t,layoutName:r.layoutName,...r.layoutContentId!==void 0&&{layoutContentId:r.layoutContentId,layoutContentStore:i}})}}function l(e,t){if(Array.isArray(t.experiences))for(let n of t.experiences)o(e,n)}function u(e,t,n){p(e,t,n.isPreview,n.sessionId),a(e,t),s(e,t),c(e,t),l(e,t)}function d(e){let t=e.searchParams[`preview-token`];if(t&&t.length>0)return t[0]}function f(e){let t=new Set,n=e.searchParams.feature;if(!n)return t;for(let e of n){let n=e.indexOf(`:`);n>0&&t.add(e.substring(0,n))}return t}function p(e,t,n,r){let i=f(e);for(let a of t.features)i.has(a.id)||m(e,a,n,r)}function m(e,t,n,a){let o=r(a,t.id);e.registerFeature(t.id,{key:`v${t.version}`,name:t.name,enabled:t.enabled,weight:t.weight,storage:n?`session`:`local`,decide:()=>i(o,t.weight)})}function h(e,t){for(let n of t.content)e.registerContent({id:n.id,contentModelKey:n.contentModelKey,data:n.data})}function g(e,t){let n=new Map;return(r,i)=>{let a=n.get(r.id);if(a)return a;let o=(async()=>{try{let n=await t(r,i);return n&&h(e,n),n}finally{n.delete(r.id)}})();return n.set(r.id,o),o}}function _(e,t){let n=new Set(t&&Array.isArray(t.experiences)?t.experiences.map(e=>e.id):[]);return(t,r)=>n.has(t.id)?e(t,r):Promise.resolve(null)}function v(){return{name:`dynamic-experiences`,setup:t=>({onStart:(0,e.attach)({source:t.session.store.map(e=>e.id),effect:async e=>{let n=d(t),r=n!==void 0,i=n===void 0?void 0:{previewToken:n},a=await t.getProjectConfig(n===void 0?void 0:{previewToken:n}).catch(e=>null);if(t.contentLoader=g(t,_(e=>t.getExperienceContent(e,i),a)),!a)return;let o=t.seededVersionId;if(o!==null&&o!==a.versionId){t.versionSkew={seeded:o,resolved:a.versionId},`${a.versionId}${o}`;return}t.previewEmbedderOrigins=a.previewEmbedderOrigins??null,u(t,a,{isPreview:r,sessionId:e})}})})}}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return u}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return v}});

package/dist/plugin-YytfMG0n.js

@@ -1,153 +0,0 @@
-import "./logger-DMN6TxJJ.js";
-import { attach as e } from "effector";
-//#region src/plugins/dynamic-experiences/hash.ts
-function t(e) {
-	let t = 2166136261;
-	for (let n of e) t ^= n.codePointAt(0) ?? 0, t = Math.imul(t, 16777619);
-	return t >>> 0;
-}
-function n(e) {
-	let t = e;
-	return t ^= t >>> 16, t = Math.imul(t, 2246822507), t ^= t >>> 13, t = Math.imul(t, 3266489909), t ^= t >>> 16, t >>> 0;
-}
-function r(e, r) {
-	return n(t(`${e}:${r}`)) % 100;
-}
-function i(e, t) {
-	return t <= 0 ? !1 : t >= 100 || e < t;
-}
-//#endregion
-//#region src/plugins/dynamic-experiences/plugin.ts
-function a(e, t) {
-	if (Array.isArray(t.conditions)) for (let n of t.conditions) e.registerCondition(n);
-}
-function o(e, t) {
-	e.registerExperience({
-		id: t.id,
-		key: t.key,
-		name: t.name,
-		targets: t.targets,
-		nodes: t.nodes,
-		edges: t.edges,
-		condition: t.condition,
-		initializeOpen: t.initializeOpen,
-		componentName: t.componentName
-	});
-}
-function s(e, t) {
-	if (Array.isArray(t.fields)) for (let n of t.fields) e.registerField(n);
-}
-function c(e, t) {
-	if (!Array.isArray(t.steps)) return;
-	let n = new Map(t.fields.map((e) => [e.id, e.key]));
-	for (let r of t.steps) {
-		let t = [];
-		for (let e of r.fieldIds ?? []) {
-			let i = n.get(e);
-			if (i === void 0) {
-				`${r.key}${e}`;
-				continue;
-			}
-			t.push(i);
-		}
-		let i = r.layoutContentId ? e.contents.getById(r.layoutContentId) : null;
-		e.registerStep({
-			id: r.id,
-			key: r.key,
-			name: r.name,
-			fieldKeys: t,
-			layoutName: r.layoutName,
-			...r.layoutContentId !== void 0 && {
-				layoutContentId: r.layoutContentId,
-				layoutContentStore: i
-			}
-		});
-	}
-}
-function l(e, t) {
-	if (Array.isArray(t.experiences)) for (let n of t.experiences) o(e, n);
-}
-function u(e, t, n) {
-	p(e, t, n.isPreview, n.sessionId), a(e, t), s(e, t), c(e, t), l(e, t);
-}
-function d(e) {
-	let t = e.searchParams["preview-token"];
-	if (t && t.length > 0) return t[0];
-}
-function f(e) {
-	let t = /* @__PURE__ */ new Set(), n = e.searchParams.feature;
-	if (!n) return t;
-	for (let e of n) {
-		let n = e.indexOf(":");
-		n > 0 && t.add(e.substring(0, n));
-	}
-	return t;
-}
-function p(e, t, n, r) {
-	let i = f(e);
-	for (let a of t.features) i.has(a.id) || m(e, a, n, r);
-}
-function m(e, t, n, a) {
-	let o = r(a, t.id);
-	e.registerFeature(t.id, {
-		key: `v${t.version}`,
-		name: t.name,
-		enabled: t.enabled,
-		weight: t.weight,
-		storage: n ? "session" : "local",
-		decide: () => i(o, t.weight)
-	});
-}
-function h(e, t) {
-	for (let n of t.content) e.registerContent({
-		id: n.id,
-		contentModelKey: n.contentModelKey,
-		data: n.data
-	});
-}
-function g(e, t) {
-	let n = /* @__PURE__ */ new Map();
-	return (r, i) => {
-		let a = n.get(r.id);
-		if (a) return a;
-		let o = (async () => {
-			try {
-				let n = await t(r, i);
-				return n && h(e, n), n;
-			} finally {
-				n.delete(r.id);
-			}
-		})();
-		return n.set(r.id, o), o;
-	};
-}
-function _(e, t) {
-	let n = new Set(t && Array.isArray(t.experiences) ? t.experiences.map((e) => e.id) : []);
-	return (t, r) => n.has(t.id) ? e(t, r) : Promise.resolve(null);
-}
-function v() {
-	return {
-		name: "dynamic-experiences",
-		setup: (t) => ({ onStart: e({
-			source: t.session.store.map((e) => e.id),
-			effect: async (e) => {
-				let n = d(t), r = n !== void 0, i = n === void 0 ? void 0 : { previewToken: n }, a = await t.getProjectConfig(n === void 0 ? void 0 : { previewToken: n }).catch((e) => null);
-				if (t.contentLoader = g(t, _((e) => t.getExperienceContent(e, i), a)), !a) return;
-				let o = t.seededVersionId;
-				if (o !== null && o !== a.versionId) {
-					t.versionSkew = {
-						seeded: o,
-						resolved: a.versionId
-					}, `${a.versionId}${o}`;
-					return;
-				}
-				t.previewEmbedderOrigins = a.previewEmbedderOrigins ?? null, u(t, a, {
-					isPreview: r,
-					sessionId: e
-				});
-			}
-		}) })
-	};
-}
-//#endregion
-export { u as n, v as t };

package/dist/registry-BYtEBdL1.js

@@ -1,111 +0,0 @@
-import "./logger-DMN6TxJJ.js";
-//#region src/utils/client-headers.ts
-var e = "Picked-Client", t = "Picked-Version";
-function n(n, r) {
-	return {
-		[e]: n,
-		[t]: r
-	};
-}
-//#endregion
-//#region src/utils/version.ts
-var r = () => "0.0.1-dev.1786065500148", i = "v1";
-function a(e, t) {
-	return new URL(`/api/${i}/${t}`, e).toString();
-}
-function o(e) {
-	return {
-		...n("sdk", r()),
-		...e
-	};
-}
-async function s(e, t, n, r) {
-	let i = a(e, t);
-	return fetch(i, {
-		headers: o(n),
-		signal: r
-	});
-}
-async function c(e, t, n, r) {
-	let i = a(e, t);
-	return fetch(i, {
-		method: "POST",
-		headers: {
-			"Content-Type": "application/json",
-			...o(r)
-		},
-		body: JSON.stringify(n)
-	});
-}
-function l(e) {
-	return typeof e == "object" && !!e;
-}
-function u(e) {
-	return l(e) && "features" in e && Array.isArray(e.features);
-}
-function d(e) {
-	return !l(e) || !("experienceId" in e) || !("content" in e) ? !1 : Array.isArray(e.content);
-}
-function f(e) {
-	try {
-		let t = new URL(e).hostname;
-		return t === "localhost" || t === "127.0.0.1" || t === "::1";
-	} catch {
-		return !1;
-	}
-}
-function p(e) {
-	if (!l(e) || !("cause" in e)) return !1;
-	let { cause: t } = e;
-	return !l(t) || !("code" in t) ? !1 : t.code === "ECONNREFUSED";
-}
-async function m(e, t, n) {
-	let r = n?.previewToken ? `projects/${t}?preview_token=${encodeURIComponent(n.previewToken)}` : `projects/${t}`, i;
-	try {
-		i = await s(e, r, n?.headers, n?.signal);
-	} catch (t) {
-		return f(e) && p(t), null;
-	}
-	if (!i.ok) return `${i.status.toString()}`, null;
-	let a;
-	try {
-		a = await i.json();
-	} catch {
-		return null;
-	}
-	return u(a) ? a : null;
-}
-async function h(e, t, n, r) {
-	let i = r?.previewToken ? `projects/${t}/experiences/${n}/content?preview_token=${encodeURIComponent(r.previewToken)}` : `projects/${t}/experiences/${n}/content`, a;
-	try {
-		a = await s(e, i, r?.headers, r?.signal);
-	} catch (t) {
-		return f(e) && p(t) || `${n}`, null;
-	}
-	if (!a.ok) return `${n}${a.status.toString()}`, null;
-	let o;
-	try {
-		o = await a.json();
-	} catch {
-		return `${n}`, null;
-	}
-	return d(o) ? o : (`${n}`, null);
-}
-//#endregion
-//#region src/data-source/virtual-data.ts
-function g(e) {
-	if (typeof e != "object" || !e || !("projectConfig" in e) || !("experienceContent" in e) || !("manifestMetadata" in e)) return !1;
-	let { experienceContent: t } = e;
-	return typeof t == "function";
-}
-//#endregion
-//#region src/data-source/registry.ts
-var _ = null;
-function v(e) {
-	g(e) && (_ = e);
-}
-function y() {
-	return _;
-}
-//#endregion
-export { m as a, n as c, h as i, v as n, c as o, g as r, r as s, y as t };

package/dist/registry-DtmKJre-.cjs

@@ -1 +0,0 @@
-require("./logger-CSTvAyyB.cjs");var e=`Picked-Client`,t=`Picked-Version`;function n(n,r){return{[e]:n,[t]:r}}var r=()=>`0.0.1-dev.1786065500148`,i=`v1`;function a(e,t){return new URL(`/api/${i}/${t}`,e).toString()}function o(e){return{...n(`sdk`,r()),...e}}async function s(e,t,n,r){let i=a(e,t);return fetch(i,{headers:o(n),signal:r})}async function c(e,t,n,r){let i=a(e,t);return fetch(i,{method:`POST`,headers:{"Content-Type":`application/json`,...o(r)},body:JSON.stringify(n)})}function l(e){return typeof e==`object`&&!!e}function u(e){return l(e)&&`features`in e&&Array.isArray(e.features)}function d(e){return!l(e)||!(`experienceId`in e)||!(`content`in e)?!1:Array.isArray(e.content)}function f(e){try{let t=new URL(e).hostname;return t===`localhost`||t===`127.0.0.1`||t===`::1`}catch{return!1}}function p(e){if(!l(e)||!(`cause`in e))return!1;let{cause:t}=e;return!l(t)||!(`code`in t)?!1:t.code===`ECONNREFUSED`}async function m(e,t,n){let r=n?.previewToken?`projects/${t}?preview_token=${encodeURIComponent(n.previewToken)}`:`projects/${t}`,i;try{i=await s(e,r,n?.headers,n?.signal)}catch(t){return f(e)&&p(t),null}if(!i.ok)return`${i.status.toString()}`,null;let a;try{a=await i.json()}catch{return null}return u(a)?a:null}async function h(e,t,n,r){let i=r?.previewToken?`projects/${t}/experiences/${n}/content?preview_token=${encodeURIComponent(r.previewToken)}`:`projects/${t}/experiences/${n}/content`,a;try{a=await s(e,i,r?.headers,r?.signal)}catch(t){return f(e)&&p(t)||`${n}`,null}if(!a.ok)return`${n}${a.status.toString()}`,null;let o;try{o=await a.json()}catch{return`${n}`,null}return d(o)?o:(`${n}`,null)}function g(e){if(typeof e!=`object`||!e||!(`projectConfig`in e)||!(`experienceContent`in e)||!(`manifestMetadata`in e))return!1;let{experienceContent:t}=e;return typeof t==`function`}var _=null;function v(e){g(e)&&(_=e)}function y(){return _}Object.defineProperty(exports,"a",{enumerable:!0,get:function(){return m}}),Object.defineProperty(exports,"c",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return h}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return v}}),Object.defineProperty(exports,"o",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return g}}),Object.defineProperty(exports,"s",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return y}});

package/dist/types/data-source/api.d.ts

@@ -1,60 +0,0 @@
-import type { ExperienceContentResponse, FetchProjectOptions, ProjectConfig } from '../plugins/dynamic-experiences/types';
-/**
- * Minimal shape check: verifies that `data` is an object with a `features` array.
- *
- * This is the minimum invariant required to prevent runtime crashes when iterating
- * `config.features`. Individual feature and experience shapes are trusted from the API.
- *
- * @param {unknown} data - Unknown API response to validate.
- * @returns {boolean} Whether `data` has the minimum required shape.
- * @example
- * ```typescript
- * if (isProjectConfig(json)) { json.features }
- * ```
- */
-export declare function isProjectConfig(data: unknown): data is ProjectConfig;
-/**
- * Minimal shape check for a successful experience-content response.
- *
- * @param {unknown} data - Unknown API response to validate.
- * @returns {boolean} Whether `data` has the minimum required shape.
- * @example
- * ```typescript
- * if (isExperienceContentResponse(json)) { useResponse(json) }
- * ```
- */
-export declare function isExperienceContentResponse(data: unknown): data is ExperienceContentResponse;
-/**
- * Fetches the project configuration from the Picked REST API.
- *
- * Returns `null` on network failure, non-OK responses, or invalid JSON shape.
- * Connection-refused errors from local URLs are suppressed silently.
- *
- * @param {string} apiUrl - Base URL for the Picked API.
- * @param {string} projectId - Project ID to fetch config for.
- * @param {FetchProjectOptions} [options] - Optional headers, preview token, and abort signal.
- * @returns {Promise<ProjectConfig | null>} Validated project config, or `null` on any failure.
- * @example
- * ```typescript
- * const config = await fetchProject('https://api.picked.app', 'proj_123')
- * ```
- */
-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, preview token, and abort signal.
- * @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>;
-//# sourceMappingURL=api.d.ts.map

package/dist/types/data-source/api.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/data-source/api.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EACV,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACd,MAAM,sCAAsC,CAAA;AAiC7C;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,aAAa,CAEpE;AAED;;;;;;;;;GASG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,yBAAyB,CAM5F;AA8CD;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;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,CAqC3C"}