@meistrari/audit-sdk 0.0.0

package/dist/client.d.ts

@@ -0,0 +1,33 @@
+export type AuditOrigin = 'api' | 'worker' | 'ui';
+export interface AuditEvent {
+    action: string;
+    object_type: string;
+    object_id?: string;
+    origin: AuditOrigin;
+    actor_type?: 'user' | 'system' | 'api_key';
+    correlation_id?: string;
+    ip_address?: string;
+    user_agent?: string;
+    occurred_at?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface AuditClientConfig {
+    baseUrl: string;
+    timeoutMs?: number;
+    maxRetries?: number;
+}
+export declare class AuditClient {
+    private baseUrl;
+    private timeoutMs;
+    private maxRetries;
+    constructor(config: AuditClientConfig);
+    track(dataToken: string, event: AuditEvent): Promise<void>;
+    trackMany(dataToken: string, events: AuditEvent[]): Promise<void>;
+    private logFailure;
+    private sleep;
+}
+export declare class AuditError extends Error {
+    details?: unknown | undefined;
+    constructor(message: string, details?: unknown | undefined);
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,QAAQ,GAAG,IAAI,CAAC;AAElD,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,MAAM,EAAE,iBAAiB;IAM/B,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IA4CvE,OAAO,CAAC,UAAU;IAelB,OAAO,CAAC,KAAK;CAGd;AAED,qBAAa,UAAW,SAAQ,KAAK;IACC,OAAO,CAAC,EAAE,OAAO;gBAAzC,OAAO,EAAE,MAAM,EAAS,OAAO,CAAC,EAAE,OAAO,YAAA;CAItD"}

package/dist/client.js

@@ -0,0 +1,70 @@
+export class AuditClient {
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/$/, '');
+        this.timeoutMs = config.timeoutMs ?? 5000;
+        this.maxRetries = config.maxRetries ?? 3;
+    }
+    async track(dataToken, event) {
+        await this.trackMany(dataToken, [event]);
+    }
+    async trackMany(dataToken, events) {
+        let lastError;
+        for (let attempt = 0; attempt < this.maxRetries; attempt++) {
+            try {
+                const response = await fetch(`${this.baseUrl}/v1/events`, {
+                    method: 'POST',
+                    headers: {
+                        Authorization: `Bearer ${dataToken}`,
+                        'Content-Type': 'application/json',
+                    },
+                    body: JSON.stringify({ events }),
+                    signal: AbortSignal.timeout(this.timeoutMs),
+                });
+                if (response.ok || response.status === 202) {
+                    return;
+                }
+                if (response.status === 429) {
+                    const retryAfter = Number(response.headers.get('Retry-After') ?? '5');
+                    await this.sleep(retryAfter * 1000);
+                    continue;
+                }
+                if (response.status >= 400 && response.status < 500) {
+                    const body = await response.json().catch(() => ({}));
+                    throw new AuditError(`Client error: ${response.status}`, body);
+                }
+                lastError = new Error(`Server error: ${response.status}`);
+            }
+            catch (error) {
+                if (error instanceof AuditError) {
+                    throw error;
+                }
+                lastError = error;
+            }
+            await this.sleep(Math.pow(2, attempt) * 1000);
+        }
+        this.logFailure(events, lastError);
+    }
+    logFailure(events, error) {
+        const payload = {
+            level: 'error',
+            service: 'audit-sdk',
+            message: 'Failed to send audit events after retries',
+            event_count: events.length,
+            actions: events.map((event) => event.action),
+            object_types: events.map((event) => event.object_type),
+            error: error?.message,
+            timestamp: new Date().toISOString(),
+        };
+        console.error(JSON.stringify(payload));
+    }
+    sleep(ms) {
+        return new Promise((resolve) => setTimeout(resolve, ms));
+    }
+}
+export class AuditError extends Error {
+    constructor(message, details) {
+        super(message);
+        this.details = details;
+        this.name = 'AuditError';
+    }
+}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './client';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export * from './client';

package/package.json

@@ -0,0 +1,30 @@
+{
+    "name": "@meistrari/audit-sdk",
+    "version": "0.0.0",
+    "type": "module",
+    "main": "dist/index.js",
+    "description": "",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/meistrari/audit-service.git"
+    },
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist"
+    ],
+    "scripts": {
+        "build": "tsc -p tsconfig.json",
+        "postinstall": "mise-en-place postinstall",
+        "clean": "rm -rf dist"
+    },
+    "engines": {
+        "node": ">=18"
+    },
+    "devDependencies": {
+        "@meistrari/mise-en-place": "2.10.2",
+        "typescript": "^5.3.3"
+    },
+    "dependencies": {
+        "@meistrari/logger": "2.1.3"
+    }
+}