@sleekcms/sync 1.4.0 → 1.4.1

package/dist/AGENT.md

@@ -57,6 +57,7 @@ Examples:
 /content/entries/<key+>.json       Content for a collection entry (array of objects; <key>+ matches the model filename)
 
 /content/images.json                       Site-level reusable images (handle → shortcut)
+/content/videos.json                       Site-level videos (handle → embed_url) — READ-ONLY, populated by UI uploads
 ```
 
 > **Tailwind**: Creating `/css/tailwind.css` enables Tailwind. It is compiled and injected automatically — do NOT add it via `link()`.
@@ -268,7 +269,7 @@ Model fields declare both the editor type and the shape expected in content JSON
 | `datetime` | ISO 8601 string |
 | `time` | `"HH:mm"` string |
 | `image` | Either a resolved `{ "url": "...", "alt": "..." }` object, **or** a shortcut string `"<source>:<search>"` (e.g., `"pexels:doctor"`, `"url:https://picsum.photos/200.jpg"`, `"cms:logo"`). Supported sources: `unsplash`, `pexels`, `pixabay`, `iconify`, `url`, `cms` (reuses an image declared in `/images.json` by handle). Append `\|<alt text>` to set the image's alt, e.g. `"pexels:doctor\|Smiling doctor with stethoscope"`. On save, the sync engine resolves the shortcut/link to a full image object automatically. |
-| `video` | Object of shape `{ "source": "BUNNY", "video_id": "...", "embed_url": "...", "title": "..." }`. **Do not write or invent this value.** Video uploads are user-driven in the CMS UI — the user uploads to Bunny.net and the sync engine stores the resolved object. In templates, always render videos with the `embed()` helper (e.g. `<%- embed(item.intro_video, { size: '1280x720' }) %>`), never by hand-rolling an iframe. |
+| `video` | Object of shape `{ "source": "BUNNY", "video_id": "...", "embed_url": "...", "title": "..." }`. **Do not write or invent this value.** Video uploads are user-driven in the CMS UI — the user uploads to Bunny.net and the sync engine stores the resolved object. In templates, always render videos with the `embed()` helper (e.g. `<%- embed(item.intro_video, { size: '1280x720' }) %>`), never by hand-rolling an iframe. The site's available video handles are exposed read-only at `/content/videos.json` (`handle → embed_url`) — look them up in templates with `getVideo('<handle>')`. |
 | `file` | Object of shape `{ "name": "...", "url": "...", "size": 0, "type": "...", "ext": "..." }` describing a downloadable document (PDF, CSV, DOC/DOCX, XLS/XLSX, PPT/PPTX, TSV, TXT — max 10 MB). **Do not write or invent this value.** File uploads are user-driven in the CMS UI — the user attaches the file via the editor and the sync engine stores the resolved object. In templates, render a link with `item.file.url` (download URL on `files.sleekcms.com`) and `item.file.name` (display name), e.g. `<a href="<%= item.brochure.url %>" download><%= item.brochure.name %></a>`. |
 | `json` | Object or array |
 | `sheet` | Array of arrays |
@@ -404,6 +405,23 @@ For images used in more than one place (logos, recurring icons, hero art), decla
 
 Then reference any of them from any content `image` field with `"cms:<handle>"` (e.g., `"cms:logo"`). The sync engine resolves it to the full image object on save. Templates can also fetch the resolved object directly via `getImage('<handle>')`.
 
+### Site videos (`/videos.json`) — READ-ONLY
+
+`/content/videos.json` is a flat map of `handle → embed_url` describing every video the user has uploaded to this site via the CMS UI (Bunny.net):
+
+```json
+{
+    "intro": "https://iframe.mediadelivery.net/embed/<lib>/<guid>",
+    "testimonial-jane": "https://iframe.mediadelivery.net/embed/<lib>/<guid>"
+}
+```
+
+**Do not edit `/content/videos.json`.** It is regenerated from the user's uploads — local edits will not sync and will be overwritten on the next pull. Use it only to discover which video handles are available, then fetch the resolved video object inside templates with `getVideo('<handle>')` and render it via `embed()`:
+
+```ejs
+<%- embed(getVideo('intro'), { size: '1280x720' }) %>
+```
+
 ---
 
 ## EJS Templates
@@ -444,6 +462,7 @@ Page records include: `item._path`, `item._slug` (collections), `item._meta.upda
 | `getEntry(handle)` | Object \| Array | Entry by handle. Single → object, collection → array |
 | `getSlugs(path)` | string[] | Slugs under a collection path |
 | `getImage(name)` | Object \| undefined | Site-level image by handle |
+| `getVideo(name)` | Object \| undefined | Site-level video by handle (handles listed in `/content/videos.json`, read-only) |
 | `getOptions(name)` | Array \| undefined | Option set as `[{ label, value }]` |
 | `getContent(query?)` | Any | Full content payload, or filter with JMESPath |
 | `path(page)` | String | URL path of a page object |

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@sleekcms/sync",
-    "version": "1.4.0",
+    "version": "1.4.1",
     "description": "Edit SleekCMS sites locally — models, content, templates, images — with live two-way sync and AI agent support.",
     "keywords": [
         "sleekcms",