documenso-observability

# Documenso Observability ## Overview Implement monitoring, structured logging, and health checks for Documenso integrations. Since Documenso does not expose rate limit headers or usage metrics via API, observability is built around your API call patterns, latency, error rates, and webhook delivery. ## Prerequisites - Working Documenso integration - Monitoring stack (Prometheus/Grafana, Datadog, or CloudWatch) - Logging infrastructure ## Instructions ### Step 1: Instrumented Client Wrapper ```typescript // src/observability/documenso-metrics.ts import { Documenso } from "@documenso/sdk-typescript"; interface Metrics { requestCount: number; errorCount: number; totalLatencyMs: number; errorsByStatus: Record<number, number>; } const metrics: Metrics = { requestCount: 0, errorCount: 0, totalLatencyMs: 0, errorsByStatus: {}, }; export function createInstrumentedClient(): Documenso { const client = new Documenso({ apiKey: process.env.DOCUMENSO_API_KEY! }); return new Proxy(client, { get(target, prop) { const value = (target as any)[prop]; if (typeof value === "object" && value !== null) { return new Proxy(value, { get(innerTarget, method) { const fn = (innerTarget as any)[method]; if (typeof fn !== "function") return fn; return async (...args: any[]) => { const start = Date.now(); metrics.requestCount++; try { const result ...