@flexkit/schema 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Flexkit.io
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,35 @@
-# Temporary Holding Version
+# @flexkit/schema
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Types and helpers for `flexkit.config.ts`:
+
+- `defineConfig` and `defineEntity` to author a project configuration with full typing.
+- The schema types (`Entity`, `Attribute`, `ProjectConfig`, …) and their deployed counterparts (`UiEntity`, `UiAttribute`, `UiProjectSchema`).
+- `serializeConfig`, used by `flexkit deploy`, which turns the config into pure data: Zod `validation` functions are compiled to JSON Schema (draft-07), and anything that cannot be expressed that way fails with a `SchemaSerializationError` naming the entity and attribute.
+
+```ts
+import { defineConfig, defineEntity } from '@flexkit/schema';
+
+export default defineConfig({
+  projectId: 'abcdefghij',
+  title: 'Shop',
+  menuGroups: [{ name: 'catalog', title: 'Catalog' }],
+  scopes: [{ name: 'default', label: 'Default', isDefault: true }],
+  schema: [
+    defineEntity({
+      name: 'product',
+      plural: 'products',
+      menu: { group: 'catalog', icon: 'Tag' },
+      attributes: [
+        {
+          name: 'name',
+          label: 'Name',
+          dataType: 'string',
+          inputType: 'text',
+          scope: 'global',
+          validation: (z) => z.string().min(1),
+        },
+      ],
+    }),
+  ],
+});
+```

package/dist/index.cjs

@@ -0,0 +1,319 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SUPPORTED_VALIDATION_FORMATS: () => SUPPORTED_VALIDATION_FORMATS,
+  SUPPORTED_VALIDATION_KEYWORDS: () => SUPPORTED_VALIDATION_KEYWORDS,
+  SchemaSerializationError: () => SchemaSerializationError,
+  defineConfig: () => defineConfig,
+  defineEntity: () => defineEntity,
+  normalizeEntity: () => normalizeEntity,
+  serializeAttribute: () => serializeAttribute,
+  serializeConfig: () => serializeConfig,
+  serializeEntity: () => serializeEntity,
+  serializeProjectConfig: () => serializeProjectConfig,
+  serializeValidation: () => serializeValidation,
+  stripJsonSchemaMeta: () => stripJsonSchemaMeta
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/normalize-entity.ts
+function assertAssetScope(attribute, entityName) {
+  if (attribute.dataType !== "asset") {
+    return;
+  }
+  if (attribute.scope !== void 0 && attribute.scope !== "global") {
+    throw new Error(
+      `Attribute "${attribute.name}" in entity "${entityName}" uses dataType "asset" but scope "${String(attribute.scope)}". Asset attributes must use scope "global" or omit scope.`
+    );
+  }
+}
+function normalizeAttributeScope(attribute) {
+  if (attribute.dataType !== "asset") {
+    return attribute;
+  }
+  return {
+    ...attribute,
+    scope: "global"
+  };
+}
+function assertDisplayAttribute(entity) {
+  const displayAttribute = entity.display ? entity.attributes.find((attribute) => attribute.name === entity.display) : entity.attributes[0];
+  if (entity.display && !displayAttribute) {
+    throw new Error(`Entity "${entity.name}" sets display to "${entity.display}", but no attribute has that name.`);
+  }
+  if (!displayAttribute || (displayAttribute.spaces ?? []).length === 0) {
+    return;
+  }
+  throw new Error(
+    `Entity "${entity.name}" cannot use space-bound attribute "${displayAttribute.name}" as its display field.`
+  );
+}
+function normalizeEntity(entity) {
+  entity.attributes.forEach((attribute) => {
+    assertAssetScope(attribute, entity.name);
+  });
+  assertDisplayAttribute(entity);
+  return {
+    ...entity,
+    attributes: entity.attributes.map(normalizeAttributeScope)
+  };
+}
+
+// src/define.ts
+function defineConfig(config) {
+  return config;
+}
+function defineEntity(entity) {
+  return normalizeEntity(entity);
+}
+
+// src/json-schema.ts
+function stripJsonSchemaMeta(value) {
+  if (Array.isArray(value)) {
+    return value.map((entry) => stripJsonSchemaMeta(entry));
+  }
+  if (!value || typeof value !== "object") {
+    return value;
+  }
+  const result = {};
+  for (const [key, nested] of Object.entries(value)) {
+    if (key === "$schema") {
+      continue;
+    }
+    result[key] = stripJsonSchemaMeta(nested);
+  }
+  return result;
+}
+
+// src/serialize.ts
+var import_zod = require("zod");
+var SUPPORTED_VALIDATION_KEYWORDS = /* @__PURE__ */ new Set([
+  "type",
+  "minLength",
+  "maxLength",
+  "pattern",
+  "format",
+  "minimum",
+  "maximum",
+  "exclusiveMinimum",
+  "exclusiveMaximum",
+  "multipleOf",
+  "enum",
+  "const",
+  "properties",
+  "required",
+  "additionalProperties",
+  "items",
+  "minItems",
+  "maxItems",
+  "anyOf",
+  "oneOf",
+  "not",
+  "description",
+  "title"
+]);
+var SUPPORTED_VALIDATION_FORMATS = /* @__PURE__ */ new Set([
+  "email",
+  "uri",
+  "uuid",
+  "date-time",
+  "date",
+  "time"
+]);
+var SchemaSerializationError = class extends Error {
+  entity;
+  attribute;
+  constructor(reason, location = {}, options) {
+    const where = location.entity ? location.attribute ? `Attribute "${location.attribute}" of entity "${location.entity}": ` : `Entity "${location.entity}": ` : "";
+    super(`${where}${reason}`, options);
+    this.name = "SchemaSerializationError";
+    this.entity = location.entity;
+    this.attribute = location.attribute;
+  }
+};
+function getDef(schema) {
+  return schema._zod.def;
+}
+function findCustomCheck(schema, seen = /* @__PURE__ */ new Set()) {
+  if (seen.has(schema)) {
+    return false;
+  }
+  seen.add(schema);
+  const def = getDef(schema);
+  if (def.checks?.some((check) => check._zod.def.check === "custom")) {
+    return true;
+  }
+  const children = [
+    def.innerType,
+    def.in,
+    def.out,
+    def.element,
+    def.left,
+    def.right,
+    def.keyType,
+    def.valueType,
+    ...def.options ?? [],
+    ...Object.values(def.shape ?? {}),
+    ...def.type === "lazy" && def.getter ? [def.getter()] : []
+  ];
+  return children.some((child) => child !== void 0 && findCustomCheck(child, seen));
+}
+function assertSupportedJsonSchema(fragment, location, path = []) {
+  if (Array.isArray(fragment)) {
+    fragment.forEach((entry, index) => {
+      assertSupportedJsonSchema(entry, location, [...path, String(index)]);
+    });
+    return;
+  }
+  if (!fragment || typeof fragment !== "object") {
+    return;
+  }
+  for (const [key, value] of Object.entries(fragment)) {
+    const insideMap = path.length > 0 && path[path.length - 1] === "properties";
+    if (!insideMap && !SUPPORTED_VALIDATION_KEYWORDS.has(key)) {
+      throw new SchemaSerializationError(
+        `validation uses the JSON Schema keyword "${[...path, key].join(".")}", which the Studio form cannot enforce. Supported keywords: ${[...SUPPORTED_VALIDATION_KEYWORDS].join(", ")}.`,
+        location
+      );
+    }
+    if (!insideMap && key === "format" && typeof value === "string" && !SUPPORTED_VALIDATION_FORMATS.has(value)) {
+      throw new SchemaSerializationError(
+        `validation uses the format "${value}", which the Studio form cannot enforce. Supported formats: ${[...SUPPORTED_VALIDATION_FORMATS].join(", ")}.`,
+        location
+      );
+    }
+    if (key === "properties" || key === "items" || key === "anyOf" || key === "oneOf" || key === "not") {
+      assertSupportedJsonSchema(value, location, [...path, key]);
+    } else if (insideMap) {
+      assertSupportedJsonSchema(value, location, [...path, key]);
+    }
+  }
+}
+function serializeValidation(validation, location = {}) {
+  let schema;
+  try {
+    schema = validation(import_zod.z);
+  } catch (error) {
+    throw new SchemaSerializationError("validation() threw while building the Zod schema.", location, { cause: error });
+  }
+  if (findCustomCheck(schema)) {
+    throw new SchemaSerializationError(
+      "validation uses refine(), superRefine() or check(), which cannot be expressed as JSON Schema. Use built-in Zod checks such as min(), max(), length(), regex() or email().",
+      location
+    );
+  }
+  let fragment;
+  try {
+    fragment = import_zod.z.toJSONSchema(schema, { target: "draft-07", unrepresentable: "throw" });
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    throw new SchemaSerializationError(`validation cannot be expressed as JSON Schema: ${reason}`, location, {
+      cause: error
+    });
+  }
+  const stripped = stripJsonSchemaMeta(fragment);
+  assertSupportedJsonSchema(stripped, location);
+  return stripped;
+}
+function assertBooleanFlag(value, name, location) {
+  if (value !== void 0 && typeof value !== "boolean") {
+    throw new SchemaSerializationError(
+      `"${name}" must be a boolean. Conditional callbacks are no longer supported; move the rule into the schema or drop it.`,
+      location
+    );
+  }
+}
+function assertIconName(value, where, location) {
+  if (value !== void 0 && typeof value !== "string") {
+    throw new SchemaSerializationError(
+      `${where} must be a lucide icon name such as 'Tag'. React elements are no longer supported in flexkit.config.ts.`,
+      location
+    );
+  }
+}
+function serializeAttribute(attribute, entityName) {
+  const location = { entity: entityName, attribute: attribute.name };
+  assertBooleanFlag(attribute.hidden, "hidden", location);
+  assertBooleanFlag(attribute.readOnly, "readOnly", location);
+  const { validation, ...rest } = attribute;
+  if (validation === void 0) {
+    return rest;
+  }
+  if (typeof validation !== "function") {
+    throw new SchemaSerializationError("validation must be a function receiving the Zod namespace.", location);
+  }
+  return { ...rest, validation: serializeValidation(validation, location) };
+}
+function serializeEntity(entity) {
+  const location = { entity: entity.name };
+  assertIconName(entity.menu?.icon, "menu.icon", location);
+  entity.groups?.forEach((group) => {
+    assertIconName(group.icon, `groups["${group.name}"].icon`, location);
+    assertBooleanFlag(group.hidden, `groups["${group.name}"].hidden`, location);
+  });
+  const serialized = {
+    name: entity.name,
+    plural: entity.plural,
+    attributes: entity.attributes.map((attribute) => serializeAttribute(attribute, entity.name))
+  };
+  if (entity.display !== void 0) serialized.display = entity.display;
+  if (entity.menu !== void 0) serialized.menu = entity.menu;
+  if (entity.spaces !== void 0) serialized.spaces = entity.spaces;
+  if (entity.groups !== void 0) serialized.groups = entity.groups;
+  return serialized;
+}
+function serializeProjectConfig(project) {
+  if (!project || typeof project !== "object" || typeof project.projectId !== "string") {
+    throw new SchemaSerializationError('each project needs a string "projectId".');
+  }
+  if (!Array.isArray(project.schema)) {
+    throw new SchemaSerializationError('"schema" must be an array of entities.', {});
+  }
+  const serialized = {
+    projectId: project.projectId,
+    schema: project.schema.map(serializeEntity)
+  };
+  if (project.title !== void 0) serialized.title = project.title;
+  if (project.menuGroups !== void 0) serialized.menuGroups = project.menuGroups;
+  if (project.scopes !== void 0) serialized.scopes = project.scopes;
+  if (project.spaces !== void 0) serialized.spaces = project.spaces;
+  return serialized;
+}
+function serializeConfig(config) {
+  return (Array.isArray(config) ? config : [config]).map(serializeProjectConfig);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SUPPORTED_VALIDATION_FORMATS,
+  SUPPORTED_VALIDATION_KEYWORDS,
+  SchemaSerializationError,
+  defineConfig,
+  defineEntity,
+  normalizeEntity,
+  serializeAttribute,
+  serializeConfig,
+  serializeEntity,
+  serializeProjectConfig,
+  serializeValidation,
+  stripJsonSchemaMeta
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/normalize-entity.ts","../src/define.ts","../src/json-schema.ts","../src/serialize.ts"],"sourcesContent":["export { defineConfig, defineEntity } from './define';\nexport { normalizeEntity } from './normalize-entity';\nexport { stripJsonSchemaMeta } from './json-schema';\nexport {\n  SUPPORTED_VALIDATION_FORMATS,\n  SUPPORTED_VALIDATION_KEYWORDS,\n  SchemaSerializationError,\n  serializeAttribute,\n  serializeConfig,\n  serializeEntity,\n  serializeProjectConfig,\n  serializeValidation,\n} from './serialize';\nexport type {\n  AssetOptions,\n  Attribute,\n  AttributeOf,\n  AttributeOptions,\n  CommonOptions,\n  Config,\n  DataType,\n  DateTimeOptions,\n  DefaultValue,\n  DefaultValueByDataType,\n  Entity,\n  EntityMenu,\n  EntityOf,\n  FieldGroup,\n  GroupedSelectList,\n  InputType,\n  JsonSchemaObject,\n  MenuGroup,\n  NumberOptions,\n  PreviewType,\n  ProjectConfig,\n  ProjectSchemaResponse,\n  RelationshipOptions,\n  Schema,\n  Scope,\n  ScopeType,\n  Scopes,\n  SelectList,\n  SelectOptions,\n  Space,\n  Spaces,\n  UiAttribute,\n  UiEntity,\n  UiProjectSchema,\n  UiSchema,\n  ZodValidation,\n} from './types';\n","import type { Attribute, Entity } from './types';\n\nfunction assertAssetScope(attribute: Attribute, entityName: string): void {\n  if (attribute.dataType !== 'asset') {\n    return;\n  }\n\n  if (attribute.scope !== undefined && attribute.scope !== 'global') {\n    throw new Error(\n      `Attribute \"${attribute.name}\" in entity \"${entityName}\" uses dataType \"asset\" but scope \"${String(attribute.scope)}\". Asset attributes must use scope \"global\" or omit scope.`\n    );\n  }\n}\n\nfunction normalizeAttributeScope(attribute: Attribute): Attribute {\n  if (attribute.dataType !== 'asset') {\n    return attribute;\n  }\n\n  return {\n    ...attribute,\n    scope: 'global',\n  };\n}\n\nfunction assertDisplayAttribute(entity: Entity): void {\n  const displayAttribute = entity.display\n    ? entity.attributes.find((attribute) => attribute.name === entity.display)\n    : entity.attributes[0];\n\n  if (entity.display && !displayAttribute) {\n    throw new Error(`Entity \"${entity.name}\" sets display to \"${entity.display}\", but no attribute has that name.`);\n  }\n\n  if (!displayAttribute || (displayAttribute.spaces ?? []).length === 0) {\n    return;\n  }\n\n  throw new Error(\n    `Entity \"${entity.name}\" cannot use space-bound attribute \"${displayAttribute.name}\" as its display field.`\n  );\n}\n\nexport function normalizeEntity(entity: Entity): Entity {\n  entity.attributes.forEach((attribute) => {\n    assertAssetScope(attribute, entity.name);\n  });\n\n  assertDisplayAttribute(entity);\n\n  return {\n    ...entity,\n    attributes: entity.attributes.map(normalizeAttributeScope),\n  };\n}\n","import { normalizeEntity } from './normalize-entity';\nimport type { Config, Entity } from './types';\n\n/** Types and returns a `flexkit.config.ts` export unchanged. */\nexport function defineConfig<T extends Config>(config: T): T {\n  return config;\n}\n\n/**\n * Types an entity and normalizes it: asset attributes get `scope: 'global'`,\n * and invalid asset scopes or display attributes throw at config load time.\n */\nexport function defineEntity<T extends Entity>(entity: T): Entity {\n  return normalizeEntity(entity);\n}\n","/** Removes `$schema` at every level of a JSON Schema document. */\nexport function stripJsonSchemaMeta(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map((entry) => stripJsonSchemaMeta(entry));\n  }\n\n  if (!value || typeof value !== 'object') {\n    return value;\n  }\n\n  const result: { [key: string]: unknown } = {};\n\n  for (const [key, nested] of Object.entries(value as { [key: string]: unknown })) {\n    if (key === '$schema') {\n      continue;\n    }\n\n    result[key] = stripJsonSchemaMeta(nested);\n  }\n\n  return result;\n}\n","import { z } from 'zod';\nimport { stripJsonSchemaMeta } from './json-schema';\nimport type {\n  Attribute,\n  Config,\n  Entity,\n  JsonSchemaObject,\n  ProjectConfig,\n  UiAttribute,\n  UiEntity,\n  UiProjectSchema,\n  ZodValidation,\n} from './types';\n\n/**\n * JSON Schema keywords the Studio form knows how to validate. Anything else\n * fails the deploy so a rule never silently disappears between the config and\n * the form.\n */\nexport const SUPPORTED_VALIDATION_KEYWORDS: ReadonlySet<string> = new Set([\n  'type',\n  'minLength',\n  'maxLength',\n  'pattern',\n  'format',\n  'minimum',\n  'maximum',\n  'exclusiveMinimum',\n  'exclusiveMaximum',\n  'multipleOf',\n  'enum',\n  'const',\n  'properties',\n  'required',\n  'additionalProperties',\n  'items',\n  'minItems',\n  'maxItems',\n  'anyOf',\n  'oneOf',\n  'not',\n  'description',\n  'title',\n]);\n\nexport const SUPPORTED_VALIDATION_FORMATS: ReadonlySet<string> = new Set([\n  'email',\n  'uri',\n  'uuid',\n  'date-time',\n  'date',\n  'time',\n]);\n\ntype SerializationLocation = { entity?: string; attribute?: string };\n\n/** Raised when a config cannot be turned into a deployable JSON schema. */\nexport class SchemaSerializationError extends Error {\n  readonly entity: string | undefined;\n  readonly attribute: string | undefined;\n\n  constructor(reason: string, location: SerializationLocation = {}, options?: { cause?: unknown }) {\n    const where = location.entity\n      ? location.attribute\n        ? `Attribute \"${location.attribute}\" of entity \"${location.entity}\": `\n        : `Entity \"${location.entity}\": `\n      : '';\n\n    super(`${where}${reason}`, options);\n    this.name = 'SchemaSerializationError';\n    this.entity = location.entity;\n    this.attribute = location.attribute;\n  }\n}\n\ntype ZodDef = {\n  type?: string;\n  checks?: { _zod: { def: { check?: string } } }[];\n  innerType?: z.ZodType;\n  in?: z.ZodType;\n  out?: z.ZodType;\n  element?: z.ZodType;\n  options?: z.ZodType[];\n  left?: z.ZodType;\n  right?: z.ZodType;\n  keyType?: z.ZodType;\n  valueType?: z.ZodType;\n  shape?: { [key: string]: z.ZodType };\n  getter?: () => z.ZodType;\n};\n\nfunction getDef(schema: z.ZodType): ZodDef {\n  return (schema as unknown as { _zod: { def: ZodDef } })._zod.def;\n}\n\n/**\n * `z.toJSONSchema` drops `.refine()` / `.superRefine()` / `.check()` without\n * complaint. Walk the schema and reject them explicitly: a rule that only ran\n * in the config author's head is worse than a deploy error.\n */\nfunction findCustomCheck(schema: z.ZodType, seen = new Set<z.ZodType>()): boolean {\n  if (seen.has(schema)) {\n    return false;\n  }\n\n  seen.add(schema);\n  const def = getDef(schema);\n\n  if (def.checks?.some((check) => check._zod.def.check === 'custom')) {\n    return true;\n  }\n\n  const children: (z.ZodType | undefined)[] = [\n    def.innerType,\n    def.in,\n    def.out,\n    def.element,\n    def.left,\n    def.right,\n    def.keyType,\n    def.valueType,\n    ...(def.options ?? []),\n    ...Object.values(def.shape ?? {}),\n    ...(def.type === 'lazy' && def.getter ? [def.getter()] : []),\n  ];\n\n  return children.some((child) => child !== undefined && findCustomCheck(child, seen));\n}\n\nfunction assertSupportedJsonSchema(fragment: unknown, location: SerializationLocation, path: string[] = []): void {\n  if (Array.isArray(fragment)) {\n    fragment.forEach((entry, index) => {\n      assertSupportedJsonSchema(entry, location, [...path, String(index)]);\n    });\n\n    return;\n  }\n\n  if (!fragment || typeof fragment !== 'object') {\n    return;\n  }\n\n  for (const [key, value] of Object.entries(fragment as { [key: string]: unknown })) {\n    const insideMap = path.length > 0 && path[path.length - 1] === 'properties';\n\n    if (!insideMap && !SUPPORTED_VALIDATION_KEYWORDS.has(key)) {\n      throw new SchemaSerializationError(\n        `validation uses the JSON Schema keyword \"${[...path, key].join('.')}\", which the Studio form cannot enforce. Supported keywords: ${[...SUPPORTED_VALIDATION_KEYWORDS].join(', ')}.`,\n        location\n      );\n    }\n\n    if (!insideMap && key === 'format' && typeof value === 'string' && !SUPPORTED_VALIDATION_FORMATS.has(value)) {\n      throw new SchemaSerializationError(\n        `validation uses the format \"${value}\", which the Studio form cannot enforce. Supported formats: ${[...SUPPORTED_VALIDATION_FORMATS].join(', ')}.`,\n        location\n      );\n    }\n\n    if (key === 'properties' || key === 'items' || key === 'anyOf' || key === 'oneOf' || key === 'not') {\n      assertSupportedJsonSchema(value, location, [...path, key]);\n    } else if (insideMap) {\n      assertSupportedJsonSchema(value, location, [...path, key]);\n    }\n  }\n}\n\n/**\n * Compiles an attribute's Zod validation to a JSON Schema (draft-07) fragment.\n * Throws `SchemaSerializationError` for anything the Studio cannot enforce.\n */\nexport function serializeValidation(validation: ZodValidation, location: SerializationLocation = {}): JsonSchemaObject {\n  let schema: z.ZodType;\n\n  try {\n    schema = validation(z);\n  } catch (error) {\n    throw new SchemaSerializationError('validation() threw while building the Zod schema.', location, { cause: error });\n  }\n\n  if (findCustomCheck(schema)) {\n    throw new SchemaSerializationError(\n      'validation uses refine(), superRefine() or check(), which cannot be expressed as JSON Schema. Use built-in Zod checks such as min(), max(), length(), regex() or email().',\n      location\n    );\n  }\n\n  let fragment: unknown;\n\n  try {\n    fragment = z.toJSONSchema(schema, { target: 'draft-07', unrepresentable: 'throw' });\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error);\n\n    throw new SchemaSerializationError(`validation cannot be expressed as JSON Schema: ${reason}`, location, {\n      cause: error,\n    });\n  }\n\n  const stripped = stripJsonSchemaMeta(fragment) as JsonSchemaObject;\n  assertSupportedJsonSchema(stripped, location);\n\n  return stripped;\n}\n\nfunction assertBooleanFlag(value: unknown, name: string, location: SerializationLocation): void {\n  if (value !== undefined && typeof value !== 'boolean') {\n    throw new SchemaSerializationError(\n      `\"${name}\" must be a boolean. Conditional callbacks are no longer supported; move the rule into the schema or drop it.`,\n      location\n    );\n  }\n}\n\nfunction assertIconName(value: unknown, where: string, location: SerializationLocation): void {\n  if (value !== undefined && typeof value !== 'string') {\n    throw new SchemaSerializationError(\n      `${where} must be a lucide icon name such as 'Tag'. React elements are no longer supported in flexkit.config.ts.`,\n      location\n    );\n  }\n}\n\nexport function serializeAttribute(attribute: Attribute, entityName: string): UiAttribute {\n  const location = { entity: entityName, attribute: attribute.name };\n\n  assertBooleanFlag(attribute.hidden, 'hidden', location);\n  assertBooleanFlag(attribute.readOnly, 'readOnly', location);\n\n  const { validation, ...rest } = attribute;\n\n  if (validation === undefined) {\n    return rest as UiAttribute;\n  }\n\n  if (typeof validation !== 'function') {\n    throw new SchemaSerializationError('validation must be a function receiving the Zod namespace.', location);\n  }\n\n  return { ...rest, validation: serializeValidation(validation, location) } as UiAttribute;\n}\n\nexport function serializeEntity(entity: Entity): UiEntity {\n  const location = { entity: entity.name };\n\n  assertIconName(entity.menu?.icon, 'menu.icon', location);\n  entity.groups?.forEach((group) => {\n    assertIconName(group.icon, `groups[\"${group.name}\"].icon`, location);\n    assertBooleanFlag(group.hidden, `groups[\"${group.name}\"].hidden`, location);\n  });\n\n  const serialized: UiEntity = {\n    name: entity.name,\n    plural: entity.plural,\n    attributes: entity.attributes.map((attribute) => serializeAttribute(attribute, entity.name)),\n  };\n\n  if (entity.display !== undefined) serialized.display = entity.display;\n  if (entity.menu !== undefined) serialized.menu = entity.menu;\n  if (entity.spaces !== undefined) serialized.spaces = entity.spaces;\n  if (entity.groups !== undefined) serialized.groups = entity.groups;\n\n  return serialized;\n}\n\n/**\n * Turns one project of a `flexkit.config.ts` into the payload `flexkit deploy`\n * sends. Only data survives: title, projectId, menuGroups, scopes, spaces and\n * the schema with validation compiled to JSON Schema.\n */\nexport function serializeProjectConfig(project: ProjectConfig): UiProjectSchema {\n  if (!project || typeof project !== 'object' || typeof project.projectId !== 'string') {\n    throw new SchemaSerializationError('each project needs a string \"projectId\".');\n  }\n\n  if (!Array.isArray(project.schema)) {\n    throw new SchemaSerializationError('\"schema\" must be an array of entities.', {});\n  }\n\n  const serialized: UiProjectSchema = {\n    projectId: project.projectId,\n    schema: project.schema.map(serializeEntity),\n  };\n\n  if (project.title !== undefined) serialized.title = project.title;\n  if (project.menuGroups !== undefined) serialized.menuGroups = project.menuGroups;\n  if (project.scopes !== undefined) serialized.scopes = project.scopes;\n  if (project.spaces !== undefined) serialized.spaces = project.spaces;\n\n  return serialized;\n}\n\n/** Serializes a whole `flexkit.config.ts` export (one project or a list). */\nexport function serializeConfig(config: Config): UiProjectSchema[] {\n  return (Array.isArray(config) ? config : [config]).map(serializeProjectConfig);\n}\n"],"mappings":"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","names":[]}