@keystrokehq/docusign 0.0.1

package/dist/envelopes.mjs

@@ -0,0 +1,190 @@
+import { docusignEnvelopeCreateInputSchema, docusignEnvelopeIdSchema, docusignEnvelopeSchema, docusignEnvelopeSummarySchema, docusignGenericObjectSchema, docusignIncludeSchema, docusignLooseObjectSchema, docusignSuccessSchema } from "./schemas/index.mjs";
+import { r as defineRestOperation, t as defineBinaryOperation } from "./operation-helpers-BMTArRh9.mjs";
+import { z } from "zod";
+
+//#region src/envelopes.ts
+/**
+* Envelope core lifecycle — get, send, replay, audit, transcripts.
+* Covers PLAN.md § 6.1.
+*/
+const binaryResponseSchema = docusignLooseObjectSchema({
+	contentType: z.string().optional(),
+	contentDisposition: z.string().optional(),
+	status: z.number(),
+	body: z.string()
+});
+const getEnvelope = defineRestOperation({
+	id: "get_envelope",
+	slug: "DOCUSIGN_GET_ENVELOPE",
+	name: "Get Envelope",
+	description: "Fetch a DocuSign envelope by id, optionally expanding recipients/tabs/custom_fields/documents.",
+	method: "GET",
+	path: (ctx) => `/envelopes/${ctx.encode(String(ctx.input.envelopeId))}`,
+	input: z.object({
+		envelopeId: docusignEnvelopeIdSchema,
+		include: docusignIncludeSchema.optional(),
+		advancedUpdate: z.boolean().optional()
+	}),
+	output: docusignEnvelopeSchema,
+	query: (input) => ({
+		include: input.include,
+		advanced_update: input.advancedUpdate
+	})
+});
+const sendEnvelope = defineRestOperation({
+	id: "send_envelope",
+	slug: "DOCUSIGN_SEND_ENVELOPE",
+	name: "Send Envelope",
+	description: "Create and send an envelope in one call (status=sent) or save it as a draft.",
+	needsApproval: true,
+	method: "POST",
+	path: "/envelopes",
+	input: docusignEnvelopeCreateInputSchema,
+	output: docusignEnvelopeSummarySchema,
+	body: (input) => input
+});
+const voidEnvelope = defineRestOperation({
+	id: "void_envelope",
+	slug: "DOCUSIGN_SEND_ENVELOPE",
+	name: "Void Envelope",
+	description: "Void an in-flight envelope. Modeled as a PUT on the envelope with status=voided + voidedReason.",
+	needsApproval: true,
+	method: "PUT",
+	path: (ctx) => `/envelopes/${ctx.encode(String(ctx.input.envelopeId))}`,
+	input: z.object({
+		envelopeId: docusignEnvelopeIdSchema,
+		voidedReason: z.string().min(1)
+	}),
+	output: docusignEnvelopeSchema,
+	body: (input) => ({
+		status: "voided",
+		voidedReason: input.voidedReason
+	})
+});
+const createEnvelopeFromTemplate = defineRestOperation({
+	id: "create_envelope_from_template",
+	slug: "DOCUSIGN_CREATE_ENVELOPE_FROM_TEMPLATE",
+	name: "Create Envelope From Template",
+	description: "Create a new envelope bound to an existing DocuSign template, filling template roles from input.",
+	needsApproval: true,
+	method: "POST",
+	path: "/envelopes",
+	input: docusignEnvelopeCreateInputSchema.extend({
+		templateId: z.string().min(1),
+		templateRoles: z.array(docusignLooseObjectSchema()).min(1),
+		status: z.enum(["created", "sent"]).optional()
+	}),
+	output: docusignEnvelopeSummarySchema,
+	body: (input) => input
+});
+const retrieveEnvelopeAuditEvents = defineRestOperation({
+	id: "retrieve_envelope_audit_events",
+	slug: "DOCUSIGN_RETRIEVE_ENVELOPE_AUDIT_EVENTS",
+	name: "Retrieve Envelope Audit Events",
+	description: "Fetch the audit trail for an envelope (send, view, sign, decline, void, etc).",
+	method: "GET",
+	path: (ctx) => `/envelopes/${ctx.encode(String(ctx.input.envelopeId))}/audit_events`,
+	input: z.object({ envelopeId: docusignEnvelopeIdSchema }),
+	output: docusignLooseObjectSchema({ auditEvents: z.array(docusignLooseObjectSchema()).optional() })
+});
+const republishConnectDataForEnvelope = defineRestOperation({
+	id: "republish_connect_data_for_envelope",
+	slug: "DOCUSIGN_REPUBLISH_CONNECT_DATA_FOR_ENVELOPE",
+	name: "Republish Connect Data For Envelope",
+	description: "Retrigger Connect webhooks for a specific envelope.",
+	needsApproval: true,
+	method: "PUT",
+	path: (ctx) => `/connect/envelopes/${ctx.encode(String(ctx.input.envelopeId))}/retry_queue`,
+	input: z.object({ envelopeId: docusignEnvelopeIdSchema }),
+	output: docusignGenericObjectSchema
+});
+const republishConnectInfoForEnvelopes = defineRestOperation({
+	id: "republish_connect_info_for_envelopes",
+	slug: "DOCUSIGN_REPUBLISH_CONNECT_INFO_FOR_ENVELOPES",
+	name: "Republish Connect Info For Envelopes",
+	description: "Retrigger Connect webhooks for a set of envelopes by id (bulk version of the single-envelope call).",
+	needsApproval: true,
+	method: "PUT",
+	path: "/connect/envelopes/retry_queue",
+	input: z.object({ envelopeIds: z.array(docusignEnvelopeIdSchema).min(1) }),
+	output: docusignGenericObjectSchema,
+	body: (input) => ({ envelopeIds: input.envelopeIds })
+});
+const submitBatchHistoricalEnvelopesToWebhook = defineRestOperation({
+	id: "submit_batch_historical_envelopes_to_webhook",
+	slug: "DOCUSIGN_SUBMIT_BATCH_HISTORICAL_ENVELOPES_TO_WEBHOOK",
+	name: "Submit Batch Historical Envelopes To Webhook",
+	description: "Queue historical envelopes for delivery to a Connect consumer. Requires JWT Grant + admin consent — v1 ships this as a pass-through; production use is plan-gated until JWT is enabled.",
+	needsApproval: true,
+	method: "POST",
+	path: "/connect/envelopes/publish/historical",
+	input: z.object({
+		connectId: z.string().min(1),
+		envelopeIds: z.array(docusignEnvelopeIdSchema).min(1)
+	}),
+	output: docusignGenericObjectSchema,
+	body: (input) => ({
+		connectId: input.connectId,
+		envelopeIds: input.envelopeIds
+	})
+});
+const retrieveEnvelopeHtmlDefinition = defineRestOperation({
+	id: "retrieve_envelope_html_definition",
+	slug: "DOCUSIGN_RETRIEVE_ENVELOPE_HTML_DEFINITION",
+	name: "Retrieve Envelope HTML Definition",
+	description: "Get the responsive HTML definition for an envelope.",
+	method: "GET",
+	path: (ctx) => `/envelopes/${ctx.encode(String(ctx.input.envelopeId))}/html_definitions`,
+	input: z.object({ envelopeId: docusignEnvelopeIdSchema }),
+	output: docusignGenericObjectSchema
+});
+const retrieveHtmlDefinitionForResponsiveDocument = defineRestOperation({
+	id: "retrieve_html_definition_for_responsive_document",
+	slug: "DOCUSIGN_RETRIEVE_HTMLDEFINITION_FOR_RESPONSIVE_DOCUMENT",
+	name: "Retrieve HTML Definition For Responsive Document",
+	description: "Get the responsive HTML definition for a specific document within an envelope.",
+	method: "GET",
+	path: (ctx) => `/envelopes/${ctx.encode(String(ctx.input.envelopeId))}/documents/${ctx.encode(String(ctx.input.documentId))}/html_definitions`,
+	input: z.object({
+		envelopeId: docusignEnvelopeIdSchema,
+		documentId: z.string().min(1)
+	}),
+	output: docusignGenericObjectSchema
+});
+const getPdfTranscriptOfEnvelopeComments = defineBinaryOperation({
+	id: "get_pdf_transcript_of_envelope_comments",
+	slug: "DOCUSIGN_GET_PDFTRANSCRIPT_OF_ENVELOPE_COMMENTS",
+	name: "Get PDF Transcript Of Envelope Comments",
+	description: "Download a PDF transcript of the comments thread on an envelope.",
+	method: "GET",
+	path: (ctx) => `/envelopes/${ctx.encode(String(ctx.input.envelopeId))}/comments/transcript`,
+	input: z.object({ envelopeId: docusignEnvelopeIdSchema }),
+	accept: "application/pdf",
+	output: binaryResponseSchema
+});
+const deleteEnvelopeTransferRule = defineRestOperation({
+	id: "delete_envelope_transfer_rule",
+	slug: "DOCUSIGN_DELETE_ENVELOPE_TRANSFER_RULE",
+	name: "Delete Envelope Transfer Rule",
+	description: "Remove a single envelope-transfer rule by id.",
+	needsApproval: true,
+	method: "DELETE",
+	path: (ctx) => `/envelopes/transfer_rules/${ctx.encode(String(ctx.input.transferRuleId))}`,
+	input: z.object({ transferRuleId: z.string().min(1) }),
+	output: docusignSuccessSchema,
+	transformResponse: () => ({ success: true })
+});
+const fetchRecipientNamesForEmail = defineRestOperation({
+	id: "fetch_recipient_names_for_email",
+	slug: "DOCUSIGN_FETCH_RECIPIENT_NAMES_FOR_EMAIL",
+	name: "Fetch Recipient Names For Email",
+	description: "Look up known recipient names for a given email address on the account.",
+	method: "GET",
+	path: "/recipient_names",
+	input: z.object({ email: z.email() }),
+	output: docusignLooseObjectSchema({ recipientNames: z.array(z.string()).optional() }),
+	query: (input) => ({ email: input.email })
+});
+
+//#endregion
+export { createEnvelopeFromTemplate, deleteEnvelopeTransferRule, fetchRecipientNamesForEmail, getEnvelope, getPdfTranscriptOfEnvelopeComments, republishConnectDataForEnvelope, republishConnectInfoForEnvelopes, retrieveEnvelopeAuditEvents, retrieveEnvelopeHtmlDefinition, retrieveHtmlDefinitionForResponsiveDocument, sendEnvelope, submitBatchHistoricalEnvelopesToWebhook, voidEnvelope };

package/dist/errors.d.mts

@@ -0,0 +1,48 @@
+//#region src/errors.d.ts
+/**
+ * Package-local error class for DocuSign API failures.
+ *
+ * Carries the provider-returned HTTP status, DocuSign error code (when
+ * structured), trace token (`X-DocuSign-TraceToken` echoes back in support
+ * queries), and a discriminated `kind` that operations can branch on without
+ * string-matching error messages.
+ */
+type DocusignApiErrorKind = 'http' | 'rate_limit' | 'auth' | 'validation' | 'plan_gated' | 'webhook_signature' | 'not_implemented' | 'network';
+interface DocusignApiErrorInit {
+  readonly kind: DocusignApiErrorKind;
+  readonly status?: number;
+  readonly providerErrorCode?: string;
+  readonly requestId?: string;
+  readonly retryable?: boolean;
+  readonly retryAfterMs?: number;
+  readonly body?: unknown;
+  readonly cause?: unknown;
+}
+declare class DocusignApiError extends Error {
+  readonly kind: DocusignApiErrorKind;
+  readonly status: number | undefined;
+  readonly providerErrorCode: string | undefined;
+  readonly requestId: string | undefined;
+  readonly retryable: boolean;
+  readonly retryAfterMs: number | undefined;
+  readonly body: unknown;
+  constructor(message: string, init: DocusignApiErrorInit);
+  static notImplemented(init: {
+    slug?: string;
+    reason?: string;
+    kind?: Extract<DocusignApiErrorKind, 'plan_gated' | 'not_implemented'>;
+  }): DocusignApiError;
+  static fromResponse(params: {
+    status: number;
+    body: unknown;
+    requestId?: string;
+    retryAfterMs?: number;
+    url: string;
+    method: string;
+  }): DocusignApiError;
+  static webhookSignature(message: string): DocusignApiError;
+  static validation(message: string, cause?: unknown): DocusignApiError;
+}
+declare function isDocusignApiError(value: unknown): value is DocusignApiError;
+//#endregion
+export { DocusignApiError, DocusignApiErrorInit, DocusignApiErrorKind, isDocusignApiError };

package/dist/errors.mjs

@@ -0,0 +1,76 @@
+//#region src/errors.ts
+var DocusignApiError = class DocusignApiError extends Error {
+	kind;
+	status;
+	providerErrorCode;
+	requestId;
+	retryable;
+	retryAfterMs;
+	body;
+	constructor(message, init) {
+		super(message, { cause: init.cause });
+		this.name = "DocusignApiError";
+		this.kind = init.kind;
+		this.status = init.status;
+		this.providerErrorCode = init.providerErrorCode;
+		this.requestId = init.requestId;
+		this.retryable = init.retryable ?? defaultRetryable(init.kind, init.status);
+		this.retryAfterMs = init.retryAfterMs;
+		this.body = init.body;
+	}
+	static notImplemented(init) {
+		const kind = init.kind ?? "not_implemented";
+		const slugSuffix = init.slug ? ` (${init.slug})` : "";
+		return new DocusignApiError(`${init.reason ?? "DocuSign operation is not implemented in this release."}${slugSuffix}`, {
+			kind,
+			retryable: false
+		});
+	}
+	static fromResponse(params) {
+		const { status, body, requestId, retryAfterMs, url, method } = params;
+		const bodyRecord = isRecord(body) ? body : void 0;
+		const providerErrorCode = readString(bodyRecord?.errorCode) ?? readString(bodyRecord?.code);
+		const providerMessage = readString(bodyRecord?.message) ?? readString(bodyRecord?.error_description) ?? readString(bodyRecord?.error);
+		const kind = status === 401 || status === 403 ? "auth" : status === 429 ? "rate_limit" : "http";
+		return new DocusignApiError(`DocuSign ${method} ${url} failed (${status}): ${providerMessage ?? `HTTP ${status}`}`, {
+			kind,
+			status,
+			providerErrorCode,
+			requestId,
+			retryAfterMs,
+			body,
+			retryable: status === 429 || status >= 500
+		});
+	}
+	static webhookSignature(message) {
+		return new DocusignApiError(message, {
+			kind: "webhook_signature",
+			retryable: false
+		});
+	}
+	static validation(message, cause) {
+		return new DocusignApiError(message, {
+			kind: "validation",
+			retryable: false,
+			cause
+		});
+	}
+};
+function defaultRetryable(kind, status) {
+	if (kind === "rate_limit") return true;
+	if (kind === "network") return true;
+	if (typeof status === "number" && status >= 500) return true;
+	return false;
+}
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function readString(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value : void 0;
+}
+function isDocusignApiError(value) {
+	return value instanceof DocusignApiError;
+}
+
+//#endregion
+export { DocusignApiError, isDocusignApiError };

package/dist/events.d.mts

@@ -0,0 +1,192 @@
+import { z } from "zod";
+
+//#region src/events.d.ts
+declare const docusignEnvelopeEventNames: readonly ["envelope-sent", "envelope-resent", "envelope-delivered", "envelope-signed", "envelope-completed", "envelope-declined", "envelope-voided", "envelope-corrected", "envelope-discard", "envelope-purge", "envelope-reassign", "envelope-deleted", "envelope-documents-purged"];
+declare const docusignRecipientEventNames: readonly ["recipient-sent", "recipient-resent", "recipient-delivered", "recipient-completed", "recipient-declined", "recipient-authenticationfailed", "recipient-autoresponded", "recipient-delegate", "recipient-finish-later", "recipient-reassign"];
+declare const docusignTemplateEventNames: readonly ["template-created", "template-modified"];
+declare const docusignConnectEventNames: readonly ["envelope-sent", "envelope-resent", "envelope-delivered", "envelope-signed", "envelope-completed", "envelope-declined", "envelope-voided", "envelope-corrected", "envelope-discard", "envelope-purge", "envelope-reassign", "envelope-deleted", "envelope-documents-purged", "recipient-sent", "recipient-resent", "recipient-delivered", "recipient-completed", "recipient-declined", "recipient-authenticationfailed", "recipient-autoresponded", "recipient-delegate", "recipient-finish-later", "recipient-reassign", "template-created", "template-modified"];
+declare const docusignConnectEventNameSchema: z.ZodEnum<{
+  "envelope-sent": "envelope-sent";
+  "envelope-resent": "envelope-resent";
+  "envelope-delivered": "envelope-delivered";
+  "envelope-signed": "envelope-signed";
+  "envelope-completed": "envelope-completed";
+  "envelope-declined": "envelope-declined";
+  "envelope-voided": "envelope-voided";
+  "envelope-corrected": "envelope-corrected";
+  "envelope-discard": "envelope-discard";
+  "envelope-purge": "envelope-purge";
+  "envelope-reassign": "envelope-reassign";
+  "envelope-deleted": "envelope-deleted";
+  "envelope-documents-purged": "envelope-documents-purged";
+  "recipient-sent": "recipient-sent";
+  "recipient-resent": "recipient-resent";
+  "recipient-delivered": "recipient-delivered";
+  "recipient-completed": "recipient-completed";
+  "recipient-declined": "recipient-declined";
+  "recipient-authenticationfailed": "recipient-authenticationfailed";
+  "recipient-autoresponded": "recipient-autoresponded";
+  "recipient-delegate": "recipient-delegate";
+  "recipient-finish-later": "recipient-finish-later";
+  "recipient-reassign": "recipient-reassign";
+  "template-created": "template-created";
+  "template-modified": "template-modified";
+}>;
+declare const docusignConnectEnvelopeEventSchema: z.ZodObject<{
+  event: z.ZodEnum<{
+    "envelope-sent": "envelope-sent";
+    "envelope-resent": "envelope-resent";
+    "envelope-delivered": "envelope-delivered";
+    "envelope-signed": "envelope-signed";
+    "envelope-completed": "envelope-completed";
+    "envelope-declined": "envelope-declined";
+    "envelope-voided": "envelope-voided";
+    "envelope-corrected": "envelope-corrected";
+    "envelope-discard": "envelope-discard";
+    "envelope-purge": "envelope-purge";
+    "envelope-reassign": "envelope-reassign";
+    "envelope-deleted": "envelope-deleted";
+    "envelope-documents-purged": "envelope-documents-purged";
+  }>;
+  apiVersion: z.ZodOptional<z.ZodString>;
+  configurationId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+  generatedDateTime: z.ZodOptional<z.ZodString>;
+  retryCount: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+  uri: z.ZodOptional<z.ZodString>;
+  data: z.ZodObject<{
+    accountId: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    envelopeId: z.ZodString;
+    envelopeSummary: z.ZodOptional<z.ZodObject<{
+      envelopeId: z.ZodOptional<z.ZodString>;
+      status: z.ZodOptional<z.ZodString>;
+      emailSubject: z.ZodOptional<z.ZodString>;
+      emailBlurb: z.ZodOptional<z.ZodString>;
+      statusChangedDateTime: z.ZodOptional<z.ZodString>;
+      sentDateTime: z.ZodOptional<z.ZodString>;
+      completedDateTime: z.ZodOptional<z.ZodString>;
+      voidedReason: z.ZodOptional<z.ZodString>;
+      senderAccountId: z.ZodOptional<z.ZodString>;
+      senderUserId: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+  }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const docusignConnectRecipientEventSchema: z.ZodObject<{
+  event: z.ZodEnum<{
+    "recipient-sent": "recipient-sent";
+    "recipient-resent": "recipient-resent";
+    "recipient-delivered": "recipient-delivered";
+    "recipient-completed": "recipient-completed";
+    "recipient-declined": "recipient-declined";
+    "recipient-authenticationfailed": "recipient-authenticationfailed";
+    "recipient-autoresponded": "recipient-autoresponded";
+    "recipient-delegate": "recipient-delegate";
+    "recipient-finish-later": "recipient-finish-later";
+    "recipient-reassign": "recipient-reassign";
+  }>;
+  apiVersion: z.ZodOptional<z.ZodString>;
+  configurationId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+  generatedDateTime: z.ZodOptional<z.ZodString>;
+  retryCount: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+  uri: z.ZodOptional<z.ZodString>;
+  data: z.ZodObject<{
+    accountId: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    envelopeId: z.ZodString;
+    recipientId: z.ZodOptional<z.ZodString>;
+    recipientIdGuid: z.ZodOptional<z.ZodString>;
+    envelopeSummary: z.ZodOptional<z.ZodObject<{
+      envelopeId: z.ZodOptional<z.ZodString>;
+      status: z.ZodOptional<z.ZodString>;
+      emailSubject: z.ZodOptional<z.ZodString>;
+      emailBlurb: z.ZodOptional<z.ZodString>;
+      statusChangedDateTime: z.ZodOptional<z.ZodString>;
+      sentDateTime: z.ZodOptional<z.ZodString>;
+      completedDateTime: z.ZodOptional<z.ZodString>;
+      voidedReason: z.ZodOptional<z.ZodString>;
+      senderAccountId: z.ZodOptional<z.ZodString>;
+      senderUserId: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+    recipientSummary: z.ZodOptional<z.ZodObject<{
+      recipientId: z.ZodOptional<z.ZodString>;
+      recipientIdGuid: z.ZodOptional<z.ZodString>;
+      email: z.ZodOptional<z.ZodString>;
+      userName: z.ZodOptional<z.ZodString>;
+      status: z.ZodOptional<z.ZodString>;
+      routingOrder: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+  }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;
+declare const docusignConnectTemplateEventSchema: z.ZodObject<{
+  event: z.ZodEnum<{
+    "template-created": "template-created";
+    "template-modified": "template-modified";
+  }>;
+  apiVersion: z.ZodOptional<z.ZodString>;
+  configurationId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+  generatedDateTime: z.ZodOptional<z.ZodString>;
+  retryCount: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+  uri: z.ZodOptional<z.ZodString>;
+  data: z.ZodObject<{
+    accountId: z.ZodOptional<z.ZodString>;
+    templateId: z.ZodString;
+    templateSummary: z.ZodOptional<z.ZodObject<{
+      templateId: z.ZodOptional<z.ZodString>;
+      name: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+  }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;
+/**
+ * The root envelope that wraps every Connect delivery. We keep this loose so
+ * downstream `definitionFilter` can branch on `event` without failing parse
+ * when DocuSign adds a new event type — the specific per-event schemas above
+ * validate the narrowed shape inside each trigger.
+ */
+declare const docusignConnectEnvelopeSchema: z.ZodObject<{
+  event: z.ZodString;
+  apiVersion: z.ZodOptional<z.ZodString>;
+  configurationId: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+  generatedDateTime: z.ZodOptional<z.ZodString>;
+  retryCount: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+  uri: z.ZodOptional<z.ZodString>;
+  data: z.ZodObject<{
+    accountId: z.ZodOptional<z.ZodString>;
+    userId: z.ZodOptional<z.ZodString>;
+    envelopeId: z.ZodOptional<z.ZodString>;
+    recipientId: z.ZodOptional<z.ZodString>;
+    templateId: z.ZodOptional<z.ZodString>;
+    envelopeSummary: z.ZodOptional<z.ZodObject<{
+      envelopeId: z.ZodOptional<z.ZodString>;
+      status: z.ZodOptional<z.ZodString>;
+      emailSubject: z.ZodOptional<z.ZodString>;
+      emailBlurb: z.ZodOptional<z.ZodString>;
+      statusChangedDateTime: z.ZodOptional<z.ZodString>;
+      sentDateTime: z.ZodOptional<z.ZodString>;
+      completedDateTime: z.ZodOptional<z.ZodString>;
+      voidedReason: z.ZodOptional<z.ZodString>;
+      senderAccountId: z.ZodOptional<z.ZodString>;
+      senderUserId: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+    recipientSummary: z.ZodOptional<z.ZodObject<{
+      recipientId: z.ZodOptional<z.ZodString>;
+      recipientIdGuid: z.ZodOptional<z.ZodString>;
+      email: z.ZodOptional<z.ZodString>;
+      userName: z.ZodOptional<z.ZodString>;
+      status: z.ZodOptional<z.ZodString>;
+      routingOrder: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+    templateSummary: z.ZodOptional<z.ZodObject<{
+      templateId: z.ZodOptional<z.ZodString>;
+      name: z.ZodOptional<z.ZodString>;
+      description: z.ZodOptional<z.ZodString>;
+    }, z.core.$catchall<z.ZodUnknown>>>;
+  }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>;
+type DocusignConnectEnvelope = z.infer<typeof docusignConnectEnvelopeSchema>;
+type DocusignConnectEnvelopeEvent = z.infer<typeof docusignConnectEnvelopeEventSchema>;
+type DocusignConnectRecipientEvent = z.infer<typeof docusignConnectRecipientEventSchema>;
+type DocusignConnectTemplateEvent = z.infer<typeof docusignConnectTemplateEventSchema>;
+type DocusignConnectEventName = (typeof docusignConnectEventNames)[number];
+//#endregion
+export { DocusignConnectEnvelope, DocusignConnectEnvelopeEvent, DocusignConnectEventName, DocusignConnectRecipientEvent, DocusignConnectTemplateEvent, docusignConnectEnvelopeEventSchema, docusignConnectEnvelopeSchema, docusignConnectEventNameSchema, docusignConnectEventNames, docusignConnectRecipientEventSchema, docusignConnectTemplateEventSchema, docusignEnvelopeEventNames, docusignRecipientEventNames, docusignTemplateEventNames };

package/dist/events.mjs

@@ -0,0 +1,146 @@
+import { docusignLooseObjectSchema } from "./schemas/index.mjs";
+import { z } from "zod";
+
+//#region src/events.ts
+/**
+* DocuSign Connect webhook event schemas.
+*
+* Connect delivers envelope, recipient, and template lifecycle events as
+* JSON payloads under the `envelope-publish v2` format. These schemas
+* describe the shape operations receive after HMAC verification has passed.
+* The envelope union is deliberately loose where DocuSign returns polymorphic
+* sub-shapes that depend on the Connect configuration; inner fields are
+* parsed strictly where they're used for idempotency.
+*
+* See: https://developers.docusign.com/platform/webhooks/connect/event-model/
+*/
+const docusignEnvelopeEventNames = [
+	"envelope-sent",
+	"envelope-resent",
+	"envelope-delivered",
+	"envelope-signed",
+	"envelope-completed",
+	"envelope-declined",
+	"envelope-voided",
+	"envelope-corrected",
+	"envelope-discard",
+	"envelope-purge",
+	"envelope-reassign",
+	"envelope-deleted",
+	"envelope-documents-purged"
+];
+const docusignRecipientEventNames = [
+	"recipient-sent",
+	"recipient-resent",
+	"recipient-delivered",
+	"recipient-completed",
+	"recipient-declined",
+	"recipient-authenticationfailed",
+	"recipient-autoresponded",
+	"recipient-delegate",
+	"recipient-finish-later",
+	"recipient-reassign"
+];
+const docusignTemplateEventNames = ["template-created", "template-modified"];
+const docusignConnectEventNames = [
+	...docusignEnvelopeEventNames,
+	...docusignRecipientEventNames,
+	...docusignTemplateEventNames
+];
+const docusignConnectEventNameSchema = z.enum(docusignConnectEventNames);
+const envelopeSummarySchema = docusignLooseObjectSchema({
+	envelopeId: z.string().optional(),
+	status: z.string().optional(),
+	emailSubject: z.string().optional(),
+	emailBlurb: z.string().optional(),
+	statusChangedDateTime: z.string().optional(),
+	sentDateTime: z.string().optional(),
+	completedDateTime: z.string().optional(),
+	voidedReason: z.string().optional(),
+	senderAccountId: z.string().optional(),
+	senderUserId: z.string().optional()
+});
+const recipientSummarySchema = docusignLooseObjectSchema({
+	recipientId: z.string().optional(),
+	recipientIdGuid: z.string().optional(),
+	email: z.string().optional(),
+	userName: z.string().optional(),
+	status: z.string().optional(),
+	routingOrder: z.string().optional()
+});
+const templateSummarySchema = docusignLooseObjectSchema({
+	templateId: z.string().optional(),
+	name: z.string().optional(),
+	description: z.string().optional()
+});
+const docusignConnectEnvelopeEventSchema = z.object({
+	event: z.enum(docusignEnvelopeEventNames),
+	apiVersion: z.string().optional(),
+	configurationId: z.union([z.string(), z.number()]).optional(),
+	generatedDateTime: z.string().optional(),
+	retryCount: z.union([z.string(), z.number()]).optional(),
+	uri: z.string().optional(),
+	data: docusignLooseObjectSchema({
+		accountId: z.string().optional(),
+		userId: z.string().optional(),
+		envelopeId: z.string().min(1),
+		envelopeSummary: envelopeSummarySchema.optional()
+	})
+});
+const docusignConnectRecipientEventSchema = z.object({
+	event: z.enum(docusignRecipientEventNames),
+	apiVersion: z.string().optional(),
+	configurationId: z.union([z.string(), z.number()]).optional(),
+	generatedDateTime: z.string().optional(),
+	retryCount: z.union([z.string(), z.number()]).optional(),
+	uri: z.string().optional(),
+	data: docusignLooseObjectSchema({
+		accountId: z.string().optional(),
+		userId: z.string().optional(),
+		envelopeId: z.string().min(1),
+		recipientId: z.string().optional(),
+		recipientIdGuid: z.string().optional(),
+		envelopeSummary: envelopeSummarySchema.optional(),
+		recipientSummary: recipientSummarySchema.optional()
+	})
+});
+const docusignConnectTemplateEventSchema = z.object({
+	event: z.enum(docusignTemplateEventNames),
+	apiVersion: z.string().optional(),
+	configurationId: z.union([z.string(), z.number()]).optional(),
+	generatedDateTime: z.string().optional(),
+	retryCount: z.union([z.string(), z.number()]).optional(),
+	uri: z.string().optional(),
+	data: docusignLooseObjectSchema({
+		accountId: z.string().optional(),
+		templateId: z.string().min(1),
+		templateSummary: templateSummarySchema.optional()
+	})
+});
+/**
+* The root envelope that wraps every Connect delivery. We keep this loose so
+* downstream `definitionFilter` can branch on `event` without failing parse
+* when DocuSign adds a new event type — the specific per-event schemas above
+* validate the narrowed shape inside each trigger.
+*/
+const docusignConnectEnvelopeSchema = z.object({
+	event: z.string().min(1),
+	apiVersion: z.string().optional(),
+	configurationId: z.union([z.string(), z.number()]).optional(),
+	generatedDateTime: z.string().optional(),
+	retryCount: z.union([z.string(), z.number()]).optional(),
+	uri: z.string().optional(),
+	data: docusignLooseObjectSchema({
+		accountId: z.string().optional(),
+		userId: z.string().optional(),
+		envelopeId: z.string().optional(),
+		recipientId: z.string().optional(),
+		templateId: z.string().optional(),
+		envelopeSummary: envelopeSummarySchema.optional(),
+		recipientSummary: recipientSummarySchema.optional(),
+		templateSummary: templateSummarySchema.optional()
+	})
+});
+
+//#endregion
+export { docusignConnectEnvelopeEventSchema, docusignConnectEnvelopeSchema, docusignConnectEventNameSchema, docusignConnectEventNames, docusignConnectRecipientEventSchema, docusignConnectTemplateEventSchema, docusignEnvelopeEventNames, docusignRecipientEventNames, docusignTemplateEventNames };

package/dist/factory-wViQTjgN.mjs

@@ -0,0 +1,8 @@
+import { t as docusign } from "./integration-CmRztL9R.mjs";
+import { createOfficialOperationFactory } from "@keystrokehq/integration-authoring/official";
+
+//#region src/factory.ts
+const docusignOperation = createOfficialOperationFactory(docusign);
+
+//#endregion
+export { docusignOperation as t };