@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/base-classes/services/resource-operations-helper.backend.service.js

@@ -0,0 +1,388 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import 'reflect-metadata';
+import { injectable, inject, optional } from 'inversify';
+import { createOrUpdateMandatoryDiscardFields, CoreResourceOperation, ErrorType, ErrorCustomMessageReference, Resources_SharedUtils } from '@wildo-ai/saas-models';
+import { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
+import { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+import { extractFlattenedPathsFromZodSchema, getZodObjectShape, getZodType, isDiscriminatorField, getZodDefArrayProperty, unwrapSchema } from '@wildo-ai/zod-decorators';
+/**
+ * Resource Operation Helper Backend Service
+ *
+ * Shared helper service for common repository and service operations.
+ * Contains reusable methods for:
+ * - Execution context ID extraction
+ * - Input data cleaning
+ * - Initiator ID mapping
+ * - Data enrichment with context
+ * - Zod schema analysis and path extraction
+ *
+ * This service is injected into both RepositoryResourceBackendService
+ * and ServicesRegistryHandlerBackendService to eliminate code duplication.
+ */
+let ResourceOperationHelperBackendService = class ResourceOperationHelperBackendService {
+    logger;
+    errorBuilder;
+    resourceIdService;
+    logDebug;
+    constructor(logger, errorBuilder, resourceIdService) {
+        this.logger = logger;
+        this.errorBuilder = errorBuilder;
+        this.resourceIdService = resourceIdService;
+        this.logDebug = this.logger.debugByType('ResourceOperationHelper');
+        this.logger.setDebugTypeLogging('ResourceOperationHelper', false);
+    }
+    /**
+     * Extract IDs from execution context based on resource field identifier
+     * @param executionContext - The execution context containing resource IDs
+     * @param resourceFieldIdentifier - The field identifier to extract IDs for
+     * @returns Extracted IDs as IdOrIdsOrFilterType or undefined if no relevant IDs found
+     */
+    extractIdsFromExecutionContext(executionContext, resourceFieldIdentifier) {
+        if (!executionContext || !resourceFieldIdentifier) {
+            return undefined;
+        }
+        // Get context resource IDs from execution context
+        const contextResourceIds = executionContext.getContextResourceIds();
+        if (!contextResourceIds || contextResourceIds.size === 0) {
+            return undefined;
+        }
+        // Look for the specific resource field identifier
+        const resourceId = contextResourceIds.get(resourceFieldIdentifier);
+        if (resourceId) {
+            return resourceId;
+        }
+        return undefined;
+    }
+    /**
+     * Get initiator ID from execution context
+     * @param executionContext - The execution context
+     * @param initiatorType - Type of initiator to extract ('user', 'organization', 'application')
+     * @returns The initiator ID or undefined if not found
+     */
+    getInitiatorId(executionContext, initiatorType) {
+        const initiatorIds = executionContext.initiatorIds;
+        if (!initiatorIds) {
+            return undefined;
+        }
+        switch (initiatorType) {
+            case 'user':
+                return initiatorIds.userId;
+            case 'organization':
+                return initiatorIds.organizationId;
+            case 'application':
+                return initiatorIds.applicationId;
+            default:
+                return undefined;
+        }
+    }
+    /**
+     * Clean input data by removing mandatory discard fields
+     * @param data - The data to clean
+     * @param operation - The operation being performed (affects which fields to keep/discard)
+     * @returns Cleaned data with discard fields removed
+     */
+    cleanInputData(data, operation) {
+        if (!data || typeof data !== 'object') {
+            return data;
+        }
+        // Create a copy to avoid mutating the original
+        const cleanedData = { ...data };
+        // Remove mandatory discard fields
+        createOrUpdateMandatoryDiscardFields.forEach(field => {
+            if (operation === CoreResourceOperation.UPDATE_MANY && field === '_id') {
+                return; // Skip removing _id for updateMany
+            }
+            delete cleanedData[field];
+        });
+        this.logDebug('Data cleaned', {
+            operation,
+            originalKeys: Object.keys(data),
+            cleanedKeys: Object.keys(cleanedData),
+            removedFields: createOrUpdateMandatoryDiscardFields.filter(field => !(operation === CoreResourceOperation.UPDATE_MANY && field === '_id'))
+        });
+        return cleanedData;
+    }
+    /**
+     * Cleans array of input data by removing mandatory discard fields
+     * @param dataArray - The array of data to clean
+     * @param operation - The operation being performed (affects which fields to keep/discard)
+     * @returns Cleaned array with discard fields removed from each item
+     */
+    cleanInputDataArray(dataArray, operation) {
+        if (!Array.isArray(dataArray)) {
+            return dataArray;
+        }
+        return dataArray.map(data => this.cleanInputData(data, operation));
+    }
+    /**
+     * Enrich data with execution context information
+     * @param data - The data to enrich
+     * @param executionContext - The execution context containing IDs and user info
+     * @param zodSchema - The zod schema for field path validation
+     * @param resourceFieldIdentifier - The resource field identifier to exclude self-references
+     * @param operation - The operation being performed
+     * @param options - Repository options containing exclusion rules
+     * @returns Enriched data with context information
+     */
+    enrichDataWithContext(data, executionContext, zodSchema, resourceFieldIdentifier, operation, options) {
+        if (!data || typeof data !== 'object') {
+            return data;
+        }
+        const enrichedData = { ...data };
+        // Check if context enrichment should be excluded
+        if (options?.excludeContextEnrichment === true) {
+            // Skip all context enrichment if explicitly disabled
+            return enrichedData;
+        }
+        // Determine blacklisted fields
+        const blacklistedFields = new Set();
+        // Always exclude the resource's own resourceFieldIdentifier to avoid self-reference
+        blacklistedFields.add(resourceFieldIdentifier);
+        // Add custom blacklisted fields if provided
+        if (Array.isArray(options?.excludeContextEnrichment)) {
+            options.excludeContextEnrichment.forEach(field => blacklistedFields.add(field));
+        }
+        // Add context resource IDs (with nested path support, schema validation and blacklist filtering)
+        const contextResourceIds = executionContext.getContextResourceIds();
+        contextResourceIds.forEach((resourceId, fieldIdentifier) => {
+            // Skip if field is blacklisted
+            if (blacklistedFields.has(fieldIdentifier)) {
+                this.logDebug('Skipping blacklisted field in context enrichment', { fieldIdentifier });
+                return;
+            }
+            // Find all schema paths that end with this field identifier (including nested paths)
+            const matchingPaths = this.findRequiredNestedFieldPathsFromZodSchema(zodSchema, fieldIdentifier, executionContext, {
+                reason: 'context_enrichment',
+                message: `Execution context field '${fieldIdentifier}' is missing from the target schema during context enrichment`,
+            });
+            // Process each matching path
+            matchingPaths.forEach(fullPath => {
+                // Only add if not already present in data (check nested path)
+                if (!this.hasNestedPath(enrichedData, fullPath)) {
+                    this.setNestedValue(enrichedData, fullPath, resourceId);
+                    this.logDebug('Added context resource ID to nested path', { fieldIdentifier, fullPath, resourceId });
+                }
+                else {
+                    this.logDebug('Skipping context field - already present in data', { fieldIdentifier, fullPath });
+                }
+            });
+        });
+        return enrichedData;
+    }
+    /**
+     * Inject non-discriminator literal field values from the schema into the data.
+     *
+     * Non-discriminator literals are fixed values defined in the schema (e.g., `z.literal("ORGANIZATION")`)
+     * that are NOT used for variant discrimination. These values are excluded from CREATE DTOs
+     * (since users shouldn't/can't change them) but must be injected before persistence.
+     *
+     * Handles wrapped types (optional, default, etc.) by unwrapping before type check.
+     *
+     * @param data - The data object to enrich
+     * @param zodSchema - The zod schema containing literal field definitions
+     * @returns Data with non-discriminator literal values injected
+     */
+    injectNonDiscriminatorLiteralValues(data, zodSchema) {
+        if (!data || typeof data !== 'object') {
+            return data;
+        }
+        const enrichedData = { ...data };
+        const shape = getZodObjectShape(zodSchema);
+        if (!shape) {
+            return enrichedData;
+        }
+        for (const [fieldName, fieldSchema] of Object.entries(shape)) {
+            // Unwrap to handle z.literal("value").optional() etc.
+            const unwrapped = unwrapSchema(fieldSchema);
+            const zodType = getZodType(unwrapped);
+            // Only process literal types that are NOT discriminators
+            // isDiscriminatorField already handles unwrapping via getMetadataRecursive
+            if (zodType === 'literal' && !isDiscriminatorField(fieldSchema)) {
+                // Only inject if not already present in data
+                if (!(fieldName in enrichedData)) {
+                    // Extract literal value from UNWRAPPED schema.def.values (Zod 4 stores as array)
+                    const literalValues = getZodDefArrayProperty(unwrapped, 'values');
+                    if (literalValues && literalValues.length > 0) {
+                        enrichedData[fieldName] = literalValues[0];
+                        this.logDebug('Injected non-discriminator literal value', { fieldName, value: literalValues[0] });
+                    }
+                }
+            }
+        }
+        return enrichedData;
+    }
+    /**
+     * Find all schema field paths that end with the given field identifier from a zod schema
+     * @param zodSchema - The zod schema to analyze for field paths
+     * @param fieldIdentifier - The field identifier to search for
+     * @returns Array of full field paths that end with the identifier
+     */
+    findNestedFieldPathsFromZodSchema(zodSchema, fieldIdentifier) {
+        const flattenedPaths = extractFlattenedPathsFromZodSchema(zodSchema);
+        const matchingPaths = [];
+        flattenedPaths.forEach(path => {
+            // Check if the path ends with the field identifier
+            if (path === fieldIdentifier || path.endsWith(`.${fieldIdentifier}`)) {
+                matchingPaths.push(path);
+            }
+        });
+        this.logDebug('Found nested field paths from zod schema', { fieldIdentifier, matchingPaths, totalPaths: flattenedPaths.length });
+        return matchingPaths;
+    }
+    /**
+     * Resolve schema paths for a field identifier and fail closed when configuration drift
+     * would otherwise silently skip context/FK enforcement.
+     */
+    findRequiredNestedFieldPathsFromZodSchema(zodSchema, fieldIdentifier, executionContext, details) {
+        const matchingPaths = this.findNestedFieldPathsFromZodSchema(zodSchema, fieldIdentifier);
+        if (matchingPaths.length > 0) {
+            return matchingPaths;
+        }
+        throw this.errorBuilder.buildError(ErrorType.INTERNAL, executionContext, {
+            customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
+            context: {
+                fieldIdentifier,
+                reason: details.reason,
+                resourceIdentifier: details.resourceIdentifier,
+                message: details.message,
+            }
+        });
+    }
+    /**
+     * Set a value at a nested object path
+     * @param obj - The object to modify
+     * @param path - The dot-notation path (e.g., 'aSub.organizationId')
+     * @param value - The value to set
+     */
+    setNestedValue(obj, path, value) {
+        const keys = path.split('.');
+        let current = obj;
+        // Navigate to the parent object
+        for (let i = 0; i < keys.length - 1; i++) {
+            const key = keys[i];
+            if (!current[key] || typeof current[key] !== 'object') {
+                current[key] = {};
+            }
+            current = current[key];
+        }
+        // Set the final value
+        const finalKey = keys[keys.length - 1];
+        current[finalKey] = value;
+    }
+    /**
+     * Check if a nested path exists in an object
+     * @param obj - The object to check
+     * @param path - The dot-notation path (e.g., 'aSub.organizationId')
+     * @returns True if the path exists and has a value
+     */
+    hasNestedPath(obj, path) {
+        const keys = path.split('.');
+        let current = obj;
+        for (const key of keys) {
+            if (!current || typeof current !== 'object' || !(key in current)) {
+                return false;
+            }
+            current = current[key];
+        }
+        return current !== undefined && current !== null;
+    }
+    /**
+     * Validate that a resourceId is a valid resource identifier.
+     * Supports both MongoDB ObjectId (24 hex characters) and UUID formats.
+     *
+     * When `resourceType` is provided and `ResourceIdBackendService` is available,
+     * validates against the specific format expected for that resource's persistence adapter.
+     *
+     * Checks that the value is:
+     * - Not null
+     * - Not undefined
+     * - A string
+     * - A valid MongoDB ObjectId OR UUID format (or specific format for resourceType)
+     *
+     * @param resourceId - The resource ID to validate
+     * @param executionContext - Optional execution context for error handling
+     * @param fieldName - Optional field name for error messages (defaults to 'resourceId')
+     * @param resourceType - Optional resource type for format-aware validation
+     * @returns True if valid, throws WildoError_Backend if invalid
+     * @throws WildoError_Backend if validation fails
+     */
+    validateResourceId(resourceId, executionContext, fieldName = 'resourceId', resourceType) {
+        // Check for null or undefined
+        if (resourceId === null || resourceId === undefined) {
+            throw this.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {
+                customMessageReference: ErrorCustomMessageReference.RESOURCE_ID_VALIDATION_FAILED,
+                context: {
+                    fieldName,
+                    reason: 'null_or_undefined',
+                    message: `${fieldName} cannot be null or undefined`
+                }
+            });
+        }
+        // Check if it's a string
+        if (typeof resourceId !== 'string') {
+            throw this.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {
+                customMessageReference: ErrorCustomMessageReference.RESOURCE_ID_VALIDATION_FAILED,
+                context: {
+                    fieldName,
+                    reason: 'not_string',
+                    actualType: typeof resourceId,
+                    message: `${fieldName} must be a string, got ${typeof resourceId}`
+                }
+            });
+        }
+        // Use format-aware validation if resourceType is provided and service is available
+        if (resourceType && this.resourceIdService) {
+            if (!this.resourceIdService.validateForResource(resourceId, resourceType)) {
+                const expectedFormat = this.resourceIdService.getFormatForResource(resourceType);
+                throw this.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {
+                    customMessageReference: ErrorCustomMessageReference.RESOURCE_ID_VALIDATION_FAILED,
+                    context: {
+                        fieldName,
+                        reason: 'invalid_format',
+                        value: resourceId,
+                        expectedFormat,
+                        resourceType,
+                        message: `${fieldName} must be a valid ${expectedFormat} for resource ${resourceType}, got invalid format`
+                    }
+                });
+            }
+            return true;
+        }
+        // Fallback to generic validation (supports both MongoDB ObjectId and UUID)
+        if (!Resources_SharedUtils.isValidResourceId(resourceId)) {
+            throw this.errorBuilder.buildError(ErrorType.VALIDATION, executionContext, {
+                customMessageReference: ErrorCustomMessageReference.RESOURCE_ID_VALIDATION_FAILED,
+                context: {
+                    fieldName,
+                    reason: 'invalid_format',
+                    value: resourceId,
+                    message: `${fieldName} must be a valid resource ID (MongoDB ObjectId or UUID), got invalid format`
+                }
+            });
+        }
+        return true;
+    }
+};
+ResourceOperationHelperBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.ErrorBuilderService)),
+    __param(2, inject(SAAS_SERVICE_TYPES.ResourceIdBackendService)),
+    __param(2, optional()),
+    __metadata("design:paramtypes", [LoggerService,
+        ErrorBuilderBackendService, Function])
+], ResourceOperationHelperBackendService);
+export { ResourceOperationHelperBackendService };
+//# sourceMappingURL=resource-operations-helper.backend.service.js.map

package/dist/esm/base-classes/services/resource-operations-helper.backend.service.js.map

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

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

@@ -0,0 +1,9 @@
+import 'reflect-metadata';
+export declare class MockServicesRegistryHandlerBackendService {
+    read: import("vitest").Mock<[], Promise<any>>;
+    list: import("vitest").Mock<[], Promise<any[]>>;
+    create: import("vitest").Mock<[], Promise<any>>;
+    update: import("vitest").Mock<[], Promise<any>>;
+    reset(): void;
+}
+//# sourceMappingURL=mock-services-registry-handler.service.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mock-services-registry-handler.service.d.ts","sourceRoot":"","sources":["../../../../../../src/base-classes/services/services/__tests__/mock-services-registry-handler.service.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAI1B,qBACa,yCAAyC;IACpD,IAAI,0CAA2B;IAE/B,IAAI,4CAAyB;IAE7B,MAAM,0CAA2B;IAEjC,MAAM,0CAAgC;IAEtC,KAAK,IAAI,IAAI;CAMd"}

package/dist/esm/base-classes/services/services/__tests__/mock-services-registry-handler.service.js

@@ -0,0 +1,26 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import 'reflect-metadata';
+import { injectable } from 'inversify';
+import { vi } from 'vitest';
+let MockServicesRegistryHandlerBackendService = class MockServicesRegistryHandlerBackendService {
+    read = vi.fn(async () => null);
+    list = vi.fn(async () => []);
+    create = vi.fn(async () => null);
+    update = vi.fn(async () => undefined);
+    reset() {
+        this.read.mockClear();
+        this.list.mockClear();
+        this.create.mockClear();
+        this.update.mockClear();
+    }
+};
+MockServicesRegistryHandlerBackendService = __decorate([
+    injectable()
+], MockServicesRegistryHandlerBackendService);
+export { MockServicesRegistryHandlerBackendService };
+//# sourceMappingURL=mock-services-registry-handler.service.js.map

package/dist/esm/base-classes/services/services/__tests__/mock-services-registry-handler.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-services-registry-handler.service.js","sourceRoot":"","sources":["../../../../../../src/base-classes/services/services/__tests__/mock-services-registry-handler.service.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,kBAAkB,CAAC;AAC1B,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAGrB,IAAM,yCAAyC,GAA/C,MAAM,yCAAyC;IACpD,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;IAE/B,IAAI,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAE7B,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC;IAEjC,MAAM,GAAG,EAAE,CAAC,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC;IAEtC,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACtB,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;QACtB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACxB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;IAC1B,CAAC;CACF,CAAA;AAfY,yCAAyC;IADrD,UAAU,EAAE;GACA,yCAAyC,CAerD"}

package/dist/esm/base-classes/services/services/resource-operation-custom-implementation-base.backend.service.d.ts

@@ -0,0 +1,144 @@
+import { z } from 'zod';
+import { ResourceOperation_CustomServiceImplementationMode } from '@wildo-ai/saas-models';
+import type { ExecutionContext } from '../../../runtime/models/execution-context.backend.schemas.js';
+import type { LoggerService } from '../../../monitoring/logger/services/logger.service.js';
+import type { ErrorBuilderBackendService } from '../../../errors/services/error-builder.backend.service.js';
+import type { ResourcesRegistryBackendService } from '../../../resources/services/resources-registry.backend.service.js';
+import type { ServicesRegistryHandlerBackendService } from './services-registry-handler.backend.service.js';
+import type { RepositoriesRegistryHandlerBackendService } from '../../../base-classes/services/repositories/repositories-registry-handler.backend.service.js';
+import type { ExternalApiHandlerBackendService } from '../../../external-providers/services/external-api-handler.backend.service.js';
+import type { PlatformMutualizedHandlerBackendService } from '../../../requests/service/platform-mutualized-handler.backend.service.js';
+import type { ServerlessServicesHandlerBackendService } from '../../../requests/service/serverless-services-handler.backend.service.js';
+import type { ExecutionContextCreatorBackendService } from '../../../runtime/services/execution-context-creator.backend.service.js';
+type Augment<TAugment extends object | undefined = undefined> = TAugment extends undefined ? {} : TAugment;
+export type ResourceOperationCustomImplementation_InputTypeOf<TMode extends ResourceOperation_CustomServiceImplementationMode = ResourceOperation_CustomServiceImplementationMode.OVERRIDE_ALL, TInput extends (z.ZodSchema | undefined) = z.ZodAny | undefined, TOutput extends z.ZodSchema = z.ZodAny, TAugment extends object | undefined = undefined> = (TMode extends ResourceOperation_CustomServiceImplementationMode.OVERRIDE_ALL | ResourceOperation_CustomServiceImplementationMode.PREFIX_CORE_OPERARTIONS ? TInput extends z.ZodSchema ? z.infer<TInput> : never : TMode extends ResourceOperation_CustomServiceImplementationMode.REPLACE_CORE_OPERARTIONS ? TInput extends z.ZodSchema ? z.infer<TInput> & Augment<TAugment> : never : z.infer<TOutput>);
+export type ResourceOperationCustomImplementation_OutputTypeOf<TMode extends ResourceOperation_CustomServiceImplementationMode = ResourceOperation_CustomServiceImplementationMode.OVERRIDE_ALL, TInput extends (z.ZodSchema | undefined) = z.ZodAny | undefined, TOutput extends z.ZodSchema = z.ZodAny, TAugment extends object | undefined = undefined> = (TMode extends ResourceOperation_CustomServiceImplementationMode.PREFIX_CORE_OPERARTIONS ? TInput extends z.ZodSchema ? z.infer<TInput> & Augment<TAugment> : Augment<TAugment> : z.infer<TOutput>);
+export declare const parseResourceOperation_CustomServiceImplementationSchema: <TSchema extends z.ZodTypeAny | undefined, TReturn = TSchema extends z.ZodTypeAny ? z.infer<TSchema> : unknown>(mode: ResourceOperation_CustomServiceImplementationMode, inputOrOutput: "input" | "output", schema: TSchema, objectToParse: unknown, errorBuilder?: ErrorBuilderBackendService) => TReturn;
+/**
+ * Utilities object provided to custom implementation methods.
+ *
+ * Contains:
+ * - Service instances (logger, errorBuilder, registries, handlers)
+ * - `executionContextCreator`: Creates child execution contexts for cross-resource sub-calls
+ * - Contextual data for the operation:
+ *   - `objectContext`: Parent and child resource data (fetched based on resource configuration)
+ *   - `initiatorUserContext`: User context of the user/organization/application initiating the operation
+ *   - `currentObject`: The current resource object (for UPDATE/DELETE operations) or input data (for CREATE operations)
+ *
+ * Context fields are populated automatically by the service registry handler based on:
+ * - Resource configuration context needs analysis
+ * - Operation type (CREATE uses input data, UPDATE/DELETE fetches current object)
+ *
+ * ### Cross-resource operations
+ *
+ * For cross-resource calls from custom impls, use `utils.executionContextCreator.createForSubCall()`
+ * to create a child context with proper depth tracking and cycle detection, then pass it
+ * to `utils.servicesRegistry`. Example:
+ *
+ * ```ts
+ * const subCtx = await utils.executionContextCreator.createForSubCall(
+ *   executionContext, targetResourceType, CoreResourceOperation.CREATE
+ * );
+ * await utils.servicesRegistry.create(targetResourceType, subCtx, data);
+ * ```
+ *
+ * Calling `servicesRegistry` directly with the parent context is functionally safe
+ * (doOperation corrects the operation), but skips depth/cycle tracking.
+ */
+export type ResourceOperation_CustomImplementation_Utils = {
+    logger: LoggerService;
+    errorBuilder: ErrorBuilderBackendService;
+    resourcesRegistry: ResourcesRegistryBackendService;
+    servicesRegistry: ServicesRegistryHandlerBackendService;
+    repositoriesRegistry: RepositoriesRegistryHandlerBackendService;
+    externalApiHandler: ExternalApiHandlerBackendService;
+    platformMutualizedHandler: PlatformMutualizedHandlerBackendService;
+    serverlessServicesHandler: ServerlessServicesHandlerBackendService;
+    /**
+     * Creates child execution contexts for cross-resource sub-calls with proper
+     * depth tracking and cycle detection. Use `createForSubCall()` when calling
+     * `servicesRegistry` methods from a custom implementation.
+     */
+    executionContextCreator: ExecutionContextCreatorBackendService;
+    /** SAML metadata service — for DISCOVER_ENDPOINTS (emits SAML_METADATA_PARSED) */
+    samlMetadataService?: {
+        parseIdPMetadata(metadataXml: string): unknown;
+    };
+    /**
+     * Contextual data about parent and child resources.
+     * Structure: { parents: Record<string, any>, children: Record<string, any> }
+     * Populated based on resource configuration context needs.
+     */
+    objectContext?: {
+        parents: Record<string, any>;
+        children: Record<string, any>;
+    };
+    /**
+     * User context of the initiator (user/organization/application) performing the operation.
+     * Populated from execution context.
+     */
+    initiatorUserContext?: any;
+    /**
+     * Current resource object (for UPDATE/DELETE) or input data (for CREATE).
+     * For UPDATE/DELETE: Fetched from repository before custom implementation execution.
+     * For CREATE: Uses the input data provided to the operation.
+     */
+    currentObject?: any;
+};
+export declare abstract class ResourceOperationCustomImplementationBase<TInput extends z.ZodSchema = z.ZodAny, TOutput extends z.ZodSchema = z.ZodAny> {
+    abstract getPlaceholders(): ResourceOperation_CustomServiceImplementationMode[];
+    /**
+     * Replaces the ENTIRE operation pipeline — no core CRUD, no notifications, no other hooks.
+     * Single-owner mode: if multiple registrations declare this, highest priority wins.
+     */
+    abstract overrideAll(_id: string | undefined, input: ResourceOperationCustomImplementation_InputTypeOf<ResourceOperation_CustomServiceImplementationMode.OVERRIDE_ALL, TInput, TOutput>, executionContext: ExecutionContext<any>, utils: ResourceOperation_CustomImplementation_Utils): Promise<ResourceOperationCustomImplementation_OutputTypeOf<ResourceOperation_CustomServiceImplementationMode.OVERRIDE_ALL, TInput, TOutput>>;
+    /**
+     * Runs before core CRUD. Augments `data` via spread-merge (`data = { ...data, ...result }`).
+     *
+     * **Multi-registration execution:** handlers run sequentially by ascending priority number
+     * (lower number = higher priority = runs first). Each handler receives the accumulated `data`
+     * from all prior handlers. For field conflicts, **last-writer-wins**: the handler with the
+     * HIGHEST priority number (lowest priority) overwrites fields set by earlier handlers.
+     *
+     * **Array inputs (CREATE_MANY):** handler must return the full transformed array, not a
+     * spread-merged object. Non-array returns are silently dropped with a debug log.
+     *
+     * `utils.currentObject` reflects pre-PREFIX state (original DB record or CREATE input).
+     */
+    abstract prefixCoreOperations<TAugment extends object | undefined = undefined>(_id: string | undefined, input: ResourceOperationCustomImplementation_InputTypeOf<ResourceOperation_CustomServiceImplementationMode.PREFIX_CORE_OPERARTIONS, TInput, TOutput, TAugment>, executionContext: ExecutionContext<any>, utils: ResourceOperation_CustomImplementation_Utils): Promise<ResourceOperationCustomImplementation_OutputTypeOf<ResourceOperation_CustomServiceImplementationMode.PREFIX_CORE_OPERARTIONS, TInput, TOutput, TAugment>>;
+    /**
+     * Replaces the core CRUD **result** — the core DB operation still runs, this overwrites `currentState`.
+     * Receives PREFIX-augmented `data` as input. Single-owner mode: highest priority wins.
+     */
+    abstract replaceCoreOperations<TAugment extends object | undefined = undefined>(_id: string | undefined, input: ResourceOperationCustomImplementation_InputTypeOf<ResourceOperation_CustomServiceImplementationMode.REPLACE_CORE_OPERARTIONS, TInput, TOutput, TAugment>, executionContext: ExecutionContext<any>, utils: ResourceOperation_CustomImplementation_Utils): Promise<ResourceOperationCustomImplementation_OutputTypeOf<ResourceOperation_CustomServiceImplementationMode.REPLACE_CORE_OPERARTIONS, TInput, TOutput, TAugment>>;
+    /**
+     * Runs after core CRUD and REPLACE. Input is the core operation result.
+     *
+     * **DELETE operations:** `input` is a `string` (the deleted `_id`) or `string[]` (bulk),
+     * NOT the deleted document. Use `utils.currentObject` to access the pre-deletion document.
+     * Handlers must guard against non-object input when destructuring.
+     *
+     * With multi-registration, handlers run sequentially by priority — each receives the previous handler's output.
+     */
+    abstract postfixCoreOperations(_id: string | undefined, input: ResourceOperationCustomImplementation_InputTypeOf<ResourceOperation_CustomServiceImplementationMode.POSTFIX_CORE_OPERARTIONS, TInput, TOutput>, executionContext: ExecutionContext<any>, utils: ResourceOperation_CustomImplementation_Utils): Promise<ResourceOperationCustomImplementation_OutputTypeOf<ResourceOperation_CustomServiceImplementationMode.POSTFIX_CORE_OPERARTIONS, TInput, TOutput>>;
+    /**
+     * Runs after notification dispatch. Input is the current operation result.
+     *
+     * **DELETE operations:** `input` is a `string` (the deleted `_id`) or `string[]` (bulk),
+     * NOT the deleted document. Use `utils.currentObject` to access the pre-deletion document.
+     *
+     * With multi-registration, handlers run sequentially by priority — each receives the previous handler's output.
+     */
+    abstract afterUserNotifications(_id: string | undefined, input: ResourceOperationCustomImplementation_InputTypeOf<ResourceOperation_CustomServiceImplementationMode.AFTER_USER_NOTIFICATIONS, TInput, TOutput>, executionContext: ExecutionContext<any>, utils: ResourceOperation_CustomImplementation_Utils): Promise<ResourceOperationCustomImplementation_OutputTypeOf<ResourceOperation_CustomServiceImplementationMode.AFTER_USER_NOTIFICATIONS, TInput, TOutput>>;
+    /**
+     * Final hook — runs at the very end of the pipeline, after notifications and lifecycle evaluations.
+     *
+     * **DELETE operations:** `input` is a `string` (the deleted `_id`) or `string[]` (bulk),
+     * NOT the deleted document. Use `utils.currentObject` to access the pre-deletion document.
+     *
+     * With multi-registration, handlers run sequentially by priority — each receives the previous handler's output.
+     */
+    abstract atTheEnd(_id: string | undefined, input: ResourceOperationCustomImplementation_InputTypeOf<ResourceOperation_CustomServiceImplementationMode.AT_THE_END, TInput, TOutput>, executionContext: ExecutionContext<any>, utils: ResourceOperation_CustomImplementation_Utils): Promise<ResourceOperationCustomImplementation_OutputTypeOf<ResourceOperation_CustomServiceImplementationMode.AT_THE_END, TInput, TOutput>>;
+}
+export {};
+//# sourceMappingURL=resource-operation-custom-implementation-base.backend.service.d.ts.map

package/dist/esm/base-classes/services/services/resource-operation-custom-implementation-base.backend.service.d.ts.map

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