@wildo-ai/saas-models 1.0.1

package/dist/esm/resources/utils/schema-family-builder.utils.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Schema Family Builder - Simplifies Inheritance Configuration
+ *
+ * Provides a builder pattern for creating discriminated union schemas with
+ * automatic generation of inheritance configuration.
+ *
+ * @see Section 19 of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md
+ */
+import { z } from 'zod';
+import { ResourceConfiguration_InheritanceSchemaDefinition } from '../resources-config.shared.schemas.js';
+/**
+ * EnumLike type for discriminator values
+ */
+export type EnumLikeType = Record<string, string>;
+/**
+ * Variant configuration - can include nested variants for multi-level inheritance
+ */
+export interface VariantConfig<TExtend extends z.ZodObject<z.ZodRawShape>> {
+    /** Fields to add to base schema for this variant */
+    extend: TExtend;
+    /**
+     * Nested variants - for multi-level discriminated unions
+     * Example: RECURRING -> { DAILY: {...}, WEEKLY: {...} }
+     */
+    nestedVariants?: {
+        discriminator: {
+            field: string;
+            baseValues?: string[];
+        };
+        variants: Record<string, VariantConfig<z.ZodObject<z.ZodRawShape>>>;
+    };
+}
+/**
+ * Configuration for creating a schema family
+ */
+export interface SchemaFamilyConfig<TBase extends z.ZodObject<z.ZodRawShape>, TDiscriminatorField extends string, TVariants extends Record<string, VariantConfig<z.ZodObject<z.ZodRawShape>>>> {
+    /** Base schema with all common fields */
+    base: TBase;
+    /** Discriminator configuration */
+    discriminator: {
+        /** Field name used for discrimination */
+        field: TDiscriminatorField;
+        /**
+         * Values that use base schema only (no variant extension)
+         * If not provided, auto-detected from enum values not in variants
+         */
+        baseValues?: string[];
+    };
+    /** Variant schemas keyed by discriminator value */
+    variants: TVariants;
+}
+/**
+ * Result of creating a schema family
+ */
+export interface SchemaFamily<TBase extends z.ZodObject<z.ZodRawShape>, TDiscriminatorField extends string, TVariants extends Record<string, VariantConfig<z.ZodObject<z.ZodRawShape>>>> {
+    /** Base schema */
+    base: TBase;
+    /** Discriminator field name */
+    discriminatorField: TDiscriminatorField;
+    /** Values that don't have extended variants */
+    baseValues: string[];
+    /** Extended variant schemas (base merged with variant extension) */
+    variants: {
+        [K in keyof TVariants]: z.ZodObject<z.ZodRawShape>;
+    };
+    /** Zod discriminated union of all variants */
+    union: z.ZodTypeAny;
+    /** Auto-generated inheritenceSchemaDefinition for resource config */
+    inheritenceSchemaDefinition: ResourceConfiguration_InheritanceSchemaDefinition<EnumLikeType, TBase>;
+}
+/**
+ * Creates a schema family with automatic inheritance configuration generation.
+ *
+ * @example
+ * ```typescript
+ * const TodosSchemaFamily = createSchemaFamily({
+ *   base: z.object({
+ *     _id: z.string().isDBIndexed(),
+ *     title: z.string().isSummaryField(),
+ *     recurringType: z.enum(['ONE_TIME', 'RECURRING']),
+ *   }),
+ *   discriminator: {
+ *     field: 'recurringType',
+ *     baseValues: ['ONE_TIME'],
+ *   },
+ *   variants: {
+ *     RECURRING: {
+ *       extend: z.object({
+ *         recurrence: z.enum(['DAILY', 'WEEKLY']),
+ *       }),
+ *     },
+ *   },
+ * });
+ * ```
+ */
+export declare function createSchemaFamily<TBase extends z.ZodObject<z.ZodRawShape>, TDiscriminatorField extends string, TVariants extends Record<string, VariantConfig<z.ZodObject<z.ZodRawShape>>>>(config: SchemaFamilyConfig<TBase, TDiscriminatorField, TVariants>): SchemaFamily<TBase, TDiscriminatorField, TVariants>;
+//# sourceMappingURL=schema-family-builder.utils.d.ts.map

package/dist/esm/resources/utils/schema-family-builder.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-family-builder.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/schema-family-builder.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EACL,iDAAiD,EAElD,MAAM,oCAAoC,CAAC;AAO5C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;IACvE,oDAAoD;IACpD,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,cAAc,CAAC,EAAE;QACf,aAAa,EAAE;YACb,KAAK,EAAE,MAAM,CAAC;YACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;SACvB,CAAC;QACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;KACrE,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CACjC,KAAK,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EACxC,mBAAmB,SAAS,MAAM,EAClC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAE3E,yCAAyC;IACzC,IAAI,EAAE,KAAK,CAAC;IAEZ,kCAAkC;IAClC,aAAa,EAAE;QACb,yCAAyC;QACzC,KAAK,EAAE,mBAAmB,CAAC;QAC3B;;;WAGG;QACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;KACvB,CAAC;IAEF,mDAAmD;IACnD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY,CAC3B,KAAK,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EACxC,mBAAmB,SAAS,MAAM,EAClC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;IAE3E,kBAAkB;IAClB,IAAI,EAAE,KAAK,CAAC;IAEZ,+BAA+B;IAC/B,kBAAkB,EAAE,mBAAmB,CAAC;IAExC,+CAA+C;IAC/C,UAAU,EAAE,MAAM,EAAE,CAAC;IAErB,oEAAoE;IACpE,QAAQ,EAAE;SACP,CAAC,IAAI,MAAM,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC;KACnD,CAAC;IAEF,8CAA8C;IAC9C,KAAK,EAAE,CAAC,CAAC,UAAU,CAAC;IAEpB,qEAAqE;IACrE,2BAA2B,EAAE,iDAAiD,CAAC,YAAY,EAAE,KAAK,CAAC,CAAC;CACrG;AAiBD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EACxC,mBAAmB,SAAS,MAAM,EAClC,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAE3E,MAAM,EAAE,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,EAAE,SAAS,CAAC,GAChE,YAAY,CAAC,KAAK,EAAE,mBAAmB,EAAE,SAAS,CAAC,CAgHrD"}

package/dist/esm/resources/utils/schema-family-builder.utils.js

@@ -0,0 +1,202 @@
+/**
+ * Schema Family Builder - Simplifies Inheritance Configuration
+ *
+ * Provides a builder pattern for creating discriminated union schemas with
+ * automatic generation of inheritance configuration.
+ *
+ * @see Section 19 of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md
+ */
+import { z } from 'zod';
+import { getZodObjectShape, getEnumValues, addDiscriminator } from '@wildo-ai/zod-decorators';
+import { ErrorCustomMessageReference } from '../../errors/errors.custom-message-ref.shared.definitions.js';
+// =============================================================================
+// ERROR HELPER
+// =============================================================================
+/**
+ * Create a configuration error with context
+ */
+function createConfigError(ref, context) {
+    return new Error(`[SchemaFamily] ${ref}: ${JSON.stringify(context)}`);
+}
+// =============================================================================
+// MAIN BUILDER FUNCTION
+// =============================================================================
+/**
+ * Creates a schema family with automatic inheritance configuration generation.
+ *
+ * @example
+ * ```typescript
+ * const TodosSchemaFamily = createSchemaFamily({
+ *   base: z.object({
+ *     _id: z.string().isDBIndexed(),
+ *     title: z.string().isSummaryField(),
+ *     recurringType: z.enum(['ONE_TIME', 'RECURRING']),
+ *   }),
+ *   discriminator: {
+ *     field: 'recurringType',
+ *     baseValues: ['ONE_TIME'],
+ *   },
+ *   variants: {
+ *     RECURRING: {
+ *       extend: z.object({
+ *         recurrence: z.enum(['DAILY', 'WEEKLY']),
+ *       }),
+ *     },
+ *   },
+ * });
+ * ```
+ */
+export function createSchemaFamily(config) {
+    const { base, discriminator, variants } = config;
+    // Validation: Ensure discriminator field exists in base schema
+    const baseShape = getZodObjectShape(base);
+    if (!baseShape[discriminator.field]) {
+        throw createConfigError(ErrorCustomMessageReference.SCHEMA_FAMILY_INVALID_DISCRIMINATOR, {
+            discriminatorField: discriminator.field,
+            availableFields: Object.keys(baseShape)
+        });
+    }
+    // Auto-detect baseValues FIRST since we need it for the discriminator decorator
+    let resolvedBaseValues = discriminator.baseValues;
+    if (!resolvedBaseValues) {
+        const discriminatorSchema = baseShape[discriminator.field];
+        const allEnumValues = getEnumValues(discriminatorSchema);
+        const variantKeys = new Set(Object.keys(variants));
+        resolvedBaseValues = allEnumValues.filter(v => !variantKeys.has(v));
+    }
+    // Build extended variant schemas with support for nested inheritance
+    const extendedVariants = {};
+    const inheritedSchemas = [];
+    for (const [discriminatorValue, variantConfig] of Object.entries(variants)) {
+        // Extend base with variant extension (Zod 4 pattern - .merge() is deprecated)
+        // Also add the discriminator literal with isDiscriminator decorator
+        const extendedSchema = base.extend({
+            ...variantConfig.extend.shape,
+            [discriminator.field]: addDiscriminator(z.literal(discriminatorValue), { baseValues: resolvedBaseValues })
+        });
+        extendedVariants[discriminatorValue] = extendedSchema;
+        // Build inheritance config entry - use the extended schema with decorated discriminator
+        const inheritanceEntry = {
+            discriminatorFieldValue: discriminatorValue,
+            schema: extendedSchema,
+        };
+        // Handle nested variants (multi-level inheritance)
+        if (variantConfig.nestedVariants) {
+            inheritanceEntry.inheritenceSchemaDefinition = buildNestedInheritance(extendedSchema, variantConfig.nestedVariants, resolvedBaseValues);
+        }
+        inheritedSchemas.push(inheritanceEntry);
+    }
+    // Validation: Ensure all enum values are accounted for
+    validateAllValuesAccountedFor(discriminator.field, baseShape[discriminator.field], resolvedBaseValues, inheritedSchemas);
+    // Build discriminated union - use any to avoid Zod 4 type complexity
+    const allVariantSchemas = [];
+    // Add base schemas for baseValues
+    // Mark discriminator field with isDiscriminator decorator so it's distinguished from non-discriminator literals
+    for (const value of resolvedBaseValues || []) {
+        allVariantSchemas.push(base.extend({
+            [discriminator.field]: addDiscriminator(z.literal(value), { baseValues: resolvedBaseValues })
+        }));
+    }
+    // Add extended schemas for variants
+    // Mark discriminator field with isDiscriminator decorator so it's distinguished from non-discriminator literals
+    for (const [value, schema] of Object.entries(extendedVariants)) {
+        allVariantSchemas.push(schema.extend({
+            [discriminator.field]: addDiscriminator(z.literal(value), { baseValues: resolvedBaseValues })
+        }));
+    }
+    // Create the union (type as any to handle Zod 4 complexity)
+    let union;
+    if (allVariantSchemas.length >= 2) {
+        union = z.discriminatedUnion(discriminator.field, allVariantSchemas);
+    }
+    else if (allVariantSchemas.length === 1) {
+        union = allVariantSchemas[0];
+    }
+    else {
+        union = base;
+    }
+    return {
+        base,
+        discriminatorField: discriminator.field,
+        baseValues: resolvedBaseValues || [],
+        variants: extendedVariants,
+        union,
+        inheritenceSchemaDefinition: {
+            discriminatorField: discriminator.field,
+            withoutInheritanceDiscriminatorFieldValues: resolvedBaseValues,
+            inheritedSchemas,
+        },
+    };
+}
+// =============================================================================
+// HELPER FUNCTIONS
+// =============================================================================
+/**
+ * Recursively build nested inheritance configuration for multi-level discriminated unions.
+ *
+ * @param parentSchema - The parent schema to extend
+ * @param nestedConfig - The nested variants configuration
+ * @param parentBaseValues - Base values from parent level (for discriminator decorator context)
+ */
+function buildNestedInheritance(parentSchema, nestedConfig, parentBaseValues) {
+    const inheritedSchemas = [];
+    // Resolve base values for this nested level
+    const nestedBaseValues = nestedConfig.discriminator.baseValues || [];
+    for (const [discriminatorValue, variantConfig] of Object.entries(nestedConfig.variants)) {
+        // Extend parent with variant extension AND add discriminator literal with decorator
+        const extendedSchema = parentSchema.extend({
+            ...variantConfig.extend.shape,
+            [nestedConfig.discriminator.field]: addDiscriminator(z.literal(discriminatorValue), { baseValues: nestedBaseValues })
+        });
+        const entry = {
+            discriminatorFieldValue: discriminatorValue,
+            schema: extendedSchema,
+        };
+        // Recurse for deeper nesting
+        if (variantConfig.nestedVariants) {
+            entry.inheritenceSchemaDefinition = buildNestedInheritance(extendedSchema, variantConfig.nestedVariants, nestedBaseValues);
+        }
+        inheritedSchemas.push(entry);
+    }
+    return {
+        discriminatorField: nestedConfig.discriminator.field,
+        withoutInheritanceDiscriminatorFieldValues: nestedConfig.discriminator.baseValues,
+        inheritedSchemas,
+    };
+}
+/**
+ * Validate that all discriminator enum values are accounted for.
+ * Throws Error if values are missing or duplicated.
+ */
+function validateAllValuesAccountedFor(discriminatorField, discriminatorSchema, baseValues, inheritedSchemas) {
+    const allEnumValues = getEnumValues(discriminatorSchema);
+    if (allEnumValues.length === 0) {
+        // Not an enum field, skip validation
+        return;
+    }
+    const accountedValues = new Set([
+        ...baseValues,
+        ...inheritedSchemas.map(s => s.discriminatorFieldValue)
+    ]);
+    const unaccountedValues = allEnumValues.filter(v => !accountedValues.has(v));
+    if (unaccountedValues.length > 0) {
+        throw createConfigError(ErrorCustomMessageReference.SCHEMA_FAMILY_UNACCOUNTED_VALUES, {
+            discriminatorField,
+            unaccountedValues,
+            hint: 'Add these values to either baseValues or variants'
+        });
+    }
+    // Check for values in both baseValues and inheritedSchemas (contradiction)
+    const baseValuesSet = new Set(baseValues);
+    const duplicates = inheritedSchemas
+        .filter(s => baseValuesSet.has(s.discriminatorFieldValue))
+        .map(s => s.discriminatorFieldValue);
+    if (duplicates.length > 0) {
+        throw createConfigError(ErrorCustomMessageReference.SCHEMA_FAMILY_DUPLICATE_VALUES, {
+            discriminatorField,
+            duplicateValues: duplicates,
+            hint: 'A value cannot be both a baseValue and have a variant schema'
+        });
+    }
+}
+//# sourceMappingURL=schema-family-builder.utils.js.map

package/dist/esm/resources/utils/schema-family-builder.utils.js.map

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

package/dist/esm/resources/utils/schema-type-inference.utils.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Schema Type Inference Utilities
+ *
+ * Centralized type utilities for Zod schema inference.
+ * Using type aliases instead of direct z.infer<T> improves TypeScript's
+ * type caching and reduces memory usage during compilation.
+ *
+ * @see TYPING_OPTIMIZATION_PLAN.md
+ */
+import { z } from 'zod';
+/**
+ * Type alias for inferring Zod schema types.
+ * TypeScript caches this more efficiently than direct z.infer<T> usage.
+ */
+export type SchemaInfer<T extends z.ZodTypeAny> = z.infer<T>;
+/**
+ * Type alias specifically for main schema inference.
+ * Used in resource configuration function parameters.
+ */
+export type MainSchemaInfer<T extends z.ZodTypeAny> = z.infer<T>;
+/**
+ * Type alias for array schema inference.
+ * Used in paginated responses and list operations.
+ */
+export type SchemaArrayInfer<T extends z.ZodTypeAny> = z.infer<T>[];
+//# sourceMappingURL=schema-type-inference.utils.d.ts.map

package/dist/esm/resources/utils/schema-type-inference.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-type-inference.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/schema-type-inference.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAE7D;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEjE;;;GAGG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC"}

package/dist/esm/resources/utils/schema-type-inference.utils.js

@@ -0,0 +1,10 @@
+/**
+ * Schema Type Inference Utilities
+ *
+ * Centralized type utilities for Zod schema inference.
+ * Using type aliases instead of direct z.infer<T> improves TypeScript's
+ * type caching and reduces memory usage during compilation.
+ *
+ * @see TYPING_OPTIMIZATION_PLAN.md
+ */
+//# sourceMappingURL=schema-type-inference.utils.js.map

package/dist/esm/resources/utils/schema-type-inference.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-type-inference.utils.js","sourceRoot":"","sources":["../../../../src/resources/utils/schema-type-inference.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/esm/resources/utils/schema-type-utils.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Schema Type Utilities
+ *
+ * TypeScript utility types for working with decorated schemas,
+ * particularly for virtual field type inference.
+ *
+ * @see Section 23.3.B of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md
+ */
+import { z } from 'zod';
+import { ZodDecorator } from '@wildo-ai/zod-decorators';
+import { SchemaInfer } from './schema-type-inference.utils.js';
+/**
+ * Schema type including virtual fields.
+ * This is the complete inferred type from the schema.
+ * Virtual fields are computed at runtime by VirtualFieldsBackendService.
+ */
+export type WithVirtualFields<TSchema extends z.ZodTypeAny> = SchemaInfer<TSchema>;
+/**
+ * Schema type as it appears in API responses (after stripping backend-only fields).
+ */
+export type ApiResponseType<TSchema extends z.ZodTypeAny> = SchemaInfer<TSchema>;
+/**
+ * Get all virtual field names from a schema at runtime.
+ *
+ * @param schema - The Zod schema to analyze
+ * @returns Array of field names that have the `isVirtual` decorator
+ *
+ * @example
+ * ```typescript
+ * const TodoSchema = z.object({
+ *   title: z.string(),
+ *   displayName: z.string().isVirtual({ calculate: ... }),
+ * });
+ *
+ * const virtualFields = getVirtualFieldNames(TodoSchema);
+ * // ['displayName']
+ * ```
+ */
+export declare function getVirtualFieldNames(schema: z.ZodTypeAny): string[];
+/**
+ * Get all field names with a specific decorator.
+ *
+ * @param schema - The Zod schema to analyze
+ * @param decorator - The decorator to check for
+ * @returns Array of field names that have the specified decorator
+ */
+export declare function getFieldNamesWithDecorator(schema: z.ZodTypeAny, decorator: ZodDecorator): string[];
+/**
+ * Check if a schema has any virtual fields.
+ */
+export declare function hasVirtualFields(schema: z.ZodTypeAny): boolean;
+/**
+ * Get the count of virtual fields in a schema.
+ */
+export declare function countVirtualFields(schema: z.ZodTypeAny): number;
+//# sourceMappingURL=schema-type-utils.d.ts.map

package/dist/esm/resources/utils/schema-type-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-type-utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/schema-type-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAIL,YAAY,EACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAM5D;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;AAEnF;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;AAMjF;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,EAAE,CAgBnE;AAED;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,SAAS,EAAE,YAAY,GACtB,MAAM,EAAE,CAkBV;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,OAAO,CAE9D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,GAAG,MAAM,CAE/D"}

package/dist/esm/resources/utils/schema-type-utils.js

@@ -0,0 +1,81 @@
+/**
+ * Schema Type Utilities
+ *
+ * TypeScript utility types for working with decorated schemas,
+ * particularly for virtual field type inference.
+ *
+ * @see Section 23.3.B of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md
+ */
+import { getZodObjectShape, isVirtualField, getFieldMetadataRecursive } from '@wildo-ai/zod-decorators';
+// =============================================================================
+// RUNTIME FUNCTIONS
+// =============================================================================
+/**
+ * Get all virtual field names from a schema at runtime.
+ *
+ * @param schema - The Zod schema to analyze
+ * @returns Array of field names that have the `isVirtual` decorator
+ *
+ * @example
+ * ```typescript
+ * const TodoSchema = z.object({
+ *   title: z.string(),
+ *   displayName: z.string().isVirtual({ calculate: ... }),
+ * });
+ *
+ * const virtualFields = getVirtualFieldNames(TodoSchema);
+ * // ['displayName']
+ * ```
+ */
+export function getVirtualFieldNames(schema) {
+    const result = [];
+    try {
+        const shape = getZodObjectShape(schema);
+        for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+            if (isVirtualField(fieldSchema)) {
+                result.push(fieldName);
+            }
+        }
+    }
+    catch {
+        // Schema may not be an object
+    }
+    return result;
+}
+/**
+ * Get all field names with a specific decorator.
+ *
+ * @param schema - The Zod schema to analyze
+ * @param decorator - The decorator to check for
+ * @returns Array of field names that have the specified decorator
+ */
+export function getFieldNamesWithDecorator(schema, decorator) {
+    const result = [];
+    try {
+        const shape = getZodObjectShape(schema);
+        for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+            // Use recursive lookup to find metadata through wrapper types (ZodOptional, etc.)
+            const metadata = getFieldMetadataRecursive(fieldSchema);
+            if (metadata && metadata[decorator] !== undefined) {
+                result.push(fieldName);
+            }
+        }
+    }
+    catch {
+        // Schema may not be an object
+    }
+    return result;
+}
+/**
+ * Check if a schema has any virtual fields.
+ */
+export function hasVirtualFields(schema) {
+    return getVirtualFieldNames(schema).length > 0;
+}
+/**
+ * Get the count of virtual fields in a schema.
+ */
+export function countVirtualFields(schema) {
+    return getVirtualFieldNames(schema).length;
+}
+//# sourceMappingURL=schema-type-utils.js.map

package/dist/esm/resources/utils/schema-type-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-type-utils.js","sourceRoot":"","sources":["../../../../src/resources/utils/schema-type-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EACL,iBAAiB,EACjB,cAAc,EACd,yBAAyB,EAE1B,MAAM,0BAA0B,CAAC;AAmBlC,gFAAgF;AAChF,oBAAoB;AACpB,gFAAgF;AAEhF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAExC,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,IAAI,cAAc,CAAC,WAA2B,CAAC,EAAE,CAAC;gBAChD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,0BAA0B,CACxC,MAAoB,EACpB,SAAuB;IAEvB,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAExC,KAAK,MAAM,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7D,kFAAkF;YAClF,MAAM,QAAQ,GAAG,yBAAyB,CAAC,WAA2B,CAAC,CAAC;YACxE,IAAI,QAAQ,IAAI,QAAQ,CAAC,SAAS,CAAC,KAAK,SAAS,EAAE,CAAC;gBAClD,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8BAA8B;IAChC,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAoB;IACnD,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,OAAO,oBAAoB,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC;AAC7C,CAAC"}

package/dist/esm/resources/utils/schema-variant-resolver.utils.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Schema Variant Resolver Utilities
+ *
+ * Resolves the correct schema variant for an object based on discriminator values.
+ * Used at runtime to get the variant-specific schema for virtual field computation,
+ * backend-only field stripping, and summary derivation.
+ *
+ * @see Section 19 of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md
+ */
+import { z } from 'zod';
+import { ResourceConfiguration_InheritanceSchemaDefinition } from '../resources-config.shared.schemas.js';
+/**
+ * Resolve the correct schema for an object based on inheritance discriminators.
+ *
+ * @param mainSchema - The base/main schema
+ * @param inheritanceDefinition - The inheritance schema definition (optional)
+ * @param object - The data object to inspect for discriminator values
+ * @returns The correct schema variant for the object
+ *
+ * @example
+ * ```typescript
+ * const config = registry.getResourceConfiguration(resourceType);
+ * const effectiveSchema = resolveSchemaForObject(
+ *   config.mainSchema,
+ *   config.inheritenceSchemaDefinition,
+ *   data
+ * );
+ * // effectiveSchema is now the variant-specific schema if applicable
+ * ```
+ */
+export declare function resolveSchemaForObject<T extends Record<string, any>>(mainSchema: z.ZodTypeAny, inheritanceDefinition: ResourceConfiguration_InheritanceSchemaDefinition<any, any> | undefined, object: T): z.ZodTypeAny;
+/**
+ * Check if an object matches a specific inheritance variant.
+ *
+ * @param inheritanceDefinition - The inheritance schema definition
+ * @param object - The data object to check
+ * @param targetVariantValue - The discriminator value to check for
+ * @returns True if the object is of the specified variant
+ */
+export declare function isObjectOfVariant<T extends Record<string, any>>(inheritanceDefinition: ResourceConfiguration_InheritanceSchemaDefinition<any, any> | undefined, object: T, targetVariantValue: string): boolean;
+/**
+ * Get all variant schemas including the base schema.
+ *
+ * @param mainSchema - The base/main schema
+ * @param inheritanceDefinition - The inheritance schema definition
+ * @returns Map of discriminator value to schema
+ */
+export declare function getAllVariantSchemas(mainSchema: z.ZodTypeAny, inheritanceDefinition: ResourceConfiguration_InheritanceSchemaDefinition<any, any> | undefined): Map<string | null, z.ZodTypeAny>;
+//# sourceMappingURL=schema-variant-resolver.utils.d.ts.map

package/dist/esm/resources/utils/schema-variant-resolver.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-variant-resolver.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/schema-variant-resolver.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,iDAAiD,EAAE,MAAM,oCAAoC,CAAC;AAEvG;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAClE,UAAU,EAAE,CAAC,CAAC,UAAU,EACxB,qBAAqB,EAAE,iDAAiD,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,EAC9F,MAAM,EAAE,CAAC,GACR,CAAC,CAAC,UAAU,CA2Cd;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC7D,qBAAqB,EAAE,iDAAiD,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,EAC9F,MAAM,EAAE,CAAC,EACT,kBAAkB,EAAE,MAAM,GACzB,OAAO,CAST;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,CAAC,CAAC,UAAU,EACxB,qBAAqB,EAAE,iDAAiD,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,SAAS,GAC7F,GAAG,CAAC,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC,UAAU,CAAC,CAgBlC"}

package/dist/esm/resources/utils/schema-variant-resolver.utils.js

@@ -0,0 +1,99 @@
+/**
+ * Schema Variant Resolver Utilities
+ *
+ * Resolves the correct schema variant for an object based on discriminator values.
+ * Used at runtime to get the variant-specific schema for virtual field computation,
+ * backend-only field stripping, and summary derivation.
+ *
+ * @see Section 19 of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md
+ */
+/**
+ * Resolve the correct schema for an object based on inheritance discriminators.
+ *
+ * @param mainSchema - The base/main schema
+ * @param inheritanceDefinition - The inheritance schema definition (optional)
+ * @param object - The data object to inspect for discriminator values
+ * @returns The correct schema variant for the object
+ *
+ * @example
+ * ```typescript
+ * const config = registry.getResourceConfiguration(resourceType);
+ * const effectiveSchema = resolveSchemaForObject(
+ *   config.mainSchema,
+ *   config.inheritenceSchemaDefinition,
+ *   data
+ * );
+ * // effectiveSchema is now the variant-specific schema if applicable
+ * ```
+ */
+export function resolveSchemaForObject(mainSchema, inheritanceDefinition, object) {
+    // No inheritance - return main schema
+    if (!inheritanceDefinition) {
+        return mainSchema;
+    }
+    // No inherited schemas - return main schema
+    if (!inheritanceDefinition.inheritedSchemas || inheritanceDefinition.inheritedSchemas.length === 0) {
+        return mainSchema;
+    }
+    // Get discriminator value from object
+    const discriminatorField = inheritanceDefinition.discriminatorField;
+    const discriminatorValue = object[discriminatorField];
+    // No discriminator value in object - return main schema
+    if (discriminatorValue === undefined || discriminatorValue === null) {
+        return mainSchema;
+    }
+    // Check if value is a base (non-inherited) value
+    const baseValues = inheritanceDefinition.withoutInheritanceDiscriminatorFieldValues || [];
+    if (baseValues.includes(discriminatorValue)) {
+        return mainSchema;
+    }
+    // Find the matching inherited schema
+    for (const inherited of inheritanceDefinition.inheritedSchemas) {
+        if (inherited.discriminatorFieldValue === discriminatorValue) {
+            // Recursively resolve if nested inheritance exists
+            if (inherited.inheritenceSchemaDefinition) {
+                return resolveSchemaForObject(inherited.schema, inherited.inheritenceSchemaDefinition, object);
+            }
+            return inherited.schema;
+        }
+    }
+    // No matching variant found - return main schema as fallback
+    return mainSchema;
+}
+/**
+ * Check if an object matches a specific inheritance variant.
+ *
+ * @param inheritanceDefinition - The inheritance schema definition
+ * @param object - The data object to check
+ * @param targetVariantValue - The discriminator value to check for
+ * @returns True if the object is of the specified variant
+ */
+export function isObjectOfVariant(inheritanceDefinition, object, targetVariantValue) {
+    if (!inheritanceDefinition) {
+        return false;
+    }
+    const discriminatorField = inheritanceDefinition.discriminatorField;
+    const discriminatorValue = object[discriminatorField];
+    return discriminatorValue === targetVariantValue;
+}
+/**
+ * Get all variant schemas including the base schema.
+ *
+ * @param mainSchema - The base/main schema
+ * @param inheritanceDefinition - The inheritance schema definition
+ * @returns Map of discriminator value to schema
+ */
+export function getAllVariantSchemas(mainSchema, inheritanceDefinition) {
+    const result = new Map();
+    // Base schema for non-inherited values (null key represents base)
+    result.set(null, mainSchema);
+    if (!inheritanceDefinition || !inheritanceDefinition.inheritedSchemas) {
+        return result;
+    }
+    // Add each inherited variant
+    for (const inherited of inheritanceDefinition.inheritedSchemas) {
+        result.set(inherited.discriminatorFieldValue, inherited.schema);
+    }
+    return result;
+}
+//# sourceMappingURL=schema-variant-resolver.utils.js.map