Skip to main content Inicio Creadores comeonoliver skillshub documenso-debug-bundle
documenso-debug-bundle Comprehensive debugging toolkit for Documenso integrations.
Use when troubleshooting complex issues, gathering diagnostic information,
or creating support tickets for Documenso problems.
Trigger with phrases like "debug documenso", "documenso diagnostics",
"troubleshoot documenso", "documenso support ticket".
Ir a la instalación Skills Marketplace Descubre y explora habilidades de IA creadas por la comunidad.
Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.
Mostrar detalles del prompt Un comando directo omite el prompt de revisión. Revisa el origen antes de ejecutarlo.
npx skills add https://github.com/ComeOnOliver/skillshub --skill documenso-debug-bundleEl comando permanece en una sola línea. Desplázate horizontalmente para revisarlo antes de copiarlo.
¿Prefieres una copia local? Descarga los archivos que SkillsMP tiene disponibles ahora.
Descargar Zip Descargando... Más de este repositorio Review product and feature risk before an AI coding agent starts implementation.
Use Xquik for X data and confirmation-gated X actions: tweet search, user lookup, follower export, media download, monitors, webhooks, MCP, and SDK workflows.
Canton Network open-source ecosystem guide covering DAML SDK, Canton runtime, and Splice applications. Use when working with Canton Network, DAML smart contracts, or building decentralized applications.
Ocupaciones relacionadas SOC
Basado en la clasificación ocupacional SOC
name documenso-debug-bundle description Comprehensive debugging toolkit for Documenso integrations.
Use when troubleshooting complex issues, gathering diagnostic information,
or creating support tickets for Documenso problems.
Trigger with phrases like "debug documenso", "documenso diagnostics",
"troubleshoot documenso", "documenso support ticket".
allowed-tools Read, Write, Edit, Bash(curl:*), Bash(node:*), Grep version 1.0.0 license MIT author Jeremy Longshore <jeremy@intentsolutions.io> compatible-with claude-code, codex, openclaw tags ["saas","documenso","debugging"]
Documenso Debug Bundle
Current State
!node --version 2>/dev/null || echo 'N/A'
!python3 --version 2>/dev/null || echo 'N/A'
!uname -a
Overview
Comprehensive debugging tools for Documenso integration issues. Includes diagnostic scripts, curl debug commands, environment verification, and support ticket templates.
Prerequisites
Documenso SDK installed
Access to logs and configuration
curl and jq available
Instructions
Step 1: Quick Connectivity Test
#!/bin/bash
set -euo pipefail
echo "=== Documenso Connectivity Test ==="
if [ -z "${DOCUMENSO_API_KEY:-} " ]; then
echo "FAIL: DOCUMENSO_API_KEY not set"
exit 1
fi
echo "OK: API key set (${#DOCUMENSO_API_KEY} chars)"
BASE="${DOCUMENSO_BASE_URL:-https://app.documenso.com/api/v1} "
STATUS=$(curl -s -o /dev/null -w "%{http_code}" \
-H "Authorization: Bearer $DOCUMENSO_API_KEY " \
"$BASE /documents?page=1&perPage=1" )
if [ "$STATUS " = "200" ]; then
echo "OK: API authentication successful"
elif [ "$STATUS " = "401" ]; then
echo
"FAIL: Invalid API key (401)"
exit
elif
"$STATUS "
"403"
then
echo
"FAIL: Insufficient permissions (403) — try a team API key"
exit
else
echo
"WARN: Unexpected status $STATUS "
fi
"%{time_total}"
"Authorization: Bearer $DOCUMENSO_API_KEY "
"$BASE /documents?page=1&perPage=1"
echo
"Latency: ${LATENCY} s"
echo
"=== Recent Documents ==="
"Authorization: Bearer $DOCUMENSO_API_KEY "
"$BASE /documents?page=1&perPage=5"
'.documents[] | {id, title, status, createdAt}'
Step 2: TypeScript Diagnostic Script
import { Documenso } from "@documenso/sdk-typescript" ;
async function diagnose (const results : Array <{ test : string ; status : "PASS" | "FAIL" ; detail : string }> = [];
const apiKey = process.env .DOCUMENSO_API_KEY ;
if (!apiKey) {
results.push ({ test : "API Key" , status : "FAIL" , detail : "DOCUMENSO_API_KEY not set" });
return results;
}
results.push ({ test : "API Key" , status : "PASS" , detail : `Set (${apiKey.length} chars)` });
const client = new Documenso ({
apiKey,
...(process.env .DOCUMENSO_BASE_URL && { serverURL : process.env .DOCUMENSO_BASE_URL }),
});
try {
const start = Date .now ();
const { documents } = await client.documents .findV0 ({ page : 1 , perPage : 1 });
const latency = Date .now () - start;
results.push ({
test : "Connection" ,
status : "PASS" ,
detail : `${latency} ms, ${documents.length} documents returned` ,
});
} catch (err : any ) {
results.push ({
test : "Connection" ,
status : "FAIL" ,
detail : `${err.statusCode ?? "unknown" } : ${err.message} ` ,
});
}
try {
const doc = await client.documents .createV0 ({ title : "[DIAG] Test Document" });
await client.documents .deleteV0 (doc.documentId );
results.push ({ test : "Write Access" , status : "PASS" , detail : "Create+delete OK" });
} catch (err : any ) {
results.push ({
test : "Write Access" ,
status : "FAIL" ,
detail : err.message ,
});
}
console .log ("\n=== Documenso Diagnostic Report ===" );
for (const r of results) {
console .log (` [${r.status} ] ${r.test} : ${r.detail} ` );
}
const failures = results.filter ((r ) => r.status === "FAIL" ).length ;
console .log (`\n${results.length} tests, ${failures} failures\n` );
return results;
}
diagnose ();
Run: npx tsx scripts/documenso-diagnose.ts
Step 3: Debug Logging Wrapper
import { Documenso } from "@documenso/sdk-typescript" ;
export function createDebugClient (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, innerProp ) {
const method = (innerTarget as any )[innerProp];
if (typeof method === "function" ) {
return async (...args : any []) => {
const start = Date .now ();
console .log (`[DOCUMENSO] ${String (prop)} .${String (innerProp)} (` , JSON .stringify (args).slice (0 , 200 ), ")" );
try {
const result = await method.apply (innerTarget, args);
console .log (`[DOCUMENSO] OK in ${Date .now() - start} ms` );
return result;
} catch (err : any ) {
console .error (`[DOCUMENSO] FAIL in ${Date .now() - start} ms: ${err.statusCode} ${err.message} ` );
throw err;
}
};
}
return method;
},
});
}
return value;
},
});
}
Step 4: Support Ticket Template ## Environment
- Documenso: Cloud / Self-hosted v[version]
- SDK: @documenso/sdk-typescript v[version]
- Node.js: [version]
- OS: [os]
## Issue Description
[What you expected vs what happened]
## Steps to Reproduce
1. [Step 1]
2. [Step 2]
## API Request (sanitized)
- Method: POST /api/v2/documents
- Status: [HTTP status]
- Response: [error body, no secrets]
## Diagnostic Output
[Paste output from documenso-diagnose.ts]
## Logs
[Relevant log lines, sanitized]
Error Handling Issue Cause Solution Diagnostic timeout Slow API or network Check connectivity, increase timeout Write test fails Read-only key or no team access Use team API key with write permissions Self-hosted unreachable Docker container down docker ps, check container logsLatency > 5s Network or infrastructure issue Check if self-hosted DB is overloaded
Resources
Next Steps For rate limit handling, see documenso-rate-limits.
