@jhits/plugin-telemetry 0.0.1 → 0.0.3

package/package.json

@@ -1,53 +1,53 @@
 {
     "name": "@jhits/plugin-telemetry",
-    "version": "0.0.1",
+    "version": "0.0.3",
     "description": "System logging and telemetry utilities for the JHITS ecosystem",
     "publishConfig": {
-      "access": "public"
+        "access": "public"
     },
     "main": "./src/index.ts",
     "types": "./src/index.ts",
     "exports": {
-      ".": {
-        "types": "./src/index.ts",
-        "default": "./src/index.ts"
-      },
-      "./server": {
-        "types": "./src/server.ts",
-        "default": "./src/server.ts"
-      },
-      "./api/route": {
-        "types": "./src/api/route.ts",
-        "default": "./src/api/route.ts"
-      },
-      "./api/handler": {
-        "types": "./src/api/handler.ts",
-        "default": "./src/api/handler.ts"
-      },
-      "./utils/logCleaner": {
-        "types": "./src/utils/logCleaner.ts",
-        "default": "./src/utils/logCleaner.ts"
-      }
+        ".": {
+            "types": "./src/index.ts",
+            "default": "./src/index.ts"
+        },
+        "./server": {
+            "types": "./src/server.ts",
+            "default": "./src/server.ts"
+        },
+        "./api/route": {
+            "types": "./src/api/route.ts",
+            "default": "./src/api/route.ts"
+        },
+        "./api/handler": {
+            "types": "./src/api/handler.ts",
+            "default": "./src/api/handler.ts"
+        },
+        "./utils/logCleaner": {
+            "types": "./src/utils/logCleaner.ts",
+            "default": "./src/utils/logCleaner.ts"
+        }
     },
     "dependencies": {
-      "@jhits/plugin-core": "^0.0.1"
+        "@jhits/plugin-core": "^0.0.1"
     },
     "peerDependencies": {
-      "next": ">=15.0.0",
-      "react": ">=18.0.0",
-      "react-dom": ">=18.0.0"
+        "next": ">=15.0.0",
+        "react": ">=18.0.0",
+        "react-dom": ">=18.0.0"
     },
     "devDependencies": {
-      "@types/node": "^20.19.27",
-      "@types/react": "^19",
-      "@types/react-dom": "^19",
-      "next": "16.1.1",
-      "react": "19.2.3",
-      "react-dom": "19.2.3",
-      "typescript": "^5"
+        "@types/node": "^20.19.27",
+        "@types/react": "^19",
+        "@types/react-dom": "^19",
+        "next": "16.1.1",
+        "react": "19.2.3",
+        "react-dom": "19.2.3",
+        "typescript": "^5"
     },
     "files": [
-      "src",
-      "package.json"
+        "src",
+        "package.json"
     ]
-  }
+}

package/src/api/handler.ts

@@ -1,3 +1,5 @@
+import 'server-only';
+
 /**
  * Telemetry API Handler
  * Plugin-mounted API handler for telemetry logging
@@ -82,14 +84,14 @@ function formatLogEntry(entry: TelemetryEntry): string {
     const context = entry.context || 'unknown';
     const userId = entry.userId || 'anonymous';
     const sessionId = entry.sessionId || 'unknown';
-    
+
     // Sanitize data to prevent log injection
-    const sanitizedData = typeof entry.data === 'object' 
+    const sanitizedData = typeof entry.data === 'object'
         ? JSON.stringify(entry.data).replace(/\n/g, '\\n').replace(/\r/g, '\\r')
         : String(entry.data);
-    
+
     const stackStr = entry.stack ? ` "stack":"${entry.stack.replace(/"/g, '\\"').replace(/\n/g, '\\n')}"` : '';
-    
+
     return `[${timestamp}] [${context}] [${userId}] [${sessionId}] [${entry.category}] ${entry.message} ${sanitizedData}${stackStr}\n`;
 }
 
@@ -133,16 +135,16 @@ function validateEntry(entry: any): TelemetryEntry | null {
  */
 function extractContext(request: NextRequest): { userId?: string; sessionId?: string } {
     // Try to get user ID from headers (custom header)
-    const userId = request.headers.get('x-user-id') || 
-                   request.headers.get('x-userid') ||
-                   undefined;
-    
+    const userId = request.headers.get('x-user-id') ||
+        request.headers.get('x-userid') ||
+        undefined;
+
     // Try to get session ID from headers or cookies
     const sessionId = request.headers.get('x-session-id') ||
-                      request.headers.get('x-sessionid') ||
-                      request.cookies.get('sessionId')?.value ||
-                      request.cookies.get('session')?.value ||
-                      undefined;
+        request.headers.get('x-sessionid') ||
+        request.cookies.get('sessionId')?.value ||
+        request.cookies.get('session')?.value ||
+        undefined;
 
     return { userId, sessionId };
 }
@@ -154,19 +156,19 @@ export async function POST(request: NextRequest): Promise<NextResponse> {
     try {
         // Ensure log directory exists
         await ensureLogDir();
-        
+
         // Rotate log if needed
         await rotateLogIfNeeded();
-        
+
         // Extract context from request
         const { userId, sessionId } = extractContext(request);
-        
+
         // Parse request body
         const body = await request.json();
-        
+
         // Handle single entry or batch of entries
         const entries = Array.isArray(body) ? body : [body];
-        
+
         // Rate limiting: Check batch size
         if (entries.length > MAX_BATCH_SIZE) {
             return NextResponse.json(
@@ -174,7 +176,7 @@ export async function POST(request: NextRequest): Promise<NextResponse> {
                 { status: 400 }
             );
         }
-        
+
         // Validate and sanitize entries
         const validEntries: TelemetryEntry[] = [];
         for (const entry of entries) {
@@ -190,20 +192,20 @@ export async function POST(request: NextRequest): Promise<NextResponse> {
                 validEntries.push(validated);
             }
         }
-        
+
         if (validEntries.length === 0) {
             return NextResponse.json(
                 { success: false, error: 'No valid entries to log' },
                 { status: 400 }
             );
         }
-        
+
         // Format and append each entry
         const logLines = validEntries.map(formatLogEntry).join('');
         await fs.appendFile(LOG_FILE, logLines, 'utf8');
-        
-        return NextResponse.json({ 
-            success: true, 
+
+        return NextResponse.json({
+            success: true,
             logged: validEntries.length,
             rejected: entries.length - validEntries.length
         });
@@ -227,17 +229,17 @@ export function telemetryHandler(req: any, res: any): void {
         try {
             await ensureLogDir();
             await rotateLogIfNeeded();
-            
+
             const body = req.body;
             const entries = Array.isArray(body) ? body : [body];
-            
+
             if (entries.length > MAX_BATCH_SIZE) {
-                return res.status(400).json({ 
-                    success: false, 
-                    error: `Batch size exceeds maximum of ${MAX_BATCH_SIZE}` 
+                return res.status(400).json({
+                    success: false,
+                    error: `Batch size exceeds maximum of ${MAX_BATCH_SIZE}`
                 });
             }
-            
+
             const validEntries: TelemetryEntry[] = [];
             for (const entry of entries) {
                 const validated = validateEntry(entry);
@@ -248,19 +250,19 @@ export function telemetryHandler(req: any, res: any): void {
                     validEntries.push(validated);
                 }
             }
-            
+
             if (validEntries.length === 0) {
-                return res.status(400).json({ 
-                    success: false, 
-                    error: 'No valid entries to log' 
+                return res.status(400).json({
+                    success: false,
+                    error: 'No valid entries to log'
                 });
             }
-            
+
             const logLines = validEntries.map(formatLogEntry).join('');
             await fs.appendFile(LOG_FILE, logLines, 'utf8');
-            
-            res.json({ 
-                success: true, 
+
+            res.json({
+                success: true,
                 logged: validEntries.length,
                 rejected: entries.length - validEntries.length
             });
@@ -269,7 +271,7 @@ export function telemetryHandler(req: any, res: any): void {
             res.status(500).json({ success: false, error: 'Failed to write log' });
         }
     };
-    
+
     handler();
 }
 

package/src/api/route.ts

@@ -1,3 +1,5 @@
+import 'server-only';
+
 /**
  * Telemetry API Route Handler
  * Server-only wrapper for the telemetry handler

package/src/server.ts

@@ -1,3 +1,5 @@
+import 'server-only';
+
 /**
  * Server-only exports for @jhits/plugin-telemetry
  * These exports should only be used in server-side code (API routes, server components)
@@ -80,10 +82,10 @@ function formatLogEntry(entry: TelemetryEntry, debug: boolean = false): string {
     const context = entry.context || 'unknown';
     const userId = entry.userId || 'anonymous';
     const sessionId = entry.sessionId || 'unknown';
-    
+
     // Check for debug mode via environment variable
     const isDebugMode = debug || process.env.TELEMETRY_DEBUG === 'true';
-    
+
     if (isDebugMode) {
         // Pretty-printed format for debugging
         const logObject = {
@@ -99,12 +101,12 @@ function formatLogEntry(entry: TelemetryEntry, debug: boolean = false): string {
         return JSON.stringify(logObject, null, 2) + '\n';
     } else {
         // Single-line JSON format for production (easier grep/tailing)
-        const sanitizedData = typeof entry.data === 'object' 
+        const sanitizedData = typeof entry.data === 'object'
             ? JSON.stringify(entry.data).replace(/\n/g, '\\n').replace(/\r/g, '\\r')
             : String(entry.data);
-        
+
         const stackStr = entry.stack ? ` "stack":"${entry.stack.replace(/"/g, '\\"').replace(/\n/g, '\\n')}"` : '';
-        
+
         return `[${timestamp}] [${context}] [${userId}] [${sessionId}] [${entry.category}] ${entry.message} ${sanitizedData}${stackStr}\n`;
     }
 }
@@ -149,16 +151,16 @@ function validateEntry(entry: any): TelemetryEntry | null {
  */
 function extractContext(request: NextRequest): { userId?: string; sessionId?: string } {
     // Try to get user ID from headers (custom header)
-    const userId = request.headers.get('x-user-id') || 
-                   request.headers.get('x-userid') ||
-                   undefined;
-    
+    const userId = request.headers.get('x-user-id') ||
+        request.headers.get('x-userid') ||
+        undefined;
+
     // Try to get session ID from headers or cookies
     const sessionId = request.headers.get('x-session-id') ||
-                      request.headers.get('x-sessionid') ||
-                      request.cookies.get('sessionId')?.value ||
-                      request.cookies.get('session')?.value ||
-                      undefined;
+        request.headers.get('x-sessionid') ||
+        request.cookies.get('sessionId')?.value ||
+        request.cookies.get('session')?.value ||
+        undefined;
 
     return { userId, sessionId };
 }
@@ -178,13 +180,13 @@ export async function telemetryHandler(
     try {
         // Ensure log directory exists
         await ensureLogDir();
-        
+
         // Rotate log if needed
         await rotateLogIfNeeded();
-        
+
         // Handle single entry or batch of entries
         const entries = Array.isArray(data) ? data : [data];
-        
+
         // Rate limiting: Check batch size
         if (entries.length > MAX_BATCH_SIZE) {
             return {
@@ -192,7 +194,7 @@ export async function telemetryHandler(
                 error: `Batch size exceeds maximum of ${MAX_BATCH_SIZE}`
             };
         }
-        
+
         // Validate and sanitize entries
         const validEntries: TelemetryEntry[] = [];
         for (const entry of entries) {
@@ -208,19 +210,19 @@ export async function telemetryHandler(
                 validEntries.push(validated);
             }
         }
-        
+
         if (validEntries.length === 0) {
             return {
                 success: false,
                 error: 'No valid entries to log'
             };
         }
-        
+
         // Format and append each entry (check for debug mode)
         const debugMode = process.env.TELEMETRY_DEBUG === 'true';
         const logLines = validEntries.map(entry => formatLogEntry(entry, debugMode)).join('');
         await fs.appendFile(LOG_FILE, logLines, 'utf8');
-        
+
         return {
             success: true,
             logged: validEntries.length,