feat(plugins): add DocuSign eSignature integration plugin

packages/corsair/core/constants.ts

@@ -101,6 +101,7 @@ export const BaseProviders = [
 	'digitalocean',
 	'discord',
 	'dockerhub',
+	'docusign',
 	'dodopayments',
 	'doppler',
 	'dropbox',
@@ -296,6 +297,7 @@ export const ProviderDisplayNames = {
 	digitalocean: 'DigitalOcean',
 	discord: 'Discord',
 	dockerhub: 'Docker Hub',
+	docusign: 'Docusign',
 	dodopayments: 'Dodo Payments',
 	doppler: 'Doppler',
 	dropbox: 'Dropbox',
@@ -498,6 +500,7 @@ export type AllProviders =
 	| 'digitalocean'
 	| 'discord'
 	| 'dockerhub'
+	| 'docusign'
 	| 'dodopayments'
 	| 'doppler'
 	| 'dropbox'

packages/docusign/client.ts

@@ -0,0 +1,48 @@
+export interface DocusignAuthOptions {
+	accessToken: string;
+	accountId: string;
+	baseUri?: string;
+}
+
+export class DocusignClient {
+	public baseUri: string;
+	public accountId: string;
+	private token: string;
+
+	constructor(options: DocusignAuthOptions) {
+		this.accountId = options.accountId;
+		this.token = options.accessToken;
+
+		let root = options.baseUri?.trim() || 'https://demo.docusign.net/restapi';
+		while (root.endsWith('/')) {
+			root = root.slice(0, -1);
+		}
+
+		this.baseUri = `${root}/v2.1/accounts/${this.accountId}`;
+	}
+
+	async request<T = any>(
+		endpoint: string,
+		options: RequestInit = {},
+	): Promise<T> {
+		const cleanPath = endpoint.startsWith('/') ? endpoint : `/${endpoint}`;
+		const url = `${this.baseUri}${cleanPath}`;
+
+		const response = await fetch(url, {
+			...options,
+			headers: {
+				Authorization: `Bearer ${this.token}`,
+				'Content-Type': 'application/json',
+				Accept: 'application/json',
+				...options.headers,
+			},
+		});
+
+		if (!response.ok) {
+			const errorText = await response.text();
+			throw new Error(`DocuSign API Error (${response.status}): ${errorText}`);
+		}
+
+		return response.json() as Promise<T>;
+	}
+}

packages/docusign/endpoints/envelopes.ts

@@ -0,0 +1,77 @@
+import type { DocusignClient } from '../client';
+
+export interface CreateEnvelopeParams {
+	templateId?: string;
+	emailSubject: string;
+	status: 'sent' | 'created';
+	templateRoles?: Array<{
+		email: string;
+		name: string;
+		roleName: string;
+	}>;
+	documents?: Array<{
+		documentId: string;
+		name: string;
+		fileExtension?: string;
+		documentBase64?: string;
+	}>;
+	recipients?: {
+		signers?: Array<{
+			email: string;
+			name: string;
+			recipientId: string;
+			routingOrder?: string;
+		}>;
+	};
+}
+
+export const createEnvelope = async (
+	client: DocusignClient,
+	params: CreateEnvelopeParams,
+) => {
+	return client.request('/envelopes', {
+		method: 'POST',
+		body: JSON.stringify(params),
+	});
+};
+
+export const getEnvelope = async (
+	client: DocusignClient,
+	{ envelopeId }: { envelopeId: string },
+) => {
+	return client.request(`/envelopes/${envelopeId}`);
+};
+
+export const sendEnvelope = async (
+	client: DocusignClient,
+	{ envelopeId }: { envelopeId: string },
+) => {
+	return client.request(`/envelopes/${envelopeId}`, {
+		method: 'PUT',
+		body: JSON.stringify({ status: 'sent' }),
+	});
+};
+
+export const createRecipientViewUrl = async (
+	client: DocusignClient,
+	{
+		envelopeId,
+		...params
+	}: {
+		envelopeId: string;
+		userName: string;
+		email: string;
+		returnUrl: string;
+		authenticationMethod?: string;
+		recipientId?: string;
+	},
+) => {
+	return client.request(`/envelopes/${envelopeId}/views/recipient`, {
+		method: 'POST',
+		body: JSON.stringify({
+			authenticationMethod: 'none',
+			recipientId: '1',
+			...params,
+		}),
+	});
+};

packages/docusign/endpoints/index.ts

@@ -0,0 +1,54 @@
+import type { DocusignClient } from '../client';
+import type {
+	CreateEnvelopeParams,
+	GetEnvelopeParams,
+	ListTemplatesParams,
+} from './types';
+
+export const createEnvelope = async (
+	client: DocusignClient,
+	params: CreateEnvelopeParams,
+) => {
+	return client.request('/envelopes', {
+		method: 'POST',
+		body: JSON.stringify(params),
+	});
+};
+
+export const getEnvelope = async (
+	client: DocusignClient,
+	params: GetEnvelopeParams,
+) => {
+	return client.request(`/envelopes/${params.envelopeId}`);
+};
+
+export const sendEnvelope = async (
+	client: DocusignClient,
+	params: GetEnvelopeParams,
+) => {
+	return client.request(`/envelopes/${params.envelopeId}`, {
+		method: 'PUT',
+		body: JSON.stringify({ status: 'sent' }),
+	});
+};
+
+export const listTemplates = async (
+	client: DocusignClient,
+	params?: ListTemplatesParams,
+) => {
+	const query = new URLSearchParams();
+	if (params?.count) query.append('count', String(params.count));
+	if (params?.startPosition)
+		query.append('start_position', String(params.startPosition));
+	const qs = query.toString() ? `?${query.toString()}` : '';
+	return client.request(`/templates${qs}`);
+};
+
+export const getTemplate = async (
+	client: DocusignClient,
+	params: { templateId: string },
+) => {
+	return client.request(`/templates/${params.templateId}`);
+};
+
+export * from './types';

packages/docusign/endpoints/templates.ts

@@ -0,0 +1,20 @@
+import type { DocusignClient } from '../client';
+
+export const listTemplates = async (
+	client: DocusignClient,
+	params?: { count?: number; startPosition?: number },
+) => {
+	const query = new URLSearchParams();
+	if (params?.count) query.append('count', String(params.count));
+	if (params?.startPosition)
+		query.append('start_position', String(params.startPosition));
+	const qs = query.toString() ? `?${query.toString()}` : '';
+	return client.request(`/templates${qs}`);
+};
+
+export const getTemplate = async (
+	client: DocusignClient,
+	{ templateId }: { templateId: string },
+) => {
+	return client.request(`/templates/${templateId}`);
+};

packages/docusign/endpoints/types.ts

@@ -0,0 +1,141 @@
+import { z } from 'zod';
+
+export const CreateEnvelopeInputSchema = z.object({
+	templateId: z.string().optional(),
+	emailSubject: z.string(),
+	status: z.enum(['sent', 'created']).default('sent'),
+	templateRoles: z
+		.array(
+			z.object({
+				email: z.string(),
+				name: z.string(),
+				roleName: z.string(),
+			}),
+		)
+		.optional(),
+	documents: z
+		.array(
+			z.object({
+				documentId: z.string(),
+				name: z.string(),
+				fileExtension: z.string().optional(),
+				documentBase64: z.string().optional(),
+			}),
+		)
+		.optional(),
+	recipients: z
+		.object({
+			signers: z
+				.array(
+					z.object({
+						email: z.string(),
+						name: z.string(),
+						recipientId: z.string(),
+						routingOrder: z.string().optional(),
+					}),
+				)
+				.optional(),
+		})
+		.optional(),
+});
+
+export const GetEnvelopeInputSchema = z.object({
+	envelopeId: z.string(),
+});
+
+export const SendEnvelopeInputSchema = z.object({
+	envelopeId: z.string(),
+});
+
+export const ListTemplatesInputSchema = z
+	.object({
+		count: z.number().optional(),
+		startPosition: z.number().optional(),
+	})
+	.optional();
+
+export const GetTemplateInputSchema = z.object({
+	templateId: z.string(),
+});
+
+export const CreateEnvelopeOutputSchema = z
+	.object({
+		envelopeId: z.string(),
+		status: z.string(),
+		statusDateTime: z.string().optional(),
+		uri: z.string().optional(),
+	})
+	.passthrough();
+
+export const GetEnvelopeOutputSchema = z
+	.object({
+		envelopeId: z.string().optional(),
+		status: z.string().optional(),
+	})
+	.passthrough();
+
+export const SendEnvelopeOutputSchema = z
+	.object({
+		envelopeId: z.string().optional(),
+		status: z.string().optional(),
+	})
+	.passthrough();
+
+export const ListTemplatesOutputSchema = z
+	.object({
+		envelopeTemplates: z.array(z.record(z.string(), z.unknown())).optional(),
+	})
+	.passthrough();
+
+export const GetTemplateOutputSchema = z
+	.object({
+		templateId: z.string().optional(),
+		name: z.string().optional(),
+	})
+	.passthrough();
+
+export const EndpointInputSchemas = {
+	createEnvelope: CreateEnvelopeInputSchema,
+	getEnvelope: GetEnvelopeInputSchema,
+	sendEnvelope: SendEnvelopeInputSchema,
+	listTemplates: ListTemplatesInputSchema,
+	getTemplate: GetTemplateInputSchema,
+};
+
+export const EndpointOutputSchemas = {
+	createEnvelope: CreateEnvelopeOutputSchema,
+	getEnvelope: GetEnvelopeOutputSchema,
+	sendEnvelope: SendEnvelopeOutputSchema,
+	listTemplates: ListTemplatesOutputSchema,
+	getTemplate: GetTemplateOutputSchema,
+};
+
+export const docusignEndpointInputSchemas = EndpointInputSchemas;
+export const docusignEndpointOutputSchemas = EndpointOutputSchemas;
+export const DocusignEndpointInputSchemas = EndpointInputSchemas;
+export const DocusignEndpointOutputSchemas = EndpointOutputSchemas;
+
+export type CreateEnvelopeParams = z.infer<typeof CreateEnvelopeInputSchema>;
+export type GetEnvelopeParams = z.infer<typeof GetEnvelopeInputSchema>;
+export type ListTemplatesParams = NonNullable<
+	z.infer<typeof ListTemplatesInputSchema>
+>;
+
+export type DocusignEndpointInputs = {
+	createEnvelope: z.infer<typeof CreateEnvelopeInputSchema>;
+	getEnvelope: z.infer<typeof GetEnvelopeInputSchema>;
+	sendEnvelope: z.infer<typeof SendEnvelopeInputSchema>;
+	listTemplates: z.infer<typeof ListTemplatesInputSchema>;
+	getTemplate: z.infer<typeof GetTemplateInputSchema>;
+};
+
+export type DocusignEndpointOutputs = {
+	createEnvelope: z.infer<typeof CreateEnvelopeOutputSchema>;
+	getEnvelope: z.infer<typeof GetEnvelopeOutputSchema>;
+	sendEnvelope: z.infer<typeof SendEnvelopeOutputSchema>;
+	listTemplates: z.infer<typeof ListTemplatesOutputSchema>;
+	getTemplate: z.infer<typeof GetTemplateOutputSchema>;
+};
+
+export type EndpointInputs = DocusignEndpointInputs;
+export type EndpointOutputs = DocusignEndpointOutputs;