@cmssy/react 0.1.7 → 0.1.9

package/dist/client.cjs

@@ -747,9 +747,105 @@ function CmssyLazyLayout({ load, ...props }) {
   if (!blocks) return null;
   return /* @__PURE__ */ jsxRuntime.jsx(CmssyEditableLayout, { ...props, blocks });
 }
+var CmssyAuthContext = react.createContext(null);
+function CmssyAuthProvider({
+  children,
+  basePath = "/api/cmssy/auth",
+  initialUser
+}) {
+  const seeded = initialUser !== void 0;
+  const [user, setUser] = react.useState(initialUser ?? null);
+  const [loading, setLoading] = react.useState(!seeded);
+  const generation = react.useRef(0);
+  const base = react.useMemo(() => basePath.replace(/\/+$/, ""), [basePath]);
+  const commitUser = react.useCallback((next) => {
+    generation.current += 1;
+    setUser(next);
+  }, []);
+  const fetchUser = react.useCallback(async () => {
+    try {
+      const res = await fetch(`${base}/me`, {
+        credentials: "same-origin",
+        cache: "no-store"
+      });
+      const data = await res.json();
+      return data.user ?? null;
+    } catch {
+      return null;
+    }
+  }, [base]);
+  react.useEffect(() => {
+    if (seeded) return;
+    const gen = generation.current;
+    void (async () => {
+      const next = await fetchUser();
+      if (gen === generation.current) {
+        setUser(next);
+        setLoading(false);
+      }
+    })();
+  }, [fetchUser, seeded]);
+  const postAction = react.useCallback(
+    async (action, body) => {
+      const res = await fetch(`${base}/${action}`, {
+        method: "POST",
+        credentials: "same-origin",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      return await res.json();
+    },
+    [base]
+  );
+  const signIn = react.useCallback(
+    async (identity, password) => {
+      const data = await postAction("sign-in", { identity, password });
+      if (data.ok && data.user) commitUser(data.user);
+      return { ok: Boolean(data.ok), message: data.message };
+    },
+    [postAction, commitUser]
+  );
+  const register = react.useCallback(
+    async (identity, password, fields) => {
+      const data = await postAction("register", {
+        identity,
+        password,
+        fields: fields ?? {}
+      });
+      return { ok: Boolean(data.ok), message: data.message };
+    },
+    [postAction]
+  );
+  const signOut = react.useCallback(async () => {
+    try {
+      await postAction("sign-out", {});
+    } finally {
+      commitUser(null);
+    }
+  }, [postAction, commitUser]);
+  const refresh = react.useCallback(async () => {
+    const gen = generation.current;
+    const next = await fetchUser();
+    if (gen === generation.current) setUser(next);
+  }, [fetchUser]);
+  const value = react.useMemo(
+    () => ({ user, loading, signIn, register, signOut, refresh }),
+    [user, loading, signIn, register, signOut, refresh]
+  );
+  return /* @__PURE__ */ jsxRuntime.jsx(CmssyAuthContext.Provider, { value, children });
+}
+function useCmssyUser() {
+  const ctx = react.useContext(CmssyAuthContext);
+  if (!ctx) {
+    throw new Error("useCmssyUser must be used within <CmssyAuthProvider>");
+  }
+  return ctx;
+}
 
+exports.CmssyAuthProvider = CmssyAuthProvider;
 exports.CmssyEditableLayout = CmssyEditableLayout;
 exports.CmssyEditablePage = CmssyEditablePage;
 exports.CmssyLazyEditor = CmssyLazyEditor;
 exports.CmssyLazyLayout = CmssyLazyLayout;
+exports.useCmssyUser = useCmssyUser;
 exports.useEditBridge = useEditBridge;

package/dist/client.d.cts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup } from './registry-BaFQ2k7r.cjs';
-import 'react';
+import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup } from './registry-e3O4s_bN.cjs';
+import { ReactNode } from 'react';
 
 interface EditBridgeConfig {
     editorOrigin: string;
@@ -80,4 +80,28 @@ interface CmssyLazyLayoutProps {
 }
 declare function CmssyLazyLayout({ load, ...props }: CmssyLazyLayoutProps): react_jsx_runtime.JSX.Element | null;
 
-export { CmssyEditableLayout, type CmssyEditableLayoutProps, CmssyEditablePage, type CmssyEditablePageProps, CmssyLazyEditor, type CmssyLazyEditorProps, CmssyLazyLayout, type CmssyLazyLayoutProps, type EditBridgeConfig, type EditBridgeState, type PatchMap, useEditBridge };
+interface CmssyAuthUser {
+    recordId: string;
+    email: string;
+}
+interface CmssyAuthActionResult {
+    ok: boolean;
+    message?: string;
+}
+interface CmssyAuthState {
+    user: CmssyAuthUser | null;
+    loading: boolean;
+    signIn(identity: string, password: string): Promise<CmssyAuthActionResult>;
+    register(identity: string, password: string, fields?: Record<string, unknown>): Promise<CmssyAuthActionResult>;
+    signOut(): Promise<void>;
+    refresh(): Promise<void>;
+}
+interface CmssyAuthProviderProps {
+    children: ReactNode;
+    basePath?: string;
+    initialUser?: CmssyAuthUser | null;
+}
+declare function CmssyAuthProvider({ children, basePath, initialUser, }: CmssyAuthProviderProps): react_jsx_runtime.JSX.Element;
+declare function useCmssyUser(): CmssyAuthState;
+
+export { type CmssyAuthActionResult, CmssyAuthProvider, type CmssyAuthProviderProps, type CmssyAuthState, type CmssyAuthUser, CmssyEditableLayout, type CmssyEditableLayoutProps, CmssyEditablePage, type CmssyEditablePageProps, CmssyLazyEditor, type CmssyLazyEditorProps, CmssyLazyLayout, type CmssyLazyLayoutProps, type EditBridgeConfig, type EditBridgeState, type PatchMap, useCmssyUser, useEditBridge };

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup } from './registry-BaFQ2k7r.js';
-import 'react';
+import { B as BlockSchema, a as BlockMeta, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup } from './registry-e3O4s_bN.js';
+import { ReactNode } from 'react';
 
 interface EditBridgeConfig {
     editorOrigin: string;
@@ -80,4 +80,28 @@ interface CmssyLazyLayoutProps {
 }
 declare function CmssyLazyLayout({ load, ...props }: CmssyLazyLayoutProps): react_jsx_runtime.JSX.Element | null;
 
-export { CmssyEditableLayout, type CmssyEditableLayoutProps, CmssyEditablePage, type CmssyEditablePageProps, CmssyLazyEditor, type CmssyLazyEditorProps, CmssyLazyLayout, type CmssyLazyLayoutProps, type EditBridgeConfig, type EditBridgeState, type PatchMap, useEditBridge };
+interface CmssyAuthUser {
+    recordId: string;
+    email: string;
+}
+interface CmssyAuthActionResult {
+    ok: boolean;
+    message?: string;
+}
+interface CmssyAuthState {
+    user: CmssyAuthUser | null;
+    loading: boolean;
+    signIn(identity: string, password: string): Promise<CmssyAuthActionResult>;
+    register(identity: string, password: string, fields?: Record<string, unknown>): Promise<CmssyAuthActionResult>;
+    signOut(): Promise<void>;
+    refresh(): Promise<void>;
+}
+interface CmssyAuthProviderProps {
+    children: ReactNode;
+    basePath?: string;
+    initialUser?: CmssyAuthUser | null;
+}
+declare function CmssyAuthProvider({ children, basePath, initialUser, }: CmssyAuthProviderProps): react_jsx_runtime.JSX.Element;
+declare function useCmssyUser(): CmssyAuthState;
+
+export { type CmssyAuthActionResult, CmssyAuthProvider, type CmssyAuthProviderProps, type CmssyAuthState, type CmssyAuthUser, CmssyEditableLayout, type CmssyEditableLayoutProps, CmssyEditablePage, type CmssyEditablePageProps, CmssyLazyEditor, type CmssyLazyEditorProps, CmssyLazyLayout, type CmssyLazyLayoutProps, type EditBridgeConfig, type EditBridgeState, type PatchMap, useCmssyUser, useEditBridge };

package/dist/client.js

@@ -1,5 +1,5 @@
 "use client";
-import { useState, useRef, useEffect, useMemo, createElement } from 'react';
+import { createContext, useState, useRef, useEffect, useMemo, useCallback, useContext, createElement } from 'react';
 import { jsx, jsxs, Fragment } from 'react/jsx-runtime';
 
 // src/registry.ts
@@ -745,5 +745,99 @@ function CmssyLazyLayout({ load, ...props }) {
   if (!blocks) return null;
   return /* @__PURE__ */ jsx(CmssyEditableLayout, { ...props, blocks });
 }
+var CmssyAuthContext = createContext(null);
+function CmssyAuthProvider({
+  children,
+  basePath = "/api/cmssy/auth",
+  initialUser
+}) {
+  const seeded = initialUser !== void 0;
+  const [user, setUser] = useState(initialUser ?? null);
+  const [loading, setLoading] = useState(!seeded);
+  const generation = useRef(0);
+  const base = useMemo(() => basePath.replace(/\/+$/, ""), [basePath]);
+  const commitUser = useCallback((next) => {
+    generation.current += 1;
+    setUser(next);
+  }, []);
+  const fetchUser = useCallback(async () => {
+    try {
+      const res = await fetch(`${base}/me`, {
+        credentials: "same-origin",
+        cache: "no-store"
+      });
+      const data = await res.json();
+      return data.user ?? null;
+    } catch {
+      return null;
+    }
+  }, [base]);
+  useEffect(() => {
+    if (seeded) return;
+    const gen = generation.current;
+    void (async () => {
+      const next = await fetchUser();
+      if (gen === generation.current) {
+        setUser(next);
+        setLoading(false);
+      }
+    })();
+  }, [fetchUser, seeded]);
+  const postAction = useCallback(
+    async (action, body) => {
+      const res = await fetch(`${base}/${action}`, {
+        method: "POST",
+        credentials: "same-origin",
+        headers: { "content-type": "application/json" },
+        body: JSON.stringify(body)
+      });
+      return await res.json();
+    },
+    [base]
+  );
+  const signIn = useCallback(
+    async (identity, password) => {
+      const data = await postAction("sign-in", { identity, password });
+      if (data.ok && data.user) commitUser(data.user);
+      return { ok: Boolean(data.ok), message: data.message };
+    },
+    [postAction, commitUser]
+  );
+  const register = useCallback(
+    async (identity, password, fields) => {
+      const data = await postAction("register", {
+        identity,
+        password,
+        fields: fields ?? {}
+      });
+      return { ok: Boolean(data.ok), message: data.message };
+    },
+    [postAction]
+  );
+  const signOut = useCallback(async () => {
+    try {
+      await postAction("sign-out", {});
+    } finally {
+      commitUser(null);
+    }
+  }, [postAction, commitUser]);
+  const refresh = useCallback(async () => {
+    const gen = generation.current;
+    const next = await fetchUser();
+    if (gen === generation.current) setUser(next);
+  }, [fetchUser]);
+  const value = useMemo(
+    () => ({ user, loading, signIn, register, signOut, refresh }),
+    [user, loading, signIn, register, signOut, refresh]
+  );
+  return /* @__PURE__ */ jsx(CmssyAuthContext.Provider, { value, children });
+}
+function useCmssyUser() {
+  const ctx = useContext(CmssyAuthContext);
+  if (!ctx) {
+    throw new Error("useCmssyUser must be used within <CmssyAuthProvider>");
+  }
+  return ctx;
+}
 
-export { CmssyEditableLayout, CmssyEditablePage, CmssyLazyEditor, CmssyLazyLayout, useEditBridge };
+export { CmssyAuthProvider, CmssyEditableLayout, CmssyEditablePage, CmssyLazyEditor, CmssyLazyLayout, useCmssyUser, useEditBridge };

package/dist/index.cjs

@@ -35,6 +35,13 @@ function buildBlockMap(blocks) {
   for (const block of blocks) map[block.type] = block.component;
   return map;
 }
+function buildLoaderMap(blocks) {
+  const map = /* @__PURE__ */ Object.create(null);
+  for (const block of blocks) {
+    if (block.loader) map[block.type] = block.loader;
+  }
+  return map;
+}
 function blocksToSchemas(blocks) {
   const out = /* @__PURE__ */ Object.create(null);
   for (const block of blocks) {
@@ -60,19 +67,6 @@ function blocksToMeta(blocks, defaults = {}) {
   return out;
 }
 
-// src/components/block-context.ts
-function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms) {
-  return {
-    locale: {
-      current: locale,
-      default: defaultLocale,
-      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
-    },
-    isPreview: isPreview ?? false,
-    forms
-  };
-}
-
 // src/content/get-block-content.ts
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -96,6 +90,19 @@ function getBlockContentForLanguage(content, locale, defaultLocale = "en", avail
   const chosen = localeMap[locale] ?? localeMap[defaultLocale] ?? localeMap[fallbackKey];
   return { ...nonTranslatable, ...chosen };
 }
+
+// src/components/block-context.ts
+function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms) {
+  return {
+    locale: {
+      current: locale,
+      default: defaultLocale,
+      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
+    },
+    isPreview: isPreview ?? false,
+    forms
+  };
+}
 var WARN_CAP = 256;
 var warned = /* @__PURE__ */ new Set();
 function UnknownBlock({ type }) {
@@ -106,12 +113,14 @@ function UnknownBlock({ type }) {
   }
   return /* @__PURE__ */ jsxRuntime.jsx("div", { "data-cmssy-unknown-block": type });
 }
-function renderResolvedBlock(block, map, locale, defaultLocale, context) {
+function renderResolvedBlock(block, map, locale, defaultLocale, options = {}) {
+  const { context, data, resolvedContent, enabledLocales } = options;
   const Component = Object.hasOwn(map, block.type) ? map[block.type] : void 0;
-  const content = getBlockContentForLanguage(
+  const content = resolvedContent ?? getBlockContentForLanguage(
     block.content,
     locale,
-    defaultLocale
+    defaultLocale,
+    enabledLocales?.length ? enabledLocales : void 0
   );
   return /* @__PURE__ */ jsxRuntime.jsx(
     "div",
@@ -119,12 +128,12 @@ function renderResolvedBlock(block, map, locale, defaultLocale, context) {
       "data-block-id": block.id,
       "data-block-type": block.type,
       style: Component ? void 0 : { display: "none" },
-      children: Component ? react.createElement(Component, { content, context }) : /* @__PURE__ */ jsxRuntime.jsx(UnknownBlock, { type: block.type })
+      children: Component ? react.createElement(Component, { content, context, data }) : /* @__PURE__ */ jsxRuntime.jsx(UnknownBlock, { type: block.type })
     },
     block.id
   );
 }
-function CmssyServerPage({
+async function CmssyServerPage({
   page,
   blocks,
   locale = "en",
@@ -134,6 +143,7 @@ function CmssyServerPage({
 }) {
   if (!page) return null;
   const map = buildBlockMap(blocks);
+  const loaderMap = buildLoaderMap(blocks);
   const context = buildBlockContext(
     locale,
     defaultLocale,
@@ -141,8 +151,38 @@ function CmssyServerPage({
     false,
     forms
   );
+  const resolved = await Promise.all(
+    page.blocks.map(async (block) => {
+      const content = getBlockContentForLanguage(
+        block.content,
+        locale,
+        defaultLocale,
+        enabledLocales?.length ? enabledLocales : void 0
+      );
+      const loader = loaderMap[block.type];
+      let data;
+      if (loader) {
+        try {
+          data = await loader({ content, context });
+        } catch (err) {
+          if (typeof console !== "undefined") {
+            console.warn(
+              `[cmssy] loader for block "${block.type}" (${block.id}) failed`,
+              err
+            );
+          }
+        }
+      }
+      return { content, data };
+    })
+  );
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: page.blocks.map(
-    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
+    (block, i) => renderResolvedBlock(block, map, locale, defaultLocale, {
+      context,
+      data: resolved[i]?.data,
+      resolvedContent: resolved[i]?.content,
+      enabledLocales
+    })
   ) });
 }
 function CmssyServerLayout({
@@ -159,7 +199,10 @@ function CmssyServerLayout({
   const map = buildBlockMap(blocks);
   const context = buildBlockContext(locale, defaultLocale, enabledLocales);
   return /* @__PURE__ */ jsxRuntime.jsx(jsxRuntime.Fragment, { children: layoutBlocks.map(
-    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
+    (block) => renderResolvedBlock(block, map, locale, defaultLocale, {
+      context,
+      enabledLocales
+    })
   ) });
 }
 
@@ -642,4 +685,5 @@ exports.parseEditorMessage = parseEditorMessage;
 exports.postToEditor = postToEditor;
 exports.resolveForms = resolveForms;
 exports.resolveSiteLocales = resolveSiteLocales;
+exports.resolveWorkspaceId = resolveWorkspaceId;
 exports.splitLocaleFromPath = splitLocaleFromPath;

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, e as FetchLike, f as CmssyClientConfig, R as RawBlock, g as BlockMap, h as CmssyBlockContext } from './registry-BaFQ2k7r.cjs';
-export { a as BlockMeta, i as BlockRect, B as BlockSchema, j as BoundsMessage, k as ClickMessage, l as CmssyBranding, m as CmssyFormField, n as CmssyFormSettings, o as CmssyFormSubmitResponse, p as CmssyLocaleContext, q as CmssyModelDefinition, r as CmssyModelRecord, s as CmssyRecordList, t as CmssySiteConfig, u as FORM_QUERY, v as FetchLikeResponse, w as FetchPageOptions, x as FieldType, M as MODEL_DEFINITIONS_QUERY, y as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, z as ParentReadyMessage, D as PatchMessage, G as RawLayoutBlock, H as ReadyMessage, S as SITE_CONFIG_QUERY, I as SUBMIT_FORM_MUTATION, J as SelectMessage, K as SubmitFormInput, L as blocksToMeta, N as blocksToSchemas, O as buildBlockContext, Q as buildBlockMap, T as defineBlock, U as fetchLayouts, V as fetchPage, W as isProtocolCompatible, X as normalizeSlug } from './registry-BaFQ2k7r.cjs';
+import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, e as FetchLike, f as CmssyClientConfig, R as RawBlock, g as BlockMap, h as CmssyBlockContext } from './registry-e3O4s_bN.cjs';
+export { a as BlockMeta, i as BlockRect, B as BlockSchema, j as BoundsMessage, k as ClickMessage, l as CmssyBranding, m as CmssyFormField, n as CmssyFormSettings, o as CmssyFormSubmitResponse, p as CmssyLocaleContext, q as CmssyModelDefinition, r as CmssyModelRecord, s as CmssyRecordList, t as CmssySiteConfig, u as FORM_QUERY, v as FetchLikeResponse, w as FetchPageOptions, x as FieldType, M as MODEL_DEFINITIONS_QUERY, y as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, z as ParentReadyMessage, D as PatchMessage, G as RawLayoutBlock, H as ReadyMessage, S as SITE_CONFIG_QUERY, I as SUBMIT_FORM_MUTATION, J as SelectMessage, K as SubmitFormInput, L as blocksToMeta, N as blocksToSchemas, O as buildBlockContext, Q as buildBlockMap, T as defineBlock, U as fetchLayouts, V as fetchPage, W as isProtocolCompatible, X as normalizeSlug } from './registry-e3O4s_bN.cjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
 
@@ -31,7 +31,12 @@ interface CmssyServerPageProps {
     /** Form definitions referenced by page blocks, exposed via context.forms. */
     forms?: Record<string, CmssyFormDefinition>;
 }
-declare function CmssyServerPage({ page, blocks, locale, defaultLocale, enabledLocales, forms, }: CmssyServerPageProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * Async React Server Component (Next.js App Router / RSC). It runs each block's
+ * loader server-side before rendering, so it must be rendered in a server
+ * component tree (as `createCmssyPage` does) - not in a client component.
+ */
+declare function CmssyServerPage({ page, blocks, locale, defaultLocale, enabledLocales, forms, }: CmssyServerPageProps): Promise<react_jsx_runtime.JSX.Element | null>;
 
 interface CmssyServerLayoutProps {
     groups: CmssyLayoutGroup[];
@@ -60,6 +65,8 @@ interface GraphqlRequestOptions {
 }
 declare function graphqlRequest<T>(config: CmssyClientConfig, query: string, variables: Record<string, unknown>, options?: GraphqlRequestOptions, label?: string): Promise<T>;
 
+declare function resolveWorkspaceId(config: CmssyClientConfig, options?: GraphqlRequestOptions): Promise<string>;
+
 interface QueryScopedOptions extends GraphqlRequestOptions {
     workspaceId?: string;
 }
@@ -101,4 +108,4 @@ interface UnknownBlockProps {
 }
 declare function UnknownBlock({ type }: UnknownBlockProps): react_jsx_runtime.JSX.Element;
 
-export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteLocales, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, splitLocaleFromPath };
+export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteLocales, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, resolveWorkspaceId, splitLocaleFromPath };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, e as FetchLike, f as CmssyClientConfig, R as RawBlock, g as BlockMap, h as CmssyBlockContext } from './registry-BaFQ2k7r.js';
-export { a as BlockMeta, i as BlockRect, B as BlockSchema, j as BoundsMessage, k as ClickMessage, l as CmssyBranding, m as CmssyFormField, n as CmssyFormSettings, o as CmssyFormSubmitResponse, p as CmssyLocaleContext, q as CmssyModelDefinition, r as CmssyModelRecord, s as CmssyRecordList, t as CmssySiteConfig, u as FORM_QUERY, v as FetchLikeResponse, w as FetchPageOptions, x as FieldType, M as MODEL_DEFINITIONS_QUERY, y as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, z as ParentReadyMessage, D as PatchMessage, G as RawLayoutBlock, H as ReadyMessage, S as SITE_CONFIG_QUERY, I as SUBMIT_FORM_MUTATION, J as SelectMessage, K as SubmitFormInput, L as blocksToMeta, N as blocksToSchemas, O as buildBlockContext, Q as buildBlockMap, T as defineBlock, U as fetchLayouts, V as fetchPage, W as isProtocolCompatible, X as normalizeSlug } from './registry-BaFQ2k7r.js';
+import { F as FieldDefinition, C as CmssyPageData, b as BlockDefinition, c as CmssyFormDefinition, d as CmssyLayoutGroup, E as EditorToAppMessage, A as AppToEditorMessage, e as FetchLike, f as CmssyClientConfig, R as RawBlock, g as BlockMap, h as CmssyBlockContext } from './registry-e3O4s_bN.js';
+export { a as BlockMeta, i as BlockRect, B as BlockSchema, j as BoundsMessage, k as ClickMessage, l as CmssyBranding, m as CmssyFormField, n as CmssyFormSettings, o as CmssyFormSubmitResponse, p as CmssyLocaleContext, q as CmssyModelDefinition, r as CmssyModelRecord, s as CmssyRecordList, t as CmssySiteConfig, u as FORM_QUERY, v as FetchLikeResponse, w as FetchPageOptions, x as FieldType, M as MODEL_DEFINITIONS_QUERY, y as MODEL_RECORDS_QUERY, P as PROTOCOL_VERSION, z as ParentReadyMessage, D as PatchMessage, G as RawLayoutBlock, H as ReadyMessage, S as SITE_CONFIG_QUERY, I as SUBMIT_FORM_MUTATION, J as SelectMessage, K as SubmitFormInput, L as blocksToMeta, N as blocksToSchemas, O as buildBlockContext, Q as buildBlockMap, T as defineBlock, U as fetchLayouts, V as fetchPage, W as isProtocolCompatible, X as normalizeSlug } from './registry-e3O4s_bN.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import 'react';
 
@@ -31,7 +31,12 @@ interface CmssyServerPageProps {
     /** Form definitions referenced by page blocks, exposed via context.forms. */
     forms?: Record<string, CmssyFormDefinition>;
 }
-declare function CmssyServerPage({ page, blocks, locale, defaultLocale, enabledLocales, forms, }: CmssyServerPageProps): react_jsx_runtime.JSX.Element | null;
+/**
+ * Async React Server Component (Next.js App Router / RSC). It runs each block's
+ * loader server-side before rendering, so it must be rendered in a server
+ * component tree (as `createCmssyPage` does) - not in a client component.
+ */
+declare function CmssyServerPage({ page, blocks, locale, defaultLocale, enabledLocales, forms, }: CmssyServerPageProps): Promise<react_jsx_runtime.JSX.Element | null>;
 
 interface CmssyServerLayoutProps {
     groups: CmssyLayoutGroup[];
@@ -60,6 +65,8 @@ interface GraphqlRequestOptions {
 }
 declare function graphqlRequest<T>(config: CmssyClientConfig, query: string, variables: Record<string, unknown>, options?: GraphqlRequestOptions, label?: string): Promise<T>;
 
+declare function resolveWorkspaceId(config: CmssyClientConfig, options?: GraphqlRequestOptions): Promise<string>;
+
 interface QueryScopedOptions extends GraphqlRequestOptions {
     workspaceId?: string;
 }
@@ -101,4 +108,4 @@ interface UnknownBlockProps {
 }
 declare function UnknownBlock({ type }: UnknownBlockProps): react_jsx_runtime.JSX.Element;
 
-export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteLocales, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, splitLocaleFromPath };
+export { AppToEditorMessage, BlockDefinition, BlockMap, CmssyBlock, CmssyBlockContext, type CmssyBlockProps, type CmssyClient, CmssyClientConfig, CmssyFormDefinition, CmssyLayoutGroup, CmssyPageData, CmssyServerLayout, type CmssyServerLayoutProps, CmssyServerPage, type CmssyServerPageProps, type CmssySiteLocales, EditorToAppMessage, FetchLike, type FieldControl, FieldDefinition, type GraphqlRequestOptions, type PostTarget, type QueryScopedOptions, RawBlock, UnknownBlock, type UnknownBlockProps, collectFormIds, createCmssyClient, fields, getBlockContentForLanguage, graphqlRequest, normalizeOrigin, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, resolveWorkspaceId, splitLocaleFromPath };

package/dist/index.js

@@ -33,6 +33,13 @@ function buildBlockMap(blocks) {
   for (const block of blocks) map[block.type] = block.component;
   return map;
 }
+function buildLoaderMap(blocks) {
+  const map = /* @__PURE__ */ Object.create(null);
+  for (const block of blocks) {
+    if (block.loader) map[block.type] = block.loader;
+  }
+  return map;
+}
 function blocksToSchemas(blocks) {
   const out = /* @__PURE__ */ Object.create(null);
   for (const block of blocks) {
@@ -58,19 +65,6 @@ function blocksToMeta(blocks, defaults = {}) {
   return out;
 }
 
-// src/components/block-context.ts
-function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms) {
-  return {
-    locale: {
-      current: locale,
-      default: defaultLocale,
-      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
-    },
-    isPreview: isPreview ?? false,
-    forms
-  };
-}
-
 // src/content/get-block-content.ts
 function isPlainObject(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
@@ -94,6 +88,19 @@ function getBlockContentForLanguage(content, locale, defaultLocale = "en", avail
   const chosen = localeMap[locale] ?? localeMap[defaultLocale] ?? localeMap[fallbackKey];
   return { ...nonTranslatable, ...chosen };
 }
+
+// src/components/block-context.ts
+function buildBlockContext(locale, defaultLocale, enabledLocales, isPreview, forms) {
+  return {
+    locale: {
+      current: locale,
+      default: defaultLocale,
+      enabled: enabledLocales && enabledLocales.length > 0 ? enabledLocales : Array.from(/* @__PURE__ */ new Set([defaultLocale, locale]))
+    },
+    isPreview: isPreview ?? false,
+    forms
+  };
+}
 var WARN_CAP = 256;
 var warned = /* @__PURE__ */ new Set();
 function UnknownBlock({ type }) {
@@ -104,12 +111,14 @@ function UnknownBlock({ type }) {
   }
   return /* @__PURE__ */ jsx("div", { "data-cmssy-unknown-block": type });
 }
-function renderResolvedBlock(block, map, locale, defaultLocale, context) {
+function renderResolvedBlock(block, map, locale, defaultLocale, options = {}) {
+  const { context, data, resolvedContent, enabledLocales } = options;
   const Component = Object.hasOwn(map, block.type) ? map[block.type] : void 0;
-  const content = getBlockContentForLanguage(
+  const content = resolvedContent ?? getBlockContentForLanguage(
     block.content,
     locale,
-    defaultLocale
+    defaultLocale,
+    enabledLocales?.length ? enabledLocales : void 0
   );
   return /* @__PURE__ */ jsx(
     "div",
@@ -117,12 +126,12 @@ function renderResolvedBlock(block, map, locale, defaultLocale, context) {
       "data-block-id": block.id,
       "data-block-type": block.type,
       style: Component ? void 0 : { display: "none" },
-      children: Component ? createElement(Component, { content, context }) : /* @__PURE__ */ jsx(UnknownBlock, { type: block.type })
+      children: Component ? createElement(Component, { content, context, data }) : /* @__PURE__ */ jsx(UnknownBlock, { type: block.type })
     },
     block.id
   );
 }
-function CmssyServerPage({
+async function CmssyServerPage({
   page,
   blocks,
   locale = "en",
@@ -132,6 +141,7 @@ function CmssyServerPage({
 }) {
   if (!page) return null;
   const map = buildBlockMap(blocks);
+  const loaderMap = buildLoaderMap(blocks);
   const context = buildBlockContext(
     locale,
     defaultLocale,
@@ -139,8 +149,38 @@ function CmssyServerPage({
     false,
     forms
   );
+  const resolved = await Promise.all(
+    page.blocks.map(async (block) => {
+      const content = getBlockContentForLanguage(
+        block.content,
+        locale,
+        defaultLocale,
+        enabledLocales?.length ? enabledLocales : void 0
+      );
+      const loader = loaderMap[block.type];
+      let data;
+      if (loader) {
+        try {
+          data = await loader({ content, context });
+        } catch (err) {
+          if (typeof console !== "undefined") {
+            console.warn(
+              `[cmssy] loader for block "${block.type}" (${block.id}) failed`,
+              err
+            );
+          }
+        }
+      }
+      return { content, data };
+    })
+  );
   return /* @__PURE__ */ jsx(Fragment, { children: page.blocks.map(
-    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
+    (block, i) => renderResolvedBlock(block, map, locale, defaultLocale, {
+      context,
+      data: resolved[i]?.data,
+      resolvedContent: resolved[i]?.content,
+      enabledLocales
+    })
   ) });
 }
 function CmssyServerLayout({
@@ -157,7 +197,10 @@ function CmssyServerLayout({
   const map = buildBlockMap(blocks);
   const context = buildBlockContext(locale, defaultLocale, enabledLocales);
   return /* @__PURE__ */ jsx(Fragment, { children: layoutBlocks.map(
-    (block) => renderResolvedBlock(block, map, locale, defaultLocale, context)
+    (block) => renderResolvedBlock(block, map, locale, defaultLocale, {
+      context,
+      enabledLocales
+    })
   ) });
 }
 
@@ -611,4 +654,4 @@ function CmssyBlock({
   );
 }
 
-export { CmssyBlock, CmssyServerLayout, CmssyServerPage, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, PROTOCOL_VERSION, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, UnknownBlock, blocksToMeta, blocksToSchemas, buildBlockContext, buildBlockMap, collectFormIds, createCmssyClient, defineBlock, fetchLayouts, fetchPage, fields, getBlockContentForLanguage, graphqlRequest, isProtocolCompatible, normalizeOrigin, normalizeSlug, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, splitLocaleFromPath };
+export { CmssyBlock, CmssyServerLayout, CmssyServerPage, FORM_QUERY, MODEL_DEFINITIONS_QUERY, MODEL_RECORDS_QUERY, PROTOCOL_VERSION, SITE_CONFIG_QUERY, SUBMIT_FORM_MUTATION, UnknownBlock, blocksToMeta, blocksToSchemas, buildBlockContext, buildBlockMap, collectFormIds, createCmssyClient, defineBlock, fetchLayouts, fetchPage, fields, getBlockContentForLanguage, graphqlRequest, isProtocolCompatible, normalizeOrigin, normalizeSlug, parseEditorMessage, postToEditor, resolveForms, resolveSiteLocales, resolveWorkspaceId, splitLocaleFromPath };

package/dist/{registry-BaFQ2k7r.d.cts → registry-e3O4s_bN.d.cts}

@@ -256,6 +256,11 @@ interface DragEndMessage {
 type EditorToAppMessage = SelectMessage | PatchMessage | ParentReadyMessage | InsertMessage | ReorderMessage | RemoveMessage | DragOverMessage | DragEndMessage;
 declare function isProtocolCompatible(version: number): boolean;
 
+interface BlockLoaderArgs {
+    content: Record<string, unknown>;
+    context?: CmssyBlockContext;
+}
+type BlockLoader = (args: BlockLoaderArgs) => Promise<unknown> | unknown;
 interface BlockDefinition {
     type: string;
     label?: string;
@@ -263,26 +268,43 @@ interface BlockDefinition {
     icon?: string;
     layoutPositions?: string[];
     props: Record<string, FieldDefinition>;
+    /**
+     * Optional server-side data loader. Run by CmssyServerPage during SSR; its
+     * result is passed to the component as the `data` prop. Not run in the
+     * editor (the component receives `data: undefined` there).
+     *
+     * The result crosses the server→client boundary when the block component is a
+     * Client Component, so it must be RSC-serializable (plain objects, arrays and
+     * primitives - no functions, class instances, etc.).
+     */
+    loader?: BlockLoader;
     component: ComponentType<{
         content: Record<string, unknown>;
         context?: CmssyBlockContext;
+        data?: unknown;
     }>;
 }
-declare function defineBlock<C extends Record<string, unknown>>(def: {
+declare function defineBlock<C extends Record<string, unknown>, D = unknown>(def: {
     type: string;
     label?: string;
     category?: string;
     icon?: string;
     layoutPositions?: string[];
     props: Record<string, FieldDefinition>;
+    loader?: (args: {
+        content: C;
+        context?: CmssyBlockContext;
+    }) => Promise<D> | D;
     component: ComponentType<{
         content: C;
         context?: CmssyBlockContext;
+        data?: D;
     }>;
 }): BlockDefinition;
 type BlockMap = Record<string, ComponentType<{
     content: Record<string, unknown>;
     context?: CmssyBlockContext;
+    data?: unknown;
 }>>;
 declare function buildBlockMap(blocks: BlockDefinition[]): BlockMap;
 declare function blocksToSchemas(blocks: BlockDefinition[]): Record<string, BlockSchema>;

package/dist/{registry-BaFQ2k7r.d.ts → registry-e3O4s_bN.d.ts}

@@ -256,6 +256,11 @@ interface DragEndMessage {
 type EditorToAppMessage = SelectMessage | PatchMessage | ParentReadyMessage | InsertMessage | ReorderMessage | RemoveMessage | DragOverMessage | DragEndMessage;
 declare function isProtocolCompatible(version: number): boolean;
 
+interface BlockLoaderArgs {
+    content: Record<string, unknown>;
+    context?: CmssyBlockContext;
+}
+type BlockLoader = (args: BlockLoaderArgs) => Promise<unknown> | unknown;
 interface BlockDefinition {
     type: string;
     label?: string;
@@ -263,26 +268,43 @@ interface BlockDefinition {
     icon?: string;
     layoutPositions?: string[];
     props: Record<string, FieldDefinition>;
+    /**
+     * Optional server-side data loader. Run by CmssyServerPage during SSR; its
+     * result is passed to the component as the `data` prop. Not run in the
+     * editor (the component receives `data: undefined` there).
+     *
+     * The result crosses the server→client boundary when the block component is a
+     * Client Component, so it must be RSC-serializable (plain objects, arrays and
+     * primitives - no functions, class instances, etc.).
+     */
+    loader?: BlockLoader;
     component: ComponentType<{
         content: Record<string, unknown>;
         context?: CmssyBlockContext;
+        data?: unknown;
     }>;
 }
-declare function defineBlock<C extends Record<string, unknown>>(def: {
+declare function defineBlock<C extends Record<string, unknown>, D = unknown>(def: {
     type: string;
     label?: string;
     category?: string;
     icon?: string;
     layoutPositions?: string[];
     props: Record<string, FieldDefinition>;
+    loader?: (args: {
+        content: C;
+        context?: CmssyBlockContext;
+    }) => Promise<D> | D;
     component: ComponentType<{
         content: C;
         context?: CmssyBlockContext;
+        data?: D;
     }>;
 }): BlockDefinition;
 type BlockMap = Record<string, ComponentType<{
     content: Record<string, unknown>;
     context?: CmssyBlockContext;
+    data?: unknown;
 }>>;
 declare function buildBlockMap(blocks: BlockDefinition[]): BlockMap;
 declare function blocksToSchemas(blocks: BlockDefinition[]): Record<string, BlockSchema>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/react",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "description": "React blocks, renderers, data client and editor bridge for cmssy headless sites",
   "keywords": [
     "cmssy",