@cmssy/next 0.1.0 → 0.1.2

package/README.md

@@ -0,0 +1,64 @@
+# @cmssy/next
+
+Next.js (App Router) bindings for a [cmssy](https://cmssy.com) headless site.
+One catch-all route renders your published cmssy content with local block
+components, with live edit-mode preview built in. Pairs with
+[`@cmssy/react`](https://www.npmjs.com/package/@cmssy/react) (blocks + data).
+
+```bash
+pnpm add @cmssy/next @cmssy/react
+```
+
+## Render every page
+
+```tsx
+// app/[[...path]]/page.tsx
+import { createCmssyPage } from "@cmssy/next";
+import { cmssy } from "@/cmssy/config";
+import { blocks } from "@/cmssy/blocks";
+import { CmssyEditor } from "@/cmssy/editor";
+
+export default createCmssyPage(cmssy, blocks, { editor: CmssyEditor });
+```
+
+```ts
+// cmssy/config.ts
+import type { CmssyNextConfig } from "@cmssy/next";
+
+export const cmssy: CmssyNextConfig = {
+  apiUrl: process.env.CMSSY_API_URL ?? "", // public GraphQL delivery endpoint
+  workspaceSlug: process.env.CMSSY_WORKSPACE_SLUG ?? "",
+  draftSecret: process.env.CMSSY_DRAFT_SECRET ?? "", // edit-mode preview handshake
+  editorOrigin: process.env.CMSSY_EDITOR_ORIGIN ?? "", // only needed in edit mode
+  defaultLocale: "en",
+};
+```
+
+`createCmssyPage` fetches the page for the request path and renders it. In edit
+mode (draft cookie or `?cmssyEdit=1`) it renders your `editor` instead and frames
+the live-edit bridge. A published build does **not** require `editorOrigin`.
+
+## Draft preview
+
+```ts
+// app/api/draft/route.ts
+import { createDraftRoute } from "@cmssy/next";
+export const GET = createDraftRoute(cmssy);
+```
+
+## Edit-mode CSP
+
+```ts
+import { cmssyCspHeaders, applyCmssyCsp } from "@cmssy/next";
+```
+
+Helpers to frame the page inside the cmssy editor only in edit mode.
+
+## Exports
+
+`createCmssyPage`, `createDraftRoute`, `cmssyCspHeaders` / `applyCmssyCsp`,
+`isCmssyEditRequest` / `isCmssyEditMode`, and the `CmssyNextConfig` type.
+
+## License
+
+MIT

package/dist/index.cjs

@@ -96,6 +96,7 @@ function createCmssyPage(config, blocks, options) {
           page,
           locale,
           defaultLocale,
+          enabledLocales: config.enabledLocales,
           edit: { editorOrigin: bridgeOrigin }
         }
       );
@@ -106,7 +107,8 @@ function createCmssyPage(config, blocks, options) {
         page,
         blocks,
         locale,
-        defaultLocale
+        defaultLocale,
+        enabledLocales: config.enabledLocales
       }
     );
   };

package/dist/index.d.cts

@@ -9,6 +9,8 @@ interface CmssyNextConfig {
     draftSecret: string;
     editorOrigin: string | string[];
     defaultLocale?: string;
+    /** All languages enabled on the workspace; exposed to blocks via context.locale.enabled. */
+    enabledLocales?: string[];
     resolveLocale?: () => string | Promise<string>;
 }
 
@@ -16,6 +18,7 @@ interface CmssyEditorProps {
     page: CmssyPageData;
     locale: string;
     defaultLocale: string;
+    enabledLocales?: string[];
     edit: EditBridgeConfig;
 }
 interface CreateCmssyPageOptions {

package/dist/index.d.ts

@@ -9,6 +9,8 @@ interface CmssyNextConfig {
     draftSecret: string;
     editorOrigin: string | string[];
     defaultLocale?: string;
+    /** All languages enabled on the workspace; exposed to blocks via context.locale.enabled. */
+    enabledLocales?: string[];
     resolveLocale?: () => string | Promise<string>;
 }
 
@@ -16,6 +18,7 @@ interface CmssyEditorProps {
     page: CmssyPageData;
     locale: string;
     defaultLocale: string;
+    enabledLocales?: string[];
     edit: EditBridgeConfig;
 }
 interface CreateCmssyPageOptions {

package/dist/index.js

@@ -94,6 +94,7 @@ function createCmssyPage(config, blocks, options) {
           page,
           locale,
           defaultLocale,
+          enabledLocales: config.enabledLocales,
           edit: { editorOrigin: bridgeOrigin }
         }
       );
@@ -104,7 +105,8 @@ function createCmssyPage(config, blocks, options) {
         page,
         blocks,
         locale,
-        defaultLocale
+        defaultLocale,
+        enabledLocales: config.enabledLocales
       }
     );
   };

package/package.json

@@ -1,6 +1,21 @@
 {
   "name": "@cmssy/next",
-  "version": "0.1.0",
+  "version": "0.1.2",
+  "description": "Next.js App Router bindings for cmssy headless sites (createCmssyPage + draft preview)",
+  "keywords": [
+    "cmssy",
+    "cms",
+    "headless",
+    "nextjs",
+    "next",
+    "app-router"
+  ],
+  "homepage": "https://cmssy.com",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cmssy-io/cmssy-sdk.git",
+    "directory": "packages/next"
+  },
   "type": "module",
   "license": "MIT",
   "publishConfig": {
@@ -21,7 +36,7 @@
     "dist"
   ],
   "peerDependencies": {
-    "@cmssy/react": "^0.1.0",
+    "@cmssy/react": "^0.1.2",
     "next": ">=15",
     "react": "^18.2.0 || ^19.0.0",
     "react-dom": "^18.2.0 || ^19.0.0"
@@ -34,7 +49,7 @@
     "tsup": "^8.3.0",
     "typescript": "^5.6.0",
     "vitest": "^2.1.0",
-    "@cmssy/react": "0.1.0"
+    "@cmssy/react": "0.1.2"
   },
   "scripts": {
     "build": "tsup",