bytekit 0.1.12

package/dist/utils/core/ErrorBoundary.d.ts

@@ -0,0 +1,141 @@
+import { Logger } from "#core/Logger.js";
+export interface ErrorContext {
+    component?: string;
+    context?: string;
+    userId?: string;
+    sessionId?: string;
+    metadata?: Record<string, unknown>;
+    originalError?: Error;
+}
+export interface ErrorHandler {
+    (error: Error, context: ErrorContext): void | Promise<void>;
+}
+export interface ErrorBoundaryConfig {
+    logger?: Logger;
+    handlers?: ErrorHandler[];
+    onError?: (error: Error, context: ErrorContext) => void;
+    onErrorRecovery?: (error: Error, context: ErrorContext) => void;
+    maxRetries?: number;
+    retryDelay?: number;
+    fallbackUI?: string;
+    isDevelopment?: boolean;
+}
+export declare class AppError extends Error {
+    readonly code: string;
+    readonly statusCode: number;
+    readonly context?: ErrorContext | undefined;
+    readonly originalError?: Error | undefined;
+    constructor(code: string, message: string, statusCode?: number, context?: ErrorContext | undefined, originalError?: Error | undefined);
+}
+export declare class AppValidationError extends AppError {
+    constructor(message: string, context?: ErrorContext);
+}
+export declare class NotFoundError extends AppError {
+    constructor(message: string, context?: ErrorContext);
+}
+export declare class UnauthorizedError extends AppError {
+    constructor(message: string, context?: ErrorContext);
+}
+export declare class ForbiddenError extends AppError {
+    constructor(message: string, context?: ErrorContext);
+}
+export declare class ConflictError extends AppError {
+    constructor(message: string, context?: ErrorContext);
+}
+export declare class RateLimitError extends AppError {
+    constructor(message: string, retryAfter?: number, context?: ErrorContext);
+}
+export declare class TimeoutError extends AppError {
+    constructor(message: string, context?: ErrorContext);
+}
+/**
+ * Global error boundary for handling and recovering from errors
+ */
+export declare class ErrorBoundary {
+    private handlers;
+    private logger?;
+    private onError?;
+    private maxRetries;
+    private retryDelay;
+    private errorStack;
+    private maxStackSize;
+    constructor(config?: ErrorBoundaryConfig);
+    /**
+     * Setup global error handlers
+     */
+    private setupGlobalHandlers;
+    /**
+     * Handle an error
+     */
+    handle(error: Error, context?: ErrorContext): Promise<void>;
+    /**
+     * Execute function with error handling and retry logic
+     */
+    execute<T>(fn: () => Promise<T>, context?: ErrorContext, retries?: number): Promise<T>;
+    /**
+     * Execute function synchronously with error handling
+     */
+    executeSync<T>(fn: () => T, context?: ErrorContext): T;
+    /**
+     * Wrap async function with error handling
+     */
+    wrap<T extends (...args: unknown[]) => Promise<unknown>>(fn: T, context?: ErrorContext): T;
+    /**
+     * Wrap sync function with error handling
+     */
+    wrapSync<T extends (...args: unknown[]) => unknown>(fn: T, context?: ErrorContext): T;
+    /**
+     * Register error handler
+     */
+    addHandler(handler: ErrorHandler): void;
+    /**
+     * Remove error handler
+     */
+    removeHandler(handler: ErrorHandler): void;
+    /**
+     * Clear all handlers
+     */
+    clearHandlers(): void;
+    /**
+     * Get error history
+     */
+    getErrorHistory(limit?: number): Array<{
+        error: Error;
+        context: ErrorContext;
+        timestamp: number;
+    }>;
+    /**
+     * Clear error history
+     */
+    clearErrorHistory(): void;
+    /**
+     * Normalize error to AppError
+     */
+    private normalizeError;
+    /**
+     * Check if error is retryable
+     */
+    private isRetryable;
+    /**
+     * Create error report
+     */
+    createErrorReport(): {
+        timestamp: string;
+        errors: Array<{
+            code: string;
+            message: string;
+            statusCode: number;
+            context?: ErrorContext;
+            timestamp: number;
+        }>;
+    };
+}
+/**
+ * Get or create global error boundary
+ */
+export declare function getGlobalErrorBoundary(config?: ErrorBoundaryConfig): ErrorBoundary;
+/**
+ * Reset global error boundary
+ */
+export declare function resetGlobalErrorBoundary(): void;
+//# sourceMappingURL=ErrorBoundary.d.ts.map

package/dist/utils/core/ErrorBoundary.d.ts.map

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

package/dist/utils/core/ErrorBoundary.js

@@ -0,0 +1,322 @@
+export class AppError extends Error {
+    code;
+    statusCode;
+    context;
+    originalError;
+    constructor(code, message, statusCode = 500, context, originalError) {
+        super(message);
+        this.code = code;
+        this.statusCode = statusCode;
+        this.context = context;
+        this.originalError = originalError;
+        this.name = "AppError";
+    }
+}
+export class AppValidationError extends AppError {
+    constructor(message, context) {
+        super("VALIDATION_ERROR", message, 400, context);
+        this.name = "AppValidationError";
+    }
+}
+export class NotFoundError extends AppError {
+    constructor(message, context) {
+        super("NOT_FOUND", message, 404, context);
+        this.name = "NotFoundError";
+    }
+}
+export class UnauthorizedError extends AppError {
+    constructor(message, context) {
+        super("UNAUTHORIZED", message, 401, context);
+        this.name = "UnauthorizedError";
+    }
+}
+export class ForbiddenError extends AppError {
+    constructor(message, context) {
+        super("FORBIDDEN", message, 403, context);
+        this.name = "ForbiddenError";
+    }
+}
+export class ConflictError extends AppError {
+    constructor(message, context) {
+        super("CONFLICT", message, 409, context);
+        this.name = "ConflictError";
+    }
+}
+export class RateLimitError extends AppError {
+    constructor(message, retryAfter, context) {
+        const contextWithRetry = retryAfter
+            ? {
+                ...context,
+                metadata: { ...(context?.metadata ?? {}), retryAfter },
+            }
+            : context;
+        super("RATE_LIMIT", message, 429, contextWithRetry);
+        this.name = "RateLimitError";
+    }
+}
+export class TimeoutError extends AppError {
+    constructor(message, context) {
+        super("TIMEOUT", message, 408, context);
+        this.name = "TimeoutError";
+    }
+}
+/**
+ * Global error boundary for handling and recovering from errors
+ */
+export class ErrorBoundary {
+    handlers = [];
+    logger;
+    onError;
+    maxRetries;
+    retryDelay;
+    errorStack = [];
+    maxStackSize = 100;
+    constructor(config = {}) {
+        this.logger = config.logger;
+        this.handlers = config.handlers ?? [];
+        this.onError = config.onError;
+        this.maxRetries = config.maxRetries ?? 3;
+        this.retryDelay = config.retryDelay ?? 1000;
+        this.setupGlobalHandlers();
+    }
+    /**
+     * Setup global error handlers
+     */
+    setupGlobalHandlers() {
+        if (typeof globalThis !== "undefined") {
+            // Handle unhandled promise rejections
+            if (typeof globalThis.addEventListener === "function") {
+                globalThis.addEventListener("unhandledrejection", (event) => {
+                    this.handle(event.reason instanceof Error
+                        ? event.reason
+                        : new Error(String(event.reason)), { context: "unhandledRejection" });
+                });
+            }
+            // Handle global errors
+            if (typeof globalThis.onerror === "function") {
+                const originalOnError = globalThis.onerror;
+                globalThis.onerror = (message, source, lineno, colno, error) => {
+                    this.handle(error instanceof Error
+                        ? error
+                        : new Error(String(message)), {
+                        context: "globalError",
+                        metadata: { source, lineno, colno },
+                    });
+                    return originalOnError?.(message, source, lineno, colno, error);
+                };
+            }
+        }
+    }
+    /**
+     * Handle an error
+     */
+    async handle(error, context = {}) {
+        const appError = this.normalizeError(error);
+        // Add to error stack
+        this.errorStack.push({
+            error: appError,
+            context,
+            timestamp: Date.now(),
+        });
+        // Keep stack size manageable
+        if (this.errorStack.length > this.maxStackSize) {
+            this.errorStack.shift();
+        }
+        // Log error
+        this.logger?.error(appError.message, context, appError);
+        // Call custom error handler
+        if (this.onError) {
+            try {
+                this.onError(appError, context);
+            }
+            catch (e) {
+                const err = e instanceof Error ? e : new Error(String(e));
+                this.logger?.error("Error in custom error handler", {}, err);
+            }
+        }
+        // Execute registered handlers
+        for (const handler of this.handlers) {
+            try {
+                await handler(appError, context);
+            }
+            catch (e) {
+                const err = e instanceof Error ? e : new Error(String(e));
+                this.logger?.error("Error in error handler", {}, err);
+            }
+        }
+    }
+    /**
+     * Execute function with error handling and retry logic
+     */
+    async execute(fn, context = {}, retries = this.maxRetries) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            const appError = this.normalizeError(error instanceof Error ? error : new Error(String(error)));
+            if (retries > 0 && this.isRetryable(appError)) {
+                this.logger?.warn(`Retrying after ${this.retryDelay}ms (${retries} retries left)`, context);
+                await new Promise((resolve) => setTimeout(resolve, this.retryDelay));
+                return this.execute(fn, context, retries - 1);
+            }
+            await this.handle(appError, context);
+            throw appError;
+        }
+    }
+    /**
+     * Execute function synchronously with error handling
+     */
+    executeSync(fn, context = {}) {
+        try {
+            return fn();
+        }
+        catch (error) {
+            const appError = this.normalizeError(error instanceof Error ? error : new Error(String(error)));
+            this.handle(appError, context).catch((e) => {
+                const err = e instanceof Error ? e : new Error(String(e));
+                this.logger?.error("Error handling sync error", {}, err);
+            });
+            throw appError;
+        }
+    }
+    /**
+     * Wrap async function with error handling
+     */
+    wrap(fn, context) {
+        return (async (...args) => {
+            try {
+                return await fn(...args);
+            }
+            catch (error) {
+                const appError = this.normalizeError(error instanceof Error ? error : new Error(String(error)));
+                await this.handle(appError, context);
+                throw appError;
+            }
+        });
+    }
+    /**
+     * Wrap sync function with error handling
+     */
+    wrapSync(fn, context) {
+        return ((...args) => {
+            try {
+                return fn(...args);
+            }
+            catch (error) {
+                const appError = this.normalizeError(error instanceof Error ? error : new Error(String(error)));
+                this.handle(appError, context ?? {}).catch((e) => {
+                    const err = e instanceof Error ? e : new Error(String(e));
+                    this.logger?.error("Error handling wrapped sync error", {}, err);
+                });
+                throw appError;
+            }
+        });
+    }
+    /**
+     * Register error handler
+     */
+    addHandler(handler) {
+        this.handlers.push(handler);
+    }
+    /**
+     * Remove error handler
+     */
+    removeHandler(handler) {
+        const index = this.handlers.indexOf(handler);
+        if (index > -1) {
+            this.handlers.splice(index, 1);
+        }
+    }
+    /**
+     * Clear all handlers
+     */
+    clearHandlers() {
+        this.handlers = [];
+    }
+    /**
+     * Get error history
+     */
+    getErrorHistory(limit = 10) {
+        return this.errorStack.slice(-limit);
+    }
+    /**
+     * Clear error history
+     */
+    clearErrorHistory() {
+        this.errorStack = [];
+    }
+    /**
+     * Normalize error to AppError
+     */
+    normalizeError(error) {
+        if (error instanceof AppError) {
+            return error;
+        }
+        // Try to detect error type from message or properties
+        if (error.message.includes("timeout") ||
+            error.message.includes("Timeout")) {
+            return new TimeoutError(error.message, {
+                originalError: error,
+            });
+        }
+        if (error.message.includes("validation") ||
+            error.message.includes("Validation")) {
+            return new AppValidationError(error.message, {
+                originalError: error,
+            });
+        }
+        if (error.message.includes("not found") ||
+            error.message.includes("Not Found")) {
+            return new NotFoundError(error.message, { originalError: error });
+        }
+        return new AppError("UNKNOWN_ERROR", error.message, 500, { originalError: error }, error);
+    }
+    /**
+     * Check if error is retryable
+     */
+    isRetryable(error) {
+        // Retry on timeout, rate limit, and 5xx errors
+        return (error.statusCode === 408 ||
+            error.statusCode === 429 ||
+            (error.statusCode >= 500 && error.statusCode < 600));
+    }
+    /**
+     * Create error report
+     */
+    createErrorReport() {
+        return {
+            timestamp: new Date().toISOString(),
+            errors: this.errorStack.map((item) => ({
+                code: item.error instanceof AppError
+                    ? item.error.code
+                    : "UNKNOWN",
+                message: item.error.message,
+                statusCode: item.error instanceof AppError
+                    ? item.error.statusCode
+                    : 500,
+                context: item.context,
+                timestamp: item.timestamp,
+            })),
+        };
+    }
+}
+/**
+ * Global error boundary instance
+ */
+let globalErrorBoundary = null;
+/**
+ * Get or create global error boundary
+ */
+export function getGlobalErrorBoundary(config) {
+    if (!globalErrorBoundary) {
+        globalErrorBoundary = new ErrorBoundary(config);
+    }
+    return globalErrorBoundary;
+}
+/**
+ * Reset global error boundary
+ */
+export function resetGlobalErrorBoundary() {
+    globalErrorBoundary = null;
+}
+//# sourceMappingURL=ErrorBoundary.js.map

package/dist/utils/core/ErrorBoundary.js.map

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

package/dist/utils/core/Logger.d.ts

@@ -0,0 +1,39 @@
+export type LogLevel = "silent" | "error" | "warn" | "info" | "debug";
+export interface LogEntry<TContext extends Record<string, unknown> = Record<string, unknown>> {
+    level: LogLevel;
+    message: string;
+    namespace?: string;
+    timestamp: Date;
+    context?: TContext;
+    error?: Error;
+}
+export type LogTransport = (entry: LogEntry) => void | Promise<void>;
+export interface LoggerOptions {
+    namespace?: string;
+    level?: LogLevel;
+    transports?: LogTransport[];
+    includeTimestamp?: boolean;
+}
+export declare const consoleTransportNode: ({ includeTimestamp, }?: {
+    includeTimestamp?: boolean;
+}) => LogTransport;
+export declare const consoleTransportBrowser: ({ includeTimestamp, }?: {
+    includeTimestamp?: boolean;
+}) => LogTransport;
+export declare class Logger<TContext extends Record<string, unknown> = Record<string, unknown>> {
+    private readonly namespace?;
+    private readonly transports;
+    private level;
+    constructor({ namespace, level, transports, includeTimestamp, }?: LoggerOptions);
+    setLevel(level: LogLevel): void;
+    child(namespace: string): Logger<TContext>;
+    debug(message: string, context?: TContext): void;
+    info(message: string, context?: TContext): void;
+    warn(message: string, context?: TContext): void;
+    error(message: string, context?: TContext, error?: Error): void;
+    log(level: LogLevel, message: string, context?: TContext, error?: Error): void;
+    private shouldLog;
+    static silent(): Logger<Record<string, unknown>>;
+}
+export declare const createLogger: (options?: LoggerOptions) => Logger<Record<string, unknown>>;
+//# sourceMappingURL=Logger.d.ts.map

package/dist/utils/core/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../src/utils/core/Logger.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAEtE,MAAM,WAAW,QAAQ,CACrB,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAElE,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,IAAI,CAAC;IAChB,OAAO,CAAC,EAAE,QAAQ,CAAC;IACnB,KAAK,CAAC,EAAE,KAAK,CAAC;CACjB;AAED,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAErE,MAAM,WAAW,aAAa;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,YAAY,EAAE,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAwBD,eAAO,MAAM,oBAAoB,GAAI,wBAElC;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,KAAG,YAkCxC,CAAC;AAEF,eAAO,MAAM,uBAAuB,GAAI,wBAErC;IAAE,gBAAgB,CAAC,EAAE,OAAO,CAAA;CAAO,KAAG,YAiCxC,CAAC;AAKF,qBAAa,MAAM,CACf,QAAQ,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAElE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAiB;IAC5C,OAAO,CAAC,KAAK,CAAW;gBAEZ,EACR,SAAS,EACT,KAAqB,EACrB,UAAU,EACV,gBAAgB,GACnB,GAAE,aAAkB;IAerB,QAAQ,CAAC,KAAK,EAAE,QAAQ;IAIxB,KAAK,CAAC,SAAS,EAAE,MAAM;IAWvB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ;IAIzC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ;IAIxC,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ;IAIxC,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,KAAK;IAIxD,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE,KAAK;IAmBvE,OAAO,CAAC,SAAS;IAKjB,MAAM,CAAC,MAAM;CAGhB;AAKD,eAAO,MAAM,YAAY,GAAI,UAAU,aAAa,oCAAwB,CAAC"}

package/dist/utils/core/Logger.js

@@ -0,0 +1,154 @@
+// ------------------------------------
+// Config & Constants
+// ------------------------------------
+const LEVEL_PRIORITY = {
+    silent: 0,
+    error: 1,
+    warn: 2,
+    info: 3,
+    debug: 4,
+};
+const DEFAULT_LEVEL = typeof process !== "undefined" && process?.env?.NODE_ENV === "production"
+    ? "info"
+    : "debug";
+const isBrowser = typeof window !== "undefined" && typeof document !== "undefined";
+// ------------------------------------
+// Transports
+// ------------------------------------
+export const consoleTransportNode = ({ includeTimestamp = true, } = {}) => {
+    const COLORS = {
+        error: "\x1b[31m", // rojo
+        warn: "\x1b[33m", // amarillo
+        info: "\x1b[32m", // verde
+        debug: "\x1b[90m", // gris tenue
+        silent: "",
+    };
+    const RESET = "\x1b[0m";
+    return (entry) => {
+        const { level, message, namespace, timestamp, context, error } = entry;
+        const color = COLORS[level] ?? "";
+        const prefixParts = [];
+        if (includeTimestamp)
+            prefixParts.push(timestamp.toISOString());
+        prefixParts.push(color + level.toUpperCase() + RESET);
+        if (namespace)
+            prefixParts.push(`[${namespace}]`);
+        const prefix = prefixParts.join(" ");
+        const payload = [`${prefix} ${message}`.trim()];
+        if (context && Object.keys(context).length > 0)
+            payload.push(context);
+        if (error)
+            payload.push(error);
+        const method = level === "error"
+            ? console.error
+            : level === "warn"
+                ? console.warn
+                : console.log;
+        method(...payload);
+    };
+};
+export const consoleTransportBrowser = ({ includeTimestamp = true, } = {}) => {
+    const COLORS = {
+        error: "color: red",
+        warn: "color: orange",
+        info: "color: green",
+        debug: "color: gray",
+        silent: "",
+    };
+    return (entry) => {
+        const { level, message, namespace, timestamp, context, error } = entry;
+        const color = COLORS[level] ?? "";
+        const prefixParts = [];
+        if (includeTimestamp)
+            prefixParts.push(timestamp.toISOString());
+        prefixParts.push(`${level.toUpperCase()}`);
+        if (namespace)
+            prefixParts.push(`[${namespace}]`);
+        const prefix = prefixParts.join(" ");
+        const payload = [`%c${prefix} ${message}`.trim(), color];
+        if (context && Object.keys(context).length > 0)
+            payload.push(context);
+        if (error)
+            payload.push(error);
+        const method = level === "error"
+            ? console.error
+            : level === "warn"
+                ? console.warn
+                : console.log;
+        method(...payload);
+    };
+};
+// ------------------------------------
+// Logger Class
+// ------------------------------------
+export class Logger {
+    namespace;
+    transports;
+    level;
+    constructor({ namespace, level = DEFAULT_LEVEL, transports, includeTimestamp, } = {}) {
+        this.namespace = namespace;
+        this.level = level;
+        // Usa el transporte correcto según entorno si no se pasó uno custom
+        this.transports =
+            transports?.length && transports.length > 0
+                ? transports
+                : [
+                    isBrowser
+                        ? consoleTransportBrowser({ includeTimestamp })
+                        : consoleTransportNode({ includeTimestamp }),
+                ];
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+    child(namespace) {
+        const childNamespace = this.namespace
+            ? `${this.namespace}:${namespace}`
+            : namespace;
+        return new Logger({
+            namespace: childNamespace,
+            level: this.level,
+            transports: this.transports,
+        });
+    }
+    debug(message, context) {
+        this.log("debug", message, context);
+    }
+    info(message, context) {
+        this.log("info", message, context);
+    }
+    warn(message, context) {
+        this.log("warn", message, context);
+    }
+    error(message, context, error) {
+        this.log("error", message, context, error);
+    }
+    log(level, message, context, error) {
+        if (!this.shouldLog(level))
+            return;
+        const entry = {
+            level,
+            message,
+            namespace: this.namespace,
+            timestamp: new Date(),
+            context,
+            error,
+        };
+        for (const transport of this.transports) {
+            Promise.resolve(transport(entry)).catch((err) => console.error("[Logger] Transport failure", err));
+        }
+    }
+    shouldLog(level) {
+        if (this.level === "silent")
+            return false;
+        return LEVEL_PRIORITY[level] <= LEVEL_PRIORITY[this.level];
+    }
+    static silent() {
+        return new Logger({ level: "silent" });
+    }
+}
+// ------------------------------------
+// Factory
+// ------------------------------------
+export const createLogger = (options) => new Logger(options);
+//# sourceMappingURL=Logger.js.map