@se-studio/contentful-cms 1.0.10 → 1.0.12

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @se-studio/contentful-cms Changelog
 
+## 1.0.12
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+
+## 1.0.11
+
+### Patch Changes
+
+- Bulk version bump: patch for all packages
+
 ## 1.0.10
 
 ### Patch Changes

package/README.md

@@ -251,7 +251,7 @@ Capture a PNG of a component, collection, external component, person, or page. *
 
 | Target | Command |
 |--------|---------|
-| Session ref (full-fidelity) | `cms-edit screenshot @c0` — all types (component, collection, externalComponent, person) via convert API and `/cms-preview/render-json` |
+| Session ref (full-fidelity) | `cms-edit screenshot @c0` — all types (component, collection, externalComponent, person) via convert API and `/cms/preview/render-json` |
 | JSON file (no Contentful) | `cms-edit screenshot --json-file path/to/entry.json` — IBase* JSON; validates or screenshots without a session |
 | By type (mock, no session) | `cms-edit screenshot --component HeroSimple`, `cms-edit screenshot --collection CardGrid` |
 | Page | `cms-edit screenshot` (current page) or `cms-edit screenshot /pricing` |

package/dist/commands/screenshot.js

@@ -14,9 +14,9 @@ const DEFAULT_VIEWPORT_WIDTH = 1280;
 const DEFAULT_VIEWPORT_HEIGHT = 900;
 const DEFAULT_BASE_URL = 'http://localhost:3000';
 function isComponentOrCollectionUrl(url) {
-    return (url.includes('/cms-showcase/render') ||
-        url.includes('/cms-preview/render') ||
-        url.includes('/cms-preview/render-json'));
+    return (url.includes('/cms/showcase/render') ||
+        url.includes('/cms/preview/render') ||
+        url.includes('/cms/preview/render-json'));
 }
 /** Collect repeatable --param key=value into an array. */
 function collectParam(value, prev) {
@@ -50,7 +50,7 @@ export function registerScreenshotCommand(program) {
         '    --collection CardGrid')
         .option('--component <type>', 'Showcase a component by type name (no session needed)')
         .option('--collection <type>', 'Showcase a collection by type name (no session needed)')
-        .option('--live', 'Fetch real Contentful data via /cms-preview/render?id=... (requires preview token)')
+        .option('--live', 'Fetch real Contentful data via /cms/preview/render?id=... (requires preview token)')
         .option('--out <path>', 'Output file path (default: ./screenshot-<type>-<timestamp>.png)')
         .option('--full', 'Capture the full scrollable page (passed to agent-browser)')
         .option('--embedded', 'Append &embedded=true to showcase URL (suppresses IframeHeightReporter)')
@@ -81,7 +81,7 @@ export function registerScreenshotCommand(program) {
                 const raw = fs.readFileSync(opts.jsonFile, 'utf-8');
                 const data = JSON.parse(raw);
                 const encoded = Buffer.from(raw, 'utf-8').toString('base64');
-                url = appendRequestParams(`${baseUrl}/cms-preview/render-json?data=${encoded}`, requestParams);
+                url = appendRequestParams(`${baseUrl}/cms/preview/render-json?data=${encoded}`, requestParams);
                 displayType = data?.type ?? 'json';
             }
             else if (opts.component || opts.collection) {
@@ -111,7 +111,7 @@ export function registerScreenshotCommand(program) {
                     throw new Error('Convert API returned no data.');
                 }
                 const encoded = Buffer.from(JSON.stringify(data), 'utf-8').toString('base64');
-                url = appendRequestParams(`${baseUrl}/cms-preview/render-json?data=${encoded}`, requestParams);
+                url = appendRequestParams(`${baseUrl}/cms/preview/render-json?data=${encoded}`, requestParams);
                 displayType = data?.type ?? entryId;
             }
             else if (target?.startsWith('/') || target?.startsWith('http')) {
@@ -254,7 +254,7 @@ function buildShowcaseUrl(baseUrl, type, mode, fields, embedded, clean, requestP
             params.set(key, value);
         }
     }
-    return `${baseUrl}/cms-showcase/render?${params.toString()}`;
+    return `${baseUrl}/cms/showcase/render?${params.toString()}`;
 }
 /** Appends requestParams as query parameters to an arbitrary URL. */
 function appendRequestParams(url, requestParams) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@se-studio/contentful-cms",
-  "version": "1.0.10",
+  "version": "1.0.12",
   "description": "CLI tool for AI agents to read and edit Contentful draft content without publish permissions",
   "repository": {
     "type": "git",

package/skills/cms-guidelines/README.md

@@ -17,7 +17,7 @@ Guidelines are short markdown fragments — one per CMS type — that describe h
    ```bash
    pnpm --filter <appName> generate-showcase
    ```
-   This writes `src/cms-showcase/showcase-examples.json`.
+   This writes `src/generated/showcase-examples.json`.
 3. **Curate showcase mocks** — run the [curate-showcase-mocks skill](.cursor/skills/se-marketing-sites/curate-showcase-mocks/SKILL.md) to select the best examples into `showcase-mocks.json`. This makes the showcase (and screenshots) show realistic content.
 4. **Generate field list** — parse TypeScript types to produce structured field metadata:
    ```bash

package/skills/core/SKILL.md

@@ -422,7 +422,7 @@ If omitted, defaults to `http://localhost:3000` with a warning.
 
 ### From session ref (full-fidelity)
 
-`cms-edit screenshot @c0` uses the app's convert API and `/cms-preview/render-json` so **all** entry types render with real converted data: component, collection, externalComponent, person. No separate "mock vs live" for refs.
+`cms-edit screenshot @c0` uses the app's convert API and `/cms/preview/render-json` so **all** entry types render with real converted data: component, collection, externalComponent, person. No separate "mock vs live" for refs.
 
 ```bash
 # Any entry type (component, collection, externalComponent, person)
@@ -445,7 +445,7 @@ cms-edit screenshot --json-file path/to/component.json
 
 ### By type (showcase mock, no session)
 
-Uses `/cms-showcase/render` with mock data. Fast, no preview token.
+Uses `/cms/showcase/render` with mock data. Fast, no preview token.
 
 ```bash
 cms-edit screenshot --component HeroSimple
@@ -469,7 +469,7 @@ cms-edit screenshot /about-us --full
 | Flag | Description |
 |------|-------------|
 | `--json-file <path>` | Read IBase* JSON from file and screenshot via render-json (no Contentful) |
-| `--live` | Legacy: use `/cms-preview/render?id=...` for ref (optional; @ref is already full-fidelity) |
+| `--live` | Legacy: use `/cms/preview/render?id=...` for ref (optional; @ref is already full-fidelity) |
 | `--out <path>` | Output file path (default: `./screenshot-<type>-<timestamp>.png`) |
 | `--full` | Full-page capture (passed to `agent-browser screenshot --full`) |
 | `--embedded` | Append `&embedded=true` to showcase URL (suppresses IframeHeightReporter) |

package/skills/screenshots/SKILL.md

@@ -10,9 +10,9 @@ Use this skill when capturing **screenshots** of components, collections, pages,
 
 ## Commands
 
-- **From session ref** (full-fidelity): `cms-edit screenshot @c0` — uses the convert API and `/cms-preview/render-json` so **all** entry types render with real data: component, collection, externalComponent, person. Add `--full` for full-page capture (auto-applied for component/collection).
-- **From JSON file** (no Contentful): `cms-edit screenshot --json-file path/to/entry.json` — reads an IBase* JSON (e.g. from `read @c0 --json` or an export), base64-encodes it, and opens `/cms-preview/render-json?data=...`. Use to validate or screenshot without a session or preview token.
-- **By type** (no session, mock): `cms-edit screenshot --component HeroSimple`, `cms-edit screenshot --collection CardGrid` — uses `/cms-showcase/render` with mock data.
+- **From session ref** (full-fidelity): `cms-edit screenshot @c0` — uses the convert API and `/cms/preview/render-json` so **all** entry types render with real data: component, collection, externalComponent, person. Add `--full` for full-page capture (auto-applied for component/collection).
+- **From JSON file** (no Contentful): `cms-edit screenshot --json-file path/to/entry.json` — reads an IBase* JSON (e.g. from `read @c0 --json` or an export), base64-encodes it, and opens `/cms/preview/render-json?data=...`. Use to validate or screenshot without a session or preview token.
+- **By type** (no session, mock): `cms-edit screenshot --component HeroSimple`, `cms-edit screenshot --collection CardGrid` — uses `/cms/showcase/render` with mock data.
 - **Page**: `cms-edit screenshot` (current open page) or `cms-edit screenshot /resources/publications/other/my-slug`
 - **URL only** (no agent-browser needed): `cms-edit screenshot @c0 --url-only`
 
@@ -29,8 +29,8 @@ Check the site's URL structure (e.g. `/resources/publications/<type>/<slug>`) an
 
 When using `--component <type>` or `--collection <type>` (no session), the default is **mock** (showcase). Use `--live` with a ref to prefer the legacy direct preview URL; for `@ref`, full-fidelity is already the default via convert → render-json.
 
-- **Mock:** `/cms-showcase/render` with mock data; fast, no preview token.
-- **Live** (with ref): `cms-edit screenshot @c0 --live` — uses `/cms-preview/render?id=...`; equivalent for component/collection/externalComponent to the default @ref path.
+- **Mock:** `/cms/showcase/render` with mock data; fast, no preview token.
+- **Live** (with ref): `cms-edit screenshot @c0 --live` — uses `/cms/preview/render?id=...`; equivalent for component/collection/externalComponent to the default @ref path.
 
 ## Checking your work