@ductape/sdk 0.0.4-v99 → 0.0.5

package/dist/api/services/processorApi.service.d.ts

@@ -1,6 +1,7 @@
 import { EnvType, IProcessorResult, IProcessProductPayload, FetchRemoteCachePayload, IRemoteCache, IRefreshTokenReq, IFileURLPayload } from '../../types';
 import { IRequestExtension } from '../../types/requests.types';
 export interface IProcessorApiService {
+    /** Save processor result (fire-and-forget from workflow/processor). data must include start and end (Unix ms). */
     saveResult(data: IProcessorResult, payload: IRequestExtension): Promise<void>;
     processProduct<T = any>(product_id: string, payload: IProcessProductPayload, auth: IRequestExtension): Promise<T>;
     fetchResult(process_id: string, payload: IRequestExtension): Promise<void>;
@@ -33,6 +34,14 @@ export interface IProcessorApiService {
         product: string;
         env: string;
     }, auth: IRequestExtension): Promise<boolean>;
+    checkSessionRevoked(payload: {
+        product: string;
+        env: string;
+        sessionId?: string;
+        identifier?: string;
+    }, auth: IRequestExtension): Promise<{
+        revoked: boolean;
+    }>;
     getBrokerEvents(payload: {
         product: string;
         env: string;
@@ -133,7 +142,67 @@ export interface IProcessorApiService {
         product_tag: string;
         session_tag: string;
         env?: string;
-    }, auth: IRequestExtension): Promise<any>;
+    }, auth: IRequestExtension): Promise<{
+        totalUsers: number;
+        activeUsers: number;
+        inactiveUsers: number;
+        expiredUsers: number;
+        newUsersToday: number;
+        newUsersThisWeek: number;
+        totalSessions: number;
+        activeSessions: number;
+        averageSessionsPerUser: number;
+        dau: {
+            current: number;
+            previous: number;
+            change: number;
+        };
+        wau: {
+            current: number;
+            previous: number;
+            change: number;
+        };
+        mau: {
+            current: number;
+            previous: number;
+            change: number;
+        };
+        activityTimeline: Array<{
+            date: string;
+            sessions: number;
+        }>;
+        peakHours: Array<{
+            hour: string;
+            count: number;
+        }>;
+        environmentBreakdown: Array<{
+            env: string;
+            count: number;
+            percentage: number;
+        }>;
+        avgSessionDuration: {
+            current: string;
+            previous: string;
+            change: number;
+        };
+    }>;
+    fetchUserDashboard(payload: {
+        product_tag: string;
+        session_tag: string;
+        identifier: string;
+        env?: string;
+    }, auth: IRequestExtension): Promise<{
+        totalLogs: number;
+        successRate: number;
+        activityTimeline: Array<{
+            day: string;
+            count: number;
+        }>;
+        peakHours: Array<{
+            hour: string;
+            count: number;
+        }>;
+    }>;
     fetchSessionActivityDashboard(payload: {
         product_tag: string;
         session_tag: string;
@@ -148,6 +217,7 @@ export interface IProcessorApiService {
         env?: string;
         page?: number;
         limit?: number;
+        expiryFilter?: 'all' | 'expiring' | 'permanent' | 'expired';
     }, auth: IRequestExtension): Promise<{
         values: any[];
         total: number;
@@ -175,11 +245,225 @@ export interface IProcessorApiService {
     }, auth: IRequestExtension): Promise<{
         deleted: number;
     }>;
+    /** Log notification message send for reprocessing (fire-and-forget from processor). Input may be encrypted with product private key. */
+    logNotificationMessage(payload: {
+        workspace_id: string;
+        product_id: string;
+        product_tag: string;
+        env: string;
+        notification_tag: string;
+        input: Record<string, unknown> | string;
+        type: 'email' | 'push' | 'sms' | 'callback' | 'notification';
+        status: 'pending' | 'sent' | 'failed';
+        process_id?: string;
+        error?: string;
+        retries?: number;
+        session?: string;
+        cache?: string;
+    }, auth: IRequestExtension): Promise<void>;
+    /** Create job execution record (fire-and-forget from processor). */
+    createJobExecution(payload: {
+        job_id: string;
+        workspace_id: string;
+        product_id: string;
+        product_tag: string;
+        env: string;
+        job_tag: string;
+        job_type: string;
+        phase?: string;
+        scheduled_at?: number | Date;
+        started_at?: number | Date;
+        triggered_by?: string;
+        input?: Record<string, unknown>;
+        operation?: string;
+    }, auth: IRequestExtension): Promise<void>;
+    /** Update job execution phase (fire-and-forget from processor). */
+    updateJobExecutionPhase(payload: {
+        workspace_id: string;
+        job_id: string;
+        phase: string;
+        started_at?: number | Date;
+        completed_at?: number | Date;
+        duration_ms?: number;
+        error?: string;
+        error_code?: string;
+        retry_count?: number;
+        result_metadata?: Record<string, unknown>;
+        output?: Record<string, unknown>;
+        operation?: string;
+    }, auth: IRequestExtension): Promise<void>;
+    /** Query notification message logs (send history) with time filters. Secured via user auth. */
+    queryNotificationMessageLogs(payload: {
+        workspace_id: string;
+        product_tag?: string;
+        product_id?: string;
+        env?: string;
+        notification_tag?: string;
+        status?: string;
+        type?: string;
+        process_id?: string;
+        start_date?: string;
+        end_date?: string;
+        page?: number;
+        limit?: number;
+    }, auth: IRequestExtension): Promise<{
+        items: any[];
+        total: number;
+        page: number;
+        limit: number;
+        hasMore: boolean;
+    }>;
+    trackBrokerMessage(payload: {
+        workspace_id: string;
+        product_id: string;
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag: string;
+        event: string;
+        producer_tag: string;
+        message_encrypted: string;
+        idempotency_key?: string;
+        process_id?: string;
+        session_tag?: string;
+        metadata?: Record<string, unknown>;
+        message_id?: string;
+    }, auth: IRequestExtension): Promise<any>;
+    trackBrokerMessageIdempotent(payload: {
+        workspace_id: string;
+        product_id: string;
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag: string;
+        event: string;
+        producer_tag: string;
+        message_encrypted: string;
+        idempotency_key?: string;
+        process_id?: string;
+        session_tag?: string;
+        metadata?: Record<string, unknown>;
+        message_id?: string;
+    }, auth: IRequestExtension): Promise<{
+        message: any;
+        isDuplicate: boolean;
+    }>;
+    registerBrokerConsumer(payload: {
+        message_id: string;
+        consumer_tag: string;
+    }, auth: IRequestExtension): Promise<any>;
+    updateBrokerConsumerStatus(payload: {
+        message_id: string;
+        consumer_tag: string;
+        status: 'pending' | 'success' | 'failed' | 'partial';
+        error?: string;
+        retry_count?: number;
+        response_data?: Record<string, unknown>;
+        private_key?: string;
+        processing_time?: number;
+    }, auth: IRequestExtension): Promise<any>;
+    getBrokerMessageStats(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+    }, auth: IRequestExtension): Promise<{
+        total: number;
+        pending: number;
+        success: number;
+        failed: number;
+        partial: number;
+    }>;
+    retryBrokerMessage(payload: {
+        message_id: string;
+        consumer_tag: string;
+    }, auth: IRequestExtension): Promise<any>;
+    failBrokerMessage(payload: {
+        message_id: string;
+        error: string;
+    }, auth: IRequestExtension): Promise<any>;
+    queryBrokerMessages(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag?: string;
+        producer_tag?: string;
+        consumer_tag?: string;
+        status?: string;
+        start_date?: string;
+        end_date?: string;
+        page?: number;
+        limit?: number;
+    }, auth: IRequestExtension): Promise<{
+        messages: any[];
+        total: number;
+        page: number;
+        limit: number;
+        hasMore: boolean;
+    }>;
+    getBrokerProducers(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag?: string;
+        page?: number;
+        limit?: number;
+    }, auth: IRequestExtension): Promise<{
+        producers: any[];
+        total: number;
+        page: number;
+        limit: number;
+        hasMore: boolean;
+    }>;
+    getBrokerConsumers(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag?: string;
+        page?: number;
+        limit?: number;
+    }, auth: IRequestExtension): Promise<{
+        consumers: any[];
+        total: number;
+        page: number;
+        limit: number;
+        hasMore: boolean;
+    }>;
+    getBrokerDeadLetters(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag?: string;
+        consumer_tag?: string;
+        start_date?: string;
+        end_date?: string;
+        page?: number;
+        limit?: number;
+    }, auth: IRequestExtension): Promise<{
+        deadLetters: any[];
+        total: number;
+        page: number;
+        limit: number;
+        hasMore: boolean;
+    }>;
+    getBrokerComprehensiveStats(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+    }, auth: IRequestExtension): Promise<any>;
+    getBrokerDashboard(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+    }, auth: IRequestExtension): Promise<any>;
 }
 export declare class ProcessorApiService implements IProcessorApiService {
     private environment;
     constructor(environment: EnvType);
     saveFileURL(payload: IFileURLPayload, auth: IRequestExtension): Promise<void>;
+    /**
+     * Save processor result (fire-and-forget from workflow executor / processor).
+     * data must include start and end (Unix ms) for timeline and list ordering.
+     */
     saveResult(data: IProcessorResult, payload: IRequestExtension): Promise<void>;
     fetchResult(process_id: string, payload: IRequestExtension): Promise<void>;
     processProduct<T = any>(product_id: string, payload: IProcessProductPayload, auth: IRequestExtension): Promise<T>;
@@ -211,6 +495,14 @@ export declare class ProcessorApiService implements IProcessorApiService {
         product: string;
         env: string;
     }, auth: IRequestExtension): Promise<boolean>;
+    checkSessionRevoked(payload: {
+        product: string;
+        env: string;
+        sessionId?: string;
+        identifier?: string;
+    }, auth: IRequestExtension): Promise<{
+        revoked: boolean;
+    }>;
     getBrokerEvents(payload: {
         product: string;
         env: string;
@@ -311,7 +603,67 @@ export declare class ProcessorApiService implements IProcessorApiService {
         product_tag: string;
         session_tag: string;
         env?: string;
-    }, auth: IRequestExtension): Promise<any>;
+    }, auth: IRequestExtension): Promise<{
+        totalUsers: number;
+        activeUsers: number;
+        inactiveUsers: number;
+        expiredUsers: number;
+        newUsersToday: number;
+        newUsersThisWeek: number;
+        totalSessions: number;
+        activeSessions: number;
+        averageSessionsPerUser: number;
+        dau: {
+            current: number;
+            previous: number;
+            change: number;
+        };
+        wau: {
+            current: number;
+            previous: number;
+            change: number;
+        };
+        mau: {
+            current: number;
+            previous: number;
+            change: number;
+        };
+        activityTimeline: Array<{
+            date: string;
+            sessions: number;
+        }>;
+        peakHours: Array<{
+            hour: string;
+            count: number;
+        }>;
+        environmentBreakdown: Array<{
+            env: string;
+            count: number;
+            percentage: number;
+        }>;
+        avgSessionDuration: {
+            current: string;
+            previous: string;
+            change: number;
+        };
+    }>;
+    fetchUserDashboard(payload: {
+        product_tag: string;
+        session_tag: string;
+        identifier: string;
+        env?: string;
+    }, auth: IRequestExtension): Promise<{
+        totalLogs: number;
+        successRate: number;
+        activityTimeline: Array<{
+            day: string;
+            count: number;
+        }>;
+        peakHours: Array<{
+            hour: string;
+            count: number;
+        }>;
+    }>;
     fetchSessionActivityDashboard(payload: {
         product_tag: string;
         session_tag: string;
@@ -326,6 +678,7 @@ export declare class ProcessorApiService implements IProcessorApiService {
         env?: string;
         page?: number;
         limit?: number;
+        expiryFilter?: 'all' | 'expiring' | 'permanent' | 'expired';
     }, auth: IRequestExtension): Promise<{
         values: any[];
         total: number;
@@ -353,4 +706,217 @@ export declare class ProcessorApiService implements IProcessorApiService {
     }, auth: IRequestExtension): Promise<{
         deleted: number;
     }>;
+    logNotificationMessage(payload: {
+        workspace_id: string;
+        product_id: string;
+        product_tag: string;
+        env: string;
+        notification_tag: string;
+        input: Record<string, unknown> | string;
+        type: 'email' | 'push' | 'sms' | 'callback' | 'notification';
+        status: 'pending' | 'sent' | 'failed';
+        process_id?: string;
+        error?: string;
+        retries?: number;
+        session?: string;
+        cache?: string;
+    }, auth: IRequestExtension): Promise<void>;
+    /**
+     * Create job execution record (fire-and-forget from processor). Does not throw; errors are logged.
+     */
+    createJobExecution(payload: {
+        job_id: string;
+        workspace_id: string;
+        product_id: string;
+        product_tag: string;
+        env: string;
+        job_tag: string;
+        job_type: string;
+        phase?: string;
+        scheduled_at?: number | Date;
+        started_at?: number | Date;
+        triggered_by?: string;
+        input?: Record<string, unknown>;
+        operation?: string;
+    }, auth: IRequestExtension): Promise<void>;
+    /**
+     * Update job execution phase (fire-and-forget from processor). Does not throw; errors are logged.
+     */
+    updateJobExecutionPhase(payload: {
+        workspace_id: string;
+        job_id: string;
+        phase: string;
+        started_at?: number | Date;
+        completed_at?: number | Date;
+        duration_ms?: number;
+        error?: string;
+        error_code?: string;
+        retry_count?: number;
+        result_metadata?: Record<string, unknown>;
+        output?: Record<string, unknown>;
+        operation?: string;
+    }, auth: IRequestExtension): Promise<void>;
+    queryNotificationMessageLogs(payload: {
+        workspace_id: string;
+        product_tag?: string;
+        product_id?: string;
+        env?: string;
+        notification_tag?: string;
+        status?: string;
+        type?: string;
+        process_id?: string;
+        start_date?: string;
+        end_date?: string;
+        page?: number;
+        limit?: number;
+    }, auth: IRequestExtension): Promise<{
+        items: any[];
+        total: number;
+        page: number;
+        limit: number;
+        hasMore: boolean;
+    }>;
+    trackBrokerMessage(payload: {
+        workspace_id: string;
+        product_id: string;
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag: string;
+        event: string;
+        producer_tag: string;
+        message_encrypted: string;
+        idempotency_key?: string;
+        process_id?: string;
+        session_tag?: string;
+        metadata?: Record<string, unknown>;
+        message_id?: string;
+    }, auth: IRequestExtension): Promise<any>;
+    trackBrokerMessageIdempotent(payload: {
+        workspace_id: string;
+        product_id: string;
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag: string;
+        event: string;
+        producer_tag: string;
+        message_encrypted: string;
+        idempotency_key?: string;
+        process_id?: string;
+        session_tag?: string;
+        metadata?: Record<string, unknown>;
+        message_id?: string;
+    }, auth: IRequestExtension): Promise<{
+        message: any;
+        isDuplicate: boolean;
+    }>;
+    registerBrokerConsumer(payload: {
+        message_id: string;
+        consumer_tag: string;
+        status?: 'pending' | 'success' | 'failed' | 'partial';
+        error?: string;
+    }, auth: IRequestExtension): Promise<any>;
+    updateBrokerConsumerStatus(payload: {
+        message_id: string;
+        consumer_tag: string;
+        status: 'pending' | 'success' | 'failed' | 'partial';
+        error?: string;
+        retry_count?: number;
+        response_data?: Record<string, unknown>;
+        private_key?: string;
+    }, auth: IRequestExtension): Promise<any>;
+    getBrokerMessageStats(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+    }, auth: IRequestExtension): Promise<{
+        total: number;
+        pending: number;
+        success: number;
+        failed: number;
+        partial: number;
+    }>;
+    retryBrokerMessage(payload: {
+        message_id: string;
+        consumer_tag: string;
+    }, auth: IRequestExtension): Promise<any>;
+    failBrokerMessage(payload: {
+        message_id: string;
+        error: string;
+    }, auth: IRequestExtension): Promise<any>;
+    queryBrokerMessages(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag?: string;
+        producer_tag?: string;
+        consumer_tag?: string;
+        status?: string;
+        start_date?: string;
+        end_date?: string;
+        page?: number;
+        limit?: number;
+    }, auth: IRequestExtension): Promise<{
+        messages: any[];
+        total: number;
+        page: number;
+        limit: number;
+        hasMore: boolean;
+    }>;
+    getBrokerProducers(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag?: string;
+        page?: number;
+        limit?: number;
+    }, auth: IRequestExtension): Promise<{
+        producers: any[];
+        total: number;
+        page: number;
+        limit: number;
+        hasMore: boolean;
+    }>;
+    getBrokerConsumers(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag?: string;
+        page?: number;
+        limit?: number;
+    }, auth: IRequestExtension): Promise<{
+        consumers: any[];
+        total: number;
+        page: number;
+        limit: number;
+        hasMore: boolean;
+    }>;
+    getBrokerDeadLetters(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+        topic_tag?: string;
+        consumer_tag?: string;
+        start_date?: string;
+        end_date?: string;
+        page?: number;
+        limit?: number;
+    }, auth: IRequestExtension): Promise<{
+        deadLetters: any[];
+        total: number;
+        page: number;
+        limit: number;
+        hasMore: boolean;
+    }>;
+    getBrokerComprehensiveStats(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+    }, auth: IRequestExtension): Promise<any>;
+    getBrokerDashboard(payload: {
+        product_tag: string;
+        env: string;
+        broker_tag: string;
+    }, auth: IRequestExtension): Promise<any>;
 }