longurl-js/dist/src/adapters/supabase/errors.d.ts

LongURL - Programmable URL management framework with entity-driven design and production-ready infrastructure

/**
 * Supabase Error Handler
 *
 * Provides detailed, actionable error messages for common Supabase/PostgreSQL errors.
 * Helps developers debug schema issues, connection problems, and data constraints.
 */
export interface SupabaseErrorDetails {
    code: string;
    message: string;
    suggestion: string;
    sqlHint?: string;
    docsUrl?: string;
}
/**
 * Enhanced error class with detailed context
 */
export declare class SupabaseAdapterError extends Error {
    readonly code: string;
    readonly suggestion: string;
    readonly sqlHint?: string;
    readonly docsUrl?: string;
    readonly originalError: any;
    constructor(details: SupabaseErrorDetails, originalError?: any);
}
/**
 * Parse and enhance Supabase errors with actionable context
 */
export declare function parseSupabaseError(error: any, operation: string, tableName?: string): SupabaseAdapterError;
/**
 * Log detailed error information for debugging
 */
export declare function logSupabaseError(error: SupabaseAdapterError, context?: Record<string, any>): void;
/**
 * Check if error indicates a temporary issue (for user's retry logic)
 */
export declare function isTemporaryError(error: any): boolean;
/**
 * Generate helpful schema suggestions based on operation
 */
export declare function getSchemaHelp(tableName?: string): string;