@storyblok/schema 0.1.0-alpha.0 → 0.1.0-alpha.1

package/dist/validators/validate-schema.cjs

@@ -0,0 +1,125 @@
+const require_is_record = require('../utils/is-record.cjs');
+const require_shapes = require('./shapes.cjs');
+
+//#region src/validators/validate-schema.ts
+/**
+* Validates a schema definition without throwing. Checks structural identity
+* (duplicate block names, field names, and datasource slugs) and cross-references
+* (every `allow` entry resolves to a defined block; every field `datasource`
+* resolves to a defined datasource).
+*
+* @example
+* const result = validateSchema({ blocks: { hero }, datasources: { colors } });
+* if (!result.ok) console.error(result.issues);
+*/
+function validateSchema(schema) {
+	const issues = [];
+	const blocks = require_shapes.toValues(schema.blocks);
+	const datasources = require_shapes.toValues(schema.datasources);
+	const datasourceSlugs = /* @__PURE__ */ new Set();
+	for (const datasource of datasources) {
+		const slug = datasource?.slug;
+		if (typeof slug !== "string") continue;
+		if (datasourceSlugs.has(slug)) issues.push({
+			severity: "error",
+			code: "duplicate_datasource_slug",
+			path: ["datasources", slug],
+			entity: `datasource:${slug}`,
+			message: `Duplicate datasource slug "${slug}".`
+		});
+		datasourceSlugs.add(slug);
+	}
+	const blockNames = /* @__PURE__ */ new Set();
+	for (const block of blocks) {
+		const name = block?.name;
+		if (typeof name !== "string") continue;
+		if (blockNames.has(name)) issues.push({
+			severity: "error",
+			code: "duplicate_block_name",
+			path: ["blocks", name],
+			entity: `block:${name}`,
+			message: `Duplicate block name "${name}".`
+		});
+		blockNames.add(name);
+	}
+	for (const block of blocks) {
+		const blockName = typeof block?.name === "string" ? block.name : "";
+		const fieldNames = /* @__PURE__ */ new Set();
+		const fields = block?.fields ?? [];
+		for (let index = 0; index < fields.length; index++) {
+			const field = fields[index];
+			if (!require_is_record.isRecord(field)) {
+				issues.push({
+					severity: "error",
+					code: "invalid_field",
+					path: [
+						"blocks",
+						blockName,
+						index
+					],
+					entity: `block:${blockName}`,
+					message: `Field at index ${index} in block "${blockName}" is not an object.`
+				});
+				continue;
+			}
+			const fieldName = field.name;
+			if (typeof fieldName === "string") {
+				if (fieldNames.has(fieldName)) issues.push({
+					severity: "error",
+					code: "duplicate_field_name",
+					path: [
+						"blocks",
+						blockName,
+						fieldName
+					],
+					entity: `block:${blockName}`,
+					message: `Duplicate field name "${fieldName}" in block "${blockName}".`
+				});
+				fieldNames.add(fieldName);
+			} else issues.push({
+				severity: "error",
+				code: "missing_field_name",
+				path: [
+					"blocks",
+					blockName,
+					index
+				],
+				entity: `block:${blockName}`,
+				message: `Field at index ${index} in block "${blockName}" is missing a string "name".`
+			});
+			for (const allowed of field.allow ?? []) if (typeof allowed === "string" && !blockNames.has(allowed)) issues.push({
+				severity: "error",
+				code: "unresolved_allow",
+				path: [
+					"blocks",
+					blockName,
+					fieldName ?? "",
+					"allow"
+				],
+				entity: `block:${blockName}`,
+				message: `Field "${fieldName}" allows unknown block "${allowed}".`
+			});
+			const datasource = field.datasource;
+			if (typeof datasource === "string" && !datasourceSlugs.has(datasource)) issues.push({
+				severity: "error",
+				code: "unresolved_datasource",
+				path: [
+					"blocks",
+					blockName,
+					fieldName ?? "",
+					"datasource"
+				],
+				entity: `block:${blockName}`,
+				message: `Field "${fieldName}" references unknown datasource "${datasource}".`
+			});
+		}
+	}
+	return {
+		ok: issues.every((issue) => issue.severity !== "error"),
+		issues
+	};
+}
+
+//#endregion
+exports.validateSchema = validateSchema;
+//# sourceMappingURL=validate-schema.cjs.map

package/dist/validators/validate-schema.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-schema.cjs","names":["toValues","isRecord"],"sources":["../../src/validators/validate-schema.ts"],"sourcesContent":["import type { SchemaLike } from './shapes';\nimport type { ValidationIssue, ValidationResult } from './types';\nimport { isRecord, toValues } from './shapes';\n\n/**\n * Validates a schema definition without throwing. Checks structural identity\n * (duplicate block names, field names, and datasource slugs) and cross-references\n * (every `allow` entry resolves to a defined block; every field `datasource`\n * resolves to a defined datasource).\n *\n * @example\n * const result = validateSchema({ blocks: { hero }, datasources: { colors } });\n * if (!result.ok) console.error(result.issues);\n */\nexport function validateSchema(schema: SchemaLike): ValidationResult {\n  const issues: ValidationIssue[] = [];\n  const blocks = toValues(schema.blocks);\n  const datasources = toValues(schema.datasources);\n\n  const datasourceSlugs = new Set<string>();\n  for (const datasource of datasources) {\n    const slug = datasource?.slug;\n    if (typeof slug !== 'string') {\n      continue;\n    }\n    if (datasourceSlugs.has(slug)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_datasource_slug',\n        path: ['datasources', slug],\n        entity: `datasource:${slug}`,\n        message: `Duplicate datasource slug \"${slug}\".`,\n      });\n    }\n    datasourceSlugs.add(slug);\n  }\n\n  const blockNames = new Set<string>();\n  for (const block of blocks) {\n    const name = block?.name;\n    if (typeof name !== 'string') {\n      continue;\n    }\n    if (blockNames.has(name)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_block_name',\n        path: ['blocks', name],\n        entity: `block:${name}`,\n        message: `Duplicate block name \"${name}\".`,\n      });\n    }\n    blockNames.add(name);\n  }\n\n  // Field-level checks run after the name/slug sets are fully populated so that\n  // forward and circular references (resolved by name) validate correctly.\n  for (const block of blocks) {\n    const blockName = typeof block?.name === 'string' ? block.name : '';\n    const fieldNames = new Set<string>();\n    const fields = block?.fields ?? [];\n    for (let index = 0; index < fields.length; index++) {\n      const field = fields[index];\n      // Flag malformed fields the wire mapper would otherwise silently drop:\n      // a non-object entry, or one without a string `name` (its mapping key).\n      if (!isRecord(field)) {\n        issues.push({\n          severity: 'error',\n          code: 'invalid_field',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is not an object.`,\n        });\n        continue;\n      }\n      const fieldName = field.name;\n      if (typeof fieldName === 'string') {\n        if (fieldNames.has(fieldName)) {\n          issues.push({\n            severity: 'error',\n            code: 'duplicate_field_name',\n            path: ['blocks', blockName, fieldName],\n            entity: `block:${blockName}`,\n            message: `Duplicate field name \"${fieldName}\" in block \"${blockName}\".`,\n          });\n        }\n        fieldNames.add(fieldName);\n      }\n      else {\n        issues.push({\n          severity: 'error',\n          code: 'missing_field_name',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is missing a string \"name\".`,\n        });\n      }\n\n      for (const allowed of field.allow ?? []) {\n        if (typeof allowed === 'string' && !blockNames.has(allowed)) {\n          issues.push({\n            severity: 'error',\n            code: 'unresolved_allow',\n            path: ['blocks', blockName, fieldName ?? '', 'allow'],\n            entity: `block:${blockName}`,\n            message: `Field \"${fieldName}\" allows unknown block \"${allowed}\".`,\n          });\n        }\n      }\n\n      const datasource = field.datasource;\n      if (typeof datasource === 'string' && !datasourceSlugs.has(datasource)) {\n        issues.push({\n          severity: 'error',\n          code: 'unresolved_datasource',\n          path: ['blocks', blockName, fieldName ?? '', 'datasource'],\n          entity: `block:${blockName}`,\n          message: `Field \"${fieldName}\" references unknown datasource \"${datasource}\".`,\n        });\n      }\n    }\n  }\n\n  return { ok: issues.every(issue => issue.severity !== 'error'), issues };\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,eAAe,QAAsC;CACnE,MAAM,SAA4B,EAAE;CACpC,MAAM,SAASA,wBAAS,OAAO,OAAO;CACtC,MAAM,cAAcA,wBAAS,OAAO,YAAY;CAEhD,MAAM,kCAAkB,IAAI,KAAa;AACzC,MAAK,MAAM,cAAc,aAAa;EACpC,MAAM,OAAO,YAAY;AACzB,MAAI,OAAO,SAAS,SAClB;AAEF,MAAI,gBAAgB,IAAI,KAAK,CAC3B,QAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN,MAAM,CAAC,eAAe,KAAK;GAC3B,QAAQ,cAAc;GACtB,SAAS,8BAA8B,KAAK;GAC7C,CAAC;AAEJ,kBAAgB,IAAI,KAAK;;CAG3B,MAAM,6BAAa,IAAI,KAAa;AACpC,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,OAAO;AACpB,MAAI,OAAO,SAAS,SAClB;AAEF,MAAI,WAAW,IAAI,KAAK,CACtB,QAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN,MAAM,CAAC,UAAU,KAAK;GACtB,QAAQ,SAAS;GACjB,SAAS,yBAAyB,KAAK;GACxC,CAAC;AAEJ,aAAW,IAAI,KAAK;;AAKtB,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,YAAY,OAAO,OAAO,SAAS,WAAW,MAAM,OAAO;EACjE,MAAM,6BAAa,IAAI,KAAa;EACpC,MAAM,SAAS,OAAO,UAAU,EAAE;AAClC,OAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS;GAClD,MAAM,QAAQ,OAAO;AAGrB,OAAI,CAACC,2BAAS,MAAM,EAAE;AACpB,WAAO,KAAK;KACV,UAAU;KACV,MAAM;KACN,MAAM;MAAC;MAAU;MAAW;MAAM;KAClC,QAAQ,SAAS;KACjB,SAAS,kBAAkB,MAAM,aAAa,UAAU;KACzD,CAAC;AACF;;GAEF,MAAM,YAAY,MAAM;AACxB,OAAI,OAAO,cAAc,UAAU;AACjC,QAAI,WAAW,IAAI,UAAU,CAC3B,QAAO,KAAK;KACV,UAAU;KACV,MAAM;KACN,MAAM;MAAC;MAAU;MAAW;MAAU;KACtC,QAAQ,SAAS;KACjB,SAAS,yBAAyB,UAAU,cAAc,UAAU;KACrE,CAAC;AAEJ,eAAW,IAAI,UAAU;SAGzB,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW;KAAM;IAClC,QAAQ,SAAS;IACjB,SAAS,kBAAkB,MAAM,aAAa,UAAU;IACzD,CAAC;AAGJ,QAAK,MAAM,WAAW,MAAM,SAAS,EAAE,CACrC,KAAI,OAAO,YAAY,YAAY,CAAC,WAAW,IAAI,QAAQ,CACzD,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW,aAAa;KAAI;KAAQ;IACrD,QAAQ,SAAS;IACjB,SAAS,UAAU,UAAU,0BAA0B,QAAQ;IAChE,CAAC;GAIN,MAAM,aAAa,MAAM;AACzB,OAAI,OAAO,eAAe,YAAY,CAAC,gBAAgB,IAAI,WAAW,CACpE,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW,aAAa;KAAI;KAAa;IAC1D,QAAQ,SAAS;IACjB,SAAS,UAAU,UAAU,mCAAmC,WAAW;IAC5E,CAAC;;;AAKR,QAAO;EAAE,IAAI,OAAO,OAAM,UAAS,MAAM,aAAa,QAAQ;EAAE;EAAQ"}

package/dist/validators/validate-schema.d.cts

@@ -0,0 +1,18 @@
+import { SchemaLike } from "./shapes.cjs";
+import { ValidationResult } from "./types.cjs";
+
+//#region src/validators/validate-schema.d.ts
+/**
+ * Validates a schema definition without throwing. Checks structural identity
+ * (duplicate block names, field names, and datasource slugs) and cross-references
+ * (every `allow` entry resolves to a defined block; every field `datasource`
+ * resolves to a defined datasource).
+ *
+ * @example
+ * const result = validateSchema({ blocks: { hero }, datasources: { colors } });
+ * if (!result.ok) console.error(result.issues);
+ */
+declare function validateSchema(schema: SchemaLike): ValidationResult;
+//#endregion
+export { validateSchema };
+//# sourceMappingURL=validate-schema.d.cts.map

package/dist/validators/validate-schema.d.mts

@@ -0,0 +1,18 @@
+import { SchemaLike } from "./shapes.mjs";
+import { ValidationResult } from "./types.mjs";
+
+//#region src/validators/validate-schema.d.ts
+/**
+ * Validates a schema definition without throwing. Checks structural identity
+ * (duplicate block names, field names, and datasource slugs) and cross-references
+ * (every `allow` entry resolves to a defined block; every field `datasource`
+ * resolves to a defined datasource).
+ *
+ * @example
+ * const result = validateSchema({ blocks: { hero }, datasources: { colors } });
+ * if (!result.ok) console.error(result.issues);
+ */
+declare function validateSchema(schema: SchemaLike): ValidationResult;
+//#endregion
+export { validateSchema };
+//# sourceMappingURL=validate-schema.d.mts.map

package/dist/validators/validate-schema.mjs

@@ -0,0 +1,125 @@
+import { isRecord } from "../utils/is-record.mjs";
+import { toValues } from "./shapes.mjs";
+
+//#region src/validators/validate-schema.ts
+/**
+* Validates a schema definition without throwing. Checks structural identity
+* (duplicate block names, field names, and datasource slugs) and cross-references
+* (every `allow` entry resolves to a defined block; every field `datasource`
+* resolves to a defined datasource).
+*
+* @example
+* const result = validateSchema({ blocks: { hero }, datasources: { colors } });
+* if (!result.ok) console.error(result.issues);
+*/
+function validateSchema(schema) {
+	const issues = [];
+	const blocks = toValues(schema.blocks);
+	const datasources = toValues(schema.datasources);
+	const datasourceSlugs = /* @__PURE__ */ new Set();
+	for (const datasource of datasources) {
+		const slug = datasource?.slug;
+		if (typeof slug !== "string") continue;
+		if (datasourceSlugs.has(slug)) issues.push({
+			severity: "error",
+			code: "duplicate_datasource_slug",
+			path: ["datasources", slug],
+			entity: `datasource:${slug}`,
+			message: `Duplicate datasource slug "${slug}".`
+		});
+		datasourceSlugs.add(slug);
+	}
+	const blockNames = /* @__PURE__ */ new Set();
+	for (const block of blocks) {
+		const name = block?.name;
+		if (typeof name !== "string") continue;
+		if (blockNames.has(name)) issues.push({
+			severity: "error",
+			code: "duplicate_block_name",
+			path: ["blocks", name],
+			entity: `block:${name}`,
+			message: `Duplicate block name "${name}".`
+		});
+		blockNames.add(name);
+	}
+	for (const block of blocks) {
+		const blockName = typeof block?.name === "string" ? block.name : "";
+		const fieldNames = /* @__PURE__ */ new Set();
+		const fields = block?.fields ?? [];
+		for (let index = 0; index < fields.length; index++) {
+			const field = fields[index];
+			if (!isRecord(field)) {
+				issues.push({
+					severity: "error",
+					code: "invalid_field",
+					path: [
+						"blocks",
+						blockName,
+						index
+					],
+					entity: `block:${blockName}`,
+					message: `Field at index ${index} in block "${blockName}" is not an object.`
+				});
+				continue;
+			}
+			const fieldName = field.name;
+			if (typeof fieldName === "string") {
+				if (fieldNames.has(fieldName)) issues.push({
+					severity: "error",
+					code: "duplicate_field_name",
+					path: [
+						"blocks",
+						blockName,
+						fieldName
+					],
+					entity: `block:${blockName}`,
+					message: `Duplicate field name "${fieldName}" in block "${blockName}".`
+				});
+				fieldNames.add(fieldName);
+			} else issues.push({
+				severity: "error",
+				code: "missing_field_name",
+				path: [
+					"blocks",
+					blockName,
+					index
+				],
+				entity: `block:${blockName}`,
+				message: `Field at index ${index} in block "${blockName}" is missing a string "name".`
+			});
+			for (const allowed of field.allow ?? []) if (typeof allowed === "string" && !blockNames.has(allowed)) issues.push({
+				severity: "error",
+				code: "unresolved_allow",
+				path: [
+					"blocks",
+					blockName,
+					fieldName ?? "",
+					"allow"
+				],
+				entity: `block:${blockName}`,
+				message: `Field "${fieldName}" allows unknown block "${allowed}".`
+			});
+			const datasource = field.datasource;
+			if (typeof datasource === "string" && !datasourceSlugs.has(datasource)) issues.push({
+				severity: "error",
+				code: "unresolved_datasource",
+				path: [
+					"blocks",
+					blockName,
+					fieldName ?? "",
+					"datasource"
+				],
+				entity: `block:${blockName}`,
+				message: `Field "${fieldName}" references unknown datasource "${datasource}".`
+			});
+		}
+	}
+	return {
+		ok: issues.every((issue) => issue.severity !== "error"),
+		issues
+	};
+}
+
+//#endregion
+export { validateSchema };
+//# sourceMappingURL=validate-schema.mjs.map

package/dist/validators/validate-schema.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-schema.mjs","names":[],"sources":["../../src/validators/validate-schema.ts"],"sourcesContent":["import type { SchemaLike } from './shapes';\nimport type { ValidationIssue, ValidationResult } from './types';\nimport { isRecord, toValues } from './shapes';\n\n/**\n * Validates a schema definition without throwing. Checks structural identity\n * (duplicate block names, field names, and datasource slugs) and cross-references\n * (every `allow` entry resolves to a defined block; every field `datasource`\n * resolves to a defined datasource).\n *\n * @example\n * const result = validateSchema({ blocks: { hero }, datasources: { colors } });\n * if (!result.ok) console.error(result.issues);\n */\nexport function validateSchema(schema: SchemaLike): ValidationResult {\n  const issues: ValidationIssue[] = [];\n  const blocks = toValues(schema.blocks);\n  const datasources = toValues(schema.datasources);\n\n  const datasourceSlugs = new Set<string>();\n  for (const datasource of datasources) {\n    const slug = datasource?.slug;\n    if (typeof slug !== 'string') {\n      continue;\n    }\n    if (datasourceSlugs.has(slug)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_datasource_slug',\n        path: ['datasources', slug],\n        entity: `datasource:${slug}`,\n        message: `Duplicate datasource slug \"${slug}\".`,\n      });\n    }\n    datasourceSlugs.add(slug);\n  }\n\n  const blockNames = new Set<string>();\n  for (const block of blocks) {\n    const name = block?.name;\n    if (typeof name !== 'string') {\n      continue;\n    }\n    if (blockNames.has(name)) {\n      issues.push({\n        severity: 'error',\n        code: 'duplicate_block_name',\n        path: ['blocks', name],\n        entity: `block:${name}`,\n        message: `Duplicate block name \"${name}\".`,\n      });\n    }\n    blockNames.add(name);\n  }\n\n  // Field-level checks run after the name/slug sets are fully populated so that\n  // forward and circular references (resolved by name) validate correctly.\n  for (const block of blocks) {\n    const blockName = typeof block?.name === 'string' ? block.name : '';\n    const fieldNames = new Set<string>();\n    const fields = block?.fields ?? [];\n    for (let index = 0; index < fields.length; index++) {\n      const field = fields[index];\n      // Flag malformed fields the wire mapper would otherwise silently drop:\n      // a non-object entry, or one without a string `name` (its mapping key).\n      if (!isRecord(field)) {\n        issues.push({\n          severity: 'error',\n          code: 'invalid_field',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is not an object.`,\n        });\n        continue;\n      }\n      const fieldName = field.name;\n      if (typeof fieldName === 'string') {\n        if (fieldNames.has(fieldName)) {\n          issues.push({\n            severity: 'error',\n            code: 'duplicate_field_name',\n            path: ['blocks', blockName, fieldName],\n            entity: `block:${blockName}`,\n            message: `Duplicate field name \"${fieldName}\" in block \"${blockName}\".`,\n          });\n        }\n        fieldNames.add(fieldName);\n      }\n      else {\n        issues.push({\n          severity: 'error',\n          code: 'missing_field_name',\n          path: ['blocks', blockName, index],\n          entity: `block:${blockName}`,\n          message: `Field at index ${index} in block \"${blockName}\" is missing a string \"name\".`,\n        });\n      }\n\n      for (const allowed of field.allow ?? []) {\n        if (typeof allowed === 'string' && !blockNames.has(allowed)) {\n          issues.push({\n            severity: 'error',\n            code: 'unresolved_allow',\n            path: ['blocks', blockName, fieldName ?? '', 'allow'],\n            entity: `block:${blockName}`,\n            message: `Field \"${fieldName}\" allows unknown block \"${allowed}\".`,\n          });\n        }\n      }\n\n      const datasource = field.datasource;\n      if (typeof datasource === 'string' && !datasourceSlugs.has(datasource)) {\n        issues.push({\n          severity: 'error',\n          code: 'unresolved_datasource',\n          path: ['blocks', blockName, fieldName ?? '', 'datasource'],\n          entity: `block:${blockName}`,\n          message: `Field \"${fieldName}\" references unknown datasource \"${datasource}\".`,\n        });\n      }\n    }\n  }\n\n  return { ok: issues.every(issue => issue.severity !== 'error'), issues };\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,eAAe,QAAsC;CACnE,MAAM,SAA4B,EAAE;CACpC,MAAM,SAAS,SAAS,OAAO,OAAO;CACtC,MAAM,cAAc,SAAS,OAAO,YAAY;CAEhD,MAAM,kCAAkB,IAAI,KAAa;AACzC,MAAK,MAAM,cAAc,aAAa;EACpC,MAAM,OAAO,YAAY;AACzB,MAAI,OAAO,SAAS,SAClB;AAEF,MAAI,gBAAgB,IAAI,KAAK,CAC3B,QAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN,MAAM,CAAC,eAAe,KAAK;GAC3B,QAAQ,cAAc;GACtB,SAAS,8BAA8B,KAAK;GAC7C,CAAC;AAEJ,kBAAgB,IAAI,KAAK;;CAG3B,MAAM,6BAAa,IAAI,KAAa;AACpC,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,OAAO,OAAO;AACpB,MAAI,OAAO,SAAS,SAClB;AAEF,MAAI,WAAW,IAAI,KAAK,CACtB,QAAO,KAAK;GACV,UAAU;GACV,MAAM;GACN,MAAM,CAAC,UAAU,KAAK;GACtB,QAAQ,SAAS;GACjB,SAAS,yBAAyB,KAAK;GACxC,CAAC;AAEJ,aAAW,IAAI,KAAK;;AAKtB,MAAK,MAAM,SAAS,QAAQ;EAC1B,MAAM,YAAY,OAAO,OAAO,SAAS,WAAW,MAAM,OAAO;EACjE,MAAM,6BAAa,IAAI,KAAa;EACpC,MAAM,SAAS,OAAO,UAAU,EAAE;AAClC,OAAK,IAAI,QAAQ,GAAG,QAAQ,OAAO,QAAQ,SAAS;GAClD,MAAM,QAAQ,OAAO;AAGrB,OAAI,CAAC,SAAS,MAAM,EAAE;AACpB,WAAO,KAAK;KACV,UAAU;KACV,MAAM;KACN,MAAM;MAAC;MAAU;MAAW;MAAM;KAClC,QAAQ,SAAS;KACjB,SAAS,kBAAkB,MAAM,aAAa,UAAU;KACzD,CAAC;AACF;;GAEF,MAAM,YAAY,MAAM;AACxB,OAAI,OAAO,cAAc,UAAU;AACjC,QAAI,WAAW,IAAI,UAAU,CAC3B,QAAO,KAAK;KACV,UAAU;KACV,MAAM;KACN,MAAM;MAAC;MAAU;MAAW;MAAU;KACtC,QAAQ,SAAS;KACjB,SAAS,yBAAyB,UAAU,cAAc,UAAU;KACrE,CAAC;AAEJ,eAAW,IAAI,UAAU;SAGzB,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW;KAAM;IAClC,QAAQ,SAAS;IACjB,SAAS,kBAAkB,MAAM,aAAa,UAAU;IACzD,CAAC;AAGJ,QAAK,MAAM,WAAW,MAAM,SAAS,EAAE,CACrC,KAAI,OAAO,YAAY,YAAY,CAAC,WAAW,IAAI,QAAQ,CACzD,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW,aAAa;KAAI;KAAQ;IACrD,QAAQ,SAAS;IACjB,SAAS,UAAU,UAAU,0BAA0B,QAAQ;IAChE,CAAC;GAIN,MAAM,aAAa,MAAM;AACzB,OAAI,OAAO,eAAe,YAAY,CAAC,gBAAgB,IAAI,WAAW,CACpE,QAAO,KAAK;IACV,UAAU;IACV,MAAM;IACN,MAAM;KAAC;KAAU;KAAW,aAAa;KAAI;KAAa;IAC1D,QAAQ,SAAS;IACjB,SAAS,UAAU,UAAU,mCAAmC,WAAW;IAC5E,CAAC;;;AAKR,QAAO;EAAE,IAAI,OAAO,OAAM,UAAS,MAAM,aAAa,QAAQ;EAAE;EAAQ"}

package/dist/validators/validate-story.cjs

@@ -0,0 +1,257 @@
+const require_is_record = require('../utils/is-record.cjs');
+const require_shapes = require('./shapes.cjs');
+const require_zod_gen = require('../generated/overlay/zod.gen.cjs');
+require('./internal-schemas.cjs');
+
+//#region src/validators/validate-story.ts
+/** Field-content keys that are not user-defined fields. */
+const RESERVED_KEYS = new Set([
+	"_uid",
+	"component",
+	"_editable"
+]);
+/** Maps a Standard Schema validator to a {@link ValidationIssue} reporter at `path`. */
+function checkValue(schema, value, path, entity, issues) {
+	const result = schema["~standard"].validate(value);
+	if (result instanceof Promise) return;
+	if (result.issues) for (const issue of result.issues) {
+		const issuePath = (issue.path ?? []).map((segment) => typeof segment === "object" && segment !== null ? String(segment.key) : segment);
+		issues.push({
+			severity: "error",
+			code: "invalid_value",
+			path: [...path, ...issuePath],
+			entity,
+			message: issue.message
+		});
+	}
+}
+function validateFieldValue(field, value, blocksByName, path, entity, issues) {
+	switch (field.type) {
+		case "asset":
+			checkValue(require_zod_gen.zAssetFieldValue, value, path, entity, issues);
+			break;
+		case "multiasset":
+			if (!Array.isArray(value)) {
+				pushTypeIssue(value, "array", path, entity, issues);
+				break;
+			}
+			value.forEach((item, index) => checkValue(require_zod_gen.zAssetFieldValue, item, [...path, index], entity, issues));
+			checkCount(value.length, field.minimum_entries, field.maximum_entries, "asset(s)", path, entity, issues);
+			break;
+		case "multilink":
+			checkValue(require_zod_gen.zMultilinkFieldValue, value, path, entity, issues);
+			break;
+		case "table":
+			checkValue(require_zod_gen.zTableFieldValue, value, path, entity, issues);
+			break;
+		case "richtext":
+			checkValue(require_zod_gen.zRichtextFieldValue, value, path, entity, issues);
+			validateRichtextBloks(value, blocksByName, path, issues);
+			break;
+		case "custom":
+			checkValue(require_zod_gen.zPluginFieldValue, value, path, entity, issues);
+			break;
+		case "bloks":
+			if (!Array.isArray(value)) {
+				pushTypeIssue(value, "array", path, entity, issues);
+				break;
+			}
+			checkCount(value.length, field.minimum, field.maximum, "block(s)", path, entity, issues);
+			value.forEach((item, index) => {
+				if (field.allow && field.allow.length > 0 && require_is_record.isRecord(item) && typeof item.component === "string" && !field.allow.includes(item.component)) issues.push({
+					severity: "error",
+					code: "disallowed_component",
+					path: [
+						...path,
+						index,
+						"component"
+					],
+					entity,
+					message: `Component "${item.component}" is not allowed in field "${field.name}"; allowed: ${field.allow.join(", ")}.`
+				});
+				validateBlokContent(item, blocksByName, [...path, index], issues);
+			});
+			break;
+		case "text":
+		case "textarea":
+		case "markdown":
+			if (typeof value !== "string") {
+				pushTypeIssue(value, "string", path, entity, issues);
+				break;
+			}
+			checkStringLength(field, value, path, entity, issues);
+			break;
+		case "option":
+		case "datetime":
+			if (typeof value !== "string") pushTypeIssue(value, "string", path, entity, issues);
+			break;
+		case "number":
+			if (typeof value !== "number") {
+				pushTypeIssue(value, "number", path, entity, issues);
+				break;
+			}
+			if (field.min_value != null && value < field.min_value) pushConstraint(`Value ${value} is below the minimum of ${field.min_value}.`, path, entity, issues);
+			if (field.max_value != null && value > field.max_value) pushConstraint(`Value ${value} exceeds the maximum of ${field.max_value}.`, path, entity, issues);
+			if (field.decimals != null && decimalPlaces(value) > field.decimals) pushConstraint(`Value ${value} has more than ${field.decimals} decimal place(s).`, path, entity, issues);
+			if (field.steps != null && field.steps > 0 && !isMultipleOf(value, field.steps, field.min_value ?? 0)) {
+				const base = field.min_value ?? 0;
+				pushConstraint(`Value ${value} is not a multiple of the step ${field.steps}${base ? ` (offset from ${base})` : ""}.`, path, entity, issues);
+			}
+			break;
+		case "boolean":
+			if (typeof value !== "boolean") pushTypeIssue(value, "boolean", path, entity, issues);
+			break;
+		case "options":
+			if (!Array.isArray(value) || value.some((item) => typeof item !== "string")) {
+				pushTypeIssue(value, "string[]", path, entity, issues);
+				break;
+			}
+			checkCount(value.length, toCount(field.min_options), toCount(field.max_options), "option(s)", path, entity, issues);
+			break;
+		case "section":
+		case "tab": break;
+		default:
+			field.type;
+			break;
+	}
+}
+/** Reports a constraint (bound/length/count) violation as an error issue. */
+function pushConstraint(message, path, entity, issues) {
+	issues.push({
+		severity: "error",
+		code: "constraint_violation",
+		path,
+		entity,
+		message
+	});
+}
+/** Checks an array length against optional inclusive `min`/`max` bounds. */
+function checkCount(length, min, max, noun, path, entity, issues) {
+	if (min != null && length < min) pushConstraint(`Expected at least ${min} ${noun}, received ${length}.`, path, entity, issues);
+	if (max != null && length > max) pushConstraint(`Expected at most ${max} ${noun}, received ${length}.`, path, entity, issues);
+}
+/** Checks a string against optional `max_length`/`maxlength` and `minlength` bounds. */
+function checkStringLength(field, value, path, entity, issues) {
+	const max = field.max_length ?? field.maxlength;
+	if (max != null && value.length > max) pushConstraint(`Text length ${value.length} exceeds the maximum of ${max}.`, path, entity, issues);
+	if (field.minlength != null && value.length < field.minlength) pushConstraint(`Text length ${value.length} is below the minimum of ${field.minlength}.`, path, entity, issues);
+}
+/** Counts a number's fractional digits, handling exponential notation (e.g. `1e-7` → 7). */
+function decimalPlaces(value) {
+	if (!Number.isFinite(value)) return 0;
+	const [mantissa, exponent] = String(value).toLowerCase().split("e");
+	const fractionDigits = mantissa.includes(".") ? mantissa.split(".")[1].length : 0;
+	return exponent ? Math.max(0, fractionDigits - Number(exponent)) : fractionDigits;
+}
+/** Whether `value` lands on a `step` increment offset from `base`, with float tolerance. */
+function isMultipleOf(value, step, base) {
+	const ratio = (value - base) / step;
+	const tolerance = 1e-9 * Math.max(1, Math.abs(ratio));
+	return Math.abs(ratio - Math.round(ratio)) <= tolerance;
+}
+/** Parses a numeric constraint stored as a string (e.g. `min_options`). Empty/non-numeric → undefined. */
+function toCount(value) {
+	if (value == null || value === "") return;
+	const parsed = Number(value);
+	return Number.isFinite(parsed) ? parsed : void 0;
+}
+function pushTypeIssue(value, expected, path, entity, issues) {
+	issues.push({
+		severity: "error",
+		code: "invalid_value",
+		path,
+		entity,
+		message: `Expected ${expected}, received ${value === null ? "null" : typeof value}.`
+	});
+}
+/** Walks richtext `content` nodes and validates embedded bloks (`type: 'blok'`). */
+function validateRichtextBloks(value, blocksByName, path, issues) {
+	if (!require_is_record.isRecord(value) || !Array.isArray(value.content)) return;
+	value.content.forEach((node, index) => {
+		if (!require_is_record.isRecord(node)) return;
+		if (node.type === "blok" && require_is_record.isRecord(node.attrs) && Array.isArray(node.attrs.body)) node.attrs.body.forEach((blok, blokIndex) => validateBlokContent(blok, blocksByName, [
+			...path,
+			"content",
+			index,
+			"attrs",
+			"body",
+			blokIndex
+		], issues));
+		else if (Array.isArray(node.content)) validateRichtextBloks(node, blocksByName, [
+			...path,
+			"content",
+			index
+		], issues);
+	});
+}
+/** Validates a single blok content object against its component definition. */
+function validateBlokContent(content, blocksByName, path, issues) {
+	if (!require_is_record.isRecord(content)) {
+		issues.push({
+			severity: "error",
+			code: "invalid_content",
+			path,
+			entity: "story",
+			message: "Expected a block content object."
+		});
+		return;
+	}
+	const component = content.component;
+	const block = typeof component === "string" ? blocksByName.get(component) : void 0;
+	if (!block) {
+		issues.push({
+			severity: "error",
+			code: "unknown_component",
+			path: [...path, "component"],
+			entity: "story",
+			message: `Unknown component "${String(component)}".`
+		});
+		return;
+	}
+	const entity = `block:${block.name}`;
+	const fields = block.fields ?? [];
+	const fieldsByName = new Map(fields.map((field) => [field.name, field]));
+	for (const key of Object.keys(content)) if (!RESERVED_KEYS.has(key) && !fieldsByName.has(key)) issues.push({
+		severity: "warning",
+		code: "unknown_field",
+		path: [...path, key],
+		entity,
+		message: `Unknown field "${key}" on component "${block.name}".`
+	});
+	for (const field of fields) {
+		const value = content[field.name];
+		if (value === void 0 || value === null) {
+			if (field.required) issues.push({
+				severity: "error",
+				code: "missing_required_field",
+				path: [...path, field.name],
+				entity,
+				message: `Missing required field "${field.name}" on component "${block.name}".`
+			});
+			continue;
+		}
+		validateFieldValue(field, value, blocksByName, [...path, field.name], entity, issues);
+	}
+}
+/**
+* Validates a story's content against a schema without throwing. Reports unknown
+* components (error), unknown fields (warning), missing required fields (error),
+* and invalid field-value shapes (error), recursing into nested `bloks` and
+* richtext-embedded bloks.
+*
+* @example
+* const result = validateStory(story, { blocks: { page, hero } });
+*/
+function validateStory(story, schema) {
+	const issues = [];
+	const blocksByName = new Map(require_shapes.toValues(schema.blocks).map((block) => [block.name, block]));
+	validateBlokContent(require_is_record.isRecord(story) ? story.content : void 0, blocksByName, ["content"], issues);
+	return {
+		ok: issues.every((issue) => issue.severity !== "error"),
+		issues
+	};
+}
+
+//#endregion
+exports.validateStory = validateStory;
+//# sourceMappingURL=validate-story.cjs.map

package/dist/validators/validate-story.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-story.cjs","names":["zAssetFieldValue","zMultilinkFieldValue","zTableFieldValue","zRichtextFieldValue","zPluginFieldValue","isRecord","toValues"],"sources":["../../src/validators/validate-story.ts"],"sourcesContent":["import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { SchemaBlockLike, SchemaFieldLike, SchemaLike } from './shapes';\nimport type { ValidationIssue, ValidationResult } from './types';\nimport {\n  zAssetFieldValue,\n  zMultilinkFieldValue,\n  zPluginFieldValue,\n  zRichtextFieldValue,\n  zTableFieldValue,\n} from './internal-schemas';\nimport { isRecord, toValues } from './shapes';\n\n/** Field-content keys that are not user-defined fields. */\nconst RESERVED_KEYS = new Set(['_uid', 'component', '_editable']);\n\n/** Maps a Standard Schema validator to a {@link ValidationIssue} reporter at `path`. */\nfunction checkValue(\n  schema: StandardSchemaV1,\n  value: unknown,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  const result = schema['~standard'].validate(value);\n  // The Zod schemas are synchronous; a thenable result would indicate misuse.\n  if (result instanceof Promise) {\n    return;\n  }\n  if (result.issues) {\n    for (const issue of result.issues) {\n      const issuePath = (issue.path ?? []).map(segment =>\n        (typeof segment === 'object' && segment !== null ? String(segment.key) : (segment as string | number)),\n      );\n      issues.push({\n        severity: 'error',\n        code: 'invalid_value',\n        path: [...path, ...issuePath],\n        entity,\n        message: issue.message,\n      });\n    }\n  }\n}\n\nfunction validateFieldValue(\n  field: SchemaFieldLike,\n  value: unknown,\n  blocksByName: Map<string, SchemaBlockLike>,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  switch (field.type) {\n    case 'asset':\n      checkValue(zAssetFieldValue, value, path, entity, issues);\n      break;\n    case 'multiasset':\n      if (!Array.isArray(value)) {\n        pushTypeIssue(value, 'array', path, entity, issues);\n        break;\n      }\n      value.forEach((item, index) => checkValue(zAssetFieldValue, item, [...path, index], entity, issues));\n      checkCount(value.length, field.minimum_entries, field.maximum_entries, 'asset(s)', path, entity, issues);\n      break;\n    case 'multilink':\n      checkValue(zMultilinkFieldValue, value, path, entity, issues);\n      break;\n    case 'table':\n      checkValue(zTableFieldValue, value, path, entity, issues);\n      break;\n    case 'richtext':\n      checkValue(zRichtextFieldValue, value, path, entity, issues);\n      validateRichtextBloks(value, blocksByName, path, issues);\n      break;\n    case 'custom':\n      checkValue(zPluginFieldValue, value, path, entity, issues);\n      break;\n    case 'bloks':\n      if (!Array.isArray(value)) {\n        pushTypeIssue(value, 'array', path, entity, issues);\n        break;\n      }\n      checkCount(value.length, field.minimum, field.maximum, 'block(s)', path, entity, issues);\n      value.forEach((item, index) => {\n        if (\n          field.allow && field.allow.length > 0\n          && isRecord(item) && typeof item.component === 'string'\n          && !field.allow.includes(item.component)\n        ) {\n          issues.push({\n            severity: 'error',\n            code: 'disallowed_component',\n            path: [...path, index, 'component'],\n            entity,\n            message: `Component \"${item.component}\" is not allowed in field \"${field.name}\"; allowed: ${field.allow.join(', ')}.`,\n          });\n        }\n        validateBlokContent(item, blocksByName, [...path, index], issues);\n      });\n      break;\n    case 'text':\n    case 'textarea':\n    case 'markdown':\n      if (typeof value !== 'string') {\n        pushTypeIssue(value, 'string', path, entity, issues);\n        break;\n      }\n      checkStringLength(field, value, path, entity, issues);\n      break;\n    case 'option':\n    case 'datetime':\n      if (typeof value !== 'string') {\n        pushTypeIssue(value, 'string', path, entity, issues);\n      }\n      break;\n    case 'number':\n      if (typeof value !== 'number') {\n        pushTypeIssue(value, 'number', path, entity, issues);\n        break;\n      }\n      if (field.min_value != null && value < field.min_value) {\n        pushConstraint(`Value ${value} is below the minimum of ${field.min_value}.`, path, entity, issues);\n      }\n      if (field.max_value != null && value > field.max_value) {\n        pushConstraint(`Value ${value} exceeds the maximum of ${field.max_value}.`, path, entity, issues);\n      }\n      if (field.decimals != null && decimalPlaces(value) > field.decimals) {\n        pushConstraint(`Value ${value} has more than ${field.decimals} decimal place(s).`, path, entity, issues);\n      }\n      if (field.steps != null && field.steps > 0 && !isMultipleOf(value, field.steps, field.min_value ?? 0)) {\n        const base = field.min_value ?? 0;\n        pushConstraint(\n          `Value ${value} is not a multiple of the step ${field.steps}${base ? ` (offset from ${base})` : ''}.`,\n          path,\n          entity,\n          issues,\n        );\n      }\n      break;\n    case 'boolean':\n      if (typeof value !== 'boolean') {\n        pushTypeIssue(value, 'boolean', path, entity, issues);\n      }\n      break;\n    case 'options':\n      if (!Array.isArray(value) || value.some(item => typeof item !== 'string')) {\n        pushTypeIssue(value, 'string[]', path, entity, issues);\n        break;\n      }\n      checkCount(value.length, toCount(field.min_options), toCount(field.max_options), 'option(s)', path, entity, issues);\n      break;\n    case 'section':\n    case 'tab':\n      // Layout-only field types carry no content value.\n      break;\n    default:\n      // Exhaustiveness guard: when a new `FieldType` is added, this fails to\n      // compile until the field type is handled (or explicitly skipped) above.\n      field.type satisfies never;\n      break;\n  }\n}\n\n/** Reports a constraint (bound/length/count) violation as an error issue. */\nfunction pushConstraint(\n  message: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  issues.push({ severity: 'error', code: 'constraint_violation', path, entity, message });\n}\n\n/** Checks an array length against optional inclusive `min`/`max` bounds. */\nfunction checkCount(\n  length: number,\n  min: number | undefined,\n  max: number | undefined,\n  noun: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  if (min != null && length < min) {\n    pushConstraint(`Expected at least ${min} ${noun}, received ${length}.`, path, entity, issues);\n  }\n  if (max != null && length > max) {\n    pushConstraint(`Expected at most ${max} ${noun}, received ${length}.`, path, entity, issues);\n  }\n}\n\n/** Checks a string against optional `max_length`/`maxlength` and `minlength` bounds. */\nfunction checkStringLength(\n  field: SchemaFieldLike,\n  value: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  const max = field.max_length ?? field.maxlength;\n  if (max != null && value.length > max) {\n    pushConstraint(`Text length ${value.length} exceeds the maximum of ${max}.`, path, entity, issues);\n  }\n  if (field.minlength != null && value.length < field.minlength) {\n    pushConstraint(`Text length ${value.length} is below the minimum of ${field.minlength}.`, path, entity, issues);\n  }\n}\n\n/** Counts a number's fractional digits, handling exponential notation (e.g. `1e-7` → 7). */\nfunction decimalPlaces(value: number): number {\n  if (!Number.isFinite(value)) {\n    return 0;\n  }\n  const text = String(value).toLowerCase();\n  const [mantissa, exponent] = text.split('e');\n  const fractionDigits = mantissa.includes('.') ? mantissa.split('.')[1].length : 0;\n  // A negative exponent (e.g. `1e-7`) adds that many fractional digits.\n  return exponent ? Math.max(0, fractionDigits - Number(exponent)) : fractionDigits;\n}\n\n/** Whether `value` lands on a `step` increment offset from `base`, with float tolerance. */\nfunction isMultipleOf(value: number, step: number, base: number): boolean {\n  const ratio = (value - base) / step;\n  const tolerance = 1e-9 * Math.max(1, Math.abs(ratio));\n  return Math.abs(ratio - Math.round(ratio)) <= tolerance;\n}\n\n/** Parses a numeric constraint stored as a string (e.g. `min_options`). Empty/non-numeric → undefined. */\nfunction toCount(value: string | undefined): number | undefined {\n  if (value == null || value === '') {\n    return undefined;\n  }\n  const parsed = Number(value);\n  return Number.isFinite(parsed) ? parsed : undefined;\n}\n\nfunction pushTypeIssue(\n  value: unknown,\n  expected: string,\n  path: (string | number)[],\n  entity: string,\n  issues: ValidationIssue[],\n): void {\n  issues.push({\n    severity: 'error',\n    code: 'invalid_value',\n    path,\n    entity,\n    message: `Expected ${expected}, received ${value === null ? 'null' : typeof value}.`,\n  });\n}\n\n/** Walks richtext `content` nodes and validates embedded bloks (`type: 'blok'`). */\nfunction validateRichtextBloks(\n  value: unknown,\n  blocksByName: Map<string, SchemaBlockLike>,\n  path: (string | number)[],\n  issues: ValidationIssue[],\n): void {\n  if (!isRecord(value) || !Array.isArray(value.content)) {\n    return;\n  }\n  value.content.forEach((node, index) => {\n    if (!isRecord(node)) {\n      return;\n    }\n    if (node.type === 'blok' && isRecord(node.attrs) && Array.isArray(node.attrs.body)) {\n      node.attrs.body.forEach((blok, blokIndex) =>\n        validateBlokContent(blok, blocksByName, [...path, 'content', index, 'attrs', 'body', blokIndex], issues),\n      );\n    }\n    else if (Array.isArray(node.content)) {\n      // Recurse into nested marks/nodes that may themselves embed bloks.\n      validateRichtextBloks(node, blocksByName, [...path, 'content', index], issues);\n    }\n  });\n}\n\n/** Validates a single blok content object against its component definition. */\nfunction validateBlokContent(\n  content: unknown,\n  blocksByName: Map<string, SchemaBlockLike>,\n  path: (string | number)[],\n  issues: ValidationIssue[],\n): void {\n  if (!isRecord(content)) {\n    issues.push({\n      severity: 'error',\n      code: 'invalid_content',\n      path,\n      entity: 'story',\n      message: 'Expected a block content object.',\n    });\n    return;\n  }\n\n  const component = content.component;\n  const block = typeof component === 'string' ? blocksByName.get(component) : undefined;\n  if (!block) {\n    issues.push({\n      severity: 'error',\n      code: 'unknown_component',\n      path: [...path, 'component'],\n      entity: 'story',\n      message: `Unknown component \"${String(component)}\".`,\n    });\n    return;\n  }\n\n  const entity = `block:${block.name}`;\n  const fields = block.fields ?? [];\n  const fieldsByName = new Map(fields.map(field => [field.name, field]));\n\n  for (const key of Object.keys(content)) {\n    if (!RESERVED_KEYS.has(key) && !fieldsByName.has(key)) {\n      issues.push({\n        severity: 'warning',\n        code: 'unknown_field',\n        path: [...path, key],\n        entity,\n        message: `Unknown field \"${key}\" on component \"${block.name}\".`,\n      });\n    }\n  }\n\n  for (const field of fields) {\n    const value = content[field.name];\n    if (value === undefined || value === null) {\n      if (field.required) {\n        issues.push({\n          severity: 'error',\n          code: 'missing_required_field',\n          path: [...path, field.name],\n          entity,\n          message: `Missing required field \"${field.name}\" on component \"${block.name}\".`,\n        });\n      }\n      continue;\n    }\n    validateFieldValue(field, value, blocksByName, [...path, field.name], entity, issues);\n  }\n}\n\n/**\n * Validates a story's content against a schema without throwing. Reports unknown\n * components (error), unknown fields (warning), missing required fields (error),\n * and invalid field-value shapes (error), recursing into nested `bloks` and\n * richtext-embedded bloks.\n *\n * @example\n * const result = validateStory(story, { blocks: { page, hero } });\n */\nexport function validateStory(story: unknown, schema: SchemaLike): ValidationResult {\n  const issues: ValidationIssue[] = [];\n  const blocksByName = new Map(toValues(schema.blocks).map(block => [block.name, block]));\n  const content = isRecord(story) ? story.content : undefined;\n  validateBlokContent(content, blocksByName, ['content'], issues);\n  return { ok: issues.every(issue => issue.severity !== 'error'), issues };\n}\n"],"mappings":"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"}

package/dist/validators/validate-story.d.cts

@@ -0,0 +1,17 @@
+import { SchemaLike } from "./shapes.cjs";
+import { ValidationResult } from "./types.cjs";
+
+//#region src/validators/validate-story.d.ts
+/**
+ * Validates a story's content against a schema without throwing. Reports unknown
+ * components (error), unknown fields (warning), missing required fields (error),
+ * and invalid field-value shapes (error), recursing into nested `bloks` and
+ * richtext-embedded bloks.
+ *
+ * @example
+ * const result = validateStory(story, { blocks: { page, hero } });
+ */
+declare function validateStory(story: unknown, schema: SchemaLike): ValidationResult;
+//#endregion
+export { validateStory };
+//# sourceMappingURL=validate-story.d.cts.map

package/dist/validators/validate-story.d.mts

@@ -0,0 +1,17 @@
+import { SchemaLike } from "./shapes.mjs";
+import { ValidationResult } from "./types.mjs";
+
+//#region src/validators/validate-story.d.ts
+/**
+ * Validates a story's content against a schema without throwing. Reports unknown
+ * components (error), unknown fields (warning), missing required fields (error),
+ * and invalid field-value shapes (error), recursing into nested `bloks` and
+ * richtext-embedded bloks.
+ *
+ * @example
+ * const result = validateStory(story, { blocks: { page, hero } });
+ */
+declare function validateStory(story: unknown, schema: SchemaLike): ValidationResult;
+//#endregion
+export { validateStory };
+//# sourceMappingURL=validate-story.d.mts.map