@wildo-ai/saas-models 1.1.7 → 1.1.8

package/dist/esm/resources/utils/resources-summary.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources-summary.utils.js","sourceRoot":"","sources":["../../../../src/resources/utils/resources-summary.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource Summary Utilities\n *\n * Utilities for deriving summary schemas from main schemas using decorators.\n * Summary schemas are lighter versions used for list/search operations.\n *\n * @see Section 4.3 of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md\n */\n\nimport { z } from 'zod';\nimport {\n  getZodObjectShape,\n  isSummaryField,\n  isBackendOnlyField,\n} from '@wildo-ai/zod-decorators';\nimport { ResourceConfiguration_InheritanceSchemaDefinition } from '../resources-config.shared.schemas';\nimport { isNonDisclosableFieldValue } from './field-value-disclosure.utils';\n\n/**\n * Options for deriving a summary schema\n */\nexport interface DeriveSummaryOptions {\n  /** Always include _id field (default: true) */\n  includeId?: boolean;\n  /** Include foreign key fields automatically (default: false) */\n  includeForeignKeys?: boolean;\n  /** Additional fields to include regardless of decorators */\n  additionalFields?: string[];\n  /** Fields to exclude regardless of decorators */\n  excludeFields?: string[];\n}\n\n/**\n * Result of summary schema validation\n */\nexport interface SummaryValidationResult {\n  valid: boolean;\n  issues: string[];\n}\n\n/**\n * Default summary derivation options\n */\nconst DEFAULT_DERIVE_OPTIONS: DeriveSummaryOptions = {\n  includeId: true,\n  includeForeignKeys: false,\n  additionalFields: [],\n  excludeFields: [],\n};\n\n/**\n * Mutable shape type for building schemas\n */\ntype MutableZodShape = Record<string, z.ZodTypeAny>;\n\n/**\n * Utility class for deriving and validating summary schemas.\n */\nexport class ResourcesSummaryUtils {\n\n  /**\n   * Derive a summary schema from a main schema using decorator metadata.\n   *\n   * Rules:\n   * - Include fields with `isSummaryField` decorator\n   * - Include virtual fields that have BOTH `isVirtual` AND `isSummaryField` decorators\n   * - Skip `isBackendOnly` fields\n   * - Always include `_id` (unless explicitly excluded)\n   * - Do NOT auto-include `isForeignKey` fields (must be explicit)\n   *\n   * @param mainSchema - The main schema to derive from\n   * @param options - Configuration options\n   * @returns A new Zod schema containing only summary fields\n   */\n  static deriveSummarySchema(\n    mainSchema: z.ZodTypeAny,\n    options?: DeriveSummaryOptions\n  ): z.ZodObject<z.ZodRawShape> {\n    const opts = { ...DEFAULT_DERIVE_OPTIONS, ...options };\n    const shape = getZodObjectShape(mainSchema);\n    const summaryShape: MutableZodShape = {};\n\n    // Always include _id if requested\n    if (opts.includeId && shape._id) {\n      summaryShape._id = shape._id as z.ZodTypeAny;\n    }\n\n    // Include additional explicitly requested fields\n    for (const field of opts.additionalFields || []) {\n      if (shape[field] && !opts.excludeFields?.includes(field)) {\n        summaryShape[field] = shape[field] as z.ZodTypeAny;\n      }\n    }\n\n    // Scan all fields for isSummaryField decorator\n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      // Skip if already added or excluded\n      if (summaryShape[fieldName] || opts.excludeFields?.includes(fieldName)) {\n        continue;\n      }\n\n      const typedSchema = fieldSchema as z.ZodTypeAny;\n\n      // Skip backend-only fields\n      if (isBackendOnlyField(typedSchema)) {\n        continue;\n      }\n\n      // Include if has isSummaryField decorator\n      if (isSummaryField(typedSchema)) {\n        // Virtual fields with isSummaryField are also included\n        // The virtual field computation happens at the service layer\n        summaryShape[fieldName] = typedSchema;\n      }\n    }\n\n    return z.object(summaryShape as z.ZodRawShape);\n  }\n\n  /**\n   * Validate that a summary schema does not contain backend-only fields.\n   *\n   * @param summarySchema - The summary schema to validate\n   * @param mainSchema - The main schema for reference\n   * @returns Validation result with issues list\n   */\n  static validateSummarySchema(\n    summarySchema: z.ZodTypeAny,\n    mainSchema: z.ZodTypeAny\n  ): SummaryValidationResult {\n    const issues: string[] = [];\n\n    try {\n      const summaryShape = getZodObjectShape(summarySchema);\n      const mainShape = getZodObjectShape(mainSchema);\n\n      for (const [fieldName] of Object.entries(summaryShape)) {\n        const mainFieldSchema = mainShape[fieldName];\n\n        if (mainFieldSchema && isBackendOnlyField(mainFieldSchema as z.ZodTypeAny)) {\n          issues.push(\n            `Field '${fieldName}' has isBackendOnly decorator but is included in summary schema`\n          );\n        }\n      }\n    } catch (error) {\n      issues.push(`Failed to validate summary schema: ${error}`);\n    }\n\n    return {\n      valid: issues.length === 0,\n      issues,\n    };\n  }\n\n  /**\n   * Derive summary schema for a discriminated union (inheritance).\n   *\n   * Creates a discriminated union of summary schemas where:\n   * - Base summary fields apply to all variants\n   * - Variant-specific summary fields apply only to that variant\n   * - Discriminator field is always included in all variants\n   *\n   * @param mainSchema - The base schema\n   * @param inheritanceDefinition - The inheritance schema definition\n   * @param options - Derivation options\n   * @returns A discriminated union summary schema or base summary\n   */\n  static deriveSummarySchemaForDiscriminatedUnion<\n    TMainSchema extends z.ZodObject<z.ZodRawShape>\n  >(\n    mainSchema: TMainSchema,\n    inheritanceDefinition: ResourceConfiguration_InheritanceSchemaDefinition<any, TMainSchema>,\n    options?: DeriveSummaryOptions\n  ): z.ZodTypeAny {\n\n    const discriminatorField = inheritanceDefinition.discriminatorField;\n    const baseSummary = this.deriveSummarySchema(mainSchema, options);\n    const baseShape = getZodObjectShape(baseSummary);\n\n    // Ensure discriminator field is included - create mutable copy\n    const mainShape = getZodObjectShape(mainSchema);\n    const mutableBaseShape: MutableZodShape = {};\n    for (const [key, value] of Object.entries(baseShape)) {\n      mutableBaseShape[key] = value as z.ZodTypeAny;\n    }\n    if (!mutableBaseShape[discriminatorField] && mainShape[discriminatorField]) {\n      mutableBaseShape[discriminatorField] = mainShape[discriminatorField] as z.ZodTypeAny;\n    }\n\n    const variantSummaries: z.ZodObject<z.ZodRawShape>[] = [];\n\n    // Add base variants (values without inheritance)\n    const baseValues = inheritanceDefinition.withoutInheritanceDiscriminatorFieldValues || [];\n    for (const value of baseValues) {\n      variantSummaries.push(\n        z.object({\n          ...mutableBaseShape,\n          [discriminatorField]: z.literal(value),\n        } as z.ZodRawShape)\n      );\n    }\n\n    // Add inherited variant summaries\n    for (const inherited of inheritanceDefinition.inheritedSchemas || []) {\n      const inheritedSummary = this.deriveSummarySchema(inherited.schema, options);\n      const inheritedShape = getZodObjectShape(inheritedSummary);\n\n      // Merge base summary with inherited summary\n      const mergedShape: MutableZodShape = { ...mutableBaseShape };\n      for (const [key, value] of Object.entries(inheritedShape)) {\n        mergedShape[key] = value as z.ZodTypeAny;\n      }\n      mergedShape[discriminatorField] = z.literal(inherited.discriminatorFieldValue);\n\n      variantSummaries.push(z.object(mergedShape as z.ZodRawShape));\n    }\n\n    // If only one variant, return it directly\n    if (variantSummaries.length === 1) {\n      return variantSummaries[0];\n    }\n\n    // Create discriminated union (use any to avoid Zod 4 type complexity)\n    if (variantSummaries.length >= 2) {\n      return z.discriminatedUnion(\n        discriminatorField,\n        variantSummaries as any\n      );\n    }\n\n    // Fallback to base summary if no variants\n    return baseSummary;\n  }\n\n  /**\n   * Is this a summary field whose VALUE may be disclosed?\n   *\n   * Both halves are load-bearing. `isSummaryField` is the application's declaration that the field\n   * is the human-readable face of a row; {@link isNonDisclosableFieldValue} is the framework's\n   * answer to whether that value may leave the backend at all — and the application's declaration\n   * never overrides it. A field declared BOTH `.isSummaryField()` and `.isWriteOnlySecret()` is\n   * legal to author and must not be rendered anywhere a response DTO would have masked it.\n   *\n   * The disclosure half is DERIVED, never restated here: it is the same predicate the subject-export\n   * surface withholds on, so the two cannot drift (issue #95).\n   */\n  static isValidSummaryField(fieldSchema: z.ZodTypeAny): boolean {\n    return isSummaryField(fieldSchema) && !isNonDisclosableFieldValue(fieldSchema);\n  }\n\n  /**\n   * Get all summary field names from a schema whose values may be disclosed.\n   *\n   * Routed through {@link isValidSummaryField} rather than repeating its test — the two said the\n   * same thing in two places, and when the disclosure rule grew from \"not backend-only\" to the full\n   * boundary, one of them would have been updated and the other left behind. That is the defect\n   * class this whole change is about, in miniature.\n   */\n  static getSummaryFieldNames(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 (ResourcesSummaryUtils.isValidSummaryField(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"]}
+{"version":3,"file":"resources-summary.utils.js","sourceRoot":"","sources":["../../../../../src/resources/utils/resources-summary.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource Summary Utilities\n *\n * Utilities for deriving summary schemas from main schemas using decorators.\n * Summary schemas are lighter versions used for list/search operations.\n *\n * @see Section 4.3 of RESOURCE_DERIVED_OBJECTS_RATIONALIZATION.md\n */\n\nimport { z } from 'zod';\nimport {\n  getZodObjectShape,\n  isSummaryField,\n  isBackendOnlyField,\n} from '@wildo-ai/zod-decorators';\nimport { ResourceConfiguration_InheritanceSchemaDefinition } from '../resources-config.shared.schemas';\nimport { isNonDisclosableFieldValue } from './field-value-disclosure.utils';\n\n/**\n * Options for deriving a summary schema\n */\nexport interface DeriveSummaryOptions {\n  /** Always include _id field (default: true) */\n  includeId?: boolean;\n  /** Include foreign key fields automatically (default: false) */\n  includeForeignKeys?: boolean;\n  /** Additional fields to include regardless of decorators */\n  additionalFields?: string[];\n  /** Fields to exclude regardless of decorators */\n  excludeFields?: string[];\n}\n\n/**\n * Result of summary schema validation\n */\nexport interface SummaryValidationResult {\n  valid: boolean;\n  issues: string[];\n}\n\n/**\n * Default summary derivation options\n */\nconst DEFAULT_DERIVE_OPTIONS: DeriveSummaryOptions = {\n  includeId: true,\n  includeForeignKeys: false,\n  additionalFields: [],\n  excludeFields: [],\n};\n\n/**\n * Mutable shape type for building schemas\n */\ntype MutableZodShape = Record<string, z.ZodTypeAny>;\n\n/**\n * Utility class for deriving and validating summary schemas.\n */\nexport class ResourcesSummaryUtils {\n\n  /**\n   * Derive a summary schema from a main schema using decorator metadata.\n   *\n   * Rules:\n   * - Include fields with `isSummaryField` decorator\n   * - Include virtual fields that have BOTH `isVirtual` AND `isSummaryField` decorators\n   * - Skip `isBackendOnly` fields\n   * - Always include `_id` (unless explicitly excluded)\n   * - Do NOT auto-include `isForeignKey` fields (must be explicit)\n   *\n   * @param mainSchema - The main schema to derive from\n   * @param options - Configuration options\n   * @returns A new Zod schema containing only summary fields\n   */\n  static deriveSummarySchema(\n    mainSchema: z.ZodTypeAny,\n    options?: DeriveSummaryOptions\n  ): z.ZodObject<z.ZodRawShape> {\n    const opts = { ...DEFAULT_DERIVE_OPTIONS, ...options };\n    const shape = getZodObjectShape(mainSchema);\n    const summaryShape: MutableZodShape = {};\n\n    // Always include _id if requested\n    if (opts.includeId && shape._id) {\n      summaryShape._id = shape._id as z.ZodTypeAny;\n    }\n\n    // Include additional explicitly requested fields\n    for (const field of opts.additionalFields || []) {\n      if (shape[field] && !opts.excludeFields?.includes(field)) {\n        summaryShape[field] = shape[field] as z.ZodTypeAny;\n      }\n    }\n\n    // Scan all fields for isSummaryField decorator\n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      // Skip if already added or excluded\n      if (summaryShape[fieldName] || opts.excludeFields?.includes(fieldName)) {\n        continue;\n      }\n\n      const typedSchema = fieldSchema as z.ZodTypeAny;\n\n      // Skip backend-only fields\n      if (isBackendOnlyField(typedSchema)) {\n        continue;\n      }\n\n      // Include if has isSummaryField decorator\n      if (isSummaryField(typedSchema)) {\n        // Virtual fields with isSummaryField are also included\n        // The virtual field computation happens at the service layer\n        summaryShape[fieldName] = typedSchema;\n      }\n    }\n\n    return z.object(summaryShape as z.ZodRawShape);\n  }\n\n  /**\n   * Validate that a summary schema does not contain backend-only fields.\n   *\n   * @param summarySchema - The summary schema to validate\n   * @param mainSchema - The main schema for reference\n   * @returns Validation result with issues list\n   */\n  static validateSummarySchema(\n    summarySchema: z.ZodTypeAny,\n    mainSchema: z.ZodTypeAny\n  ): SummaryValidationResult {\n    const issues: string[] = [];\n\n    try {\n      const summaryShape = getZodObjectShape(summarySchema);\n      const mainShape = getZodObjectShape(mainSchema);\n\n      for (const [fieldName] of Object.entries(summaryShape)) {\n        const mainFieldSchema = mainShape[fieldName];\n\n        if (mainFieldSchema && isBackendOnlyField(mainFieldSchema as z.ZodTypeAny)) {\n          issues.push(\n            `Field '${fieldName}' has isBackendOnly decorator but is included in summary schema`\n          );\n        }\n      }\n    } catch (error) {\n      issues.push(`Failed to validate summary schema: ${error}`);\n    }\n\n    return {\n      valid: issues.length === 0,\n      issues,\n    };\n  }\n\n  /**\n   * Derive summary schema for a discriminated union (inheritance).\n   *\n   * Creates a discriminated union of summary schemas where:\n   * - Base summary fields apply to all variants\n   * - Variant-specific summary fields apply only to that variant\n   * - Discriminator field is always included in all variants\n   *\n   * @param mainSchema - The base schema\n   * @param inheritanceDefinition - The inheritance schema definition\n   * @param options - Derivation options\n   * @returns A discriminated union summary schema or base summary\n   */\n  static deriveSummarySchemaForDiscriminatedUnion<\n    TMainSchema extends z.ZodObject<z.ZodRawShape>\n  >(\n    mainSchema: TMainSchema,\n    inheritanceDefinition: ResourceConfiguration_InheritanceSchemaDefinition<any, TMainSchema>,\n    options?: DeriveSummaryOptions\n  ): z.ZodTypeAny {\n\n    const discriminatorField = inheritanceDefinition.discriminatorField;\n    const baseSummary = this.deriveSummarySchema(mainSchema, options);\n    const baseShape = getZodObjectShape(baseSummary);\n\n    // Ensure discriminator field is included - create mutable copy\n    const mainShape = getZodObjectShape(mainSchema);\n    const mutableBaseShape: MutableZodShape = {};\n    for (const [key, value] of Object.entries(baseShape)) {\n      mutableBaseShape[key] = value as z.ZodTypeAny;\n    }\n    if (!mutableBaseShape[discriminatorField] && mainShape[discriminatorField]) {\n      mutableBaseShape[discriminatorField] = mainShape[discriminatorField] as z.ZodTypeAny;\n    }\n\n    const variantSummaries: z.ZodObject<z.ZodRawShape>[] = [];\n\n    // Add base variants (values without inheritance)\n    const baseValues = inheritanceDefinition.withoutInheritanceDiscriminatorFieldValues || [];\n    for (const value of baseValues) {\n      variantSummaries.push(\n        z.object({\n          ...mutableBaseShape,\n          [discriminatorField]: z.literal(value),\n        } as z.ZodRawShape)\n      );\n    }\n\n    // Add inherited variant summaries\n    for (const inherited of inheritanceDefinition.inheritedSchemas || []) {\n      const inheritedSummary = this.deriveSummarySchema(inherited.schema, options);\n      const inheritedShape = getZodObjectShape(inheritedSummary);\n\n      // Merge base summary with inherited summary\n      const mergedShape: MutableZodShape = { ...mutableBaseShape };\n      for (const [key, value] of Object.entries(inheritedShape)) {\n        mergedShape[key] = value as z.ZodTypeAny;\n      }\n      mergedShape[discriminatorField] = z.literal(inherited.discriminatorFieldValue);\n\n      variantSummaries.push(z.object(mergedShape as z.ZodRawShape));\n    }\n\n    // If only one variant, return it directly\n    if (variantSummaries.length === 1) {\n      return variantSummaries[0];\n    }\n\n    // Create discriminated union (use any to avoid Zod 4 type complexity)\n    if (variantSummaries.length >= 2) {\n      return z.discriminatedUnion(\n        discriminatorField,\n        variantSummaries as any\n      );\n    }\n\n    // Fallback to base summary if no variants\n    return baseSummary;\n  }\n\n  /**\n   * Is this a summary field whose VALUE may be disclosed?\n   *\n   * Both halves are load-bearing. `isSummaryField` is the application's declaration that the field\n   * is the human-readable face of a row; {@link isNonDisclosableFieldValue} is the framework's\n   * answer to whether that value may leave the backend at all — and the application's declaration\n   * never overrides it. A field declared BOTH `.isSummaryField()` and `.isWriteOnlySecret()` is\n   * legal to author and must not be rendered anywhere a response DTO would have masked it.\n   *\n   * The disclosure half is DERIVED, never restated here: it is the same predicate the subject-export\n   * surface withholds on, so the two cannot drift (issue #95).\n   */\n  static isValidSummaryField(fieldSchema: z.ZodTypeAny): boolean {\n    return isSummaryField(fieldSchema) && !isNonDisclosableFieldValue(fieldSchema);\n  }\n\n  /**\n   * Get all summary field names from a schema whose values may be disclosed.\n   *\n   * Routed through {@link isValidSummaryField} rather than repeating its test — the two said the\n   * same thing in two places, and when the disclosure rule grew from \"not backend-only\" to the full\n   * boundary, one of them would have been updated and the other left behind. That is the defect\n   * class this whole change is about, in miniature.\n   */\n  static getSummaryFieldNames(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 (ResourcesSummaryUtils.isValidSummaryField(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"]}

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;;;;;;;;;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"}
+{"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.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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","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"]}
+{"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.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","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"]}
+{"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.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.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","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"]}
+{"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.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.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","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"]}
+{"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.map

@@ -1 +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,CAe3F,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;AA8BD,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;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,oBAAY,iCAAiC;IAC3C,IAAI,SAAS;IACb,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB"}
+{"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,CAe3F,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;AA8BD,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;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,oBAAY,iCAAiC;IAC3C,IAAI,SAAS;IACb,KAAK,UAAU;IACf,MAAM,WAAW;IACjB,QAAQ,aAAa;CACtB"}

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

@@ -1 +1 @@
-{"version":3,"file":"shared-persistence-collection.utils.js","sourceRoot":"","sources":["../../../../src/resources/utils/shared-persistence-collection.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { CoreResourceType } from '../resources.shared.core.definitions';\nimport type { ResourceType } from '../resources.shared.schemas';\nimport type { PersistenceAdapterType } from '../resources-config.shared.schemas';\nimport { ErasureRetentionMode } from '../../compliance/privacy/impersonalization.shared.schemas';\n\n/**\n * Resource types that deliberately project onto ANOTHER resource type's\n * persistence collection — THE authority for \"which configs address the same\n * physical rows?\".\n *\n * ## What this expresses\n *\n * A `USER_SELF*` resource is not a different record set; it is a different DOOR\n * onto the SAME record set, with its own operations, roles and scoping. The\n * `USERS` door is the admin surface (list every user, delete a user); the\n * `USER_SELF` door is the self surface (read/update MY row). They intentionally\n * share `UserSchema` and they intentionally share storage — the persistence\n * layer builds a SEPARATE model per resource config over ONE collection.\n *\n * Anything not listed here stores under its own resource type.\n *\n * ## Why it is a single named authority\n *\n * This mapping had already been copied twice inside the backend (the\n * zod→mongoose model builder, which is what actually creates and reads the\n * collection, and the aggregation collection resolver — whose earlier\n * divergence made every aggregation query a non-existent collection and return\n * zero rows). It now has a third consumer of a completely different kind:\n * {@link findSharedPersistenceCollectionRetentionIncoherences}, a boot-time\n * coherence guard. A per-resource config factory structurally cannot see this\n * relationship — it validates ONE config at a time — so the fact has to live\n * where every layer can read it, and it has to live exactly once.\n *\n * ## The alias belongs to the RESOURCE, not to the storage adapter\n *\n * Every persistence path resolves through this map, and each adapter has\n * exactly ONE composition point that does so: MongoDB's model builder and its\n * aggregation resolver, and — on the SQL side — the single\n * `resolveTableNameForResource` helper that the hybrid planner, the PostgreSQL\n * repository and the boot-time table verifier all call.\n *\n * This was NOT always true, and the way it failed is the reason to keep it\n * true: PostgreSQL used to derive its table name straight from\n * `resourceIdentifier`, so `USER_SELF` planned, wrote and verified a `userself`\n * table while `USERS` used `users`. An adapter choice must never silently\n * change WHICH RECORDS a resource addresses — that is not a storage detail, it\n * is the \"two doors, one record set\" contract itself. On the SQL side the\n * resolved name is additionally normalised into a SQL identifier; casing is an\n * adapter concern, the alias is not.\n *\n * The one thing a shared resolver still cannot see is an alias group whose\n * members are pointed at DIFFERENT adapters — each config is individually\n * valid, and only the pair is wrong. That is what\n * {@link findSharedPersistenceCollectionAdapterIncoherences} fails closed on.\n */\nexport const RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES: Readonly<Record<string, string>> = {\n  [CoreResourceType.USER_SELF]: CoreResourceType.USERS,\n  [CoreResourceType.USER_SELF_PROFILES]: CoreResourceType.USER_PROFILES,\n  [CoreResourceType.USER_SELF_PREFERENCES]: CoreResourceType.USER_PREFERENCES,\n  /*\n   * The application-scoped audit door addresses the organization-scoped resource's rows (#317).\n   *\n   * Unlike the `USER_SELF` group above — where the alias exists so a principal can address its OWN\n   * row through a narrower door — this pair exists because the two doors see DIFFERENT SUBSETS of\n   * one set: the organization door is tenant-filtered and structurally cannot return the rows that\n   * carry no organization (logins, session evictions, application-wide policy changes), which is\n   * 74% of them on a measured dogfood application. Splitting the storage would split the audit\n   * trail itself, so the alias is load-bearing rather than a convenience.\n   */\n  [CoreResourceType.APPLICATION_AUDIT_LOGS]: CoreResourceType.AUDIT_LOGS,\n};\n\n/**\n * The persistence collection a resource type's rows live in — its alias target\n * when it declares one, otherwise the resource type itself.\n *\n * @param resourceType - the resource type whose storage location is wanted.\n * @returns the collection name, as a plain string.\n */\nexport function resolveSharedPersistenceCollectionName(resourceType: ResourceType): string {\n  return RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES[resourceType as string] ?? (resourceType as string);\n}\n\n/** The minimal config shape {@link findSharedPersistenceCollectionAdapterIncoherences} reads. */\nexport interface SharedPersistenceCollectionAdapterCandidate {\n  readonly resourceIdentifier: ResourceType;\n  /** The config's OWN declaration; `undefined` means \"inherit the application default\". */\n  readonly persistenceAdapter?: PersistenceAdapterType | undefined;\n}\n\n/** One collection whose resource configs are pointed at different databases. */\nexport interface SharedPersistenceCollectionAdapterIncoherence {\n  /** The shared collection the disagreeing configs claim to address. */\n  readonly collectionName: string;\n  /** Every resource config addressing that collection, with the adapter it RESOLVED to. */\n  readonly adapters: readonly { resourceType: ResourceType; adapter: PersistenceAdapterType }[];\n  /** Operator-facing explanation naming the consequence and the fix. */\n  readonly message: string;\n}\n\n/**\n * Registry-ASSEMBLY guardrail: every resource config that resolves to the SAME\n * persistence collection must resolve to the SAME persistence adapter.\n *\n * ## Why the shared resolver cannot cover this on its own\n *\n * {@link resolveSharedPersistenceCollectionName} makes the alias\n * adapter-independent: whichever database a resource lands in, it addresses the\n * aliased NAME. That is necessary and not sufficient. A name is only an address\n * WITHIN one database, so pointing `USERS` at PostgreSQL while `USER_SELF`\n * inherits MongoDB yields two stores that both believe they own the same rows.\n * Nothing downstream can detect it: each config is individually valid, each\n * repository is correctly built, and every per-resource check passes.\n *\n * ## The failure it prevents\n *\n * The doors silently stop sharing records. The admin door lists users the self\n * door cannot read; a self-service update writes to a row the admin door will\n * never see; and — because retention is enforced against ROWS — an erasure\n * performed through one door leaves the other door's copy completely\n * untouched, which is the same compliance-grade lie that\n * {@link findSharedPersistenceCollectionRetentionIncoherences} exists to\n * prevent, arrived at from a different direction.\n *\n * The table name is not the only thing that follows from the adapter. Id FORMAT\n * does too — the PostgreSQL repository validates ids as UUIDs while Mongo\n * expects ObjectIds, each resolved from its OWN resource's adapter — so a split\n * group would also reject through one door the very ids the other door mints.\n * Anything keyed on \"this resource's adapter\" inherits this invariant.\n *\n * ## Why this is permanent, not a capability gate\n *\n * Unlike adapter gaps that close when the missing support is implemented, this\n * one has no future in which it becomes valid: two databases cannot hold one\n * set of rows. It is deliberately NOT a ban on aliased resources using\n * PostgreSQL — an alias group that agrees on PostgreSQL resolves to one shared\n * table, and whether that table was actually provisioned is a separate,\n * already-enforced question (the boot-time table verifier).\n *\n * Resources inherit the application default when they declare nothing, so the\n * caller supplies the resolved default rather than this function guessing it.\n *\n * Pure and side-effect free: it reports, the caller throws.\n *\n * @param resourceConfigurations - every assembled resource config, keyed by resource type.\n * @param defaultPersistenceAdapter - the adapter a config with no declaration inherits.\n * @returns one entry per incoherent collection; empty when the registry is coherent.\n */\nexport function findSharedPersistenceCollectionAdapterIncoherences(\n  resourceConfigurations: Record<string, SharedPersistenceCollectionAdapterCandidate>,\n  defaultPersistenceAdapter: PersistenceAdapterType,\n): SharedPersistenceCollectionAdapterIncoherence[] {\n  const adaptersByCollection = new Map<\n    string,\n    { resourceType: ResourceType; adapter: PersistenceAdapterType }[]\n  >();\n\n  for (const [resourceTypeKey, resourceConfig] of Object.entries(resourceConfigurations)) {\n    // Same reasoning as the retention guard: prefer the config's OWN identifier so a mis-keyed\n    // registry entry is diagnosed against the name its author actually wrote.\n    const resourceType = (resourceConfig?.resourceIdentifier ?? resourceTypeKey) as ResourceType;\n    const collectionName = resolveSharedPersistenceCollectionName(resourceType);\n    const entry = {\n      resourceType,\n      adapter: resourceConfig?.persistenceAdapter ?? defaultPersistenceAdapter,\n    };\n\n    const existing = adaptersByCollection.get(collectionName);\n    if (existing) {\n      existing.push(entry);\n    } else {\n      adaptersByCollection.set(collectionName, [entry]);\n    }\n  }\n\n  const incoherences: SharedPersistenceCollectionAdapterIncoherence[] = [];\n\n  for (const [collectionName, adapters] of adaptersByCollection) {\n    if (adapters.length < 2) {\n      continue;\n    }\n    if (new Set(adapters.map((entry) => entry.adapter)).size < 2) {\n      continue;\n    }\n\n    const declared = adapters\n      .map((entry) => `'${String(entry.resourceType)}' → ${entry.adapter}`)\n      .join(', ');\n\n    incoherences.push({\n      collectionName,\n      adapters,\n      message:\n        `Resource configs [${declared}] all address the '${collectionName}' persistence collection but ` +\n        `resolve to DIFFERENT persistence adapters. These configs are separate doors onto ONE set of ` +\n        `rows, and a collection name only addresses rows within a single database, so this splits them ` +\n        `across two stores that each believe they own the records: the admin door lists rows the self ` +\n        `door cannot read, a self-service write lands where the admin door will never see it, and an ` +\n        `erasure performed through one door leaves the other door's copy fully intact. Give every ` +\n        `config listed above the same persistenceAdapter (a resource sharing a collection cannot pick ` +\n        `its database alone), or stop sharing the collection.`,\n    });\n  }\n\n  return incoherences;\n}\n\n/** The minimal config shape {@link findSharedPersistenceCollectionRetentionIncoherences} reads. */\nexport interface SharedPersistenceCollectionRetentionCandidate {\n  readonly resourceIdentifier: ResourceType;\n  readonly retentionPolicy?: { mode?: ErasureRetentionMode } | undefined;\n}\n\n/**\n * Canonical comparison key for a resource's retention POSTURE.\n *\n * Compares the WHOLE resolved policy, not just `mode`. It carries two members since #1635 — `mode` and\n * the nested `statutoryRetention` ground — and this is the case the whole-policy comparison was written\n * for: comparing `mode` alone would let two configs over one collection agree on the treatment while\n * one says a statute keeps the rows and the other does not. Two configs over one collection must agree\n * on ALL of it.\n *\n * Key order is normalised at EVERY depth so authoring order cannot masquerade as a disagreement. `undefined` gets\n * its own key rather than being skipped: \"rows of this resource are hard-deleted\" is a positive\n * claim, and the in-vs-out asymmetry is what produces both failure modes documented below.\n */\nfunction buildRetentionPostureKey(retentionPolicy: { mode?: ErasureRetentionMode } | undefined): string {\n  if (retentionPolicy === undefined || retentionPolicy === null) {\n    return 'NOT_GOVERNED';\n  }\n  const canonical = (value: unknown): unknown => {\n    if (value === null || typeof value !== 'object' || Array.isArray(value)) return value;\n    return Object.entries(value as Record<string, unknown>)\n      .filter(([, member]) => member !== undefined)\n      .sort(([leftKey], [rightKey]) => leftKey.localeCompare(rightKey))\n      .map(([key, member]) => [key, canonical(member)]);\n  };\n  const entries = canonical(retentionPolicy) as unknown[];\n  return entries.length === 0 ? 'NOT_GOVERNED' : JSON.stringify(entries);\n}\n\n/** One collection whose resource configs disagree about retention governance. */\nexport interface SharedPersistenceCollectionRetentionIncoherence {\n  /** The shared collection the disagreeing configs write to. */\n  readonly collectionName: string;\n  /** Every resource config addressing that collection, with the posture it declared. */\n  readonly postures: readonly { resourceType: ResourceType; mode: ErasureRetentionMode | undefined }[];\n  /** Operator-facing explanation naming both failure modes and the fix. */\n  readonly message: string;\n}\n\n/**\n * Registry-ASSEMBLY guardrail: every resource config that resolves to the SAME\n * persistence collection must declare the SAME retention posture.\n *\n * ## Why a config that passes every per-resource check can still be broken\n *\n * `retentionPolicy` is validated PER RESOURCE CONFIG by the config factory: it\n * checks that resource's operations, its field treatments, its system-access\n * grants. It cannot check what a SIBLING config declares, because a factory\n * invocation never sees one. But retention is enforced against ROWS, and two\n * configs can own the same rows (see\n * {@link RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES}). So a pair that\n * disagrees produces a config where every individual resource is valid and the\n * COLLECTION is not.\n *\n * ## The two concrete failure modes\n *\n * **1. Fail-open erasure.** The retention hide filter (rows marked `RETAINED`\n * are invisible) and the immutability freeze are injected per resource config,\n * in `buildContextualFilter`. A row erased through the governed door stays\n * fully READABLE and UPDATABLE through the ungoverned one. For the\n * `USERS`/`USER_SELF` pair that ungoverned door exposes READ + UPDATE to\n * `APP_USER` — i.e. the erased subject can still read and edit their own\n * \"erased\" record. The row is erased only from the door that was opted in,\n * which is a compliance-grade lie about the record.\n *\n * **2. Unique-index collision — a hard functional abort.** A retention-governed\n * config scopes each unique index to NON-retained rows (a partial filter on the\n * retention marker), precisely so scrubbed rows leave the index and cannot\n * collide on the shared mask value. An ungoverned config over the same\n * collection emits a PLAIN unique index on the same field. The FIRST erasure\n * succeeds; the SECOND writes the same mask value, hits the plain index, and\n * fails E11000 — inside the erasure transaction, so the whole erasure rolls\n * back. The capability is silently single-use.\n *\n * Both modes are invisible until a real erasure runs, which is why this is a\n * BOOT-time guard and not a test: the point is that a config which passes at\n * boot must actually be able to perform an erasure.\n *\n * ## Why \"one opted in, one not\" is a disagreement, not a default\n *\n * An absent `retentionPolicy` is a positive statement — \"rows of this resource\n * are hard-deleted\" — not an unset value the governed sibling can supply. Both\n * failure modes above are produced by exactly that asymmetry, so `undefined`\n * participates in the comparison as its own posture rather than being skipped.\n *\n * Pure and side-effect free: it reports, the caller throws. That keeps the\n * shared-collection fact and its invariant in the layer both persistence and\n * validation can import, while the registry owns the error shape.\n *\n * @param resourceConfigurations - every assembled resource config, keyed by resource type.\n * @returns one entry per incoherent collection; empty when the registry is coherent.\n */\nexport function findSharedPersistenceCollectionRetentionIncoherences(\n  resourceConfigurations: Record<string, SharedPersistenceCollectionRetentionCandidate>,\n): SharedPersistenceCollectionRetentionIncoherence[] {\n  const posturesByCollection = new Map<\n    string,\n    { resourceType: ResourceType; mode: ErasureRetentionMode | undefined; postureKey: string }[]\n  >();\n\n  for (const [resourceTypeKey, resourceConfig] of Object.entries(resourceConfigurations)) {\n    // Prefer the config's OWN identifier over the map key: the registry keys by resource type, but a\n    // host that mis-keyed an entry would otherwise be diagnosed against a name it never authored.\n    const resourceType = (resourceConfig?.resourceIdentifier ?? resourceTypeKey) as ResourceType;\n    const collectionName = resolveSharedPersistenceCollectionName(resourceType);\n    const posture = {\n      resourceType,\n      mode: resourceConfig?.retentionPolicy?.mode,\n      postureKey: buildRetentionPostureKey(resourceConfig?.retentionPolicy),\n    };\n\n    const existing = posturesByCollection.get(collectionName);\n    if (existing) {\n      existing.push(posture);\n    } else {\n      posturesByCollection.set(collectionName, [posture]);\n    }\n  }\n\n  const incoherences: SharedPersistenceCollectionRetentionIncoherence[] = [];\n\n  for (const [collectionName, postures] of posturesByCollection) {\n    if (postures.length < 2) {\n      continue;\n    }\n    const distinctPostures = new Set(postures.map((posture) => posture.postureKey));\n    if (distinctPostures.size < 2) {\n      continue;\n    }\n\n    const declared = postures\n      .map((posture) => `'${String(posture.resourceType)}' → ${posture.mode ?? 'NOT retention-governed'}`)\n      .join(', ');\n\n    incoherences.push({\n      collectionName,\n      postures,\n      message:\n        `Resource configs [${declared}] all store in the '${collectionName}' collection but declare ` +\n        `DIFFERENT retention postures. They are separate models over ONE set of rows, and retention is ` +\n        `enforced per resource config, so this ships two defects that only appear when a real erasure ` +\n        `runs: (1) FAIL-OPEN ERASURE — the retention hide filter and the immutability freeze are absent ` +\n        `on the ungoverned door, leaving an erased row readable and updatable there; (2) UNIQUE-INDEX ` +\n        `COLLISION — the governed config scopes its unique indexes to non-retained rows while the ` +\n        `ungoverned one emits plain unique indexes on the same collection, so the SECOND erased row ` +\n        `collides (E11000) and the erasure transaction rolls back. Declare the SAME retentionPolicy on ` +\n        `every config listed above (a resource sharing a collection cannot opt in or out alone), or ` +\n        `stop sharing the collection.`,\n    });\n  }\n\n  return incoherences;\n}\n\n/**\n * The privilege AXES a database credential issued to a named runtime principal (a minion) is built\n * from — one closed vocabulary shared by every storage adapter that mints such a credential.\n *\n * Each axis is a distinct verb set, not a strength on a scale, and they must never be merged:\n *\n * - {@link READ} — read rows.\n * - {@link WRITE} — insert, update and delete. The only axis that can REMOVE a row.\n * - {@link APPEND} — insert only. A principal can add a row and never amend or remove it, which is\n *   what makes it the axis for evidence: an audit trail a principal can rewrite is not an audit trail.\n * - {@link MAINTAIN} — insert and update, never delete, for durable runtime state whose history must\n *   survive the principal that advances it.\n *\n * It lives beside the collection aliases because a grant is issued per COLLECTION: the alias map says\n * which rows a grant on a resource type reaches, and this says which verbs it carries there. The\n * derivation that fills each axis, and the engine floor it adds, live in `platform-config-lib`\n * (`deriveMinionDatabaseGrants`); the MongoDB and PostgreSQL adapters each translate an axis into\n * their own privilege dialect.\n *\n * Scope, stated because it is easy to over-read: this governs NAMED runtime principals only. The\n * application backend is not issued an axis-scoped credential — it owns its database — so nothing\n * here constrains what the backend's own credential can do to a row.\n */\nexport enum RuntimePrincipalDatabaseGrantAxis {\n  READ = 'read',\n  WRITE = 'write',\n  APPEND = 'append',\n  MAINTAIN = 'maintain',\n}\n"]}
+{"version":3,"file":"shared-persistence-collection.utils.js","sourceRoot":"","sources":["../../../../../src/resources/utils/shared-persistence-collection.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import { CoreResourceType } from '../resources.shared.core.definitions';\nimport type { ResourceType } from '../resources.shared.schemas';\nimport type { PersistenceAdapterType } from '../resources-config.shared.schemas';\nimport { ErasureRetentionMode } from '../../compliance/privacy/impersonalization.shared.schemas';\n\n/**\n * Resource types that deliberately project onto ANOTHER resource type's\n * persistence collection — THE authority for \"which configs address the same\n * physical rows?\".\n *\n * ## What this expresses\n *\n * A `USER_SELF*` resource is not a different record set; it is a different DOOR\n * onto the SAME record set, with its own operations, roles and scoping. The\n * `USERS` door is the admin surface (list every user, delete a user); the\n * `USER_SELF` door is the self surface (read/update MY row). They intentionally\n * share `UserSchema` and they intentionally share storage — the persistence\n * layer builds a SEPARATE model per resource config over ONE collection.\n *\n * Anything not listed here stores under its own resource type.\n *\n * ## Why it is a single named authority\n *\n * This mapping had already been copied twice inside the backend (the\n * zod→mongoose model builder, which is what actually creates and reads the\n * collection, and the aggregation collection resolver — whose earlier\n * divergence made every aggregation query a non-existent collection and return\n * zero rows). It now has a third consumer of a completely different kind:\n * {@link findSharedPersistenceCollectionRetentionIncoherences}, a boot-time\n * coherence guard. A per-resource config factory structurally cannot see this\n * relationship — it validates ONE config at a time — so the fact has to live\n * where every layer can read it, and it has to live exactly once.\n *\n * ## The alias belongs to the RESOURCE, not to the storage adapter\n *\n * Every persistence path resolves through this map, and each adapter has\n * exactly ONE composition point that does so: MongoDB's model builder and its\n * aggregation resolver, and — on the SQL side — the single\n * `resolveTableNameForResource` helper that the hybrid planner, the PostgreSQL\n * repository and the boot-time table verifier all call.\n *\n * This was NOT always true, and the way it failed is the reason to keep it\n * true: PostgreSQL used to derive its table name straight from\n * `resourceIdentifier`, so `USER_SELF` planned, wrote and verified a `userself`\n * table while `USERS` used `users`. An adapter choice must never silently\n * change WHICH RECORDS a resource addresses — that is not a storage detail, it\n * is the \"two doors, one record set\" contract itself. On the SQL side the\n * resolved name is additionally normalised into a SQL identifier; casing is an\n * adapter concern, the alias is not.\n *\n * The one thing a shared resolver still cannot see is an alias group whose\n * members are pointed at DIFFERENT adapters — each config is individually\n * valid, and only the pair is wrong. That is what\n * {@link findSharedPersistenceCollectionAdapterIncoherences} fails closed on.\n */\nexport const RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES: Readonly<Record<string, string>> = {\n  [CoreResourceType.USER_SELF]: CoreResourceType.USERS,\n  [CoreResourceType.USER_SELF_PROFILES]: CoreResourceType.USER_PROFILES,\n  [CoreResourceType.USER_SELF_PREFERENCES]: CoreResourceType.USER_PREFERENCES,\n  /*\n   * The application-scoped audit door addresses the organization-scoped resource's rows (#317).\n   *\n   * Unlike the `USER_SELF` group above — where the alias exists so a principal can address its OWN\n   * row through a narrower door — this pair exists because the two doors see DIFFERENT SUBSETS of\n   * one set: the organization door is tenant-filtered and structurally cannot return the rows that\n   * carry no organization (logins, session evictions, application-wide policy changes), which is\n   * 74% of them on a measured dogfood application. Splitting the storage would split the audit\n   * trail itself, so the alias is load-bearing rather than a convenience.\n   */\n  [CoreResourceType.APPLICATION_AUDIT_LOGS]: CoreResourceType.AUDIT_LOGS,\n};\n\n/**\n * The persistence collection a resource type's rows live in — its alias target\n * when it declares one, otherwise the resource type itself.\n *\n * @param resourceType - the resource type whose storage location is wanted.\n * @returns the collection name, as a plain string.\n */\nexport function resolveSharedPersistenceCollectionName(resourceType: ResourceType): string {\n  return RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES[resourceType as string] ?? (resourceType as string);\n}\n\n/** The minimal config shape {@link findSharedPersistenceCollectionAdapterIncoherences} reads. */\nexport interface SharedPersistenceCollectionAdapterCandidate {\n  readonly resourceIdentifier: ResourceType;\n  /** The config's OWN declaration; `undefined` means \"inherit the application default\". */\n  readonly persistenceAdapter?: PersistenceAdapterType | undefined;\n}\n\n/** One collection whose resource configs are pointed at different databases. */\nexport interface SharedPersistenceCollectionAdapterIncoherence {\n  /** The shared collection the disagreeing configs claim to address. */\n  readonly collectionName: string;\n  /** Every resource config addressing that collection, with the adapter it RESOLVED to. */\n  readonly adapters: readonly { resourceType: ResourceType; adapter: PersistenceAdapterType }[];\n  /** Operator-facing explanation naming the consequence and the fix. */\n  readonly message: string;\n}\n\n/**\n * Registry-ASSEMBLY guardrail: every resource config that resolves to the SAME\n * persistence collection must resolve to the SAME persistence adapter.\n *\n * ## Why the shared resolver cannot cover this on its own\n *\n * {@link resolveSharedPersistenceCollectionName} makes the alias\n * adapter-independent: whichever database a resource lands in, it addresses the\n * aliased NAME. That is necessary and not sufficient. A name is only an address\n * WITHIN one database, so pointing `USERS` at PostgreSQL while `USER_SELF`\n * inherits MongoDB yields two stores that both believe they own the same rows.\n * Nothing downstream can detect it: each config is individually valid, each\n * repository is correctly built, and every per-resource check passes.\n *\n * ## The failure it prevents\n *\n * The doors silently stop sharing records. The admin door lists users the self\n * door cannot read; a self-service update writes to a row the admin door will\n * never see; and — because retention is enforced against ROWS — an erasure\n * performed through one door leaves the other door's copy completely\n * untouched, which is the same compliance-grade lie that\n * {@link findSharedPersistenceCollectionRetentionIncoherences} exists to\n * prevent, arrived at from a different direction.\n *\n * The table name is not the only thing that follows from the adapter. Id FORMAT\n * does too — the PostgreSQL repository validates ids as UUIDs while Mongo\n * expects ObjectIds, each resolved from its OWN resource's adapter — so a split\n * group would also reject through one door the very ids the other door mints.\n * Anything keyed on \"this resource's adapter\" inherits this invariant.\n *\n * ## Why this is permanent, not a capability gate\n *\n * Unlike adapter gaps that close when the missing support is implemented, this\n * one has no future in which it becomes valid: two databases cannot hold one\n * set of rows. It is deliberately NOT a ban on aliased resources using\n * PostgreSQL — an alias group that agrees on PostgreSQL resolves to one shared\n * table, and whether that table was actually provisioned is a separate,\n * already-enforced question (the boot-time table verifier).\n *\n * Resources inherit the application default when they declare nothing, so the\n * caller supplies the resolved default rather than this function guessing it.\n *\n * Pure and side-effect free: it reports, the caller throws.\n *\n * @param resourceConfigurations - every assembled resource config, keyed by resource type.\n * @param defaultPersistenceAdapter - the adapter a config with no declaration inherits.\n * @returns one entry per incoherent collection; empty when the registry is coherent.\n */\nexport function findSharedPersistenceCollectionAdapterIncoherences(\n  resourceConfigurations: Record<string, SharedPersistenceCollectionAdapterCandidate>,\n  defaultPersistenceAdapter: PersistenceAdapterType,\n): SharedPersistenceCollectionAdapterIncoherence[] {\n  const adaptersByCollection = new Map<\n    string,\n    { resourceType: ResourceType; adapter: PersistenceAdapterType }[]\n  >();\n\n  for (const [resourceTypeKey, resourceConfig] of Object.entries(resourceConfigurations)) {\n    // Same reasoning as the retention guard: prefer the config's OWN identifier so a mis-keyed\n    // registry entry is diagnosed against the name its author actually wrote.\n    const resourceType = (resourceConfig?.resourceIdentifier ?? resourceTypeKey) as ResourceType;\n    const collectionName = resolveSharedPersistenceCollectionName(resourceType);\n    const entry = {\n      resourceType,\n      adapter: resourceConfig?.persistenceAdapter ?? defaultPersistenceAdapter,\n    };\n\n    const existing = adaptersByCollection.get(collectionName);\n    if (existing) {\n      existing.push(entry);\n    } else {\n      adaptersByCollection.set(collectionName, [entry]);\n    }\n  }\n\n  const incoherences: SharedPersistenceCollectionAdapterIncoherence[] = [];\n\n  for (const [collectionName, adapters] of adaptersByCollection) {\n    if (adapters.length < 2) {\n      continue;\n    }\n    if (new Set(adapters.map((entry) => entry.adapter)).size < 2) {\n      continue;\n    }\n\n    const declared = adapters\n      .map((entry) => `'${String(entry.resourceType)}' → ${entry.adapter}`)\n      .join(', ');\n\n    incoherences.push({\n      collectionName,\n      adapters,\n      message:\n        `Resource configs [${declared}] all address the '${collectionName}' persistence collection but ` +\n        `resolve to DIFFERENT persistence adapters. These configs are separate doors onto ONE set of ` +\n        `rows, and a collection name only addresses rows within a single database, so this splits them ` +\n        `across two stores that each believe they own the records: the admin door lists rows the self ` +\n        `door cannot read, a self-service write lands where the admin door will never see it, and an ` +\n        `erasure performed through one door leaves the other door's copy fully intact. Give every ` +\n        `config listed above the same persistenceAdapter (a resource sharing a collection cannot pick ` +\n        `its database alone), or stop sharing the collection.`,\n    });\n  }\n\n  return incoherences;\n}\n\n/** The minimal config shape {@link findSharedPersistenceCollectionRetentionIncoherences} reads. */\nexport interface SharedPersistenceCollectionRetentionCandidate {\n  readonly resourceIdentifier: ResourceType;\n  readonly retentionPolicy?: { mode?: ErasureRetentionMode } | undefined;\n}\n\n/**\n * Canonical comparison key for a resource's retention POSTURE.\n *\n * Compares the WHOLE resolved policy, not just `mode`. It carries two members since #1635 — `mode` and\n * the nested `statutoryRetention` ground — and this is the case the whole-policy comparison was written\n * for: comparing `mode` alone would let two configs over one collection agree on the treatment while\n * one says a statute keeps the rows and the other does not. Two configs over one collection must agree\n * on ALL of it.\n *\n * Key order is normalised at EVERY depth so authoring order cannot masquerade as a disagreement. `undefined` gets\n * its own key rather than being skipped: \"rows of this resource are hard-deleted\" is a positive\n * claim, and the in-vs-out asymmetry is what produces both failure modes documented below.\n */\nfunction buildRetentionPostureKey(retentionPolicy: { mode?: ErasureRetentionMode } | undefined): string {\n  if (retentionPolicy === undefined || retentionPolicy === null) {\n    return 'NOT_GOVERNED';\n  }\n  const canonical = (value: unknown): unknown => {\n    if (value === null || typeof value !== 'object' || Array.isArray(value)) return value;\n    return Object.entries(value as Record<string, unknown>)\n      .filter(([, member]) => member !== undefined)\n      .sort(([leftKey], [rightKey]) => leftKey.localeCompare(rightKey))\n      .map(([key, member]) => [key, canonical(member)]);\n  };\n  const entries = canonical(retentionPolicy) as unknown[];\n  return entries.length === 0 ? 'NOT_GOVERNED' : JSON.stringify(entries);\n}\n\n/** One collection whose resource configs disagree about retention governance. */\nexport interface SharedPersistenceCollectionRetentionIncoherence {\n  /** The shared collection the disagreeing configs write to. */\n  readonly collectionName: string;\n  /** Every resource config addressing that collection, with the posture it declared. */\n  readonly postures: readonly { resourceType: ResourceType; mode: ErasureRetentionMode | undefined }[];\n  /** Operator-facing explanation naming both failure modes and the fix. */\n  readonly message: string;\n}\n\n/**\n * Registry-ASSEMBLY guardrail: every resource config that resolves to the SAME\n * persistence collection must declare the SAME retention posture.\n *\n * ## Why a config that passes every per-resource check can still be broken\n *\n * `retentionPolicy` is validated PER RESOURCE CONFIG by the config factory: it\n * checks that resource's operations, its field treatments, its system-access\n * grants. It cannot check what a SIBLING config declares, because a factory\n * invocation never sees one. But retention is enforced against ROWS, and two\n * configs can own the same rows (see\n * {@link RESOURCE_SHARED_PERSISTENCE_COLLECTION_ALIASES}). So a pair that\n * disagrees produces a config where every individual resource is valid and the\n * COLLECTION is not.\n *\n * ## The two concrete failure modes\n *\n * **1. Fail-open erasure.** The retention hide filter (rows marked `RETAINED`\n * are invisible) and the immutability freeze are injected per resource config,\n * in `buildContextualFilter`. A row erased through the governed door stays\n * fully READABLE and UPDATABLE through the ungoverned one. For the\n * `USERS`/`USER_SELF` pair that ungoverned door exposes READ + UPDATE to\n * `APP_USER` — i.e. the erased subject can still read and edit their own\n * \"erased\" record. The row is erased only from the door that was opted in,\n * which is a compliance-grade lie about the record.\n *\n * **2. Unique-index collision — a hard functional abort.** A retention-governed\n * config scopes each unique index to NON-retained rows (a partial filter on the\n * retention marker), precisely so scrubbed rows leave the index and cannot\n * collide on the shared mask value. An ungoverned config over the same\n * collection emits a PLAIN unique index on the same field. The FIRST erasure\n * succeeds; the SECOND writes the same mask value, hits the plain index, and\n * fails E11000 — inside the erasure transaction, so the whole erasure rolls\n * back. The capability is silently single-use.\n *\n * Both modes are invisible until a real erasure runs, which is why this is a\n * BOOT-time guard and not a test: the point is that a config which passes at\n * boot must actually be able to perform an erasure.\n *\n * ## Why \"one opted in, one not\" is a disagreement, not a default\n *\n * An absent `retentionPolicy` is a positive statement — \"rows of this resource\n * are hard-deleted\" — not an unset value the governed sibling can supply. Both\n * failure modes above are produced by exactly that asymmetry, so `undefined`\n * participates in the comparison as its own posture rather than being skipped.\n *\n * Pure and side-effect free: it reports, the caller throws. That keeps the\n * shared-collection fact and its invariant in the layer both persistence and\n * validation can import, while the registry owns the error shape.\n *\n * @param resourceConfigurations - every assembled resource config, keyed by resource type.\n * @returns one entry per incoherent collection; empty when the registry is coherent.\n */\nexport function findSharedPersistenceCollectionRetentionIncoherences(\n  resourceConfigurations: Record<string, SharedPersistenceCollectionRetentionCandidate>,\n): SharedPersistenceCollectionRetentionIncoherence[] {\n  const posturesByCollection = new Map<\n    string,\n    { resourceType: ResourceType; mode: ErasureRetentionMode | undefined; postureKey: string }[]\n  >();\n\n  for (const [resourceTypeKey, resourceConfig] of Object.entries(resourceConfigurations)) {\n    // Prefer the config's OWN identifier over the map key: the registry keys by resource type, but a\n    // host that mis-keyed an entry would otherwise be diagnosed against a name it never authored.\n    const resourceType = (resourceConfig?.resourceIdentifier ?? resourceTypeKey) as ResourceType;\n    const collectionName = resolveSharedPersistenceCollectionName(resourceType);\n    const posture = {\n      resourceType,\n      mode: resourceConfig?.retentionPolicy?.mode,\n      postureKey: buildRetentionPostureKey(resourceConfig?.retentionPolicy),\n    };\n\n    const existing = posturesByCollection.get(collectionName);\n    if (existing) {\n      existing.push(posture);\n    } else {\n      posturesByCollection.set(collectionName, [posture]);\n    }\n  }\n\n  const incoherences: SharedPersistenceCollectionRetentionIncoherence[] = [];\n\n  for (const [collectionName, postures] of posturesByCollection) {\n    if (postures.length < 2) {\n      continue;\n    }\n    const distinctPostures = new Set(postures.map((posture) => posture.postureKey));\n    if (distinctPostures.size < 2) {\n      continue;\n    }\n\n    const declared = postures\n      .map((posture) => `'${String(posture.resourceType)}' → ${posture.mode ?? 'NOT retention-governed'}`)\n      .join(', ');\n\n    incoherences.push({\n      collectionName,\n      postures,\n      message:\n        `Resource configs [${declared}] all store in the '${collectionName}' collection but declare ` +\n        `DIFFERENT retention postures. They are separate models over ONE set of rows, and retention is ` +\n        `enforced per resource config, so this ships two defects that only appear when a real erasure ` +\n        `runs: (1) FAIL-OPEN ERASURE — the retention hide filter and the immutability freeze are absent ` +\n        `on the ungoverned door, leaving an erased row readable and updatable there; (2) UNIQUE-INDEX ` +\n        `COLLISION — the governed config scopes its unique indexes to non-retained rows while the ` +\n        `ungoverned one emits plain unique indexes on the same collection, so the SECOND erased row ` +\n        `collides (E11000) and the erasure transaction rolls back. Declare the SAME retentionPolicy on ` +\n        `every config listed above (a resource sharing a collection cannot opt in or out alone), or ` +\n        `stop sharing the collection.`,\n    });\n  }\n\n  return incoherences;\n}\n\n/**\n * The privilege AXES a database credential issued to a named runtime principal (a minion) is built\n * from — one closed vocabulary shared by every storage adapter that mints such a credential.\n *\n * Each axis is a distinct verb set, not a strength on a scale, and they must never be merged:\n *\n * - {@link READ} — read rows.\n * - {@link WRITE} — insert, update and delete. The only axis that can REMOVE a row.\n * - {@link APPEND} — insert only. A principal can add a row and never amend or remove it, which is\n *   what makes it the axis for evidence: an audit trail a principal can rewrite is not an audit trail.\n * - {@link MAINTAIN} — insert and update, never delete, for durable runtime state whose history must\n *   survive the principal that advances it.\n *\n * It lives beside the collection aliases because a grant is issued per COLLECTION: the alias map says\n * which rows a grant on a resource type reaches, and this says which verbs it carries there. The\n * derivation that fills each axis, and the engine floor it adds, live in `platform-config-lib`\n * (`deriveMinionDatabaseGrants`); the MongoDB and PostgreSQL adapters each translate an axis into\n * their own privilege dialect.\n *\n * Scope, stated because it is easy to over-read: this governs NAMED runtime principals only. The\n * application backend is not issued an axis-scoped credential — it owns its database — so nothing\n * here constrains what the backend's own credential can do to a row.\n */\nexport enum RuntimePrincipalDatabaseGrantAxis {\n  READ = 'read',\n  WRITE = 'write',\n  APPEND = 'append',\n  MAINTAIN = 'maintain',\n}\n"]}

package/dist/esm/resources/utils/templatable-file-fields.shared.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"templatable-file-fields.shared.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/templatable-file-fields.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAkBL,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,iCAAiC;IAChD,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,KAChC,CAAC,CAAC,UAAU,CAAC;CACnB;AAiBD,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,yCAA0C,SAAQ,KAAK;aAEhD,SAAS,EAAE,MAAM;aACjB,gBAAgB,EAAE,kBAAkB,GAAG,SAAS;aAChD,mBAAmB,EAAE,kBAAkB,GAAG,SAAS;gBAFnD,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,kBAAkB,GAAG,SAAS,EAChD,mBAAmB,EAAE,kBAAkB,GAAG,SAAS;CAOtE;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,UAAU,SAAK,EACf,aAAa,UAAQ,EACrB,aAAa,GAAE,OAAO,CAAC,MAAM,CAAyB,GACrD,wBAAwB,EAAE,CAmG5B;AAmDD;;;;;GAKG;AACH,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,OAAO,GAAE,iCAAsC,EAC/C,aAAa,GAAE,OAAO,CAAC,MAAM,CAAyB,GACrD,CAAC,CAAC,UAAU,CAgOd"}
+{"version":3,"file":"templatable-file-fields.shared.utils.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/templatable-file-fields.shared.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAkBL,KAAK,kBAAkB,EACxB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,WAAW,iCAAiC;IAChD,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EACxB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,KAChC,CAAC,CAAC,UAAU,CAAC;CACnB;AAiBD,MAAM,WAAW,wBAAwB;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC;IACrB,aAAa,EAAE,OAAO,CAAC;CACxB;AAED,qBAAa,yCAA0C,SAAQ,KAAK;aAEhD,SAAS,EAAE,MAAM;aACjB,gBAAgB,EAAE,kBAAkB,GAAG,SAAS;aAChD,mBAAmB,EAAE,kBAAkB,GAAG,SAAS;gBAFnD,SAAS,EAAE,MAAM,EACjB,gBAAgB,EAAE,kBAAkB,GAAG,SAAS,EAChD,mBAAmB,EAAE,kBAAkB,GAAG,SAAS;CAOtE;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,UAAU,SAAK,EACf,aAAa,UAAQ,EACrB,aAAa,GAAE,OAAO,CAAC,MAAM,CAAyB,GACrD,wBAAwB,EAAE,CAmG5B;AAmDD;;;;;GAKG;AACH,wBAAgB,qCAAqC,CACnD,MAAM,EAAE,CAAC,CAAC,UAAU,EACpB,OAAO,GAAE,iCAAsC,EAC/C,aAAa,GAAE,OAAO,CAAC,MAAM,CAAyB,GACrD,CAAC,CAAC,UAAU,CAgOd"}

package/dist/esm/resources/utils/templatable-file-fields.shared.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"templatable-file-fields.shared.utils.js","sourceRoot":"","sources":["../../../../src/resources/utils/templatable-file-fields.shared.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  getFileMetadata,\n  getZodDefArrayProperty,\n  getZodDef,\n  getZodDefProperty,\n  getZodDefSchemaProperty,\n  getZodDefStringProperty,\n  getZodObjectShape,\n  getZodType,\n  isTemplatableFileField,\n  isZodArray,\n  isZodDefault,\n  isZodNullable,\n  isZodObject,\n  isZodOptional,\n  SCHEMA_METADATA,\n  unwrapSchema,\n  withArrayElement,\n  type FileSchemaMetadata,\n} from '@wildo-ai/zod-decorators';\nimport { z } from 'zod';\n\nexport interface StripTemplatableFileFieldsOptions {\n  rebuildObjectSchema?: (\n    schema: z.ZodObject<any>,\n    shape: Record<string, z.ZodTypeAny>,\n  ) => z.ZodTypeAny;\n}\n\n/**\n * Carry decorator metadata (`SCHEMA_METADATA`) from a schema onto the instance that replaces it.\n *\n * Structured value types (`z_address`, `z_file`, `z_money`, `z_range`, …) record their identity as\n * metadata on the schema INSTANCE. A rebuild that does not carry it turns the field into a plain\n * object, and the form then renders its parts as unrelated inputs.\n */\nfunction carrySchemaMetadata<TSchema extends z.ZodTypeAny>(source: z.ZodTypeAny, rebuilt: TSchema): TSchema {\n  const metadata = (source as any)[SCHEMA_METADATA];\n  if (metadata !== undefined) {\n    (rebuilt as any)[SCHEMA_METADATA] = metadata;\n  }\n  return rebuilt;\n}\n\nexport interface TemplatableFileFieldPath {\n  fieldName: string;\n  schema: z.ZodTypeAny;\n  isInsideArray: boolean;\n}\n\nexport class IncompatibleTemplatableFileFieldPathError extends Error {\n  constructor(\n    public readonly fieldName: string,\n    public readonly existingMetadata: FileSchemaMetadata | undefined,\n    public readonly conflictingMetadata: FileSchemaMetadata | undefined,\n  ) {\n    super(\n      `Incompatible generated file metadata detected for templatable file field path \"${fieldName}\".`,\n    );\n    this.name = 'IncompatibleTemplatableFileFieldPathError';\n  }\n}\n\nexport function collectTemplatableFileFieldPaths(\n  schema: z.ZodTypeAny,\n  pathPrefix = '',\n  isInsideArray = false,\n  activeSchemas: WeakSet<object> = new WeakSet<object>(),\n): TemplatableFileFieldPath[] {\n  if (activeSchemas.has(schema)) {\n    return [];\n  }\n\n  activeSchemas.add(schema);\n  try {\n    const rawSchemaType = getZodType(schema);\n    if (rawSchemaType === 'pipe') {\n      const inSchema = getZodDefSchemaProperty(schema, 'in');\n      const outSchema = getZodDefSchemaProperty(schema, 'out');\n      return mergeTemplatableFileFieldPaths([\n        ...(inSchema ? collectTemplatableFileFieldPaths(inSchema, pathPrefix, isInsideArray, activeSchemas) : []),\n        ...(outSchema ? collectTemplatableFileFieldPaths(outSchema, pathPrefix, isInsideArray, activeSchemas) : []),\n      ]);\n    }\n\n    if (isZodOptional(schema) || isZodNullable(schema) || isZodDefault(schema)) {\n      const innerSchema = getZodDefSchemaProperty(schema, 'innerType');\n      return innerSchema\n        ? collectTemplatableFileFieldPaths(innerSchema, pathPrefix, isInsideArray, activeSchemas)\n        : [];\n    }\n\n    const unwrappedSchema = unwrapSchema(schema);\n    if (unwrappedSchema !== schema) {\n      return collectTemplatableFileFieldPaths(unwrappedSchema, pathPrefix, isInsideArray, activeSchemas);\n    }\n\n    if (isTemplatableFileField(unwrappedSchema)) {\n      return pathPrefix ? [{ fieldName: pathPrefix, schema: unwrappedSchema, isInsideArray }] : [];\n    }\n\n    const schemaType = getZodType(unwrappedSchema);\n    if (schemaType === 'lazy') {\n      const lazyGetter = getZodDef(unwrappedSchema)?.getter;\n      const lazySchema = typeof lazyGetter === 'function'\n        ? lazyGetter()\n        : undefined;\n      return lazySchema\n        ? collectTemplatableFileFieldPaths(lazySchema as z.ZodTypeAny, pathPrefix, isInsideArray, activeSchemas)\n        : [];\n    }\n\n    if (schemaType === 'intersection') {\n      const leftSchema = getZodDefSchemaProperty(unwrappedSchema, 'left');\n      const rightSchema = getZodDefSchemaProperty(unwrappedSchema, 'right');\n      return mergeTemplatableFileFieldPaths([\n        ...(leftSchema ? collectTemplatableFileFieldPaths(leftSchema, pathPrefix, isInsideArray, activeSchemas) : []),\n        ...(rightSchema ? collectTemplatableFileFieldPaths(rightSchema, pathPrefix, isInsideArray, activeSchemas) : []),\n      ]);\n    }\n\n    if (schemaType === 'union') {\n      const unionOptions = getZodDefArrayProperty(unwrappedSchema, 'options') as z.ZodTypeAny[] | undefined;\n      return mergeTemplatableFileFieldPaths(\n        (unionOptions ?? []).flatMap((option) =>\n          collectTemplatableFileFieldPaths(option, pathPrefix, isInsideArray, activeSchemas)\n        ),\n      );\n    }\n\n    if (isZodArray(unwrappedSchema)) {\n      const elementSchema = getZodDefProperty(unwrappedSchema, 'element') as z.ZodTypeAny | undefined;\n      return elementSchema ? collectTemplatableFileFieldPaths(elementSchema, pathPrefix, true, activeSchemas) : [];\n    }\n\n    if (schemaType === 'record' || schemaType === 'map' || schemaType === 'set') {\n      const valueSchema = getZodDefSchemaProperty(unwrappedSchema, 'valueType');\n      return valueSchema\n        ? collectTemplatableFileFieldPaths(valueSchema, pathPrefix, true, activeSchemas)\n        : [];\n    }\n\n    if (schemaType === 'tuple') {\n      const tupleItems = getZodDefArrayProperty(unwrappedSchema, 'items') as z.ZodTypeAny[] | undefined;\n      const restSchema = getZodDefSchemaProperty(unwrappedSchema, 'rest');\n      return mergeTemplatableFileFieldPaths([\n        ...((tupleItems ?? []).flatMap((item) =>\n          collectTemplatableFileFieldPaths(item, pathPrefix, true, activeSchemas)\n        )),\n        ...(restSchema ? collectTemplatableFileFieldPaths(restSchema, pathPrefix, true, activeSchemas) : []),\n      ]);\n    }\n\n    if (!isZodObject(unwrappedSchema)) {\n      return [];\n    }\n\n    const shape = getZodObjectShape(unwrappedSchema);\n    return mergeTemplatableFileFieldPaths(\n      Object.entries(shape).flatMap(([fieldName, fieldSchema]) => {\n        const nextPath = pathPrefix ? `${pathPrefix}.${fieldName}` : fieldName;\n        return collectTemplatableFileFieldPaths(fieldSchema as z.ZodTypeAny, nextPath, isInsideArray, activeSchemas);\n      }),\n    );\n  } finally {\n    activeSchemas.delete(schema);\n  }\n}\n\nfunction mergeTemplatableFileFieldPaths(\n  fields: TemplatableFileFieldPath[],\n): TemplatableFileFieldPath[] {\n  const byFieldName = new Map<string, TemplatableFileFieldPath>();\n  for (const field of fields) {\n    const existing = byFieldName.get(field.fieldName);\n    if (existing && !areTemplatableFileMetadataCompatible(existing.schema, field.schema)) {\n      throw new IncompatibleTemplatableFileFieldPathError(\n        field.fieldName,\n        getFileMetadata(existing.schema),\n        getFileMetadata(field.schema),\n      );\n    }\n    byFieldName.set(field.fieldName, existing\n      ? {\n          ...existing,\n          isInsideArray: existing.isInsideArray || field.isInsideArray,\n        }\n      : field);\n  }\n  return Array.from(byFieldName.values()).sort((left, right) =>\n    left.fieldName.localeCompare(right.fieldName)\n  );\n}\n\nfunction normalizeMetadataForComparison(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map(normalizeMetadataForComparison);\n  }\n\n  if (value && typeof value === 'object') {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>)\n        .sort(([left], [right]) => left.localeCompare(right))\n        .map(([key, childValue]) => [key, normalizeMetadataForComparison(childValue)]),\n    );\n  }\n\n  return value;\n}\n\nfunction areTemplatableFileMetadataCompatible(\n  leftSchema: z.ZodTypeAny,\n  rightSchema: z.ZodTypeAny,\n): boolean {\n  return JSON.stringify(normalizeMetadataForComparison(getFileMetadata(leftSchema)))\n    === JSON.stringify(normalizeMetadataForComparison(getFileMetadata(rightSchema)));\n}\n\n/**\n * Remove generated PDF file fields from request DTO schemas, including nested\n * structures and union arms. These fields are framework-owned outputs, so they\n * must never appear in frontend/authored write DTOs even when custom DTOs are\n * provided by an application.\n */\nexport function stripTemplatableFileFieldsRecursively(\n  schema: z.ZodTypeAny,\n  options: StripTemplatableFileFieldsOptions = {},\n  activeSchemas: WeakSet<object> = new WeakSet<object>(),\n): z.ZodTypeAny {\n  if (activeSchemas.has(schema)) {\n    return schema;\n  }\n  activeSchemas.add(schema);\n\n  try {\n    /*\n     * Wrappers hand back the ORIGINAL instance when nothing beneath them changed (#989).\n     *\n     * They used to rebuild `inner.optional()` unconditionally. A fresh wrapper is a different\n     * instance, so the enclosing object read it as \"changed\" and was rebuilt too — and the rebuild\n     * dropped the object's decorator metadata. A `z_address()` nested in any object therefore reached\n     * the create and update request DTOs as a plain object, and the form rendered its parts as\n     * unrelated text inputs. Identity is what tells the object branch nothing was stripped.\n     */\n    if (isZodOptional(schema)) {\n      const innerSchema = getZodDefSchemaProperty(schema, 'innerType');\n      if (!innerSchema) {\n        return schema;\n      }\n      const strippedInner = stripTemplatableFileFieldsRecursively(innerSchema, options, activeSchemas);\n      return strippedInner === innerSchema ? schema : carrySchemaMetadata(schema, strippedInner.optional());\n    }\n\n    if (isZodNullable(schema)) {\n      const innerSchema = getZodDefSchemaProperty(schema, 'innerType');\n      if (!innerSchema) {\n        return schema;\n      }\n      const strippedInner = stripTemplatableFileFieldsRecursively(innerSchema, options, activeSchemas);\n      return strippedInner === innerSchema ? schema : carrySchemaMetadata(schema, strippedInner.nullable());\n    }\n\n    if (isZodDefault(schema)) {\n      const innerSchema = getZodDefSchemaProperty(schema, 'innerType');\n      if (!innerSchema) {\n        return schema;\n      }\n      const strippedInner = stripTemplatableFileFieldsRecursively(innerSchema, options, activeSchemas);\n      if (strippedInner === innerSchema) {\n        return schema;\n      }\n      // Re-READ the default per parse rather than carrying a value across. In Zod 4\n      // `def.defaultValue` is a GETTER, so reading it here EVALUATES the default —\n      // and this stripped schema is built once, at configuration time, so a value\n      // read here would be frozen into every parse the process performs. (The old\n      // `typeof defaultValue === 'function'` branch could never fire for a dynamic\n      // default for the same reason: the getter returns the VALUE, not the factory.)\n      return carrySchemaMetadata(schema, strippedInner.default(() => getZodDefProperty(schema, 'defaultValue') as unknown));\n    }\n\n    const schemaType = getZodType(schema);\n    if (schemaType === 'pipe') {\n      const inSchema = getZodDefSchemaProperty(schema, 'in');\n      const outSchema = getZodDefSchemaProperty(schema, 'out');\n      const strippedIn = inSchema\n        ? stripTemplatableFileFieldsRecursively(inSchema, options, activeSchemas)\n        : inSchema;\n      const strippedOut = outSchema\n        ? stripTemplatableFileFieldsRecursively(outSchema, options, activeSchemas)\n        : outSchema;\n      if (strippedIn === inSchema && strippedOut === outSchema) {\n        return schema;\n      }\n      if (strippedIn && strippedOut) {\n        return z.pipe(strippedIn, strippedOut);\n      }\n      return strippedOut ?? strippedIn ?? schema;\n    }\n\n    if (schemaType === 'lazy') {\n      const lazyGetter = getZodDef(schema)?.getter;\n      if (typeof lazyGetter !== 'function') {\n        return schema;\n      }\n      return z.lazy(() =>\n        stripTemplatableFileFieldsRecursively(lazyGetter() as z.ZodTypeAny, options, activeSchemas)\n      );\n    }\n\n    if (schemaType === 'intersection') {\n      const leftSchema = getZodDefSchemaProperty(schema, 'left');\n      const rightSchema = getZodDefSchemaProperty(schema, 'right');\n      const strippedLeft = leftSchema\n        ? stripTemplatableFileFieldsRecursively(leftSchema, options, activeSchemas)\n        : leftSchema;\n      const strippedRight = rightSchema\n        ? stripTemplatableFileFieldsRecursively(rightSchema, options, activeSchemas)\n        : rightSchema;\n      return strippedLeft === leftSchema && strippedRight === rightSchema\n        ? schema\n        : z.intersection(strippedLeft ?? z.object({}), strippedRight ?? z.object({}));\n    }\n\n    if (schemaType === 'union') {\n      const discriminator = getZodDefStringProperty(schema, 'discriminator');\n      const unionOptions = getZodDefArrayProperty(schema, 'options') as z.ZodTypeAny[] | undefined;\n      if (!unionOptions?.length) {\n        return schema;\n      }\n\n      const strippedOptions = unionOptions.map((option) =>\n        stripTemplatableFileFieldsRecursively(option, options, activeSchemas)\n      );\n      if (strippedOptions.length < 2) {\n        return strippedOptions[0] ?? schema;\n      }\n      if (strippedOptions.every((option, index) => option === unionOptions[index])) {\n        return schema;\n      }\n\n      const rebuiltUnion: z.ZodTypeAny = discriminator\n        ? z.discriminatedUnion(\n            discriminator,\n            strippedOptions as [z.ZodObject<any>, z.ZodObject<any>, ...z.ZodObject<any>[]],\n          )\n        : z.union(strippedOptions as [z.ZodTypeAny, z.ZodTypeAny, ...z.ZodTypeAny[]]);\n      return carrySchemaMetadata(schema, rebuiltUnion);\n    }\n\n    if (isZodArray(schema)) {\n      const elementSchema = getZodDefProperty(schema, 'element') as z.ZodTypeAny | undefined;\n      if (!elementSchema) {\n        return schema;\n      }\n\n      const strippedElement = stripTemplatableFileFieldsRecursively(elementSchema, options, activeSchemas);\n\n      // Nothing to strip inside the element — hand back the ORIGINAL schema, the same way the\n      // intersection / record / map branches do.\n      if (strippedElement === elementSchema) {\n        return schema;\n      }\n\n      // The element WAS rewritten. `withArrayElement` keeps the array's own `.min()` / `.max()` /\n      // `.length()` checks across the swap; a plain `z.array(strippedElement)` — what this branch\n      // used to do unconditionally — drops them, so an authored constraint never reached the DTO\n      // the controller and repository validate against.\n      return withArrayElement(schema, strippedElement);\n    }\n\n    if (schemaType === 'record') {\n      const keySchema = getZodDefSchemaProperty(schema, 'keyType');\n      const valueSchema = getZodDefSchemaProperty(schema, 'valueType');\n      const strippedValue = valueSchema\n        ? stripTemplatableFileFieldsRecursively(valueSchema, options, activeSchemas)\n        : valueSchema;\n      return valueSchema && strippedValue !== valueSchema\n        ? z.record((keySchema ?? z.string()) as any, strippedValue)\n        : schema;\n    }\n\n    if (schemaType === 'map') {\n      const keySchema = getZodDefSchemaProperty(schema, 'keyType');\n      const valueSchema = getZodDefSchemaProperty(schema, 'valueType');\n      const strippedValue = valueSchema\n        ? stripTemplatableFileFieldsRecursively(valueSchema, options, activeSchemas)\n        : valueSchema;\n      return keySchema && valueSchema && strippedValue !== valueSchema\n        ? z.map(keySchema, strippedValue)\n        : schema;\n    }\n\n    if (schemaType === 'set') {\n      const valueSchema = getZodDefSchemaProperty(schema, 'valueType');\n      const strippedValue = valueSchema\n        ? stripTemplatableFileFieldsRecursively(valueSchema, options, activeSchemas)\n        : valueSchema;\n      return valueSchema && strippedValue !== valueSchema\n        ? z.set(strippedValue)\n        : schema;\n    }\n\n    if (schemaType === 'tuple') {\n      const tupleItems = getZodDefArrayProperty(schema, 'items') as z.ZodTypeAny[] | undefined;\n      const restSchema = getZodDefSchemaProperty(schema, 'rest');\n      const strippedItems = (tupleItems ?? []).map((item) =>\n        stripTemplatableFileFieldsRecursively(item, options, activeSchemas)\n      );\n      const strippedRest = restSchema\n        ? stripTemplatableFileFieldsRecursively(restSchema, options, activeSchemas)\n        : restSchema;\n      const changed = strippedItems.some((item, index) => item !== tupleItems?.[index])\n        || strippedRest !== restSchema;\n      if (!changed) {\n        return schema;\n      }\n      const rebuiltTuple = z.tuple(strippedItems as any);\n      return strippedRest ? rebuiltTuple.rest(strippedRest) : rebuiltTuple;\n    }\n\n    if (!isZodObject(schema)) {\n      return schema;\n    }\n\n    const shape = getZodObjectShape(schema);\n    const strippedShape: Record<string, z.ZodTypeAny> = {};\n    let changed = false;\n\n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      const typedSchema = fieldSchema as z.ZodTypeAny;\n      if (isTemplatableFileField(typedSchema)) {\n        changed = true;\n        continue;\n      }\n\n      const strippedSchema = stripTemplatableFileFieldsRecursively(typedSchema, options, activeSchemas);\n      if (strippedSchema !== typedSchema) {\n        changed = true;\n      }\n      strippedShape[fieldName] = strippedSchema;\n    }\n\n    if (!changed) {\n      return schema;\n    }\n\n    return options.rebuildObjectSchema\n      ? options.rebuildObjectSchema(schema, strippedShape)\n      : rebuildObjectSchemaPreservingSemantics(schema, strippedShape);\n  } finally {\n    activeSchemas.delete(schema);\n  }\n}\n\nfunction rebuildObjectSchemaPreservingSemantics(\n  schema: z.ZodObject<any>,\n  strippedShape: Record<string, z.ZodTypeAny>,\n): z.ZodTypeAny {\n  const originalShape = getZodObjectShape(schema);\n  const removedFields = Object.keys(originalShape).filter((fieldName) => !(fieldName in strippedShape));\n\n  try {\n    const omittedSchema = removedFields.length > 0\n      ? schema.omit(Object.fromEntries(removedFields.map((fieldName) => [fieldName, true])) as Record<string, true>)\n      : schema;\n\n    const extended = omittedSchema.extend(strippedShape);\n    // Same field set, only a nested field replaced: the object is still what its metadata describes.\n    // A field REMOVED means it may not be, so the metadata stays behind on that path (#989).\n    return removedFields.length === 0 ? carrySchemaMetadata(schema, extended) : extended;\n  } catch {\n    const rebuiltSchema = z.object(strippedShape);\n    const catchallSchema = getZodDefProperty(schema, 'catchall') as z.ZodTypeAny | undefined;\n    const rebuilt = catchallSchema ? rebuiltSchema.catchall(catchallSchema) : rebuiltSchema;\n    return removedFields.length === 0 ? carrySchemaMetadata(schema, rebuilt) : rebuilt;\n  }\n}\n"]}
+{"version":3,"file":"templatable-file-fields.shared.utils.js","sourceRoot":"","sources":["../../../../../src/resources/utils/templatable-file-fields.shared.utils.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n  getFileMetadata,\n  getZodDefArrayProperty,\n  getZodDef,\n  getZodDefProperty,\n  getZodDefSchemaProperty,\n  getZodDefStringProperty,\n  getZodObjectShape,\n  getZodType,\n  isTemplatableFileField,\n  isZodArray,\n  isZodDefault,\n  isZodNullable,\n  isZodObject,\n  isZodOptional,\n  SCHEMA_METADATA,\n  unwrapSchema,\n  withArrayElement,\n  type FileSchemaMetadata,\n} from '@wildo-ai/zod-decorators';\nimport { z } from 'zod';\n\nexport interface StripTemplatableFileFieldsOptions {\n  rebuildObjectSchema?: (\n    schema: z.ZodObject<any>,\n    shape: Record<string, z.ZodTypeAny>,\n  ) => z.ZodTypeAny;\n}\n\n/**\n * Carry decorator metadata (`SCHEMA_METADATA`) from a schema onto the instance that replaces it.\n *\n * Structured value types (`z_address`, `z_file`, `z_money`, `z_range`, …) record their identity as\n * metadata on the schema INSTANCE. A rebuild that does not carry it turns the field into a plain\n * object, and the form then renders its parts as unrelated inputs.\n */\nfunction carrySchemaMetadata<TSchema extends z.ZodTypeAny>(source: z.ZodTypeAny, rebuilt: TSchema): TSchema {\n  const metadata = (source as any)[SCHEMA_METADATA];\n  if (metadata !== undefined) {\n    (rebuilt as any)[SCHEMA_METADATA] = metadata;\n  }\n  return rebuilt;\n}\n\nexport interface TemplatableFileFieldPath {\n  fieldName: string;\n  schema: z.ZodTypeAny;\n  isInsideArray: boolean;\n}\n\nexport class IncompatibleTemplatableFileFieldPathError extends Error {\n  constructor(\n    public readonly fieldName: string,\n    public readonly existingMetadata: FileSchemaMetadata | undefined,\n    public readonly conflictingMetadata: FileSchemaMetadata | undefined,\n  ) {\n    super(\n      `Incompatible generated file metadata detected for templatable file field path \"${fieldName}\".`,\n    );\n    this.name = 'IncompatibleTemplatableFileFieldPathError';\n  }\n}\n\nexport function collectTemplatableFileFieldPaths(\n  schema: z.ZodTypeAny,\n  pathPrefix = '',\n  isInsideArray = false,\n  activeSchemas: WeakSet<object> = new WeakSet<object>(),\n): TemplatableFileFieldPath[] {\n  if (activeSchemas.has(schema)) {\n    return [];\n  }\n\n  activeSchemas.add(schema);\n  try {\n    const rawSchemaType = getZodType(schema);\n    if (rawSchemaType === 'pipe') {\n      const inSchema = getZodDefSchemaProperty(schema, 'in');\n      const outSchema = getZodDefSchemaProperty(schema, 'out');\n      return mergeTemplatableFileFieldPaths([\n        ...(inSchema ? collectTemplatableFileFieldPaths(inSchema, pathPrefix, isInsideArray, activeSchemas) : []),\n        ...(outSchema ? collectTemplatableFileFieldPaths(outSchema, pathPrefix, isInsideArray, activeSchemas) : []),\n      ]);\n    }\n\n    if (isZodOptional(schema) || isZodNullable(schema) || isZodDefault(schema)) {\n      const innerSchema = getZodDefSchemaProperty(schema, 'innerType');\n      return innerSchema\n        ? collectTemplatableFileFieldPaths(innerSchema, pathPrefix, isInsideArray, activeSchemas)\n        : [];\n    }\n\n    const unwrappedSchema = unwrapSchema(schema);\n    if (unwrappedSchema !== schema) {\n      return collectTemplatableFileFieldPaths(unwrappedSchema, pathPrefix, isInsideArray, activeSchemas);\n    }\n\n    if (isTemplatableFileField(unwrappedSchema)) {\n      return pathPrefix ? [{ fieldName: pathPrefix, schema: unwrappedSchema, isInsideArray }] : [];\n    }\n\n    const schemaType = getZodType(unwrappedSchema);\n    if (schemaType === 'lazy') {\n      const lazyGetter = getZodDef(unwrappedSchema)?.getter;\n      const lazySchema = typeof lazyGetter === 'function'\n        ? lazyGetter()\n        : undefined;\n      return lazySchema\n        ? collectTemplatableFileFieldPaths(lazySchema as z.ZodTypeAny, pathPrefix, isInsideArray, activeSchemas)\n        : [];\n    }\n\n    if (schemaType === 'intersection') {\n      const leftSchema = getZodDefSchemaProperty(unwrappedSchema, 'left');\n      const rightSchema = getZodDefSchemaProperty(unwrappedSchema, 'right');\n      return mergeTemplatableFileFieldPaths([\n        ...(leftSchema ? collectTemplatableFileFieldPaths(leftSchema, pathPrefix, isInsideArray, activeSchemas) : []),\n        ...(rightSchema ? collectTemplatableFileFieldPaths(rightSchema, pathPrefix, isInsideArray, activeSchemas) : []),\n      ]);\n    }\n\n    if (schemaType === 'union') {\n      const unionOptions = getZodDefArrayProperty(unwrappedSchema, 'options') as z.ZodTypeAny[] | undefined;\n      return mergeTemplatableFileFieldPaths(\n        (unionOptions ?? []).flatMap((option) =>\n          collectTemplatableFileFieldPaths(option, pathPrefix, isInsideArray, activeSchemas)\n        ),\n      );\n    }\n\n    if (isZodArray(unwrappedSchema)) {\n      const elementSchema = getZodDefProperty(unwrappedSchema, 'element') as z.ZodTypeAny | undefined;\n      return elementSchema ? collectTemplatableFileFieldPaths(elementSchema, pathPrefix, true, activeSchemas) : [];\n    }\n\n    if (schemaType === 'record' || schemaType === 'map' || schemaType === 'set') {\n      const valueSchema = getZodDefSchemaProperty(unwrappedSchema, 'valueType');\n      return valueSchema\n        ? collectTemplatableFileFieldPaths(valueSchema, pathPrefix, true, activeSchemas)\n        : [];\n    }\n\n    if (schemaType === 'tuple') {\n      const tupleItems = getZodDefArrayProperty(unwrappedSchema, 'items') as z.ZodTypeAny[] | undefined;\n      const restSchema = getZodDefSchemaProperty(unwrappedSchema, 'rest');\n      return mergeTemplatableFileFieldPaths([\n        ...((tupleItems ?? []).flatMap((item) =>\n          collectTemplatableFileFieldPaths(item, pathPrefix, true, activeSchemas)\n        )),\n        ...(restSchema ? collectTemplatableFileFieldPaths(restSchema, pathPrefix, true, activeSchemas) : []),\n      ]);\n    }\n\n    if (!isZodObject(unwrappedSchema)) {\n      return [];\n    }\n\n    const shape = getZodObjectShape(unwrappedSchema);\n    return mergeTemplatableFileFieldPaths(\n      Object.entries(shape).flatMap(([fieldName, fieldSchema]) => {\n        const nextPath = pathPrefix ? `${pathPrefix}.${fieldName}` : fieldName;\n        return collectTemplatableFileFieldPaths(fieldSchema as z.ZodTypeAny, nextPath, isInsideArray, activeSchemas);\n      }),\n    );\n  } finally {\n    activeSchemas.delete(schema);\n  }\n}\n\nfunction mergeTemplatableFileFieldPaths(\n  fields: TemplatableFileFieldPath[],\n): TemplatableFileFieldPath[] {\n  const byFieldName = new Map<string, TemplatableFileFieldPath>();\n  for (const field of fields) {\n    const existing = byFieldName.get(field.fieldName);\n    if (existing && !areTemplatableFileMetadataCompatible(existing.schema, field.schema)) {\n      throw new IncompatibleTemplatableFileFieldPathError(\n        field.fieldName,\n        getFileMetadata(existing.schema),\n        getFileMetadata(field.schema),\n      );\n    }\n    byFieldName.set(field.fieldName, existing\n      ? {\n          ...existing,\n          isInsideArray: existing.isInsideArray || field.isInsideArray,\n        }\n      : field);\n  }\n  return Array.from(byFieldName.values()).sort((left, right) =>\n    left.fieldName.localeCompare(right.fieldName)\n  );\n}\n\nfunction normalizeMetadataForComparison(value: unknown): unknown {\n  if (Array.isArray(value)) {\n    return value.map(normalizeMetadataForComparison);\n  }\n\n  if (value && typeof value === 'object') {\n    return Object.fromEntries(\n      Object.entries(value as Record<string, unknown>)\n        .sort(([left], [right]) => left.localeCompare(right))\n        .map(([key, childValue]) => [key, normalizeMetadataForComparison(childValue)]),\n    );\n  }\n\n  return value;\n}\n\nfunction areTemplatableFileMetadataCompatible(\n  leftSchema: z.ZodTypeAny,\n  rightSchema: z.ZodTypeAny,\n): boolean {\n  return JSON.stringify(normalizeMetadataForComparison(getFileMetadata(leftSchema)))\n    === JSON.stringify(normalizeMetadataForComparison(getFileMetadata(rightSchema)));\n}\n\n/**\n * Remove generated PDF file fields from request DTO schemas, including nested\n * structures and union arms. These fields are framework-owned outputs, so they\n * must never appear in frontend/authored write DTOs even when custom DTOs are\n * provided by an application.\n */\nexport function stripTemplatableFileFieldsRecursively(\n  schema: z.ZodTypeAny,\n  options: StripTemplatableFileFieldsOptions = {},\n  activeSchemas: WeakSet<object> = new WeakSet<object>(),\n): z.ZodTypeAny {\n  if (activeSchemas.has(schema)) {\n    return schema;\n  }\n  activeSchemas.add(schema);\n\n  try {\n    /*\n     * Wrappers hand back the ORIGINAL instance when nothing beneath them changed (#989).\n     *\n     * They used to rebuild `inner.optional()` unconditionally. A fresh wrapper is a different\n     * instance, so the enclosing object read it as \"changed\" and was rebuilt too — and the rebuild\n     * dropped the object's decorator metadata. A `z_address()` nested in any object therefore reached\n     * the create and update request DTOs as a plain object, and the form rendered its parts as\n     * unrelated text inputs. Identity is what tells the object branch nothing was stripped.\n     */\n    if (isZodOptional(schema)) {\n      const innerSchema = getZodDefSchemaProperty(schema, 'innerType');\n      if (!innerSchema) {\n        return schema;\n      }\n      const strippedInner = stripTemplatableFileFieldsRecursively(innerSchema, options, activeSchemas);\n      return strippedInner === innerSchema ? schema : carrySchemaMetadata(schema, strippedInner.optional());\n    }\n\n    if (isZodNullable(schema)) {\n      const innerSchema = getZodDefSchemaProperty(schema, 'innerType');\n      if (!innerSchema) {\n        return schema;\n      }\n      const strippedInner = stripTemplatableFileFieldsRecursively(innerSchema, options, activeSchemas);\n      return strippedInner === innerSchema ? schema : carrySchemaMetadata(schema, strippedInner.nullable());\n    }\n\n    if (isZodDefault(schema)) {\n      const innerSchema = getZodDefSchemaProperty(schema, 'innerType');\n      if (!innerSchema) {\n        return schema;\n      }\n      const strippedInner = stripTemplatableFileFieldsRecursively(innerSchema, options, activeSchemas);\n      if (strippedInner === innerSchema) {\n        return schema;\n      }\n      // Re-READ the default per parse rather than carrying a value across. In Zod 4\n      // `def.defaultValue` is a GETTER, so reading it here EVALUATES the default —\n      // and this stripped schema is built once, at configuration time, so a value\n      // read here would be frozen into every parse the process performs. (The old\n      // `typeof defaultValue === 'function'` branch could never fire for a dynamic\n      // default for the same reason: the getter returns the VALUE, not the factory.)\n      return carrySchemaMetadata(schema, strippedInner.default(() => getZodDefProperty(schema, 'defaultValue') as unknown));\n    }\n\n    const schemaType = getZodType(schema);\n    if (schemaType === 'pipe') {\n      const inSchema = getZodDefSchemaProperty(schema, 'in');\n      const outSchema = getZodDefSchemaProperty(schema, 'out');\n      const strippedIn = inSchema\n        ? stripTemplatableFileFieldsRecursively(inSchema, options, activeSchemas)\n        : inSchema;\n      const strippedOut = outSchema\n        ? stripTemplatableFileFieldsRecursively(outSchema, options, activeSchemas)\n        : outSchema;\n      if (strippedIn === inSchema && strippedOut === outSchema) {\n        return schema;\n      }\n      if (strippedIn && strippedOut) {\n        return z.pipe(strippedIn, strippedOut);\n      }\n      return strippedOut ?? strippedIn ?? schema;\n    }\n\n    if (schemaType === 'lazy') {\n      const lazyGetter = getZodDef(schema)?.getter;\n      if (typeof lazyGetter !== 'function') {\n        return schema;\n      }\n      return z.lazy(() =>\n        stripTemplatableFileFieldsRecursively(lazyGetter() as z.ZodTypeAny, options, activeSchemas)\n      );\n    }\n\n    if (schemaType === 'intersection') {\n      const leftSchema = getZodDefSchemaProperty(schema, 'left');\n      const rightSchema = getZodDefSchemaProperty(schema, 'right');\n      const strippedLeft = leftSchema\n        ? stripTemplatableFileFieldsRecursively(leftSchema, options, activeSchemas)\n        : leftSchema;\n      const strippedRight = rightSchema\n        ? stripTemplatableFileFieldsRecursively(rightSchema, options, activeSchemas)\n        : rightSchema;\n      return strippedLeft === leftSchema && strippedRight === rightSchema\n        ? schema\n        : z.intersection(strippedLeft ?? z.object({}), strippedRight ?? z.object({}));\n    }\n\n    if (schemaType === 'union') {\n      const discriminator = getZodDefStringProperty(schema, 'discriminator');\n      const unionOptions = getZodDefArrayProperty(schema, 'options') as z.ZodTypeAny[] | undefined;\n      if (!unionOptions?.length) {\n        return schema;\n      }\n\n      const strippedOptions = unionOptions.map((option) =>\n        stripTemplatableFileFieldsRecursively(option, options, activeSchemas)\n      );\n      if (strippedOptions.length < 2) {\n        return strippedOptions[0] ?? schema;\n      }\n      if (strippedOptions.every((option, index) => option === unionOptions[index])) {\n        return schema;\n      }\n\n      const rebuiltUnion: z.ZodTypeAny = discriminator\n        ? z.discriminatedUnion(\n            discriminator,\n            strippedOptions as [z.ZodObject<any>, z.ZodObject<any>, ...z.ZodObject<any>[]],\n          )\n        : z.union(strippedOptions as [z.ZodTypeAny, z.ZodTypeAny, ...z.ZodTypeAny[]]);\n      return carrySchemaMetadata(schema, rebuiltUnion);\n    }\n\n    if (isZodArray(schema)) {\n      const elementSchema = getZodDefProperty(schema, 'element') as z.ZodTypeAny | undefined;\n      if (!elementSchema) {\n        return schema;\n      }\n\n      const strippedElement = stripTemplatableFileFieldsRecursively(elementSchema, options, activeSchemas);\n\n      // Nothing to strip inside the element — hand back the ORIGINAL schema, the same way the\n      // intersection / record / map branches do.\n      if (strippedElement === elementSchema) {\n        return schema;\n      }\n\n      // The element WAS rewritten. `withArrayElement` keeps the array's own `.min()` / `.max()` /\n      // `.length()` checks across the swap; a plain `z.array(strippedElement)` — what this branch\n      // used to do unconditionally — drops them, so an authored constraint never reached the DTO\n      // the controller and repository validate against.\n      return withArrayElement(schema, strippedElement);\n    }\n\n    if (schemaType === 'record') {\n      const keySchema = getZodDefSchemaProperty(schema, 'keyType');\n      const valueSchema = getZodDefSchemaProperty(schema, 'valueType');\n      const strippedValue = valueSchema\n        ? stripTemplatableFileFieldsRecursively(valueSchema, options, activeSchemas)\n        : valueSchema;\n      return valueSchema && strippedValue !== valueSchema\n        ? z.record((keySchema ?? z.string()) as any, strippedValue)\n        : schema;\n    }\n\n    if (schemaType === 'map') {\n      const keySchema = getZodDefSchemaProperty(schema, 'keyType');\n      const valueSchema = getZodDefSchemaProperty(schema, 'valueType');\n      const strippedValue = valueSchema\n        ? stripTemplatableFileFieldsRecursively(valueSchema, options, activeSchemas)\n        : valueSchema;\n      return keySchema && valueSchema && strippedValue !== valueSchema\n        ? z.map(keySchema, strippedValue)\n        : schema;\n    }\n\n    if (schemaType === 'set') {\n      const valueSchema = getZodDefSchemaProperty(schema, 'valueType');\n      const strippedValue = valueSchema\n        ? stripTemplatableFileFieldsRecursively(valueSchema, options, activeSchemas)\n        : valueSchema;\n      return valueSchema && strippedValue !== valueSchema\n        ? z.set(strippedValue)\n        : schema;\n    }\n\n    if (schemaType === 'tuple') {\n      const tupleItems = getZodDefArrayProperty(schema, 'items') as z.ZodTypeAny[] | undefined;\n      const restSchema = getZodDefSchemaProperty(schema, 'rest');\n      const strippedItems = (tupleItems ?? []).map((item) =>\n        stripTemplatableFileFieldsRecursively(item, options, activeSchemas)\n      );\n      const strippedRest = restSchema\n        ? stripTemplatableFileFieldsRecursively(restSchema, options, activeSchemas)\n        : restSchema;\n      const changed = strippedItems.some((item, index) => item !== tupleItems?.[index])\n        || strippedRest !== restSchema;\n      if (!changed) {\n        return schema;\n      }\n      const rebuiltTuple = z.tuple(strippedItems as any);\n      return strippedRest ? rebuiltTuple.rest(strippedRest) : rebuiltTuple;\n    }\n\n    if (!isZodObject(schema)) {\n      return schema;\n    }\n\n    const shape = getZodObjectShape(schema);\n    const strippedShape: Record<string, z.ZodTypeAny> = {};\n    let changed = false;\n\n    for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n      const typedSchema = fieldSchema as z.ZodTypeAny;\n      if (isTemplatableFileField(typedSchema)) {\n        changed = true;\n        continue;\n      }\n\n      const strippedSchema = stripTemplatableFileFieldsRecursively(typedSchema, options, activeSchemas);\n      if (strippedSchema !== typedSchema) {\n        changed = true;\n      }\n      strippedShape[fieldName] = strippedSchema;\n    }\n\n    if (!changed) {\n      return schema;\n    }\n\n    return options.rebuildObjectSchema\n      ? options.rebuildObjectSchema(schema, strippedShape)\n      : rebuildObjectSchemaPreservingSemantics(schema, strippedShape);\n  } finally {\n    activeSchemas.delete(schema);\n  }\n}\n\nfunction rebuildObjectSchemaPreservingSemantics(\n  schema: z.ZodObject<any>,\n  strippedShape: Record<string, z.ZodTypeAny>,\n): z.ZodTypeAny {\n  const originalShape = getZodObjectShape(schema);\n  const removedFields = Object.keys(originalShape).filter((fieldName) => !(fieldName in strippedShape));\n\n  try {\n    const omittedSchema = removedFields.length > 0\n      ? schema.omit(Object.fromEntries(removedFields.map((fieldName) => [fieldName, true])) as Record<string, true>)\n      : schema;\n\n    const extended = omittedSchema.extend(strippedShape);\n    // Same field set, only a nested field replaced: the object is still what its metadata describes.\n    // A field REMOVED means it may not be, so the metadata stays behind on that path (#989).\n    return removedFields.length === 0 ? carrySchemaMetadata(schema, extended) : extended;\n  } catch {\n    const rebuiltSchema = z.object(strippedShape);\n    const catchallSchema = getZodDefProperty(schema, 'catchall') as z.ZodTypeAny | undefined;\n    const rebuilt = catchallSchema ? rebuiltSchema.catchall(catchallSchema) : rebuiltSchema;\n    return removedFields.length === 0 ? carrySchemaMetadata(schema, rebuilt) : rebuilt;\n  }\n}\n"]}