Documenso SDK Patterns

Documenso SDK Patterns

Output

• A scoped SDK boundary with document authorization, idempotency, redacted telemetry, and safe error handling.
• A test-backed client design that never logs signing URLs, document content, signer PII, or credentials.

Examples

Instantiate the SDK with a development secret reference, create a synthetic test document with a stable idempotency key, and assert the mocked request shape in unit tests. For one development integration check, record only correlation ID and lifecycle state; never log document or signer payloads.

Overview

Production-ready patterns for the Documenso TypeScript SDK (@documenso/sdk-typescript) and Python SDK. Covers singleton clients, typed wrappers, error handling, retry logic, and testing patterns.

Prerequisites

• Completed documenso-install-auth setup
• Familiarity with async/await and TypeScript generics
• Understanding of error handling best practices

Instructions

Pattern 1: Singleton Client with Configuration

// src/documenso/client.ts
import { Documenso } from "@documenso/sdk-typescript";

interface DocumensoConfig {
  apiKey: string;
  baseUrl?: string;
  timeout?: number;
}

let instance: Documenso | null = null;

export function getDocumensoClient(config?: DocumensoConfig): Documenso {
  if (!instance) {
    const apiKey = config?.apiKey ?? process.env.DOCUMENSO_API_KEY;