convex-audit-log 0.1.0

package/dist/react/index.d.ts

@@ -0,0 +1,247 @@
+import type { FunctionReference } from "convex/server";
+export type Severity = "info" | "warning" | "error" | "critical";
+export interface AuditLogEntry {
+    _id: string;
+    _creationTime: number;
+    action: string;
+    actorId?: string;
+    timestamp: number;
+    resourceType?: string;
+    resourceId?: string;
+    metadata?: unknown;
+    severity: Severity;
+    ipAddress?: string;
+    userAgent?: string;
+    sessionId?: string;
+    tags?: string[];
+    before?: unknown;
+    after?: unknown;
+    diff?: string;
+    retentionCategory?: string;
+}
+export interface AuditLogStats {
+    totalCount: number;
+    bySeverity: {
+        info: number;
+        warning: number;
+        error: number;
+        critical: number;
+    };
+    topActions: {
+        action: string;
+        count: number;
+    }[];
+    topActors: {
+        actorId: string;
+        count: number;
+    }[];
+}
+export interface Anomaly {
+    action: string;
+    count: number;
+    threshold: number;
+    windowMinutes: number;
+    detectedAt: number;
+}
+/**
+ * Hook to query audit logs by resource.
+ * Provides real-time updates when the audit log changes.
+ *
+ * @example
+ * ```tsx
+ * import { useAuditLogByResource } from "convex-audit-log/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function DocumentHistory({ documentId }: { documentId: string }) {
+ *   const logs = useAuditLogByResource(api.auditLog.queryByResource, {
+ *     resourceType: "documents",
+ *     resourceId: documentId,
+ *     limit: 20,
+ *   });
+ *
+ *   if (!logs) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <ul>
+ *       {logs.map((log) => (
+ *         <li key={log._id}>
+ *           {log.action} by {log.actorId} at {new Date(log.timestamp).toLocaleString()}
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAuditLogByResource(queryRef: FunctionReference<"query", "public", {
+    resourceType: string;
+    resourceId: string;
+    limit?: number;
+    fromTimestamp?: number;
+}, AuditLogEntry[]>, args: {
+    resourceType: string;
+    resourceId: string;
+    limit?: number;
+    fromTimestamp?: number;
+}): AuditLogEntry[] | undefined;
+/**
+ * Hook to query audit logs by actor (user).
+ *
+ * @example
+ * ```tsx
+ * import { useAuditLogByActor } from "convex-audit-log/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function UserActivity({ userId }: { userId: string }) {
+ *   const logs = useAuditLogByActor(api.auditLog.queryByActor, {
+ *     actorId: userId,
+ *     limit: 50,
+ *   });
+ *
+ *   if (!logs) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <ul>
+ *       {logs.map((log) => (
+ *         <li key={log._id}>{log.action}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAuditLogByActor(queryRef: FunctionReference<"query", "public", {
+    actorId: string;
+    limit?: number;
+    fromTimestamp?: number;
+    actions?: string[];
+}, AuditLogEntry[]>, args: {
+    actorId: string;
+    limit?: number;
+    fromTimestamp?: number;
+    actions?: string[];
+}): AuditLogEntry[] | undefined;
+/**
+ * Hook to watch critical events in real-time.
+ *
+ * @example
+ * ```tsx
+ * import { useWatchCriticalEvents } from "convex-audit-log/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function SecurityAlerts() {
+ *   const criticalEvents = useWatchCriticalEvents(api.auditLog.watchCritical, {
+ *     limit: 10,
+ *   });
+ *
+ *   if (!criticalEvents) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <div className="alerts">
+ *       {criticalEvents.map((event) => (
+ *         <div key={event._id} className={`alert alert-${event.severity}`}>
+ *           {event.action}
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useWatchCriticalEvents(queryRef: FunctionReference<"query", "public", {
+    severity?: Severity[];
+    limit?: number;
+}, AuditLogEntry[]>, args?: {
+    severity?: Severity[];
+    limit?: number;
+}): AuditLogEntry[] | undefined;
+/**
+ * Hook to get audit log statistics.
+ *
+ * @example
+ * ```tsx
+ * import { useAuditLogStats } from "convex-audit-log/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function Dashboard() {
+ *   const stats = useAuditLogStats(api.auditLog.getStats, {
+ *     fromTimestamp: Date.now() - 24 * 60 * 60 * 1000, // Last 24 hours
+ *   });
+ *
+ *   if (!stats) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <div>
+ *       <h2>Total Events: {stats.totalCount}</h2>
+ *       <div>Critical: {stats.bySeverity.critical}</div>
+ *       <div>Errors: {stats.bySeverity.error}</div>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAuditLogStats(queryRef: FunctionReference<"query", "public", {
+    fromTimestamp?: number;
+    toTimestamp?: number;
+}, AuditLogStats>, args?: {
+    fromTimestamp?: number;
+    toTimestamp?: number;
+}): AuditLogStats | undefined;
+/**
+ * Hook to detect anomalies in real-time.
+ *
+ * @example
+ * ```tsx
+ * import { useAnomalyDetection } from "convex-audit-log/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function AnomalyMonitor() {
+ *   const anomalies = useAnomalyDetection(api.auditLog.detectAnomalies, {
+ *     patterns: [
+ *       { action: "user.login.failed", threshold: 5, windowMinutes: 5 },
+ *       { action: "record.deleted", threshold: 10, windowMinutes: 1 },
+ *     ],
+ *   });
+ *
+ *   if (!anomalies) return <div>Loading...</div>;
+ *   if (anomalies.length === 0) return <div>No anomalies detected</div>;
+ *
+ *   return (
+ *     <div className="anomalies">
+ *       {anomalies.map((anomaly, i) => (
+ *         <div key={i} className="anomaly-alert">
+ *           {anomaly.action}: {anomaly.count} events in {anomaly.windowMinutes} minutes
+ *           (threshold: {anomaly.threshold})
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export declare function useAnomalyDetection(queryRef: FunctionReference<"query", "public", {
+    patterns: {
+        action: string;
+        threshold: number;
+        windowMinutes: number;
+    }[];
+}, Anomaly[]>, args: {
+    patterns: {
+        action: string;
+        threshold: number;
+        windowMinutes: number;
+    }[];
+}): Anomaly[] | undefined;
+/**
+ * Formats a timestamp to a human-readable string.
+ */
+export declare function formatTimestamp(timestamp: number): string;
+/**
+ * Returns a CSS class name based on severity.
+ */
+export declare function getSeverityClass(severity: Severity): string;
+/**
+ * Returns a color based on severity (for inline styles).
+ */
+export declare function getSeverityColor(severity: Severity): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}

package/dist/react/index.js

@@ -0,0 +1,196 @@
+"use client";
+import { useQuery } from "convex/react";
+/**
+ * Hook to query audit logs by resource.
+ * Provides real-time updates when the audit log changes.
+ *
+ * @example
+ * ```tsx
+ * import { useAuditLogByResource } from "convex-audit-log/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function DocumentHistory({ documentId }: { documentId: string }) {
+ *   const logs = useAuditLogByResource(api.auditLog.queryByResource, {
+ *     resourceType: "documents",
+ *     resourceId: documentId,
+ *     limit: 20,
+ *   });
+ *
+ *   if (!logs) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <ul>
+ *       {logs.map((log) => (
+ *         <li key={log._id}>
+ *           {log.action} by {log.actorId} at {new Date(log.timestamp).toLocaleString()}
+ *         </li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+export function useAuditLogByResource(queryRef, args) {
+    return useQuery(queryRef, args);
+}
+/**
+ * Hook to query audit logs by actor (user).
+ *
+ * @example
+ * ```tsx
+ * import { useAuditLogByActor } from "convex-audit-log/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function UserActivity({ userId }: { userId: string }) {
+ *   const logs = useAuditLogByActor(api.auditLog.queryByActor, {
+ *     actorId: userId,
+ *     limit: 50,
+ *   });
+ *
+ *   if (!logs) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <ul>
+ *       {logs.map((log) => (
+ *         <li key={log._id}>{log.action}</li>
+ *       ))}
+ *     </ul>
+ *   );
+ * }
+ * ```
+ */
+export function useAuditLogByActor(queryRef, args) {
+    return useQuery(queryRef, args);
+}
+/**
+ * Hook to watch critical events in real-time.
+ *
+ * @example
+ * ```tsx
+ * import { useWatchCriticalEvents } from "convex-audit-log/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function SecurityAlerts() {
+ *   const criticalEvents = useWatchCriticalEvents(api.auditLog.watchCritical, {
+ *     limit: 10,
+ *   });
+ *
+ *   if (!criticalEvents) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <div className="alerts">
+ *       {criticalEvents.map((event) => (
+ *         <div key={event._id} className={`alert alert-${event.severity}`}>
+ *           {event.action}
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useWatchCriticalEvents(queryRef, args) {
+    return useQuery(queryRef, args ?? {});
+}
+/**
+ * Hook to get audit log statistics.
+ *
+ * @example
+ * ```tsx
+ * import { useAuditLogStats } from "convex-audit-log/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function Dashboard() {
+ *   const stats = useAuditLogStats(api.auditLog.getStats, {
+ *     fromTimestamp: Date.now() - 24 * 60 * 60 * 1000, // Last 24 hours
+ *   });
+ *
+ *   if (!stats) return <div>Loading...</div>;
+ *
+ *   return (
+ *     <div>
+ *       <h2>Total Events: {stats.totalCount}</h2>
+ *       <div>Critical: {stats.bySeverity.critical}</div>
+ *       <div>Errors: {stats.bySeverity.error}</div>
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useAuditLogStats(queryRef, args) {
+    return useQuery(queryRef, args ?? {});
+}
+/**
+ * Hook to detect anomalies in real-time.
+ *
+ * @example
+ * ```tsx
+ * import { useAnomalyDetection } from "convex-audit-log/react";
+ * import { api } from "../convex/_generated/api";
+ *
+ * function AnomalyMonitor() {
+ *   const anomalies = useAnomalyDetection(api.auditLog.detectAnomalies, {
+ *     patterns: [
+ *       { action: "user.login.failed", threshold: 5, windowMinutes: 5 },
+ *       { action: "record.deleted", threshold: 10, windowMinutes: 1 },
+ *     ],
+ *   });
+ *
+ *   if (!anomalies) return <div>Loading...</div>;
+ *   if (anomalies.length === 0) return <div>No anomalies detected</div>;
+ *
+ *   return (
+ *     <div className="anomalies">
+ *       {anomalies.map((anomaly, i) => (
+ *         <div key={i} className="anomaly-alert">
+ *           {anomaly.action}: {anomaly.count} events in {anomaly.windowMinutes} minutes
+ *           (threshold: {anomaly.threshold})
+ *         </div>
+ *       ))}
+ *     </div>
+ *   );
+ * }
+ * ```
+ */
+export function useAnomalyDetection(queryRef, args) {
+    return useQuery(queryRef, args);
+}
+/**
+ * Formats a timestamp to a human-readable string.
+ */
+export function formatTimestamp(timestamp) {
+    return new Date(timestamp).toLocaleString();
+}
+/**
+ * Returns a CSS class name based on severity.
+ */
+export function getSeverityClass(severity) {
+    switch (severity) {
+        case "critical":
+            return "audit-severity-critical";
+        case "error":
+            return "audit-severity-error";
+        case "warning":
+            return "audit-severity-warning";
+        case "info":
+        default:
+            return "audit-severity-info";
+    }
+}
+/**
+ * Returns a color based on severity (for inline styles).
+ */
+export function getSeverityColor(severity) {
+    switch (severity) {
+        case "critical":
+            return "#dc2626"; // red-600
+        case "error":
+            return "#ea580c"; // orange-600
+        case "warning":
+            return "#ca8a04"; // yellow-600
+        case "info":
+        default:
+            return "#2563eb"; // blue-600
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AA6CxC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,MAAM,UAAU,qBAAqB,CACnC,QAKC,EACD,IAKC;IAED,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,kBAAkB,CAChC,QAKC,EACD,IAKC;IAED,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,sBAAsB,CACpC,QAKC,EACD,IAGC;IAED,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,QAKC,EACD,IAGC;IAED,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAKC,EACD,IAEC;IAED,OAAO,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAClC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,cAAc,EAAE,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,yBAAyB,CAAC;QACnC,KAAK,OAAO;YACV,OAAO,sBAAsB,CAAC;QAChC,KAAK,SAAS;YACZ,OAAO,wBAAwB,CAAC;QAClC,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,qBAAqB,CAAC;IACjC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAkB;IACjD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,UAAU;YACb,OAAO,SAAS,CAAC,CAAC,UAAU;QAC9B,KAAK,OAAO;YACV,OAAO,SAAS,CAAC,CAAC,aAAa;QACjC,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC,CAAC,aAAa;QACjC,KAAK,MAAM,CAAC;QACZ;YACE,OAAO,SAAS,CAAC,CAAC,WAAW;IACjC,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,115 @@
+{
+  "name": "convex-audit-log",
+  "description": "A comprehensive audit logging component for Convex - track user actions, API calls, and system events with built-in compliance features.",
+  "repository": "github:robertalv/audit-log",
+  "homepage": "https://github.com/robertalv/audit-log#readme",
+  "bugs": {
+    "url": "https://github.com/robertalv/audit-log/issues"
+  },
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "keywords": [
+    "convex",
+    "component",
+    "audit-log",
+    "logging",
+    "compliance",
+    "analytics",
+    "security",
+    "GDPR",
+    "HIPAA",
+    "SOC2"
+  ],
+  "type": "module",
+  "scripts": {
+    "dev": "run-p -r 'dev:*'",
+    "dev:backend": "convex dev --typecheck-components",
+    "dev:frontend": "cd example && vite --clearScreen false",
+    "dev:build": "chokidar 'tsconfig*.json' 'src/**/*.ts' -i '**/*.test.ts' -c 'npm run build:codegen' --initial",
+    "predev": "path-exists .env.local dist || (npm run build && convex dev --once)",
+    "build": "tsc --project ./tsconfig.build.json",
+    "build:codegen": "npx convex codegen --component-dir ./src/component && npm run build",
+    "build:clean": "rm -rf dist *.tsbuildinfo && npm run build:codegen",
+    "typecheck": "tsc --noEmit && tsc -p example && tsc -p example/convex",
+    "lint": "eslint .",
+    "all": "run-p -r 'dev:*' 'test:watch'",
+    "test": "vitest run --typecheck",
+    "test:watch": "vitest --typecheck --clearScreen false",
+    "test:debug": "vitest --inspect-brk --no-file-parallelism",
+    "test:coverage": "vitest run --coverage --coverage.reporter=text",
+    "preversion": "npm ci && npm run build:clean && run-p test lint typecheck",
+    "alpha": "npm version prerelease --preid alpha && npm publish --tag alpha && git push --follow-tags",
+    "release": "npm version patch && npm publish && git push --follow-tags",
+    "version": "vim -c 'normal o' -c 'normal o## '$npm_package_version CHANGELOG.md && prettier -w CHANGELOG.md && git add CHANGELOG.md"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/client/index.d.ts",
+      "default": "./dist/client/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    },
+    "./test": "./src/test.ts",
+    "./_generated/component.js": {
+      "types": "./dist/component/_generated/component.d.ts"
+    },
+    "./_generated/component": {
+      "types": "./dist/component/_generated/component.d.ts"
+    },
+    "./convex.config.js": {
+      "types": "./dist/component/convex.config.d.ts",
+      "default": "./dist/component/convex.config.js"
+    },
+    "./convex.config": {
+      "types": "./dist/component/convex.config.d.ts",
+      "default": "./dist/component/convex.config.js"
+    }
+  },
+  "peerDependencies": {
+    "convex": "^1.29.3",
+    "react": "^18.3.1 || ^19.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@convex-dev/eslint-plugin": "^1.1.1",
+    "@edge-runtime/vm": "^5.0.0",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "9.39.1",
+    "@types/node": "^24.10.4",
+    "@types/react": "^19.2.7",
+    "@types/react-dom": "^19.2.3",
+    "@vitejs/plugin-react": "^5.1.1",
+    "chokidar-cli": "3.0.0",
+    "convex": "1.31.0",
+    "convex-test": "0.0.40",
+    "cpy-cli": "^6.0.0",
+    "eslint": "9.39.1",
+    "eslint-plugin-react": "^7.37.5",
+    "eslint-plugin-react-hooks": "^7.0.1",
+    "eslint-plugin-react-refresh": "^0.4.24",
+    "globals": "^17.0.0",
+    "npm-run-all2": "8.0.4",
+    "path-exists-cli": "2.0.0",
+    "pkg-pr-new": "^0.0.60",
+    "prettier": "3.6.2",
+    "react": "^19.2.1",
+    "react-dom": "^19.2.1",
+    "typescript": "5.9.3",
+    "typescript-eslint": "8.47.0",
+    "vite": "7.2.6",
+    "vitest": "4.0.17"
+  },
+  "types": "./dist/client/index.d.ts",
+  "module": "./dist/client/index.js"
+}

package/src/client/_generated/_ignore.ts

@@ -0,0 +1 @@
+// This is only here so convex-test can detect a _generated folder

package/src/client/index.test.ts

@@ -0,0 +1,61 @@
+import { describe, expect, test } from "vitest";
+import { exposeAuditLogApi } from "./index.js";
+import { anyApi, type ApiFromModules } from "convex/server";
+import { components, initConvexTest } from "./setup.test.js";
+
+// Re-export the audit log API for testing
+export const { queryByResource, queryByActor, getStats, watchCritical } =
+  exposeAuditLogApi(components.auditLog, {
+    auth: async (ctx, _operation) => {
+      return (await ctx.auth.getUserIdentity())?.subject ?? "anonymous";
+    },
+  });
+
+const testApi = (
+  anyApi as unknown as ApiFromModules<{
+    "index.test": {
+      queryByResource: typeof queryByResource;
+      queryByActor: typeof queryByActor;
+      getStats: typeof getStats;
+      watchCritical: typeof watchCritical;
+    };
+  }>
+)["index.test"];
+
+describe("client tests", () => {
+  test("should be able to query by resource (empty at start)", async () => {
+    const t = initConvexTest().withIdentity({
+      subject: "user1",
+    });
+
+    const logs = await t.query(testApi.queryByResource, {
+      resourceType: "documents",
+      resourceId: "doc123",
+    });
+
+    expect(logs).toHaveLength(0);
+  });
+
+  test("should be able to get stats (empty at start)", async () => {
+    const t = initConvexTest().withIdentity({
+      subject: "user1",
+    });
+
+    const stats = await t.query(testApi.getStats, {});
+
+    expect(stats).toBeDefined();
+    expect(stats.totalCount).toBe(0);
+  });
+
+  test("should be able to watch critical events (empty at start)", async () => {
+    const t = initConvexTest().withIdentity({
+      subject: "user1",
+    });
+
+    const criticalEvents = await t.query(testApi.watchCritical, {
+      limit: 10,
+    });
+
+    expect(criticalEvents).toHaveLength(0);
+  });
+});