Next.js SDK Logging

# .npmrc
@abrova-trace:registry=https://center.abrova.ir/api/packages/abrova/npm/

npm install @abrova-trace/nextjs-sdk

import { LogService } from '@abrova-trace/nextjs-sdk';

export const logger = new LogService({
  apiKey: process.env.ABROVA_TRACE_API_KEY!,
  sourceId: 'nextjs-app',
  sourceName: 'My Next.js App',
  platform: 'nextjs',
  environment: process.env.NODE_ENV,
});

// app/api/users/route.ts
import { NextResponse } from 'next/server';
import { logger } from '@/lib/logger';

export async function GET(request: Request) {
  logger.log('Fetching users', 'info');

  try {
    const users = await db.users.findMany();
    logger.log('Users fetched', 'info', { count: users.length });
    return NextResponse.json(users);
  } catch (error) {
    logger.log('Failed to fetch users', 'error', {
      error: error instanceof Error ? error.message : 'Unknown',
    });
    return NextResponse.json({ error: 'Internal Server Error' }, { status: 500 });
  }
}

// pages/api/orders.ts
import { logger } from '@/lib/logger';

export default async function handler(req, res) {
  logger.log('Order request received', 'info', {
    method: req.method,
    path: req.url,
  });

  try {
    const order = await createOrder(req.body);
    logger.log('Order created', 'info', { orderId: order.id });
    res.json(order);
  } catch (error) {
    logger.log('Order creation failed', 'error', {
      error: error.message,
    });
    res.status(500).json({ error: 'Failed to create order' });
  }
}

// LogLevel = 'trace' | 'debug' | 'info' | 'warn' | 'error' | 'fatal'

logger.log('Detailed trace info', 'trace');
logger.log('Debug information', 'debug');
logger.log('User action completed', 'info');
logger.log('Approaching rate limit', 'warn');
logger.log('Failed to save data', 'error');
logger.log('App crashed unexpectedly', 'fatal');

// middleware.ts
import { NextResponse } from 'next/server';
import type { NextRequest } from 'next/server';
import { logger } from '@/lib/logger';

export function middleware(request: NextRequest) {
  const start = Date.now();

  logger.log('Request received', 'info', {
    method: request.method,
    path: request.nextUrl.pathname,
  });

  const response = NextResponse.next();
  const duration = Date.now() - start;

  logger.log('Request processed', 'info', {
    path: request.nextUrl.pathname,
    duration,
  });

  return response;
}

export const config = { matcher: '/api/:path*' };

// app/api/log/route.ts
import { NextResponse } from 'next/server';
import { logger } from '@/lib/logger';

export async function POST(request: Request) {
  const { message, level, metadata } = await request.json();

  const validLevels = ['trace', 'debug', 'info', 'warn', 'error', 'fatal'];
  const safeLevel = validLevels.includes(level) ? level : 'info';

  logger.log(message, safeLevel, { ...metadata, source: 'client' });

  return NextResponse.json({ success: true });
}

'use client';

async function logToServer(message: string, level: string, metadata?: object) {
  await fetch('/api/log', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ message, level, metadata }),
  });
}

// Usage
logToServer('Button clicked', 'info', { buttonId: 'submit-form' });