@md-oss/observability 0.1.0

package/LICENSE

@@ -0,0 +1,5 @@
+Copyright 2026 Mirasaki Development
+
+Permission to use, copy, modify, and/or distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED “AS IS” AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,308 @@
+# @md-oss/observability
+
+Structured logging with Winston for production-ready observability.
+
+## Features
+
+- **Structured Logging** - JSON-formatted logs with Winston
+- **Multiple Transports** - Console and file-based logging with automatic rotation
+- **Exception Handling** - Automatic logging of unhandled exceptions and rejections
+- **Child Loggers** - Create contextual loggers with custom metadata
+- **Configurable Levels** - Support for all Winston log levels (error, warn, info, verbose, debug, silly)
+- **Log Rotation** - Automatic file rotation with configurable size limits
+
+## Installation
+
+```bash
+pnpm add @md-oss/observability
+```
+
+## Usage
+
+### Basic Logging
+
+```typescript
+import { logger } from '@md-oss/observability';
+
+// Log at different levels
+logger.error('Critical error occurred', { userId: 123 });
+logger.warn('Warning message', { action: 'deprecated' });
+logger.info('User logged in', { userId: 456 });
+logger.verbose('Detailed information');
+logger.debug('Debug information');
+logger.silly('Very detailed debug info');
+
+// Log errors with stack traces
+try {
+  throw new Error('Something went wrong');
+} catch (error) {
+  logger.error('Operation failed', { error });
+}
+```
+
+### Child Loggers
+
+Create contextual loggers with custom metadata:
+
+```typescript
+import { createChildLogger } from '@md-oss/observability';
+
+// Create a logger for a specific service
+const userServiceLogger = createChildLogger({
+  service: 'user-service',
+  component: 'authentication'
+});
+
+userServiceLogger.info('User authenticated', { userId: 123 });
+// Logs: { service: 'user-service', component: 'authentication', message: 'User authenticated', userId: 123 }
+
+// Create a logger for a specific request
+const requestLogger = createChildLogger({
+  requestId: 'req-abc-123',
+  userId: 456
+});
+
+requestLogger.info('Processing request');
+requestLogger.error('Request failed');
+// All logs include requestId and userId
+```
+
+## Configuration
+
+Set environment variables to configure logging behavior:
+
+### Environment Variables
+
+```bash
+# Required
+NODE_ENV=development          # or 'production', 'test'
+
+# Optional
+LOG_LEVEL=info               # error | warn | info | verbose | debug | silly
+LOG_DIR=./logs               # Directory for log files (relative to cwd)
+LOG_TO_CONSOLE=true          # Enable/disable console logging
+```
+
+### Log Files
+
+When `LOG_DIR` is set, the following files are created:
+
+- **`combined.log`** - All logs (max 10MB per file, keeps last 7 files)
+- **`errors.log`** - Error level logs only (max 10MB per file, keeps last 3 files)
+- **`exceptions.log`** - Unhandled exceptions
+- **`rejections.log`** - Unhandled promise rejections
+
+### Example Configuration
+
+```env
+# .env.development
+NODE_ENV=development
+LOG_LEVEL=debug
+LOG_TO_CONSOLE=true
+LOG_DIR=./logs
+
+# .env.production
+NODE_ENV=production
+LOG_LEVEL=info
+LOG_TO_CONSOLE=false
+LOG_DIR=/var/log/app
+```
+
+## Log Format
+
+### Console Output (Development)
+
+```
+2026-01-27 10:30:45 info: User logged in userId=123
+2026-01-27 10:30:46 error: Operation failed error=[Error: Something went wrong]
+```
+
+### File Output (JSON)
+
+```json
+{
+  "level": "info",
+  "message": "User logged in",
+  "timestamp": "2026-01-27 10:30:45",
+  "service": "my-app",
+  "version": "1.0.0",
+  "userId": 123
+}
+```
+
+## Advanced Usage
+
+### Custom Transports
+
+Access the transports array to add custom Winston transports:
+
+```typescript
+import { transports, logger } from '@md-oss/observability';
+import winston from 'winston';
+
+// Add a custom transport
+transports.push(
+  new winston.transports.Http({
+    host: 'log-server.example.com',
+    port: 8080
+  })
+);
+```
+
+### Log Level Access
+
+```typescript
+import { logLevel } from '@md-oss/observability';
+
+console.log('Current log level:', logLevel); // 'info'
+
+// Conditionally log based on level
+if (logLevel === 'debug' || logLevel === 'silly') {
+  logger.debug('Detailed debug information');
+}
+```
+
+### Metadata and Formatting
+
+```typescript
+import { logger } from '@md-oss/observability';
+
+// Log with structured metadata
+logger.info('User action', {
+  action: 'login',
+  userId: 123,
+  ip: '192.168.1.1',
+  timestamp: Date.now()
+});
+
+// String interpolation with metadata
+logger.info('User %s performed %s', 'John', 'login', {
+  userId: 123
+});
+```
+
+## Exception Handling
+
+Unhandled exceptions and promise rejections are automatically logged:
+
+```typescript
+// Unhandled exception - automatically logged to exceptions.log
+throw new Error('Unhandled error');
+
+// Unhandled promise rejection - automatically logged to rejections.log
+Promise.reject(new Error('Unhandled promise rejection'));
+```
+
+## Best Practices
+
+### 1. Use Appropriate Log Levels
+
+```typescript
+// Production errors
+logger.error('Payment processing failed', { orderId: 123, error });
+
+// Important events
+logger.warn('API rate limit approaching', { usage: 0.9 });
+
+// Business logic events
+logger.info('Order created', { orderId: 456, total: 99.99 });
+
+// Detailed flow information (development)
+logger.debug('Cache hit', { key: 'user:123', ttl: 300 });
+
+// Very detailed debugging (development only)
+logger.silly('Raw request data', { headers, body });
+```
+
+### 2. Include Context in Logs
+
+```typescript
+// Good - includes context
+logger.error('Database query failed', {
+  query: 'SELECT * FROM users',
+  error,
+  duration: 1500
+});
+
+// Bad - lacks context
+logger.error('Query failed');
+```
+
+### 3. Use Child Loggers for Modules
+
+```typescript
+// api/users.ts
+const userLogger = createChildLogger({ module: 'users' });
+
+export function getUser(id: number) {
+  userLogger.info('Fetching user', { userId: id });
+  // ...
+}
+
+// api/orders.ts
+const orderLogger = createChildLogger({ module: 'orders' });
+
+export function createOrder(data: Order) {
+  orderLogger.info('Creating order', { order: data });
+  // ...
+}
+```
+
+### 4. Structured Logging
+
+```typescript
+// Good - structured and searchable
+logger.info('User login', {
+  event: 'user.login',
+  userId: 123,
+  ip: req.ip,
+  userAgent: req.headers['user-agent']
+});
+
+// Bad - unstructured string
+logger.info(`User ${userId} logged in from ${ip}`);
+```
+
+## Performance Considerations
+
+- **File I/O**: File transports use buffered writes (minimal overhead)
+- **Log Rotation**: Automatic rotation prevents disk space issues
+- **Conditional Logging**: Check log level before expensive operations
+
+```typescript
+// Avoid expensive serialization if not needed
+if (logLevel === 'debug') {
+  logger.debug('Complex object', JSON.stringify(largeObject, null, 2));
+}
+```
+
+## Types
+
+```typescript
+import type { winston } from '@md-oss/observability';
+
+// winston is re-exported from the winston package
+const logger: winston.Logger = createChildLogger({ service: 'my-service' });
+```
+
+## API Reference
+
+### Logger
+
+- `logger.error(message, metadata?)` - Log error level
+- `logger.warn(message, metadata?)` - Log warning level
+- `logger.info(message, metadata?)` - Log info level
+- `logger.verbose(message, metadata?)` - Log verbose level
+- `logger.debug(message, metadata?)` - Log debug level
+- `logger.silly(message, metadata?)` - Log silly level
+
+### Functions
+
+- `createChildLogger(metadata)` - Create a contextual logger with default metadata
+
+### Exports
+
+- `logger: winston.Logger` - Main logger instance
+- `logLevel: string` - Current log level
+- `transports: winston.transport[]` - Array of active transports
+- `winston: typeof winston` - Winston type exports

package/dist/env.cjs

@@ -0,0 +1,2 @@
+"use strict";var o=Object.defineProperty;var n=(r,O)=>o(r,"name",{value:O,configurable:!0});var t=require("@t3-oss/env-nextjs"),e=require("zod/v4");const L=n(()=>t.createEnv({server:{NODE_ENV:e.z.enum(["development","production","test"]).default("development"),LOG_LEVEL:e.z.enum(["error","warn","info","verbose","debug","silly"]).default("info"),LOG_DIR:e.z.string().optional(),LOG_TO_CONSOLE:e.z.boolean().default(!0)},client:{},runtimeEnv:{NODE_ENV:"production",LOG_LEVEL:process.env.LOG_LEVEL||"info",LOG_DIR:process.env.LOG_DIR,LOG_TO_CONSOLE:process.env.LOG_TO_CONSOLE!=="false"}}),"env");exports.env=L;
+//# sourceMappingURL=env.cjs.map

package/dist/env.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.cjs","sources":["../src/env.ts"],"sourcesContent":["import { createEnv } from '@t3-oss/env-nextjs';\nimport { z } from 'zod/v4';\n\nexport const env = (): Readonly<{\n\tLOG_DIR?: string | undefined;\n\tNODE_ENV: 'development' | 'production' | 'test';\n\tLOG_LEVEL: 'error' | 'warn' | 'info' | 'verbose' | 'debug' | 'silly';\n\tLOG_TO_CONSOLE: boolean;\n}> =>\n\tcreateEnv({\n\t\tserver: {\n\t\t\tNODE_ENV: z\n\t\t\t\t.enum(['development', 'production', 'test'])\n\t\t\t\t.default('development'),\n\t\t\tLOG_LEVEL: z\n\t\t\t\t.enum(['error', 'warn', 'info', 'verbose', 'debug', 'silly'])\n\t\t\t\t.default('info'),\n\t\t\tLOG_DIR: z.string().optional(),\n\t\t\tLOG_TO_CONSOLE: z.boolean().default(true),\n\t\t},\n\t\tclient: {},\n\t\truntimeEnv: {\n\t\t\tNODE_ENV: process.env.NODE_ENV || 'development',\n\t\t\tLOG_LEVEL: process.env.LOG_LEVEL || 'info',\n\t\t\tLOG_DIR: process.env.LOG_DIR,\n\t\t\tLOG_TO_CONSOLE: process.env.LOG_TO_CONSOLE !== 'false',\n\t\t},\n\t});\n"],"names":["env","__name","createEnv","z"],"mappings":"oJAGO,MAAMA,EAAMC,EAAA,IAMlBC,EAAAA,UAAU,CACT,OAAQ,CACP,SAAUC,EAAAA,EACR,KAAK,CAAC,cAAe,aAAc,MAAM,CAAC,EAC1C,QAAQ,aAAa,EACvB,UAAWA,EAAAA,EACT,KAAK,CAAC,QAAS,OAAQ,OAAQ,UAAW,QAAS,OAAO,CAAC,EAC3D,QAAQ,MAAM,EAChB,QAASA,EAAAA,EAAE,OAAA,EAAS,SAAA,EACpB,eAAgBA,EAAAA,EAAE,QAAA,EAAU,QAAQ,EAAI,CAAA,EAEzC,OAAQ,CAAA,EACR,WAAY,CACX,SAAU,aACV,UAAW,QAAQ,IAAI,WAAa,OACpC,QAAS,QAAQ,IAAI,QACrB,eAAgB,QAAQ,IAAI,iBAAmB,OAAA,CAEjD,CAAC,EAxBiB"}

package/dist/env.d.cts

@@ -0,0 +1,8 @@
+declare const env: () => Readonly<{
+    LOG_DIR?: string | undefined;
+    NODE_ENV: "development" | "production" | "test";
+    LOG_LEVEL: "error" | "warn" | "info" | "verbose" | "debug" | "silly";
+    LOG_TO_CONSOLE: boolean;
+}>;
+
+export { env };

package/dist/env.d.mts

@@ -0,0 +1,8 @@
+declare const env: () => Readonly<{
+    LOG_DIR?: string | undefined;
+    NODE_ENV: "development" | "production" | "test";
+    LOG_LEVEL: "error" | "warn" | "info" | "verbose" | "debug" | "silly";
+    LOG_TO_CONSOLE: boolean;
+}>;
+
+export { env };

package/dist/env.mjs

@@ -0,0 +1,2 @@
+var O=Object.defineProperty;var o=(n,r)=>O(n,"name",{value:r,configurable:!0});import{createEnv as t}from"@t3-oss/env-nextjs";import{z as e}from"zod/v4";const L=o(()=>t({server:{NODE_ENV:e.enum(["development","production","test"]).default("development"),LOG_LEVEL:e.enum(["error","warn","info","verbose","debug","silly"]).default("info"),LOG_DIR:e.string().optional(),LOG_TO_CONSOLE:e.boolean().default(!0)},client:{},runtimeEnv:{NODE_ENV:"production",LOG_LEVEL:process.env.LOG_LEVEL||"info",LOG_DIR:process.env.LOG_DIR,LOG_TO_CONSOLE:process.env.LOG_TO_CONSOLE!=="false"}}),"env");export{L as env};
+//# sourceMappingURL=env.mjs.map

package/dist/env.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.mjs","sources":["../src/env.ts"],"sourcesContent":["import { createEnv } from '@t3-oss/env-nextjs';\nimport { z } from 'zod/v4';\n\nexport const env = (): Readonly<{\n\tLOG_DIR?: string | undefined;\n\tNODE_ENV: 'development' | 'production' | 'test';\n\tLOG_LEVEL: 'error' | 'warn' | 'info' | 'verbose' | 'debug' | 'silly';\n\tLOG_TO_CONSOLE: boolean;\n}> =>\n\tcreateEnv({\n\t\tserver: {\n\t\t\tNODE_ENV: z\n\t\t\t\t.enum(['development', 'production', 'test'])\n\t\t\t\t.default('development'),\n\t\t\tLOG_LEVEL: z\n\t\t\t\t.enum(['error', 'warn', 'info', 'verbose', 'debug', 'silly'])\n\t\t\t\t.default('info'),\n\t\t\tLOG_DIR: z.string().optional(),\n\t\t\tLOG_TO_CONSOLE: z.boolean().default(true),\n\t\t},\n\t\tclient: {},\n\t\truntimeEnv: {\n\t\t\tNODE_ENV: process.env.NODE_ENV || 'development',\n\t\t\tLOG_LEVEL: process.env.LOG_LEVEL || 'info',\n\t\t\tLOG_DIR: process.env.LOG_DIR,\n\t\t\tLOG_TO_CONSOLE: process.env.LOG_TO_CONSOLE !== 'false',\n\t\t},\n\t});\n"],"names":["env","__name","createEnv","z"],"mappings":"yJAGO,MAAMA,EAAMC,EAAA,IAMlBC,EAAU,CACT,OAAQ,CACP,SAAUC,EACR,KAAK,CAAC,cAAe,aAAc,MAAM,CAAC,EAC1C,QAAQ,aAAa,EACvB,UAAWA,EACT,KAAK,CAAC,QAAS,OAAQ,OAAQ,UAAW,QAAS,OAAO,CAAC,EAC3D,QAAQ,MAAM,EAChB,QAASA,EAAE,OAAA,EAAS,SAAA,EACpB,eAAgBA,EAAE,QAAA,EAAU,QAAQ,EAAI,CAAA,EAEzC,OAAQ,CAAA,EACR,WAAY,CACX,SAAU,aACV,UAAW,QAAQ,IAAI,WAAa,OACpC,QAAS,QAAQ,IAAI,QACrB,eAAgB,QAAQ,IAAI,iBAAmB,OAAA,CAEjD,CAAC,EAxBiB"}

package/dist/index.cjs

@@ -0,0 +1,2 @@
+"use strict";var f=Object.defineProperty;var t=(e,u)=>f(e,"name",{value:u,configurable:!0});var o=require("node:path"),r=require("winston"),d=require("./env.cjs");require("@t3-oss/env-nextjs"),require("zod/v4");const{LOG_DIR:n,LOG_LEVEL:L,LOG_TO_CONSOLE:w}=d.env(),l=10*1024*1024,{combine:c,timestamp:m,json:Y,errors:p,splat:g,colorize:_,simple:j}=r.format,s=[],a=L||"info",i=t(()=>new r.transports.Console({format:c(_(),m({format:"YYYY-MM-DD HH:mm:ss"}),p({stack:!0}),g(),j()),level:a}),"consoleTransport");if(n){const e=o.join(process.cwd(),n);s.push(new r.transports.File({filename:o.join(e,"errors.log"),level:"error",maxsize:l,maxFiles:3,dirname:e}),new r.transports.File({filename:o.join(e,"combined.log"),maxsize:l,maxFiles:7,dirname:e}))}w&&s.push(i());const v=r.createLogger({level:a,format:c(m({format:"YYYY-MM-DD HH:mm:ss"}),p({stack:!0}),g(),Y()),transports:s,defaultMeta:{service:process.env.npm_package_name||"unknown",version:process.env.npm_package_version||"unknown"},exceptionHandlers:[i(),new r.transports.File({filename:o.join(n||"","exceptions.log")})],rejectionHandlers:[i(),new r.transports.File({filename:o.join(n||"","rejections.log")})]}),h=t(e=>v.child(e),"createChildLogger");exports.createChildLogger=h,exports.logLevel=a,exports.logger=v,exports.transports=s;
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.cjs","sources":["../src/index.ts"],"sourcesContent":["import path from 'node:path';\nimport winston from 'winston';\nimport { env } from './env';\n\nconst { LOG_DIR, LOG_LEVEL, LOG_TO_CONSOLE } = env();\n\nconst TEN_MEGABYTES = 10 * 1024 * 1024;\nconst { combine, timestamp, json, errors, splat, colorize, simple } =\n\twinston.format;\n\nconst transports: winston.transport[] = [];\nconst logLevel: 'error' | 'warn' | 'info' | 'verbose' | 'debug' | 'silly' =\n\tLOG_LEVEL || 'info';\n\nconst consoleTransport = () =>\n\tnew winston.transports.Console({\n\t\tformat: combine(\n\t\t\tcolorize(),\n\t\t\ttimestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),\n\t\t\terrors({ stack: true }),\n\t\t\tsplat(),\n\t\t\tsimple()\n\t\t),\n\t\tlevel: logLevel,\n\t});\n\nif (LOG_DIR) {\n\tconst resolvedPath = path.join(process.cwd(), LOG_DIR);\n\ttransports.push(\n\t\tnew winston.transports.File({\n\t\t\tfilename: path.join(resolvedPath, 'errors.log'),\n\t\t\tlevel: 'error',\n\t\t\tmaxsize: TEN_MEGABYTES,\n\t\t\tmaxFiles: 3,\n\t\t\tdirname: resolvedPath,\n\t\t}),\n\t\tnew winston.transports.File({\n\t\t\tfilename: path.join(resolvedPath, 'combined.log'),\n\t\t\tmaxsize: TEN_MEGABYTES,\n\t\t\tmaxFiles: 7,\n\t\t\tdirname: resolvedPath,\n\t\t})\n\t);\n}\n\nif (LOG_TO_CONSOLE) {\n\ttransports.push(consoleTransport());\n}\n\nconst logger: winston.Logger = winston.createLogger({\n\tlevel: logLevel,\n\tformat: combine(\n\t\ttimestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),\n\t\terrors({ stack: true }),\n\t\tsplat(),\n\t\tjson()\n\t),\n\ttransports,\n\tdefaultMeta: {\n\t\tservice: process.env.npm_package_name || 'unknown',\n\t\tversion: process.env.npm_package_version || 'unknown',\n\t},\n\texceptionHandlers: [\n\t\tconsoleTransport(),\n\t\tnew winston.transports.File({\n\t\t\tfilename: path.join(LOG_DIR || '', 'exceptions.log'),\n\t\t}),\n\t],\n\trejectionHandlers: [\n\t\tconsoleTransport(),\n\t\tnew winston.transports.File({\n\t\t\tfilename: path.join(LOG_DIR || '', 'rejections.log'),\n\t\t}),\n\t],\n});\n\nconst createChildLogger = (meta: Record<string, unknown>): winston.Logger => {\n\treturn logger.child(meta);\n};\n\nexport { logger, logLevel, type winston, transports, createChildLogger };\n"],"names":["LOG_DIR","LOG_LEVEL","LOG_TO_CONSOLE","env","TEN_MEGABYTES","combine","timestamp","json","errors","splat","colorize","simple","winston","transports","logLevel","consoleTransport","__name","resolvedPath","path","logger","createChildLogger","meta"],"mappings":"mNAIA,KAAM,CAAE,QAAAA,EAAS,UAAAC,EAAW,eAAAC,CAAA,EAAmBC,EAAAA,IAAA,EAEzCC,EAAgB,GAAK,KAAO,KAC5B,CAAE,QAAAC,EAAS,UAAAC,EAAW,KAAAC,EAAM,OAAAC,EAAQ,MAAAC,EAAO,SAAAC,EAAU,OAAAC,GAC1DC,EAAQ,OAEHC,EAAkC,CAAA,EAClCC,EACLb,GAAa,OAERc,EAAmBC,EAAA,IACxB,IAAIJ,EAAQ,WAAW,QAAQ,CAC9B,OAAQP,EACPK,EAAA,EACAJ,EAAU,CAAE,OAAQ,sBAAuB,EAC3CE,EAAO,CAAE,MAAO,GAAM,EACtBC,EAAA,EACAE,EAAA,CAAO,EAER,MAAOG,CACR,CAAC,EAVuB,oBAYzB,GAAId,EAAS,CACZ,MAAMiB,EAAeC,EAAK,KAAK,QAAQ,IAAA,EAAOlB,CAAO,EACrDa,EAAW,KACV,IAAID,EAAQ,WAAW,KAAK,CAC3B,SAAUM,EAAK,KAAKD,EAAc,YAAY,EAC9C,MAAO,QACP,QAASb,EACT,SAAU,EACV,QAASa,CAAA,CACT,EACD,IAAIL,EAAQ,WAAW,KAAK,CAC3B,SAAUM,EAAK,KAAKD,EAAc,cAAc,EAChD,QAASb,EACT,SAAU,EACV,QAASa,CAAA,CACT,CAAA,CAEH,CAEIf,GACHW,EAAW,KAAKE,GAAkB,EAGnC,MAAMI,EAAyBP,EAAQ,aAAa,CACnD,MAAOE,EACP,OAAQT,EACPC,EAAU,CAAE,OAAQ,sBAAuB,EAC3CE,EAAO,CAAE,MAAO,GAAM,EACtBC,EAAA,EACAF,EAAA,CAAK,EAEN,WAAAM,EACA,YAAa,CACZ,QAAS,QAAQ,IAAI,kBAAoB,UACzC,QAAS,QAAQ,IAAI,qBAAuB,SAAA,EAE7C,kBAAmB,CAClBE,EAAA,EACA,IAAIH,EAAQ,WAAW,KAAK,CAC3B,SAAUM,EAAK,KAAKlB,GAAW,GAAI,gBAAgB,CAAA,CACnD,CAAA,EAEF,kBAAmB,CAClBe,EAAA,EACA,IAAIH,EAAQ,WAAW,KAAK,CAC3B,SAAUM,EAAK,KAAKlB,GAAW,GAAI,gBAAgB,CAAA,CACnD,CAAA,CAEH,CAAC,EAEKoB,EAAoBJ,EAACK,GACnBF,EAAO,MAAME,CAAI,EADC"}

package/dist/index.d.cts

@@ -0,0 +1,9 @@
+import winston from 'winston';
+export { default as winston } from 'winston';
+
+declare const transports: winston.transport[];
+declare const logLevel: 'error' | 'warn' | 'info' | 'verbose' | 'debug' | 'silly';
+declare const logger: winston.Logger;
+declare const createChildLogger: (meta: Record<string, unknown>) => winston.Logger;
+
+export { createChildLogger, logLevel, logger, transports };

package/dist/index.d.mts

@@ -0,0 +1,9 @@
+import winston from 'winston';
+export { default as winston } from 'winston';
+
+declare const transports: winston.transport[];
+declare const logLevel: 'error' | 'warn' | 'info' | 'verbose' | 'debug' | 'silly';
+declare const logger: winston.Logger;
+declare const createChildLogger: (meta: Record<string, unknown>) => winston.Logger;
+
+export { createChildLogger, logLevel, logger, transports };

package/dist/index.mjs

@@ -0,0 +1,2 @@
+var d=Object.defineProperty;var t=(e,v)=>d(e,"name",{value:v,configurable:!0});import n from"node:path";import o from"winston";import{env as w}from"./env.mjs";import"@t3-oss/env-nextjs";import"zod/v4";const{LOG_DIR:r,LOG_LEVEL:L,LOG_TO_CONSOLE:Y}=w(),m=10*1024*1024,{combine:l,timestamp:c,json:_,errors:p,splat:f,colorize:j,simple:u}=o.format,s=[],i=L||"info",a=t(()=>new o.transports.Console({format:l(j(),c({format:"YYYY-MM-DD HH:mm:ss"}),p({stack:!0}),f(),u()),level:i}),"consoleTransport");if(r){const e=n.join(process.cwd(),r);s.push(new o.transports.File({filename:n.join(e,"errors.log"),level:"error",maxsize:m,maxFiles:3,dirname:e}),new o.transports.File({filename:n.join(e,"combined.log"),maxsize:m,maxFiles:7,dirname:e}))}Y&&s.push(a());const g=o.createLogger({level:i,format:l(c({format:"YYYY-MM-DD HH:mm:ss"}),p({stack:!0}),f(),_()),transports:s,defaultMeta:{service:process.env.npm_package_name||"unknown",version:process.env.npm_package_version||"unknown"},exceptionHandlers:[a(),new o.transports.File({filename:n.join(r||"","exceptions.log")})],rejectionHandlers:[a(),new o.transports.File({filename:n.join(r||"","rejections.log")})]}),x=t(e=>g.child(e),"createChildLogger");export{x as createChildLogger,i as logLevel,g as logger,s as transports};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../src/index.ts"],"sourcesContent":["import path from 'node:path';\nimport winston from 'winston';\nimport { env } from './env';\n\nconst { LOG_DIR, LOG_LEVEL, LOG_TO_CONSOLE } = env();\n\nconst TEN_MEGABYTES = 10 * 1024 * 1024;\nconst { combine, timestamp, json, errors, splat, colorize, simple } =\n\twinston.format;\n\nconst transports: winston.transport[] = [];\nconst logLevel: 'error' | 'warn' | 'info' | 'verbose' | 'debug' | 'silly' =\n\tLOG_LEVEL || 'info';\n\nconst consoleTransport = () =>\n\tnew winston.transports.Console({\n\t\tformat: combine(\n\t\t\tcolorize(),\n\t\t\ttimestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),\n\t\t\terrors({ stack: true }),\n\t\t\tsplat(),\n\t\t\tsimple()\n\t\t),\n\t\tlevel: logLevel,\n\t});\n\nif (LOG_DIR) {\n\tconst resolvedPath = path.join(process.cwd(), LOG_DIR);\n\ttransports.push(\n\t\tnew winston.transports.File({\n\t\t\tfilename: path.join(resolvedPath, 'errors.log'),\n\t\t\tlevel: 'error',\n\t\t\tmaxsize: TEN_MEGABYTES,\n\t\t\tmaxFiles: 3,\n\t\t\tdirname: resolvedPath,\n\t\t}),\n\t\tnew winston.transports.File({\n\t\t\tfilename: path.join(resolvedPath, 'combined.log'),\n\t\t\tmaxsize: TEN_MEGABYTES,\n\t\t\tmaxFiles: 7,\n\t\t\tdirname: resolvedPath,\n\t\t})\n\t);\n}\n\nif (LOG_TO_CONSOLE) {\n\ttransports.push(consoleTransport());\n}\n\nconst logger: winston.Logger = winston.createLogger({\n\tlevel: logLevel,\n\tformat: combine(\n\t\ttimestamp({ format: 'YYYY-MM-DD HH:mm:ss' }),\n\t\terrors({ stack: true }),\n\t\tsplat(),\n\t\tjson()\n\t),\n\ttransports,\n\tdefaultMeta: {\n\t\tservice: process.env.npm_package_name || 'unknown',\n\t\tversion: process.env.npm_package_version || 'unknown',\n\t},\n\texceptionHandlers: [\n\t\tconsoleTransport(),\n\t\tnew winston.transports.File({\n\t\t\tfilename: path.join(LOG_DIR || '', 'exceptions.log'),\n\t\t}),\n\t],\n\trejectionHandlers: [\n\t\tconsoleTransport(),\n\t\tnew winston.transports.File({\n\t\t\tfilename: path.join(LOG_DIR || '', 'rejections.log'),\n\t\t}),\n\t],\n});\n\nconst createChildLogger = (meta: Record<string, unknown>): winston.Logger => {\n\treturn logger.child(meta);\n};\n\nexport { logger, logLevel, type winston, transports, createChildLogger };\n"],"names":["LOG_DIR","LOG_LEVEL","LOG_TO_CONSOLE","env","TEN_MEGABYTES","combine","timestamp","json","errors","splat","colorize","simple","winston","transports","logLevel","consoleTransport","__name","resolvedPath","path","logger","createChildLogger","meta"],"mappings":"yMAIA,KAAM,CAAE,QAAAA,EAAS,UAAAC,EAAW,eAAAC,CAAA,EAAmBC,EAAA,EAEzCC,EAAgB,GAAK,KAAO,KAC5B,CAAE,QAAAC,EAAS,UAAAC,EAAW,KAAAC,EAAM,OAAAC,EAAQ,MAAAC,EAAO,SAAAC,EAAU,OAAAC,GAC1DC,EAAQ,OAEHC,EAAkC,CAAA,EAClCC,EACLb,GAAa,OAERc,EAAmBC,EAAA,IACxB,IAAIJ,EAAQ,WAAW,QAAQ,CAC9B,OAAQP,EACPK,EAAA,EACAJ,EAAU,CAAE,OAAQ,sBAAuB,EAC3CE,EAAO,CAAE,MAAO,GAAM,EACtBC,EAAA,EACAE,EAAA,CAAO,EAER,MAAOG,CACR,CAAC,EAVuB,oBAYzB,GAAId,EAAS,CACZ,MAAMiB,EAAeC,EAAK,KAAK,QAAQ,IAAA,EAAOlB,CAAO,EACrDa,EAAW,KACV,IAAID,EAAQ,WAAW,KAAK,CAC3B,SAAUM,EAAK,KAAKD,EAAc,YAAY,EAC9C,MAAO,QACP,QAASb,EACT,SAAU,EACV,QAASa,CAAA,CACT,EACD,IAAIL,EAAQ,WAAW,KAAK,CAC3B,SAAUM,EAAK,KAAKD,EAAc,cAAc,EAChD,QAASb,EACT,SAAU,EACV,QAASa,CAAA,CACT,CAAA,CAEH,CAEIf,GACHW,EAAW,KAAKE,GAAkB,EAGnC,MAAMI,EAAyBP,EAAQ,aAAa,CACnD,MAAOE,EACP,OAAQT,EACPC,EAAU,CAAE,OAAQ,sBAAuB,EAC3CE,EAAO,CAAE,MAAO,GAAM,EACtBC,EAAA,EACAF,EAAA,CAAK,EAEN,WAAAM,EACA,YAAa,CACZ,QAAS,QAAQ,IAAI,kBAAoB,UACzC,QAAS,QAAQ,IAAI,qBAAuB,SAAA,EAE7C,kBAAmB,CAClBE,EAAA,EACA,IAAIH,EAAQ,WAAW,KAAK,CAC3B,SAAUM,EAAK,KAAKlB,GAAW,GAAI,gBAAgB,CAAA,CACnD,CAAA,EAEF,kBAAmB,CAClBe,EAAA,EACA,IAAIH,EAAQ,WAAW,KAAK,CAC3B,SAAUM,EAAK,KAAKlB,GAAW,GAAI,gBAAgB,CAAA,CACnD,CAAA,CAEH,CAAC,EAEKoB,EAAoBJ,EAACK,GACnBF,EAAO,MAAME,CAAI,EADC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@md-oss/observability",
+  "version": "0.1.0",
+  "private": false,
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/Mirasaki-OSS/monorepo-template.git",
+    "directory": "vendor/observability"
+  },
+  "type": "module",
+  "description": "Structured logging with Winston",
+  "license": "ISC",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.cts",
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      },
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      }
+    },
+    "./env": {
+      "require": {
+        "types": "./dist/env.d.cts",
+        "default": "./dist/env.cjs"
+      },
+      "import": {
+        "types": "./dist/env.d.mts",
+        "default": "./dist/env.mjs"
+      }
+    }
+  },
+  "dependencies": {
+    "@t3-oss/env-nextjs": "^0.13.10",
+    "winston": "^3.19.0",
+    "zod": "^4.3.6",
+    "@md-oss/config": "^0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.0.9",
+    "pkgroll": "^2.21.5",
+    "typescript": "^5.9.3"
+  },
+  "scripts": {
+    "build": "pkgroll --minify --clean-dist --sourcemap  --define.process.env.NODE_ENV='\"production\"' --define.DEBUG=false",
+    "clean": "git clean -xdf .turbo dist node_modules tsconfig.tsbuildinfo",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}