@no-mess/client 0.2.0 → 0.4.0

package/dist/react/no-mess-provider.d.ts

@@ -0,0 +1,21 @@
+import type { NoMessContextValue, NoMessEntry, NoMessLiveRouteProviderProps, NoMessProviderProps, UseNoMessEditableEntryOptions } from "../types.js";
+/**
+ * Provider for route-aware preview and live edit on real site routes.
+ * Keeps the legacy preview-only APIs available while adding route reporting
+ * and entry binding for live edit on delivered pages.
+ */
+export declare function NoMessLiveRouteProvider({ children, liveEditConfig, ...previewConfig }: NoMessLiveRouteProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Backward-compatible alias for the route-aware provider.
+ */
+export declare function NoMessProvider(props: NoMessProviderProps): import("react/jsx-runtime").JSX.Element;
+/** Access the current no-mess provider context. */
+export declare function useNoMess(): NoMessContextValue | null;
+/** Read a single live field override from provider context. */
+export declare function useNoMessField<T = unknown>(fieldName: string): T | undefined;
+/**
+ * Returns the entry visible on the current route, switching to preview/draft
+ * content when the active iframe session targets this entry.
+ */
+export declare function useNoMessEditableEntry<T extends NoMessEntry>(entry: T, options?: UseNoMessEditableEntryOptions): T;
+//# sourceMappingURL=no-mess-provider.d.ts.map

package/dist/react/no-mess-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-mess-provider.d.ts","sourceRoot":"","sources":["../../src/react/no-mess-provider.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EACV,kBAAkB,EAClB,WAAW,EACX,4BAA4B,EAC5B,mBAAmB,EAEnB,6BAA6B,EAG9B,MAAM,aAAa,CAAC;AAwErB;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,cAAc,EACd,GAAG,aAAa,EACjB,EAAE,4BAA4B,2CAuK9B;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,mBAAmB,2CAExD;AAED,mDAAmD;AACnD,wBAAgB,SAAS,8BAExB;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,MAAM,iBAI5D;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,WAAW,EAC1D,KAAK,EAAE,CAAC,EACR,OAAO,CAAC,EAAE,6BAA6B,KA4DxC"}

package/dist/react/no-mess-provider.js

@@ -0,0 +1,286 @@
+"use client";
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext, useEffect, useMemo, useRef, useState, } from "react";
+import { NoMessClient } from "../client.js";
+import { normalizeNoMessError } from "../error-utils.js";
+import { createPreviewHandler } from "../index.js";
+import { createLiveEditHandler } from "../live-edit.js";
+import { DEFAULT_ADMIN_ORIGIN } from "../types.js";
+const REPORTED_ROUTE_CACHE_PREFIX = "no-mess:reported-route";
+const REPORTED_ROUTE_TTL_MS = 24 * 60 * 60 * 1000;
+const TRANSIENT_PARAMS = ["preview", "secret", "sid", "slug", "type"];
+const NoMessContext = createContext(null);
+function sortSearchParams(url) {
+    const entries = [...url.searchParams.entries()].sort(([a], [b]) => a.localeCompare(b));
+    url.search = "";
+    for (const [key, value] of entries) {
+        url.searchParams.append(key, value);
+    }
+}
+function normalizeRouteUrl(url) {
+    const normalized = new URL(url, window.location.href);
+    for (const param of TRANSIENT_PARAMS) {
+        normalized.searchParams.delete(param);
+    }
+    sortSearchParams(normalized);
+    return normalized.toString();
+}
+function createReportedRouteCacheKey(entryId, url) {
+    return `${REPORTED_ROUTE_CACHE_PREFIX}:${entryId}:${url}`;
+}
+function shouldReportRoute(entryId, url) {
+    if (typeof localStorage === "undefined") {
+        return true;
+    }
+    const key = createReportedRouteCacheKey(entryId, url);
+    const lastReportedAt = Number(localStorage.getItem(key) ?? "0");
+    return (!lastReportedAt || Date.now() - lastReportedAt >= REPORTED_ROUTE_TTL_MS);
+}
+function markRouteReported(entryId, url) {
+    if (typeof localStorage === "undefined") {
+        return;
+    }
+    const key = createReportedRouteCacheKey(entryId, url);
+    localStorage.setItem(key, String(Date.now()));
+}
+function defaultPreviewState() {
+    return {
+        entry: null,
+        error: null,
+        errorDetails: null,
+        isLoading: true,
+        status: "waiting-for-admin",
+    };
+}
+function defaultLiveEditState() {
+    return {
+        isLiveEditActive: false,
+        fieldOverrides: {},
+        error: null,
+        errorDetails: null,
+    };
+}
+/**
+ * Provider for route-aware preview and live edit on real site routes.
+ * Keeps the legacy preview-only APIs available while adding route reporting
+ * and entry binding for live edit on delivered pages.
+ */
+export function NoMessLiveRouteProvider({ children, liveEditConfig, ...previewConfig }) {
+    const [isIframe, setIsIframe] = useState(false);
+    const [preview, setPreview] = useState(defaultPreviewState);
+    const [liveEdit, setLiveEdit] = useState(defaultLiveEditState);
+    const adminOrigin = liveEditConfig?.adminOrigin ??
+        previewConfig.adminOrigin ??
+        DEFAULT_ADMIN_ORIGIN;
+    const client = useMemo(() => new NoMessClient({
+        apiKey: previewConfig.apiKey,
+        apiUrl: previewConfig.apiUrl,
+        logger: previewConfig.logger,
+    }), [previewConfig.apiKey, previewConfig.apiUrl, previewConfig.logger]);
+    useEffect(() => {
+        const iframe = window.self !== window.top;
+        setIsIframe(iframe);
+        if (!iframe) {
+            setPreview({
+                entry: null,
+                error: null,
+                errorDetails: null,
+                isLoading: false,
+                status: "ready",
+            });
+            return;
+        }
+        const previewHandler = createPreviewHandler({
+            client: {
+                exchangePreviewSession: async (...args) => {
+                    setPreview((current) => ({
+                        ...current,
+                        isLoading: true,
+                        status: "exchanging-session",
+                    }));
+                    return client.exchangePreviewSession(...args);
+                },
+            },
+            adminOrigin,
+            logger: previewConfig.logger,
+            onEntry: (entry) => {
+                setPreview({
+                    entry,
+                    error: null,
+                    errorDetails: null,
+                    isLoading: false,
+                    status: "ready",
+                });
+            },
+            onError: (error) => {
+                const normalized = normalizeNoMessError(error, {
+                    kind: "runtime",
+                    code: "preview_exchange_failed",
+                    operation: "NoMessLiveRouteProvider.onPreviewError",
+                });
+                setPreview({
+                    entry: null,
+                    error: normalized,
+                    errorDetails: normalized,
+                    isLoading: false,
+                    status: "error",
+                });
+            },
+        });
+        const liveEditHandler = createLiveEditHandler({
+            adminOrigin,
+            logger: liveEditConfig?.logger ?? previewConfig.logger,
+            onEnter: () => {
+                setLiveEdit({
+                    isLiveEditActive: true,
+                    fieldOverrides: {},
+                    error: null,
+                    errorDetails: null,
+                });
+            },
+            onExit: () => {
+                setLiveEdit({
+                    isLiveEditActive: false,
+                    fieldOverrides: {},
+                    error: null,
+                    errorDetails: null,
+                });
+            },
+            onError: (error) => {
+                const normalized = normalizeNoMessError(error, {
+                    kind: "runtime",
+                    code: "live_edit_runtime_failed",
+                    operation: "NoMessLiveRouteProvider.onLiveEditError",
+                });
+                setLiveEdit((current) => ({
+                    ...current,
+                    error: normalized,
+                    errorDetails: normalized,
+                }));
+            },
+        });
+        const handleMessage = (event) => {
+            if (event.origin !== adminOrigin)
+                return;
+            const data = event.data;
+            if (!data || typeof data.type !== "string")
+                return;
+            if (data.type === "no-mess:field-updated" &&
+                typeof data.fieldName === "string") {
+                setLiveEdit((current) => ({
+                    ...current,
+                    fieldOverrides: {
+                        ...current.fieldOverrides,
+                        [data.fieldName]: data.value,
+                    },
+                }));
+            }
+        };
+        previewHandler.start();
+        window.addEventListener("message", handleMessage);
+        return () => {
+            previewHandler.cleanup();
+            liveEditHandler.cleanup();
+            window.removeEventListener("message", handleMessage);
+        };
+    }, [adminOrigin, client, liveEditConfig?.logger, previewConfig.logger]);
+    const value = useMemo(() => ({
+        adminOrigin,
+        apiKey: previewConfig.apiKey,
+        apiUrl: previewConfig.apiUrl,
+        bindEntry: (entryId) => {
+            if (!isIframe)
+                return;
+            window.parent.postMessage({ type: "no-mess:entry-bound", entryId }, adminOrigin);
+        },
+        client,
+        isIframe,
+        preview,
+        liveEdit,
+    }), [
+        adminOrigin,
+        client,
+        isIframe,
+        liveEdit,
+        preview,
+        previewConfig.apiKey,
+        previewConfig.apiUrl,
+    ]);
+    return _jsx(NoMessContext, { value: value, children: children });
+}
+/**
+ * Backward-compatible alias for the route-aware provider.
+ */
+export function NoMessProvider(props) {
+    return _jsx(NoMessLiveRouteProvider, { ...props });
+}
+/** Access the current no-mess provider context. */
+export function useNoMess() {
+    return useContext(NoMessContext);
+}
+/** Read a single live field override from provider context. */
+export function useNoMessField(fieldName) {
+    const ctx = useContext(NoMessContext);
+    if (!ctx)
+        return undefined;
+    return ctx.liveEdit.fieldOverrides[fieldName];
+}
+/**
+ * Returns the entry visible on the current route, switching to preview/draft
+ * content when the active iframe session targets this entry.
+ */
+export function useNoMessEditableEntry(entry, options) {
+    const ctx = useContext(NoMessContext);
+    const lastBoundEntryId = useRef(null);
+    const registerCurrentUrl = options?.registerCurrentUrl ?? true;
+    useEffect(() => {
+        if (!ctx || !registerCurrentUrl)
+            return;
+        if (typeof window === "undefined")
+            return;
+        let normalizedUrl;
+        try {
+            normalizedUrl = normalizeRouteUrl(options?.url ?? window.location.href);
+        }
+        catch {
+            return;
+        }
+        if (!shouldReportRoute(entry._id, normalizedUrl)) {
+            return;
+        }
+        let cancelled = false;
+        const reportOptions = {
+            entryId: entry._id,
+            url: normalizedUrl,
+        };
+        void ctx.client
+            .reportLiveEditRoute(reportOptions)
+            .then(() => {
+            if (!cancelled) {
+                markRouteReported(entry._id, normalizedUrl);
+            }
+        })
+            .catch(() => { });
+        return () => {
+            cancelled = true;
+        };
+    }, [ctx, entry._id, options?.url, registerCurrentUrl]);
+    const matchesPreviewEntry = ctx?.preview.entry?._id === entry._id;
+    useEffect(() => {
+        if (!ctx || !ctx.isIframe || !matchesPreviewEntry)
+            return;
+        if (lastBoundEntryId.current === entry._id)
+            return;
+        ctx.bindEntry(entry._id);
+        lastBoundEntryId.current = entry._id;
+    }, [ctx, entry._id, matchesPreviewEntry]);
+    if (!ctx || !matchesPreviewEntry) {
+        return entry;
+    }
+    return {
+        ...entry,
+        ...ctx.preview.entry,
+        ...ctx.liveEdit.fieldOverrides,
+    };
+}
+//# sourceMappingURL=no-mess-provider.js.map

package/dist/react/no-mess-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"no-mess-provider.js","sourceRoot":"","sources":["../../src/react/no-mess-provider.tsx"],"names":[],"mappings":"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"}

package/dist/react/use-no-mess-live-edit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-no-mess-live-edit.d.ts","sourceRoot":"","sources":["../../src/react/use-no-mess-live-edit.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAGrB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,uBAAuB,GAC9B,uBAAuB,CAiDzB"}
+{"version":3,"file":"use-no-mess-live-edit.d.ts","sourceRoot":"","sources":["../../src/react/use-no-mess-live-edit.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAEV,uBAAuB,EACvB,uBAAuB,EACxB,MAAM,aAAa,CAAC;AAGrB;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,uBAAuB,GAC9B,uBAAuB,CA8EzB"}

package/dist/react/use-no-mess-live-edit.js

@@ -1,5 +1,7 @@
 "use client";
 import { useCallback, useEffect, useRef, useState } from "react";
+import { normalizeNoMessError } from "../error-utils.js";
+import { createSdkLogger } from "../logging.js";
 import { createLiveEditHandler } from "../live-edit.js";
 import { DEFAULT_ADMIN_ORIGIN } from "../types.js";
 /**
@@ -19,8 +21,12 @@ import { DEFAULT_ADMIN_ORIGIN } from "../types.js";
 export function useNoMessLiveEdit(config) {
     const [isLiveEditActive, setIsLiveEditActive] = useState(false);
     const [fieldOverrides, setFieldOverrides] = useState({});
+    const [error, setError] = useState(null);
+    const [errorDetails, setErrorDetails] = useState(null);
     const configRef = useRef(config);
     configRef.current = config;
+    const loggerRef = useRef(createSdkLogger(config.logger));
+    loggerRef.current = createSdkLogger(config.logger);
     const handleFieldUpdate = useCallback((event) => {
         const origin = configRef.current.adminOrigin ?? DEFAULT_ADMIN_ORIGIN;
         if (event.origin !== origin)
@@ -28,25 +34,49 @@ export function useNoMessLiveEdit(config) {
         const data = event.data;
         if (!data || typeof data.type !== "string")
             return;
-        if (data.type === "no-mess:field-updated" && data.fieldName) {
+        if (data.type === "no-mess:field-updated" && typeof data.fieldName === "string") {
             setFieldOverrides((prev) => ({
                 ...prev,
                 [data.fieldName]: data.value,
             }));
+            return;
+        }
+        if (data.type === "no-mess:field-updated") {
+            loggerRef.current({
+                level: "debug",
+                code: "live_edit_runtime_failed",
+                message: "Ignored malformed live edit field update message in React state bridge",
+                scope: "live-edit-react",
+                operation: "useNoMessLiveEdit.handleFieldUpdate",
+                timestamp: new Date().toISOString(),
+                context: {},
+            });
         }
     }, []);
     useEffect(() => {
         const adminOrigin = configRef.current.adminOrigin ?? DEFAULT_ADMIN_ORIGIN;
         const handle = createLiveEditHandler({
             adminOrigin,
+            logger: configRef.current.logger,
             onEnter: () => {
                 setIsLiveEditActive(true);
                 setFieldOverrides({});
+                setError(null);
+                setErrorDetails(null);
             },
             onExit: () => {
                 setIsLiveEditActive(false);
                 setFieldOverrides({});
             },
+            onError: (err) => {
+                const normalized = normalizeNoMessError(err, {
+                    kind: "runtime",
+                    code: "live_edit_runtime_failed",
+                    operation: "useNoMessLiveEdit.onError",
+                });
+                setError(normalized);
+                setErrorDetails(normalized);
+            },
         });
         // Also listen for field-updated to track overrides in React state
         window.addEventListener("message", handleFieldUpdate);
@@ -55,6 +85,6 @@ export function useNoMessLiveEdit(config) {
             window.removeEventListener("message", handleFieldUpdate);
         };
     }, [handleFieldUpdate]);
-    return { isLiveEditActive, fieldOverrides };
+    return { isLiveEditActive, fieldOverrides, error, errorDetails };
 }
 //# sourceMappingURL=use-no-mess-live-edit.js.map

package/dist/react/use-no-mess-live-edit.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-no-mess-live-edit.js","sourceRoot":"","sources":["../../src/react/use-no-mess-live-edit.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAKxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAC/B,MAA+B;IAE/B,MAAM,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;IAChE,MAAM,CAAC,cAAc,EAAE,iBAAiB,CAAC,GAAG,QAAQ,CAClD,EAAE,CACH,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAE3B,MAAM,iBAAiB,GAAG,WAAW,CAAC,CAAC,KAAmB,EAAE,EAAE;QAC5D,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;QACrE,IAAI,KAAK,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO;QAEpC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO;QAEnD,IAAI,IAAI,CAAC,IAAI,KAAK,uBAAuB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YAC5D,iBAAiB,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBAC3B,GAAG,IAAI;gBACP,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,KAAK;aAC7B,CAAC,CAAC,CAAC;QACN,CAAC;IACH,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,WAAW,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,IAAI,oBAAoB,CAAC;QAE1E,MAAM,MAAM,GAAG,qBAAqB,CAAC;YACnC,WAAW;YACX,OAAO,EAAE,GAAG,EAAE;gBACZ,mBAAmB,CAAC,IAAI,CAAC,CAAC;gBAC1B,iBAAiB,CAAC,EAAE,CAAC,CAAC;YACxB,CAAC;YACD,MAAM,EAAE,GAAG,EAAE;gBACX,mBAAmB,CAAC,KAAK,CAAC,CAAC;gBAC3B,iBAAiB,CAAC,EAAE,CAAC,CAAC;YACxB,CAAC;SACF,CAAC,CAAC;QAEH,kEAAkE;QAClE,MAAM,CAAC,gBAAgB,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QAEtD,OAAO,GAAG,EAAE;YACV,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QAC3D,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAExB,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"use-no-mess-live-edit.js","sourceRoot":"","sources":["../../src/react/use-no-mess-live-edit.ts"],"names":[],"mappings":"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"}

package/dist/react/use-no-mess-preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-no-mess-preview.d.ts","sourceRoot":"","sources":["../../src/react/use-no-mess-preview.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,WAAW,EACX,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAGrB,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAClE,MAAM,EAAE,sBAAsB,GAC7B,sBAAsB,CAAC,CAAC,CAAC,CAiC3B"}
+{"version":3,"file":"use-no-mess-preview.d.ts","sourceRoot":"","sources":["../../src/react/use-no-mess-preview.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,WAAW,EAEX,sBAAsB,EACtB,sBAAsB,EACvB,MAAM,aAAa,CAAC;AAGrB,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAClE,MAAM,EAAE,sBAAsB,GAC7B,sBAAsB,CAAC,CAAC,CAAC,CA0D3B"}

package/dist/react/use-no-mess-preview.js

@@ -1,35 +1,58 @@
 "use client";
 import { useEffect, useRef, useState } from "react";
 import { NoMessClient } from "../client.js";
+import { normalizeNoMessError } from "../error-utils.js";
 import { createPreviewHandler } from "../index.js";
 import { DEFAULT_ADMIN_ORIGIN } from "../types.js";
 export function useNoMessPreview(config) {
     const [entry, setEntry] = useState(null);
     const [error, setError] = useState(null);
-    const [isLoading, setIsLoading] = useState(true);
+    const [errorDetails, setErrorDetails] = useState(null);
+    const [status, setStatus] = useState("waiting-for-admin");
     const configRef = useRef(config);
     configRef.current = config;
     useEffect(() => {
-        const client = new NoMessClient({
+        const baseClient = new NoMessClient({
             apiKey: configRef.current.apiKey,
             apiUrl: configRef.current.apiUrl,
+            logger: configRef.current.logger,
         });
+        const client = {
+            exchangePreviewSession: async (...args) => {
+                setStatus("exchanging-session");
+                return baseClient.exchangePreviewSession(...args);
+            },
+        };
         const handler = createPreviewHandler({
             client,
             adminOrigin: configRef.current.adminOrigin ?? DEFAULT_ADMIN_ORIGIN,
+            logger: configRef.current.logger,
             onEntry: (e) => {
                 setEntry(e);
                 setError(null);
-                setIsLoading(false);
+                setErrorDetails(null);
+                setStatus("ready");
             },
             onError: (err) => {
-                setError(err);
-                setIsLoading(false);
+                const normalized = normalizeNoMessError(err, {
+                    kind: "runtime",
+                    code: "preview_exchange_failed",
+                    operation: "useNoMessPreview.onError",
+                });
+                setError(normalized);
+                setErrorDetails(normalized);
+                setStatus("error");
             },
         });
         handler.start();
         return () => handler.cleanup();
     }, []);
-    return { entry, error, isLoading };
+    return {
+        entry,
+        error,
+        errorDetails,
+        isLoading: status !== "ready" && status !== "error",
+        status,
+    };
 }
 //# sourceMappingURL=use-no-mess-preview.js.map

package/dist/react/use-no-mess-preview.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-no-mess-preview.js","sourceRoot":"","sources":["../../src/react/use-no-mess-preview.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAMnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,UAAU,gBAAgB,CAC9B,MAA8B;IAE9B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAW,IAAI,CAAC,CAAC;IACnD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEjD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAE3B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC;YAC9B,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM;YAChC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM;SACjC,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,oBAAoB,CAAC;YACnC,MAAM;YACN,WAAW,EAAE,SAAS,CAAC,OAAO,CAAC,WAAW,IAAI,oBAAoB;YAClE,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBACb,QAAQ,CAAC,CAAM,CAAC,CAAC;gBACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACf,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YACD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,QAAQ,CAAC,GAAG,CAAC,CAAC;gBACd,YAAY,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACrC,CAAC"}
+{"version":3,"file":"use-no-mess-preview.js","sourceRoot":"","sources":["../../src/react/use-no-mess-preview.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAOnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAEnD,MAAM,UAAU,gBAAgB,CAC9B,MAA8B;IAE9B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAW,IAAI,CAAC,CAAC;IACnD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IACvD,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IAC3E,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAClC,mBAAmB,CACpB,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,OAAO,GAAG,MAAM,CAAC;IAE3B,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,UAAU,GAAG,IAAI,YAAY,CAAC;YAClC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM;YAChC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM;YAChC,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM;SACjC,CAAC,CAAC;QAEH,MAAM,MAAM,GAAG;YACb,sBAAsB,EAAE,KAAK,EAAE,GAAG,IAAwD,EAAE,EAAE;gBAC5F,SAAS,CAAC,oBAAoB,CAAC,CAAC;gBAChC,OAAO,UAAU,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC,CAAC;YACpD,CAAC;SACF,CAAC;QAEF,MAAM,OAAO,GAAG,oBAAoB,CAAC;YACnC,MAAM;YACN,WAAW,EAAE,SAAS,CAAC,OAAO,CAAC,WAAW,IAAI,oBAAoB;YAClE,MAAM,EAAE,SAAS,CAAC,OAAO,CAAC,MAAM;YAChC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE;gBACb,QAAQ,CAAC,CAAM,CAAC,CAAC;gBACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACf,eAAe,CAAC,IAAI,CAAC,CAAC;gBACtB,SAAS,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;YACD,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,MAAM,UAAU,GAAG,oBAAoB,CAAC,GAAG,EAAE;oBAC3C,IAAI,EAAE,SAAS;oBACf,IAAI,EAAE,yBAAyB;oBAC/B,SAAS,EAAE,0BAA0B;iBACtC,CAAC,CAAC;gBACH,QAAQ,CAAC,UAAU,CAAC,CAAC;gBACrB,eAAe,CAAC,UAAU,CAAC,CAAC;gBAC5B,SAAS,CAAC,OAAO,CAAC,CAAC;YACrB,CAAC;SACF,CAAC,CAAC;QAEH,OAAO,CAAC,KAAK,EAAE,CAAC;QAChB,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IACjC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO;QACL,KAAK;QACL,KAAK;QACL,YAAY;QACZ,SAAS,EAAE,MAAM,KAAK,OAAO,IAAI,MAAM,KAAK,OAAO;QACnD,MAAM;KACP,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -1,5 +1,31 @@
-export declare const DEFAULT_API_URL = "https://api.no-mess.xyz";
+export declare const DEFAULT_API_URL = "https://api.nomess.xyz";
 export declare const DEFAULT_ADMIN_ORIGIN = "https://admin.no-mess.xyz";
+export type NoMessErrorKind = "config" | "network" | "http" | "response" | "crypto" | "protocol" | "runtime";
+export type NoMessErrorCode = "secret_key_in_browser" | "request_failed" | "http_error" | "invalid_success_response" | "invalid_error_response" | "crypto_unavailable" | "invalid_session_secret" | "preview_message_invalid" | "preview_exchange_failed" | "preview_postmessage_failed" | "live_edit_runtime_failed";
+export type NoMessLogLevel = "debug" | "info" | "warn" | "error";
+export interface NoMessLogEvent {
+    level: NoMessLogLevel;
+    code: NoMessErrorCode;
+    message: string;
+    scope: string;
+    operation?: string;
+    error?: NoMessError;
+    timestamp: string;
+    context: Record<string, unknown>;
+}
+export type NoMessLogger = (event: NoMessLogEvent) => void;
+export interface NoMessErrorOptions {
+    kind?: NoMessErrorKind;
+    code?: NoMessErrorCode;
+    status?: number;
+    retryable?: boolean;
+    operation?: string;
+    method?: string;
+    url?: string;
+    requestId?: string;
+    details?: Record<string, unknown>;
+    cause?: unknown;
+}
 export interface NoMessClientConfig {
     apiUrl?: string;
     /**
@@ -10,6 +36,7 @@ export interface NoMessClientConfig {
      * - **Publishable key**: Safe for client-side use. Read-only access to published content.
      */
     apiKey: string;
+    logger?: NoMessLogger;
 }
 /** Returns true if the key is a publishable key (nm_pub_ prefix). */
 export declare function isPublishableKey(key: string): boolean;
@@ -66,6 +93,11 @@ export interface PreviewSessionAuth {
     sessionId: string;
     sessionSecret: string;
 }
+/** Report a delivery URL for route-aware Live Edit. */
+export interface ReportLiveEditRouteOptions {
+    entryId: string;
+    url?: string;
+}
 export interface PreviewExchangeResult {
     entry: NoMessEntry;
     sessionId: string;
@@ -78,16 +110,21 @@ export interface PreviewHandlerConfig {
     adminOrigin: string;
     onEntry: (entry: NoMessEntry) => void;
     onError?: (error: Error) => void;
+    logger?: NoMessLogger;
 }
 export interface UseNoMessPreviewConfig {
     apiKey: string;
     apiUrl?: string;
     adminOrigin?: string;
+    logger?: NoMessLogger;
 }
+export type UseNoMessPreviewStatus = "waiting-for-admin" | "exchanging-session" | "ready" | "error";
 export interface UseNoMessPreviewResult<T extends NoMessEntry = NoMessEntry> {
     entry: T | null;
     error: Error | null;
+    errorDetails: NoMessError | null;
     isLoading: boolean;
+    status: UseNoMessPreviewStatus;
 }
 export interface ContentTypeSchema {
     name: string;
@@ -138,6 +175,30 @@ export interface SchemaGetResponse {
     contentType: ContentTypeSchema;
     sdkExample: string;
 }
+/** Props for the route-aware provider used on real site routes. */
+export interface NoMessLiveRouteProviderProps extends UseNoMessPreviewConfig {
+    children: import("react").ReactNode;
+    liveEditConfig?: UseNoMessLiveEditConfig;
+}
+/** Backward-compatible alias for the route-aware provider props. */
+export interface NoMessProviderProps extends NoMessLiveRouteProviderProps {
+}
+/** Options for binding a rendered entry to the current route. */
+export interface UseNoMessEditableEntryOptions {
+    registerCurrentUrl?: boolean;
+    url?: string;
+}
+/** Shared provider context for preview/live-edit state. */
+export interface NoMessContextValue {
+    adminOrigin: string;
+    apiKey: string;
+    apiUrl?: string;
+    bindEntry: (entryId: string) => void;
+    client: Pick<import("./client.js").NoMessClient, "reportLiveEditRoute">;
+    isIframe: boolean;
+    preview: UseNoMessPreviewResult;
+    liveEdit: UseNoMessLiveEditResult;
+}
 export interface LiveEditFieldInfo {
     name: string;
     type: string;
@@ -148,19 +209,34 @@ export interface LiveEditConfig {
     onFieldClicked?: (fieldName: string) => void;
     onEnter?: () => void;
     onExit?: () => void;
+    onError?: (error: Error) => void;
+    logger?: NoMessLogger;
 }
 export interface LiveEditHandle {
     cleanup: () => void;
 }
 export interface UseNoMessLiveEditConfig {
     adminOrigin?: string;
+    logger?: NoMessLogger;
 }
 export interface UseNoMessLiveEditResult {
     isLiveEditActive: boolean;
     fieldOverrides: Record<string, unknown>;
+    error: Error | null;
+    errorDetails: NoMessError | null;
 }
 export declare class NoMessError extends Error {
-    status: number;
+    readonly kind: NoMessErrorKind;
+    readonly code: NoMessErrorCode;
+    readonly status?: number;
+    readonly retryable: boolean;
+    readonly operation?: string;
+    readonly method?: string;
+    readonly url?: string;
+    readonly requestId?: string;
+    readonly details?: Record<string, unknown>;
+    readonly cause?: unknown;
     constructor(message: string, status: number);
+    constructor(message: string, options?: NoMessErrorOptions);
 }
 //# sourceMappingURL=types.d.ts.map