@clicoh/logging 1.0.0

package/README.md

@@ -0,0 +1,53 @@
+# @clicoh/logging
+
+Structured JSON logging for ClicOH Node.js and Express services.
+
+## Install
+
+```bash
+bun add @clicoh/logging
+```
+
+The package is public on npmjs.com, so consumers do not need a registry token.
+
+## Usage
+
+```ts
+import logger, {
+  logErrorMiddleware,
+  logTimeStartMiddleware,
+  printGeneralLog,
+  requestLogMiddleware,
+} from '@clicoh/logging';
+
+printGeneralLog(
+  { message: 'Shipment created' },
+  'shipmentCreated',
+  logger,
+);
+```
+
+Optional middleware exports:
+
+```ts
+import { auditMiddleware, memoryMiddleware } from '@clicoh/logging';
+```
+
+## Configuration
+
+- `SERVICE_NAME`: stable service name used in Loki.
+- `ENVIRONMENT` or `NODE_ENV`: deployment environment.
+- `LOG_LEVEL`: `error`, `warn`, `info`, or `debug`.
+- `LOG_HTTP_FULL`: includes sanitized request bodies and headers in audit logs.
+- `LOG_MEMORY_USAGE`: enables memory-delta logs.
+- `MAX_LOG_STRING_LENGTH`: maximum length for individual strings.
+- `MAX_LOG_EVENT_LENGTH`: maximum UTF-8 byte size for a complete JSON line.
+- `AWS_REGION`: optional region metadata.
+
+Errors are written to stderr. Other enabled levels are written to stdout.
+
+## Releases
+
+The first public version is published manually with npm 2FA. Subsequent semver
+tags publish through `.github/workflows/publish.yml` using npm trusted
+publishing (OIDC), without long-lived registry tokens.

package/dist/audit.d.ts

@@ -0,0 +1,4 @@
+declare const auditMiddleware: import("express-serve-static-core").Router;
+export { auditMiddleware };
+export default auditMiddleware;
+//# sourceMappingURL=audit.d.ts.map

package/dist/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":"AAMA,QAAA,MAAM,eAAe,4CAAmB,CAAC;AAmEzC,OAAO,EAAE,eAAe,EAAE,CAAC;AAC3B,eAAe,eAAe,CAAC"}

package/dist/audit.js

@@ -0,0 +1,59 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.auditMiddleware = void 0;
+const express_1 = __importDefault(require("express"));
+const log_data_1 = require("./log-data");
+const logger_1 = require("./logger");
+const logging_1 = __importDefault(require("./logging"));
+const auditMiddleware = express_1.default.Router();
+exports.auditMiddleware = auditMiddleware;
+auditMiddleware.use(async (req, _res, next) => {
+    try {
+        if (!req.body)
+            req.body = {};
+        const { body, params, method, headers } = req;
+        let { admin, admin_id, adminId } = body;
+        let { messenger, messengerId, messenger_id, idMessenger } = body;
+        let { user, userId, user_id, idUser } = body;
+        let adminOid = null;
+        let userOid = null;
+        let messengerOid = null;
+        if (user == null && userId == null && user_id == null && idUser == null) {
+            ({ user, userId, user_id, idUser } = params);
+        }
+        userOid = user ?? userId ?? user_id ?? idUser ?? null;
+        if (messenger == null &&
+            messengerId == null &&
+            messenger_id == null &&
+            idMessenger == null) {
+            ({ messenger, messengerId, messenger_id, idMessenger } = params);
+        }
+        messengerOid =
+            messenger ?? messengerId ?? messenger_id ?? idMessenger ?? null;
+        if (admin == null && admin_id == null && adminId == null) {
+            ({ admin, admin_id, adminId } = params);
+        }
+        adminOid = admin ?? admin_id ?? adminId ?? null;
+        if (process.env.NODE_ENV !== 'local') {
+            const logHttpFull = process.env.LOG_HTTP_FULL === 'true';
+            (0, logger_1.printGeneralLog)({
+                method: method || null,
+                admin: adminOid ? String(adminOid) : null,
+                messenger: messengerOid ? String(messengerOid) : null,
+                user: userOid ? String(userOid) : null,
+                action: (0, log_data_1.sanitizeRequestPath)(`${req.baseUrl}${req.path}`),
+                ...(logHttpFull ? { body, headers } : {}),
+            }, 'auditRequest', logging_1.default);
+        }
+        next();
+    }
+    catch (error) {
+        (0, logger_1.printGeneralLog)(error && typeof error === 'object' ? error : { error }, 'auditMiddlewareError', logging_1.default, true);
+        next();
+    }
+});
+exports.default = auditMiddleware;
+//# sourceMappingURL=audit.js.map

package/dist/audit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.js","sourceRoot":"","sources":["../src/audit.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAmE;AAEnE,yCAAiD;AACjD,qCAA2C;AAC3C,wDAA+B;AAE/B,MAAM,eAAe,GAAG,iBAAO,CAAC,MAAM,EAAE,CAAC;AAmEhC,0CAAe;AAjExB,eAAe,CAAC,GAAG,CACjB,KAAK,EAAE,GAAY,EAAE,IAAc,EAAE,IAAkB,EAAE,EAAE;IACzD,IAAI,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,IAAI;YAAE,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;QAC7B,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC;QAE9C,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACxC,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,IAAI,CAAC;QACjE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAE7C,IAAI,QAAQ,GAAG,IAAI,CAAC;QACpB,IAAI,OAAO,GAAG,IAAI,CAAC;QACnB,IAAI,YAAY,GAAG,IAAI,CAAC;QAExB,IAAI,IAAI,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,EAAE,CAAC;YACxE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,CAAC;QAC/C,CAAC;QACD,OAAO,GAAG,IAAI,IAAI,MAAM,IAAI,OAAO,IAAI,MAAM,IAAI,IAAI,CAAC;QAEtD,IACE,SAAS,IAAI,IAAI;YACjB,WAAW,IAAI,IAAI;YACnB,YAAY,IAAI,IAAI;YACpB,WAAW,IAAI,IAAI,EACnB,CAAC;YACD,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,CAAC;QACnE,CAAC;QACD,YAAY;YACV,SAAS,IAAI,WAAW,IAAI,YAAY,IAAI,WAAW,IAAI,IAAI,CAAC;QAElE,IAAI,KAAK,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;YACzD,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC;QAC1C,CAAC;QACD,QAAQ,GAAG,KAAK,IAAI,QAAQ,IAAI,OAAO,IAAI,IAAI,CAAC;QAEhD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACrC,MAAM,WAAW,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,KAAK,MAAM,CAAC;YAEzD,IAAA,wBAAe,EACb;gBACE,MAAM,EAAE,MAAM,IAAI,IAAI;gBACtB,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;gBACzC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI;gBACrD,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI;gBACtC,MAAM,EAAE,IAAA,8BAAmB,EAAC,GAAG,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;gBACxD,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC1C,EACD,cAAc,EACd,iBAAM,CACP,CAAC;QACJ,CAAC;QAED,IAAI,EAAE,CAAC;IACT,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,wBAAe,EACb,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EACtD,sBAAsB,EACtB,iBAAM,EACN,IAAI,CACL,CAAC;QACF,IAAI,EAAE,CAAC;IACT,CAAC;AACH,CAAC,CACF,CAAC;AAGF,kBAAe,eAAe,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import auditMiddleware from './audit';
+import { CIRCULAR_VALUE, DEFAULT_SENSITIVE_FIELDS, REDACTED_VALUE, TRUNCATED_SUFFIX, cleanLogData, getMaxEventLength, getMaxStringLength, limitLogEvent, redactSensitiveData, safeSerialize, safeStringify, sanitizeRequestPath, truncateString } from './log-data';
+import { cleanData, handlerError, hideSensitiveData, logErrorMiddleware, logTimeStartMiddleware, printGeneralLog, requestLogMiddleware } from './logger';
+import logger from './logging';
+import memoryMiddleware from './memory';
+export { CIRCULAR_VALUE, DEFAULT_SENSITIVE_FIELDS, REDACTED_VALUE, TRUNCATED_SUFFIX, auditMiddleware, cleanData, cleanLogData, getMaxEventLength, getMaxStringLength, handlerError, hideSensitiveData, limitLogEvent, logErrorMiddleware, logger, logTimeStartMiddleware, memoryMiddleware, printGeneralLog, redactSensitiveData, requestLogMiddleware, safeSerialize, safeStringify, sanitizeRequestPath, truncateString, };
+export type { CompatibleLogger } from './logger';
+export default logger;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,MAAM,SAAS,CAAC;AACtC,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,EACf,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAClB,OAAO,MAAM,MAAM,WAAW,CAAC;AAC/B,OAAO,gBAAgB,MAAM,UAAU,CAAC;AAExC,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,cAAc,EACd,gBAAgB,EAChB,eAAe,EACf,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,MAAM,EACN,sBAAsB,EACtB,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,aAAa,EACb,mBAAmB,EACnB,cAAc,GACf,CAAC;AAEF,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,eAAe,MAAM,CAAC"}

package/dist/index.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.truncateString = exports.sanitizeRequestPath = exports.safeStringify = exports.safeSerialize = exports.requestLogMiddleware = exports.redactSensitiveData = exports.printGeneralLog = exports.memoryMiddleware = exports.logTimeStartMiddleware = exports.logger = exports.logErrorMiddleware = exports.limitLogEvent = exports.hideSensitiveData = exports.handlerError = exports.getMaxStringLength = exports.getMaxEventLength = exports.cleanLogData = exports.cleanData = exports.auditMiddleware = exports.TRUNCATED_SUFFIX = exports.REDACTED_VALUE = exports.DEFAULT_SENSITIVE_FIELDS = exports.CIRCULAR_VALUE = void 0;
+const audit_1 = __importDefault(require("./audit"));
+exports.auditMiddleware = audit_1.default;
+const log_data_1 = require("./log-data");
+Object.defineProperty(exports, "CIRCULAR_VALUE", { enumerable: true, get: function () { return log_data_1.CIRCULAR_VALUE; } });
+Object.defineProperty(exports, "DEFAULT_SENSITIVE_FIELDS", { enumerable: true, get: function () { return log_data_1.DEFAULT_SENSITIVE_FIELDS; } });
+Object.defineProperty(exports, "REDACTED_VALUE", { enumerable: true, get: function () { return log_data_1.REDACTED_VALUE; } });
+Object.defineProperty(exports, "TRUNCATED_SUFFIX", { enumerable: true, get: function () { return log_data_1.TRUNCATED_SUFFIX; } });
+Object.defineProperty(exports, "cleanLogData", { enumerable: true, get: function () { return log_data_1.cleanLogData; } });
+Object.defineProperty(exports, "getMaxEventLength", { enumerable: true, get: function () { return log_data_1.getMaxEventLength; } });
+Object.defineProperty(exports, "getMaxStringLength", { enumerable: true, get: function () { return log_data_1.getMaxStringLength; } });
+Object.defineProperty(exports, "limitLogEvent", { enumerable: true, get: function () { return log_data_1.limitLogEvent; } });
+Object.defineProperty(exports, "redactSensitiveData", { enumerable: true, get: function () { return log_data_1.redactSensitiveData; } });
+Object.defineProperty(exports, "safeSerialize", { enumerable: true, get: function () { return log_data_1.safeSerialize; } });
+Object.defineProperty(exports, "safeStringify", { enumerable: true, get: function () { return log_data_1.safeStringify; } });
+Object.defineProperty(exports, "sanitizeRequestPath", { enumerable: true, get: function () { return log_data_1.sanitizeRequestPath; } });
+Object.defineProperty(exports, "truncateString", { enumerable: true, get: function () { return log_data_1.truncateString; } });
+const logger_1 = require("./logger");
+Object.defineProperty(exports, "cleanData", { enumerable: true, get: function () { return logger_1.cleanData; } });
+Object.defineProperty(exports, "handlerError", { enumerable: true, get: function () { return logger_1.handlerError; } });
+Object.defineProperty(exports, "hideSensitiveData", { enumerable: true, get: function () { return logger_1.hideSensitiveData; } });
+Object.defineProperty(exports, "logErrorMiddleware", { enumerable: true, get: function () { return logger_1.logErrorMiddleware; } });
+Object.defineProperty(exports, "logTimeStartMiddleware", { enumerable: true, get: function () { return logger_1.logTimeStartMiddleware; } });
+Object.defineProperty(exports, "printGeneralLog", { enumerable: true, get: function () { return logger_1.printGeneralLog; } });
+Object.defineProperty(exports, "requestLogMiddleware", { enumerable: true, get: function () { return logger_1.requestLogMiddleware; } });
+const logging_1 = __importDefault(require("./logging"));
+exports.logger = logging_1.default;
+const memory_1 = __importDefault(require("./memory"));
+exports.memoryMiddleware = memory_1.default;
+exports.default = logging_1.default;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,oDAAsC;AAiCpC,0BAjCK,eAAe,CAiCL;AAhCjB,yCAcoB;AAclB,+FA3BA,yBAAc,OA2BA;AACd,yGA3BA,mCAAwB,OA2BA;AACxB,+FA3BA,yBAAc,OA2BA;AACd,iGA3BA,2BAAgB,OA2BA;AAGhB,6FA7BA,uBAAY,OA6BA;AACZ,kGA7BA,4BAAiB,OA6BA;AACjB,mGA7BA,6BAAkB,OA6BA;AAGlB,8FA/BA,wBAAa,OA+BA;AAMb,oGApCA,8BAAmB,OAoCA;AAEnB,8FArCA,wBAAa,OAqCA;AACb,8FArCA,wBAAa,OAqCA;AACb,oGArCA,8BAAmB,OAqCA;AACnB,+FArCA,yBAAc,OAqCA;AAnChB,qCAQkB;AAUhB,0FAjBA,kBAAS,OAiBA;AAIT,6FApBA,qBAAY,OAoBA;AACZ,kGApBA,0BAAiB,OAoBA;AAEjB,mGArBA,2BAAkB,OAqBA;AAElB,uGAtBA,+BAAsB,OAsBA;AAEtB,gGAvBA,wBAAe,OAuBA;AAEf,qGAxBA,6BAAoB,OAwBA;AAtBtB,wDAA+B;AAiB7B,iBAjBK,iBAAM,CAiBL;AAhBR,sDAAwC;AAkBtC,2BAlBK,gBAAgB,CAkBL;AAYlB,kBAAe,iBAAM,CAAC"}

package/dist/log-data.d.ts

@@ -0,0 +1,15 @@
+declare const REDACTED_VALUE = "[REDACTED]";
+declare const CIRCULAR_VALUE = "[Circular]";
+declare const TRUNCATED_SUFFIX = "...[TRUNCATED]";
+declare const DEFAULT_SENSITIVE_FIELDS: string[];
+declare const getMaxStringLength: () => number;
+declare const getMaxEventLength: () => number;
+declare const truncateString: (value: string, maxLength?: number) => string;
+declare const safeSerialize: (value: unknown) => unknown;
+declare const redactSensitiveData: (value: unknown, hiddenFields?: string[]) => unknown;
+declare const cleanLogData: (value: unknown, hiddenFields?: string[]) => unknown;
+declare const safeStringify: (value: unknown) => string;
+declare const limitLogEvent: (value: unknown) => unknown;
+declare const sanitizeRequestPath: (path: string) => string;
+export { CIRCULAR_VALUE, DEFAULT_SENSITIVE_FIELDS, REDACTED_VALUE, TRUNCATED_SUFFIX, cleanLogData, getMaxEventLength, getMaxStringLength, limitLogEvent, redactSensitiveData, sanitizeRequestPath, safeSerialize, safeStringify, truncateString, };
+//# sourceMappingURL=log-data.d.ts.map

package/dist/log-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-data.d.ts","sourceRoot":"","sources":["../src/log-data.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,cAAc,eAAe,CAAC;AACpC,QAAA,MAAM,cAAc,eAAe,CAAC;AACpC,QAAA,MAAM,gBAAgB,mBAAmB,CAAC;AAQ1C,QAAA,MAAM,wBAAwB,UAyB7B,CAAC;AAYF,QAAA,MAAM,kBAAkB,cAOrB,CAAC;AAEJ,QAAA,MAAM,iBAAiB,cAOpB,CAAC;AAEJ,QAAA,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,kBAAgC,WAOtE,CAAC;AA2GF,QAAA,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,OAQrC,CAAC;AA0BJ,QAAA,MAAM,mBAAmB,GAAI,OAAO,OAAO,EAAE,eAAc,MAAM,EAAO,YAClB,CAAC;AAEvD,QAAA,MAAM,YAAY,GAAI,OAAO,OAAO,EAAE,eAAc,MAAM,EAAO,YACR,CAAC;AAE1D,QAAA,MAAM,aAAa,GAAI,OAAO,OAAO,WAMpC,CAAC;AAUF,QAAA,MAAM,aAAa,GAAI,OAAO,OAAO,KAAG,OA4BvC,CAAC;AAEF,QAAA,MAAM,mBAAmB,GAAI,MAAM,MAAM,WAWxC,CAAC;AAEF,OAAO,EACL,cAAc,EACd,wBAAwB,EACxB,cAAc,EACd,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,EACb,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,cAAc,GACf,CAAC"}

package/dist/log-data.js

@@ -0,0 +1,213 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.truncateString = exports.safeStringify = exports.safeSerialize = exports.sanitizeRequestPath = exports.redactSensitiveData = exports.limitLogEvent = exports.getMaxStringLength = exports.getMaxEventLength = exports.cleanLogData = exports.TRUNCATED_SUFFIX = exports.REDACTED_VALUE = exports.DEFAULT_SENSITIVE_FIELDS = exports.CIRCULAR_VALUE = void 0;
+const REDACTED_VALUE = '[REDACTED]';
+exports.REDACTED_VALUE = REDACTED_VALUE;
+const CIRCULAR_VALUE = '[Circular]';
+exports.CIRCULAR_VALUE = CIRCULAR_VALUE;
+const TRUNCATED_SUFFIX = '...[TRUNCATED]';
+exports.TRUNCATED_SUFFIX = TRUNCATED_SUFFIX;
+const DEFAULT_MAX_STRING_LENGTH = 10000;
+const DEFAULT_MAX_EVENT_LENGTH = 65536;
+const MAX_DEPTH = 12;
+const MAX_ARRAY_ITEMS = 100;
+const MAX_OBJECT_KEYS = 100;
+const MAX_NODES = 2000;
+const DEFAULT_SENSITIVE_FIELDS = [
+    'authorization',
+    'proxy-authorization',
+    'password',
+    'passwordConfirmation',
+    'passwd',
+    'pass',
+    'token',
+    'tokenPushy',
+    'accessToken',
+    'access-token',
+    'access_token',
+    'refreshToken',
+    'refresh_token',
+    'apiKey',
+    'apikey',
+    'secret',
+    'clientSecret',
+    'client_secret',
+    'cookie',
+    'set-cookie',
+    'x-api-key',
+    'private-key',
+    'session-tracker',
+    'security',
+];
+exports.DEFAULT_SENSITIVE_FIELDS = DEFAULT_SENSITIVE_FIELDS;
+const parsePositiveInteger = (value, fallback) => {
+    const parsed = Number.parseInt(value ?? '', 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+};
+const getMaxStringLength = () => Math.max(TRUNCATED_SUFFIX.length, parsePositiveInteger(process.env.MAX_LOG_STRING_LENGTH, DEFAULT_MAX_STRING_LENGTH));
+exports.getMaxStringLength = getMaxStringLength;
+const getMaxEventLength = () => Math.max(256, parsePositiveInteger(process.env.MAX_LOG_EVENT_LENGTH, DEFAULT_MAX_EVENT_LENGTH));
+exports.getMaxEventLength = getMaxEventLength;
+const truncateString = (value, maxLength = getMaxStringLength()) => {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    const availableLength = Math.max(0, maxLength - TRUNCATED_SUFFIX.length);
+    return `${value.slice(0, availableLength)}${TRUNCATED_SUFFIX}`;
+};
+exports.truncateString = truncateString;
+const serializeValue = (value, context, depth) => {
+    if (value === undefined)
+        return '[Undefined]';
+    if (value === null)
+        return null;
+    if (typeof value === 'string')
+        return truncateString(value);
+    if (typeof value === 'number' ||
+        typeof value === 'boolean' ||
+        typeof value === 'bigint') {
+        return typeof value === 'bigint' ? value.toString() : value;
+    }
+    if (typeof value === 'symbol' || typeof value === 'function') {
+        return truncateString(String(value));
+    }
+    if (depth >= MAX_DEPTH || context.nodes >= MAX_NODES) {
+        return TRUNCATED_SUFFIX;
+    }
+    if (typeof value !== 'object') {
+        return truncateString(String(value));
+    }
+    if (context.seen.has(value)) {
+        return CIRCULAR_VALUE;
+    }
+    context.seen.add(value);
+    context.nodes += 1;
+    if (value instanceof Date) {
+        const timestamp = value.getTime();
+        return Number.isNaN(timestamp) ? 'Invalid Date' : value.toISOString();
+    }
+    if (value instanceof Error) {
+        const serializedError = {
+            name: value.name,
+            message: truncateString(value.message),
+        };
+        if (value.stack) {
+            serializedError.stack = truncateString(value.stack);
+        }
+        for (const key of Object.keys(value).slice(0, MAX_OBJECT_KEYS)) {
+            try {
+                serializedError[key] = serializeValue(value[key], context, depth + 1);
+            }
+            catch {
+                serializedError[key] = '[Unserializable]';
+            }
+        }
+        return serializedError;
+    }
+    if (Buffer.isBuffer(value)) {
+        return `[Buffer length=${value.length}]`;
+    }
+    if (Array.isArray(value)) {
+        const serializedArray = value
+            .slice(0, MAX_ARRAY_ITEMS)
+            .map((item) => serializeValue(item, context, depth + 1));
+        if (value.length > MAX_ARRAY_ITEMS) {
+            serializedArray.push(TRUNCATED_SUFFIX);
+        }
+        return serializedArray;
+    }
+    const serializedObject = {};
+    let keys;
+    try {
+        keys = Object.keys(value);
+    }
+    catch {
+        return '[Unserializable]';
+    }
+    for (const key of keys.slice(0, MAX_OBJECT_KEYS)) {
+        try {
+            serializedObject[key] = serializeValue(value[key], context, depth + 1);
+        }
+        catch {
+            serializedObject[key] = '[Unserializable]';
+        }
+    }
+    if (keys.length > MAX_OBJECT_KEYS) {
+        serializedObject._truncated = TRUNCATED_SUFFIX;
+    }
+    return serializedObject;
+};
+const safeSerialize = (value) => serializeValue(value, {
+    nodes: 0,
+    seen: new WeakSet(),
+}, 0);
+exports.safeSerialize = safeSerialize;
+const getSensitiveFields = (hiddenFields = []) => new Set([...DEFAULT_SENSITIVE_FIELDS, ...hiddenFields].map((field) => field.toLowerCase()));
+const redactValue = (value, sensitiveFields) => {
+    if (Array.isArray(value)) {
+        return value.map((item) => redactValue(item, sensitiveFields));
+    }
+    if (value === null || typeof value !== 'object') {
+        return value;
+    }
+    const redacted = {};
+    for (const [key, item] of Object.entries(value)) {
+        redacted[key] = sensitiveFields.has(key.toLowerCase())
+            ? REDACTED_VALUE
+            : redactValue(item, sensitiveFields);
+    }
+    return redacted;
+};
+const redactSensitiveData = (value, hiddenFields = []) => redactValue(value, getSensitiveFields(hiddenFields));
+exports.redactSensitiveData = redactSensitiveData;
+const cleanLogData = (value, hiddenFields = []) => redactSensitiveData(safeSerialize(value), hiddenFields);
+exports.cleanLogData = cleanLogData;
+const safeStringify = (value) => {
+    try {
+        return JSON.stringify(value);
+    }
+    catch {
+        return JSON.stringify('[Unserializable]');
+    }
+};
+exports.safeStringify = safeStringify;
+const truncateUtf8 = (value, maxBytes) => {
+    const buffer = Buffer.from(value);
+    if (buffer.length <= maxBytes) {
+        return value;
+    }
+    return buffer.subarray(0, Math.max(0, maxBytes)).toString('utf8');
+};
+const limitLogEvent = (value) => {
+    const serialized = safeStringify(value);
+    const maxLength = getMaxEventLength();
+    if (Buffer.byteLength(serialized) <= maxLength) {
+        return value;
+    }
+    let availableBytes = Math.max(0, maxLength - Buffer.byteLength(TRUNCATED_SUFFIX) - 64);
+    let limited = {
+        message: `${truncateUtf8(serialized, availableBytes)}${TRUNCATED_SUFFIX}`,
+        truncated: true,
+    };
+    let limitedSize = Buffer.byteLength(safeStringify(limited));
+    while (limitedSize > maxLength && availableBytes > 0) {
+        availableBytes = Math.max(0, availableBytes - (limitedSize - maxLength));
+        limited = {
+            message: `${truncateUtf8(serialized, availableBytes)}${TRUNCATED_SUFFIX}`,
+            truncated: true,
+        };
+        limitedSize = Buffer.byteLength(safeStringify(limited));
+    }
+    return limited;
+};
+exports.limitLogEvent = limitLogEvent;
+const sanitizeRequestPath = (path) => {
+    const dynamicSegment = /^(?:\d+|[0-9a-f]{8}-[0-9a-f-]{27,}|[0-9a-f]{16,}|[^/]*@[^/]*)$/i;
+    const pathname = path.split('?')[0];
+    return pathname
+        .split('/')
+        .map((segment) => dynamicSegment.test(segment) || segment.length > 24 ? ':value' : segment)
+        .join('/');
+};
+exports.sanitizeRequestPath = sanitizeRequestPath;
+//# sourceMappingURL=log-data.js.map

package/dist/log-data.js.map

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

package/dist/logger.d.ts

@@ -0,0 +1,23 @@
+import { ErrorRequestHandler, NextFunction, Request, Response } from 'express';
+import { limitLogEvent, redactSensitiveData, safeSerialize, truncateString } from './log-data';
+type CompatibleLogger = {
+    error: (message: unknown, metadata?: object) => unknown;
+    info: (message: unknown, metadata?: object) => unknown;
+};
+declare const handlerError: (code: number, error: string, status: number) => {
+    status: number;
+    message: {
+        code: number;
+        detail: string;
+    };
+};
+declare const logTimeStartMiddleware: (req: Request & {
+    logTimeStart?: number;
+}, _res: Response, next: NextFunction) => void;
+declare const cleanData: (data: unknown, hiddenFields?: string[]) => unknown;
+declare const hideSensitiveData: (data: unknown, hiddenFields?: string[]) => unknown;
+declare const logErrorMiddleware: ErrorRequestHandler;
+declare const requestLogMiddleware: (targetLogger: CompatibleLogger, formats?: string, enabled?: boolean, hiddenFields?: string[]) => (_req: Request, _res: Response, next: NextFunction) => void;
+declare const printGeneralLog: (message: object, type: string, targetLogger?: CompatibleLogger | null, isError?: boolean, formats?: string, enabled?: boolean) => void;
+export { CompatibleLogger, cleanData, handlerError, hideSensitiveData, limitLogEvent, logErrorMiddleware, logTimeStartMiddleware, printGeneralLog, redactSensitiveData, requestLogMiddleware, safeSerialize, truncateString, };
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,YAAY,EACZ,OAAO,EACP,QAAQ,EACT,MAAM,SAAS,CAAC;AAGjB,OAAO,EAEL,aAAa,EACb,mBAAmB,EACnB,aAAa,EAEb,cAAc,EACf,MAAM,YAAY,CAAC;AAMpB,KAAK,gBAAgB,GAAG;IACtB,KAAK,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACxD,IAAI,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CACxD,CAAC;AAKF,QAAA,MAAM,YAAY,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,EAAE,QAAQ,MAAM;;;;;;CAM/D,CAAC;AAEH,QAAA,MAAM,sBAAsB,GAC1B,KAAK,OAAO,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,EACxC,MAAM,QAAQ,EACd,MAAM,YAAY,SAInB,CAAC;AAEF,QAAA,MAAM,SAAS,GAAI,MAAM,OAAO,EAAE,eAAc,MAAM,EAAO,YAC3B,CAAC;AAEnC,QAAA,MAAM,iBAAiB,GAAI,MAAM,OAAO,EAAE,eAAc,MAAM,EAAO,YACb,CAAC;AAEzD,QAAA,MAAM,kBAAkB,EAAE,mBA4CzB,CAAC;AAEF,QAAA,MAAM,oBAAoB,GAEtB,cAAc,gBAAgB,EAC9B,gBAAgB,EAChB,iBAAc,EACd,eAAc,MAAM,EAAO,MAE5B,MAAM,OAAO,EAAE,MAAM,QAAQ,EAAE,MAAM,YAAY,SAMjD,CAAC;AAEJ,QAAA,MAAM,eAAe,GACnB,SAAS,MAAM,EACf,MAAM,MAAM,EACZ,eAAc,gBAAgB,GAAG,IAAW,EAC5C,iBAAe,EACf,gBAAgB,EAChB,iBAAc,SAoCf,CAAC;AAEF,OAAO,EACL,gBAAgB,EAChB,SAAS,EACT,YAAY,EACZ,iBAAiB,EACjB,aAAa,EACb,kBAAkB,EAClB,sBAAsB,EACtB,eAAe,EACf,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,cAAc,GACf,CAAC"}

package/dist/logger.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.truncateString = exports.safeSerialize = exports.requestLogMiddleware = exports.redactSensitiveData = exports.printGeneralLog = exports.logTimeStartMiddleware = exports.logErrorMiddleware = exports.limitLogEvent = exports.hideSensitiveData = exports.handlerError = exports.cleanData = void 0;
+const logging_1 = __importDefault(require("./logging"));
+const log_data_1 = require("./log-data");
+Object.defineProperty(exports, "limitLogEvent", { enumerable: true, get: function () { return log_data_1.limitLogEvent; } });
+Object.defineProperty(exports, "redactSensitiveData", { enumerable: true, get: function () { return log_data_1.redactSensitiveData; } });
+Object.defineProperty(exports, "safeSerialize", { enumerable: true, get: function () { return log_data_1.safeSerialize; } });
+Object.defineProperty(exports, "truncateString", { enumerable: true, get: function () { return log_data_1.truncateString; } });
+const getGlobalHiddenFields = () => global.hiddenFields ?? [];
+const handlerError = (code, error, status) => ({
+    status: status || 400,
+    message: {
+        code,
+        detail: error,
+    },
+});
+exports.handlerError = handlerError;
+const logTimeStartMiddleware = (req, _res, next) => {
+    req.logTimeStart = Date.now();
+    next();
+};
+exports.logTimeStartMiddleware = logTimeStartMiddleware;
+const cleanData = (data, hiddenFields = []) => (0, log_data_1.cleanLogData)(data, hiddenFields);
+exports.cleanData = cleanData;
+const hideSensitiveData = (data, hiddenFields = []) => (0, log_data_1.redactSensitiveData)((0, log_data_1.safeSerialize)(data), hiddenFields);
+exports.hideSensitiveData = hideSensitiveData;
+const logErrorMiddleware = (err, req, _res, next) => {
+    try {
+        const errorRecord = err && typeof err === 'object'
+            ? err
+            : undefined;
+        const nestedError = errorRecord?.error;
+        const source = nestedError ?? err;
+        const sourceRecord = source && typeof source === 'object'
+            ? source
+            : undefined;
+        const name = source instanceof Error
+            ? source.name
+            : typeof sourceRecord?.name === 'string'
+                ? sourceRecord.name
+                : String(source ?? 'UnknownError');
+        const stack = typeof errorRecord?.stack === 'string'
+            ? errorRecord.stack
+            : typeof sourceRecord?.stack === 'string'
+                ? sourceRecord.stack
+                : '';
+        req.logErrorData = {
+            name: (0, log_data_1.truncateString)(name),
+            data: (0, log_data_1.limitLogEvent)(cleanData(source, getGlobalHiddenFields())),
+            stack: (0, log_data_1.truncateString)(stack),
+        };
+    }
+    catch {
+        req.logErrorData = {
+            name: 'LoggingError',
+            data: '[Unserializable]',
+            stack: '',
+        };
+    }
+    next(err);
+};
+exports.logErrorMiddleware = logErrorMiddleware;
+const requestLogMiddleware = (targetLogger, formats = 'json', enabled = true, hiddenFields = []) => (_req, _res, next) => {
+    void targetLogger;
+    void formats;
+    void enabled;
+    void hiddenFields;
+    next();
+};
+exports.requestLogMiddleware = requestLogMiddleware;
+const printGeneralLog = (message, type, targetLogger = null, isError = false, formats = 'json', enabled = true) => {
+    if (!enabled) {
+        return;
+    }
+    const selectedLogger = targetLogger || logging_1.default;
+    try {
+        const sanitized = cleanData(message, getGlobalHiddenFields());
+        const formatted = formats === 'json' ? sanitized : (0, log_data_1.safeStringify)(sanitized);
+        const limited = (0, log_data_1.limitLogEvent)(formatted);
+        const event = limited && typeof limited === 'object' && !Array.isArray(limited)
+            ? { ...limited, type }
+            : { message: limited, type };
+        if (isError) {
+            selectedLogger.error(event);
+        }
+        else {
+            selectedLogger.info(event);
+        }
+    }
+    catch {
+        try {
+            process.stderr.write(`${(0, log_data_1.safeStringify)({
+                level: 'error',
+                type: 'loggerFailure',
+                sourceType: (0, log_data_1.truncateString)(type),
+                message: 'The logger failed to serialize an event',
+            })}\n`);
+        }
+        catch {
+            // Logging failures must not affect application behavior.
+        }
+    }
+};
+exports.printGeneralLog = printGeneralLog;
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/logging.d.ts

@@ -0,0 +1,5 @@
+import winston from 'winston';
+declare const logger: winston.Logger;
+export { logger };
+export default logger;
+//# sourceMappingURL=logging.d.ts.map

package/dist/logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../src/logging.ts"],"names":[],"mappings":"AACA,OAAO,OAAO,MAAM,SAAS,CAAC;AAgF9B,QAAA,MAAM,MAAM,gBASV,CAAC;AAiCH,OAAO,EAAE,MAAM,EAAE,CAAC;AAClB,eAAe,MAAM,CAAC"}

package/dist/logging.js

@@ -0,0 +1,130 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = void 0;
+const rTracer = __importStar(require("cls-rtracer"));
+const winston_1 = __importDefault(require("winston"));
+const log_data_1 = require("./log-data");
+const VALID_LOG_LEVELS = new Set(['error', 'warn', 'info', 'debug']);
+const configuredLevel = process.env.LOG_LEVEL?.toLowerCase();
+const logLevel = configuredLevel && VALID_LOG_LEVELS.has(configuredLevel)
+    ? configuredLevel
+    : 'info';
+const getHiddenFields = () => {
+    const applicationGlobal = global;
+    return applicationGlobal.hiddenFields ?? [];
+};
+const structuredMetadata = winston_1.default.format((info) => {
+    const currentLevel = info.level;
+    const sanitized = (0, log_data_1.limitLogEvent)((0, log_data_1.cleanLogData)(info, getHiddenFields()));
+    for (const key of Object.keys(info)) {
+        delete info[key];
+    }
+    if (sanitized &&
+        typeof sanitized === 'object' &&
+        !Array.isArray(sanitized)) {
+        Object.assign(info, sanitized);
+    }
+    else {
+        info.message = sanitized;
+    }
+    info.level = currentLevel;
+    info.service =
+        process.env.SERVICE_NAME ||
+            process.env.npm_package_name ||
+            'unknown-service';
+    info.environment =
+        process.env.ENVIRONMENT || process.env.NODE_ENV || 'unknown';
+    if (process.env.AWS_REGION) {
+        info.region = process.env.AWS_REGION;
+    }
+    const requestId = rTracer.id();
+    if (requestId !== undefined && requestId !== null) {
+        info.requestId = requestId;
+    }
+    return info;
+});
+const oneLineJson = winston_1.default.format((info) => {
+    info[Symbol.for('message')] = (0, log_data_1.safeStringify)((0, log_data_1.limitLogEvent)(info));
+    return info;
+});
+const outputFormat = process.env.NODE_ENV === 'local'
+    ? winston_1.default.format.combine(winston_1.default.format.errors({ stack: true }), structuredMetadata(), winston_1.default.format.timestamp(), winston_1.default.format.prettyPrint())
+    : winston_1.default.format.combine(winston_1.default.format.errors({ stack: true }), structuredMetadata(), winston_1.default.format.timestamp(), oneLineJson());
+const logger = winston_1.default.createLogger({
+    level: logLevel,
+    format: outputFormat,
+    transports: [
+        new winston_1.default.transports.Console({
+            stderrLevels: ['error'],
+            consoleWarnLevels: [],
+        }),
+    ],
+});
+exports.logger = logger;
+process
+    .on('unhandledRejection', (reason, promise) => {
+    try {
+        logger.error({
+            type: 'unhandledRejection',
+            name: 'Unhandled Rejection at Promise',
+            error: reason,
+            promise,
+        });
+    }
+    catch {
+        process.stderr.write('{"level":"error","type":"unhandledRejection","message":"Logger failed while handling rejection"}\n');
+    }
+})
+    .on('uncaughtException', (error) => {
+    try {
+        logger.error({
+            type: 'uncaughtException',
+            name: 'Uncaught Exception thrown',
+            error,
+        });
+    }
+    catch {
+        process.stderr.write('{"level":"error","type":"uncaughtException","message":"Logger failed while handling exception"}\n');
+    }
+    finally {
+        process.exit(1);
+    }
+});
+exports.default = logger;
+//# sourceMappingURL=logging.js.map

package/dist/logging.js.map

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

package/dist/memory.d.ts

@@ -0,0 +1,4 @@
+declare const memoryMiddleware: import("express-serve-static-core").Router;
+export { memoryMiddleware };
+export default memoryMiddleware;
+//# sourceMappingURL=memory.d.ts.map

package/dist/memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":"AAKA,QAAA,MAAM,gBAAgB,4CAAmB,CAAC;AA4B1C,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAC5B,eAAe,gBAAgB,CAAC"}

package/dist/memory.js

@@ -0,0 +1,31 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.memoryMiddleware = void 0;
+const express_1 = __importDefault(require("express"));
+const logger_1 = require("./logger");
+const logging_1 = __importDefault(require("./logging"));
+const memoryMiddleware = express_1.default.Router();
+exports.memoryMiddleware = memoryMiddleware;
+memoryMiddleware.use(async (req, res, next) => {
+    if (process.env.LOG_MEMORY_USAGE !== 'true') {
+        return next();
+    }
+    const startMemory = process.memoryUsage().heapUsed;
+    res.on('finish', () => {
+        const endMemory = process.memoryUsage().heapUsed;
+        const memoryUsed = endMemory - startMemory;
+        if (process.env.NODE_ENV !== 'local') {
+            (0, logger_1.printGeneralLog)({
+                memoryMb: memoryUsed / (1024 * 1024),
+                method: req.method,
+                url: req.path,
+            }, 'memory-usage', logging_1.default);
+        }
+    });
+    next();
+});
+exports.default = memoryMiddleware;
+//# sourceMappingURL=memory.js.map

package/dist/memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory.js","sourceRoot":"","sources":["../src/memory.ts"],"names":[],"mappings":";;;;;;AAAA,sDAAmE;AAEnE,qCAA2C;AAC3C,wDAA+B;AAE/B,MAAM,gBAAgB,GAAG,iBAAO,CAAC,MAAM,EAAE,CAAC;AA4BjC,4CAAgB;AA1BzB,gBAAgB,CAAC,GAAG,CAClB,KAAK,EAAE,GAAY,EAAE,GAAa,EAAE,IAAkB,EAAE,EAAE;IACxD,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,KAAK,MAAM,EAAE,CAAC;QAC5C,OAAO,IAAI,EAAE,CAAC;IAChB,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC;IACnD,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;QACpB,MAAM,SAAS,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC;QACjD,MAAM,UAAU,GAAG,SAAS,GAAG,WAAW,CAAC;QAC3C,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YACrC,IAAA,wBAAe,EACb;gBACE,QAAQ,EAAE,UAAU,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC;gBACpC,MAAM,EAAE,GAAG,CAAC,MAAM;gBAClB,GAAG,EAAE,GAAG,CAAC,IAAI;aACd,EACD,cAAc,EACd,iBAAM,CACP,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IACH,IAAI,EAAE,CAAC;AACT,CAAC,CACF,CAAC;AAGF,kBAAe,gBAAgB,CAAC"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@clicoh/logging",
+  "version": "1.0.0",
+  "description": "Structured JSON logging for ClicOH Node.js Express services",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./logger": {
+      "types": "./dist/logger.d.ts",
+      "require": "./dist/logger.js",
+      "default": "./dist/logger.js"
+    },
+    "./log-data": {
+      "types": "./dist/log-data.d.ts",
+      "require": "./dist/log-data.js",
+      "default": "./dist/log-data.js"
+    },
+    "./audit": {
+      "types": "./dist/audit.d.ts",
+      "require": "./dist/audit.js",
+      "default": "./dist/audit.js"
+    },
+    "./memory": {
+      "types": "./dist/memory.d.ts",
+      "require": "./dist/memory.js",
+      "default": "./dist/memory.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "bun run build && node --test tests/*.test.js",
+    "prepublishOnly": "bun run test"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "peerDependencies": {
+    "cls-rtracer": "^2.6.0",
+    "express": "^4.18.0 || ^5.0.0",
+    "winston": "^3.11.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.0",
+    "cls-rtracer": "2.6.3",
+    "express": "^5.2.1",
+    "typescript": "^5.7.2",
+    "winston": "3.19.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/clicOH/logging-node.git"
+  },
+  "license": "UNLICENSED",
+  "private": false,
+  "packageManager": "bun@1.4.2"
+}