@baseplate-dev/project-builder-lib 0.2.0 → 0.2.2

package/dist/references/definition-ref-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-ref-builder.d.ts","sourceRoot":"","sources":["../../src/references/definition-ref-builder.ts"],"names":[],"mappings":"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"}

package/dist/references/definition-ref-builder.js

@@ -0,0 +1,242 @@
+import { get } from 'es-toolkit/compat';
+import { stripRefMarkers } from './strip-ref-markers.js';
+/**
+ * Creates a definition entity name resolver.
+ * @param entityNameResolver - The entity name resolver.
+ * @returns The definition entity name resolver.
+ */
+export function createDefinitionEntityNameResolver(entityNameResolver) {
+    return entityNameResolver;
+}
+/**
+ * DefinitionRefBuilder is responsible for constructing reference paths, and registering
+ * references and entities as defined in a Zod schema.
+ *
+ * The builder uses a prefix (usually the current parsing path) and context (a
+ * shared map for resolving relative references) to build complete reference paths.
+ *
+ * @template TInput - The type of the input data being parsed.
+ */
+export class DefinitionRefBuilder {
+    /**
+     * Creates a new builder instance.
+     * @param pathPrefix - The starting path for all references.
+     * @param context - Shared context including a path map and deserialize flag.
+     * @param data - The data being parsed.
+     */
+    constructor(pathPrefix, context, data) {
+        Object.defineProperty(this, "references", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "entitiesWithNameResolver", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "pathPrefix", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "context", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "pathMap", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "data", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        this.references = [];
+        this.entitiesWithNameResolver = [];
+        this.pathPrefix = pathPrefix;
+        this.context = context;
+        this.pathMap = new Map();
+        this.data = data;
+    }
+    /**
+     * Converts a dot-separated string path into an array of keys.
+     * @param path - A string (e.g. "a.b.0.c") representing the path.
+     * @returns An array of keys (numbers for numeric strings, otherwise strings).
+     */
+    _constructPathWithoutPrefix(path) {
+        if (!path)
+            return [];
+        const pathComponents = path
+            .split('.')
+            .map((key) => (/^[0-9]+$/.test(key) ? Number.parseInt(key, 10) : key));
+        return pathComponents;
+    }
+    /**
+     * Prepends the builder's path prefix to the provided path.
+     * @param path - The dot-separated path string.
+     * @returns The complete reference path as an array.
+     */
+    _constructPath(path) {
+        if (!path)
+            return this.pathPrefix;
+        return [...this.pathPrefix, ...this._constructPathWithoutPrefix(path)];
+    }
+    /**
+     * Constructs a reference path that may be defined directly as a string or indirectly
+     * via a context object. If a context object is provided, the function looks up the
+     * actual path from the builder's context.
+     *
+     * @param path - Either a dot-separated string path or an object with a context key.
+     * @param expectedEntityType - The entity type expected for this context.
+     * @returns The resolved reference path.
+     * @throws If the context cannot be found or its type does not match.
+     */
+    _constructPathWithContext(path, expectedEntityType) {
+        if (typeof path === 'string') {
+            return this._constructPath(path);
+        }
+        // Lookup the context for the given key.
+        const pathContext = this.context.pathMap.get(path.context);
+        if (!pathContext) {
+            throw new Error(`Could not find context for ${path.context} from ${this.pathPrefix.join('.')}`);
+        }
+        if (pathContext.type !== expectedEntityType) {
+            throw new Error(`Attempted to retrieve context for ${path.context} from ${this.pathPrefix.join('.')} expecting ${expectedEntityType.name}, but found ${pathContext.type.name}`);
+        }
+        return pathContext.path;
+    }
+    /**
+     * Registers a reference based on the provided input definition.
+     *
+     * Flow:
+     * 1. Validate that the parent path is provided if required (and vice versa).
+     * 2. Compute the reference path; if the path is empty, use the entire data.
+     * 3. If the referenced value is null or undefined, skip adding the reference.
+     * 4. Otherwise, add the reference and, if requested, register its context.
+     *
+     * @param reference - The reference definition.
+     * @throws If parent path usage is incorrect.
+     */
+    addReference(reference) {
+        if (!reference.type.parentType && reference.parentPath) {
+            throw new Error(`Parent path does nothing since reference does not have parent`);
+        }
+        if (reference.type.parentType && !reference.parentPath) {
+            throw new Error(`Parent path required if reference type has parent type`);
+        }
+        // Compute the path without prefix once.
+        const refPathWithoutPrefix = this._constructPathWithoutPrefix(reference.path);
+        // If the path is empty, use the entire data; otherwise, retrieve the value.
+        const refValue = refPathWithoutPrefix.length === 0
+            ? this.data
+            : get(this.data, refPathWithoutPrefix);
+        if (refValue === undefined || refValue === null)
+            return;
+        const fullPath = this._constructPath(reference.path);
+        this.references.push({
+            type: reference.type,
+            path: fullPath,
+            parentPath: reference.parentPath &&
+                reference.type.parentType &&
+                this._constructPathWithContext(reference.parentPath, reference.type.parentType),
+            onDelete: reference.onDelete,
+        });
+        // Optionally, add this path to the shared context.
+        if (reference.addContext) {
+            this._addPathToContext(fullPath, reference.type, reference.addContext);
+        }
+    }
+    /**
+     * Registers an entity based on the provided definition.
+     *
+     * Flow:
+     * 1. Validate that not both a name and a name reference path are provided.
+     * 2. Compute the full entity path.
+     * 3. Resolve the entity ID:
+     *    - Use the provided idPath if available; otherwise, default to appending 'id'
+     *      to the entity path.
+     *    - If no id is found, generate a new one.
+     * 4. Resolve the entity name:
+     *    - Use the provided resolveName if available; otherwise, default to using the
+     *      name path.
+     * 5. Register the entity in either the direct entities list or the name-ref list.
+     * 6. Optionally, add the entity’s id path to the shared context.
+     *
+     * @param entity - The entity definition.
+     * @throws If both name and nameRefPath are provided or if no name is resolved.
+     */
+    addEntity(entity) {
+        // Build the full path for the entity.
+        const path = this._constructPath(entity.path);
+        // Resolve the id path: if provided use it; otherwise, assume the id is at "entity.path.id"
+        const idPath = entity.idPath
+            ? this._constructPathWithoutPrefix(entity.idPath)
+            : [...this._constructPathWithoutPrefix(entity.path), 'id'];
+        const id = get(this.data, idPath);
+        if (!id) {
+            throw new Error(`No id found for entity ${entity.type.name}`);
+        }
+        if (!entity.type.isId(id)) {
+            throw new Error(`Invalid id: ${id} for entity ${entity.type.name}`);
+        }
+        // Resolve the name: if getNameResolver is provided, use it to build the name resolver; otherwise,
+        // use the default name resolver.
+        const getNameResolver = entity.getNameResolver ?? ((value) => get(value, 'name'));
+        const nameResolver = getNameResolver(stripRefMarkers(this.data));
+        // Base entity definition shared between regular entities and those with a name reference.
+        const entityBase = {
+            id,
+            type: entity.type,
+            path,
+            idPath: [...this.pathPrefix, ...idPath],
+            parentPath: entity.parentPath &&
+                entity.type.parentType &&
+                this._constructPathWithContext(entity.parentPath, entity.type.parentType),
+        };
+        this.entitiesWithNameResolver.push({
+            ...entityBase,
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment -- needed to allow more specific generic typed to be put in here
+            nameResolver: typeof nameResolver === 'string'
+                ? { resolveName: () => nameResolver }
+                : nameResolver,
+        });
+        // Optionally add the id path to the context.
+        if (entity.addContext) {
+            this._addPathToContext([...this.pathPrefix, ...idPath], entity.type, entity.addContext);
+        }
+    }
+    /**
+     * Registers a given path into the builder's context map.
+     * @param path - The full reference path.
+     * @param type - The entity type associated with the path.
+     * @param context - A unique key to identify this context.
+     * @throws If the context key is already registered.
+     */
+    _addPathToContext(path, type, context) {
+        // For now, allow overriding contexts to maintain compatibility
+        this.pathMap.set(context, { path, type });
+        // Also register in the shared context for other builders to access
+        this.context.pathMap.set(context, { path, type });
+    }
+    /**
+     * Convenience method that builds a full path from a dot-separated string and
+     * adds it to the context.
+     * @param path - The dot-separated string path.
+     * @param type - The entity type.
+     * @param context - The context key.
+     */
+    addPathToContext(path, type, context) {
+        this._addPathToContext(this._constructPath(path), type, context);
+    }
+}
+//# sourceMappingURL=definition-ref-builder.js.map

package/dist/references/definition-ref-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition-ref-builder.js","sourceRoot":"","sources":["../../src/references/definition-ref-builder.ts"],"names":[],"mappings":"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"}

package/dist/references/deserialize-schema.d.ts

@@ -1,4 +1,15 @@
 import type { TypeOf, z } from 'zod';
+import type { DefinitionSchemaCreator, DefinitionSchemaCreatorOptions } from '#src/schema/creator/types.js';
 import type { ResolvedZodRefPayload } from './types.js';
-export declare function deserializeSchemaWithReferences<TSchema extends z.ZodType>(schema: TSchema, input: unknown): ResolvedZodRefPayload<TypeOf<TSchema>>;
+/**
+ * Deserialize a schema with references using the new transform-based approach.
+ * This function converts human-readable names back to entity IDs.
+ *
+ * @template T - The schema creator type
+ * @param schemaCreator - The schema creator function
+ * @param input - The input data with names instead of IDs
+ * @param options - Options for the schema creator (excluding transformReferences)
+ * @returns The resolved payload with IDs instead of names
+ */
+export declare function deserializeSchemaWithTransformedReferences<T extends DefinitionSchemaCreator>(schemaCreator: T, input: unknown, options: Omit<DefinitionSchemaCreatorOptions, 'transformReferences'>): ResolvedZodRefPayload<ReturnType<T> extends z.ZodType ? TypeOf<ReturnType<T>> : unknown>;
 //# sourceMappingURL=deserialize-schema.d.ts.map

package/dist/references/deserialize-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deserialize-schema.d.ts","sourceRoot":"","sources":["../../src/references/deserialize-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMrC,OAAO,KAAK,EAAoB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQ1E,wBAAgB,+BAA+B,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EACvE,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,OAAO,GACb,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CA0FxC"}
+{"version":3,"file":"deserialize-schema.d.ts","sourceRoot":"","sources":["../../src/references/deserialize-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMrC,OAAO,KAAK,EACV,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAoB,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAQ1E;;;;;;;;;GASG;AACH,wBAAgB,0CAA0C,CACxD,CAAC,SAAS,uBAAuB,EAEjC,aAAa,EAAE,CAAC,EAChB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,IAAI,CAAC,8BAA8B,EAAE,qBAAqB,CAAC,GACnE,qBAAqB,CACtB,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAClE,CAYA"}

package/dist/references/deserialize-schema.js

@@ -1,15 +1,35 @@
 import { toposort } from '@baseplate-dev/utils';
 import { groupBy, keyBy, uniq } from 'es-toolkit';
 import { get, set } from 'es-toolkit/compat';
-import { parseSchemaWithReferences } from './parse-schema-with-references.js';
+import { parseSchemaWithTransformedReferences } from './parse-schema-with-references.js';
 function referenceToNameParentId(name, parentId) {
     return JSON.stringify({ name, parentId });
 }
-export function deserializeSchemaWithReferences(schema, input) {
-    const payload = parseSchemaWithReferences(schema, input, {
+/**
+ * Deserialize a schema with references using the new transform-based approach.
+ * This function converts human-readable names back to entity IDs.
+ *
+ * @template T - The schema creator type
+ * @param schemaCreator - The schema creator function
+ * @param input - The input data with names instead of IDs
+ * @param options - Options for the schema creator (excluding transformReferences)
+ * @returns The resolved payload with IDs instead of names
+ */
+export function deserializeSchemaWithTransformedReferences(schemaCreator, input, options) {
+    const payload = parseSchemaWithTransformedReferences(schemaCreator, input, options, {
         skipReferenceNameResolution: true,
     });
-    // resolve all references
+    // Use the same resolution logic as the original function
+    return resolveReferencesToIds(payload);
+}
+/**
+ * Internal function to resolve entity names to IDs in the payload.
+ * This is shared logic between the old and new approaches.
+ *
+ * @param payload - The parsed payload with entities and references
+ * @returns The payload with references resolved to IDs
+ */
+function resolveReferencesToIds(payload) {
     const { references, entities, data } = payload;
     // check we don't have more entities than IDs
     const entitiesById = groupBy(entities, (entity) => entity.id);

package/dist/references/deserialize-schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"deserialize-schema.js","sourceRoot":"","sources":["../../src/references/deserialize-schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deserialize-schema.js","sourceRoot":"","sources":["../../src/references/deserialize-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAS7C,OAAO,EAAE,oCAAoC,EAAE,MAAM,mCAAmC,CAAC;AAEzF,SAAS,uBAAuB,CAAC,IAAY,EAAE,QAAiB;IAC9D,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,0CAA0C,CAGxD,aAAgB,EAChB,KAAc,EACd,OAAoE;IAIpE,MAAM,OAAO,GAAG,oCAAoC,CAClD,aAAa,EACb,KAAK,EACL,OAAO,EACP;QACE,2BAA2B,EAAE,IAAI;KAClC,CACF,CAAC;IAEF,yDAAyD;IACzD,OAAO,sBAAsB,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;GAMG;AACH,SAAS,sBAAsB,CAC7B,OAAiC;IAEjC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC;IAE/C,6CAA6C;IAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9D,MAAM,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,MAAM,CAC3D,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CACpB,CAAC;IACF,IAAI,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CACb,wCAAwC,kBAAkB;aACvD,GAAG,CACF,CAAC,IAAI,EAAE,EAAE,CACP,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CACnE;aACA,IAAI,CAAC,IAAI,CAAC,EAAE,CAChB,CAAC;IACJ,CAAC;IACD,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,IAAI,eAAe,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,iCAAiC;IACjC,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,MAAM,eAAe,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7D,IAAI,eAAe,CAAC,MAAM,KAAK,WAAW,CAAC,MAAM,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CACb,oFAAoF,CACrF,CAAC;IACJ,CAAC;IAED,MAAM,eAAe,GAAG,QAAQ,CAC9B,eAAe,EACf,WAAW;SACR,MAAM,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;SAC/C,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC;QACnB,UAAU,CAAC,UAAU,EAAE,IAAI,IAAI,EAAE;QACjC,UAAU,CAAC,IAAI;KAChB,CAAC,CACL,CAAC;IAEF,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7D,MAAM,gBAAgB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEjE,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;QACnC,MAAM,QAAQ,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,UAAU,GAAG,gBAAgB,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAEhD,iCAAiC;QACjC,MAAM,sBAAsB,GAC1B,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE;YACpB,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;YACzB,MAAM,QAAQ,GAAG,UAAU;gBACzB,CAAC,CAAE,GAAG,CAAC,IAAI,EAAE,UAAU,CAAY;gBACnC,CAAC,CAAC,SAAS,CAAC;YAEd,IAAI,UAAU,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CACb,kCAAkC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CACzD,CAAC;YACJ,CAAC;YAED,OAAO,uBAAuB,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACnD,CAAC,CAAC,CAAC;QAEL,KAAK,MAAM,GAAG,IAAI,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAW,CAAC;YAC3C,mFAAmF;YACnF,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,IAAK,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,UAAU,CAAY,CAAC;YACzE,MAAM,YAAY,GAAG,uBAAuB,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;YAE7D,MAAM,cAAc,GAAG,sBAAsB,CAAC,YAAY,CAAC,CAAC;YAC5D,IAAI,CAAC,cAAc,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CACb,gCAAgC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAChD,GAAG,CAAC,IAAI,CAAC,IACX,IAAI,YAAY,GAAG,CACpB,CAAC;YACJ,CAAC;YACD,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/references/extend-parser-context-with-refs.d.ts

@@ -0,0 +1,16 @@
+import type { Paths } from 'type-fest';
+import { z } from 'zod';
+import type { DefinitionEntityType } from '#src/index.js';
+import type { DefinitionSchemaCreatorOptions } from '#src/schema/index.js';
+import type { DefinitionEntityInput, DefinitionReferenceInput, ZodBuilderFunction } from './definition-ref-builder.js';
+export type WithRefType = <TEntityType extends DefinitionEntityType>(reference: DefinitionReferenceInput<string, TEntityType>) => z.ZodEffects<z.ZodString>;
+type PathInput<Type> = Exclude<Paths<Type>, number>;
+export type WithEntType = <TObject extends z.SomeZodObject, TEntityType extends DefinitionEntityType, TPath extends PathInput<z.input<TObject>>>(schema: TObject, entity: DefinitionEntityInput<z.input<TObject>, TEntityType, TPath>) => z.ZodEffects<TObject>;
+export type WithRefBuilder = <T extends z.ZodType>(schema: T, builder?: ZodBuilderFunction<z.TypeOf<T>>) => z.ZodEffects<T>;
+export declare function extendParserContextWithRefs({ transformReferences, }: DefinitionSchemaCreatorOptions): {
+    withRef: WithRefType;
+    withEnt: WithEntType;
+    withRefBuilder: WithRefBuilder;
+};
+export {};
+//# sourceMappingURL=extend-parser-context-with-refs.d.ts.map

package/dist/references/extend-parser-context-with-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend-parser-context-with-refs.d.ts","sourceRoot":"","sources":["../../src/references/extend-parser-context-with-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,sBAAsB,CAAC;AAE3E,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,kBAAkB,EAEnB,MAAM,6BAA6B,CAAC;AAWrC,MAAM,MAAM,WAAW,GAAG,CAAC,WAAW,SAAS,oBAAoB,EACjE,SAAS,EAAE,wBAAwB,CAAC,MAAM,EAAE,WAAW,CAAC,KACrD,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAE/B,KAAK,SAAS,CAAC,IAAI,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;AAEpD,MAAM,MAAM,WAAW,GAAG,CACxB,OAAO,SAAS,CAAC,CAAC,aAAa,EAC/B,WAAW,SAAS,oBAAoB,EACxC,KAAK,SAAS,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAEzC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,KAChE,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;AAE3B,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAC/C,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KACtC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAErB,wBAAgB,2BAA2B,CAAC,EAC1C,mBAAmB,GACpB,EAAE,8BAA8B,GAAG;IAClC,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,WAAW,CAAC;IACrB,cAAc,EAAE,cAAc,CAAC;CAChC,CA4GA"}

package/dist/references/extend-parser-context-with-refs.js

@@ -0,0 +1,82 @@
+import { z } from 'zod';
+import { DefinitionReferenceMarker, REF_ANNOTATIONS_MARKER_SYMBOL, } from './markers.js';
+export function extendParserContextWithRefs({ transformReferences, }) {
+    function withRef(reference) {
+        return z.string().transform((value) => {
+            if (transformReferences && value) {
+                return new DefinitionReferenceMarker(value, reference);
+            }
+            return value;
+        });
+    }
+    function withEnt(schema, entity) {
+        if (!('id' in schema.shape)) {
+            throw new Error(`Entity must have an id field. Entity type: ${entity.type.name}. Schema keys: ${Object.keys(schema.shape).join(', ')}`);
+        }
+        return schema.transform((value) => {
+            // Check if the id is valid
+            if (!('id' in value) || !entity.type.isId(value.id)) {
+                throw new Error(`Invalid id for entity ${entity.type.name}. Id: ${value.id}`);
+            }
+            if (transformReferences) {
+                const existingAnnotations = REF_ANNOTATIONS_MARKER_SYMBOL in value
+                    ? value[REF_ANNOTATIONS_MARKER_SYMBOL]
+                    : undefined;
+                return {
+                    ...value,
+                    [REF_ANNOTATIONS_MARKER_SYMBOL]: {
+                        entities: [...(existingAnnotations?.entities ?? []), entity],
+                        references: existingAnnotations?.references ?? [],
+                        contextPaths: existingAnnotations?.contextPaths ?? [],
+                    },
+                };
+            }
+            return value;
+        });
+    }
+    function withRefBuilder(schema, builder) {
+        return schema.transform((value) => {
+            if (!value) {
+                return value;
+            }
+            if (typeof value !== 'object') {
+                throw new TypeError(`refBuilder requires an object, but got ${typeof value}`);
+            }
+            const existingAnnotations = REF_ANNOTATIONS_MARKER_SYMBOL in value
+                ? value[REF_ANNOTATIONS_MARKER_SYMBOL]
+                : undefined;
+            const entities = existingAnnotations?.entities ?? [];
+            const references = existingAnnotations?.references ?? [];
+            const contextPaths = existingAnnotations?.contextPaths ?? [];
+            const refBuilder = {
+                addReference: (reference) => {
+                    references.push(reference);
+                },
+                addEntity: (entity) => {
+                    entities.push(entity);
+                },
+                addPathToContext: (path, type, context) => {
+                    contextPaths.push({ path, type, context });
+                },
+            };
+            builder?.(refBuilder, value);
+            if (transformReferences) {
+                return {
+                    ...value,
+                    [REF_ANNOTATIONS_MARKER_SYMBOL]: {
+                        entities,
+                        references,
+                        contextPaths,
+                    },
+                };
+            }
+            return value;
+        });
+    }
+    return {
+        withRef,
+        withEnt,
+        withRefBuilder,
+    };
+}
+//# sourceMappingURL=extend-parser-context-with-refs.js.map

package/dist/references/extend-parser-context-with-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extend-parser-context-with-refs.js","sourceRoot":"","sources":["../../src/references/extend-parser-context-with-refs.ts"],"names":[],"mappings":"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"}

package/dist/references/extract-definition-refs.d.ts

@@ -0,0 +1,19 @@
+import type { DefinitionEntityNameResolver, RefBuilderContext, ZodRefPayload } from './definition-ref-builder.js';
+import type { DefinitionEntity, DefinitionReference, ReferencePath } from './types.js';
+/**
+ * Entity with a name resolver.
+ */
+export interface DefinitionEntityWithNameResolver extends Omit<DefinitionEntity, 'name'> {
+    nameResolver: DefinitionEntityNameResolver;
+}
+/**
+ * Context for storing references, entities, and builder context.
+ */
+export interface ZodRefContext {
+    context: RefBuilderContext;
+    references: DefinitionReference[];
+    entitiesWithNameResolver: DefinitionEntityWithNameResolver[];
+}
+export declare function extractDefinitionRefsRecursive(value: unknown, context: ZodRefContext, path: ReferencePath): unknown;
+export declare function extractDefinitionRefs<T>(value: T): ZodRefPayload<T>;
+//# sourceMappingURL=extract-definition-refs.d.ts.map

package/dist/references/extract-definition-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-definition-refs.d.ts","sourceRoot":"","sources":["../../src/references/extract-definition-refs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,4BAA4B,EAE5B,iBAAiB,EACjB,aAAa,EACd,MAAM,6BAA6B,CAAC;AAErC,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,aAAa,EACd,MAAM,YAAY,CAAC;AAQpB;;GAEG;AACH,MAAM,WAAW,gCACf,SAAQ,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC;IACtC,YAAY,EAAE,4BAA4B,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,iBAAiB,CAAC;IAC3B,UAAU,EAAE,mBAAmB,EAAE,CAAC;IAClC,wBAAwB,EAAE,gCAAgC,EAAE,CAAC;CAC9D;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,aAAa,EACtB,IAAI,EAAE,aAAa,GAClB,OAAO,CAyET;AAED,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAgBnE"}

package/dist/references/extract-definition-refs.js

@@ -0,0 +1,63 @@
+import { DefinitionRefBuilder } from './definition-ref-builder.js';
+import { DefinitionReferenceMarker, REF_ANNOTATIONS_MARKER_SYMBOL, } from './markers.js';
+export function extractDefinitionRefsRecursive(value, context, path) {
+    const builder = new DefinitionRefBuilder(path, context.context, value);
+    if (value instanceof DefinitionReferenceMarker) {
+        builder.addReference(value.reference);
+        context.references.push(...builder.references);
+        context.entitiesWithNameResolver.push(...builder.entitiesWithNameResolver);
+        return value.value;
+    }
+    if (typeof value === 'object' &&
+        value !== null &&
+        REF_ANNOTATIONS_MARKER_SYMBOL in value) {
+        const annotations = value[REF_ANNOTATIONS_MARKER_SYMBOL];
+        for (const entity of annotations.entities) {
+            builder.addEntity(entity);
+        }
+        for (const reference of annotations.references) {
+            builder.addReference(reference);
+        }
+        for (const pathInfo of annotations.contextPaths) {
+            builder.addPathToContext(pathInfo.path, pathInfo.type, pathInfo.context);
+        }
+        context.references.push(...builder.references);
+        context.entitiesWithNameResolver.push(...builder.entitiesWithNameResolver);
+        // Remove the marker symbol and process the clean object
+        const { [REF_ANNOTATIONS_MARKER_SYMBOL]: _, ...cleanValue } = value;
+        // Process the clean object recursively
+        return Object.fromEntries(Object.entries(cleanValue).map(([key, childValue]) => [
+            key,
+            extractDefinitionRefsRecursive(childValue, context, [...path, key]),
+        ]));
+    }
+    // Run recursively for arrays first (arrays are also objects)
+    if (Array.isArray(value)) {
+        return value.map((element, i) => extractDefinitionRefsRecursive(element, context, [...path, i]));
+    }
+    // Run recursively for regular objects
+    if (typeof value === 'object' && value !== null) {
+        return Object.fromEntries(Object.entries(value).map(([key, childValue]) => [
+            key,
+            extractDefinitionRefsRecursive(childValue, context, [...path, key]),
+        ]));
+    }
+    // Return primitive values as-is
+    return value;
+}
+export function extractDefinitionRefs(value) {
+    const refContext = {
+        context: {
+            pathMap: new Map(),
+        },
+        references: [],
+        entitiesWithNameResolver: [],
+    };
+    const cleanData = extractDefinitionRefsRecursive(value, refContext, []);
+    return {
+        data: cleanData,
+        references: refContext.references,
+        entitiesWithNameResolver: refContext.entitiesWithNameResolver,
+    };
+}
+//# sourceMappingURL=extract-definition-refs.js.map

package/dist/references/extract-definition-refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract-definition-refs.js","sourceRoot":"","sources":["../../src/references/extract-definition-refs.ts"],"names":[],"mappings":"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"}

package/dist/references/fix-ref-deletions.d.ts

@@ -1,9 +1,9 @@
-import type { TypeOf, z } from 'zod';
+import type { def, DefinitionSchemaCreator, DefinitionSchemaCreatorOptions } from '#src/schema/index.js';
 import type { DefinitionReference, ResolvedZodRefPayload } from './types.js';
-interface FixRefDeletionSuccessResult<TSchema extends z.ZodType> {
+interface FixRefDeletionSuccessResult<T extends DefinitionSchemaCreator> {
     type: 'success';
-    value: TypeOf<TSchema>;
-    refPayload: ResolvedZodRefPayload<TypeOf<TSchema>>;
+    value: def.InferOutput<T>;
+    refPayload: ResolvedZodRefPayload<def.InferOutput<T>>;
 }
 export interface FixRefDeletionError {
     ref: DefinitionReference;
@@ -13,10 +13,10 @@ interface FixRefDeletionFailureResult {
     type: 'failure';
     issues: FixRefDeletionError[];
 }
-export type FixRefDeletionResult<TSchema extends z.ZodType> = FixRefDeletionSuccessResult<TSchema> | FixRefDeletionFailureResult;
+export type FixRefDeletionResult<T extends DefinitionSchemaCreator> = FixRefDeletionSuccessResult<T> | FixRefDeletionFailureResult;
 /**
  * Fixes any reference deletions by performing the appropriate action for the reference
  */
-export declare function fixRefDeletions<TSchema extends z.ZodType>(schema: TSchema, value: TypeOf<TSchema>): FixRefDeletionResult<TSchema>;
+export declare function fixRefDeletions<T extends DefinitionSchemaCreator>(schemaCreator: T, value: unknown, schemaCreatorOptions: Omit<DefinitionSchemaCreatorOptions, 'transformReferences'>): FixRefDeletionResult<T>;
 export {};
 //# sourceMappingURL=fix-ref-deletions.d.ts.map

package/dist/references/fix-ref-deletions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fix-ref-deletions.d.ts","sourceRoot":"","sources":["../../src/references/fix-ref-deletions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKrC,OAAO,KAAK,EACV,mBAAmB,EAEnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAIpB,UAAU,2BAA2B,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO;IAC7D,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IACvB,UAAU,EAAE,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,mBAAmB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,2BAA2B;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,oBAAoB,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,IACtD,2BAA2B,CAAC,OAAO,CAAC,GACpC,2BAA2B,CAAC;AAKhC;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,SAAS,CAAC,CAAC,OAAO,EACvD,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,GACrB,oBAAoB,CAAC,OAAO,CAAC,CAuG/B"}
+{"version":3,"file":"fix-ref-deletions.d.ts","sourceRoot":"","sources":["../../src/references/fix-ref-deletions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,GAAG,EACH,uBAAuB,EACvB,8BAA8B,EAC/B,MAAM,sBAAsB,CAAC;AAE9B,OAAO,KAAK,EACV,mBAAmB,EAEnB,qBAAqB,EACtB,MAAM,YAAY,CAAC;AAIpB,UAAU,2BAA2B,CAAC,CAAC,SAAS,uBAAuB;IACrE,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAC1B,UAAU,EAAE,qBAAqB,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CACvD;AAED,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,mBAAmB,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,2BAA2B;IACnC,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,MAAM,oBAAoB,CAAC,CAAC,SAAS,uBAAuB,IAC9D,2BAA2B,CAAC,CAAC,CAAC,GAC9B,2BAA2B,CAAC;AAKhC;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS,uBAAuB,EAC/D,aAAa,EAAE,CAAC,EAChB,KAAK,EAAE,OAAO,EACd,oBAAoB,EAAE,IAAI,CACxB,8BAA8B,EAC9B,qBAAqB,CACtB,GACA,oBAAoB,CAAC,CAAC,CAAC,CAsHzB"}

package/dist/references/fix-ref-deletions.js

@@ -1,18 +1,18 @@
 import { sortBy } from 'es-toolkit';
 import { get, groupBy, set } from 'es-toolkit/compat';
-import { parseSchemaWithReferences } from './parse-schema-with-references.js';
+import { parseSchemaWithTransformedReferences } from './parse-schema-with-references.js';
 // sentinel ID to signify the reference has been flagged for deletion
 const DELETED_SENTINEL_ID = 'deleted-sentinel-id';
 /**
  * Fixes any reference deletions by performing the appropriate action for the reference
  */
-export function fixRefDeletions(schema, value) {
+export function fixRefDeletions(schemaCreator, value, schemaCreatorOptions) {
     const issues = [];
     // find all references that do not have a corresponding entity
     let iterations;
     let valueToEdit = value;
     for (iterations = 0; iterations < 100; iterations++) {
-        const parseResult = parseSchemaWithReferences(schema, valueToEdit, {
+        const parseResult = parseSchemaWithTransformedReferences(schemaCreator, valueToEdit, schemaCreatorOptions, {
             allowInvalidReferences: true,
         });
         const { references, entities } = parseResult;
@@ -55,8 +55,16 @@ export function fixRefDeletions(schema, value) {
         for (const ref of referencesMissingEntity) {
             const id = get(valueToEdit, ref.path);
             switch (ref.onDelete) {
-                case 'SET_NULL': {
-                    set(valueToEdit, ref.path, null);
+                case 'SET_UNDEFINED': {
+                    // Check if reference is inside an array
+                    if (ref.path.length > 0) {
+                        const parentPath = ref.path.slice(0, -1);
+                        const parent = get(valueToEdit, parentPath);
+                        if (Array.isArray(parent)) {
+                            throw new TypeError(`SET_UNDEFINED cannot be used for references inside arrays at path ${ref.path.join('.')}. Use DELETE instead to remove the array element.`);
+                        }
+                    }
+                    set(valueToEdit, ref.path, undefined);
                     break;
                 }
                 case 'RESTRICT': {