@cmssy/next 0.14.0 → 0.17.0

package/README.md

@@ -23,14 +23,18 @@ export default createCmssyPage(cmssy, blocks, { editor: CmssyEditor });
 
 ```ts
 // cmssy/config.ts
-import type { CmssyNextConfig } from "@cmssy/next";
-
-export const cmssy: CmssyNextConfig = {
-  workspaceSlug: process.env.CMSSY_WORKSPACE_SLUG ?? "",
-  draftSecret: process.env.CMSSY_DRAFT_SECRET ?? "", // edit-mode preview handshake
+import { defineCmssyConfig } from "@cmssy/next";
+
+// defineCmssyConfig validates the required env vars and throws a clear error if
+// any is missing - never mask them with `?? ""` (an empty org/slug builds a
+// broken delivery URL like `/public//graphql`).
+export const cmssy = defineCmssyConfig({
+  org: process.env.CMSSY_ORG_SLUG,
+  workspaceSlug: process.env.CMSSY_WORKSPACE_SLUG,
+  draftSecret: process.env.CMSSY_DRAFT_SECRET, // edit-mode preview handshake
   defaultLocale: "en",
   // apiUrl + editorOrigin default to cmssy cloud; set them only for self-host/staging.
-};
+});
 ```
 
 `createCmssyPage` fetches the page for the request path and renders it. In edit

package/dist/index.cjs

@@ -96,6 +96,7 @@ function resolveEditorOrigin(editorOrigin) {
   return value.trim().length > 0 ? value : DEFAULT_CMSSY_EDITOR_ORIGINS;
 }
 var REQUIRED_CONFIG_ENV = [
+  ["org", "CMSSY_ORG_SLUG"],
   ["workspaceSlug", "CMSSY_WORKSPACE_SLUG"],
   ["draftSecret", "CMSSY_DRAFT_SECRET"]
 ];
@@ -216,6 +217,7 @@ function createCmssyPage(config, blocks, options) {
   const Editor = options?.editor;
   const clientConfig = {
     apiUrl: config.apiUrl,
+    org: config.org,
     workspaceSlug: config.workspaceSlug
   };
   const client$1 = react.createCmssyClient(clientConfig);
@@ -370,6 +372,7 @@ function createCmssyNotFound(config, blocks, options) {
   }
   const clientConfig = {
     apiUrl: config.apiUrl,
+    org: config.org,
     workspaceSlug: config.workspaceSlug
   };
   const fallback = options?.fallback ?? /* @__PURE__ */ jsxRuntime.jsx(DefaultNotFound, {});
@@ -488,6 +491,7 @@ function localizedPath(slug, locale, defaultLocale) {
 function createCmssySitemap(config, options = {}) {
   const clientConfig = {
     apiUrl: config.apiUrl,
+    org: config.org,
     workspaceSlug: config.workspaceSlug
   };
   return async function sitemap() {
@@ -539,6 +543,7 @@ function pick(value, locale, defaultLocale) {
 async function buildCmssyMetadata(config, path, options = {}) {
   const clientConfig = {
     apiUrl: config.apiUrl,
+    org: config.org,
     workspaceSlug: config.workspaceSlug
   };
   const [meta, siteConfig, baseUrl] = await Promise.all([
@@ -669,6 +674,7 @@ async function resolveLocaleFromPathname(config, pathname) {
   const hasStaticLocales = !!config.enabledLocales?.length;
   const fetched = config.defaultLocale && hasStaticLocales ? null : await react.resolveSiteLocales({
     apiUrl: config.apiUrl,
+    org: config.org,
     workspaceSlug: config.workspaceSlug
   });
   const siteLocales = {

package/dist/index.d.cts

@@ -18,6 +18,8 @@ interface CmssyNextConfig {
      * (`https://api.cmssy.io/graphql`); set it only for self-hosted / staging.
      */
     apiUrl?: string;
+    /** Organization slug - part of the org-scoped delivery path. */
+    org: string;
     workspaceSlug: string;
     draftSecret: string;
     /**
@@ -53,7 +55,8 @@ interface CmssyNextConfig {
  * through without a `?? ""` fallback (which would mask a missing value as an
  * empty string) or a cast.
  */
-type CmssyEnvConfig = Omit<CmssyNextConfig, "workspaceSlug" | "draftSecret"> & {
+type CmssyEnvConfig = Omit<CmssyNextConfig, "org" | "workspaceSlug" | "draftSecret"> & {
+    org?: string;
     workspaceSlug?: string;
     draftSecret?: string;
 };

package/dist/index.d.ts

@@ -18,6 +18,8 @@ interface CmssyNextConfig {
      * (`https://api.cmssy.io/graphql`); set it only for self-hosted / staging.
      */
     apiUrl?: string;
+    /** Organization slug - part of the org-scoped delivery path. */
+    org: string;
     workspaceSlug: string;
     draftSecret: string;
     /**
@@ -53,7 +55,8 @@ interface CmssyNextConfig {
  * through without a `?? ""` fallback (which would mask a missing value as an
  * empty string) or a cast.
  */
-type CmssyEnvConfig = Omit<CmssyNextConfig, "workspaceSlug" | "draftSecret"> & {
+type CmssyEnvConfig = Omit<CmssyNextConfig, "org" | "workspaceSlug" | "draftSecret"> & {
+    org?: string;
     workspaceSlug?: string;
     draftSecret?: string;
 };

package/dist/index.js

@@ -95,6 +95,7 @@ function resolveEditorOrigin(editorOrigin) {
   return value.trim().length > 0 ? value : DEFAULT_CMSSY_EDITOR_ORIGINS;
 }
 var REQUIRED_CONFIG_ENV = [
+  ["org", "CMSSY_ORG_SLUG"],
   ["workspaceSlug", "CMSSY_WORKSPACE_SLUG"],
   ["draftSecret", "CMSSY_DRAFT_SECRET"]
 ];
@@ -215,6 +216,7 @@ function createCmssyPage(config, blocks, options) {
   const Editor = options?.editor;
   const clientConfig = {
     apiUrl: config.apiUrl,
+    org: config.org,
     workspaceSlug: config.workspaceSlug
   };
   const client = createCmssyClient(clientConfig);
@@ -369,6 +371,7 @@ function createCmssyNotFound(config, blocks, options) {
   }
   const clientConfig = {
     apiUrl: config.apiUrl,
+    org: config.org,
     workspaceSlug: config.workspaceSlug
   };
   const fallback = options?.fallback ?? /* @__PURE__ */ jsx(DefaultNotFound, {});
@@ -487,6 +490,7 @@ function localizedPath(slug, locale, defaultLocale) {
 function createCmssySitemap(config, options = {}) {
   const clientConfig = {
     apiUrl: config.apiUrl,
+    org: config.org,
     workspaceSlug: config.workspaceSlug
   };
   return async function sitemap() {
@@ -538,6 +542,7 @@ function pick(value, locale, defaultLocale) {
 async function buildCmssyMetadata(config, path, options = {}) {
   const clientConfig = {
     apiUrl: config.apiUrl,
+    org: config.org,
     workspaceSlug: config.workspaceSlug
   };
   const [meta, siteConfig, baseUrl] = await Promise.all([
@@ -668,6 +673,7 @@ async function resolveLocaleFromPathname(config, pathname) {
   const hasStaticLocales = !!config.enabledLocales?.length;
   const fetched = config.defaultLocale && hasStaticLocales ? null : await resolveSiteLocales({
     apiUrl: config.apiUrl,
+    org: config.org,
     workspaceSlug: config.workspaceSlug
   });
   const siteLocales = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cmssy/next",
-  "version": "0.14.0",
+  "version": "0.17.0",
   "description": "Next.js App Router bindings for cmssy headless sites (createCmssyPage + draft preview)",
   "keywords": [
     "cmssy",
@@ -41,7 +41,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "@cmssy/react": "^0.14.0",
+    "@cmssy/react": "^0.17.0",
     "next": ">=15",
     "react": "^18.2.0 || ^19.0.0",
     "react-dom": "^18.2.0 || ^19.0.0"
@@ -55,7 +55,7 @@
     "tsup": "^8.3.0",
     "typescript": "^5.6.0",
     "vitest": "^2.1.0",
-    "@cmssy/react": "0.14.0"
+    "@cmssy/react": "0.17.0"
   },
   "dependencies": {
     "jose": "^6.2.3"