@juspay/neurolink 9.54.2 → 9.54.4

package/dist/observability/exporters/langfuseExporter.js

@@ -2,7 +2,7 @@
  * Langfuse Exporter
  * Exports spans to Langfuse observability platform
  */
-import { SpanType } from "../types/spanTypes.js";
+import { SpanType } from "../../types/index.js";
 import { SpanSerializer } from "../utils/spanSerializer.js";
 import { BaseExporter } from "./baseExporter.js";
 /**

package/dist/observability/exporters/langsmithExporter.d.ts

@@ -2,7 +2,7 @@
  * LangSmith Exporter
  * Exports spans to LangSmith observability platform
  */
-import type { ExporterHealthStatus, ExportResult, LangSmithExporterConfig, SpanData } from "../types/index.js";
+import type { ExporterHealthStatus, ExportResult, LangSmithExporterConfig, SpanData } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * LangSmith exporter for LangChain ecosystem observability

package/dist/observability/exporters/otelExporter.d.ts

@@ -2,7 +2,7 @@
  * OpenTelemetry Exporter
  * Exports spans to OTLP-compatible backends
  */
-import type { ExporterHealthStatus, ExportResult, OtelExporterConfig, SpanData } from "../types/index.js";
+import type { ExporterHealthStatus, ExportResult, OtelExporterConfig, SpanData } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * OpenTelemetry exporter for OTLP-compatible backends

package/dist/observability/exporters/posthogExporter.d.ts

@@ -3,7 +3,7 @@
  * Exports spans to PostHog product analytics platform
  * @see https://posthog.com/docs/api
  */
-import type { ExporterHealthStatus, ExportResult, PostHogExporterConfig, SpanData } from "../types/index.js";
+import type { ExporterHealthStatus, ExportResult, PostHogExporterConfig, SpanData } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * PostHog exporter for product analytics and LLM event tracking

package/dist/observability/exporters/posthogExporter.js

@@ -4,7 +4,7 @@
  * @see https://posthog.com/docs/api
  */
 import { logger } from "../../utils/logger.js";
-import { SpanStatus, SpanType } from "../types/spanTypes.js";
+import { SpanStatus, SpanType } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * PostHog exporter for product analytics and LLM event tracking

package/dist/observability/exporters/sentryExporter.d.ts

@@ -2,7 +2,7 @@
  * Sentry Exporter
  * Exports spans to Sentry error tracking and performance platform
  */
-import type { ExporterHealthStatus, ExportResult, SentryExporterConfig, SpanData } from "../types/index.js";
+import type { ExporterHealthStatus, ExportResult, SentryExporterConfig, SpanData } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * Sentry exporter for error tracking and performance monitoring

package/dist/observability/exporters/sentryExporter.js

@@ -3,7 +3,7 @@
  * Exports spans to Sentry error tracking and performance platform
  */
 import { logger } from "../../utils/logger.js";
-import { SpanStatus } from "../types/spanTypes.js";
+import { SpanStatus } from "../../types/index.js";
 import { BaseExporter } from "./baseExporter.js";
 /**
  * Sentry exporter for error tracking and performance monitoring

package/dist/observability/index.d.ts

@@ -13,13 +13,11 @@ export { LangSmithExporter } from "./exporters/langsmithExporter.js";
 export { OtelExporter } from "./exporters/otelExporter.js";
 export { PostHogExporter } from "./exporters/posthogExporter.js";
 export { SentryExporter } from "./exporters/sentryExporter.js";
-export { getMetricsAggregator, type LatencyStats, MetricsAggregator, type MetricsAggregatorConfig, type MetricsSummary, type ModelCostStats, type ProviderCostStats, resetMetricsAggregator, type TimeWindowStats, } from "./metricsAggregator.js";
+export { getMetricsAggregator, MetricsAggregator, resetMetricsAggregator, } from "./metricsAggregator.js";
 export { OtelBridge } from "./otelBridge.js";
-export { BaseRetryPolicy, CircuitBreakerAwarePolicy, ExponentialBackoffPolicy, FixedDelayPolicy, LinearBackoffPolicy, NoRetryPolicy, type RetryContext, type RetryDecision, RetryExecutor, type RetryPolicy, RetryPolicyFactory, } from "./retryPolicy.js";
-export { AlwaysSampler, AttributeBasedSampler, CompositeSampler, CustomSampler, ErrorOnlySampler, NeverSampler, PrioritySampler, RatioSampler, type Sampler, SamplerFactory, TraceIdRatioSampler, } from "./sampling/samplers.js";
-export { AttributeEnrichmentProcessor, BatchProcessor, CompositeProcessor, FilterProcessor, PassThroughProcessor, RedactionProcessor, type SpanProcessor, SpanProcessorFactory, TruncationProcessor, } from "./spanProcessor.js";
-export { enrichSpanWithTokenUsage, getTokenTracker, type ModelPricing, type ModelTokenStats, type ProviderTokenStats, resetTokenTracker, TokenTracker, type TokenUsageStats, } from "./tokenTracker.js";
-export type { ArizeExporterConfig, BraintrustExporterConfig, DatadogExporterConfig, ExportError, ExporterConfig, ExporterHealthStatus, ExporterPlugin, ExportResult, ExtendedObservabilityConfig, LaminarExporterConfig, LangfuseExporterConfig, LangSmithExporterConfig, OtelExporterConfig, OtelProtocol, PostHogExporterConfig, SamplerConfig, SamplingRule, SentryExporterConfig, } from "./types/exporterTypes.js";
-export type { TraceView } from "./metricsAggregator.js";
-export { AGENT_ATTRIBUTES, GENAI_ATTRIBUTES, type LangfuseSpan, type LangSmithRun, type OtelSpan, type SpanAttributes, type SpanData, type SpanEvent, type SpanLink, SpanStatus, SpanType, } from "./types/spanTypes.js";
+export { BaseRetryPolicy, CircuitBreakerAwarePolicy, ExponentialBackoffPolicy, FixedDelayPolicy, LinearBackoffPolicy, NoRetryPolicy, RetryExecutor, RetryPolicyFactory, } from "./retryPolicy.js";
+export { AlwaysSampler, AttributeBasedSampler, CompositeSampler, CustomSampler, ErrorOnlySampler, NeverSampler, PrioritySampler, RatioSampler, SamplerFactory, TraceIdRatioSampler, } from "./sampling/samplers.js";
+export { AttributeEnrichmentProcessor, BatchProcessor, CompositeProcessor, FilterProcessor, PassThroughProcessor, RedactionProcessor, SpanProcessorFactory, TruncationProcessor, } from "./spanProcessor.js";
+export { enrichSpanWithTokenUsage, getTokenTracker, resetTokenTracker, TokenTracker, } from "./tokenTracker.js";
+export { AGENT_ATTRIBUTES, GENAI_ATTRIBUTES, SpanStatus, SpanType, } from "../types/index.js";
 export { SpanSerializer } from "./utils/spanSerializer.js";

package/dist/observability/index.js

@@ -26,6 +26,6 @@ export { AlwaysSampler, AttributeBasedSampler, CompositeSampler, CustomSampler,
 export { AttributeEnrichmentProcessor, BatchProcessor, CompositeProcessor, FilterProcessor, PassThroughProcessor, RedactionProcessor, SpanProcessorFactory, TruncationProcessor, } from "./spanProcessor.js";
 export { enrichSpanWithTokenUsage, getTokenTracker, resetTokenTracker, TokenTracker, } from "./tokenTracker.js";
 // Types
-export { AGENT_ATTRIBUTES, GENAI_ATTRIBUTES, SpanStatus, SpanType, } from "./types/spanTypes.js";
+export { AGENT_ATTRIBUTES, GENAI_ATTRIBUTES, SpanStatus, SpanType, } from "../types/index.js";
 // Utilities
 export { SpanSerializer } from "./utils/spanSerializer.js";

package/dist/observability/metricsAggregator.d.ts

@@ -1,66 +1,9 @@
-/**
- * Metrics Aggregator
- * Comprehensive metrics aggregation with latency percentiles, token usage, and cost tracking
- */
-import type { TokenUsageStats } from "./tokenTracker.js";
 import { TokenTracker } from "./tokenTracker.js";
-import type { SpanData } from "./types/spanTypes.js";
-/**
- * Latency statistics with percentile calculations
- */
-export type LatencyStats = {
-    /** Minimum latency in milliseconds */
-    min: number;
-    /** Maximum latency in milliseconds */
-    max: number;
-    /** Mean/average latency in milliseconds */
-    mean: number;
-    /** Median latency (p50) in milliseconds */
-    median: number;
-    /** 50th percentile latency in milliseconds */
-    p50: number;
-    /** 75th percentile latency in milliseconds */
-    p75: number;
-    /** 90th percentile latency in milliseconds */
-    p90: number;
-    /** 95th percentile latency in milliseconds */
-    p95: number;
-    /** 99th percentile latency in milliseconds */
-    p99: number;
-    /** Standard deviation in milliseconds */
-    stdDev: number;
-    /** Total number of samples */
-    count: number;
-};
-/**
- * Cost breakdown by provider
- */
-export type ProviderCostStats = {
-    provider: string;
-    totalCost: number;
-    requestCount: number;
-    avgCostPerRequest: number;
-    inputCost: number;
-    outputCost: number;
-};
-/**
- * Cost breakdown by model
- */
-export type ModelCostStats = {
-    model: string;
-    provider: string;
-    totalCost: number;
-    requestCount: number;
-    avgCostPerRequest: number;
-    inputTokens: number;
-    outputTokens: number;
-    inputCost: number;
-    outputCost: number;
-};
+import type { SpanData, TraceView, TokenUsageStats, LatencyStats, MetricsSummary, ModelCostStats, ProviderCostStats } from "../types/index.js";
 /**
  * Time window statistics
  */
-export type TimeWindowStats = {
+type TimeWindowStats = {
     windowStart: Date;
     windowEnd: Date;
     windowDurationMs: number;
@@ -73,58 +16,10 @@ export type TimeWindowStats = {
     costByProvider: Map<string, ProviderCostStats>;
     costByModel: Map<string, ModelCostStats>;
 };
-/**
- * Aggregated metrics summary
- */
-export type MetricsSummary = {
-    /** Total number of spans tracked */
-    totalSpans: number;
-    /** Number of successful spans */
-    successfulSpans: number;
-    /** Number of failed spans */
-    failedSpans: number;
-    /** Overall success rate (0-1) */
-    successRate: number;
-    /** Latency statistics */
-    latency: LatencyStats;
-    /** Token usage statistics */
-    tokens: TokenUsageStats;
-    /** Cost by provider */
-    costByProvider: ProviderCostStats[];
-    /** Cost by model */
-    costByModel: ModelCostStats[];
-    /** Total cost across all providers */
-    totalCost: number;
-    /** Span count by type */
-    spansByType: Record<string, number>;
-    /** Timestamp of first span */
-    firstSpanTime?: Date;
-    /** Timestamp of last span */
-    lastSpanTime?: Date;
-    /** Tracking duration in milliseconds */
-    trackingDurationMs?: number;
-};
-/**
- * Hierarchical trace view grouping related spans
- */
-export type TraceView = {
-    /** Trace identifier shared by all spans in this trace */
-    traceId: string;
-    /** The root/parent span of this trace */
-    rootSpan: SpanData;
-    /** Child spans linked to the root */
-    childSpans: SpanData[];
-    /** Total duration from first to last span */
-    totalDurationMs: number;
-    /** Total number of spans in this trace */
-    spanCount: number;
-    /** Overall trace status */
-    status: "ok" | "error" | "partial";
-};
 /**
  * Configuration for the metrics aggregator
  */
-export type MetricsAggregatorConfig = {
+type MetricsAggregatorConfig = {
     /** Maximum spans to retain in memory */
     maxSpansRetained?: number;
     /** Enable time-window statistics */
@@ -258,3 +153,4 @@ export declare function getMetricsAggregator(): MetricsAggregator;
  * Reset the global metrics aggregator (for testing)
  */
 export declare function resetMetricsAggregator(): void;
+export {};

package/dist/observability/metricsAggregator.js

@@ -1,7 +1,3 @@
-/**
- * Metrics Aggregator
- * Comprehensive metrics aggregation with latency percentiles, token usage, and cost tracking
- */
 import { TokenTracker } from "./tokenTracker.js";
 /**
  * Metrics Aggregator for comprehensive telemetry analysis

package/dist/observability/otelBridge.d.ts

@@ -3,8 +3,8 @@
  * Bidirectional context propagation between NeuroLink and OpenTelemetry
  */
 import { type Context, type SpanContext } from "@opentelemetry/api";
-import type { SpanData } from "./types/spanTypes.js";
-import { type SpanType } from "./types/spanTypes.js";
+import type { SpanData } from "../types/index.js";
+import { type SpanType } from "../types/index.js";
 /**
  * Bridge for bidirectional context propagation between
  * NeuroLink's observability system and OpenTelemetry

package/dist/observability/otelBridge.js

@@ -3,7 +3,7 @@
  * Bidirectional context propagation between NeuroLink and OpenTelemetry
  */
 import { context, propagation, trace, } from "@opentelemetry/api";
-import { SpanStatus } from "./types/spanTypes.js";
+import { SpanStatus } from "../types/index.js";
 import { SpanSerializer } from "./utils/spanSerializer.js";
 /**
  * Bridge for bidirectional context propagation between

package/dist/observability/retryPolicy.d.ts

@@ -2,33 +2,7 @@
  * Retry Policy
  * Configurable retry strategies for observability exporters
  */
-import type { RetryPolicy } from "../types/observability.js";
-/**
- * Result of a retry decision
- */
-export type RetryDecision = {
-    /** Whether to retry */
-    shouldRetry: boolean;
-    /** Delay before retry in milliseconds */
-    delayMs: number;
-    /** Reason for the decision */
-    reason: string;
-};
-/**
- * Context for retry decision making
- */
-export type RetryContext = {
-    /** Current attempt number (0-indexed) */
-    attempt: number;
-    /** The error that triggered the retry */
-    error: Error;
-    /** Total elapsed time since first attempt */
-    elapsedMs: number;
-    /** Operation name for logging */
-    operationName: string;
-    /** Additional metadata */
-    metadata?: Record<string, unknown>;
-};
+import type { RetryPolicy, RetryContext, RetryDecision } from "../types/index.js";
 export type { RetryPolicy };
 /**
  * Base retry policy with common configuration

package/dist/observability/sampling/index.d.ts

@@ -1,4 +1,4 @@
 /**
  * Sampling strategies exports
  */
-export { AlwaysSampler, AttributeBasedSampler, CompositeSampler, CustomSampler, ErrorOnlySampler, NeverSampler, PrioritySampler, RatioSampler, type Sampler, SamplerFactory, TraceIdRatioSampler, } from "./samplers.js";
+export { AlwaysSampler, AttributeBasedSampler, CompositeSampler, CustomSampler, ErrorOnlySampler, NeverSampler, PrioritySampler, RatioSampler, SamplerFactory, TraceIdRatioSampler, } from "./samplers.js";

package/dist/observability/sampling/samplers.d.ts

@@ -2,9 +2,7 @@
  * Sampling Strategies
  * Control which spans are exported for production optimization
  */
-import type { SamplerConfig, SamplingRule } from "../types/exporterTypes.js";
-import type { SpanData } from "../types/spanTypes.js";
-import type { Sampler } from "../../types/observability.js";
+import type { SamplerConfig, SamplingRule, SpanData, Sampler } from "../../types/index.js";
 export type { Sampler };
 /**
  * Always sample all spans

package/dist/observability/sampling/samplers.js

@@ -2,7 +2,7 @@
  * Sampling Strategies
  * Control which spans are exported for production optimization
  */
-import { SpanStatus } from "../types/spanTypes.js";
+import { SpanStatus } from "../../types/index.js";
 /**
  * Always sample all spans
  */

package/dist/observability/spanProcessor.d.ts

@@ -3,8 +3,7 @@
  * Handles span processing before export - enrichment, filtering, and transformation
  * Fills the 9% gap in pattern compliance
  */
-import type { SpanAttributes, SpanData } from "./types/index.js";
-import type { SpanProcessor } from "../types/observability.js";
+import type { SpanAttributes, SpanData, SpanProcessor } from "../types/index.js";
 export type { SpanProcessor };
 /**
  * No-op processor that passes spans through unchanged

package/dist/observability/tokenTracker.d.ts

@@ -2,50 +2,11 @@
  * Token Usage Tracker
  * Aggregates token usage and cost across spans
  */
-import type { SpanData } from "./types/spanTypes.js";
-/**
- * Token usage statistics by provider
- */
-export type ProviderTokenStats = {
-    provider: string;
-    inputTokens: number;
-    outputTokens: number;
-    totalTokens: number;
-    cost: number;
-    requestCount: number;
-};
-/**
- * Token usage statistics by model
- */
-export type ModelTokenStats = {
-    model: string;
-    provider: string;
-    inputTokens: number;
-    outputTokens: number;
-    totalTokens: number;
-    cost: number;
-    requestCount: number;
-    avgTokensPerRequest: number;
-};
-/**
- * Aggregated token usage statistics
- */
-export type TokenUsageStats = {
-    totalInputTokens: number;
-    totalOutputTokens: number;
-    totalTokens: number;
-    cacheReadTokens: number;
-    cacheCreationTokens: number;
-    reasoningTokens: number;
-    totalCost: number;
-    byProvider: Map<string, ProviderTokenStats>;
-    byModel: Map<string, ModelTokenStats>;
-    bySpanType: Map<string, number>;
-};
+import type { SpanData, TokenUsageStats } from "../types/index.js";
 /**
  * Model pricing information
  */
-export type ModelPricing = {
+type ModelPricing = {
     inputPricePerMillion: number;
     outputPricePerMillion: number;
     cachedInputPricePerMillion?: number;
@@ -154,3 +115,4 @@ export declare function getTokenTracker(): TokenTracker;
  * Reset the global token tracker (for testing)
  */
 export declare function resetTokenTracker(): void;
+export {};

package/dist/observability/utils/safeMetadata.d.ts

@@ -5,6 +5,6 @@
  * metadata. User prompts (input), LLM responses (output), error stacks, and
  * any other potentially sensitive data are excluded to prevent PII leaks.
  */
-import type { SpanAttributes } from "../types/spanTypes.js";
+import type { SpanAttributes } from "../../types/index.js";
 export declare const SAFE_METADATA_KEYS: Set<string>;
 export declare function filterSafeMetadata(attributes: SpanAttributes): Record<string, unknown>;

package/dist/observability/utils/spanSerializer.d.ts

@@ -2,7 +2,7 @@
  * Utility class for span creation and serialization
  * Handles conversion between NeuroLink's span format and platform-specific formats
  */
-import { type LangfuseSpan, type LangSmithRun, type OtelSpan, type SpanAttributes, type SpanData, SpanStatus, SpanType } from "../types/index.js";
+import { type LangfuseSpan, type LangSmithRun, type OtelSpan, type SpanAttributes, type SpanData, SpanStatus, SpanType } from "../../types/index.js";
 /**
  * Utility class for span creation and serialization
  */

package/dist/observability/utils/spanSerializer.js

@@ -3,7 +3,7 @@
  * Handles conversion between NeuroLink's span format and platform-specific formats
  */
 import { randomBytes } from "node:crypto";
-import { SpanStatus, SpanType, } from "../types/index.js";
+import { SpanStatus, SpanType, } from "../../types/index.js";
 /**
  * Utility class for span creation and serialization
  */

package/dist/processors/archive/ArchiveProcessor.d.ts

@@ -36,48 +36,7 @@
  * ```
  */
 import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
-import type { FileInfo, FileProcessingResult, ProcessedFileBase, ProcessOptions } from "../base/types.js";
-/**
- * Supported archive format identifiers.
- */
-export type ArchiveFormat = "zip" | "tar" | "tar.gz" | "tar.bz2" | "gz" | "rar" | "7z";
-/**
- * Metadata about an individual entry within an archive.
- */
-export type ArchiveEntry = {
-    /** Relative path/name of the entry within the archive */
-    name: string;
-    /** Uncompressed size in bytes */
-    uncompressedSize: number;
-    /** Compressed size in bytes (0 if unknown) */
-    compressedSize: number;
-    /** Whether this entry is a directory */
-    isDirectory: boolean;
-};
-/**
- * Processed archive result.
- * Extends ProcessedFileBase with archive-specific metadata, entry listing,
- * and any security warnings encountered during processing.
- */
-export type ProcessedArchive = ProcessedFileBase & {
-    /** Structured text content describing the archive for LLM consumption */
-    textContent: string;
-    /** High-level archive metadata */
-    archiveMetadata: {
-        /** Detected archive format */
-        format: ArchiveFormat;
-        /** Total number of entries (files + directories) */
-        totalEntries: number;
-        /** Sum of uncompressed sizes across all entries in bytes */
-        totalUncompressedSize: number;
-        /** Sum of compressed sizes across all entries in bytes */
-        totalCompressedSize: number;
-    };
-    /** Individual entry metadata */
-    entries: ArchiveEntry[];
-    /** Security warnings raised during processing (non-fatal) */
-    securityWarnings: string[];
-};
+import type { FileInfo, ProcessedArchive, ProcessorFileProcessingResult, ProcessOptions } from "../../types/index.js";
 /**
  * Archive Processor - handles ZIP, TAR, TAR.GZ, and plain GZ files.
  *
@@ -125,7 +84,7 @@ export declare class ArchiveProcessor extends BaseFileProcessor<ProcessedArchive
      * @param options - Optional processing options (auth headers, timeout, etc.)
      * @returns Processing result with archive metadata and entry listing, or error
      */
-    processFile(fileInfo: FileInfo, options?: ProcessOptions): Promise<FileProcessingResult<ProcessedArchive>>;
+    processFile(fileInfo: FileInfo, options?: ProcessOptions): Promise<ProcessorFileProcessingResult<ProcessedArchive>>;
     /**
      * Detect the archive format using magic bytes and file extension.
      * Magic bytes take precedence over extension when available.
@@ -324,4 +283,4 @@ export declare function isArchiveFile(mimetype: string, filename: string): boole
  * }
  * ```
  */
-export declare function processArchive(fileInfo: FileInfo, options?: ProcessOptions): Promise<FileProcessingResult<ProcessedArchive>>;
+export declare function processArchive(fileInfo: FileInfo, options?: ProcessOptions): Promise<ProcessorFileProcessingResult<ProcessedArchive>>;

package/dist/processors/archive/ArchiveProcessor.js

@@ -40,6 +40,9 @@ import { BaseFileProcessor } from "../base/BaseFileProcessor.js";
 import { SIZE_LIMITS_MB } from "../config/index.js";
 import { FileErrorCode } from "../errors/index.js";
 // =============================================================================
+// TYPES
+// =============================================================================
+// =============================================================================
 // SECURITY CONFIGURATION
 // =============================================================================
 /**

package/dist/processors/archive/index.d.ts

@@ -30,4 +30,4 @@
  * }
  * ```
  */
-export { type ArchiveEntry, type ArchiveFormat, ArchiveProcessor, archiveProcessor, isArchiveFile, type ProcessedArchive, processArchive, } from "./ArchiveProcessor.js";
+export { ArchiveProcessor, archiveProcessor, isArchiveFile, processArchive, } from "./ArchiveProcessor.js";

package/dist/processors/archive/index.js

@@ -34,6 +34,7 @@
 // ARCHIVE PROCESSOR
 // =============================================================================
 export { 
+// Types
 // Class
 ArchiveProcessor, 
 // Singleton instance

package/dist/processors/base/BaseFileProcessor.d.ts

@@ -44,7 +44,7 @@
  * ```
  */
 import { FileErrorCode } from "../errors/index.js";
-import type { BatchProcessingSummary, FileInfo, FileProcessingError, FileProcessingResult, FileProcessorConfig, OperationResult, ProcessedFileBase, ProcessOptions } from "./types.js";
+import type { BatchProcessingSummary, FileInfo, FileProcessingError, ProcessorFileProcessingResult, FileProcessorConfig, ProcessorOperationResult, ProcessedFileBase, ProcessOptions } from "../../types/index.js";
 /**
  * Abstract base class for file processors.
  * Provides common download, validation, and error handling functionality.
@@ -91,7 +91,7 @@ export declare abstract class BaseFileProcessor<T extends ProcessedFileBase> {
      * }
      * ```
      */
-    processFile(fileInfo: FileInfo, options?: ProcessOptions): Promise<FileProcessingResult<T>>;
+    processFile(fileInfo: FileInfo, options?: ProcessOptions): Promise<ProcessorFileProcessingResult<T>>;
     /**
      * Process multiple files with detailed summary.
      *
@@ -154,7 +154,7 @@ export declare abstract class BaseFileProcessor<T extends ProcessedFileBase> {
      * @param fileInfo - Original file information
      * @returns Success result or error result
      */
-    protected validateDownloadedFileWithResult(buffer: Buffer, fileInfo: FileInfo): Promise<OperationResult<void>>;
+    protected validateDownloadedFileWithResult(buffer: Buffer, fileInfo: FileInfo): Promise<ProcessorOperationResult<void>>;
     /**
      * Build processed result with structured error handling.
      * Override for custom result building that can fail with errors.
@@ -163,7 +163,7 @@ export declare abstract class BaseFileProcessor<T extends ProcessedFileBase> {
      * @param fileInfo - Original file information
      * @returns Success result with data or error result
      */
-    protected buildProcessedResultWithResult(buffer: Buffer, fileInfo: FileInfo): Promise<FileProcessingResult<T>>;
+    protected buildProcessedResultWithResult(buffer: Buffer, fileInfo: FileInfo): Promise<ProcessorFileProcessingResult<T>>;
     /**
      * Get filename with default fallback.
      *
@@ -188,14 +188,14 @@ export declare abstract class BaseFileProcessor<T extends ProcessedFileBase> {
      * @param options - Processing options including auth headers and retry config
      * @returns Success result with buffer or error result
      */
-    protected downloadFileWithRetry(fileInfo: FileInfo, options?: ProcessOptions): Promise<OperationResult<Buffer>>;
+    protected downloadFileWithRetry(fileInfo: FileInfo, options?: ProcessOptions): Promise<ProcessorOperationResult<Buffer>>;
     /**
      * Validate file type and size with structured error result.
      *
      * @param fileInfo - File information to validate
      * @returns Success result or error result
      */
-    protected validateFileWithResult(fileInfo: FileInfo): OperationResult<void>;
+    protected validateFileWithResult(fileInfo: FileInfo): ProcessorOperationResult<void>;
     /**
      * Validate file size against configured maximum.
      *

package/dist/processors/base/BaseFileProcessor.js

@@ -48,7 +48,7 @@ import { gunzip } from "zlib";
 import { SIZE_LIMITS } from "../config/index.js";
 import { isAbortError } from "../../utils/errorHandling.js";
 import { createFileError, extractHttpStatus, FileErrorCode, isRetryableError, } from "../errors/index.js";
-import { DEFAULT_RETRY_CONFIG } from "./types.js";
+import { DEFAULT_RETRY_CONFIG } from "../../types/index.js";
 const gunzipAsync = promisify(gunzip);
 /**
  * Abstract base class for file processors.

package/dist/processors/base/index.d.ts

@@ -10,5 +10,4 @@
  * @module processors/base
  */
 export { BaseFileProcessor, getDefaultImageMaxSizeMB, getDefaultImageTimeout, getDefaultTextMaxSizeMB, getDefaultTextTimeout, } from "./BaseFileProcessor.js";
-export type { BatchProcessingSummary, ErrorMessageTemplate, ExcelWorksheet, FailedFileInfo, FileErrorCode, FileInfo, FileProcessingError, FileProcessingResult, FileProcessorConfig, FileWarning, JsonTypeGuard, OperationResult, ProcessedConfig, ProcessedExcel, ProcessedFileBase, ProcessedFileInfo, ProcessedHtml, ProcessedJson, ProcessedMarkdown, ProcessedOpenDocument, ProcessedRtf, ProcessedSourceCode, ProcessedSvg, ProcessedText, ProcessedWord, ProcessedXml, ProcessedYaml, ProcessOptions, ProcessorInfo, ProcessorMatch, ProcessorPriorityKey, ProcessorPriorityValue, RegistryOptions, RegistryProcessResult, RetryConfig, SkippedFileInfo, UnsupportedFileError, } from "./types.js";
-export { DEFAULT_IMAGE_MAX_SIZE_MB, DEFAULT_IMAGE_TIMEOUT_MS, DEFAULT_RETRY_CONFIG, DEFAULT_TEXT_MAX_SIZE_MB, DEFAULT_TEXT_TIMEOUT_MS, PROCESSOR_PRIORITIES, } from "./types.js";
+export { DEFAULT_IMAGE_MAX_SIZE_MB, DEFAULT_IMAGE_TIMEOUT_MS, DEFAULT_RETRY_CONFIG, DEFAULT_TEXT_MAX_SIZE_MB, DEFAULT_TEXT_TIMEOUT_MS, PROCESSOR_PRIORITIES, } from "../../types/index.js";

package/dist/processors/base/index.js

@@ -14,6 +14,9 @@
 // =============================================================================
 export { BaseFileProcessor, getDefaultImageMaxSizeMB, getDefaultImageTimeout, getDefaultTextMaxSizeMB, getDefaultTextTimeout, } from "./BaseFileProcessor.js";
 // =============================================================================
+// TYPE DEFINITIONS (single source of truth)
+// =============================================================================
+// =============================================================================
 // CONSTANTS
 // =============================================================================
-export { DEFAULT_IMAGE_MAX_SIZE_MB, DEFAULT_IMAGE_TIMEOUT_MS, DEFAULT_RETRY_CONFIG, DEFAULT_TEXT_MAX_SIZE_MB, DEFAULT_TEXT_TIMEOUT_MS, PROCESSOR_PRIORITIES, } from "./types.js";
+export { DEFAULT_IMAGE_MAX_SIZE_MB, DEFAULT_IMAGE_TIMEOUT_MS, DEFAULT_RETRY_CONFIG, DEFAULT_TEXT_MAX_SIZE_MB, DEFAULT_TEXT_TIMEOUT_MS, PROCESSOR_PRIORITIES, } from "../../types/index.js";