@no-mess/client 0.2.0 → 0.3.0

package/dist/index.js

@@ -2,6 +2,8 @@ export { NoMessClient } from "./client.js";
 export { createLiveEditHandler } from "./live-edit.js";
 export { DEFAULT_ADMIN_ORIGIN, DEFAULT_API_URL, isPublishableKey, isSecretKey, NoMessError, } from "./types.js";
 import { NoMessClient } from "./client.js";
+import { createNoMessProtocolError, normalizeNoMessError, } from "./error-utils.js";
+import { createSdkLogger } from "./logging.js";
 /**
  * Create a no-mess client instance.
  */
@@ -25,48 +27,172 @@ export function createNoMessClient(config) {
  * ```
  */
 export function createPreviewHandler(config) {
+    const logger = createSdkLogger(config.logger);
     let sessionAuth = null;
+    let disposed = false;
+    let inFlightRequestId = 0;
+    let latestCompletedRequestId = 0;
+    const logEvent = (level, code, message, context, error) => {
+        logger({
+            level,
+            code,
+            message,
+            scope: "preview",
+            operation: "createPreviewHandler",
+            error: error instanceof Error ? error : undefined,
+            timestamp: new Date().toISOString(),
+            context,
+        });
+    };
+    const invokeOnError = (error) => {
+        try {
+            config.onError?.(error);
+        }
+        catch (callbackError) {
+            logEvent("error", "preview_exchange_failed", "Preview onError callback threw unexpectedly", {}, normalizeNoMessError(callbackError, {
+                kind: "runtime",
+                code: "preview_exchange_failed",
+                operation: "preview.onError",
+            }));
+        }
+    };
+    const postToParent = (message, origin, context) => {
+        try {
+            window.parent.postMessage(message, origin);
+            return true;
+        }
+        catch (error) {
+            const normalized = normalizeNoMessError(error, {
+                kind: "runtime",
+                code: "preview_postmessage_failed",
+                operation: "preview.postMessage",
+                details: context,
+            });
+            logEvent("error", normalized.code, "Failed to post preview message to parent window", {
+                ...context,
+                targetOrigin: origin,
+            }, normalized);
+            return false;
+        }
+    };
+    const emitPreviewError = (error, origin, context) => {
+        invokeOnError(error);
+        const normalized = normalizeNoMessError(error, {
+            kind: "runtime",
+            code: "preview_exchange_failed",
+            operation: "preview.emitError",
+            details: context,
+        });
+        logEvent("error", normalized.code, normalized.message, context, normalized);
+        postToParent({
+            type: "no-mess:preview-error",
+            error: normalized.message,
+            code: normalized.code,
+            status: normalized.status,
+            retryable: normalized.retryable,
+        }, origin, context);
+    };
+    const runExchange = async (reason, origin) => {
+        if (!sessionAuth) {
+            logEvent("debug", "preview_message_invalid", "Preview refresh ignored because no session is available", {
+                reason,
+            });
+            return;
+        }
+        const requestId = ++inFlightRequestId;
+        try {
+            const result = await config.client.exchangePreviewSession(sessionAuth);
+            if (disposed ||
+                requestId < inFlightRequestId ||
+                requestId <= latestCompletedRequestId) {
+                logEvent("debug", "preview_exchange_failed", "Discarded stale preview exchange result", {
+                    reason,
+                    requestId,
+                    inFlightRequestId,
+                    latestCompletedRequestId,
+                });
+                return;
+            }
+            latestCompletedRequestId = requestId;
+            try {
+                config.onEntry(result.entry);
+            }
+            catch (error) {
+                emitPreviewError(normalizeNoMessError(error, {
+                    kind: "runtime",
+                    code: "preview_exchange_failed",
+                    operation: "preview.onEntry",
+                    details: { reason },
+                }), origin, { reason, requestId, phase: "onEntry" });
+                return;
+            }
+            postToParent({ type: "no-mess:preview-loaded" }, origin, { reason, requestId, phase: "loaded" });
+        }
+        catch (error) {
+            if (disposed ||
+                requestId < inFlightRequestId ||
+                requestId <= latestCompletedRequestId) {
+                logEvent("debug", "preview_exchange_failed", "Discarded stale preview exchange error", {
+                    reason,
+                    requestId,
+                    inFlightRequestId,
+                    latestCompletedRequestId,
+                });
+                return;
+            }
+            latestCompletedRequestId = requestId;
+            emitPreviewError(normalizeNoMessError(error, {
+                kind: "runtime",
+                code: "preview_exchange_failed",
+                operation: "preview.exchange",
+                details: { reason },
+            }), origin, { reason, requestId, phase: "exchange" });
+        }
+    };
     const handleMessage = async (event) => {
-        if (event.origin !== config.adminOrigin)
+        if (disposed || event.origin !== config.adminOrigin)
             return;
         const data = event.data;
         if (!data || typeof data.type !== "string")
             return;
         if (data.type === "no-mess:session-auth") {
+            if (typeof data.sessionId !== "string" ||
+                typeof data.sessionSecret !== "string") {
+                emitPreviewError(createNoMessProtocolError("Received invalid preview session credentials", {
+                    kind: "protocol",
+                    code: "preview_message_invalid",
+                    operation: "preview.session-auth",
+                    details: {
+                        receivedKeys: data && typeof data === "object" ? Object.keys(data) : [],
+                    },
+                }), event.origin, { type: data.type });
+                return;
+            }
             sessionAuth = {
                 sessionId: data.sessionId,
                 sessionSecret: data.sessionSecret,
             };
-            try {
-                const result = await config.client.exchangePreviewSession(sessionAuth);
-                config.onEntry(result.entry);
-                window.parent.postMessage({ type: "no-mess:preview-loaded" }, event.origin);
-            }
-            catch (err) {
-                const error = err instanceof Error ? err : new Error(String(err));
-                config.onError?.(error);
-                window.parent.postMessage({ type: "no-mess:preview-error", error: error.message }, event.origin);
-            }
+            await runExchange("session-auth", event.origin);
+            return;
         }
-        if (data.type === "no-mess:refresh" && sessionAuth) {
-            try {
-                const result = await config.client.exchangePreviewSession(sessionAuth);
-                config.onEntry(result.entry);
-                window.parent.postMessage({ type: "no-mess:preview-loaded" }, event.origin);
-            }
-            catch (err) {
-                const error = err instanceof Error ? err : new Error(String(err));
-                config.onError?.(error);
-                window.parent.postMessage({ type: "no-mess:preview-error", error: error.message }, event.origin);
+        if (data.type === "no-mess:refresh") {
+            if (!sessionAuth) {
+                logEvent("debug", "preview_message_invalid", "Ignored preview refresh before session authentication", {
+                    type: data.type,
+                });
+                return;
             }
+            await runExchange("refresh", event.origin);
         }
     };
     return {
         start: () => {
+            disposed = false;
             window.addEventListener("message", handleMessage);
-            window.parent.postMessage({ type: "no-mess:preview-ready" }, "*");
+            postToParent({ type: "no-mess:preview-ready" }, "*", { phase: "ready" });
         },
         cleanup: () => {
+            disposed = true;
             window.removeEventListener("message", handleMessage);
         },
     };

package/dist/index.js.map

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

package/dist/live-edit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"live-edit.d.ts","sourceRoot":"","sources":["../src/live-edit.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyDjE;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CA0Q5E"}
+{"version":3,"file":"live-edit.d.ts","sourceRoot":"","sources":["../src/live-edit.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAyFjE;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,cAAc,CA+Y5E"}

package/dist/live-edit.js

@@ -1,3 +1,5 @@
+import { normalizeNoMessError } from "./error-utils.js";
+import { createSdkLogger } from "./logging.js";
 const OVERLAY_CONTAINER_ID = "no-mess-live-edit-overlays";
 const OVERLAY_ATTR = "data-no-mess-overlay-for";
 const FIELD_ATTR = "data-no-mess-field";
@@ -45,6 +47,22 @@ const OVERLAY_CSS = `
   background: oklch(0.546 0.245 262.9);
 }
 `;
+function serializeRect(rect) {
+    const rectWithJson = rect;
+    if (typeof rectWithJson.toJSON === "function") {
+        return rectWithJson.toJSON();
+    }
+    return {
+        x: rect.x,
+        y: rect.y,
+        width: rect.width,
+        height: rect.height,
+        top: rect.top,
+        right: rect.right,
+        bottom: rect.bottom,
+        left: rect.left,
+    };
+}
 /**
  * Create a live edit handler that manages overlay highlights on annotated DOM
  * elements and communicates with the admin dashboard via postMessage.
@@ -58,6 +76,7 @@ const OVERLAY_CSS = `
  * ```
  */
 export function createLiveEditHandler(config) {
+    const logger = createSdkLogger(config.logger);
     let active = false;
     let container = null;
     let styleEl = null;
@@ -66,6 +85,55 @@ export function createLiveEditHandler(config) {
     let mutationObserver = null;
     let scrollListener = null;
     let rafId = null;
+    const emitLog = (level, message, context, error) => {
+        logger({
+            level,
+            code: "live_edit_runtime_failed",
+            message,
+            scope: "live-edit",
+            operation: "createLiveEditHandler",
+            error: error instanceof Error ? error : undefined,
+            timestamp: new Date().toISOString(),
+            context,
+        });
+    };
+    const reportRuntimeError = (error, context, message = "Live edit runtime failure") => {
+        const normalized = normalizeNoMessError(error, {
+            kind: "runtime",
+            code: "live_edit_runtime_failed",
+            operation: "live-edit",
+            details: context,
+        });
+        try {
+            config.onError?.(normalized);
+        }
+        catch (callbackError) {
+            emitLog("error", "Live edit onError callback threw unexpectedly", context, normalizeNoMessError(callbackError, {
+                kind: "runtime",
+                code: "live_edit_runtime_failed",
+                operation: "live-edit.onError",
+            }));
+        }
+        emitLog("error", message, context, normalized);
+    };
+    const safeInvoke = (callback, context, message) => {
+        if (!callback)
+            return;
+        try {
+            callback();
+        }
+        catch (error) {
+            reportRuntimeError(error, context, message);
+        }
+    };
+    const safePostMessage = (message, context) => {
+        try {
+            window.parent.postMessage(message, config.adminOrigin);
+        }
+        catch (error) {
+            reportRuntimeError(error, context, "Failed to post live edit message");
+        }
+    };
     function injectStyles() {
         if (document.getElementById("no-mess-live-edit-styles"))
             return;
@@ -113,105 +181,151 @@ export function createLiveEditHandler(config) {
             return;
         rafId = requestAnimationFrame(() => {
             rafId = null;
-            updateAllPositions();
+            try {
+                updateAllPositions();
+            }
+            catch (error) {
+                reportRuntimeError(error, { phase: "updateAllPositions" });
+            }
         });
     }
     function buildOverlays() {
-        // Clear existing overlays
-        for (const entry of overlays) {
-            entry.overlay.remove();
-        }
-        overlays = [];
-        if (!container)
-            return;
-        const fieldElements = getFieldElements();
-        const fieldRects = [];
-        for (const [fieldName, elements] of fieldElements) {
-            for (const element of elements) {
-                const overlay = document.createElement("div");
-                overlay.className = "no-mess-overlay";
-                overlay.setAttribute(OVERLAY_ATTR, fieldName);
-                const label = document.createElement("span");
-                label.className = "no-mess-overlay-label";
-                label.textContent = fieldName;
-                overlay.appendChild(label);
-                positionOverlay(overlay, element);
-                overlay.addEventListener("click", () => {
-                    window.parent.postMessage({ type: "no-mess:field-clicked", fieldName }, config.adminOrigin);
-                    config.onFieldClicked?.(fieldName);
-                });
-                container.appendChild(overlay);
-                overlays.push({ element, overlay, fieldName });
-                const rect = element.getBoundingClientRect();
-                fieldRects.push({ fieldName, rect: rect.toJSON() });
-                // Observe element for size changes
-                resizeObserver?.observe(element);
+        try {
+            for (const entry of overlays) {
+                entry.overlay.remove();
+            }
+            overlays = [];
+            if (!container)
+                return;
+            const fieldElements = getFieldElements();
+            const fieldRects = [];
+            for (const [fieldName, elements] of fieldElements) {
+                for (const element of elements) {
+                    const overlay = document.createElement("div");
+                    overlay.className = "no-mess-overlay";
+                    overlay.setAttribute(OVERLAY_ATTR, fieldName);
+                    const label = document.createElement("span");
+                    label.className = "no-mess-overlay-label";
+                    label.textContent = fieldName;
+                    overlay.appendChild(label);
+                    positionOverlay(overlay, element);
+                    overlay.addEventListener("click", () => {
+                        safePostMessage({ type: "no-mess:field-clicked", fieldName }, { phase: "field-clicked", fieldName });
+                        try {
+                            config.onFieldClicked?.(fieldName);
+                        }
+                        catch (error) {
+                            reportRuntimeError(error, { phase: "field-clicked", fieldName });
+                        }
+                    });
+                    container.appendChild(overlay);
+                    overlays.push({ element, overlay, fieldName });
+                    const rect = element.getBoundingClientRect();
+                    fieldRects.push({ fieldName, rect: serializeRect(rect) });
+                    resizeObserver?.observe(element);
+                }
             }
+            const uniqueFields = [...new Set(fieldRects.map((field) => field.fieldName))];
+            safePostMessage({
+                type: "no-mess:field-map",
+                fields: uniqueFields.map((fieldName) => {
+                    const match = fieldRects.find((field) => field.fieldName === fieldName);
+                    return { fieldName, rect: match?.rect };
+                }),
+            }, { phase: "field-map", count: uniqueFields.length });
+        }
+        catch (error) {
+            reportRuntimeError(error, { phase: "buildOverlays" }, "Failed to build live edit overlays");
         }
-        // Send field map to admin
-        const uniqueFields = [...new Set(fieldRects.map((f) => f.fieldName))];
-        window.parent.postMessage({
-            type: "no-mess:field-map",
-            fields: uniqueFields.map((fieldName) => {
-                const match = fieldRects.find((f) => f.fieldName === fieldName);
-                return { fieldName, rect: match?.rect };
-            }),
-        }, config.adminOrigin);
     }
     function enterLiveEdit() {
         if (active)
             return;
         active = true;
-        injectStyles();
-        createContainer();
-        resizeObserver = new ResizeObserver(() => {
-            schedulePositionUpdate();
-        });
-        buildOverlays();
-        // Track scroll for repositioning
-        scrollListener = () => schedulePositionUpdate();
-        window.addEventListener("scroll", scrollListener, { passive: true });
-        window.addEventListener("resize", scrollListener, { passive: true });
-        // Track DOM mutations for SPA navigation
-        mutationObserver = new MutationObserver(() => {
-            // Debounce rescan slightly for batch mutations
-            setTimeout(() => {
-                if (active)
-                    buildOverlays();
-            }, 100);
-        });
-        mutationObserver.observe(document.body, {
-            childList: true,
-            subtree: true,
-        });
-        config.onEnter?.();
+        try {
+            injectStyles();
+            createContainer();
+            if (typeof ResizeObserver !== "undefined") {
+                resizeObserver = new ResizeObserver(() => {
+                    try {
+                        schedulePositionUpdate();
+                    }
+                    catch (error) {
+                        reportRuntimeError(error, { phase: "resizeObserver" });
+                    }
+                });
+            }
+            else {
+                emitLog("warn", "ResizeObserver is not available; live edit overlays will fall back to scroll/resize updates only", {
+                    feature: "ResizeObserver",
+                });
+            }
+            buildOverlays();
+            scrollListener = () => {
+                try {
+                    schedulePositionUpdate();
+                }
+                catch (error) {
+                    reportRuntimeError(error, { phase: "scrollListener" });
+                }
+            };
+            window.addEventListener("scroll", scrollListener, { passive: true });
+            window.addEventListener("resize", scrollListener, { passive: true });
+            if (typeof MutationObserver !== "undefined") {
+                mutationObserver = new MutationObserver(() => {
+                    setTimeout(() => {
+                        if (!active)
+                            return;
+                        buildOverlays();
+                    }, 100);
+                });
+                mutationObserver.observe(document.body, {
+                    childList: true,
+                    subtree: true,
+                });
+            }
+            else {
+                emitLog("warn", "MutationObserver is not available; live edit overlays will not auto-refresh for DOM changes", {
+                    feature: "MutationObserver",
+                });
+            }
+            safeInvoke(config.onEnter, { phase: "enter" }, "Live edit onEnter callback threw unexpectedly");
+        }
+        catch (error) {
+            reportRuntimeError(error, { phase: "enterLiveEdit" });
+        }
     }
     function exitLiveEdit() {
         if (!active)
             return;
         active = false;
-        if (rafId !== null) {
-            cancelAnimationFrame(rafId);
-            rafId = null;
+        try {
+            if (rafId !== null) {
+                cancelAnimationFrame(rafId);
+                rafId = null;
+            }
+            resizeObserver?.disconnect();
+            resizeObserver = null;
+            mutationObserver?.disconnect();
+            mutationObserver = null;
+            if (scrollListener) {
+                window.removeEventListener("scroll", scrollListener);
+                window.removeEventListener("resize", scrollListener);
+                scrollListener = null;
+            }
+            for (const entry of overlays) {
+                entry.overlay.remove();
+            }
+            overlays = [];
+            container?.remove();
+            container = null;
+            styleEl?.remove();
+            styleEl = null;
+            safeInvoke(config.onExit, { phase: "exit" }, "Live edit onExit callback threw unexpectedly");
         }
-        resizeObserver?.disconnect();
-        resizeObserver = null;
-        mutationObserver?.disconnect();
-        mutationObserver = null;
-        if (scrollListener) {
-            window.removeEventListener("scroll", scrollListener);
-            window.removeEventListener("resize", scrollListener);
-            scrollListener = null;
+        catch (error) {
+            reportRuntimeError(error, { phase: "exitLiveEdit" });
         }
-        for (const entry of overlays) {
-            entry.overlay.remove();
-        }
-        overlays = [];
-        container?.remove();
-        container = null;
-        styleEl?.remove();
-        styleEl = null;
-        config.onExit?.();
     }
     function handleFieldUpdate(fieldName, value) {
         const elements = document.querySelectorAll(`[${FIELD_ATTR}="${fieldName}"]`);
@@ -252,31 +366,56 @@ export function createLiveEditHandler(config) {
         const data = event.data;
         if (!data || typeof data.type !== "string")
             return;
-        switch (data.type) {
-            case "no-mess:live-edit-enter":
-                enterLiveEdit();
-                break;
-            case "no-mess:live-edit-exit":
-                exitLiveEdit();
-                break;
-            case "no-mess:field-updated":
-                if (data.fieldName && active) {
+        try {
+            switch (data.type) {
+                case "no-mess:live-edit-enter":
+                    enterLiveEdit();
+                    break;
+                case "no-mess:live-edit-exit":
+                    exitLiveEdit();
+                    break;
+                case "no-mess:field-updated":
+                    if (!active)
+                        break;
+                    if (typeof data.fieldName !== "string") {
+                        emitLog("debug", "Ignored malformed live edit field update message", {
+                            type: data.type,
+                        });
+                        break;
+                    }
                     handleFieldUpdate(data.fieldName, data.value);
-                }
-                break;
-            case "no-mess:field-focus":
-                if (data.fieldName && active) {
+                    break;
+                case "no-mess:field-focus":
+                    if (!active)
+                        break;
+                    if (typeof data.fieldName !== "string") {
+                        emitLog("debug", "Ignored malformed live edit focus message", {
+                            type: data.type,
+                        });
+                        break;
+                    }
                     handleFieldFocus(data.fieldName);
-                }
-                break;
-            case "no-mess:field-blur":
-                if (data.fieldName && active) {
+                    break;
+                case "no-mess:field-blur":
+                    if (!active)
+                        break;
+                    if (typeof data.fieldName !== "string") {
+                        emitLog("debug", "Ignored malformed live edit blur message", {
+                            type: data.type,
+                        });
+                        break;
+                    }
                     handleFieldBlur(data.fieldName);
-                }
-                break;
+                    break;
+            }
+        }
+        catch (error) {
+            reportRuntimeError(error, {
+                phase: "handleMessage",
+                type: data.type,
+            });
         }
     }
-    // Start listening immediately
     window.addEventListener("message", handleMessage);
     return {
         cleanup: () => {