glasswork 0.9.1 → 0.10.0

package/dist/observability/exception-tracking.js

@@ -0,0 +1,238 @@
+import { isTest } from '../utils/environment.js';
+import { getRequestContext, setRequestUser } from './request-context.js';
+/**
+ * Default exception tracking configuration.
+ * Only tracks 5xx server errors by default.
+ */
+export const defaultTrackStatusCodes = (statusCode) => statusCode >= 500;
+/**
+ * Determine if an exception should be tracked based on explicit flag and status code rules.
+ *
+ * @param explicitTrack - Explicit track flag from exception (overrides status code rules)
+ * @param statusCode - HTTP status code
+ * @param config - Tracking configuration
+ * @returns true if the exception should be tracked
+ *
+ * @internal
+ */
+export function shouldTrackException(explicitTrack, statusCode, config) {
+    // Explicit tracking flag takes precedence
+    if (explicitTrack !== undefined) {
+        return explicitTrack;
+    }
+    // Otherwise use status code rules
+    return config.trackStatusCodes(statusCode);
+}
+/**
+ * Create middleware for exception tracking context setup.
+ *
+ * This middleware sets up request context for exception tracking.
+ * Actual exception capture is handled in the error handler.
+ *
+ * @param config - Exception tracking configuration
+ * @returns Hono middleware handler
+ *
+ * @example
+ * ```typescript
+ * import { createExceptionTrackingMiddleware } from 'glasswork';
+ *
+ * app.use(createExceptionTrackingMiddleware({
+ *   tracker,
+ *   trackStatusCodes: (status) => status >= 500,
+ * }));
+ * ```
+ */
+export function createExceptionTrackingMiddleware(config) {
+    return async (c, next) => {
+        // Get request context from AsyncLocalStorage if available
+        const ctx = getRequestContext();
+        const requestId = ctx?.requestId ?? c.get('requestId');
+        config.tracker.setContext('request', {
+            id: requestId,
+            method: c.req.method,
+            path: c.req.path,
+            userAgent: c.req.header('user-agent'),
+        });
+        await next();
+    };
+}
+/**
+ * Create a CloudWatch-based exception tracker.
+ *
+ * This tracker publishes custom metrics to CloudWatch for error monitoring.
+ * It's a zero-dependency option that works natively with AWS infrastructure.
+ *
+ * **Features:**
+ * - Publishes `ErrorCount` metric on each exception
+ * - Includes dimensions for path, error type, status code
+ * - Optional console logging for CloudWatch Logs visibility
+ * - Works without additional dependencies in Lambda
+ *
+ * **CloudWatch Alarms:**
+ * Create alarms on the `ErrorCount` metric to get notified of issues.
+ *
+ * @param options - Configuration options
+ * @returns Exception tracker instance
+ *
+ * @example
+ * ```typescript
+ * import { createCloudWatchTracker, bootstrap } from 'glasswork';
+ *
+ * const tracker = createCloudWatchTracker({
+ *   namespace: 'MyApp/Errors',
+ *   dimensions: {
+ *     environment: process.env.NODE_ENV,
+ *     service: 'user-api',
+ *   },
+ * });
+ *
+ * const { app } = await bootstrap(AppModule, {
+ *   exceptionTracking: { tracker },
+ * });
+ * ```
+ */
+export function createCloudWatchTracker(options = {}) {
+    const { namespace = 'Application/Errors', dimensions = {}, cloudWatchClient, logToConsole = !isTest(), } = options;
+    // Lazy-load AWS SDK to avoid bundling if not used
+    let cwClient = cloudWatchClient ?? null;
+    async function getClient() {
+        if (cwClient)
+            return cwClient;
+        try {
+            // Dynamic import to avoid bundling if not used
+            const { CloudWatchClient } = await import('@aws-sdk/client-cloudwatch');
+            cwClient = new CloudWatchClient({});
+            return cwClient;
+        }
+        catch {
+            // AWS SDK not available - log only
+            return null;
+        }
+    }
+    async function putMetric(metricName, value, extraDimensions = {}) {
+        const client = await getClient();
+        if (!client)
+            return;
+        try {
+            const { PutMetricDataCommand } = await import('@aws-sdk/client-cloudwatch');
+            const allDimensions = { ...dimensions, ...extraDimensions };
+            const dimensionArray = Object.entries(allDimensions).map(([Name, Value]) => ({
+                Name,
+                Value,
+            }));
+            await client.send(new PutMetricDataCommand({
+                Namespace: namespace,
+                MetricData: [
+                    {
+                        MetricName: metricName,
+                        Value: value,
+                        Unit: 'Count',
+                        Timestamp: new Date(),
+                        Dimensions: dimensionArray,
+                    },
+                ],
+            }));
+        }
+        catch (err) {
+            // Don't throw - exception tracking should never break the app
+            if (logToConsole) {
+                console.error('[CloudWatchTracker] Failed to put metric:', err);
+            }
+        }
+    }
+    const contextStore = {};
+    return {
+        captureException(error, context) {
+            const ctx = getRequestContext();
+            if (logToConsole) {
+                console.error('[Exception]', {
+                    error: error.message,
+                    stack: error.stack,
+                    requestId: ctx?.requestId ?? context?.requestId,
+                    userId: ctx?.userId,
+                    ...context,
+                });
+            }
+            // Publish metric to CloudWatch
+            void putMetric('ErrorCount', 1, {
+                ErrorType: error.name || 'Error',
+                Path: String(context?.path ?? ctx?.path ?? 'unknown'),
+                StatusCode: String(context?.statusCode ?? 500),
+            });
+        },
+        captureMessage(message, level, context) {
+            const ctx = getRequestContext();
+            if (logToConsole) {
+                const logFn = level === 'error' ? console.error : level === 'warning' ? console.warn : console.log;
+                logFn(`[${level.toUpperCase()}]`, message, {
+                    requestId: ctx?.requestId,
+                    userId: ctx?.userId,
+                    ...context,
+                });
+            }
+            if (level === 'error') {
+                void putMetric('ErrorCount', 1, {
+                    ErrorType: 'Message',
+                    Path: String(context?.path ?? ctx?.path ?? 'unknown'),
+                });
+            }
+        },
+        setUser(user) {
+            // Set user in request context (preferred method)
+            // User info will be available via getRequestContext() for logging and tracking
+            setRequestUser(user.id);
+        },
+        setContext(key, data) {
+            contextStore[key] = data;
+        },
+    };
+}
+/**
+ * Create a console-only exception tracker for development.
+ *
+ * This tracker logs exceptions to the console without sending to external services.
+ * Useful for local development and testing.
+ *
+ * @returns Exception tracker instance
+ *
+ * @example
+ * ```typescript
+ * import { createConsoleTracker, bootstrap, isDevelopment } from 'glasswork';
+ *
+ * const tracker = isDevelopment()
+ *   ? createConsoleTracker()
+ *   : createCloudWatchTracker({ namespace: 'MyApp/Errors' });
+ *
+ * const { app } = await bootstrap(AppModule, {
+ *   exceptionTracking: { tracker },
+ * });
+ * ```
+ */
+export function createConsoleTracker() {
+    return {
+        captureException(error, context) {
+            const ctx = getRequestContext();
+            console.error('[Exception]', {
+                error: error.message,
+                stack: error.stack,
+                requestId: ctx?.requestId ?? context?.requestId,
+                ...context,
+            });
+        },
+        captureMessage(message, level, context) {
+            const ctx = getRequestContext();
+            const logFn = level === 'error' ? console.error : level === 'warning' ? console.warn : console.log;
+            logFn(`[${level.toUpperCase()}]`, message, {
+                requestId: ctx?.requestId,
+                ...context,
+            });
+        },
+        setUser() {
+            // No-op for console tracker
+        },
+        setContext() {
+            // No-op for console tracker
+        },
+    };
+}
+//# sourceMappingURL=exception-tracking.js.map

package/dist/observability/exception-tracking.js.map

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

package/dist/observability/pino-logger.d.ts

@@ -0,0 +1,108 @@
+import type { MiddlewareHandler } from 'hono';
+import type { Logger } from '../utils/logger.js';
+/**
+ * Pino logger interface - subset of pino.Logger for type compatibility.
+ * This allows the framework to work with Pino without a hard dependency.
+ */
+export interface PinoLogger {
+    level: string;
+    debug: (obj: object, msg?: string) => void;
+    info: (obj: object, msg?: string) => void;
+    warn: (obj: object, msg?: string) => void;
+    error: (obj: object, msg?: string) => void;
+    child: (bindings: Record<string, unknown>) => PinoLogger;
+    flush?: () => void | Promise<void>;
+}
+/**
+ * Options for creating a context-aware Pino logger.
+ */
+export interface ContextAwarePinoOptions {
+    /**
+     * Base Pino logger instance.
+     * Create with: `pino({ level: 'info' })`
+     */
+    pino: PinoLogger;
+    /**
+     * Service name to include in all logs.
+     * Useful for filtering logs by service in CloudWatch.
+     */
+    service?: string;
+}
+/**
+ * Create a context-aware logger that automatically includes request context.
+ *
+ * This logger wraps a Pino instance and automatically injects:
+ * - requestId (from AsyncLocalStorage)
+ * - userId (if set via setRequestUser)
+ * - service name
+ *
+ * The logger uses Pino's structured logging format, optimized for CloudWatch Logs Insights.
+ *
+ * @param options - Configuration options
+ * @returns Logger instance compatible with Glasswork's Logger interface
+ *
+ * @example
+ * ```typescript
+ * import pino from 'pino';
+ * import { createContextAwarePinoLogger } from 'glasswork';
+ *
+ * const logger = createContextAwarePinoLogger({
+ *   pino: pino({ level: 'info' }),
+ *   service: 'user-service',
+ * });
+ *
+ * // In your service (requestId automatically included!)
+ * logger.info('Creating user', { email: 'test@example.com' });
+ * // Output: {"level":"info","requestId":"abc-123","service":"user-service","msg":"Creating user","email":"test@example.com"}
+ * ```
+ */
+export declare function createContextAwarePinoLogger(options: ContextAwarePinoOptions): Logger;
+/**
+ * Create HTTP request logging middleware for Pino.
+ *
+ * This middleware logs HTTP requests with:
+ * - requestId
+ * - method, path, status
+ * - duration (ms)
+ * - userId (if authenticated)
+ *
+ * @param pino - Pino logger instance
+ * @returns Hono middleware handler
+ *
+ * @example
+ * ```typescript
+ * import pino from 'pino';
+ * import { createPinoHttpMiddleware } from 'glasswork';
+ *
+ * const logger = pino({ level: 'info' });
+ * app.use(createPinoHttpMiddleware(logger));
+ * ```
+ */
+export declare function createPinoHttpMiddleware(pino: PinoLogger): MiddlewareHandler;
+/**
+ * Default Pino configuration optimized for AWS Lambda.
+ *
+ * Features:
+ * - JSON output (CloudWatch Logs Insights compatible)
+ * - Minimal formatting overhead
+ * - Fast serialization
+ *
+ * @example
+ * ```typescript
+ * import pino from 'pino';
+ * import { lambdaPinoConfig } from 'glasswork';
+ *
+ * const logger = pino(lambdaPinoConfig);
+ * ```
+ */
+export declare const lambdaPinoConfig: {
+    level: string;
+    formatters: {
+        level: (label: string) => {
+            level: string;
+        };
+    };
+    transport: undefined;
+    base: undefined;
+};
+//# sourceMappingURL=pino-logger.d.ts.map

package/dist/observability/pino-logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pino-logger.d.ts","sourceRoot":"","sources":["../../src/observability/pino-logger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAC9C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAGjD;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,IAAI,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,UAAU,CAAC;IACzD,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;;OAGG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,uBAAuB,GAAG,MAAM,CA2DrF;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,iBAAiB,CA8B5E;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB;;;uBAIV,MAAM;;;;;;CAMxB,CAAC"}

package/dist/observability/pino-logger.js

@@ -0,0 +1,158 @@
+import { getRequestContext } from './request-context.js';
+/**
+ * Create a context-aware logger that automatically includes request context.
+ *
+ * This logger wraps a Pino instance and automatically injects:
+ * - requestId (from AsyncLocalStorage)
+ * - userId (if set via setRequestUser)
+ * - service name
+ *
+ * The logger uses Pino's structured logging format, optimized for CloudWatch Logs Insights.
+ *
+ * @param options - Configuration options
+ * @returns Logger instance compatible with Glasswork's Logger interface
+ *
+ * @example
+ * ```typescript
+ * import pino from 'pino';
+ * import { createContextAwarePinoLogger } from 'glasswork';
+ *
+ * const logger = createContextAwarePinoLogger({
+ *   pino: pino({ level: 'info' }),
+ *   service: 'user-service',
+ * });
+ *
+ * // In your service (requestId automatically included!)
+ * logger.info('Creating user', { email: 'test@example.com' });
+ * // Output: {"level":"info","requestId":"abc-123","service":"user-service","msg":"Creating user","email":"test@example.com"}
+ * ```
+ */
+export function createContextAwarePinoLogger(options) {
+    const { pino, service } = options;
+    function getBindings() {
+        const ctx = getRequestContext();
+        const bindings = {};
+        if (ctx?.requestId) {
+            bindings.requestId = ctx.requestId;
+        }
+        if (ctx?.userId) {
+            bindings.userId = ctx.userId;
+        }
+        if (service) {
+            bindings.service = service;
+        }
+        // Include custom context
+        if (ctx?.custom) {
+            Object.assign(bindings, ctx.custom);
+        }
+        return bindings;
+    }
+    function createLogObject(_msg, meta) {
+        const bindings = getBindings();
+        let obj = { ...bindings };
+        // Handle meta arguments
+        for (const item of meta) {
+            if (item && typeof item === 'object' && !Array.isArray(item)) {
+                obj = { ...obj, ...item };
+            }
+        }
+        return obj;
+    }
+    return {
+        debug(msg, ...meta) {
+            pino.debug(createLogObject(msg, meta), msg);
+        },
+        info(msg, ...meta) {
+            pino.info(createLogObject(msg, meta), msg);
+        },
+        warn(msg, ...meta) {
+            pino.warn(createLogObject(msg, meta), msg);
+        },
+        error(msg, ...meta) {
+            pino.error(createLogObject(msg, meta), msg);
+        },
+        child(bindings) {
+            return createContextAwarePinoLogger({
+                pino: pino.child(bindings),
+                service,
+            });
+        },
+    };
+}
+/**
+ * Create HTTP request logging middleware for Pino.
+ *
+ * This middleware logs HTTP requests with:
+ * - requestId
+ * - method, path, status
+ * - duration (ms)
+ * - userId (if authenticated)
+ *
+ * @param pino - Pino logger instance
+ * @returns Hono middleware handler
+ *
+ * @example
+ * ```typescript
+ * import pino from 'pino';
+ * import { createPinoHttpMiddleware } from 'glasswork';
+ *
+ * const logger = pino({ level: 'info' });
+ * app.use(createPinoHttpMiddleware(logger));
+ * ```
+ */
+export function createPinoHttpMiddleware(pino) {
+    return async (c, next) => {
+        const start = Date.now();
+        await next();
+        const duration = Date.now() - start;
+        const ctx = getRequestContext();
+        const logObject = {
+            requestId: ctx?.requestId,
+            method: c.req.method,
+            path: c.req.path,
+            status: c.res.status,
+            duration,
+        };
+        if (ctx?.userId) {
+            logObject.userId = ctx.userId;
+        }
+        // Use appropriate log level based on status
+        if (c.res.status >= 500) {
+            pino.error(logObject, 'HTTP Request');
+        }
+        else if (c.res.status >= 400) {
+            pino.warn(logObject, 'HTTP Request');
+        }
+        else {
+            pino.info(logObject, 'HTTP Request');
+        }
+    };
+}
+/**
+ * Default Pino configuration optimized for AWS Lambda.
+ *
+ * Features:
+ * - JSON output (CloudWatch Logs Insights compatible)
+ * - Minimal formatting overhead
+ * - Fast serialization
+ *
+ * @example
+ * ```typescript
+ * import pino from 'pino';
+ * import { lambdaPinoConfig } from 'glasswork';
+ *
+ * const logger = pino(lambdaPinoConfig);
+ * ```
+ */
+export const lambdaPinoConfig = {
+    level: process.env.LOG_LEVEL || 'info',
+    // Use safe formatters that work in Lambda
+    formatters: {
+        level: (label) => ({ level: label }),
+    },
+    // Disable pretty printing
+    transport: undefined,
+    // Disable pid/hostname for smaller logs
+    base: undefined,
+};
+//# sourceMappingURL=pino-logger.js.map

package/dist/observability/pino-logger.js.map

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

package/dist/observability/request-context.d.ts

@@ -0,0 +1,105 @@
+import { AsyncLocalStorage } from 'node:async_hooks';
+import type { MiddlewareHandler } from 'hono';
+/**
+ * Request context stored in AsyncLocalStorage.
+ * Available anywhere in your code during a request lifecycle.
+ */
+export interface RequestContext {
+    /** Unique request identifier for correlation */
+    requestId: string;
+    /** HTTP method */
+    method: string;
+    /** Request path */
+    path: string;
+    /** Optional user ID (set via setUser) */
+    userId?: string;
+    /** Custom context data */
+    custom: Record<string, unknown>;
+}
+/**
+ * AsyncLocalStorage instance for request context.
+ * @internal
+ */
+export declare const requestContextStorage: AsyncLocalStorage<RequestContext>;
+/**
+ * Get the current request context.
+ * Returns undefined if called outside a request lifecycle.
+ *
+ * @returns Current request context or undefined
+ *
+ * @example
+ * ```typescript
+ * import { getRequestContext } from 'glasswork';
+ *
+ * function someUtility() {
+ *   const ctx = getRequestContext();
+ *   if (ctx) {
+ *     console.log('Request ID:', ctx.requestId);
+ *   }
+ * }
+ * ```
+ */
+export declare function getRequestContext(): RequestContext | undefined;
+/**
+ * Get the current request ID.
+ * Returns undefined if called outside a request lifecycle.
+ *
+ * This is a convenience function for the common case of just needing the request ID.
+ *
+ * @returns Current request ID or undefined
+ *
+ * @example
+ * ```typescript
+ * import { getRequestId } from 'glasswork';
+ *
+ * class UserService {
+ *   async create(data: CreateUserDto) {
+ *     const requestId = getRequestId();
+ *     this.logger.info({ requestId, email: data.email }, 'Creating user');
+ *     // ...
+ *   }
+ * }
+ * ```
+ */
+export declare function getRequestId(): string | undefined;
+/**
+ * Set user information in the current request context.
+ * Useful for correlating logs and errors with users after authentication.
+ *
+ * @param userId - User identifier
+ *
+ * @example
+ * ```typescript
+ * import { setRequestUser } from 'glasswork';
+ *
+ * // In auth middleware
+ * const user = await validateToken(token);
+ * setRequestUser(user.id);
+ * ```
+ */
+export declare function setRequestUser(userId: string): void;
+/**
+ * Set custom context data for the current request.
+ * Useful for adding business-specific context to logs.
+ *
+ * @param key - Context key
+ * @param value - Context value
+ *
+ * @example
+ * ```typescript
+ * import { setRequestContext } from 'glasswork';
+ *
+ * // Add tenant ID for multi-tenant apps
+ * setRequestContext('tenantId', tenant.id);
+ * ```
+ */
+export declare function setRequestContextValue(key: string, value: unknown): void;
+/**
+ * Middleware that initializes AsyncLocalStorage request context.
+ * Applied automatically by bootstrap when using the built-in logger.
+ *
+ * @returns Hono middleware handler
+ * @internal
+ */
+export declare function createRequestContextMiddleware(): MiddlewareHandler;
+//# sourceMappingURL=request-context.d.ts.map

package/dist/observability/request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-context.d.ts","sourceRoot":"","sources":["../../src/observability/request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,MAAM,CAAC;AAE9C;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,mCAA0C,CAAC;AAE7E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,GAAG,SAAS,CAE9D;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,YAAY,IAAI,MAAM,GAAG,SAAS,CAEjD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAKnD;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAKxE;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,IAAI,iBAAiB,CAelE"}