@easyling/sanity-connector 1.3.0 → 2.0.0

package/dist-types/utils/logger.d.ts

@@ -1,104 +0,0 @@
-/**
- * Logging utilities with structured output
- * Requirements: 4.3 - Clear error messages and structured logging
- */
-export declare enum LogLevel {
-    DEBUG = 0,
-    INFO = 1,
-    WARN = 2,
-    ERROR = 3
-}
-export interface LogEntry {
-    timestamp: string;
-    level: LogLevel;
-    message: string;
-    context?: Record<string, any>;
-    error?: Error;
-}
-export interface LoggerConfig {
-    level: LogLevel;
-    enableConsole: boolean;
-    enableStructuredOutput: boolean;
-    prefix?: string;
-}
-export declare class Logger {
-    private config;
-    constructor(config?: Partial<LoggerConfig>);
-    /**
-     * Log debug message
-     */
-    debug(message: string, context?: Record<string, any>): void;
-    /**
-     * Log info message
-     */
-    info(message: string, context?: Record<string, any>): void;
-    /**
-     * Log warning message
-     */
-    warn(message: string, context?: Record<string, any>): void;
-    /**
-     * Log error message
-     * Requirement 4.3: Display clear error messages
-     */
-    error(message: string, error?: Error, context?: Record<string, any>): void;
-    /**
-     * Log translation request with structured format
-     * Requirements: 1.3, 2.4 - Log request body to console for verification
-     */
-    logTranslationRequest(documentId: string, endpoint: string, payload: any): void;
-    /**
-     * Log bulk translation summary
-     * Requirement 2.5: Display summary of processed documents
-     */
-    logBulkTranslationSummary(summary: {
-        totalDocuments: number;
-        processedDocuments: number;
-        failedDocuments: number;
-        duration?: number;
-    }): void;
-    /**
-     * Log document processing progress
-     */
-    logProgress(current: number, total: number, documentId?: string): void;
-    /**
-     * Log validation errors
-     * Requirement 4.3: Clear error messages for validation failures
-     */
-    logValidationError(type: string, errors: string[], context?: Record<string, any>): void;
-    /**
-     * Log performance metrics
-     */
-    logPerformance(operation: string, duration: number, context?: Record<string, any>): void;
-    /**
-     * Core logging method
-     */
-    private log;
-    /**
-     * Output log entry to console with appropriate formatting
-     */
-    private outputToConsole;
-    /**
-     * Serialize error object for logging
-     */
-    private serializeError;
-    /**
-     * Update logger configuration
-     */
-    updateConfig(config: Partial<LoggerConfig>): void;
-    /**
-     * Get current configuration
-     */
-    getConfig(): LoggerConfig;
-}
-export declare const defaultLogger: Logger;
-export declare const logger: {
-    debug: (message: string, context?: Record<string, any>) => void;
-    info: (message: string, context?: Record<string, any>) => void;
-    warn: (message: string, context?: Record<string, any>) => void;
-    error: (message: string, error?: Error, context?: Record<string, any>) => void;
-    logTranslationRequest: (documentId: string, endpoint: string, payload: any) => void;
-    logBulkTranslationSummary: (summary: any) => void;
-    logProgress: (current: number, total: number, documentId?: string) => void;
-    logValidationError: (type: string, errors: string[], context?: Record<string, any>) => void;
-    logPerformance: (operation: string, duration: number, context?: Record<string, any>) => void;
-};

package/dist-types/utils/oauthErrorFeedback.d.ts

@@ -1,75 +0,0 @@
-/**
- * OAuth Error Feedback Utility
- *
- * Provides user-friendly error feedback for OAuth authentication errors
- * using Sanity UI toast notifications and dialogs.
- *
- * Requirements: 7.2, 7.3, 7.4
- */
-import { OAuthError, OAuthErrorType } from '../types/oauth';
-import { DialogService } from '../services/dialogService';
-/**
- * OAuth Error Feedback Handler
- *
- * Provides methods for displaying user-friendly error messages
- * with appropriate help text and retry options.
- */
-export declare class OAuthErrorFeedback {
-    private dialogService;
-    /**
-     * Create a new OAuth error feedback handler
-     *
-     * @param dialogService - Dialog service instance
-     */
-    constructor(dialogService: DialogService);
-    /**
-     * Show an error dialog for an OAuth error
-     *
-     * Requirements: 7.2, 7.3, 7.4
-     *
-     * @param error - OAuth error to display
-     * @param onRetry - Optional callback for retry action
-     * @returns Promise that resolves to true if user clicked retry, false otherwise
-     */
-    showError(error: OAuthError, onRetry?: () => void): Promise<boolean>;
-    /**
-     * Show an error dialog for a generic error
-     *
-     * Requirements: 7.2, 7.3
-     *
-     * @param message - Error message to display
-     * @param details - Optional additional details
-     * @param showRetry - Whether to show retry button
-     * @param onRetry - Optional callback for retry action
-     * @returns Promise that resolves to true if user clicked retry, false otherwise
-     */
-    showGenericError(message: string, details?: string, showRetry?: boolean, onRetry?: () => void): Promise<boolean>;
-    /**
-     * Show a success message
-     *
-     * @param message - Success message to display
-     * @param details - Optional additional details
-     */
-    showSuccess(message: string, details?: string): void;
-    /**
-     * Get help text for a specific error type
-     *
-     * @param errorType - OAuth error type
-     * @returns Help text for the error type
-     */
-    getHelpText(errorType: OAuthErrorType): string;
-    /**
-     * Format an error for logging (sanitizes sensitive data)
-     *
-     * @param error - Error to format
-     * @returns Formatted error object safe for logging
-     */
-    formatErrorForLogging(error: OAuthError): Record<string, unknown>;
-}
-/**
- * Create an OAuth error feedback handler
- *
- * @param dialogService - Dialog service instance
- * @returns OAuth error feedback handler
- */
-export declare function createOAuthErrorFeedback(dialogService: DialogService): OAuthErrorFeedback;

package/dist-types/utils/oauthLogger.d.ts

@@ -1,175 +0,0 @@
-/**
- * OAuth Logger Utility
- *
- * Provides structured logging for OAuth authentication events with timestamps
- * and component identification. Never logs sensitive data like tokens or secrets.
- *
- * Requirements: 7.1, 8.5
- */
-/**
- * Log level enumeration
- */
-export declare enum LogLevel {
-    INFO = "info",
-    WARN = "warn",
-    ERROR = "error"
-}
-/**
- * OAuth component identifier
- */
-export type OAuthComponent = 'OAuthService' | 'TokenStorage' | 'AuthStateManager' | 'OAuthCallback' | 'AuthStatus' | 'TranslationService';
-/**
- * OAuth log entry structure
- */
-export interface OAuthLogEntry {
-    /** ISO timestamp of the log entry */
-    timestamp: string;
-    /** Log level */
-    level: LogLevel;
-    /** Component that generated the log */
-    component: OAuthComponent;
-    /** Event name or description */
-    event: string;
-    /** Optional additional details (never contains sensitive data) */
-    details?: Record<string, unknown>;
-}
-/**
- * OAuth Logger
- *
- * Provides structured logging methods for OAuth-related events.
- * Automatically sanitizes sensitive data from log output.
- */
-export declare class OAuthLogger {
-    private component;
-    /**
-     * Create a new OAuth logger for a specific component
-     *
-     * @param component - Component identifier
-     */
-    constructor(component: OAuthComponent);
-    /**
-     * Sanitize details object to remove sensitive data
-     *
-     * @param details - Details object to sanitize
-     * @returns Sanitized details object
-     */
-    private sanitizeDetails;
-    /**
-     * Create a log entry
-     *
-     * @param level - Log level
-     * @param event - Event name
-     * @param details - Optional details
-     * @returns OAuth log entry
-     */
-    private createLogEntry;
-    /**
-     * Format log entry for console output
-     *
-     * @param entry - OAuth log entry to format
-     * @returns Formatted log message
-     */
-    private formatLogEntry;
-    /**
-     * Log an info-level event
-     *
-     * @param event - Event name
-     * @param details - Optional details
-     */
-    info(event: string, details?: Record<string, unknown>): void;
-    /**
-     * Log a warning-level event
-     *
-     * @param event - Event name
-     * @param details - Optional details
-     */
-    warn(event: string, details?: Record<string, unknown>): void;
-    /**
-     * Log an error-level event
-     *
-     * @param event - Event name
-     * @param details - Optional details
-     */
-    error(event: string, details?: Record<string, unknown>): void;
-    /**
-     * Log OAuth flow initiation
-     *
-     * @param authUrl - Authorization URL (without sensitive params)
-     */
-    logFlowInitiation(authUrl: string): void;
-    /**
-     * Log OAuth callback received
-     *
-     * @param hasCode - Whether authorization code was received
-     * @param hasError - Whether error was received
-     * @param projectId - Project ID if available
-     */
-    logCallbackReceived(hasCode: boolean, hasError: boolean, projectId?: string): void;
-    /**
-     * Log token exchange attempt
-     */
-    logTokenExchange(): void;
-    /**
-     * Log token exchange success
-     *
-     * @param expiresIn - Token expiration time in seconds
-     * @param hasRefreshToken - Whether refresh token was received
-     */
-    logTokenExchangeSuccess(expiresIn: number, hasRefreshToken: boolean): void;
-    /**
-     * Log token exchange failure
-     *
-     * @param error - Error message
-     * @param statusCode - HTTP status code if available
-     */
-    logTokenExchangeFailure(error: string, statusCode?: number): void;
-    /**
-     * Log token refresh attempt
-     */
-    logTokenRefresh(): void;
-    /**
-     * Log token refresh success
-     *
-     * @param expiresIn - New token expiration time in seconds
-     */
-    logTokenRefreshSuccess(expiresIn: number): void;
-    /**
-     * Log token refresh failure
-     *
-     * @param error - Error message
-     */
-    logTokenRefreshFailure(error: string): void;
-    /**
-     * Log authentication state change
-     *
-     * @param fromState - Previous state
-     * @param toState - New state
-     * @param projectId - Project ID if available
-     */
-    logStateChange(fromState: string, toState: string, projectId?: string): void;
-    /**
-     * Log logout event
-     */
-    logLogout(): void;
-    /**
-     * Log storage operation
-     *
-     * @param operation - Operation type (store, retrieve, clear)
-     * @param success - Whether operation succeeded
-     */
-    logStorageOperation(operation: 'store' | 'retrieve' | 'clear', success: boolean): void;
-    /**
-     * Sanitize URL to remove sensitive query parameters
-     *
-     * @param url - URL to sanitize
-     * @returns Sanitized URL string
-     */
-    private sanitizeUrl;
-}
-/**
- * Create a logger instance for a specific component
- *
- * @param component - Component identifier
- * @returns Logger instance
- */
-export declare function createOAuthLogger(component: OAuthComponent): OAuthLogger;

package/dist-types/utils/validator.d.ts

@@ -1,66 +0,0 @@
-/**
- * Validation functions for document and payload structure
- * Requirements: 3.4, 4.3 - Validate document structure and provide clear error messages
- */
-import { DocumentContent, ExtendedDocumentContent } from '../services/contentExtractor';
-import { TranslationRequestPayload } from '../services/translationService';
-export interface ValidationResult {
-    isValid: boolean;
-    errors: string[];
-    warnings: string[];
-}
-export interface DocumentValidationOptions {
-    requireTitle?: boolean;
-    requireContent?: boolean;
-    allowEmptyFields?: boolean;
-    maxContentLength?: number;
-}
-export interface PayloadValidationOptions {
-    requireMetadata?: boolean;
-    maxPayloadSize?: number;
-    validateHtmlStructure?: boolean;
-}
-export declare class Validator {
-    /**
-     * Validate Sanity document structure
-     * Requirement 3.4: Validate document structure
-     */
-    static validateSanityDocument(document: any, options?: DocumentValidationOptions): ValidationResult;
-    /**
-     * Validate document content structure
-     * Requirement 3.4: Validate extracted content structure
-     */
-    static validateDocumentContent(content: DocumentContent): ValidationResult;
-    /**
-     * Validate extended document content structure
-     */
-    static validateExtendedDocumentContent(content: ExtendedDocumentContent): ValidationResult;
-    /**
-     * Validate translation request payload
-     * Requirement 3.4: Validate payload structure for JSON transmission
-     */
-    static validateTranslationPayload(payload: TranslationRequestPayload, options?: PayloadValidationOptions): ValidationResult;
-    /**
-     * Validate HTML content structure
-     * Requirement 3.2: Validate HTML structure preservation
-     */
-    static validateHtmlContent(html: string): ValidationResult;
-    /**
-     * Validate array of documents for bulk operations
-     * Requirement 2.1: Validate multiple documents for bulk processing
-     */
-    static validateDocumentArray(documents: any[], options?: DocumentValidationOptions): ValidationResult;
-    /**
-     * Validate endpoint URL
-     */
-    static validateEndpoint(endpoint: string): ValidationResult;
-}
-export declare const validator: {
-    validateSanityDocument: typeof Validator.validateSanityDocument;
-    validateDocumentContent: typeof Validator.validateDocumentContent;
-    validateExtendedDocumentContent: typeof Validator.validateExtendedDocumentContent;
-    validateTranslationPayload: typeof Validator.validateTranslationPayload;
-    validateHtmlContent: typeof Validator.validateHtmlContent;
-    validateDocumentArray: typeof Validator.validateDocumentArray;
-    validateEndpoint: typeof Validator.validateEndpoint;
-};