@picked/client 0.0.1-dev.1789541668638 → 0.0.1-next.2

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

@@ -1,50 +0,0 @@
-import type { 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

@@ -1 +0,0 @@
-{"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/hash.d.ts

@@ -1,105 +0,0 @@
-/** @file Deterministic, independent per-feature bucket allocation for A/B testing. */
-/**
- * FNV-1a 32-bit hash.
- * Deterministic, fast, well-distributed for short strings.
- *
- * @param {string} input - String to hash.
- * @returns {number} Unsigned 32-bit hash.
- * @example
- * ```typescript
- * fnv1a32('sess_1:winter-sale')
- * ```
- */
-export declare function fnv1a32(input: string): number;
-/**
- * Deterministic dice roll for A/B testing.
- *
- * Returns a value 0–99 that is stable for a given session and feature. Seeding
- * on the feature as well as the session keeps flags independent of one another:
- * two flags at weight 50 each take half of sessions, and a quarter of sessions
- * land in both. Independence rests on the avalanche in {@link fmix32}, not on
- * the seed alone.
- *
- * The feature version keys the stored bucket rather than the roll, so
- * publishing a new version re-runs `decide` against the current weight and an
- * unchanged weight keeps the same audience.
- *
- * This is the boolean path's input. A multi-variant feature does not roll once
- * and look the result up; {@link allocateVariant} scores each arm on its own
- * seed. One roll per feature is still what keeps features independent of one
- * another, per ADR-0018.
- *
- * @param {string} sessionId - Current session id, stable across page loads.
- * @param {string} featureId - Feature the roll is for.
- * @returns {number} A value in the range 0 to 99.
- * @example
- * ```typescript
- * const diceRoll = featureDiceRoll('sess_1', 'winter-sale')
- * ```
- */
-export declare function featureDiceRoll(sessionId: string, featureId: string): number;
-/**
- * Whether the given dice roll falls within the feature's weight.
- *
- * Widening a weight admits sessions the narrower weight excluded and never
- * evicts one already inside, so a rollout can ratchet up without re-bucketing
- * anyone. The roll is per feature, so this describes one feature's own weight
- * changing over time; two features at the same weight overlap by chance.
- *
- * @param {number} diceRoll - Roll from {@link featureDiceRoll}, 0–99.
- * @param {number} weight - Feature weight, 0–100.
- * @returns {boolean} Whether the session is allocated to the feature.
- * @example
- * ```typescript
- * isAllocated(42, 50) // true
- * ```
- */
-export declare function isAllocated(diceRoll: number, weight: number): boolean;
-/** The fields {@link allocateVariant} needs from an arm. */
-export interface AllocatableVariant {
-    key: string;
-    weight: number;
-}
-/**
- * Picks the arm a session lands in, scoring each arm independently.
- *
- * Each arm is hashed on its own key and scored against its own weight, and the
- * highest score wins. An arm's score therefore depends on nothing but the
- * session, the feature and that arm's own weight, which is what gives the two
- * properties an author is entitled to assume:
- *
- * - Editing one arm's weight moves sessions only into or out of that arm. Two
- *   arms the author did not touch never trade sessions with each other.
- * - Widening an arm only admits sessions and never evicts one already inside,
- *   the same ratchet {@link isAllocated} gives the boolean path. Narrowing is
- *   its mirror.
- *
- * Neither holds for cumulative ranges, where an arm's interval depends on every
- * arm ordered before it, so a boundary shift upstream drags unrelated arms
- * across it.
- *
- * Scores are compared, never summed, so the result is invariant under scaling
- * every weight by the same factor: `1:1:2` and `10:10:20` allocate identically.
- * Ties break on the key so that the arms' arrival order cannot matter — nothing
- * in the delivery pipeline promises one.
- *
- * The chosen arm is returned whole rather than by key, so a caller reading its
- * value needs no second lookup — and cannot resolve a duplicate key to a
- * different arm than the one scored.
- *
- * @template T
- * @param {string} sessionId - Current session id, stable across page loads.
- * @param {string} featureKey - Feature being allocated.
- * @param {readonly T[]} variants - The feature's arms, in any order.
- * @returns {T | null} The chosen arm, or null when the set decides nobody.
- * @example
- * ```typescript
- * // 'hero-b' takes three sessions in four; 'false' takes the fourth.
- * allocateVariant('sess_1', 'hero', [
- *   { key: 'hero-b', weight: 3 },
- *   { key: 'false', weight: 1 },
- * ])
- * ```
- */
-export declare function allocateVariant<T extends AllocatableVariant>(sessionId: string, featureKey: string, variants: readonly T[]): T | null;
-//# sourceMappingURL=hash.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/hash.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAY7C;AA8BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAUrE;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;CACf;AA4CD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,kBAAkB,EAC1D,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,SAAS,CAAC,EAAE,GACrB,CAAC,GAAG,IAAI,CAmBV"}

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

@@ -1,7 +0,0 @@
-/** @file Public exports for the dynamic-experiences plugin (project config + per-experience content resolution). */
-export { dynamicExperiencesPlugin, fetchExperienceContent, fetchProject } from './plugin';
-export { createClientHeaders, fetchSchema } from '@picked/delivery-api-client';
-export { registerPickedBundle } from '../../data-source/registry';
-export type * from './types';
-export type { ApiExperienceStep, ContentBlob, ExperienceContentResponse, FetchProjectOptions, ProjectConfig, ProjectConfigExperience, ProjectConfigFeature, ProjectConfigNode, } from '@picked/delivery-api-client';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"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;AAGzF,OAAO,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAA;AAI9E,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AACjE,mBAAmB,SAAS,CAAA;AAI5B,YAAY,EACV,iBAAiB,EACjB,WAAW,EACX,yBAAyB,EACzB,mBAAmB,EACnB,aAAa,EACb,uBAAuB,EACvB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,6BAA6B,CAAA"}

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

@@ -1,49 +0,0 @@
-import type { ProjectConfig } from '@picked/delivery-api-client';
-import type { Plugin } from '../../entities/plugin/plugin';
-import type { Picked } from '../../picked';
-export { fetchProject, fetchExperienceContent } from '../../data-source/api';
-/**
- * Synchronously registers a complete project config with the client: features, conditions,
- * fields, steps, and experiences, in dependency order.
- *
- * Extracted from `dynamicExperiencesPlugin`'s `onStart` so the same registration runs outside
- * the lifecycle (notably from the server `serialize` helper and the SSR provider), where the
- * stores must be populated synchronously before selection or rendering.
- *
- * @param {Picked} client - Picked client instance.
- * @param {ProjectConfig} config - Project configuration to register.
- * @param {object} options - Registration options.
- * @param {boolean} options.isPreview - Whether features use session storage instead of local storage.
- * @param {string} options.sessionId - Current session id, used as the seed for stable feature allocation.
- * @example
- * ```typescript
- * registerProjectConfig(client, config, { isPreview: false, sessionId: 's' })
- * ```
- */
-export declare function registerProjectConfig(client: Picked, config: ProjectConfig, options: {
-    isPreview: boolean;
-    sessionId: string;
-}): void;
-/**
- * Plugin that resolves project configuration through the client and registers features,
- * steps, fields, and experiences with it.
- *
- * 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 {Plugin} A configured Picked plugin.
- * @example
- * ```typescript
- * import { dynamicExperiencesPlugin } from '@picked/client/plugins/dynamic-experiences'
- *
- * createClient({
- *   plugins: [
- *     dynamicExperiencesPlugin()
- *   ]
- * })
- * ```
- */
-export declare function dynamicExperiencesPlugin(): Plugin;
-//# sourceMappingURL=plugin.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/dynamic-experiences/plugin.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAEV,aAAa,EAGd,MAAM,6BAA6B,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAG1D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAK1C,OAAO,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AA+J5E;;;;;;;;;;;;;;;;;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;AA2QD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CA4DjD"}

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

@@ -1,45 +0,0 @@
-/**
- * @file Plugin-specific types for the dynamic-experiences plugin.
- *
- * The wire-format shapes the Delivery API returns live in `@picked/delivery-api-client`,
- * which stays runtime-agnostic. This file holds the types that only mean something inside
- * the client: the content loader and the virtual data module
- * `@picked/vite-plugin-picked` generates.
- */
-import type { ExperienceContentResponse, ProjectConfig } 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)
- * and called by each experience's `prepareExperienceContentFx`, which is fired by the
- * per-experience sample graph in parallel with `initialiseFx`.
- */
-export type ContentLoader = (experience: {
-    id: string;
-    key: string;
-}, 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.
- */
-export interface VirtualPickedData {
-    projectConfig: ProjectConfig;
-    experienceContent: ContentLoader;
-    manifestMetadata: PickedManifestMetadata;
-}
-//# sourceMappingURL=types.d.ts.map

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

@@ -1 +0,0 @@
-{"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;;;;;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/plugins/experience-browser-storage/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/experience-browser-storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,UAAU,CAAA"}

package/dist/types/plugins/experience-browser-storage/plugin.d.ts

@@ -1,7 +0,0 @@
-import type { Plugin } from '../../entities/plugin/plugin';
-interface ExperienceBrowserStoragePlugin {
-    storage?: 'local' | 'session';
-}
-export declare const experienceBrowserStoragePlugin: ({ storage, }?: ExperienceBrowserStoragePlugin) => Plugin;
-export {};
-//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugins/experience-browser-storage/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/experience-browser-storage/plugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAM1D,UAAU,8BAA8B;IACtC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC9B;AAED,eAAO,MAAM,8BAA8B,kBAExC,8BAA8B,KAAQ,MAmDxC,CAAA"}

package/dist/types/plugins/history-browser-storage/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/history-browser-storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAA"}

package/dist/types/plugins/history-browser-storage/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/history-browser-storage/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAM1D,cAAc;AACd,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC9B;AAED,eAAO,MAAM,2BAA2B,kBAErC,2BAA2B,KAAQ,MA8BrC,CAAA"}

package/dist/types/plugins/responses-browser-storage/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/responses-browser-storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,6BAA6B,EAAE,MAAM,UAAU,CAAA"}

package/dist/types/plugins/responses-browser-storage/plugin.d.ts

@@ -1,18 +0,0 @@
-import type { Plugin } from '../../entities/plugin/plugin';
-interface ResponsesBrowserStoragePlugin {
-    storage?: 'local' | 'session';
-}
-/**
- * Persists field responses to browser storage and restores them on the next page load.
- *
- * @param {ResponsesBrowserStoragePlugin} [options] - Plugin options.
- * @param {'local' | 'session'} [options.storage] - Which browser store to persist to.
- * @returns {Plugin} The plugin to pass to `createClient({ plugins })`.
- * @example
- * ```ts
- * createClient({ plugins: [responsesBrowserStoragePlugin({ storage: 'local' })] })
- * ```
- */
-export declare const responsesBrowserStoragePlugin: ({ storage, }?: ResponsesBrowserStoragePlugin) => Plugin;
-export {};
-//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugins/responses-browser-storage/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/responses-browser-storage/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAM1D,UAAU,6BAA6B;IACrC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CAC9B;AAsED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,6BAA6B,kBAEvC,6BAA6B,KAAQ,MA4FvC,CAAA"}

package/dist/types/plugins/responses-indexeddb/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/responses-indexeddb/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAA"}

package/dist/types/plugins/responses-indexeddb/plugin.d.ts

@@ -1,3 +0,0 @@
-import type { Plugin } from '../../entities/plugin/plugin';
-export declare const responsesIndexedDBPlugin: () => Plugin;
-//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugins/responses-indexeddb/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/responses-indexeddb/plugin.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAO1D,eAAO,MAAM,wBAAwB,QAAO,MAyE3C,CAAA"}

package/dist/types/plugins/telemetry/emit.d.ts

@@ -1,18 +0,0 @@
-/**
- * @file The lazily-imported half of the telemetry plugin.
- *
- * This module holds the only import of the OTLP emitter, so bundlers give it
- * its own chunk and the plugin can load it after first paint.
- */
-import { type SpanAttributes, type TelemetrySpan } from '@picked/telemetry';
-/**
- * Sends a batch of spans and resolves once the attempt has finished.
- *
- * @param {string} [endpoint] - OTLP HTTP trace endpoint. Defaults to Picked's collector.
- * @param {SpanAttributes} resource - Resource attributes describing this SDK instance.
- * @param {TelemetrySpan[]} spans - Spans to send.
- * @returns {Promise<void>} Resolves when the batch has been attempted.
- * @example await flushSpans(undefined, { 'service.name': 'picked-sdk' }, spans)
- */
-export declare function flushSpans(endpoint: string | undefined, resource: SpanAttributes, spans: TelemetrySpan[]): Promise<void>;
-//# sourceMappingURL=emit.d.ts.map

package/dist/types/plugins/telemetry/emit.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"emit.d.ts","sourceRoot":"","sources":["../../../../src/plugins/telemetry/emit.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAA0B,KAAK,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAA;AAEnG;;;;;;;;GAQG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,QAAQ,EAAE,cAAc,EACxB,KAAK,EAAE,aAAa,EAAE,GACrB,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/types/plugins/telemetry/index.d.ts

@@ -1,4 +0,0 @@
-/** @file Public entry for the opt-in browser telemetry plugin. */
-export { telemetryPlugin, TELEMETRY_PLUGIN_NAME } from './plugin';
-export type * from './plugin';
-//# sourceMappingURL=index.d.ts.map

package/dist/types/plugins/telemetry/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/telemetry/index.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AACjE,mBAAmB,UAAU,CAAA"}

package/dist/types/plugins/telemetry/plugin-summary.d.ts

@@ -1,10 +0,0 @@
-/** @file Summarises a client's registered plugin names for telemetry. */
-/**
- * Sorts and caps a client's registered plugin names for reporting.
- *
- * @param {string[]} registered - Every plugin name registered on the client.
- * @returns {string[]} The names, sorted, capped at the reporting limit.
- * @example summarisePlugins(['window', 'analytics']) // ['analytics', 'window']
- */
-export declare function summarisePlugins(registered: string[]): string[];
-//# sourceMappingURL=plugin-summary.d.ts.map

package/dist/types/plugins/telemetry/plugin-summary.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin-summary.d.ts","sourceRoot":"","sources":["../../../../src/plugins/telemetry/plugin-summary.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAKzE;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAE/D"}

package/dist/types/plugins/telemetry/plugin.d.ts

@@ -1,45 +0,0 @@
-import type { Plugin } from '../../entities/plugin/plugin';
-/** Plugin name under which this plugin registers. */
-export declare const TELEMETRY_PLUGIN_NAME = "telemetry";
-/**
- * Spans held before a flush is forced.
- *
- * A session buffers between flushes, so this is what bounds the buffer on a
- * long-lived page that keeps making delivery API requests.
- */
-export declare const MAX_BUFFERED_SPANS = 50;
-/**
- * How long the batch waits after its first span for others to join it.
- *
- * The ready flush goes out before a delivery API request settles, and a session
- * makes far fewer requests than {@link MAX_BUFFERED_SPANS} — so this timer is
- * what sends a delivery span while the session is still running, leaving the
- * page-hidden flush as the backstop for whatever the last few seconds hold.
- */
-export declare const FLUSH_DELAY_MS = 5000;
-/** Options for {@link telemetryPlugin}. */
-export interface TelemetryPluginOptions {
-    /**
-     * Fraction of sessions to trace, between 0 and 1.
-     *
-     * Decided once per client, before the first request, since it also decides
-     * whether `traceparent` is sent.
-     *
-     * @default 1
-     */
-    sampleRate?: number;
-    /** OTLP HTTP trace endpoint. Defaults to Picked's collector. */
-    endpoint?: string;
-}
-/**
- * Creates the browser telemetry plugin.
- *
- * @param {TelemetryPluginOptions} [options] - Sampling and endpoint overrides.
- * @returns {Plugin} A plugin to register with the Picked client.
- * @example
- * ```typescript
- * const client = createClient({ plugins: [telemetryPlugin({ sampleRate: 0.05 })] })
- * ```
- */
-export declare function telemetryPlugin(options?: TelemetryPluginOptions): Plugin;
-//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugins/telemetry/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/telemetry/plugin.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAK1D,qDAAqD;AACrD,eAAO,MAAM,qBAAqB,cAAc,CAAA;AAEhD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAA;AAEpC;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,OAAO,CAAA;AAElC,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAwDD;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAmFxE"}

package/dist/types/plugins/web-components/index.d.ts

@@ -1,2 +0,0 @@
-export { webComponentsPlugin } from './plugin';
-//# sourceMappingURL=index.d.ts.map

package/dist/types/plugins/web-components/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/plugins/web-components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAA"}

package/dist/types/plugins/web-components/plugin.d.ts

@@ -1,4 +0,0 @@
-/** @file Web Components plugin — registers a `<picked-root>` custom element that launches a Picked experience by id when connected to the DOM. */
-import type { Plugin } from '../../entities/plugin/plugin';
-export declare const webComponentsPlugin: () => Plugin;
-//# sourceMappingURL=plugin.d.ts.map

package/dist/types/plugins/web-components/plugin.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../src/plugins/web-components/plugin.ts"],"names":[],"mappings":"AAAA,kJAAkJ;AAClJ,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAA;AAG1D,eAAO,MAAM,mBAAmB,QAAO,MA2BtC,CAAA"}

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

@@ -1,18 +0,0 @@
-/**
- * @file Public entry for live-preview helpers.
- *
- * Separate from the root entry so the path parser and the ops applier never reach the bundle every
- * customer page loads. Imported by the Picked dashboard, and by the SDK's own preview receiver.
- *
- * The wire protocol is exported from here so the embedder builds against the same declaration the
- * receiver does — see `preview-receiver/protocol` for why that stays compatible with older SDKs.
- * The receiver's own inbound guard is not exported: the embedder sends patches rather than
- * receiving them, and leaving it out keeps this entry inside its `size-limit` budget.
- */
-export { formatContentPath, parseContentPath } from '../utils/content-path';
-export type { ContentPathSegment } from '../utils/content-path';
-export { applyContentOps } from '../preview-receiver/apply-ops';
-export type { ContentPatchOp } from '../preview-receiver/apply-ops';
-export { PREVIEW_CONTENT_PATCH_MESSAGE, PREVIEW_INERT_SCRIPTS_MESSAGE, PREVIEW_PROTOCOL_VERSION, PREVIEW_READY_MESSAGE, PREVIEW_RESYNC_MESSAGE, } from '../preview-receiver/protocol';
-export type { PreviewInertScriptsMessage, PreviewReadyMessage, PreviewResyncMessage, } from '../preview-receiver/protocol';
-//# sourceMappingURL=index.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/preview/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAC3E,YAAY,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAA;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAC/D,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,EACL,6BAA6B,EAC7B,6BAA6B,EAC7B,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,8BAA8B,CAAA;AACrC,YAAY,EACV,0BAA0B,EAC1B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,8BAA8B,CAAA"}

package/dist/types/preview-bridge/index.d.ts

@@ -1,14 +0,0 @@
-/** The `postMessage` `type` discriminator for navigation reports sent to the embedding parent frame. */
-export declare const PREVIEW_NAVIGATION_MESSAGE = "picked-preview:navigation";
-/**
- * Starts reporting this frame's URL to the embedding parent frame: posts immediately, then again on
- * every SPA navigation (`history.pushState`/`replaceState` and `popstate`). Listeners are wired at
- * most once per frame, so multiple Picked clients on the same page do not double-report.
- *
- * @returns {() => void} A teardown function that detaches the `popstate` listener and re-arms the bridge.
- * @example
- * const stop = initPreviewBridge()
- * // later, e.g. in a test: stop()
- */
-export declare function initPreviewBridge(): () => void;
-//# sourceMappingURL=index.d.ts.map

package/dist/types/preview-bridge/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/preview-bridge/index.ts"],"names":[],"mappings":"AAUA,wGAAwG;AACxG,eAAO,MAAM,0BAA0B,8BAA8B,CAAA;AAmErE;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,IAAI,CAwB9C"}

package/dist/types/preview-channel.d.ts

@@ -1,16 +0,0 @@
-/**
- * @file Single entry point for the live-preview channel, so the bridge and the receiver share one
- * dynamic-import boundary and neither reaches production bundles.
- */
-import type { Picked } from './picked';
-/**
- * Starts both halves of the preview channel: the outbound bridge that reports this frame's URL to
- * the dashboard, and the inbound receiver that applies the dashboard's content patches.
- *
- * @param {Picked} client - The Picked client whose content index receives the patches.
- * @returns {() => void} Teardown that stops both halves.
- * @example
- * const stop = initPreviewChannel(client)
- */
-export declare function initPreviewChannel(client: Picked): () => void;
-//# sourceMappingURL=preview-channel.d.ts.map

package/dist/types/preview-channel.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"preview-channel.d.ts","sourceRoot":"","sources":["../../src/preview-channel.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAItC;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAQ7D"}

package/dist/types/preview-receiver/apply-ops.d.ts

@@ -1,32 +0,0 @@
-/**
- * A single path-addressed replacement inside a content record's `data`.
- *
- * `path` uses the format the Picked API already emits for content-data validation errors —
- * `$.sections[0].data.title`. See `utils/content-path`.
- */
-export interface ContentPatchOp {
-    /** Path to the value being replaced, for example `$.sections[0].data.title`. */
-    path: string;
-    /** The replacement value. */
-    value: unknown;
-}
-/**
- * Applies path-addressed replacements to a content `data` blob, returning a new blob that shares
- * every untouched branch with the original.
- *
- * That structural sharing is the point of per-field patching: replacing the whole blob would mint a
- * fresh object identity for every field on every keystroke, re-rendering every memoised consumer in
- * the host app's tree. Here only the touched spine changes identity.
- *
- * Ops that cannot be applied — a malformed path, the root, a prototype-polluting key, an index into
- * a non-array, an out-of-range index — are skipped. A patch arrives from another frame, so a bad op
- * must degrade to a no-op rather than throw inside a customer's page.
- *
- * @param {Record<string, unknown>} data - The content `data` blob to patch.
- * @param {readonly ContentPatchOp[]} ops - The replacements to apply, in order.
- * @returns {Record<string, unknown>} The patched blob, or `data` unchanged when no op applied.
- * @example
- * applyContentOps({ headline: 'old' }, [{ path: '$.headline', value: 'new' }])
- */
-export declare function applyContentOps(data: Record<string, unknown>, ops: readonly ContentPatchOp[]): Record<string, unknown>;
-//# sourceMappingURL=apply-ops.d.ts.map

package/dist/types/preview-receiver/apply-ops.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"apply-ops.d.ts","sourceRoot":"","sources":["../../../src/preview-receiver/apply-ops.ts"],"names":[],"mappings":"AASA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,KAAK,EAAE,OAAO,CAAA;CACf;AA4DD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,GAAG,EAAE,SAAS,cAAc,EAAE,GAC7B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAUzB"}

package/dist/types/preview-receiver/index.d.ts

@@ -1,32 +0,0 @@
-/**
- * @file Live-preview receiver: applies content patches pushed by the Picked dashboard.
- *
- * Reached only through a dynamic `import()` the client performs when a preview session is detected,
- * so it stays out of production bundles. It touches only `client.contents`, which is
- * framework-agnostic, so React, Svelte and script-tag installs all get live preview without any
- * per-binding code.
- *
- * Trust model: the customer's page does not opt in, so the origin check is the only defence and it
- * cannot come from the page itself. The API issues `previewEmbedderOrigins` alongside the preview
- * project config; every inbound message is validated against that list, and the handshake is posted
- * only to those origins. Never `document.referrer` (it becomes this frame's own origin after an
- * in-frame navigation) and never a wildcard target.
- *
- * The base blob is the SDK's own preview-token fetch, so the receiver announces readiness only once
- * content is registered and patches always land on a server-projected base.
- */
-import type { Picked } from '../picked';
-/**
- * Starts the live-preview receiver: announces readiness to the allowlisted embedder origins once
- * content is registered, then applies inbound content patches to the client's content index.
- *
- * Wired at most once per frame, so several Picked clients on one page cannot double-apply a patch.
- *
- * @param {Picked} client - The Picked client whose content index receives the patches.
- * @returns {() => void} Teardown that detaches every listener and re-arms the receiver.
- * @example
- * const stop = initPreviewReceiver(client)
- * // later, e.g. in a test: stop()
- */
-export declare function initPreviewReceiver(client: Picked): () => void;
-//# sourceMappingURL=index.d.ts.map

package/dist/types/preview-receiver/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/preview-receiver/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AA4CvC;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAyG9D"}