@wildo-ai/saas-backend-lib 1.0.1

package/dist/esm/guidance/batches/dormancy-detection.batch.backend.service.js

@@ -0,0 +1,110 @@
+/**
+ * Dormancy Detection Batch Job
+ *
+ * This batch job runs periodically (configurable via lifecycle config) and performs:
+ * 1. Query all lifecycle states where currentStage is in DORMANCY_SOURCE_STAGES
+ *    and lastActiveAt is older than the dormancy threshold
+ * 2. Transition each to DORMANT via LifecycleEvaluatorBackendService
+ * 3. WS events are pushed per transition (handled by the evaluator)
+ *
+ * Uses createCustomBatchExecutionService — same pattern as createFilesCleanupBatch().
+ * Evaluator accessed via late-binding getLifecycleEvaluator().
+ */
+import { createCustomBatchExecutionService } from '../../base-classes/services/batches/batches-cronjobs-custom-execution.service.js';
+import { z } from 'zod';
+import { CoreResourceType, CoreResourceOperation, LIFECYCLE_DORMANCY_SOURCE_STAGES, isWildoBackendError } from '@wildo-ai/saas-models';
+import { getLifecycleEvaluator, getLifecycleConfig } from '../../guidance/services/lifecycle-custom-implementations.backend.js';
+// ── Constants ────────────────────────────────────────────────────────
+const DEFAULT_DORMANCY_THRESHOLD_DAYS = 14;
+/** Max entities fetched per page per resource type. Paginated until exhausted or MAX_PAGES reached. */
+const DEFAULT_BATCH_SIZE = 100;
+const MAX_PAGES = 50;
+const MS_PER_DAY = 24 * 60 * 60 * 1000;
+const DORMANCY_CHECK_RESOURCE_TYPES = [
+    CoreResourceType.USER_LIFECYCLE_STATE,
+    CoreResourceType.ORGANIZATION_LIFECYCLE_STATE,
+];
+// ── Input/Output Schemas ─────────────────────────────────────────────
+const DormancyDetectionInputSchema = z.object({
+    dormancyThresholdDays: z.number().int().positive().optional(),
+    batchSize: z.number().int().positive().optional(),
+});
+const DormancyDetectionOutputSchema = z.object({
+    usersTransitioned: z.number().int().min(0),
+    orgsTransitioned: z.number().int().min(0),
+    totalProcessed: z.number().int().min(0),
+    durationMs: z.number().int().min(0),
+});
+// ── Batch Factory ────────────────────────────────────────────────────
+/** @param cronSchedule — from LifecycleConfig.dormancyCronSchedule (flows from appConfig) */
+export function createDormancyDetectionBatch(cronSchedule = '0 */6 * * *') {
+    return createCustomBatchExecutionService({
+        input: DormancyDetectionInputSchema,
+        output: DormancyDetectionOutputSchema,
+        batchCronjob_Context: {
+            resourceIdentifier: CoreResourceType.USER_LIFECYCLE_STATE,
+            operationIdentifier: CoreResourceOperation.UPDATE,
+            cronJobExpression: cronSchedule,
+        },
+        doHandle: async (input, params) => {
+            const startTime = Date.now();
+            const { repositoriesRegistry, logger, executionContext } = params;
+            const evaluator = getLifecycleEvaluator();
+            const lifecycleConfig = getLifecycleConfig();
+            const thresholdDays = input.dormancyThresholdDays
+                ?? lifecycleConfig.dormancyThresholdDays
+                ?? DEFAULT_DORMANCY_THRESHOLD_DAYS;
+            const batchSize = input.batchSize ?? DEFAULT_BATCH_SIZE;
+            const cutoffDate = new Date(Date.now() - thresholdDays * MS_PER_DAY);
+            const counts = { users: 0, orgs: 0 };
+            for (const resourceType of DORMANCY_CHECK_RESOURCE_TYPES) {
+                const repo = repositoriesRegistry.getRepository(resourceType);
+                let pageCount = 0;
+                let totalProcessedForType = 0;
+                let hasMore = true;
+                while (hasMore && pageCount < MAX_PAGES) {
+                    // Always skip=0: processed entities transition to DORMANT and drop out of the query,
+                    // so the next iteration naturally returns the next batch.
+                    const result = await repo.list(executionContext, {
+                        currentStage: { $in: LIFECYCLE_DORMANCY_SOURCE_STAGES },
+                        lastActiveAt: { $lt: cutoffDate },
+                    }, { paginated: true, listOptions: { limit: batchSize } });
+                    for (const state of result.data) {
+                        try {
+                            await evaluator.transitionToDormant(resourceType, state._id, executionContext, cutoffDate);
+                            if (resourceType === CoreResourceType.USER_LIFECYCLE_STATE)
+                                counts.users++;
+                            else
+                                counts.orgs++;
+                            totalProcessedForType++;
+                        }
+                        catch (error) {
+                            logger.warn('Dormancy transition failed', {
+                                resourceType, stateId: state._id,
+                                error: isWildoBackendError(error) ? String(error) : (error instanceof Error ? error.message : 'Unknown'),
+                            });
+                        }
+                    }
+                    pageCount++;
+                    hasMore = result.data.length === batchSize;
+                }
+                if (pageCount >= MAX_PAGES) {
+                    logger.warn('Dormancy detection hit max page cap', { resourceType, pageCount, totalProcessedForType });
+                }
+            }
+            const durationMs = Date.now() - startTime;
+            const totalProcessed = counts.users + counts.orgs;
+            logger.info('Dormancy detection batch completed', {
+                ...counts, totalProcessed, durationMs, thresholdDays,
+            });
+            return {
+                usersTransitioned: counts.users,
+                orgsTransitioned: counts.orgs,
+                totalProcessed,
+                durationMs,
+            };
+        },
+    });
+}
+export const DORMANCY_DETECTION_BATCH_REF = 'lifecycle:dormancy-detection';
+//# sourceMappingURL=dormancy-detection.batch.backend.service.js.map

package/dist/esm/guidance/batches/dormancy-detection.batch.backend.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dormancy-detection.batch.backend.service.js","sourceRoot":"","sources":["../../../../src/guidance/batches/dormancy-detection.batch.backend.service.ts"],"names":[],"mappings":"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"}

package/dist/esm/guidance/services/guidance-trigger-evaluator.backend.service.d.ts

@@ -0,0 +1,41 @@
+import 'reflect-metadata';
+import type { GuidanceFlowDefinition } from '@wildo-ai/saas-models';
+import { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+import { WebSocketService } from '../../requests/service/websocket.service.js';
+export interface GuidanceTriggerEvaluateParams {
+    resourceType: string;
+    operationIdentifier: string;
+    guidanceFlows: GuidanceFlowDefinition[];
+    userId: string;
+    organizationId?: string;
+}
+export declare class GuidanceTriggerEvaluatorBackendService {
+    private readonly logger;
+    private readonly webSocketService;
+    private logDebug;
+    private registeredFlows;
+    constructor(logger: LoggerService, webSocketService: WebSocketService);
+    /**
+     * Register guidance flow definitions at startup.
+     * Called by StartApplicationBackendService during initialization,
+     * following the same pattern as ChartRegistryBackendService.
+     */
+    initializeFlows(flows: GuidanceFlowDefinition[]): void;
+    /**
+     * Convenience method for pipeline integration.
+     * Uses guidance flows registered at startup via initializeFlows().
+     */
+    evaluateForOperation(params: {
+        resourceType: string;
+        operationIdentifier: string;
+        userId: string;
+        organizationId?: string;
+    }): Promise<void>;
+    /**
+     * Evaluate all guidance flows for EVENT-type triggers that match a backend resource operation.
+     * For each match, push a GUIDANCE_STATE_CHANGED WS event to the appropriate identity room.
+     * This is designed to be called fire-and-forget after successful resource operations.
+     */
+    evaluateEventTrigger(params: GuidanceTriggerEvaluateParams): Promise<void>;
+}
+//# sourceMappingURL=guidance-trigger-evaluator.backend.service.d.ts.map

package/dist/esm/guidance/services/guidance-trigger-evaluator.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guidance-trigger-evaluator.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/guidance/services/guidance-trigger-evaluator.backend.service.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAQ1B,OAAO,KAAK,EACV,sBAAsB,EAEvB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAC7F,OAAO,EAAE,gBAAgB,EAAoB,MAAM,uDAAuD,CAAC;AAE3G,MAAM,WAAW,6BAA6B;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,EAAE,sBAAsB,EAAE,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,qBACa,sCAAsC;IAMZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IACb,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IALhF,OAAO,CAAC,QAAQ,CAA+D;IAC/E,OAAO,CAAC,eAAe,CAAgC;gBAGD,MAAM,EAAE,aAAa,EACX,gBAAgB,EAAE,gBAAgB;IAMlG;;;;OAIG;IACI,eAAe,CAAC,KAAK,EAAE,sBAAsB,EAAE,GAAG,IAAI;IAK7D;;;OAGG;IACU,oBAAoB,CAAC,MAAM,EAAE;QACxC,YAAY,EAAE,MAAM,CAAC;QACrB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,IAAI,CAAC;IAejB;;;;OAIG;IACU,oBAAoB,CAAC,MAAM,EAAE,6BAA6B,GAAG,OAAO,CAAC,IAAI,CAAC;CAwExF"}

package/dist/esm/guidance/services/guidance-trigger-evaluator.backend.service.js

@@ -0,0 +1,135 @@
+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 } from 'inversify';
+import { CoreWebSocketEvent, OnboardingStatus, OnboardingTriggerType, isWildoBackendError, } from '@wildo-ai/saas-models';
+import { GuidanceFlowScope } from '@wildo-ai/saas-models';
+import { SAAS_SERVICE_TYPES } from '../../inject/models/service-types.js';
+import { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+import { WebSocketService } from '../../requests/service/websocket.service.js';
+let GuidanceTriggerEvaluatorBackendService = class GuidanceTriggerEvaluatorBackendService {
+    logger;
+    webSocketService;
+    logDebug;
+    registeredFlows = [];
+    constructor(logger, webSocketService) {
+        this.logger = logger;
+        this.webSocketService = webSocketService;
+        this.logDebug = this.logger.debugByType('GuidanceTriggerEvaluator');
+        this.logger.setDebugTypeLogging('GuidanceTriggerEvaluator', false);
+    }
+    /**
+     * Register guidance flow definitions at startup.
+     * Called by StartApplicationBackendService during initialization,
+     * following the same pattern as ChartRegistryBackendService.
+     */
+    initializeFlows(flows) {
+        this.registeredFlows = [...flows];
+        this.logDebug('Guidance flows registered', { count: flows.length });
+    }
+    /**
+     * Convenience method for pipeline integration.
+     * Uses guidance flows registered at startup via initializeFlows().
+     */
+    async evaluateForOperation(params) {
+        try {
+            if (this.registeredFlows.length === 0)
+                return;
+            await this.evaluateEventTrigger({
+                ...params,
+                guidanceFlows: this.registeredFlows,
+            });
+        }
+        catch (error) {
+            this.logger.warn('Failed to evaluate guidance triggers from app config', {
+                error: isWildoBackendError(error) ? String(error) : (error instanceof Error ? error.message : String(error)),
+            });
+        }
+    }
+    /**
+     * Evaluate all guidance flows for EVENT-type triggers that match a backend resource operation.
+     * For each match, push a GUIDANCE_STATE_CHANGED WS event to the appropriate identity room.
+     * This is designed to be called fire-and-forget after successful resource operations.
+     */
+    async evaluateEventTrigger(params) {
+        const { resourceType, operationIdentifier, guidanceFlows, userId, organizationId } = params;
+        const eventName = `${resourceType}:${operationIdentifier}`;
+        const matchingFlows = guidanceFlows.filter(flow => flow.trigger.type === OnboardingTriggerType.EVENT &&
+            flow.trigger.eventName === eventName);
+        if (matchingFlows.length === 0) {
+            return;
+        }
+        this.logDebug('Matched guidance flows for event trigger', {
+            eventName,
+            matchCount: matchingFlows.length,
+            flowRefs: matchingFlows.map(f => f.ref),
+        });
+        for (const flow of matchingFlows) {
+            const payload = {
+                flowRef: flow.ref,
+                status: OnboardingStatus.IN_PROGRESS,
+                triggerSource: 'backend',
+                scope: flow.scope ?? GuidanceFlowScope.USER,
+            };
+            const wsMessage = {
+                type: CoreWebSocketEvent.GUIDANCE_STATE_CHANGED,
+                payload,
+                timestamp: new Date(),
+            };
+            try {
+                const scope = flow.scope ?? GuidanceFlowScope.USER;
+                switch (scope) {
+                    case GuidanceFlowScope.USER:
+                        if (!userId) {
+                            this.logger.warn('Guidance flow has USER scope but no userId provided', {
+                                flowRef: flow.ref,
+                            });
+                            break;
+                        }
+                        await this.webSocketService.sendToUser(userId, wsMessage);
+                        break;
+                    case GuidanceFlowScope.ORGANIZATION:
+                        if (organizationId) {
+                            await this.webSocketService.sendToOrganization(organizationId, wsMessage);
+                        }
+                        else {
+                            this.logger.warn('Guidance flow has ORGANIZATION scope but no organizationId provided', {
+                                flowRef: flow.ref,
+                            });
+                        }
+                        break;
+                }
+                this.logDebug('Pushed guidance state changed event', {
+                    flowRef: flow.ref,
+                    scope,
+                    eventName,
+                });
+            }
+            catch (error) {
+                this.logger.warn('Failed to push guidance state changed event', {
+                    flowRef: flow.ref,
+                    error: isWildoBackendError(error) ? String(error) : (error instanceof Error ? error.message : String(error)),
+                });
+            }
+        }
+    }
+};
+GuidanceTriggerEvaluatorBackendService = __decorate([
+    injectable(),
+    __param(0, inject(SAAS_SERVICE_TYPES.Logger)),
+    __param(1, inject(SAAS_SERVICE_TYPES.WebSocketService)),
+    __metadata("design:paramtypes", [LoggerService,
+        WebSocketService])
+], GuidanceTriggerEvaluatorBackendService);
+export { GuidanceTriggerEvaluatorBackendService };
+//# sourceMappingURL=guidance-trigger-evaluator.backend.service.js.map

package/dist/esm/guidance/services/guidance-trigger-evaluator.backend.service.js.map

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

package/dist/esm/guidance/services/lifecycle-custom-implementations.backend.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Lifecycle Custom Implementations — Aggregator + Late-Binding Setup
+ *
+ * Follows billing-custom-implementations.backend.ts pattern exactly:
+ * - Factory functions registered at startup (before lifecycle is initialized)
+ * - Handler functions execute at operation time (after lifecycle is initialized)
+ * - initializeLifecycleCustomImplementations() called during startup
+ *
+ * Uses createResourceCustomServiceImplementation() from the factory module
+ * (same as subscription.mutations.custom-impl.backend.service.ts)
+ */
+import type { LifecycleConfig } from '@wildo-ai/saas-models';
+import { type ResourceCustomServiceImplementationFactory } from '../../base-classes/services/services/resource-operation-custom-implementation.factory.backend.js';
+import type { ErrorBuilderBackendService } from '../../errors/services/error-builder.backend.service.js';
+import type { LifecycleEvaluatorBackendService } from './lifecycle-evaluator.backend.service.js';
+/**
+ * Initialize lifecycle custom implementation dependencies.
+ * Called from start-application after the lifecycle evaluator is configured.
+ * Must be called before any lifecycle custom operation executes.
+ */
+export declare function initializeLifecycleCustomImplementations(evaluator: LifecycleEvaluatorBackendService, config: LifecycleConfig, errorBuilder: ErrorBuilderBackendService): void;
+/**
+ * Get the lifecycle evaluator (lazy — resolved at operation execution time).
+ * @throws if initializeLifecycleCustomImplementations() has not been called
+ */
+export declare function getLifecycleEvaluator(): LifecycleEvaluatorBackendService;
+/**
+ * Get the lifecycle config (lazy — resolved at operation execution time).
+ * @throws if initializeLifecycleCustomImplementations() has not been called
+ */
+export declare function getLifecycleConfig(): LifecycleConfig;
+export declare const lifecycleCustomImplementations: ResourceCustomServiceImplementationFactory[];
+//# sourceMappingURL=lifecycle-custom-implementations.backend.d.ts.map

package/dist/esm/guidance/services/lifecycle-custom-implementations.backend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-custom-implementations.backend.d.ts","sourceRoot":"","sources":["../../../../src/guidance/services/lifecycle-custom-implementations.backend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAEL,KAAK,0CAA0C,EAChD,MAAM,4GAA4G,CAAC;AAEpH,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,kEAAkE,CAAC;AACnH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,uCAAuC,CAAC;AAQ9F;;;;GAIG;AACH,wBAAgB,wCAAwC,CACtD,SAAS,EAAE,gCAAgC,EAC3C,MAAM,EAAE,eAAe,EACvB,YAAY,EAAE,0BAA0B,GACvC,IAAI,CAIN;AAaD;;;GAGG;AACH,wBAAgB,qBAAqB,IAAI,gCAAgC,CAOxE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAOpD;AAmDD,eAAO,MAAM,8BAA8B,EAAE,0CAA0C,EAEtF,CAAC"}

package/dist/esm/guidance/services/lifecycle-custom-implementations.backend.js

@@ -0,0 +1,105 @@
+/**
+ * Lifecycle Custom Implementations — Aggregator + Late-Binding Setup
+ *
+ * Follows billing-custom-implementations.backend.ts pattern exactly:
+ * - Factory functions registered at startup (before lifecycle is initialized)
+ * - Handler functions execute at operation time (after lifecycle is initialized)
+ * - initializeLifecycleCustomImplementations() called during startup
+ *
+ * Uses createResourceCustomServiceImplementation() from the factory module
+ * (same as subscription.mutations.custom-impl.backend.service.ts)
+ */
+import { CoreResourceType, CoreResourceOperation, ResourceOperationVariantType, LifecycleStage, ErrorType, ErrorCustomMessageReference, } from '@wildo-ai/saas-models';
+import { createResourceCustomServiceImplementation, } from '../../base-classes/services/services/resource-operation-custom-implementation.factory.backend.js';
+// ── Late-Binding References ──────────────────────────────────────────
+let _lifecycleEvaluator = null;
+let _lifecycleConfig = null;
+let _errorBuilder = null;
+/**
+ * Initialize lifecycle custom implementation dependencies.
+ * Called from start-application after the lifecycle evaluator is configured.
+ * Must be called before any lifecycle custom operation executes.
+ */
+export function initializeLifecycleCustomImplementations(evaluator, config, errorBuilder) {
+    _lifecycleEvaluator = evaluator;
+    _lifecycleConfig = config;
+    _errorBuilder = errorBuilder;
+}
+/** Throw a CONFIGURATION WildoError_Backend, or fall back to plain Error if error builder itself isn't initialized yet. */
+function throwLifecycleNotInitialized(message) {
+    if (_errorBuilder) {
+        throw _errorBuilder.buildError(ErrorType.CONFIGURATION, undefined, {
+            customMessageReference: ErrorCustomMessageReference.CONFIGURATION,
+            context: { message },
+        });
+    }
+    throw new Error(message);
+}
+/**
+ * Get the lifecycle evaluator (lazy — resolved at operation execution time).
+ * @throws if initializeLifecycleCustomImplementations() has not been called
+ */
+export function getLifecycleEvaluator() {
+    if (!_lifecycleEvaluator) {
+        throwLifecycleNotInitialized('Lifecycle evaluator not initialized — initializeLifecycleCustomImplementations() must be called first');
+    }
+    return _lifecycleEvaluator;
+}
+/**
+ * Get the lifecycle config (lazy — resolved at operation execution time).
+ * @throws if initializeLifecycleCustomImplementations() has not been called
+ */
+export function getLifecycleConfig() {
+    if (!_lifecycleConfig) {
+        throwLifecycleNotInitialized('Lifecycle config not initialized — initializeLifecycleCustomImplementations() must be called first');
+    }
+    return _lifecycleConfig;
+}
+// ── Lifecycle state resource types (const) ───────────────────────────
+const LIFECYCLE_STATE_RESOURCE_TYPES = [
+    CoreResourceType.USER_LIFECYCLE_STATE,
+    CoreResourceType.ORGANIZATION_LIFECYCLE_STATE,
+];
+// ── Custom Implementation Factories ──────────────────────────────────
+/** READ POSTFIX on all lifecycle state resources:
+ *  When a dormant user's frontend loads and fetches lifecycle state,
+ *  detect dormancy → trigger reactivation for instant UX.
+ *
+ *  Uses createResourceCustomServiceImplementation() with proper operationPath
+ *  (same pattern as subscription.mutations.custom-impl.backend.service.ts) */
+function createLifecycleStateReadReactivationFactories() {
+    return LIFECYCLE_STATE_RESOURCE_TYPES.map((resourceType) => {
+        const factory = (_resourcesRegistryService) => {
+            return createResourceCustomServiceImplementation({
+                operationPath: {
+                    resourceIdentifier: resourceType,
+                    operationIdentifier: CoreResourceOperation.READ,
+                    variantType: ResourceOperationVariantType.API_CALL,
+                    isOperationDefault: true,
+                },
+                handlers: {
+                    postfixCoreOperations: async (_id, result, executionContext, _operationPath, utils) => {
+                        const evaluator = getLifecycleEvaluator();
+                        if (result?.currentStage === LifecycleStage.DORMANT) {
+                            // Fire-and-forget reactivation — don't block the READ response
+                            setImmediate(() => {
+                                evaluator.handleReactivation(resourceType, _id, executionContext)
+                                    .catch(err => utils.logger.warn('On-read reactivation failed', {
+                                    resourceType, stateId: _id, error: String(err),
+                                }));
+                            });
+                        }
+                        return result;
+                    },
+                },
+            });
+        };
+        // Double cast follows billing pattern — factory signature mismatch with generic ResourceCustomServiceImplementationFactory
+        return factory;
+    });
+}
+// ── Aggregated exports ───────────────────────────────────────────────
+export const lifecycleCustomImplementations = [
+    ...createLifecycleStateReadReactivationFactories(),
+];
+//# sourceMappingURL=lifecycle-custom-implementations.backend.js.map

package/dist/esm/guidance/services/lifecycle-custom-implementations.backend.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-custom-implementations.backend.js","sourceRoot":"","sources":["../../../../src/guidance/services/lifecycle-custom-implementations.backend.ts"],"names":[],"mappings":"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"}

package/dist/esm/guidance/services/lifecycle-evaluator.backend.service.d.ts

@@ -0,0 +1,103 @@
+import 'reflect-metadata';
+import { CoreResourceType } from '@wildo-ai/saas-models';
+import type { LifecycleConfig, MilestoneLifecycleTransition } from '@wildo-ai/saas-models';
+import type { LoggerService } from '../../monitoring/logger/services/logger.service.js';
+import type { WebSocketService } from '../../requests/service/websocket.service.js';
+import type { RepositoriesRegistryHandlerBackendService } from '../../base-classes/services/repositories/repositories-registry-handler.backend.service.js';
+/**
+ * Lifecycle Evaluator Backend Service
+ *
+ * Pipeline integration entry point for lifecycle state evaluation.
+ * Called fire-and-forget after milestone evaluation in the operation pipeline.
+ *
+ * Handles:
+ * - Activity tracking (debounced per scope:id, ~30 min)
+ * - Reactivation detection (DORMANT → REACTIVATED on any operation)
+ * - Engagement evaluation (ACTIVATED/REACTIVATED → ENGAGED if threshold met)
+ * - Activation criteria evaluation (SIGNED_UP → ACTIVATED via milestone achievements)
+ * - Dormancy transitions (called by dormancy detection batch)
+ * - On-read reactivation (called by READ POSTFIX custom implementation)
+ */
+export declare class LifecycleEvaluatorBackendService {
+    private readonly logger;
+    private readonly webSocketService;
+    private readonly repositoriesRegistry;
+    /** Debounce cache: scope:scopeId → last write timestamp (in-memory, per-instance) */
+    private activityDebounceCache;
+    private logDebug;
+    private lifecycleConfig;
+    constructor(logger: LoggerService, webSocketService: WebSocketService, repositoriesRegistry: RepositoriesRegistryHandlerBackendService);
+    /** Called at startup to inject lifecycle config from app config */
+    setLifecycleConfig(config: LifecycleConfig | undefined): void;
+    /**
+     * Pipeline integration: called fire-and-forget on every operation.
+     * Handles: activity tracking (debounced), reactivation detection, engagement evaluation.
+     * Updates ALL applicable scopes (user always, org if present).
+     */
+    onOperation(params: {
+        userId: string;
+        organizationId?: string;
+        operationIdentifier: string;
+        resourceIdentifier: string;
+        executionContext: unknown;
+    }): Promise<void>;
+    /** Evaluate a single scope on operation — activity + reactivation + engagement + guidance-based activation. */
+    private evaluateScopeOnOperation;
+    /** Evaluate activation criteria after a guidance state resource was updated.
+     *  Handles GUIDANCE_COMPLETED criteria for SIGNED_UP → ACTIVATED.
+     *  Uses atomicConditionalUpdate with currentStage guard to prevent double-activation
+     *  if both onMilestoneAchieved and this method fire concurrently. */
+    private evaluateGuidanceBasedActivation;
+    /**
+     * Called by MilestoneEvaluatorBackendService after a milestone is achieved.
+     * Handles: SIGNED_UP → ACTIVATED transition via activation criteria.
+     * Evaluates all applicable scopes.
+     */
+    onMilestoneAchieved(params: {
+        milestoneIdentifier: string;
+        milestoneLifecycleTransition?: MilestoneLifecycleTransition;
+        userId: string;
+        organizationId?: string;
+    }): Promise<void>;
+    /**
+     * Called by dormancy detection batch.
+     * Transitions a specific entity to DORMANT. Validates via LIFECYCLE_VALID_TRANSITIONS.
+     */
+    transitionToDormant(scopeResourceType: CoreResourceType, scopeId: string, executionContext: unknown, cutoffDate?: Date): Promise<void>;
+    /**
+     * Called by READ POSTFIX custom implementation on lifecycle state resources.
+     * Detects dormant user returning → triggers reactivation for instant UX.
+     */
+    handleReactivation(scopeResourceType: CoreResourceType, scopeId: string, executionContext: unknown): Promise<void>;
+    /** Resolve all applicable scopes for this operation context. */
+    private resolveApplicableScopes;
+    /** Resolve LifecycleScope from a resource type */
+    private resolveScope;
+    private applyTransition;
+    /**
+     * Atomically commit the canonical SIGNED_UP → ACTIVATED transition.
+     * This keeps milestone-driven and guidance-driven activation on the same
+     * compare-and-set path so concurrent activations cannot double-transition.
+     */
+    private tryActivateSignedUpLifecycleState;
+    private getLifecycleMongooseModel;
+    private shouldUpdateActivity;
+    /**
+     * Note: `daysSinceStageEntry` measures time since the *current* stage was
+     * entered (could be REACTIVATED, not ACTIVATED). Engagement counters are
+     * reset on reactivation (in `applyTransition`), so the threshold evaluation
+     * is accurate for each activation/reactivation cycle.
+     */
+    private isEngagementThresholdMet;
+    private evaluateActivationCriteria;
+    private evaluateSingleCriterion;
+    private loadOrCreateLifecycleState;
+    private loadLifecycleState;
+    private updateLifecycleState;
+    private loadProgressionState;
+    private loadGuidanceState;
+    /** Sanitize trigger for WS payload — hide internal operation identifiers */
+    private sanitizeTrigger;
+    private pushStageChanged;
+}
+//# sourceMappingURL=lifecycle-evaluator.backend.service.d.ts.map

package/dist/esm/guidance/services/lifecycle-evaluator.backend.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-evaluator.backend.service.d.ts","sourceRoot":"","sources":["../../../../src/guidance/services/lifecycle-evaluator.backend.service.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAG1B,OAAO,EAEL,gBAAgB,EAcjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAEV,eAAe,EAMf,4BAA4B,EAE7B,MAAM,uBAAuB,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8DAA8D,CAAC;AAClG,OAAO,KAAK,EAAE,gBAAgB,EAAoB,MAAM,uDAAuD,CAAC;AAChH,OAAO,KAAK,EAAE,yCAAyC,EAAE,MAAM,qGAAqG,CAAC;AAiBrK;;;;;;;;;;;;;GAaG;AACH,qBACa,gCAAgC;IAUN,OAAO,CAAC,QAAQ,CAAC,MAAM;IACb,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACf,OAAO,CAAC,QAAQ,CAAC,oBAAoB;IAVtG,qFAAqF;IACrF,OAAO,CAAC,qBAAqB,CAA6B;IAE1D,OAAO,CAAC,QAAQ,CAA+D;IAE/E,OAAO,CAAC,eAAe,CAA8B;gBAGC,MAAM,EAAE,aAAa,EACX,gBAAgB,EAAE,gBAAgB,EAChB,oBAAoB,EAAE,yCAAyC;IAMjJ,mEAAmE;IAC5D,kBAAkB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,GAAG,IAAI;IAQpE;;;;OAIG;IACU,WAAW,CAAC,MAAM,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,gBAAgB,EAAE,OAAO,CAAC;KAC3B,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjB,+GAA+G;YACjG,wBAAwB;IA4ItC;;;yEAGqE;YACvD,+BAA+B;IA4C7C;;;;OAIG;IACU,mBAAmB,CAAC,MAAM,EAAE;QACvC,mBAAmB,EAAE,MAAM,CAAC;QAC5B,4BAA4B,CAAC,EAAE,4BAA4B,CAAC;QAC5D,MAAM,EAAE,MAAM,CAAC;QACf,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,OAAO,CAAC,IAAI,CAAC;IAuEjB;;;OAGG;IACU,mBAAmB,CAC9B,iBAAiB,EAAE,gBAAgB,EACnC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,OAAO,EACzB,UAAU,CAAC,EAAE,IAAI,GAChB,OAAO,CAAC,IAAI,CAAC;IAoChB;;;OAGG;IACU,kBAAkB,CAC7B,iBAAiB,EAAE,gBAAgB,EACnC,OAAO,EAAE,MAAM,EACf,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAAC,IAAI,CAAC;IA0BhB,gEAAgE;IAChE,OAAO,CAAC,uBAAuB;IAoB/B,kDAAkD;IAClD,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,eAAe;IA2CvB;;;;OAIG;YACW,iCAAiC;IAqE/C,OAAO,CAAC,yBAAyB;IAUjC,OAAO,CAAC,oBAAoB;IAM5B;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;YAWlB,0BAA0B;IA2BxC,OAAO,CAAC,uBAAuB;YA2BjB,0BAA0B;YAkD1B,kBAAkB;YAuBlB,oBAAoB;YAwBpB,oBAAoB;YAuBpB,iBAAiB;IAuB/B,4EAA4E;IAC5E,OAAO,CAAC,eAAe;YAUT,gBAAgB;CA8C/B"}