@nextblock-cms/cortex 0.20.1 → 0.21.0

package/lib/block-content-schemas.es.js

@@ -1,262 +1,332 @@
-import "./zod-config.es.js";
-import { z as t } from "zod";
-const d = [
-  "text",
-  "heading",
-  "image",
-  "button",
-  "posts_grid",
-  "video_embed",
-  "section",
-  "form",
-  "testimonial",
-  "product_grid",
-  "featured_product",
-  "cart",
-  "checkout",
-  "product_details"
-], b = t.enum(d), m = t.object({
-  direction: t.string().optional(),
-  stops: t.array(t.object({ color: t.string(), position: t.number() })),
-  type: t.enum(["linear", "radial"])
-}), g = t.object({
-  gradient: m.optional(),
-  image: t.object({
-    alt_text: t.string().optional(),
-    blur_data_url: t.string().optional(),
-    external_url: t.string().optional(),
-    height: t.number().optional(),
-    media_id: t.string().optional(),
-    object_key: t.string().optional(),
-    overlay: t.object({
-      gradient: m,
-      type: t.literal("gradient")
-    }).optional(),
-    position: t.enum(["center", "top", "bottom", "left", "right"]),
-    quality: t.number().nullable().optional(),
-    size: t.enum(["cover", "contain"]),
-    width: t.number().optional()
-  }).optional(),
-  min_height: t.string().optional(),
-  solid_color: t.string().optional(),
-  theme: t.enum(["primary", "secondary", "muted", "accent", "destructive"]).optional(),
-  type: t.enum(["none", "theme", "solid", "gradient", "image"])
-}), f = t.string().regex(/^[a-z][a-z0-9-]*$/), p = t.object({
-  block_type: t.union([b, f]),
-  content: t.record(t.string(), t.any()),
-  temp_id: t.string().optional()
-}), y = t.object({
-  background: g,
-  column_blocks: t.array(t.array(p))
-}), h = t.object({
-  // Slider settings mirror the editor's "Enable Slider (Carousel layout)" panel:
-  // `autoplay` rotates the slides every `timeframe` SECONDS (5 when omitted).
-  autoplay: t.boolean().optional(),
-  background: g,
-  column_blocks: t.array(t.array(p)),
-  column_gap: t.enum(["none", "sm", "md", "lg", "xl"]),
-  container_type: t.enum(["full-width", "container", "container-sm", "container-lg", "container-xl"]),
-  // The editor's "Hero Section (Prioritized image loading)" checkbox: the section's
-  // background image (and the first slide's images) load with priority, and the
-  // normalizer centres its content vertically.
-  is_hero: t.boolean().optional(),
-  padding: t.object({
-    bottom: t.enum(["none", "sm", "md", "lg", "xl"]),
-    top: t.enum(["none", "sm", "md", "lg", "xl"])
-  }),
-  responsive_columns: t.object({
-    desktop: t.union([t.literal(1), t.literal(2), t.literal(3), t.literal(4)]),
-    mobile: t.union([t.literal(1), t.literal(2)]),
-    tablet: t.union([t.literal(1), t.literal(2), t.literal(3)])
-  }),
-  // With `slider: true` and a non-empty `slides` list the renderer shows a carousel
-  // of those slides and ignores the top-level `column_blocks` and `background`.
-  slider: t.boolean().optional(),
-  slides: t.array(y).optional(),
-  timeframe: t.number().optional(),
-  vertical_alignment: t.enum(["start", "center", "end", "stretch"]).optional()
-}), _ = {
-  button: t.object({
-    position: t.enum(["left", "center", "right"]).optional(),
-    size: t.enum(["default", "sm", "lg", "full"]).optional(),
-    text: t.string(),
-    url: t.string(),
-    variant: t.enum(["default", "outline", "secondary", "ghost", "link"]).optional()
-  }),
-  cart: t.object({}),
-  checkout: t.object({}),
-  featured_product: t.object({
-    imagePosition: t.enum(["left", "right"]).default("left"),
-    productId: t.string().min(1),
-    showBackground: t.boolean().default(!1)
-  }),
-  form: t.object({
-    fields: t.array(
-      t.object({
-        // Mirrors FormFieldSchema in apps/nextblock/lib/blocks/blockRegistry.ts.
-        field_type: t.enum(["text", "email", "tel", "url", "number", "textarea", "select", "radio", "checkbox"]),
-        is_required: t.boolean(),
-        label: t.string(),
-        options: t.array(t.object({ label: t.string(), value: t.string() })).optional(),
-        placeholder: t.string().optional(),
-        temp_id: t.string()
-      })
-    ),
-    // Opaque handle into form_endpoints, which holds the destination server-side.
-    form_key: t.string().optional(),
-    // Legacy. Migration 27 moved every address out of block content; kept optional so
-    // an older payload still validates, and stripped before the block reaches a browser.
-    recipient_email: t.string().email().optional(),
-    submit_button_text: t.string(),
-    success_message: t.string()
-  }),
-  heading: t.object({
-    level: t.union([t.literal(1), t.literal(2), t.literal(3), t.literal(4), t.literal(5), t.literal(6)]),
-    textAlign: t.enum(["left", "center", "right", "justify"]).optional(),
-    // Mirrors TextColorSchema in apps/nextblock/lib/blocks/blockRegistry.ts —
-    // a theme token, or a literal CSS colour from the block editor's picker.
-    // libs/* cannot import from the app, so the union is restated here.
-    textColor: t.union([
-      t.enum(["foreground", "primary", "secondary", "accent", "muted", "destructive", "background"]),
-      t.string().regex(
-        /^(#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})|rgba?\([^)]+\)|hsla?\([^)]+\))$/i,
-        "Must be a hex, rgb(a) or hsl(a) colour"
-      )
-    ]).optional().describe("Prefer a theme token so the heading adapts to dark mode; use a CSS colour only when the brand requires an exact value"),
-    text_content: t.string()
-  }),
-  image: t.object({
-    alt_text: t.string().optional(),
-    caption: t.string().optional(),
-    external_url: t.string().nullable().optional(),
-    height: t.number().nullable().optional(),
-    media_id: t.string().nullable().optional(),
-    object_key: t.string().nullable().optional(),
-    width: t.number().nullable().optional()
-  }),
-  posts_grid: t.object({
-    columns: t.number().min(1).max(6),
-    postsPerPage: t.number().min(1).max(50),
-    showPagination: t.boolean(),
-    title: t.string().optional()
-  }),
-  product_details: t.object({}),
-  product_grid: t.object({
-    categoryId: t.string().optional(),
-    categoryIds: t.array(t.string()).max(20).optional(),
-    // 0 = unlimited (every match on one page).
-    limit: t.number().min(0).max(48).default(6),
-    productIds: t.array(t.string()).max(24).optional(),
-    showPagination: t.boolean().default(!1),
-    title: t.string().optional(),
-    type: t.enum(["latest", "category", "manual"]).default("latest")
-  }),
-  section: h,
-  testimonial: t.object({
-    author_name: t.string().min(1),
-    author_title: t.string().optional(),
-    image_url: t.string().url().optional().or(t.literal("")),
-    quote: t.string().min(1)
-  }),
-  text: t.object({
-    html_content: t.string()
-  }),
-  video_embed: t.object({
-    autoplay: t.boolean().optional(),
-    controls: t.boolean().optional(),
-    title: t.string().optional(),
-    url: t.string()
-  })
+import { z as e } from "./zod-config.es.js";
+//#region libs/cortex/src/lib/block-content-schemas.ts
+var t = [
+	"text",
+	"heading",
+	"image",
+	"button",
+	"posts_grid",
+	"video_embed",
+	"section",
+	"form",
+	"testimonial",
+	"product_grid",
+	"featured_product",
+	"cart",
+	"checkout",
+	"product_details"
+], n = e.enum(t), r = e.object({
+	direction: e.string().optional(),
+	stops: e.array(e.object({
+		color: e.string(),
+		position: e.number()
+	})),
+	type: e.enum(["linear", "radial"])
+}), i = e.object({
+	gradient: r.optional(),
+	image: e.object({
+		alt_text: e.string().optional(),
+		blur_data_url: e.string().optional(),
+		external_url: e.string().optional(),
+		height: e.number().optional(),
+		media_id: e.string().optional(),
+		object_key: e.string().optional(),
+		overlay: e.object({
+			gradient: r,
+			type: e.literal("gradient")
+		}).optional(),
+		position: e.enum([
+			"center",
+			"top",
+			"bottom",
+			"left",
+			"right"
+		]),
+		quality: e.number().nullable().optional(),
+		size: e.enum(["cover", "contain"]),
+		width: e.number().optional()
+	}).optional(),
+	min_height: e.string().optional(),
+	solid_color: e.string().optional(),
+	theme: e.enum([
+		"primary",
+		"secondary",
+		"muted",
+		"accent",
+		"destructive"
+	]).optional(),
+	type: e.enum([
+		"none",
+		"theme",
+		"solid",
+		"gradient",
+		"image"
+	])
+}), a = e.string().regex(/^[a-z][a-z0-9-]*$/), o = e.object({
+	block_type: e.union([n, a]),
+	content: e.record(e.string(), e.any()),
+	temp_id: e.string().optional()
+}), s = e.object({
+	background: i,
+	column_blocks: e.array(e.array(o))
+}), c = e.object({
+	autoplay: e.boolean().optional(),
+	background: i,
+	column_blocks: e.array(e.array(o)),
+	column_gap: e.enum([
+		"none",
+		"sm",
+		"md",
+		"lg",
+		"xl"
+	]),
+	container_type: e.enum([
+		"full-width",
+		"container",
+		"container-sm",
+		"container-lg",
+		"container-xl"
+	]),
+	is_hero: e.boolean().optional(),
+	padding: e.object({
+		bottom: e.enum([
+			"none",
+			"sm",
+			"md",
+			"lg",
+			"xl"
+		]),
+		top: e.enum([
+			"none",
+			"sm",
+			"md",
+			"lg",
+			"xl"
+		])
+	}),
+	responsive_columns: e.object({
+		desktop: e.union([
+			e.literal(1),
+			e.literal(2),
+			e.literal(3),
+			e.literal(4)
+		]),
+		mobile: e.union([e.literal(1), e.literal(2)]),
+		tablet: e.union([
+			e.literal(1),
+			e.literal(2),
+			e.literal(3)
+		])
+	}),
+	slider: e.boolean().optional(),
+	slides: e.array(s).optional(),
+	timeframe: e.number().optional(),
+	vertical_alignment: e.enum([
+		"start",
+		"center",
+		"end",
+		"stretch"
+	]).optional()
+}), l = {
+	button: e.object({
+		position: e.enum([
+			"left",
+			"center",
+			"right"
+		]).optional(),
+		size: e.enum([
+			"default",
+			"sm",
+			"lg",
+			"full"
+		]).optional(),
+		text: e.string(),
+		url: e.string(),
+		variant: e.enum([
+			"default",
+			"outline",
+			"secondary",
+			"ghost",
+			"link"
+		]).optional()
+	}),
+	cart: e.object({}),
+	checkout: e.object({}),
+	featured_product: e.object({
+		imagePosition: e.enum(["left", "right"]).default("left"),
+		productId: e.string().min(1),
+		showBackground: e.boolean().default(!1)
+	}),
+	form: e.object({
+		fields: e.array(e.object({
+			field_type: e.enum([
+				"text",
+				"email",
+				"tel",
+				"url",
+				"number",
+				"textarea",
+				"select",
+				"radio",
+				"checkbox"
+			]),
+			is_required: e.boolean(),
+			label: e.string(),
+			options: e.array(e.object({
+				label: e.string(),
+				value: e.string()
+			})).optional(),
+			placeholder: e.string().optional(),
+			temp_id: e.string()
+		})),
+		form_key: e.string().optional(),
+		recipient_email: e.string().email().optional(),
+		submit_button_text: e.string(),
+		success_message: e.string()
+	}),
+	heading: e.object({
+		level: e.union([
+			e.literal(1),
+			e.literal(2),
+			e.literal(3),
+			e.literal(4),
+			e.literal(5),
+			e.literal(6)
+		]),
+		textAlign: e.enum([
+			"left",
+			"center",
+			"right",
+			"justify"
+		]).optional(),
+		textColor: e.union([e.enum([
+			"foreground",
+			"primary",
+			"secondary",
+			"accent",
+			"muted",
+			"destructive",
+			"background"
+		]), e.string().regex(/^(#(?:[0-9a-f]{3,4}|[0-9a-f]{6}|[0-9a-f]{8})|rgba?\([^)]+\)|hsla?\([^)]+\))$/i, "Must be a hex, rgb(a) or hsl(a) colour")]).optional().describe("Prefer a theme token so the heading adapts to dark mode; use a CSS colour only when the brand requires an exact value"),
+		text_content: e.string()
+	}),
+	image: e.object({
+		alt_text: e.string().optional(),
+		caption: e.string().optional(),
+		external_url: e.string().nullable().optional(),
+		height: e.number().nullable().optional(),
+		media_id: e.string().nullable().optional(),
+		object_key: e.string().nullable().optional(),
+		width: e.number().nullable().optional()
+	}),
+	posts_grid: e.object({
+		columns: e.number().min(1).max(6),
+		postsPerPage: e.number().min(1).max(50),
+		showPagination: e.boolean(),
+		title: e.string().optional()
+	}),
+	product_details: e.object({}),
+	product_grid: e.object({
+		categoryId: e.string().optional(),
+		categoryIds: e.array(e.string()).max(20).optional(),
+		limit: e.number().min(0).max(48).default(6),
+		productIds: e.array(e.string()).max(24).optional(),
+		showPagination: e.boolean().default(!1),
+		title: e.string().optional(),
+		type: e.enum([
+			"latest",
+			"category",
+			"manual"
+		]).default("latest")
+	}),
+	section: c,
+	testimonial: e.object({
+		author_name: e.string().min(1),
+		author_title: e.string().optional(),
+		image_url: e.string().url().optional().or(e.literal("")),
+		quote: e.string().min(1)
+	}),
+	text: e.object({ html_content: e.string() }),
+	video_embed: e.object({
+		autoplay: e.boolean().optional(),
+		controls: e.boolean().optional(),
+		title: e.string().optional(),
+		url: e.string()
+	})
 };
-function v(o) {
-  return d.includes(o);
+function u(e) {
+	return t.includes(e);
 }
-function k(o) {
-  return typeof o?.validateBlockContent == "function" ? o.validateBlockContent : null;
+function d(e) {
+	return typeof e?.validateBlockContent == "function" ? e.validateBlockContent : null;
 }
-function B(o, n, r) {
-  const l = k(r);
-  if (l)
-    return l(o, n);
-  const i = _[o].safeParse(n);
-  return i.success ? { errors: [], isValid: !0, warnings: [] } : {
-    errors: i.error.issues.map((s) => {
-      const e = s.path.join(".");
-      return e ? `${e}: ${s.message}` : s.message;
-    }),
-    isValid: !1,
-    warnings: []
-  };
+function f(e, t, n) {
+	let r = d(n);
+	if (r) return r(e, t);
+	let i = l[e].safeParse(t);
+	return i.success ? {
+		errors: [],
+		isValid: !0,
+		warnings: []
+	} : {
+		errors: i.error.issues.map((e) => {
+			let t = e.path.join(".");
+			return t ? `${t}: ${e.message}` : e.message;
+		}),
+		isValid: !1,
+		warnings: []
+	};
 }
-function j(o) {
-  return Array.isArray(o.fields) ? o.fields.filter(
-    (n) => !!n && typeof n == "object" && typeof n.key == "string" && typeof n.type == "string"
-  ) : [];
+function p(e) {
+	return Array.isArray(e.fields) ? e.fields.filter((e) => !!e && typeof e == "object" && typeof e.key == "string" && typeof e.type == "string") : [];
 }
-function x(o) {
-  return o == null || typeof o == "string" && o.trim() === "" || Array.isArray(o) && o.length === 0;
+function m(e) {
+	return e == null || typeof e == "string" && e.trim() === "" || Array.isArray(e) && e.length === 0;
 }
-function S(o, n) {
-  if (!n || typeof n != "object" || Array.isArray(n))
-    return {
-      errors: ["content must be a JSON object of { field_key: value } pairs."],
-      isValid: !1,
-      warnings: []
-    };
-  const r = j(o), l = new Set(r.map((e) => e.key)), i = [], s = [];
-  for (const e of Object.keys(n))
-    l.has(e) || i.push(
-      `Unknown field "${e}" for custom block "${o.slug}". Known fields: ${[...l].join(", ") || "(none)"}.`
-    );
-  for (const e of r) {
-    const a = n[e.key];
-    if (x(a)) {
-      e.required && i.push(`Field "${e.key}" is required.`);
-      continue;
-    }
-    if (e.type === "text" || e.type === "rich-text") {
-      if (typeof a != "string") {
-        i.push(`Field "${e.key}" must be a string${e.type === "rich-text" ? " of HTML" : ""}.`);
-        continue;
-      }
-      typeof e.max_length == "number" && a.length > e.max_length && i.push(`Field "${e.key}" exceeds its ${e.max_length}-character limit.`), typeof e.min_length == "number" && a.length < e.min_length && i.push(`Field "${e.key}" is shorter than its ${e.min_length}-character minimum.`);
-      continue;
-    }
-    if (e.type === "image_r2") {
-      const c = a;
-      (typeof a != "object" || Array.isArray(a) || typeof c.object_key != "string" || typeof c.url != "string") && i.push(
-        `Field "${e.key}" must be an uploaded image object with object_key and url (upload it with upload_media first) or null.`
-      );
-      continue;
-    }
-    if (e.type === "db_relation") {
-      const c = (u) => typeof u == "string" || typeof u == "number";
-      e.multiple ? (!Array.isArray(a) || !a.every(c)) && i.push(`Field "${e.key}" must be an array of related record ids.`) : c(a) || i.push(`Field "${e.key}" must be a single related record id.`);
-      continue;
-    }
-    s.push(`Field "${e.key}" has an unrecognised type "${String(e.type)}"; it was not validated.`);
-  }
-  return { errors: i, isValid: i.length === 0, warnings: s };
+function h(e, t) {
+	if (!t || typeof t != "object" || Array.isArray(t)) return {
+		errors: ["content must be a JSON object of { field_key: value } pairs."],
+		isValid: !1,
+		warnings: []
+	};
+	let n = p(e), r = new Set(n.map((e) => e.key)), i = [], a = [];
+	for (let n of Object.keys(t)) r.has(n) || i.push(`Unknown field "${n}" for custom block "${e.slug}". Known fields: ${[...r].join(", ") || "(none)"}.`);
+	for (let e of n) {
+		let n = t[e.key];
+		if (m(n)) {
+			e.required && i.push(`Field "${e.key}" is required.`);
+			continue;
+		}
+		if (e.type === "text" || e.type === "rich-text") {
+			if (typeof n != "string") {
+				i.push(`Field "${e.key}" must be a string${e.type === "rich-text" ? " of HTML" : ""}.`);
+				continue;
+			}
+			typeof e.max_length == "number" && n.length > e.max_length && i.push(`Field "${e.key}" exceeds its ${e.max_length}-character limit.`), typeof e.min_length == "number" && n.length < e.min_length && i.push(`Field "${e.key}" is shorter than its ${e.min_length}-character minimum.`);
+			continue;
+		}
+		if (e.type === "image_r2") {
+			let t = n;
+			(typeof n != "object" || Array.isArray(n) || typeof t.object_key != "string" || typeof t.url != "string") && i.push(`Field "${e.key}" must be an uploaded image object with object_key and url (upload it with upload_media first) or null.`);
+			continue;
+		}
+		if (e.type === "db_relation") {
+			let t = (e) => typeof e == "string" || typeof e == "number";
+			e.multiple ? (!Array.isArray(n) || !n.every(t)) && i.push(`Field "${e.key}" must be an array of related record ids.`) : t(n) || i.push(`Field "${e.key}" must be a single related record id.`);
+			continue;
+		}
+		a.push(`Field "${e.key}" has an unrecognised type "${String(e.type)}"; it was not validated.`);
+	}
+	return {
+		errors: i,
+		isValid: i.length === 0,
+		warnings: a
+	};
 }
-async function A(o) {
-  const { data: n, error: r } = await o.from("custom_block_definitions").select("slug, name, fields");
-  if (r)
-    throw new Error(
-      `Could not read the custom block definitions: ${typeof r == "object" && r && "message" in r ? String(r.message) : String(r)}`
-    );
-  return (Array.isArray(n) ? n : []).filter(
-    (l) => !!l && typeof l.slug == "string"
-  );
+async function g(e) {
+	let { data: t, error: n } = await e.from("custom_block_definitions").select("slug, name, fields");
+	if (n) throw Error(`Could not read the custom block definitions: ${typeof n == "object" && n && "message" in n ? String(n.message) : String(n)}`);
+	return (Array.isArray(t) ? t : []).filter((e) => !!e && typeof e.slug == "string");
 }
-export {
-  d as availableCortexAiBlockTypes,
-  b as cortexAiBlockTypeSchema,
-  f as customBlockSlugPatternSchema,
-  _ as fallbackBlockSchemas,
-  v as isValidBlockType,
-  A as loadCustomBlockDefinitions,
-  j as readCustomBlockFields,
-  h as sectionBlockFallbackSchema,
-  B as validateCortexBlockContent,
-  S as validateCustomBlockInstanceContent
-};
+//#endregion
+export { t as availableCortexAiBlockTypes, n as cortexAiBlockTypeSchema, a as customBlockSlugPatternSchema, l as fallbackBlockSchemas, u as isValidBlockType, g as loadCustomBlockDefinitions, p as readCustomBlockFields, c as sectionBlockFallbackSchema, f as validateCortexBlockContent, h as validateCustomBlockInstanceContent };

package/lib/cortex-widget-registry.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const n=require("@nextblock-cms/utils/custom-blocks"),a="id, slug, name, description, fields, layout_schema, is_original";class c extends Error{code;status;constructor(e,i){super(e),this.name="CortexWidgetRegistryInsertError",this.code=i?.code,this.status=i?.status??500}}function s(t){return JSON.parse(JSON.stringify(t))}function d(t){return t==="23505"?409:t==="42501"?403:500}function u(t){const e=n.customBlockDefinitionCreateSchema.parse({...t,is_original:!0});return{description:e.description,fields:s(e.fields),is_original:!0,layout_schema:s(e.layout_schema),name:e.name,slug:e.slug}}async function l(t,e){const i=u(e),{data:o,error:r}=await t.from("custom_block_definitions").insert(i).select(a).single();if(r||!o)throw new c(r?.message??"Failed to insert Cortex custom block definition.",{code:r?.code,status:d(r?.code)});return n.customBlockDefinitionRowSchema.parse(o)}exports.CORTEX_WIDGET_DEFINITION_SELECT=a;exports.CortexWidgetRegistryInsertError=c;exports.buildCortexWidgetDefinitionInsertPayload=u;exports.insertCortexWidgetDefinition=l;
+let e=require("@nextblock-cms/utils/custom-blocks");var t=`id, slug, name, description, fields, layout_schema, is_original`,n=class extends Error{code;status;constructor(e,t){super(e),this.name=`CortexWidgetRegistryInsertError`,this.code=t?.code,this.status=t?.status??500}};function r(e){return JSON.parse(JSON.stringify(e))}function i(e){return e===`23505`?409:e===`42501`?403:500}function a(t){let n=e.customBlockDefinitionCreateSchema.parse({...t,is_original:!0});return{description:n.description,fields:r(n.fields),is_original:!0,layout_schema:r(n.layout_schema),name:n.name,slug:n.slug}}async function o(r,o){let s=a(o),{data:c,error:l}=await r.from(`custom_block_definitions`).insert(s).select(t).single();if(l||!c)throw new n(l?.message??`Failed to insert Cortex custom block definition.`,{code:l?.code,status:i(l?.code)});return e.customBlockDefinitionRowSchema.parse(c)}exports.CORTEX_WIDGET_DEFINITION_SELECT=t,exports.CortexWidgetRegistryInsertError=n,exports.buildCortexWidgetDefinitionInsertPayload=a,exports.insertCortexWidgetDefinition=o;