npm - @wildo-ai/saas-backend-lib - Versions diffs - 1.1.2 → 1.1.4 - Mend

@wildo-ai/saas-backend-lib 1.1.2 → 1.1.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (1358) hide show

package/dist/esm/resources/services/resource-population.backend.service.js.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resource-population.backend.service.js","sourceRoot":"","sources":["../../../../../src/resources/services/resource-population.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Resource Population Backend Service\n \n Handles population of related resources based on DataMode and contextPolicy.\n * Orchestrates fetching of parent/child resources for API responses.\n \n Key responsibilities:\n * - Analyze schema for context needs (needsObjectContext, needsUserContext)\n * - Fetch computation context for virtual fields (temporary, not in response)\n * - Populate for SUMMARY mode (isSummaryField({ populate: true }) FKs)\n * - Populate for CONTEXT mode (based on contextPolicy from relationships)\n \n Population Modes:\n \n 1. SUMMARY Mode:\n * - Populates FK fields marked with isSummaryField({ populate: true })\n * - Fetched parents return their own summary fields\n * - Used for LIST/SEARCH responses where minimal related data is needed\n \n 2. CONTEXT Mode:\n * - Uses contextPolicy from ResourceRelationship definitions\n * - Respects operation-specific overrides (e.g., disable on LIST for performance)\n * - Supports depth control and object mode (ID_ONLY, SUMMARY, FULL)\n \n 3. Computation Context (internal, not in response):\n * - Fetched only when virtual fields declare needsObjectContext: true\n * - Provides parent/child data to virtual field calculate() functions\n * - Never included in API response (stripped after virtual computation)\n \n Performance Optimization:\n * - Context needs are analyzed once per resource type and cached\n * - If no virtuals require context, expensive context fetching is skipped entirely\n * - Batch population for lists (TODO: optimize with bulk queries)\n /\n\nimport { injectable, inject, Container } from 'inversify';\nimport {\n ResourceType,\n ResourceRelationship,\n ResourceRelationshipCardinality,\n ResourcesConfigNamingUtils,\n getAllVariantSchemas,\n resolveSchemaForObject,\n analyzeOperationContextNeeds,\n DataMode,\n CoreResourceOperation,\n getParentDirectionRelationships,\n getChildDirectionRelationships,\n isOneToOneCardinality,\n PersistenceAdapter,\n} from '@wildo-ai/saas-models';\nimport { ExecutionContext } from '~wildo-backend-lib/runtime/models/execution-context.backend.schemas';\nimport {\n getZodObjectShape,\n isForeignKeyField,\n isSummaryField,\n getSummaryFieldParams,\n isVirtualField,\n virtualFieldNeedsObjectContext,\n virtualFieldNeedsUserContext\n} from '@wildo-ai/zod-decorators';\nimport { z } from 'zod';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { describeCaughtError, projectCaughtErrorLogFields } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport { ResourcesRegistryBackendService } from './resources-registry.backend.service';\nimport type { RepositoriesRegistryHandlerBackendService } from '~wildo-backend-lib/base-classes/services/repositories/repositories-registry-handler.backend.service';\nimport {\n ResourceContextBackendService,\n ResourceContextFailureMode,\n} from './resource-context.backend.service';\nimport type { ServicesRegistryHandlerBackendService } from '~wildo-backend-lib/base-classes/services/services/services-registry-handler.backend.service';\nimport { FilePopulationBackendService, FilePopulationOptions } from '~wildo-backend-lib/files/services/file-population.backend.service';\nimport { RepositoryOptions, ServiceOptions } from '~wildo-backend-lib/base-classes/models/repositories.backend.schemas';\nimport { ExecutionContextCreatorBackendService } from '~wildo-backend-lib/runtime/services/execution-context-creator.backend.service';\n\n// =============================================================================\n// TYPE DEFINITIONS\n// =============================================================================\n\n/\n Analysis of what context a resource needs.\n \n EFFICIENCY RULES:\n * - needsObjectContext is ONLY true if at least one virtual has needsObjectContext: true\n * - needsUserContext is ONLY true if at least one virtual has needsUserContext: true\n * - If both are false, NO context fetching occurs (fast path)\n * - This analysis is cached per resource type for performance\n /\nexport interface ContextNeedsAnalysis {\n /\n True ONLY if at least one virtual field declares needsObjectContext: true.\n * When false, skip expensive context fetching entirely.\n /\n needsObjectContext: boolean;\n\n /\n True ONLY if at least one virtual field declares needsUserContext: true.\n * When false, skip user context resolution.\n /\n needsUserContext: boolean;\n\n /* FK fields that should be populated in response (isSummaryField({ populate: true })) /\n responsePopulationFields: Set<string>;\n}\n\n/\n Temporary context used for virtual field computation.\n * NOT included in response.\n /\nexport interface ComputationContext {\n /\n Full object context (parents AND children).\n * Same structure as objectContext passed to virtual calculate().\n /\n objectContext?: {\n parents?: Record<string, any>;\n children?: Record<string, any>;\n };\n\n /* User context /\n userContext?: any;\n}\n\n/\n Controls whether object-context assembly may degrade to an empty context.\n \n Virtual-field rendering is intentionally fault tolerant. Authorization and\n * mutation invariants are not: treating a failed relationship read as \"there\n * are no related objects\" would evaluate business policy against invented\n * state.\n /\nexport enum ComputationContextFailureMode {\n FAULT_TOLERANT = 'fault-tolerant',\n PROPAGATE = 'propagate',\n}\n\n// =============================================================================\n// SERVICE IMPLEMENTATION\n// =============================================================================\n\n@injectable()\nexport class ResourcePopulationBackendService {\n\n protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n\n // Cache for context needs analysis per resource type\n private contextNeedsCache: Map<ResourceType, ContextNeedsAnalysis> = new Map();\n\n constructor(\n @inject(SAAS_SERVICE_TYPES.Logger)\n private logger: LoggerService,\n\n @inject(SAAS_SERVICE_TYPES.ResourceRegistryService)\n private resourcesRegistry: ResourcesRegistryBackendService,\n\n @inject(SAAS_SERVICE_TYPES.RepositoriesRegistryHandlerService)\n private repositoriesRegistry: RepositoriesRegistryHandlerBackendService,\n\n @inject(SAAS_SERVICE_TYPES.ResourceContextService)\n private resourceContextService: ResourceContextBackendService,\n\n // Container for lazy resolution of ServicesRegistryHandlerService to break circular dependency\n @inject('Container') private container: Container,\n\n @inject(SAAS_SERVICE_TYPES.FilePopulationService)\n private filePopulationService: FilePopulationBackendService,\n\n @inject(SAAS_SERVICE_TYPES.ExecutionContextCreatorBackendService)\n private executionContextCreator: ExecutionContextCreatorBackendService,\n ) {\n this.logDebug = this.logger.debugByType('ResourcePopulationBackendService');\n this.logger.setDebugTypeLogging('ResourcePopulationBackendService', false);\n\n this.logDebug('Resource population service created');\n }\n\n /* One log per (resourceType, field) for the D10 skip — a per-id warn storm is the failure mode the guard exists to remove. /\n private readonly loggedHttpApiPopulationSkips = new Set<string>();\n\n /\n ETL decision D10 (slice 1, recorded deviation on the plan): FK population across an HTTP-API\n * boundary is SKIPPED entirely — the per-relationship opt-in surface lands together with\n * cross-boundary FK support (paper A, gate G1), which registration currently refuses anyway.\n * Consulted at BOTH fetch sites (single-item and list fan-out), enumerated per\n * `invariant-call-site-enumeration.md`. The skip must run BEFORE fetching: the fetch paths\n * swallow failures, so an unguarded remote target would silently half-populate rows.\n /\n private skipHttpApiParentPopulation(parentType: string, resourceType: string, field: string): boolean {\n let parentConfiguration: { persistenceAdapter?: string } \| undefined;\n try {\n parentConfiguration = this.resourcesRegistry.tryGetResourceConfiguration(parentType as never) as\n \| { persistenceAdapter?: string }\n \| undefined;\n } catch {\n return false; // unresolvable parent config — the ordinary fetch path reports it\n }\n if (parentConfiguration?.persistenceAdapter !== PersistenceAdapter.HTTP_API) {\n return false;\n }\n const logKey = `${resourceType}.${field}`;\n if (!this.loggedHttpApiPopulationSkips.has(logKey)) {\n this.loggedHttpApiPopulationSkips.add(logKey);\n this.logger.info(\n `FK population of '${field}' on '${resourceType}' targets HTTP_API-backed '${parentType}' and is skipped (ETL D10, slice 1: no population across a remote boundary). The FK value itself is served; consumers resolve the parent explicitly.`,\n );\n }\n return true;\n }\n\n /\n Lazy getter for ServicesRegistryHandlerService to break circular dependency\n * ServicesRegistryHandlerService depends on ResourcePopulationService, so we resolve it lazily\n /\n private getServicesRegistry(): ServicesRegistryHandlerBackendService {\n return this.container.get<ServicesRegistryHandlerBackendService>(SAAS_SERVICE_TYPES.ServicesRegistryHandlerService);\n }\n\n /\n Analyze schema to determine what context is needed.\n * Returns computation needs (for virtuals, enabledCondition, basicPrefixOperation) and response population (for API response).\n \n EFFICIENCY: Only returns needsObjectContext: true if at least one virtual\n * field, enabledCondition, or basicPrefixOperation explicitly declares needsObjectContext: true.\n * This avoids expensive context fetching when not required.\n /\n analyzeContextNeeds(resourceType: ResourceType): ContextNeedsAnalysis {\n // Check cache first\n if (this.contextNeedsCache.has(resourceType)) {\n return this.contextNeedsCache.get(resourceType)!;\n }\n\n const resourceConfig = this.resourcesRegistry.getResourceConfiguration(resourceType);\n if (!resourceConfig) {\n const result: ContextNeedsAnalysis = {\n needsObjectContext: false,\n needsUserContext: false,\n responsePopulationFields: new Set(),\n };\n return result;\n }\n\n // Get ALL variant schemas (base + inherited) to analyze comprehensively\n // This ensures we don't miss virtual fields only defined in inherited schemas\n const allSchemas = getAllVariantSchemas(\n resourceConfig.mainSchema,\n resourceConfig.inheritenceSchemaDefinition\n );\n\n let needsObjectContext = false;\n let needsUserContext = false;\n const responsePopulationFields = new Set<string>();\n\n // Analyze each schema variant\n for (const [, schema] of allSchemas) {\n const shape = getZodObjectShape(schema);\n if (!shape) continue;\n\n // Analyze each field in this variant\n for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n const typedSchema = fieldSchema as z.ZodTypeAny;\n\n // Check for virtual fields with context needs\n if (isVirtualField(typedSchema)) {\n if (virtualFieldNeedsObjectContext(typedSchema)) {\n needsObjectContext = true;\n }\n if (virtualFieldNeedsUserContext(typedSchema)) {\n needsUserContext = true;\n }\n }\n\n // Check for FK fields with isSummaryField({ populate: true })\n if (isForeignKeyField(typedSchema) && isSummaryField(typedSchema)) {\n const summaryParams = getSummaryFieldParams(typedSchema);\n if (summaryParams?.populate) {\n responsePopulationFields.add(fieldName);\n }\n }\n }\n }\n\n // Analyze operations for enabledCondition and basicPrefixOperation context needs\n if (resourceConfig.operations) {\n for (const operation of resourceConfig.operations) {\n const operationNeeds = analyzeOperationContextNeeds(operation as any);\n if (operationNeeds.needsObjectContext) {\n needsObjectContext = true;\n }\n if (operationNeeds.needsUserContext) {\n needsUserContext = true;\n }\n }\n }\n\n const result: ContextNeedsAnalysis = {\n needsObjectContext,\n needsUserContext,\n responsePopulationFields,\n };\n\n // Cache the result\n this.contextNeedsCache.set(resourceType, result);\n\n this.logDebug(`Analyzed context needs for ${resourceType}`, {\n needsObjectContext,\n needsUserContext,\n responsePopulationFieldsCount: responsePopulationFields.size,\n });\n\n return result;\n }\n\n /\n Fetch computation context for virtual fields.\n * This is TEMPORARY - only used for virtual computation, not returned in response.\n /\n async fetchComputationContext<T extends Record<string, any>>(\n resourceType: ResourceType,\n data: T,\n needs: ContextNeedsAnalysis,\n executionContext: ExecutionContext<any>,\n repositoryOptions?: RepositoryOptions,\n failureMode: ComputationContextFailureMode =\n ComputationContextFailureMode.FAULT_TOLERANT,\n ): Promise<ComputationContext> {\n const result: ComputationContext = {};\n\n // Fetch object context (parents + children) if needed\n if (needs.needsObjectContext) {\n try {\n // Extract resource ID from data\n const resourceId = data._id?.toString() \|\| data.id;\n if (!resourceId) {\n if (failureMode === ComputationContextFailureMode.PROPAGATE) {\n throw new Error(\n `Cannot fetch authoritative object context for ${resourceType}: missing resource ID`,\n );\n }\n this.logger.warn(`Cannot fetch object context for ${resourceType}: missing resource ID`);\n result.objectContext = { parents: {}, children: {} };\n } else {\n const resourceContext = await this.resourceContextService.buildContext(\n resourceType,\n resourceId,\n data,\n {\n parentDepth: 1,\n childDepth: 0,\n executionContext,\n repositoryOptions,\n failureMode:\n failureMode === ComputationContextFailureMode.PROPAGATE\n ? ResourceContextFailureMode.PROPAGATE\n : ResourceContextFailureMode.FAULT_TOLERANT,\n }\n );\n\n result.objectContext = {\n parents: resourceContext.parents,\n children: resourceContext.children,\n };\n }\n } catch (error) {\n if (failureMode === ComputationContextFailureMode.PROPAGATE) {\n throw error;\n }\n this.logger.warn(`Failed to fetch object context for ${resourceType}`, {\n ...projectCaughtErrorLogFields(error),\n });\n // Don't fail - virtual fields should be fault-tolerant\n result.objectContext = { parents: {}, children: {} };\n }\n }\n\n // Fetch user context if needed\n if (needs.needsUserContext) {\n // User context comes from execution context initiatorIds\n result.userContext = executionContext.initiatorIds \|\| undefined;\n }\n\n return result;\n }\n\n /\n Populate for SUMMARY mode.\n * Uses isSummaryField({ populate: true }) FKs.\n * Parents are fetched with THEIR summary fields.\n * Does NOT include computation-only context.\n /\n async populateForSummary<T extends Record<string, any>>(\n resourceType: ResourceType,\n data: T,\n executionContext: ExecutionContext<any>,\n options?: { populateFiles?: boolean },\n repositoryOptions?: RepositoryOptions\n ): Promise<T & Record<string, any>> {\n const needs = this.analyzeContextNeeds(resourceType);\n\n if (needs.responsePopulationFields.size === 0) {\n // No fields to populate\n return data;\n }\n\n const resourceConfig = this.resourcesRegistry.getResourceConfiguration(resourceType);\n if (!resourceConfig) {\n return data;\n }\n\n let result = { ...data } as T & Record<string, any>;\n\n // Populate each FK field that has isSummaryField({ populate: true })\n for (const fkField of needs.responsePopulationFields) {\n const fkValue = data[fkField];\n if (!fkValue) continue;\n\n // Determine the populated field name (todoListId -> todoList)\n const populatedFieldName = ResourcesConfigNamingUtils.extractBaseName(fkField);\n\n // Find the relationship for this FK (includes selfRelationships for tree-structured FKs)\n const relationship = this.findRelationshipForField(\n getParentDirectionRelationships(resourceConfig.resourceRelationships),\n fkField\n );\n\n if (!relationship) {\n this.logDebug(`No relationship found for FK field: ${fkField}`);\n continue;\n }\n\n // Fetch the parent resource with its summary fields\n const parentType = relationship.resourceType1 === resourceType\n ? relationship.resourceType2\n : relationship.resourceType1;\n\n // ETL D10 guard, site 1 of 2 (enumerated per invariant-call-site-enumeration): population\n // against an HTTP_API-backed parent is one REMOTE call per row, and this method's own catch\n // SWALLOWS failures — a rate-limited target would silently half-populate rows behind a warn\n // storm. Skipped BEFORE fetching, one legible log per (resourceType, field), never per id.\n if (this.skipHttpApiParentPopulation(parentType, resourceType as string, fkField)) {\n continue;\n }\n\n try {\n // Build relationship context to track how we're accessing the parent\n const relationshipContext: import('@wildo-ai/saas-models').ExecutionContext_RelationshipContext = {\n resourceType: resourceType as string, // Current resource type\n relationshipField: fkField, // FK field on current resource\n resourceId: data._id?.toString() \|\| data.id, // Current resource ID\n };\n\n // Create sub-call context with correct operation for parent READ\n const subContext = await this.executionContextCreator.createForSubCall(\n executionContext,\n parentType,\n CoreResourceOperation.READ,\n { dataMode: DataMode.SUMMARY },\n fkValue,\n relationshipContext\n );\n\n // Use service layer to read parent with SUMMARY mode\n // This ensures parents get full service processing (virtual fields, summary extraction, etc.)\n // in SUMMARY mode, matching the behavior described in the class documentation\n const parentData = await this.getServicesRegistry().read(\n parentType,\n subContext,\n fkValue,\n { dataMode: DataMode.SUMMARY }\n );\n\n if (parentData) {\n (result as Record<string, any>)[populatedFieldName] = parentData;\n }\n } catch (error) {\n this.logger.warn(`Failed to populate ${populatedFieldName} for ${resourceType}`, {\n fkField,\n fkValue,\n ...projectCaughtErrorLogFields(error),\n });\n // Continue with other fields - don't fail the whole operation\n }\n }\n\n // Populate file fields after FK population\n const populateFiles = options?.populateFiles !== false; // default: true\n if (populateFiles) {\n const populatedWithFiles = await this.filePopulationService.populateFileFields(\n result,\n resourceType,\n executionContext,\n { populateFiles: true },\n repositoryOptions\n );\n result = populatedWithFiles as T & Record<string, any>;\n }\n\n return result;\n }\n\n /\n Populate for CONTEXT mode.\n * Uses contextPolicy from relationships.\n /\n async populateForContext<T extends Record<string, any>>(\n resourceType: ResourceType,\n data: T,\n executionContext: ExecutionContext<any>,\n options?: { populateFiles?: boolean },\n repositoryOptions?: RepositoryOptions\n ): Promise<T & Record<string, any>> {\n // Use ResourceContextBackendService for full context population\n try {\n // Extract resource ID from data\n const resourceId = data._id?.toString() \|\| data.id;\n if (!resourceId) {\n this.logger.warn(`Cannot populate context for ${resourceType}: missing resource ID`);\n return data;\n }\n\n // Pass operation to buildContext for proper contextPolicy resolution\n // The operation determines which operationOverrides apply (e.g., objectMode: FULL on READ)\n const operation = executionContext?.operation?.operationIdentifier as CoreResourceOperation \| undefined;\n\n this.logDebug(`[populateForContext] Starting for ${resourceType}:${resourceId}`, {\n operation,\n hasExecutionContext: !!executionContext,\n operationIdentifier: executionContext?.operation?.operationIdentifier,\n variantKey: executionContext?.operation?.variantKey,\n });\n\n const resourceContext = await this.resourceContextService.buildContext(\n resourceType,\n resourceId,\n data,\n { executionContext, operation }\n );\n\n this.logDebug(`[populateForContext] buildContext returned`, {\n resourceType,\n hasParents: !!resourceContext.parents,\n parentKeys: resourceContext.parents ? Object.keys(resourceContext.parents) : [],\n hasChildren: !!resourceContext.children,\n childKeys: resourceContext.children ? Object.keys(resourceContext.children) : [],\n childrenCounts: resourceContext.children\n ? Object.entries(resourceContext.children).map(([k, v]) => `${k}:${(v as any[]).length}`)\n : [],\n });\n\n let result = { ...data } as T & Record<string, any>;\n\n // Merge parents into result\n // Parents are ResourceContextItem[] - extract .data from each\n // For parents, typically there's one item (1:1 relationship), so we extract the first item's data\n if (resourceContext.parents) {\n for (const [key, items] of Object.entries(resourceContext.parents)) {\n if (Array.isArray(items) && items.length > 0) {\n // For parent relationships (typically 1:1), use the first item's data directly\n // If there are multiple parents of the same type (unusual), take the first\n (result as Record<string, any>)[key] = items[0]?.data;\n }\n }\n }\n\n // Merge children into result\n // Children are ResourceContextItem[] - extract .data from each\n // For 1:1 relationships, return single object with singularized key\n // For 1:many relationships, return array with plural key\n if (resourceContext.children) {\n for (const [key, items] of Object.entries(resourceContext.children)) {\n this.logDebug(`[populateForContext] Processing child key=${key}, itemsCount=${items?.length \|\| 0}`);\n\n if (Array.isArray(items) && items.length > 0) {\n // Check cardinality from the first item to determine if 1:1 or 1:many\n const cardinality = items[0]?.cardinality;\n const isOneToOne = cardinality === ResourceRelationshipCardinality.ONE \|\|\n cardinality === ResourceRelationshipCardinality.ZERO_OR_ONE;\n\n // Use singularized key for 1:1 relationships\n // e.g., 'userSelfProfiles' -> 'userSelfProfile', but 'organizationMembers' stays as-is\n const fieldKey = isOneToOne\n ? ResourcesConfigNamingUtils.singularize(key)\n : key;\n\n this.logDebug(`[populateForContext] Child ${key}: cardinality=${cardinality}, isOneToOne=${isOneToOne}, fieldKey=${fieldKey}`);\n\n if (isOneToOne) {\n // 1:1 relationship: return single object with singularized key\n (result as Record<string, any>)[fieldKey] = items[0]?.data;\n } else {\n // 1:many relationship: return array with plural key\n (result as Record<string, any>)[fieldKey] = items.map(item => item?.data).filter(Boolean);\n }\n } else if (Array.isArray(items)) {\n // Empty result. Cardinality CANNOT be read from items (there are none),\n // so resolve it from the relationship config. A 1:1 child with no row\n // must be OMITTED: the contextDto types a 1:1 embed as an OPTIONAL single\n // `z.record` (see `addRelationshipPlaceholders`), so writing `[]` fails\n // output validation with \"expected record, received array\" — the exact\n // crash for a freshly-created user whose 1:1 `userSelfPreferences` row does\n // not exist yet. A 1:many child stays an empty array (its contextDto\n // placeholder is `z.array(...).optional()`, and consumers expect an array,\n // not an absent field). If the relationship can't be resolved, fall back to\n // the historical `[]` behaviour.\n const emptyChildRelationship = this.findContextChildRelationship(resourceType, key);\n const emptyIsOneToOne = emptyChildRelationship\n ? isOneToOneCardinality(emptyChildRelationship.cardinality2)\n : false;\n this.logDebug(`[populateForContext] Child ${key}: empty items array (isOneToOne=${emptyIsOneToOne})`);\n if (!emptyIsOneToOne) {\n (result as Record<string, any>)[key] = [];\n }\n // 1:1 with no row → leave the field absent (optional single record in contextDto)\n }\n }\n }\n\n // Populate file fields after context population\n const populateFiles = options?.populateFiles !== false; // default: true\n if (populateFiles) {\n const populatedWithFiles = await this.filePopulationService.populateFileFields(\n result,\n resourceType,\n executionContext,\n { populateFiles: true },\n repositoryOptions\n );\n result = populatedWithFiles as T & Record<string, any>;\n }\n\n return result;\n } catch (error) {\n this.logger.warn(`Failed to populate context for ${resourceType}`, {\n ...projectCaughtErrorLogFields(error),\n });\n return data;\n }\n }\n\n /\n Batch populate for lists (SUMMARY mode).\n * Optimized: Collects unique FK values, batch fetches parents, then distributes to items.\n /\n async populateListForSummary<T extends Record<string, any>>(\n resourceType: ResourceType,\n items: T[],\n executionContext: ExecutionContext<any>,\n options?: { populateFiles?: boolean },\n repositoryOptions?: RepositoryOptions\n ): Promise<T[]> {\n const needs = this.analyzeContextNeeds(resourceType);\n\n if (needs.responsePopulationFields.size === 0 \|\| items.length === 0) {\n return items;\n }\n\n const resourceConfig = this.resourcesRegistry.getResourceConfiguration(resourceType);\n if (!resourceConfig) {\n return items;\n }\n\n // Step 1: Collect unique FK values per field\n const fkValuesByField = new Map<string, Set<string>>();\n for (const field of needs.responsePopulationFields) {\n fkValuesByField.set(field, new Set());\n }\n\n for (const item of items) {\n for (const field of needs.responsePopulationFields) {\n const value = item[field];\n if (value) {\n const id = typeof value === 'string' ? value : (value._id?.toString() \|\| value.id?.toString() \|\| String(value));\n if (id) {\n fkValuesByField.get(field)!.add(id);\n }\n }\n }\n }\n\n // Step 2: Batch fetch all parents, grouped by field\n const fetchedParentsByField = new Map<string, Map<string, any>>();\n\n for (const [field, fkValues] of fkValuesByField.entries()) {\n if (fkValues.size === 0) continue;\n\n // Find the relationship for this FK (includes selfRelationships for tree-structured FKs)\n const relationship = this.findRelationshipForField(\n getParentDirectionRelationships(resourceConfig.resourceRelationships),\n field\n );\n\n if (!relationship) {\n this.logDebug(`No relationship found for FK field: ${field}`);\n continue;\n }\n\n // Determine parent resource type\n const parentType = relationship.resourceType1 === resourceType\n ? relationship.resourceType2\n : relationship.resourceType1;\n\n // ETL D10 guard, site 2 of 2: the list path fans out one PARALLEL remote read per unique\n // parent id, unbounded — the exact N+1-against-a-remote-API shape the decision forbids.\n if (this.skipHttpApiParentPopulation(parentType, resourceType as string, field)) {\n continue;\n }\n\n try {\n // Batch fetch all parents using parallel individual reads via service layer\n // Using service layer ensures parents get full service processing (virtual fields, summary extraction, etc.)\n // in SUMMARY mode, matching the behavior described in the class documentation\n const parentIds = Array.from(fkValues);\n const parentsMap = new Map<string, any>();\n\n // Use Promise.all for parallel individual reads\n await Promise.all(\n parentIds.map(async (id) => {\n try {\n // Build relationship context (we don't have specific item ID here, using field info)\n const relationshipContext: import('@wildo-ai/saas-models').ExecutionContext_RelationshipContext = {\n resourceType: resourceType as string, // Current resource type\n relationshipField: field, // FK field on current resource\n resourceId: id, // Parent ID being fetched\n };\n\n // Create sub-call context with correct operation for parent READ\n const subContext = await this.executionContextCreator.createForSubCall(\n executionContext,\n parentType,\n CoreResourceOperation.READ,\n { dataMode: DataMode.SUMMARY },\n id,\n relationshipContext\n );\n\n const parent = await this.getServicesRegistry().read(\n parentType,\n subContext,\n id,\n { dataMode: DataMode.SUMMARY }\n );\n if (parent) {\n const parentRecord = parent as Record<string, any>;\n const parentId = parentRecord._id?.toString() \|\| parentRecord.id?.toString() \|\| id;\n parentsMap.set(parentId, parent);\n }\n } catch (error) {\n // Skip failed reads - don't fail entire operation\n this.logDebug(`Failed to read parent ${parentType}:${id}`, {\n error: describeCaughtError(error)\n });\n }\n })\n );\n\n fetchedParentsByField.set(field, parentsMap);\n } catch (error) {\n this.logger.warn(`Failed to batch fetch parents for field ${field}`, {\n parentType,\n ...projectCaughtErrorLogFields(error),\n });\n // Continue with other fields\n }\n }\n\n // Step 3: Distribute fetched parents to items\n const results: (T & Record<string, any>)[] = [];\n for (const item of items) {\n const result = { ...item } as T & Record<string, any>;\n\n for (const field of needs.responsePopulationFields) {\n const fkValue = item[field];\n if (!fkValue) continue;\n\n const fkId = typeof fkValue === 'string' ? fkValue : (fkValue._id?.toString() \|\| fkValue.id?.toString() \|\| String(fkValue));\n const parentsMap = fetchedParentsByField.get(field);\n\n if (parentsMap && fkId) {\n const parent = parentsMap.get(fkId);\n if (parent) {\n const populatedFieldName = ResourcesConfigNamingUtils.extractBaseName(field);\n (result as Record<string, any>)[populatedFieldName] = parent;\n }\n }\n }\n\n results.push(result);\n }\n\n // Populate file fields after FK population\n const populateFiles = options?.populateFiles !== false; // default: true\n if (populateFiles) {\n const populatedWithFiles = await this.filePopulationService.populateFileFields(\n results,\n resourceType,\n executionContext,\n { populateFiles: true },\n repositoryOptions\n );\n return populatedWithFiles as T[];\n }\n\n return results;\n }\n\n /\n Batch populate for lists (CONTEXT mode).\n /\n async populateListForContext<T extends Record<string, any>>(\n resourceType: ResourceType,\n dataList: T[],\n executionContext: ExecutionContext<any>,\n options?: { populateFiles?: boolean },\n repositoryOptions?: RepositoryOptions\n ): Promise<(T & Record<string, any>)[]> {\n if (dataList.length === 0) {\n return dataList;\n }\n\n // TODO: Implement batch optimization\n\n // For now, populate each item individually (less optimal)\n const results: (T & Record<string, any>)[] = [];\n for (const item of dataList) {\n const populated = await this.populateForContext(resourceType, item, executionContext, options, repositoryOptions);\n results.push(populated);\n }\n\n // File population is already handled in populateForContext\n return results;\n }\n\n // =============================================================================\n // PRIVATE HELPERS\n // =============================================================================\n\n /\n Find the relationship that corresponds to a given FK field.\n * Uses the allResourceFieldIdentifiers map for lookup instead of string manipulation.\n /\n private findRelationshipForField(\n relationships: ResourceRelationship[],\n fkField: string\n ): ResourceRelationship \| undefined {\n const fieldIdentifiers = this.resourcesRegistry.getAllResourceFieldIdentifiers();\n\n return relationships.find(rel => {\n // Priority 1: Explicit foreignKeyField matches\n if (rel.foreignKeyField === fkField) {\n return true;\n }\n // Priority 2: Check if FK field matches the standard field identifier for the related resource type\n // For relationship A → B with B as resourceType2, the FK on A is B's field identifier\n const standardFieldIdentifier = fieldIdentifiers[rel.resourceType2];\n return standardFieldIdentifier === fkField;\n });\n }\n\n /\n Resolve the child-direction relationship a CONTEXT children key corresponds to.\n * The key is the child resource type (`resourceType2`) under which\n * `ResourceContextBackendService` groups fetched items. Used by\n * `populateForContext` to recover a relationship's cardinality when the fetched\n * item set is EMPTY — cardinality can't be read from a non-existent item, so an\n * absent 1:1 child would otherwise be mis-projected as `[]` and fail the\n * optional-single-`z.record` contextDto placeholder. Uses the same\n * `getChildDirectionRelationships` enumeration the DTO builder uses, keyed by\n * `resourceType2` (how the context service groups children).\n */\n private findContextChildRelationship(\n resourceType: ResourceType,\n childResourceType: string,\n ): ResourceRelationship \| undefined {\n const config = this.resourcesRegistry.tryGetResourceConfiguration(resourceType);\n if (!config?.resourceRelationships) {\n return undefined;\n }\n return getChildDirectionRelationships(config.resourceRelationships)\n .find(rel => rel.resourceType2 === childResourceType);\n }\n}\n"]}
1	+ {"version":3,"file":"resource-population.backend.service.js","sourceRoot":"","sources":["../../../../src/resources/services/resource-population.backend.service.ts"],"names":[],"mappings":"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","sourcesContent":["/*\n Resource Population Backend Service\n \n Handles population of related resources based on DataMode and contextPolicy.\n * Orchestrates fetching of parent/child resources for API responses.\n \n Key responsibilities:\n * - Analyze schema for context needs (needsObjectContext, needsUserContext)\n * - Fetch computation context for virtual fields (temporary, not in response)\n * - Populate for SUMMARY mode (isSummaryField({ populate: true }) FKs)\n * - Populate for CONTEXT mode (based on contextPolicy from relationships)\n \n Population Modes:\n \n 1. SUMMARY Mode:\n * - Populates FK fields marked with isSummaryField({ populate: true })\n * - Fetched parents return their own summary fields\n * - Used for LIST/SEARCH responses where minimal related data is needed\n \n 2. CONTEXT Mode:\n * - Uses contextPolicy from ResourceRelationship definitions\n * - Respects operation-specific overrides (e.g., disable on LIST for performance)\n * - Supports depth control and object mode (ID_ONLY, SUMMARY, FULL)\n \n 3. Computation Context (internal, not in response):\n * - Fetched only when virtual fields declare needsObjectContext: true\n * - Provides parent/child data to virtual field calculate() functions\n * - Never included in API response (stripped after virtual computation)\n \n Performance Optimization:\n * - Context needs are analyzed once per resource type and cached\n * - If no virtuals require context, expensive context fetching is skipped entirely\n * - Batch population for lists (TODO: optimize with bulk queries)\n /\n\nimport { injectable, inject, Container } from 'inversify';\nimport {\n ResourceType,\n ResourceRelationship,\n ResourceRelationshipCardinality,\n ResourcesConfigNamingUtils,\n getAllVariantSchemas,\n resolveSchemaForObject,\n analyzeOperationContextNeeds,\n DataMode,\n CoreResourceOperation,\n getParentDirectionRelationships,\n getChildDirectionRelationships,\n isOneToOneCardinality,\n PersistenceAdapter,\n Resources_SharedUtils,\n} from '@wildo-ai/saas-models';\nimport { ExecutionContext } from '~wildo-backend-lib/runtime/models/execution-context.backend.schemas';\nimport {\n getZodObjectShape,\n isForeignKeyField,\n isSummaryField,\n getSummaryFieldParams,\n isVirtualField,\n virtualFieldNeedsObjectContext,\n virtualFieldNeedsUserContext\n} from '@wildo-ai/zod-decorators';\nimport { z } from 'zod';\nimport { SAAS_SERVICE_TYPES } from '~wildo-backend-lib/inject/models/service-types';\nimport { LoggerService } from '~wildo-backend-lib/monitoring/logger/services/logger.service';\nimport { describeCaughtError, projectCaughtErrorLogFields } from '~wildo-backend-lib/errors/utils/error-log-level-classification.backend.utils';\nimport { ResourcesRegistryBackendService } from './resources-registry.backend.service';\nimport type { RepositoriesRegistryHandlerBackendService } from '~wildo-backend-lib/base-classes/services/repositories/repositories-registry-handler.backend.service';\nimport {\n ResourceContextBackendService,\n ResourceContextFailureMode,\n} from './resource-context.backend.service';\nimport type { ServicesRegistryHandlerBackendService } from '~wildo-backend-lib/base-classes/services/services/services-registry-handler.backend.service';\nimport { FilePopulationBackendService, FilePopulationOptions } from '~wildo-backend-lib/files/services/file-population.backend.service';\nimport { RepositoryOptions, ServiceOptions } from '~wildo-backend-lib/base-classes/models/repositories.backend.schemas';\nimport { ExecutionContextCreatorBackendService } from '~wildo-backend-lib/runtime/services/execution-context-creator.backend.service';\n\n// =============================================================================\n// TYPE DEFINITIONS\n// =============================================================================\n\n/\n Analysis of what context a resource needs.\n \n EFFICIENCY RULES:\n * - needsObjectContext is ONLY true if at least one virtual has needsObjectContext: true\n * - needsUserContext is ONLY true if at least one virtual has needsUserContext: true\n * - If both are false, NO context fetching occurs (fast path)\n * - This analysis is cached per resource type for performance\n /\nexport interface ContextNeedsAnalysis {\n /\n True ONLY if at least one virtual field declares needsObjectContext: true.\n * When false, skip expensive context fetching entirely.\n /\n needsObjectContext: boolean;\n\n /\n True ONLY if at least one virtual field declares needsUserContext: true.\n * When false, skip user context resolution.\n /\n needsUserContext: boolean;\n\n /* FK fields that should be populated in response (isSummaryField({ populate: true })) /\n responsePopulationFields: Set<string>;\n}\n\n/\n Temporary context used for virtual field computation.\n * NOT included in response.\n /\nexport interface ComputationContext {\n /\n Full object context (parents AND children).\n * Same structure as objectContext passed to virtual calculate().\n /\n objectContext?: {\n parents?: Record<string, any>;\n children?: Record<string, any>;\n };\n\n /* User context /\n userContext?: any;\n}\n\n/\n Controls whether object-context assembly may degrade to an empty context.\n \n Virtual-field rendering is intentionally fault tolerant. Authorization and\n * mutation invariants are not: treating a failed relationship read as \"there\n * are no related objects\" would evaluate business policy against invented\n * state.\n /\nexport enum ComputationContextFailureMode {\n FAULT_TOLERANT = 'fault-tolerant',\n PROPAGATE = 'propagate',\n}\n\n// =============================================================================\n// SERVICE IMPLEMENTATION\n// =============================================================================\n\n@injectable()\nexport class ResourcePopulationBackendService {\n\n protected logDebug: (message: string, context?: Record<string, unknown>) => void;\n\n // Cache for context needs analysis per resource type\n private contextNeedsCache: Map<ResourceType, ContextNeedsAnalysis> = new Map();\n\n constructor(\n @inject(SAAS_SERVICE_TYPES.Logger)\n private logger: LoggerService,\n\n @inject(SAAS_SERVICE_TYPES.ResourceRegistryService)\n private resourcesRegistry: ResourcesRegistryBackendService,\n\n @inject(SAAS_SERVICE_TYPES.RepositoriesRegistryHandlerService)\n private repositoriesRegistry: RepositoriesRegistryHandlerBackendService,\n\n @inject(SAAS_SERVICE_TYPES.ResourceContextService)\n private resourceContextService: ResourceContextBackendService,\n\n // Container for lazy resolution of ServicesRegistryHandlerService to break circular dependency\n @inject('Container') private container: Container,\n\n @inject(SAAS_SERVICE_TYPES.FilePopulationService)\n private filePopulationService: FilePopulationBackendService,\n\n @inject(SAAS_SERVICE_TYPES.ExecutionContextCreatorBackendService)\n private executionContextCreator: ExecutionContextCreatorBackendService,\n ) {\n this.logDebug = this.logger.debugByType('ResourcePopulationBackendService');\n this.logger.setDebugTypeLogging('ResourcePopulationBackendService', false);\n\n this.logDebug('Resource population service created');\n }\n\n /* One log per (resourceType, field) for the D10 skip — a per-id warn storm is the failure mode the guard exists to remove. /\n private readonly loggedHttpApiPopulationSkips = new Set<string>();\n\n /\n ETL decision D10 (slice 1, recorded deviation on the plan): FK population across an HTTP-API\n * boundary is SKIPPED entirely — the per-relationship opt-in surface lands together with\n * cross-boundary FK support (paper A, gate G1), which registration currently refuses anyway.\n * Consulted at BOTH fetch sites (single-item and list fan-out), enumerated per\n * `invariant-call-site-enumeration.md`. The skip must run BEFORE fetching: the fetch paths\n * swallow failures, so an unguarded remote target would silently half-populate rows.\n /\n private skipHttpApiParentPopulation(parentType: string, resourceType: string, field: string): boolean {\n let parentConfiguration: { persistenceAdapter?: string } \| undefined;\n try {\n parentConfiguration = this.resourcesRegistry.tryGetResourceConfiguration(parentType as never) as\n \| { persistenceAdapter?: string }\n \| undefined;\n } catch {\n return false; // unresolvable parent config — the ordinary fetch path reports it\n }\n if (parentConfiguration?.persistenceAdapter !== PersistenceAdapter.HTTP_API) {\n return false;\n }\n const logKey = `${resourceType}.${field}`;\n if (!this.loggedHttpApiPopulationSkips.has(logKey)) {\n this.loggedHttpApiPopulationSkips.add(logKey);\n this.logger.info(\n `FK population of '${field}' on '${resourceType}' targets HTTP_API-backed '${parentType}' and is skipped (ETL D10, slice 1: no population across a remote boundary). The FK value itself is served; consumers resolve the parent explicitly.`,\n );\n }\n return true;\n }\n\n /\n Lazy getter for ServicesRegistryHandlerService to break circular dependency\n * ServicesRegistryHandlerService depends on ResourcePopulationService, so we resolve it lazily\n /\n private getServicesRegistry(): ServicesRegistryHandlerBackendService {\n return this.container.get<ServicesRegistryHandlerBackendService>(SAAS_SERVICE_TYPES.ServicesRegistryHandlerService);\n }\n\n /\n Analyze schema to determine what context is needed.\n * Returns computation needs (for virtuals, enabledCondition, basicPrefixOperation) and response population (for API response).\n \n EFFICIENCY: Only returns needsObjectContext: true if at least one virtual\n * field, enabledCondition, or basicPrefixOperation explicitly declares needsObjectContext: true.\n * This avoids expensive context fetching when not required.\n /\n analyzeContextNeeds(resourceType: ResourceType): ContextNeedsAnalysis {\n // Check cache first\n if (this.contextNeedsCache.has(resourceType)) {\n return this.contextNeedsCache.get(resourceType)!;\n }\n\n const resourceConfig = this.resourcesRegistry.getResourceConfiguration(resourceType);\n if (!resourceConfig) {\n const result: ContextNeedsAnalysis = {\n needsObjectContext: false,\n needsUserContext: false,\n responsePopulationFields: new Set(),\n };\n return result;\n }\n\n // Get ALL variant schemas (base + inherited) to analyze comprehensively\n // This ensures we don't miss virtual fields only defined in inherited schemas\n const allSchemas = getAllVariantSchemas(\n resourceConfig.mainSchema,\n resourceConfig.inheritenceSchemaDefinition\n );\n\n let needsObjectContext = false;\n let needsUserContext = false;\n const responsePopulationFields = new Set<string>();\n\n // Analyze each schema variant\n for (const [, schema] of allSchemas) {\n const shape = getZodObjectShape(schema);\n if (!shape) continue;\n\n // Analyze each field in this variant\n for (const [fieldName, fieldSchema] of Object.entries(shape)) {\n const typedSchema = fieldSchema as z.ZodTypeAny;\n\n // Check for virtual fields with context needs\n if (isVirtualField(typedSchema)) {\n if (virtualFieldNeedsObjectContext(typedSchema)) {\n needsObjectContext = true;\n }\n if (virtualFieldNeedsUserContext(typedSchema)) {\n needsUserContext = true;\n }\n }\n\n // Check for FK fields with isSummaryField({ populate: true })\n if (isForeignKeyField(typedSchema) && isSummaryField(typedSchema)) {\n const summaryParams = getSummaryFieldParams(typedSchema);\n if (summaryParams?.populate) {\n responsePopulationFields.add(fieldName);\n }\n }\n }\n }\n\n // Analyze operations for enabledCondition and basicPrefixOperation context needs\n if (resourceConfig.operations) {\n for (const operation of resourceConfig.operations) {\n const operationNeeds = analyzeOperationContextNeeds(operation as any);\n if (operationNeeds.needsObjectContext) {\n needsObjectContext = true;\n }\n if (operationNeeds.needsUserContext) {\n needsUserContext = true;\n }\n }\n }\n\n const result: ContextNeedsAnalysis = {\n needsObjectContext,\n needsUserContext,\n responsePopulationFields,\n };\n\n // Cache the result\n this.contextNeedsCache.set(resourceType, result);\n\n this.logDebug(`Analyzed context needs for ${resourceType}`, {\n needsObjectContext,\n needsUserContext,\n responsePopulationFieldsCount: responsePopulationFields.size,\n });\n\n return result;\n }\n\n /\n Fetch computation context for virtual fields.\n * This is TEMPORARY - only used for virtual computation, not returned in response.\n /\n async fetchComputationContext<T extends Record<string, any>>(\n resourceType: ResourceType,\n data: T,\n needs: ContextNeedsAnalysis,\n executionContext: ExecutionContext<any>,\n repositoryOptions?: RepositoryOptions,\n failureMode: ComputationContextFailureMode =\n ComputationContextFailureMode.FAULT_TOLERANT,\n ): Promise<ComputationContext> {\n const result: ComputationContext = {};\n\n // Fetch object context (parents + children) if needed\n if (needs.needsObjectContext) {\n try {\n // Extract resource ID from data\n const resourceId = data._id?.toString() \|\| data.id;\n if (!resourceId) {\n if (failureMode === ComputationContextFailureMode.PROPAGATE) {\n throw new Error(\n `Cannot fetch authoritative object context for ${resourceType}: missing resource ID`,\n );\n }\n this.logger.warn(`Cannot fetch object context for ${resourceType}: missing resource ID`);\n result.objectContext = { parents: {}, children: {} };\n } else {\n const resourceContext = await this.resourceContextService.buildContext(\n resourceType,\n resourceId,\n data,\n {\n parentDepth: 1,\n childDepth: 0,\n executionContext,\n repositoryOptions,\n failureMode:\n failureMode === ComputationContextFailureMode.PROPAGATE\n ? ResourceContextFailureMode.PROPAGATE\n : ResourceContextFailureMode.FAULT_TOLERANT,\n }\n );\n\n result.objectContext = {\n parents: resourceContext.parents,\n children: resourceContext.children,\n };\n }\n } catch (error) {\n if (failureMode === ComputationContextFailureMode.PROPAGATE) {\n throw error;\n }\n this.logger.warn(`Failed to fetch object context for ${resourceType}`, {\n ...projectCaughtErrorLogFields(error),\n });\n // Don't fail - virtual fields should be fault-tolerant\n result.objectContext = { parents: {}, children: {} };\n }\n }\n\n // Fetch user context if needed\n if (needs.needsUserContext) {\n // User context comes from execution context initiatorIds\n result.userContext = executionContext.initiatorIds \|\| undefined;\n }\n\n return result;\n }\n\n /\n Populate for SUMMARY mode.\n * Uses isSummaryField({ populate: true }) FKs.\n * Parents are fetched with THEIR summary fields.\n * Does NOT include computation-only context.\n /\n async populateForSummary<T extends Record<string, any>>(\n resourceType: ResourceType,\n data: T,\n executionContext: ExecutionContext<any>,\n options?: { populateFiles?: boolean },\n repositoryOptions?: RepositoryOptions\n ): Promise<T & Record<string, any>> {\n const needs = this.analyzeContextNeeds(resourceType);\n\n if (needs.responsePopulationFields.size === 0) {\n // No fields to populate\n return data;\n }\n\n const resourceConfig = this.resourcesRegistry.getResourceConfiguration(resourceType);\n if (!resourceConfig) {\n return data;\n }\n\n let result = { ...data } as T & Record<string, any>;\n\n // Populate each FK field that has isSummaryField({ populate: true })\n for (const fkField of needs.responsePopulationFields) {\n const fkValue = data[fkField];\n if (!fkValue) continue;\n\n // Determine the populated field name (todoListId -> todoList)\n const populatedFieldName = ResourcesConfigNamingUtils.extractBaseName(fkField);\n\n // Find the relationship for this FK (includes selfRelationships for tree-structured FKs)\n const relationship = this.findRelationshipForField(\n getParentDirectionRelationships(resourceConfig.resourceRelationships),\n fkField\n );\n\n if (!relationship) {\n this.logDebug(`No relationship found for FK field: ${fkField}`);\n continue;\n }\n\n // Fetch the parent resource with its summary fields\n const parentType = relationship.resourceType1 === resourceType\n ? relationship.resourceType2\n : relationship.resourceType1;\n\n // ETL D10 guard, site 1 of 2 (enumerated per invariant-call-site-enumeration): population\n // against an HTTP_API-backed parent is one REMOTE call per row, and this method's own catch\n // SWALLOWS failures — a rate-limited target would silently half-populate rows behind a warn\n // storm. Skipped BEFORE fetching, one legible log per (resourceType, field), never per id.\n if (this.skipHttpApiParentPopulation(parentType, resourceType as string, fkField)) {\n continue;\n }\n\n try {\n // Build relationship context to track how we're accessing the parent\n const relationshipContext: import('@wildo-ai/saas-models').ExecutionContext_RelationshipContext = {\n resourceType: resourceType as string, // Current resource type\n relationshipField: fkField, // FK field on current resource\n resourceId: data._id?.toString() \|\| data.id, // Current resource ID\n };\n\n // Create sub-call context with correct operation for parent READ\n const subContext = await this.executionContextCreator.createForSubCall(\n executionContext,\n parentType,\n CoreResourceOperation.READ,\n { dataMode: DataMode.SUMMARY },\n fkValue,\n relationshipContext\n );\n\n // Use service layer to read parent with SUMMARY mode\n // This ensures parents get full service processing (virtual fields, summary extraction, etc.)\n // in SUMMARY mode, matching the behavior described in the class documentation\n const parentData = await this.getServicesRegistry().read(\n parentType,\n subContext,\n fkValue,\n { dataMode: DataMode.SUMMARY }\n );\n\n if (parentData) {\n (result as Record<string, any>)[populatedFieldName] = parentData;\n }\n } catch (error) {\n this.logger.warn(`Failed to populate ${populatedFieldName} for ${resourceType}`, {\n fkField,\n fkValue,\n ...projectCaughtErrorLogFields(error),\n });\n // Continue with other fields - don't fail the whole operation\n }\n }\n\n // Populate file fields after FK population\n const populateFiles = options?.populateFiles !== false; // default: true\n if (populateFiles) {\n const populatedWithFiles = await this.filePopulationService.populateFileFields(\n result,\n resourceType,\n executionContext,\n { populateFiles: true },\n repositoryOptions\n );\n result = populatedWithFiles as T & Record<string, any>;\n }\n\n return result;\n }\n\n /\n Populate for CONTEXT mode.\n * Uses contextPolicy from relationships.\n /\n async populateForContext<T extends Record<string, any>>(\n resourceType: ResourceType,\n data: T,\n executionContext: ExecutionContext<any>,\n options?: { populateFiles?: boolean },\n repositoryOptions?: RepositoryOptions\n ): Promise<T & Record<string, any>> {\n // Use ResourceContextBackendService for full context population\n try {\n // Extract resource ID from data\n const resourceId = data._id?.toString() \|\| data.id;\n if (!resourceId) {\n this.logger.warn(`Cannot populate context for ${resourceType}: missing resource ID`);\n return data;\n }\n\n // Pass operation to buildContext for proper contextPolicy resolution\n // The operation determines which operationOverrides apply (e.g., objectMode: FULL on READ)\n const operation = executionContext?.operation?.operationIdentifier as CoreResourceOperation \| undefined;\n\n this.logDebug(`[populateForContext] Starting for ${resourceType}:${resourceId}`, {\n operation,\n hasExecutionContext: !!executionContext,\n operationIdentifier: executionContext?.operation?.operationIdentifier,\n variantKey: executionContext?.operation?.variantKey,\n });\n\n const resourceContext = await this.resourceContextService.buildContext(\n resourceType,\n resourceId,\n data,\n { executionContext, operation }\n );\n\n this.logDebug(`[populateForContext] buildContext returned`, {\n resourceType,\n hasParents: !!resourceContext.parents,\n parentKeys: resourceContext.parents ? Object.keys(resourceContext.parents) : [],\n hasChildren: !!resourceContext.children,\n childKeys: resourceContext.children ? Object.keys(resourceContext.children) : [],\n childrenCounts: resourceContext.children\n ? Object.entries(resourceContext.children).map(([k, v]) => `${k}:${(v as any[]).length}`)\n : [],\n });\n\n let result = { ...data } as T & Record<string, any>;\n\n // Merge parents into result\n // Parents are ResourceContextItem[] - extract .data from each\n // For parents, typically there's one item (1:1 relationship), so we extract the first item's data\n //\n // ⚠️ ENUMERATED AND DELIBERATELY NOT CHANGED (2026-09-10, issue #563). This branch has the\n // SAME name-derivation defect the child branch below just lost: it keys on `resourceType1`\n // while the context DTO declares the FK-derived name (`users` vs `user`, `organizations` vs\n // `organization`, `user_self` vs `user`). Measured over the core registry it mismatches on\n // 37 of 37* context-enabled parent relationships — so no parent object has ever survived\n // the response parse, on any resource.\n //\n // It is not fixed here because the rename is only half a fix and the other half is a DESIGN\n // decision rather than a rename: `addRelationshipPlaceholders` types a parent placeholder as\n // `z.object({ _id: z.string() }).optional()`, so a correctly-named parent would still arrive\n // as a bare `{_id}` whatever SUMMARY/FULL `objectMode` its contextPolicy asked for. Landing\n // the rename alone would add 37 near-empty objects to context responses in every generated\n // application and satisfy no requirement #563 states. Filed with the measurement instead, so\n // the next reader inherits the count rather than re-deriving it.\n if (resourceContext.parents) {\n for (const [key, items] of Object.entries(resourceContext.parents)) {\n if (Array.isArray(items) && items.length > 0) {\n // For parent relationships (typically 1:1), use the first item's data directly\n // If there are multiple parents of the same type (unusual), take the first\n (result as Record<string, any>)[key] = items[0]?.data;\n }\n }\n }\n\n // Merge children into result.\n //\n // The field name is NOT derived here. It comes from\n // `Resources_SharedUtils.resolveRelationshipObjectIdentity` — the SAME authority\n // `ResourcesConfigOperations_DtosBuilderUtils.addRelationshipPlaceholders` uses to declare\n // the context placeholder on `contextDto` / `internalDto`. That is the whole point of the\n // call: a populated field survives only if the DTO declares a field of exactly that name,\n // because BOTH the service-layer `internalDto.parse` (`transformOutput`) and the controller's\n // response serializer strip anything the schema does not name.\n //\n // ⚠️ This used to derive the name independently — `singularize(resourceType2)` for 1:1,\n // `resourceType2` verbatim for 1:many — on the stated grounds that the two derivations were\n // \"structurally equivalent\". They are not. The DTO derives from the related resource's\n // `resourceFieldIdentifier`, whose stem is authored and need not be the singular of the\n // resource type: `USER_SELF_PREFERENCES` carries `userSelfPreferencesId` → the DTO declares\n // `userSelfPreferences` while this site produced `userSelfPreference`. Measured over the core\n // registry (2026-09-10): of its 111 relationships, 37 carry an enabled `contextPolicy`, and\n // the two derivations disagreed on 11 of those 37. EVERY one of those 11 fields was populated\n // by this service and then silently Zod-stripped before it left the process — no error, no\n // log, on any surface. That is what made every date in every generated application render at\n // the i18n floor: the member's regional preferences never reached the client (issue #563).\n //\n // Deriving from one authority makes the class unrepresentable rather than merely fixed.\n // Pinned by `resource-population.context-field-name.test.ts` (this site emits the authority's\n // name, asserted as a LITERAL — recomputing the expectation with the same function the code\n // uses would pass whichever derivation either side chose) and by `saas-models`'s\n // `context-projection-field-name-agreement.test.ts` (the generated context DTO declares that\n // name and strips the retired one).\n if (resourceContext.children) {\n for (const [key, items] of Object.entries(resourceContext.children)) {\n this.logDebug(`[populateForContext] Processing child key=${key}, itemsCount=${items?.length \|\| 0}`);\n\n const childRelationship = this.findContextChildRelationship(resourceType, key);\n const contextFieldKey = this.resolveContextChildFieldName(childRelationship, key);\n\n if (Array.isArray(items) && items.length > 0) {\n // Check cardinality from the first item to determine if 1:1 or 1:many\n const cardinality = items[0]?.cardinality;\n const isOneToOne = cardinality === ResourceRelationshipCardinality.ONE \|\|\n cardinality === ResourceRelationshipCardinality.ZERO_OR_ONE;\n\n const fieldKey = contextFieldKey;\n\n this.logDebug(`[populateForContext] Child ${key}: cardinality=${cardinality}, isOneToOne=${isOneToOne}, fieldKey=${fieldKey}`);\n\n if (isOneToOne) {\n // 1:1 relationship: return single object under the DTO's declared field name\n (result as Record<string, any>)[fieldKey] = items[0]?.data;\n } else {\n // 1:many relationship: return array under the DTO's declared field name\n (result as Record<string, any>)[fieldKey] = items.map(item => item?.data).filter(Boolean);\n }\n } else if (Array.isArray(items)) {\n // Empty result. Cardinality CANNOT be read from items (there are none),\n // so resolve it from the relationship config. A 1:1 child with no row\n // must be OMITTED: the contextDto types a 1:1 embed as an OPTIONAL single\n // `z.record` (see `addRelationshipPlaceholders`), so writing `[]` fails\n // output validation with \"expected record, received array\" — the exact\n // crash for a freshly-created user whose 1:1 `userSelfPreferences` row does\n // not exist yet. A 1:many child stays an empty array (its contextDto\n // placeholder is `z.array(...).optional()`, and consumers expect an array,\n // not an absent field). If the relationship can't be resolved, fall back to\n // the historical `[]` behaviour.\n const emptyIsOneToOne = childRelationship\n ? isOneToOneCardinality(childRelationship.cardinality2)\n : false;\n this.logDebug(`[populateForContext] Child ${key}: empty items array (isOneToOne=${emptyIsOneToOne})`);\n if (!emptyIsOneToOne) {\n (result as Record<string, any>)[contextFieldKey] = [];\n }\n // 1:1 with no row → leave the field absent (optional single record in contextDto)\n }\n }\n }\n\n // Populate file fields after context population\n const populateFiles = options?.populateFiles !== false; // default: true\n if (populateFiles) {\n const populatedWithFiles = await this.filePopulationService.populateFileFields(\n result,\n resourceType,\n executionContext,\n { populateFiles: true },\n repositoryOptions\n );\n result = populatedWithFiles as T & Record<string, any>;\n }\n\n return result;\n } catch (error) {\n this.logger.warn(`Failed to populate context for ${resourceType}`, {\n ...projectCaughtErrorLogFields(error),\n });\n return data;\n }\n }\n\n /*\n Batch populate for lists (SUMMARY mode).\n * Optimized: Collects unique FK values, batch fetches parents, then distributes to items.\n /\n async populateListForSummary<T extends Record<string, any>>(\n resourceType: ResourceType,\n items: T[],\n executionContext: ExecutionContext<any>,\n options?: { populateFiles?: boolean },\n repositoryOptions?: RepositoryOptions\n ): Promise<T[]> {\n const needs = this.analyzeContextNeeds(resourceType);\n\n if (needs.responsePopulationFields.size === 0 \|\| items.length === 0) {\n return items;\n }\n\n const resourceConfig = this.resourcesRegistry.getResourceConfiguration(resourceType);\n if (!resourceConfig) {\n return items;\n }\n\n // Step 1: Collect unique FK values per field\n const fkValuesByField = new Map<string, Set<string>>();\n for (const field of needs.responsePopulationFields) {\n fkValuesByField.set(field, new Set());\n }\n\n for (const item of items) {\n for (const field of needs.responsePopulationFields) {\n const value = item[field];\n if (value) {\n const id = typeof value === 'string' ? value : (value._id?.toString() \|\| value.id?.toString() \|\| String(value));\n if (id) {\n fkValuesByField.get(field)!.add(id);\n }\n }\n }\n }\n\n // Step 2: Batch fetch all parents, grouped by field\n const fetchedParentsByField = new Map<string, Map<string, any>>();\n\n for (const [field, fkValues] of fkValuesByField.entries()) {\n if (fkValues.size === 0) continue;\n\n // Find the relationship for this FK (includes selfRelationships for tree-structured FKs)\n const relationship = this.findRelationshipForField(\n getParentDirectionRelationships(resourceConfig.resourceRelationships),\n field\n );\n\n if (!relationship) {\n this.logDebug(`No relationship found for FK field: ${field}`);\n continue;\n }\n\n // Determine parent resource type\n const parentType = relationship.resourceType1 === resourceType\n ? relationship.resourceType2\n : relationship.resourceType1;\n\n // ETL D10 guard, site 2 of 2: the list path fans out one PARALLEL remote read per unique\n // parent id, unbounded — the exact N+1-against-a-remote-API shape the decision forbids.\n if (this.skipHttpApiParentPopulation(parentType, resourceType as string, field)) {\n continue;\n }\n\n try {\n // Batch fetch all parents using parallel individual reads via service layer\n // Using service layer ensures parents get full service processing (virtual fields, summary extraction, etc.)\n // in SUMMARY mode, matching the behavior described in the class documentation\n const parentIds = Array.from(fkValues);\n const parentsMap = new Map<string, any>();\n\n // Use Promise.all for parallel individual reads\n await Promise.all(\n parentIds.map(async (id) => {\n try {\n // Build relationship context (we don't have specific item ID here, using field info)\n const relationshipContext: import('@wildo-ai/saas-models').ExecutionContext_RelationshipContext = {\n resourceType: resourceType as string, // Current resource type\n relationshipField: field, // FK field on current resource\n resourceId: id, // Parent ID being fetched\n };\n\n // Create sub-call context with correct operation for parent READ\n const subContext = await this.executionContextCreator.createForSubCall(\n executionContext,\n parentType,\n CoreResourceOperation.READ,\n { dataMode: DataMode.SUMMARY },\n id,\n relationshipContext\n );\n\n const parent = await this.getServicesRegistry().read(\n parentType,\n subContext,\n id,\n { dataMode: DataMode.SUMMARY }\n );\n if (parent) {\n const parentRecord = parent as Record<string, any>;\n const parentId = parentRecord._id?.toString() \|\| parentRecord.id?.toString() \|\| id;\n parentsMap.set(parentId, parent);\n }\n } catch (error) {\n // Skip failed reads - don't fail entire operation\n this.logDebug(`Failed to read parent ${parentType}:${id}`, {\n error: describeCaughtError(error)\n });\n }\n })\n );\n\n fetchedParentsByField.set(field, parentsMap);\n } catch (error) {\n this.logger.warn(`Failed to batch fetch parents for field ${field}`, {\n parentType,\n ...projectCaughtErrorLogFields(error),\n });\n // Continue with other fields\n }\n }\n\n // Step 3: Distribute fetched parents to items\n const results: (T & Record<string, any>)[] = [];\n for (const item of items) {\n const result = { ...item } as T & Record<string, any>;\n\n for (const field of needs.responsePopulationFields) {\n const fkValue = item[field];\n if (!fkValue) continue;\n\n const fkId = typeof fkValue === 'string' ? fkValue : (fkValue._id?.toString() \|\| fkValue.id?.toString() \|\| String(fkValue));\n const parentsMap = fetchedParentsByField.get(field);\n\n if (parentsMap && fkId) {\n const parent = parentsMap.get(fkId);\n if (parent) {\n const populatedFieldName = ResourcesConfigNamingUtils.extractBaseName(field);\n (result as Record<string, any>)[populatedFieldName] = parent;\n }\n }\n }\n\n results.push(result);\n }\n\n // Populate file fields after FK population\n const populateFiles = options?.populateFiles !== false; // default: true\n if (populateFiles) {\n const populatedWithFiles = await this.filePopulationService.populateFileFields(\n results,\n resourceType,\n executionContext,\n { populateFiles: true },\n repositoryOptions\n );\n return populatedWithFiles as T[];\n }\n\n return results;\n }\n\n /\n Batch populate for lists (CONTEXT mode).\n /\n async populateListForContext<T extends Record<string, any>>(\n resourceType: ResourceType,\n dataList: T[],\n executionContext: ExecutionContext<any>,\n options?: { populateFiles?: boolean },\n repositoryOptions?: RepositoryOptions\n ): Promise<(T & Record<string, any>)[]> {\n if (dataList.length === 0) {\n return dataList;\n }\n\n // TODO: Implement batch optimization\n\n // For now, populate each item individually (less optimal)\n const results: (T & Record<string, any>)[] = [];\n for (const item of dataList) {\n const populated = await this.populateForContext(resourceType, item, executionContext, options, repositoryOptions);\n results.push(populated);\n }\n\n // File population is already handled in populateForContext\n return results;\n }\n\n // =============================================================================\n // PRIVATE HELPERS\n // =============================================================================\n\n /\n Find the relationship that corresponds to a given FK field.\n * Uses the allResourceFieldIdentifiers map for lookup instead of string manipulation.\n /\n private findRelationshipForField(\n relationships: ResourceRelationship[],\n fkField: string\n ): ResourceRelationship \| undefined {\n const fieldIdentifiers = this.resourcesRegistry.getAllResourceFieldIdentifiers();\n\n return relationships.find(rel => {\n // Priority 1: Explicit foreignKeyField matches\n if (rel.foreignKeyField === fkField) {\n return true;\n }\n // Priority 2: Check if FK field matches the standard field identifier for the related resource type\n // For relationship A → B with B as resourceType2, the FK on A is B's field identifier\n const standardFieldIdentifier = fieldIdentifiers[rel.resourceType2];\n return standardFieldIdentifier === fkField;\n });\n }\n\n /\n The field name a CONTEXT projection publishes a child relationship under.\n \n Delegates to `Resources_SharedUtils.resolveRelationshipObjectIdentity` — the authority the DTO\n * builder uses when it declares the placeholder — so producer and contract cannot disagree. See\n * the long note at the child-merge site in {@link populateForContext} for what the two\n * independent derivations cost.\n \n The fallback is the historical local derivation, and it is reached only when the relationship\n * cannot be resolved from the registry at all (the same condition under which the empty-array\n * branch already falls back). Keeping it means an unresolvable relationship degrades exactly as\n * it did before rather than throwing inside a response path.\n /\n private resolveContextChildFieldName(\n relationship: ResourceRelationship \| undefined,\n childResourceType: string,\n ): string {\n if (relationship) {\n return Resources_SharedUtils.resolveRelationshipObjectIdentity(\n relationship,\n relationship.resourceType2,\n relationship.cardinality2,\n this.resourcesRegistry.getAllResourceFieldIdentifiers(),\n ).objectFieldName;\n }\n return childResourceType;\n }\n\n /\n Resolve the child-direction relationship a CONTEXT children key corresponds to.\n * The key is the child resource type (`resourceType2`) under which\n * `ResourceContextBackendService` groups fetched items. Used by\n * `populateForContext` both to name the published field (see\n * {@link resolveContextChildFieldName}) and to recover a relationship's cardinality when the\n * fetched item set is EMPTY — cardinality can't be read from a non-existent item, so an\n * absent 1:1 child would otherwise be mis-projected as `[]` and fail the\n * optional-single-`z.record` contextDto placeholder. Uses the same\n * `getChildDirectionRelationships` enumeration the DTO builder uses, keyed by\n * `resourceType2` (how the context service groups children).\n */\n private findContextChildRelationship(\n resourceType: ResourceType,\n childResourceType: string,\n ): ResourceRelationship \| undefined {\n const config = this.resourcesRegistry.tryGetResourceConfiguration(resourceType);\n if (!config?.resourceRelationships) {\n return undefined;\n }\n return getChildDirectionRelationships(config.resourceRelationships)\n .find(rel => rel.resourceType2 === childResourceType);\n }\n}\n"]}

package/dist/esm/resources/services/resources-registry.backend.service.d.ts CHANGED Viewed

@@ -10,6 +10,20 @@ export declare class ResourcesRegistryBackendService {
     protected logDebug: (message: string, context?: Record<string, unknown>) => void;
     protected registry: ResourcesRegistry | null;
     protected isInitialized: boolean;
+    /**
+     * The resource types this application DELIBERATELY excluded from the registry at
+     * initialization (today: billing-conditional resources when billing is disabled).
+     *
+     * Retained because "absent from the registry" has two completely different causes and a
+     * boot-time consumer must be able to tell them apart. A resource nobody ever declared is a
+     * typo or a drifted reference — permanently broken, worth refusing startup over. A resource
+     * that WAS declared and was then feature-excluded is a legitimate runtime configuration, and
+     * refusing over it would turn "billing is disabled" into "the application will not start".
+     *
+     * Populated even when empty so a caller never has to distinguish "no exclusions" from "not
+     * yet initialized" — {@link getExcludedResourceTypes} answers that with `ensureInitialized`.
+     */
+    protected excludedResourceTypes: ReadonlySet<string>;
     constructor(logger: LoggerService, configService: AppConfigurationService, errorBuilder: ErrorBuilderBackendService);
     /**
      * W5.1: Returns organizationTypes config when app config is initialized.
@@ -68,6 +82,15 @@ export declare class ResourcesRegistryBackendService {
      */
     validatePersistenceAdapterConfigurationForPlatform(): void;
     getResourceTypes(): ResourceType[];
+    /**
+     * The resource types this application deliberately excluded at initialization — the
+     * complement of {@link getResourceTypes} that a boot-time consumer needs in order to tell a
+     * legitimate feature-gated absence from a broken reference.
+     *
+     * Fails closed when the registry is not initialized: an empty set would read as "nothing was
+     * excluded" and let a caller draw a conclusion from a registry that has not been built.
+     */
+    getExcludedResourceTypes(): ReadonlySet<string>;
     /**
      * Re-run persistence-dependent registry invariants after application config
      * is initialized.
@@ -174,11 +197,36 @@ export declare class ResourcesRegistryBackendService {
      * Resolution is INTERNAL-preferred, then URL-bearing:
      *  1. If the operation declares an `INTERNAL_CALL` default, return it. This
      *     honours author intent for resources whose default for this operation
-     *     is internal-only (`userIdentityLinks.list`) AND for resources that
-     *     declare BOTH an internal and a URL default for the same operation
-     *     (`users.list`, `inboundContacts.update`) — the internal variant is the
-     *     one trusted callers must use; the URL variant is the public/admin
-     *     surface reached via its keyed/route path.
+     *     is internal-only (`userIdentityLinks.list`, `users.list`,
+     *     `inboundContacts.update`) AND for the one resource that declares BOTH
+     *     an internal and a URL default for the same operation — the internal
+     *     variant is the one trusted callers must use; the URL variant is the
+     *     public/admin surface reached via its keyed/route path.
+     *
+     *     **That "BOTH" population is exactly ONE operation: `organizations`
+     *     CREATE.** Measured 2026-09-08 over all 106 non-test
+     *     `*resources-config*.ts` files (653 variant blocks), replicating
+     *     `determineOperationVariantDefault` per variant-type group.
+     *
+     *     This paragraph previously cited `users.list` and `inboundContacts.update`
+     *     as further both-default examples and BOTH were wrong: the former's
+     *     `API_CALL` is `isDefault: false, variantKey: "admin"`, and the latter
+     *     declares no `API_CALL` at all — so neither has a URL-bearing DEFAULT and
+     *     neither is a case where this method chooses between transports. The
+     *     correction is recorded rather than silently applied because the false
+     *     plural made the preference look like a broad, well-trodden policy when it
+     *     decides exactly one operation — which is what made the agent function-tool
+     *     plane's blast radius read as unbounded when it was a single, and severe,
+     *     case (see `9594526e`).
+     *
+     *     ⚠️ **A caller that FACES AN EXTERNAL PRINCIPAL must not use this method.**
+     *     It answers "which variant does a TRUSTED internal caller want", and for
+     *     `organizations` CREATE that is the registration-owned path, which skips the
+     *     creation-policy guard and writes no founding owner. A surface that
+     *     advertises a public operation to an outside caller owes
+     *     {@link getOperationPathDefault} instead, so the operation it authorized and
+     *     advertised is the operation it executes — the invariant the MCP tool plane
+     *     and the agent function-tool factories both keep.
      *  2. Otherwise return the URL-bearing default (`API_CALL` /
      *     `API_CALL_WITH_CALLBACK`) for resources exposed only over HTTP.
      *  3. Otherwise throw `RESOURCES_REGISTRY_OPERATION_PATH_NOT_FOUND`.
@@ -348,6 +396,36 @@ export declare class ResourcesRegistryBackendService {
     protected normalizeResourceConfigurationRelationships(allResourceConfigurations: {
         [key: string]: AnyResourceConfiguration;
     }, allResourceFieldIdentifiers: Record<string, string>): void;
+    /**
+     * Refuse to start on an incoherent notification-badge declaration.
+     *
+     * ## What this catches, and why the runtime could not
+     *
+     * A badge write used to be addressed by a bare `identifier`, resolved against nothing. Two
+     * declarations were therefore unfalsifiable:
+     *
+     * - an operation naming a badge NO definition declares — the write materialized a counter row
+     *   that no definition described and no screen could render, silently, forever;
+     * - two definitions sharing one `(scope, identifier)` — every lookup answers the first, so the
+     *   second is unreachable while sharing the first's count.
+     *
+     * Neither produces an error at runtime. The write succeeds; the render finds nothing; nobody is
+     * told. So the check belongs where the DECLARATION is, not where the write is, and it fails
+     * CLOSED for the same reason the organization-unit narrowing containment above does: a
+     * misconfiguration that only manifests as a missing number is one nobody chases.
+     *
+     * **What a misconfigured application experiences:** the backend does not come up. Startup throws
+     * a `CONFIGURATION` error naming every violation — the resource and operation that declared the
+     * unresolvable ref, or the duplicated key — beside the keys that ARE registered, so the author
+     * reads the fix off the message rather than deriving it. A typo in a `badgeRef` is a refusal at
+     * the moment it is authored instead of a badge that never appears in production.
+     *
+     * The enumeration is TOTAL over both populations rather than sampled: every registered
+     * definition, and every `notificationBadgeOperations` entry on every operation of every resource
+     * configuration — which is the merged core + application map, so an engine-declared badge is
+     * checked on the same terms as an application-declared one.
+     */
+    protected validateNotificationBadgeDeclarations(notificationBadgeDefinitions: NotificationBadgeDefinition[], allResourceConfigurations: Record<string, AnyResourceConfiguration>): void;
     /**
      * Validate that all relationships can resolve their FK fields at startup.
      * This catches configuration errors early (e.g., missing resourceFieldIdentifier).

package/dist/esm/resources/services/resources-registry.backend.service.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"resources-registry.backend.service.d.ts","sourceRoot":"","sources":["~~../../../../../~~src/resources/services/resources-registry.backend.service.ts"],"names":[],"mappings":"AACA,OAAO,EACH,iBAAiB,EACjB,oBAAoB,EACpB,oBAAoB,EACpB,2BAA2B,~~EAE3B~~,0BAA0B,EAC1B,+BAA+B,EAC/B,mCAAmC,EACnC,wBAAwB,EACxB,8CAA8C,EAK9C,YAAY,EAgBZ,KAAK,oCAAoC,EAYzC,QAAQ,EAGX,MAAM,uBAAuB,CAAC;AAO/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sEAAsE,CAAC;AAcpH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AAE9G,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAG7B,qBACa,+BAA+B;~~IAOD~~,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,aAAa;IAC9B,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,uBAAuB;IACtD,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,0BAA0B;~~IAR~~/G,SAAS,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACjF,SAAS,CAAC,QAAQ,EAAE,iBAAiB,GAAG,IAAI,CAAQ;IAEpD,SAAS,CAAC,aAAa,UAAS;~~gBAG0B~~,MAAM,EAAE,aAAa,EACX,aAAa,EAAE,uBAAuB,EACnC,YAAY,EAAE,0BAA0B;IAQ/G;;;;OAIG;IACI,0BAA0B,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAMxE;;;OAGG;IACI,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS;IAMhE;;;;;;;;;OASG;IACI,uBAAuB,IAAI,oBAAoB,GAAG,SAAS;IAUrD,UAAU,CACnB,yBAAyB,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EACtE,0BAA0B,SAAS,YAAY,GAAG,SAAS,GAAG,SAAS,EAEvE,8CAA8C,EAAG,8CAA8C,CAAC,yBAAyB,CAAC,EAC1H,oCAAoC,EAAE;QAAE,CAAE,GAAG,EAAE,MAAM,GAAI,MAAM,CAAA;KAAE,GAAG,SAAS,EAC7E,mCAAmC,EAAE,oBAAoB,EAAE,EAC3D,+CAA+C,EAAG,8CAA8C,CAAC,0BAA0B,CAAC,EAC5H,qCAAqC,EAAE;QAAE,CAAE,GAAG,EAAE,MAAM,GAAI,MAAM,CAAA;KAAE,GAAG,SAAS,EAC9E,oCAAoC,EAAE,oBAAoB,EAAE,EAC5D,kCAAkC,CAAC,EAAE,2BAA2B,EAAE,EAClE,2CAA2C,CAAC,EAAE,0BAA0B,EAAE,EAC1E,qBAAqB,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC;IAC3C;;;;;;;;OAQG;IACH,+BAA+B,CAAC,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,oCAAoC,CAAC,CAAC,CAAC,GAC1G,OAAO,CAAC,IAAI,CAAC;~~IAgTT~~,oBAAoB,IAAI,iBAAiB;IAKhD;;;;;;;;;;;;;;;;OAgBG;IACI,kDAAkD,IAAI,IAAI;IAQ1D,gBAAgB,IAAI,YAAY,EAAE;IAKzC;;;;;;;;;;OAUG;IACI,kDAAkD,IAAI,IAAI;IAejE;;;;;OAKG;IACI,8BAA8B,IAAI,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC;IAKrE;;;;;;;;;;;OAWG;IACI,sBAAsB,CAAC,YAAY,EAAE;QAAE,aAAa,EAAE,YAAY,CAAC;QAAC,aAAa,CAAC,EAAE,YAAY,CAAC;QAAC,eAAe,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM;IA4B5I;;;;;OAKG;IACI,gCAAgC,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;IAKvE;;;;;OAKG;IACI,sCAAsC,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAKxF;;;;;;;;;;;;;;;;;OAiBG;IACI,uBAAuB,CAAC,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,GAAG,mCAAmC,CAAC,GAAG,EAAE,GAAG,CAAC;IAoDtI;;;;;;;;;;;;;;;;;;;;OAoBG;IACI,uBAAuB,CAAC,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,GAAG,OAAO;IAahG~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAqCG~~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"}
1	+ {"version":3,"file":"resources-registry.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/resources/services/resources-registry.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/resources/services/resources-registry.backend.service.js CHANGED Viewed

@@ -11,7 +11,7 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 import { injectable, inject } from 'inversify';
-import { coreNotificationBadgeDefinitions, coreShared_ResourcesConfigurations_FactoryMap, coreResourceShared_FieldIdentifier, coreResourceShared_FieldIdentifierPriority, coreSharedResourceRelationship, ResourcesConfigOperationsUrlsBuilderUtils, ResourcesConfigOperationsDtosBuilderUtils, ResourcesConfig_OperationPathUtils, ResourceOperationVariantType, isDefaultUrlBearingOperation, isServiceResolvableDefaultOperation, SERVICE_NATIVE_OPERATION_VARIANT_TYPES, URL_BEARING_OPERATION_VARIANT_TYPES, findSharedPersistenceCollectionRetentionIncoherences, findSharedPersistenceCollectionAdapterIncoherences, ErrorType, ErrorCustomMessageReference, ENGINE_ORGANIZATION_UNIT_NARROWING, collectOrganizationUnitNarrowingViolations, mergeOrganizationUnitNarrowingDeclarations, DEFAULT_PERSISTENCE_ADAPTER, CoreResourceOperation, ResourceParentResourceRequirement, reconcileGeneratedRelationshipBulkOperations, Resources_SharedUtils, isPersistenceAdapter, selectByPersistenceAdapter, dataModeToVariantKey, findDuplicateRelationshipRegistrations, } from '@wildo-ai/saas-models';
+import { coreNotificationBadgeDefinitions, collectNotificationBadgeDeclarationViolations, notificationBadgeIdentityKey, coreShared_ResourcesConfigurations_FactoryMap, coreResourceShared_FieldIdentifier, coreResourceShared_FieldIdentifierPriority, coreSharedResourceRelationship, ResourcesConfigOperationsUrlsBuilderUtils, ResourcesConfigOperationsDtosBuilderUtils, ResourcesConfig_OperationPathUtils, ResourceOperationVariantType, isDefaultUrlBearingOperation, isServiceResolvableDefaultOperation, SERVICE_NATIVE_OPERATION_VARIANT_TYPES, URL_BEARING_OPERATION_VARIANT_TYPES, findSharedPersistenceCollectionRetentionIncoherences, findSharedPersistenceCollectionAdapterIncoherences, ErrorType, ErrorCustomMessageReference, ENGINE_ORGANIZATION_UNIT_NARROWING, collectOrganizationUnitNarrowingViolations, mergeOrganizationUnitNarrowingDeclarations, DEFAULT_PERSISTENCE_ADAPTER, CoreResourceOperation, ResourceParentResourceRequirement, reconcileGeneratedRelationshipBulkOperations, Resources_SharedUtils, isPersistenceAdapter, selectByPersistenceAdapter, dataModeToVariantKey, findDuplicateRelationshipRegistrations, } from '@wildo-ai/saas-models';
 import { backendResourcesConfigurationsFactoryMap } from '../../resources/models/resources-operations.backend.definitions.js';
 import { backendResourcesRelationships } from '../../resources/models/resources-relationships.backend.definitions.js';
 import { BackendResourceFieldIdentifier } from '../../resources/models/resources-types.backend.schemas.js';
@@ -29,6 +29,20 @@ let ResourcesRegistryBackendService = class ResourcesRegistryBackendService {
     logDebug;
     registry = null;
     isInitialized = false;
+    /**
+     * The resource types this application DELIBERATELY excluded from the registry at
+     * initialization (today: billing-conditional resources when billing is disabled).
+     *
+     * Retained because "absent from the registry" has two completely different causes and a
+     * boot-time consumer must be able to tell them apart. A resource nobody ever declared is a
+     * typo or a drifted reference — permanently broken, worth refusing startup over. A resource
+     * that WAS declared and was then feature-excluded is a legitimate runtime configuration, and
+     * refusing over it would turn "billing is disabled" into "the application will not start".
+     *
+     * Populated even when empty so a caller never has to distinguish "no exclusions" from "not
+     * yet initialized" — {@link getExcludedResourceTypes} answers that with `ensureInitialized`.
+     */
+    excludedResourceTypes = new Set();
     constructor(logger, configService, errorBuilder) {
         this.logger = logger;
         this.configService = configService;
@@ -223,6 +237,11 @@ let ResourcesRegistryBackendService = class ResourcesRegistryBackendService {
         // Generic mechanism: remove excluded resource types from all 3 layers
         // (configurations, relationships, field identifiers).
         // Used for billing-conditional resources when billing is disabled.
+        //
+        // Recorded on the service BEFORE the filtering below, and unconditionally, so a later
+        // boot-time consumer can distinguish a deliberately-excluded resource from one that was
+        // never declared at all. See the `excludedResourceTypes` field.
+        this.excludedResourceTypes = new Set(excludedResourceTypes ?? []);
         if (excludedResourceTypes && excludedResourceTypes.size > 0) {
             this.logDebug(`Excluding ${excludedResourceTypes.size} resource types from registry`, {
                 excludedTypes: [...excludedResourceTypes],
@@ -288,6 +307,9 @@ let ResourcesRegistryBackendService = class ResourcesRegistryBackendService {
             // repositories (which apply) — so they cannot disagree about which resources are narrowed.
             organizationUnitNarrowing,
         };
+        // Validate that every badge declaration is coherent, and refuse to start otherwise.
+        this.logDebug('Validating notification badge declarations');
+        this.validateNotificationBadgeDeclarations(this.registry.notificationBadgeDefinitions, allResourceConfigurations);
         // Validate all relationships can resolve FK fields
         this.logDebug('Validating relationship FK field resolution');
         this.validateRelationshipForeignKeyFields(allResourceRelationships, allResourceFieldIdentifiers);
@@ -347,6 +369,18 @@ let ResourcesRegistryBackendService = class ResourcesRegistryBackendService {
         this.ensureInitialized();
         return Object.keys(this.registry.resourceConfigurations);
     }
+    /**
+     * The resource types this application deliberately excluded at initialization — the
+     * complement of {@link getResourceTypes} that a boot-time consumer needs in order to tell a
+     * legitimate feature-gated absence from a broken reference.
+     *
+     * Fails closed when the registry is not initialized: an empty set would read as "nothing was
+     * excluded" and let a caller draw a conclusion from a registry that has not been built.
+     */
+    getExcludedResourceTypes() {
+        this.ensureInitialized();
+        return this.excludedResourceTypes;
+    }
     /**
      * Re-run persistence-dependent registry invariants after application config
      * is initialized.
@@ -534,11 +568,36 @@ let ResourcesRegistryBackendService = class ResourcesRegistryBackendService {
      * Resolution is INTERNAL-preferred, then URL-bearing:
      *  1. If the operation declares an `INTERNAL_CALL` default, return it. This
      *     honours author intent for resources whose default for this operation
-     *     is internal-only (`userIdentityLinks.list`) AND for resources that
-     *     declare BOTH an internal and a URL default for the same operation
-     *     (`users.list`, `inboundContacts.update`) — the internal variant is the
-     *     one trusted callers must use; the URL variant is the public/admin
-     *     surface reached via its keyed/route path.
+     *     is internal-only (`userIdentityLinks.list`, `users.list`,
+     *     `inboundContacts.update`) AND for the one resource that declares BOTH
+     *     an internal and a URL default for the same operation — the internal
+     *     variant is the one trusted callers must use; the URL variant is the
+     *     public/admin surface reached via its keyed/route path.
+     *
+     *     **That "BOTH" population is exactly ONE operation: `organizations`
+     *     CREATE.** Measured 2026-09-08 over all 106 non-test
+     *     `*resources-config*.ts` files (653 variant blocks), replicating
+     *     `determineOperationVariantDefault` per variant-type group.
+     *
+     *     This paragraph previously cited `users.list` and `inboundContacts.update`
+     *     as further both-default examples and BOTH were wrong: the former's
+     *     `API_CALL` is `isDefault: false, variantKey: "admin"`, and the latter
+     *     declares no `API_CALL` at all — so neither has a URL-bearing DEFAULT and
+     *     neither is a case where this method chooses between transports. The
+     *     correction is recorded rather than silently applied because the false
+     *     plural made the preference look like a broad, well-trodden policy when it
+     *     decides exactly one operation — which is what made the agent function-tool
+     *     plane's blast radius read as unbounded when it was a single, and severe,
+     *     case (see `9594526e`).
+     *
+     *     ⚠️ **A caller that FACES AN EXTERNAL PRINCIPAL must not use this method.**
+     *     It answers "which variant does a TRUSTED internal caller want", and for
+     *     `organizations` CREATE that is the registration-owned path, which skips the
+     *     creation-policy guard and writes no founding owner. A surface that
+     *     advertises a public operation to an outside caller owes
+     *     {@link getOperationPathDefault} instead, so the operation it authorized and
+     *     advertised is the operation it executes — the invariant the MCP tool plane
+     *     and the agent function-tool factories both keep.
      *  2. Otherwise return the URL-bearing default (`API_CALL` /
      *     `API_CALL_WITH_CALLBACK`) for resources exposed only over HTTP.
      *  3. Otherwise throw `RESOURCES_REGISTRY_OPERATION_PATH_NOT_FOUND`.
@@ -1032,6 +1091,62 @@ let ResourcesRegistryBackendService = class ResourcesRegistryBackendService {
             };
         }
     }
+    /**
+     * Refuse to start on an incoherent notification-badge declaration.
+     *
+     * ## What this catches, and why the runtime could not
+     *
+     * A badge write used to be addressed by a bare `identifier`, resolved against nothing. Two
+     * declarations were therefore unfalsifiable:
+     *
+     * - an operation naming a badge NO definition declares — the write materialized a counter row
+     *   that no definition described and no screen could render, silently, forever;
+     * - two definitions sharing one `(scope, identifier)` — every lookup answers the first, so the
+     *   second is unreachable while sharing the first's count.
+     *
+     * Neither produces an error at runtime. The write succeeds; the render finds nothing; nobody is
+     * told. So the check belongs where the DECLARATION is, not where the write is, and it fails
+     * CLOSED for the same reason the organization-unit narrowing containment above does: a
+     * misconfiguration that only manifests as a missing number is one nobody chases.
+     *
+     * **What a misconfigured application experiences:** the backend does not come up. Startup throws
+     * a `CONFIGURATION` error naming every violation — the resource and operation that declared the
+     * unresolvable ref, or the duplicated key — beside the keys that ARE registered, so the author
+     * reads the fix off the message rather than deriving it. A typo in a `badgeRef` is a refusal at
+     * the moment it is authored instead of a badge that never appears in production.
+     *
+     * The enumeration is TOTAL over both populations rather than sampled: every registered
+     * definition, and every `notificationBadgeOperations` entry on every operation of every resource
+     * configuration — which is the merged core + application map, so an engine-declared badge is
+     * checked on the same terms as an application-declared one.
+     */
+    validateNotificationBadgeDeclarations(notificationBadgeDefinitions, allResourceConfigurations) {
+        const operationSites = [];
+        for (const [resourceType, resourceConfiguration] of Object.entries(allResourceConfigurations)) {
+            const operations = resourceConfiguration?.operations ?? {};
+            for (const [operationIdentifier, operation] of Object.entries(operations)) {
+                const badgeOperations = operation?.notificationBadgeOperations ?? [];
+                for (const badgeOperation of badgeOperations) {
+                    operationSites.push({ resourceType, operationIdentifier, badgeRef: badgeOperation.badgeRef });
+                }
+            }
+        }
+        const violations = collectNotificationBadgeDeclarationViolations(notificationBadgeDefinitions, operationSites);
+        if (violations.length > 0) {
+            this.logger.error('Notification badge declaration validation failed', { violations });
+            throw this.errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
+                customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
+                context: {
+                    message: 'Notification badge declarations are incoherent',
+                    reason: 'notification_badge_declaration_violation',
+                    violations,
+                    registeredBadgeKeys: notificationBadgeDefinitions.map(notificationBadgeIdentityKey),
+                },
+            });
+        }
+        this.logDebug(`Validated ${notificationBadgeDefinitions.length} notification badge definition(s) `
+            + `and ${operationSites.length} operation badge reference(s)`);
+    }
     /**
      * Validate that all relationships can resolve their FK fields at startup.
      * This catches configuration errors early (e.g., missing resourceFieldIdentifier).