@wildo-ai/saas-models 1.1.4 → 1.1.5

package/dist/esm/resources/utils/resources-config-operations.path.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources-config-operations.path.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/resources-config-operations.path.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,mCAAmC,EACnC,6CAA6C,EAC9C,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAI3F,eAAO,MAAM,mCAAmC,cAAc,CAAC;AAC/D,eAAO,MAAM,sCAAsC,iBAAiB,CAAC;AAGrE,KAAK,qBAAqB,GAAG;IAC3B,kBAAkB,EAAE,YAAY,GAAG,MAAM,CAAC;IAC1C,mBAAmB,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC5E,WAAW,EAAE,4BAA4B,CAAC;IAC1C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAYF,qBAAa,kCAAkC;IAC7C,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAKnC;;OAEG;WACW,oBAAoB,CAChC,SAAS,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GACzC,mCAAmC,CAAC,GAAG,EAAE,GAAG,CAAC;WAqBlC,kCAAkC,CAAC,SAAS,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,MAAM;IAKpG;;;OAGG;WACW,sBAAsB,CAClC,aAAa,EAAE;QACb,kBAAkB,EAAE,YAAY,GAAG,MAAM,CAAC;QAC1C,mBAAmB,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAC5E,WAAW,EAAE,4BAA4B,CAAC;QAC1C,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,MAAM;IAiCT;;;OAGG;WACW,qBAAqB,CAAC,mBAAmB,EAAE,MAAM,GAAG,mCAAmC,CAAC,GAAG,EAAE,GAAG,CAAC;IA2B/G;;;OAGG;WACW,mCAAmC,CAAC,SAAS,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,MAAM;IAKrG;;OAEG;WACW,8BAA8B,CAC1C,oBAAoB,SAAS,YAAY,GAAG,SAAS,EACrD,kBAAkB,SAAS,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,EAErE,SAAS,EAAE,+BAA+B,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,GAAG,CAAC,GACxF,6CAA6C;IA6BhD;;;OAGG;WACW,gCAAgC,CAC5C,uBAAuB,EAAE,6CAA6C,GACrE,MAAM;IAiBT;;;OAGG;WACW,+BAA+B,CAAC,6BAA6B,EAAE,MAAM,GAAG,6CAA6C;IAmBnI;;;OAGG;WACW,6CAA6C,CACzD,oBAAoB,SAAS,YAAY,GAAG,SAAS,EACrD,kBAAkB,SAAS,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,EAErE,SAAS,EAAE,+BAA+B,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,GAAG,CAAC,GACxF,MAAM;IAKT;;;OAGG;WACW,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAqDtE;;;OAGG;WACW,kCAAkC,CAAC,0BAA0B,EAAE,MAAM,GAAG,IAAI;CAmD3F"}
+{"version":3,"file":"resources-config-operations.path.utils.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/resources-config-operations.path.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAC/B,mCAAmC,EACnC,6CAA6C,EAC9C,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAAE,4BAA4B,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAI3F,eAAO,MAAM,mCAAmC,cAAc,CAAC;AAC/D,eAAO,MAAM,sCAAsC,iBAAiB,CAAC;AAGrE,KAAK,qBAAqB,GAAG;IAC3B,kBAAkB,EAAE,YAAY,GAAG,MAAM,CAAC;IAC1C,mBAAmB,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAC5E,WAAW,EAAE,4BAA4B,CAAC;IAC1C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAYF,qBAAa,kCAAkC;IAC7C,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAKnC;;OAEG;WACW,oBAAoB,CAChC,SAAS,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GACzC,mCAAmC,CAAC,GAAG,EAAE,GAAG,CAAC;WAqBlC,kCAAkC,CAAC,SAAS,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,MAAM;IAKpG;;;OAGG;WACW,sBAAsB,CAClC,aAAa,EAAE;QACb,kBAAkB,EAAE,YAAY,GAAG,MAAM,CAAC;QAC1C,mBAAmB,EAAE,MAAM,GAAG,YAAY,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;QAC5E,WAAW,EAAE,4BAA4B,CAAC;QAC1C,kBAAkB,CAAC,EAAE,OAAO,CAAC;QAC7B,eAAe,CAAC,EAAE,OAAO,CAAC;QAC1B,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GACA,MAAM;IAiCT;;;OAGG;WACW,qBAAqB,CAAC,mBAAmB,EAAE,MAAM,GAAG,mCAAmC,CAAC,GAAG,EAAE,GAAG,CAAC;IA2B/G;;;OAGG;WACW,mCAAmC,CAAC,SAAS,EAAE,QAAQ,CAAC,qBAAqB,CAAC,GAAG,MAAM;IAKrG;;OAEG;WACW,8BAA8B,CAC1C,oBAAoB,SAAS,YAAY,GAAG,SAAS,EACrD,kBAAkB,SAAS,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,EAErE,SAAS,EAAE,+BAA+B,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,GAAG,CAAC,GACxF,6CAA6C;IA6BhD;;;OAGG;WACW,gCAAgC,CAC5C,uBAAuB,EAAE,6CAA6C,GACrE,MAAM;IAiBT;;;OAGG;WACW,+BAA+B,CAAC,6BAA6B,EAAE,MAAM,GAAG,6CAA6C;IAmBnI;;;OAGG;WACW,6CAA6C,CACzD,oBAAoB,SAAS,YAAY,GAAG,SAAS,EACrD,kBAAkB,SAAS,OAAO,CAAC,qBAAqB,CAAC,GAAG,SAAS,EAErE,SAAS,EAAE,+BAA+B,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,GAAG,CAAC,GACxF,MAAM;IAKT;;;OAGG;WACW,wBAAwB,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI;IAqDtE;;;OAGG;WACW,kCAAkC,CAAC,0BAA0B,EAAE,MAAM,GAAG,IAAI;CAmD3F"}

package/dist/esm/resources/utils/resources-config-operations.urls-builder.utils.d.ts

@@ -248,6 +248,40 @@ export declare class ResourcesConfigOperationsUrlsBuilderUtils {
      * - OPTIONAL_CONTEXT: Can be included or not in parent context (generates multiple URL paths)
      * - STANDALONE: Never included in URL path - resource is accessed independently
      *   (the relationship exists for data model purposes, but not for URL routing)
+     *
+     * ## The nesting ceiling: a resource's DIRECT parents only (#1095)
+     *
+     * `parentInfos` holds the resource's OWN parent relationships. A parent's own optional parents are
+     * never chained: with `TODO_LISTS → TODOS` and `TODOS → TASKS` both OPTIONAL_CONTEXT, tasks mount
+     * under `/organizations/{org}/tasks` and `/organizations/{org}/todos/{todo}/tasks`, and the
+     * four-level `/organizations/{org}/todo-lists/{list}/todos/{todo}/tasks` does NOT exist — the
+     * grandparent contributes nothing to the grandchild's URL set. So the deepest route an application
+     * can reach is primary scope + one level of direct parents, and a lane asserting a deeper chain is
+     * asserting a route the framework never generates (pinned by
+     * `examples/wonder-todos/e2e/resource-relationships.e2e.ts`, A4b).
+     *
+     * This is a design ceiling rather than an oversight, and it is deliberately NOT lifted here: chaining
+     * optional parents transitively multiplies the route set per level and asks the URL parent coherence
+     * check to reconcile a grandparent it has no FK for.
+     *
+     * ## DECIDED 2026-09-17 (#1121): the ceiling STAYS
+     *
+     * Measured before deciding rather than argued from the cost alone. Navigation, breadcrumbs and
+     * context loading read the ancestor chain from `parentResourcesRequirements` — the resource context
+     * — and not from URL depth (`useNavigationController.ts`), so nothing renders differently for the
+     * absence of the deeper route. Wonder Todos declares exactly the shape that would use it
+     * (`TODO_LISTS → TODOS → TASKS`, both hops OPTIONAL_CONTEXT) and has run against this ceiling
+     * throughout.
+     *
+     * Both alternatives were real and both were refused for the same reason: they buy a capability with
+     * no consumer. Chaining every hop needs a DEFINED answer — 404 or a coherence 400 — for a todo whose
+     * `todoListId` disagrees with the `{list}` in the URL, at every depth, and the coherence check has
+     * no FK to reconcile the grandparent with. Opting in per relationship adds a declarative authoring
+     * surface for a case nobody has asked for, which is the thing a framework should add last.
+     *
+     * So the rule is unchanged and now has a reason attached: do not widen this builder until an
+     * application needs deeper addressing, and when one does, the FIRST thing owed is the coherence
+     * answer, not the route generation.
      */
     private static generateParentCombinations;
     /**

package/dist/esm/resources/utils/resources-config-operations.urls-builder.utils.d.ts.map

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

package/dist/esm/resources/utils/resources-config-operations.urls-builder.utils.js

@@ -483,7 +483,17 @@ export class ResourcesConfigOperationsUrlsBuilderUtils {
                 if (relationship.accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.STANDALONE) {
                     continue;
                 }
-                throw new Error(`Cannot generate URL parent info for "${resourceType}" without a registered field identifier or relationship foreignKeyField.`);
+                /*
+                 * Name the CHILD, not only the parent. The parent alone ("organizations") is true of most
+                 * resources in a registry, so the message sent a reader to grep for a type that is
+                 * everywhere while saying nothing about which relationship is unresolvable — measured
+                 * 2026-09-21 on a companion OpenAPI generation that refused with no way to locate it.
+                 */
+                throw new Error(`Cannot generate URL parent info for parent "${resourceType}" of child `
+                    + `"${relationship.resourceType2}" (relationship nature ${String(relationship.nature)}, `
+                    + `accessScopeStrategy ${String(relationship.accessScopeStrategy)}) without a registered `
+                    + 'field identifier or relationship foreignKeyField. The parent type is usually absent from '
+                    + '`allResourceFieldIdentifiers` because feature gating excluded it from this registry.');
             }
             parentInfos.push({
                 resourceType,
@@ -598,6 +608,40 @@ export class ResourcesConfigOperationsUrlsBuilderUtils {
      * - OPTIONAL_CONTEXT: Can be included or not in parent context (generates multiple URL paths)
      * - STANDALONE: Never included in URL path - resource is accessed independently
      *   (the relationship exists for data model purposes, but not for URL routing)
+     *
+     * ## The nesting ceiling: a resource's DIRECT parents only (#1095)
+     *
+     * `parentInfos` holds the resource's OWN parent relationships. A parent's own optional parents are
+     * never chained: with `TODO_LISTS → TODOS` and `TODOS → TASKS` both OPTIONAL_CONTEXT, tasks mount
+     * under `/organizations/{org}/tasks` and `/organizations/{org}/todos/{todo}/tasks`, and the
+     * four-level `/organizations/{org}/todo-lists/{list}/todos/{todo}/tasks` does NOT exist — the
+     * grandparent contributes nothing to the grandchild's URL set. So the deepest route an application
+     * can reach is primary scope + one level of direct parents, and a lane asserting a deeper chain is
+     * asserting a route the framework never generates (pinned by
+     * `examples/wonder-todos/e2e/resource-relationships.e2e.ts`, A4b).
+     *
+     * This is a design ceiling rather than an oversight, and it is deliberately NOT lifted here: chaining
+     * optional parents transitively multiplies the route set per level and asks the URL parent coherence
+     * check to reconcile a grandparent it has no FK for.
+     *
+     * ## DECIDED 2026-09-17 (#1121): the ceiling STAYS
+     *
+     * Measured before deciding rather than argued from the cost alone. Navigation, breadcrumbs and
+     * context loading read the ancestor chain from `parentResourcesRequirements` — the resource context
+     * — and not from URL depth (`useNavigationController.ts`), so nothing renders differently for the
+     * absence of the deeper route. Wonder Todos declares exactly the shape that would use it
+     * (`TODO_LISTS → TODOS → TASKS`, both hops OPTIONAL_CONTEXT) and has run against this ceiling
+     * throughout.
+     *
+     * Both alternatives were real and both were refused for the same reason: they buy a capability with
+     * no consumer. Chaining every hop needs a DEFINED answer — 404 or a coherence 400 — for a todo whose
+     * `todoListId` disagrees with the `{list}` in the URL, at every depth, and the coherence check has
+     * no FK to reconcile the grandparent with. Opting in per relationship adds a declarative authoring
+     * surface for a case nobody has asked for, which is the thing a framework should add last.
+     *
+     * So the rule is unchanged and now has a reason attached: do not widen this builder until an
+     * application needs deeper addressing, and when one does, the FIRST thing owed is the coherence
+     * answer, not the route generation.
      */
     static generateParentCombinations(parentInfos) {
         // Filter out STANDALONE relationships - they are NEVER included in URL paths

package/dist/esm/resources/utils/resources-config-operations.urls-builder.utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"resources-config-operations.urls-builder.utils.js","sourceRoot":"","sources":["../../../../../src/resources/utils/resources-config-operations.urls-builder.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/** URL Generation Examples:\n * \n * Collection-Level Operations (no entity ID):\n * - LIST: GET /api/v1/organizations/{organizationId}/organization-features  \n * - CREATE: POST /api/v1/organizations/{organizationId}/organization-features\n * - CREATE_MANY: POST /api/v1/organizations/{organizationId}/organization-features (differentiated by request body)\n * - UPDATE_MANY: PUT /api/v1/organizations/{organizationId}/organization-features\n * - DELETE_MANY: DELETE /api/v1/organizations/{organizationId}/organization-features\n * - SEARCH: GET /api/v1/organizations/{organizationId}/organization-features/search\n * - COUNT: GET /api/v1/organizations/{organizationId}/organization-features/count\n * - Custom collection operations (with resourceOperationLike pointing to collection op): \n *   PUT /api/v1/organizations/{organizationId}/organization-features/reset-features\n * \n * Entity-Level Operations:\n * - Regular resources include their entity ID in the route.\n * - Parent-owned composition singletons and complete M:N paths omit the child /\n *   junction ID because the declared relationship path uniquely identifies it.\n * - READ: GET /api/v1/organizations/{organizationId}/organization-features\n * - UPDATE: PUT /api/v1/organizations/{organizationId}/organization-features\n * - DELETE: DELETE /api/v1/organizations/{organizationId}/organization-features\n * - Custom entity operations follow the same entity-id rule as their effective\n *   core operation: regular entity resources include the id, while\n *   parent-owned composition singletons and complete M:N paths omit it.\n * \n * Variant Keys (for role-based variants):\n * - LIST admin variant: GET /api/v1/organizations/{organizationId}/organization-features/admin\n * - READ admin variant on regular entity resources:\n *   GET /api/v1/organizations/{organizationId}/organization-features/{id}/admin\n * - READ admin variant on parent-owned composition singletons or complete M:N\n *   paths omits the child/junction ID:\n *   GET /api/v1/organizations/{organizationId}/organization-features/admin\n * - SEARCH admin variant: GET /api/v1/organizations/{organizationId}/organization-features/search/admin\n * \n * Bulk Operations (collection-level, no entity ID):\n * - DELETE bulk: DELETE /api/v1/organizations/{organizationId}/organization-features/bulk\n * - DELETE bulk admin: DELETE /api/v1/organizations/{organizationId}/organization-features/bulk/admin\n * \n * Access Scope Strategy (determines URL path generation):\n * - REQUIRES_CONTEXT: Always in URL path (mandatory parent)\n * - OPTIONAL_CONTEXT: Generates multiple URLs with/without parent\n * - STANDALONE: NEVER in URL path - resource accessed independently (data relationship only)\n *   Example: APPLICATION → ORGANIZATIONS with STANDALONE means /organizations not /applications/{id}/organizations\n * \n * Foreign Key Relationships (foreignKeyField):\n * - FK relationships like TODOS → USERS with assignedToUserId are transformed to parent relationships\n * - They use OPTIONAL_CONTEXT to generate alternative URL paths\n * - Example: /assigned-to-users/{assignedToUserId}/todos (prefix derived from FK field name)\n * \n * Many-to-Many Relationships (via junction table):\n * - Junction table (e.g., ORGANIZATION_MEMBERS) can be accessed from BOTH sides\n * - Both parents use OPTIONAL_CONTEXT to generate independent paths\n * - Example: /organizations/{orgId}/organization-members\n * - Example: /users/{userId}/organization-members\n * - Combined: /organizations/{orgId}/users/{userId}/organization-member (singular, unique record)\n */\n\nimport { \n  ResourceConfiguration, \n  AnyResourceConfiguration,\n  ResourceConfiguration_Operation_ApiCall,\n  ResourceConfiguration_Operation_ApiCallWithCallback,\n  ResourcesRegistry,\n  ResourceConfiguration_Operation_UrlParameterInfo,\n  ResourceConfiguration_Operation_UrlInitiatorInfo,\n  ResourceConfiguration_Operation,\n  ResourceGeneratedOperationKind,\n  getParentDirectionRelationships,\n  getChildDirectionRelationships,\n  type ResourceConfiguration_ResourceRelationships,\n} from '../resources-config.shared.schemas';\nimport { z } from 'zod';\n\nimport { \n  ResourceRelationship,\n  ResourceRelationshipDeclaration,\n  RelationshipNature,\n  ResourceParentResourceRequirement,\n  ResourceOperationVariantType,\n  ResourceRelationshipAccessScopeStrategy,\n  ResourceRelationshipCardinality,\n  isOneToOneCardinality,\n} from '../resources.shared.schemas';\nimport { \n  ResourceType,\n  ResourceFieldIdentifier,\n  ALL_COLLECTION_OPERATIONS,\n  CoreResourceOperation\n} from '../resources.shared.core.definitions';\nimport { ResourcesConfigNamingUtils } from './resources-config-naming.utils';\nimport { Resources_SharedUtils } from '../resources.shared.utils';\nimport { EnumLikeType } from '@wildo-ai/zod-decorators';\nimport { ResourcesConfig_OperationPathUtils } from './resources-config-operations.path.utils';\nimport { MAIN_API_BASE_PATH } from '../../requests/manual-controllers-routes-urls';\n\nexport interface URLGenerationResult {\n  initiatorInfos: ResourceConfiguration_Operation_UrlInitiatorInfo[];\n  metadata: {\n    operation: string;\n    variantKey?: string;\n    isBulk: boolean;\n    isSearch: boolean;\n    isCount: boolean;\n    parentCombinations: string[][];\n  };\n}\n\nexport interface ParentResourceInfo {\n  resourceType: ResourceType;\n  fieldIdentifier: string;\n  isPrimaryScope: boolean;\n  isOptional: boolean;\n  accessScopeStrategy: ResourceRelationshipAccessScopeStrategy;\n  /** Foreign key field for disambiguation or non-standard naming */\n  foreignKeyField?: string;\n  /** Child-side FK proven by resolved persistence semantics for singleton URL omission. */\n  childForeignKeyField?: string;\n  relationshipNature?: RelationshipNature;\n  jointResourceType?: ResourceType;\n  /** Scope-via-junction tag (scope-required reference search) — propagated to the URL param. */\n  scopeViaJunction?: ResourceType;\n  cardinality1?: ResourceRelationshipCardinality;\n  cardinality2: ResourceRelationshipCardinality; // Cardinality from parent to child\n  order: number;\n}\n\nexport type ResourceConfiguration_Operation_Urlisable<TCustomOperationEnum extends EnumLikeType | undefined, TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined> = \n    ResourceConfiguration_Operation_ApiCall<TCustomOperationEnum, TCoreOperationEnum, z.ZodTypeAny> \n  | ResourceConfiguration_Operation_ApiCallWithCallback<TCustomOperationEnum, TCoreOperationEnum, z.ZodTypeAny>;\n\n\nexport class ResourcesConfigOperationsUrlsBuilderUtils {\n  \n \n  public static buildUrlsForResourceConfiguration( resourceConfig: AnyResourceConfiguration, allResourceFieldIdentifiers: Record<string, string> ): Record<string, URLGenerationResult> {\n\n    const results: Record<string, URLGenerationResult> = {};\n    const apiCallOperations = resourceConfig.operations.filter( (op): op is ResourceConfiguration_Operation_Urlisable<any, any> => this.isUrlisable(op.variantType));\n    \n    for (const operation of apiCallOperations) {\n      const operationKey = this.getOperationKey(operation);\n      results[operationKey] = this.buildUrlsForOperation( operation, resourceConfig, allResourceFieldIdentifiers);\n    }\n    \n    return results;\n  }\n\n\n\n\n  /**\n  * Build URLs for all API_CALL and API_CALL_WITH_CALLBACK operations in a resource configuration\n  */\n  public static updateOperationUrls( resourceConfig: AnyResourceConfiguration, allResourceFieldIdentifiers: Record<string, string> ): void {\n    const urlResults = this.buildUrlsForResourceConfiguration( resourceConfig, allResourceFieldIdentifiers);\n    \n    // Update URLs in API_CALL and API_CALL_WITH_CALLBACK operations\n    for (const operation of resourceConfig.operations) {\n      if (this.isUrlisable(operation.variantType)) {\n\n        const apiCallOp = operation as ResourceConfiguration_Operation_Urlisable<any, any>;\n        const operationKey = this.getOperationKey(apiCallOp);\n        const urlResult = urlResults[operationKey];\n        \n        if (urlResult) {\n          apiCallOp.initiatorInfos = urlResult.initiatorInfos;\n        }\n      }\n    }\n  }\n  \n  /**\n   * Return the full parent edge set that can legitimately address a resource in URLs.\n   *\n   * This includes:\n   * - real parent/self relationships from the active operation relationship\n   *   view, falling back to the compiled resource model\n   * - synthetic FK-reference parents used to expose alternative nested paths for\n   *   non-standard FK fields without polluting the stored relationship graph\n   *\n   * Frontend navigation and form/runtime consumers should reuse this helper when\n   * they need to stay aligned with URL addressability semantics.\n   *\n   * Note that URL parent addressability is intentionally broader than\n   * context-addressed mutation eligibility: self relationships can contribute\n   * navigable tree routes, but singleton mutation target resolution only trusts\n   * compiled `parentRelationships`.\n   */\n  public static getUrlAddressableParentRelationships(\n    resourceConfig: AnyResourceConfiguration,\n    allResourceFieldIdentifiers: Record<string, string>,\n    resourceRelationshipsOverride?: ResourceConfiguration_ResourceRelationships,\n  ): ResourceRelationship[] {\n    const realParents = getParentDirectionRelationships(\n      resourceRelationshipsOverride ?? resourceConfig.resourceRelationships,\n    ).filter(\n      (relationship) =>\n        !this.isInboundFkReferenceParent(relationship, allResourceFieldIdentifiers),\n    );\n    // The SAME inbound-FK guard must run over the synthetic parents, not only the real ones.\n    //\n    // {@link isInboundFkReferenceParent} was written to stop a resource being nested under something\n    // that holds an FK pointing AT it — its JSDoc names the symptom exactly: \"phantom routes […]\n    // that require an id the target has no notion of and that no controller registers — a guaranteed\n    // 404 for every consumer of the target resource's own routes\". But it was applied only to\n    // `realParents`, while {@link generateSyntheticFKParents} appends parents built by REVERSING a\n    // child relationship — which is precisely how an inbound FK reference gets in.\n    //\n    // That gap took the whole `users` API surface off the air on 2026-08-06. Adding\n    // `PLATFORM_ACCESS_GRANTS` with `foreignKeyField: 'operatorUserId'` (non-standard, since USERS'\n    // identifier is `userId`) synthesised a reversed parent, and every users route became\n    // `/operator-user-platform-access-grants/{operatorUserId}/users/{userId}` — the bare\n    // `/users/{userId}` disappeared entirely and the resource 404'd. `applications` was already\n    // broken the same way by `appId` on application-features/metadata/versions (7 phantom\n    // combinations, no bare `/applications`); nobody had noticed because nothing called it.\n    //\n    // Measured over the full core catalogue, this filter changes 4 resources and removes ONLY\n    // phantom shapes — `users` and `applications` regain their base paths, and the two\n    // `referrer-billing-account-referrals/{referrerBillingAccountId}/…-billing-accounts` variants\n    // (addressing a billing account under a billing-account id) go with them. None of the removed\n    // shapes had ever been served: 0 occurrences across the last 8 dev logs.\n    //\n    // WHY THE GENERATOR IS KEPT, and why this filter cannot break its legitimate output.\n    //\n    // `generateSyntheticFKParents` assumes `resourceType1` is the FK HOLDER. Declared that way — the\n    // header example `TODOS → USERS with assignedToUserId` — reversing it yields exactly the intended\n    // `/assigned-to-users/{assignedToUserId}/todos`, and the cardinalities (TODOS MANY → USERS ONE)\n    // make the synthetic's `cardinality2` MANY, so this guard KEEPS it.\n    //\n    // The broken cases declare the FK TARGET first instead (`USERS → PLATFORM_ACCESS_GRANTS`,\n    // `APPLICATIONS → APPLICATION_FEATURES`). The generator cannot tell the difference from\n    // declaration order, but the guard can: it reads FK ownership from CARDINALITY, so a synthetic\n    // built from a target-first declaration comes out `cardinality1 === MANY` and is rejected.\n    //\n    // So the filter separates the two shapes on the only signal that is actually reliable — which is\n    // the same reason `isInboundFkReferenceParent` reads cardinality rather than argument order.\n    //\n    // MEASURED, so the next reader need not guess who this affects: of 335 relationship declarations\n    // repo-wide, the holder-first shape this generator serves has exactly EIGHT production\n    // consumers, all in one app file (`tasks-manager.relationships.ts`) and all the same idea — a\n    // \"who created / who is assigned\" pointer at USERS or ORGANIZATION_UNITS (`createdByUserId`,\n    // `assignedToUserId`, `postedByUserId`, `organizationUnitId`). The engine declares ZERO; every\n    // one of its 40 core relationships is parent-first.\n    //\n    // That asymmetry IS the failure story. This generator is an APP-AUTHORING feature the engine had\n    // never exercised, so when engine relationships began carrying non-standard FKs\n    // (`operatorUserId`, `appId`) they fell into machinery with no engine-side precedent and nothing\n    // watching it. Keep that in mind before assuming a change here is engine-only.\n    const syntheticFKParents = this.generateSyntheticFKParents(\n      resourceConfig,\n      allResourceFieldIdentifiers,\n      resourceRelationshipsOverride,\n    ).filter(\n      (relationship) =>\n        !this.isInboundFkReferenceParent(relationship, allResourceFieldIdentifiers),\n    );\n\n    return [...realParents, ...syntheticFKParents];\n  }\n\n  /**\n   * Detect a parent-bucket entry that is actually an INBOUND FK reference —\n   * i.e. the *other* resource holds an FK that points at the current resource,\n   * so the current resource is the FK **target**, not a routable child.\n   *\n   * In the parent bucket the current resource is always `resourceType2`. A\n   * relationship legitimately nests the current resource under `resourceType1`\n   * only when the current resource **holds the foreign key** that references\n   * `resourceType1` (e.g. `draftNotes.userId → users`, `userProfiles.userId →\n   * users`). When the FK lives on `resourceType1` and points back at the\n   * current resource (e.g. `todos.assignedToUserId → users`,\n   * `tasks.assignedToUserId → users`), nesting the current resource under\n   * `resourceType1` is semantically inverted: it yields phantom routes like\n   * `/assigned-to-user-todos/{assignedToUserId}/users/search` that require an\n   * id the target has no notion of and that no controller registers — a\n   * guaranteed 404 for every consumer of the target resource's own routes.\n   *\n   * The correct holder-under-target route (`/assigned-to-users/{userId}/todos`)\n   * is produced independently by {@link generateSyntheticFKParents} from the\n   * FK-holder's child bucket, so excluding the inbound direction here loses no\n   * legitimate addressability.\n   *\n   * FK ownership is read off the relationship shape (no schema access needed):\n   * - `cardinality2 === MANY` → the current resource is the many side and holds\n   *   the FK → genuine child, keep.\n   * - `cardinality1 === MANY` (so the current `one` side is referenced by a\n   *   many holder) → current is the FK target → inbound, drop.\n   * - `1:1` → the current resource holds the FK only when the FK is\n   *   `resourceType1`'s standard identifier (a standard parent reference like\n   *   `userProfiles.userId`); a non-standard FK (`assignedToUserId`) on a 1:1\n   *   edge belongs to `resourceType1` and points back at current → inbound,\n   *   drop.\n   *\n   * Only `REFERENCE`-nature edges can be inbound; compositions/associations\n   * always contain the current resource as a genuine child, and self\n   * relationships (`resourceType1 === resourceType2`) are legitimate tree\n   * routes — both are never treated as inbound.\n   */\n  private static isInboundFkReferenceParent(\n    relationship: ResourceRelationship,\n    allResourceFieldIdentifiers: Record<string, string>,\n  ): boolean {\n    if (relationship.resourceType1 === relationship.resourceType2) {\n      return false;\n    }\n    if (relationship.nature !== RelationshipNature.REFERENCE) {\n      return false;\n    }\n\n    const currentHoldsForeignKey =\n      relationship.cardinality2 === ResourceRelationshipCardinality.MANY\n        ? true\n        : relationship.cardinality1 === ResourceRelationshipCardinality.MANY\n          ? false\n          : relationship.foreignKeyField != null\n            && relationship.foreignKeyField === allResourceFieldIdentifiers[relationship.resourceType1];\n\n    return !currentHoldsForeignKey;\n  }\n\n  /**\n   * Build URLs for a specific operation\n   */\n  private static buildUrlsForOperation( operation: ResourceConfiguration_Operation_Urlisable<any, any>, resourceConfig: AnyResourceConfiguration, allResourceFieldIdentifiers: Record<string, string> ): URLGenerationResult {\n\n    const initiatorInfos: ResourceConfiguration_Operation_UrlInitiatorInfo[] = [];\n    \n    const coreOperation = this.getCoreOperation(operation);\n\n    // Scope-required reference search: an edge tagged with `urlOperationScope`\n    // contributes its URL ONLY for the listed core operations (the scope-anchored\n    // peer-under-scope edge restricts to SEARCH/LIST). Untagged edges (every\n    // normal relationship) are unaffected.\n    const allParentsForURLs = this.getUrlAddressableParentRelationships(\n      resourceConfig,\n      allResourceFieldIdentifiers,\n      operation.resourceRelationships,\n    ).filter((rel) => !rel.urlOperationScope || rel.urlOperationScope.includes(coreOperation));\n\n    // Generate URL paths from all parent combinations\n    const parentInfos = this.getParentResourceInfos(allParentsForURLs, allResourceFieldIdentifiers);\n    const parentCombinations = this.generateParentCombinations(parentInfos).filter(\n      (parentCombo) =>\n        coreOperation !== CoreResourceOperation.LIST\n        || !this.isCompleteManyToManyPath(parentCombo),\n    );\n\n    // A complete M:N parent path identifies one junction row: for example,\n    // organization + user identifies THE organization-membership. That path is\n    // therefore an entity address owned by READ. LIST remains available under\n    // either individual parent (members by organization, memberships by user),\n    // but must not also claim the complete path with the same GET method. Doing\n    // so registers two different operation contracts on one HTTP route and\n    // makes router ordering decide which contract is actually served.\n\n    for (const parentCombo of parentCombinations) {\n      const urlInfo = this.buildUrlForParentCombination( parentCombo, resourceConfig, operation, allResourceFieldIdentifiers, false);\n      \n      const initiatorInfo: ResourceConfiguration_Operation_UrlInitiatorInfo = {\n        url: urlInfo.url,\n        parameters: urlInfo.parameters,\n        ...(operation.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK && {\n          urlCallback: `${urlInfo.url}/callback`\n        })\n      };\n      \n      initiatorInfos.push(initiatorInfo);\n    }\n\n    // W7.3a: Dual initiatorInfos for isAnonymizable resources.\n    // For operations that allow APP_ANONYMOUS, generate additional URL patterns\n    // with the ANONYMOUS_USERS parent replacing the USER_SELF parent.\n    if (resourceConfig.isAnonymizable && (operation as any).roles?.includes('APP_ANONYMOUS')) {\n      for (const parentCombo of parentCombinations) {\n        const userSelfParentIndex = parentCombo.findIndex(p =>\n          p.isPrimaryScope && p.fieldIdentifier === 'userId'\n        );\n\n        if (userSelfParentIndex >= 0) {\n          const anonymousCombo = parentCombo.map((p, i) => {\n            if (i === userSelfParentIndex) {\n              // Synthesize the ANONYMOUS_USERS parent that masks the USER_SELF\n              // primary parent for the anonymous URL variant.\n              //\n              // `foreignKeyField` MUST become the anonymous user's own FK\n              // (`anonymousUserId`), NOT the inherited `userId` from the\n              // authenticated parent. `buildUrlForParentCombination` derives\n              // BOTH the route param name (`foreignKeyField || fieldIdentifier`)\n              // AND the param's `relationshipField` (the child-filter FK) from\n              // `foreignKeyField`. Leaving it as `userId` was the W7.3a bug:\n              //  - the route param bound `req.params.userId`, which\n              //    `extractInitiatorIds` maps to `initiatorIds.userId` → the\n              //    ANONYMOUS_SESSION ExecutionContext constructor rejects any\n              //    authenticated identity field → 500 at\n              //    `handleAnonymousSessionInit`; and\n              //  - the nested-LIST child filter keyed on `userId` (null for\n              //    anonymous rows), never on the `anonymousUserId` column that\n              //    actually stores the session handle.\n              // With `anonymousUserId`, the param is ignored by\n              // `extractInitiatorIds` (the session id is set from the\n              // `x-anonymous-session-init` header), the coherence check pins the\n              // URL uuid to the session uuid (defense in depth), and the child\n              // filter targets the correct column.\n              //\n              // The URL segment stays honest: `anonymousUserId` IS the standard\n              // identifier of `anonymous_users`, so `extractRelationshipPrefix`\n              // strips it → no redundant prefix → `/anonymous-users/…`, parallel\n              // to the authenticated `/users/{userId}/…` route.\n              return {\n                ...p,\n                resourceType: 'anonymous_users' as ResourceType,\n                fieldIdentifier: 'anonymousUserId',\n                foreignKeyField: 'anonymousUserId',\n              };\n            }\n            return p;\n          });\n\n          const urlInfo = this.buildUrlForParentCombination(\n            anonymousCombo, resourceConfig, operation, allResourceFieldIdentifiers, false\n          );\n\n          const anonInitiatorInfo: ResourceConfiguration_Operation_UrlInitiatorInfo = {\n            url: urlInfo.url,\n            parameters: urlInfo.parameters,\n            ...(operation.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK && {\n              urlCallback: `${urlInfo.url}/callback`\n            })\n          };\n\n          initiatorInfos.push(anonInitiatorInfo);\n        }\n      }\n    }\n    \n    return {\n      initiatorInfos,\n      metadata: {\n        operation: String(operation.operationIdentifier),\n        variantKey: operation.variantKey,\n        isBulk: operation.isBulkOperation,\n        isCount : coreOperation === CoreResourceOperation.COUNT,\n        isSearch: coreOperation === CoreResourceOperation.SEARCH,\n        // Informational only: initiatorInfos.parameters remain the canonical\n        // source for FK/relationship-field route evidence.\n        parentCombinations: parentCombinations.map(combo =>\n          combo.map(parent => parent.resourceType)\n        )\n      }\n    };\n  }\n\n  public static buildOperationFrontendRoutePaths( \n    resourceConfig: AnyResourceConfiguration, \n    operation: ResourceConfiguration_Operation_Urlisable<any, any>, \n    allResourceFieldIdentifiers: Record<string, string>\n  ): { url: string; parameters: ResourceConfiguration_Operation_UrlParameterInfo[] }[] {\n    \n    if (!this.isUrlisable(operation.variantType))\n      return []; // other presets are not routable\n\n    // Mirror buildUrlsForOperation's `urlOperationScope` filter so frontend route\n    // generation and backend route registration stay in lock-step.\n    const coreOperation = this.getCoreOperation(operation);\n    const allParentsForURLs = this.getUrlAddressableParentRelationships(\n      resourceConfig,\n      allResourceFieldIdentifiers,\n      operation.resourceRelationships,\n    ).filter((rel) => !rel.urlOperationScope || rel.urlOperationScope.includes(coreOperation));\n\n    const parentInfos = this.getParentResourceInfos(allParentsForURLs, allResourceFieldIdentifiers);\n    const parentCombinations = this.generateParentCombinations(parentInfos);\n    const frontendRoutePaths:  { url: string; parameters: ResourceConfiguration_Operation_UrlParameterInfo[] }[]  = [];\n  \n    for (const parentCombo of parentCombinations) {\n      const routePath = this.buildUrlForParentCombination( parentCombo, resourceConfig, operation, allResourceFieldIdentifiers, true);\n      frontendRoutePaths.push(routePath);\n    }\n  \n    return frontendRoutePaths;\n  }\n\n  /**\n   * Build a resource-integrated file upload route from a concrete operation route.\n   *\n   * File uploads should stay aligned with the operation route family they extend.\n   * For CREATE-like uploads, the collection route is sufficient. For UPDATE-like\n   * uploads, the target resource id must appear exactly once:\n   * - if the operation route already addresses the entity, reuse it as-is\n   * - if the operation route intentionally omits the entity id (for unique nested\n   *   addresses such as one-to-one or complete many-to-many paths), append the\n   *   target resource placeholder before the `/files/:field` suffix\n   *\n   * The returned `parameters` array mirrors the final route shape so backend\n   * request-context extraction and frontend placeholder resolution stay in sync.\n   */\n  public static buildFileUploadRouteForOperation(params: {\n    operationRouteUrl: string;\n    operationParameters: ResourceConfiguration_Operation_UrlParameterInfo[];\n    targetResourceType: ResourceType;\n    targetResourceFieldIdentifier: ResourceFieldIdentifier;\n    fieldName: string;\n    requiresTargetResourceId: boolean;\n    isFrontend: boolean;\n  }): { url: string; parameters: ResourceConfiguration_Operation_UrlParameterInfo[] } {\n    const parameters = [...params.operationParameters];\n    const hasTargetResourceIdParameter = parameters.some(\n      (parameter) => parameter.fieldIdentifier === params.targetResourceFieldIdentifier,\n    );\n\n    let url = params.operationRouteUrl;\n    if (params.requiresTargetResourceId && !hasTargetResourceIdParameter) {\n      const targetPlaceholder = params.isFrontend\n        ? `:${params.targetResourceFieldIdentifier}`\n        : `{${params.targetResourceFieldIdentifier}}`;\n      url = `${url}/${targetPlaceholder}`;\n      parameters.push({\n        fieldIdentifier: params.targetResourceFieldIdentifier,\n        resourceType: params.targetResourceType,\n      });\n    }\n\n    const fileRouteSegment = ResourcesConfigNamingUtils.toKebabCase(params.fieldName.replace(/\\./g, '-'));\n    return {\n      url: `${url}/files/${fileRouteSegment}`,\n      parameters,\n    };\n  }\n\n  /**\n   * Build the resource-integrated file **serve** (GET) route for an operation.\n   *\n   * Symmetric to `buildFileUploadRouteForOperation`, but always entity-addressed and\n   * terminated by the specific `fileId`:\n   * `{operationRoute}/{resourceId}/files/{fieldSegment}/{fileId}`.\n   *\n   * The serve route inherits authorization from the parent resource's READ\n   * operation (the `{resourceId}` identifies the record whose access is checked),\n   * so the URL is single-sourced here for BOTH the backend Express route\n   * registration and the frontend fetch URL. The trailing `fileId` is a plain path\n   * param resolved in the serve handler (NOT a resource-identifying parameter), so\n   * it is intentionally not added to `parameters` — those stay the resource/parent\n   * identifiers the execution context needs. Reuses the upload builder to append\n   * the entity id + `/files/<field>`.\n   */\n  public static buildFileServeRouteForOperation(params: {\n    operationRouteUrl: string;\n    operationParameters: ResourceConfiguration_Operation_UrlParameterInfo[];\n    targetResourceType: ResourceType;\n    targetResourceFieldIdentifier: ResourceFieldIdentifier;\n    fieldName: string;\n    isFrontend: boolean;\n  }): { url: string; parameters: ResourceConfiguration_Operation_UrlParameterInfo[] } {\n    const base = this.buildFileUploadRouteForOperation({\n      operationRouteUrl: params.operationRouteUrl,\n      operationParameters: params.operationParameters,\n      targetResourceType: params.targetResourceType,\n      targetResourceFieldIdentifier: params.targetResourceFieldIdentifier,\n      fieldName: params.fieldName,\n      requiresTargetResourceId: true,\n      isFrontend: params.isFrontend,\n    });\n    const fileIdPlaceholder = params.isFrontend ? ':fileId' : '{fileId}';\n    return {\n      url: `${base.url}/${fileIdPlaceholder}`,\n      parameters: base.parameters,\n    };\n  }\n\n  // ===========================================================================================\n  // PARENT RELATIONSHIP MANAGEMENT\n  // =========================================================================================\n    \n    /**\n   * Build URL for a specific parent combination\n   * \n   * When a parent has a foreignKeyField (like assignedToUserId), the prefix\n   * is applied to the PARENT resource name, not the child:\n   * - /assigned-to-users/{assignedToUserId}/todos (prefix on parent)\n   * - NOT /users/{userId}/assigned-to-todos (prefix on child)\n   */\n    public static buildUrlForParentCombination(\n      parentCombo: ParentResourceInfo[],\n      resourceConfig: AnyResourceConfiguration,\n      operation: ResourceConfiguration_Operation_Urlisable<any, any>,\n      allResourceFieldIdentifiers: Record<string, string>,\n      isFrontend: boolean = false\n    ): { url: string; parameters: ResourceConfiguration_Operation_UrlParameterInfo[] } {\n      \n      const segments: string[] = !isFrontend ? [MAIN_API_BASE_PATH] : [];\n      const parameters: ResourceConfiguration_Operation_UrlParameterInfo[] = [];\n      \n      // For frontend routes (React Router), use :paramName format\n      // For backend routes (Express), use {paramName} format\n      const formatParam = (paramName: string) => isFrontend ? `:${paramName}` : `{${paramName}}`;\n      \n      // Add parent resource segments\n      for (const parent of parentCombo) {\n        let resourcePath = ResourcesConfigNamingUtils.toKebabCase(parent.resourceType);\n        \n        // For FK relationships, use the FK field as the parameter name (e.g., assignedToUserId)\n        // For standard relationships, use the standard field identifier (e.g., userId)\n        // This avoids confusion and makes URLs self-documenting\n        const parameterName = parent.foreignKeyField || parent.fieldIdentifier;\n        \n        // If parent has a foreignKeyField, apply the prefix to the parent resource name\n        // Example: assignedToUserId with parent=users → \"assigned-to-users\" instead of just \"users\"\n        if (parent.foreignKeyField) {\n          const relationshipPrefix = this.extractRelationshipPrefix(parent.foreignKeyField, parent.resourceType);\n          if (relationshipPrefix) {\n            resourcePath = `${relationshipPrefix}-${resourcePath}`;\n          }\n        }\n        \n        segments.push(resourcePath);\n        segments.push(formatParam(parameterName));\n        parameters.push({\n          fieldIdentifier: parameterName,\n          resourceType: parent.resourceType,\n          relationshipField: parent.foreignKeyField,\n          scopeViaJunction: parent.scopeViaJunction,\n        });\n      }\n      \n      // Add main resource segment (no longer modified by relationship context - prefix is on parent)\n      const mainResourcePath = this.generateMainResourcePath(resourceConfig.resourceIdentifier, parentCombo);\n      segments.push(mainResourcePath);\n      \n      // Add operation-specific segments\n      const operationSegments = this.getOperationSegments(\n        operation,\n        resourceConfig,\n        allResourceFieldIdentifiers,\n        parentCombo,\n        isFrontend,\n      );\n      segments.push(...operationSegments.segments);\n      parameters.push(...operationSegments.parameterInfos);\n  \n      const prefix = isFrontend ? '/' : '';\n      return {\n        url: prefix + segments.join('/').replace(/\\/+/g, '/'),\n        parameters\n      };\n    }\n  \n    \n  /**\n   * Get parent resource information with ordering\n   */\n  public static getParentResourceInfos(\n    parentRelationships: ResourceRelationship[],\n    allResourceFieldIdentifiers: Record<string, string>\n  ): ParentResourceInfo[] {\n    const parentInfos: ParentResourceInfo[] = [];\n    \n    for (const relationship of parentRelationships) {\n      const compiledRelationship = Resources_SharedUtils.ensureCompiledRelationship(\n        relationship,\n        allResourceFieldIdentifiers,\n      );\n      const resourceType = relationship.resourceType1;\n      const fieldIdentifier = allResourceFieldIdentifiers[resourceType] ?? relationship.foreignKeyField;\n      if (!fieldIdentifier) {\n        /*\n         * A STANDALONE parent is NEVER part of a URL, so it cannot need a name in one.\n         *\n         * `generateParentCombinations` filters STANDALONE parents out before any segment is built,\n         * and the only consumer of `fieldIdentifier` is the parameter name at that point — so\n         * demanding one here refuses a configuration over data the URL provably discards. Skipping\n         * changes nothing downstream: such a parent is dropped a few steps later regardless.\n         *\n         * What it fixes is severe and silent. `initializeResources` DELETES an excluded type's field\n         * identifier, so a surviving resource anchored to an excluded parent threw here — and\n         * `generateUrlsForApiCallOperations` CATCHES that and `console.error`s it, leaving the\n         * registry \"built successfully\" with every operation carrying no url. Measured on the\n         * application-creation workbench, whose resources anchor to APPLICATION through exactly this\n         * STANDALONE shape: excluding every core type gave 1 resource, 1 logged error and\n         * `listUrl: undefined`, while every unit test that stubbed the transport passed.\n         *\n         * A NON-standalone parent still throws: that URL genuinely needs the parent's name, so an\n         * unresolvable one is a real configuration defect rather than a discarded input.\n         */\n        if (relationship.accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.STANDALONE) {\n          continue;\n        }\n        throw new Error(\n          `Cannot generate URL parent info for \"${resourceType}\" without a registered field identifier or relationship foreignKeyField.`,\n        );\n      }\n      \n      parentInfos.push({\n        resourceType,\n        fieldIdentifier,\n        isPrimaryScope: relationship.isPrimaryScope || false,\n        isOptional: relationship.parentResourceRequirement === ResourceParentResourceRequirement.OPTIONAL,\n        accessScopeStrategy: relationship.accessScopeStrategy,\n        foreignKeyField: relationship.foreignKeyField,\n        childForeignKeyField: compiledRelationship.resolvedSemantics.persistence.foreignKey?.fieldIdentifier,\n        relationshipNature: relationship.nature,\n        jointResourceType: relationship.jointResourceType,\n        scopeViaJunction: relationship.scopeViaJunction,\n        cardinality1: relationship.cardinality1,\n        cardinality2: relationship.cardinality2,\n        order: 0 // Will be calculated later\n      });\n    }\n    \n    // Collapse multiple parents that resolve to the SAME resourceType down to a\n    // single URL parent, preferring the ROUTABLE one. A resource can carry both\n    // a STANDALONE primary anchor (which declares `resourcePrimaryScope` but is\n    // intentionally inert for URL routing — see the primary-scope derivation in\n    // the config factory) AND a routable peer of the same type (e.g. an M:N\n    // junction's OPTIONAL_CONTEXT side). Without this collapse,\n    // `orderParentResourceInfos`' per-resourceType dedup keeps whichever sorts\n    // first — the STANDALONE anchor (primary sorts first) — and then\n    // `generateParentCombinations` drops it as STANDALONE, so the route is lost\n    // entirely. That is the exact bug that left ORGANIZATION_MEMBERS unreachable\n    // under `/organizations/{organizationId}/organization-members` while it still\n    // routed under `/users/{userId}/...`. We keep the routable peer's OWN flags\n    // (notably its non-primary, OPTIONAL_CONTEXT scope) so the route stays\n    // optional — preserving BOTH the org-side and user-side URLs of the junction.\n    const collapsedByResourceType = new Map<ResourceType, ParentResourceInfo>();\n    for (const info of parentInfos) {\n      const existing = collapsedByResourceType.get(info.resourceType);\n      if (!existing || this.isMoreUrlRoutableParent(info, existing)) {\n        collapsedByResourceType.set(info.resourceType, info);\n      }\n    }\n\n    // Order by dependency chain, then alphabetically\n    return this.orderParentResourceInfos([...collapsedByResourceType.values()], parentRelationships);\n  }\n\n  /**\n   * Rank a candidate URL parent against the one currently kept for the same\n   * resourceType. A routable (non-STANDALONE) parent always beats a STANDALONE\n   * anchor — a STANDALONE relationship is by definition off the URL surface, so\n   * it must never shadow a peer that DOES route. Two equally-routable (or two\n   * equally-STANDALONE) parents keep the first encountered (stable).\n   */\n  private static isMoreUrlRoutableParent(candidate: ParentResourceInfo, existing: ParentResourceInfo): boolean {\n    const candidateRoutable = candidate.accessScopeStrategy !== ResourceRelationshipAccessScopeStrategy.STANDALONE;\n    const existingRoutable = existing.accessScopeStrategy !== ResourceRelationshipAccessScopeStrategy.STANDALONE;\n    return candidateRoutable && !existingRoutable;\n  }\n  \n  /**\n   * Order parent resources by dependency chain and alphabetically\n   */\n  private static orderParentResourceInfos(\n    parentInfos: ParentResourceInfo[],\n    allRelationships: ResourceRelationship[]\n  ): ParentResourceInfo[] {\n    // Create dependency map\n    const dependencyMap = new Map<ResourceType, Set<ResourceType>>();\n    \n    for (const info of parentInfos) {\n      dependencyMap.set(info.resourceType, new Set());\n    }\n    \n    // Build dependency chains\n    for (const relationship of allRelationships) {\n      if (dependencyMap.has(relationship.resourceType2) && \n        dependencyMap.has(relationship.resourceType1)) {\n        dependencyMap.get(relationship.resourceType2)!.add(relationship.resourceType1);\n      }\n    }\n    \n    // Topological sort with primary scope priority\n    const sorted: ParentResourceInfo[] = [];\n    const visited = new Set<ResourceType>();\n    const visiting = new Set<ResourceType>();\n    \n    const visit = (info: ParentResourceInfo) => {\n      if (visiting.has(info.resourceType)) {\n        // Circular dependency, sort alphabetically\n        return;\n      }\n      if (visited.has(info.resourceType)) {\n        return;\n      }\n      \n      visiting.add(info.resourceType);\n      \n      // Visit dependencies first\n      const dependencies = dependencyMap.get(info.resourceType) || new Set();\n      const depInfos = parentInfos.filter(p => dependencies.has(p.resourceType));\n      depInfos.sort((a, b) => a.resourceType.localeCompare(b.resourceType));\n      \n      for (const depInfo of depInfos) {\n        visit(depInfo);\n      }\n      \n      visiting.delete(info.resourceType);\n      visited.add(info.resourceType);\n      sorted.push(info);\n    };\n    \n    // Sort by priority: primary scope first, then alphabetically\n    const sortedInfos = [...parentInfos].sort((a, b) => {\n      if (a.isPrimaryScope && !b.isPrimaryScope) return -1;\n      if (!a.isPrimaryScope && b.isPrimaryScope) return 1;\n      return a.resourceType.localeCompare(b.resourceType);\n    });\n    \n    for (const info of sortedInfos) {\n      visit(info);\n    }\n    \n    return sorted;\n  }\n  \n  /**\n   * Generate all possible parent combinations based on accessScopeStrategy\n   * \n   * Access Scope Strategy Rules:\n   * - REQUIRES_CONTEXT: Always included in parent context (mandatory in URL path)\n   * - OPTIONAL_CONTEXT: Can be included or not in parent context (generates multiple URL paths)\n   * - STANDALONE: Never included in URL path - resource is accessed independently\n   *   (the relationship exists for data model purposes, but not for URL routing)\n   */\n  private static generateParentCombinations(\n    parentInfos: ParentResourceInfo[]\n  ): ParentResourceInfo[][] {\n    \n    // Filter out STANDALONE relationships - they are NEVER included in URL paths\n    const urlParents = parentInfos.filter(p =>\n      p.accessScopeStrategy !== ResourceRelationshipAccessScopeStrategy.STANDALONE\n    );\n\n    // Scope-anchored peer-under-scope edges (scope-required reference search) are\n    // ADDITIVE access paths: each adds a single-parent scoped route (e.g.\n    // /organizations/{org}/users/search) WITHOUT altering the target's normal\n    // addressability — in particular it must NOT suppress the target's bare/global\n    // route (the empty combination is skipped below whenever any parent exists, so\n    // a scope-anchored edge folded into the normal powerset would silently drop\n    // /users/search). Handle them separately, appended as their own routes.\n    const scopeAnchoredParents = urlParents.filter(p => p.scopeViaJunction);\n    const standardParents = urlParents.filter(p => !p.scopeViaJunction);\n\n    const primaryScope = standardParents.filter(p => p.isPrimaryScope);\n    const mandatoryContext = standardParents.filter(p =>\n      !p.isPrimaryScope &&\n      p.accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.REQUIRES_CONTEXT\n    );\n    // OPTIONAL_CONTEXT generates optional URL paths (with and without parent)\n    const optionalContext = standardParents.filter(p =>\n      p.accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT &&\n      !p.isPrimaryScope\n    );\n\n    // Generate all combinations of optional context parents\n    const optionalCombinations = this.generateOptionalCombinations(optionalContext);\n\n    const allCombinations: ParentResourceInfo[][] = [];\n\n    for (const optionalCombo of optionalCombinations) {\n      const combination = [...primaryScope, ...mandatoryContext, ...optionalCombo];\n      if (combination.length > 0) {\n        allCombinations.push(combination);\n      }\n    }\n\n    // If no standard combinations, at least return the empty (bare) combination.\n    if (allCombinations.length === 0) {\n      allCombinations.push([]);\n    }\n\n    // Append each scope-anchored edge as its OWN single-parent route, on top of\n    // the normal addressability above (additive — never suppresses the bare).\n    for (const scopeAnchoredParent of scopeAnchoredParents) {\n      allCombinations.push([scopeAnchoredParent]);\n    }\n\n    return allCombinations;\n  }\n  \n  /**\n   * Generate all possible combinations of optional items\n   */\n  private static generateOptionalCombinations<T>(optionalItems: T[]): T[][] {\n    const combinations: T[][] = [[]]; // Start with empty combination\n    \n    for (const item of optionalItems) {\n      const currentLength = combinations.length;\n      for (let i = 0; i < currentLength; i++) {\n        combinations.push([...combinations[i], item]);\n      }\n    }\n    \n    return combinations;\n  }\n  \n\n  /**\n   * Get operation-specific URL segments\n   * \n   * URL Pattern Rules:\n   * - Core collection operations (LIST, CREATE, etc.): No operation suffix, differentiated by HTTP method\n   * - SEARCH: /search suffix (single occurrence)\n   * - COUNT: /count suffix (single occurrence)\n   * - Custom collection operations: Add operation name (e.g., /reset-features)\n   * - Core entity operations (READ, UPDATE, DELETE): No suffix after the entity\n   *   target. Regular resources include an entity ID; relationship-unique\n   *   singleton and complete M:N paths omit it.\n   * - Custom entity operations: Add the operation name after the entity target\n   *   (e.g., /{id}/rotate on regular resources, or /rotate on id-less\n   *   singleton / complete M:N paths).\n   */\n  \n  private static getOperationSegments(\n    operation: ResourceConfiguration_Operation_Urlisable<any, any>,\n    resourceConfig: AnyResourceConfiguration,\n    allResourceFieldIdentifiers: Record<string, string>,\n    parentCombo: ParentResourceInfo[],\n    isFrontend: boolean = false\n  ): { segments: string[]; parameterInfos: ResourceConfiguration_Operation_UrlParameterInfo[] } {\n    \n    const segments: string[] = [];\n    const parameterInfos: ResourceConfiguration_Operation_UrlParameterInfo[] = [];\n    const operationName = String(operation.operationIdentifier);\n    const isCollectionLevelOperation = this.isCollectionLevelOperation(operation, operationName);\n    \n    // For frontend routes (React Router), use :paramName format\n    // For backend routes (Express), use {paramName} format\n    const formatParam = (paramName: string) => isFrontend ? `:${paramName}` : `{${paramName}}`;\n    const generatedRegenerate = operation.generatedOperation?.kind === ResourceGeneratedOperationKind.GENERATED_FILE_REGENERATE\n      ? operation.generatedOperation\n      : undefined;\n    const generatedCollectionExport = operation.generatedOperation?.kind === ResourceGeneratedOperationKind.GENERATED_COLLECTION_EXPORT;\n    \n    // Determine if this is a custom operation (not a core operation)\n    const isCustomOperation = !Object.values(CoreResourceOperation).includes(operationName as CoreResourceOperation);\n    \n    if (isCollectionLevelOperation) {\n      // For custom collection operations, add the operation name segment\n      if (isCustomOperation) {\n        // The export companion is the one custom collection operation that must NOT be named here.\n        // Its identifier (`collectionExport:list`) would kebab-case into a segment, and it needs the\n        // `search` segment its SOURCE gets — which is appended further down, from\n        // `resourceOperationLike`. So the literal `export` segment is pushed AFTER that, and this\n        // branch contributes nothing.\n        if (!generatedCollectionExport) {\n          const operationSegment = ResourcesConfigNamingUtils.toKebabCase(operationName);\n          segments.push(operationSegment);\n        }\n      }\n      // Core collection operations (LIST, CREATE, etc.) don't add an operation\n      // name on the BACKEND — they differentiate by HTTP method (GET for LIST,\n      // POST for CREATE). FRONTEND routes carry no HTTP method, so an addressable\n      // core CREATE must carry an explicit `create` segment or it resolves to the\n      // bare collection path and collides with LIST — shadowing the listing on a\n      // cold load / refresh. Mirrors the `search`/`count` disambiguation below.\n      // (LIST stays at the bare collection path; SEARCH/COUNT/CREATE disambiguate.)\n      else if (isFrontend && this.getCoreOperation(operation) === CoreResourceOperation.CREATE) {\n        segments.push('create');\n      }\n    } else {\n      // Entity-level operations\n      // Skip resource ID when the parent combination uniquely identifies the resource:\n      // - One-to-one: only one instance per parent (e.g., organization-preference)\n      // - Complete many-to-many: both foreign keys specified (e.g., org + user = unique membership)\n      if (generatedRegenerate || (!this.isOneToOneRelationship(parentCombo) && !this.isCompleteManyToManyPath(parentCombo))) {\n        const resourceParam = allResourceFieldIdentifiers[resourceConfig.resourceIdentifier];\n        segments.push(formatParam(resourceParam));\n\n        parameterInfos.push({\n          fieldIdentifier: resourceParam,\n          resourceType: resourceConfig.resourceIdentifier as ResourceType\n        });\n      }\n      \n      // For custom entity operations, add the operation name after the entity target.\n      if (isCustomOperation) {\n        if (generatedRegenerate) {\n          segments.push('files', ResourcesConfigNamingUtils.toKebabCase(generatedRegenerate.fieldName.replace(/\\./g, '-')), 'regenerate');\n        } else {\n          const operationSegment = ResourcesConfigNamingUtils.toKebabCase(operationName);\n          segments.push(operationSegment);\n        }\n      }\n    }\n    \n    // Add bulk suffix if needed\n    if (operation.isBulkOperation) {\n      segments.push('bulk');\n    }\n\n    const coreOperation = this.getCoreOperation(operation);\n\n    // Add search segment when the operation carries SEARCH semantics.\n    if (coreOperation === CoreResourceOperation.SEARCH) {\n      segments.push('search');\n    }\n\n    // Add count segment when the operation carries COUNT semantics.\n    if (coreOperation === CoreResourceOperation.COUNT) {\n      segments.push('count');\n    }\n\n    // The export companion sits one segment BELOW the listing it exports, so it inherits that\n    // listing's whole path — every parent combination, and the `search` disambiguator above:\n    //   LIST   → /organizations/{org}/todos/export\n    //   SEARCH → /organizations/{org}/todos/search/export\n    // A resource exporting both verbs therefore gets two distinct routes without a naming scheme,\n    // and neither can shadow the listing itself (a literal segment, appended last).\n    if (generatedCollectionExport) {\n      segments.push('export');\n    }\n    \n    // Add variant key if exists\n    if (operation.variantKey) {\n      segments.push(operation.variantKey);\n    }\n    \n    return { segments, parameterInfos };\n  }\n\n\n  \n  /**\n   * Generate main resource path segment\n   * \n   * Note: The relationship prefix (like \"assigned-to\") is now applied to the PARENT resource\n   * in buildUrlForParentCombination, not to the child resource here.\n   * \n   * Examples:\n   * - /assigned-to-users/{userId}/todos (prefix on parent \"users\")\n   * - /created-by-users/{userId}/todos (prefix on parent \"users\")\n   * - /organizations/{orgId}/todos (no relationship field, no prefix)\n   * - /organizations/{orgId}/organization-preference (singular for one-to-one)\n   * - /organizations/{orgId}/users/{userId}/organization-member (singular for complete many-to-many)\n   */\n  private static generateMainResourcePath(mainResourceIdentifier: string, parentCombo: ParentResourceInfo[]): string {\n\n    // Check if this is a one-to-one relationship OR a complete many-to-many path - use singular form\n    const baseResourcePath = (this.isOneToOneRelationship(parentCombo) || this.isCompleteManyToManyPath(parentCombo)) \n      ? ResourcesConfigNamingUtils.toKebabCase(ResourcesConfigNamingUtils.singularize(mainResourceIdentifier)) \n      : ResourcesConfigNamingUtils.toKebabCase(mainResourceIdentifier);\n    \n    return baseResourcePath;\n  }\n  \n  /**\n   * Extract relationship prefix from a relationship field, excluding the parent resource type.\n   * \n   * Pattern: {relationshipDescriptor}{ParentResourceType}Id\n   * - assignedToUserId with parentType=users → assignedTo → assigned-to\n   * - createdByUserId with parentType=users → createdBy → created-by\n   * \n   * @param relationshipField - The relationship field name (e.g., assignedToUserId)\n   * @param parentResourceType - The parent resource type (e.g., users) - optional, if provided will be stripped\n   */\n  public static extractRelationshipPrefix(relationshipField: string, parentResourceType?: ResourceType): string {\n    // Get base name without Id/Ids suffix\n    let baseName = ResourcesConfigNamingUtils.extractBaseName(relationshipField);\n    \n    // If parent resource type is provided, remove it from the end of base name\n    // e.g., \"assignedToUser\" with parent \"users\" → \"assignedTo\"\n    if (parentResourceType) {\n      // Get singular form of parent resource type (e.g., \"users\" → \"user\").\n      const parentSingular = ResourcesConfigNamingUtils.singularize(parentResourceType);\n      // Compare using WORD-BOUNDARY-SAFE camelCase forms so that multi-word\n      // snake_case resource types work identically to single-word ones. The FK\n      // base name is always camelCase (e.g. \"anonymousUserId\" → \"anonymousUser\"),\n      // while a snake_case parent singular is \"anonymous_user\"; comparing the raw\n      // forms (\"Anonymous_user\" / \"anonymous_user\") misses the strip and emits a\n      // redundant prefix (\"anonymous-user-anonymous-users\"). PascalCase folds both\n      // to \"AnonymousUser\" so `endsWith` matches on the word boundary, and a\n      // separator-stripped lowercase compare catches the exact standard-FK case.\n      const parentSingularPascal = ResourcesConfigNamingUtils.toPascalCase(parentSingular);\n      const stripSeparators = (value: string): string => value.replace(/[_\\-\\s]/g, '').toLowerCase();\n\n      if (stripSeparators(baseName) === stripSeparators(parentSingular)) {\n        // Exact match for a standard FK: the base name IS the parent's own\n        // identifier (e.g. \"userId\"→\"users\", \"anonymousUserId\"→\"anonymous_users\")\n        // → no prefix needed.\n        baseName = '';\n      } else if (baseName.endsWith(parentSingularPascal)) {\n        // Non-standard FK carrying the parent type as a trailing word\n        // (e.g. \"assignedToUser\"/\"approvedByManager\" end with \"User\"/\"Manager\").\n        baseName = baseName.slice(0, -parentSingularPascal.length);\n      }\n    }\n    \n    // If baseName is empty after stripping, return empty (no prefix needed)\n    if (!baseName) return '';\n    \n    return ResourcesConfigNamingUtils.toKebabCase(baseName);\n  }\n\n  private static getOperationKey(operation: ResourceConfiguration_Operation_Urlisable<any, any>): string {\n    return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation);\n  }\n\n\n\n  private static getCoreOperation(\n    operation: ResourceConfiguration_Operation_Urlisable<any, any>)\n    : CoreResourceOperation {\n    if (operation.resourceOperationLike) {\n      return operation.resourceOperationLike as CoreResourceOperation;\n    } else {\n      return operation.operationIdentifier as CoreResourceOperation;\n    }\n  }\n\n  // ================================\n  // CHECK HELPERS\n  // ================================\n    \n  private static isUrlisable(variantType: ResourceOperationVariantType): boolean {\n    return variantType === ResourceOperationVariantType.API_CALL || variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK;\n  }\n    /**\n   * Determines if an operation should be at collection level (no entity ID) or entity level\n   * \n   * Collection-level operations include:\n   * - Core collection operations (LIST, CREATE, CREATE_MANY, UPDATE_MANY, DELETE_MANY, SEARCH, COUNT)\n   * - Custom operations with resourceOperationLike pointing to a collection operation\n   * - Bulk operations (isBulkOperation = true) - they operate on multiple entities\n   */\n    private static isCollectionLevelOperation(operation: ResourceConfiguration_Operation_Urlisable<any, any>, operationName: string ): boolean {\n\n        // Bulk operations are always collection-level (no entity ID)\n        if (operation.isBulkOperation) {\n          return true;\n        }\n\n        if (ALL_COLLECTION_OPERATIONS.includes(operationName as any)) {\n          return true;\n        }\n        \n        if (operation.resourceOperationLike) {\n          const resourceOperationLikeName = String(operation.resourceOperationLike);\n          if (ALL_COLLECTION_OPERATIONS.includes(resourceOperationLikeName as any)) {\n            return true;\n          }\n        }\n        \n        return false;\n      }\n\n      \n  /**\n   * Check if this resource has a one-to-one relationship with its parent\n   * Used to determine if resource should use singular naming and no entity ID\n   */\n  private static isOneToOneRelationship(parentCombo: ParentResourceInfo[]): boolean {\n    if (parentCombo.length === 1) {\n      const parent = parentCombo[0];\n      return parent.relationshipNature === RelationshipNature.COMPOSITION\n        && parent.cardinality1 === ResourceRelationshipCardinality.ONE\n        && isOneToOneCardinality(parent.cardinality2)\n        && parent.accessScopeStrategy !== ResourceRelationshipAccessScopeStrategy.STANDALONE\n        && Boolean(parent.childForeignKeyField);\n    }\n    \n    return false;\n  }\n  \n  /**\n   * Check if this represents a complete many-to-many path (both entities specified)\n   * For junction tables, when both foreign keys are specified in the path,\n   * there can only be one matching record, so we use singular form and no entity ID\n   * \n   * Example: /organizations/{orgId}/users/{userId}/organization-member\n   * This uniquely identifies THE membership between this org and user\n   * \n   * Important: This should NOT match hierarchical relationships with optional\n   * parents. Factory-generated junction parents are OPTIONAL_CONTEXT so each\n   * side can also expose an independent URL, but the complete path is proven by\n   * the association semantics plus shared jointResourceType, not by requiredness.\n   */\n  private static isCompleteManyToManyPath(parentCombo: ParentResourceInfo[]): boolean {\n    // For a complete many-to-many path, we need exactly two association parents\n    // that both point at the same junction resource. Do not require\n    // REQUIRES_CONTEXT here: factory-real M:N junction parents are intentionally\n    // OPTIONAL_CONTEXT so each side can generate independent URLs as well.\n    \n    if (parentCombo.length === 2) {\n      const jointResourceTypes = parentCombo\n        .map((parent) => parent.jointResourceType)\n        .filter((jointResourceType): jointResourceType is ResourceType => Boolean(jointResourceType));\n      return jointResourceTypes.length === 2\n        && new Set(jointResourceTypes).size === 1\n        && new Set(parentCombo.map((parent) => parent.foreignKeyField || parent.fieldIdentifier)).size === parentCombo.length\n        && parentCombo.every((parent) =>\n          parent.relationshipNature === RelationshipNature.ASSOCIATION\n          && parent.cardinality1 === ResourceRelationshipCardinality.ONE\n          && parent.cardinality2 === ResourceRelationshipCardinality.MANY\n        );\n    }\n    \n    return false;\n  }\n\n  /**\n   * Generate synthetic parent relationships for FK reference URL paths.\n   * \n   * These synthetic relationships are created ON-THE-FLY during URL generation\n   * and do NOT pollute the data model's parentRelationships.\n   * \n   * Purpose: Enable alternative URL access patterns for resources with non-standard FK fields.\n   * Example: TODOS → USERS with 'assignedToUserId' creates /assigned-to-users/{userId}/todos\n   * \n   * This method replaces the FK transformation that was previously done in the factory,\n   * which incorrectly modified the relationship model and broke context fetching/population.\n   * \n   * Edge Cases Handled:\n   * - M:N relationships: Excluded (not in childRelationships)\n   * - Self-referencing: Filtered out before synthetic parent creation\n   * - Missing standard FK: Skipped gracefully when the parent resource is unknown\n   * - Standard FK (e.g., USER_SELF with userId): Correctly identified and skipped\n   * \n   * Known Minor Inefficiency:\n   * - Multiple non-standard FKs to same resource type (e.g., assignedToUserId + createdByUserId)\n   *   creates extra URL combinations including both FKs in one path.\n   *   Not harmful, just generates unused URL patterns. Can be optimized later.\n   * \n   * @param resourceConfig - Resource configuration with clean relationship model\n   * @param allResourceFieldIdentifiers - Map of resourceType → standard field identifier\n   * @returns Array of synthetic parent relationships (for URL generation ONLY)\n   */\n  private static generateSyntheticFKParents(\n    resourceConfig: AnyResourceConfiguration,\n    allResourceFieldIdentifiers: Record<string, string>,\n    resourceRelationshipsOverride?: ResourceConfiguration_ResourceRelationships,\n  ): ResourceRelationship[] {\n    const syntheticParents: ResourceRelationship[] = [];\n    const resourceIdentifier = resourceConfig.resourceIdentifier;\n    const childRelationships = getChildDirectionRelationships(\n      resourceRelationshipsOverride ?? resourceConfig.resourceRelationships,\n    );\n    \n    // Scan child relationships (where current resource is resourceType1/parent)\n    for (const rel of childRelationships) {\n      // Only process relationships with explicit FK field\n      if (!rel.foreignKeyField) continue;\n      \n      // Skip self-referencing relationships\n      if (rel.resourceType2 === resourceIdentifier) continue;\n      \n      // Get standard FK for the parent (current resource = resourceType1)\n      const parentStandardFK = allResourceFieldIdentifiers[rel.resourceType1];\n      if (!parentStandardFK) {\n        // No standard FK defined - skip\n        continue;\n      }\n      \n      // Check if this FK is standard or non-standard\n      // Standard: FK matches the parent's standard field identifier\n      // Non-standard: FK differs (e.g., assignedToUserId instead of userId)\n      const isStandardFK = rel.foreignKeyField === parentStandardFK;\n      \n      if (!isStandardFK) {\n        // Non-standard FK found!\n        // Original relationship: CURRENT → REFERENCED with non-standard FK\n        // Create synthetic: REFERENCED → CURRENT for URL generation\n        // This enables URL pattern: /fk-prefix-referenced/{fkValue}/current\n        \n        const syntheticParent = Resources_SharedUtils.compileRelationshipDeclaration({\n          // Reverse the relationship for URL nesting\n          resourceType1: rel.resourceType2,  // Referenced resource becomes \"parent\" for URL\n          resourceType2: resourceIdentifier,  // Current resource becomes \"child\" for URL\n          cardinality1: rel.cardinality2,\n          cardinality2: rel.cardinality1,\n          \n          // FK reference relationships are never primary scope\n          isPrimaryScope: false,\n          primaryScope: undefined,\n          \n          // Optional parent - generates alternative URL path\n          parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,\n          \n          // OPTIONAL_CONTEXT ensures URL path is generated\n          // (STANDALONE would skip, REQUIRES_CONTEXT would make it mandatory)\n          accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT,\n          \n          // Basic flags\n          isDisabled: false,\n          allowCycle: false,\n          jointResourceType: undefined,\n          \n          // Keep foreignKeyField - URL builder uses this for custom prefix\n          // Example: assignedToUserId → /assigned-to-users/ prefix\n          foreignKeyField: rel.foreignKeyField,\n          \n          // DO NOT copy contextPolicy/childOperations - these are for data model.\n          // Synthetic relationships exist ONLY for URL generation.\n          contextPolicy: undefined,\n          nature: RelationshipNature.REFERENCE,\n          childOperations: undefined,\n          // discriminator and condition are explicitly set to undefined because\n          // synthetic FK parents are structural (for URL path generation), not\n          // data-dependent. They must not carry runtime conditions from the\n          // original relationship — conditions are evaluated elsewhere (in\n          // ResourceContext, ServicesRegistryHandler, ContainerNested) when\n          // processing the real relationship.\n          discriminator: undefined,\n          condition: undefined,\n          display: undefined,\n        } satisfies ResourceRelationshipDeclaration);\n        \n        syntheticParents.push(syntheticParent);\n      }\n    }\n    \n    return syntheticParents;\n  }\n}\n"]}
+{"version":3,"file":"resources-config-operations.urls-builder.utils.js","sourceRoot":"","sources":["../../../../../src/resources/utils/resources-config-operations.urls-builder.utils.ts"],"names":[],"mappings":"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","sourcesContent":["/** URL Generation Examples:\n * \n * Collection-Level Operations (no entity ID):\n * - LIST: GET /api/v1/organizations/{organizationId}/organization-features  \n * - CREATE: POST /api/v1/organizations/{organizationId}/organization-features\n * - CREATE_MANY: POST /api/v1/organizations/{organizationId}/organization-features (differentiated by request body)\n * - UPDATE_MANY: PUT /api/v1/organizations/{organizationId}/organization-features\n * - DELETE_MANY: DELETE /api/v1/organizations/{organizationId}/organization-features\n * - SEARCH: GET /api/v1/organizations/{organizationId}/organization-features/search\n * - COUNT: GET /api/v1/organizations/{organizationId}/organization-features/count\n * - Custom collection operations (with resourceOperationLike pointing to collection op): \n *   PUT /api/v1/organizations/{organizationId}/organization-features/reset-features\n * \n * Entity-Level Operations:\n * - Regular resources include their entity ID in the route.\n * - Parent-owned composition singletons and complete M:N paths omit the child /\n *   junction ID because the declared relationship path uniquely identifies it.\n * - READ: GET /api/v1/organizations/{organizationId}/organization-features\n * - UPDATE: PUT /api/v1/organizations/{organizationId}/organization-features\n * - DELETE: DELETE /api/v1/organizations/{organizationId}/organization-features\n * - Custom entity operations follow the same entity-id rule as their effective\n *   core operation: regular entity resources include the id, while\n *   parent-owned composition singletons and complete M:N paths omit it.\n * \n * Variant Keys (for role-based variants):\n * - LIST admin variant: GET /api/v1/organizations/{organizationId}/organization-features/admin\n * - READ admin variant on regular entity resources:\n *   GET /api/v1/organizations/{organizationId}/organization-features/{id}/admin\n * - READ admin variant on parent-owned composition singletons or complete M:N\n *   paths omits the child/junction ID:\n *   GET /api/v1/organizations/{organizationId}/organization-features/admin\n * - SEARCH admin variant: GET /api/v1/organizations/{organizationId}/organization-features/search/admin\n * \n * Bulk Operations (collection-level, no entity ID):\n * - DELETE bulk: DELETE /api/v1/organizations/{organizationId}/organization-features/bulk\n * - DELETE bulk admin: DELETE /api/v1/organizations/{organizationId}/organization-features/bulk/admin\n * \n * Access Scope Strategy (determines URL path generation):\n * - REQUIRES_CONTEXT: Always in URL path (mandatory parent)\n * - OPTIONAL_CONTEXT: Generates multiple URLs with/without parent\n * - STANDALONE: NEVER in URL path - resource accessed independently (data relationship only)\n *   Example: APPLICATION → ORGANIZATIONS with STANDALONE means /organizations not /applications/{id}/organizations\n * \n * Foreign Key Relationships (foreignKeyField):\n * - FK relationships like TODOS → USERS with assignedToUserId are transformed to parent relationships\n * - They use OPTIONAL_CONTEXT to generate alternative URL paths\n * - Example: /assigned-to-users/{assignedToUserId}/todos (prefix derived from FK field name)\n * \n * Many-to-Many Relationships (via junction table):\n * - Junction table (e.g., ORGANIZATION_MEMBERS) can be accessed from BOTH sides\n * - Both parents use OPTIONAL_CONTEXT to generate independent paths\n * - Example: /organizations/{orgId}/organization-members\n * - Example: /users/{userId}/organization-members\n * - Combined: /organizations/{orgId}/users/{userId}/organization-member (singular, unique record)\n */\n\nimport { \n  ResourceConfiguration, \n  AnyResourceConfiguration,\n  ResourceConfiguration_Operation_ApiCall,\n  ResourceConfiguration_Operation_ApiCallWithCallback,\n  ResourcesRegistry,\n  ResourceConfiguration_Operation_UrlParameterInfo,\n  ResourceConfiguration_Operation_UrlInitiatorInfo,\n  ResourceConfiguration_Operation,\n  ResourceGeneratedOperationKind,\n  getParentDirectionRelationships,\n  getChildDirectionRelationships,\n  type ResourceConfiguration_ResourceRelationships,\n} from '../resources-config.shared.schemas';\nimport { z } from 'zod';\n\nimport { \n  ResourceRelationship,\n  ResourceRelationshipDeclaration,\n  RelationshipNature,\n  ResourceParentResourceRequirement,\n  ResourceOperationVariantType,\n  ResourceRelationshipAccessScopeStrategy,\n  ResourceRelationshipCardinality,\n  isOneToOneCardinality,\n} from '../resources.shared.schemas';\nimport { \n  ResourceType,\n  ResourceFieldIdentifier,\n  ALL_COLLECTION_OPERATIONS,\n  CoreResourceOperation\n} from '../resources.shared.core.definitions';\nimport { ResourcesConfigNamingUtils } from './resources-config-naming.utils';\nimport { Resources_SharedUtils } from '../resources.shared.utils';\nimport { EnumLikeType } from '@wildo-ai/zod-decorators';\nimport { ResourcesConfig_OperationPathUtils } from './resources-config-operations.path.utils';\nimport { MAIN_API_BASE_PATH } from '../../requests/manual-controllers-routes-urls';\n\nexport interface URLGenerationResult {\n  initiatorInfos: ResourceConfiguration_Operation_UrlInitiatorInfo[];\n  metadata: {\n    operation: string;\n    variantKey?: string;\n    isBulk: boolean;\n    isSearch: boolean;\n    isCount: boolean;\n    parentCombinations: string[][];\n  };\n}\n\nexport interface ParentResourceInfo {\n  resourceType: ResourceType;\n  fieldIdentifier: string;\n  isPrimaryScope: boolean;\n  isOptional: boolean;\n  accessScopeStrategy: ResourceRelationshipAccessScopeStrategy;\n  /** Foreign key field for disambiguation or non-standard naming */\n  foreignKeyField?: string;\n  /** Child-side FK proven by resolved persistence semantics for singleton URL omission. */\n  childForeignKeyField?: string;\n  relationshipNature?: RelationshipNature;\n  jointResourceType?: ResourceType;\n  /** Scope-via-junction tag (scope-required reference search) — propagated to the URL param. */\n  scopeViaJunction?: ResourceType;\n  cardinality1?: ResourceRelationshipCardinality;\n  cardinality2: ResourceRelationshipCardinality; // Cardinality from parent to child\n  order: number;\n}\n\nexport type ResourceConfiguration_Operation_Urlisable<TCustomOperationEnum extends EnumLikeType | undefined, TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined> = \n    ResourceConfiguration_Operation_ApiCall<TCustomOperationEnum, TCoreOperationEnum, z.ZodTypeAny> \n  | ResourceConfiguration_Operation_ApiCallWithCallback<TCustomOperationEnum, TCoreOperationEnum, z.ZodTypeAny>;\n\n\nexport class ResourcesConfigOperationsUrlsBuilderUtils {\n  \n \n  public static buildUrlsForResourceConfiguration( resourceConfig: AnyResourceConfiguration, allResourceFieldIdentifiers: Record<string, string> ): Record<string, URLGenerationResult> {\n\n    const results: Record<string, URLGenerationResult> = {};\n    const apiCallOperations = resourceConfig.operations.filter( (op): op is ResourceConfiguration_Operation_Urlisable<any, any> => this.isUrlisable(op.variantType));\n    \n    for (const operation of apiCallOperations) {\n      const operationKey = this.getOperationKey(operation);\n      results[operationKey] = this.buildUrlsForOperation( operation, resourceConfig, allResourceFieldIdentifiers);\n    }\n    \n    return results;\n  }\n\n\n\n\n  /**\n  * Build URLs for all API_CALL and API_CALL_WITH_CALLBACK operations in a resource configuration\n  */\n  public static updateOperationUrls( resourceConfig: AnyResourceConfiguration, allResourceFieldIdentifiers: Record<string, string> ): void {\n    const urlResults = this.buildUrlsForResourceConfiguration( resourceConfig, allResourceFieldIdentifiers);\n    \n    // Update URLs in API_CALL and API_CALL_WITH_CALLBACK operations\n    for (const operation of resourceConfig.operations) {\n      if (this.isUrlisable(operation.variantType)) {\n\n        const apiCallOp = operation as ResourceConfiguration_Operation_Urlisable<any, any>;\n        const operationKey = this.getOperationKey(apiCallOp);\n        const urlResult = urlResults[operationKey];\n        \n        if (urlResult) {\n          apiCallOp.initiatorInfos = urlResult.initiatorInfos;\n        }\n      }\n    }\n  }\n  \n  /**\n   * Return the full parent edge set that can legitimately address a resource in URLs.\n   *\n   * This includes:\n   * - real parent/self relationships from the active operation relationship\n   *   view, falling back to the compiled resource model\n   * - synthetic FK-reference parents used to expose alternative nested paths for\n   *   non-standard FK fields without polluting the stored relationship graph\n   *\n   * Frontend navigation and form/runtime consumers should reuse this helper when\n   * they need to stay aligned with URL addressability semantics.\n   *\n   * Note that URL parent addressability is intentionally broader than\n   * context-addressed mutation eligibility: self relationships can contribute\n   * navigable tree routes, but singleton mutation target resolution only trusts\n   * compiled `parentRelationships`.\n   */\n  public static getUrlAddressableParentRelationships(\n    resourceConfig: AnyResourceConfiguration,\n    allResourceFieldIdentifiers: Record<string, string>,\n    resourceRelationshipsOverride?: ResourceConfiguration_ResourceRelationships,\n  ): ResourceRelationship[] {\n    const realParents = getParentDirectionRelationships(\n      resourceRelationshipsOverride ?? resourceConfig.resourceRelationships,\n    ).filter(\n      (relationship) =>\n        !this.isInboundFkReferenceParent(relationship, allResourceFieldIdentifiers),\n    );\n    // The SAME inbound-FK guard must run over the synthetic parents, not only the real ones.\n    //\n    // {@link isInboundFkReferenceParent} was written to stop a resource being nested under something\n    // that holds an FK pointing AT it — its JSDoc names the symptom exactly: \"phantom routes […]\n    // that require an id the target has no notion of and that no controller registers — a guaranteed\n    // 404 for every consumer of the target resource's own routes\". But it was applied only to\n    // `realParents`, while {@link generateSyntheticFKParents} appends parents built by REVERSING a\n    // child relationship — which is precisely how an inbound FK reference gets in.\n    //\n    // That gap took the whole `users` API surface off the air on 2026-08-06. Adding\n    // `PLATFORM_ACCESS_GRANTS` with `foreignKeyField: 'operatorUserId'` (non-standard, since USERS'\n    // identifier is `userId`) synthesised a reversed parent, and every users route became\n    // `/operator-user-platform-access-grants/{operatorUserId}/users/{userId}` — the bare\n    // `/users/{userId}` disappeared entirely and the resource 404'd. `applications` was already\n    // broken the same way by `appId` on application-features/metadata/versions (7 phantom\n    // combinations, no bare `/applications`); nobody had noticed because nothing called it.\n    //\n    // Measured over the full core catalogue, this filter changes 4 resources and removes ONLY\n    // phantom shapes — `users` and `applications` regain their base paths, and the two\n    // `referrer-billing-account-referrals/{referrerBillingAccountId}/…-billing-accounts` variants\n    // (addressing a billing account under a billing-account id) go with them. None of the removed\n    // shapes had ever been served: 0 occurrences across the last 8 dev logs.\n    //\n    // WHY THE GENERATOR IS KEPT, and why this filter cannot break its legitimate output.\n    //\n    // `generateSyntheticFKParents` assumes `resourceType1` is the FK HOLDER. Declared that way — the\n    // header example `TODOS → USERS with assignedToUserId` — reversing it yields exactly the intended\n    // `/assigned-to-users/{assignedToUserId}/todos`, and the cardinalities (TODOS MANY → USERS ONE)\n    // make the synthetic's `cardinality2` MANY, so this guard KEEPS it.\n    //\n    // The broken cases declare the FK TARGET first instead (`USERS → PLATFORM_ACCESS_GRANTS`,\n    // `APPLICATIONS → APPLICATION_FEATURES`). The generator cannot tell the difference from\n    // declaration order, but the guard can: it reads FK ownership from CARDINALITY, so a synthetic\n    // built from a target-first declaration comes out `cardinality1 === MANY` and is rejected.\n    //\n    // So the filter separates the two shapes on the only signal that is actually reliable — which is\n    // the same reason `isInboundFkReferenceParent` reads cardinality rather than argument order.\n    //\n    // MEASURED, so the next reader need not guess who this affects: of 335 relationship declarations\n    // repo-wide, the holder-first shape this generator serves has exactly EIGHT production\n    // consumers, all in one app file (`tasks-manager.relationships.ts`) and all the same idea — a\n    // \"who created / who is assigned\" pointer at USERS or ORGANIZATION_UNITS (`createdByUserId`,\n    // `assignedToUserId`, `postedByUserId`, `organizationUnitId`). The engine declares ZERO; every\n    // one of its 40 core relationships is parent-first.\n    //\n    // That asymmetry IS the failure story. This generator is an APP-AUTHORING feature the engine had\n    // never exercised, so when engine relationships began carrying non-standard FKs\n    // (`operatorUserId`, `appId`) they fell into machinery with no engine-side precedent and nothing\n    // watching it. Keep that in mind before assuming a change here is engine-only.\n    const syntheticFKParents = this.generateSyntheticFKParents(\n      resourceConfig,\n      allResourceFieldIdentifiers,\n      resourceRelationshipsOverride,\n    ).filter(\n      (relationship) =>\n        !this.isInboundFkReferenceParent(relationship, allResourceFieldIdentifiers),\n    );\n\n    return [...realParents, ...syntheticFKParents];\n  }\n\n  /**\n   * Detect a parent-bucket entry that is actually an INBOUND FK reference —\n   * i.e. the *other* resource holds an FK that points at the current resource,\n   * so the current resource is the FK **target**, not a routable child.\n   *\n   * In the parent bucket the current resource is always `resourceType2`. A\n   * relationship legitimately nests the current resource under `resourceType1`\n   * only when the current resource **holds the foreign key** that references\n   * `resourceType1` (e.g. `draftNotes.userId → users`, `userProfiles.userId →\n   * users`). When the FK lives on `resourceType1` and points back at the\n   * current resource (e.g. `todos.assignedToUserId → users`,\n   * `tasks.assignedToUserId → users`), nesting the current resource under\n   * `resourceType1` is semantically inverted: it yields phantom routes like\n   * `/assigned-to-user-todos/{assignedToUserId}/users/search` that require an\n   * id the target has no notion of and that no controller registers — a\n   * guaranteed 404 for every consumer of the target resource's own routes.\n   *\n   * The correct holder-under-target route (`/assigned-to-users/{userId}/todos`)\n   * is produced independently by {@link generateSyntheticFKParents} from the\n   * FK-holder's child bucket, so excluding the inbound direction here loses no\n   * legitimate addressability.\n   *\n   * FK ownership is read off the relationship shape (no schema access needed):\n   * - `cardinality2 === MANY` → the current resource is the many side and holds\n   *   the FK → genuine child, keep.\n   * - `cardinality1 === MANY` (so the current `one` side is referenced by a\n   *   many holder) → current is the FK target → inbound, drop.\n   * - `1:1` → the current resource holds the FK only when the FK is\n   *   `resourceType1`'s standard identifier (a standard parent reference like\n   *   `userProfiles.userId`); a non-standard FK (`assignedToUserId`) on a 1:1\n   *   edge belongs to `resourceType1` and points back at current → inbound,\n   *   drop.\n   *\n   * Only `REFERENCE`-nature edges can be inbound; compositions/associations\n   * always contain the current resource as a genuine child, and self\n   * relationships (`resourceType1 === resourceType2`) are legitimate tree\n   * routes — both are never treated as inbound.\n   */\n  private static isInboundFkReferenceParent(\n    relationship: ResourceRelationship,\n    allResourceFieldIdentifiers: Record<string, string>,\n  ): boolean {\n    if (relationship.resourceType1 === relationship.resourceType2) {\n      return false;\n    }\n    if (relationship.nature !== RelationshipNature.REFERENCE) {\n      return false;\n    }\n\n    const currentHoldsForeignKey =\n      relationship.cardinality2 === ResourceRelationshipCardinality.MANY\n        ? true\n        : relationship.cardinality1 === ResourceRelationshipCardinality.MANY\n          ? false\n          : relationship.foreignKeyField != null\n            && relationship.foreignKeyField === allResourceFieldIdentifiers[relationship.resourceType1];\n\n    return !currentHoldsForeignKey;\n  }\n\n  /**\n   * Build URLs for a specific operation\n   */\n  private static buildUrlsForOperation( operation: ResourceConfiguration_Operation_Urlisable<any, any>, resourceConfig: AnyResourceConfiguration, allResourceFieldIdentifiers: Record<string, string> ): URLGenerationResult {\n\n    const initiatorInfos: ResourceConfiguration_Operation_UrlInitiatorInfo[] = [];\n    \n    const coreOperation = this.getCoreOperation(operation);\n\n    // Scope-required reference search: an edge tagged with `urlOperationScope`\n    // contributes its URL ONLY for the listed core operations (the scope-anchored\n    // peer-under-scope edge restricts to SEARCH/LIST). Untagged edges (every\n    // normal relationship) are unaffected.\n    const allParentsForURLs = this.getUrlAddressableParentRelationships(\n      resourceConfig,\n      allResourceFieldIdentifiers,\n      operation.resourceRelationships,\n    ).filter((rel) => !rel.urlOperationScope || rel.urlOperationScope.includes(coreOperation));\n\n    // Generate URL paths from all parent combinations\n    const parentInfos = this.getParentResourceInfos(allParentsForURLs, allResourceFieldIdentifiers);\n    const parentCombinations = this.generateParentCombinations(parentInfos).filter(\n      (parentCombo) =>\n        coreOperation !== CoreResourceOperation.LIST\n        || !this.isCompleteManyToManyPath(parentCombo),\n    );\n\n    // A complete M:N parent path identifies one junction row: for example,\n    // organization + user identifies THE organization-membership. That path is\n    // therefore an entity address owned by READ. LIST remains available under\n    // either individual parent (members by organization, memberships by user),\n    // but must not also claim the complete path with the same GET method. Doing\n    // so registers two different operation contracts on one HTTP route and\n    // makes router ordering decide which contract is actually served.\n\n    for (const parentCombo of parentCombinations) {\n      const urlInfo = this.buildUrlForParentCombination( parentCombo, resourceConfig, operation, allResourceFieldIdentifiers, false);\n      \n      const initiatorInfo: ResourceConfiguration_Operation_UrlInitiatorInfo = {\n        url: urlInfo.url,\n        parameters: urlInfo.parameters,\n        ...(operation.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK && {\n          urlCallback: `${urlInfo.url}/callback`\n        })\n      };\n      \n      initiatorInfos.push(initiatorInfo);\n    }\n\n    // W7.3a: Dual initiatorInfos for isAnonymizable resources.\n    // For operations that allow APP_ANONYMOUS, generate additional URL patterns\n    // with the ANONYMOUS_USERS parent replacing the USER_SELF parent.\n    if (resourceConfig.isAnonymizable && (operation as any).roles?.includes('APP_ANONYMOUS')) {\n      for (const parentCombo of parentCombinations) {\n        const userSelfParentIndex = parentCombo.findIndex(p =>\n          p.isPrimaryScope && p.fieldIdentifier === 'userId'\n        );\n\n        if (userSelfParentIndex >= 0) {\n          const anonymousCombo = parentCombo.map((p, i) => {\n            if (i === userSelfParentIndex) {\n              // Synthesize the ANONYMOUS_USERS parent that masks the USER_SELF\n              // primary parent for the anonymous URL variant.\n              //\n              // `foreignKeyField` MUST become the anonymous user's own FK\n              // (`anonymousUserId`), NOT the inherited `userId` from the\n              // authenticated parent. `buildUrlForParentCombination` derives\n              // BOTH the route param name (`foreignKeyField || fieldIdentifier`)\n              // AND the param's `relationshipField` (the child-filter FK) from\n              // `foreignKeyField`. Leaving it as `userId` was the W7.3a bug:\n              //  - the route param bound `req.params.userId`, which\n              //    `extractInitiatorIds` maps to `initiatorIds.userId` → the\n              //    ANONYMOUS_SESSION ExecutionContext constructor rejects any\n              //    authenticated identity field → 500 at\n              //    `handleAnonymousSessionInit`; and\n              //  - the nested-LIST child filter keyed on `userId` (null for\n              //    anonymous rows), never on the `anonymousUserId` column that\n              //    actually stores the session handle.\n              // With `anonymousUserId`, the param is ignored by\n              // `extractInitiatorIds` (the session id is set from the\n              // `x-anonymous-session-init` header), the coherence check pins the\n              // URL uuid to the session uuid (defense in depth), and the child\n              // filter targets the correct column.\n              //\n              // The URL segment stays honest: `anonymousUserId` IS the standard\n              // identifier of `anonymous_users`, so `extractRelationshipPrefix`\n              // strips it → no redundant prefix → `/anonymous-users/…`, parallel\n              // to the authenticated `/users/{userId}/…` route.\n              return {\n                ...p,\n                resourceType: 'anonymous_users' as ResourceType,\n                fieldIdentifier: 'anonymousUserId',\n                foreignKeyField: 'anonymousUserId',\n              };\n            }\n            return p;\n          });\n\n          const urlInfo = this.buildUrlForParentCombination(\n            anonymousCombo, resourceConfig, operation, allResourceFieldIdentifiers, false\n          );\n\n          const anonInitiatorInfo: ResourceConfiguration_Operation_UrlInitiatorInfo = {\n            url: urlInfo.url,\n            parameters: urlInfo.parameters,\n            ...(operation.variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK && {\n              urlCallback: `${urlInfo.url}/callback`\n            })\n          };\n\n          initiatorInfos.push(anonInitiatorInfo);\n        }\n      }\n    }\n    \n    return {\n      initiatorInfos,\n      metadata: {\n        operation: String(operation.operationIdentifier),\n        variantKey: operation.variantKey,\n        isBulk: operation.isBulkOperation,\n        isCount : coreOperation === CoreResourceOperation.COUNT,\n        isSearch: coreOperation === CoreResourceOperation.SEARCH,\n        // Informational only: initiatorInfos.parameters remain the canonical\n        // source for FK/relationship-field route evidence.\n        parentCombinations: parentCombinations.map(combo =>\n          combo.map(parent => parent.resourceType)\n        )\n      }\n    };\n  }\n\n  public static buildOperationFrontendRoutePaths( \n    resourceConfig: AnyResourceConfiguration, \n    operation: ResourceConfiguration_Operation_Urlisable<any, any>, \n    allResourceFieldIdentifiers: Record<string, string>\n  ): { url: string; parameters: ResourceConfiguration_Operation_UrlParameterInfo[] }[] {\n    \n    if (!this.isUrlisable(operation.variantType))\n      return []; // other presets are not routable\n\n    // Mirror buildUrlsForOperation's `urlOperationScope` filter so frontend route\n    // generation and backend route registration stay in lock-step.\n    const coreOperation = this.getCoreOperation(operation);\n    const allParentsForURLs = this.getUrlAddressableParentRelationships(\n      resourceConfig,\n      allResourceFieldIdentifiers,\n      operation.resourceRelationships,\n    ).filter((rel) => !rel.urlOperationScope || rel.urlOperationScope.includes(coreOperation));\n\n    const parentInfos = this.getParentResourceInfos(allParentsForURLs, allResourceFieldIdentifiers);\n    const parentCombinations = this.generateParentCombinations(parentInfos);\n    const frontendRoutePaths:  { url: string; parameters: ResourceConfiguration_Operation_UrlParameterInfo[] }[]  = [];\n  \n    for (const parentCombo of parentCombinations) {\n      const routePath = this.buildUrlForParentCombination( parentCombo, resourceConfig, operation, allResourceFieldIdentifiers, true);\n      frontendRoutePaths.push(routePath);\n    }\n  \n    return frontendRoutePaths;\n  }\n\n  /**\n   * Build a resource-integrated file upload route from a concrete operation route.\n   *\n   * File uploads should stay aligned with the operation route family they extend.\n   * For CREATE-like uploads, the collection route is sufficient. For UPDATE-like\n   * uploads, the target resource id must appear exactly once:\n   * - if the operation route already addresses the entity, reuse it as-is\n   * - if the operation route intentionally omits the entity id (for unique nested\n   *   addresses such as one-to-one or complete many-to-many paths), append the\n   *   target resource placeholder before the `/files/:field` suffix\n   *\n   * The returned `parameters` array mirrors the final route shape so backend\n   * request-context extraction and frontend placeholder resolution stay in sync.\n   */\n  public static buildFileUploadRouteForOperation(params: {\n    operationRouteUrl: string;\n    operationParameters: ResourceConfiguration_Operation_UrlParameterInfo[];\n    targetResourceType: ResourceType;\n    targetResourceFieldIdentifier: ResourceFieldIdentifier;\n    fieldName: string;\n    requiresTargetResourceId: boolean;\n    isFrontend: boolean;\n  }): { url: string; parameters: ResourceConfiguration_Operation_UrlParameterInfo[] } {\n    const parameters = [...params.operationParameters];\n    const hasTargetResourceIdParameter = parameters.some(\n      (parameter) => parameter.fieldIdentifier === params.targetResourceFieldIdentifier,\n    );\n\n    let url = params.operationRouteUrl;\n    if (params.requiresTargetResourceId && !hasTargetResourceIdParameter) {\n      const targetPlaceholder = params.isFrontend\n        ? `:${params.targetResourceFieldIdentifier}`\n        : `{${params.targetResourceFieldIdentifier}}`;\n      url = `${url}/${targetPlaceholder}`;\n      parameters.push({\n        fieldIdentifier: params.targetResourceFieldIdentifier,\n        resourceType: params.targetResourceType,\n      });\n    }\n\n    const fileRouteSegment = ResourcesConfigNamingUtils.toKebabCase(params.fieldName.replace(/\\./g, '-'));\n    return {\n      url: `${url}/files/${fileRouteSegment}`,\n      parameters,\n    };\n  }\n\n  /**\n   * Build the resource-integrated file **serve** (GET) route for an operation.\n   *\n   * Symmetric to `buildFileUploadRouteForOperation`, but always entity-addressed and\n   * terminated by the specific `fileId`:\n   * `{operationRoute}/{resourceId}/files/{fieldSegment}/{fileId}`.\n   *\n   * The serve route inherits authorization from the parent resource's READ\n   * operation (the `{resourceId}` identifies the record whose access is checked),\n   * so the URL is single-sourced here for BOTH the backend Express route\n   * registration and the frontend fetch URL. The trailing `fileId` is a plain path\n   * param resolved in the serve handler (NOT a resource-identifying parameter), so\n   * it is intentionally not added to `parameters` — those stay the resource/parent\n   * identifiers the execution context needs. Reuses the upload builder to append\n   * the entity id + `/files/<field>`.\n   */\n  public static buildFileServeRouteForOperation(params: {\n    operationRouteUrl: string;\n    operationParameters: ResourceConfiguration_Operation_UrlParameterInfo[];\n    targetResourceType: ResourceType;\n    targetResourceFieldIdentifier: ResourceFieldIdentifier;\n    fieldName: string;\n    isFrontend: boolean;\n  }): { url: string; parameters: ResourceConfiguration_Operation_UrlParameterInfo[] } {\n    const base = this.buildFileUploadRouteForOperation({\n      operationRouteUrl: params.operationRouteUrl,\n      operationParameters: params.operationParameters,\n      targetResourceType: params.targetResourceType,\n      targetResourceFieldIdentifier: params.targetResourceFieldIdentifier,\n      fieldName: params.fieldName,\n      requiresTargetResourceId: true,\n      isFrontend: params.isFrontend,\n    });\n    const fileIdPlaceholder = params.isFrontend ? ':fileId' : '{fileId}';\n    return {\n      url: `${base.url}/${fileIdPlaceholder}`,\n      parameters: base.parameters,\n    };\n  }\n\n  // ===========================================================================================\n  // PARENT RELATIONSHIP MANAGEMENT\n  // =========================================================================================\n    \n    /**\n   * Build URL for a specific parent combination\n   * \n   * When a parent has a foreignKeyField (like assignedToUserId), the prefix\n   * is applied to the PARENT resource name, not the child:\n   * - /assigned-to-users/{assignedToUserId}/todos (prefix on parent)\n   * - NOT /users/{userId}/assigned-to-todos (prefix on child)\n   */\n    public static buildUrlForParentCombination(\n      parentCombo: ParentResourceInfo[],\n      resourceConfig: AnyResourceConfiguration,\n      operation: ResourceConfiguration_Operation_Urlisable<any, any>,\n      allResourceFieldIdentifiers: Record<string, string>,\n      isFrontend: boolean = false\n    ): { url: string; parameters: ResourceConfiguration_Operation_UrlParameterInfo[] } {\n      \n      const segments: string[] = !isFrontend ? [MAIN_API_BASE_PATH] : [];\n      const parameters: ResourceConfiguration_Operation_UrlParameterInfo[] = [];\n      \n      // For frontend routes (React Router), use :paramName format\n      // For backend routes (Express), use {paramName} format\n      const formatParam = (paramName: string) => isFrontend ? `:${paramName}` : `{${paramName}}`;\n      \n      // Add parent resource segments\n      for (const parent of parentCombo) {\n        let resourcePath = ResourcesConfigNamingUtils.toKebabCase(parent.resourceType);\n        \n        // For FK relationships, use the FK field as the parameter name (e.g., assignedToUserId)\n        // For standard relationships, use the standard field identifier (e.g., userId)\n        // This avoids confusion and makes URLs self-documenting\n        const parameterName = parent.foreignKeyField || parent.fieldIdentifier;\n        \n        // If parent has a foreignKeyField, apply the prefix to the parent resource name\n        // Example: assignedToUserId with parent=users → \"assigned-to-users\" instead of just \"users\"\n        if (parent.foreignKeyField) {\n          const relationshipPrefix = this.extractRelationshipPrefix(parent.foreignKeyField, parent.resourceType);\n          if (relationshipPrefix) {\n            resourcePath = `${relationshipPrefix}-${resourcePath}`;\n          }\n        }\n        \n        segments.push(resourcePath);\n        segments.push(formatParam(parameterName));\n        parameters.push({\n          fieldIdentifier: parameterName,\n          resourceType: parent.resourceType,\n          relationshipField: parent.foreignKeyField,\n          scopeViaJunction: parent.scopeViaJunction,\n        });\n      }\n      \n      // Add main resource segment (no longer modified by relationship context - prefix is on parent)\n      const mainResourcePath = this.generateMainResourcePath(resourceConfig.resourceIdentifier, parentCombo);\n      segments.push(mainResourcePath);\n      \n      // Add operation-specific segments\n      const operationSegments = this.getOperationSegments(\n        operation,\n        resourceConfig,\n        allResourceFieldIdentifiers,\n        parentCombo,\n        isFrontend,\n      );\n      segments.push(...operationSegments.segments);\n      parameters.push(...operationSegments.parameterInfos);\n  \n      const prefix = isFrontend ? '/' : '';\n      return {\n        url: prefix + segments.join('/').replace(/\\/+/g, '/'),\n        parameters\n      };\n    }\n  \n    \n  /**\n   * Get parent resource information with ordering\n   */\n  public static getParentResourceInfos(\n    parentRelationships: ResourceRelationship[],\n    allResourceFieldIdentifiers: Record<string, string>\n  ): ParentResourceInfo[] {\n    const parentInfos: ParentResourceInfo[] = [];\n    \n    for (const relationship of parentRelationships) {\n      const compiledRelationship = Resources_SharedUtils.ensureCompiledRelationship(\n        relationship,\n        allResourceFieldIdentifiers,\n      );\n      const resourceType = relationship.resourceType1;\n      const fieldIdentifier = allResourceFieldIdentifiers[resourceType] ?? relationship.foreignKeyField;\n      if (!fieldIdentifier) {\n        /*\n         * A STANDALONE parent is NEVER part of a URL, so it cannot need a name in one.\n         *\n         * `generateParentCombinations` filters STANDALONE parents out before any segment is built,\n         * and the only consumer of `fieldIdentifier` is the parameter name at that point — so\n         * demanding one here refuses a configuration over data the URL provably discards. Skipping\n         * changes nothing downstream: such a parent is dropped a few steps later regardless.\n         *\n         * What it fixes is severe and silent. `initializeResources` DELETES an excluded type's field\n         * identifier, so a surviving resource anchored to an excluded parent threw here — and\n         * `generateUrlsForApiCallOperations` CATCHES that and `console.error`s it, leaving the\n         * registry \"built successfully\" with every operation carrying no url. Measured on the\n         * application-creation workbench, whose resources anchor to APPLICATION through exactly this\n         * STANDALONE shape: excluding every core type gave 1 resource, 1 logged error and\n         * `listUrl: undefined`, while every unit test that stubbed the transport passed.\n         *\n         * A NON-standalone parent still throws: that URL genuinely needs the parent's name, so an\n         * unresolvable one is a real configuration defect rather than a discarded input.\n         */\n        if (relationship.accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.STANDALONE) {\n          continue;\n        }\n        /*\n         * Name the CHILD, not only the parent. The parent alone (\"organizations\") is true of most\n         * resources in a registry, so the message sent a reader to grep for a type that is\n         * everywhere while saying nothing about which relationship is unresolvable — measured\n         * 2026-09-21 on a companion OpenAPI generation that refused with no way to locate it.\n         */\n        throw new Error(\n          `Cannot generate URL parent info for parent \"${resourceType}\" of child `\n          + `\"${relationship.resourceType2}\" (relationship nature ${String(relationship.nature)}, `\n          + `accessScopeStrategy ${String(relationship.accessScopeStrategy)}) without a registered `\n          + 'field identifier or relationship foreignKeyField. The parent type is usually absent from '\n          + '`allResourceFieldIdentifiers` because feature gating excluded it from this registry.',\n        );\n      }\n      \n      parentInfos.push({\n        resourceType,\n        fieldIdentifier,\n        isPrimaryScope: relationship.isPrimaryScope || false,\n        isOptional: relationship.parentResourceRequirement === ResourceParentResourceRequirement.OPTIONAL,\n        accessScopeStrategy: relationship.accessScopeStrategy,\n        foreignKeyField: relationship.foreignKeyField,\n        childForeignKeyField: compiledRelationship.resolvedSemantics.persistence.foreignKey?.fieldIdentifier,\n        relationshipNature: relationship.nature,\n        jointResourceType: relationship.jointResourceType,\n        scopeViaJunction: relationship.scopeViaJunction,\n        cardinality1: relationship.cardinality1,\n        cardinality2: relationship.cardinality2,\n        order: 0 // Will be calculated later\n      });\n    }\n    \n    // Collapse multiple parents that resolve to the SAME resourceType down to a\n    // single URL parent, preferring the ROUTABLE one. A resource can carry both\n    // a STANDALONE primary anchor (which declares `resourcePrimaryScope` but is\n    // intentionally inert for URL routing — see the primary-scope derivation in\n    // the config factory) AND a routable peer of the same type (e.g. an M:N\n    // junction's OPTIONAL_CONTEXT side). Without this collapse,\n    // `orderParentResourceInfos`' per-resourceType dedup keeps whichever sorts\n    // first — the STANDALONE anchor (primary sorts first) — and then\n    // `generateParentCombinations` drops it as STANDALONE, so the route is lost\n    // entirely. That is the exact bug that left ORGANIZATION_MEMBERS unreachable\n    // under `/organizations/{organizationId}/organization-members` while it still\n    // routed under `/users/{userId}/...`. We keep the routable peer's OWN flags\n    // (notably its non-primary, OPTIONAL_CONTEXT scope) so the route stays\n    // optional — preserving BOTH the org-side and user-side URLs of the junction.\n    const collapsedByResourceType = new Map<ResourceType, ParentResourceInfo>();\n    for (const info of parentInfos) {\n      const existing = collapsedByResourceType.get(info.resourceType);\n      if (!existing || this.isMoreUrlRoutableParent(info, existing)) {\n        collapsedByResourceType.set(info.resourceType, info);\n      }\n    }\n\n    // Order by dependency chain, then alphabetically\n    return this.orderParentResourceInfos([...collapsedByResourceType.values()], parentRelationships);\n  }\n\n  /**\n   * Rank a candidate URL parent against the one currently kept for the same\n   * resourceType. A routable (non-STANDALONE) parent always beats a STANDALONE\n   * anchor — a STANDALONE relationship is by definition off the URL surface, so\n   * it must never shadow a peer that DOES route. Two equally-routable (or two\n   * equally-STANDALONE) parents keep the first encountered (stable).\n   */\n  private static isMoreUrlRoutableParent(candidate: ParentResourceInfo, existing: ParentResourceInfo): boolean {\n    const candidateRoutable = candidate.accessScopeStrategy !== ResourceRelationshipAccessScopeStrategy.STANDALONE;\n    const existingRoutable = existing.accessScopeStrategy !== ResourceRelationshipAccessScopeStrategy.STANDALONE;\n    return candidateRoutable && !existingRoutable;\n  }\n  \n  /**\n   * Order parent resources by dependency chain and alphabetically\n   */\n  private static orderParentResourceInfos(\n    parentInfos: ParentResourceInfo[],\n    allRelationships: ResourceRelationship[]\n  ): ParentResourceInfo[] {\n    // Create dependency map\n    const dependencyMap = new Map<ResourceType, Set<ResourceType>>();\n    \n    for (const info of parentInfos) {\n      dependencyMap.set(info.resourceType, new Set());\n    }\n    \n    // Build dependency chains\n    for (const relationship of allRelationships) {\n      if (dependencyMap.has(relationship.resourceType2) && \n        dependencyMap.has(relationship.resourceType1)) {\n        dependencyMap.get(relationship.resourceType2)!.add(relationship.resourceType1);\n      }\n    }\n    \n    // Topological sort with primary scope priority\n    const sorted: ParentResourceInfo[] = [];\n    const visited = new Set<ResourceType>();\n    const visiting = new Set<ResourceType>();\n    \n    const visit = (info: ParentResourceInfo) => {\n      if (visiting.has(info.resourceType)) {\n        // Circular dependency, sort alphabetically\n        return;\n      }\n      if (visited.has(info.resourceType)) {\n        return;\n      }\n      \n      visiting.add(info.resourceType);\n      \n      // Visit dependencies first\n      const dependencies = dependencyMap.get(info.resourceType) || new Set();\n      const depInfos = parentInfos.filter(p => dependencies.has(p.resourceType));\n      depInfos.sort((a, b) => a.resourceType.localeCompare(b.resourceType));\n      \n      for (const depInfo of depInfos) {\n        visit(depInfo);\n      }\n      \n      visiting.delete(info.resourceType);\n      visited.add(info.resourceType);\n      sorted.push(info);\n    };\n    \n    // Sort by priority: primary scope first, then alphabetically\n    const sortedInfos = [...parentInfos].sort((a, b) => {\n      if (a.isPrimaryScope && !b.isPrimaryScope) return -1;\n      if (!a.isPrimaryScope && b.isPrimaryScope) return 1;\n      return a.resourceType.localeCompare(b.resourceType);\n    });\n    \n    for (const info of sortedInfos) {\n      visit(info);\n    }\n    \n    return sorted;\n  }\n  \n  /**\n   * Generate all possible parent combinations based on accessScopeStrategy\n   * \n   * Access Scope Strategy Rules:\n   * - REQUIRES_CONTEXT: Always included in parent context (mandatory in URL path)\n   * - OPTIONAL_CONTEXT: Can be included or not in parent context (generates multiple URL paths)\n   * - STANDALONE: Never included in URL path - resource is accessed independently\n   *   (the relationship exists for data model purposes, but not for URL routing)\n   *\n   * ## The nesting ceiling: a resource's DIRECT parents only (#1095)\n   *\n   * `parentInfos` holds the resource's OWN parent relationships. A parent's own optional parents are\n   * never chained: with `TODO_LISTS → TODOS` and `TODOS → TASKS` both OPTIONAL_CONTEXT, tasks mount\n   * under `/organizations/{org}/tasks` and `/organizations/{org}/todos/{todo}/tasks`, and the\n   * four-level `/organizations/{org}/todo-lists/{list}/todos/{todo}/tasks` does NOT exist — the\n   * grandparent contributes nothing to the grandchild's URL set. So the deepest route an application\n   * can reach is primary scope + one level of direct parents, and a lane asserting a deeper chain is\n   * asserting a route the framework never generates (pinned by\n   * `examples/wonder-todos/e2e/resource-relationships.e2e.ts`, A4b).\n   *\n   * This is a design ceiling rather than an oversight, and it is deliberately NOT lifted here: chaining\n   * optional parents transitively multiplies the route set per level and asks the URL parent coherence\n   * check to reconcile a grandparent it has no FK for.\n   *\n   * ## DECIDED 2026-09-17 (#1121): the ceiling STAYS\n   *\n   * Measured before deciding rather than argued from the cost alone. Navigation, breadcrumbs and\n   * context loading read the ancestor chain from `parentResourcesRequirements` — the resource context\n   * — and not from URL depth (`useNavigationController.ts`), so nothing renders differently for the\n   * absence of the deeper route. Wonder Todos declares exactly the shape that would use it\n   * (`TODO_LISTS → TODOS → TASKS`, both hops OPTIONAL_CONTEXT) and has run against this ceiling\n   * throughout.\n   *\n   * Both alternatives were real and both were refused for the same reason: they buy a capability with\n   * no consumer. Chaining every hop needs a DEFINED answer — 404 or a coherence 400 — for a todo whose\n   * `todoListId` disagrees with the `{list}` in the URL, at every depth, and the coherence check has\n   * no FK to reconcile the grandparent with. Opting in per relationship adds a declarative authoring\n   * surface for a case nobody has asked for, which is the thing a framework should add last.\n   *\n   * So the rule is unchanged and now has a reason attached: do not widen this builder until an\n   * application needs deeper addressing, and when one does, the FIRST thing owed is the coherence\n   * answer, not the route generation.\n   */\n  private static generateParentCombinations(\n    parentInfos: ParentResourceInfo[]\n  ): ParentResourceInfo[][] {\n    \n    // Filter out STANDALONE relationships - they are NEVER included in URL paths\n    const urlParents = parentInfos.filter(p =>\n      p.accessScopeStrategy !== ResourceRelationshipAccessScopeStrategy.STANDALONE\n    );\n\n    // Scope-anchored peer-under-scope edges (scope-required reference search) are\n    // ADDITIVE access paths: each adds a single-parent scoped route (e.g.\n    // /organizations/{org}/users/search) WITHOUT altering the target's normal\n    // addressability — in particular it must NOT suppress the target's bare/global\n    // route (the empty combination is skipped below whenever any parent exists, so\n    // a scope-anchored edge folded into the normal powerset would silently drop\n    // /users/search). Handle them separately, appended as their own routes.\n    const scopeAnchoredParents = urlParents.filter(p => p.scopeViaJunction);\n    const standardParents = urlParents.filter(p => !p.scopeViaJunction);\n\n    const primaryScope = standardParents.filter(p => p.isPrimaryScope);\n    const mandatoryContext = standardParents.filter(p =>\n      !p.isPrimaryScope &&\n      p.accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.REQUIRES_CONTEXT\n    );\n    // OPTIONAL_CONTEXT generates optional URL paths (with and without parent)\n    const optionalContext = standardParents.filter(p =>\n      p.accessScopeStrategy === ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT &&\n      !p.isPrimaryScope\n    );\n\n    // Generate all combinations of optional context parents\n    const optionalCombinations = this.generateOptionalCombinations(optionalContext);\n\n    const allCombinations: ParentResourceInfo[][] = [];\n\n    for (const optionalCombo of optionalCombinations) {\n      const combination = [...primaryScope, ...mandatoryContext, ...optionalCombo];\n      if (combination.length > 0) {\n        allCombinations.push(combination);\n      }\n    }\n\n    // If no standard combinations, at least return the empty (bare) combination.\n    if (allCombinations.length === 0) {\n      allCombinations.push([]);\n    }\n\n    // Append each scope-anchored edge as its OWN single-parent route, on top of\n    // the normal addressability above (additive — never suppresses the bare).\n    for (const scopeAnchoredParent of scopeAnchoredParents) {\n      allCombinations.push([scopeAnchoredParent]);\n    }\n\n    return allCombinations;\n  }\n  \n  /**\n   * Generate all possible combinations of optional items\n   */\n  private static generateOptionalCombinations<T>(optionalItems: T[]): T[][] {\n    const combinations: T[][] = [[]]; // Start with empty combination\n    \n    for (const item of optionalItems) {\n      const currentLength = combinations.length;\n      for (let i = 0; i < currentLength; i++) {\n        combinations.push([...combinations[i], item]);\n      }\n    }\n    \n    return combinations;\n  }\n  \n\n  /**\n   * Get operation-specific URL segments\n   * \n   * URL Pattern Rules:\n   * - Core collection operations (LIST, CREATE, etc.): No operation suffix, differentiated by HTTP method\n   * - SEARCH: /search suffix (single occurrence)\n   * - COUNT: /count suffix (single occurrence)\n   * - Custom collection operations: Add operation name (e.g., /reset-features)\n   * - Core entity operations (READ, UPDATE, DELETE): No suffix after the entity\n   *   target. Regular resources include an entity ID; relationship-unique\n   *   singleton and complete M:N paths omit it.\n   * - Custom entity operations: Add the operation name after the entity target\n   *   (e.g., /{id}/rotate on regular resources, or /rotate on id-less\n   *   singleton / complete M:N paths).\n   */\n  \n  private static getOperationSegments(\n    operation: ResourceConfiguration_Operation_Urlisable<any, any>,\n    resourceConfig: AnyResourceConfiguration,\n    allResourceFieldIdentifiers: Record<string, string>,\n    parentCombo: ParentResourceInfo[],\n    isFrontend: boolean = false\n  ): { segments: string[]; parameterInfos: ResourceConfiguration_Operation_UrlParameterInfo[] } {\n    \n    const segments: string[] = [];\n    const parameterInfos: ResourceConfiguration_Operation_UrlParameterInfo[] = [];\n    const operationName = String(operation.operationIdentifier);\n    const isCollectionLevelOperation = this.isCollectionLevelOperation(operation, operationName);\n    \n    // For frontend routes (React Router), use :paramName format\n    // For backend routes (Express), use {paramName} format\n    const formatParam = (paramName: string) => isFrontend ? `:${paramName}` : `{${paramName}}`;\n    const generatedRegenerate = operation.generatedOperation?.kind === ResourceGeneratedOperationKind.GENERATED_FILE_REGENERATE\n      ? operation.generatedOperation\n      : undefined;\n    const generatedCollectionExport = operation.generatedOperation?.kind === ResourceGeneratedOperationKind.GENERATED_COLLECTION_EXPORT;\n    \n    // Determine if this is a custom operation (not a core operation)\n    const isCustomOperation = !Object.values(CoreResourceOperation).includes(operationName as CoreResourceOperation);\n    \n    if (isCollectionLevelOperation) {\n      // For custom collection operations, add the operation name segment\n      if (isCustomOperation) {\n        // The export companion is the one custom collection operation that must NOT be named here.\n        // Its identifier (`collectionExport:list`) would kebab-case into a segment, and it needs the\n        // `search` segment its SOURCE gets — which is appended further down, from\n        // `resourceOperationLike`. So the literal `export` segment is pushed AFTER that, and this\n        // branch contributes nothing.\n        if (!generatedCollectionExport) {\n          const operationSegment = ResourcesConfigNamingUtils.toKebabCase(operationName);\n          segments.push(operationSegment);\n        }\n      }\n      // Core collection operations (LIST, CREATE, etc.) don't add an operation\n      // name on the BACKEND — they differentiate by HTTP method (GET for LIST,\n      // POST for CREATE). FRONTEND routes carry no HTTP method, so an addressable\n      // core CREATE must carry an explicit `create` segment or it resolves to the\n      // bare collection path and collides with LIST — shadowing the listing on a\n      // cold load / refresh. Mirrors the `search`/`count` disambiguation below.\n      // (LIST stays at the bare collection path; SEARCH/COUNT/CREATE disambiguate.)\n      else if (isFrontend && this.getCoreOperation(operation) === CoreResourceOperation.CREATE) {\n        segments.push('create');\n      }\n    } else {\n      // Entity-level operations\n      // Skip resource ID when the parent combination uniquely identifies the resource:\n      // - One-to-one: only one instance per parent (e.g., organization-preference)\n      // - Complete many-to-many: both foreign keys specified (e.g., org + user = unique membership)\n      if (generatedRegenerate || (!this.isOneToOneRelationship(parentCombo) && !this.isCompleteManyToManyPath(parentCombo))) {\n        const resourceParam = allResourceFieldIdentifiers[resourceConfig.resourceIdentifier];\n        segments.push(formatParam(resourceParam));\n\n        parameterInfos.push({\n          fieldIdentifier: resourceParam,\n          resourceType: resourceConfig.resourceIdentifier as ResourceType\n        });\n      }\n      \n      // For custom entity operations, add the operation name after the entity target.\n      if (isCustomOperation) {\n        if (generatedRegenerate) {\n          segments.push('files', ResourcesConfigNamingUtils.toKebabCase(generatedRegenerate.fieldName.replace(/\\./g, '-')), 'regenerate');\n        } else {\n          const operationSegment = ResourcesConfigNamingUtils.toKebabCase(operationName);\n          segments.push(operationSegment);\n        }\n      }\n    }\n    \n    // Add bulk suffix if needed\n    if (operation.isBulkOperation) {\n      segments.push('bulk');\n    }\n\n    const coreOperation = this.getCoreOperation(operation);\n\n    // Add search segment when the operation carries SEARCH semantics.\n    if (coreOperation === CoreResourceOperation.SEARCH) {\n      segments.push('search');\n    }\n\n    // Add count segment when the operation carries COUNT semantics.\n    if (coreOperation === CoreResourceOperation.COUNT) {\n      segments.push('count');\n    }\n\n    // The export companion sits one segment BELOW the listing it exports, so it inherits that\n    // listing's whole path — every parent combination, and the `search` disambiguator above:\n    //   LIST   → /organizations/{org}/todos/export\n    //   SEARCH → /organizations/{org}/todos/search/export\n    // A resource exporting both verbs therefore gets two distinct routes without a naming scheme,\n    // and neither can shadow the listing itself (a literal segment, appended last).\n    if (generatedCollectionExport) {\n      segments.push('export');\n    }\n    \n    // Add variant key if exists\n    if (operation.variantKey) {\n      segments.push(operation.variantKey);\n    }\n    \n    return { segments, parameterInfos };\n  }\n\n\n  \n  /**\n   * Generate main resource path segment\n   * \n   * Note: The relationship prefix (like \"assigned-to\") is now applied to the PARENT resource\n   * in buildUrlForParentCombination, not to the child resource here.\n   * \n   * Examples:\n   * - /assigned-to-users/{userId}/todos (prefix on parent \"users\")\n   * - /created-by-users/{userId}/todos (prefix on parent \"users\")\n   * - /organizations/{orgId}/todos (no relationship field, no prefix)\n   * - /organizations/{orgId}/organization-preference (singular for one-to-one)\n   * - /organizations/{orgId}/users/{userId}/organization-member (singular for complete many-to-many)\n   */\n  private static generateMainResourcePath(mainResourceIdentifier: string, parentCombo: ParentResourceInfo[]): string {\n\n    // Check if this is a one-to-one relationship OR a complete many-to-many path - use singular form\n    const baseResourcePath = (this.isOneToOneRelationship(parentCombo) || this.isCompleteManyToManyPath(parentCombo)) \n      ? ResourcesConfigNamingUtils.toKebabCase(ResourcesConfigNamingUtils.singularize(mainResourceIdentifier)) \n      : ResourcesConfigNamingUtils.toKebabCase(mainResourceIdentifier);\n    \n    return baseResourcePath;\n  }\n  \n  /**\n   * Extract relationship prefix from a relationship field, excluding the parent resource type.\n   * \n   * Pattern: {relationshipDescriptor}{ParentResourceType}Id\n   * - assignedToUserId with parentType=users → assignedTo → assigned-to\n   * - createdByUserId with parentType=users → createdBy → created-by\n   * \n   * @param relationshipField - The relationship field name (e.g., assignedToUserId)\n   * @param parentResourceType - The parent resource type (e.g., users) - optional, if provided will be stripped\n   */\n  public static extractRelationshipPrefix(relationshipField: string, parentResourceType?: ResourceType): string {\n    // Get base name without Id/Ids suffix\n    let baseName = ResourcesConfigNamingUtils.extractBaseName(relationshipField);\n    \n    // If parent resource type is provided, remove it from the end of base name\n    // e.g., \"assignedToUser\" with parent \"users\" → \"assignedTo\"\n    if (parentResourceType) {\n      // Get singular form of parent resource type (e.g., \"users\" → \"user\").\n      const parentSingular = ResourcesConfigNamingUtils.singularize(parentResourceType);\n      // Compare using WORD-BOUNDARY-SAFE camelCase forms so that multi-word\n      // snake_case resource types work identically to single-word ones. The FK\n      // base name is always camelCase (e.g. \"anonymousUserId\" → \"anonymousUser\"),\n      // while a snake_case parent singular is \"anonymous_user\"; comparing the raw\n      // forms (\"Anonymous_user\" / \"anonymous_user\") misses the strip and emits a\n      // redundant prefix (\"anonymous-user-anonymous-users\"). PascalCase folds both\n      // to \"AnonymousUser\" so `endsWith` matches on the word boundary, and a\n      // separator-stripped lowercase compare catches the exact standard-FK case.\n      const parentSingularPascal = ResourcesConfigNamingUtils.toPascalCase(parentSingular);\n      const stripSeparators = (value: string): string => value.replace(/[_\\-\\s]/g, '').toLowerCase();\n\n      if (stripSeparators(baseName) === stripSeparators(parentSingular)) {\n        // Exact match for a standard FK: the base name IS the parent's own\n        // identifier (e.g. \"userId\"→\"users\", \"anonymousUserId\"→\"anonymous_users\")\n        // → no prefix needed.\n        baseName = '';\n      } else if (baseName.endsWith(parentSingularPascal)) {\n        // Non-standard FK carrying the parent type as a trailing word\n        // (e.g. \"assignedToUser\"/\"approvedByManager\" end with \"User\"/\"Manager\").\n        baseName = baseName.slice(0, -parentSingularPascal.length);\n      }\n    }\n    \n    // If baseName is empty after stripping, return empty (no prefix needed)\n    if (!baseName) return '';\n    \n    return ResourcesConfigNamingUtils.toKebabCase(baseName);\n  }\n\n  private static getOperationKey(operation: ResourceConfiguration_Operation_Urlisable<any, any>): string {\n    return ResourcesConfig_OperationPathUtils.createOperationPathKeyFromOperation(operation);\n  }\n\n\n\n  private static getCoreOperation(\n    operation: ResourceConfiguration_Operation_Urlisable<any, any>)\n    : CoreResourceOperation {\n    if (operation.resourceOperationLike) {\n      return operation.resourceOperationLike as CoreResourceOperation;\n    } else {\n      return operation.operationIdentifier as CoreResourceOperation;\n    }\n  }\n\n  // ================================\n  // CHECK HELPERS\n  // ================================\n    \n  private static isUrlisable(variantType: ResourceOperationVariantType): boolean {\n    return variantType === ResourceOperationVariantType.API_CALL || variantType === ResourceOperationVariantType.API_CALL_WITH_CALLBACK;\n  }\n    /**\n   * Determines if an operation should be at collection level (no entity ID) or entity level\n   * \n   * Collection-level operations include:\n   * - Core collection operations (LIST, CREATE, CREATE_MANY, UPDATE_MANY, DELETE_MANY, SEARCH, COUNT)\n   * - Custom operations with resourceOperationLike pointing to a collection operation\n   * - Bulk operations (isBulkOperation = true) - they operate on multiple entities\n   */\n    private static isCollectionLevelOperation(operation: ResourceConfiguration_Operation_Urlisable<any, any>, operationName: string ): boolean {\n\n        // Bulk operations are always collection-level (no entity ID)\n        if (operation.isBulkOperation) {\n          return true;\n        }\n\n        if (ALL_COLLECTION_OPERATIONS.includes(operationName as any)) {\n          return true;\n        }\n        \n        if (operation.resourceOperationLike) {\n          const resourceOperationLikeName = String(operation.resourceOperationLike);\n          if (ALL_COLLECTION_OPERATIONS.includes(resourceOperationLikeName as any)) {\n            return true;\n          }\n        }\n        \n        return false;\n      }\n\n      \n  /**\n   * Check if this resource has a one-to-one relationship with its parent\n   * Used to determine if resource should use singular naming and no entity ID\n   */\n  private static isOneToOneRelationship(parentCombo: ParentResourceInfo[]): boolean {\n    if (parentCombo.length === 1) {\n      const parent = parentCombo[0];\n      return parent.relationshipNature === RelationshipNature.COMPOSITION\n        && parent.cardinality1 === ResourceRelationshipCardinality.ONE\n        && isOneToOneCardinality(parent.cardinality2)\n        && parent.accessScopeStrategy !== ResourceRelationshipAccessScopeStrategy.STANDALONE\n        && Boolean(parent.childForeignKeyField);\n    }\n    \n    return false;\n  }\n  \n  /**\n   * Check if this represents a complete many-to-many path (both entities specified)\n   * For junction tables, when both foreign keys are specified in the path,\n   * there can only be one matching record, so we use singular form and no entity ID\n   * \n   * Example: /organizations/{orgId}/users/{userId}/organization-member\n   * This uniquely identifies THE membership between this org and user\n   * \n   * Important: This should NOT match hierarchical relationships with optional\n   * parents. Factory-generated junction parents are OPTIONAL_CONTEXT so each\n   * side can also expose an independent URL, but the complete path is proven by\n   * the association semantics plus shared jointResourceType, not by requiredness.\n   */\n  private static isCompleteManyToManyPath(parentCombo: ParentResourceInfo[]): boolean {\n    // For a complete many-to-many path, we need exactly two association parents\n    // that both point at the same junction resource. Do not require\n    // REQUIRES_CONTEXT here: factory-real M:N junction parents are intentionally\n    // OPTIONAL_CONTEXT so each side can generate independent URLs as well.\n    \n    if (parentCombo.length === 2) {\n      const jointResourceTypes = parentCombo\n        .map((parent) => parent.jointResourceType)\n        .filter((jointResourceType): jointResourceType is ResourceType => Boolean(jointResourceType));\n      return jointResourceTypes.length === 2\n        && new Set(jointResourceTypes).size === 1\n        && new Set(parentCombo.map((parent) => parent.foreignKeyField || parent.fieldIdentifier)).size === parentCombo.length\n        && parentCombo.every((parent) =>\n          parent.relationshipNature === RelationshipNature.ASSOCIATION\n          && parent.cardinality1 === ResourceRelationshipCardinality.ONE\n          && parent.cardinality2 === ResourceRelationshipCardinality.MANY\n        );\n    }\n    \n    return false;\n  }\n\n  /**\n   * Generate synthetic parent relationships for FK reference URL paths.\n   * \n   * These synthetic relationships are created ON-THE-FLY during URL generation\n   * and do NOT pollute the data model's parentRelationships.\n   * \n   * Purpose: Enable alternative URL access patterns for resources with non-standard FK fields.\n   * Example: TODOS → USERS with 'assignedToUserId' creates /assigned-to-users/{userId}/todos\n   * \n   * This method replaces the FK transformation that was previously done in the factory,\n   * which incorrectly modified the relationship model and broke context fetching/population.\n   * \n   * Edge Cases Handled:\n   * - M:N relationships: Excluded (not in childRelationships)\n   * - Self-referencing: Filtered out before synthetic parent creation\n   * - Missing standard FK: Skipped gracefully when the parent resource is unknown\n   * - Standard FK (e.g., USER_SELF with userId): Correctly identified and skipped\n   * \n   * Known Minor Inefficiency:\n   * - Multiple non-standard FKs to same resource type (e.g., assignedToUserId + createdByUserId)\n   *   creates extra URL combinations including both FKs in one path.\n   *   Not harmful, just generates unused URL patterns. Can be optimized later.\n   * \n   * @param resourceConfig - Resource configuration with clean relationship model\n   * @param allResourceFieldIdentifiers - Map of resourceType → standard field identifier\n   * @returns Array of synthetic parent relationships (for URL generation ONLY)\n   */\n  private static generateSyntheticFKParents(\n    resourceConfig: AnyResourceConfiguration,\n    allResourceFieldIdentifiers: Record<string, string>,\n    resourceRelationshipsOverride?: ResourceConfiguration_ResourceRelationships,\n  ): ResourceRelationship[] {\n    const syntheticParents: ResourceRelationship[] = [];\n    const resourceIdentifier = resourceConfig.resourceIdentifier;\n    const childRelationships = getChildDirectionRelationships(\n      resourceRelationshipsOverride ?? resourceConfig.resourceRelationships,\n    );\n    \n    // Scan child relationships (where current resource is resourceType1/parent)\n    for (const rel of childRelationships) {\n      // Only process relationships with explicit FK field\n      if (!rel.foreignKeyField) continue;\n      \n      // Skip self-referencing relationships\n      if (rel.resourceType2 === resourceIdentifier) continue;\n      \n      // Get standard FK for the parent (current resource = resourceType1)\n      const parentStandardFK = allResourceFieldIdentifiers[rel.resourceType1];\n      if (!parentStandardFK) {\n        // No standard FK defined - skip\n        continue;\n      }\n      \n      // Check if this FK is standard or non-standard\n      // Standard: FK matches the parent's standard field identifier\n      // Non-standard: FK differs (e.g., assignedToUserId instead of userId)\n      const isStandardFK = rel.foreignKeyField === parentStandardFK;\n      \n      if (!isStandardFK) {\n        // Non-standard FK found!\n        // Original relationship: CURRENT → REFERENCED with non-standard FK\n        // Create synthetic: REFERENCED → CURRENT for URL generation\n        // This enables URL pattern: /fk-prefix-referenced/{fkValue}/current\n        \n        const syntheticParent = Resources_SharedUtils.compileRelationshipDeclaration({\n          // Reverse the relationship for URL nesting\n          resourceType1: rel.resourceType2,  // Referenced resource becomes \"parent\" for URL\n          resourceType2: resourceIdentifier,  // Current resource becomes \"child\" for URL\n          cardinality1: rel.cardinality2,\n          cardinality2: rel.cardinality1,\n          \n          // FK reference relationships are never primary scope\n          isPrimaryScope: false,\n          primaryScope: undefined,\n          \n          // Optional parent - generates alternative URL path\n          parentResourceRequirement: ResourceParentResourceRequirement.OPTIONAL,\n          \n          // OPTIONAL_CONTEXT ensures URL path is generated\n          // (STANDALONE would skip, REQUIRES_CONTEXT would make it mandatory)\n          accessScopeStrategy: ResourceRelationshipAccessScopeStrategy.OPTIONAL_CONTEXT,\n          \n          // Basic flags\n          isDisabled: false,\n          allowCycle: false,\n          jointResourceType: undefined,\n          \n          // Keep foreignKeyField - URL builder uses this for custom prefix\n          // Example: assignedToUserId → /assigned-to-users/ prefix\n          foreignKeyField: rel.foreignKeyField,\n          \n          // DO NOT copy contextPolicy/childOperations - these are for data model.\n          // Synthetic relationships exist ONLY for URL generation.\n          contextPolicy: undefined,\n          nature: RelationshipNature.REFERENCE,\n          childOperations: undefined,\n          // discriminator and condition are explicitly set to undefined because\n          // synthetic FK parents are structural (for URL path generation), not\n          // data-dependent. They must not carry runtime conditions from the\n          // original relationship — conditions are evaluated elsewhere (in\n          // ResourceContext, ServicesRegistryHandler, ContainerNested) when\n          // processing the real relationship.\n          discriminator: undefined,\n          condition: undefined,\n          display: undefined,\n        } satisfies ResourceRelationshipDeclaration);\n        \n        syntheticParents.push(syntheticParent);\n      }\n    }\n    \n    return syntheticParents;\n  }\n}\n"]}

package/dist/esm/resources/utils/resources-config-operations.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources-config-operations.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/resources-config-operations.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAA2C,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACxI,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,qBAAa,uBAAuB;WAClB,qCAAqC,CAAC,SAAS,EAAE,+BAA+B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,qBAAqB,GAAG,SAAS;IAUjJ;;;;;;;;;OASG;IACH,MAAM,CAAC,uBAAuB,CAC5B,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GACnC,QAAQ,GAAG,SAAS;IAcvB;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CACpB,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS,EAC9D,YAAY,CAAC,EAAE,QAAQ,EACvB,eAAe,GAAE,QAAuB,GACvC,QAAQ;IAuBX;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAIrD;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;CAG/D"}
+{"version":3,"file":"resources-config-operations.utils.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/resources-config-operations.utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAA2C,QAAQ,EAAE,MAAM,oCAAoC,CAAC;AACxI,OAAO,EAAE,qBAAqB,EAAE,MAAM,sCAAsC,CAAC;AAG7E,qBAAa,uBAAuB;WAClB,qCAAqC,CAAC,SAAS,EAAE,+BAA+B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,qBAAqB,GAAG,SAAS;IAUjJ;;;;;;;;;OASG;IACH,MAAM,CAAC,uBAAuB,CAC5B,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GACnC,QAAQ,GAAG,SAAS;IAcvB;;;;;;;;OAQG;IACH,MAAM,CAAC,eAAe,CACpB,MAAM,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS,EAC9D,YAAY,CAAC,EAAE,QAAQ,EACvB,eAAe,GAAE,QAAuB,GACvC,QAAQ;IAuBX;;;;OAIG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,GAAG,QAAQ;IAIrD;;;OAGG;IACH,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;CAG/D"}

package/dist/esm/resources/utils/resources-serialization.utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resources-serialization.utils.d.ts","sourceRoot":"","sources":["../../../../src/resources/utils/resources-serialization.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mCAAmC,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,yBAAyB,EACzB,oCAAoC,EACrC,MAAM,gDAAgD,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,aAAa,EAAE,8BAA8B,CAAC;IAC9C,YAAY,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACnD,cAAc,EAAE,yBAAyB,EAAE,CAAC;IAC5C,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACnE,oBAAoB,CAAC,EAAE,oCAAoC,EAAE,CAAC;CAC/D;AAED;;;GAGG;AACH,qBAAa,0BAA0B;IAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2DG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO;IAIpE;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAIlE;;;;;;OAMG;IACH,MAAM,CAAC,sBAAsB,CAAC,aAAa,EAAE,mCAAmC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM;IAWnG;;;;;OAKG;IACH,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,mCAAmC,CAAC,GAAG,EAAE,GAAG,CAAC;IAI5F;;;;;;;;;OASG;IACH,MAAM,CAAC,yBAAyB,CAAC,GAAG,EAAE;QACpC,aAAa,EAAE,8BAA8B,CAAC;QAC9C,YAAY,EAAE,6BAA6B,GAAG,IAAI,CAAC;QACnD,cAAc,EAAE,yBAAyB,EAAE,CAAC;QAC5C,qBAAqB,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;QACpE,oBAAoB,EAAE,oCAAoC,EAAE,CAAC;KAC9D,GAAG,MAAM;IAgBV;;;;;;;OAOG;IACH,MAAM,CAAC,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,8BAA8B;IAIpF;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,6BAA6B,GAAG,IAAI;CAS3F"}
+{"version":3,"file":"resources-serialization.utils.d.ts","sourceRoot":"","sources":["../../../../../src/resources/utils/resources-serialization.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,mCAAmC,EAAE,MAAM,oCAAoC,CAAC;AACzF,OAAO,EACL,8BAA8B,EAC9B,6BAA6B,EAC7B,yBAAyB,EACzB,oCAAoC,EACrC,MAAM,gDAAgD,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,8BAA8B;IAC7C,aAAa,EAAE,8BAA8B,CAAC;IAC9C,YAAY,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACnD,cAAc,EAAE,yBAAyB,EAAE,CAAC;IAC5C,+BAA+B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACnE,oBAAoB,CAAC,EAAE,oCAAoC,EAAE,CAAC;CAC/D;AAED;;;GAGG;AACH,qBAAa,0BAA0B;IAErC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2DG;IACH,MAAM,CAAC,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO;IAIpE;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,mBAAmB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM;IAIlE;;;;;;OAMG;IACH,MAAM,CAAC,sBAAsB,CAAC,aAAa,EAAE,mCAAmC,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM;IAWnG;;;;;OAKG;IACH,MAAM,CAAC,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,mCAAmC,CAAC,GAAG,EAAE,GAAG,CAAC;IAI5F;;;;;;;;;OASG;IACH,MAAM,CAAC,yBAAyB,CAAC,GAAG,EAAE;QACpC,aAAa,EAAE,8BAA8B,CAAC;QAC9C,YAAY,EAAE,6BAA6B,GAAG,IAAI,CAAC;QACnD,cAAc,EAAE,yBAAyB,EAAE,CAAC;QAC5C,qBAAqB,EAAE,MAAM,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;QACpE,oBAAoB,EAAE,oCAAoC,EAAE,CAAC;KAC9D,GAAG,MAAM;IAgBV;;;;;;;OAOG;IACH,MAAM,CAAC,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,8BAA8B;IAIpF;;;;;;OAMG;IACH,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,6BAA6B,GAAG,IAAI;CAS3F"}