@openhealth/oht-custom-parser-lib 0.3.13 → 0.4.0

package/dist/service/processingLogger.service.d.ts

@@ -1,158 +0,0 @@
-import pino from 'pino';
-/**
- * Returns a stable request id for the given context. Same id must be used for the whole request.
- * Used to key the registry so each request has isolated state.
- */
-export declare function getRequestIdFromContext(context: ProcessingContext): string;
-/**
- * Processing context interface - contains all context information for a processing cycle
- */
-export interface ProcessingContext {
-    fileName?: string;
-    fileUploadId?: string;
-    partnerId?: string;
-    partnerName?: string;
-    signedUploadId?: string;
-    cloudEventId?: string;
-    messageId?: string;
-    publishTime?: string;
-    fileMimeType?: string;
-    normalizerName?: string;
-    isPreview?: boolean;
-    reportPreviewId?: string;
-}
-/**
- * Stage duration interface - tracks timing for each processing stage
- */
-export interface StageDuration {
-    step: string;
-    percentage: number;
-    startTime: Date;
-    endTime?: Date;
-    durationMs?: number;
-    cumulativeDurationMs?: number;
-}
-/**
- * Processing state interface - internal state tracking for the logger
- */
-interface ProcessingState {
-    fileName?: string;
-    fileUploadId?: string;
-    partnerId?: string;
-    partnerName?: string;
-    signedUploadId?: string;
-    cloudEventId?: string;
-    messageId?: string;
-    publishTime?: string;
-    fileMimeType?: string;
-    normalizerName?: string;
-    isPreview?: boolean;
-    reportPreviewId?: string;
-    startTime?: Date;
-    endTime?: Date;
-    totalDurationMs?: number;
-    stages: StageDuration[];
-    currentStageStartTime?: Date;
-    currentStep?: string;
-    progressPercentage?: number;
-    measurementsCount?: number;
-    unknownMeasurementsCount?: number;
-    unknownUnitsCount?: number;
-    unmappedLabKeysCount?: number;
-    errors: Array<{
-        message: string;
-        step: string;
-        timestamp: Date;
-        error?: Error;
-    }>;
-    warnings: Array<{
-        message: string;
-        step: string;
-        timestamp: Date;
-    }>;
-    success?: boolean;
-    metadata?: Record<string, any>;
-}
-/**
- * ProcessingLoggerService - Singleton facade for request-scoped processing state and logging.
- *
- * State is keyed by request id (fileUploadId ?? messageId ?? cloudEventId) in a registry.
- * AsyncLocalStorage holds only the current request id; getMutableState() resolves state via
- * registry.get(id). When registry.get(id) is undefined (no context or stale id), a transient
- * empty state is used so one request never overwrites another's context.
- *
- * Entry point: runWithContextAsync(context, fn). Creates registry entry, runs fn with id in ALS,
- * removes entry in finally. Use logInfo, logWarn, logError, logDebug for application logs so they
- * include the same context and are searchable by fileUploadId/filename.
- *
- * Usage:
- * ```typescript
- * await runWithContextAsync(context, async () => {
- *   processingLogger.logStart();
- *   processingLogger.logProgress(20, 'get_transformation_rules');
- *   processingLogger.logEnd(true);
- * });
- * ```
- * Initial state is set from context by runWithContextAsync; clear() and setContext() are optional if you need to reset/override.
- */
-declare class ProcessingLoggerService {
-    private static instance;
-    private logger;
-    private constructor();
-    static getInstance(): ProcessingLoggerService;
-    /**
-     * Resolves state from registry by current request id. When registry.get(id) is undefined
-     * (no context or stale id), returns a transient clear state so one request never overwrites another's context.
-     */
-    private getMutableState;
-    /**
-     * Reset all state for a new processing cycle. Call at the start of each Cloud Event / request
-     * so that context and metrics from a previous request never leak.
-     * Clears both context fields and run state; call setContext(context) after clear() in handlers.
-     */
-    clear(): void;
-    /**
-     * Set context for the current processing cycle. Overwrites all context fields.
-     * Call after clear() for each new request.
-     */
-    setContext(context: ProcessingContext): void;
-    /** Public getter for tests / inspection; returns a deep copy so callers cannot mutate internal state. */
-    getState(): ProcessingState;
-    /**
-     * Replace the underlying logger (for testing only).
-     * Allows tests to inject a mock logger without mocking the module.
-     */
-    setLogger(logger: pino.Logger): void;
-    /**
-     * Context for the current log line (from request-scoped state when inside runWithContext).
-     */
-    private getLogContext;
-    logInfo(message: string, data?: Record<string, unknown>): void;
-    logWarn(message: string, data?: Record<string, unknown>): void;
-    logError(message: string, error?: Error, data?: Record<string, unknown>): void;
-    logDebug(message: string, data?: Record<string, unknown>): void;
-    private startStage;
-    private endStage;
-    logStart(): void;
-    logProgress(percentage: number, step: string): void;
-    addMeasurement(count: number, type: string): void;
-    addError(error: Error, step: string): void;
-    addWarning(message: string, step: string): void;
-    private calculateStageDurations;
-    private formatStageDurations;
-    logEnd(success: boolean): void;
-}
-export declare const processingLogger: ProcessingLoggerService;
-/**
- * Run handler logic inside a request-scoped context. State is keyed by request id in the registry;
- * ALS holds only the id. Call at the start of each Cloud Event / request after building the context.
- * @deprecated Prefer runWithContextAsync for async handlers.
- */
-export declare function runWithContext<T>(context: ProcessingContext, fn: () => T): T;
-/**
- * Async variant: run handler logic inside a request-scoped context. Each request gets its own state
- * in the registry keyed by request id; ALS holds only the id. Entry is removed in finally so one
- * request never overwrites another's context.
- */
-export declare function runWithContextAsync<T>(context: ProcessingContext, fn: () => Promise<T>): Promise<T>;
-export {};