@acorex-platform/framework-server 0.0.10

package/domain/providers/src/lib/validators/domain-entity.validator.js

@@ -0,0 +1,281 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DomainEntityValidator = exports.DomainEntityValidationError = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+class DomainEntityValidationError extends Error {
+    constructor(message, errors = [], code = 'VALIDATION_ERROR', status = 400) {
+        super(message);
+        this.errors = errors;
+        this.code = code;
+        this.status = status;
+        this.name = 'DomainEntityValidationError';
+    }
+}
+exports.DomainEntityValidationError = DomainEntityValidationError;
+let DomainEntityValidator = class DomainEntityValidator {
+    constructor(loader) {
+        this.loader = loader;
+        this.validationCatalog = null;
+    }
+    /** Validates seed/create payloads against domain entity definitions. */
+    async validateForCreate(entityName, data, backend) {
+        await this.validateMutation({
+            op: 'create',
+            entityName,
+            data,
+            backend,
+            skipWhenDefinitionMissing: false,
+        });
+    }
+    /** Validates REST create/update payloads against domain entity definitions. */
+    async validateMutation(options) {
+        if (!this.loader) {
+            if (options.skipWhenDefinitionMissing) {
+                return;
+            }
+            throw new DomainEntityValidationError('Domain definition loader is not configured.', [], 'LOADER_NOT_CONFIGURED', 500);
+        }
+        const parts = options.entityName.split('.');
+        const moduleName = parts[0] ?? '';
+        const entityPath = parts.slice(1).join('.') || (parts[0] ?? '');
+        const entityDefinition = await this.resolveEntityDefinition(moduleName, entityPath);
+        if (!entityDefinition?.fields?.length) {
+            if (options.skipWhenDefinitionMissing) {
+                return;
+            }
+            throw new DomainEntityValidationError(`Entity "${options.entityName}" not found in domain definitions. Seed definitions manually before seeding data.`, [], 'ENTITY_NOT_FOUND', 404);
+        }
+        const catalog = await this.loadValidationCatalog();
+        const fields = entityDefinition.fields;
+        const errors = [];
+        if (options.op === 'update' && options.id) {
+            const previous = await options.backend.getOne(options.entityName, options.id).catch(() => null);
+            const merged = {
+                ...(previous ?? {}),
+                ...options.data,
+            };
+            errors.push(...validateEntityData(merged, fields, catalog));
+        }
+        else {
+            errors.push(...validateEntityData(options.data, fields, catalog));
+        }
+        if (errors.length) {
+            throw new DomainEntityValidationError(`Entity "${options.entityName}" validation failed: ${errors.join(' | ')}`, errors);
+        }
+        const existing = options.op === 'update' && options.id
+            ? await options.backend.getOne(options.entityName, options.id).catch(() => null)
+            : null;
+        const dataForUnique = existing != null
+            ? { ...existing, ...options.data }
+            : options.data;
+        for (const field of fields) {
+            const hasUnique = field.validations?.some((rule) => rule.rule === 'unique' && shouldRunOnServer(rule, catalog));
+            if (!hasUnique) {
+                continue;
+            }
+            const uniqueError = await validateUniqueField(options.entityName, field.name, field.title ?? field.name, dataForUnique, options.backend, options.op === 'update' ? options.id : undefined);
+            if (uniqueError) {
+                throw uniqueError;
+            }
+        }
+    }
+    async resolveEntityDefinition(moduleName, entityName) {
+        if (!this.loader) {
+            return null;
+        }
+        const storageLoader = this.loader;
+        if (storageLoader.resolveEntityForStorage) {
+            const definition = await storageLoader.resolveEntityForStorage(moduleName, entityName);
+            if (definition) {
+                return definition;
+            }
+        }
+        const path = entityName.includes('.') ? entityName : `${moduleName}.${entityName}`;
+        const definition = await this.loader.loadEntity(path);
+        if (definition?.fields?.length) {
+            return definition;
+        }
+        return null;
+    }
+    async loadValidationCatalog() {
+        if (this.validationCatalog) {
+            return this.validationCatalog;
+        }
+        const catalog = new Map();
+        if (!this.loader) {
+            this.validationCatalog = catalog;
+            return catalog;
+        }
+        const rules = await this.loader.loadValidationRules();
+        for (const rule of rules) {
+            if (typeof rule.rule === 'string') {
+                catalog.set(rule.rule, rule);
+            }
+        }
+        this.validationCatalog = catalog;
+        return catalog;
+    }
+};
+exports.DomainEntityValidator = DomainEntityValidator;
+exports.DomainEntityValidator = DomainEntityValidator = tslib_1.__decorate([
+    (0, common_1.Injectable)(),
+    tslib_1.__param(0, (0, common_1.Optional)()),
+    tslib_1.__metadata("design:paramtypes", [Object])
+], DomainEntityValidator);
+//#endregion
+//#region ---- Validation helpers ----
+function shouldRunOnServer(rule, catalog) {
+    const meta = catalog.get(rule.rule);
+    if (!meta?.runAt) {
+        return true;
+    }
+    return meta.runAt === 'server' || meta.runAt === 'both';
+}
+function getDisplayLabel(field) {
+    const title = field.title ?? field.name;
+    if (typeof title === 'string' &&
+        (title.startsWith('@') || title.includes('t("') || title.includes("t('"))) {
+        return field.name;
+    }
+    return title;
+}
+function getEntityShortLabel(entityName) {
+    const parts = entityName.split('.');
+    return parts[parts.length - 1] || entityName;
+}
+function normalizeFieldLabel(rawTitle, fieldName) {
+    let base;
+    if (typeof rawTitle === 'string') {
+        if (rawTitle.startsWith('@') || rawTitle.includes('t("') || rawTitle.includes("t('")) {
+            base = fieldName;
+        }
+        else {
+            base = rawTitle;
+        }
+    }
+    else {
+        base = fieldName;
+    }
+    const last = base.split('.').pop() ?? base;
+    const clean = last.replace(/[_-]+/g, ' ').trim();
+    if (!clean) {
+        return fieldName;
+    }
+    return clean.charAt(0).toUpperCase() + clean.slice(1);
+}
+function validateEntityData(data, fields, catalog) {
+    const errors = [];
+    if (!data || typeof data !== 'object') {
+        return ['Invalid data'];
+    }
+    for (const field of fields) {
+        const value = getNestedValue(data, field.name);
+        const hasValue = value !== undefined && value !== null;
+        const strVal = typeof value === 'string' ? value.trim() : String(value ?? '');
+        const label = getDisplayLabel(field);
+        for (const validation of field.validations ?? []) {
+            if (!shouldRunOnServer(validation, catalog)) {
+                continue;
+            }
+            if (validation.rule === 'required') {
+                if (!hasValue || (typeof value === 'string' && strVal === '')) {
+                    errors.push(`${label} is required`);
+                    break;
+                }
+            }
+            else if (validation.rule === 'at-least-one-of') {
+                const paths = validation.options?.paths ?? [];
+                const customMessage = validation.options?.message;
+                const anySet = paths.some((path) => hasMeaningfulValueAtPath(data, path));
+                if (!anySet) {
+                    errors.push(customMessage ?? `${label}: at least one of ${paths.join(', ')} must be set`);
+                }
+                break;
+            }
+            else if (validation.rule === 'minLength' && hasValue) {
+                const min = validation.options?.value ??
+                    validation.options?.minLength;
+                if (min != null && strVal.length < min) {
+                    errors.push(`${label} must be at least ${min} characters`);
+                    break;
+                }
+            }
+            else if (validation.rule === 'maxLength' && hasValue) {
+                const max = validation.options?.value ??
+                    validation.options?.maxLength;
+                if (max != null && strVal.length > max) {
+                    errors.push(`${label} must be at most ${max} characters`);
+                    break;
+                }
+            }
+            else if (validation.rule === 'email' && hasValue) {
+                if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(strVal)) {
+                    errors.push(`${label} must be a valid email`);
+                    break;
+                }
+            }
+        }
+    }
+    return errors;
+}
+async function validateUniqueField(entityName, fieldName, fieldTitle, data, backend, excludeId) {
+    const value = getNestedValue(data, fieldName);
+    if (value === undefined) {
+        return null;
+    }
+    const filters = [
+        { field: fieldName, operator: { type: 'equal' }, value },
+    ];
+    if (excludeId) {
+        filters.push({ field: 'id', operator: { type: 'notEqual' }, value: excludeId });
+    }
+    const result = await backend.query(entityName, {
+        filter: { field: null, logic: 'and', operator: null, filters },
+        skip: 0,
+        take: 1,
+    });
+    if (result.items?.length) {
+        const entityLabel = getEntityShortLabel(entityName);
+        const fieldLabel = normalizeFieldLabel(fieldTitle, fieldName);
+        return new DomainEntityValidationError(`The value for field "${fieldLabel}" of "${entityLabel}" already exists and must be unique.`, [], 'UNIQUE_FIELD_VIOLATION', 409);
+    }
+    return null;
+}
+function getNestedValue(obj, path) {
+    let current = obj;
+    for (const part of path.split('.')) {
+        if (current == null || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+function hasMeaningfulValueAtPath(data, path) {
+    const value = getNestedValue(data, path);
+    if (value === undefined || value === null) {
+        return false;
+    }
+    if (typeof value === 'string') {
+        return value.trim() !== '';
+    }
+    if (typeof value === 'number') {
+        return !Number.isNaN(value);
+    }
+    if (typeof value === 'object' && value !== null && 'id' in value) {
+        const id = value.id;
+        if (id === undefined || id === null) {
+            return false;
+        }
+        if (typeof id === 'string') {
+            return id.trim() !== '';
+        }
+        if (typeof id === 'number') {
+            return !Number.isNaN(id);
+        }
+    }
+    return false;
+}
+//#endregion
+//# sourceMappingURL=domain-entity.validator.js.map

package/domain/providers/src/lib/validators/domain-entity.validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain-entity.validator.js","sourceRoot":"","sources":["../../../../../../../../../libs/framework/server/domain/providers/src/lib/validators/domain-entity.validator.ts"],"names":[],"mappings":"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"}

package/domain/seed/package.json

@@ -0,0 +1,17 @@
+{
+  "name": "@acorex-platform/framework-server/domain/seed",
+  "version": "0.0.0-ACOREX",
+  "private": true,
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "types": "./src/index.d.ts",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@acorex-platform/framework-server/domain/abstract": "0.0.0-ACOREX",
+    "@acorex-platform/framework-server/domain/providers": "0.0.0-ACOREX",
+    "@acorex-platform/framework-server/jql/seed": "0.0.0-ACOREX",
+    "@acorex-platform/framework-shared/core": "0.0.1"
+  }
+}

package/domain/seed/src/index.d.ts

@@ -0,0 +1,5 @@
+export * from './lib/domain-seed.types';
+export * from './lib/collect-entity-factories.util';
+export * from './lib/axp-entity-to-definition.converter';
+export * from './lib/category-companion-entity.builder';
+export * from './lib/domain-definition-seed.provider';

package/domain/seed/src/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/domain-seed.types"), exports);
+tslib_1.__exportStar(require("./lib/collect-entity-factories.util"), exports);
+tslib_1.__exportStar(require("./lib/axp-entity-to-definition.converter"), exports);
+tslib_1.__exportStar(require("./lib/category-companion-entity.builder"), exports);
+tslib_1.__exportStar(require("./lib/domain-definition-seed.provider"), exports);
+//# sourceMappingURL=index.js.map

package/domain/seed/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../../libs/framework/server/domain/seed/src/index.ts"],"names":[],"mappings":";;;AAAA,kEAAwC;AACxC,8EAAoD;AACpD,mFAAyD;AACzD,kFAAwD;AACxD,gFAAsD"}

package/domain/seed/src/lib/axp-entity-to-definition.converter.d.ts

@@ -0,0 +1,9 @@
+import { type AXPEntityDefinition } from '@acorex-platform/framework-server/domain/abstract';
+import type { AXPEntity } from '@acorex-platform/framework-shared/entity';
+/**
+ * Maps a layout {@link AXPEntity} (module `*.entity.ts` factories) to a domain
+ * {@link AXPEntityDefinition} stored in the entity-definition JQL `entities` store.
+ */
+export declare function axpEntityToEntityDefinition(entity: AXPEntity): AXPEntityDefinition;
+/** Builds the domain-definition store row for one entity. */
+export declare function buildDomainEntityStoreRecord(entity: AXPEntity): Record<string, unknown>;

package/domain/seed/src/lib/axp-entity-to-definition.converter.js

@@ -0,0 +1,64 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.axpEntityToEntityDefinition = axpEntityToEntityDefinition;
+exports.buildDomainEntityStoreRecord = buildDomainEntityStoreRecord;
+const abstract_1 = require("@acorex-platform/framework-server/domain/abstract");
+//#region ---- AXPEntity → AXPEntityDefinition ----
+/**
+ * Maps a layout {@link AXPEntity} (module `*.entity.ts` factories) to a domain
+ * {@link AXPEntityDefinition} stored in the entity-definition JQL `entities` store.
+ */
+function axpEntityToEntityDefinition(entity) {
+    return {
+        name: entity.name,
+        title: entity.title,
+        module: entity.module,
+        type: abstract_1.AXPEntityType.Entity,
+        icon: entity.icon,
+        plugins: entity.plugins,
+        groups: entity.groups,
+        columns: entity.columns?.map((column) => typeof column === 'string' ? { name: column } : { name: column.name }),
+        formats: entity.formats,
+        fields: entity.properties.map(propertyToField),
+        relatedEntities: entity.relatedEntities,
+    };
+}
+function propertyToField(property) {
+    const widgetType = property.schema.interface?.type ?? 'text-editor';
+    const interfaceOptions = property.schema.interface?.options;
+    const field = {
+        name: property.name,
+        title: property.title,
+        description: property.description,
+        dataType: property.schema.dataType,
+        interface: {
+            name: String(widgetType),
+            title: property.title,
+            ...(interfaceOptions ? { options: interfaceOptions } : {}),
+        },
+        validations: property.validations,
+        fieldFeatures: {
+            nullable: property.schema.nullable ?? true,
+            readOnly: Boolean(property.schema.readonly),
+        },
+    };
+    if (property.groupId) {
+        field.groupId = property.groupId;
+    }
+    if (property.options) {
+        field.options = property.options;
+    }
+    return field;
+}
+/** Builds the domain-definition store row for one entity. */
+function buildDomainEntityStoreRecord(entity) {
+    const entityFullName = `${entity.module}.${entity.name}`;
+    return {
+        id: entityFullName,
+        name: entity.name,
+        module_id: entity.module,
+        definition: axpEntityToEntityDefinition(entity),
+    };
+}
+//#endregion
+//# sourceMappingURL=axp-entity-to-definition.converter.js.map

package/domain/seed/src/lib/axp-entity-to-definition.converter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"axp-entity-to-definition.converter.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/domain/seed/src/lib/axp-entity-to-definition.converter.ts"],"names":[],"mappings":";;AAkBA,kEAgBC;AAuCD,oEASC;AAlFD,gFAK2D;AAO3D,mDAAmD;AAEnD;;;GAGG;AACH,SAAgB,2BAA2B,CAAC,MAAiB;IAC3D,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,IAAI,EAAE,wBAAa,CAAC,MAAM;QAC1B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACtC,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CACtE;QACD,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,eAAe,CAAC;QAC9C,eAAe,EAAE,MAAM,CAAC,eAAe;KACxC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,QAA2B;IAClD,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,IAAI,aAAa,CAAC;IACpE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,OAAO,CAAC;IAE5D,MAAM,KAAK,GAIT;QACE,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ;QAClC,SAAS,EAAE;YACT,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC;YACxB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,GAAG,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3D;QACD,WAAW,EAAE,QAAQ,CAAC,WAAmD;QACzE,aAAa,EAAE;YACb,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI;YAC1C,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC;SAC5C;KACF,CAAC;IAEJ,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACnC,CAAC;IAED,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrB,KAAK,CAAC,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IACnC,CAAC;IAED,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6DAA6D;AAC7D,SAAgB,4BAA4B,CAAC,MAAiB;IAC5D,MAAM,cAAc,GAAG,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;IAEzD,OAAO;QACL,EAAE,EAAE,cAAc;QAClB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,SAAS,EAAE,MAAM,CAAC,MAAM;QACxB,UAAU,EAAE,2BAA2B,CAAC,MAAM,CAAC;KAChD,CAAC;AACJ,CAAC;AAED,YAAY"}

package/domain/seed/src/lib/category-companion-entity.builder.d.ts

@@ -0,0 +1,30 @@
+import type { AXPEntity } from '@acorex-platform/framework-shared/entity';
+/** Mirrors {@link AXPCategoryPluginOptions} on the client category plugin. */
+export interface CategoryPluginOptions {
+    categoryEntity?: string;
+    propertyName?: string;
+    allowMultiple?: boolean;
+    textField?: string;
+    valueField?: string;
+    parentKey?: string;
+    readonly?: boolean;
+    appearance?: {
+        icon?: boolean;
+        color?: boolean;
+    };
+    metaData?: {
+        enabled: boolean;
+        title?: string;
+    };
+}
+/**
+ * Builds the companion `{BaseEntity}Category` layout entity for domain-definition seeding.
+ * Mirrors client {@link AXMEntityCategoryProvider} (dynamic category entity generation).
+ *
+ * Returns `null` when:
+ * - base entity has no category plugin
+ * - `categoryEntity` option points to a custom entity defined elsewhere
+ */
+export declare function buildCategoryCompanionEntity(baseEntity: AXPEntity): AXPEntity | null;
+/** Resolves companion category entity keys for all base entities (for diagnostics/tests). */
+export declare function resolveCategoryCompanionEntityKeys(baseEntities: readonly AXPEntity[]): string[];

package/domain/seed/src/lib/category-companion-entity.builder.js

@@ -0,0 +1,178 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCategoryCompanionEntity = buildCategoryCompanionEntity;
+exports.resolveCategoryCompanionEntityKeys = resolveCategoryCompanionEntityKeys;
+const CATEGORY_PLUGIN_NAMES = new Set(['category', 'common.category']);
+function isCategoryPlugin(plugin) {
+    const name = plugin.name?.trim() ?? '';
+    return CATEGORY_PLUGIN_NAMES.has(name) || name.endsWith('.category');
+}
+function readCategoryPlugin(baseEntity) {
+    const plugin = baseEntity.plugins?.find(isCategoryPlugin);
+    if (!plugin) {
+        return null;
+    }
+    return {
+        plugin,
+        options: (plugin.options ?? {}),
+    };
+}
+function resolveMetaDataBuilderTitle(baseEntity, options) {
+    const metaDataFormPlugin = baseEntity.plugins?.find((p) => p.name === 'meta-data-form');
+    const pluginTitle = metaDataFormPlugin?.options?.['title'];
+    if (typeof pluginTitle === 'string' && pluginTitle.trim().length > 0) {
+        return pluginTitle.trim();
+    }
+    const extensionTitle = baseEntity['extensions'];
+    const extEntry = extensionTitle?.metaDataForm
+        ? Object.values(extensionTitle.metaDataForm).find((ext) => ext?.title?.trim())
+        : undefined;
+    if (extEntry?.title?.trim()) {
+        return extEntry.title.trim();
+    }
+    if (options.metaData?.title?.trim()) {
+        return options.metaData.title.trim();
+    }
+    return undefined;
+}
+/**
+ * Builds the companion `{BaseEntity}Category` layout entity for domain-definition seeding.
+ * Mirrors client {@link AXMEntityCategoryProvider} (dynamic category entity generation).
+ *
+ * Returns `null` when:
+ * - base entity has no category plugin
+ * - `categoryEntity` option points to a custom entity defined elsewhere
+ */
+function buildCategoryCompanionEntity(baseEntity) {
+    if (!baseEntity.module?.trim() || !baseEntity.name?.trim()) {
+        return null;
+    }
+    const categoryConfig = readCategoryPlugin(baseEntity);
+    if (!categoryConfig) {
+        return null;
+    }
+    const { options } = categoryConfig;
+    if (options.categoryEntity?.trim()) {
+        return null;
+    }
+    const categoryEntityName = `${baseEntity.name}Category`;
+    const categoryEntityKey = `${baseEntity.module}.${categoryEntityName}`;
+    const appearanceConfig = options.appearance;
+    const enableAppearance = appearanceConfig?.icon === true || appearanceConfig?.color === true;
+    const enableMetaDataSelector = options.metaData?.enabled === true;
+    const metaDataBuilderTitle = enableMetaDataSelector
+        ? resolveMetaDataBuilderTitle(baseEntity, options)
+        : undefined;
+    const properties = [
+        {
+            name: 'title',
+            title: '@general:terms.common.title',
+            groupId: 'basic-info',
+            options: {
+                sort: { enabled: true },
+                filter: { advance: { enabled: true }, inline: { enabled: true } },
+            },
+            schema: { dataType: 'string', interface: { type: 'text-editor' } },
+            validations: [{ rule: 'required' }],
+        },
+        {
+            name: 'parentId',
+            title: '@general:terms.classification.parent',
+            groupId: 'basic-info',
+            schema: {
+                dataType: 'string',
+                interface: {
+                    type: 'entity-category-editor',
+                    options: { entity: categoryEntityKey },
+                },
+            },
+        },
+        {
+            name: 'description',
+            title: '@general:terms.common.description',
+            groupId: 'basic-info',
+            schema: { dataType: 'string', interface: { type: 'large-text-editor' } },
+        },
+    ];
+    if (enableAppearance && appearanceConfig?.color !== false) {
+        properties.push({
+            name: 'color',
+            title: '@general:terms.common.color',
+            groupId: 'appearance',
+            schema: { dataType: 'string', interface: { type: 'color-palette-editor' } },
+        });
+    }
+    if (enableAppearance && appearanceConfig?.icon !== false) {
+        properties.push({
+            name: 'icon',
+            title: '@general:terms.common.icon',
+            groupId: 'appearance',
+            schema: { dataType: 'string', interface: { type: 'icon-chooser' } },
+        });
+    }
+    if (enableMetaDataSelector) {
+        properties.push({
+            name: 'metaDataList',
+            title: metaDataBuilderTitle ??
+                '@data-management:metadata-definitions.actions.configure-meta-data.title',
+            groupId: 'meta-data-config',
+            schema: {
+                dataType: 'object',
+                interface: { type: 'meta-data-builder-editor' },
+            },
+        });
+    }
+    return {
+        module: baseEntity.module,
+        name: categoryEntityName,
+        parentKey: options.parentKey?.trim() || 'parentId',
+        title: '@general:terms.classification.category',
+        formats: {
+            individual: '@general:terms.classification.category',
+            plural: '@general:terms.classification.categories',
+            searchResult: {
+                title: '{{ title }}',
+                description: '{{ module }}',
+            },
+        },
+        plugins: enableMetaDataSelector
+            ? [
+                {
+                    name: 'meta-data-builder',
+                    ...(metaDataBuilderTitle ? { options: { title: metaDataBuilderTitle } } : {}),
+                },
+            ]
+            : [],
+        relatedEntities: [],
+        groups: [
+            { id: 'basic-info', title: '@general:terms.interface.basic-info' },
+            ...(enableAppearance
+                ? [{ id: 'appearance', title: '@general:terms.interface.appearance' }]
+                : []),
+            ...(enableMetaDataSelector
+                ? [
+                    {
+                        id: 'meta-data-config',
+                        title: metaDataBuilderTitle ??
+                            '@data-management:metadata-definitions.actions.configure-meta-data.title',
+                    },
+                ]
+                : []),
+        ],
+        properties,
+        columns: [{ name: 'title' }, { name: 'description' }],
+    };
+}
+/** Resolves companion category entity keys for all base entities (for diagnostics/tests). */
+function resolveCategoryCompanionEntityKeys(baseEntities) {
+    const keys = [];
+    for (const entity of baseEntities) {
+        const companion = buildCategoryCompanionEntity(entity);
+        if (companion) {
+            keys.push(`${companion.module}.${companion.name}`);
+        }
+    }
+    return keys;
+}
+//#endregion
+//# sourceMappingURL=category-companion-entity.builder.js.map

package/domain/seed/src/lib/category-companion-entity.builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category-companion-entity.builder.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/domain/seed/src/lib/category-companion-entity.builder.ts"],"names":[],"mappings":"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"}

package/domain/seed/src/lib/collect-entity-factories.util.d.ts

@@ -0,0 +1,7 @@
+import type { AXPDomainEntityFactory } from './domain-seed.types';
+/**
+ * Collects async entity factory functions from a domain package namespace export.
+ * Matches exported zero-arg functions whose name contains `Factory` (any casing),
+ * e.g. `localesFactory`, `tenantEntityFactory`, `factoryAssessmentCase`.
+ */
+export declare function collectEntityFactories(moduleExports: Record<string, unknown>): AXPDomainEntityFactory[];