@democratize-quality/qualitylens-core 0.1.0

package/dist/utils/logger.mjs

@@ -0,0 +1,79 @@
+// src/utils/logger.ts
+import * as fs from "fs";
+import * as path from "path";
+var Logger = class {
+  logPath = null;
+  fd = null;
+  /**
+   * Open (or create) qualitylens.log in the given directory.
+   * Appends to an existing log so multiple runs accumulate history.
+   * Call once at the start of each command.
+   */
+  configure(outputDir) {
+    try {
+      fs.mkdirSync(outputDir, { recursive: true });
+      this.logPath = path.join(outputDir, "qualitylens.log");
+      this.fd = fs.openSync(this.logPath, "a");
+      this.write("INFO", `--- qualitylens session started (pid ${process.pid}) ---`);
+    } catch {
+      this.logPath = null;
+      this.fd = null;
+    }
+  }
+  /** Path to the current log file, or null if not configured. */
+  get filePath() {
+    return this.logPath;
+  }
+  info(msg, detail) {
+    this.write("INFO", msg, detail);
+  }
+  warn(msg, detail) {
+    this.write("WARN", msg, detail);
+  }
+  /** Logs full detail (stack trace, raw error) to file only. */
+  error(msg, detail) {
+    this.write("ERROR", msg, detail);
+  }
+  debug(msg, detail) {
+    this.write("DEBUG", msg, detail);
+  }
+  close() {
+    if (this.fd !== null) {
+      try {
+        fs.closeSync(this.fd);
+      } catch {
+      }
+      this.fd = null;
+    }
+  }
+  write(level, msg, detail) {
+    if (this.fd === null) return;
+    const ts = (/* @__PURE__ */ new Date()).toISOString();
+    let line = `[${ts}] ${level.padEnd(5)} ${msg}`;
+    if (detail !== void 0) {
+      if (detail instanceof Error) {
+        line += `
+  ${detail.message}`;
+        if (detail.stack) {
+          line += "\n" + detail.stack.split("\n").map((l) => "  " + l).join("\n");
+        }
+      } else if (typeof detail === "string" && detail.trim()) {
+        line += "\n" + detail.split("\n").map((l) => "  " + l).join("\n");
+      } else if (typeof detail === "object") {
+        try {
+          line += "\n  " + JSON.stringify(detail, null, 2).replace(/\n/g, "\n  ");
+        } catch {
+        }
+      }
+    }
+    try {
+      fs.writeSync(this.fd, line + "\n");
+    } catch {
+    }
+  }
+};
+var logger = new Logger();
+export {
+  logger
+};
+//# sourceMappingURL=logger.mjs.map

package/dist/utils/logger.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/logger.ts"],"sourcesContent":["/**\n * src/utils/logger.ts\n *\n * Module-level singleton logger.\n * - Always writes to a log file (qualitylens.log) with timestamps and full detail.\n * - Console output is handled separately by each command — the logger only writes the file.\n *\n * Usage:\n *   import { logger } from './utils/logger'\n *   logger.configure('./reports')        // call once at startup\n *   logger.info('scan started', { config: opts.config })\n *   logger.error('route discovery failed', err)\n */\n\nimport * as fs from 'fs'\nimport * as path from 'path'\n\ntype LogLevel = 'INFO' | 'WARN' | 'ERROR' | 'DEBUG'\n\nclass Logger {\n  private logPath: string | null = null\n  private fd: number | null = null\n\n  /**\n   * Open (or create) qualitylens.log in the given directory.\n   * Appends to an existing log so multiple runs accumulate history.\n   * Call once at the start of each command.\n   */\n  configure(outputDir: string): void {\n    try {\n      fs.mkdirSync(outputDir, { recursive: true })\n      this.logPath = path.join(outputDir, 'qualitylens.log')\n      this.fd = fs.openSync(this.logPath, 'a')\n      this.write('INFO', `--- qualitylens session started (pid ${process.pid}) ---`)\n    } catch {\n      // If we can't open a log file, continue silently — logging is non-blocking\n      this.logPath = null\n      this.fd = null\n    }\n  }\n\n  /** Path to the current log file, or null if not configured. */\n  get filePath(): string | null {\n    return this.logPath\n  }\n\n  info(msg: string, detail?: unknown): void {\n    this.write('INFO', msg, detail)\n  }\n\n  warn(msg: string, detail?: unknown): void {\n    this.write('WARN', msg, detail)\n  }\n\n  /** Logs full detail (stack trace, raw error) to file only. */\n  error(msg: string, detail?: unknown): void {\n    this.write('ERROR', msg, detail)\n  }\n\n  debug(msg: string, detail?: unknown): void {\n    this.write('DEBUG', msg, detail)\n  }\n\n  close(): void {\n    if (this.fd !== null) {\n      try { fs.closeSync(this.fd) } catch { /* ignore */ }\n      this.fd = null\n    }\n  }\n\n  private write(level: LogLevel, msg: string, detail?: unknown): void {\n    if (this.fd === null) return\n\n    const ts = new Date().toISOString()\n    let line = `[${ts}] ${level.padEnd(5)} ${msg}`\n\n    if (detail !== undefined) {\n      if (detail instanceof Error) {\n        line += `\\n  ${detail.message}`\n        if (detail.stack) {\n          line += '\\n' + detail.stack.split('\\n').map(l => '  ' + l).join('\\n')\n        }\n      } else if (typeof detail === 'string' && detail.trim()) {\n        line += '\\n' + detail.split('\\n').map(l => '  ' + l).join('\\n')\n      } else if (typeof detail === 'object') {\n        try {\n          line += '\\n  ' + JSON.stringify(detail, null, 2).replace(/\\n/g, '\\n  ')\n        } catch { /* circular ref or similar — skip */ }\n      }\n    }\n\n    try {\n      fs.writeSync(this.fd, line + '\\n')\n    } catch { /* disk full or fd closed — ignore */ }\n  }\n}\n\nexport const logger = new Logger()\n"],"mappings":";AAcA,YAAY,QAAQ;AACpB,YAAY,UAAU;AAItB,IAAM,SAAN,MAAa;AAAA,EACH,UAAyB;AAAA,EACzB,KAAoB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO5B,UAAU,WAAyB;AACjC,QAAI;AACF,MAAG,aAAU,WAAW,EAAE,WAAW,KAAK,CAAC;AAC3C,WAAK,UAAe,UAAK,WAAW,iBAAiB;AACrD,WAAK,KAAQ,YAAS,KAAK,SAAS,GAAG;AACvC,WAAK,MAAM,QAAQ,wCAAwC,QAAQ,GAAG,OAAO;AAAA,IAC/E,QAAQ;AAEN,WAAK,UAAU;AACf,WAAK,KAAK;AAAA,IACZ;AAAA,EACF;AAAA;AAAA,EAGA,IAAI,WAA0B;AAC5B,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,KAAK,KAAa,QAAwB;AACxC,SAAK,MAAM,QAAQ,KAAK,MAAM;AAAA,EAChC;AAAA,EAEA,KAAK,KAAa,QAAwB;AACxC,SAAK,MAAM,QAAQ,KAAK,MAAM;AAAA,EAChC;AAAA;AAAA,EAGA,MAAM,KAAa,QAAwB;AACzC,SAAK,MAAM,SAAS,KAAK,MAAM;AAAA,EACjC;AAAA,EAEA,MAAM,KAAa,QAAwB;AACzC,SAAK,MAAM,SAAS,KAAK,MAAM;AAAA,EACjC;AAAA,EAEA,QAAc;AACZ,QAAI,KAAK,OAAO,MAAM;AACpB,UAAI;AAAE,QAAG,aAAU,KAAK,EAAE;AAAA,MAAE,QAAQ;AAAA,MAAe;AACnD,WAAK,KAAK;AAAA,IACZ;AAAA,EACF;AAAA,EAEQ,MAAM,OAAiB,KAAa,QAAwB;AAClE,QAAI,KAAK,OAAO,KAAM;AAEtB,UAAM,MAAK,oBAAI,KAAK,GAAE,YAAY;AAClC,QAAI,OAAO,IAAI,EAAE,KAAK,MAAM,OAAO,CAAC,CAAC,IAAI,GAAG;AAE5C,QAAI,WAAW,QAAW;AACxB,UAAI,kBAAkB,OAAO;AAC3B,gBAAQ;AAAA,IAAO,OAAO,OAAO;AAC7B,YAAI,OAAO,OAAO;AAChB,kBAAQ,OAAO,OAAO,MAAM,MAAM,IAAI,EAAE,IAAI,OAAK,OAAO,CAAC,EAAE,KAAK,IAAI;AAAA,QACtE;AAAA,MACF,WAAW,OAAO,WAAW,YAAY,OAAO,KAAK,GAAG;AACtD,gBAAQ,OAAO,OAAO,MAAM,IAAI,EAAE,IAAI,OAAK,OAAO,CAAC,EAAE,KAAK,IAAI;AAAA,MAChE,WAAW,OAAO,WAAW,UAAU;AACrC,YAAI;AACF,kBAAQ,SAAS,KAAK,UAAU,QAAQ,MAAM,CAAC,EAAE,QAAQ,OAAO,MAAM;AAAA,QACxE,QAAQ;AAAA,QAAuC;AAAA,MACjD;AAAA,IACF;AAEA,QAAI;AACF,MAAG,aAAU,KAAK,IAAI,OAAO,IAAI;AAAA,IACnC,QAAQ;AAAA,IAAwC;AAAA,EAClD;AACF;AAEO,IAAM,SAAS,IAAI,OAAO;","names":[]}

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "@democratize-quality/qualitylens-core",
+  "version": "0.1.0",
+  "description": "Core library for qualitylens — engine, types, sources, matchers, reporters",
+  "author": "Raj Uppadhyay",
+  "license": "AGPL-3.0-only",
+  "main": "./dist/core/types.js",
+  "module": "./dist/core/types.mjs",
+  "types": "./dist/core/types.d.ts",
+  "exports": {
+    "./core/types": {
+      "types": "./dist/core/types.d.ts",
+      "import": "./dist/core/types.mjs",
+      "require": "./dist/core/types.js"
+    },
+    "./core/engine": {
+      "types": "./dist/core/engine.d.ts",
+      "import": "./dist/core/engine.mjs",
+      "require": "./dist/core/engine.js"
+    },
+    "./core/config": {
+      "types": "./dist/core/config.d.ts",
+      "import": "./dist/core/config.mjs",
+      "require": "./dist/core/config.js"
+    },
+    "./core/detector": {
+      "types": "./dist/core/detector.d.ts",
+      "import": "./dist/core/detector.mjs",
+      "require": "./dist/core/detector.js"
+    },
+    "./sources/base.source": {
+      "types": "./dist/sources/base.source.d.ts",
+      "import": "./dist/sources/base.source.mjs",
+      "require": "./dist/sources/base.source.js"
+    },
+    "./sources/playwright.source": {
+      "types": "./dist/sources/playwright.source.d.ts",
+      "import": "./dist/sources/playwright.source.mjs",
+      "require": "./dist/sources/playwright.source.js"
+    },
+    "./sources/yaml.source": {
+      "types": "./dist/sources/yaml.source.d.ts",
+      "import": "./dist/sources/yaml.source.mjs",
+      "require": "./dist/sources/yaml.source.js"
+    },
+    "./sources/routes.source": {
+      "types": "./dist/sources/routes.source.d.ts",
+      "import": "./dist/sources/routes.source.mjs",
+      "require": "./dist/sources/routes.source.js"
+    },
+    "./matchers/fuzzy.matcher": {
+      "types": "./dist/matchers/fuzzy.matcher.d.ts",
+      "import": "./dist/matchers/fuzzy.matcher.mjs",
+      "require": "./dist/matchers/fuzzy.matcher.js"
+    },
+    "./matchers/area.matcher": {
+      "types": "./dist/matchers/area.matcher.d.ts",
+      "import": "./dist/matchers/area.matcher.mjs",
+      "require": "./dist/matchers/area.matcher.js"
+    },
+    "./reporters/base.reporter": {
+      "types": "./dist/reporters/base.reporter.d.ts",
+      "import": "./dist/reporters/base.reporter.mjs",
+      "require": "./dist/reporters/base.reporter.js"
+    },
+    "./reporters/console.reporter": {
+      "types": "./dist/reporters/console.reporter.d.ts",
+      "import": "./dist/reporters/console.reporter.mjs",
+      "require": "./dist/reporters/console.reporter.js"
+    },
+    "./utils/logger": {
+      "types": "./dist/utils/logger.d.ts",
+      "import": "./dist/utils/logger.mjs",
+      "require": "./dist/utils/logger.js"
+    },
+    "./utils/http": {
+      "types": "./dist/utils/http.d.ts",
+      "import": "./dist/utils/http.mjs",
+      "require": "./dist/utils/http.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "tsc --noEmit"
+  },
+  "keywords": [
+    "testing",
+    "playwright",
+    "qa",
+    "coverage"
+  ],
+  "dependencies": {
+    "@typescript-eslint/parser": "^8.57.2",
+    "chalk": "^5.3.0",
+    "fast-glob": "^3.3.2",
+    "js-yaml": "^4.1.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.4.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  }
+}