npm - @bettercms-ai/codegen - Versions diffs - 0.5.0 → 0.6.0 - Mend

@bettercms-ai/codegen 0.5.0 → 0.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/dist/index.js CHANGED Viewed

@@ -16,6 +16,60 @@ export type RichText = {
   readonly html?: string;
 };
+/**
+ * A field that may arrive as EITHER shape.
+ *
+ * Switching a field between \`text\` and \`richtext\` in the CMS switches what Delivery
+ * returns for it \u2014 a bare string becomes \`{ format, value, html }\`. Type author-editable
+ * text with this and read it through \`plain()\`/\`rich()\` below, and that switch stops being
+ * a site-breaking change. Interpolating the value directly renders \`[object Object]\`.
+ */
+export type TextOrRich = string | RichText | null | undefined;
+/** True when the value is a rich-text envelope rather than a bare string. */
+export function isRichText(value: unknown): value is RichText {
+  return (
+    typeof value === "object" && value !== null && !Array.isArray(value) &&
+    ("html" in value || "format" in value)
+  );
+}
+/** Plain text for attribute contexts \u2014 \`<title>\`, meta description, JSON-LD, \`alt\`. */
+export function plain(value: TextOrRich): string {
+  if (typeof value === "string") return value;
+  if (!isRichText(value) || typeof value.html !== "string") return "";
+  return decodeEntities(value.html.replace(/<[^>]+>/g, "")).trim();
+}
+/**
+ * Renderable HTML, for \`set:html\` / \`dangerouslySetInnerHTML\`. Rich text keeps its inline
+ * marks (the server sanitizes \`html\` on write); a bare string is escaped, so a plain field
+ * can never inject markup. A LONE wrapping block is unwrapped \u2014 a field switched from
+ * \`text\` stores \`<p>\u2026</p>\`, and \`<h1><p>\u2026</p></h1>\` is invalid HTML (the parser closes the
+ * heading early, dropping the text out of it). Real block structure is left alone.
+ */
+export function rich(value: TextOrRich, fallback = ""): string {
+  const html = (
+    typeof value === "string" ? escapeHtml(value) : isRichText(value) ? (value.html ?? "") : ""
+  ).trim();
+  return html ? unwrapLoneBlock(html) : escapeHtml(fallback);
+}
+function unwrapLoneBlock(html: string): string {
+  const m = html.match(/^<(p|div|h[1-6])(?:\\s[^>]*)?>([\\s\\S]*)<\\/\\1>$/i);
+  return m && !new RegExp(\`</\${m[1]}>\`, "i").test(m[2]) ? m[2] : html;
+}
+function escapeHtml(s: string): string {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function decodeEntities(s: string): string {
+  return s
+    .replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&quot;/g, '"')
+    .replace(/&#0?39;/g, "'").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&");
+}
 /**
  * Image / media field value as stored and returned verbatim by the Delivery API
  * (server-normalized on write to the canonical shape). \`url\` is always present; an
@@ -31,6 +85,26 @@ export interface BetterCMSImage {
   readonly height?: number;
 }
+/**
+ * A component slot's value, as stored and delivered.
+ *
+ * \`componentId\` points at a component definition; \`overrides\` are the author's values,
+ * keyed by the component's declared prop keys.
+ *
+ * \`resolved\` is the SNAPSHOT: at publish time the component is resolved (its block tree
+ * with the overrides applied) and frozen onto the published value. That is why editing a
+ * component does not silently rewrite entries that were already published \u2014 a published
+ * entry carries what it was published with until it is published again.
+ *
+ * Read \`resolved\` when it is there; it is absent on draft-perspective reads, where you
+ * should resolve \`componentId\` yourself against the components endpoint.
+ */
+export interface BetterCMSComponentRef {
+  readonly componentId: string;
+  readonly overrides?: Readonly<Record<string, unknown>>;
+  readonly resolved?: readonly unknown[];
+}
 /**
  * Delivery envelope around a model's typed \`data\`. \`getEntry\`/\`listEntries\` in the
  * Next adapter return this shape, with \`fields\` typed by the model.
@@ -78,7 +152,12 @@ function scalarType(field) {
     case "reference":
       return "string";
     // referenced entry id
+    // Both spellings are live (see ContentModelFieldType). Template- and Webflow-seeded
+    // models carry the camelCase one; until it was handled here it fell through to the
+    // exhaustiveness default, so generated types for every template-created collection
+    // typed this field as `unknown` instead of `string[]`.
     case "multi-reference":
+    case "multiReference":
       return "string[]";
     // referenced entry ids
     case "array": {
@@ -86,6 +165,23 @@ function scalarType(field) {
       const inner = itemType === "number" ? "number" : "string";
       return `${inner}[]`;
     }
+    // ── Builder scalars ────────────────────────────────────────────────────────
+    // All string-shaped on the wire; each is value-validated on write (see
+    // src/lib/content/reference-validation.ts), so the generated type is the
+    // narrowest thing that is actually true of the stored value.
+    case "longtext":
+    case "slug":
+    case "email":
+    case "phone":
+    case "link":
+    case "color":
+      return "string";
+    case "json":
+      return "unknown";
+    case "component-ref":
+      return "BetterCMSComponentRef";
+    case "file":
+      return "BetterCMSImage";
     default: {
       const _exhaustive = t;
       return "unknown";

package/dist/index.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"sources":["../src/generate.ts","../src/bindings.ts","../src/components.ts","../src/fetch-models.ts"],"sourcesContent":["/*\n @bettercms-ai/codegen — schema → TypeScript generator (the single source of truth).\n \n Both the dashboard schema builder and the MCP `create_model`/`add_field` tools write\n * the SAME `content_models.fields` (an array of `ContentModelField`). This generator maps\n * that one array into TypeScript. Because there is exactly one schema representation, the\n * generated types can never drift from the editor or the agent — they are the same source.\n \n Pure + deterministic: same models in → identical string out (stable ordering, no clock,\n * no I/O). That makes it trivially testable and safe to commit + diff in a customer repo.\n /\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\n\n/* Minimal model shape the generator needs — a subset of the Management API model row. /\nexport interface GeneratableModel {\n /* Machine-safe slug, e.g. \"blog\" or \"case-study\". Used for the schema-map key. /\n slug: string;\n /* Human name, used only for the JSDoc header. /\n name?: string;\n description?: string \| null;\n fields: ContentModelField[];\n}\n\nexport interface GenerateOptions {\n /* Generator version stamped into the header (defaults to the package version). /\n version?: string;\n /* Override the banner timestamp source — omitted by default so output is deterministic. /\n bannerComment?: string;\n}\n\n/* Helper types emitted once at the top of every generated file (self-contained, zero-dep). /\nconst PREAMBLE = `/\n Rich-text field value returned by the Delivery API.\n \n - \\`format\\`/\\`value\\`: the portable, editor-agnostic payload (Lexical EditorState) —\n * render it with your editor's serializer for full fidelity.\n * - \\`html\\`: server-rendered, sanitized HTML (computed render-on-write). Present on\n * Delivery reads; the simplest path for non-React consumers — safe to inject directly\n * (e.g. \\`dangerouslySetInnerHTML\\`). Optional: legacy/un-normalized values may omit it.\n \n The \\`{ format, value }\\` contract is unchanged; \\`html\\` is additive.\n /\nexport type RichText = {\n readonly format: string;\n readonly value: unknown;\n readonly html?: string;\n};\n\n/\n Image / media field value as stored and returned verbatim by the Delivery API\n * (server-normalized on write to the canonical shape). \\`url\\` is always present; an\n * unresolved/external value may carry only \\`url\\`. \\`altText\\` is the accessibility text\n * for \\`<img alt>\\`.\n /\nexport interface BetterCMSImage {\n readonly id?: string;\n readonly url: string;\n readonly name?: string;\n readonly altText?: string \| null;\n readonly width?: number;\n readonly height?: number;\n}\n\n/\n Delivery envelope around a model's typed \\`data\\`. \\`getEntry\\`/\\`listEntries\\` in the\n * Next adapter return this shape, with \\`fields\\` typed by the model.\n /\nexport interface BetterCMSEntry<TFields> {\n readonly slug: string;\n readonly status: \"draft\" \| \"published\";\n readonly fields: TFields;\n readonly updatedAt: string;\n}\n`;\n\n/* PascalCase an identifier from a slug: \"case-study\" → \"CaseStudy\". /\nfunction pascalCase(slug: string): string {\n const parts = slug.split(/[-_\\s]+/).filter(Boolean);\n const pascal = parts\n .map((p) => p.charAt(0).toUpperCase() + p.slice(1))\n .join(\"\");\n // Guard against an identifier that starts with a digit (invalid TS type name).\n return /^[0-9]/.test(pascal) ? `Model${pascal}` : pascal \|\| \"Model\";\n}\n\n/\n Make a string safe to embed inside a `/** ... /` JSDoc comment. A field label\n (free-text, author/agent-controlled) could contain `/` — which closes the comment\n early and injects the remainder as code — or a newline, which breaks the single-line\n * comment. Both are neutralized here. Without this, hostile content produces non-\n * compiling (or worse, code-injected) output.\n /\nfunction escapeJsDoc(text: string): string {\n return text.replace(/\\\\//g, \"* /\").replace(/[\\r\\n]+/g, \" \").trim();\n}\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]$/;\n\n/\n Render a field key as a TS property name. Field keys are author/agent-controlled and\n * not guaranteed to be valid identifiers (e.g. \"my-field\", \"1title\", \"\"), so anything\n * that isn't a bare identifier is emitted as a quoted property name — always valid TS.\n /\nfunction propName(key: string): string {\n return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/* A scalar/primitive field maps to a TS type expression (no nesting). /\nfunction scalarType(field: ContentModelField): string {\n const t: ContentModelFieldType = field.type;\n switch (t) {\n case \"text\":\n return \"string\";\n case \"richtext\":\n return \"RichText\";\n case \"image\":\n return \"BetterCMSImage\";\n case \"boolean\":\n return \"boolean\";\n case \"number\":\n return \"number\";\n case \"date\":\n case \"datetime\":\n return \"string\"; // ISO 8601\n case \"select\": {\n const opts = field.options?.filter((o) => typeof o === \"string\") ?? [];\n return opts.length > 0\n ? opts.map((o) => JSON.stringify(o)).join(\" \| \")\n : \"string\";\n }\n case \"reference\":\n return \"string\"; // referenced entry id\n case \"multi-reference\":\n return \"string[]\"; // referenced entry ids\n case \"array\": {\n // Zoned arrays (config.zones) are expanded by fieldsToBody before reaching here;\n // this branch handles only the primitive list form (config.itemType).\n const itemType = field.config?.itemType ?? \"text\";\n const inner =\n itemType === \"number\" ? \"number\" : \"string\"; // text \| date → string\n return `${inner}[]`;\n }\n default: {\n // Exhaustiveness guard: if a new field type is added to the union and not\n // mapped here, this line becomes a compile error in the codegen build.\n const _exhaustive: never = t;\n return \"unknown\";\n }\n }\n}\n\n/\n Render the TS type for a zoned `array` field: an object with optional\n * `nonRepeatable` (a fixed block) and/or `repeatable` (a list of blocks). Recurses\n * through zone fields, so a zone field that is itself a zoned `array` nests naturally.\n /\nfunction arrayZoneType(field: ContentModelField, indent: string): string {\n const zones = field.config?.zones;\n const parts: string[] = [];\n if (zones?.nonRepeatable?.length) {\n const nested = fieldsToBody(zones.nonRepeatable, indent + \" \");\n parts.push(`${indent} readonly nonRepeatable?: {\\n${nested}\\n${indent} };`);\n }\n if (zones?.repeatable?.fields?.length) {\n const nested = fieldsToBody(zones.repeatable.fields, indent + \" \");\n parts.push(`${indent} readonly repeatable?: Array<{\\n${nested}\\n${indent} }>;`);\n }\n if (parts.length === 0) return \"Record<string, unknown>\"; // zoned array with no fields yet\n return `{\\n${parts.join(\"\\n\")}\\n${indent}}`;\n}\n\n/* Render the body of an object type from a field list, recursing into zones. /\nfunction fieldsToBody(fields: ContentModelField[], indent: string): string {\n const lines: string[] = [];\n for (const field of fields) {\n const optional = field.required ? \"\" : \"?\";\n let typeExpr: string;\n\n if (field.type === \"array\" && field.config?.zones) {\n typeExpr = arrayZoneType(field, indent);\n } else {\n typeExpr = scalarType(field);\n }\n\n const safeLabel = field.label ? escapeJsDoc(field.label) : \"\";\n if (safeLabel && safeLabel !== field.key) {\n lines.push(`${indent}/* ${safeLabel} /`);\n }\n lines.push(`${indent}readonly ${propName(field.key)}${optional}: ${typeExpr};`);\n }\n return lines.join(\"\\n\");\n}\n\n/\n Generate a complete `.ts` module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n /\nexport function generateTypes(\n models: GeneratableModel[],\n opts: GenerateOptions = {},\n): string {\n const version = opts.version ?? \"0.1.0\";\n // Code-unit sort (NOT localeCompare): locale/ICU-independent so the generated\n // file is byte-identical on every machine — committed output diffs cleanly.\n const sorted = [...models].sort((a, b) =>\n a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n );\n\n const header = `// ⚠️ AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen\n// Source of truth: your BetterCMS content models (the same schema the dashboard\n// builder and the MCP tools write). Re-run codegen after any schema change.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n const interfaces: string[] = [];\n const mapEntries: string[] = [];\n // Different slugs can PascalCase to the same base name (e.g. \"case-study\" and\n // \"case_study\" → \"CaseStudy\"). Emitting two identical interfaces would silently\n // declaration-merge into one wrong type, so disambiguate with a numeric suffix.\n const usedNames = new Set<string>();\n\n for (const model of sorted) {\n const base = `${pascalCase(model.slug)}Fields`;\n let typeName = base;\n for (let n = 2; usedNames.has(typeName); n++) typeName = `${base}_${n}`;\n usedNames.add(typeName);\n\n const name = model.name ? escapeJsDoc(model.name) : \"\";\n const desc = model.description ? escapeJsDoc(model.description) : \"\";\n const doc = name\n ? `/\\n ${name}${desc ? ` — ${desc}` : \"\"}\\n * Model slug: \\`${model.slug}\\`\\n /\\n`\n : \"\";\n const body = model.fields.length\n ? fieldsToBody(model.fields, \" \")\n : \" // (no fields defined yet)\";\n interfaces.push(`${doc}export interface ${typeName} {\\n${body}\\n}`);\n mapEntries.push(` readonly ${JSON.stringify(model.slug)}: ${typeName};`);\n }\n\n const schemaMap = `/\n Registry mapping each model slug to its typed fields. The Next adapter uses this to\n * type \\`getEntry(\"blog\", ...)\\` by slug — autocomplete and exhaustiveness for free.\n /\nexport interface BetterCMSSchema {\n${mapEntries.join(\"\\n\") \|\| \" // (no models defined yet)\"}\n}\n\n/* Union of all model slugs. /\nexport type BetterCMSModelSlug = keyof BetterCMSSchema;`;\n\n return [header, PREAMBLE, interfaces.join(\"\\n\\n\"), schemaMap, \"\"].join(\"\\n\");\n}\n","/\n @bettercms-ai/codegen — schema → Live Preview binding helper generator.\n \n Companion to {@link generateTypes}. Where that emits the types, this emits a\n * tiny, schema-derived runtime that stamps `data-bcms-field` / `data-bcms-kind`\n * attributes onto the elements a site author binds to CMS content. Those\n * attributes are what the dashboard's Live Preview editor reads to turn the real,\n * running site into an editable canvas (the parent maps `data-bcms-field` → its\n * internal `data-node-id` on frame load).\n \n Why a helper and not auto-injection: BetterCMS never renders the customer's DOM\n * — the site does. So binding is opt-in per element via a spread:\n \n import { bcms } from \"./bettercms.bindings.generated\";\n \n <h1 {...bcms.blog.title}>{entry.fields.title}</h1> // scalar\n * <li {...bcms.blog.tags.value(i)}>{tag}</li> // primitive-array item\n * <article {...bcms.blog.features.$(i)}> // array item root\n * <h3 {...bcms.blog.features.label(i)}>{f.label}</h3> // array item sub-field\n * </article>\n \n The attributes only appear when the site is built with `BCMS_ANNOTATE` set\n * (preview builds); a normal production build ships zero extra attributes, because\n * `bcmsField` returns `{}`. Same generated file, both builds — no separate mode.\n \n Pure + deterministic, exactly like the type generator: same models in → identical\n * string out (slug-sorted, field order preserved, no clock, no I/O). Field keys are\n * author/agent-controlled, so every embedded key is emitted as an escaped string\n * literal (never interpolated into code) — hostile input can't break the output.\n \n Grammar — mirrors what the editor's `fieldPathToNodeId` resolves:\n * `title` · `hero.heroTitle` · `hero.primaryCta.label` (group leaves, any depth)\n * `features[0]` · `features[0].label` · `intro.facts[0].label` (repeaters, one index)\n * Group (non-repeatable) zones recurse into nested binding objects; a repeater is an\n * object with `$(i)` (item root) + one accessor per scalar sub-field. Arrays nested\n * inside a repeater item (a second index) are still beyond what the editor can\n * address, so they are intentionally omitted rather than emitted as dead paths.\n /\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\nimport type { GeneratableModel, GenerateOptions } from \"./generate.js\";\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]$/;\n\n/*\n Render a field key as an object property name. Keys aren't guaranteed to be valid\n * identifiers (e.g. \"my-field\", \"1title\"), so anything that isn't a bare identifier\n * is quoted — always valid TS. (Mirrors the same helper in `generate.ts`.)\n /\nfunction propName(key: string): string {\n return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/\n The kind label written to `data-bcms-kind`, mapped to the editor's closed field-type\n * set (matches the dashboard adapter's `toEditorFieldType`): API-only types that have\n * no on-canvas control collapse to \"text\". Informational today — the editor derives the\n * authoritative kind from the loaded model — but kept truthful for debugging/forward use.\n /\nfunction bindingKind(t: ContentModelFieldType): string {\n switch (t) {\n case \"text\":\n case \"richtext\":\n case \"image\":\n case \"boolean\":\n case \"number\":\n case \"select\":\n case \"array\":\n return t;\n // reference / multi-reference / date / datetime → plain text in the editor v1.\n default:\n return \"text\";\n }\n}\n\n/\n Build a runtime path expression for an array element: a string literal split around\n * the index so it concatenates at call time. Both halves are JSON-escaped, so an\n * author-controlled key can never inject code. e.g. (\"features[\", \"].label\") →\n * `\"features[\" + i + \"].label\"`.\n /\nfunction indexedPath(prefix: string, suffix: string): string {\n return `${JSON.stringify(prefix)} + i + ${JSON.stringify(suffix)}`;\n}\n\n/* Render a repeater binding object: `$(i)` item root + one accessor per scalar\n * sub-field. `path` is the repeater's full (possibly dotted) field path. /\nfunction repeaterBinding(\n itemFields: ContentModelField[],\n path: string,\n indent: string,\n): string {\n const lines: string[] = [\n `${indent} $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n ];\n for (const sub of itemFields) {\n // A sub-field that is itself an array would need a second index the editor\n // can't address yet — skip it rather than emit a path that won't bind.\n if (sub.type === \"array\") continue;\n lines.push(\n `${indent} ${propName(sub.key)}: (i: number) => bcmsField(${indexedPath(`${path}[`, `].${sub.key}`)}, ${JSON.stringify(bindingKind(sub.type))}),`,\n );\n }\n return `{\\n${lines.join(\"\\n\")}\\n${indent}}`;\n}\n\n/* Render the binding for one field at `path`, recursing into group zones. /\nfunction fieldBinding(\n field: ContentModelField,\n prefix: string,\n indent: string,\n): string {\n const path = prefix ? `${prefix}.${field.key}` : field.key;\n const name = propName(field.key);\n\n if (field.type !== \"array\") {\n return `${indent}${name}: bcmsField(${JSON.stringify(path)}, ${JSON.stringify(bindingKind(field.type))}),`;\n }\n\n const zones = field.config?.zones;\n // Group (non-repeatable) → a nested object of dotted-path leaf bindings.\n if (zones?.nonRepeatable?.length) {\n const body = zones.nonRepeatable\n .map((child) => fieldBinding(child, path, `${indent} `))\n .join(\"\\n\");\n return `${indent}${name}: {\\n${body}\\n${indent}},`;\n }\n // Repeater → `$(i)` + scalar sub-field accessors.\n if (zones?.repeatable?.fields?.length) {\n return `${indent}${name}: ${repeaterBinding(zones.repeatable.fields, path, indent)},`;\n }\n // Primitive list (`config.itemType` or bare) → `$(i)` + synthetic `value(i)`.\n const lines = [\n `${indent} $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n `${indent} value: (i: number) => bcmsField(${indexedPath(`${path}[`, \"].value\")}, \"text\"),`,\n ];\n return `${indent}${name}: {\\n${lines.join(\"\\n\")}\\n${indent}},`;\n}\n\n/* Render the binding entries for one model's fields (field order preserved). /\nfunction fieldsToBindings(fields: ContentModelField[], indent: string): string {\n return fields.map((field) => fieldBinding(field, \"\", indent)).join(\"\\n\");\n}\n\n/* The self-contained runtime emitted once at the top of every bindings file. /\nconst PREAMBLE = `/\n True when this site is built for Live Preview annotation. Set \\`BCMS_ANNOTATE=1\\`\n * in the preview build only; unset (the default) ships zero binding attributes.\n * Read defensively so the module is safe in any runtime (browser, Node, edge).\n /\nconst BCMS_ANNOTATE: boolean = (() => {\n try {\n const v = (globalThis as { process?: { env?: Record<string, string \| undefined> } })\n .process?.env?.BCMS_ANNOTATE;\n return v != null && v !== \"\" && v !== \"0\" && v !== \"false\";\n } catch {\n return false;\n }\n})();\n\n/\n Binding attributes for a CMS-bound element. Spread onto the element that renders a\n * field: \\`<h1 {...bcmsField(\"title\", \"text\")}>\\`. Returns \\`{}\\` unless BCMS_ANNOTATE\n * is set, so production markup is untouched.\n /\nexport function bcmsField(path: string, kind: string): Record<string, string> {\n return BCMS_ANNOTATE ? { \"data-bcms-field\": path, \"data-bcms-kind\": kind } : {};\n}\n`;\n\n/\n Generate the Live Preview bindings module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n /\nexport function generateBindings(\n models: GeneratableModel[],\n opts: GenerateOptions = {},\n): string {\n const version = opts.version ?? \"0.1.0\";\n // Code-unit sort (NOT localeCompare) so output is byte-identical on every machine.\n const sorted = [...models].sort((a, b) =>\n a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n );\n\n const header = `// ⚠️ AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Live Preview field bindings. Regenerate with: npx @bettercms-ai/codegen --bindings-out <path>\n// Spread these onto the elements that render your content; they emit\n// data-bcms-field/data-bcms-kind only when the site is built with BCMS_ANNOTATE set.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n const entries = sorted.map((model) => {\n const body = model.fields.length\n ? `\\n${fieldsToBindings(model.fields, \" \")}\\n `\n : \"\";\n return ` ${JSON.stringify(model.slug)}: {${body}},`;\n });\n\n const bcms = `/\n Field bindings keyed by model slug. Spread a binding onto the element that renders\n * that field. Arrays expose \\`$(i)\\` for the item element and one accessor per\n * (one-level) sub-field; primitive arrays expose \\`value(i)\\` for the item's scalar.\n /\nexport const bcms = {\n${entries.join(\"\\n\") \|\| \" // (no models defined yet)\"}\n} as const;`;\n\n return [header, PREAMBLE, bcms, \"\"].join(\"\\n\");\n}\n","/\n @bettercms-ai/codegen — schema → typed React render components generator.\n \n Companion to {@link generateTypes} (types) and {@link generateBindings} (Live\n * Preview attributes). This emits a small, self-contained `.tsx` module with two\n * components that render the canonical Delivery field shapes CORRECTLY, so authors\n * never hand-roll the rendering that produces the classic bugs:\n \n - <RichText> renders the server-sanitized `html` via `dangerouslySetInnerHTML`,\n * instead of interpolating the value as a JSX child (which React escapes, so the\n * page shows literal `<p>…</p>` tags — the #6 escaped-richtext bug).\n * - <Image> reads the normalized image object's `.url`/`.altText`, instead of\n * treating the object as a string.\n \n The emitted module is intentionally generic (not per-model) and dependency-free\n * beyond React, so it is a drop-in: point codegen at a path and import the two\n * components. It is deterministic (no clock, no I/O) like the sibling generators.\n \n Security: `html` is the Delivery API's server-rendered, DOMPurify-sanitized output\n * (see the RichText type docs). `<RichText>` injects exactly that field. If a caller\n * passes HTML from another, untrusted source they must sanitize it themselves.\n /\n\nimport type { GenerateOptions } from \"./generate.js\";\n\n/\n Generate the `bettercms.components.tsx` module: typed `<RichText>` and `<Image>`\n * components for the canonical Delivery field shapes. Deterministic — same options\n * in, identical string out.\n /\nexport function generateComponents(opts: GenerateOptions = {}): string {\n const version = opts.version ?? \"0.1.0\";\n const header = `// ⚠️ AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen --components-out <path>\n// Typed render components for BetterCMS field shapes. Use these instead of\n// hand-rendering richtext/image values — they render the canonical shapes correctly.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n const body = `import as React from \"react\";\n\n/** Rich-text value from the Delivery API. \\`html\\` is server-rendered + sanitized. /\nexport type RichTextValue = {\n readonly format: string;\n readonly value: unknown;\n readonly html?: string;\n};\n\n/* Normalized image/media value from the Delivery API. /\nexport interface BetterCMSImageValue {\n readonly url: string;\n readonly altText?: string \| null;\n readonly width?: number;\n readonly height?: number;\n}\n\ntype RichTextProps = {\n /* The richtext field value (\\`entry.fields.someRichText\\`). /\n field?: RichTextValue \| null;\n /* Element/component to render as. Default: \\`\"div\"\\`. /\n as?: React.ElementType;\n} & Omit<React.HTMLAttributes<HTMLElement>, \"dangerouslySetInnerHTML\" \| \"children\">;\n\n/\n Render a richtext field as HTML. Uses the server-sanitized \\`html\\` via\n * \\`dangerouslySetInnerHTML\\` — NEVER interpolate a richtext value as a JSX child\n * (React escapes it, so the page shows literal tags). Renders nothing when unset.\n /\nexport function RichText({ field, as: Tag = \"div\", ...rest }: RichTextProps) {\n if (!field \|\| !field.html) return null;\n return <Tag {...rest} dangerouslySetInnerHTML={{ __html: field.html }} />;\n}\n\ntype ImageProps = {\n /* The image field value (\\`entry.fields.someImage\\`). /\n field?: BetterCMSImageValue \| null;\n /* Alt text override; defaults to the field's \\`altText\\`, then \\`\"\"\\`. /\n alt?: string;\n} & Omit<React.ImgHTMLAttributes<HTMLImageElement>, \"src\">;\n\n/\n Render an image field as an \\`<img>\\` from its normalized \\`.url\\`/\\`.altText\\`.\n * Renders nothing when unset. Pass \\`alt\\` to override the stored alt text.\n /\nexport function Image({ field, alt, ...rest }: ImageProps) {\n if (!field \|\| !field.url) return null;\n return (\n <img\n src={field.url}\n alt={alt ?? field.altText ?? \"\"}\n width={field.width}\n height={field.height}\n {...rest}\n />\n );\n}\n`;\n\n return [header, body].join(\"\\n\");\n}\n","/\n Fetches content models from the BetterCMS Management API so the CLI can generate\n * types against a live project. Kept dependency-free (plain fetch) so the generated\n * artifact and this fetcher can run anywhere — a GitHub Action, a postinstall, a script.\n /\n\nimport type { GeneratableModel } from \"./generate.js\";\n\nexport interface FetchModelsOptions {\n /* Management API base, e.g. \"https://api.bettercms.ai/api/v1\". /\n apiUrl: string;\n /* A management-scoped key (content:manage) or device-minted token. /\n apiKey: string;\n /* Optional fetch override (testing / custom runtime). /\n fetchImpl?: typeof fetch;\n}\n\ninterface ManagedModelRow {\n slug: string;\n name?: string;\n description?: string \| null;\n fields: GeneratableModel[\"fields\"];\n}\n\n/\n GET /management/content/models — returns the project's models (the key is\n * project-scoped server-side, so this is exactly the schema for this site).\n */\nexport async function fetchModels(\n opts: FetchModelsOptions,\n): Promise<GeneratableModel[]> {\n const doFetch = opts.fetchImpl ?? globalThis.fetch;\n const base = opts.apiUrl.replace(/\\/+$/, \"\");\n const url = `${base}/management/content/models`;\n\n let res: Response;\n try {\n res = await doFetch(url, {\n // No Content-Type: this is a bodyless GET; the header is incorrect here and\n // strict edge runtimes/proxies may reject it.\n headers: { Authorization: `Bearer ${opts.apiKey}`, Accept: \"application/json\" },\n });\n } catch (err) {\n throw new Error(\n `Could not reach the BetterCMS Management API at ${url}: ${\n err instanceof Error ? err.message : String(err)\n }`,\n );\n }\n\n if (!res.ok) {\n const hint =\n res.status === 401 \|\| res.status === 403\n ? \" — check your management API key (it must have the content:manage scope).\"\n : \"\";\n throw new Error(`Management API returned ${res.status} ${res.statusText}${hint}`);\n }\n\n const body = (await res.json()) as { data?: ManagedModelRow[] };\n const rows = body.data ?? [];\n return rows.map((r) => ({\n slug: r.slug,\n name: r.name,\n description: r.description ?? null,\n fields: r.fields ?? [],\n }));\n}\n"],"mappings":"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","names":["VALID_IDENT","propName","PREAMBLE"]}
1	+ {"version":3,"sources":["../src/generate.ts","../src/bindings.ts","../src/components.ts","../src/fetch-models.ts"],"sourcesContent":["/*\n @bettercms-ai/codegen — schema → TypeScript generator (the single source of truth).\n \n Both the dashboard schema builder and the MCP `create_model`/`add_field` tools write\n * the SAME `content_models.fields` (an array of `ContentModelField`). This generator maps\n * that one array into TypeScript. Because there is exactly one schema representation, the\n * generated types can never drift from the editor or the agent — they are the same source.\n \n Pure + deterministic: same models in → identical string out (stable ordering, no clock,\n * no I/O). That makes it trivially testable and safe to commit + diff in a customer repo.\n /\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\n\n/* Minimal model shape the generator needs — a subset of the Management API model row. /\nexport interface GeneratableModel {\n /* Machine-safe slug, e.g. \"blog\" or \"case-study\". Used for the schema-map key. /\n slug: string;\n /* Human name, used only for the JSDoc header. /\n name?: string;\n description?: string \| null;\n fields: ContentModelField[];\n}\n\nexport interface GenerateOptions {\n /* Generator version stamped into the header (defaults to the package version). /\n version?: string;\n /* Override the banner timestamp source — omitted by default so output is deterministic. /\n bannerComment?: string;\n}\n\n/* Helper types emitted once at the top of every generated file (self-contained, zero-dep). /\nconst PREAMBLE = `/\n Rich-text field value returned by the Delivery API.\n \n - \\`format\\`/\\`value\\`: the portable, editor-agnostic payload (Lexical EditorState) —\n * render it with your editor's serializer for full fidelity.\n * - \\`html\\`: server-rendered, sanitized HTML (computed render-on-write). Present on\n * Delivery reads; the simplest path for non-React consumers — safe to inject directly\n * (e.g. \\`dangerouslySetInnerHTML\\`). Optional: legacy/un-normalized values may omit it.\n \n The \\`{ format, value }\\` contract is unchanged; \\`html\\` is additive.\n /\nexport type RichText = {\n readonly format: string;\n readonly value: unknown;\n readonly html?: string;\n};\n\n/\n A field that may arrive as EITHER shape.\n \n Switching a field between \\`text\\` and \\`richtext\\` in the CMS switches what Delivery\n * returns for it — a bare string becomes \\`{ format, value, html }\\`. Type author-editable\n * text with this and read it through \\`plain()\\`/\\`rich()\\` below, and that switch stops being\n * a site-breaking change. Interpolating the value directly renders \\`[object Object]\\`.\n /\nexport type TextOrRich = string \| RichText \| null \| undefined;\n\n/* True when the value is a rich-text envelope rather than a bare string. /\nexport function isRichText(value: unknown): value is RichText {\n return (\n typeof value === \"object\" && value !== null && !Array.isArray(value) &&\n (\"html\" in value \|\| \"format\" in value)\n );\n}\n\n/* Plain text for attribute contexts — \\`<title>\\`, meta description, JSON-LD, \\`alt\\`. /\nexport function plain(value: TextOrRich): string {\n if (typeof value === \"string\") return value;\n if (!isRichText(value) \|\| typeof value.html !== \"string\") return \"\";\n return decodeEntities(value.html.replace(/<[^>]+>/g, \"\")).trim();\n}\n\n/\n Renderable HTML, for \\`set:html\\` / \\`dangerouslySetInnerHTML\\`. Rich text keeps its inline\n * marks (the server sanitizes \\`html\\` on write); a bare string is escaped, so a plain field\n * can never inject markup. A LONE wrapping block is unwrapped — a field switched from\n * \\`text\\` stores \\`<p>…</p>\\`, and \\`<h1><p>…</p></h1>\\` is invalid HTML (the parser closes the\n * heading early, dropping the text out of it). Real block structure is left alone.\n /\nexport function rich(value: TextOrRich, fallback = \"\"): string {\n const html = (\n typeof value === \"string\" ? escapeHtml(value) : isRichText(value) ? (value.html ?? \"\") : \"\"\n ).trim();\n return html ? unwrapLoneBlock(html) : escapeHtml(fallback);\n}\n\nfunction unwrapLoneBlock(html: string): string {\n const m = html.match(/^<(p\|div\|h[1-6])(?:\\\\s[^>])?>([\\\\s\\\\S])<\\\\/\\\\1>$/i);\n return m && !new RegExp(\\`</\\${m[1]}>\\`, \"i\").test(m[2]) ? m[2] : html;\n}\n\nfunction escapeHtml(s: string): string {\n return s.replace(/&/g, \"&\").replace(/</g, \"<\").replace(/>/g, \">\");\n}\n\nfunction decodeEntities(s: string): string {\n return s\n .replace(/</g, \"<\").replace(/>/g, \">\").replace(/"/g, '\"')\n .replace(/&#0?39;/g, \"'\").replace(/ /g, \" \").replace(/&/g, \"&\");\n}\n\n/\n Image / media field value as stored and returned verbatim by the Delivery API\n * (server-normalized on write to the canonical shape). \\`url\\` is always present; an\n * unresolved/external value may carry only \\`url\\`. \\`altText\\` is the accessibility text\n * for \\`<img alt>\\`.\n /\nexport interface BetterCMSImage {\n readonly id?: string;\n readonly url: string;\n readonly name?: string;\n readonly altText?: string \| null;\n readonly width?: number;\n readonly height?: number;\n}\n\n/\n A component slot's value, as stored and delivered.\n \n \\`componentId\\` points at a component definition; \\`overrides\\` are the author's values,\n * keyed by the component's declared prop keys.\n \n \\`resolved\\` is the SNAPSHOT: at publish time the component is resolved (its block tree\n * with the overrides applied) and frozen onto the published value. That is why editing a\n * component does not silently rewrite entries that were already published — a published\n * entry carries what it was published with until it is published again.\n \n Read \\`resolved\\` when it is there; it is absent on draft-perspective reads, where you\n * should resolve \\`componentId\\` yourself against the components endpoint.\n /\nexport interface BetterCMSComponentRef {\n readonly componentId: string;\n readonly overrides?: Readonly<Record<string, unknown>>;\n readonly resolved?: readonly unknown[];\n}\n\n/\n Delivery envelope around a model's typed \\`data\\`. \\`getEntry\\`/\\`listEntries\\` in the\n * Next adapter return this shape, with \\`fields\\` typed by the model.\n /\nexport interface BetterCMSEntry<TFields> {\n readonly slug: string;\n readonly status: \"draft\" \| \"published\";\n readonly fields: TFields;\n readonly updatedAt: string;\n}\n`;\n\n/* PascalCase an identifier from a slug: \"case-study\" → \"CaseStudy\". /\nfunction pascalCase(slug: string): string {\n const parts = slug.split(/[-_\\s]+/).filter(Boolean);\n const pascal = parts\n .map((p) => p.charAt(0).toUpperCase() + p.slice(1))\n .join(\"\");\n // Guard against an identifier that starts with a digit (invalid TS type name).\n return /^[0-9]/.test(pascal) ? `Model${pascal}` : pascal \|\| \"Model\";\n}\n\n/\n Make a string safe to embed inside a `/** ... /` JSDoc comment. A field label\n (free-text, author/agent-controlled) could contain `/` — which closes the comment\n early and injects the remainder as code — or a newline, which breaks the single-line\n * comment. Both are neutralized here. Without this, hostile content produces non-\n * compiling (or worse, code-injected) output.\n /\nfunction escapeJsDoc(text: string): string {\n return text.replace(/\\\\//g, \"* /\").replace(/[\\r\\n]+/g, \" \").trim();\n}\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]$/;\n\n/\n Render a field key as a TS property name. Field keys are author/agent-controlled and\n * not guaranteed to be valid identifiers (e.g. \"my-field\", \"1title\", \"\"), so anything\n * that isn't a bare identifier is emitted as a quoted property name — always valid TS.\n /\nfunction propName(key: string): string {\n return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/* A scalar/primitive field maps to a TS type expression (no nesting). /\nfunction scalarType(field: ContentModelField): string {\n const t: ContentModelFieldType = field.type;\n switch (t) {\n case \"text\":\n return \"string\";\n case \"richtext\":\n return \"RichText\";\n case \"image\":\n return \"BetterCMSImage\";\n case \"boolean\":\n return \"boolean\";\n case \"number\":\n return \"number\";\n case \"date\":\n case \"datetime\":\n return \"string\"; // ISO 8601\n case \"select\": {\n const opts = field.options?.filter((o) => typeof o === \"string\") ?? [];\n return opts.length > 0\n ? opts.map((o) => JSON.stringify(o)).join(\" \| \")\n : \"string\";\n }\n case \"reference\":\n return \"string\"; // referenced entry id\n // Both spellings are live (see ContentModelFieldType). Template- and Webflow-seeded\n // models carry the camelCase one; until it was handled here it fell through to the\n // exhaustiveness default, so generated types for every template-created collection\n // typed this field as `unknown` instead of `string[]`.\n case \"multi-reference\":\n case \"multiReference\":\n return \"string[]\"; // referenced entry ids\n case \"array\": {\n // Zoned arrays (config.zones) are expanded by fieldsToBody before reaching here;\n // this branch handles only the primitive list form (config.itemType).\n const itemType = field.config?.itemType ?? \"text\";\n const inner =\n itemType === \"number\" ? \"number\" : \"string\"; // text \| date → string\n return `${inner}[]`;\n }\n // ── Builder scalars ────────────────────────────────────────────────────────\n // All string-shaped on the wire; each is value-validated on write (see\n // src/lib/content/reference-validation.ts), so the generated type is the\n // narrowest thing that is actually true of the stored value.\n case \"longtext\":\n case \"slug\":\n case \"email\":\n case \"phone\":\n case \"link\":\n case \"color\":\n return \"string\";\n case \"json\":\n // Arbitrary author-supplied JSON — object or parseable string. `unknown`\n // forces the consumer to narrow, which is correct: we genuinely don't know.\n return \"unknown\";\n case \"component-ref\":\n // The delivered value is the reference plus, on published reads, its frozen tree.\n return \"BetterCMSComponentRef\";\n case \"file\":\n // The file envelope is the image envelope minus the pixel dimensions\n // ({ url, name?, ... }), and BetterCMSImage's width/height are optional — so\n // every file value is already a valid BetterCMSImage. Reused rather than\n // emitting a second near-identical public type into every generated SDK.\n return \"BetterCMSImage\";\n default: {\n // Exhaustiveness guard: if a new field type is added to the union and not\n // mapped here, this line becomes a compile error in the codegen build.\n const _exhaustive: never = t;\n return \"unknown\";\n }\n }\n}\n\n/\n Render the TS type for a zoned `array` field: an object with optional\n * `nonRepeatable` (a fixed block) and/or `repeatable` (a list of blocks). Recurses\n * through zone fields, so a zone field that is itself a zoned `array` nests naturally.\n /\nfunction arrayZoneType(field: ContentModelField, indent: string): string {\n const zones = field.config?.zones;\n const parts: string[] = [];\n if (zones?.nonRepeatable?.length) {\n const nested = fieldsToBody(zones.nonRepeatable, indent + \" \");\n parts.push(`${indent} readonly nonRepeatable?: {\\n${nested}\\n${indent} };`);\n }\n if (zones?.repeatable?.fields?.length) {\n const nested = fieldsToBody(zones.repeatable.fields, indent + \" \");\n parts.push(`${indent} readonly repeatable?: Array<{\\n${nested}\\n${indent} }>;`);\n }\n if (parts.length === 0) return \"Record<string, unknown>\"; // zoned array with no fields yet\n return `{\\n${parts.join(\"\\n\")}\\n${indent}}`;\n}\n\n/* Render the body of an object type from a field list, recursing into zones. /\nfunction fieldsToBody(fields: ContentModelField[], indent: string): string {\n const lines: string[] = [];\n for (const field of fields) {\n const optional = field.required ? \"\" : \"?\";\n let typeExpr: string;\n\n if (field.type === \"array\" && field.config?.zones) {\n typeExpr = arrayZoneType(field, indent);\n } else {\n typeExpr = scalarType(field);\n }\n\n const safeLabel = field.label ? escapeJsDoc(field.label) : \"\";\n if (safeLabel && safeLabel !== field.key) {\n lines.push(`${indent}/* ${safeLabel} /`);\n }\n lines.push(`${indent}readonly ${propName(field.key)}${optional}: ${typeExpr};`);\n }\n return lines.join(\"\\n\");\n}\n\n/\n Generate a complete `.ts` module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n /\nexport function generateTypes(\n models: GeneratableModel[],\n opts: GenerateOptions = {},\n): string {\n const version = opts.version ?? \"0.1.0\";\n // Code-unit sort (NOT localeCompare): locale/ICU-independent so the generated\n // file is byte-identical on every machine — committed output diffs cleanly.\n const sorted = [...models].sort((a, b) =>\n a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n );\n\n const header = `// ⚠️ AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen\n// Source of truth: your BetterCMS content models (the same schema the dashboard\n// builder and the MCP tools write). Re-run codegen after any schema change.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n const interfaces: string[] = [];\n const mapEntries: string[] = [];\n // Different slugs can PascalCase to the same base name (e.g. \"case-study\" and\n // \"case_study\" → \"CaseStudy\"). Emitting two identical interfaces would silently\n // declaration-merge into one wrong type, so disambiguate with a numeric suffix.\n const usedNames = new Set<string>();\n\n for (const model of sorted) {\n const base = `${pascalCase(model.slug)}Fields`;\n let typeName = base;\n for (let n = 2; usedNames.has(typeName); n++) typeName = `${base}_${n}`;\n usedNames.add(typeName);\n\n const name = model.name ? escapeJsDoc(model.name) : \"\";\n const desc = model.description ? escapeJsDoc(model.description) : \"\";\n const doc = name\n ? `/\\n ${name}${desc ? ` — ${desc}` : \"\"}\\n * Model slug: \\`${model.slug}\\`\\n /\\n`\n : \"\";\n const body = model.fields.length\n ? fieldsToBody(model.fields, \" \")\n : \" // (no fields defined yet)\";\n interfaces.push(`${doc}export interface ${typeName} {\\n${body}\\n}`);\n mapEntries.push(` readonly ${JSON.stringify(model.slug)}: ${typeName};`);\n }\n\n const schemaMap = `/\n Registry mapping each model slug to its typed fields. The Next adapter uses this to\n * type \\`getEntry(\"blog\", ...)\\` by slug — autocomplete and exhaustiveness for free.\n /\nexport interface BetterCMSSchema {\n${mapEntries.join(\"\\n\") \|\| \" // (no models defined yet)\"}\n}\n\n/* Union of all model slugs. /\nexport type BetterCMSModelSlug = keyof BetterCMSSchema;`;\n\n return [header, PREAMBLE, interfaces.join(\"\\n\\n\"), schemaMap, \"\"].join(\"\\n\");\n}\n","/\n @bettercms-ai/codegen — schema → Live Preview binding helper generator.\n \n Companion to {@link generateTypes}. Where that emits the types, this emits a\n * tiny, schema-derived runtime that stamps `data-bcms-field` / `data-bcms-kind`\n * attributes onto the elements a site author binds to CMS content. Those\n * attributes are what the dashboard's Live Preview editor reads to turn the real,\n * running site into an editable canvas (the parent maps `data-bcms-field` → its\n * internal `data-node-id` on frame load).\n \n Why a helper and not auto-injection: BetterCMS never renders the customer's DOM\n * — the site does. So binding is opt-in per element via a spread:\n \n import { bcms } from \"./bettercms.bindings.generated\";\n \n <h1 {...bcms.blog.title}>{entry.fields.title}</h1> // scalar\n * <li {...bcms.blog.tags.value(i)}>{tag}</li> // primitive-array item\n * <article {...bcms.blog.features.$(i)}> // array item root\n * <h3 {...bcms.blog.features.label(i)}>{f.label}</h3> // array item sub-field\n * </article>\n \n The attributes only appear when the site is built with `BCMS_ANNOTATE` set\n * (preview builds); a normal production build ships zero extra attributes, because\n * `bcmsField` returns `{}`. Same generated file, both builds — no separate mode.\n \n Pure + deterministic, exactly like the type generator: same models in → identical\n * string out (slug-sorted, field order preserved, no clock, no I/O). Field keys are\n * author/agent-controlled, so every embedded key is emitted as an escaped string\n * literal (never interpolated into code) — hostile input can't break the output.\n \n Grammar — mirrors what the editor's `fieldPathToNodeId` resolves:\n * `title` · `hero.heroTitle` · `hero.primaryCta.label` (group leaves, any depth)\n * `features[0]` · `features[0].label` · `intro.facts[0].label` (repeaters, one index)\n * Group (non-repeatable) zones recurse into nested binding objects; a repeater is an\n * object with `$(i)` (item root) + one accessor per scalar sub-field. Arrays nested\n * inside a repeater item (a second index) are still beyond what the editor can\n * address, so they are intentionally omitted rather than emitted as dead paths.\n /\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\nimport type { GeneratableModel, GenerateOptions } from \"./generate.js\";\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]$/;\n\n/*\n Render a field key as an object property name. Keys aren't guaranteed to be valid\n * identifiers (e.g. \"my-field\", \"1title\"), so anything that isn't a bare identifier\n * is quoted — always valid TS. (Mirrors the same helper in `generate.ts`.)\n /\nfunction propName(key: string): string {\n return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/\n The kind label written to `data-bcms-kind`, mapped to the editor's closed field-type\n * set (matches the dashboard adapter's `toEditorFieldType`): API-only types that have\n * no on-canvas control collapse to \"text\". Informational today — the editor derives the\n * authoritative kind from the loaded model — but kept truthful for debugging/forward use.\n /\nfunction bindingKind(t: ContentModelFieldType): string {\n switch (t) {\n case \"text\":\n case \"richtext\":\n case \"image\":\n case \"boolean\":\n case \"number\":\n case \"select\":\n case \"array\":\n return t;\n // reference / multi-reference / date / datetime → plain text in the editor v1.\n default:\n return \"text\";\n }\n}\n\n/\n Build a runtime path expression for an array element: a string literal split around\n * the index so it concatenates at call time. Both halves are JSON-escaped, so an\n * author-controlled key can never inject code. e.g. (\"features[\", \"].label\") →\n * `\"features[\" + i + \"].label\"`.\n /\nfunction indexedPath(prefix: string, suffix: string): string {\n return `${JSON.stringify(prefix)} + i + ${JSON.stringify(suffix)}`;\n}\n\n/* Render a repeater binding object: `$(i)` item root + one accessor per scalar\n * sub-field. `path` is the repeater's full (possibly dotted) field path. /\nfunction repeaterBinding(\n itemFields: ContentModelField[],\n path: string,\n indent: string,\n): string {\n const lines: string[] = [\n `${indent} $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n ];\n for (const sub of itemFields) {\n // A sub-field that is itself an array would need a second index the editor\n // can't address yet — skip it rather than emit a path that won't bind.\n if (sub.type === \"array\") continue;\n lines.push(\n `${indent} ${propName(sub.key)}: (i: number) => bcmsField(${indexedPath(`${path}[`, `].${sub.key}`)}, ${JSON.stringify(bindingKind(sub.type))}),`,\n );\n }\n return `{\\n${lines.join(\"\\n\")}\\n${indent}}`;\n}\n\n/* Render the binding for one field at `path`, recursing into group zones. /\nfunction fieldBinding(\n field: ContentModelField,\n prefix: string,\n indent: string,\n): string {\n const path = prefix ? `${prefix}.${field.key}` : field.key;\n const name = propName(field.key);\n\n if (field.type !== \"array\") {\n return `${indent}${name}: bcmsField(${JSON.stringify(path)}, ${JSON.stringify(bindingKind(field.type))}),`;\n }\n\n const zones = field.config?.zones;\n // Group (non-repeatable) → a nested object of dotted-path leaf bindings.\n if (zones?.nonRepeatable?.length) {\n const body = zones.nonRepeatable\n .map((child) => fieldBinding(child, path, `${indent} `))\n .join(\"\\n\");\n return `${indent}${name}: {\\n${body}\\n${indent}},`;\n }\n // Repeater → `$(i)` + scalar sub-field accessors.\n if (zones?.repeatable?.fields?.length) {\n return `${indent}${name}: ${repeaterBinding(zones.repeatable.fields, path, indent)},`;\n }\n // Primitive list (`config.itemType` or bare) → `$(i)` + synthetic `value(i)`.\n const lines = [\n `${indent} $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n `${indent} value: (i: number) => bcmsField(${indexedPath(`${path}[`, \"].value\")}, \"text\"),`,\n ];\n return `${indent}${name}: {\\n${lines.join(\"\\n\")}\\n${indent}},`;\n}\n\n/* Render the binding entries for one model's fields (field order preserved). /\nfunction fieldsToBindings(fields: ContentModelField[], indent: string): string {\n return fields.map((field) => fieldBinding(field, \"\", indent)).join(\"\\n\");\n}\n\n/* The self-contained runtime emitted once at the top of every bindings file. /\nconst PREAMBLE = `/\n True when this site is built for Live Preview annotation. Set \\`BCMS_ANNOTATE=1\\`\n * in the preview build only; unset (the default) ships zero binding attributes.\n * Read defensively so the module is safe in any runtime (browser, Node, edge).\n /\nconst BCMS_ANNOTATE: boolean = (() => {\n try {\n const v = (globalThis as { process?: { env?: Record<string, string \| undefined> } })\n .process?.env?.BCMS_ANNOTATE;\n return v != null && v !== \"\" && v !== \"0\" && v !== \"false\";\n } catch {\n return false;\n }\n})();\n\n/\n Binding attributes for a CMS-bound element. Spread onto the element that renders a\n * field: \\`<h1 {...bcmsField(\"title\", \"text\")}>\\`. Returns \\`{}\\` unless BCMS_ANNOTATE\n * is set, so production markup is untouched.\n /\nexport function bcmsField(path: string, kind: string): Record<string, string> {\n return BCMS_ANNOTATE ? { \"data-bcms-field\": path, \"data-bcms-kind\": kind } : {};\n}\n`;\n\n/\n Generate the Live Preview bindings module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n /\nexport function generateBindings(\n models: GeneratableModel[],\n opts: GenerateOptions = {},\n): string {\n const version = opts.version ?? \"0.1.0\";\n // Code-unit sort (NOT localeCompare) so output is byte-identical on every machine.\n const sorted = [...models].sort((a, b) =>\n a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n );\n\n const header = `// ⚠️ AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Live Preview field bindings. Regenerate with: npx @bettercms-ai/codegen --bindings-out <path>\n// Spread these onto the elements that render your content; they emit\n// data-bcms-field/data-bcms-kind only when the site is built with BCMS_ANNOTATE set.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n const entries = sorted.map((model) => {\n const body = model.fields.length\n ? `\\n${fieldsToBindings(model.fields, \" \")}\\n `\n : \"\";\n return ` ${JSON.stringify(model.slug)}: {${body}},`;\n });\n\n const bcms = `/\n Field bindings keyed by model slug. Spread a binding onto the element that renders\n * that field. Arrays expose \\`$(i)\\` for the item element and one accessor per\n * (one-level) sub-field; primitive arrays expose \\`value(i)\\` for the item's scalar.\n /\nexport const bcms = {\n${entries.join(\"\\n\") \|\| \" // (no models defined yet)\"}\n} as const;`;\n\n return [header, PREAMBLE, bcms, \"\"].join(\"\\n\");\n}\n","/\n @bettercms-ai/codegen — schema → typed React render components generator.\n \n Companion to {@link generateTypes} (types) and {@link generateBindings} (Live\n * Preview attributes). This emits a small, self-contained `.tsx` module with two\n * components that render the canonical Delivery field shapes CORRECTLY, so authors\n * never hand-roll the rendering that produces the classic bugs:\n \n - <RichText> renders the server-sanitized `html` via `dangerouslySetInnerHTML`,\n * instead of interpolating the value as a JSX child (which React escapes, so the\n * page shows literal `<p>…</p>` tags — the #6 escaped-richtext bug).\n * - <Image> reads the normalized image object's `.url`/`.altText`, instead of\n * treating the object as a string.\n \n The emitted module is intentionally generic (not per-model) and dependency-free\n * beyond React, so it is a drop-in: point codegen at a path and import the two\n * components. It is deterministic (no clock, no I/O) like the sibling generators.\n \n Security: `html` is the Delivery API's server-rendered, DOMPurify-sanitized output\n * (see the RichText type docs). `<RichText>` injects exactly that field. If a caller\n * passes HTML from another, untrusted source they must sanitize it themselves.\n /\n\nimport type { GenerateOptions } from \"./generate.js\";\n\n/\n Generate the `bettercms.components.tsx` module: typed `<RichText>` and `<Image>`\n * components for the canonical Delivery field shapes. Deterministic — same options\n * in, identical string out.\n /\nexport function generateComponents(opts: GenerateOptions = {}): string {\n const version = opts.version ?? \"0.1.0\";\n const header = `// ⚠️ AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen --components-out <path>\n// Typed render components for BetterCMS field shapes. Use these instead of\n// hand-rendering richtext/image values — they render the canonical shapes correctly.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n const body = `import as React from \"react\";\n\n/** Rich-text value from the Delivery API. \\`html\\` is server-rendered + sanitized. /\nexport type RichTextValue = {\n readonly format: string;\n readonly value: unknown;\n readonly html?: string;\n};\n\n/* Normalized image/media value from the Delivery API. /\nexport interface BetterCMSImageValue {\n readonly url: string;\n readonly altText?: string \| null;\n readonly width?: number;\n readonly height?: number;\n}\n\ntype RichTextProps = {\n /* The richtext field value (\\`entry.fields.someRichText\\`). /\n field?: RichTextValue \| null;\n /* Element/component to render as. Default: \\`\"div\"\\`. /\n as?: React.ElementType;\n} & Omit<React.HTMLAttributes<HTMLElement>, \"dangerouslySetInnerHTML\" \| \"children\">;\n\n/\n Render a richtext field as HTML. Uses the server-sanitized \\`html\\` via\n * \\`dangerouslySetInnerHTML\\` — NEVER interpolate a richtext value as a JSX child\n * (React escapes it, so the page shows literal tags). Renders nothing when unset.\n /\nexport function RichText({ field, as: Tag = \"div\", ...rest }: RichTextProps) {\n if (!field \|\| !field.html) return null;\n return <Tag {...rest} dangerouslySetInnerHTML={{ __html: field.html }} />;\n}\n\ntype ImageProps = {\n /* The image field value (\\`entry.fields.someImage\\`). /\n field?: BetterCMSImageValue \| null;\n /* Alt text override; defaults to the field's \\`altText\\`, then \\`\"\"\\`. /\n alt?: string;\n} & Omit<React.ImgHTMLAttributes<HTMLImageElement>, \"src\">;\n\n/\n Render an image field as an \\`<img>\\` from its normalized \\`.url\\`/\\`.altText\\`.\n * Renders nothing when unset. Pass \\`alt\\` to override the stored alt text.\n /\nexport function Image({ field, alt, ...rest }: ImageProps) {\n if (!field \|\| !field.url) return null;\n return (\n <img\n src={field.url}\n alt={alt ?? field.altText ?? \"\"}\n width={field.width}\n height={field.height}\n {...rest}\n />\n );\n}\n`;\n\n return [header, body].join(\"\\n\");\n}\n","/\n Fetches content models from the BetterCMS Management API so the CLI can generate\n * types against a live project. Kept dependency-free (plain fetch) so the generated\n * artifact and this fetcher can run anywhere — a GitHub Action, a postinstall, a script.\n /\n\nimport type { GeneratableModel } from \"./generate.js\";\n\nexport interface FetchModelsOptions {\n /* Management API base, e.g. \"https://api.bettercms.ai/api/v1\". /\n apiUrl: string;\n /* A management-scoped key (content:manage) or device-minted token. /\n apiKey: string;\n /* Optional fetch override (testing / custom runtime). /\n fetchImpl?: typeof fetch;\n}\n\ninterface ManagedModelRow {\n slug: string;\n name?: string;\n description?: string \| null;\n fields: GeneratableModel[\"fields\"];\n}\n\n/\n GET /management/content/models — returns the project's models (the key is\n * project-scoped server-side, so this is exactly the schema for this site).\n */\nexport async function fetchModels(\n opts: FetchModelsOptions,\n): Promise<GeneratableModel[]> {\n const doFetch = opts.fetchImpl ?? globalThis.fetch;\n const base = opts.apiUrl.replace(/\\/+$/, \"\");\n const url = `${base}/management/content/models`;\n\n let res: Response;\n try {\n res = await doFetch(url, {\n // No Content-Type: this is a bodyless GET; the header is incorrect here and\n // strict edge runtimes/proxies may reject it.\n headers: { Authorization: `Bearer ${opts.apiKey}`, Accept: \"application/json\" },\n });\n } catch (err) {\n throw new Error(\n `Could not reach the BetterCMS Management API at ${url}: ${\n err instanceof Error ? err.message : String(err)\n }`,\n );\n }\n\n if (!res.ok) {\n const hint =\n res.status === 401 \|\| res.status === 403\n ? \" — check your management API key (it must have the content:manage scope).\"\n : \"\";\n throw new Error(`Management API returned ${res.status} ${res.statusText}${hint}`);\n }\n\n const body = (await res.json()) as { data?: ManagedModelRow[] };\n const rows = body.data ?? [];\n return rows.map((r) => ({\n slug: r.slug,\n name: r.name,\n description: r.description ?? null,\n fields: r.fields ?? [],\n }));\n}\n"],"mappings":"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","names":["VALID_IDENT","propName","PREAMBLE"]}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@bettercms-ai/codegen",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "type": "module",
   "description": "Generate TypeScript types from your BetterCMS content schema — the single source of truth shared by the dashboard builder and the MCP tools.",
   "bin": {

package/dist/cli.js DELETED Viewed

@@ -1,501 +0,0 @@
-#!/usr/bin/env node
-// src/cli.ts
-import { writeFile, mkdir } from "fs/promises";
-import { dirname, resolve } from "path";
-// src/fetch-models.ts
-async function fetchModels(opts) {
-  const doFetch = opts.fetchImpl ?? globalThis.fetch;
-  const base = opts.apiUrl.replace(/\/+$/, "");
-  const url = `${base}/management/content/models`;
-  let res;
-  try {
-    res = await doFetch(url, {
-      // No Content-Type: this is a bodyless GET; the header is incorrect here and
-      // strict edge runtimes/proxies may reject it.
-      headers: { Authorization: `Bearer ${opts.apiKey}`, Accept: "application/json" }
-    });
-  } catch (err) {
-    throw new Error(
-      `Could not reach the BetterCMS Management API at ${url}: ${err instanceof Error ? err.message : String(err)}`
-    );
-  }
-  if (!res.ok) {
-    const hint = res.status === 401 || res.status === 403 ? " \u2014 check your management API key (it must have the content:manage scope)." : "";
-    throw new Error(`Management API returned ${res.status} ${res.statusText}${hint}`);
-  }
-  const body = await res.json();
-  const rows = body.data ?? [];
-  return rows.map((r) => ({
-    slug: r.slug,
-    name: r.name,
-    description: r.description ?? null,
-    fields: r.fields ?? []
-  }));
-}
-// src/generate.ts
-var PREAMBLE = `/**
- * Rich-text field value returned by the Delivery API.
- *
- * - \`format\`/\`value\`: the portable, editor-agnostic payload (Lexical EditorState) \u2014
- *   render it with your editor's serializer for full fidelity.
- * - \`html\`: server-rendered, sanitized HTML (computed render-on-write). Present on
- *   Delivery reads; the simplest path for non-React consumers \u2014 safe to inject directly
- *   (e.g. \`dangerouslySetInnerHTML\`). Optional: legacy/un-normalized values may omit it.
- *
- * The \`{ format, value }\` contract is unchanged; \`html\` is additive.
- */
-export type RichText = {
-  readonly format: string;
-  readonly value: unknown;
-  readonly html?: string;
-};
-/**
- * Image / media field value as stored and returned verbatim by the Delivery API
- * (server-normalized on write to the canonical shape). \`url\` is always present; an
- * unresolved/external value may carry only \`url\`. \`altText\` is the accessibility text
- * for \`<img alt>\`.
- */
-export interface BetterCMSImage {
-  readonly id?: string;
-  readonly url: string;
-  readonly name?: string;
-  readonly altText?: string | null;
-  readonly width?: number;
-  readonly height?: number;
-}
-/**
- * Delivery envelope around a model's typed \`data\`. \`getEntry\`/\`listEntries\` in the
- * Next adapter return this shape, with \`fields\` typed by the model.
- */
-export interface BetterCMSEntry<TFields> {
-  readonly slug: string;
-  readonly status: "draft" | "published";
-  readonly fields: TFields;
-  readonly updatedAt: string;
-}
-`;
-function pascalCase(slug) {
-  const parts = slug.split(/[-_\s]+/).filter(Boolean);
-  const pascal = parts.map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join("");
-  return /^[0-9]/.test(pascal) ? `Model${pascal}` : pascal || "Model";
-}
-function escapeJsDoc(text) {
-  return text.replace(/\*\//g, "* /").replace(/[\r\n]+/g, " ").trim();
-}
-var VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
-function propName(key) {
-  return VALID_IDENT.test(key) ? key : JSON.stringify(key);
-}
-function scalarType(field) {
-  const t = field.type;
-  switch (t) {
-    case "text":
-      return "string";
-    case "richtext":
-      return "RichText";
-    case "image":
-      return "BetterCMSImage";
-    case "boolean":
-      return "boolean";
-    case "number":
-      return "number";
-    case "date":
-    case "datetime":
-      return "string";
-    // ISO 8601
-    case "select": {
-      const opts = field.options?.filter((o) => typeof o === "string") ?? [];
-      return opts.length > 0 ? opts.map((o) => JSON.stringify(o)).join(" | ") : "string";
-    }
-    case "reference":
-      return "string";
-    // referenced entry id
-    case "multi-reference":
-      return "string[]";
-    // referenced entry ids
-    case "array": {
-      const itemType = field.config?.itemType ?? "text";
-      const inner = itemType === "number" ? "number" : "string";
-      return `${inner}[]`;
-    }
-    default: {
-      const _exhaustive = t;
-      return "unknown";
-    }
-  }
-}
-function arrayZoneType(field, indent) {
-  const zones = field.config?.zones;
-  const parts = [];
-  if (zones?.nonRepeatable?.length) {
-    const nested = fieldsToBody(zones.nonRepeatable, indent + "  ");
-    parts.push(`${indent}  readonly nonRepeatable?: {
-${nested}
-${indent}  };`);
-  }
-  if (zones?.repeatable?.fields?.length) {
-    const nested = fieldsToBody(zones.repeatable.fields, indent + "    ");
-    parts.push(`${indent}  readonly repeatable?: Array<{
-${nested}
-${indent}  }>;`);
-  }
-  if (parts.length === 0) return "Record<string, unknown>";
-  return `{
-${parts.join("\n")}
-${indent}}`;
-}
-function fieldsToBody(fields, indent) {
-  const lines = [];
-  for (const field of fields) {
-    const optional = field.required ? "" : "?";
-    let typeExpr;
-    if (field.type === "array" && field.config?.zones) {
-      typeExpr = arrayZoneType(field, indent);
-    } else {
-      typeExpr = scalarType(field);
-    }
-    const safeLabel = field.label ? escapeJsDoc(field.label) : "";
-    if (safeLabel && safeLabel !== field.key) {
-      lines.push(`${indent}/** ${safeLabel} */`);
-    }
-    lines.push(`${indent}readonly ${propName(field.key)}${optional}: ${typeExpr};`);
-  }
-  return lines.join("\n");
-}
-function generateTypes(models, opts = {}) {
-  const version = opts.version ?? "0.1.0";
-  const sorted = [...models].sort(
-    (a, b) => a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0
-  );
-  const header = `// \u26A0\uFE0F  AUTO-GENERATED by @bettercms-ai/codegen v${version} \u2014 DO NOT EDIT.
-// Regenerate with: npx @bettercms-ai/codegen
-// Source of truth: your BetterCMS content models (the same schema the dashboard
-// builder and the MCP tools write). Re-run codegen after any schema change.
-${opts.bannerComment ? `// ${opts.bannerComment}
-` : ""}`;
-  const interfaces = [];
-  const mapEntries = [];
-  const usedNames = /* @__PURE__ */ new Set();
-  for (const model of sorted) {
-    const base = `${pascalCase(model.slug)}Fields`;
-    let typeName = base;
-    for (let n = 2; usedNames.has(typeName); n++) typeName = `${base}_${n}`;
-    usedNames.add(typeName);
-    const name = model.name ? escapeJsDoc(model.name) : "";
-    const desc = model.description ? escapeJsDoc(model.description) : "";
-    const doc = name ? `/**
- * ${name}${desc ? ` \u2014 ${desc}` : ""}
- * Model slug: \`${model.slug}\`
- */
-` : "";
-    const body = model.fields.length ? fieldsToBody(model.fields, "  ") : "  // (no fields defined yet)";
-    interfaces.push(`${doc}export interface ${typeName} {
-${body}
-}`);
-    mapEntries.push(`  readonly ${JSON.stringify(model.slug)}: ${typeName};`);
-  }
-  const schemaMap = `/**
- * Registry mapping each model slug to its typed fields. The Next adapter uses this to
- * type \`getEntry("blog", ...)\` by slug \u2014 autocomplete and exhaustiveness for free.
- */
-export interface BetterCMSSchema {
-${mapEntries.join("\n") || "  // (no models defined yet)"}
-}
-/** Union of all model slugs. */
-export type BetterCMSModelSlug = keyof BetterCMSSchema;`;
-  return [header, PREAMBLE, interfaces.join("\n\n"), schemaMap, ""].join("\n");
-}
-// src/bindings.ts
-var VALID_IDENT2 = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
-function propName2(key) {
-  return VALID_IDENT2.test(key) ? key : JSON.stringify(key);
-}
-function bindingKind(t) {
-  switch (t) {
-    case "text":
-    case "richtext":
-    case "image":
-    case "boolean":
-    case "number":
-    case "select":
-    case "array":
-      return t;
-    // reference / multi-reference / date / datetime → plain text in the editor v1.
-    default:
-      return "text";
-  }
-}
-function indexedPath(prefix, suffix) {
-  return `${JSON.stringify(prefix)} + i + ${JSON.stringify(suffix)}`;
-}
-function repeaterBinding(itemFields, path, indent) {
-  const lines = [
-    `${indent}  $: (i: number) => bcmsField(${indexedPath(`${path}[`, "]")}, "array"),`
-  ];
-  for (const sub of itemFields) {
-    if (sub.type === "array") continue;
-    lines.push(
-      `${indent}  ${propName2(sub.key)}: (i: number) => bcmsField(${indexedPath(`${path}[`, `].${sub.key}`)}, ${JSON.stringify(bindingKind(sub.type))}),`
-    );
-  }
-  return `{
-${lines.join("\n")}
-${indent}}`;
-}
-function fieldBinding(field, prefix, indent) {
-  const path = prefix ? `${prefix}.${field.key}` : field.key;
-  const name = propName2(field.key);
-  if (field.type !== "array") {
-    return `${indent}${name}: bcmsField(${JSON.stringify(path)}, ${JSON.stringify(bindingKind(field.type))}),`;
-  }
-  const zones = field.config?.zones;
-  if (zones?.nonRepeatable?.length) {
-    const body = zones.nonRepeatable.map((child) => fieldBinding(child, path, `${indent}  `)).join("\n");
-    return `${indent}${name}: {
-${body}
-${indent}},`;
-  }
-  if (zones?.repeatable?.fields?.length) {
-    return `${indent}${name}: ${repeaterBinding(zones.repeatable.fields, path, indent)},`;
-  }
-  const lines = [
-    `${indent}  $: (i: number) => bcmsField(${indexedPath(`${path}[`, "]")}, "array"),`,
-    `${indent}  value: (i: number) => bcmsField(${indexedPath(`${path}[`, "].value")}, "text"),`
-  ];
-  return `${indent}${name}: {
-${lines.join("\n")}
-${indent}},`;
-}
-function fieldsToBindings(fields, indent) {
-  return fields.map((field) => fieldBinding(field, "", indent)).join("\n");
-}
-var PREAMBLE2 = `/**
- * True when this site is built for Live Preview annotation. Set \`BCMS_ANNOTATE=1\`
- * in the preview build only; unset (the default) ships zero binding attributes.
- * Read defensively so the module is safe in any runtime (browser, Node, edge).
- */
-const BCMS_ANNOTATE: boolean = (() => {
-  try {
-    const v = (globalThis as { process?: { env?: Record<string, string | undefined> } })
-      .process?.env?.BCMS_ANNOTATE;
-    return v != null && v !== "" && v !== "0" && v !== "false";
-  } catch {
-    return false;
-  }
-})();
-/**
- * Binding attributes for a CMS-bound element. Spread onto the element that renders a
- * field: \`<h1 {...bcmsField("title", "text")}>\`. Returns \`{}\` unless BCMS_ANNOTATE
- * is set, so production markup is untouched.
- */
-export function bcmsField(path: string, kind: string): Record<string, string> {
-  return BCMS_ANNOTATE ? { "data-bcms-field": path, "data-bcms-kind": kind } : {};
-}
-`;
-function generateBindings(models, opts = {}) {
-  const version = opts.version ?? "0.1.0";
-  const sorted = [...models].sort(
-    (a, b) => a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0
-  );
-  const header = `// \u26A0\uFE0F  AUTO-GENERATED by @bettercms-ai/codegen v${version} \u2014 DO NOT EDIT.
-// Live Preview field bindings. Regenerate with: npx @bettercms-ai/codegen --bindings-out <path>
-// Spread these onto the elements that render your content; they emit
-// data-bcms-field/data-bcms-kind only when the site is built with BCMS_ANNOTATE set.
-${opts.bannerComment ? `// ${opts.bannerComment}
-` : ""}`;
-  const entries = sorted.map((model) => {
-    const body = model.fields.length ? `
-${fieldsToBindings(model.fields, "    ")}
-  ` : "";
-    return `  ${JSON.stringify(model.slug)}: {${body}},`;
-  });
-  const bcms = `/**
- * Field bindings keyed by model slug. Spread a binding onto the element that renders
- * that field. Arrays expose \`$(i)\` for the item element and one accessor per
- * (one-level) sub-field; primitive arrays expose \`value(i)\` for the item's scalar.
- */
-export const bcms = {
-${entries.join("\n") || "  // (no models defined yet)"}
-} as const;`;
-  return [header, PREAMBLE2, bcms, ""].join("\n");
-}
-// src/components.ts
-function generateComponents(opts = {}) {
-  const version = opts.version ?? "0.1.0";
-  const header = `// \u26A0\uFE0F  AUTO-GENERATED by @bettercms-ai/codegen v${version} \u2014 DO NOT EDIT.
-// Regenerate with: npx @bettercms-ai/codegen --components-out <path>
-// Typed render components for BetterCMS field shapes. Use these instead of
-// hand-rendering richtext/image values \u2014 they render the canonical shapes correctly.
-${opts.bannerComment ? `// ${opts.bannerComment}
-` : ""}`;
-  const body = `import * as React from "react";
-/** Rich-text value from the Delivery API. \`html\` is server-rendered + sanitized. */
-export type RichTextValue = {
-  readonly format: string;
-  readonly value: unknown;
-  readonly html?: string;
-};
-/** Normalized image/media value from the Delivery API. */
-export interface BetterCMSImageValue {
-  readonly url: string;
-  readonly altText?: string | null;
-  readonly width?: number;
-  readonly height?: number;
-}
-type RichTextProps = {
-  /** The richtext field value (\`entry.fields.someRichText\`). */
-  field?: RichTextValue | null;
-  /** Element/component to render as. Default: \`"div"\`. */
-  as?: React.ElementType;
-} & Omit<React.HTMLAttributes<HTMLElement>, "dangerouslySetInnerHTML" | "children">;
-/**
- * Render a richtext field as HTML. Uses the server-sanitized \`html\` via
- * \`dangerouslySetInnerHTML\` \u2014 NEVER interpolate a richtext value as a JSX child
- * (React escapes it, so the page shows literal tags). Renders nothing when unset.
- */
-export function RichText({ field, as: Tag = "div", ...rest }: RichTextProps) {
-  if (!field || !field.html) return null;
-  return <Tag {...rest} dangerouslySetInnerHTML={{ __html: field.html }} />;
-}
-type ImageProps = {
-  /** The image field value (\`entry.fields.someImage\`). */
-  field?: BetterCMSImageValue | null;
-  /** Alt text override; defaults to the field's \`altText\`, then \`""\`. */
-  alt?: string;
-} & Omit<React.ImgHTMLAttributes<HTMLImageElement>, "src">;
-/**
- * Render an image field as an \`<img>\` from its normalized \`.url\`/\`.altText\`.
- * Renders nothing when unset. Pass \`alt\` to override the stored alt text.
- */
-export function Image({ field, alt, ...rest }: ImageProps) {
-  if (!field || !field.url) return null;
-  return (
-    <img
-      src={field.url}
-      alt={alt ?? field.altText ?? ""}
-      width={field.width}
-      height={field.height}
-      {...rest}
-    />
-  );
-}
-`;
-  return [header, body].join("\n");
-}
-// src/cli.ts
-var VERSION = "0.2.0";
-var DEFAULT_API_URL = "https://api.bettercms.ai/api/v1";
-var DEFAULT_OUT = "bettercms.generated.ts";
-function parseArgs(argv) {
-  const args = {
-    apiUrl: process.env.BETTERCMS_API_URL ?? DEFAULT_API_URL,
-    apiKey: process.env.BETTERCMS_API_KEY,
-    out: DEFAULT_OUT,
-    bindingsOut: void 0,
-    componentsOut: void 0,
-    help: false
-  };
-  for (let i = 0; i < argv.length; i++) {
-    const arg = argv[i];
-    const next = () => argv[++i];
-    switch (arg) {
-      case "--api-url":
-        args.apiUrl = next() ?? args.apiUrl;
-        break;
-      case "--key":
-      case "--api-key":
-        args.apiKey = next();
-        break;
-      case "--out":
-      case "-o":
-        args.out = next() ?? args.out;
-        break;
-      case "--bindings-out":
-        args.bindingsOut = next();
-        break;
-      case "--components-out":
-        args.componentsOut = next();
-        break;
-      case "--help":
-      case "-h":
-        args.help = true;
-        break;
-    }
-  }
-  return args;
-}
-var HELP = `bettercms-codegen v${VERSION} \u2014 generate TypeScript types from your BetterCMS schema
-Usage:
-  npx @bettercms-ai/codegen [options]
-Options:
-  -o, --out <path>      Output file (default: ${DEFAULT_OUT})
-      --bindings-out <path>  Also emit the Live Preview bindings module to <path>
-      --components-out <path>  Also emit typed <RichText>/<Image> React components (.tsx) to <path>
-      --api-url <url>   Management API base (default: ${DEFAULT_API_URL})
-      --key <key>       Management API key (or set BETTERCMS_API_KEY)
-  -h, --help            Show this help
-Env:
-  BETTERCMS_API_KEY     Management-scoped key (content:manage)
-  BETTERCMS_API_URL     Override the API base
-`;
-async function main() {
-  const args = parseArgs(process.argv.slice(2));
-  if (args.help) {
-    process.stdout.write(HELP);
-    return;
-  }
-  if (!args.apiKey) {
-    process.stderr.write(
-      "error: no API key. Pass --key <key> or set BETTERCMS_API_KEY.\n"
-    );
-    process.exit(1);
-  }
-  const models = await fetchModels({ apiUrl: args.apiUrl, apiKey: args.apiKey });
-  const outPath = resolve(process.cwd(), args.out);
-  await mkdir(dirname(outPath), { recursive: true });
-  await writeFile(outPath, generateTypes(models, { version: VERSION }), "utf8");
-  const plural = models.length === 1 ? "" : "s";
-  process.stdout.write(
-    `\u2713 Generated ${models.length} model type${plural} \u2192 ${args.out}
-`
-  );
-  if (args.bindingsOut) {
-    const bindingsPath = resolve(process.cwd(), args.bindingsOut);
-    await mkdir(dirname(bindingsPath), { recursive: true });
-    await writeFile(bindingsPath, generateBindings(models, { version: VERSION }), "utf8");
-    process.stdout.write(`\u2713 Generated Live Preview bindings \u2192 ${args.bindingsOut}
-`);
-  }
-  if (args.componentsOut) {
-    const componentsPath = resolve(process.cwd(), args.componentsOut);
-    await mkdir(dirname(componentsPath), { recursive: true });
-    await writeFile(componentsPath, generateComponents({ version: VERSION }), "utf8");
-    process.stdout.write(`\u2713 Generated render components \u2192 ${args.componentsOut}
-`);
-  }
-}
-main().catch((err) => {
-  process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}
-`);
-  process.exit(1);
-});
-//# sourceMappingURL=cli.js.map

package/dist/cli.js.map DELETED Viewed

@@ -1 +0,0 @@

- {"version":3,"sources":["../src/cli.ts","../src/fetch-models.ts","../src/generate.ts","../src/bindings.ts","../src/components.ts"],"sourcesContent":["/**\n * `bettercms-codegen` — fetch a project's content models and write a typed `.ts` file.\n *\n * Designed for two call sites:\n * 1. A developer in their repo: npx @bettercms-ai/codegen --out src/bettercms.generated.ts\n * 2. The build-time GitHub Action: same command, key from a repo secret.\n *\n * Auth + endpoint come from flags or env (BETTERCMS_API_KEY, BETTERCMS_API_URL).\n */\n\nimport { writeFile, mkdir } from \"node:fs/promises\";\nimport { dirname, resolve } from \"node:path\";\nimport { fetchModels } from \"./fetch-models.js\";\nimport { generateTypes } from \"./generate.js\";\nimport { generateBindings } from \"./bindings.js\";\nimport { generateComponents } from \"./components.js\";\n\nconst VERSION = \"0.2.0\";\nconst DEFAULT_API_URL = \"https://api.bettercms.ai/api/v1\";\nconst DEFAULT_OUT = \"bettercms.generated.ts\";\n\ninterface CliArgs {\n apiUrl: string;\n apiKey: string | undefined;\n out: string;\n /** When set, also emit the Live Preview bindings module to this path. */\n bindingsOut: string | undefined;\n /** When set, also emit the typed React render components (.tsx) to this path. */\n componentsOut: string | undefined;\n help: boolean;\n}\n\nfunction parseArgs(argv: string[]): CliArgs {\n const args: CliArgs = {\n apiUrl: process.env.BETTERCMS_API_URL ?? DEFAULT_API_URL,\n apiKey: process.env.BETTERCMS_API_KEY,\n out: DEFAULT_OUT,\n bindingsOut: undefined,\n componentsOut: undefined,\n help: false,\n };\n for (let i = 0; i < argv.length; i++) {\n const arg = argv[i];\n const next = () => argv[++i];\n switch (arg) {\n case \"--api-url\":\n args.apiUrl = next() ?? args.apiUrl;\n break;\n case \"--key\":\n case \"--api-key\":\n args.apiKey = next();\n break;\n case \"--out\":\n case \"-o\":\n args.out = next() ?? args.out;\n break;\n case \"--bindings-out\":\n args.bindingsOut = next();\n break;\n case \"--components-out\":\n args.componentsOut = next();\n break;\n case \"--help\":\n case \"-h\":\n args.help = true;\n break;\n }\n }\n return args;\n}\n\nconst HELP = `bettercms-codegen v${VERSION} — generate TypeScript types from your BetterCMS schema\n\nUsage:\n npx @bettercms-ai/codegen [options]\n\nOptions:\n -o, --out <path> Output file (default: ${DEFAULT_OUT})\n --bindings-out <path> Also emit the Live Preview bindings module to <path>\n --components-out <path> Also emit typed <RichText>/<Image> React components (.tsx) to <path>\n --api-url <url> Management API base (default: ${DEFAULT_API_URL})\n --key <key> Management API key (or set BETTERCMS_API_KEY)\n -h, --help Show this help\n\nEnv:\n BETTERCMS_API_KEY Management-scoped key (content:manage)\n BETTERCMS_API_URL Override the API base\n`;\n\nasync function main(): Promise<void> {\n const args = parseArgs(process.argv.slice(2));\n\n if (args.help) {\n process.stdout.write(HELP);\n return;\n }\n if (!args.apiKey) {\n process.stderr.write(\n \"error: no API key. Pass --key <key> or set BETTERCMS_API_KEY.\\n\",\n );\n process.exit(1);\n }\n\n const models = await fetchModels({ apiUrl: args.apiUrl, apiKey: args.apiKey });\n\n const outPath = resolve(process.cwd(), args.out);\n await mkdir(dirname(outPath), { recursive: true });\n await writeFile(outPath, generateTypes(models, { version: VERSION }), \"utf8\");\n\n const plural = models.length === 1 ? \"\" : \"s\";\n process.stdout.write(\n `✓ Generated ${models.length} model type${plural} → ${args.out}\\n`,\n );\n\n if (args.bindingsOut) {\n const bindingsPath = resolve(process.cwd(), args.bindingsOut);\n await mkdir(dirname(bindingsPath), { recursive: true });\n await writeFile(bindingsPath, generateBindings(models, { version: VERSION }), \"utf8\");\n process.stdout.write(`✓ Generated Live Preview bindings → ${args.bindingsOut}\\n`);\n }\n\n if (args.componentsOut) {\n const componentsPath = resolve(process.cwd(), args.componentsOut);\n await mkdir(dirname(componentsPath), { recursive: true });\n await writeFile(componentsPath, generateComponents({ version: VERSION }), \"utf8\");\n process.stdout.write(`✓ Generated render components → ${args.componentsOut}\\n`);\n }\n}\n\nmain().catch((err: unknown) => {\n process.stderr.write(`error: ${err instanceof Error ? err.message : String(err)}\\n`);\n process.exit(1);\n});\n","/**\n * Fetches content models from the BetterCMS Management API so the CLI can generate\n * types against a live project. Kept dependency-free (plain fetch) so the generated\n * artifact and this fetcher can run anywhere — a GitHub Action, a postinstall, a script.\n */\n\nimport type { GeneratableModel } from \"./generate.js\";\n\nexport interface FetchModelsOptions {\n /** Management API base, e.g. \"https://api.bettercms.ai/api/v1\". */\n apiUrl: string;\n /** A management-scoped key (content:manage) or device-minted token. */\n apiKey: string;\n /** Optional fetch override (testing / custom runtime). */\n fetchImpl?: typeof fetch;\n}\n\ninterface ManagedModelRow {\n slug: string;\n name?: string;\n description?: string | null;\n fields: GeneratableModel[\"fields\"];\n}\n\n/**\n * GET /management/content/models — returns the project's models (the key is\n * project-scoped server-side, so this is exactly the schema for this site).\n */\nexport async function fetchModels(\n opts: FetchModelsOptions,\n): Promise<GeneratableModel[]> {\n const doFetch = opts.fetchImpl ?? globalThis.fetch;\n const base = opts.apiUrl.replace(/\\/+$/, \"\");\n const url = `${base}/management/content/models`;\n\n let res: Response;\n try {\n res = await doFetch(url, {\n // No Content-Type: this is a bodyless GET; the header is incorrect here and\n // strict edge runtimes/proxies may reject it.\n headers: { Authorization: `Bearer ${opts.apiKey}`, Accept: \"application/json\" },\n });\n } catch (err) {\n throw new Error(\n `Could not reach the BetterCMS Management API at ${url}: ${\n err instanceof Error ? err.message : String(err)\n }`,\n );\n }\n\n if (!res.ok) {\n const hint =\n res.status === 401 || res.status === 403\n ? \" — check your management API key (it must have the content:manage scope).\"\n : \"\";\n throw new Error(`Management API returned ${res.status} ${res.statusText}${hint}`);\n }\n\n const body = (await res.json()) as { data?: ManagedModelRow[] };\n const rows = body.data ?? [];\n return rows.map((r) => ({\n slug: r.slug,\n name: r.name,\n description: r.description ?? null,\n fields: r.fields ?? [],\n }));\n}\n","/**\n * @bettercms-ai/codegen — schema → TypeScript generator (the single source of truth).\n *\n * Both the dashboard schema builder and the MCP `create_model`/`add_field` tools write\n * the SAME `content_models.fields` (an array of `ContentModelField`). This generator maps\n * that one array into TypeScript. Because there is exactly one schema representation, the\n * generated types can never drift from the editor or the agent — they are the same source.\n *\n * Pure + deterministic: same models in → identical string out (stable ordering, no clock,\n * no I/O). That makes it trivially testable and safe to commit + diff in a customer repo.\n */\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\n\n/** Minimal model shape the generator needs — a subset of the Management API model row. */\nexport interface GeneratableModel {\n /** Machine-safe slug, e.g. \"blog\" or \"case-study\". Used for the schema-map key. */\n slug: string;\n /** Human name, used only for the JSDoc header. */\n name?: string;\n description?: string | null;\n fields: ContentModelField[];\n}\n\nexport interface GenerateOptions {\n /** Generator version stamped into the header (defaults to the package version). */\n version?: string;\n /** Override the banner timestamp source — omitted by default so output is deterministic. */\n bannerComment?: string;\n}\n\n/** Helper types emitted once at the top of every generated file (self-contained, zero-dep). */\nconst PREAMBLE = `/**\n * Rich-text field value returned by the Delivery API.\n *\n * - \\`format\\`/\\`value\\`: the portable, editor-agnostic payload (Lexical EditorState) —\n * render it with your editor's serializer for full fidelity.\n * - \\`html\\`: server-rendered, sanitized HTML (computed render-on-write). Present on\n * Delivery reads; the simplest path for non-React consumers — safe to inject directly\n * (e.g. \\`dangerouslySetInnerHTML\\`). Optional: legacy/un-normalized values may omit it.\n *\n * The \\`{ format, value }\\` contract is unchanged; \\`html\\` is additive.\n */\nexport type RichText = {\n readonly format: string;\n readonly value: unknown;\n readonly html?: string;\n};\n\n/**\n * Image / media field value as stored and returned verbatim by the Delivery API\n * (server-normalized on write to the canonical shape). \\`url\\` is always present; an\n * unresolved/external value may carry only \\`url\\`. \\`altText\\` is the accessibility text\n * for \\`<img alt>\\`.\n */\nexport interface BetterCMSImage {\n readonly id?: string;\n readonly url: string;\n readonly name?: string;\n readonly altText?: string | null;\n readonly width?: number;\n readonly height?: number;\n}\n\n/**\n * Delivery envelope around a model's typed \\`data\\`. \\`getEntry\\`/\\`listEntries\\` in the\n * Next adapter return this shape, with \\`fields\\` typed by the model.\n */\nexport interface BetterCMSEntry<TFields> {\n readonly slug: string;\n readonly status: \"draft\" | \"published\";\n readonly fields: TFields;\n readonly updatedAt: string;\n}\n`;\n\n/** PascalCase an identifier from a slug: \"case-study\" → \"CaseStudy\". */\nfunction pascalCase(slug: string): string {\n const parts = slug.split(/[-_\\s]+/).filter(Boolean);\n const pascal = parts\n .map((p) => p.charAt(0).toUpperCase() + p.slice(1))\n .join(\"\");\n // Guard against an identifier that starts with a digit (invalid TS type name).\n return /^[0-9]/.test(pascal) ? `Model${pascal}` : pascal || \"Model\";\n}\n\n/**\n * Make a string safe to embed inside a `/** ... */` JSDoc comment. A field label\n * (free-text, author/agent-controlled) could contain `*/` — which closes the comment\n * early and injects the remainder as code — or a newline, which breaks the single-line\n * comment. Both are neutralized here. Without this, hostile content produces non-\n * compiling (or worse, code-injected) output.\n */\nfunction escapeJsDoc(text: string): string {\n return text.replace(/\\*\\//g, \"* /\").replace(/[\\r\\n]+/g, \" \").trim();\n}\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/**\n * Render a field key as a TS property name. Field keys are author/agent-controlled and\n * not guaranteed to be valid identifiers (e.g. \"my-field\", \"1title\", \"\"), so anything\n * that isn't a bare identifier is emitted as a quoted property name — always valid TS.\n */\nfunction propName(key: string): string {\n return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/** A scalar/primitive field maps to a TS type expression (no nesting). */\nfunction scalarType(field: ContentModelField): string {\n const t: ContentModelFieldType = field.type;\n switch (t) {\n case \"text\":\n return \"string\";\n case \"richtext\":\n return \"RichText\";\n case \"image\":\n return \"BetterCMSImage\";\n case \"boolean\":\n return \"boolean\";\n case \"number\":\n return \"number\";\n case \"date\":\n case \"datetime\":\n return \"string\"; // ISO 8601\n case \"select\": {\n const opts = field.options?.filter((o) => typeof o === \"string\") ?? [];\n return opts.length > 0\n ? opts.map((o) => JSON.stringify(o)).join(\" | \")\n : \"string\";\n }\n case \"reference\":\n return \"string\"; // referenced entry id\n case \"multi-reference\":\n return \"string[]\"; // referenced entry ids\n case \"array\": {\n // Zoned arrays (config.zones) are expanded by fieldsToBody before reaching here;\n // this branch handles only the primitive list form (config.itemType).\n const itemType = field.config?.itemType ?? \"text\";\n const inner =\n itemType === \"number\" ? \"number\" : \"string\"; // text | date → string\n return `${inner}[]`;\n }\n default: {\n // Exhaustiveness guard: if a new field type is added to the union and not\n // mapped here, this line becomes a compile error in the codegen build.\n const _exhaustive: never = t;\n return \"unknown\";\n }\n }\n}\n\n/**\n * Render the TS type for a zoned `array` field: an object with optional\n * `nonRepeatable` (a fixed block) and/or `repeatable` (a list of blocks). Recurses\n * through zone fields, so a zone field that is itself a zoned `array` nests naturally.\n */\nfunction arrayZoneType(field: ContentModelField, indent: string): string {\n const zones = field.config?.zones;\n const parts: string[] = [];\n if (zones?.nonRepeatable?.length) {\n const nested = fieldsToBody(zones.nonRepeatable, indent + \" \");\n parts.push(`${indent} readonly nonRepeatable?: {\\n${nested}\\n${indent} };`);\n }\n if (zones?.repeatable?.fields?.length) {\n const nested = fieldsToBody(zones.repeatable.fields, indent + \" \");\n parts.push(`${indent} readonly repeatable?: Array<{\\n${nested}\\n${indent} }>;`);\n }\n if (parts.length === 0) return \"Record<string, unknown>\"; // zoned array with no fields yet\n return `{\\n${parts.join(\"\\n\")}\\n${indent}}`;\n}\n\n/** Render the body of an object type from a field list, recursing into zones. */\nfunction fieldsToBody(fields: ContentModelField[], indent: string): string {\n const lines: string[] = [];\n for (const field of fields) {\n const optional = field.required ? \"\" : \"?\";\n let typeExpr: string;\n\n if (field.type === \"array\" && field.config?.zones) {\n typeExpr = arrayZoneType(field, indent);\n } else {\n typeExpr = scalarType(field);\n }\n\n const safeLabel = field.label ? escapeJsDoc(field.label) : \"\";\n if (safeLabel && safeLabel !== field.key) {\n lines.push(`${indent}/** ${safeLabel} */`);\n }\n lines.push(`${indent}readonly ${propName(field.key)}${optional}: ${typeExpr};`);\n }\n return lines.join(\"\\n\");\n}\n\n/**\n * Generate a complete `.ts` module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n */\nexport function generateTypes(\n models: GeneratableModel[],\n opts: GenerateOptions = {},\n): string {\n const version = opts.version ?? \"0.1.0\";\n // Code-unit sort (NOT localeCompare): locale/ICU-independent so the generated\n // file is byte-identical on every machine — committed output diffs cleanly.\n const sorted = [...models].sort((a, b) =>\n a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n );\n\n const header = `// ⚠️ AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen\n// Source of truth: your BetterCMS content models (the same schema the dashboard\n// builder and the MCP tools write). Re-run codegen after any schema change.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n const interfaces: string[] = [];\n const mapEntries: string[] = [];\n // Different slugs can PascalCase to the same base name (e.g. \"case-study\" and\n // \"case_study\" → \"CaseStudy\"). Emitting two identical interfaces would silently\n // declaration-merge into one wrong type, so disambiguate with a numeric suffix.\n const usedNames = new Set<string>();\n\n for (const model of sorted) {\n const base = `${pascalCase(model.slug)}Fields`;\n let typeName = base;\n for (let n = 2; usedNames.has(typeName); n++) typeName = `${base}_${n}`;\n usedNames.add(typeName);\n\n const name = model.name ? escapeJsDoc(model.name) : \"\";\n const desc = model.description ? escapeJsDoc(model.description) : \"\";\n const doc = name\n ? `/**\\n * ${name}${desc ? ` — ${desc}` : \"\"}\\n * Model slug: \\`${model.slug}\\`\\n */\\n`\n : \"\";\n const body = model.fields.length\n ? fieldsToBody(model.fields, \" \")\n : \" // (no fields defined yet)\";\n interfaces.push(`${doc}export interface ${typeName} {\\n${body}\\n}`);\n mapEntries.push(` readonly ${JSON.stringify(model.slug)}: ${typeName};`);\n }\n\n const schemaMap = `/**\n * Registry mapping each model slug to its typed fields. The Next adapter uses this to\n * type \\`getEntry(\"blog\", ...)\\` by slug — autocomplete and exhaustiveness for free.\n */\nexport interface BetterCMSSchema {\n${mapEntries.join(\"\\n\") || \" // (no models defined yet)\"}\n}\n\n/** Union of all model slugs. */\nexport type BetterCMSModelSlug = keyof BetterCMSSchema;`;\n\n return [header, PREAMBLE, interfaces.join(\"\\n\\n\"), schemaMap, \"\"].join(\"\\n\");\n}\n","/**\n * @bettercms-ai/codegen — schema → Live Preview binding helper generator.\n *\n * Companion to {@link generateTypes}. Where that emits the *types*, this emits a\n * tiny, schema-derived runtime that stamps `data-bcms-field` / `data-bcms-kind`\n * attributes onto the elements a site author binds to CMS content. Those\n * attributes are what the dashboard's Live Preview editor reads to turn the real,\n * running site into an editable canvas (the parent maps `data-bcms-field` → its\n * internal `data-node-id` on frame load).\n *\n * Why a helper and not auto-injection: BetterCMS never renders the customer's DOM\n * — the site does. So binding is opt-in per element via a spread:\n *\n * import { bcms } from \"./bettercms.bindings.generated\";\n *\n * <h1 {...bcms.blog.title}>{entry.fields.title}</h1> // scalar\n * <li {...bcms.blog.tags.value(i)}>{tag}</li> // primitive-array item\n * <article {...bcms.blog.features.$(i)}> // array item root\n * <h3 {...bcms.blog.features.label(i)}>{f.label}</h3> // array item sub-field\n * </article>\n *\n * The attributes only appear when the site is built with `BCMS_ANNOTATE` set\n * (preview builds); a normal production build ships zero extra attributes, because\n * `bcmsField` returns `{}`. Same generated file, both builds — no separate mode.\n *\n * Pure + deterministic, exactly like the type generator: same models in → identical\n * string out (slug-sorted, field order preserved, no clock, no I/O). Field keys are\n * author/agent-controlled, so every embedded key is emitted as an escaped string\n * literal (never interpolated into code) — hostile input can't break the output.\n *\n * Grammar — mirrors what the editor's `fieldPathToNodeId` resolves:\n * `title` · `hero.heroTitle` · `hero.primaryCta.label` (group leaves, any depth)\n * `features[0]` · `features[0].label` · `intro.facts[0].label` (repeaters, one index)\n * Group (non-repeatable) zones recurse into nested binding objects; a repeater is an\n * object with `$(i)` (item root) + one accessor per scalar sub-field. Arrays nested\n * inside a repeater item (a second index) are still beyond what the editor can\n * address, so they are intentionally omitted rather than emitted as dead paths.\n */\n\nimport type { ContentModelField, ContentModelFieldType } from \"@bettercms-ai/types\";\nimport type { GeneratableModel, GenerateOptions } from \"./generate.js\";\n\nconst VALID_IDENT = /^[A-Za-z_$][A-Za-z0-9_$]*$/;\n\n/**\n * Render a field key as an object property name. Keys aren't guaranteed to be valid\n * identifiers (e.g. \"my-field\", \"1title\"), so anything that isn't a bare identifier\n * is quoted — always valid TS. (Mirrors the same helper in `generate.ts`.)\n */\nfunction propName(key: string): string {\n return VALID_IDENT.test(key) ? key : JSON.stringify(key);\n}\n\n/**\n * The kind label written to `data-bcms-kind`, mapped to the editor's closed field-type\n * set (matches the dashboard adapter's `toEditorFieldType`): API-only types that have\n * no on-canvas control collapse to \"text\". Informational today — the editor derives the\n * authoritative kind from the loaded model — but kept truthful for debugging/forward use.\n */\nfunction bindingKind(t: ContentModelFieldType): string {\n switch (t) {\n case \"text\":\n case \"richtext\":\n case \"image\":\n case \"boolean\":\n case \"number\":\n case \"select\":\n case \"array\":\n return t;\n // reference / multi-reference / date / datetime → plain text in the editor v1.\n default:\n return \"text\";\n }\n}\n\n/**\n * Build a runtime path expression for an array element: a string literal split around\n * the index so it concatenates at call time. Both halves are JSON-escaped, so an\n * author-controlled key can never inject code. e.g. (\"features[\", \"].label\") →\n * `\"features[\" + i + \"].label\"`.\n */\nfunction indexedPath(prefix: string, suffix: string): string {\n return `${JSON.stringify(prefix)} + i + ${JSON.stringify(suffix)}`;\n}\n\n/** Render a repeater binding object: `$(i)` item root + one accessor per scalar\n * sub-field. `path` is the repeater's full (possibly dotted) field path. */\nfunction repeaterBinding(\n itemFields: ContentModelField[],\n path: string,\n indent: string,\n): string {\n const lines: string[] = [\n `${indent} $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n ];\n for (const sub of itemFields) {\n // A sub-field that is itself an array would need a second index the editor\n // can't address yet — skip it rather than emit a path that won't bind.\n if (sub.type === \"array\") continue;\n lines.push(\n `${indent} ${propName(sub.key)}: (i: number) => bcmsField(${indexedPath(`${path}[`, `].${sub.key}`)}, ${JSON.stringify(bindingKind(sub.type))}),`,\n );\n }\n return `{\\n${lines.join(\"\\n\")}\\n${indent}}`;\n}\n\n/** Render the binding for one field at `path`, recursing into group zones. */\nfunction fieldBinding(\n field: ContentModelField,\n prefix: string,\n indent: string,\n): string {\n const path = prefix ? `${prefix}.${field.key}` : field.key;\n const name = propName(field.key);\n\n if (field.type !== \"array\") {\n return `${indent}${name}: bcmsField(${JSON.stringify(path)}, ${JSON.stringify(bindingKind(field.type))}),`;\n }\n\n const zones = field.config?.zones;\n // Group (non-repeatable) → a nested object of dotted-path leaf bindings.\n if (zones?.nonRepeatable?.length) {\n const body = zones.nonRepeatable\n .map((child) => fieldBinding(child, path, `${indent} `))\n .join(\"\\n\");\n return `${indent}${name}: {\\n${body}\\n${indent}},`;\n }\n // Repeater → `$(i)` + scalar sub-field accessors.\n if (zones?.repeatable?.fields?.length) {\n return `${indent}${name}: ${repeaterBinding(zones.repeatable.fields, path, indent)},`;\n }\n // Primitive list (`config.itemType` or bare) → `$(i)` + synthetic `value(i)`.\n const lines = [\n `${indent} $: (i: number) => bcmsField(${indexedPath(`${path}[`, \"]\")}, \"array\"),`,\n `${indent} value: (i: number) => bcmsField(${indexedPath(`${path}[`, \"].value\")}, \"text\"),`,\n ];\n return `${indent}${name}: {\\n${lines.join(\"\\n\")}\\n${indent}},`;\n}\n\n/** Render the binding entries for one model's fields (field order preserved). */\nfunction fieldsToBindings(fields: ContentModelField[], indent: string): string {\n return fields.map((field) => fieldBinding(field, \"\", indent)).join(\"\\n\");\n}\n\n/** The self-contained runtime emitted once at the top of every bindings file. */\nconst PREAMBLE = `/**\n * True when this site is built for Live Preview annotation. Set \\`BCMS_ANNOTATE=1\\`\n * in the preview build only; unset (the default) ships zero binding attributes.\n * Read defensively so the module is safe in any runtime (browser, Node, edge).\n */\nconst BCMS_ANNOTATE: boolean = (() => {\n try {\n const v = (globalThis as { process?: { env?: Record<string, string | undefined> } })\n .process?.env?.BCMS_ANNOTATE;\n return v != null && v !== \"\" && v !== \"0\" && v !== \"false\";\n } catch {\n return false;\n }\n})();\n\n/**\n * Binding attributes for a CMS-bound element. Spread onto the element that renders a\n * field: \\`<h1 {...bcmsField(\"title\", \"text\")}>\\`. Returns \\`{}\\` unless BCMS_ANNOTATE\n * is set, so production markup is untouched.\n */\nexport function bcmsField(path: string, kind: string): Record<string, string> {\n return BCMS_ANNOTATE ? { \"data-bcms-field\": path, \"data-bcms-kind\": kind } : {};\n}\n`;\n\n/**\n * Generate the Live Preview bindings module from a set of content models.\n * Deterministic: models are sorted by slug; field order is preserved as authored.\n */\nexport function generateBindings(\n models: GeneratableModel[],\n opts: GenerateOptions = {},\n): string {\n const version = opts.version ?? \"0.1.0\";\n // Code-unit sort (NOT localeCompare) so output is byte-identical on every machine.\n const sorted = [...models].sort((a, b) =>\n a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0,\n );\n\n const header = `// ⚠️ AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Live Preview field bindings. Regenerate with: npx @bettercms-ai/codegen --bindings-out <path>\n// Spread these onto the elements that render your content; they emit\n// data-bcms-field/data-bcms-kind only when the site is built with BCMS_ANNOTATE set.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n const entries = sorted.map((model) => {\n const body = model.fields.length\n ? `\\n${fieldsToBindings(model.fields, \" \")}\\n `\n : \"\";\n return ` ${JSON.stringify(model.slug)}: {${body}},`;\n });\n\n const bcms = `/**\n * Field bindings keyed by model slug. Spread a binding onto the element that renders\n * that field. Arrays expose \\`$(i)\\` for the item element and one accessor per\n * (one-level) sub-field; primitive arrays expose \\`value(i)\\` for the item's scalar.\n */\nexport const bcms = {\n${entries.join(\"\\n\") || \" // (no models defined yet)\"}\n} as const;`;\n\n return [header, PREAMBLE, bcms, \"\"].join(\"\\n\");\n}\n","/**\n * @bettercms-ai/codegen — schema → typed React render components generator.\n *\n * Companion to {@link generateTypes} (types) and {@link generateBindings} (Live\n * Preview attributes). This emits a small, self-contained `.tsx` module with two\n * components that render the canonical Delivery field shapes CORRECTLY, so authors\n * never hand-roll the rendering that produces the classic bugs:\n *\n * - <RichText> renders the server-sanitized `html` via `dangerouslySetInnerHTML`,\n * instead of interpolating the value as a JSX child (which React escapes, so the\n * page shows literal `<p>…</p>` tags — the #6 escaped-richtext bug).\n * - <Image> reads the normalized image object's `.url`/`.altText`, instead of\n * treating the object as a string.\n *\n * The emitted module is intentionally generic (not per-model) and dependency-free\n * beyond React, so it is a drop-in: point codegen at a path and import the two\n * components. It is deterministic (no clock, no I/O) like the sibling generators.\n *\n * Security: `html` is the Delivery API's server-rendered, DOMPurify-sanitized output\n * (see the RichText type docs). `<RichText>` injects exactly that field. If a caller\n * passes HTML from another, untrusted source they must sanitize it themselves.\n */\n\nimport type { GenerateOptions } from \"./generate.js\";\n\n/**\n * Generate the `bettercms.components.tsx` module: typed `<RichText>` and `<Image>`\n * components for the canonical Delivery field shapes. Deterministic — same options\n * in, identical string out.\n */\nexport function generateComponents(opts: GenerateOptions = {}): string {\n const version = opts.version ?? \"0.1.0\";\n const header = `// ⚠️ AUTO-GENERATED by @bettercms-ai/codegen v${version} — DO NOT EDIT.\n// Regenerate with: npx @bettercms-ai/codegen --components-out <path>\n// Typed render components for BetterCMS field shapes. Use these instead of\n// hand-rendering richtext/image values — they render the canonical shapes correctly.\n${opts.bannerComment ? `// ${opts.bannerComment}\\n` : \"\"}`;\n\n const body = `import * as React from \"react\";\n\n/** Rich-text value from the Delivery API. \\`html\\` is server-rendered + sanitized. */\nexport type RichTextValue = {\n readonly format: string;\n readonly value: unknown;\n readonly html?: string;\n};\n\n/** Normalized image/media value from the Delivery API. */\nexport interface BetterCMSImageValue {\n readonly url: string;\n readonly altText?: string | null;\n readonly width?: number;\n readonly height?: number;\n}\n\ntype RichTextProps = {\n /** The richtext field value (\\`entry.fields.someRichText\\`). */\n field?: RichTextValue | null;\n /** Element/component to render as. Default: \\`\"div\"\\`. */\n as?: React.ElementType;\n} & Omit<React.HTMLAttributes<HTMLElement>, \"dangerouslySetInnerHTML\" | \"children\">;\n\n/**\n * Render a richtext field as HTML. Uses the server-sanitized \\`html\\` via\n * \\`dangerouslySetInnerHTML\\` — NEVER interpolate a richtext value as a JSX child\n * (React escapes it, so the page shows literal tags). Renders nothing when unset.\n */\nexport function RichText({ field, as: Tag = \"div\", ...rest }: RichTextProps) {\n if (!field || !field.html) return null;\n return <Tag {...rest} dangerouslySetInnerHTML={{ __html: field.html }} />;\n}\n\ntype ImageProps = {\n /** The image field value (\\`entry.fields.someImage\\`). */\n field?: BetterCMSImageValue | null;\n /** Alt text override; defaults to the field's \\`altText\\`, then \\`\"\"\\`. */\n alt?: string;\n} & Omit<React.ImgHTMLAttributes<HTMLImageElement>, \"src\">;\n\n/**\n * Render an image field as an \\`<img>\\` from its normalized \\`.url\\`/\\`.altText\\`.\n * Renders nothing when unset. Pass \\`alt\\` to override the stored alt text.\n */\nexport function Image({ field, alt, ...rest }: ImageProps) {\n if (!field || !field.url) return null;\n return (\n <img\n src={field.url}\n alt={alt ?? field.altText ?? \"\"}\n width={field.width}\n height={field.height}\n {...rest}\n />\n );\n}\n`;\n\n return [header, body].join(\"\\n\");\n}\n"],"mappings":"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","names":["VALID_IDENT","propName","PREAMBLE"]}