@meadown/logger 1.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Dewan Mobashirul
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,58 @@
+# @meadown/logger
+
+I kept writing `console.log` everywhere, then squinting at my terminal trying to
+remember _which file_ a message came from — and worse, forgetting to pull those logs
+out before shipping. So I made this.
+
+It's basically `console.log` with the rough edges sanded off: every message gets a
+label, a timestamp, and the file and line it came from. And it stays quiet in
+production, so you can leave your logs where they are and not worry about them.
+
+No dependencies. No config. Import it and you're done.
+
+## Install
+
+```bash
+npm install @meadown/logger
+```
+
+## Using it
+
+```ts
+import customLog from "@meadown/logger"
+
+customLog("Hello world")
+customLog("Auth", "user logged in") // first word can be a label, if you want one
+
+customLog.warn("This is deprecated")
+customLog.error("Something went wrong")
+```
+
+You'll see something like:
+
+```text
+[INFO]  2026-05-30T10:00:00.000Z (server.ts:42) Auth user logged in
+[WARN]  2026-05-30T10:00:00.000Z (server.ts:51) This is deprecated
+[ERROR] 2026-05-30T10:00:00.000Z (server.ts:60) Something went wrong
+```
+
+That `(server.ts:42)` bit is the part I missed most with plain `console.log` —
+no more hunting for where a message came from.
+
+## What about production?
+
+Here's the nice part: you don't have to do anything. Logs show up while you're
+developing and go silent in production. The only thing that flips the switch is your
+`NODE_ENV`:
+
+| `NODE_ENV`                               | Logs?  |
+| ---------------------------------------- | ------ |
+| not set, `development`, or anything else | shown  |
+| `production`                             | silent |
+
+So leave your logs in the code. Once you ship with `NODE_ENV=production`, they just
+quietly step aside.
+
+## License
+
+MIT © Dewan Mobashirul

package/dist/config.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 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;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAOA;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAItC"}

package/dist/config.js

@@ -0,0 +1,17 @@
+/*
+ * config.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+/**
+ * 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 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";
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,6EAA6E;IAC7E,wEAAwE;IACxE,OAAO,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,CAAA;AAChF,CAAC"}

package/dist/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 default customLog;
+//# 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":"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"}

package/dist/index.js

@@ -0,0 +1,36 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+import { getFileName, getTimeStamp } from "./utils/index.js";
+import { isLogAllowed } from "./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 (isLogAllowed())
+            console[channel](tag, getTimeStamp(), `(${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]"),
+});
+export default customLog;
+//# 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;;;;;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"}

package/dist/utils/getFileName.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 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;
+//# sourceMappingURL=getFileName.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"getFileName.d.ts","sourceRoot":"","sources":["../../src/utils/getFileName.ts"],"names":[],"mappings":"AAOA;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,IAAI,MAAM,CAK5C"}

package/dist/utils/getFileName.js

@@ -0,0 +1,17 @@
+/*
+ * getFileName.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+/**
+ * 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() {
+    const stack = new Error().stack ?? "";
+    const line = stack.split("\n")[3] ?? "";
+    const match = line.match(/([^/\\]+\.[cm]?[jt]sx?):(\d+)/);
+    return match ? match[0] : "unknown";
+}
+//# sourceMappingURL=getFileName.js.map

package/dist/utils/getFileName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFileName.js","sourceRoot":"","sources":["../../src/utils/getFileName.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW;IACjC,MAAM,KAAK,GAAG,IAAI,KAAK,EAAE,CAAC,KAAK,IAAI,EAAE,CAAA;IACrC,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAA;IACzD,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;AACrC,CAAC"}

package/dist/utils/getTimeStamp.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"getTimeStamp.d.ts","sourceRoot":"","sources":["../../src/utils/getTimeStamp.ts"],"names":[],"mappings":"AAOA,uFAAuF;AACvF,MAAM,CAAC,OAAO,UAAU,YAAY,IAAI,MAAM,CAE7C"}

package/dist/utils/getTimeStamp.js

@@ -0,0 +1,11 @@
+/*
+ * getTimeStamp.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+/** Returns the current time as an ISO-8601 string, e.g. `2026-05-30T10:00:00.000Z`. */
+export default function getTimeStamp() {
+    return new Date().toISOString();
+}
+//# sourceMappingURL=getTimeStamp.js.map

package/dist/utils/getTimeStamp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getTimeStamp.js","sourceRoot":"","sources":["../../src/utils/getTimeStamp.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,uFAAuF;AACvF,MAAM,CAAC,OAAO,UAAU,YAAY;IAClC,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;AACjC,CAAC"}

package/dist/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { default as getFileName } from "./getFileName.js";
+export { default as getTimeStamp } from "./getTimeStamp.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/utils/index.js

@@ -0,0 +1,9 @@
+/*
+ * index.ts
+ * Created by Dewan Mobashirul
+ * Copyright (c) 2026 dewan-meadown
+ * All rights reserved
+ */
+export { default as getFileName } from "./getFileName.js";
+export { default as getTimeStamp } from "./getTimeStamp.js";
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,mBAAmB,CAAA"}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@meadown/logger",
+  "version": "1.0.1",
+  "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",
+    "logging",
+    "log",
+    "console",
+    "typescript",
+    "nodejs",
+    "zero-dependency",
+    "debug"
+  ],
+  "homepage": "https://github.com/meadown/meadown-logger#readme",
+  "bugs": {
+    "url": "https://github.com/meadown/meadown-logger/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/meadown/meadown-logger.git"
+  },
+  "license": "MIT",
+  "author": "Dewan Mobashirul",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "tsc && node --test \"test/**/*.test.mjs\"",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "prepublishOnly": "pnpm run lint && pnpm test && pnpm run build",
+    "prepare": "husky",
+    "release": "semantic-release"
+  },
+  "devDependencies": {
+    "@commitlint/cli": "^20.5.3",
+    "@commitlint/config-conventional": "^20.5.3",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/commit-analyzer": "^13.0.1",
+    "@semantic-release/git": "^10.0.1",
+    "@semantic-release/github": "^12.0.8",
+    "@semantic-release/npm": "^13.1.5",
+    "@semantic-release/release-notes-generator": "^14.1.1",
+    "@types/node": "^25.9.1",
+    "conventional-changelog-conventionalcommits": "^9.3.1",
+    "eslint": "^10.4.0",
+    "husky": "^9.1.7",
+    "semantic-release": "^25.0.3",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.60.0"
+  }
+}