@no-mess/client 0.1.1

package/README.md

@@ -0,0 +1,64 @@
+# @no-mess/client
+
+TypeScript SDK for the [no-mess](https://no-mess.xyz) headless CMS.
+
+## Install
+
+```bash
+npm install @no-mess/client
+# or
+bun add @no-mess/client
+```
+
+## Usage
+
+### Fetching content
+
+```ts
+import { createNoMessClient } from "@no-mess/client";
+
+const client = createNoMessClient({
+  apiKey: "your-api-key",
+});
+
+// Get all entries of a content type
+const posts = await client.getEntries("blog-post");
+
+// Get a single entry by slug
+const post = await client.getEntry("blog-post", "hello-world");
+```
+
+### Live preview (React)
+
+```tsx
+import { useNoMessPreview } from "@no-mess/client/react";
+
+function PreviewPage() {
+  const { entry, isLoading, error } = useNoMessPreview({
+    apiKey: "your-api-key",
+  });
+
+  if (isLoading) return <p>Loading preview...</p>;
+  if (error) return <p>Error: {error.message}</p>;
+
+  return <h1>{entry?.fields.title}</h1>;
+}
+```
+
+The `useNoMessPreview` hook handles the postMessage handshake between the no-mess admin dashboard and your preview iframe automatically.
+
+### Shopify data
+
+```ts
+const products = await client.getProducts();
+const product = await client.getProduct("product-handle");
+const collections = await client.getCollections();
+```
+
+## API reference
+
+Full documentation at [no-mess.xyz/docs/sdk](https://no-mess.xyz/docs/sdk).
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,51 @@
+import type { GetEntryOptions, NoMessClientConfig, NoMessEntry, PreviewExchangeResult, PreviewSessionAuth, SchemaGetResponse, SchemaListResponse, ShopifyCollection, ShopifyProduct } from "./types.js";
+export declare class NoMessClient {
+    private apiUrl;
+    private apiKey;
+    constructor(config: NoMessClientConfig);
+    private fetch;
+    /**
+     * List all content type schemas with fields, TypeScript interfaces, and entry counts.
+     */
+    getSchemas(): Promise<SchemaListResponse>;
+    /**
+     * Get a single content type schema by slug.
+     */
+    getSchema(typeSlug: string): Promise<SchemaGetResponse>;
+    /**
+     * Get all published entries of a content type.
+     */
+    getEntries<T extends NoMessEntry = NoMessEntry>(contentType: string): Promise<T[]>;
+    /**
+     * Get a single entry by content type and slug.
+     * Supports preview mode with preview secret.
+     */
+    getEntry<T extends NoMessEntry = NoMessEntry>(contentType: string, slug: string, options?: GetEntryOptions): Promise<T>;
+    /**
+     * Get all synced Shopify products.
+     */
+    getProducts(): Promise<ShopifyProduct[]>;
+    /**
+     * Get a single Shopify product by handle.
+     */
+    getProduct(handle: string): Promise<ShopifyProduct>;
+    /**
+     * Get all synced Shopify collections.
+     */
+    getCollections(): Promise<ShopifyCollection[]>;
+    /**
+     * Get a single Shopify collection by handle.
+     */
+    getCollection(handle: string): Promise<ShopifyCollection>;
+    /**
+     * Exchange a preview session for draft content.
+     * Computes an HMAC-SHA256 proof and sends it to the server for verification.
+     */
+    exchangePreviewSession(session: PreviewSessionAuth): Promise<PreviewExchangeResult>;
+    /**
+     * Compute HMAC-SHA256 proof for preview session authentication.
+     * Uses Web Crypto API (works in browsers, Node.js 18+, Deno, Bun, edge runtimes).
+     */
+    private computeProof;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACf,MAAM,YAAY,CAAC;AAGpB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,kBAAkB;YAiBxB,KAAK;IA+BnB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAI/C;;OAEG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI7D;;OAEG;IACG,UAAU,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAClD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,CAAC,EAAE,CAAC;IAIf;;;OAGG;IACG,QAAQ,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAChD,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,eAAe,GACxB,OAAO,CAAC,CAAC,CAAC;IAWb;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAI9C;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAIzD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAIpD;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAI/D;;;OAGG;IACG,sBAAsB,CAC1B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,qBAAqB,CAAC;IAkCjC;;;OAGG;YACW,YAAY;CA0B3B"}

package/dist/client.js

@@ -0,0 +1,134 @@
+import { DEFAULT_API_URL, NoMessError } from "./types.js";
+export class NoMessClient {
+    constructor(config) {
+        this.apiUrl = (config.apiUrl ?? DEFAULT_API_URL).replace(/\/$/, "");
+        this.apiKey = config.apiKey;
+        if (typeof window !== "undefined" &&
+            config.apiKey.startsWith("nm_") &&
+            !config.apiKey.startsWith("nm_pub_")) {
+            console.warn("[no-mess] You are using a secret API key (nm_) in a browser environment. " +
+                "This exposes your secret key to end users. " +
+                "Use a publishable key (nm_pub_) for client-side code instead.");
+        }
+    }
+    async fetch(path, params) {
+        const url = new URL(`${this.apiUrl}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                url.searchParams.set(key, value);
+            }
+        }
+        const response = await fetch(url.toString(), {
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            const body = await response
+                .json()
+                .catch(() => ({ error: "Unknown error" }));
+            throw new NoMessError(body.error ?? `HTTP ${response.status}`, response.status);
+        }
+        return response.json();
+    }
+    /**
+     * List all content type schemas with fields, TypeScript interfaces, and entry counts.
+     */
+    async getSchemas() {
+        return this.fetch("/api/schema");
+    }
+    /**
+     * Get a single content type schema by slug.
+     */
+    async getSchema(typeSlug) {
+        return this.fetch(`/api/schema/${typeSlug}`);
+    }
+    /**
+     * Get all published entries of a content type.
+     */
+    async getEntries(contentType) {
+        return this.fetch(`/api/content/${contentType}`);
+    }
+    /**
+     * Get a single entry by content type and slug.
+     * Supports preview mode with preview secret.
+     */
+    async getEntry(contentType, slug, options) {
+        const params = {};
+        if (options?.preview) {
+            params.preview = "true";
+            if (options.previewSecret) {
+                params.secret = options.previewSecret;
+            }
+        }
+        return this.fetch(`/api/content/${contentType}/${slug}`, params);
+    }
+    /**
+     * Get all synced Shopify products.
+     */
+    async getProducts() {
+        return this.fetch("/api/shopify/products");
+    }
+    /**
+     * Get a single Shopify product by handle.
+     */
+    async getProduct(handle) {
+        return this.fetch(`/api/shopify/products/${handle}`);
+    }
+    /**
+     * Get all synced Shopify collections.
+     */
+    async getCollections() {
+        return this.fetch("/api/shopify/collections");
+    }
+    /**
+     * Get a single Shopify collection by handle.
+     */
+    async getCollection(handle) {
+        return this.fetch(`/api/shopify/collections/${handle}`);
+    }
+    /**
+     * Exchange a preview session for draft content.
+     * Computes an HMAC-SHA256 proof and sends it to the server for verification.
+     */
+    async exchangePreviewSession(session) {
+        const timestamp = Math.floor(Date.now() / 1000).toString();
+        const proof = await this.computeProof(session.sessionSecret, session.sessionId, timestamp);
+        const response = await fetch(`${this.apiUrl}/api/preview/exchange`, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${this.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                sessionId: session.sessionId,
+                timestamp,
+                proof,
+            }),
+        });
+        if (!response.ok) {
+            const body = await response
+                .json()
+                .catch(() => ({ error: "Unknown error" }));
+            throw new NoMessError(body.error ?? `HTTP ${response.status}`, response.status);
+        }
+        return response.json();
+    }
+    /**
+     * Compute HMAC-SHA256 proof for preview session authentication.
+     * Uses Web Crypto API (works in browsers, Node.js 18+, Deno, Bun, edge runtimes).
+     */
+    async computeProof(sessionSecret, sessionId, timestamp) {
+        const secretBytes = new Uint8Array((sessionSecret.match(/.{2}/g) ?? []).map((byte) => parseInt(byte, 16)));
+        const buf = new ArrayBuffer(secretBytes.byteLength);
+        new Uint8Array(buf).set(secretBytes);
+        const key = await crypto.subtle.importKey("raw", buf, { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+        const message = new TextEncoder().encode(`${sessionId}.${timestamp}`);
+        const msgBuf = new ArrayBuffer(message.byteLength);
+        new Uint8Array(msgBuf).set(message);
+        const signature = await crypto.subtle.sign("HMAC", key, msgBuf);
+        return btoa(String.fromCharCode(...new Uint8Array(signature)));
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+export { NoMessClient } from "./client.js";
+export { createLiveEditHandler } from "./live-edit.js";
+export type { ContentTypeSchema, GetEntryOptions, LiveEditConfig, LiveEditHandle, NoMessClientConfig, NoMessEntry, PreviewExchangeResult, PreviewHandlerConfig, PreviewSessionAuth, SchemaGetResponse, SchemaListResponse, ShopifyCollection, ShopifyProduct, UseNoMessLiveEditConfig, UseNoMessLiveEditResult, UseNoMessPreviewConfig, UseNoMessPreviewResult, } from "./types.js";
+export { DEFAULT_ADMIN_ORIGIN, DEFAULT_API_URL, isPublishableKey, isSecretKey, NoMessError, } from "./types.js";
+import { NoMessClient } from "./client.js";
+import type { NoMessClientConfig, PreviewHandlerConfig } from "./types.js";
+/**
+ * Create a no-mess client instance.
+ */
+export declare function createNoMessClient(config: NoMessClientConfig): NoMessClient;
+/**
+ * Create a preview handler that manages the postMessage handshake
+ * between the admin dashboard (parent) and the preview iframe (child).
+ *
+ * Usage in a client site's preview page:
+ * ```ts
+ * const handler = createPreviewHandler({
+ *   client,
+ *   adminOrigin: "https://admin.no-mess.xyz",
+ *   onEntry: (entry) => setEntry(entry),
+ *   onError: (err) => setError(err.message),
+ * });
+ * handler.start();
+ * // On cleanup: handler.cleanup();
+ * ```
+ */
+export declare function createPreviewHandler(config: PreviewHandlerConfig): {
+    start: () => void;
+    cleanup: () => void;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AACvD,YAAY,EACV,iBAAiB,EACjB,eAAe,EACf,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,WAAW,EACX,qBAAqB,EACrB,oBAAoB,EACpB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,gBAAgB,EAChB,WAAW,EACX,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,kBAAkB,EAElB,oBAAoB,EAErB,MAAM,YAAY,CAAC;AAEpB;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAE3E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,oBAAoB,GAAG;IAClE,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CA2DA"}

package/dist/index.js

@@ -0,0 +1,74 @@
+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";
+/**
+ * Create a no-mess client instance.
+ */
+export function createNoMessClient(config) {
+    return new NoMessClient(config);
+}
+/**
+ * Create a preview handler that manages the postMessage handshake
+ * between the admin dashboard (parent) and the preview iframe (child).
+ *
+ * Usage in a client site's preview page:
+ * ```ts
+ * const handler = createPreviewHandler({
+ *   client,
+ *   adminOrigin: "https://admin.no-mess.xyz",
+ *   onEntry: (entry) => setEntry(entry),
+ *   onError: (err) => setError(err.message),
+ * });
+ * handler.start();
+ * // On cleanup: handler.cleanup();
+ * ```
+ */
+export function createPreviewHandler(config) {
+    let sessionAuth = null;
+    const handleMessage = async (event) => {
+        if (event.origin !== config.adminOrigin)
+            return;
+        const data = event.data;
+        if (!data || typeof data.type !== "string")
+            return;
+        if (data.type === "no-mess:session-auth") {
+            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);
+            }
+        }
+        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);
+            }
+        }
+    };
+    return {
+        start: () => {
+            window.addEventListener("message", handleMessage);
+            window.parent.postMessage({ type: "no-mess:preview-ready" }, "*");
+        },
+        cleanup: () => {
+            window.removeEventListener("message", handleMessage);
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/live-edit.d.ts

@@ -0,0 +1,15 @@
+import type { LiveEditConfig, LiveEditHandle } from "./types.js";
+/**
+ * Create a live edit handler that manages overlay highlights on annotated DOM
+ * elements and communicates with the admin dashboard via postMessage.
+ *
+ * Usage in a client site's preview page:
+ * ```ts
+ * const handle = createLiveEditHandler({
+ *   adminOrigin: "https://admin.no-mess.xyz",
+ * });
+ * // On cleanup: handle.cleanup();
+ * ```
+ */
+export declare function createLiveEditHandler(config: LiveEditConfig): LiveEditHandle;
+//# sourceMappingURL=live-edit.d.ts.map

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

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

package/dist/live-edit.js

@@ -0,0 +1,288 @@
+const OVERLAY_CONTAINER_ID = "no-mess-live-edit-overlays";
+const OVERLAY_ATTR = "data-no-mess-overlay-for";
+const FIELD_ATTR = "data-no-mess-field";
+const OVERLAY_CSS = `
+#${OVERLAY_CONTAINER_ID} {
+  pointer-events: none;
+  position: fixed;
+  top: 0;
+  left: 0;
+  width: 100%;
+  height: 100%;
+  z-index: 2147483646;
+}
+.no-mess-overlay {
+  position: absolute;
+  border: 2px solid oklch(0.623 0.214 259.1);
+  border-radius: 4px;
+  pointer-events: auto;
+  cursor: pointer;
+  transition: border-color 150ms, background-color 150ms;
+}
+.no-mess-overlay:hover {
+  background-color: oklch(0.623 0.214 259.1 / 0.08);
+}
+.no-mess-overlay[data-focused="true"] {
+  border-color: oklch(0.546 0.245 262.9);
+  background-color: oklch(0.546 0.245 262.9 / 0.12);
+  border-width: 3px;
+}
+.no-mess-overlay-label {
+  position: absolute;
+  top: -22px;
+  left: -2px;
+  background: oklch(0.623 0.214 259.1);
+  color: white;
+  font-size: 11px;
+  font-family: system-ui, sans-serif;
+  line-height: 1;
+  padding: 3px 6px;
+  border-radius: 3px 3px 0 0;
+  white-space: nowrap;
+  pointer-events: none;
+}
+.no-mess-overlay[data-focused="true"] .no-mess-overlay-label {
+  background: oklch(0.546 0.245 262.9);
+}
+`;
+/**
+ * Create a live edit handler that manages overlay highlights on annotated DOM
+ * elements and communicates with the admin dashboard via postMessage.
+ *
+ * Usage in a client site's preview page:
+ * ```ts
+ * const handle = createLiveEditHandler({
+ *   adminOrigin: "https://admin.no-mess.xyz",
+ * });
+ * // On cleanup: handle.cleanup();
+ * ```
+ */
+export function createLiveEditHandler(config) {
+    let active = false;
+    let container = null;
+    let styleEl = null;
+    let overlays = [];
+    let resizeObserver = null;
+    let mutationObserver = null;
+    let scrollListener = null;
+    let rafId = null;
+    function injectStyles() {
+        if (document.getElementById("no-mess-live-edit-styles"))
+            return;
+        styleEl = document.createElement("style");
+        styleEl.id = "no-mess-live-edit-styles";
+        styleEl.textContent = OVERLAY_CSS;
+        document.head.appendChild(styleEl);
+    }
+    function createContainer() {
+        container = document.createElement("div");
+        container.id = OVERLAY_CONTAINER_ID;
+        document.body.appendChild(container);
+    }
+    function getFieldElements() {
+        const map = new Map();
+        const elements = document.querySelectorAll(`[${FIELD_ATTR}]`);
+        for (const el of elements) {
+            const fieldName = el.getAttribute(FIELD_ATTR);
+            if (!fieldName)
+                continue;
+            const existing = map.get(fieldName);
+            if (existing) {
+                existing.push(el);
+            }
+            else {
+                map.set(fieldName, [el]);
+            }
+        }
+        return map;
+    }
+    function positionOverlay(overlay, element) {
+        const rect = element.getBoundingClientRect();
+        overlay.style.top = `${rect.top}px`;
+        overlay.style.left = `${rect.left}px`;
+        overlay.style.width = `${rect.width}px`;
+        overlay.style.height = `${rect.height}px`;
+    }
+    function updateAllPositions() {
+        for (const entry of overlays) {
+            positionOverlay(entry.overlay, entry.element);
+        }
+    }
+    function schedulePositionUpdate() {
+        if (rafId !== null)
+            return;
+        rafId = requestAnimationFrame(() => {
+            rafId = null;
+            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);
+            }
+        }
+        // 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?.();
+    }
+    function exitLiveEdit() {
+        if (!active)
+            return;
+        active = false;
+        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;
+        config.onExit?.();
+    }
+    function handleFieldUpdate(fieldName, value) {
+        const elements = document.querySelectorAll(`[${FIELD_ATTR}="${fieldName}"]`);
+        for (const el of elements) {
+            if (el instanceof HTMLImageElement && typeof value === "string") {
+                el.src = value;
+            }
+            else if (el instanceof HTMLElement &&
+                el.style.backgroundImage &&
+                typeof value === "string") {
+                el.style.backgroundImage = `url(${value})`;
+            }
+            else if (typeof value === "string") {
+                el.textContent = value;
+            }
+            else if (typeof value === "number" || typeof value === "boolean") {
+                el.textContent = String(value);
+            }
+        }
+    }
+    function handleFieldFocus(fieldName) {
+        for (const entry of overlays) {
+            if (entry.fieldName === fieldName) {
+                entry.overlay.setAttribute("data-focused", "true");
+            }
+        }
+    }
+    function handleFieldBlur(fieldName) {
+        for (const entry of overlays) {
+            if (entry.fieldName === fieldName) {
+                entry.overlay.removeAttribute("data-focused");
+            }
+        }
+    }
+    function handleMessage(event) {
+        if (event.origin !== config.adminOrigin)
+            return;
+        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) {
+                    handleFieldUpdate(data.fieldName, data.value);
+                }
+                break;
+            case "no-mess:field-focus":
+                if (data.fieldName && active) {
+                    handleFieldFocus(data.fieldName);
+                }
+                break;
+            case "no-mess:field-blur":
+                if (data.fieldName && active) {
+                    handleFieldBlur(data.fieldName);
+                }
+                break;
+        }
+    }
+    // Start listening immediately
+    window.addEventListener("message", handleMessage);
+    return {
+        cleanup: () => {
+            window.removeEventListener("message", handleMessage);
+            exitLiveEdit();
+        },
+    };
+}
+//# sourceMappingURL=live-edit.js.map

package/dist/live-edit.js.map

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

package/dist/react/index.d.ts

@@ -0,0 +1,6 @@
+export type { NoMessEntry, UseNoMessLiveEditConfig, UseNoMessLiveEditResult, UseNoMessPreviewConfig, UseNoMessPreviewResult, } from "../types.js";
+export type { NoMessPreviewProps } from "./no-mess-preview.js";
+export { NoMessPreview } from "./no-mess-preview.js";
+export { useNoMessLiveEdit } from "./use-no-mess-live-edit.js";
+export { useNoMessPreview } from "./use-no-mess-preview.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAEA,YAAY,EACV,WAAW,EACX,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/react/index.js

@@ -0,0 +1,5 @@
+"use client";
+export { NoMessPreview } from "./no-mess-preview.js";
+export { useNoMessLiveEdit } from "./use-no-mess-live-edit.js";
+export { useNoMessPreview } from "./use-no-mess-preview.js";
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAUb,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC"}

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

@@ -0,0 +1,11 @@
+import type { ReactNode } from "react";
+import type { NoMessEntry, UseNoMessPreviewConfig } from "../types.js";
+export interface NoMessPreviewProps<T extends NoMessEntry = NoMessEntry> extends UseNoMessPreviewConfig {
+    children: (state: {
+        entry: T | null;
+        error: Error | null;
+        isLoading: boolean;
+    }) => ReactNode;
+}
+export declare function NoMessPreview<T extends NoMessEntry = NoMessEntry>({ children, ...config }: NoMessPreviewProps<T>): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=no-mess-preview.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"no-mess-preview.d.ts","sourceRoot":"","sources":["../../src/react/no-mess-preview.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAGvE,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,CACrE,SAAQ,sBAAsB;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE;QAChB,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;QAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;QACpB,SAAS,EAAE,OAAO,CAAC;KACpB,KAAK,SAAS,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAAE,EACjE,QAAQ,EACR,GAAG,MAAM,EACV,EAAE,kBAAkB,CAAC,CAAC,CAAC,2CAGvB"}

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

@@ -0,0 +1,8 @@
+"use client";
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useNoMessPreview } from "./use-no-mess-preview.js";
+export function NoMessPreview({ children, ...config }) {
+    const state = useNoMessPreview(config);
+    return _jsx(_Fragment, { children: children(state) });
+}
+//# sourceMappingURL=no-mess-preview.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"no-mess-preview.js","sourceRoot":"","sources":["../../src/react/no-mess-preview.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAIb,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAW5D,MAAM,UAAU,aAAa,CAAsC,EACjE,QAAQ,EACR,GAAG,MAAM,EACa;IACtB,MAAM,KAAK,GAAG,gBAAgB,CAAI,MAAM,CAAC,CAAC;IAC1C,OAAO,4BAAG,QAAQ,CAAC,KAAK,CAAC,GAAI,CAAC;AAChC,CAAC"}

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

@@ -0,0 +1,17 @@
+import type { UseNoMessLiveEditConfig, UseNoMessLiveEditResult } from "../types.js";
+/**
+ * React hook for live edit mode. When the admin dashboard sends a
+ * `no-mess:live-edit-enter` message, this hook activates overlays on
+ * elements with `data-no-mess-field` attributes and tracks field value
+ * overrides sent from the admin.
+ *
+ * Usage:
+ * ```tsx
+ * const { isLiveEditActive, fieldOverrides } = useNoMessLiveEdit({
+ *   adminOrigin: "https://admin.no-mess.xyz",
+ * });
+ * const title = (fieldOverrides.title as string) ?? entry?.title;
+ * ```
+ */
+export declare function useNoMessLiveEdit(config: UseNoMessLiveEditConfig): UseNoMessLiveEditResult;
+//# sourceMappingURL=use-no-mess-live-edit.d.ts.map

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

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

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

@@ -0,0 +1,60 @@
+"use client";
+import { useCallback, useEffect, useRef, useState } from "react";
+import { createLiveEditHandler } from "../live-edit.js";
+import { DEFAULT_ADMIN_ORIGIN } from "../types.js";
+/**
+ * React hook for live edit mode. When the admin dashboard sends a
+ * `no-mess:live-edit-enter` message, this hook activates overlays on
+ * elements with `data-no-mess-field` attributes and tracks field value
+ * overrides sent from the admin.
+ *
+ * Usage:
+ * ```tsx
+ * const { isLiveEditActive, fieldOverrides } = useNoMessLiveEdit({
+ *   adminOrigin: "https://admin.no-mess.xyz",
+ * });
+ * const title = (fieldOverrides.title as string) ?? entry?.title;
+ * ```
+ */
+export function useNoMessLiveEdit(config) {
+    const [isLiveEditActive, setIsLiveEditActive] = useState(false);
+    const [fieldOverrides, setFieldOverrides] = useState({});
+    const configRef = useRef(config);
+    configRef.current = config;
+    const handleFieldUpdate = useCallback((event) => {
+        const origin = configRef.current.adminOrigin ?? DEFAULT_ADMIN_ORIGIN;
+        if (event.origin !== origin)
+            return;
+        const data = event.data;
+        if (!data || typeof data.type !== "string")
+            return;
+        if (data.type === "no-mess:field-updated" && data.fieldName) {
+            setFieldOverrides((prev) => ({
+                ...prev,
+                [data.fieldName]: data.value,
+            }));
+        }
+    }, []);
+    useEffect(() => {
+        const adminOrigin = configRef.current.adminOrigin ?? DEFAULT_ADMIN_ORIGIN;
+        const handle = createLiveEditHandler({
+            adminOrigin,
+            onEnter: () => {
+                setIsLiveEditActive(true);
+                setFieldOverrides({});
+            },
+            onExit: () => {
+                setIsLiveEditActive(false);
+                setFieldOverrides({});
+            },
+        });
+        // Also listen for field-updated to track overrides in React state
+        window.addEventListener("message", handleFieldUpdate);
+        return () => {
+            handle.cleanup();
+            window.removeEventListener("message", handleFieldUpdate);
+        };
+    }, [handleFieldUpdate]);
+    return { isLiveEditActive, fieldOverrides };
+}
+//# sourceMappingURL=use-no-mess-live-edit.js.map

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

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

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

@@ -0,0 +1,3 @@
+import type { NoMessEntry, UseNoMessPreviewConfig, UseNoMessPreviewResult } from "../types.js";
+export declare function useNoMessPreview<T extends NoMessEntry = NoMessEntry>(config: UseNoMessPreviewConfig): UseNoMessPreviewResult<T>;
+//# sourceMappingURL=use-no-mess-preview.d.ts.map

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

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

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

@@ -0,0 +1,35 @@
+"use client";
+import { useEffect, useRef, useState } from "react";
+import { NoMessClient } from "../client.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 configRef = useRef(config);
+    configRef.current = config;
+    useEffect(() => {
+        const client = new NoMessClient({
+            apiKey: configRef.current.apiKey,
+            apiUrl: configRef.current.apiUrl,
+        });
+        const handler = createPreviewHandler({
+            client,
+            adminOrigin: configRef.current.adminOrigin ?? DEFAULT_ADMIN_ORIGIN,
+            onEntry: (e) => {
+                setEntry(e);
+                setError(null);
+                setIsLoading(false);
+            },
+            onError: (err) => {
+                setError(err);
+                setIsLoading(false);
+            },
+        });
+        handler.start();
+        return () => handler.cleanup();
+    }, []);
+    return { entry, error, isLoading };
+}
+//# sourceMappingURL=use-no-mess-preview.js.map

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

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

package/dist/types.d.ts

@@ -0,0 +1,166 @@
+export declare const DEFAULT_API_URL = "https://api.no-mess.xyz";
+export declare const DEFAULT_ADMIN_ORIGIN = "https://admin.no-mess.xyz";
+export interface NoMessClientConfig {
+    apiUrl?: string;
+    /**
+     * API key for authenticating requests to the no-mess API.
+     * Accepts either a secret key (`nm_...`) or a publishable key (`nm_pub_...`).
+     *
+     * - **Secret key**: Server-side only. Full access. Never expose in client-side code.
+     * - **Publishable key**: Safe for client-side use. Read-only access to published content.
+     */
+    apiKey: string;
+}
+/** Returns true if the key is a publishable key (nm_pub_ prefix). */
+export declare function isPublishableKey(key: string): boolean;
+/** Returns true if the key is a secret key (nm_ prefix, not nm_pub_). */
+export declare function isSecretKey(key: string): boolean;
+export interface GetEntryOptions {
+    preview?: boolean;
+    previewSecret?: string;
+}
+export interface NoMessEntry {
+    slug: string;
+    title: string;
+    _id: string;
+    _createdAt: number;
+    _updatedAt: number;
+    _publishedAt?: number;
+    _status?: string;
+    [key: string]: unknown;
+}
+export interface ShopifyProduct {
+    handle: string;
+    title: string;
+    status: string;
+    featuredImage?: string;
+    priceRange: {
+        min: string;
+        max: string;
+    };
+    available: boolean;
+    images?: {
+        id: string;
+        src: string;
+        alt?: string;
+    }[];
+    variants?: {
+        id: string;
+        title: string;
+        sku?: string;
+        price: string;
+        compareAtPrice?: string;
+        available: boolean;
+    }[];
+    productType?: string;
+    vendor?: string;
+    tags?: string[];
+}
+export interface ShopifyCollection {
+    handle: string;
+    title: string;
+    image?: string;
+    productsCount: number;
+}
+export interface PreviewSessionAuth {
+    sessionId: string;
+    sessionSecret: string;
+}
+export interface PreviewExchangeResult {
+    entry: NoMessEntry;
+    sessionId: string;
+    expiresAt: number;
+}
+export interface PreviewHandlerConfig {
+    client: {
+        exchangePreviewSession: (session: PreviewSessionAuth) => Promise<PreviewExchangeResult>;
+    };
+    adminOrigin: string;
+    onEntry: (entry: NoMessEntry) => void;
+    onError?: (error: Error) => void;
+}
+export interface UseNoMessPreviewConfig {
+    apiKey: string;
+    apiUrl?: string;
+    adminOrigin?: string;
+}
+export interface UseNoMessPreviewResult<T extends NoMessEntry = NoMessEntry> {
+    entry: T | null;
+    error: Error | null;
+    isLoading: boolean;
+}
+export interface ContentTypeSchema {
+    name: string;
+    slug: string;
+    description?: string;
+    fields: {
+        name: string;
+        type: string;
+        required: boolean;
+        description?: string;
+        options?: {
+            choices?: {
+                label: string;
+                value: string;
+            }[];
+        };
+    }[];
+    fieldTypeMap: {
+        name: string;
+        type: string;
+        tsType: string;
+        required: boolean;
+    }[];
+    typescript: string;
+    entryCounts: {
+        published: number;
+        draft: number;
+        total: number;
+    };
+    endpoints: {
+        list: string;
+        get: string;
+    };
+}
+export interface SchemaListResponse {
+    site: {
+        name: string;
+        slug: string;
+    };
+    contentTypes: ContentTypeSchema[];
+    sdkExample: string;
+}
+export interface SchemaGetResponse {
+    site: {
+        name: string;
+        slug: string;
+    };
+    contentType: ContentTypeSchema;
+    sdkExample: string;
+}
+export interface LiveEditFieldInfo {
+    name: string;
+    type: string;
+    required: boolean;
+}
+export interface LiveEditConfig {
+    adminOrigin: string;
+    onFieldClicked?: (fieldName: string) => void;
+    onEnter?: () => void;
+    onExit?: () => void;
+}
+export interface LiveEditHandle {
+    cleanup: () => void;
+}
+export interface UseNoMessLiveEditConfig {
+    adminOrigin?: string;
+}
+export interface UseNoMessLiveEditResult {
+    isLiveEditActive: boolean;
+    fieldOverrides: Record<string, unknown>;
+}
+export declare class NoMessError extends Error {
+    status: number;
+    constructor(message: string, status: number);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,4BAA4B,CAAC;AACzD,eAAO,MAAM,oBAAoB,8BAA8B,CAAC;AAEhE,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qEAAqE;AACrE,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAErD;AAED,yEAAyE;AACzE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACzC,SAAS,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACrD,QAAQ,CAAC,EAAE;QACT,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,OAAO,CAAC;KACpB,EAAE,CAAC;IACJ,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE;QACN,sBAAsB,EAAE,CACtB,OAAO,EAAE,kBAAkB,KACxB,OAAO,CAAC,qBAAqB,CAAC,CAAC;KACrC,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACtC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACzE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,OAAO,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE;YACR,OAAO,CAAC,EAAE;gBAAE,KAAK,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,CAAA;aAAE,EAAE,CAAC;SAC9C,CAAC;KACH,EAAE,CAAC;IACJ,YAAY,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,OAAO,CAAC;KACnB,EAAE,CAAC;IACJ,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE;QACX,SAAS,EAAE,MAAM,CAAC;QAClB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;CACpB;AAID,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7C,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACzC;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,MAAM,EAAE,MAAM,CAAC;gBAEH,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK5C"}

package/dist/types.js

@@ -0,0 +1,18 @@
+export const DEFAULT_API_URL = "https://api.no-mess.xyz";
+export const DEFAULT_ADMIN_ORIGIN = "https://admin.no-mess.xyz";
+/** Returns true if the key is a publishable key (nm_pub_ prefix). */
+export function isPublishableKey(key) {
+    return key.startsWith("nm_pub_");
+}
+/** Returns true if the key is a secret key (nm_ prefix, not nm_pub_). */
+export function isSecretKey(key) {
+    return key.startsWith("nm_") && !key.startsWith("nm_pub_");
+}
+export class NoMessError extends Error {
+    constructor(message, status) {
+        super(message);
+        this.name = "NoMessError";
+        this.status = status;
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG,yBAAyB,CAAC;AACzD,MAAM,CAAC,MAAM,oBAAoB,GAAG,2BAA2B,CAAC;AAchE,qEAAqE;AACrE,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,OAAO,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AACnC,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;AAC7D,CAAC;AAuJD,MAAM,OAAO,WAAY,SAAQ,KAAK;IAGpC,YAAY,OAAe,EAAE,MAAc;QACzC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@no-mess/client",
+  "version": "0.1.1",
+  "description": "TypeScript SDK for the no-mess headless CMS",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./react": {
+      "import": "./dist/react/index.js",
+      "types": "./dist/react/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/jjjjjjjjjjjjjjjjacob/no-mess.git",
+    "directory": "packages/no-mess-client"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.0.0",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "jsdom": "^26.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^3.0.0"
+  }
+}