Skip to main content ホーム クリエイター 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".
インストールへ移動 Skills Marketplace コミュニティが作成したAIスキルを発見・探索
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/ComeOnOliver/skillshub --skill documenso-debug-bundleコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
Zipをダウンロード ダウンロード中... このリポジトリの他の Skills 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.
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.
