@hff-ai/media-processor-client 1.0.0

package/dist/MediaProcessor.d.ts

@@ -0,0 +1,222 @@
+/**
+ * MediaProcessor - Main client class for communicating with the Media Processor service
+ */
+import { EventEmitter } from 'events';
+import { MediaProcessorConfig, ImageProcessOptions, VideoProcessOptions, ZipProcessOptions, AsyncImageProcessOptions, AsyncVideoProcessOptions, AsyncZipProcessOptions, MediaResultMessage, SystemStatus } from './types';
+/**
+ * MediaProcessor client class
+ *
+ * Provides a stream-like interface for communicating with the Media Processor service.
+ * Handles AMQP connections, message publishing, and event emission for processing updates.
+ */
+export declare class MediaProcessor extends EventEmitter {
+    private config;
+    private options;
+    private httpClient;
+    private connection;
+    private channel;
+    private consumerTag;
+    private _isConnected;
+    private reconnectAttempts;
+    private reconnectTimer;
+    private isShuttingDown;
+    private readonly requestQueue;
+    private readonly updatesQueue;
+    /** Map of pending async requests, keyed by correlation ID */
+    private pendingRequests;
+    /**
+     * Create a new MediaProcessor instance
+     *
+     * @param config - Configuration for the media processor connection
+     */
+    constructor(config: MediaProcessorConfig);
+    /**
+     * Validate the configuration object
+     */
+    private validateConfig;
+    /**
+     * Connect to the media processor service
+     *
+     * This will:
+     * 1. Set up the system configuration via REST API
+     * 2. Establish AMQP connection
+     * 3. Start consuming update messages
+     */
+    connect(): Promise<void>;
+    /**
+     * Set up the system configuration via REST API
+     */
+    private setupSystem;
+    /**
+     * Connect to RabbitMQ
+     */
+    private connectAmqp;
+    /**
+     * Set up the consumer for update messages
+     */
+    private setupConsumer;
+    /**
+     * Handle incoming messages from the updates queue
+     *
+     * Messages are routed based on their correlationId:
+     *
+     * 1. Has correlationId AND matches pending request → handle via Promise
+     * 2. Has correlationId but NO match → orphaned async message → unhandled_message only
+     * 3. No correlationId → queue-based message → emit events
+     *
+     * This ensures:
+     * - Clean separation between async and queue API styles
+     * - Orphaned async messages (from dead processes) don't pollute event handlers
+     * - Queue messages are properly routed to event listeners
+     */
+    private handleMessage;
+    /**
+     * Extract correlation ID from an update message
+     */
+    private extractCorrelationId;
+    /**
+     * Warn if there are no listeners for a message type
+     * Helps detect orphaned messages that would otherwise be silently lost
+     */
+    private warnIfNoListeners;
+    /**
+     * Emit progress events
+     */
+    private emitProgressEvent;
+    /**
+     * Emit result events
+     */
+    private emitResultEvent;
+    /**
+     * Emit error events
+     */
+    private emitErrorEvent;
+    /**
+     * Handle connection errors
+     */
+    private handleConnectionError;
+    /**
+     * Handle connection close
+     */
+    private handleConnectionClose;
+    /**
+     * Schedule a reconnection attempt
+     */
+    private scheduleReconnect;
+    /**
+     * Manually trigger a reconnection
+     */
+    reconnect(): Promise<void>;
+    /**
+     * Clean up AMQP connections
+     */
+    private cleanupConnections;
+    /**
+     * Disconnect from the media processor service
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Reject all pending async requests (called on disconnect)
+     */
+    private rejectAllPendingRequests;
+    /**
+     * Check if connected to the media processor
+     */
+    isConnected(): boolean;
+    /**
+     * Update the authentication token
+     */
+    updateToken(token: string): void;
+    /**
+     * Get the current system status
+     */
+    getSystemStatus(): Promise<SystemStatus>;
+    /**
+     * Queue an image for processing (fire-and-forget)
+     *
+     * Use this when you want to handle results via events.
+     *
+     * @param s3Key - S3 object key of the image to process
+     * @param options - Optional processing parameters
+     * @returns mediaId - Unique identifier for tracking this job
+     */
+    queueS3Image(s3Key: string, options?: ImageProcessOptions): string;
+    /**
+     * Queue a video for processing (fire-and-forget)
+     *
+     * Use this when you want to handle results via events.
+     *
+     * @param s3Key - S3 object key of the video to process
+     * @param options - Optional processing parameters
+     * @returns mediaId - Unique identifier for tracking this job
+     */
+    queueS3Video(s3Key: string, options?: VideoProcessOptions): string;
+    /**
+     * Queue a zip archive for processing (fire-and-forget)
+     *
+     * Use this when you want to handle results via events.
+     *
+     * @param s3Key - S3 object key of the zip file
+     * @param options - Optional processing parameters
+     * @returns mediaId - Unique identifier for tracking this job
+     */
+    queueS3Zip(s3Key: string, options?: ZipProcessOptions): string;
+    /**
+     * Process an image and wait for the result
+     *
+     * @param s3Key - S3 object key of the image to process
+     * @param options - Optional processing parameters including timeout and progress callback
+     * @returns Promise that resolves with the processing result
+     * @throws ProcessingError if processing fails
+     * @throws ProcessingError with code 'PROCESSING_TIMEOUT' if timeout is exceeded
+     */
+    processS3Image(s3Key: string, options?: AsyncImageProcessOptions): Promise<MediaResultMessage>;
+    /**
+     * Process a video and wait for the result
+     *
+     * @param s3Key - S3 object key of the video to process
+     * @param options - Optional processing parameters including timeout and progress callback
+     * @returns Promise that resolves with the processing result
+     * @throws ProcessingError if processing fails
+     * @throws ProcessingError with code 'PROCESSING_TIMEOUT' if timeout is exceeded
+     */
+    processS3Video(s3Key: string, options?: AsyncVideoProcessOptions): Promise<MediaResultMessage>;
+    /**
+     * Process a zip archive and wait for the result
+     *
+     * @param s3Key - S3 object key of the zip file
+     * @param options - Optional processing parameters including timeout and progress callback
+     * @returns Promise that resolves with the processing result
+     * @throws ProcessingError if processing fails
+     * @throws ProcessingError with code 'PROCESSING_TIMEOUT' if timeout is exceeded
+     */
+    processS3Zip(s3Key: string, options?: AsyncZipProcessOptions): Promise<MediaResultMessage>;
+    /**
+     * Submit an async processing request and return a Promise
+     */
+    private submitAsyncProcessingRequest;
+    /**
+     * Generate a unique correlation ID for request tracking
+     *
+     * Uses UUID to ensure uniqueness even across process restarts,
+     * preventing any possibility of ID collision with orphaned responses.
+     */
+    private generateCorrelationId;
+    /**
+     * Submit a processing request
+     */
+    private submitProcessingRequest;
+    /**
+     * Guess MIME type from file extension
+     */
+    private guessMimeType;
+    /**
+     * Extract filename from S3 key
+     */
+    private extractFilename;
+    /**
+     * Extract file extension from S3 key
+     */
+    private extractExtension;
+}
+//# sourceMappingURL=MediaProcessor.d.ts.map

package/dist/MediaProcessor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaProcessor.d.ts","sourceRoot":"","sources":["../src/MediaProcessor.ts"],"names":[],"mappings":"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"}