convex-audit-log 0.1.0

package/dist/component/convex.config.d.ts

@@ -0,0 +1,3 @@
+declare const _default: import("convex/server").ComponentDefinition<any>;
+export default _default;
+//# sourceMappingURL=convex.config.d.ts.map

package/dist/component/convex.config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex.config.d.ts","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":";AAEA,wBAA2C"}

package/dist/component/convex.config.js

@@ -0,0 +1,3 @@
+import { defineComponent } from "convex/server";
+export default defineComponent("auditLog");
+//# sourceMappingURL=convex.config.js.map

package/dist/component/convex.config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convex.config.js","sourceRoot":"","sources":["../../src/component/convex.config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhD,eAAe,eAAe,CAAC,UAAU,CAAC,CAAC"}

package/dist/component/lib.d.ts

@@ -0,0 +1,341 @@
+/**
+ * Log a single audit event.
+ */
+export declare const log: import("convex/server").RegisteredMutation<"public", {
+    actorId?: string | undefined;
+    resourceType?: string | undefined;
+    resourceId?: string | undefined;
+    metadata?: any;
+    ipAddress?: string | undefined;
+    userAgent?: string | undefined;
+    sessionId?: string | undefined;
+    tags?: string[] | undefined;
+    retentionCategory?: string | undefined;
+    action: string;
+    severity: "info" | "warning" | "error" | "critical";
+}, Promise<import("convex/values").GenericId<"auditLogs">>>;
+/**
+ * Log a change event with before/after states and optional diff generation.
+ */
+export declare const logChange: import("convex/server").RegisteredMutation<"public", {
+    actorId?: string | undefined;
+    severity?: "info" | "warning" | "error" | "critical" | undefined;
+    ipAddress?: string | undefined;
+    userAgent?: string | undefined;
+    sessionId?: string | undefined;
+    tags?: string[] | undefined;
+    retentionCategory?: string | undefined;
+    before?: any;
+    after?: any;
+    generateDiff?: boolean | undefined;
+    action: string;
+    resourceType: string;
+    resourceId: string;
+}, Promise<import("convex/values").GenericId<"auditLogs">>>;
+/**
+ * Log multiple audit events in a single transaction.
+ */
+export declare const logBulk: import("convex/server").RegisteredMutation<"public", {
+    events: {
+        actorId?: string | undefined;
+        resourceType?: string | undefined;
+        resourceId?: string | undefined;
+        metadata?: any;
+        ipAddress?: string | undefined;
+        userAgent?: string | undefined;
+        sessionId?: string | undefined;
+        tags?: string[] | undefined;
+        retentionCategory?: string | undefined;
+        action: string;
+        severity: "info" | "warning" | "error" | "critical";
+    }[];
+}, Promise<any>>;
+/**
+ * Query audit logs by resource.
+ */
+export declare const queryByResource: import("convex/server").RegisteredQuery<"public", {
+    fromTimestamp?: number | undefined;
+    limit?: number | undefined;
+    resourceType: string;
+    resourceId: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"auditLogs">;
+    _creationTime: number;
+    actorId?: string | undefined;
+    resourceType?: string | undefined;
+    resourceId?: string | undefined;
+    metadata?: any;
+    ipAddress?: string | undefined;
+    userAgent?: string | undefined;
+    sessionId?: string | undefined;
+    tags?: string[] | undefined;
+    retentionCategory?: string | undefined;
+    before?: any;
+    after?: any;
+    diff?: string | undefined;
+    action: string;
+    severity: "info" | "warning" | "error" | "critical";
+    timestamp: number;
+}[]>>;
+/**
+ * Query audit logs by actor (user).
+ */
+export declare const queryByActor: import("convex/server").RegisteredQuery<"public", {
+    actions?: string[] | undefined;
+    fromTimestamp?: number | undefined;
+    limit?: number | undefined;
+    actorId: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"auditLogs">;
+    _creationTime: number;
+    actorId?: string | undefined;
+    resourceType?: string | undefined;
+    resourceId?: string | undefined;
+    metadata?: any;
+    ipAddress?: string | undefined;
+    userAgent?: string | undefined;
+    sessionId?: string | undefined;
+    tags?: string[] | undefined;
+    retentionCategory?: string | undefined;
+    before?: any;
+    after?: any;
+    diff?: string | undefined;
+    action: string;
+    severity: "info" | "warning" | "error" | "critical";
+    timestamp: number;
+}[]>>;
+/**
+ * Query audit logs by severity level.
+ */
+export declare const queryBySeverity: import("convex/server").RegisteredQuery<"public", {
+    fromTimestamp?: number | undefined;
+    limit?: number | undefined;
+    severity: ("info" | "warning" | "error" | "critical")[];
+}, Promise<{
+    _id: import("convex/values").GenericId<"auditLogs">;
+    _creationTime: number;
+    actorId?: string | undefined;
+    resourceType?: string | undefined;
+    resourceId?: string | undefined;
+    metadata?: any;
+    ipAddress?: string | undefined;
+    userAgent?: string | undefined;
+    sessionId?: string | undefined;
+    tags?: string[] | undefined;
+    retentionCategory?: string | undefined;
+    before?: any;
+    after?: any;
+    diff?: string | undefined;
+    action: string;
+    severity: "info" | "warning" | "error" | "critical";
+    timestamp: number;
+}[]>>;
+/**
+ * Query audit logs by action type.
+ */
+export declare const queryByAction: import("convex/server").RegisteredQuery<"public", {
+    fromTimestamp?: number | undefined;
+    limit?: number | undefined;
+    action: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"auditLogs">;
+    _creationTime: number;
+    actorId?: string | undefined;
+    resourceType?: string | undefined;
+    resourceId?: string | undefined;
+    metadata?: any;
+    ipAddress?: string | undefined;
+    userAgent?: string | undefined;
+    sessionId?: string | undefined;
+    tags?: string[] | undefined;
+    retentionCategory?: string | undefined;
+    before?: any;
+    after?: any;
+    diff?: string | undefined;
+    action: string;
+    severity: "info" | "warning" | "error" | "critical";
+    timestamp: number;
+}[]>>;
+/**
+ * Advanced search with multiple filters.
+ */
+export declare const search: import("convex/server").RegisteredQuery<"public", {
+    filters: {
+        severity?: ("info" | "warning" | "error" | "critical")[] | undefined;
+        tags?: string[] | undefined;
+        actions?: string[] | undefined;
+        resourceTypes?: string[] | undefined;
+        actorIds?: string[] | undefined;
+        fromTimestamp?: number | undefined;
+        toTimestamp?: number | undefined;
+    };
+    pagination: {
+        cursor?: string | undefined;
+        limit: number;
+    };
+}, Promise<{
+    items: {
+        _id: import("convex/values").GenericId<"auditLogs">;
+        _creationTime: number;
+        actorId?: string | undefined;
+        resourceType?: string | undefined;
+        resourceId?: string | undefined;
+        metadata?: any;
+        ipAddress?: string | undefined;
+        userAgent?: string | undefined;
+        sessionId?: string | undefined;
+        tags?: string[] | undefined;
+        retentionCategory?: string | undefined;
+        before?: any;
+        after?: any;
+        diff?: string | undefined;
+        action: string;
+        severity: "info" | "warning" | "error" | "critical";
+        timestamp: number;
+    }[];
+    cursor: import("convex/values").GenericId<"auditLogs"> | null;
+    hasMore: boolean;
+}>>;
+/**
+ * Watch for critical events (real-time subscription).
+ */
+export declare const watchCritical: import("convex/server").RegisteredQuery<"public", {
+    severity?: ("info" | "warning" | "error" | "critical")[] | undefined;
+    limit?: number | undefined;
+}, Promise<{
+    _id: import("convex/values").GenericId<"auditLogs">;
+    _creationTime: number;
+    actorId?: string | undefined;
+    resourceType?: string | undefined;
+    resourceId?: string | undefined;
+    metadata?: any;
+    ipAddress?: string | undefined;
+    userAgent?: string | undefined;
+    sessionId?: string | undefined;
+    tags?: string[] | undefined;
+    retentionCategory?: string | undefined;
+    before?: any;
+    after?: any;
+    diff?: string | undefined;
+    action: string;
+    severity: "info" | "warning" | "error" | "critical";
+    timestamp: number;
+}[]>>;
+/**
+ * Get a single audit log by ID.
+ */
+export declare const get: import("convex/server").RegisteredQuery<"public", {
+    id: string;
+}, Promise<{
+    _id: import("convex/values").GenericId<"auditLogs">;
+    _creationTime: number;
+    actorId?: string | undefined;
+    resourceType?: string | undefined;
+    resourceId?: string | undefined;
+    metadata?: any;
+    ipAddress?: string | undefined;
+    userAgent?: string | undefined;
+    sessionId?: string | undefined;
+    tags?: string[] | undefined;
+    retentionCategory?: string | undefined;
+    before?: any;
+    after?: any;
+    diff?: string | undefined;
+    action: string;
+    severity: "info" | "warning" | "error" | "critical";
+    timestamp: number;
+} | null>>;
+/**
+ * Clean up old audit logs based on retention policies.
+ */
+export declare const cleanup: import("convex/server").RegisteredMutation<"public", {
+    retentionCategory?: string | undefined;
+    olderThanDays?: number | undefined;
+    preserveSeverity?: ("info" | "warning" | "error" | "critical")[] | undefined;
+    batchSize?: number | undefined;
+}, Promise<number>>;
+/**
+ * Get current configuration.
+ */
+export declare const getConfig: import("convex/server").RegisteredQuery<"public", {}, Promise<{
+    _id: import("convex/values").GenericId<"config">;
+    _creationTime: number;
+    customRetention?: {
+        category: string;
+        retentionDays: number;
+    }[] | undefined;
+    defaultRetentionDays: number;
+    criticalRetentionDays: number;
+    piiFieldsToRedact: string[];
+    samplingEnabled: boolean;
+    samplingRate: number;
+} | null>>;
+/**
+ * Update configuration.
+ */
+export declare const updateConfig: import("convex/server").RegisteredMutation<"public", {
+    defaultRetentionDays?: number | undefined;
+    criticalRetentionDays?: number | undefined;
+    piiFieldsToRedact?: string[] | undefined;
+    samplingEnabled?: boolean | undefined;
+    samplingRate?: number | undefined;
+    customRetention?: {
+        category: string;
+        retentionDays: number;
+    }[] | undefined;
+}, Promise<import("convex/values").GenericId<"config">>>;
+/**
+ * Detect anomalies based on event frequency patterns.
+ */
+export declare const detectAnomalies: import("convex/server").RegisteredQuery<"public", {
+    patterns: {
+        action: string;
+        threshold: number;
+        windowMinutes: number;
+    }[];
+}, Promise<{
+    action: string;
+    count: number;
+    threshold: number;
+    windowMinutes: number;
+    detectedAt: number;
+}[]>>;
+/**
+ * Generate a report of audit logs.
+ */
+export declare const generateReport: import("convex/server").RegisteredQuery<"public", {
+    includeFields?: string[] | undefined;
+    groupBy?: string | undefined;
+    startDate: number;
+    endDate: number;
+    format: "json" | "csv";
+}, Promise<{
+    format: "json" | "csv";
+    data: string;
+    generatedAt: number;
+    recordCount: number;
+}>>;
+/**
+ * Get statistics for audit logs.
+ */
+export declare const getStats: import("convex/server").RegisteredQuery<"public", {
+    fromTimestamp?: number | undefined;
+    toTimestamp?: number | undefined;
+}, Promise<{
+    totalCount: number;
+    bySeverity: {
+        info: number;
+        warning: number;
+        error: number;
+        critical: number;
+    };
+    topActions: {
+        action: string;
+        count: number;
+    }[];
+    topActors: {
+        actorId: string;
+        count: number;
+    }[];
+}>>;
+//# sourceMappingURL=lib.d.ts.map

package/dist/component/lib.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lib.d.ts","sourceRoot":"","sources":["../../src/component/lib.ts"],"names":[],"mappings":"AAyBA;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;2DAad,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;;;2DA8BpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;;;;;;;;;;gBAmBlB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;;KA8B1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;KAyBvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;;;;;;;;;;;KA2B1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;KAoBxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2EjB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;KA0BxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;UAiBd,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO;;;;;mBAkClB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;UAyBpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;wDAwCvB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;KA8C1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;GAgFzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;;GA6EnB,CAAC"}