@picked/client 0.0.69 → 0.0.70-next.2

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

@@ -0,0 +1,32 @@
+/**
+ * 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

@@ -0,0 +1 @@
+{"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

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

@@ -0,0 +1 @@
+{"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"}

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

@@ -0,0 +1,60 @@
+import { ContentPatchOp } from './apply-ops';
+/** Current protocol version. Reported on the handshake for support and telemetry only. */
+export declare const PREVIEW_PROTOCOL_VERSION = 1;
+/** Receiver → embedder: the frame is listening and content is registered. */
+export declare const PREVIEW_READY_MESSAGE = "picked-preview:ready";
+/** Embedder → receiver: path-addressed replacements for one content record. */
+export declare const PREVIEW_CONTENT_PATCH_MESSAGE = "picked-preview:content-patch";
+/** Receiver → embedder: a sequence gap was detected; resend the dirty paths. */
+export declare const PREVIEW_RESYNC_MESSAGE = "picked-preview:resync";
+/** Receiver → embedder: cumulative count of inserted subtrees whose scripts were neutralised. */
+export declare const PREVIEW_INERT_SCRIPTS_MESSAGE = "picked-preview:inert-scripts";
+/** Handshake posted by the receiver to each allowlisted origin. */
+export interface PreviewReadyMessage {
+    /** Discriminator. */
+    type: typeof PREVIEW_READY_MESSAGE;
+    /** Protocol version this receiver speaks. Diagnostics only. */
+    protocolVersion: number;
+    /** Content record ids currently registered, so the embedder knows what it can patch. */
+    contentIds: string[];
+}
+/** Patch posted by the embedder for one content record. Narrowed to by {@link isContentPatchMessage}. */
+interface PreviewContentPatchMessage {
+    /** Discriminator. */
+    type: typeof PREVIEW_CONTENT_PATCH_MESSAGE;
+    /** The content record to patch. */
+    contentId: string;
+    /** Path-addressed replacements, applied in order. */
+    ops: ContentPatchOp[];
+    /** Monotonic per-record sequence number, used only to detect a dropped message. */
+    seq: number;
+}
+/** Resync request posted by the receiver after a sequence gap. */
+export interface PreviewResyncMessage {
+    /** Discriminator. */
+    type: typeof PREVIEW_RESYNC_MESSAGE;
+    /** The content record whose sequence broke. */
+    contentId: string;
+    /** The last sequence number successfully applied. */
+    lastSeq: number;
+}
+/** Inert-script report posted by the receiver. */
+export interface PreviewInertScriptsMessage {
+    /** Discriminator. */
+    type: typeof PREVIEW_INERT_SCRIPTS_MESSAGE;
+    /** Cumulative count of inserted subtrees whose scripts were neutralised this session. */
+    total: number;
+}
+/**
+ * Type guard for an inbound content-patch message.
+ *
+ * Validates structurally rather than trusting the sender: the message crosses a frame boundary, and
+ * an unrecognised or malformed one is ignored rather than throwing inside a customer's page.
+ *
+ * @param {unknown} data - The `MessageEvent.data` payload.
+ * @returns {boolean} True when the payload is a well-formed content-patch message.
+ * @example isContentPatchMessage(event.data)
+ */
+export declare function isContentPatchMessage(data: unknown): data is PreviewContentPatchMessage;
+export {};
+//# sourceMappingURL=protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../../src/preview-receiver/protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAEjD,0FAA0F;AAC1F,eAAO,MAAM,wBAAwB,IAAI,CAAA;AAEzC,6EAA6E;AAC7E,eAAO,MAAM,qBAAqB,yBAAyB,CAAA;AAC3D,+EAA+E;AAC/E,eAAO,MAAM,6BAA6B,iCAAiC,CAAA;AAC3E,gFAAgF;AAChF,eAAO,MAAM,sBAAsB,0BAA0B,CAAA;AAC7D,iGAAiG;AACjG,eAAO,MAAM,6BAA6B,iCAAiC,CAAA;AAE3E,mEAAmE;AACnE,MAAM,WAAW,mBAAmB;IAClC,qBAAqB;IACrB,IAAI,EAAE,OAAO,qBAAqB,CAAA;IAClC,+DAA+D;IAC/D,eAAe,EAAE,MAAM,CAAA;IACvB,wFAAwF;IACxF,UAAU,EAAE,MAAM,EAAE,CAAA;CACrB;AAED,yGAAyG;AACzG,UAAU,0BAA0B;IAClC,qBAAqB;IACrB,IAAI,EAAE,OAAO,6BAA6B,CAAA;IAC1C,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAA;IACjB,qDAAqD;IACrD,GAAG,EAAE,cAAc,EAAE,CAAA;IACrB,mFAAmF;IACnF,GAAG,EAAE,MAAM,CAAA;CACZ;AAED,kEAAkE;AAClE,MAAM,WAAW,oBAAoB;IACnC,qBAAqB;IACrB,IAAI,EAAE,OAAO,sBAAsB,CAAA;IACnC,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAA;IACjB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,kDAAkD;AAClD,MAAM,WAAW,0BAA0B;IACzC,qBAAqB;IACrB,IAAI,EAAE,OAAO,6BAA6B,CAAA;IAC1C,yFAAyF;IACzF,KAAK,EAAE,MAAM,CAAA;CACd;AA8BD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,0BAA0B,CAavF"}

package/dist/types/utils/content-path.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @file Content-path parsing for live-preview patches.
+ *
+ * Paths address a field inside a Content Entry's delivered `data` blob using the format the Picked
+ * API already emits for content-data validation errors — `$.sections[0].data.title`, rooted at `$`,
+ * with `.key` for object keys and `[n]` for array indices. Reusing that format keeps one convention
+ * across validation errors and preview patches instead of inventing a second.
+ *
+ * Content-model field keys are constrained to `/^[a-z][a-z0-9_]*$/` server-side, so no key can
+ * contain `.` or `[` and the string form needs no escaping.
+ */
+/** One step along a content path: an object key, or an array index. */
+export type ContentPathSegment = string | number;
+/**
+ * Parses a content path into its segments.
+ *
+ * Returns an empty list for the root path *and* for anything malformed. Callers treat an empty list
+ * as "no addressable target" and skip the operation, so a corrupt or hostile path from another
+ * frame degrades to a no-op instead of throwing inside a customer's page.
+ *
+ * @param {string} path - The path to parse, for example `$.sections[0].data.title`.
+ * @returns {ContentPathSegment[]} The parsed segments, or `[]` for the root or an invalid path.
+ * @example
+ * parseContentPath('$.sections[0].data.title') // ['sections', 0, 'data', 'title']
+ */
+export declare function parseContentPath(path: string): ContentPathSegment[];
+/**
+ * Formats segments back into a content path. Inverse of {@link parseContentPath} for every
+ * well-formed path.
+ *
+ * @param {readonly ContentPathSegment[]} segments - The segments to format.
+ * @returns {string} The path string, or `'$'` when there are no segments.
+ * @example
+ * formatContentPath(['sections', 0, 'data', 'title']) // '$.sections[0].data.title'
+ */
+export declare function formatContentPath(segments: readonly ContentPathSegment[]): string;
+//# sourceMappingURL=content-path.d.ts.map

package/dist/types/utils/content-path.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-path.d.ts","sourceRoot":"","sources":["../../../src/utils/content-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,uEAAuE;AACvE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,CAAA;AA2ChD;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAYnE;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,CAOjF"}

package/dist/types/utils/events.d.ts

@@ -71,6 +71,31 @@ export interface PayloadMap {
         experience: ExperienceInstance;
         step?: ExperienceStep;
     };
+    /**
+     * Emitted when a consumer callback registered via `form.onBeforeSubmit`,
+     * `form.onSuccess` or `form.onError` throws or rejects — once per failed
+     * callback.
+     *
+     * A `success` or `error` phase failure never blocks navigation; a
+     * `before-submit` failure aborts the submit before commit, because that
+     * callback is on the data path and its return value is what gets committed.
+     *
+     * The thrown value is normalised to `name`/`message` deliberately: no stack,
+     * no cause, and no submitted field data, because the bus fans out to
+     * third-party sinks. The field is named `error` rather than `exception` so it
+     * stays distinct from the `{ reason: ValidationError[] }` shape that the
+     * analytics plugin narrows on.
+     */
+    form_submit_callback_error: {
+        form: FormPayload;
+        phase: 'before-submit' | 'success' | 'error';
+        error: {
+            name: string;
+            message: string;
+        };
+        experience: ExperienceInstance;
+        step?: ExperienceStep;
+    };
     field_validation_error: {
         exception: {
             reason: ValidationError[];

package/dist/types/utils/events.d.ts.map

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

package/dist/types/utils/inert-script-report.d.ts

@@ -0,0 +1,40 @@
+/**
+ * @file Relays the count of preview-inserted subtrees whose scripts were neutralised.
+ *
+ * The render layer (`@picked/react`'s `HtmlRender`) knows how many script-bearing subtrees a
+ * preview morph inserted; the preview receiver knows how to tell the dashboard. Neither should
+ * import the other, so the count passes through this tiny module. Every framework binding's render
+ * path reports into the same receiver through it.
+ *
+ * The count is cumulative for the session and only ever grows, which matches how the editor uses
+ * it: "some markup you added is inert until you save", not a per-edit delta.
+ */
+/** Listener notified when the cumulative inert-subtree count changes. */
+type InertScriptListener = (total: number) => void;
+/**
+ * Records that a preview render inserted `count` subtrees whose scripts were neutralised.
+ *
+ * @param {number} count - Subtrees neutralised by the render that just completed.
+ * @returns {void} Nothing.
+ * @example reportInertScriptSubtrees(2)
+ */
+export declare function reportInertScriptSubtrees(count: number): void;
+/**
+ * Subscribes to the cumulative inert-subtree count, invoking `listener` immediately with the
+ * current total so a late subscriber (the receiver connects after first paint) is not left behind.
+ *
+ * @param {InertScriptListener} listener - Called with the running total.
+ * @returns {() => void} Unsubscribe function.
+ * @example const stop = onInertScriptSubtrees((n) => post({ inertScriptSubtrees: n }))
+ */
+export declare function onInertScriptSubtrees(listener: InertScriptListener): () => void;
+/**
+ * Resets the cumulative count and drops every listener. Exposed for tests, which share a module
+ * registry across cases.
+ *
+ * @returns {void} Nothing.
+ * @example resetInertScriptReport()
+ */
+export declare function resetInertScriptReport(): void;
+export {};
+//# sourceMappingURL=inert-script-report.d.ts.map

package/dist/types/utils/inert-script-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inert-script-report.d.ts","sourceRoot":"","sources":["../../../src/utils/inert-script-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,yEAAyE;AACzE,KAAK,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAA;AAKlD;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI7D;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,mBAAmB,GAAG,MAAM,IAAI,CAM/E;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C"}

package/dist/types/utils/preview-session.d.ts

@@ -0,0 +1,12 @@
+/** Search parameter the dashboard appends to the preview iframe's URL. */
+export declare const PREVIEW_TOKEN_PARAM = "preview-token";
+/**
+ * Whether this frame is running as a Picked live-preview session: inside an iframe, with a preview
+ * token on the URL.
+ *
+ * @returns {boolean} True when the frame is a preview session.
+ * @example
+ * if (isPreviewSession()) enableMorphingRender()
+ */
+export declare function isPreviewSession(): boolean;
+//# sourceMappingURL=preview-session.d.ts.map

package/dist/types/utils/preview-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preview-session.d.ts","sourceRoot":"","sources":["../../../src/utils/preview-session.ts"],"names":[],"mappings":"AAUA,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB,kBAAkB,CAAA;AAElD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,IAAI,OAAO,CAG1C"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@picked/client",
-  "version": "0.0.69",
+  "version": "0.0.70-next.2",
   "dependencies": {
     "@withease/factories": "^1.0.5"
   },
@@ -35,6 +35,12 @@
       "require": "./dist/cjs/server/index.js",
       "default": "./dist/esm/server/index.js"
     },
+    "./preview": {
+      "types": "./dist/types/preview/index.d.ts",
+      "import": "./dist/esm/preview/index.js",
+      "require": "./dist/cjs/preview/index.js",
+      "default": "./dist/esm/preview/index.js"
+    },
     "./plugins/single-page-app": {
       "types": "./dist/types/plugins/single-page-app/index.d.ts",
       "import": "./dist/esm/plugins/single-page-app/index.js",
@@ -166,12 +172,18 @@
   "size-limit": [
     {
       "path": "dist/esm/index.js",
-      "limit": "14.5 kB"
+      "limit": "16 kB",
+      "name": "index (incl. lazily-loaded preview channel; see AGENTS.md)"
     },
     {
       "path": "dist/esm/server/index.js",
       "limit": "10 kB"
     },
+    {
+      "path": "dist/esm/preview/index.js",
+      "limit": "5 kB",
+      "name": "preview helpers (dashboard-only subpath)"
+    },
     {
       "path": "dist/esm/plugins/single-page-app/index.js",
       "limit": "5 kB"

package/dist/api-u-1KqkBB.cjs

@@ -1 +0,0 @@
-var e=`Picked-Client`,t=`Picked-Version`;function n(n,r){return{[e]:n,[t]:r}}var r=()=>`0.0.69`,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)})}Object.defineProperty(exports,"i",{enumerable:!0,get:function(){return n}}),Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return r}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return s}});

package/dist/preview-bridge-CpX1BkSA.cjs

@@ -1 +0,0 @@
-const e=require("./object-CIkt7Fkr.cjs"),t=require("./supports-DBzjGaWD.cjs");var n=`picked-preview:navigation`,r=!1;function i(){return`*`}function a(){let{href:e,pathname:t,search:r}=globalThis.location,a={type:n,href:e,pathname:t,search:r};globalThis.parent.postMessage(a,i())}function o(e){return function(...t){e.apply(this,t),a()}}function s(){if(r||!t.f())return()=>void 0;r=!0,a();let n=()=>{a()};return globalThis.addEventListener(`popstate`,n),t.a()&&(e.n(globalThis.history,`pushState`,o),e.n(globalThis.history,`replaceState`,o)),()=>{r=!1,globalThis.removeEventListener(`popstate`,n)}}exports.initPreviewBridge=s;

package/dist/preview-bridge-D76l-dPy.js

@@ -1,33 +0,0 @@
-import { n as e } from "./object-BUDGxEqy.js";
-import { a as t, f as n } from "./supports-CO9bJGNl.js";
-//#region src/preview-bridge/index.ts
-var r = "picked-preview:navigation", i = !1;
-function a() {
-	return "*";
-}
-function o() {
-	let { href: e, pathname: t, search: n } = globalThis.location, i = {
-		type: r,
-		href: e,
-		pathname: t,
-		search: n
-	};
-	globalThis.parent.postMessage(i, a());
-}
-function s(e) {
-	return function(...t) {
-		e.apply(this, t), o();
-	};
-}
-function c() {
-	if (i || !n()) return () => void 0;
-	i = !0, o();
-	let r = () => {
-		o();
-	};
-	return globalThis.addEventListener("popstate", r), t() && (e(globalThis.history, "pushState", s), e(globalThis.history, "replaceState", s)), () => {
-		i = !1, globalThis.removeEventListener("popstate", r);
-	};
-}
-//#endregion
-export { c as initPreviewBridge };