@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/base-classes/services/services/services-registry-handler.backend.service.d.ts

@@ -0,0 +1,593 @@
+import 'reflect-metadata';
+import type { ResourceConfiguration_Operation, ResourceConfiguration_OperationPath } from '@wildo-ai/saas-models';
+import { ResourceType, CoreResourceOperation, DataMode, ResourceConfiguration_OperationVariant_CustomImplementation_FunctionParameters, type ResourceRelationshipBulkActionRequest, type ResourceRelationshipBulkActionResult } from '@wildo-ai/saas-models';
+import { EnumLikeType } from '@wildo-ai/zod-decorators';
+import { ExecutionContext } from '../../../runtime/models/execution-context.backend.schemas.js';
+import { RepositoriesRegistryHandlerBackendService } from '../../../base-classes/services/repositories/repositories-registry-handler.backend.service.js';
+import { ResourceOperationHelperBackendService } from '../../../base-classes/services/resource-operations-helper.backend.service.js';
+import { RepositoryOptions, ServiceOptions, IdOrIdsOrFilterType } from '../../../base-classes/models/repositories.backend.schemas.js';
+import { Resources_PaginationRequest, Resources_PaginatedResult } from '@wildo-ai/saas-models';
+import { LoggerService } from '../../../monitoring/logger/services/logger.service.js';
+import { ErrorBuilderBackendService } from '../../../errors/services/error-builder.backend.service.js';
+import { z } from 'zod';
+import { PlatformMutualizedHandlerBackendService } from '../../../requests/service/platform-mutualized-handler.backend.service.js';
+import { ResourcesRegistryBackendService } from '../../../resources/services/resources-registry.backend.service.js';
+import { ExternalApiHandlerBackendService } from '../../../external-providers/services/external-api-handler.backend.service.js';
+import { ResourceOperationCustomImplementationRegistryBackendService } from './resource-operation-custom-implementation-registry.backend.service.js';
+import { ServerlessServicesHandlerBackendService } from '../../../requests/service/serverless-services-handler.backend.service.js';
+import { NotificationDispatcherService } from '../../../notifications/services/notifications-dispatcher.backend.service.js';
+import { ResourcePopulationBackendService } from '../../../resources/services/resource-population.backend.service.js';
+import { VirtualFieldsBackendService } from '../../../resources/services/virtual-fields.backend.service.js';
+import { MongoDBService } from '../../../databases/services/mongodb.service.js';
+import { PostgreSQLDatabaseBackendService } from '../../../databases/services/postgresql-database.backend.service.js';
+import { FilterQuery } from 'mongoose';
+import { FileOperationHandlerBackendService } from '../../../files/services/file-operation-handler.backend.service.js';
+import { FileFieldDetectionBackendService } from '../../../files/services/file-field-detection.backend.service.js';
+import { ExecutionContextCreatorBackendService } from '../../../runtime/services/execution-context-creator.backend.service.js';
+import { QueueBackendService } from '../../../queue/queue.backend.service.js';
+import { FeatureGateBackendService } from '../../../features/services/feature-gate.backend.service.js';
+import { ConsumableTokenBackendService } from '../../../security/consumable-tokens/services/consumable-token.backend.service.js';
+import { AppConfigurationService } from '../../../config/services/app-configuration.backend.service.js';
+import type { TokenGenerationResult } from '../../../security/consumable-tokens/services/consumable-token.backend.service.js';
+import { GuidanceTriggerEvaluatorBackendService } from '../../../guidance/services/guidance-trigger-evaluator.backend.service.js';
+import { MilestoneEvaluatorBackendService } from '../../../guidance/services/milestone-evaluator.backend.service.js';
+import { LifecycleEvaluatorBackendService } from '../../../guidance/services/lifecycle-evaluator.backend.service.js';
+import type { SAMLMetadataBackendService } from '../../../security/authentications/services/auth-methods/saml-metadata.backend.service.js';
+interface PostOperationNotificationDispatcher {
+    dispatchResourceRoomNotifications<TResourceConfigOperation extends ResourceConfiguration_Operation<any, any, any>>(executionContext: ExecutionContext<TResourceConfigOperation>, functionParameters: ResourceConfiguration_OperationVariant_CustomImplementation_FunctionParameters): Promise<void>;
+    dispatchConfiguredNotifications<TResourceConfigOperation extends ResourceConfiguration_Operation<any, any, any>>(executionContext: ExecutionContext<TResourceConfigOperation>, functionParameters: ResourceConfiguration_OperationVariant_CustomImplementation_FunctionParameters): Promise<void>;
+}
+interface PostOperationNotificationDispatchDeps {
+    notificationDispatcher: PostOperationNotificationDispatcher;
+    populationService: Pick<ResourcePopulationBackendService, 'analyzeContextNeeds' | 'fetchComputationContext'>;
+    logger: Pick<LoggerService, 'error'>;
+    logDebug: (message: string, context?: Record<string, unknown>) => void;
+}
+export declare function dispatchPostOperationNotificationsBestEffort(deps: PostOperationNotificationDispatchDeps, executionContext: ExecutionContext<any>, inputData: any, currentResult: any, tokenGenerationResult?: TokenGenerationResult | null): Promise<void>;
+export declare class ServicesRegistryHandlerBackendService {
+    private readonly repositoriesRegistry;
+    private readonly logger;
+    private readonly errorBuilder;
+    private readonly resourcesRegistry;
+    private readonly repositoryHelper;
+    private readonly customImplRegistry;
+    private readonly externalApiHandler;
+    private readonly platformMutualizedHandler;
+    private readonly serverlessServicesHandler;
+    private readonly notificationDispatcher;
+    private readonly populationService;
+    private readonly virtualFieldsService;
+    private readonly mongoDBService;
+    private readonly fileOperationHandler;
+    private readonly fileFieldDetection;
+    private readonly executionContextCreator;
+    private readonly queueService;
+    private readonly featureGate;
+    private readonly consumableTokenService;
+    private readonly appConfigService;
+    private readonly guidanceTriggerEvaluator?;
+    private readonly milestoneEvaluator?;
+    private readonly lifecycleEvaluator?;
+    private readonly postgreSQLDatabaseService?;
+    private readonly samlMetadataService?;
+    private readonly services;
+    private readonly serviceOperationsMap;
+    private isInitialized;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    /**
+     * Post-operation hooks: fire after a successful mutation on a resource type.
+     * Key = resource type identifier, Value = array of hook callbacks.
+     */
+    private readonly postOperationHooks;
+    constructor(repositoriesRegistry: RepositoriesRegistryHandlerBackendService, logger: LoggerService, errorBuilder: ErrorBuilderBackendService, resourcesRegistry: ResourcesRegistryBackendService, repositoryHelper: ResourceOperationHelperBackendService, customImplRegistry: ResourceOperationCustomImplementationRegistryBackendService, externalApiHandler: ExternalApiHandlerBackendService, platformMutualizedHandler: PlatformMutualizedHandlerBackendService, serverlessServicesHandler: ServerlessServicesHandlerBackendService, notificationDispatcher: NotificationDispatcherService, populationService: ResourcePopulationBackendService, virtualFieldsService: VirtualFieldsBackendService, mongoDBService: MongoDBService, fileOperationHandler: FileOperationHandlerBackendService, fileFieldDetection: FileFieldDetectionBackendService, executionContextCreator: ExecutionContextCreatorBackendService, queueService: QueueBackendService, featureGate: FeatureGateBackendService, consumableTokenService: ConsumableTokenBackendService, appConfigService: AppConfigurationService, guidanceTriggerEvaluator?: GuidanceTriggerEvaluatorBackendService, milestoneEvaluator?: MilestoneEvaluatorBackendService, lifecycleEvaluator?: LifecycleEvaluatorBackendService, postgreSQLDatabaseService?: PostgreSQLDatabaseBackendService, samlMetadataService?: SAMLMetadataBackendService);
+    /** Exposes SAML metadata service for custom impl utils (DISCOVER_ENDPOINTS). */
+    getSamlMetadataService(): SAMLMetadataBackendService | undefined;
+    initializeServices(): Promise<void>;
+    private createService;
+    private buildOperationPathsMap;
+    getService<TCustomOperationEnum extends EnumLikeType | undefined = undefined, TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined = undefined, TMainSchema extends z.ZodTypeAny = z.ZodTypeAny>(resourceType: ResourceType): ServiceResourceBackendService<TCustomOperationEnum, TCoreOperationEnum, TMainSchema> | undefined;
+    getServiceOrThrow<TCustomOperationEnum extends EnumLikeType | undefined = undefined, TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined = undefined, TMainSchema extends z.ZodTypeAny = z.ZodTypeAny>(resourceType: ResourceType): ServiceResourceBackendService<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>;
+    doByOperationPath<T = any>(operationPath: ResourceConfiguration_OperationPath<any, any>, executionContext: ExecutionContext<any>, id_or_ids_or_filter?: IdOrIdsOrFilterType, data?: any, options?: RepositoryOptions): Promise<T>;
+    doByExecutionContext<T = any>(executionContext: ExecutionContext<any>, data?: any, options?: RepositoryOptions): Promise<T>;
+    create<T = any>(resourceType: ResourceType, executionContext: ExecutionContext<any>, data: any, options?: ServiceOptions): Promise<T>;
+    createMany<T = any>(resourceType: ResourceType, executionContext: ExecutionContext<any>, data: any[], options?: ServiceOptions): Promise<T[]>;
+    read<T = any>(resourceType: ResourceType, executionContext: ExecutionContext<any>, id_or_ids_or_filter: IdOrIdsOrFilterType, options?: ServiceOptions): Promise<T | null>;
+    update<T = any>(resourceType: ResourceType, executionContext: ExecutionContext<any>, id_or_ids_or_filter: IdOrIdsOrFilterType, data: any, options?: ServiceOptions): Promise<T | null>;
+    updateMany<T = any>(resourceType: ResourceType, executionContext: ExecutionContext<any>, id_or_ids_or_filter: IdOrIdsOrFilterType, data: any, options?: ServiceOptions): Promise<T[]>;
+    delete(resourceType: ResourceType, executionContext: ExecutionContext<any>, resourceId: string, options?: ServiceOptions): Promise<string>;
+    deleteMany(resourceType: ResourceType, executionContext: ExecutionContext<any>, id_or_ids_or_filter: IdOrIdsOrFilterType, options?: ServiceOptions): Promise<string[]>;
+    /**
+     * Execute a custom operation on a resource through the full pipeline.
+     * Routes through the same operation pipeline as HTTP-triggered custom operations
+     * (Zod validation, RBAC, custom impl dispatch, post-operation hooks).
+     *
+     * @param resourceType - The resource type to execute the operation on
+     * @param customOperationIdentifier - The custom operation name (e.g., 'top_up', 'consume')
+     * @param executionContext - The execution context for RBAC and scoping
+     * @param id_or_ids_or_filter - The resource ID to target (most custom ops require this)
+     * @param data - The request payload for the custom operation
+     * @param options - Optional service options
+     */
+    executeCustomOperation<T = any>(resourceType: ResourceType, customOperationIdentifier: string, executionContext: ExecutionContext<any>, id_or_ids_or_filter?: IdOrIdsOrFilterType, data?: any, options?: ServiceOptions): Promise<T>;
+    /**
+     * Execute an explicit multi-target relationship action.
+     *
+     * This is the service-level implementation seam behind the planned operation
+     * split:
+     * - `UPDATE_MANY` stays a bulk patch of the main resource
+     * - explicit relationship actions (`set`, `clear`, `create`, `link`,
+     *   `unlink`) are applied to a named relationship from the current resource's
+     *   perspective
+     */
+    applyRelationshipActionMany(resourceType: ResourceType, executionContext: ExecutionContext<any>, id_or_ids_or_filter: IdOrIdsOrFilterType, request: ResourceRelationshipBulkActionRequest, options?: ServiceOptions): Promise<ResourceRelationshipBulkActionResult>;
+    /**
+     * Register a callback that fires after any successful mutation on a resource type.
+     * Hooks are fire-and-forget — errors are logged but do not fail the operation.
+     *
+     * @param resourceType - The resource type to observe
+     * @param callback - Invoked after CREATE, UPDATE, DELETE, or custom mutation succeeds
+     */
+    registerPostOperationHook(resourceType: string, callback: PostOperationHookCallback): void;
+    /**
+     * Dispatch post-operation hooks for a resource type.
+     * Called by ServiceResourceBackendService after successful operations.
+     * @internal
+     */
+    dispatchPostOperationHooks(resourceType: string, operationIdentifier: string, result: any, executionContext: ExecutionContext<any>): Promise<void>;
+    /**
+     * List resources with optional pagination.
+     * @param options.paginated - When true, returns { data: T[], pagination: {...} }. Default: false (returns T[])
+     * @param options.variantKey - Optional variant key (e.g., 'summary', 'context')
+     * @param options.dataMode - Optional data mode for population behavior
+     */
+    list<T = any>(resourceType: ResourceType, executionContext: ExecutionContext<any>, filter?: FilterQuery<any>, pagination?: Partial<Resources_PaginationRequest>, options?: ServiceOptions): Promise<T[] | Resources_PaginatedResult<T>>;
+    search<T = any>(resourceType: ResourceType, executionContext: ExecutionContext<any>, searchQuery: string, filter?: FilterQuery<any>, options?: ServiceOptions): Promise<Resources_PaginatedResult<T>>;
+    count(resourceType: ResourceType, executionContext: ExecutionContext<any>, filter?: FilterQuery<any>, options?: ServiceOptions): Promise<{
+        count: number;
+    }>;
+    getAvailableOperationPaths(): ResourceConfiguration_OperationPath<any, any>[];
+    hasService(resourceType: ResourceType): boolean;
+    getRegisteredResourceTypes(): ResourceType[];
+    getServiceCount(): number;
+    getDebugInfo(): {
+        serviceCount: number;
+        operationPathsCount: number;
+        resourceTypes: ResourceType[];
+        isInitialized: boolean;
+    };
+}
+/**
+ * Callback type for post-operation hooks.
+ * Fired after a successful mutation (CREATE/UPDATE/DELETE/custom) on a resource.
+ */
+export type PostOperationHookCallback = (resourceType: string, operationIdentifier: string, result: any, executionContext: ExecutionContext<any>) => Promise<void>;
+export declare class ServiceResourceBackendService<TCustomOperationEnum extends EnumLikeType | undefined = undefined, TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined = undefined, TMainSchema extends z.ZodTypeAny = z.ZodTypeAny> {
+    private readonly resourcesRegistry;
+    private readonly logger;
+    private readonly errorBuilder;
+    private readonly repositoryHelper;
+    private readonly customImplRegistry;
+    private readonly repositoriesRegistry;
+    private readonly servicesRegistry;
+    private readonly externalApiHandler;
+    private readonly platformMutualizedHandler;
+    private readonly serverlessServicesHandler;
+    private readonly notificationDispatcher;
+    private readonly populationService;
+    private readonly virtualFieldsService;
+    private readonly mongoDBService;
+    private readonly fileOperationHandler;
+    private readonly fileFieldDetection;
+    private readonly executionContextCreator;
+    private readonly queueService;
+    private readonly featureGate;
+    private readonly consumableTokenService;
+    private readonly appConfigService;
+    private readonly guidanceTriggerEvaluator?;
+    private readonly milestoneEvaluator?;
+    private readonly lifecycleEvaluator?;
+    private readonly postgreSQLDatabaseService?;
+    private readonly resourceConfiguration;
+    private readonly operationsMap;
+    protected logDebug: (message: string, context?: Record<string, unknown>) => void;
+    constructor(resourceType: ResourceType, resourcesRegistry: ResourcesRegistryBackendService, logger: LoggerService, errorBuilder: ErrorBuilderBackendService, repositoryHelper: ResourceOperationHelperBackendService, customImplRegistry: ResourceOperationCustomImplementationRegistryBackendService, repositoriesRegistry: RepositoriesRegistryHandlerBackendService, servicesRegistry: ServicesRegistryHandlerBackendService, externalApiHandler: ExternalApiHandlerBackendService, platformMutualizedHandler: PlatformMutualizedHandlerBackendService, serverlessServicesHandler: ServerlessServicesHandlerBackendService, notificationDispatcher: NotificationDispatcherService, populationService: ResourcePopulationBackendService, virtualFieldsService: VirtualFieldsBackendService, mongoDBService: MongoDBService, fileOperationHandler: FileOperationHandlerBackendService, fileFieldDetection: FileFieldDetectionBackendService, executionContextCreator: ExecutionContextCreatorBackendService, queueService: QueueBackendService, featureGate: FeatureGateBackendService, consumableTokenService: ConsumableTokenBackendService, appConfigService: AppConfigurationService, guidanceTriggerEvaluator?: GuidanceTriggerEvaluatorBackendService, milestoneEvaluator?: MilestoneEvaluatorBackendService, lifecycleEvaluator?: LifecycleEvaluatorBackendService, postgreSQLDatabaseService?: PostgreSQLDatabaseBackendService);
+    static createInstance<TCustomOperationEnum extends EnumLikeType | undefined = undefined, TCoreOperationEnum extends Partial<CoreResourceOperation> | undefined = undefined, TMainSchema extends z.ZodTypeAny = z.ZodTypeAny>(resourceType: ResourceType, logger: LoggerService, errorBuilder: ErrorBuilderBackendService, repositoriesRegistry: RepositoriesRegistryHandlerBackendService, servicesRegistry: ServicesRegistryHandlerBackendService, resourcesRegistry: ResourcesRegistryBackendService, repositoryHelper: ResourceOperationHelperBackendService, customImplRegistry: ResourceOperationCustomImplementationRegistryBackendService, externalApiHandler: ExternalApiHandlerBackendService, platformMutualizedHandler: PlatformMutualizedHandlerBackendService, serverlessServicesHandler: ServerlessServicesHandlerBackendService, notificationDispatcher: NotificationDispatcherService, populationService: ResourcePopulationBackendService, virtualFieldsService: VirtualFieldsBackendService, mongoDBService: MongoDBService, fileOperationHandler: FileOperationHandlerBackendService, fileFieldDetection: FileFieldDetectionBackendService, executionContextCreator: ExecutionContextCreatorBackendService, queueService: QueueBackendService, featureGate: FeatureGateBackendService, consumableTokenService: ConsumableTokenBackendService, appConfigService: AppConfigurationService, guidanceTriggerEvaluator?: GuidanceTriggerEvaluatorBackendService, milestoneEvaluator?: MilestoneEvaluatorBackendService, lifecycleEvaluator?: LifecycleEvaluatorBackendService, postgreSQLDatabaseService?: PostgreSQLDatabaseBackendService): ServiceResourceBackendService<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>;
+    applyRelationshipActionMany(executionContext: ExecutionContext<any>, id_or_ids_or_filter: IdOrIdsOrFilterType, request: ResourceRelationshipBulkActionRequest, options?: RepositoryOptions): Promise<ResourceRelationshipBulkActionResult>;
+    private executeGeneratedRelationshipBulkOperation;
+    private parseGeneratedRelationshipBulkOperationRequest;
+    private resolveGeneratedRelationshipBulkSelector;
+    private assertGeneratedRelationshipBulkOperationEnabled;
+    private resolveSingleSelectedId;
+    private resolveHookCurrentObject;
+    private assertBulkHookObjectContextAvailability;
+    private initializeOperationsMap;
+    /**
+     * Entry point from registry convenience methods (`create`, `update`, `delete`, etc.)
+     * and controller-level `doByOperationPath`.
+     *
+     * Resolves `operation` from this handler's `operationsMap`. The caller's
+     * `executionContext.operation` may point to a DIFFERENT operation (e.g., a parent's
+     * operation or a generic webhook operation). `doOperation()` corrects this mismatch
+     * via Correction Point 1 before any pipeline logic executes.
+     */
+    doByOperationPath(operationPath: ResourceConfiguration_OperationPath<TCustomOperationEnum, TCoreOperationEnum>, executionContext: ExecutionContext<any>, id_or_ids_or_filter?: IdOrIdsOrFilterType, data?: any, options?: RepositoryOptions): Promise<any>;
+    /**
+     * Entry point from controller-level `doByExecutionContext`.
+     *
+     * Reads `operation` directly from `executionContext.operation` — guaranteed to match
+     * (same object reference). `doOperation()` correction points are no-ops in this path.
+     */
+    doByExecutionContext(executionContext: ExecutionContext<ResourceConfiguration_Operation<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>>, data?: any, options?: RepositoryOptions): Promise<any>;
+    resolveOperationForDataMode(operation: ResourceConfiguration_Operation<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>, dataMode: DataMode | undefined): ResourceConfiguration_Operation<TCustomOperationEnum, TCoreOperationEnum, TMainSchema>;
+    /**
+     * Helper method to fetch contexts for operation functions (enabledCondition, basicPrefixOperation).
+     * Fetches objectContext and userContext only when needed based on function flags.
+     *
+     * @param fn - Function with optional context needs flags
+     * @param resourceType - Resource type for context fetching
+     * @param currentObject - Current object (fetched if needed for UPDATE/DELETE)
+     * @param executionContext - Execution context
+     * @returns Object with objectContext, userContext, and resolved currentObject
+     */
+    private fetchContextsForOperationFunction;
+    /**
+     * Fetch current object for UPDATE/DELETE operations.
+     * For CREATE operations, returns undefined (object doesn't exist yet).
+     *
+     * @param coreOperation - The core operation type
+     * @param resourceType - Resource type
+     * @param id_or_ids_or_filter - ID or filter
+     * @param executionContext - Execution context
+     * @returns Current object or undefined for CREATE
+     */
+    private fetchCurrentObjectForOperation;
+    private static readonly STEP_UP_EXEMPT_OPERATIONS;
+    /**
+     * W7.1: Enforces step-up re-authentication for sensitive (mutating) operations.
+     *
+     * Skip conditions (all must be false for enforcement to apply):
+     * 1. Non-user requests (INTERNAL_CALL, API_KEY, etc.) — exempt
+     * 2. Worker executions — already authorized at queue time
+     * 3. Sub-calls (subCallDepth > 0) — parent already passed step-up
+     * 4. Read-only operations (READ, LIST, SEARCH, COUNT) — exempt
+     * 5. stepUpAuth not enabled for this user type — no-op
+     *
+     * When enforced and auth is stale (beyond maxAgeSeconds), accepts either:
+     * - A valid REAUTH consumable token via X-Reauth-Token header
+     * - Otherwise throws STEP_UP_REQUIRED (HTTP 403)
+     */
+    private enforceStepUpAuth;
+    /**
+     * Central orchestration method — ALL resource operations flow through here.
+     *
+     * Two entry points:
+     * - `doByOperationPath()` — resolves `operation` from the operations map. The caller's
+     *   `executionContext.operation` may differ (e.g., webhook context with a generic operation).
+     * - `doByExecutionContext()` — reads `operation` from `executionContext.operation`.
+     *   Guaranteed to match (same reference).
+     *
+     * Two correction points enforce the invariant that `executionContext.operation` always
+     * matches the operation being executed:
+     * - Correction Point 1 (pre-queue): corrects to the base `operation` parameter.
+     * - Correction Point 2 (post-variant): refines to `resolvedOperation` when `dataMode !== RAW`.
+     *
+     * After correction, ALL downstream reads of `executionContext.operation` — notifications,
+     * guidance, milestones, queue serialization, repositories — use the correct operation.
+     */
+    private doOperation;
+    /**
+     * Execute operation via queue with RPC pattern (QUEUED / QUEUED_NOT_AWAITABLE).
+     *
+     * @param executionContext - The execution context with operation
+     * @param id_or_ids_or_filter - Resource ID(s) or filter for the operation
+     * @param data - Input data for the operation
+     * @param awaitable - If true, wait for result (QUEUED); if false, return immediately (QUEUED_NOT_AWAITABLE)
+     * @returns For awaitable: the operation result; otherwise: { jobId, status: 'queued' }
+     */
+    private executeQueued;
+    /**
+     * Execute operation via queue with callback pattern (BACKGROUND_JOB).
+     * Returns immediately with job tracking info.
+     *
+     * @param executionContext - The execution context with operation
+     * @param id_or_ids_or_filter - Resource ID(s) or filter for the operation
+     * @param data - Input data for the operation
+     * @returns Job tracking info: { jobId, status: 'processing', message }
+     */
+    private executeBackgroundJob;
+    /**
+     * Execute operation inline but don't wait for result (INLINE_NOT_AWAITABLE).
+     * Fire and forget pattern - executes in the next tick.
+     *
+     * @param operation - The operation to execute
+     * @param executionContext - The execution context
+     * @param id_or_ids_or_filter - Resource ID(s) or filter
+     * @param data - Input data
+     * @param options - Repository options
+     */
+    private executeInlineAsync;
+    private callRepository;
+    private create;
+    private createMany;
+    /**
+     * Resolve operation variant based on dataMode.
+     * Maps dataMode to appropriate variantKey:
+     * - RAW -> default variant (no variantKey)
+     * - SUMMARY -> 'summary' variant (throws if not found)
+     * - CONTEXT -> 'context' variant (throws if not found)
+     *
+     * Throws error if requested variant doesn't exist (fail-fast).
+     */
+    private resolveOperationVariant;
+    private read;
+    private update;
+    private updateMany;
+    private delete;
+    private deleteMany;
+    private list;
+    private search;
+    private count;
+    /**
+     * Validate and transform input data using operation's requestDto
+     */
+    private validateAndTransformInput;
+    private transformOutput;
+    private extractCollectionItemDto;
+    /**
+     * Apply business validation
+     */
+    private applyBusinessValidation;
+    /**
+     * Execute pre-operation business logic
+     */
+    private executePreOperationLogic;
+    /**
+     * Execute post-operation business logic using engine lifecycle operations
+     */
+    private executePostOperationLogic;
+    private getRelationshipFieldNameForCurrentResource;
+    private getRelationshipForBulkAction;
+    private applyReferenceSetActionMany;
+    private applyReferenceClearActionMany;
+    private applyCompositionCreateActionMany;
+    private applyAssociationLinkActionMany;
+    private applyAssociationUnlinkActionMany;
+    private applyAssociationReplaceActionMany;
+    /**
+     * Extract nested field name from relationship using the shared
+     * relationship-object identity rule.
+     */
+    private getNestedFieldName;
+    private getAllResourceFieldIdentifiers;
+    private extractResourceIds;
+    /**
+     * Get FK field name for a relationship.
+     * Delegates to the registry so backend services do not improvise their own
+     * FK fallback semantics.
+     */
+    private getFKFieldForRelationship;
+    private resolveActiveAssociationBulkTargetIds;
+    private resolveAssociationBulkIdentity;
+    private assertAssociationPeerResourcesExist;
+    private listAssociationRowsByCurrentAndPeerIds;
+    private listAssociationRowsByCurrentIds;
+    private getResolvedNestedMutationConfig;
+    private getResolvedNestedReadConfig;
+    private getResolvedLifecycleOnParentDelete;
+    /**
+     * Extract nested data from request, separating parent data from nested child data.
+     * Returns { parentData, nestedData } where nestedData is keyed by field name.
+     */
+    private extractNestedData;
+    /**
+     * Bulk variant of extractNestedData().
+     * Applies the same nested field split to each item independently.
+     */
+    private extractNestedDataArray;
+    /**
+     * Normalize bulk create payloads to the array shape expected by the service layer.
+     * Some callers may already pass the raw array, while others may use a `{ data: [] }`
+     * envelope before controller-level extraction.
+     */
+    private normalizeCreateManyInput;
+    /**
+     * Normalize the CREATE_MANY request shape so service callers may pass either
+     * a raw array or the controller-facing `{ data: [...] }` envelope.
+     */
+    private normalizeCreateManyRequestPayload;
+    private getResolvedPersistenceAdapter;
+    private getResolvedPersistenceAdapterForResource;
+    /**
+     * The FILES resource is currently the Mongo-backed coordination seam for file
+     * metadata. PostgreSQL-backed resources can coordinate with it, but they cannot
+     * silently inherit the parent SQL transaction.
+     */
+    private assertMongoBackedFilesResource;
+    private getResourceDatabaseService;
+    private buildFileRepositoryOptions;
+    private buildRepositoryOptionsForResource;
+    private executeResourceTransaction;
+    /**
+     * Route file metadata work through the FILES resource adapter instead of
+     * leaking the current resource transaction into a different repository backend.
+     */
+    private executeFileMetadataWork;
+    private assertNestedMutationAdaptersMatchCurrentResource;
+    private assertMongoBulkTransactionSupport;
+    private getResourceIdValue;
+    private hasExplicitFileFieldMutations;
+    private processBulkCreateFileFields;
+    private loadBulkParentStateMap;
+    private loadBulkTargetResources;
+    private processBulkUpdateFileFields;
+    /**
+     * Extract nested data for UPDATE operations, including delete arrays.
+     * Returns { parentData, nestedData, deleteData }.
+     */
+    private extractNestedDataForUpdate;
+    /**
+     * Filter child relationships by evaluating discriminator/condition against the parent resource.
+     *
+     * This is the central runtime gate for conditional relationships in the services layer.
+     * It ensures that nested CRUD operations and lifecycle cascades only apply to child
+     * relationships whose conditions match the current parent resource's data.
+     *
+     * ## Evaluation Logic
+     *
+     * For each relationship:
+     * 1. If `discriminator` is present: check `String(parentResource[discriminatorField])`
+     *    against `values`. If no match → exclude.
+     * 2. If `condition` is present: call `condition(parentResource)`.
+     *    If it returns false → exclude.
+     * 3. Relationships without discriminator or condition always pass through.
+     *
+     * When both discriminator and condition are present, AND semantics apply —
+     * discriminator is checked first, then condition.
+     *
+     * ## Application Points
+     *
+     * This method is called at 4 critical points in the CRUD lifecycle:
+     *
+     * 1. **Nested CREATE** (inside transaction): After creating the parent, filters
+     *    child relationships using `parentResult` before processing nested creates.
+     *    This prevents creating children for relationships that don't apply to this parent.
+     *
+     * 2. **Nested READ**: After reading the parent, filters child relationships using
+     *    the read `result` before fetching nested children for the response.
+     *
+     * 3. **Nested UPDATE** (inside transaction): After updating the parent, filters
+     *    child relationships using `parentResult` before processing nested updates.
+     *
+     * 4. **Lifecycle DELETE**: Filters lifecycle relationships using pre-delete parent
+     *    snapshots to determine which children should cascade-delete.
+     *    - `DELETE`: uses the single `currentState`
+     *    - `DELETE_MANY`: uses the pre-delete snapshot set loaded for the matched parents,
+     *      so discriminator/condition gating still fails closed per deleted parent
+     *
+     * ## String Coercion
+     *
+     * Uses the shared relationship-activation utility in `saas-models`, preserving
+     * the same `String()` coercion semantics used across backend and frontend
+     * runtime evaluation.
+     *
+     * @param relationships - Child relationships to filter
+     * @param parentResource - The parent resource's data to evaluate conditions against
+     * @returns Relationships whose discriminator/condition match the parent (or have no conditions)
+     */
+    private filterRelationshipsByParent;
+    /**
+     * Process nested operations for CREATE/UPDATE.
+     * Handles creating/updating/deleting children and attaching them to parent result.
+     */
+    private processNestedOperations;
+    /**
+     * Bulk variant of processNestedOperations().
+     * Reuses the single-parent orchestration path for each returned parent result,
+     * preserving sub-call execution contexts and relationship activation checks.
+     *
+     * Contract:
+     * - CREATE_MANY expects per-row nested payloads and receives one nested envelope
+     *   per created parent result.
+     * - UPDATE_MANY currently uses broadcast semantics for nested create/update payloads:
+     *   the same validated nested envelope is replayed for every matched parent result.
+     * - UPDATE_MANY nested deletes are intentionally more restrictive and are rejected
+     *   earlier when a shared delete payload would target multiple parents ambiguously.
+     */
+    private processBulkNestedOperations;
+    /**
+     * Process nested read operations - include children in READ response.
+     */
+    private processNestedRead;
+    /**
+     * Execute lifecycle operations for child resources based on relationship configuration.
+     * Handles onParentDelete cascade for all child relationships with lifecycle.onParentDelete.enabled = true.
+     */
+    private executeLifecycleOperations;
+    /**
+     * Delete child resources immediately (synchronous, within same transaction).
+     *
+     * Includes depth tracking and circular reference detection to prevent infinite loops.
+     *
+     * @param relationship - The relationship configuration
+     * @param parentIds - IDs of parent resources being deleted
+     * @param executionContext - Execution context for the operation
+     * @param currentDepth - Current recursion depth (starts at 0)
+     * @param maxDepth - Maximum allowed depth (from lifecycle config, default 1)
+     * @param visitedResourceIds - Set of visited resource IDs to prevent circular references
+     */
+    private deleteChildrenImmediate;
+    /**
+     * Queue child resources for async deletion (eventual consistency).
+     *
+     * LAZY mode provides eventual consistency by queuing deletion operations
+     * for asynchronous processing. This improves performance for bulk deletions
+     * but requires a queue system to be implemented.
+     *
+     * Current implementation: Placeholder that throws NOT_IMPLEMENTED error.
+     *
+     * Future implementation (Phase 6.1-6.2):
+     * When the queue system is implemented, this method should:
+     * 1. Get the DELETE operation for the child resource type
+     * 2. Use `operation.internalDto` for serializing queue payloads
+     *    - `internalDto` includes `isBackendOnly` fields needed for backend-to-backend communication
+     *    - Date coercion is already applied in `internalDto`
+     * 3. Serialize resource data using `operation.internalDto.parse()` for validation
+     * 4. Enqueue job with validated payload
+     *
+     * Example (when queue system is ready):
+     * ```typescript
+     * const childResourceConfig = this.resourcesRegistry.resourceConfigurations[relationship.resourceType2];
+     * const deleteOperation = childResourceConfig.operations.find(
+     *   op => op.operationIdentifier === CoreResourceOperation.DELETE
+     * );
+     * if (!deleteOperation?.internalDto) {
+     *   throw new Error('DELETE operation or internalDto not found');
+     * }
+     *
+     * // Validate and serialize using internalDto
+     * const queuePayload = {
+     *   resourceType: relationship.resourceType2,
+     *   operationIdentifier: CoreResourceOperation.DELETE,
+     *   data: deleteOperation.internalDto.parse({ _id: childId, ...otherFields }),
+     *   executionContext: { ... },
+     * };
+     *
+     * await this.queueService.enqueueResourceOperation(deleteOperation, queuePayload.data, executionContext);
+     * ```
+     *
+     * @see Phase 6.1 - Use internalDto for Queue Payloads
+     * @see Phase 6.2 - Validate Queue Payloads Against internalDto
+     */
+    private queueChildDeletion;
+    /**
+     * Execute additional post-operation logic (non-cascading)
+     */
+    private executeAdditionalPostOperationLogic;
+    /**
+     * Enrich business context
+     */
+    private enrichBusinessContext;
+    /**
+     * Apply business filter
+     */
+    private applyBusinessFilter;
+    /**
+     * Enhance search query with business logic
+     */
+    private enhanceSearchQuery;
+    /**
+     * Validate deletion constraints
+     */
+    private validateDeletionConstraints;
+    /**
+     * Dispatch notifications (email, badge, WebSocket, M2M) based on operation configuration.
+     *
+     * Reads ALL notification config from `executionContext.operation` — which is guaranteed
+     * to be the correct (possibly variant-resolved) operation thanks to Correction Points
+     * 1 and 2 in `doOperation()`. The NotificationDispatcherService also reads
+     * `executionContext.operation` extensively (15+ reads across its sub-methods).
+     */
+    private dispatchNotifications;
+}
+export {};
+//# sourceMappingURL=services-registry-handler.backend.service.d.ts.map

package/dist/esm/base-classes/services/services/services-registry-handler.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"services-registry-handler.backend.service.d.ts","sourceRoot":"","sources":["../../../../../src/base-classes/services/services/services-registry-handler.backend.service.ts"],"names":[],"mappings":"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"}