@baseplate-dev/project-builder-lib 0.5.3 → 0.6.0

package/dist/{definition/project-definition-container.test-utils.js → testing/project-definition-container.test-helper.js}

@@ -1,8 +1,9 @@
+import { ProjectDefinitionContainer } from '#src/definition/project-definition-container.js';
 import { getLatestMigrationVersion } from '#src/migrations/index.js';
 import { createPluginSpecStore } from '#src/parser/parser.js';
 import { deserializeSchemaWithTransformedReferences } from '#src/references/deserialize-schema.js';
+import { createDefinitionSchemaParserContext } from '#src/schema/index.js';
 import { createProjectDefinitionSchema } from '#src/schema/project-definition.js';
-import { ProjectDefinitionContainer } from './project-definition-container.js';
 export function createTestProjectDefinition(input = {}) {
     return {
         settings: {
@@ -36,7 +37,8 @@ export function createTestProjectDefinitionContainer(input = {}) {
     const pluginSpecStore = createPluginSpecStore(pluginStore, {
         plugins: [],
     });
-    const resolvedRefPayload = deserializeSchemaWithTransformedReferences(createProjectDefinitionSchema, createTestProjectDefinitionInput(input), { plugins: pluginSpecStore });
+    const schema = createProjectDefinitionSchema(createDefinitionSchemaParserContext({ plugins: pluginSpecStore }));
+    const resolvedRefPayload = deserializeSchemaWithTransformedReferences(schema, createTestProjectDefinitionInput(input));
     return new ProjectDefinitionContainer(resolvedRefPayload, {
         pluginStore,
         cliVersion: '0.1.0',
@@ -44,8 +46,12 @@ export function createTestProjectDefinitionContainer(input = {}) {
             id: 'test-project',
             name: 'test-project',
             directory: '/test-project',
-            isInternalExample: false,
+            type: 'user',
+            baseplateDirectory: '/test-project/baseplate',
         },
-    }, pluginSpecStore);
+    }, pluginSpecStore, schema);
 }
-//# sourceMappingURL=project-definition-container.test-utils.js.map
+export function createTestEntityServiceContext(input = {}) {
+    return createTestProjectDefinitionContainer(input).toEntityServiceContext();
+}
+//# sourceMappingURL=project-definition-container.test-helper.js.map

package/dist/testing/project-definition-container.test-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-definition-container.test-helper.js","sourceRoot":"","sources":["../../src/testing/project-definition-container.test-helper.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,0BAA0B,EAAE,MAAM,iDAAiD,CAAC;AAC7F,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AACrE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,0CAA0C,EAAE,MAAM,uCAAuC,CAAC;AACnG,OAAO,EAAE,mCAAmC,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,6BAA6B,EAAE,MAAM,mCAAmC,CAAC;AAElF,MAAM,UAAU,2BAA2B,CACzC,QAAoC,EAAE;IAEtC,OAAO;QACL,QAAQ,EAAE;YACR,OAAO,EAAE;gBACP,IAAI,EAAE,cAAc;gBACpB,YAAY,EAAE,EAAE;gBAChB,UAAU,EAAE,IAAI;aACjB;SACF;QACD,QAAQ,EAAE,EAAE;QACZ,UAAU,EAAE,OAAO;QACnB,IAAI,EAAE,EAAE;QACR,SAAS,EAAE,EAAE;QACb,MAAM,EAAE,EAAE;QACV,aAAa,EAAE,IAAI;QACnB,aAAa,EAAE,yBAAyB,EAAE;QAC1C,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,gCAAgC,CAC9C,QAAyC,EAAE;IAE3C,OAAO;QACL,GAAG,2BAA2B,EAAE;QAChC,GAAG,KAAK;KACT,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,oCAAoC,CAClD,QAAyC,EAAE;IAE3C,MAAM,WAAW,GAAgB;QAC/B,gBAAgB,EAAE,EAAE;QACpB,WAAW,EAAE,EAAE;KAChB,CAAC;IACF,MAAM,eAAe,GAAG,qBAAqB,CAAC,WAAW,EAAE;QACzD,OAAO,EAAE,EAAE;KACZ,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,6BAA6B,CAC1C,mCAAmC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,CAAC,CAClE,CAAC;IACF,MAAM,kBAAkB,GAAG,0CAA0C,CACnE,MAAM,EACN,gCAAgC,CAAC,KAAK,CAAC,CACxC,CAAC;IACF,OAAO,IAAI,0BAA0B,CACnC,kBAAkB,EAClB;QACE,WAAW;QACX,UAAU,EAAE,OAAO;QACnB,OAAO,EAAE;YACP,EAAE,EAAE,cAAc;YAClB,IAAI,EAAE,cAAc;YACpB,SAAS,EAAE,eAAe;YAC1B,IAAI,EAAE,MAAM;YACZ,kBAAkB,EAAE,yBAAyB;SAC9C;KACF,EACD,eAAe,EACf,MAAM,CACP,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAAyC,EAAE;IAE3C,OAAO,oCAAoC,CAAC,KAAK,CAAC,CAAC,sBAAsB,EAAE,CAAC;AAC9E,CAAC"}

package/dist/tools/assign-entity-ids.d.ts

@@ -0,0 +1,17 @@
+import type { z } from 'zod';
+interface AssignEntityIdsOptions {
+    /** If returns true for an ID, that ID is preserved (not regenerated). */
+    isExistingId?: (id: string) => boolean;
+}
+/**
+ * Recursively assigns IDs to an entity and all nested child entities.
+ *
+ * Walks the schema using `transformDataWithSchema` to detect entity nodes
+ * (via `getEntityMeta`). At each entity boundary, generates a new ID unless
+ * the existing ID is preserved by the `isExistingId` callback.
+ *
+ * Returns a new object with IDs assigned (immutable, structural sharing).
+ */
+export declare function assignEntityIds<T>(schema: z.ZodType, data: T, options?: AssignEntityIdsOptions): T;
+export {};
+//# sourceMappingURL=assign-entity-ids.d.ts.map

package/dist/tools/assign-entity-ids.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assign-entity-ids.d.ts","sourceRoot":"","sources":["../../src/tools/assign-entity-ids.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAS7B,UAAU,sBAAsB;IAC9B,yEAAyE;IACzE,YAAY,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC;CACxC;AAED;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAC/B,MAAM,EAAE,CAAC,CAAC,OAAO,EACjB,IAAI,EAAE,CAAC,EACP,OAAO,CAAC,EAAE,sBAAsB,GAC/B,CAAC,CAuBH"}

package/dist/tools/assign-entity-ids.js

@@ -0,0 +1,34 @@
+import { immutableSet } from '@baseplate-dev/utils';
+import { get } from 'es-toolkit/compat';
+import { transformDataWithSchema } from '#src/parser/transform-data-with-schema.js';
+import { getEntityMeta } from './merge-schema/entity-utils.js';
+/**
+ * Recursively assigns IDs to an entity and all nested child entities.
+ *
+ * Walks the schema using `transformDataWithSchema` to detect entity nodes
+ * (via `getEntityMeta`). At each entity boundary, generates a new ID unless
+ * the existing ID is preserved by the `isExistingId` callback.
+ *
+ * Returns a new object with IDs assigned (immutable, structural sharing).
+ */
+export function assignEntityIds(schema, data, options) {
+    return transformDataWithSchema(schema, data, (value, ctx) => {
+        const entityMeta = getEntityMeta(ctx.schema);
+        if (!entityMeta) {
+            return value;
+        }
+        if (value === null || value === undefined || typeof value !== 'object') {
+            return value;
+        }
+        const currentId = get(value, entityMeta.idPath);
+        if (currentId !== undefined && typeof currentId !== 'string') {
+            throw new TypeError(`Expected string id at path "${entityMeta.idPath.join('.')}" but got ${typeof currentId}`);
+        }
+        if (currentId && options?.isExistingId?.(currentId)) {
+            return value;
+        }
+        const newId = entityMeta.type.generateNewId();
+        return immutableSet(value, entityMeta.idPath, newId);
+    });
+}
+//# sourceMappingURL=assign-entity-ids.js.map

package/dist/tools/assign-entity-ids.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assign-entity-ids.js","sourceRoot":"","sources":["../../src/tools/assign-entity-ids.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAExC,OAAO,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEpF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAO/D;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAiB,EACjB,IAAO,EACP,OAAgC;IAEhC,OAAO,uBAAuB,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QAC1D,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YACvE,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,CAAY,CAAC;QAC3D,IAAI,SAAS,KAAK,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;YAC7D,MAAM,IAAI,SAAS,CACjB,+BAA+B,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,OAAO,SAAS,EAAE,CAC1F,CAAC;QACJ,CAAC;QACD,IAAI,SAAS,IAAI,OAAO,EAAE,YAAY,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC;YACpD,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QAC9C,OAAO,YAAY,CAAC,KAAK,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/tools/entity-service/entity-navigation.d.ts

@@ -0,0 +1,13 @@
+import type { ReferencePath } from '#src/references/types.js';
+import type { EntityServiceContext } from './types.js';
+/**
+ * Finds the entity array containing entities of the given type.
+ *
+ * For top-level types: navigates from the definition root.
+ * For nested types: finds the parent entity by ID, then navigates from there.
+ */
+export declare function resolveEntityArray(entityTypeName: string, parentEntityId: string | undefined, { entityTypeMap, lookupEntity, serializedDefinition }: EntityServiceContext): {
+    array: unknown[];
+    path: ReferencePath;
+};
+//# sourceMappingURL=entity-navigation.d.ts.map

package/dist/tools/entity-service/entity-navigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-navigation.d.ts","sourceRoot":"","sources":["../../../src/tools/entity-service/entity-navigation.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAwEvD;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,cAAc,EAAE,MAAM,EACtB,cAAc,EAAE,MAAM,GAAG,SAAS,EAClC,EAAE,aAAa,EAAE,YAAY,EAAE,oBAAoB,EAAE,EAAE,oBAAoB,GAC1E;IAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CA0C3C"}

package/dist/tools/entity-service/entity-navigation.js

@@ -0,0 +1,84 @@
+import { isPlainObject } from 'es-toolkit';
+import { get } from 'es-toolkit/compat';
+/**
+ * Navigates from a starting object through a schema relative path to reach the entity array.
+ * Returns the array at the end of the path, or throws an error if the path is invalid.
+ */
+function navigateToEntityArrayFromSchemaPath(obj, relativePath, pathPrefix) {
+    let current = obj;
+    const path = [...pathPrefix];
+    for (const element of relativePath) {
+        switch (element.type) {
+            case 'object-key': {
+                if (!isPlainObject(current)) {
+                    throw new TypeError(`Expected object at path "${path.join('.')}" but got ${typeof current}`);
+                }
+                current = current[element.key];
+                path.push(element.key);
+                break;
+            }
+            case 'tuple-index': {
+                if (!Array.isArray(current)) {
+                    throw new TypeError(`Expected array at path "${path.join('.')}" but got ${typeof current}`);
+                }
+                current = current[element.index];
+                path.push(element.index);
+                break;
+            }
+            case 'discriminated-union-array': {
+                // Enter the array and find the unique element matching the discriminator
+                if (!Array.isArray(current)) {
+                    throw new TypeError(`Expected array at path "${path.join('.')}" but got ${typeof current}`);
+                }
+                const match = current.findIndex((item) => {
+                    if (!isPlainObject(item)) {
+                        throw new TypeError(`Expected object at path "${path.join('.')}" but got ${typeof item}`);
+                    }
+                    return item[element.discriminatorKey] === element.value;
+                });
+                if (match === -1) {
+                    throw new Error(`No element found in array at path "${path.join('.')}" with discriminator key "${element.discriminatorKey}" and value "${element.value}"`);
+                }
+                current = current[match];
+                path.push(match);
+                break;
+            }
+        }
+    }
+    if (!Array.isArray(current)) {
+        throw new TypeError(`Expected array at path "${path.join('.')}" but got ${typeof current}`);
+    }
+    return { array: current, path };
+}
+/**
+ * Finds the entity array containing entities of the given type.
+ *
+ * For top-level types: navigates from the definition root.
+ * For nested types: finds the parent entity by ID, then navigates from there.
+ */
+export function resolveEntityArray(entityTypeName, parentEntityId, { entityTypeMap, lookupEntity, serializedDefinition }) {
+    const metadata = entityTypeMap.get(entityTypeName);
+    if (!metadata) {
+        throw new Error(`Unknown entity type: ${entityTypeName}`);
+    }
+    let startPath = [];
+    if (metadata.parentEntityTypeName) {
+        // Nested entity: find the parent first
+        if (!parentEntityId) {
+            throw new Error(`Entity type "${entityTypeName}" requires a parent entity ID (parent type: "${metadata.parentEntityTypeName}")`);
+        }
+        const parentResult = lookupEntity(parentEntityId);
+        if (!parentResult) {
+            throw new Error(`Parent entity "${parentEntityId}" not found for entity type "${entityTypeName}"`);
+        }
+        startPath = parentResult.path;
+    }
+    const parentEntity = (startPath.length === 0
+        ? serializedDefinition
+        : get(serializedDefinition, startPath));
+    if (!isPlainObject(parentEntity)) {
+        throw new Error(`Parent entity at path "${startPath.join('.')}" is not a plain object`);
+    }
+    return navigateToEntityArrayFromSchemaPath(parentEntity, metadata.relativePath, startPath);
+}
+//# sourceMappingURL=entity-navigation.js.map

package/dist/tools/entity-service/entity-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-navigation.js","sourceRoot":"","sources":["../../../src/tools/entity-service/entity-navigation.ts"],"names":[],"mappings":"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"}

package/dist/tools/entity-service/entity-read.d.ts

@@ -0,0 +1,38 @@
+import type { EntityServiceContext } from './types.js';
+export interface ListEntitiesInput {
+    entityTypeName: string;
+    parentEntityId?: string;
+}
+/**
+ * Lightweight entity stub returned by listEntities.
+ */
+export interface EntityStub {
+    id: string;
+    name: string;
+    type: string;
+}
+/**
+ * Lists all entities of a given type, returning lightweight stubs.
+ *
+ * For nested entity types, `parentEntityId` is required to scope the listing
+ * to entities within a specific parent.
+ *
+ * @param container - The project definition container
+ * @param entityTypeMap - The entity type map built from the schema
+ * @param entityTypeName - The entity type to list
+ * @param parentEntityId - Required for nested entity types
+ * @returns Array of entity stubs with id, name, and type
+ */
+export declare function listEntities({ entityTypeName, parentEntityId }: ListEntitiesInput, context: EntityServiceContext): EntityStub[];
+/**
+ * Gets a single entity by ID, returning its full serialized (name-based) data.
+ *
+ * @param container - The project definition container
+ * @param entityTypeMap - The entity type map built from the schema
+ * @param serializedDef - The serialized project definition (with names)
+ * @param entityTypeName - The entity type to get
+ * @param entityId - The entity ID
+ * @returns The serialized entity data, or undefined if not found
+ */
+export declare function getEntity(entityId: string, context: EntityServiceContext): Record<string, unknown> | undefined;
+//# sourceMappingURL=entity-read.d.ts.map

package/dist/tools/entity-service/entity-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-read.d.ts","sourceRoot":"","sources":["../../../src/tools/entity-service/entity-read.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKvD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,EAAE,cAAc,EAAE,cAAc,EAAE,EAAE,iBAAiB,EACrD,OAAO,EAAE,oBAAoB,GAC5B,UAAU,EAAE,CA2Bd;AAED;;;;;;;;;GASG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAYrC"}

package/dist/tools/entity-service/entity-read.js

@@ -0,0 +1,56 @@
+import { isPlainObject } from 'es-toolkit';
+import { get } from 'es-toolkit/compat';
+import { getEntityName } from '../merge-schema/entity-utils.js';
+import { resolveEntityArray } from './entity-navigation.js';
+/**
+ * Lists all entities of a given type, returning lightweight stubs.
+ *
+ * For nested entity types, `parentEntityId` is required to scope the listing
+ * to entities within a specific parent.
+ *
+ * @param container - The project definition container
+ * @param entityTypeMap - The entity type map built from the schema
+ * @param entityTypeName - The entity type to list
+ * @param parentEntityId - Required for nested entity types
+ * @returns Array of entity stubs with id, name, and type
+ */
+export function listEntities({ entityTypeName, parentEntityId }, context) {
+    const metadata = context.entityTypeMap.get(entityTypeName);
+    if (!metadata) {
+        throw new Error(`Unknown entity type: ${entityTypeName}`);
+    }
+    const { array, path } = resolveEntityArray(entityTypeName, parentEntityId, context);
+    return array.map((item, index) => {
+        if (!isPlainObject(item)) {
+            throw new TypeError(`Expected plain object at path "${path.join('.')}[${index}]" but got ${typeof item}`);
+        }
+        const id = get(item, metadata.entityMeta.idPath);
+        if (typeof id !== 'string') {
+            throw new TypeError(`Expected string id at path "${metadata.entityMeta.idPath.join('.')}" but got ${typeof id}`);
+        }
+        const name = getEntityName(metadata.entityMeta, item);
+        return { id, name, type: entityTypeName };
+    });
+}
+/**
+ * Gets a single entity by ID, returning its full serialized (name-based) data.
+ *
+ * @param container - The project definition container
+ * @param entityTypeMap - The entity type map built from the schema
+ * @param serializedDef - The serialized project definition (with names)
+ * @param entityTypeName - The entity type to get
+ * @param entityId - The entity ID
+ * @returns The serialized entity data, or undefined if not found
+ */
+export function getEntity(entityId, context) {
+    const result = context.lookupEntity(entityId);
+    if (!result) {
+        return undefined;
+    }
+    const item = get(context.serializedDefinition, result.path);
+    if (!isPlainObject(item)) {
+        throw new TypeError(`Expected plain object at path "${result.path.join('.')}" but got ${typeof item}`);
+    }
+    return item;
+}
+//# sourceMappingURL=entity-read.js.map

package/dist/tools/entity-service/entity-read.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-read.js","sourceRoot":"","sources":["../../../src/tools/entity-service/entity-read.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAIxC,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAgB5D;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,YAAY,CAC1B,EAAE,cAAc,EAAE,cAAc,EAAqB,EACrD,OAA6B;IAE7B,MAAM,QAAQ,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC3D,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,wBAAwB,cAAc,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,GAAG,kBAAkB,CACxC,cAAc,EACd,cAAc,EACd,OAAO,CACR,CAAC;IAEF,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,SAAS,CACjB,kCAAkC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,KAAK,cAAc,OAAO,IAAI,EAAE,CACrF,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAY,CAAC;QAC5D,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,IAAI,SAAS,CACjB,+BAA+B,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,OAAO,EAAE,EAAE,CAC5F,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,aAAa,CAAC,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QACtD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAC5C,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,SAAS,CACvB,QAAgB,EAChB,OAA6B;IAE7B,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAY,CAAC;IACvE,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CACjB,kCAAkC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,aAAa,OAAO,IAAI,EAAE,CAClF,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/entity-service/entity-type-map.d.ts

@@ -0,0 +1,18 @@
+import type { z } from 'zod';
+import type { EntityTypeMap } from './types.js';
+/**
+ * Collects entity metadata from a Zod schema by walking its structure.
+ *
+ * Walks the schema once, detecting entity arrays (via `definitionRefRegistry`
+ * annotations) and building metadata for each entity type including its
+ * relative path from the parent entity (or root) and parent entity type linkage.
+ *
+ * Parent relationships are determined by `entityType.parentType` on the
+ * `DefinitionEntityType` instance — when a parent type is set, the walker
+ * finds the matching ancestor entity in its stack and computes the relative
+ * path from there.
+ *
+ * Call once per schema and reuse the result.
+ */
+export declare function collectEntityMetadata(schema: z.ZodType): EntityTypeMap;
+//# sourceMappingURL=entity-type-map.d.ts.map

package/dist/tools/entity-service/entity-type-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-type-map.d.ts","sourceRoot":"","sources":["../../../src/tools/entity-service/entity-type-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAO7B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAIhD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,GAAG,aAAa,CAyEtE"}

package/dist/tools/entity-service/entity-type-map.js

@@ -0,0 +1,75 @@
+import { getSchemaChildren } from '#src/parser/schema-structure.js';
+import { walkSchemaStructure } from '#src/parser/walk-schema-structure.js';
+import { getEntityMeta } from '../merge-schema/entity-utils.js';
+/**
+ * Collects entity metadata from a Zod schema by walking its structure.
+ *
+ * Walks the schema once, detecting entity arrays (via `definitionRefRegistry`
+ * annotations) and building metadata for each entity type including its
+ * relative path from the parent entity (or root) and parent entity type linkage.
+ *
+ * Parent relationships are determined by `entityType.parentType` on the
+ * `DefinitionEntityType` instance — when a parent type is set, the walker
+ * finds the matching ancestor entity in its stack and computes the relative
+ * path from there.
+ *
+ * Call once per schema and reuse the result.
+ */
+export function collectEntityMetadata(schema) {
+    const map = new Map();
+    // Stack of entity types encountered during the walk, used to determine
+    // parent-child relationships and compute relative paths.
+    const entityStack = [];
+    walkSchemaStructure(schema, [
+        {
+            visit(innerSchema, ctx) {
+                const children = getSchemaChildren(innerSchema, undefined, []);
+                if (children.kind !== 'array') {
+                    return undefined;
+                }
+                const entityMeta = getEntityMeta(children.elementSchema);
+                if (!entityMeta) {
+                    return undefined;
+                }
+                const entityTypeName = entityMeta.type.name;
+                const { parentType } = entityMeta.type;
+                let parentEntityTypeName;
+                let relativePath;
+                if (parentType) {
+                    // Find the parent entity in the stack
+                    const parentEntry = entityStack.findLast((entry) => entry.entityTypeName === parentType.name);
+                    if (!parentEntry) {
+                        throw new Error(`Entity type "${entityTypeName}" declares parent type "${parentType.name}" ` +
+                            `but no such entity was found in the ancestor chain`);
+                    }
+                    parentEntityTypeName = parentType.name;
+                    relativePath = ctx.path.slice(parentEntry.pathAtEntity.length);
+                }
+                else {
+                    // Top-level entity: relative path is the full path
+                    relativePath = ctx.path;
+                }
+                map.set(entityTypeName, {
+                    name: entityTypeName,
+                    entityType: entityMeta.type,
+                    entityMeta,
+                    elementSchema: children.elementSchema,
+                    relativePath,
+                    parentEntityTypeName,
+                });
+                // Push onto entity stack. Child relative paths are computed by
+                // slicing from this position — the walker adds discriminated-union-array
+                // elements when descending into array branches.
+                entityStack.push({
+                    entityTypeName,
+                    pathAtEntity: ctx.path,
+                });
+                return () => {
+                    entityStack.pop();
+                };
+            },
+        },
+    ]);
+    return map;
+}
+//# sourceMappingURL=entity-type-map.js.map

package/dist/tools/entity-service/entity-type-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-type-map.js","sourceRoot":"","sources":["../../../src/tools/entity-service/entity-type-map.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAI3E,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAEhE;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAiB;IACrD,MAAM,GAAG,GAAkB,IAAI,GAAG,EAAE,CAAC;IAErC,uEAAuE;IACvE,yDAAyD;IACzD,MAAM,WAAW,GAGX,EAAE,CAAC;IAET,mBAAmB,CAAC,MAAM,EAAE;QAC1B;YACE,KAAK,CAAC,WAAW,EAAE,GAAG;gBACpB,MAAM,QAAQ,GAAG,iBAAiB,CAAC,WAAW,EAAE,SAAS,EAAE,EAAE,CAAC,CAAC;gBAC/D,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;oBAC9B,OAAO,SAAS,CAAC;gBACnB,CAAC;gBAED,MAAM,UAAU,GAAG,aAAa,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;gBACzD,IAAI,CAAC,UAAU,EAAE,CAAC;oBAChB,OAAO,SAAS,CAAC;gBACnB,CAAC;gBAED,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC5C,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,CAAC,IAAI,CAAC;gBAEvC,IAAI,oBAAwC,CAAC;gBAC7C,IAAI,YAAgD,CAAC;gBAErD,IAAI,UAAU,EAAE,CAAC;oBACf,sCAAsC;oBACtC,MAAM,WAAW,GAAG,WAAW,CAAC,QAAQ,CACtC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,cAAc,KAAK,UAAU,CAAC,IAAI,CACpD,CAAC;oBAEF,IAAI,CAAC,WAAW,EAAE,CAAC;wBACjB,MAAM,IAAI,KAAK,CACb,gBAAgB,cAAc,2BAA2B,UAAU,CAAC,IAAI,IAAI;4BAC1E,oDAAoD,CACvD,CAAC;oBACJ,CAAC;oBAED,oBAAoB,GAAG,UAAU,CAAC,IAAI,CAAC;oBACvC,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACjE,CAAC;qBAAM,CAAC;oBACN,mDAAmD;oBACnD,YAAY,GAAG,GAAG,CAAC,IAAI,CAAC;gBAC1B,CAAC;gBAED,GAAG,CAAC,GAAG,CAAC,cAAc,EAAE;oBACtB,IAAI,EAAE,cAAc;oBACpB,UAAU,EAAE,UAAU,CAAC,IAAI;oBAC3B,UAAU;oBACV,aAAa,EAAE,QAAQ,CAAC,aAAa;oBACrC,YAAY;oBACZ,oBAAoB;iBACrB,CAAC,CAAC;gBAEH,+DAA+D;gBAC/D,yEAAyE;gBACzE,gDAAgD;gBAChD,WAAW,CAAC,IAAI,CAAC;oBACf,cAAc;oBACd,YAAY,EAAE,GAAG,CAAC,IAAI;iBACvB,CAAC,CAAC;gBACH,OAAO,GAAG,EAAE;oBACV,WAAW,CAAC,GAAG,EAAE,CAAC;gBACpB,CAAC,CAAC;YACJ,CAAC;SACF;KACF,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/tools/entity-service/entity-write.d.ts

@@ -0,0 +1,39 @@
+import type { EntityServiceContext } from './types.js';
+export interface CreateEntityInput {
+    entityTypeName: string;
+    entityData: Record<string, unknown>;
+    parentEntityId?: string;
+}
+/**
+ * Creates a new entity in the definition.
+ *
+ * Generates a new ID for the entity using the entity type's ID generation.
+ * For nested entity types, `parentEntityId` specifies which parent to add to.
+ *
+ * @returns A new definition with the entity added (original is not modified)
+ */
+export declare function createEntity({ entityTypeName, entityData, parentEntityId }: CreateEntityInput, context: EntityServiceContext): Record<string, unknown>;
+export interface UpdateEntityInput {
+    entityTypeName: string;
+    entityId: string;
+    entityData: Record<string, unknown>;
+}
+/**
+ * Updates an existing entity by ID.
+ *
+ * Replaces the entity data while preserving the entity's ID.
+ *
+ * @returns A new definition with the entity updated (original is not modified)
+ */
+export declare function updateEntity({ entityTypeName, entityId, entityData }: UpdateEntityInput, context: EntityServiceContext): Record<string, unknown>;
+export interface DeleteEntityInput {
+    entityTypeName: string;
+    entityId: string;
+}
+/**
+ * Deletes an entity by ID.
+ *
+ * @returns A new definition with the entity removed (original is not modified)
+ */
+export declare function deleteEntity({ entityTypeName, entityId }: DeleteEntityInput, context: EntityServiceContext): Record<string, unknown>;
+//# sourceMappingURL=entity-write.d.ts.map

package/dist/tools/entity-service/entity-write.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-write.d.ts","sourceRoot":"","sources":["../../../src/tools/entity-service/entity-write.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAKvD,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,EAAE,cAAc,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,iBAAiB,EACjE,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAC1B,EAAE,cAAc,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,iBAAiB,EAC3D,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA4CzB;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAC1B,EAAE,cAAc,EAAE,QAAQ,EAAE,EAAE,iBAAiB,EAC/C,OAAO,EAAE,oBAAoB,GAC5B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAiCzB"}

package/dist/tools/entity-service/entity-write.js

@@ -0,0 +1,99 @@
+import { isPlainObject } from 'es-toolkit';
+import { get } from 'es-toolkit/compat';
+import { produce } from 'immer';
+import { assignEntityIds } from '../assign-entity-ids.js';
+import { resolveEntityArray } from './entity-navigation.js';
+/**
+ * Creates a new entity in the definition.
+ *
+ * Generates a new ID for the entity using the entity type's ID generation.
+ * For nested entity types, `parentEntityId` specifies which parent to add to.
+ *
+ * @returns A new definition with the entity added (original is not modified)
+ */
+export function createEntity({ entityTypeName, entityData, parentEntityId }, context) {
+    const metadata = context.entityTypeMap.get(entityTypeName);
+    if (!metadata) {
+        throw new Error(`Unknown entity type: ${entityTypeName}`);
+    }
+    // Resolve the array path on the original definition
+    const { path } = resolveEntityArray(entityTypeName, parentEntityId, context);
+    // Assign IDs to the entity and all nested child entities
+    const entityWithIds = assignEntityIds(metadata.elementSchema, entityData);
+    return produce(context.serializedDefinition, (draft) => {
+        const array = get(draft, path);
+        if (!Array.isArray(array)) {
+            throw new TypeError(`Expected array at path "${path.join('.')}" but got ${typeof array}`);
+        }
+        array.push(entityWithIds);
+    });
+}
+/**
+ * Updates an existing entity by ID.
+ *
+ * Replaces the entity data while preserving the entity's ID.
+ *
+ * @returns A new definition with the entity updated (original is not modified)
+ */
+export function updateEntity({ entityTypeName, entityId, entityData }, context) {
+    const metadata = context.entityTypeMap.get(entityTypeName);
+    if (!metadata) {
+        throw new Error(`Unknown entity type: ${entityTypeName}`);
+    }
+    // Verify the entity exists and get its path
+    const entity = context.lookupEntity(entityId);
+    if (!entity) {
+        throw new Error(`Entity "${entityId}" of type "${entityTypeName}" not found`);
+    }
+    // Preserve the ID in the updated data but populate any children entities with new IDs if they don't have an ID yet.
+    const updatedEntity = assignEntityIds(metadata.elementSchema, entityData, {
+        isExistingId: (id) => !!context.lookupEntity(id),
+    });
+    return produce(context.serializedDefinition, (draft) => {
+        const target = get(draft, entity.path);
+        if (!isPlainObject(target)) {
+            throw new TypeError(`Expected plain object at path "${entity.path.join('.')}" but got ${typeof target}`);
+        }
+        // Find the parent array and the entity's index within it
+        const parentPath = entity.path.slice(0, -1);
+        const entityIndex = entity.path.at(-1);
+        if (typeof entityIndex !== 'number') {
+            throw new TypeError(`Expected numeric index at end of entity path "${entity.path.join('.')}"`);
+        }
+        const parentArray = get(draft, parentPath);
+        if (!Array.isArray(parentArray)) {
+            throw new TypeError(`Expected array at path "${parentPath.join('.')}" but got ${typeof parentArray}`);
+        }
+        parentArray[entityIndex] = updatedEntity;
+    });
+}
+/**
+ * Deletes an entity by ID.
+ *
+ * @returns A new definition with the entity removed (original is not modified)
+ */
+export function deleteEntity({ entityTypeName, entityId }, context) {
+    const metadata = context.entityTypeMap.get(entityTypeName);
+    if (!metadata) {
+        throw new Error(`Unknown entity type: ${entityTypeName}`);
+    }
+    // Verify the entity exists and get its path
+    const entity = context.lookupEntity(entityId);
+    if (!entity) {
+        throw new Error(`Entity "${entityId}" of type "${entityTypeName}" not found`);
+    }
+    // Find the parent array and remove the entity by index
+    const parentPath = entity.path.slice(0, -1);
+    const entityIndex = entity.path.at(-1);
+    if (typeof entityIndex !== 'number') {
+        throw new TypeError(`Expected numeric index at end of entity path "${entity.path.join('.')}"`);
+    }
+    return produce(context.serializedDefinition, (draft) => {
+        const parentArray = get(draft, parentPath);
+        if (!Array.isArray(parentArray)) {
+            throw new TypeError(`Expected array at path "${parentPath.join('.')}" but got ${typeof parentArray}`);
+        }
+        parentArray.splice(entityIndex, 1);
+    });
+}
+//# sourceMappingURL=entity-write.js.map

package/dist/tools/entity-service/entity-write.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-write.js","sourceRoot":"","sources":["../../../src/tools/entity-service/entity-write.ts"],"names":[],"mappings":"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"}

package/dist/tools/entity-service/index.d.ts

@@ -0,0 +1,5 @@
+export { getEntity, listEntities } from './entity-read.js';
+export { collectEntityMetadata } from './entity-type-map.js';
+export { createEntity, deleteEntity, updateEntity } from './entity-write.js';
+export type { EntityServiceContext, EntityTypeMap, EntityTypeMetadata, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/entity-service/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/entity-service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7E,YAAY,EACV,oBAAoB,EACpB,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/tools/entity-service/index.js

@@ -0,0 +1,4 @@
+export { getEntity, listEntities } from './entity-read.js';
+export { collectEntityMetadata } from './entity-type-map.js';
+export { createEntity, deleteEntity, updateEntity } from './entity-write.js';
+//# sourceMappingURL=index.js.map

package/dist/tools/entity-service/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/tools/entity-service/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC"}