@wildo-ai/saas-models 1.0.1 → 1.1.0

package/dist/esm/resources/utils/resource-polymorphism.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-polymorphism.factory.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/resource-polymorphism.factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resource-polymorphism.factory.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/resource-polymorphism.factory.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EACV,uCAAuC,EACvC,2CAA2C,EAC3C,iDAAiD,EACjD,wDAAwD,EACxD,2BAA2B,EAC5B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAgB,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAChG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,4BAA4B,EAA8B,MAAM,iCAAiC,CAAC;AAMhH;;;;GAIG;AACH,KAAK,gBAAgB,CAAC,CAAC,EAAE,CAAC,SAAS,WAAW,IAAI,CAAC,SAAS,GAAG,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,KAAK,CAAC;AAErF;;;;;;;;;;GAUG;AACH;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,CAAC,WAAW,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,IACrF,gBAAgB,CAAC,wDAAwD,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,GAChG,2BAA2B,GAAG;IAC5B;;;;;;;;;;;;;;;;OAgBG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC3C,iGAAiG;IACjG,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,0BAA0B,CAAC,WAAW,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,MAAM,IAAI,IAAI,CACxF,iDAAiD,CAAC,WAAW,CAAC,EAC9D,UAAU,CACX,GAAG;IACF,QAAQ,EAAE,2BAA2B,CAAC,WAAW,CAAC,EAAE,CAAC;CACtD,CAAC;AAEF;;;GAGG;AACH,KAAK,yBAAyB,GAC1B,YAAY,GACZ,oBAAoB,GACpB,yBAAyB,GACzB,uBAAuB,GACvB,yBAAyB,CAAC;AAE9B;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,MAAM,yBAAyB,CACnC,oBAAoB,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EACjE,kBAAkB,SAAS,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,GAAG,SAAS,EACjF,WAAW,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,MAAM,IACzC,IAAI,CACN,uCAAuC,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CAAC,EAC9F,yBAAyB,CAC1B,GAAG;IACF,yEAAyE;IACzE,uBAAuB,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,WAAW,CAAC,CAAC,CAAC;CAClF,CAAC;AAMF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,uCAAuC,CACrD,oBAAoB,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EACjE,kBAAkB,SAAS,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,GAAG,SAAS,EACjF,WAAW,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,MAAM,EAE3C,WAAW,EAAE,4BAA4B,CAAC,WAAW,CAAC,EACtD,YAAY,EAAE,yBAAyB,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,WAAW,CAAC,GAC7F,MAAM,CAAC,MAAM,EAAE,2CAA2C,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC,CAwC5G"}

package/dist/esm/resources/utils/resource-polymorphism.factory.js

@@ -38,7 +38,7 @@ import { createResourceConfiguration_Initialization } from '../resources-config.
  *           isDefault: true,
  *           polymorphicRole: {
  *             'organizations': [CORE_ORG_ROLES.ORG_OWNER],
- *             'users': [],
+ *             'users': [CORE_APP_ROLES.APP_USER], // never [] — empty is fail-closed (403)
  *           },
  *           riskLevel: ResourceOperationRiskLevel.LOW,
  *         }],
@@ -66,20 +66,20 @@ export function createPolymorphicResourceConfigurations(declaration, sharedConfi
         const inheritenceSchemaDefinition = variant.schemaFamily
             ? variant.schemaFamily.inheritenceSchemaDefinition
             : sharedConfig.inheritenceSchemaDefinition;
-        // Lazy factory: relationships are provided at registry call time, not at declaration time
+        // Lazy factory: relationships are provided at registry call time, not at declaration time.
+        // SPREAD the shared config rather than re-listing its fields: that is what makes every current
+        // AND FUTURE resource-level capability (retentionPolicy, isAnonymizable, transpositionPolicy, …)
+        // reach the generated variants automatically. Re-listing is how those three were silently lost.
+        // Only the genuinely per-variant keys are overridden below.
         result[variant.resourceType] = (resourcesRelationships) => createResourceConfiguration_Initialization({
-            isDisabled: sharedConfig.isDisabled,
+            ...sharedConfig,
             mainSchema: variantMainSchema,
             resourceIdentifier: variant.resourceType,
             resourceFieldIdentifier: variant.fieldIdentifier,
             resourceRelationships: resourcesRelationships,
+            // A variant carrying its own SchemaFamily overrides the shared definition.
             inheritenceSchemaDefinition,
-            persistenceAdapter: sharedConfig.persistenceAdapter,
-            isSystemResource: sharedConfig.isSystemResource,
-            coreOperations: sharedConfig.coreOperations,
-            customOperation: sharedConfig.customOperation,
             operationsConfiguration: resolvedOpsConfig,
-            autoVariants: sharedConfig.autoVariants,
         });
     }
     return result;
@@ -130,4 +130,4 @@ function resolveOperationsForVariant(operationsConfiguration, variant) {
     }
     return resolved;
 }
-//# sourceMappingURL=resource-polymorphism.factory.js.map
+//# sourceMappingURL=resource-polymorphism.factory.js.map

package/dist/esm/resources/utils/resource-polymorphism.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-polymorphism.factory.js","sourceRoot":"","sources":["../../../../src/resources/utils/resource-polymorphism.factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resource-polymorphism.factory.js","sourceRoot":"","sources":["../../../../../src/resources/utils/resource-polymorphism.factory.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource Polymorphism — Factory Configuration (Phase 3)\n *\n * Provides `createPolymorphicResourceConfigurations()` which takes a polymorphic\n * declaration + shared resource configuration, and produces N factory functions\n * (one per variant) that can be spread into the resource configurations factory map.\n *\n * Key transformation: `polymorphicRole` on operation variants is resolved to\n * standard `roles` for each variant's scope.\n *\n * @see polymorphic-scope-approach-A-expansion.md — Phase 3\n */\n\nimport { z } from 'zod';\nimport { createResourceConfiguration_Initialization } from '../resources-config.shared.factory';\nimport type {\n  ResourceConfiguration_BuilderParameters,\n  ResourceConfiguration_InitializationFactory,\n  ResourceConfiguration_Operation_BuilderParameters,\n  ResourceConfiguration_OperationVariant_BuilderParameters,\n  CollectionViewFields_Search,\n} from '../resources-config.shared.schemas';\nimport type { ResourceType, CoreResourceOperation } from '../resources.shared.core.definitions';\nimport type { EnumLikeType } from '@wildo-ai/zod-decorators';\nimport type { PolymorphicSchemaDeclaration, PolymorphicResolvedVariant } from './resource-polymorphism.schemas';\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\n/**\n * Distributive Omit — preserves union members individually.\n * Standard `Omit<A | B, K>` collapses to common keys only, losing per-member properties.\n * This helper distributes the Omit over each union member, preserving all variant-specific fields.\n */\ntype DistributiveOmit<T, K extends PropertyKey> = T extends any ? Omit<T, K> : never;\n\n/**\n * Operation variant with `polymorphicRole` support.\n * Extends the standard variant by adding `polymorphicRole` as an alternative to `roles`.\n *\n * - `polymorphicRole`: `Record<ResourceType, string[]>` — role mapping per parent resource type.\n *   The factory resolves this to standard `roles` for each generated variant.\n * - `roles`: standard roles array — used directly (e.g., for admin variants).\n *\n * If both `polymorphicRole` and `roles` are provided, `polymorphicRole` takes precedence\n * for the matching parent resource type. If the parent isn't in `polymorphicRole`, `roles` is used as fallback.\n */\n/**\n * Polymorphic variant type. Intersects with CollectionViewFields_Search so that\n * SEARCH operation variants (including REPOSITORY_ONLY) can specify isSearchable,\n * searchableFields, filterFields, sortFields, etc. All fields are optional.\n */\nexport type PolymorphicOperationVariant<TMainSchema extends z.ZodTypeAny = z.ZodTypeAny> =\n  DistributiveOmit<ResourceConfiguration_OperationVariant_BuilderParameters<TMainSchema>, 'roles'> &\n  CollectionViewFields_Search & {\n    /**\n     * Role mapping per parent resource type.\n     * The factory resolves this into standard `roles` for each generated variant.\n     *\n     * ⚠️ An EMPTY array is NOT \"skip the role check\" — it is fail-CLOSED. The\n     * authorization gate evaluates `operationRoles.some(...)`, and `[].some()`\n     * is always `false`, so an empty array denies EVERY caller (403). For the\n     * user-self scope, list the baseline authenticated role (`APP_USER`); role\n     * membership is the floor, while row ownership is enforced separately by the\n     * USER_SELF scope authorizer.\n     *\n     * @example\n     * polymorphicRole: {\n     *   'organizations': ['ORG_OWNER', 'ORG_ADMIN'],\n     *   'users': ['APP_USER'],  // user-self: any authenticated user (ownership checked by scope)\n     * }\n     */\n    polymorphicRole?: Record<string, string[]>;\n    /** Standard roles — used directly or as fallback when polymorphicRole doesn't have the parent */\n    roles?: string[];\n  };\n\n/**\n * Operation configuration with polymorphic role support.\n */\nexport type PolymorphicOperationConfig<TMainSchema extends z.ZodTypeAny = z.ZodAny> = Omit<\n  ResourceConfiguration_Operation_BuilderParameters<TMainSchema>,\n  'variants'\n> & {\n  variants: PolymorphicOperationVariant<TMainSchema>[];\n};\n\n/**\n * Keys the polymorphic factory derives PER VARIANT — the only things a shared config cannot supply.\n * Everything else is shared, and is now inherited structurally (see {@link PolymorphicResourceConfig}).\n */\ntype PolymorphicPerVariantKeys =\n  | 'mainSchema'              // derived per variant from the declaration\n  | 'resourceIdentifier'      // derived per variant\n  | 'resourceFieldIdentifier' // derived per variant\n  | 'resourceRelationships'   // provided at factory call time by the registry\n  | 'operationsConfiguration';// replaced by the polymorphicRole-aware shape below\n\n/**\n * Shared resource configuration for polymorphic resources — everything common across all variants.\n *\n * ⚠️ DERIVED FROM `ResourceConfiguration_BuilderParameters`, deliberately. This used to be a\n * hand-maintained whitelist of forwarded fields, and it silently DROPPED every resource-level\n * capability axis added after it was written (`isAnonymizable`, `transpositionPolicy`,\n * `retentionPolicy`). The failure mode was invisible: a polymorphic resource could ASK for a\n * capability and simply not get it — no type error, no runtime error, the opt-in just evaporated.\n * Because the type is now an `Omit` of the real parameter surface and the values are spread through,\n * ANY capability added to the builder parameters is automatically available to polymorphic resources\n * and forwarded — there is no list left to forget.\n *\n * Per-variant keys are omitted (see {@link PolymorphicPerVariantKeys}); `operationsConfiguration` is\n * re-declared with the `polymorphicRole`-aware variant shape.\n *\n * NOTE ON SEMANTICS: a capability declared here applies to EVERY generated variant (that is the point\n * — e.g. all billing scopes retain identically). A capability that is invalid for one variant's scope\n * fails loud in that variant's factory call, which is the correct outcome; per-variant capability\n * overrides are intentionally NOT modelled (no consumer needs them, and they would reintroduce the\n * \"which variant actually got it?\" ambiguity this contract removes).\n */\nexport type PolymorphicResourceConfig<\n  TCustomOperationEnum extends EnumLikeType | undefined = undefined,\n  TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined = undefined,\n  TMainSchema extends z.ZodTypeAny = z.ZodAny,\n> = Omit<\n  ResourceConfiguration_BuilderParameters<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>,\n  PolymorphicPerVariantKeys\n> & {\n  /** Operations configuration — supports `polymorphicRole` on variants. */\n  operationsConfiguration: Record<string, PolymorphicOperationConfig<TMainSchema>>;\n};\n\n// =============================================================================\n// MAIN FUNCTION\n// =============================================================================\n\n/**\n * Create N resource configuration factories from a polymorphic declaration.\n *\n * For each variant in the declaration, produces a standard\n * `ResourceConfiguration_InitializationFactory` that can be registered in the factory map.\n *\n * The key transformation: `polymorphicRole` on operation variants is resolved to\n * standard `roles` for each variant's parent resource type.\n *\n * @returns Record mapping variant resource type → factory function\n *\n * @example\n * ```typescript\n * const billingAccountFactories = createPolymorphicResourceConfigurations(\n *   billingAccountsPolymorphicDeclaration,\n *   {\n *     coreOperations: [CoreResourceOperation.READ, CoreResourceOperation.LIST, ...],\n *     operationsConfiguration: {\n *       [CoreResourceOperation.READ]: {\n *         variants: [{\n *           variantType: ResourceOperationVariantType.API_CALL,\n *           isDefault: true,\n *           polymorphicRole: {\n *             'organizations': [CORE_ORG_ROLES.ORG_OWNER],\n *             'users': [CORE_APP_ROLES.APP_USER], // never [] — empty is fail-closed (403)\n *           },\n *           riskLevel: ResourceOperationRiskLevel.LOW,\n *         }],\n *       },\n *     },\n *   },\n * );\n * // → {\n * //     'organizationBillingAccounts': (rels) => ResourceConfiguration,\n * //     'userBillingAccounts': (rels) => ResourceConfiguration,\n * //   }\n * ```\n */\nexport function createPolymorphicResourceConfigurations<\n  TCustomOperationEnum extends EnumLikeType | undefined = undefined,\n  TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined = undefined,\n  TMainSchema extends z.ZodTypeAny = z.ZodAny,\n>(\n  declaration: PolymorphicSchemaDeclaration<TMainSchema>,\n  sharedConfig: PolymorphicResourceConfig<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>,\n): Record<string, ResourceConfiguration_InitializationFactory<TCustomOperationEnum, TCoreOperationEnum, any>> {\n  const result: Record<string, ResourceConfiguration_InitializationFactory<TCustomOperationEnum, TCoreOperationEnum, any>> = {};\n\n  for (const [, variant] of declaration.variants) {\n    const resolvedOpsConfig = resolveOperationsForVariant(\n      sharedConfig.operationsConfiguration,\n      variant,\n    );\n\n    // Determine the schema for this variant:\n    // - If SchemaFamily, use the rebuilt union\n    // - If plain ZodObject, use the variant schema directly\n    const variantMainSchema = variant.schema;\n\n    // Determine inheritenceSchemaDefinition:\n    // - If SchemaFamily, use the rebuilt family's inheritenceSchemaDefinition\n    // - Otherwise, use the shared config's (if any)\n    const inheritenceSchemaDefinition = variant.schemaFamily\n      ? variant.schemaFamily.inheritenceSchemaDefinition as any\n      : sharedConfig.inheritenceSchemaDefinition;\n\n    // Lazy factory: relationships are provided at registry call time, not at declaration time.\n    // SPREAD the shared config rather than re-listing its fields: that is what makes every current\n    // AND FUTURE resource-level capability (retentionPolicy, isAnonymizable, transpositionPolicy, …)\n    // reach the generated variants automatically. Re-listing is how those three were silently lost.\n    // Only the genuinely per-variant keys are overridden below.\n    result[variant.resourceType] = (resourcesRelationships) =>\n      createResourceConfiguration_Initialization({\n        ...(sharedConfig as any),\n        mainSchema: variantMainSchema,\n        resourceIdentifier: variant.resourceType as ResourceType,\n        resourceFieldIdentifier: variant.fieldIdentifier,\n        resourceRelationships: resourcesRelationships,\n        // A variant carrying its own SchemaFamily overrides the shared definition.\n        inheritenceSchemaDefinition,\n        operationsConfiguration: resolvedOpsConfig as any,\n      });\n  }\n\n  return result;\n}\n\n// =============================================================================\n// INTERNALS\n// =============================================================================\n\n/**\n * Resolve `polymorphicRole` → `roles` for each operation variant for a specific scope variant.\n */\nfunction resolveOperationsForVariant<TMainSchema extends z.ZodTypeAny>(\n  operationsConfiguration: Record<string, PolymorphicOperationConfig<TMainSchema>>,\n  variant: PolymorphicResolvedVariant<TMainSchema>,\n): Record<string, ResourceConfiguration_Operation_BuilderParameters<TMainSchema>> {\n  const resolved: Record<string, ResourceConfiguration_Operation_BuilderParameters<TMainSchema>> = {};\n\n  for (const [operationKey, opConfig] of Object.entries(operationsConfiguration)) {\n    const resolvedVariants: ResourceConfiguration_OperationVariant_BuilderParameters<TMainSchema>[] = [];\n\n    for (const opVariant of opConfig.variants) {\n      const { polymorphicRole, roles: fallbackRoles, ...rest } = opVariant;\n\n      let resolvedRoles: string[];\n\n      if (polymorphicRole) {\n        // Resolve from polymorphicRole map using the parent resource type\n        const parentType = variant.parentResourceType as string;\n        if (parentType in polymorphicRole) {\n          resolvedRoles = polymorphicRole[parentType]!;\n        } else if (fallbackRoles) {\n          resolvedRoles = fallbackRoles;\n        } else {\n          throw new Error(\n            `[PolymorphicFactory] Operation \"${operationKey}\" variant has polymorphicRole but no entry ` +\n            `for parentResourceType=\"${parentType}\" and no fallback roles. ` +\n            `Either add \"${parentType}\" to polymorphicRole or provide fallback roles.`\n          );\n        }\n      } else if (fallbackRoles) {\n        resolvedRoles = fallbackRoles;\n      } else {\n        throw new Error(\n          `[PolymorphicFactory] Operation \"${operationKey}\" variant has neither polymorphicRole nor roles.`\n        );\n      }\n\n      resolvedVariants.push({\n        ...rest,\n        roles: resolvedRoles,\n      } as ResourceConfiguration_OperationVariant_BuilderParameters<TMainSchema>);\n    }\n\n    resolved[operationKey] = {\n      ...opConfig,\n      variants: resolvedVariants,\n    };\n  }\n\n  return resolved;\n}\n"]}

package/dist/esm/resources/utils/resource-polymorphism.relationships.d.ts

@@ -14,13 +14,13 @@
  *
  * @see polymorphic-scope-approach-A-expansion.md — Phase 2
  */
-import type { ResourceRelationship } from '../resources.shared.schemas.js';
-import { RelationshipNature, ResourceRelationshipCardinality, type ResourceRelationshipConditionFn } from '../resources.shared.schemas.js';
-import type { RelationshipContextPolicy } from '../context-policy.shared.schemas.js';
-import type { ChildOperationsConfig, ResourceRelationshipDiscriminator } from '../child-operations.shared.schemas.js';
-import type { RelationshipDisplayConfig } from '../relationship-display.shared.schemas.js';
-import type { ResourceType } from '../resources.shared.core.definitions.js';
-import type { PolymorphicSchemaDeclaration } from './resource-polymorphism.schemas.js';
+import type { ResourceRelationship } from '../resources.shared.schemas';
+import { RelationshipNature, ResourceRelationshipCardinality, type ResourceRelationshipConditionFn } from '../resources.shared.schemas';
+import type { RelationshipContextPolicy } from '../context-policy.shared.schemas';
+import type { ChildOperationsConfig, ResourceRelationshipDiscriminator } from '../child-operations.shared.schemas';
+import type { RelationshipDisplayConfig } from '../relationship-display.shared.schemas';
+import type { ResourceType } from '../resources.shared.core.definitions';
+import type { PolymorphicSchemaDeclaration } from './resource-polymorphism.schemas';
 /**
  * Options propagated to each generated relationship.
  *

package/dist/esm/resources/utils/resource-polymorphism.relationships.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-polymorphism.relationships.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/resource-polymorphism.relationships.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,KAAK,+BAA+B,EACrC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACnH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAMpF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,8BAA8B;IAC7C,2CAA2C;IAC3C,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,kEAAkE;IAClE,MAAM,EAAE,kBAAkB,CAAC;IAC3B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,qCAAqC;IACrC,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,qFAAqF;IACrF,aAAa,CAAC,EAAE,iCAAiC,CAAC;IAClD,kFAAkF;IAClF,SAAS,CAAC,EAAE,+BAA+B,CAAC;IAC5C,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,4BAA4B,EACzC,OAAO,EAAE;IACP,yEAAyE;IACzE,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,gDAAgD;IAChD,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,kEAAkE;IAClE,MAAM,EAAE,kBAAkB,CAAC;IAC3B,gDAAgD;IAChD,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,+BAA+B,CAAC;CACpD,GACA,oBAAoB,EAAE,CAyBxB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,8BAA8B,CAC5C,iBAAiB,EAAE,4BAA4B,EAC/C,sBAAsB,EAAE,4BAA4B,GAAG,YAAY,EACnE,iBAAiB,EAAE,+BAA+B,EAClD,gBAAgB,EAAE,+BAA+B,EACjD,OAAO,EAAE,8BAA8B,GACtC,oBAAoB,EAAE,CA8CxB"}
+{"version":3,"file":"resource-polymorphism.relationships.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/resource-polymorphism.relationships.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EACL,kBAAkB,EAClB,+BAA+B,EAC/B,KAAK,+BAA+B,EACrC,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,kCAAkC,CAAC;AAClF,OAAO,KAAK,EAAE,qBAAqB,EAAE,iCAAiC,EAAE,MAAM,oCAAoC,CAAC;AACnH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AACzE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,iCAAiC,CAAC;AAMpF;;;;;;;;;;GAUG;AACH,MAAM,WAAW,8BAA8B;IAC7C,2CAA2C;IAC3C,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,kEAAkE;IAClE,MAAM,EAAE,kBAAkB,CAAC;IAC3B,+DAA+D;IAC/D,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,qCAAqC;IACrC,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,qFAAqF;IACrF,aAAa,CAAC,EAAE,iCAAiC,CAAC;IAClD,kFAAkF;IAClF,SAAS,CAAC,EAAE,+BAA+B,CAAC;IAC5C,8EAA8E;IAC9E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,mCAAmC,CACjD,WAAW,EAAE,4BAA4B,EACzC,OAAO,EAAE;IACP,yEAAyE;IACzE,eAAe,CAAC,EAAE,qBAAqB,CAAC;IACxC,gDAAgD;IAChD,aAAa,CAAC,EAAE,yBAAyB,CAAC;IAC1C,kEAAkE;IAClE,MAAM,EAAE,kBAAkB,CAAC;IAC3B,gDAAgD;IAChD,OAAO,CAAC,EAAE,yBAAyB,CAAC;IACpC,0FAA0F;IAC1F,gBAAgB,CAAC,EAAE,+BAA+B,CAAC;CACpD,GACA,oBAAoB,EAAE,CAyBxB;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,wBAAgB,8BAA8B,CAC5C,iBAAiB,EAAE,4BAA4B,EAC/C,sBAAsB,EAAE,4BAA4B,GAAG,YAAY,EACnE,iBAAiB,EAAE,+BAA+B,EAClD,gBAAgB,EAAE,+BAA+B,EACjD,OAAO,EAAE,8BAA8B,GACtC,oBAAoB,EAAE,CA8CxB"}

package/dist/esm/resources/utils/resource-polymorphism.relationships.js

@@ -128,4 +128,4 @@ export function createPolymorphicRelationships(parentDeclaration, childDeclarati
     }
     return relationships;
 }
-//# sourceMappingURL=resource-polymorphism.relationships.js.map
+//# sourceMappingURL=resource-polymorphism.relationships.js.map

package/dist/esm/resources/utils/resource-polymorphism.relationships.js.map

@@ -1 +1 @@
-{"version":3,"file":"resource-polymorphism.relationships.js","sourceRoot":"","sources":["../../../../src/resources/utils/resource-polymorphism.relationships.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"resource-polymorphism.relationships.js","sourceRoot":"","sources":["../../../../../src/resources/utils/resource-polymorphism.relationships.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Resource Polymorphism — Relationship Declaration (Phase 2)\n *\n * Provides helpers to generate N relationships from a polymorphic declaration:\n *\n * 1. `createPolymorphicScopeRelationships(declaration)` — generates scope relationships\n *    (e.g., ORGANIZATIONS → organizationBillingAccounts) for each `isPrimaryScope: true` variant.\n *\n * 2. `createPolymorphicRelationships(parentDecl, childDeclOrType, ...)` — generates parent-child\n *    relationships for each variant (e.g., organizationBillingAccounts → organizationSubscriptions).\n *\n * Both use existing `createResourcesRelationship()` internally — the output is standard\n * `ResourceRelationship[]` spread into the registry.\n *\n * @see polymorphic-scope-approach-A-expansion.md — Phase 2\n */\n\nimport { createResourcesRelationship } from '../resources-relationships.shared.factory';\nimport type { ResourceRelationship } from '../resources.shared.schemas';\nimport {\n  RelationshipNature,\n  ResourceRelationshipCardinality,\n  type ResourceRelationshipConditionFn,\n} from '../resources.shared.schemas';\nimport type { RelationshipContextPolicy } from '../context-policy.shared.schemas';\nimport type { ChildOperationsConfig, ResourceRelationshipDiscriminator } from '../child-operations.shared.schemas';\nimport type { RelationshipDisplayConfig } from '../relationship-display.shared.schemas';\nimport type { ResourceType } from '../resources.shared.core.definitions';\nimport type { PolymorphicSchemaDeclaration } from './resource-polymorphism.schemas';\n\n// =============================================================================\n// TYPES\n// =============================================================================\n\n/**\n * Options propagated to each generated relationship.\n *\n * When `discriminator` or `condition` is provided, every generated variant\n * relationship will carry the same condition. This is useful when the\n * polymorphic expansion should be universally conditional (e.g., all billing\n * account variants → subscriptions only when account is active).\n *\n * For variant-specific conditions, apply discriminator/condition directly\n * on individual `createResourcesRelationship()` calls instead.\n */\nexport interface PolymorphicRelationshipOptions {\n  /** Context policy for this relationship */\n  contextPolicy?: RelationshipContextPolicy;\n  /** High-level semantic meaning for each generated relationship */\n  nature: RelationshipNature;\n  /** Child operations configuration (lifecycle + nested DTOs) */\n  childOperations?: ChildOperationsConfig;\n  /** Frontend display configuration */\n  display?: RelationshipDisplayConfig;\n  /** Static discriminator filter — forwarded to each generated variant relationship */\n  discriminator?: ResourceRelationshipDiscriminator;\n  /** Function-based condition — forwarded to each generated variant relationship */\n  condition?: ResourceRelationshipConditionFn;\n  /** Foreign key field override (usually not needed — derived automatically) */\n  foreignKeyField?: string;\n}\n\n// =============================================================================\n// SCOPE RELATIONSHIPS\n// =============================================================================\n\n/**\n * Generate scope relationships for a polymorphic declaration.\n *\n * For each variant with `isPrimaryScope: true`, generates:\n *   parentResourceType → variantResourceType (ONE:MANY, isPrimaryScope: true)\n *\n * For `isPrimaryScope: false` variants, this function generates nothing —\n * non-primary-scope variants get their parent relationship from\n * `createPolymorphicRelationships()` instead.\n *\n * @example\n * ```typescript\n * // In the registry:\n * ...createPolymorphicScopeRelationships(billingAccountsPolymorphicDeclaration),\n * // Generates:\n * //   ORGANIZATIONS → organizationBillingAccounts (isPrimaryScope: true)\n * //   USERS → userBillingAccounts (isPrimaryScope: true)\n * ```\n */\nexport function createPolymorphicScopeRelationships(\n  declaration: PolymorphicSchemaDeclaration,\n  options: {\n    /** Child operations for the scope relationship (e.g., cascade delete) */\n    childOperations?: ChildOperationsConfig;\n    /** Context policy for the scope relationship */\n    contextPolicy?: RelationshipContextPolicy;\n    /** High-level semantic meaning for each generated relationship */\n    nature: RelationshipNature;\n    /** Display config for the scope relationship */\n    display?: RelationshipDisplayConfig;\n    /** Cardinality from parent → child. Defaults to MANY. Use ONE for singleton resources. */\n    childCardinality?: ResourceRelationshipCardinality;\n  },\n): ResourceRelationship[] {\n  const relationships: ResourceRelationship[] = [];\n  const childCardinality = options?.childCardinality ?? ResourceRelationshipCardinality.MANY;\n\n  for (const [, variant] of declaration.variants) {\n    if (!variant.isPrimaryScope) continue;\n\n    relationships.push(\n      createResourcesRelationship(\n        variant.parentResourceType,\n        variant.resourceType,\n        ResourceRelationshipCardinality.ONE,\n        childCardinality,\n        {\n          isPrimaryScope: true,\n          nature: options.nature,\n          ...(options?.childOperations ? { childOperations: options.childOperations } : {}),\n          ...(options?.contextPolicy ? { contextPolicy: options.contextPolicy } : {}),\n          ...(options?.display ? { display: options.display } : {}),\n        },\n      ),\n    );\n  }\n\n  return relationships;\n}\n\n// =============================================================================\n// PARENT-CHILD RELATIONSHIPS\n// =============================================================================\n\n/**\n * Generate parent-child relationships between a polymorphic parent and a child.\n *\n * The child can be:\n * - **Another polymorphic declaration**: generates variant-to-variant relationships\n *   (e.g., organizationBillingAccounts → organizationSubscriptions)\n * - **A simple resource type string**: generates variant-to-same-child relationships\n *   (e.g., organizationBillingAccounts → prices, if prices are NOT polymorphic)\n *\n * When both parent and child are polymorphic, the function matches variants by\n * `parentResourceType` — each parent variant maps to the child variant with the\n * same parent resource type.\n *\n * @example\n * ```typescript\n * // Polymorphic parent → polymorphic child:\n * ...createPolymorphicRelationships(\n *   billingAccountsPolymorphicDeclaration,\n *   subscriptionsPolymorphicDeclaration,\n *   ResourceRelationshipCardinality.ONE,\n *   ResourceRelationshipCardinality.MANY,\n *   { childOperations: { lifecycle: { onParentDelete: { enabled: true, mode: 'IMMEDIATE', maxDepth: 1 } } } },\n * ),\n * // Generates:\n * //   organizationBillingAccounts → organizationSubscriptions\n * //   userBillingAccounts → userSubscriptions\n *\n * // Polymorphic parent → non-polymorphic child:\n * ...createPolymorphicRelationships(\n *   billingAccountsPolymorphicDeclaration,\n *   CoreResourceType.PRICES,\n *   ResourceRelationshipCardinality.ONE,\n *   ResourceRelationshipCardinality.MANY,\n * ),\n * // Generates:\n * //   organizationBillingAccounts → prices\n * //   userBillingAccounts → prices\n * ```\n */\nexport function createPolymorphicRelationships(\n  parentDeclaration: PolymorphicSchemaDeclaration,\n  childDeclarationOrType: PolymorphicSchemaDeclaration | ResourceType,\n  parentCardinality: ResourceRelationshipCardinality,\n  childCardinality: ResourceRelationshipCardinality,\n  options: PolymorphicRelationshipOptions,\n): ResourceRelationship[] {\n  const relationships: ResourceRelationship[] = [];\n  const isChildPolymorphic = typeof childDeclarationOrType !== 'string' && '__polymorphic' in childDeclarationOrType;\n\n  for (const [parentResourceType, parentVariant] of parentDeclaration.variants) {\n    let childResourceType: string;\n\n    if (isChildPolymorphic) {\n      const childDeclaration = childDeclarationOrType as PolymorphicSchemaDeclaration;\n      const childVariant = childDeclaration.variants.get(parentResourceType);\n\n      if (!childVariant) {\n        throw new Error(\n          `[PolymorphicRelationships] Parent variant \"${parentVariant.resourceType}\" ` +\n          `(parentResourceType=\"${parentResourceType as string}\") has no matching child variant ` +\n          `in child declaration \"${childDeclaration.baseResourceType}\". ` +\n          `Both polymorphic declarations must have the same set of parentResourceType values.`\n        );\n      }\n\n      childResourceType = childVariant.resourceType;\n    } else {\n      // Child is a simple (non-polymorphic) resource type\n      childResourceType = childDeclarationOrType as string;\n    }\n\n    relationships.push(\n      createResourcesRelationship(\n        parentVariant.resourceType,\n        childResourceType,\n        parentCardinality,\n        childCardinality,\n        {\n          nature: options.nature,\n          ...(options?.contextPolicy ? { contextPolicy: options.contextPolicy } : {}),\n          ...(options?.childOperations ? { childOperations: options.childOperations } : {}),\n          ...(options?.display ? { display: options.display } : {}),\n          ...(options?.discriminator ? { discriminator: options.discriminator } : {}),\n          ...(options?.condition ? { condition: options.condition } : {}),\n          ...(options?.foreignKeyField ? { foreignKeyField: options.foreignKeyField } : {}),\n        },\n      ),\n    );\n  }\n\n  return relationships;\n}\n"]}

package/dist/esm/resources/utils/resource-polymorphism.schemas.d.ts

@@ -10,12 +10,21 @@
  * @see polymorphic-scope-approach-A-expansion.md — Phase 1
  */
 import { z } from 'zod';
-import { type PolymorphicParentVariantDefinition } from './resource-polymorphism.utils.js';
-import type { SchemaFamily, VariantConfig } from './schema-family-builder.utils.js';
-import type { ResourceType } from '../resources.shared.core.definitions.js';
+import { type PolymorphicParentVariantDefinition } from './resource-polymorphism.utils';
+import type { SchemaFamily, VariantConfig } from './schema-family-builder.utils';
+import type { ResourceType } from '../resources.shared.core.definitions';
 /**
- * Full variant definition including isPrimaryScope flag.
- * Used as input to `declarePolymorphicSchemas()`.
+ * @wildo_source:part:start saas.models.polymorphism.variant-definition facet:layer:shared facet:family:polymorphism
+ *
+ * One entry in the variant list passed to `declarePolymorphicSchemas()` (from
+ * `@wildo-ai/saas-models`) — describes ONE scope a polymorphic resource is
+ * stamped out for. Besides the two fields below it also carries the inherited
+ * `parentResourceType` (the scope entity — e.g. ORGANIZATIONS / APPLICATION /
+ * USERS) and `parentFieldIdentifier` (the scope FK the engine injects into the
+ * variant schema — e.g. `organizationId` / `applicationId`). The
+ * `isPrimaryScope` + `businessKeyFields` pair is the SINGLETON-vs-MULTI-ROW
+ * decision: a singleton scope FK becomes a one-per-scope unique business key; a
+ * multi-row (collection) resource must opt out via `optOutPolymorphicAutoBusinessKey`.
  */
 export interface PolymorphicVariantDefinition extends PolymorphicParentVariantDefinition {
     /**
@@ -24,7 +33,99 @@ export interface PolymorphicVariantDefinition extends PolymorphicParentVariantDe
      * - `false`: parent FK injected (e.g., `projectId`), scope inherited from parent chain
      */
     isPrimaryScope: boolean;
+    /**
+     * Optional per-variant business-key declaration.
+     *
+     * The polymorphism engine cannot honour `.isBusinessKey()` on the base
+     * schema for fields that don't yet exist there (the canonical case being
+     * a polymorphic singleton whose business key is the *injected* parent FK
+     * — `organizationId` for the ORG variant, `applicationId` for the APP
+     * variant). This field gives the variant declaration a place to mark
+     * those fields per-variant.
+     *
+     * Resolution rule:
+     *
+     * 1. If `businessKeyFields` is provided (including an empty array `[]`
+     *    to *opt out*), apply `.isBusinessKey()` to each named field on the
+     *    final variant shape. Fail-loud if a name does not exist on the
+     *    variant shape.
+     * 2. Else if `isPrimaryScope: true` and `businessKeyFields` is omitted,
+     *    auto-mark the injected `parentFieldIdentifier` as the business key
+     *    (the singleton-per-scope convention).
+     * 3. Else (no explicit declaration AND not a primary scope), no
+     *    business-key marking is added — the framework's pre-A4 behaviour is
+     *    preserved for non-singleton polymorphism.
+     *
+     * DB UNIQUENESS: when the resolved business key is a SINGLE field (the
+     * singleton case — branch 2, or a one-field branch-1 list), that field is ALSO
+     * stamped `.isUnique()`, compiling to a Mongo unique index that enforces
+     * one-row-per-scope at the DB layer. `.isBusinessKey()` alone is a PURE marker
+     * with no index, so without this a raced insert (e.g. a system lazy-create on
+     * two concurrent logins) could duplicate the singleton row. A COMPOSITE
+     * (>1-field) business key stays marker-only — declare an object-level
+     * `.businessKeySet([...])` for a compound unique index instead. Consequence: a
+     * forgotten opt-out on a MULTI-ROW resource is now a hard duplicate-key insert
+     * failure (see `optOutPolymorphicAutoBusinessKey`), not just silent
+     * `upsertByBusinessKey` misrouting.
+     *
+     * Field names refer to the **post-injection, post-rename** shape — i.e.,
+     * what the field is actually called on the variant schema after
+     * polymorphic FK injection and any `polymorphicVariants`-driven renames
+     * (e.g., `billingAccountId` → `organizationBillingAccountId`). This is
+     * the shape the consumer of `variants[parentResourceType].schema` reads.
+     */
+    businessKeyFields?: string[];
 }
+/** @wildo_source:part:end saas.models.polymorphism.variant-definition */
+/**
+ * @wildo_source:part:start saas.models.polymorphism.optout-business-key facet:layer:shared facet:family:polymorphism
+ *
+ * Opt out the auto-default that marks the injected `parentFieldIdentifier`
+ * as the business key on every `isPrimaryScope: true` variant.
+ *
+ * Use this on **non-singleton** polymorphic resources (e.g., delivery logs,
+ * SSO connections, SIEM DLQ rows, SCIM tokens, billing usage records, credit
+ * pools, subscriptions, invoice refs) where the parent FK alone does NOT
+ * uniquely identify a row in the collection. Without this opt-out, the
+ * polymorphism engine auto-marks the injected scope FK (`organizationId` /
+ * `applicationId` / etc.) as the business key. On a multi-row resource that is
+ * now TWO bugs, not one:
+ *   1. any `upsertByBusinessKey()` call routes every row in the scope onto a
+ *      single document (silent data corruption); AND
+ *   2. the single-field business key is ALSO stamped `.isUnique()` (the
+ *      singleton ⇒ unique-index convention), so the SECOND row per scope is
+ *      rejected at insert with a duplicate-key error — a hard, immediate
+ *      failure. The resource is NOT a singleton, so both are wrong.
+ * Opt out and both vanish: the scope FK stays a plain non-unique index with no
+ * business-key marker.
+ *
+ * Contract:
+ *
+ * - Signature is **per-variant**: `(variantDef) => variantDef`. Apply it
+ *   to a whole variant array via the standard `Array.prototype.map`:
+ *   `[...AUTH_SCOPE_VARIANTS].map(optOutPolymorphicAutoBusinessKey)`.
+ *   Direct per-variant calls are also fine — useful when only one
+ *   variant in a heterogeneous array needs the opt-out.
+ * - The result is a fresh `PolymorphicVariantDefinition` (or array
+ *   thereof) with `businessKeyFields: []` per variant (the canonical
+ *   "explicit empty" opt-out — the empty-array branch of the resolution rule
+ *   documented on `PolymorphicVariantDefinition.businessKeyFields`).
+ * - **The helper UNCONDITIONALLY overwrites any pre-existing
+ *   `businessKeyFields` on the variant** — that is the entire point. If
+ *   you need to preserve / extend an existing composite key, do NOT pipe
+ *   through this helper; declare `businessKeyFields` inline on the
+ *   variant instead.
+ *
+ * Why a helper instead of inline `.map(v => ({ ...v, businessKeyFields: [] }))`:
+ *
+ * - Keeps the call-site one-line and self-documenting (the helper name IS
+ *   the rationale).
+ * - Centralizes the `businessKeyFields: []` literal so a future rename or
+ *   semantic change has one source of truth, not eight inlined copies.
+ * - Discoverable via `rg optOutPolymorphicAutoBusinessKey`.
+ */
+export declare function optOutPolymorphicAutoBusinessKey(variantDef: PolymorphicVariantDefinition): PolymorphicVariantDefinition;
+/** @wildo_source:part:end saas.models.polymorphism.optout-business-key */
 /**
  * A single resolved variant within a polymorphic declaration.
  * Contains all derived naming + the transformed schema.
@@ -125,4 +226,37 @@ export interface DeclarePolymorphicSchemasConfig<TSchema extends z.ZodTypeAny> {
  * ```
  */
 export declare function declarePolymorphicSchemas<TSchema extends z.ZodTypeAny>(config: DeclarePolymorphicSchemasConfig<TSchema>): PolymorphicSchemaDeclaration<TSchema>;
+/**
+ * Compute the per-variant renamed schema map for a polymorphic base.
+ *
+ * Exported as the canonical bridge that callers OUTSIDE this module
+ * (notably the frontend lib's `createPolymorphicFrontendPreset`, which
+ * threads a `FRONTEND_SCHEMA_KEY` per variant for `z_clone`-style UI
+ * mutations) use to derive per-variant schemas without having to reach
+ * into the private rename helpers.
+ *
+ * Given a base schema and an array of variant declarations, returns
+ * `Map<parentResourceType, ZodObject>` where each value is the base
+ * schema with `polymorphicVariants`-marked FK fields renamed to their
+ * variant-specific names (e.g. `billingAccountId` →
+ * `organizationBillingAccountId` for the ORGANIZATIONS variant).
+ *
+ * Why this matters: the polymorphic resource factory ALREADY applies
+ * these renames to the runtime variant schemas (see `applyFkRenames`
+ * call sites above). But callers that take the BASE schema as input
+ * and attach it to per-variant artifacts (e.g. the frontend's UI
+ * behavior `FRONTEND_SCHEMA_KEY`) bypass the rename and end up
+ * replacing the variant's renamed `mainSchema` with the base's
+ * un-renamed shape — breaking the registry's FK→parent map. Use this
+ * helper to keep that path aligned with the resource factory's
+ * rename semantics.
+ *
+ * `variants` only needs `parentResourceType`; any extra properties on
+ * the input objects are ignored. This lets frontend callers pass
+ * `PolymorphicFrontendVariant`-shaped values directly without
+ * reaching for the backend's full `PolymorphicVariantDefinition`.
+ */
+export declare function computePolymorphicVariantSchemas(baseSchema: z.ZodObject<z.ZodRawShape>, variants: ReadonlyArray<{
+    parentResourceType: string;
+}>): Map<string, z.ZodObject<z.ZodRawShape>>;
 //# sourceMappingURL=resource-polymorphism.schemas.d.ts.map

package/dist/esm/resources/utils/resource-polymorphism.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resource-polymorphism.schemas.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/resource-polymorphism.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA6B,KAAK,kCAAkC,EAAiC,MAAM,+BAA+B,CAAC;AAClJ,OAAO,KAAK,EAAE,YAAY,EAAgB,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAMzE;;;GAGG;AACH,MAAM,WAAW,4BAA6B,SAAQ,kCAAkC;IACtF;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;CACzB;AAED;;;GAGG;AACH,MAAM,WAAW,0BAA0B,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IACrF,2DAA2D;IAC3D,kBAAkB,EAAE,YAAY,CAAC;IACjC,6DAA6D;IAC7D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,cAAc,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,uFAAuF;IACvF,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5H;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IACvF,uCAAuC;IACvC,aAAa,EAAE,IAAI,CAAC;IACpB,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,kBAAkB,EAAE,4BAA4B,EAAE,CAAC;IACnD,4FAA4F;IAC5F,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU;IAC3E,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,QAAQ,EAAE,4BAA4B,EAAE,CAAC;CAC1C;AAiCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,EACpE,MAAM,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAC/C,4BAA4B,CAAC,OAAO,CAAC,CA0KvC"}
+{"version":3,"file":"resource-polymorphism.schemas.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/resource-polymorphism.schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAA6B,KAAK,kCAAkC,EAAiC,MAAM,+BAA+B,CAAC;AAClJ,OAAO,KAAK,EAAE,YAAY,EAAgB,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAE/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAMzE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,4BAA6B,SAAQ,kCAAkC;IACtF;;;;OAIG;IACH,cAAc,EAAE,OAAO,CAAC;IAExB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC9B;AACD,yEAAyE;AAEzE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,4BAA4B,GACvC,4BAA4B,CAE9B;AACD,0EAA0E;AAE1E;;;GAGG;AACH,MAAM,WAAW,0BAA0B,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IACrF,2DAA2D;IAC3D,kBAAkB,EAAE,YAAY,CAAC;IACjC,6DAA6D;IAC7D,qBAAqB,EAAE,MAAM,CAAC;IAC9B,8DAA8D;IAC9D,cAAc,EAAE,OAAO,CAAC;IACxB,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,eAAe,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,cAAc,EAAE,MAAM,CAAC;IACvB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,MAAM,EAAE,OAAO,CAAC;IAChB,uFAAuF;IACvF,YAAY,CAAC,EAAE,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CAC5H;AAED;;;GAGG;AACH,MAAM,WAAW,4BAA4B,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU;IACvF,uCAAuC;IACvC,aAAa,EAAE,IAAI,CAAC;IACpB,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,+DAA+D;IAC/D,UAAU,EAAE,OAAO,CAAC;IACpB,oEAAoE;IACpE,kBAAkB,EAAE,4BAA4B,EAAE,CAAC;IACnD,4FAA4F;IAC5F,QAAQ,EAAE,GAAG,CAAC,YAAY,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC,CAAC;CAClE;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU;IAC3E,mDAAmD;IACnD,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,mBAAmB,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB,oDAAoD;IACpD,QAAQ,EAAE,4BAA4B,EAAE,CAAC;CAC1C;AAiCD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,SAAS,CAAC,CAAC,UAAU,EACpE,MAAM,EAAE,+BAA+B,CAAC,OAAO,CAAC,GAC/C,4BAA4B,CAAC,OAAO,CAAC,CAkMvC;AAgED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,wBAAgB,gCAAgC,CAC9C,UAAU,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,EACtC,QAAQ,EAAE,aAAa,CAAC;IAAE,kBAAkB,EAAE,MAAM,CAAA;CAAE,CAAC,GACtD,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAezC"}