guardian-risk-logger 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guardian Contributors
+
+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 @@
+# guardian-risk-logger
+
+> **Requires:** [`guardian-risk`](https://www.npmjs.com/package/guardian-risk) (core)
+
+```bash
+npm install guardian-risk guardian-risk-logger
+```
+
+> **Stub package** — API may change before `1.0.0`.
+
+Audit logging for [guardian-risk](https://www.npmjs.com/package/guardian-risk). Records risk reports, matched rules, and scores for compliance and debugging.
+
+## What gets logged
+
+| Field | Source |
+|-------|--------|
+| `score` | `report.score` |
+| `riskLevel` | `report.level` |
+| `matchedRules` | Count and details from `report.matchedRules` |
+| `reasons` | `report.reasons` |
+| `analyzedAt` | `report.analyzedAt` |
+
+## Usage (stub)
+
+```typescript
+import { Guardian } from 'guardian-risk';
+import { loggerPlugin, analyzeAndLog } from 'guardian-risk-logger';
+import { vpnPlugin } from 'guardian-risk-vpn';
+
+const guardian = new Guardian()
+  .use(loggerPlugin({ level: 'info', minScore: 20 }))
+  .use(vpnPlugin());
+
+guardian.signal('vpn', true);
+
+const report = analyzeAndLog(guardian, { minScore: 0 });
+```
+
+## Custom sink
+
+```typescript
+import { loggerPlugin, logReport, type LogSink } from 'guardian-risk-logger';
+
+const sink: LogSink = {
+  write(entry) {
+    // Send to Datadog, CloudWatch, file, etc.
+    myAuditService.record(entry);
+  },
+};
+
+const guardian = new Guardian().use(loggerPlugin({ sink }));
+const report = guardian.analyze();
+logReport(report, { sink });
+```
+
+## Status
+
+Not yet published. Implementation in progress.

package/dist/index.cjs

@@ -0,0 +1,67 @@
+'use strict';
+
+// src/index.ts
+var LEVEL_ORDER = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+var defaultSink = {
+  write(entry) {
+    const payload = JSON.stringify({
+      level: entry.level,
+      message: entry.message,
+      score: entry.report.score,
+      riskLevel: entry.report.level,
+      matchedRules: entry.report.matchedRules.length,
+      timestamp: entry.timestamp
+    });
+    console.log(`[guardian-risk] ${payload}`);
+  }
+};
+function loggerPlugin(options = {}) {
+  const { level = "info", sink = defaultSink, minScore = 0 } = options;
+  return {
+    name: "guardian-risk-logger",
+    install(_guardian) {
+    }
+  };
+}
+function logReport(report, options = {}) {
+  const { level = "info", sink = defaultSink, minScore = 0 } = options;
+  if (report.score < minScore) {
+    return;
+  }
+  const entryLevel = resolveLogLevel(report, level);
+  sink.write({
+    level: entryLevel,
+    message: `Risk analysis complete: ${report.level} (${report.score})`,
+    report,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  });
+}
+function analyzeAndLog(guardian, options = {}) {
+  const report = guardian.analyze();
+  logReport(report, options);
+  return report;
+}
+function resolveLogLevel(report, configured) {
+  if (report.level === "CRITICAL") {
+    return "error";
+  }
+  if (report.level === "HIGH") {
+    return "warn";
+  }
+  return configured;
+}
+function shouldLog(configured, actual) {
+  return LEVEL_ORDER[actual] >= LEVEL_ORDER[configured];
+}
+
+exports.analyzeAndLog = analyzeAndLog;
+exports.logReport = logReport;
+exports.loggerPlugin = loggerPlugin;
+exports.shouldLog = shouldLog;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;AA4BA,IAAM,WAAA,GAAwC;AAAA,EAC5C,KAAA,EAAO,CAAA;AAAA,EACP,IAAA,EAAM,CAAA;AAAA,EACN,IAAA,EAAM,CAAA;AAAA,EACN,KAAA,EAAO;AACT,CAAA;AAEA,IAAM,WAAA,GAAuB;AAAA,EAC3B,MAAM,KAAA,EAAa;AACjB,IAAA,MAAM,OAAA,GAAU,KAAK,SAAA,CAAU;AAAA,MAC7B,OAAO,KAAA,CAAM,KAAA;AAAA,MACb,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,KAAA,EAAO,MAAM,MAAA,CAAO,KAAA;AAAA,MACpB,SAAA,EAAW,MAAM,MAAA,CAAO,KAAA;AAAA,MACxB,YAAA,EAAc,KAAA,CAAM,MAAA,CAAO,YAAA,CAAa,MAAA;AAAA,MACxC,WAAW,KAAA,CAAM;AAAA,KAClB,CAAA;AACD,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,gBAAA,EAAmB,OAAO,CAAA,CAAE,CAAA;AAAA,EAC1C;AACF,CAAA;AAQO,SAAS,YAAA,CAAa,OAAA,GAA+B,EAAC,EAAW;AACtE,EAAA,MAAM,EAAE,KAAA,GAAQ,MAAA,EAAQ,OAAO,WAAA,EAAa,QAAA,GAAW,GAAE,GAAI,OAAA;AAE7D,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,sBAAA;AAAA,IACN,QAAQ,SAAA,EAAW;AAGZ,IAEP;AAAA,GACF;AACF;AAKO,SAAS,SAAA,CACd,MAAA,EACA,OAAA,GAA+B,EAAC,EAC1B;AACN,EAAA,MAAM,EAAE,KAAA,GAAQ,MAAA,EAAQ,OAAO,WAAA,EAAa,QAAA,GAAW,GAAE,GAAI,OAAA;AAE7D,EAAA,IAAI,MAAA,CAAO,QAAQ,QAAA,EAAU;AAC3B,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,UAAA,GAAa,eAAA,CAAgB,MAAA,EAAQ,KAAK,CAAA;AAEhD,EAAA,IAAA,CAAK,KAAA,CAAM;AAAA,IACT,KAAA,EAAO,UAAA;AAAA,IACP,SAAS,CAAA,wBAAA,EAA2B,MAAA,CAAO,KAAK,CAAA,EAAA,EAAK,OAAO,KAAK,CAAA,CAAA,CAAA;AAAA,IACjE,MAAA;AAAA,IACA,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,GACnC,CAAA;AACH;AAKO,SAAS,aAAA,CACd,QAAA,EACA,OAAA,GAA+B,EAAC,EACpB;AACZ,EAAA,MAAM,MAAA,GAAS,SAAS,OAAA,EAAQ;AAChC,EAAA,SAAA,CAAU,QAAQ,OAAO,CAAA;AACzB,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,eAAA,CAAgB,QAAoB,UAAA,EAAgC;AAC3E,EAAA,IAAI,MAAA,CAAO,UAAU,UAAA,EAAY;AAC/B,IAAA,OAAO,OAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,CAAO,UAAU,MAAA,EAAQ;AAC3B,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,UAAA;AACT;AAEA,SAAS,SAAA,CAAU,YAAsB,MAAA,EAA2B;AAClE,EAAA,OAAO,WAAA,CAAY,MAAM,CAAA,IAAK,WAAA,CAAY,UAAU,CAAA;AACtD","file":"index.cjs","sourcesContent":["import type { Plugin, RiskReport } from 'guardian-risk';\n\n/** Log severity level. */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/** Sink that receives structured log entries. */\nexport interface LogSink {\n  write(entry: LogEntry): void;\n}\n\n/** Structured log entry for a risk analysis. */\nexport interface LogEntry {\n  readonly level: LogLevel;\n  readonly message: string;\n  readonly report: RiskReport;\n  readonly timestamp: string;\n}\n\n/** Options for the logger plugin (stub). */\nexport interface LoggerPluginOptions {\n  /** Minimum level to emit. */\n  readonly level?: LogLevel;\n  /** Custom sink. Defaults to console. */\n  readonly sink?: LogSink;\n  /** Log only when score exceeds this threshold. */\n  readonly minScore?: number;\n}\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nconst defaultSink: LogSink = {\n  write(entry): void {\n    const payload = JSON.stringify({\n      level: entry.level,\n      message: entry.message,\n      score: entry.report.score,\n      riskLevel: entry.report.level,\n      matchedRules: entry.report.matchedRules.length,\n      timestamp: entry.timestamp,\n    });\n    console.log(`[guardian-risk] ${payload}`);\n  },\n};\n\n/**\n * Logger plugin for guardian-risk.\n *\n * @stub Future versions will hook into analyze() automatically.\n * For now, use `logReport()` after `guardian.analyze()`.\n */\nexport function loggerPlugin(options: LoggerPluginOptions = {}): Plugin {\n  const { level = 'info', sink = defaultSink, minScore = 0 } = options;\n\n  return {\n    name: 'guardian-risk-logger',\n    install(_guardian) {\n      void level;\n      void sink;\n      void minScore;\n      // Stub: will wrap analyze() and emit audit logs automatically\n    },\n  };\n}\n\n/**\n * Log a risk report to the configured sink.\n */\nexport function logReport(\n  report: RiskReport,\n  options: LoggerPluginOptions = {},\n): void {\n  const { level = 'info', sink = defaultSink, minScore = 0 } = options;\n\n  if (report.score < minScore) {\n    return;\n  }\n\n  const entryLevel = resolveLogLevel(report, level);\n\n  sink.write({\n    level: entryLevel,\n    message: `Risk analysis complete: ${report.level} (${report.score})`,\n    report,\n    timestamp: new Date().toISOString(),\n  });\n}\n\n/**\n * Analyze and log in one step.\n */\nexport function analyzeAndLog(\n  guardian: import('guardian-risk').Guardian,\n  options: LoggerPluginOptions = {},\n): RiskReport {\n  const report = guardian.analyze();\n  logReport(report, options);\n  return report;\n}\n\nfunction resolveLogLevel(report: RiskReport, configured: LogLevel): LogLevel {\n  if (report.level === 'CRITICAL') {\n    return 'error';\n  }\n  if (report.level === 'HIGH') {\n    return 'warn';\n  }\n  return configured;\n}\n\nfunction shouldLog(configured: LogLevel, actual: LogLevel): boolean {\n  return LEVEL_ORDER[actual] >= LEVEL_ORDER[configured];\n}\n\nexport { shouldLog };\n"]}

package/dist/index.d.cts

@@ -0,0 +1,43 @@
+import * as guardian_risk from 'guardian-risk';
+import { RiskReport, Plugin } from 'guardian-risk';
+
+/** Log severity level. */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/** Sink that receives structured log entries. */
+interface LogSink {
+    write(entry: LogEntry): void;
+}
+/** Structured log entry for a risk analysis. */
+interface LogEntry {
+    readonly level: LogLevel;
+    readonly message: string;
+    readonly report: RiskReport;
+    readonly timestamp: string;
+}
+/** Options for the logger plugin (stub). */
+interface LoggerPluginOptions {
+    /** Minimum level to emit. */
+    readonly level?: LogLevel;
+    /** Custom sink. Defaults to console. */
+    readonly sink?: LogSink;
+    /** Log only when score exceeds this threshold. */
+    readonly minScore?: number;
+}
+/**
+ * Logger plugin for guardian-risk.
+ *
+ * @stub Future versions will hook into analyze() automatically.
+ * For now, use `logReport()` after `guardian.analyze()`.
+ */
+declare function loggerPlugin(options?: LoggerPluginOptions): Plugin;
+/**
+ * Log a risk report to the configured sink.
+ */
+declare function logReport(report: RiskReport, options?: LoggerPluginOptions): void;
+/**
+ * Analyze and log in one step.
+ */
+declare function analyzeAndLog(guardian: guardian_risk.Guardian, options?: LoggerPluginOptions): RiskReport;
+declare function shouldLog(configured: LogLevel, actual: LogLevel): boolean;
+
+export { type LogEntry, type LogLevel, type LogSink, type LoggerPluginOptions, analyzeAndLog, logReport, loggerPlugin, shouldLog };

package/dist/index.d.ts

@@ -0,0 +1,43 @@
+import * as guardian_risk from 'guardian-risk';
+import { RiskReport, Plugin } from 'guardian-risk';
+
+/** Log severity level. */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error';
+/** Sink that receives structured log entries. */
+interface LogSink {
+    write(entry: LogEntry): void;
+}
+/** Structured log entry for a risk analysis. */
+interface LogEntry {
+    readonly level: LogLevel;
+    readonly message: string;
+    readonly report: RiskReport;
+    readonly timestamp: string;
+}
+/** Options for the logger plugin (stub). */
+interface LoggerPluginOptions {
+    /** Minimum level to emit. */
+    readonly level?: LogLevel;
+    /** Custom sink. Defaults to console. */
+    readonly sink?: LogSink;
+    /** Log only when score exceeds this threshold. */
+    readonly minScore?: number;
+}
+/**
+ * Logger plugin for guardian-risk.
+ *
+ * @stub Future versions will hook into analyze() automatically.
+ * For now, use `logReport()` after `guardian.analyze()`.
+ */
+declare function loggerPlugin(options?: LoggerPluginOptions): Plugin;
+/**
+ * Log a risk report to the configured sink.
+ */
+declare function logReport(report: RiskReport, options?: LoggerPluginOptions): void;
+/**
+ * Analyze and log in one step.
+ */
+declare function analyzeAndLog(guardian: guardian_risk.Guardian, options?: LoggerPluginOptions): RiskReport;
+declare function shouldLog(configured: LogLevel, actual: LogLevel): boolean;
+
+export { type LogEntry, type LogLevel, type LogSink, type LoggerPluginOptions, analyzeAndLog, logReport, loggerPlugin, shouldLog };

package/dist/index.js

@@ -0,0 +1,62 @@
+// src/index.ts
+var LEVEL_ORDER = {
+  debug: 0,
+  info: 1,
+  warn: 2,
+  error: 3
+};
+var defaultSink = {
+  write(entry) {
+    const payload = JSON.stringify({
+      level: entry.level,
+      message: entry.message,
+      score: entry.report.score,
+      riskLevel: entry.report.level,
+      matchedRules: entry.report.matchedRules.length,
+      timestamp: entry.timestamp
+    });
+    console.log(`[guardian-risk] ${payload}`);
+  }
+};
+function loggerPlugin(options = {}) {
+  const { level = "info", sink = defaultSink, minScore = 0 } = options;
+  return {
+    name: "guardian-risk-logger",
+    install(_guardian) {
+    }
+  };
+}
+function logReport(report, options = {}) {
+  const { level = "info", sink = defaultSink, minScore = 0 } = options;
+  if (report.score < minScore) {
+    return;
+  }
+  const entryLevel = resolveLogLevel(report, level);
+  sink.write({
+    level: entryLevel,
+    message: `Risk analysis complete: ${report.level} (${report.score})`,
+    report,
+    timestamp: (/* @__PURE__ */ new Date()).toISOString()
+  });
+}
+function analyzeAndLog(guardian, options = {}) {
+  const report = guardian.analyze();
+  logReport(report, options);
+  return report;
+}
+function resolveLogLevel(report, configured) {
+  if (report.level === "CRITICAL") {
+    return "error";
+  }
+  if (report.level === "HIGH") {
+    return "warn";
+  }
+  return configured;
+}
+function shouldLog(configured, actual) {
+  return LEVEL_ORDER[actual] >= LEVEL_ORDER[configured];
+}
+
+export { analyzeAndLog, logReport, loggerPlugin, shouldLog };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";AA4BA,IAAM,WAAA,GAAwC;AAAA,EAC5C,KAAA,EAAO,CAAA;AAAA,EACP,IAAA,EAAM,CAAA;AAAA,EACN,IAAA,EAAM,CAAA;AAAA,EACN,KAAA,EAAO;AACT,CAAA;AAEA,IAAM,WAAA,GAAuB;AAAA,EAC3B,MAAM,KAAA,EAAa;AACjB,IAAA,MAAM,OAAA,GAAU,KAAK,SAAA,CAAU;AAAA,MAC7B,OAAO,KAAA,CAAM,KAAA;AAAA,MACb,SAAS,KAAA,CAAM,OAAA;AAAA,MACf,KAAA,EAAO,MAAM,MAAA,CAAO,KAAA;AAAA,MACpB,SAAA,EAAW,MAAM,MAAA,CAAO,KAAA;AAAA,MACxB,YAAA,EAAc,KAAA,CAAM,MAAA,CAAO,YAAA,CAAa,MAAA;AAAA,MACxC,WAAW,KAAA,CAAM;AAAA,KAClB,CAAA;AACD,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,gBAAA,EAAmB,OAAO,CAAA,CAAE,CAAA;AAAA,EAC1C;AACF,CAAA;AAQO,SAAS,YAAA,CAAa,OAAA,GAA+B,EAAC,EAAW;AACtE,EAAA,MAAM,EAAE,KAAA,GAAQ,MAAA,EAAQ,OAAO,WAAA,EAAa,QAAA,GAAW,GAAE,GAAI,OAAA;AAE7D,EAAA,OAAO;AAAA,IACL,IAAA,EAAM,sBAAA;AAAA,IACN,QAAQ,SAAA,EAAW;AAGZ,IAEP;AAAA,GACF;AACF;AAKO,SAAS,SAAA,CACd,MAAA,EACA,OAAA,GAA+B,EAAC,EAC1B;AACN,EAAA,MAAM,EAAE,KAAA,GAAQ,MAAA,EAAQ,OAAO,WAAA,EAAa,QAAA,GAAW,GAAE,GAAI,OAAA;AAE7D,EAAA,IAAI,MAAA,CAAO,QAAQ,QAAA,EAAU;AAC3B,IAAA;AAAA,EACF;AAEA,EAAA,MAAM,UAAA,GAAa,eAAA,CAAgB,MAAA,EAAQ,KAAK,CAAA;AAEhD,EAAA,IAAA,CAAK,KAAA,CAAM;AAAA,IACT,KAAA,EAAO,UAAA;AAAA,IACP,SAAS,CAAA,wBAAA,EAA2B,MAAA,CAAO,KAAK,CAAA,EAAA,EAAK,OAAO,KAAK,CAAA,CAAA,CAAA;AAAA,IACjE,MAAA;AAAA,IACA,SAAA,EAAA,iBAAW,IAAI,IAAA,EAAK,EAAE,WAAA;AAAY,GACnC,CAAA;AACH;AAKO,SAAS,aAAA,CACd,QAAA,EACA,OAAA,GAA+B,EAAC,EACpB;AACZ,EAAA,MAAM,MAAA,GAAS,SAAS,OAAA,EAAQ;AAChC,EAAA,SAAA,CAAU,QAAQ,OAAO,CAAA;AACzB,EAAA,OAAO,MAAA;AACT;AAEA,SAAS,eAAA,CAAgB,QAAoB,UAAA,EAAgC;AAC3E,EAAA,IAAI,MAAA,CAAO,UAAU,UAAA,EAAY;AAC/B,IAAA,OAAO,OAAA;AAAA,EACT;AACA,EAAA,IAAI,MAAA,CAAO,UAAU,MAAA,EAAQ;AAC3B,IAAA,OAAO,MAAA;AAAA,EACT;AACA,EAAA,OAAO,UAAA;AACT;AAEA,SAAS,SAAA,CAAU,YAAsB,MAAA,EAA2B;AAClE,EAAA,OAAO,WAAA,CAAY,MAAM,CAAA,IAAK,WAAA,CAAY,UAAU,CAAA;AACtD","file":"index.js","sourcesContent":["import type { Plugin, RiskReport } from 'guardian-risk';\n\n/** Log severity level. */\nexport type LogLevel = 'debug' | 'info' | 'warn' | 'error';\n\n/** Sink that receives structured log entries. */\nexport interface LogSink {\n  write(entry: LogEntry): void;\n}\n\n/** Structured log entry for a risk analysis. */\nexport interface LogEntry {\n  readonly level: LogLevel;\n  readonly message: string;\n  readonly report: RiskReport;\n  readonly timestamp: string;\n}\n\n/** Options for the logger plugin (stub). */\nexport interface LoggerPluginOptions {\n  /** Minimum level to emit. */\n  readonly level?: LogLevel;\n  /** Custom sink. Defaults to console. */\n  readonly sink?: LogSink;\n  /** Log only when score exceeds this threshold. */\n  readonly minScore?: number;\n}\n\nconst LEVEL_ORDER: Record<LogLevel, number> = {\n  debug: 0,\n  info: 1,\n  warn: 2,\n  error: 3,\n};\n\nconst defaultSink: LogSink = {\n  write(entry): void {\n    const payload = JSON.stringify({\n      level: entry.level,\n      message: entry.message,\n      score: entry.report.score,\n      riskLevel: entry.report.level,\n      matchedRules: entry.report.matchedRules.length,\n      timestamp: entry.timestamp,\n    });\n    console.log(`[guardian-risk] ${payload}`);\n  },\n};\n\n/**\n * Logger plugin for guardian-risk.\n *\n * @stub Future versions will hook into analyze() automatically.\n * For now, use `logReport()` after `guardian.analyze()`.\n */\nexport function loggerPlugin(options: LoggerPluginOptions = {}): Plugin {\n  const { level = 'info', sink = defaultSink, minScore = 0 } = options;\n\n  return {\n    name: 'guardian-risk-logger',\n    install(_guardian) {\n      void level;\n      void sink;\n      void minScore;\n      // Stub: will wrap analyze() and emit audit logs automatically\n    },\n  };\n}\n\n/**\n * Log a risk report to the configured sink.\n */\nexport function logReport(\n  report: RiskReport,\n  options: LoggerPluginOptions = {},\n): void {\n  const { level = 'info', sink = defaultSink, minScore = 0 } = options;\n\n  if (report.score < minScore) {\n    return;\n  }\n\n  const entryLevel = resolveLogLevel(report, level);\n\n  sink.write({\n    level: entryLevel,\n    message: `Risk analysis complete: ${report.level} (${report.score})`,\n    report,\n    timestamp: new Date().toISOString(),\n  });\n}\n\n/**\n * Analyze and log in one step.\n */\nexport function analyzeAndLog(\n  guardian: import('guardian-risk').Guardian,\n  options: LoggerPluginOptions = {},\n): RiskReport {\n  const report = guardian.analyze();\n  logReport(report, options);\n  return report;\n}\n\nfunction resolveLogLevel(report: RiskReport, configured: LogLevel): LogLevel {\n  if (report.level === 'CRITICAL') {\n    return 'error';\n  }\n  if (report.level === 'HIGH') {\n    return 'warn';\n  }\n  return configured;\n}\n\nfunction shouldLog(configured: LogLevel, actual: LogLevel): boolean {\n  return LEVEL_ORDER[actual] >= LEVEL_ORDER[configured];\n}\n\nexport { shouldLog };\n"]}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "guardian-risk-logger",
+  "version": "0.1.0",
+  "description": "Audit logging plugin for guardian-risk — logs reports and matched rules",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "guardian-risk",
+    "guardian-risk-logger",
+    "logger",
+    "audit",
+    "logging",
+    "risk",
+    "security"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/himanshu6306singh/guardian-risk.git",
+    "directory": "packages/logger"
+  },
+  "homepage": "https://github.com/himanshu6306singh/guardian-risk/tree/main/packages/logger#readme",
+  "bugs": {
+    "url": "https://github.com/himanshu6306singh/guardian-risk/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "guardian-risk": "^0.2.0"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "guardian-risk": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit"
+  }
+}