convex-audit-log 0.1.0

package/dist/component/schema.d.ts

@@ -0,0 +1,87 @@
+/**
+ * Severity levels for audit events.
+ * - info: Regular operations (login, profile update)
+ * - warning: Potentially concerning actions (password change, permission change)
+ * - error: Failed operations or errors
+ * - critical: Security-sensitive events (unauthorized access attempts, data breaches)
+ */
+export declare const vSeverity: import("convex/values").VUnion<"info" | "warning" | "error" | "critical", [import("convex/values").VLiteral<"info", "required">, import("convex/values").VLiteral<"warning", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"critical", "required">], "required", never>;
+export type Severity = "info" | "warning" | "error" | "critical";
+declare const _default: import("convex/server").SchemaDefinition<{
+    /**
+     * Main audit log table storing all audit events.
+     */
+    auditLogs: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        resourceType?: string | undefined;
+        actorId?: string | undefined;
+        resourceId?: string | undefined;
+        before?: any;
+        metadata?: any;
+        ipAddress?: string | undefined;
+        userAgent?: string | undefined;
+        sessionId?: string | undefined;
+        tags?: string[] | undefined;
+        retentionCategory?: string | undefined;
+        after?: any;
+        diff?: string | undefined;
+        severity: "info" | "warning" | "error" | "critical";
+        action: string;
+        timestamp: number;
+    }, {
+        action: import("convex/values").VString<string, "required">;
+        actorId: import("convex/values").VString<string | undefined, "optional">;
+        timestamp: import("convex/values").VFloat64<number, "required">;
+        resourceType: import("convex/values").VString<string | undefined, "optional">;
+        resourceId: import("convex/values").VString<string | undefined, "optional">;
+        metadata: import("convex/values").VAny<any, "optional", string>;
+        severity: import("convex/values").VUnion<"info" | "warning" | "error" | "critical", [import("convex/values").VLiteral<"info", "required">, import("convex/values").VLiteral<"warning", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"critical", "required">], "required", never>;
+        ipAddress: import("convex/values").VString<string | undefined, "optional">;
+        userAgent: import("convex/values").VString<string | undefined, "optional">;
+        sessionId: import("convex/values").VString<string | undefined, "optional">;
+        tags: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+        before: import("convex/values").VAny<any, "optional", string>;
+        after: import("convex/values").VAny<any, "optional", string>;
+        diff: import("convex/values").VString<string | undefined, "optional">;
+        retentionCategory: import("convex/values").VString<string | undefined, "optional">;
+    }, "required", "resourceType" | "actorId" | "severity" | "action" | "resourceId" | "before" | "metadata" | "ipAddress" | "userAgent" | "sessionId" | "tags" | "retentionCategory" | `metadata.${string}` | "after" | `before.${string}` | `after.${string}` | "timestamp" | "diff">, {
+        by_action_timestamp: ["action", "timestamp", "_creationTime"];
+        by_actor_timestamp: ["actorId", "timestamp", "_creationTime"];
+        by_resource: ["resourceType", "resourceId", "timestamp", "_creationTime"];
+        by_severity_timestamp: ["severity", "timestamp", "_creationTime"];
+        by_timestamp: ["timestamp", "_creationTime"];
+        by_retention_timestamp: ["retentionCategory", "timestamp", "_creationTime"];
+    }, {}, {}>;
+    /**
+     * Configuration table for component settings.
+     * Contains a single document with global configuration.
+     */
+    config: import("convex/server").TableDefinition<import("convex/values").VObject<{
+        customRetention?: {
+            category: string;
+            retentionDays: number;
+        }[] | undefined;
+        defaultRetentionDays: number;
+        criticalRetentionDays: number;
+        piiFieldsToRedact: string[];
+        samplingEnabled: boolean;
+        samplingRate: number;
+    }, {
+        defaultRetentionDays: import("convex/values").VFloat64<number, "required">;
+        criticalRetentionDays: import("convex/values").VFloat64<number, "required">;
+        piiFieldsToRedact: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+        samplingEnabled: import("convex/values").VBoolean<boolean, "required">;
+        samplingRate: import("convex/values").VFloat64<number, "required">;
+        customRetention: import("convex/values").VArray<{
+            category: string;
+            retentionDays: number;
+        }[] | undefined, import("convex/values").VObject<{
+            category: string;
+            retentionDays: number;
+        }, {
+            category: import("convex/values").VString<string, "required">;
+            retentionDays: import("convex/values").VFloat64<number, "required">;
+        }, "required", "category" | "retentionDays">, "optional">;
+    }, "required", "defaultRetentionDays" | "criticalRetentionDays" | "piiFieldsToRedact" | "samplingEnabled" | "samplingRate" | "customRetention">, {}, {}, {}>;
+}, true>;
+export default _default;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/component/schema.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,gUAKrB,CAAC;AAEF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;;IAG/D;;OAEG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4CH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAlDL,wBAyEG"}

package/dist/component/schema.js

@@ -0,0 +1,71 @@
+import { defineSchema, defineTable } from "convex/server";
+import { v } from "convex/values";
+/**
+ * Severity levels for audit events.
+ * - info: Regular operations (login, profile update)
+ * - warning: Potentially concerning actions (password change, permission change)
+ * - error: Failed operations or errors
+ * - critical: Security-sensitive events (unauthorized access attempts, data breaches)
+ */
+export const vSeverity = v.union(v.literal("info"), v.literal("warning"), v.literal("error"), v.literal("critical"));
+export default defineSchema({
+    /**
+     * Main audit log table storing all audit events.
+     */
+    auditLogs: defineTable({
+        // Core event data
+        action: v.string(),
+        actorId: v.optional(v.string()),
+        timestamp: v.number(),
+        // Resource tracking
+        resourceType: v.optional(v.string()),
+        resourceId: v.optional(v.string()),
+        // Event metadata
+        metadata: v.optional(v.any()),
+        severity: vSeverity,
+        // Context information
+        ipAddress: v.optional(v.string()),
+        userAgent: v.optional(v.string()),
+        sessionId: v.optional(v.string()),
+        // Compliance tags
+        tags: v.optional(v.array(v.string())),
+        // Change tracking
+        before: v.optional(v.any()),
+        after: v.optional(v.any()),
+        diff: v.optional(v.string()),
+        // Retention category for cleanup policies
+        retentionCategory: v.optional(v.string()),
+    })
+        // Query by action type with time ordering
+        .index("by_action_timestamp", ["action", "timestamp"])
+        // Query by actor (user) with time ordering
+        .index("by_actor_timestamp", ["actorId", "timestamp"])
+        // Query by resource with time ordering
+        .index("by_resource", ["resourceType", "resourceId", "timestamp"])
+        // Query by severity level with time ordering
+        .index("by_severity_timestamp", ["severity", "timestamp"])
+        // Query by timestamp for time-range queries
+        .index("by_timestamp", ["timestamp"])
+        // Query by retention category for cleanup
+        .index("by_retention_timestamp", ["retentionCategory", "timestamp"]),
+    /**
+     * Configuration table for component settings.
+     * Contains a single document with global configuration.
+     */
+    config: defineTable({
+        // Retention settings
+        defaultRetentionDays: v.number(),
+        criticalRetentionDays: v.number(),
+        // PII redaction settings
+        piiFieldsToRedact: v.array(v.string()),
+        // Sampling settings (for high-volume apps)
+        samplingEnabled: v.boolean(),
+        samplingRate: v.number(), // 0.0 to 1.0
+        // Custom retention categories
+        customRetention: v.optional(v.array(v.object({
+            category: v.string(),
+            retentionDays: v.number(),
+        }))),
+    }),
+});
+//# sourceMappingURL=schema.js.map

package/dist/component/schema.js.map

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

package/dist/component/shared.d.ts

@@ -0,0 +1,203 @@
+import type { Infer } from "convex/values";
+/**
+ * Severity levels for audit events.
+ */
+export declare const vSeverity: import("convex/values").VUnion<"info" | "warning" | "error" | "critical", [import("convex/values").VLiteral<"info", "required">, import("convex/values").VLiteral<"warning", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"critical", "required">], "required", never>;
+/**
+ * Base audit event validator (without timestamp - added automatically).
+ */
+export declare const vAuditEventInput: import("convex/values").VObject<{
+    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";
+}, {
+    action: import("convex/values").VString<string, "required">;
+    actorId: import("convex/values").VString<string | undefined, "optional">;
+    resourceType: import("convex/values").VString<string | undefined, "optional">;
+    resourceId: import("convex/values").VString<string | undefined, "optional">;
+    metadata: import("convex/values").VAny<any, "optional", string>;
+    severity: import("convex/values").VUnion<"info" | "warning" | "error" | "critical", [import("convex/values").VLiteral<"info", "required">, import("convex/values").VLiteral<"warning", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"critical", "required">], "required", never>;
+    ipAddress: import("convex/values").VString<string | undefined, "optional">;
+    userAgent: import("convex/values").VString<string | undefined, "optional">;
+    sessionId: import("convex/values").VString<string | undefined, "optional">;
+    tags: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    retentionCategory: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "action" | "actorId" | "resourceType" | "resourceId" | "metadata" | "severity" | "ipAddress" | "userAgent" | "sessionId" | "tags" | "retentionCategory" | `metadata.${string}`>;
+/**
+ * Change tracking event validator.
+ */
+export declare const vChangeEventInput: import("convex/values").VObject<{
+    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;
+}, {
+    action: import("convex/values").VString<string, "required">;
+    actorId: import("convex/values").VString<string | undefined, "optional">;
+    resourceType: import("convex/values").VString<string, "required">;
+    resourceId: import("convex/values").VString<string, "required">;
+    before: import("convex/values").VAny<any, "optional", string>;
+    after: import("convex/values").VAny<any, "optional", string>;
+    generateDiff: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    severity: import("convex/values").VUnion<"info" | "warning" | "error" | "critical" | undefined, [import("convex/values").VLiteral<"info", "required">, import("convex/values").VLiteral<"warning", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"critical", "required">], "optional", never>;
+    ipAddress: import("convex/values").VString<string | undefined, "optional">;
+    userAgent: import("convex/values").VString<string | undefined, "optional">;
+    sessionId: import("convex/values").VString<string | undefined, "optional">;
+    tags: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    retentionCategory: import("convex/values").VString<string | undefined, "optional">;
+}, "required", "action" | "actorId" | "resourceType" | "resourceId" | "severity" | "ipAddress" | "userAgent" | "sessionId" | "tags" | "retentionCategory" | "before" | "after" | "generateDiff" | `before.${string}` | `after.${string}`>;
+/**
+ * Query filters validator.
+ */
+export declare const vQueryFilters: import("convex/values").VObject<{
+    severity?: ("info" | "warning" | "error" | "critical")[] | undefined;
+    tags?: string[] | undefined;
+    actions?: string[] | undefined;
+    resourceTypes?: string[] | undefined;
+    actorIds?: string[] | undefined;
+    fromTimestamp?: number | undefined;
+    toTimestamp?: number | undefined;
+}, {
+    severity: import("convex/values").VArray<("info" | "warning" | "error" | "critical")[] | undefined, import("convex/values").VUnion<"info" | "warning" | "error" | "critical", [import("convex/values").VLiteral<"info", "required">, import("convex/values").VLiteral<"warning", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"critical", "required">], "required", never>, "optional">;
+    actions: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    resourceTypes: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    actorIds: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    fromTimestamp: import("convex/values").VFloat64<number | undefined, "optional">;
+    toTimestamp: import("convex/values").VFloat64<number | undefined, "optional">;
+    tags: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+}, "required", "severity" | "tags" | "actions" | "resourceTypes" | "actorIds" | "fromTimestamp" | "toTimestamp">;
+/**
+ * Pagination validator.
+ */
+export declare const vPagination: import("convex/values").VObject<{
+    cursor?: string | undefined;
+    limit: number;
+}, {
+    cursor: import("convex/values").VString<string | undefined, "optional">;
+    limit: import("convex/values").VFloat64<number, "required">;
+}, "required", "cursor" | "limit">;
+/**
+ * Report format validator.
+ */
+export declare const vReportFormat: import("convex/values").VUnion<"json" | "csv", [import("convex/values").VLiteral<"json", "required">, import("convex/values").VLiteral<"csv", "required">], "required", never>;
+/**
+ * Anomaly pattern validator.
+ */
+export declare const vAnomalyPattern: import("convex/values").VObject<{
+    action: string;
+    threshold: number;
+    windowMinutes: number;
+}, {
+    action: import("convex/values").VString<string, "required">;
+    threshold: import("convex/values").VFloat64<number, "required">;
+    windowMinutes: import("convex/values").VFloat64<number, "required">;
+}, "required", "action" | "threshold" | "windowMinutes">;
+/**
+ * Cleanup options validator.
+ */
+export declare const vCleanupOptions: import("convex/values").VObject<{
+    retentionCategory?: string | undefined;
+    olderThanDays?: number | undefined;
+    preserveSeverity?: ("info" | "warning" | "error" | "critical")[] | undefined;
+    batchSize?: number | undefined;
+}, {
+    olderThanDays: import("convex/values").VFloat64<number | undefined, "optional">;
+    preserveSeverity: import("convex/values").VArray<("info" | "warning" | "error" | "critical")[] | undefined, import("convex/values").VUnion<"info" | "warning" | "error" | "critical", [import("convex/values").VLiteral<"info", "required">, import("convex/values").VLiteral<"warning", "required">, import("convex/values").VLiteral<"error", "required">, import("convex/values").VLiteral<"critical", "required">], "required", never>, "optional">;
+    retentionCategory: import("convex/values").VString<string | undefined, "optional">;
+    batchSize: import("convex/values").VFloat64<number | undefined, "optional">;
+}, "required", "retentionCategory" | "olderThanDays" | "preserveSeverity" | "batchSize">;
+/**
+ * Configuration options validator.
+ */
+export declare const vConfigOptions: import("convex/values").VObject<{
+    defaultRetentionDays?: number | undefined;
+    criticalRetentionDays?: number | undefined;
+    piiFieldsToRedact?: string[] | undefined;
+    samplingEnabled?: boolean | undefined;
+    samplingRate?: number | undefined;
+    customRetention?: {
+        category: string;
+        retentionDays: number;
+    }[] | undefined;
+}, {
+    defaultRetentionDays: import("convex/values").VFloat64<number | undefined, "optional">;
+    criticalRetentionDays: import("convex/values").VFloat64<number | undefined, "optional">;
+    piiFieldsToRedact: import("convex/values").VArray<string[] | undefined, import("convex/values").VString<string, "required">, "optional">;
+    samplingEnabled: import("convex/values").VBoolean<boolean | undefined, "optional">;
+    samplingRate: import("convex/values").VFloat64<number | undefined, "optional">;
+    customRetention: import("convex/values").VArray<{
+        category: string;
+        retentionDays: number;
+    }[] | undefined, import("convex/values").VObject<{
+        category: string;
+        retentionDays: number;
+    }, {
+        category: import("convex/values").VString<string, "required">;
+        retentionDays: import("convex/values").VFloat64<number, "required">;
+    }, "required", "category" | "retentionDays">, "optional">;
+}, "required", "defaultRetentionDays" | "criticalRetentionDays" | "piiFieldsToRedact" | "samplingEnabled" | "samplingRate" | "customRetention">;
+export type Severity = Infer<typeof vSeverity>;
+export type AuditEventInput = Infer<typeof vAuditEventInput>;
+export type ChangeEventInput = Infer<typeof vChangeEventInput>;
+export type QueryFilters = Infer<typeof vQueryFilters>;
+export type Pagination = Infer<typeof vPagination>;
+export type ReportFormat = Infer<typeof vReportFormat>;
+export type AnomalyPattern = Infer<typeof vAnomalyPattern>;
+export type CleanupOptions = Infer<typeof vCleanupOptions>;
+export type ConfigOptions = Infer<typeof vConfigOptions>;
+/**
+ * Full audit event with generated fields.
+ */
+export type AuditEvent = AuditEventInput & {
+    _id: string;
+    _creationTime: number;
+    timestamp: number;
+    before?: unknown;
+    after?: unknown;
+    diff?: string;
+};
+/**
+ * Paginated result type.
+ */
+export type PaginatedResult<T> = {
+    items: T[];
+    cursor: string | null;
+    hasMore: boolean;
+};
+/**
+ * Anomaly detection result.
+ */
+export type Anomaly = {
+    action: string;
+    count: number;
+    threshold: number;
+    windowMinutes: number;
+    detectedAt: number;
+};
+/**
+ * Report result type.
+ */
+export type Report = {
+    format: ReportFormat;
+    data: string;
+    generatedAt: number;
+    recordCount: number;
+};
+//# sourceMappingURL=shared.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/component/shared.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAE3C;;GAEG;AACH,eAAO,MAAM,SAAS,gUAKrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;8LAY3B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;yOAc5B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;gHAQxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;kCAGtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,aAAa,gLAGzB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;wDAI1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;wFAK1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;+IAczB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAC/C,MAAM,MAAM,eAAe,GAAG,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC7D,MAAM,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC/D,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACvD,MAAM,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AACnD,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AACvD,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC3D,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAC3D,MAAM,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG;IACzC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,MAAM,EAAE,YAAY,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC"}

package/dist/component/shared.js

@@ -0,0 +1,94 @@
+import { v } from "convex/values";
+/**
+ * Severity levels for audit events.
+ */
+export const vSeverity = v.union(v.literal("info"), v.literal("warning"), v.literal("error"), v.literal("critical"));
+/**
+ * Base audit event validator (without timestamp - added automatically).
+ */
+export const vAuditEventInput = v.object({
+    action: v.string(),
+    actorId: v.optional(v.string()),
+    resourceType: v.optional(v.string()),
+    resourceId: v.optional(v.string()),
+    metadata: v.optional(v.any()),
+    severity: vSeverity,
+    ipAddress: v.optional(v.string()),
+    userAgent: v.optional(v.string()),
+    sessionId: v.optional(v.string()),
+    tags: v.optional(v.array(v.string())),
+    retentionCategory: v.optional(v.string()),
+});
+/**
+ * Change tracking event validator.
+ */
+export const vChangeEventInput = v.object({
+    action: v.string(),
+    actorId: v.optional(v.string()),
+    resourceType: v.string(),
+    resourceId: v.string(),
+    before: v.optional(v.any()),
+    after: v.optional(v.any()),
+    generateDiff: v.optional(v.boolean()),
+    severity: v.optional(vSeverity),
+    ipAddress: v.optional(v.string()),
+    userAgent: v.optional(v.string()),
+    sessionId: v.optional(v.string()),
+    tags: v.optional(v.array(v.string())),
+    retentionCategory: v.optional(v.string()),
+});
+/**
+ * Query filters validator.
+ */
+export const vQueryFilters = v.object({
+    severity: v.optional(v.array(vSeverity)),
+    actions: v.optional(v.array(v.string())),
+    resourceTypes: v.optional(v.array(v.string())),
+    actorIds: v.optional(v.array(v.string())),
+    fromTimestamp: v.optional(v.number()),
+    toTimestamp: v.optional(v.number()),
+    tags: v.optional(v.array(v.string())),
+});
+/**
+ * Pagination validator.
+ */
+export const vPagination = v.object({
+    cursor: v.optional(v.string()),
+    limit: v.number(),
+});
+/**
+ * Report format validator.
+ */
+export const vReportFormat = v.union(v.literal("json"), v.literal("csv"));
+/**
+ * Anomaly pattern validator.
+ */
+export const vAnomalyPattern = v.object({
+    action: v.string(),
+    threshold: v.number(),
+    windowMinutes: v.number(),
+});
+/**
+ * Cleanup options validator.
+ */
+export const vCleanupOptions = v.object({
+    olderThanDays: v.optional(v.number()),
+    preserveSeverity: v.optional(v.array(vSeverity)),
+    retentionCategory: v.optional(v.string()),
+    batchSize: v.optional(v.number()),
+});
+/**
+ * Configuration options validator.
+ */
+export const vConfigOptions = v.object({
+    defaultRetentionDays: v.optional(v.number()),
+    criticalRetentionDays: v.optional(v.number()),
+    piiFieldsToRedact: v.optional(v.array(v.string())),
+    samplingEnabled: v.optional(v.boolean()),
+    samplingRate: v.optional(v.number()),
+    customRetention: v.optional(v.array(v.object({
+        category: v.string(),
+        retentionDays: v.number(),
+    }))),
+});
+//# sourceMappingURL=shared.js.map

package/dist/component/shared.js.map

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