mongoosleuth 0.1.0

package/dist/index.mjs

@@ -0,0 +1,402 @@
+// src/reporters/format-finding.ts
+function renderVal(val) {
+  if (val === null) {
+    return "<null>";
+  }
+  if (val === void 0) {
+    return "<undefined>";
+  }
+  if (typeof val === "string") {
+    if (val.startsWith("<") && val.endsWith(">")) {
+      return val;
+    }
+    return `"${val}"`;
+  }
+  if (Array.isArray(val)) {
+    if (val.length === 0) {
+      return "[]";
+    }
+    return `[${renderVal(val[0])}]`;
+  }
+  if (typeof val === "object") {
+    const keys = Object.keys(val);
+    if (keys.length === 0) {
+      return "{}";
+    }
+    const entries = keys.map((key) => `${key}: ${renderVal(val[key])}`);
+    return `{ ${entries.join(", ")} }`;
+  }
+  return String(val);
+}
+function extractQueryShape(finding) {
+  const prefix = `${finding.model}:${finding.operation}:`;
+  if (!finding.fingerprint || !finding.fingerprint.startsWith(prefix)) {
+    return {};
+  }
+  const jsonShapeStr = finding.fingerprint.slice(prefix.length);
+  try {
+    return JSON.parse(jsonShapeStr);
+  } catch {
+    return {};
+  }
+}
+function formatQueryLine(finding) {
+  const shape = extractQueryShape(finding);
+  const keys = Object.keys(shape);
+  if (keys.length === 0) {
+    return `${finding.operation}({})`;
+  }
+  return `${finding.operation}(${renderVal(shape)})`;
+}
+function suggestFix(finding) {
+  const op = finding.operation;
+  if (op === "find" || op === "findOne" || op === "findById") {
+    return "use .populate() or batch this with a single query using $in";
+  }
+  return "consider batching this operation instead of calling it in a loop (e.g. bulkWrite)";
+}
+
+// src/reporters/console.ts
+var ConsoleReporter = class {
+  /**
+   * Reports the identified N+1 query findings.
+   * @param findings The list of findings to report.
+   */
+  report(findings) {
+    if (findings.length === 0) {
+      return;
+    }
+    for (const finding of findings) {
+      console.warn(`[mongoosleuth] N+1 detected
+  model: ${finding.model}
+  query: ${formatQueryLine(finding)}
+  called ${finding.count} times in ${finding.callSite}
+  fix: ${suggestFix(finding)}`);
+    }
+  }
+};
+
+// src/scope.ts
+import { AsyncLocalStorage } from "async_hooks";
+var storage = new AsyncLocalStorage();
+function runInScope(fn) {
+  const scopeMap = /* @__PURE__ */ new Map();
+  return storage.run(scopeMap, fn);
+}
+function recordQuery(entry) {
+  const store = storage.getStore();
+  if (!store) {
+    return;
+  }
+  const key = `${entry.fingerprint}::${entry.callSite}`;
+  const existing = store.get(key);
+  if (existing) {
+    existing.count++;
+  } else {
+    store.set(key, {
+      model: entry.model,
+      operation: entry.operation,
+      fingerprint: entry.fingerprint,
+      callSite: entry.callSite,
+      count: 1
+    });
+  }
+}
+function getRawStore() {
+  return storage.getStore();
+}
+
+// src/fingerprint.ts
+function isObjectId(val) {
+  if (!val || typeof val !== "object") return false;
+  const anyVal = val;
+  if (anyVal._bsontype === "ObjectID") return true;
+  if (anyVal.constructor && (anyVal.constructor.name === "ObjectId" || anyVal.constructor.name === "ObjectID")) {
+    return true;
+  }
+  if (typeof anyVal.toHexString === "function") return true;
+  return false;
+}
+function normalizeValue(val) {
+  if (val === null) return "<null>";
+  if (val === void 0) return "<undefined>";
+  if (isObjectId(val)) {
+    return "<ObjectId>";
+  }
+  if (val instanceof Date) {
+    return "<Date>";
+  }
+  if (val instanceof RegExp) {
+    return "<RegExp>";
+  }
+  if (typeof val === "string") {
+    return "<string>";
+  }
+  if (typeof val === "number") {
+    return "<number>";
+  }
+  if (typeof val === "boolean") {
+    return "<boolean>";
+  }
+  if (Array.isArray(val)) {
+    if (val.length === 0) {
+      return "<empty array>";
+    }
+    return [normalizeValue(val[0])];
+  }
+  if (typeof val === "object") {
+    const result = {};
+    for (const key of Object.keys(val)) {
+      result[key] = normalizeValue(val[key]);
+    }
+    return result;
+  }
+  return `<${typeof val}>`;
+}
+function sortObjectKeys(val) {
+  if (val === null || val === void 0 || typeof val !== "object") {
+    return val;
+  }
+  if (Array.isArray(val)) {
+    return val.map(sortObjectKeys);
+  }
+  const sortedObj = {};
+  const keys = Object.keys(val).sort();
+  for (const key of keys) {
+    sortedObj[key] = sortObjectKeys(val[key]);
+  }
+  return sortedObj;
+}
+function normalizeFilterShape(filter) {
+  if (!filter || typeof filter !== "object" || Array.isArray(filter)) {
+    return {};
+  }
+  return normalizeValue(filter);
+}
+function buildFingerprint(modelName, operation, filter) {
+  const normalized = normalizeFilterShape(filter);
+  const sorted = sortObjectKeys(normalized);
+  return `${modelName}:${operation}:${JSON.stringify(sorted)}`;
+}
+
+// src/interceptor.ts
+var originalExec = null;
+function buildCallSite(stack) {
+  const lines = stack.split("\n");
+  const isInternal = /node_modules[\\/]mongoose[\\/]|node_modules[\\/]mongoosleuth[\\/]|[\\/]mongoosleuth[\\/]src[\\/]|[\\/]mongoosleuth[\\/]dist[\\/]|[\\/]src[\\/](?:interceptor|scope|mongoosleuth|fingerprint|analyzer)\.ts/i;
+  for (const line of lines) {
+    if (!line.includes("at ")) {
+      continue;
+    }
+    if (isInternal.test(line)) {
+      continue;
+    }
+    const parenMatch = line.match(/\(([^)]+)\)/);
+    const pathStr = parenMatch ? parenMatch[1] : line.trim().slice(3);
+    let normalizedPath = pathStr.replace(/\\/g, "/");
+    const cwd = process.cwd().replace(/\\/g, "/");
+    if (normalizedPath.toLowerCase().startsWith(cwd.toLowerCase() + "/")) {
+      normalizedPath = normalizedPath.slice(cwd.length + 1);
+    }
+    const cleanMatch = normalizedPath.match(/^(.*?):(\d+)(:\d+)?$/);
+    if (cleanMatch) {
+      return `${cleanMatch[1]}:${cleanMatch[2]}`;
+    }
+  }
+  return "unknown";
+}
+function attachInterceptor(mongooseInstance, options) {
+  if (!mongooseInstance || !mongooseInstance.Query || !mongooseInstance.Query.prototype) {
+    return;
+  }
+  if (mongooseInstance.Query.prototype.exec && mongooseInstance.Query.prototype.exec.__mongoosleuthPatched) {
+    console.warn("[mongoosleuth] already attached, skipping");
+    return;
+  }
+  originalExec = mongooseInstance.Query.prototype.exec;
+  const enabled = options.enabled !== false;
+  const captureStackTrace = options.captureStackTrace !== false;
+  const ignore = options.ignore || [];
+  const patchedExec = function(...args) {
+    if (!enabled) {
+      return originalExec.apply(this, args);
+    }
+    const modelName = this.model?.modelName;
+    const operation = this.op;
+    if (!modelName || !operation) {
+      return originalExec.apply(this, args);
+    }
+    const isIgnored = ignore.some((entry) => {
+      const matchModel = !entry.model || entry.model === modelName;
+      const matchOp = !entry.operation || entry.operation === operation;
+      return matchModel && matchOp;
+    });
+    if (isIgnored) {
+      return originalExec.apply(this, args);
+    }
+    const filter = this.getQuery() || {};
+    const fingerprint = buildFingerprint(modelName, operation, filter);
+    let callSite = "unknown";
+    if (captureStackTrace) {
+      const stack = new Error().stack;
+      if (stack) {
+        callSite = buildCallSite(stack);
+      }
+    }
+    recordQuery({
+      model: modelName,
+      operation,
+      fingerprint,
+      callSite
+    });
+    return originalExec.apply(this, args);
+  };
+  patchedExec.__mongoosleuthPatched = true;
+  mongooseInstance.Query.prototype.exec = patchedExec;
+}
+
+// src/analyzer.ts
+function analyzeRecords(records, options) {
+  if (!records) {
+    return [];
+  }
+  const findings = records.filter((r) => r.count >= options.threshold).map((r) => ({
+    model: r.model,
+    operation: r.operation,
+    fingerprint: r.fingerprint,
+    count: r.count,
+    callSite: r.callSite
+  }));
+  findings.sort((a, b) => b.count - a.count);
+  return findings;
+}
+
+// src/mongoosleuth.ts
+var Mongoosleuth = class {
+  options;
+  /**
+   * Initializes a new instance of Mongoosleuth.
+   * @param options Configuration options.
+   */
+  constructor(options) {
+    const enabled = options?.enabled !== void 0 ? options.enabled : process.env.NODE_ENV !== "production";
+    const threshold = options?.threshold !== void 0 ? options.threshold : 3;
+    const captureStackTrace = options?.captureStackTrace !== void 0 ? options.captureStackTrace : true;
+    const ignore = options?.ignore || [];
+    const reporters = options?.reporters || [new ConsoleReporter()];
+    if (options?.threshold !== void 0 && options.threshold < 1) {
+      throw new Error(
+        `[mongoosleuth] Invalid threshold value: ${options.threshold}. Threshold must be >= 1.`
+      );
+    }
+    this.options = {
+      enabled,
+      threshold,
+      captureStackTrace,
+      ignore,
+      reporters
+    };
+  }
+  /**
+   * Patches the given Mongoose instance to intercept all query executions.
+   *
+   * @param mongooseInstance Mongoose library instance to attach to.
+   */
+  attach(mongooseInstance) {
+    attachInterceptor(mongooseInstance, this.options);
+  }
+  /**
+   * Internal helper to run query pattern analysis and trigger reporters.
+   */
+  analyzeAndReport(records) {
+    const findings = analyzeRecords(records, {
+      threshold: this.options.threshold
+    });
+    if (findings.length > 0) {
+      for (const reporter of this.options.reporters) {
+        reporter.report(findings);
+      }
+    }
+  }
+  /**
+   * Express/Koa/Fastify middleware that opens a RequestScope for each incoming request
+   * and runs pattern analysis upon request completion.
+   *
+   * @returns Request middleware function.
+   */
+  middleware() {
+    return (req, res, next) => {
+      if (!this.options.enabled) {
+        next();
+        return;
+      }
+      runInScope(async () => {
+        const store = getRawStore();
+        res.on("finish", () => {
+          const records = store ? Array.from(store.values()) : [];
+          this.analyzeAndReport(records);
+        });
+        next();
+      });
+    };
+  }
+  /**
+   * Manually runs a function within a new query tracking scope.
+   * Useful for background jobs, scripts, or manual request cycles outside standard middleware.
+   *
+   * @param fn The asynchronous function to execute within the scope.
+   */
+  async run(fn) {
+    if (!this.options.enabled) {
+      return fn();
+    }
+    let records;
+    try {
+      return await runInScope(async () => {
+        const store = getRawStore();
+        try {
+          return await fn();
+        } finally {
+          records = store ? Array.from(store.values()) : [];
+        }
+      });
+    } finally {
+      this.analyzeAndReport(records);
+    }
+  }
+};
+
+// src/reporters/json.ts
+var JsonReporter = class {
+  write;
+  /**
+   * Initializes a new instance of JsonReporter.
+   * @param write Optional callback function to write the JSON line. Defaults to console.log.
+   */
+  constructor(write) {
+    this.write = write || console.log;
+  }
+  /**
+   * Serializes the findings to JSON lines and writes them using the write handler.
+   * @param findings The list of findings to serialize and report.
+   */
+  report(findings) {
+    if (findings.length === 0) {
+      return;
+    }
+    for (const finding of findings) {
+      const output = {
+        type: "mongoosleuth_finding",
+        timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+        ...finding
+      };
+      this.write(JSON.stringify(output));
+    }
+  }
+};
+export {
+  ConsoleReporter,
+  JsonReporter,
+  Mongoosleuth
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/reporters/format-finding.ts","../src/reporters/console.ts","../src/scope.ts","../src/fingerprint.ts","../src/interceptor.ts","../src/analyzer.ts","../src/mongoosleuth.ts","../src/reporters/json.ts"],"sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { Finding } from '../types';\n\n/**\n * Helper to recursively format a parsed shape value into a JS-like object literal notation.\n * Strips quotes from keys and type tag values (e.g. <ObjectId>).\n */\nfunction renderVal(val: any): string {\n  if (val === null) {\n    return '<null>';\n  }\n  if (val === undefined) {\n    return '<undefined>';\n  }\n\n  if (typeof val === 'string') {\n    if (val.startsWith('<') && val.endsWith('>')) {\n      return val;\n    }\n    return `\"${val}\"`;\n  }\n\n  if (Array.isArray(val)) {\n    if (val.length === 0) {\n      return '[]';\n    }\n    return `[${renderVal(val[0])}]`;\n  }\n\n  if (typeof val === 'object') {\n    const keys = Object.keys(val);\n    if (keys.length === 0) {\n      return '{}';\n    }\n    const entries = keys.map((key) => `${key}: ${renderVal(val[key])}`);\n    return `{ ${entries.join(', ')} }`;\n  }\n\n  return String(val);\n}\n\n/**\n * Extracts and parses the JSON shape from a fingerprint.\n *\n * @param finding The N+1 query finding.\n * @returns Parsed shape object or {} if parsing fails.\n */\nexport function extractQueryShape(finding: Finding): Record<string, any> {\n  const prefix = `${finding.model}:${finding.operation}:`;\n  if (!finding.fingerprint || !finding.fingerprint.startsWith(prefix)) {\n    return {};\n  }\n  const jsonShapeStr = finding.fingerprint.slice(prefix.length);\n  try {\n    return JSON.parse(jsonShapeStr);\n  } catch {\n    return {};\n  }\n}\n\n/**\n * Formats the query line in the format: operation({ key1: value1, key2: value2 }).\n *\n * @param finding The N+1 query finding.\n * @returns Formatted query execution line.\n */\nexport function formatQueryLine(finding: Finding): string {\n  const shape = extractQueryShape(finding);\n  const keys = Object.keys(shape);\n  if (keys.length === 0) {\n    return `${finding.operation}({})`;\n  }\n  return `${finding.operation}(${renderVal(shape)})`;\n}\n\n/**\n * Suggests an N+1 query fix based on the operation.\n *\n * @param finding The N+1 query finding.\n * @returns Suggestion text.\n */\nexport function suggestFix(finding: Finding): string {\n  const op = finding.operation;\n  if (op === 'find' || op === 'findOne' || op === 'findById') {\n    return 'use .populate() or batch this with a single query using $in';\n  }\n  return 'consider batching this operation instead of calling it in a loop (e.g. bulkWrite)';\n}\n","import { Finding, Reporter } from '../types';\nimport { formatQueryLine, suggestFix } from './format-finding';\n\n/**\n * Default reporter that prints query N+1 findings to console.warn.\n * See AGENTS.md: Reporter.\n */\nexport class ConsoleReporter implements Reporter {\n  /**\n   * Reports the identified N+1 query findings.\n   * @param findings The list of findings to report.\n   */\n  public report(findings: Finding[]): void {\n    if (findings.length === 0) {\n      return;\n    }\n\n    for (const finding of findings) {\n      console.warn(`[mongoosleuth] N+1 detected\n  model: ${finding.model}\n  query: ${formatQueryLine(finding)}\n  called ${finding.count} times in ${finding.callSite}\n  fix: ${suggestFix(finding)}`);\n    }\n  }\n}\n","import { AsyncLocalStorage } from 'node:async_hooks';\n\n/**\n * Represents a recorded query within a tracking scope.\n */\nexport interface QueryRecord {\n  model: string;\n  operation: string;\n  fingerprint: string;\n  callSite: string;\n  count: number;\n}\n\n// Thread-safe request/execution context isolation for queries\nconst storage = new AsyncLocalStorage<Map<string, QueryRecord>>();\n\n/**\n * Opens a new query tracking scope for the duration of the asynchronous function `fn`.\n *\n * @param fn The asynchronous function to execute within the scope.\n * @returns The resolved/rejected promise value of `fn`.\n */\nexport function runInScope<T>(fn: () => Promise<T>): Promise<T> {\n  const scopeMap = new Map<string, QueryRecord>();\n  return storage.run(scopeMap, fn);\n}\n\n/**\n * Records an intercepted query into the active scope, if one is active.\n * If called outside of an active scope, it silently does nothing.\n *\n * @param entry The query details to record.\n */\nexport function recordQuery(entry: {\n  model: string;\n  operation: string;\n  fingerprint: string;\n  callSite: string;\n}): void {\n  const store = storage.getStore();\n  if (!store) {\n    return;\n  }\n\n  const key = `${entry.fingerprint}::${entry.callSite}`;\n  const existing = store.get(key);\n\n  if (existing) {\n    existing.count++;\n  } else {\n    store.set(key, {\n      model: entry.model,\n      operation: entry.operation,\n      fingerprint: entry.fingerprint,\n      callSite: entry.callSite,\n      count: 1,\n    });\n  }\n}\n\n/**\n * Returns all recorded queries inside the currently active scope as an array.\n * Returns `undefined` if called outside any active scope.\n *\n * @returns Array of QueryRecord objects or undefined.\n */\nexport function getActiveRecords(): QueryRecord[] | undefined {\n  const store = storage.getStore();\n  if (!store) {\n    return undefined;\n  }\n  return Array.from(store.values());\n}\n\n/**\n * Returns the raw Map store of the active scope.\n * Internal utility to capture the store reference across asynchronous boundaries.\n *\n * @returns The active Map store or undefined.\n */\nexport function getRawStore(): Map<string, QueryRecord> | undefined {\n  return storage.getStore();\n}\n","/**\n * Checks if a value behaves like a MongoDB/Mongoose ObjectId.\n * Since this module is pure, it does not import from mongoose.\n */\nfunction isObjectId(val: unknown): boolean {\n  if (!val || typeof val !== 'object') return false;\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const anyVal = val as any;\n  if (anyVal._bsontype === 'ObjectID') return true;\n  if (\n    anyVal.constructor &&\n    (anyVal.constructor.name === 'ObjectId' || anyVal.constructor.name === 'ObjectID')\n  ) {\n    return true;\n  }\n  if (typeof anyVal.toHexString === 'function') return true;\n  return false;\n}\n\n/**\n * Recursively normalizes a query filter value into its shape representation.\n */\nfunction normalizeValue(val: unknown): unknown {\n  if (val === null) return '<null>';\n  if (val === undefined) return '<undefined>';\n\n  if (isObjectId(val)) {\n    return '<ObjectId>';\n  }\n  if (val instanceof Date) {\n    return '<Date>';\n  }\n  if (val instanceof RegExp) {\n    return '<RegExp>';\n  }\n  if (typeof val === 'string') {\n    return '<string>';\n  }\n  if (typeof val === 'number') {\n    return '<number>';\n  }\n  if (typeof val === 'boolean') {\n    return '<boolean>';\n  }\n  if (Array.isArray(val)) {\n    if (val.length === 0) {\n      return '<empty array>';\n    }\n    // Normalize using only the shape of the first element\n    return [normalizeValue(val[0])];\n  }\n  if (typeof val === 'object') {\n    // If it's a plain object (or behaves like one), recurse\n    const result: Record<string, unknown> = {};\n    for (const key of Object.keys(val as Record<string, unknown>)) {\n      result[key] = normalizeValue((val as Record<string, unknown>)[key]);\n    }\n    return result;\n  }\n  return `<${typeof val}>`;\n}\n\n/**\n * Recursively sorts keys of an object alphabetically.\n */\nfunction sortObjectKeys(val: unknown): unknown {\n  if (val === null || val === undefined || typeof val !== 'object') {\n    return val;\n  }\n  if (Array.isArray(val)) {\n    return val.map(sortObjectKeys);\n  }\n  const sortedObj: Record<string, unknown> = {};\n  const keys = Object.keys(val as Record<string, unknown>).sort();\n  for (const key of keys) {\n    sortedObj[key] = sortObjectKeys((val as Record<string, unknown>)[key]);\n  }\n  return sortedObj;\n}\n\n/**\n * Normalizes a query filter object, replacing primitive leaf values with type tags (e.g., '<string>', '<ObjectId>').\n * Keeps object keys and nesting structure intact. For arrays, uses the shape of the first element.\n *\n * See AGENTS.md: fingerprinting rules.\n *\n * @param filter The raw Mongoose query filter object.\n * @returns The normalized filter shape.\n */\nexport function normalizeFilterShape(filter: Record<string, unknown>): Record<string, unknown> {\n  if (!filter || typeof filter !== 'object' || Array.isArray(filter)) {\n    return {};\n  }\n  return normalizeValue(filter) as Record<string, unknown>;\n}\n\n/**\n * Builds a query fingerprint string in the format \"${modelName}:${operation}:${normalizedFilterShape}\".\n *\n * @param modelName Name of the Mongoose model.\n * @param operation Name of the query operation (e.g., find, findOne).\n * @param filter The query filter object.\n * @returns A unique fingerprint string representing the query template.\n */\nexport function buildFingerprint(\n  modelName: string,\n  operation: string,\n  filter: Record<string, unknown>\n): string {\n  const normalized = normalizeFilterShape(filter);\n  const sorted = sortObjectKeys(normalized);\n  return `${modelName}:${operation}:${JSON.stringify(sorted)}`;\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { MongoosleuthOptions } from './types';\nimport { buildFingerprint } from './fingerprint';\nimport { recordQuery } from './scope';\n\n// Global reference to the original Mongoose Query.prototype.exec function\nlet originalExec: any = null;\n\n/**\n * Extracts and formats the relative callsite from a stack trace string.\n * Filters out internal library frames from mongoose and mongoosleuth.\n *\n * @param stack Raw stack trace string from Error().stack.\n * @returns Formatted \"file:line\" string or \"unknown\".\n */\nexport function buildCallSite(stack: string): string {\n  const lines = stack.split('\\n');\n\n  // Regular expression to identify internal library frames that should be skipped\n  const isInternal =\n    /node_modules[\\\\/]mongoose[\\\\/]|node_modules[\\\\/]mongoosleuth[\\\\/]|[\\\\/]mongoosleuth[\\\\/]src[\\\\/]|[\\\\/]mongoosleuth[\\\\/]dist[\\\\/]|[\\\\/]src[\\\\/](?:interceptor|scope|mongoosleuth|fingerprint|analyzer)\\.ts/i;\n\n  for (const line of lines) {\n    if (!line.includes('at ')) {\n      continue;\n    }\n\n    if (isInternal.test(line)) {\n      continue;\n    }\n\n    // Extract path between parentheses or directly after 'at '\n    const parenMatch = line.match(/\\(([^)]+)\\)/);\n    const pathStr = parenMatch ? parenMatch[1] : line.trim().slice(3); // strip \"at \"\n\n    // Normalize backslashes to forward slashes for cross-platform consistency\n    let normalizedPath = pathStr.replace(/\\\\/g, '/');\n    const cwd = process.cwd().replace(/\\\\/g, '/');\n\n    // Make path relative to the current working directory\n    if (normalizedPath.toLowerCase().startsWith(cwd.toLowerCase() + '/')) {\n      normalizedPath = normalizedPath.slice(cwd.length + 1);\n    }\n\n    // Capture file path and line number, discarding column info\n    const cleanMatch = normalizedPath.match(/^(.*?):(\\d+)(:\\d+)?$/);\n    if (cleanMatch) {\n      return `${cleanMatch[1]}:${cleanMatch[2]}`;\n    }\n  }\n\n  return 'unknown';\n}\n\n/**\n * Patches mongoose.Query.prototype.exec once to intercept executed queries.\n * Fingerprints and records each query into the active RequestScope.\n *\n * See AGENTS.md: QueryInterceptor.\n *\n * @param mongooseInstance The Mongoose instance to patch.\n * @param options Mongoosleuth options (e.g. threshold, captureStackTrace).\n */\nexport function attachInterceptor(mongooseInstance: any, options: MongoosleuthOptions): void {\n  if (!mongooseInstance || !mongooseInstance.Query || !mongooseInstance.Query.prototype) {\n    return;\n  }\n\n  // Ensure idempotency\n  if (\n    mongooseInstance.Query.prototype.exec &&\n    mongooseInstance.Query.prototype.exec.__mongoosleuthPatched\n  ) {\n    console.warn('[mongoosleuth] already attached, skipping');\n    return;\n  }\n\n  // Store reference to the original function for restoration\n  originalExec = mongooseInstance.Query.prototype.exec;\n\n  // Capture options by value (closure)\n  const enabled = options.enabled !== false;\n  const captureStackTrace = options.captureStackTrace !== false;\n  const ignore = options.ignore || [];\n\n  const patchedExec = function (this: any, ...args: any[]) {\n    if (!enabled) {\n      return originalExec.apply(this, args);\n    }\n\n    const modelName = this.model?.modelName;\n    const operation = this.op;\n\n    if (!modelName || !operation) {\n      return originalExec.apply(this, args);\n    }\n\n    // Check if the current model and operation should be ignored\n    const isIgnored = ignore.some((entry) => {\n      const matchModel = !entry.model || entry.model === modelName;\n      const matchOp = !entry.operation || entry.operation === operation;\n      return matchModel && matchOp;\n    });\n\n    if (isIgnored) {\n      return originalExec.apply(this, args);\n    }\n\n    const filter = this.getQuery() || {};\n    const fingerprint = buildFingerprint(modelName, operation, filter);\n\n    let callSite = 'unknown';\n    if (captureStackTrace) {\n      const stack = new Error().stack;\n      if (stack) {\n        callSite = buildCallSite(stack);\n      }\n    }\n\n    recordQuery({\n      model: modelName,\n      operation,\n      fingerprint,\n      callSite,\n    });\n\n    return originalExec.apply(this, args);\n  };\n\n  // Add the marker flag to ensure idempotency\n  (patchedExec as any).__mongoosleuthPatched = true;\n\n  // Overwrite prototype exec\n  mongooseInstance.Query.prototype.exec = patchedExec;\n}\n\n/**\n * Resets the patched Mongoose Query.prototype.exec back to its original state.\n * Internal-only utility for test cleanups.\n *\n * @param mongooseInstance Mongoose instance to reset.\n */\nexport function __resetForTests(mongooseInstance: any): void {\n  if (\n    mongooseInstance &&\n    mongooseInstance.Query &&\n    mongooseInstance.Query.prototype &&\n    originalExec\n  ) {\n    mongooseInstance.Query.prototype.exec = originalExec;\n    originalExec = null;\n  }\n}\n","import type { QueryRecord } from './scope';\nimport type { Finding } from './types';\n\n/**\n * Analyzes recorded queries and maps them to public N+1 query findings.\n * Filters out query records whose count is below the specified threshold.\n *\n * This function is pure and side-effect free.\n * See AGENTS.md: PatternAnalyzer.\n *\n * @param records List of recorded queries from the active scope, or undefined if outside scope.\n * @param options Analyzer options (containing threshold).\n * @returns Array of N+1 query findings.\n */\nexport function analyzeRecords(\n  records: QueryRecord[] | undefined,\n  options: { threshold: number }\n): Finding[] {\n  if (!records) {\n    return [];\n  }\n\n  // Filter records with count >= threshold and map to Finding structure\n  const findings: Finding[] = records\n    .filter((r) => r.count >= options.threshold)\n    .map((r) => ({\n      model: r.model,\n      operation: r.operation,\n      fingerprint: r.fingerprint,\n      count: r.count,\n      callSite: r.callSite,\n    }));\n\n  // Sort descending by count only (stable sort by default)\n  findings.sort((a, b) => b.count - a.count);\n\n  return findings;\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { MongoosleuthOptions } from './types';\nimport { ConsoleReporter } from './reporters/console';\nimport { runInScope, getRawStore } from './scope';\nimport { attachInterceptor } from './interceptor';\nimport { analyzeRecords } from './analyzer';\n\n/**\n * The main Mongoosleuth library class.\n * Coordinates intercepting queries, request-scoped tracking, and analyzing/reporting.\n *\n * See AGENTS.md: Public API surface.\n */\nexport class Mongoosleuth {\n  public readonly options: Required<MongoosleuthOptions>;\n\n  /**\n   * Initializes a new instance of Mongoosleuth.\n   * @param options Configuration options.\n   */\n  constructor(options?: MongoosleuthOptions) {\n    const enabled =\n      options?.enabled !== undefined ? options.enabled : process.env.NODE_ENV !== 'production';\n    const threshold = options?.threshold !== undefined ? options.threshold : 3;\n    const captureStackTrace =\n      options?.captureStackTrace !== undefined ? options.captureStackTrace : true;\n    const ignore = options?.ignore || [];\n    const reporters = options?.reporters || [new ConsoleReporter()];\n\n    if (options?.threshold !== undefined && options.threshold < 1) {\n      throw new Error(\n        `[mongoosleuth] Invalid threshold value: ${options.threshold}. Threshold must be >= 1.`\n      );\n    }\n\n    this.options = {\n      enabled,\n      threshold,\n      captureStackTrace,\n      ignore,\n      reporters,\n    };\n  }\n\n  /**\n   * Patches the given Mongoose instance to intercept all query executions.\n   *\n   * @param mongooseInstance Mongoose library instance to attach to.\n   */\n  public attach(mongooseInstance: any): void {\n    attachInterceptor(mongooseInstance, this.options);\n  }\n\n  /**\n   * Internal helper to run query pattern analysis and trigger reporters.\n   */\n  private analyzeAndReport(records: any[] | undefined): void {\n    const findings = analyzeRecords(records, {\n      threshold: this.options.threshold,\n    });\n    if (findings.length > 0) {\n      for (const reporter of this.options.reporters) {\n        reporter.report(findings);\n      }\n    }\n  }\n\n  /**\n   * Express/Koa/Fastify middleware that opens a RequestScope for each incoming request\n   * and runs pattern analysis upon request completion.\n   *\n   * @returns Request middleware function.\n   */\n  public middleware(): (req: any, res: any, next: (err?: any) => void) => void {\n    return (req: any, res: any, next: (err?: any) => void) => {\n      if (!this.options.enabled) {\n        next();\n        return;\n      }\n\n      runInScope(async () => {\n        const store = getRawStore();\n        res.on('finish', () => {\n          const records = store ? Array.from(store.values()) : [];\n          this.analyzeAndReport(records);\n        });\n        next();\n      });\n    };\n  }\n\n  /**\n   * Manually runs a function within a new query tracking scope.\n   * Useful for background jobs, scripts, or manual request cycles outside standard middleware.\n   *\n   * @param fn The asynchronous function to execute within the scope.\n   */\n  public async run<T>(fn: () => Promise<T>): Promise<T> {\n    if (!this.options.enabled) {\n      return fn();\n    }\n\n    let records: any[] | undefined;\n    try {\n      return await runInScope(async () => {\n        const store = getRawStore();\n        try {\n          return await fn();\n        } finally {\n          records = store ? Array.from(store.values()) : [];\n        }\n      });\n    } finally {\n      this.analyzeAndReport(records);\n    }\n  }\n}\n","import { Finding, Reporter } from '../types';\n\n/**\n * Pluggable reporter that outputs query N+1 findings as a single-line JSON string (NDJSON format).\n * See AGENTS.md: Reporter.\n */\nexport class JsonReporter implements Reporter {\n  private write: (line: string) => void;\n\n  /**\n   * Initializes a new instance of JsonReporter.\n   * @param write Optional callback function to write the JSON line. Defaults to console.log.\n   */\n  constructor(write?: (line: string) => void) {\n    this.write = write || console.log;\n  }\n\n  /**\n   * Serializes the findings to JSON lines and writes them using the write handler.\n   * @param findings The list of findings to serialize and report.\n   */\n  public report(findings: Finding[]): void {\n    if (findings.length === 0) {\n      return;\n    }\n\n    for (const finding of findings) {\n      const output = {\n        type: 'mongoosleuth_finding',\n        timestamp: new Date().toISOString(),\n        ...finding,\n      };\n      this.write(JSON.stringify(output));\n    }\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "mongoosleuth",
+  "version": "0.1.0",
+  "description": "N+1 query pattern detector for Mongoose",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "lint": "eslint \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\""
+  },
+  "keywords": [
+    "mongoose",
+    "mongodb",
+    "n+1",
+    "n1",
+    "detector",
+    "profiler",
+    "performance"
+  ],
+  "author": "",
+  "license": "MIT",
+  "peerDependencies": {
+    "mongoose": "^7.0.0 || ^8.0.0"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.6",
+    "@types/node": "^20.0.0",
+    "@types/supertest": "^7.2.0",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "eslint": "^8.56.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.1.3",
+    "express": "^5.2.1",
+    "mongodb-memory-server": "^9.0.0",
+    "mongoose": "^8.0.0",
+    "prettier": "^3.2.5",
+    "supertest": "^7.2.2",
+    "tsup": "^8.0.2",
+    "typescript": "^5.3.3",
+    "vitest": "^4.1.9"
+  }
+}