@wildo-ai/saas-models 1.0.1 → 1.1.0

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

@@ -7,7 +7,7 @@
  * @see Section 19 of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md
  */
 import { z } from 'zod';
-import { ResourceConfiguration_InheritanceSchemaDefinition } from '../resources-config.shared.schemas.js';
+import { ResourceConfiguration_InheritanceSchemaDefinition } from '../resources-config.shared.schemas';
 /**
  * EnumLike type for discriminator values
  */
@@ -31,7 +31,14 @@ export interface VariantConfig<TExtend extends z.ZodObject<z.ZodRawShape>> {
     };
 }
 /**
- * Configuration for creating a schema family
+ * @wildo_source:part:start saas.models.schema-family-builder facet:layer:shared facet:family:schema-family
+ *
+ * Configuration for creating a schema family.
+ *
+ * Import path for application code: `@wildo-ai/saas-models`.
+ *
+ * Use this when one resource keeps a shared base schema plus one or more
+ * discriminator-driven variants.
  */
 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 */
@@ -50,7 +57,13 @@ export interface SchemaFamilyConfig<TBase extends z.ZodObject<z.ZodRawShape>, TD
     variants: TVariants;
 }
 /**
- * Result of creating a schema family
+ * Result of creating a schema family.
+ *
+ * Import path for application code: `@wildo-ai/saas-models`.
+ *
+ * The returned object exposes the shared base schema, each extended variant,
+ * the discriminated union, and the generated inheritance metadata used by the
+ * wider resource/config system.
  */
 export interface SchemaFamily<TBase extends z.ZodObject<z.ZodRawShape>, TDiscriminatorField extends string, TVariants extends Record<string, VariantConfig<z.ZodObject<z.ZodRawShape>>>> {
     /** Base schema */
@@ -71,6 +84,11 @@ export interface SchemaFamily<TBase extends z.ZodObject<z.ZodRawShape>, TDiscrim
 /**
  * Creates a schema family with automatic inheritance configuration generation.
  *
+ * Import path for application code: `@wildo-ai/saas-models`.
+ *
+ * Use this when a discriminator field on the base schema decides which
+ * variant-only extension fields are valid.
+ *
  * @example
  * ```typescript
  * const TodosSchemaFamily = createSchemaFamily({

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

@@ -1 +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"}
+{"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;;;;;;;;;GASG;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;;;;;;;;GAQG;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;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

@@ -24,6 +24,11 @@ function createConfigError(ref, context) {
 /**
  * Creates a schema family with automatic inheritance configuration generation.
  *
+ * Import path for application code: `@wildo-ai/saas-models`.
+ *
+ * Use this when a discriminator field on the base schema decides which
+ * variant-only extension fields are valid.
+ *
  * @example
  * ```typescript
  * const TodosSchemaFamily = createSchemaFamily({
@@ -128,6 +133,7 @@ export function createSchemaFamily(config) {
         },
     };
 }
+/** @wildo_source:part:end saas.models.schema-family-builder */
 // =============================================================================
 // HELPER FUNCTIONS
 // =============================================================================
@@ -199,4 +205,4 @@ function validateAllValuesAccountedFor(discriminatorField, discriminatorSchema,
         });
     }
 }
-//# sourceMappingURL=schema-family-builder.utils.js.map
+//# sourceMappingURL=schema-family-builder.utils.js.map

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

@@ -1 +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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"}
+{"version":3,"file":"schema-family-builder.utils.js","sourceRoot":"","sources":["../../../../../src/resources/utils/schema-family-builder.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Schema Family Builder - Simplifies Inheritance Configuration\n *\n * Provides a builder pattern for creating discriminated union schemas with\n * automatic generation of inheritance configuration.\n *\n * @see Section 19 of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md\n */\n\nimport { z } from 'zod';\nimport { getZodObjectShape, getEnumValues, addDiscriminator } from '@wildo-ai/zod-decorators';\nimport {\n  ResourceConfiguration_InheritanceSchemaDefinition,\n  ResourceConfiguration_InheritanceItemSchemaDefinition\n} from '../resources-config.shared.schemas';\nimport { ErrorCustomMessageReference } from '../../errors/errors.custom-message-ref.shared.definitions';\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\n/**\n * EnumLike type for discriminator values\n */\nexport type EnumLikeType = Record<string, string>;\n\n/**\n * Variant configuration - can include nested variants for multi-level inheritance\n */\nexport interface VariantConfig<TExtend extends z.ZodObject<z.ZodRawShape>> {\n  /** Fields to add to base schema for this variant */\n  extend: TExtend;\n\n  /**\n   * Nested variants - for multi-level discriminated unions\n   * Example: RECURRING -> { DAILY: {...}, WEEKLY: {...} }\n   */\n  nestedVariants?: {\n    discriminator: {\n      field: string;\n      baseValues?: string[];\n    };\n    variants: Record<string, VariantConfig<z.ZodObject<z.ZodRawShape>>>;\n  };\n}\n\n/**\n * @wildo_source:part:start saas.models.schema-family-builder facet:layer:shared facet:family:schema-family\n *\n * Configuration for creating a schema family.\n *\n * Import path for application code: `@wildo-ai/saas-models`.\n *\n * Use this when one resource keeps a shared base schema plus one or more\n * discriminator-driven variants.\n */\nexport interface SchemaFamilyConfig<\n  TBase extends z.ZodObject<z.ZodRawShape>,\n  TDiscriminatorField extends string,\n  TVariants extends Record<string, VariantConfig<z.ZodObject<z.ZodRawShape>>>\n> {\n  /** Base schema with all common fields */\n  base: TBase;\n\n  /** Discriminator configuration */\n  discriminator: {\n    /** Field name used for discrimination */\n    field: TDiscriminatorField;\n    /**\n     * Values that use base schema only (no variant extension)\n     * If not provided, auto-detected from enum values not in variants\n     */\n    baseValues?: string[];\n  };\n\n  /** Variant schemas keyed by discriminator value */\n  variants: TVariants;\n}\n\n/**\n * Result of creating a schema family.\n *\n * Import path for application code: `@wildo-ai/saas-models`.\n *\n * The returned object exposes the shared base schema, each extended variant,\n * the discriminated union, and the generated inheritance metadata used by the\n * wider resource/config system.\n */\nexport interface SchemaFamily<\n  TBase extends z.ZodObject<z.ZodRawShape>,\n  TDiscriminatorField extends string,\n  TVariants extends Record<string, VariantConfig<z.ZodObject<z.ZodRawShape>>>\n> {\n  /** Base schema */\n  base: TBase;\n\n  /** Discriminator field name */\n  discriminatorField: TDiscriminatorField;\n\n  /** Values that don't have extended variants */\n  baseValues: string[];\n\n  /** Extended variant schemas (base merged with variant extension) */\n  variants: {\n    [K in keyof TVariants]: z.ZodObject<z.ZodRawShape>;\n  };\n\n  /** Zod discriminated union of all variants */\n  union: z.ZodTypeAny;\n\n  /** Auto-generated inheritenceSchemaDefinition for resource config */\n  inheritenceSchemaDefinition: ResourceConfiguration_InheritanceSchemaDefinition<EnumLikeType, TBase>;\n}\n\n// =============================================================================\n// ERROR HELPER\n// =============================================================================\n\n/**\n * Create a configuration error with context\n */\nfunction createConfigError(ref: ErrorCustomMessageReference, context: Record<string, unknown>): Error {\n  return new Error(`[SchemaFamily] ${ref}: ${JSON.stringify(context)}`);\n}\n\n// =============================================================================\n// MAIN BUILDER FUNCTION\n// =============================================================================\n\n/**\n * Creates a schema family with automatic inheritance configuration generation.\n *\n * Import path for application code: `@wildo-ai/saas-models`.\n *\n * Use this when a discriminator field on the base schema decides which\n * variant-only extension fields are valid.\n *\n * @example\n * ```typescript\n * const TodosSchemaFamily = createSchemaFamily({\n *   base: z.object({\n *     _id: z.string().isDBIndexed(),\n *     title: z.string().isSummaryField(),\n *     recurringType: z.enum(['ONE_TIME', 'RECURRING']),\n *   }),\n *   discriminator: {\n *     field: 'recurringType',\n *     baseValues: ['ONE_TIME'],\n *   },\n *   variants: {\n *     RECURRING: {\n *       extend: z.object({\n *         recurrence: z.enum(['DAILY', 'WEEKLY']),\n *       }),\n *     },\n *   },\n * });\n * ```\n */\nexport function createSchemaFamily<\n  TBase extends z.ZodObject<z.ZodRawShape>,\n  TDiscriminatorField extends string,\n  TVariants extends Record<string, VariantConfig<z.ZodObject<z.ZodRawShape>>>\n>(\n  config: SchemaFamilyConfig<TBase, TDiscriminatorField, TVariants>\n): SchemaFamily<TBase, TDiscriminatorField, TVariants> {\n\n  const { base, discriminator, variants } = config;\n\n  // Validation: Ensure discriminator field exists in base schema\n  const baseShape = getZodObjectShape(base);\n  if (!baseShape[discriminator.field]) {\n    throw createConfigError(\n      ErrorCustomMessageReference.SCHEMA_FAMILY_INVALID_DISCRIMINATOR,\n      {\n        discriminatorField: discriminator.field,\n        availableFields: Object.keys(baseShape)\n      }\n    );\n  }\n\n  // Auto-detect baseValues FIRST since we need it for the discriminator decorator\n  let resolvedBaseValues = discriminator.baseValues;\n  if (!resolvedBaseValues) {\n    const discriminatorSchema = baseShape[discriminator.field];\n    const allEnumValues = getEnumValues(discriminatorSchema);\n    const variantKeys = new Set(Object.keys(variants));\n    resolvedBaseValues = allEnumValues.filter(v => !variantKeys.has(v));\n  }\n\n  // Build extended variant schemas with support for nested inheritance\n  const extendedVariants: Record<string, z.ZodObject<z.ZodRawShape>> = {};\n  const inheritedSchemas: ResourceConfiguration_InheritanceItemSchemaDefinition<EnumLikeType, TBase>[] = [];\n\n  for (const [discriminatorValue, variantConfig] of Object.entries(variants)) {\n    // Extend base with variant extension (Zod 4 pattern - .merge() is deprecated)\n    // Also add the discriminator literal with isDiscriminator decorator\n    const extendedSchema = base.extend({\n      ...(variantConfig.extend as z.ZodObject<z.ZodRawShape>).shape,\n      [discriminator.field]: addDiscriminator(z.literal(discriminatorValue), { baseValues: resolvedBaseValues })\n    });\n    extendedVariants[discriminatorValue] = extendedSchema;\n\n    // Build inheritance config entry - use the extended schema with decorated discriminator\n    const inheritanceEntry: ResourceConfiguration_InheritanceItemSchemaDefinition<EnumLikeType, TBase> = {\n      discriminatorFieldValue: discriminatorValue,\n      schema: extendedSchema as TBase,\n    };\n\n    // Handle nested variants (multi-level inheritance)\n    if (variantConfig.nestedVariants) {\n      inheritanceEntry.inheritenceSchemaDefinition = buildNestedInheritance(\n        extendedSchema,\n        variantConfig.nestedVariants,\n        resolvedBaseValues\n      ) as ResourceConfiguration_InheritanceSchemaDefinition<EnumLikeType, TBase>;\n    }\n\n    inheritedSchemas.push(inheritanceEntry);\n  }\n\n  // Validation: Ensure all enum values are accounted for\n  validateAllValuesAccountedFor(\n    discriminator.field,\n    baseShape[discriminator.field],\n    resolvedBaseValues,\n    inheritedSchemas\n  );\n\n  // Build discriminated union - use any to avoid Zod 4 type complexity\n  const allVariantSchemas: z.ZodObject<z.ZodRawShape>[] = [];\n\n  // Add base schemas for baseValues\n  // Mark discriminator field with isDiscriminator decorator so it's distinguished from non-discriminator literals\n  for (const value of resolvedBaseValues || []) {\n    allVariantSchemas.push(\n      base.extend({\n        [discriminator.field]: addDiscriminator(z.literal(value), { baseValues: resolvedBaseValues })\n      }) as z.ZodObject<z.ZodRawShape>\n    );\n  }\n\n  // Add extended schemas for variants\n  // Mark discriminator field with isDiscriminator decorator so it's distinguished from non-discriminator literals\n  for (const [value, schema] of Object.entries(extendedVariants)) {\n    allVariantSchemas.push(\n      schema.extend({\n        [discriminator.field]: addDiscriminator(z.literal(value), { baseValues: resolvedBaseValues })\n      }) as z.ZodObject<z.ZodRawShape>\n    );\n  }\n\n  // Create the union (type as any to handle Zod 4 complexity)\n  let union: z.ZodTypeAny;\n  if (allVariantSchemas.length >= 2) {\n    union = z.discriminatedUnion(\n      discriminator.field,\n      allVariantSchemas as any\n    );\n  } else if (allVariantSchemas.length === 1) {\n    union = allVariantSchemas[0];\n  } else {\n    union = base;\n  }\n\n  return {\n    base,\n    discriminatorField: discriminator.field,\n    baseValues: resolvedBaseValues || [],\n    variants: extendedVariants as { [K in keyof TVariants]: z.ZodObject<z.ZodRawShape> },\n    union,\n    inheritenceSchemaDefinition: {\n      discriminatorField: discriminator.field,\n      withoutInheritanceDiscriminatorFieldValues: resolvedBaseValues,\n      inheritedSchemas,\n    },\n  };\n}\n/** @wildo_source:part:end saas.models.schema-family-builder */\n\n// =============================================================================\n// HELPER FUNCTIONS\n// =============================================================================\n\n/**\n * Recursively build nested inheritance configuration for multi-level discriminated unions.\n *\n * @param parentSchema - The parent schema to extend\n * @param nestedConfig - The nested variants configuration\n * @param parentBaseValues - Base values from parent level (for discriminator decorator context)\n */\nfunction buildNestedInheritance<TParent extends z.ZodObject<z.ZodRawShape>>(\n  parentSchema: TParent,\n  nestedConfig: NonNullable<VariantConfig<z.ZodObject<z.ZodRawShape>>['nestedVariants']>,\n  parentBaseValues?: string[]\n): ResourceConfiguration_InheritanceSchemaDefinition<EnumLikeType, TParent> {\n\n  const inheritedSchemas: ResourceConfiguration_InheritanceItemSchemaDefinition<EnumLikeType, TParent>[] = [];\n\n  // Resolve base values for this nested level\n  const nestedBaseValues = nestedConfig.discriminator.baseValues || [];\n\n  for (const [discriminatorValue, variantConfig] of Object.entries(nestedConfig.variants)) {\n    // Extend parent with variant extension AND add discriminator literal with decorator\n    const extendedSchema = parentSchema.extend({\n      ...variantConfig.extend.shape,\n      [nestedConfig.discriminator.field]: addDiscriminator(z.literal(discriminatorValue), { baseValues: nestedBaseValues })\n    });\n\n    const entry: ResourceConfiguration_InheritanceItemSchemaDefinition<EnumLikeType, TParent> = {\n      discriminatorFieldValue: discriminatorValue,\n      schema: extendedSchema as TParent,\n    };\n\n    // Recurse for deeper nesting\n    if (variantConfig.nestedVariants) {\n      entry.inheritenceSchemaDefinition = buildNestedInheritance(\n        extendedSchema,\n        variantConfig.nestedVariants,\n        nestedBaseValues\n      ) as ResourceConfiguration_InheritanceSchemaDefinition<EnumLikeType, TParent>;\n    }\n\n    inheritedSchemas.push(entry);\n  }\n\n  return {\n    discriminatorField: nestedConfig.discriminator.field,\n    withoutInheritanceDiscriminatorFieldValues: nestedConfig.discriminator.baseValues,\n    inheritedSchemas,\n  };\n}\n\n/**\n * Validate that all discriminator enum values are accounted for.\n * Throws Error if values are missing or duplicated.\n */\nfunction validateAllValuesAccountedFor(\n  discriminatorField: string,\n  discriminatorSchema: z.ZodTypeAny,\n  baseValues: string[],\n  inheritedSchemas: { discriminatorFieldValue: string }[]\n): void {\n\n  const allEnumValues = getEnumValues(discriminatorSchema);\n  if (allEnumValues.length === 0) {\n    // Not an enum field, skip validation\n    return;\n  }\n\n  const accountedValues = new Set([\n    ...baseValues,\n    ...inheritedSchemas.map(s => s.discriminatorFieldValue)\n  ]);\n\n  const unaccountedValues = allEnumValues.filter(v => !accountedValues.has(v));\n\n  if (unaccountedValues.length > 0) {\n    throw createConfigError(\n      ErrorCustomMessageReference.SCHEMA_FAMILY_UNACCOUNTED_VALUES,\n      {\n        discriminatorField,\n        unaccountedValues,\n        hint: 'Add these values to either baseValues or variants'\n      }\n    );\n  }\n\n  // Check for values in both baseValues and inheritedSchemas (contradiction)\n  const baseValuesSet = new Set(baseValues);\n  const duplicates = inheritedSchemas\n    .filter(s => baseValuesSet.has(s.discriminatorFieldValue))\n    .map(s => s.discriminatorFieldValue);\n\n  if (duplicates.length > 0) {\n    throw createConfigError(\n      ErrorCustomMessageReference.SCHEMA_FAMILY_DUPLICATE_VALUES,\n      {\n        discriminatorField,\n        duplicateValues: duplicates,\n        hint: 'A value cannot be both a baseValue and have a variant schema'\n      }\n    );\n  }\n}\n"]}

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

@@ -1 +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"}
+{"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

@@ -7,4 +7,4 @@
  *
  * @see TYPING_OPTIMIZATION_PLAN.md
  */
-//# sourceMappingURL=schema-type-inference.utils.js.map
+//# sourceMappingURL=schema-type-inference.utils.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema-type-inference.utils.js","sourceRoot":"","sources":["../../../../src/resources/utils/schema-type-inference.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}
+{"version":3,"file":"schema-type-inference.utils.js","sourceRoot":"","sources":["../../../../../src/resources/utils/schema-type-inference.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG","sourcesContent":["/**\n * Schema Type Inference Utilities\n * \n * Centralized type utilities for Zod schema inference.\n * Using type aliases instead of direct z.infer<T> improves TypeScript's\n * type caching and reduces memory usage during compilation.\n * \n * @see TYPING_OPTIMIZATION_PLAN.md\n */\n\nimport { z } from 'zod';\n\n/**\n * Type alias for inferring Zod schema types.\n * TypeScript caches this more efficiently than direct z.infer<T> usage.\n */\nexport type SchemaInfer<T extends z.ZodTypeAny> = z.infer<T>;\n\n/**\n * Type alias specifically for main schema inference.\n * Used in resource configuration function parameters.\n */\nexport type MainSchemaInfer<T extends z.ZodTypeAny> = z.infer<T>;\n\n/**\n * Type alias for array schema inference.\n * Used in paginated responses and list operations.\n */\nexport type SchemaArrayInfer<T extends z.ZodTypeAny> = z.infer<T>[];\n"]}

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

@@ -8,7 +8,7 @@
  */
 import { z } from 'zod';
 import { ZodDecorator } from '@wildo-ai/zod-decorators';
-import { SchemaInfer } from './schema-type-inference.utils.js';
+import { SchemaInfer } from './schema-type-inference.utils';
 /**
  * Schema type including virtual fields.
  * This is the complete inferred type from the schema.

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

@@ -1 +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"}
+{"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

@@ -78,4 +78,4 @@ export function hasVirtualFields(schema) {
 export function countVirtualFields(schema) {
     return getVirtualFieldNames(schema).length;
 }
-//# sourceMappingURL=schema-type-utils.js.map
+//# sourceMappingURL=schema-type-utils.js.map

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

@@ -1 +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"}
+{"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","sourcesContent":["/**\n * Schema Type Utilities\n * \n * TypeScript utility types for working with decorated schemas,\n * particularly for virtual field type inference.\n * \n * @see Section 23.3.B of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md\n */\n\nimport { z } from 'zod';\nimport { \n  getZodObjectShape, \n  isVirtualField, \n  getFieldMetadataRecursive,\n  ZodDecorator \n} from '@wildo-ai/zod-decorators';\nimport { SchemaInfer } from './schema-type-inference.utils';\n\n// =============================================================================\n// UTILITY TYPES\n// =============================================================================\n\n/**\n * Schema type including virtual fields.\n * This is the complete inferred type from the schema.\n * Virtual fields are computed at runtime by VirtualFieldsBackendService.\n */\nexport type WithVirtualFields<TSchema extends z.ZodTypeAny> = SchemaInfer<TSchema>;\n\n/**\n * Schema type as it appears in API responses (after stripping backend-only fields).\n */\nexport type ApiResponseType<TSchema extends z.ZodTypeAny> = SchemaInfer<TSchema>;\n\n// =============================================================================\n// RUNTIME FUNCTIONS\n// =============================================================================\n\n/**\n * Get all virtual field names from a schema at runtime.\n * \n * @param schema - The Zod schema to analyze\n * @returns Array of field names that have the `isVirtual` decorator\n * \n * @example\n * ```typescript\n * const TodoSchema = z.object({\n *   title: z.string(),\n *   displayName: z.string().isVirtual({ calculate: ... }),\n * });\n * \n * const virtualFields = getVirtualFieldNames(TodoSchema);\n * // ['displayName']\n * ```\n */\nexport function getVirtualFieldNames(schema: z.ZodTypeAny): string[] {\n  const result: string[] = [];\n  \n  try {\n    const shape = getZodObjectShape(schema);\n    \n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      if (isVirtualField(fieldSchema as z.ZodTypeAny)) {\n        result.push(fieldName);\n      }\n    }\n  } catch {\n    // Schema may not be an object\n  }\n\n  return result;\n}\n\n/**\n * Get all field names with a specific decorator.\n * \n * @param schema - The Zod schema to analyze\n * @param decorator - The decorator to check for\n * @returns Array of field names that have the specified decorator\n */\nexport function getFieldNamesWithDecorator(\n  schema: z.ZodTypeAny, \n  decorator: ZodDecorator\n): string[] {\n  const result: string[] = [];\n  \n  try {\n    const shape = getZodObjectShape(schema);\n    \n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      // Use recursive lookup to find metadata through wrapper types (ZodOptional, etc.)\n      const metadata = getFieldMetadataRecursive(fieldSchema as z.ZodTypeAny);\n      if (metadata && metadata[decorator] !== undefined) {\n        result.push(fieldName);\n      }\n    }\n  } catch {\n    // Schema may not be an object\n  }\n\n  return result;\n}\n\n/**\n * Check if a schema has any virtual fields.\n */\nexport function hasVirtualFields(schema: z.ZodTypeAny): boolean {\n  return getVirtualFieldNames(schema).length > 0;\n}\n\n/**\n * Get the count of virtual fields in a schema.\n */\nexport function countVirtualFields(schema: z.ZodTypeAny): number {\n  return getVirtualFieldNames(schema).length;\n}\n"]}

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

@@ -8,7 +8,7 @@
  * @see Section 19 of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md
  */
 import { z } from 'zod';
-import { ResourceConfiguration_InheritanceSchemaDefinition } from '../resources-config.shared.schemas.js';
+import { ResourceConfiguration_InheritanceSchemaDefinition } from '../resources-config.shared.schemas';
 /**
  * Resolve the correct schema for an object based on inheritance discriminators.
  *

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

@@ -1 +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"}
+{"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

@@ -96,4 +96,4 @@ export function getAllVariantSchemas(mainSchema, inheritanceDefinition) {
     }
     return result;
 }
-//# sourceMappingURL=schema-variant-resolver.utils.js.map
+//# sourceMappingURL=schema-variant-resolver.utils.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"schema-variant-resolver.utils.js","sourceRoot":"","sources":["../../../../src/resources/utils/schema-variant-resolver.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAwB,EACxB,qBAA8F,EAC9F,MAAS;IAET,sCAAsC;IACtC,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,qBAAqB,CAAC,gBAAgB,IAAI,qBAAqB,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnG,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,sCAAsC;IACtC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,kBAAkB,CAAC;IACpE,MAAM,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAEtD,wDAAwD;IACxD,IAAI,kBAAkB,KAAK,SAAS,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACpE,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,iDAAiD;IACjD,MAAM,UAAU,GAAG,qBAAqB,CAAC,0CAA0C,IAAI,EAAE,CAAC;IAC1F,IAAI,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC5C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,qCAAqC;IACrC,KAAK,MAAM,SAAS,IAAI,qBAAqB,CAAC,gBAAgB,EAAE,CAAC;QAC/D,IAAI,SAAS,CAAC,uBAAuB,KAAK,kBAAkB,EAAE,CAAC;YAC7D,mDAAmD;YACnD,IAAI,SAAS,CAAC,2BAA2B,EAAE,CAAC;gBAC1C,OAAO,sBAAsB,CAC3B,SAAS,CAAC,MAAM,EAChB,SAAS,CAAC,2BAA2B,EACrC,MAAM,CACP,CAAC;YACJ,CAAC;YACD,OAAO,SAAS,CAAC,MAAM,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,qBAA8F,EAC9F,MAAS,EACT,kBAA0B;IAE1B,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,kBAAkB,CAAC;IACpE,MAAM,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAEtD,OAAO,kBAAkB,KAAK,kBAAkB,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAwB,EACxB,qBAA8F;IAE9F,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEtD,kEAAkE;IAClE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE7B,IAAI,CAAC,qBAAqB,IAAI,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,CAAC;QACtE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6BAA6B;IAC7B,KAAK,MAAM,SAAS,IAAI,qBAAqB,CAAC,gBAAgB,EAAE,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,uBAAuB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}
+{"version":3,"file":"schema-variant-resolver.utils.js","sourceRoot":"","sources":["../../../../../src/resources/utils/schema-variant-resolver.utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,sBAAsB,CACpC,UAAwB,EACxB,qBAA8F,EAC9F,MAAS;IAET,sCAAsC;IACtC,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,4CAA4C;IAC5C,IAAI,CAAC,qBAAqB,CAAC,gBAAgB,IAAI,qBAAqB,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnG,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,sCAAsC;IACtC,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,kBAAkB,CAAC;IACpE,MAAM,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAEtD,wDAAwD;IACxD,IAAI,kBAAkB,KAAK,SAAS,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QACpE,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,iDAAiD;IACjD,MAAM,UAAU,GAAG,qBAAqB,CAAC,0CAA0C,IAAI,EAAE,CAAC;IAC1F,IAAI,UAAU,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;QAC5C,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,qCAAqC;IACrC,KAAK,MAAM,SAAS,IAAI,qBAAqB,CAAC,gBAAgB,EAAE,CAAC;QAC/D,IAAI,SAAS,CAAC,uBAAuB,KAAK,kBAAkB,EAAE,CAAC;YAC7D,mDAAmD;YACnD,IAAI,SAAS,CAAC,2BAA2B,EAAE,CAAC;gBAC1C,OAAO,sBAAsB,CAC3B,SAAS,CAAC,MAAM,EAChB,SAAS,CAAC,2BAA2B,EACrC,MAAM,CACP,CAAC;YACJ,CAAC;YACD,OAAO,SAAS,CAAC,MAAM,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,6DAA6D;IAC7D,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAC/B,qBAA8F,EAC9F,MAAS,EACT,kBAA0B;IAE1B,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC3B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,kBAAkB,GAAG,qBAAqB,CAAC,kBAAkB,CAAC;IACpE,MAAM,kBAAkB,GAAG,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAEtD,OAAO,kBAAkB,KAAK,kBAAkB,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAClC,UAAwB,EACxB,qBAA8F;IAE9F,MAAM,MAAM,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEtD,kEAAkE;IAClE,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAE7B,IAAI,CAAC,qBAAqB,IAAI,CAAC,qBAAqB,CAAC,gBAAgB,EAAE,CAAC;QACtE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6BAA6B;IAC7B,KAAK,MAAM,SAAS,IAAI,qBAAqB,CAAC,gBAAgB,EAAE,CAAC;QAC/D,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,uBAAuB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IAClE,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["/**\n * Schema Variant Resolver Utilities\n * \n * Resolves the correct schema variant for an object based on discriminator values.\n * Used at runtime to get the variant-specific schema for virtual field computation,\n * backend-only field stripping, and summary derivation.\n * \n * @see Section 19 of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md\n */\n\nimport { z } from 'zod';\nimport { ResourceConfiguration_InheritanceSchemaDefinition } from '../resources-config.shared.schemas';\n\n/**\n * Resolve the correct schema for an object based on inheritance discriminators.\n * \n * @param mainSchema - The base/main schema\n * @param inheritanceDefinition - The inheritance schema definition (optional)\n * @param object - The data object to inspect for discriminator values\n * @returns The correct schema variant for the object\n * \n * @example\n * ```typescript\n * const config = registry.getResourceConfiguration(resourceType);\n * const effectiveSchema = resolveSchemaForObject(\n *   config.mainSchema,\n *   config.inheritenceSchemaDefinition,\n *   data\n * );\n * // effectiveSchema is now the variant-specific schema if applicable\n * ```\n */\nexport function resolveSchemaForObject<T extends Record<string, any>>(\n  mainSchema: z.ZodTypeAny,\n  inheritanceDefinition: ResourceConfiguration_InheritanceSchemaDefinition<any, any> | undefined,\n  object: T\n): z.ZodTypeAny {\n  // No inheritance - return main schema\n  if (!inheritanceDefinition) {\n    return mainSchema;\n  }\n\n  // No inherited schemas - return main schema\n  if (!inheritanceDefinition.inheritedSchemas || inheritanceDefinition.inheritedSchemas.length === 0) {\n    return mainSchema;\n  }\n\n  // Get discriminator value from object\n  const discriminatorField = inheritanceDefinition.discriminatorField;\n  const discriminatorValue = object[discriminatorField];\n\n  // No discriminator value in object - return main schema\n  if (discriminatorValue === undefined || discriminatorValue === null) {\n    return mainSchema;\n  }\n\n  // Check if value is a base (non-inherited) value\n  const baseValues = inheritanceDefinition.withoutInheritanceDiscriminatorFieldValues || [];\n  if (baseValues.includes(discriminatorValue)) {\n    return mainSchema;\n  }\n\n  // Find the matching inherited schema\n  for (const inherited of inheritanceDefinition.inheritedSchemas) {\n    if (inherited.discriminatorFieldValue === discriminatorValue) {\n      // Recursively resolve if nested inheritance exists\n      if (inherited.inheritenceSchemaDefinition) {\n        return resolveSchemaForObject(\n          inherited.schema,\n          inherited.inheritenceSchemaDefinition,\n          object\n        );\n      }\n      return inherited.schema;\n    }\n  }\n\n  // No matching variant found - return main schema as fallback\n  return mainSchema;\n}\n\n/**\n * Check if an object matches a specific inheritance variant.\n * \n * @param inheritanceDefinition - The inheritance schema definition\n * @param object - The data object to check\n * @param targetVariantValue - The discriminator value to check for\n * @returns True if the object is of the specified variant\n */\nexport function isObjectOfVariant<T extends Record<string, any>>(\n  inheritanceDefinition: ResourceConfiguration_InheritanceSchemaDefinition<any, any> | undefined,\n  object: T,\n  targetVariantValue: string\n): boolean {\n  if (!inheritanceDefinition) {\n    return false;\n  }\n\n  const discriminatorField = inheritanceDefinition.discriminatorField;\n  const discriminatorValue = object[discriminatorField];\n\n  return discriminatorValue === targetVariantValue;\n}\n\n/**\n * Get all variant schemas including the base schema.\n * \n * @param mainSchema - The base/main schema\n * @param inheritanceDefinition - The inheritance schema definition\n * @returns Map of discriminator value to schema\n */\nexport function getAllVariantSchemas(\n  mainSchema: z.ZodTypeAny,\n  inheritanceDefinition: ResourceConfiguration_InheritanceSchemaDefinition<any, any> | undefined\n): Map<string | null, z.ZodTypeAny> {\n  const result = new Map<string | null, z.ZodTypeAny>();\n\n  // Base schema for non-inherited values (null key represents base)\n  result.set(null, mainSchema);\n\n  if (!inheritanceDefinition || !inheritanceDefinition.inheritedSchemas) {\n    return result;\n  }\n\n  // Add each inherited variant\n  for (const inherited of inheritanceDefinition.inheritedSchemas) {\n    result.set(inherited.discriminatorFieldValue, inherited.schema);\n  }\n\n  return result;\n}\n"]}

package/dist/esm/resources/utils/shared-persistence-collection.utils.d.ts

@@ -0,0 +1,203 @@
+import type { ResourceType } from '../resources.shared.schemas';
+import type { PersistenceAdapterType } from '../resources-config.shared.schemas';
+import { ErasureRetentionMode } from '../../compliance/privacy/impersonalization.shared.schemas';
+/**
+ * Resource types that deliberately project onto ANOTHER resource type's
+ * persistence collection — THE authority for "which configs address the same
+ * physical rows?".
+ *
+ * ## What this expresses
+ *
+ * A `USER_SELF*` resource is not a different record set; it is a different DOOR
+ * onto the SAME record set, with its own operations, roles and scoping. The
+ * `USERS` door is the admin surface (list every user, delete a user); the
+ * `USER_SELF` door is the self surface (read/update MY row). They intentionally
+ * share `UserSchema` and they intentionally share storage — the persistence
+ * layer builds a SEPARATE model per resource config over ONE collection.
+ *
+ * Anything not listed here stores under its own resource type.
+ *
+ * ## Why it is a single named authority
+ *
+ * This mapping had already been copied twice inside the backend (the
+ * zod→mongoose model builder, which is what actually creates and reads the
+ * collection, and the aggregation collection resolver — whose earlier
+ * divergence made every aggregation query a non-existent collection and return
+ * zero rows). It now has a third consumer of a completely different kind:
+ * {@link findSharedPersistenceCollectionRetentionIncoherences}, a boot-time
+ * coherence guard. A per-resource config factory structurally cannot see this
+ * relationship — it validates ONE config at a time — so the fact has to live
+ * where every layer can read it, and it has to live exactly once.
+ *
+ * ## The alias belongs to the RESOURCE, not to the storage adapter
+ *
+ * Every persistence path resolves through this map, and each adapter has
+ * exactly ONE composition point that does so: MongoDB's model builder and its
+ * aggregation resolver, and — on the SQL side — the single
+ * `resolveTableNameForResource` helper that the hybrid planner, the PostgreSQL
+ * repository and the boot-time table verifier all call.
+ *
+ * This was NOT always true, and the way it failed is the reason to keep it
+ * true: PostgreSQL used to derive its table name straight from
+ * `resourceIdentifier`, so `USER_SELF` planned, wrote and verified a `userself`
+ * table while `USERS` used `users`. An adapter choice must never silently
+ * change WHICH RECORDS a resource addresses — that is not a storage detail, it
+ * is the "two doors, one record set" contract itself. On the SQL side the
+ * resolved name is additionally normalised into a SQL identifier; casing is an
+ * adapter concern, the alias is not.
+ *
+ * The one thing a shared resolver still cannot see is an alias group whose
+ * members are pointed at DIFFERENT adapters — each config is individually
+ * valid, and only the pair is wrong. That is what
+ * {@link findSharedPersistenceCollectionAdapterIncoherences} fails closed on.
+ */
+export declare const RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES: Readonly<Record<string, string>>;
+/**
+ * The persistence collection a resource type's rows live in — its alias target
+ * when it declares one, otherwise the resource type itself.
+ *
+ * @param resourceType - the resource type whose storage location is wanted.
+ * @returns the collection name, as a plain string.
+ */
+export declare function resolveSharedPersistenceCollectionName(resourceType: ResourceType): string;
+/** The minimal config shape {@link findSharedPersistenceCollectionAdapterIncoherences} reads. */
+export interface SharedPersistenceCollectionAdapterCandidate {
+    readonly resourceIdentifier: ResourceType;
+    /** The config's OWN declaration; `undefined` means "inherit the application default". */
+    readonly persistenceAdapter?: PersistenceAdapterType | undefined;
+}
+/** One collection whose resource configs are pointed at different databases. */
+export interface SharedPersistenceCollectionAdapterIncoherence {
+    /** The shared collection the disagreeing configs claim to address. */
+    readonly collectionName: string;
+    /** Every resource config addressing that collection, with the adapter it RESOLVED to. */
+    readonly adapters: readonly {
+        resourceType: ResourceType;
+        adapter: PersistenceAdapterType;
+    }[];
+    /** Operator-facing explanation naming the consequence and the fix. */
+    readonly message: string;
+}
+/**
+ * Registry-ASSEMBLY guardrail: every resource config that resolves to the SAME
+ * persistence collection must resolve to the SAME persistence adapter.
+ *
+ * ## Why the shared resolver cannot cover this on its own
+ *
+ * {@link resolveSharedPersistenceCollectionName} makes the alias
+ * adapter-independent: whichever database a resource lands in, it addresses the
+ * aliased NAME. That is necessary and not sufficient. A name is only an address
+ * WITHIN one database, so pointing `USERS` at PostgreSQL while `USER_SELF`
+ * inherits MongoDB yields two stores that both believe they own the same rows.
+ * Nothing downstream can detect it: each config is individually valid, each
+ * repository is correctly built, and every per-resource check passes.
+ *
+ * ## The failure it prevents
+ *
+ * The doors silently stop sharing records. The admin door lists users the self
+ * door cannot read; a self-service update writes to a row the admin door will
+ * never see; and — because retention is enforced against ROWS — an erasure
+ * performed through one door leaves the other door's copy completely
+ * untouched, which is the same compliance-grade lie that
+ * {@link findSharedPersistenceCollectionRetentionIncoherences} exists to
+ * prevent, arrived at from a different direction.
+ *
+ * The table name is not the only thing that follows from the adapter. Id FORMAT
+ * does too — the PostgreSQL repository validates ids as UUIDs while Mongo
+ * expects ObjectIds, each resolved from its OWN resource's adapter — so a split
+ * group would also reject through one door the very ids the other door mints.
+ * Anything keyed on "this resource's adapter" inherits this invariant.
+ *
+ * ## Why this is permanent, not a capability gate
+ *
+ * Unlike adapter gaps that close when the missing support is implemented, this
+ * one has no future in which it becomes valid: two databases cannot hold one
+ * set of rows. It is deliberately NOT a ban on aliased resources using
+ * PostgreSQL — an alias group that agrees on PostgreSQL resolves to one shared
+ * table, and whether that table was actually provisioned is a separate,
+ * already-enforced question (the boot-time table verifier).
+ *
+ * Resources inherit the application default when they declare nothing, so the
+ * caller supplies the resolved default rather than this function guessing it.
+ *
+ * Pure and side-effect free: it reports, the caller throws.
+ *
+ * @param resourceConfigurations - every assembled resource config, keyed by resource type.
+ * @param defaultPersistenceAdapter - the adapter a config with no declaration inherits.
+ * @returns one entry per incoherent collection; empty when the registry is coherent.
+ */
+export declare function findSharedPersistenceCollectionAdapterIncoherences(resourceConfigurations: Record<string, SharedPersistenceCollectionAdapterCandidate>, defaultPersistenceAdapter: PersistenceAdapterType): SharedPersistenceCollectionAdapterIncoherence[];
+/** The minimal config shape {@link findSharedPersistenceCollectionRetentionIncoherences} reads. */
+export interface SharedPersistenceCollectionRetentionCandidate {
+    readonly resourceIdentifier: ResourceType;
+    readonly retentionPolicy?: {
+        mode?: ErasureRetentionMode;
+    } | undefined;
+}
+/** One collection whose resource configs disagree about retention governance. */
+export interface SharedPersistenceCollectionRetentionIncoherence {
+    /** The shared collection the disagreeing configs write to. */
+    readonly collectionName: string;
+    /** Every resource config addressing that collection, with the posture it declared. */
+    readonly postures: readonly {
+        resourceType: ResourceType;
+        mode: ErasureRetentionMode | undefined;
+    }[];
+    /** Operator-facing explanation naming both failure modes and the fix. */
+    readonly message: string;
+}
+/**
+ * Registry-ASSEMBLY guardrail: every resource config that resolves to the SAME
+ * persistence collection must declare the SAME retention posture.
+ *
+ * ## Why a config that passes every per-resource check can still be broken
+ *
+ * `retentionPolicy` is validated PER RESOURCE CONFIG by the config factory: it
+ * checks that resource's operations, its field treatments, its system-access
+ * grants. It cannot check what a SIBLING config declares, because a factory
+ * invocation never sees one. But retention is enforced against ROWS, and two
+ * configs can own the same rows (see
+ * {@link RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES}). So a pair that
+ * disagrees produces a config where every individual resource is valid and the
+ * COLLECTION is not.
+ *
+ * ## The two concrete failure modes
+ *
+ * **1. Fail-open erasure.** The retention hide filter (rows marked `RETAINED`
+ * are invisible) and the immutability freeze are injected per resource config,
+ * in `buildContextualFilter`. A row erased through the governed door stays
+ * fully READABLE and UPDATABLE through the ungoverned one. For the
+ * `USERS`/`USER_SELF` pair that ungoverned door exposes READ + UPDATE to
+ * `APP_USER` — i.e. the erased subject can still read and edit their own
+ * "erased" record. The row is erased only from the door that was opted in,
+ * which is a compliance-grade lie about the record.
+ *
+ * **2. Unique-index collision — a hard functional abort.** A retention-governed
+ * config scopes each unique index to NON-retained rows (a partial filter on the
+ * retention marker), precisely so scrubbed rows leave the index and cannot
+ * collide on the shared mask value. An ungoverned config over the same
+ * collection emits a PLAIN unique index on the same field. The FIRST erasure
+ * succeeds; the SECOND writes the same mask value, hits the plain index, and
+ * fails E11000 — inside the erasure transaction, so the whole erasure rolls
+ * back. The capability is silently single-use.
+ *
+ * Both modes are invisible until a real erasure runs, which is why this is a
+ * BOOT-time guard and not a test: the point is that a config which passes at
+ * boot must actually be able to perform an erasure.
+ *
+ * ## Why "one opted in, one not" is a disagreement, not a default
+ *
+ * An absent `retentionPolicy` is a positive statement — "rows of this resource
+ * are hard-deleted" — not an unset value the governed sibling can supply. Both
+ * failure modes above are produced by exactly that asymmetry, so `undefined`
+ * participates in the comparison as its own posture rather than being skipped.
+ *
+ * Pure and side-effect free: it reports, the caller throws. That keeps the
+ * shared-collection fact and its invariant in the layer both persistence and
+ * validation can import, while the registry owns the error shape.
+ *
+ * @param resourceConfigurations - every assembled resource config, keyed by resource type.
+ * @returns one entry per incoherent collection; empty when the registry is coherent.
+ */
+export declare function findSharedPersistenceCollectionRetentionIncoherences(resourceConfigurations: Record<string, SharedPersistenceCollectionRetentionCandidate>): SharedPersistenceCollectionRetentionIncoherence[];
+//# sourceMappingURL=shared-persistence-collection.utils.d.ts.map

package/dist/esm/resources/utils/shared-persistence-collection.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared-persistence-collection.utils.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/shared-persistence-collection.utils.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AACjF,OAAO,EAAE,oBAAoB,EAAE,MAAM,2DAA2D,CAAC;AAEjG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,eAAO,MAAM,8CAA8C,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAI3F,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,sCAAsC,CAAC,YAAY,EAAE,YAAY,GAAG,MAAM,CAEzF;AAED,iGAAiG;AACjG,MAAM,WAAW,2CAA2C;IAC1D,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC;IAC1C,yFAAyF;IACzF,QAAQ,CAAC,kBAAkB,CAAC,EAAE,sBAAsB,GAAG,SAAS,CAAC;CAClE;AAED,gFAAgF;AAChF,MAAM,WAAW,6CAA6C;IAC5D,sEAAsE;IACtE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,OAAO,EAAE,sBAAsB,CAAA;KAAE,EAAE,CAAC;IAC9F,sEAAsE;IACtE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,kDAAkD,CAChE,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,2CAA2C,CAAC,EACnF,yBAAyB,EAAE,sBAAsB,GAChD,6CAA6C,EAAE,CAsDjD;AAED,mGAAmG;AACnG,MAAM,WAAW,6CAA6C;IAC5D,QAAQ,CAAC,kBAAkB,EAAE,YAAY,CAAC;IAC1C,QAAQ,CAAC,eAAe,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,oBAAoB,CAAA;KAAE,GAAG,SAAS,CAAC;CACxE;AAyBD,iFAAiF;AACjF,MAAM,WAAW,+CAA+C;IAC9D,8DAA8D;IAC9D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,EAAE,SAAS;QAAE,YAAY,EAAE,YAAY,CAAC;QAAC,IAAI,EAAE,oBAAoB,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IACrG,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoDG;AACH,wBAAgB,oDAAoD,CAClE,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,6CAA6C,CAAC,GACpF,+CAA+C,EAAE,CA0DnD"}