@vinetechke/next-error-logger 0.1.0-beta.1

package/dist/api/index.cjs

@@ -0,0 +1,257 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/api/index.ts
+var api_exports = {};
+__export(api_exports, {
+  createLogAPIHandlers: () => createLogAPIHandlers,
+  createLogDetailAPIHandlers: () => createLogDetailAPIHandlers,
+  createLogStatsHandler: () => createLogStatsHandler
+});
+module.exports = __toCommonJS(api_exports);
+var import_server = require("next/server");
+
+// src/logger.ts
+var config = null;
+function getConfig() {
+  if (!config) {
+    throw new Error(
+      "[@vinetechke/next-error-logger] Logger not initialized. Call initErrorLogger() first."
+    );
+  }
+  return config;
+}
+function isInitialized() {
+  return config !== null;
+}
+
+// src/api/index.ts
+function createLogAPIHandlers(config2) {
+  const { isAuthorized } = config2;
+  return {
+    /**
+     * GET /api/logs - List logs with filtering and pagination
+     *
+     * Query parameters:
+     * - page: Page number (default: 1)
+     * - limit: Items per page (default: 50)
+     * - level: Filter by level (error, warn, info, debug)
+     * - userId: Filter by user ID
+     * - search: Search in message, stack, path, userEmail
+     * - startDate: Filter logs after this date (ISO string)
+     * - endDate: Filter logs before this date (ISO string)
+     */
+    GET: async (request) => {
+      if (!await isAuthorized(request)) {
+        return import_server.NextResponse.json(
+          { error: "Unauthorized" },
+          { status: 401 }
+        );
+      }
+      if (!isInitialized()) {
+        return import_server.NextResponse.json(
+          { error: "Logger not initialized" },
+          { status: 500 }
+        );
+      }
+      const cfg = getConfig();
+      const searchParams = request.nextUrl.searchParams;
+      try {
+        const options = {
+          page: parseInt(searchParams.get("page") || "1", 10),
+          limit: Math.min(
+            parseInt(searchParams.get("limit") || "50", 10),
+            100
+          ),
+          level: searchParams.get("level"),
+          userId: searchParams.get("userId") || void 0,
+          search: searchParams.get("search") || void 0,
+          startDate: searchParams.get("startDate") ? new Date(searchParams.get("startDate")) : void 0,
+          endDate: searchParams.get("endDate") ? new Date(searchParams.get("endDate")) : void 0
+        };
+        const result = await cfg.adapter.findMany(options);
+        return import_server.NextResponse.json(result);
+      } catch (error) {
+        console.error("[@vinetechke/next-error-logger] API error:", error);
+        return import_server.NextResponse.json(
+          { error: "Failed to fetch logs" },
+          { status: 500 }
+        );
+      }
+    },
+    /**
+     * DELETE /api/logs - Clear logs
+     *
+     * Body parameters:
+     * - before: Delete logs before this date (ISO string)
+     * - level: Delete logs with this level only
+     */
+    DELETE: async (request) => {
+      if (!await isAuthorized(request)) {
+        return import_server.NextResponse.json(
+          { error: "Unauthorized" },
+          { status: 401 }
+        );
+      }
+      if (!isInitialized()) {
+        return import_server.NextResponse.json(
+          { error: "Logger not initialized" },
+          { status: 500 }
+        );
+      }
+      const cfg = getConfig();
+      try {
+        const body = await request.json().catch(() => ({}));
+        const count = await cfg.adapter.deleteMany({
+          before: body.before ? new Date(body.before) : void 0,
+          level: body.level
+        });
+        return import_server.NextResponse.json({ deleted: count });
+      } catch (error) {
+        console.error("[@vinetechke/next-error-logger] API error:", error);
+        return import_server.NextResponse.json(
+          { error: "Failed to delete logs" },
+          { status: 500 }
+        );
+      }
+    }
+  };
+}
+function createLogDetailAPIHandlers(config2) {
+  const { isAuthorized } = config2;
+  return {
+    /**
+     * GET /api/logs/[id] - Get a single log entry
+     */
+    GET: async (request, { params }) => {
+      if (!await isAuthorized(request)) {
+        return import_server.NextResponse.json(
+          { error: "Unauthorized" },
+          { status: 401 }
+        );
+      }
+      if (!isInitialized()) {
+        return import_server.NextResponse.json(
+          { error: "Logger not initialized" },
+          { status: 500 }
+        );
+      }
+      const cfg = getConfig();
+      const { id } = await params;
+      try {
+        const log = await cfg.adapter.findById(id);
+        if (!log) {
+          return import_server.NextResponse.json(
+            { error: "Not found" },
+            { status: 404 }
+          );
+        }
+        return import_server.NextResponse.json(log);
+      } catch (error) {
+        console.error("[@vinetechke/next-error-logger] API error:", error);
+        return import_server.NextResponse.json(
+          { error: "Failed to fetch log" },
+          { status: 500 }
+        );
+      }
+    },
+    /**
+     * DELETE /api/logs/[id] - Delete a single log entry
+     */
+    DELETE: async (request, { params }) => {
+      if (!await isAuthorized(request)) {
+        return import_server.NextResponse.json(
+          { error: "Unauthorized" },
+          { status: 401 }
+        );
+      }
+      if (!isInitialized()) {
+        return import_server.NextResponse.json(
+          { error: "Logger not initialized" },
+          { status: 500 }
+        );
+      }
+      const cfg = getConfig();
+      const { id } = await params;
+      try {
+        await cfg.adapter.delete(id);
+        return import_server.NextResponse.json({ success: true });
+      } catch (error) {
+        console.error("[@vinetechke/next-error-logger] API error:", error);
+        return import_server.NextResponse.json(
+          { error: "Failed to delete log" },
+          { status: 500 }
+        );
+      }
+    }
+  };
+}
+function createLogStatsHandler(config2) {
+  const { isAuthorized } = config2;
+  return async (request) => {
+    if (!await isAuthorized(request)) {
+      return import_server.NextResponse.json({ error: "Unauthorized" }, { status: 401 });
+    }
+    if (!isInitialized()) {
+      return import_server.NextResponse.json(
+        { error: "Logger not initialized" },
+        { status: 500 }
+      );
+    }
+    const cfg = getConfig();
+    try {
+      const [errors, warnings, infos, debugs, total] = await Promise.all([
+        cfg.adapter.findMany({ level: "error", limit: 0 }).then((r) => r.total),
+        cfg.adapter.findMany({ level: "warn", limit: 0 }).then((r) => r.total),
+        cfg.adapter.findMany({ level: "info", limit: 0 }).then((r) => r.total),
+        cfg.adapter.findMany({ level: "debug", limit: 0 }).then((r) => r.total),
+        cfg.adapter.findMany({ limit: 0 }).then((r) => r.total)
+      ]);
+      const oneDayAgo = new Date(Date.now() - 24 * 60 * 60 * 1e3);
+      const recentResult = await cfg.adapter.findMany({
+        startDate: oneDayAgo,
+        limit: 0
+      });
+      return import_server.NextResponse.json({
+        total,
+        byLevel: {
+          error: errors,
+          warn: warnings,
+          info: infos,
+          debug: debugs
+        },
+        last24Hours: recentResult.total
+      });
+    } catch (error) {
+      console.error("[@vinetechke/next-error-logger] API error:", error);
+      return import_server.NextResponse.json(
+        { error: "Failed to fetch stats" },
+        { status: 500 }
+      );
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createLogAPIHandlers,
+  createLogDetailAPIHandlers,
+  createLogStatsHandler
+});
+//# sourceMappingURL=index.cjs.map

package/dist/api/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/index.ts","../../src/logger.ts"],"sourcesContent":["import { NextRequest, NextResponse } from 'next/server'\nimport { getConfig, isInitialized } from '../logger'\nimport type { LogLevel } from '../types'\n\n/**\n * Configuration for API route handlers\n */\nexport interface APIHandlerConfig {\n    /**\n     * Function to check if user is authorized to view logs\n     * Return true to allow access, false to deny\n     *\n     * @example\n     * ```ts\n     * const config = {\n     *   isAuthorized: async (request) => {\n     *     const session = await auth()\n     *     return session?.user?.role === 'admin'\n     *   }\n     * }\n     * ```\n     */\n    isAuthorized: (request: NextRequest) => Promise<boolean>\n}\n\n/**\n * Create API route handlers for the error logger\n *\n * Creates GET, DELETE handlers for listing, fetching, and deleting logs.\n *\n * @example\n * ```ts\n * // app/api/admin/logs/route.ts\n * import { createLogAPIHandlers } from '@vinetechke/next-error-logger/api'\n * import { auth } from '@/auth'\n *\n * const { GET, DELETE } = createLogAPIHandlers({\n *   isAuthorized: async () => {\n *     const session = await auth()\n *     return session?.user?.role === 'ADMIN'\n *   },\n * })\n *\n * export { GET, DELETE }\n * ```\n *\n * @example\n * ```ts\n * // app/api/admin/logs/[id]/route.ts\n * import { createLogDetailAPIHandlers } from '@vinetechke/next-error-logger/api'\n * import { auth } from '@/auth'\n *\n * const { GET, DELETE } = createLogDetailAPIHandlers({\n *   isAuthorized: async () => {\n *     const session = await auth()\n *     return session?.user?.role === 'ADMIN'\n *   },\n * })\n *\n * export { GET, DELETE }\n * ```\n */\nexport function createLogAPIHandlers(config: APIHandlerConfig) {\n    const { isAuthorized } = config\n\n    return {\n        /**\n         * GET /api/logs - List logs with filtering and pagination\n         *\n         * Query parameters:\n         * - page: Page number (default: 1)\n         * - limit: Items per page (default: 50)\n         * - level: Filter by level (error, warn, info, debug)\n         * - userId: Filter by user ID\n         * - search: Search in message, stack, path, userEmail\n         * - startDate: Filter logs after this date (ISO string)\n         * - endDate: Filter logs before this date (ISO string)\n         */\n        GET: async (request: NextRequest): Promise<NextResponse> => {\n            // Check authorization\n            if (!(await isAuthorized(request))) {\n                return NextResponse.json(\n                    { error: 'Unauthorized' },\n                    { status: 401 },\n                )\n            }\n\n            // Check if logger is initialized\n            if (!isInitialized()) {\n                return NextResponse.json(\n                    { error: 'Logger not initialized' },\n                    { status: 500 },\n                )\n            }\n\n            const cfg = getConfig()\n            const searchParams = request.nextUrl.searchParams\n\n            try {\n                const options = {\n                    page: parseInt(searchParams.get('page') || '1', 10),\n                    limit: Math.min(\n                        parseInt(searchParams.get('limit') || '50', 10),\n                        100,\n                    ),\n                    level: searchParams.get('level') as LogLevel | undefined,\n                    userId: searchParams.get('userId') || undefined,\n                    search: searchParams.get('search') || undefined,\n                    startDate: searchParams.get('startDate')\n                        ? new Date(searchParams.get('startDate')!)\n                        : undefined,\n                    endDate: searchParams.get('endDate')\n                        ? new Date(searchParams.get('endDate')!)\n                        : undefined,\n                }\n\n                const result = await cfg.adapter.findMany(options)\n\n                return NextResponse.json(result)\n            } catch (error) {\n                console.error('[@vinetechke/next-error-logger] API error:', error)\n                return NextResponse.json(\n                    { error: 'Failed to fetch logs' },\n                    { status: 500 },\n                )\n            }\n        },\n\n        /**\n         * DELETE /api/logs - Clear logs\n         *\n         * Body parameters:\n         * - before: Delete logs before this date (ISO string)\n         * - level: Delete logs with this level only\n         */\n        DELETE: async (request: NextRequest): Promise<NextResponse> => {\n            // Check authorization\n            if (!(await isAuthorized(request))) {\n                return NextResponse.json(\n                    { error: 'Unauthorized' },\n                    { status: 401 },\n                )\n            }\n\n            // Check if logger is initialized\n            if (!isInitialized()) {\n                return NextResponse.json(\n                    { error: 'Logger not initialized' },\n                    { status: 500 },\n                )\n            }\n\n            const cfg = getConfig()\n\n            try {\n                const body = await request.json().catch(() => ({}))\n\n                const count = await cfg.adapter.deleteMany({\n                    before: body.before ? new Date(body.before) : undefined,\n                    level: body.level as LogLevel | undefined,\n                })\n\n                return NextResponse.json({ deleted: count })\n            } catch (error) {\n                console.error('[@vinetechke/next-error-logger] API error:', error)\n                return NextResponse.json(\n                    { error: 'Failed to delete logs' },\n                    { status: 500 },\n                )\n            }\n        },\n    }\n}\n\n/**\n * Create API route handlers for individual log entries\n *\n * @example\n * ```ts\n * // app/api/admin/logs/[id]/route.ts\n * import { createLogDetailAPIHandlers } from '@vinetechke/next-error-logger/api'\n *\n * const { GET, DELETE } = createLogDetailAPIHandlers({\n *   isAuthorized: async () => {\n *     const session = await auth()\n *     return session?.user?.role === 'ADMIN'\n *   },\n * })\n *\n * export { GET, DELETE }\n * ```\n */\nexport function createLogDetailAPIHandlers(config: APIHandlerConfig) {\n    const { isAuthorized } = config\n\n    return {\n        /**\n         * GET /api/logs/[id] - Get a single log entry\n         */\n        GET: async (\n            request: NextRequest,\n            { params }: { params: Promise<{ id: string }> },\n        ): Promise<NextResponse> => {\n            // Check authorization\n            if (!(await isAuthorized(request))) {\n                return NextResponse.json(\n                    { error: 'Unauthorized' },\n                    { status: 401 },\n                )\n            }\n\n            // Check if logger is initialized\n            if (!isInitialized()) {\n                return NextResponse.json(\n                    { error: 'Logger not initialized' },\n                    { status: 500 },\n                )\n            }\n\n            const cfg = getConfig()\n            const { id } = await params\n\n            try {\n                const log = await cfg.adapter.findById(id)\n\n                if (!log) {\n                    return NextResponse.json(\n                        { error: 'Not found' },\n                        { status: 404 },\n                    )\n                }\n\n                return NextResponse.json(log)\n            } catch (error) {\n                console.error('[@vinetechke/next-error-logger] API error:', error)\n                return NextResponse.json(\n                    { error: 'Failed to fetch log' },\n                    { status: 500 },\n                )\n            }\n        },\n\n        /**\n         * DELETE /api/logs/[id] - Delete a single log entry\n         */\n        DELETE: async (\n            request: NextRequest,\n            { params }: { params: Promise<{ id: string }> },\n        ): Promise<NextResponse> => {\n            // Check authorization\n            if (!(await isAuthorized(request))) {\n                return NextResponse.json(\n                    { error: 'Unauthorized' },\n                    { status: 401 },\n                )\n            }\n\n            // Check if logger is initialized\n            if (!isInitialized()) {\n                return NextResponse.json(\n                    { error: 'Logger not initialized' },\n                    { status: 500 },\n                )\n            }\n\n            const cfg = getConfig()\n            const { id } = await params\n\n            try {\n                await cfg.adapter.delete(id)\n                return NextResponse.json({ success: true })\n            } catch (error) {\n                console.error('[@vinetechke/next-error-logger] API error:', error)\n                return NextResponse.json(\n                    { error: 'Failed to delete log' },\n                    { status: 500 },\n                )\n            }\n        },\n    }\n}\n\n/**\n * Get log statistics\n *\n * @example\n * ```ts\n * // app/api/admin/logs/stats/route.ts\n * import { createLogStatsHandler } from '@vinetechke/next-error-logger/api'\n *\n * export const GET = createLogStatsHandler({\n *   isAuthorized: async () => {\n *     const session = await auth()\n *     return session?.user?.role === 'ADMIN'\n *   },\n * })\n * ```\n */\nexport function createLogStatsHandler(config: APIHandlerConfig) {\n    const { isAuthorized } = config\n\n    return async (request: NextRequest): Promise<NextResponse> => {\n        // Check authorization\n        if (!(await isAuthorized(request))) {\n            return NextResponse.json({ error: 'Unauthorized' }, { status: 401 })\n        }\n\n        // Check if logger is initialized\n        if (!isInitialized()) {\n            return NextResponse.json(\n                { error: 'Logger not initialized' },\n                { status: 500 },\n            )\n        }\n\n        const cfg = getConfig()\n\n        try {\n            // Get counts for each level\n            const [errors, warnings, infos, debugs, total] = await Promise.all([\n                cfg.adapter\n                    .findMany({ level: 'error', limit: 0 })\n                    .then(r => r.total),\n                cfg.adapter\n                    .findMany({ level: 'warn', limit: 0 })\n                    .then(r => r.total),\n                cfg.adapter\n                    .findMany({ level: 'info', limit: 0 })\n                    .then(r => r.total),\n                cfg.adapter\n                    .findMany({ level: 'debug', limit: 0 })\n                    .then(r => r.total),\n                cfg.adapter.findMany({ limit: 0 }).then(r => r.total),\n            ])\n\n            // Get recent logs (last 24 hours)\n            const oneDayAgo = new Date(Date.now() - 24 * 60 * 60 * 1000)\n            const recentResult = await cfg.adapter.findMany({\n                startDate: oneDayAgo,\n                limit: 0,\n            })\n\n            return NextResponse.json({\n                total,\n                byLevel: {\n                    error: errors,\n                    warn: warnings,\n                    info: infos,\n                    debug: debugs,\n                },\n                last24Hours: recentResult.total,\n            })\n        } catch (error) {\n            console.error('[@vinetechke/next-error-logger] API error:', error)\n            return NextResponse.json(\n                { error: 'Failed to fetch stats' },\n                { status: 500 },\n            )\n        }\n    }\n}\n","import type {\n    ErrorLoggerConfig,\n    LogLevel,\n    ErrorLogEntry,\n    RequestContext,\n    LogResult,\n} from './types'\n\nlet config: ErrorLoggerConfig | null = null\n\n/**\n * Initialize the error logger with your configuration\n * Must be called before using errorLogger\n *\n * @example\n * ```ts\n * import { initErrorLogger } from '@vinetechke/next-error-logger'\n * import { createPrismaAdapter } from '@vinetechke/next-error-logger/adapters/prisma'\n * import { createNextAuthAdapter } from '@vinetechke/next-error-logger/auth/next-auth'\n * import { prisma } from '@/lib/prisma'\n * import { auth } from '@/auth'\n *\n * initErrorLogger({\n *   adapter: createPrismaAdapter(prisma),\n *   authAdapter: createNextAuthAdapter(auth),\n *   retentionDays: 30,\n * })\n * ```\n */\nexport function initErrorLogger(cfg: ErrorLoggerConfig): void {\n    config = {\n        consoleInDev: true,\n        retentionDays: 30,\n        ...cfg,\n    }\n}\n\n/**\n * Get the current logger configuration\n * @throws Error if logger is not initialized\n */\nexport function getConfig(): ErrorLoggerConfig {\n    if (!config) {\n        throw new Error(\n            '[@vinetechke/next-error-logger] Logger not initialized. Call initErrorLogger() first.',\n        )\n    }\n    return config\n}\n\n/**\n * Check if logger is initialized\n */\nexport function isInitialized(): boolean {\n    return config !== null\n}\n\n/**\n * Internal logging function\n */\nasync function log(\n    level: LogLevel,\n    message: string,\n    error?: Error | null,\n    context?: RequestContext,\n): Promise<LogResult> {\n    try {\n        const cfg = getConfig()\n\n        // Check if this level should be captured\n        if (cfg.levels && !cfg.levels.includes(level)) {\n            return { success: true }\n        }\n\n        // Console output in development\n        if (cfg.consoleInDev && process.env.NODE_ENV === 'development') {\n            const consoleMethod =\n                level === 'error' ? 'error' : level === 'warn' ? 'warn' : 'log'\n            console[consoleMethod](\n                `[${level.toUpperCase()}]`,\n                message,\n                error || '',\n                context || '',\n            )\n        }\n\n        // Get user context if auth adapter is provided\n        let user: { id: string; email?: string; name?: string } | null = null\n        if (cfg.authAdapter) {\n            try {\n                user = await cfg.authAdapter.getUser()\n            } catch {\n                // Silently ignore auth errors - user context is optional\n            }\n        }\n\n        // Create the log entry\n        const entry = await cfg.adapter.create({\n            level,\n            message,\n            stack: error?.stack || null,\n            userId: user?.id || null,\n            userEmail: user?.email || null,\n            userName: user?.name || null,\n            path: context?.path || null,\n            method: context?.method || null,\n            userAgent: context?.userAgent || null,\n            ip: context?.ip || null,\n            metadata: context?.metadata || null,\n        })\n\n        return { success: true, entry }\n    } catch (err) {\n        // Don't throw on logging failures - just return error result\n        console.error('[@vinetechke/next-error-logger] Failed to log:', err)\n        return {\n            success: false,\n            error: err instanceof Error ? err.message : 'Unknown error',\n        }\n    }\n}\n\n/**\n * Extract request context from a Next.js Request object\n */\nfunction extractRequestContext(request: Request): RequestContext {\n    const url = new URL(request.url)\n    return {\n        path: url.pathname,\n        method: request.method,\n        userAgent: request.headers.get('user-agent') || undefined,\n        ip:\n            request.headers.get('x-forwarded-for')?.split(',')[0]?.trim() ||\n            request.headers.get('x-real-ip') ||\n            undefined,\n    }\n}\n\n/**\n * Main error logger instance\n *\n * @example\n * ```ts\n * // Simple logging\n * await errorLogger.error('Something went wrong', error)\n * await errorLogger.warn('Deprecated API used')\n * await errorLogger.info('User completed checkout')\n *\n * // With request context (in API routes)\n * const log = errorLogger.fromRequest(request)\n * await log.error('API failed', error, { orderId: '123' })\n * ```\n */\nexport const errorLogger = {\n    /**\n     * Log an error with optional Error object and context\n     */\n    error: (\n        message: string,\n        error?: Error,\n        context?: RequestContext,\n    ): Promise<LogResult> => log('error', message, error, context),\n\n    /**\n     * Log a warning with optional Error object and context\n     */\n    warn: (\n        message: string,\n        error?: Error,\n        context?: RequestContext,\n    ): Promise<LogResult> => log('warn', message, error, context),\n\n    /**\n     * Log an info message with optional context\n     */\n    info: (message: string, context?: RequestContext): Promise<LogResult> =>\n        log('info', message, null, context),\n\n    /**\n     * Log a debug message with optional context\n     */\n    debug: (message: string, context?: RequestContext): Promise<LogResult> =>\n        log('debug', message, null, context),\n\n    /**\n     * Create a logger instance bound to a specific request\n     * Automatically extracts path, method, user agent, and IP\n     *\n     * @example\n     * ```ts\n     * export async function POST(request: Request) {\n     *   const log = errorLogger.fromRequest(request)\n     *\n     *   try {\n     *     // ... your code\n     *   } catch (error) {\n     *     await log.error('Failed to process', error as Error, { orderId: '123' })\n     *     return new Response('Error', { status: 500 })\n     *   }\n     * }\n     * ```\n     */\n    fromRequest: (request: Request) => {\n        const baseContext = extractRequestContext(request)\n\n        return {\n            error: (\n                message: string,\n                error?: Error,\n                metadata?: Record<string, unknown>,\n            ): Promise<LogResult> =>\n                log('error', message, error, { ...baseContext, metadata }),\n\n            warn: (\n                message: string,\n                metadata?: Record<string, unknown>,\n            ): Promise<LogResult> =>\n                log('warn', message, null, { ...baseContext, metadata }),\n\n            info: (\n                message: string,\n                metadata?: Record<string, unknown>,\n            ): Promise<LogResult> =>\n                log('info', message, null, { ...baseContext, metadata }),\n\n            debug: (\n                message: string,\n                metadata?: Record<string, unknown>,\n            ): Promise<LogResult> =>\n                log('debug', message, null, { ...baseContext, metadata }),\n        }\n    },\n\n    /**\n     * Log with explicit user context (when auth adapter is not available)\n     *\n     * @example\n     * ```ts\n     * await errorLogger.withUser({ id: 'user-123', email: 'user@example.com' })\n     *   .error('User action failed', error)\n     * ```\n     */\n    withUser: (user: { id: string; email?: string; name?: string }) => {\n        return {\n            error: async (\n                message: string,\n                error?: Error,\n                context?: RequestContext,\n            ): Promise<LogResult> => {\n                const cfg = getConfig()\n                try {\n                    const entry = await cfg.adapter.create({\n                        level: 'error',\n                        message,\n                        stack: error?.stack || null,\n                        userId: user.id,\n                        userEmail: user.email || null,\n                        userName: user.name || null,\n                        path: context?.path || null,\n                        method: context?.method || null,\n                        userAgent: context?.userAgent || null,\n                        ip: context?.ip || null,\n                        metadata: context?.metadata || null,\n                    })\n                    return { success: true, entry }\n                } catch (err) {\n                    return {\n                        success: false,\n                        error:\n                            err instanceof Error\n                                ? err.message\n                                : 'Unknown error',\n                    }\n                }\n            },\n\n            warn: async (\n                message: string,\n                context?: RequestContext,\n            ): Promise<LogResult> => {\n                const cfg = getConfig()\n                try {\n                    const entry = await cfg.adapter.create({\n                        level: 'warn',\n                        message,\n                        stack: null,\n                        userId: user.id,\n                        userEmail: user.email || null,\n                        userName: user.name || null,\n                        path: context?.path || null,\n                        method: context?.method || null,\n                        userAgent: context?.userAgent || null,\n                        ip: context?.ip || null,\n                        metadata: context?.metadata || null,\n                    })\n                    return { success: true, entry }\n                } catch (err) {\n                    return {\n                        success: false,\n                        error:\n                            err instanceof Error\n                                ? err.message\n                                : 'Unknown error',\n                    }\n                }\n            },\n\n            info: async (\n                message: string,\n                context?: RequestContext,\n            ): Promise<LogResult> => {\n                const cfg = getConfig()\n                try {\n                    const entry = await cfg.adapter.create({\n                        level: 'info',\n                        message,\n                        stack: null,\n                        userId: user.id,\n                        userEmail: user.email || null,\n                        userName: user.name || null,\n                        path: context?.path || null,\n                        method: context?.method || null,\n                        userAgent: context?.userAgent || null,\n                        ip: context?.ip || null,\n                        metadata: context?.metadata || null,\n                    })\n                    return { success: true, entry }\n                } catch (err) {\n                    return {\n                        success: false,\n                        error:\n                            err instanceof Error\n                                ? err.message\n                                : 'Unknown error',\n                    }\n                }\n            },\n        }\n    },\n}\n"],"mappings":"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","names":["config"]}

package/dist/api/index.d.cts

@@ -0,0 +1,137 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+/**
+ * Configuration for API route handlers
+ */
+interface APIHandlerConfig {
+    /**
+     * Function to check if user is authorized to view logs
+     * Return true to allow access, false to deny
+     *
+     * @example
+     * ```ts
+     * const config = {
+     *   isAuthorized: async (request) => {
+     *     const session = await auth()
+     *     return session?.user?.role === 'admin'
+     *   }
+     * }
+     * ```
+     */
+    isAuthorized: (request: NextRequest) => Promise<boolean>;
+}
+/**
+ * Create API route handlers for the error logger
+ *
+ * Creates GET, DELETE handlers for listing, fetching, and deleting logs.
+ *
+ * @example
+ * ```ts
+ * // app/api/admin/logs/route.ts
+ * import { createLogAPIHandlers } from '@vinetechke/next-error-logger/api'
+ * import { auth } from '@/auth'
+ *
+ * const { GET, DELETE } = createLogAPIHandlers({
+ *   isAuthorized: async () => {
+ *     const session = await auth()
+ *     return session?.user?.role === 'ADMIN'
+ *   },
+ * })
+ *
+ * export { GET, DELETE }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // app/api/admin/logs/[id]/route.ts
+ * import { createLogDetailAPIHandlers } from '@vinetechke/next-error-logger/api'
+ * import { auth } from '@/auth'
+ *
+ * const { GET, DELETE } = createLogDetailAPIHandlers({
+ *   isAuthorized: async () => {
+ *     const session = await auth()
+ *     return session?.user?.role === 'ADMIN'
+ *   },
+ * })
+ *
+ * export { GET, DELETE }
+ * ```
+ */
+declare function createLogAPIHandlers(config: APIHandlerConfig): {
+    /**
+     * GET /api/logs - List logs with filtering and pagination
+     *
+     * Query parameters:
+     * - page: Page number (default: 1)
+     * - limit: Items per page (default: 50)
+     * - level: Filter by level (error, warn, info, debug)
+     * - userId: Filter by user ID
+     * - search: Search in message, stack, path, userEmail
+     * - startDate: Filter logs after this date (ISO string)
+     * - endDate: Filter logs before this date (ISO string)
+     */
+    GET: (request: NextRequest) => Promise<NextResponse>;
+    /**
+     * DELETE /api/logs - Clear logs
+     *
+     * Body parameters:
+     * - before: Delete logs before this date (ISO string)
+     * - level: Delete logs with this level only
+     */
+    DELETE: (request: NextRequest) => Promise<NextResponse>;
+};
+/**
+ * Create API route handlers for individual log entries
+ *
+ * @example
+ * ```ts
+ * // app/api/admin/logs/[id]/route.ts
+ * import { createLogDetailAPIHandlers } from '@vinetechke/next-error-logger/api'
+ *
+ * const { GET, DELETE } = createLogDetailAPIHandlers({
+ *   isAuthorized: async () => {
+ *     const session = await auth()
+ *     return session?.user?.role === 'ADMIN'
+ *   },
+ * })
+ *
+ * export { GET, DELETE }
+ * ```
+ */
+declare function createLogDetailAPIHandlers(config: APIHandlerConfig): {
+    /**
+     * GET /api/logs/[id] - Get a single log entry
+     */
+    GET: (request: NextRequest, { params }: {
+        params: Promise<{
+            id: string;
+        }>;
+    }) => Promise<NextResponse>;
+    /**
+     * DELETE /api/logs/[id] - Delete a single log entry
+     */
+    DELETE: (request: NextRequest, { params }: {
+        params: Promise<{
+            id: string;
+        }>;
+    }) => Promise<NextResponse>;
+};
+/**
+ * Get log statistics
+ *
+ * @example
+ * ```ts
+ * // app/api/admin/logs/stats/route.ts
+ * import { createLogStatsHandler } from '@vinetechke/next-error-logger/api'
+ *
+ * export const GET = createLogStatsHandler({
+ *   isAuthorized: async () => {
+ *     const session = await auth()
+ *     return session?.user?.role === 'ADMIN'
+ *   },
+ * })
+ * ```
+ */
+declare function createLogStatsHandler(config: APIHandlerConfig): (request: NextRequest) => Promise<NextResponse>;
+
+export { type APIHandlerConfig, createLogAPIHandlers, createLogDetailAPIHandlers, createLogStatsHandler };

package/dist/api/index.d.ts

@@ -0,0 +1,137 @@
+import { NextRequest, NextResponse } from 'next/server';
+
+/**
+ * Configuration for API route handlers
+ */
+interface APIHandlerConfig {
+    /**
+     * Function to check if user is authorized to view logs
+     * Return true to allow access, false to deny
+     *
+     * @example
+     * ```ts
+     * const config = {
+     *   isAuthorized: async (request) => {
+     *     const session = await auth()
+     *     return session?.user?.role === 'admin'
+     *   }
+     * }
+     * ```
+     */
+    isAuthorized: (request: NextRequest) => Promise<boolean>;
+}
+/**
+ * Create API route handlers for the error logger
+ *
+ * Creates GET, DELETE handlers for listing, fetching, and deleting logs.
+ *
+ * @example
+ * ```ts
+ * // app/api/admin/logs/route.ts
+ * import { createLogAPIHandlers } from '@vinetechke/next-error-logger/api'
+ * import { auth } from '@/auth'
+ *
+ * const { GET, DELETE } = createLogAPIHandlers({
+ *   isAuthorized: async () => {
+ *     const session = await auth()
+ *     return session?.user?.role === 'ADMIN'
+ *   },
+ * })
+ *
+ * export { GET, DELETE }
+ * ```
+ *
+ * @example
+ * ```ts
+ * // app/api/admin/logs/[id]/route.ts
+ * import { createLogDetailAPIHandlers } from '@vinetechke/next-error-logger/api'
+ * import { auth } from '@/auth'
+ *
+ * const { GET, DELETE } = createLogDetailAPIHandlers({
+ *   isAuthorized: async () => {
+ *     const session = await auth()
+ *     return session?.user?.role === 'ADMIN'
+ *   },
+ * })
+ *
+ * export { GET, DELETE }
+ * ```
+ */
+declare function createLogAPIHandlers(config: APIHandlerConfig): {
+    /**
+     * GET /api/logs - List logs with filtering and pagination
+     *
+     * Query parameters:
+     * - page: Page number (default: 1)
+     * - limit: Items per page (default: 50)
+     * - level: Filter by level (error, warn, info, debug)
+     * - userId: Filter by user ID
+     * - search: Search in message, stack, path, userEmail
+     * - startDate: Filter logs after this date (ISO string)
+     * - endDate: Filter logs before this date (ISO string)
+     */
+    GET: (request: NextRequest) => Promise<NextResponse>;
+    /**
+     * DELETE /api/logs - Clear logs
+     *
+     * Body parameters:
+     * - before: Delete logs before this date (ISO string)
+     * - level: Delete logs with this level only
+     */
+    DELETE: (request: NextRequest) => Promise<NextResponse>;
+};
+/**
+ * Create API route handlers for individual log entries
+ *
+ * @example
+ * ```ts
+ * // app/api/admin/logs/[id]/route.ts
+ * import { createLogDetailAPIHandlers } from '@vinetechke/next-error-logger/api'
+ *
+ * const { GET, DELETE } = createLogDetailAPIHandlers({
+ *   isAuthorized: async () => {
+ *     const session = await auth()
+ *     return session?.user?.role === 'ADMIN'
+ *   },
+ * })
+ *
+ * export { GET, DELETE }
+ * ```
+ */
+declare function createLogDetailAPIHandlers(config: APIHandlerConfig): {
+    /**
+     * GET /api/logs/[id] - Get a single log entry
+     */
+    GET: (request: NextRequest, { params }: {
+        params: Promise<{
+            id: string;
+        }>;
+    }) => Promise<NextResponse>;
+    /**
+     * DELETE /api/logs/[id] - Delete a single log entry
+     */
+    DELETE: (request: NextRequest, { params }: {
+        params: Promise<{
+            id: string;
+        }>;
+    }) => Promise<NextResponse>;
+};
+/**
+ * Get log statistics
+ *
+ * @example
+ * ```ts
+ * // app/api/admin/logs/stats/route.ts
+ * import { createLogStatsHandler } from '@vinetechke/next-error-logger/api'
+ *
+ * export const GET = createLogStatsHandler({
+ *   isAuthorized: async () => {
+ *     const session = await auth()
+ *     return session?.user?.role === 'ADMIN'
+ *   },
+ * })
+ * ```
+ */
+declare function createLogStatsHandler(config: APIHandlerConfig): (request: NextRequest) => Promise<NextResponse>;
+
+export { type APIHandlerConfig, createLogAPIHandlers, createLogDetailAPIHandlers, createLogStatsHandler };