@meadown/logger 1.0.1 → 1.1.0

package/dist/cjs/config.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Logging is enabled in every environment except production, read directly
+ * from `process.env.NODE_ENV`. No configuration — set `NODE_ENV=production`
+ * in your runtime to silence logs.
+ */
+export declare function isLogAllowed(): boolean;

package/dist/cjs/config.js

@@ -0,0 +1,19 @@
+"use strict";
+/*
+ * config.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLogAllowed = isLogAllowed;
+/**
+ * Logging is enabled in every environment except production, read directly
+ * from `process.env.NODE_ENV`. No configuration — set `NODE_ENV=production`
+ * in your runtime to silence logs.
+ */
+function isLogAllowed() {
+    // Guard `process` so the logger doesn't throw in non-Node runtimes (browser,
+    // edge) where it may be undefined; default to logging when it's absent.
+    return typeof process === "undefined" || process.env.NODE_ENV !== "production";
+}

package/dist/cjs/index.d.ts

@@ -0,0 +1,18 @@
+/** The logger: a callable for info logs, plus `.error` and `.warn` variants. */
+export interface LogFN {
+    (...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+}
+/**
+ * Logs to the console, but only outside production. Each line is prefixed with
+ * an `[INFO]` tag, an ISO timestamp, and the file and line it was called from;
+ * all arguments are then printed as-is. `.error` and `.warn` behave the same
+ * with their own tags and console channels.
+ * @example
+ * customLog("Auth", "user logged in")
+ * // [INFO] 2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in
+ */
+declare const customLog: LogFN;
+export { customLog };
+export default customLog;

package/dist/cjs/index.js

@@ -0,0 +1,39 @@
+"use strict";
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.customLog = void 0;
+const index_js_1 = require("./utils/index.js");
+const config_js_1 = require("./config.js");
+/**
+ * Builds a log function bound to a console channel and tag. The returned closure
+ * is what the caller invokes directly, so {@link getFileName} still resolves the
+ * caller's own frame (no extra stack frame is inserted). `console[channel]` is
+ * looked up at call time, so reassigning `console.log` (e.g. in tests) is
+ * respected. Logs only outside production — see {@link isLogAllowed}.
+ */
+function createLog(channel, tag) {
+    return (...args) => {
+        if ((0, config_js_1.isLogAllowed)())
+            console[channel](tag, (0, index_js_1.getTimeStamp)(), `(${(0, index_js_1.getFileName)()})`, ...args);
+    };
+}
+/**
+ * Logs to the console, but only outside production. Each line is prefixed with
+ * an `[INFO]` tag, an ISO timestamp, and the file and line it was called from;
+ * all arguments are then printed as-is. `.error` and `.warn` behave the same
+ * with their own tags and console channels.
+ * @example
+ * customLog("Auth", "user logged in")
+ * // [INFO] 2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in
+ */
+const customLog = Object.assign(createLog("log", "[INFO]"), {
+    error: createLog("error", "[ERROR]"),
+    warn: createLog("warn", "[WARN]"),
+});
+exports.customLog = customLog;
+exports.default = customLog;

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/utils/getFileName.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns the caller's source location as `file.ext:line` by reading the call
+ * stack, or `"unknown"` if it can't be determined (e.g. minified or eval code).
+ */
+export default function getFileName(): string;

package/dist/cjs/utils/getFileName.js

@@ -0,0 +1,19 @@
+"use strict";
+/*
+ * getFileName.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = getFileName;
+/**
+ * Returns the caller's source location as `file.ext:line` by reading the call
+ * stack, or `"unknown"` if it can't be determined (e.g. minified or eval code).
+ */
+function getFileName() {
+    const stack = new Error().stack ?? "";
+    const line = stack.split("\n")[3] ?? "";
+    const match = line.match(/([^/\\]+\.[cm]?[jt]sx?):(\d+)/);
+    return match ? match[0] : "unknown";
+}

package/dist/cjs/utils/getTimeStamp.d.ts

@@ -0,0 +1,2 @@
+/** Returns the current time as an ISO-8601 string, e.g. `2026-05-30T10:00:00.000Z`. */
+export default function getTimeStamp(): string;

package/dist/cjs/utils/getTimeStamp.js

@@ -0,0 +1,13 @@
+"use strict";
+/*
+ * getTimeStamp.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = getTimeStamp;
+/** Returns the current time as an ISO-8601 string, e.g. `2026-05-30T10:00:00.000Z`. */
+function getTimeStamp() {
+    return new Date().toISOString();
+}

package/dist/cjs/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { default as getFileName } from "./getFileName.js";
+export { default as getTimeStamp } from "./getTimeStamp.js";

package/dist/cjs/utils/index.js

@@ -0,0 +1,16 @@
+"use strict";
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getTimeStamp = exports.getFileName = void 0;
+var getFileName_js_1 = require("./getFileName.js");
+Object.defineProperty(exports, "getFileName", { enumerable: true, get: function () { return __importDefault(getFileName_js_1).default; } });
+var getTimeStamp_js_1 = require("./getTimeStamp.js");
+Object.defineProperty(exports, "getTimeStamp", { enumerable: true, get: function () { return __importDefault(getTimeStamp_js_1).default; } });

package/dist/index.d.ts

@@ -14,5 +14,6 @@ export interface LogFN {
  * // [INFO] 2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in
  */
 declare const customLog: LogFN;
+export { customLog };
 export default customLog;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC1B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAC/B;AAmBD;;;;;;;;GAQG;AACH,QAAA,MAAM,SAAS,EAAE,KAGf,CAAA;AAEF,eAAe,SAAS,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,gFAAgF;AAChF,MAAM,WAAW,KAAK;IACpB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC1B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;CAC/B;AAmBD;;;;;;;;GAQG;AACH,QAAA,MAAM,SAAS,EAAE,KAGf,CAAA;AAEF,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,eAAe,SAAS,CAAA"}

package/dist/index.js

@@ -32,5 +32,6 @@ const customLog = Object.assign(createLog("log", "[INFO]"), {
     error: createLog("error", "[ERROR]"),
     warn: createLog("warn", "[WARN]"),
 });
+export { customLog };
 export default customLog;
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAS1C;;;;;;GAMG;AACH,SAAS,SAAS,CAChB,OAAiC,EACjC,GAAW;IAEX,OAAO,CAAC,GAAG,IAAe,EAAQ,EAAE;QAClC,IAAI,YAAY,EAAE;YAChB,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,IAAI,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IACxE,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,SAAS,GAAU,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE;IACjE,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;IACpC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC;CAClC,CAAC,CAAA;AAEF,eAAe,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAS1C;;;;;;GAMG;AACH,SAAS,SAAS,CAChB,OAAiC,EACjC,GAAW;IAEX,OAAO,CAAC,GAAG,IAAe,EAAQ,EAAE;QAClC,IAAI,YAAY,EAAE;YAChB,OAAO,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,EAAE,IAAI,WAAW,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAA;IACxE,CAAC,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,SAAS,GAAU,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE;IACjE,KAAK,EAAE,SAAS,CAAC,OAAO,EAAE,SAAS,CAAC;IACpC,IAAI,EAAE,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC;CAClC,CAAC,CAAA;AAEF,OAAO,EAAE,SAAS,EAAE,CAAA;AACpB,eAAe,SAAS,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meadown/logger",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "A tiny, zero-dependency logger for Node.js and TypeScript that tags each line, timestamps it, shows the source file and line, and goes quiet in production.",
   "keywords": [
     "logger",
@@ -23,13 +23,19 @@
   "license": "MIT",
   "author": "Dewan Mobashirul",
   "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "default": "./dist/index.js"
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/cjs/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
     }
   },
   "files": [
@@ -42,7 +48,7 @@
     "access": "public"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/write-cjs-pkg.mjs",
     "test": "tsc && node --test \"test/**/*.test.mjs\"",
     "lint": "eslint src",
     "lint:fix": "eslint src --fix",