@superdurable/connector-docusign 0.0.0-stage → 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,553 @@
+import { C as CreateEnvelopeFromTemplateInput, a as CreatedEnvelope, b as Connection, D as DownloadCombinedDocumentInput, c as CombinedDocument, G as GetEnvelopeInput, E as Envelope, L as ListEnvelopeRecipientsInput, d as EnvelopeRecipients, V as VoidEnvelopeInput, e as VoidedEnvelope, f as CredentialSource, g as Credentials, h as Config, O as Operations, i as EnvelopeCustomField } from './connection-BFvLyRgn.js';
+export { j as CombinedDocumentSchema, k as ConfigSchema, l as CreateEnvelopeFromTemplateInputSchema, m as CreatedEnvelopeSchema, n as DownloadCombinedDocumentInputSchema, o as EnvelopeCustomFieldSchema, p as EnvelopeRecipientsSchema, q as EnvelopeSchema, r as GetEnvelopeInputSchema, s as ListEnvelopeRecipientsInputSchema, R as Recipient, t as RecipientSchema, T as TemplateRole, u as TemplateRoleSchema, v as VoidEnvelopeInputSchema, w as VoidedEnvelopeSchema, x as decodeCredentials, y as decodeSharedCredentials, z as newConnection, A as newConnectionWithOperations } from './connection-BFvLyRgn.js';
+import * as _superdurable_connectors_sdk from '@superdurable/connectors-sdk';
+import { MutationDefinition, QueryDefinition, MutationStepConfig, Mutation, MutationResult, QueryStepConfig, Query, QueryResult, MutationStep, QueryStep, Call, QueryAttempt, MutationAttempt, TriggerLogger, Failure, ReceiptDraft, TriggerEvent, TriggerTarget, TriggerRunner, TriggerContext, ConnectorConfigurationUI, TriggerDefinition, TriggerBindingDefinition } from '@superdurable/connectors-sdk';
+import { StepTarget } from '@superdurable/dex';
+import { LoadedProject, TriggerInboxKey, Configuration } from '@superdurable/connectors-sdk/projectconfig';
+import { ProviderRequest, ProviderResponse } from '@superdurable/connectors-sdk/providerhttp';
+import { ManifestCredentialRefreshDriver } from '@superdurable/connectors-sdk/oauthtoken';
+import { IncomingHttpHeaders, IncomingMessage, ServerResponse } from 'node:http';
+import { z } from 'zod';
+import { WebhookEndpoint } from '@superdurable/connectors-sdk/webhooktrigger';
+
+/** Stable connector identity. */
+declare const ConnectorID = "docusign";
+/** Provider identity for named connections. */
+declare const ProviderID = "docusign";
+/** Branch IDs for createEnvelopeFromTemplate. */
+declare const CreateEnvelopeFromTemplateBranch: {
+    readonly Created: "created";
+    readonly ProviderRejected: "providerRejected";
+    readonly Uncertain: "uncertain";
+    readonly Defect: "defect";
+};
+/** DocuSign holds the envelope this Step execution created; wasRecovered tells whether a later attempt found it by its custom field after an interrupted one. */
+declare const CreateEnvelopeFromTemplateBranchCreated: "created";
+/** DocuSign conclusively rejected the envelope, such as an unknown template, an unfilled or unknown role, an invalid email address, an exhausted envelope allowance, or a user who may not send; nothing was created. */
+declare const CreateEnvelopeFromTemplateBranchProviderRejected: "providerRejected";
+/** The create request was sent but DocuSign's answer was lost, a server error, or unreadable, and no envelope with this Step's custom field could be found, so an envelope may exist that this Result does not name; do not create another automatically. */
+declare const CreateEnvelopeFromTemplateBranchUncertain: "uncertain";
+/** Local input, connection configuration, or connector definition is invalid. */
+declare const CreateEnvelopeFromTemplateBranchDefect: "defect";
+/** Manifest definition for createEnvelopeFromTemplate. */
+declare const CreateEnvelopeFromTemplateDefinition: MutationDefinition;
+/** Manifest metadata for createEnvelopeFromTemplate. */
+declare const CreateEnvelopeFromTemplateMetadata: {
+    readonly kind: "mutation";
+    readonly idempotency: "required";
+    readonly authorization: "required";
+};
+/** Branch IDs for getEnvelope. */
+declare const GetEnvelopeBranch: {
+    readonly Found: "found";
+    readonly NotFound: "notFound";
+    readonly ProviderRejected: "providerRejected";
+    readonly InvalidResponse: "invalidResponse";
+    readonly Defect: "defect";
+};
+/** DocuSign returned the envelope. */
+declare const GetEnvelopeBranchFound: "found";
+/** The envelope does not exist in the connection's account or the user may not see it. */
+declare const GetEnvelopeBranchNotFound: "notFound";
+/** DocuSign conclusively rejected the read, such as a revoked consent or a user without access to the account. */
+declare const GetEnvelopeBranchProviderRejected: "providerRejected";
+/** DocuSign returned a malformed or oversized response. */
+declare const GetEnvelopeBranchInvalidResponse: "invalidResponse";
+/** Local input, connection configuration, or connector definition is invalid. */
+declare const GetEnvelopeBranchDefect: "defect";
+/** Manifest definition for getEnvelope. */
+declare const GetEnvelopeDefinition: QueryDefinition;
+/** Manifest metadata for getEnvelope. */
+declare const GetEnvelopeMetadata: {
+    readonly kind: "query";
+    readonly idempotency: "none";
+    readonly authorization: "required";
+};
+/** Branch IDs for listEnvelopeRecipients. */
+declare const ListEnvelopeRecipientsBranch: {
+    readonly Listed: "listed";
+    readonly NotFound: "notFound";
+    readonly ProviderRejected: "providerRejected";
+    readonly InvalidResponse: "invalidResponse";
+    readonly Defect: "defect";
+};
+/** DocuSign returned the envelope's recipients. */
+declare const ListEnvelopeRecipientsBranchListed: "listed";
+/** The envelope does not exist in the connection's account or the user may not see it. */
+declare const ListEnvelopeRecipientsBranchNotFound: "notFound";
+/** DocuSign conclusively rejected the read, such as a revoked consent or a user without access to the account. */
+declare const ListEnvelopeRecipientsBranchProviderRejected: "providerRejected";
+/** DocuSign returned a malformed or oversized response. */
+declare const ListEnvelopeRecipientsBranchInvalidResponse: "invalidResponse";
+/** Local input, connection configuration, or connector definition is invalid. */
+declare const ListEnvelopeRecipientsBranchDefect: "defect";
+/** Manifest definition for listEnvelopeRecipients. */
+declare const ListEnvelopeRecipientsDefinition: QueryDefinition;
+/** Manifest metadata for listEnvelopeRecipients. */
+declare const ListEnvelopeRecipientsMetadata: {
+    readonly kind: "query";
+    readonly idempotency: "none";
+    readonly authorization: "required";
+};
+/** Branch IDs for voidEnvelope. */
+declare const VoidEnvelopeBranch: {
+    readonly Voided: "voided";
+    readonly NotVoidable: "notVoidable";
+    readonly NotFound: "notFound";
+    readonly ProviderRejected: "providerRejected";
+    readonly InvalidResponse: "invalidResponse";
+    readonly Defect: "defect";
+};
+/** The envelope is voided, by this call or earlier; wasAlreadyVoided tells which. */
+declare const VoidEnvelopeBranchVoided: "voided";
+/** The envelope is completed, declined, or still a draft, which DocuSign does not void; status names which. */
+declare const VoidEnvelopeBranchNotVoidable: "notVoidable";
+/** The envelope does not exist in the connection's account or the user may not see it. */
+declare const VoidEnvelopeBranchNotFound: "notFound";
+/** DocuSign conclusively rejected the void, such as a user who is not the sender or lacks permission. */
+declare const VoidEnvelopeBranchProviderRejected: "providerRejected";
+/** DocuSign returned a malformed or oversized response. */
+declare const VoidEnvelopeBranchInvalidResponse: "invalidResponse";
+/** Local input, connection configuration, or connector definition is invalid. */
+declare const VoidEnvelopeBranchDefect: "defect";
+/** Manifest definition for voidEnvelope. */
+declare const VoidEnvelopeDefinition: MutationDefinition;
+/** Manifest metadata for voidEnvelope. */
+declare const VoidEnvelopeMetadata: {
+    readonly kind: "mutation";
+    readonly idempotency: "required";
+    readonly authorization: "required";
+};
+/** Branch IDs for downloadCombinedDocument. */
+declare const DownloadCombinedDocumentBranch: {
+    readonly Downloaded: "downloaded";
+    readonly NotFound: "notFound";
+    readonly TooLarge: "tooLarge";
+    readonly ProviderRejected: "providerRejected";
+    readonly InvalidResponse: "invalidResponse";
+    readonly Defect: "defect";
+};
+/** DocuSign returned the combined PDF and its digest was recorded, and stored when the client has a CombinedDocumentStore. */
+declare const DownloadCombinedDocumentBranchDownloaded: "downloaded";
+/** The envelope does not exist in the connection's account or the user may not see it. */
+declare const DownloadCombinedDocumentBranchNotFound: "notFound";
+/** The combined PDF exceeds the connection's maxDocumentBytes; nothing was stored. */
+declare const DownloadCombinedDocumentBranchTooLarge: "tooLarge";
+/** DocuSign conclusively rejected the download, such as a revoked consent or a user without access to the envelope. */
+declare const DownloadCombinedDocumentBranchProviderRejected: "providerRejected";
+/** DocuSign returned something other than a complete PDF, or the CombinedDocumentStore rejected it. */
+declare const DownloadCombinedDocumentBranchInvalidResponse: "invalidResponse";
+/** Local input, connection configuration, or connector definition is invalid. */
+declare const DownloadCombinedDocumentBranchDefect: "defect";
+/** Manifest definition for downloadCombinedDocument. */
+declare const DownloadCombinedDocumentDefinition: QueryDefinition;
+/** Manifest metadata for downloadCombinedDocument. */
+declare const DownloadCombinedDocumentMetadata: {
+    readonly kind: "query";
+    readonly idempotency: "none";
+    readonly authorization: "required";
+};
+
+/** Configuration for the createEnvelopeFromTemplate connector Step. */
+interface CreateEnvelopeFromTemplateStepConfig<StepInput, OperationInput = CreateEnvelopeFromTemplateInput, OperationOutput = CreatedEnvelope> extends Omit<MutationStepConfig<StepInput, OperationInput, OperationOutput>, 'operation' | 'connection' | 'branches'> {
+    /** Named connection supplying this operation. */
+    connection: Connection<{
+        createEnvelopeFromTemplate(): Mutation<OperationInput, OperationOutput>;
+    }>;
+    /** Name matching the bound connection. */
+    connectionName: string;
+    /** DocuSign holds the envelope this Step execution created; wasRecovered tells whether a later attempt found it by its custom field after an interrupted one. */
+    created: StepTarget<MutationResult<OperationOutput>>;
+    /** DocuSign conclusively rejected the envelope, such as an unknown template, an unfilled or unknown role, an invalid email address, an exhausted envelope allowance, or a user who may not send; nothing was created. */
+    providerRejected?: StepTarget<MutationResult<OperationOutput>>;
+    /** The create request was sent but DocuSign's answer was lost, a server error, or unreadable, and no envelope with this Step's custom field could be found, so an envelope may exist that this Result does not name; do not create another automatically. */
+    uncertain?: StepTarget<MutationResult<OperationOutput>>;
+    /** Local input, connection configuration, or connector definition is invalid. */
+    defect?: StepTarget<MutationResult<OperationOutput>>;
+}
+/** Build the createEnvelopeFromTemplate Step from a named connection. */
+declare function newCreateEnvelopeFromTemplateStep<StepInput, OperationInput = CreateEnvelopeFromTemplateInput, OperationOutput = CreatedEnvelope>(configuration: CreateEnvelopeFromTemplateStepConfig<StepInput, OperationInput, OperationOutput>): MutationStep<StepInput, OperationInput, OperationOutput>;
+/** Configuration for the getEnvelope connector Step. */
+interface GetEnvelopeStepConfig<StepInput, OperationInput = GetEnvelopeInput, OperationOutput = Envelope> extends Omit<QueryStepConfig<StepInput, OperationInput, OperationOutput>, 'operation' | 'connection' | 'branches'> {
+    /** Named connection supplying this operation. */
+    connection: Connection<{
+        getEnvelope(): Query<OperationInput, OperationOutput>;
+    }>;
+    /** Name matching the bound connection. */
+    connectionName: string;
+    /** DocuSign returned the envelope. */
+    found: StepTarget<QueryResult<OperationOutput>>;
+    /** The envelope does not exist in the connection's account or the user may not see it. */
+    notFound?: StepTarget<QueryResult<OperationOutput>>;
+    /** DocuSign conclusively rejected the read, such as a revoked consent or a user without access to the account. */
+    providerRejected?: StepTarget<QueryResult<OperationOutput>>;
+    /** DocuSign returned a malformed or oversized response. */
+    invalidResponse?: StepTarget<QueryResult<OperationOutput>>;
+    /** Local input, connection configuration, or connector definition is invalid. */
+    defect?: StepTarget<QueryResult<OperationOutput>>;
+}
+/** Build the getEnvelope Step from a named connection. */
+declare function newGetEnvelopeStep<StepInput, OperationInput = GetEnvelopeInput, OperationOutput = Envelope>(configuration: GetEnvelopeStepConfig<StepInput, OperationInput, OperationOutput>): QueryStep<StepInput, OperationInput, OperationOutput>;
+/** Configuration for the listEnvelopeRecipients connector Step. */
+interface ListEnvelopeRecipientsStepConfig<StepInput, OperationInput = ListEnvelopeRecipientsInput, OperationOutput = EnvelopeRecipients> extends Omit<QueryStepConfig<StepInput, OperationInput, OperationOutput>, 'operation' | 'connection' | 'branches'> {
+    /** Named connection supplying this operation. */
+    connection: Connection<{
+        listEnvelopeRecipients(): Query<OperationInput, OperationOutput>;
+    }>;
+    /** Name matching the bound connection. */
+    connectionName: string;
+    /** DocuSign returned the envelope's recipients. */
+    listed: StepTarget<QueryResult<OperationOutput>>;
+    /** The envelope does not exist in the connection's account or the user may not see it. */
+    notFound?: StepTarget<QueryResult<OperationOutput>>;
+    /** DocuSign conclusively rejected the read, such as a revoked consent or a user without access to the account. */
+    providerRejected?: StepTarget<QueryResult<OperationOutput>>;
+    /** DocuSign returned a malformed or oversized response. */
+    invalidResponse?: StepTarget<QueryResult<OperationOutput>>;
+    /** Local input, connection configuration, or connector definition is invalid. */
+    defect?: StepTarget<QueryResult<OperationOutput>>;
+}
+/** Build the listEnvelopeRecipients Step from a named connection. */
+declare function newListEnvelopeRecipientsStep<StepInput, OperationInput = ListEnvelopeRecipientsInput, OperationOutput = EnvelopeRecipients>(configuration: ListEnvelopeRecipientsStepConfig<StepInput, OperationInput, OperationOutput>): QueryStep<StepInput, OperationInput, OperationOutput>;
+/** Configuration for the voidEnvelope connector Step. */
+interface VoidEnvelopeStepConfig<StepInput, OperationInput = VoidEnvelopeInput, OperationOutput = VoidedEnvelope> extends Omit<MutationStepConfig<StepInput, OperationInput, OperationOutput>, 'operation' | 'connection' | 'branches'> {
+    /** Named connection supplying this operation. */
+    connection: Connection<{
+        voidEnvelope(): Mutation<OperationInput, OperationOutput>;
+    }>;
+    /** Name matching the bound connection. */
+    connectionName: string;
+    /** The envelope is voided, by this call or earlier; wasAlreadyVoided tells which. */
+    voided: StepTarget<MutationResult<OperationOutput>>;
+    /** The envelope is completed, declined, or still a draft, which DocuSign does not void; status names which. */
+    notVoidable?: StepTarget<MutationResult<OperationOutput>>;
+    /** The envelope does not exist in the connection's account or the user may not see it. */
+    notFound?: StepTarget<MutationResult<OperationOutput>>;
+    /** DocuSign conclusively rejected the void, such as a user who is not the sender or lacks permission. */
+    providerRejected?: StepTarget<MutationResult<OperationOutput>>;
+    /** DocuSign returned a malformed or oversized response. */
+    invalidResponse?: StepTarget<MutationResult<OperationOutput>>;
+    /** Local input, connection configuration, or connector definition is invalid. */
+    defect?: StepTarget<MutationResult<OperationOutput>>;
+}
+/** Build the voidEnvelope Step from a named connection. */
+declare function newVoidEnvelopeStep<StepInput, OperationInput = VoidEnvelopeInput, OperationOutput = VoidedEnvelope>(configuration: VoidEnvelopeStepConfig<StepInput, OperationInput, OperationOutput>): MutationStep<StepInput, OperationInput, OperationOutput>;
+/** Configuration for the downloadCombinedDocument connector Step. */
+interface DownloadCombinedDocumentStepConfig<StepInput, OperationInput = DownloadCombinedDocumentInput, OperationOutput = CombinedDocument> extends Omit<QueryStepConfig<StepInput, OperationInput, OperationOutput>, 'operation' | 'connection' | 'branches'> {
+    /** Named connection supplying this operation. */
+    connection: Connection<{
+        downloadCombinedDocument(): Query<OperationInput, OperationOutput>;
+    }>;
+    /** Name matching the bound connection. */
+    connectionName: string;
+    /** DocuSign returned the combined PDF and its digest was recorded, and stored when the client has a CombinedDocumentStore. */
+    downloaded: StepTarget<QueryResult<OperationOutput>>;
+    /** The envelope does not exist in the connection's account or the user may not see it. */
+    notFound?: StepTarget<QueryResult<OperationOutput>>;
+    /** The combined PDF exceeds the connection's maxDocumentBytes; nothing was stored. */
+    tooLarge?: StepTarget<QueryResult<OperationOutput>>;
+    /** DocuSign conclusively rejected the download, such as a revoked consent or a user without access to the envelope. */
+    providerRejected?: StepTarget<QueryResult<OperationOutput>>;
+    /** DocuSign returned something other than a complete PDF, or the CombinedDocumentStore rejected it. */
+    invalidResponse?: StepTarget<QueryResult<OperationOutput>>;
+    /** Local input, connection configuration, or connector definition is invalid. */
+    defect?: StepTarget<QueryResult<OperationOutput>>;
+}
+/** Build the downloadCombinedDocument Step from a named connection. */
+declare function newDownloadCombinedDocumentStep<StepInput, OperationInput = DownloadCombinedDocumentInput, OperationOutput = CombinedDocument>(configuration: DownloadCombinedDocumentStepConfig<StepInput, OperationInput, OperationOutput>): QueryStep<StepInput, OperationInput, OperationOutput>;
+
+/** Create a server-template envelope with read-back after an unconfirmed POST. */
+declare class CreateEnvelopeFromTemplateOperation implements Mutation<CreateEnvelopeFromTemplateInput, CreatedEnvelope> {
+    private readonly client;
+    /** Bind the authenticated DocuSign client. */
+    constructor(client: DocuSignClient);
+    /** Return manifest routes and Execute defaults. */
+    definition(): _superdurable_connectors_sdk.MutationDefinition;
+    /** Use the stable Dex Call ID as the hidden deduplication marker. */
+    idempotencyKey(callId: string): string;
+    /** Invoke one safe-to-classify create attempt. */
+    invoke(call: Call, input: CreateEnvelopeFromTemplateInput): Promise<MutationAttempt<CreatedEnvelope>>;
+}
+/** Read one envelope with custom fields. */
+declare class GetEnvelopeOperation implements Query<GetEnvelopeInput, Envelope> {
+    private readonly client;
+    /** Bind the authenticated DocuSign client. */
+    constructor(client: DocuSignClient);
+    /** Return manifest routes and Execute defaults. */
+    definition(): _superdurable_connectors_sdk.QueryDefinition;
+    /** Invoke one envelope read. */
+    invoke(call: Call, input: GetEnvelopeInput): Promise<QueryAttempt<Envelope>>;
+}
+/** Flatten DocuSign recipient collections into routing order. */
+declare class ListEnvelopeRecipientsOperation implements Query<ListEnvelopeRecipientsInput, EnvelopeRecipients> {
+    private readonly client;
+    /** Bind the authenticated DocuSign client. */
+    constructor(client: DocuSignClient);
+    /** Return manifest routes and Execute defaults. */
+    definition(): _superdurable_connectors_sdk.QueryDefinition;
+    /** Invoke one recipients read. */
+    invoke(call: Call, input: ListEnvelopeRecipientsInput): Promise<QueryAttempt<EnvelopeRecipients>>;
+}
+/** Void an envelope or read back a status refusal. */
+declare class VoidEnvelopeOperation implements Mutation<VoidEnvelopeInput, VoidedEnvelope> {
+    private readonly client;
+    /** Bind the authenticated DocuSign client. */
+    constructor(client: DocuSignClient);
+    /** Return manifest routes and Execute defaults. */
+    definition(): _superdurable_connectors_sdk.MutationDefinition;
+    /** Use the stable Call ID for this safely repeatable PUT. */
+    idempotencyKey(callId: string): string;
+    /** Invoke one void attempt. */
+    invoke(call: Call, input: VoidEnvelopeInput): Promise<MutationAttempt<VoidedEnvelope>>;
+}
+/** Download and digest a combined PDF without persisting its bytes in Dex. */
+declare class DownloadCombinedDocumentOperation implements Query<DownloadCombinedDocumentInput, CombinedDocument> {
+    private readonly client;
+    /** Bind the authenticated DocuSign client. */
+    constructor(client: DocuSignClient);
+    /** Return manifest routes and Execute defaults. */
+    definition(): _superdurable_connectors_sdk.QueryDefinition;
+    /** Invoke one combined PDF read. */
+    invoke(call: Call, input: DownloadCombinedDocumentInput): Promise<QueryAttempt<CombinedDocument>>;
+}
+
+/** Reference handed to an application-owned combined PDF store. */
+interface CombinedDocumentReference {
+    /** Account that owns the PDF. */ accountId: string;
+    /** Envelope whose documents were combined. */ envelopeId: string;
+    /** Whether the certificate of completion is included. */ includesCertificate: boolean;
+}
+/** Store a complete PDF outside Dex payloads and return a safe, stable location. */
+interface CombinedDocumentStore {
+    /** Consume the whole stream atomically and return a repeat-safe location. */
+    storeCombinedDocument(reference: CombinedDocumentReference, content: AsyncIterable<Uint8Array>): Promise<string>;
+}
+/** Replace the transport, clock, or document store for an application or provider test. */
+interface DocuSignClientOptions {
+    /** Override the bounded JSON request transport. */
+    send?: (request: ProviderRequest) => Promise<ProviderResponse>;
+    /** Override the clock used for receipts and rate limits. */
+    now?: () => Date;
+    /** Persist a combined PDF outside Dex payloads. */
+    documentStore?: CombinedDocumentStore;
+    /** Receive the envelopeEventReceived Trigger's delivery records; omitted uses the SDK's console logger. */
+    logger?: TriggerLogger;
+}
+/** One provider answer; oversized applies only to successful JSON bodies. */
+interface DocuSignResponse {
+    /** HTTP status. */ status: number;
+    /** Response headers. */ headers: ProviderResponse['headers'];
+    /** Bounded response bytes. */ body: Uint8Array;
+    /** Whether a successful body exceeded its limit. */ isTooLarge: boolean;
+}
+/** Open successful PDF stream or a bounded non-success answer. */
+type DocumentResponse = {
+    stream: AsyncIterable<Uint8Array>;
+    headers: ProviderResponse['headers'];
+    close(): Promise<void>;
+} | {
+    rejected: DocuSignResponse;
+};
+/** Session credentials and the account selected by DocuSign userinfo. */
+interface DocuSignSession {
+    /** Credentials for this call. */ credentials: Credentials;
+    /** Selected API account ID. */ accountId: string;
+    /** Validated regional API base URI. */ baseUri: string;
+}
+/** Sanitized classification of a provider refusal. */
+interface DocuSignOutcome {
+    /** Whether Dex can safely retry. */ retry: boolean;
+    /** Whether the provider found no matching object. */ notFound: boolean;
+    /** Provider requested retry delay in milliseconds. */ retryAfterMs: number;
+    /** Safe provider error code. */ errorCode: string;
+    /** Persistable failure without provider message text. */ failure: Failure;
+}
+/** Authenticated DocuSign eSignature client bound to one Dex connection. */
+declare class DocuSignClient {
+    readonly credentials: CredentialSource;
+    readonly maxResponseBytes: number;
+    readonly maxDocumentBytes: number;
+    readonly documentStore: CombinedDocumentStore | undefined;
+    /** Largest Connect request body the envelopeEventReceived endpoint accepts. */
+    readonly connectMaxBodyBytes: number;
+    /** Destination of the envelopeEventReceived Trigger's records. */
+    readonly triggerLogger: TriggerLogger;
+    private readonly accountId;
+    private readonly send;
+    private readonly hasCustomSend;
+    private readonly now;
+    private readonly accountCache;
+    /** @internal Refreshes expiring OAuth credentials for operations and the Connect endpoint. */
+    readonly refreshDriver: ManifestCredentialRefreshDriver<Credentials>;
+    /** Validate connection settings and bind host-owned renewable credentials. */
+    constructor(config: Config, credentials: CredentialSource, options?: DocuSignClientOptions);
+    /** Bind the template creation Mutation. */
+    createEnvelopeFromTemplate(): CreateEnvelopeFromTemplateOperation;
+    /** Bind the envelope Query. */
+    getEnvelope(): GetEnvelopeOperation;
+    /** Bind the recipients Query. */
+    listEnvelopeRecipients(): ListEnvelopeRecipientsOperation;
+    /** Bind the void Mutation. */
+    voidEnvelope(): VoidEnvelopeOperation;
+    /** Bind the combined PDF Query. */
+    downloadCombinedDocument(): DownloadCombinedDocumentOperation;
+    /** Resolve renewable credentials and DocuSign's own account host. */
+    openSession(call: Call, operation: string): Promise<DocuSignSession>;
+    /** Send one eSignature request after account selection. */
+    requestAPI(call: Call, session: DocuSignSession, method: string, path: string, query?: Record<string, string>, body?: unknown, accept?: string, limit?: number, timeoutMs?: number): Promise<DocuSignResponse>;
+    /** Open the combined PDF without buffering a successful response in Dex memory. */
+    openDocument(call: Call, session: DocuSignSession, envelopeId: string, includeCertificate: boolean): Promise<DocumentResponse>;
+    /** Classify one conclusive refusal without exposing provider messages. */
+    classify(operation: string, response: DocuSignResponse): DocuSignOutcome;
+    /** Build a provider receipt with only safe envelope identity and error code. */
+    receipt(envelopeId: string, errorCode?: string): ReceiptDraft;
+    /** Return the injected clock for recovery windows and receipts. */
+    currentTime(): Date;
+    private request;
+}
+
+/** Open a named DocuSign connection with generated private and shared credential decoders. */
+declare function newProjectConnection(project: LoadedProject, connectionName: string, options?: DocuSignClientOptions): Connection<Operations>;
+
+/** The Connect event sent when every recipient finished. */
+declare const ConnectEventEnvelopeCompleted = "envelope-completed";
+/** The Connect event sent when a recipient declined. */
+declare const ConnectEventEnvelopeDeclined = "envelope-declined";
+/** The Connect event sent when the sender voided the envelope or it expired. */
+declare const ConnectEventEnvelopeVoided = "envelope-voided";
+/** The Connect events the envelopeEventReceived Trigger records. */
+declare const ConnectEnvelopeEvents: readonly string[];
+/** One envelope Connect event name. */
+type ConnectEnvelopeEvent = typeof ConnectEventEnvelopeCompleted | typeof ConnectEventEnvelopeDeclined | typeof ConnectEventEnvelopeVoided;
+/**
+ * Filters the Connect events one binding records. An empty or omitted events list records every
+ * envelope-completed, envelope-declined, and envelope-voided event. It reduces what a binding stores; the
+ * application's TriggerFilter remains its admission rule.
+ */
+declare const EnvelopeEventReceivedTriggerConfigurationSchema: z.ZodObject<{
+    events: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+}, z.core.$strict>;
+/** Event filter of one envelopeEventReceived binding. */
+type EnvelopeEventReceivedTriggerConfiguration = z.infer<typeof EnvelopeEventReceivedTriggerConfigurationSchema>;
+/**
+ * One HMAC-verified Connect envelope event in the JSON SIM format; field names and order match the Go
+ * connector. Its Trigger event ID is the envelope ID and the event name, such as
+ * 93be49ab-0000-0000-0000-f752070d71ec:envelope-completed, so a Connect retry or a second Connect
+ * configuration delivering the same outcome keeps one ID.
+ */
+interface EnvelopeEvent {
+    /** envelope-completed, envelope-declined, or envelope-voided. */ event: string;
+    /** The envelope's lowercase GUID. */ envelopeId: string;
+    /** The sender's lowercase DocuSign API account GUID. */ accountId: string;
+    /** When Connect generated the message, or when the endpoint received it if Connect left it blank, as RFC 3339 UTC. */ generatedAt: string;
+    /** The envelope summary's lowercase status; absent unless the Connect configuration includes envelope data. */ status?: Envelope['status'];
+    /** The envelope summary's void reason for an envelope-voided event, when included. */ voidedReason?: string;
+    /** The envelope's text custom fields; absent unless the Connect configuration's Include Data lists Custom Fields. */ customFields?: EnvelopeCustomField[];
+}
+/** Runtime validator of a replayed EnvelopeEvent payload. */
+declare const EnvelopeEventSchema: z.ZodPipe<z.ZodObject<{
+    event: z.ZodString;
+    envelopeId: z.ZodString;
+    accountId: z.ZodString;
+    generatedAt: z.ZodString;
+    status: z.ZodOptional<z.ZodString>;
+    voidedReason: z.ZodOptional<z.ZodString>;
+    customFields: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        value: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>, z.ZodTransform<EnvelopeEvent, {
+    event: string;
+    envelopeId: string;
+    accountId: string;
+    generatedAt: string;
+    status?: string | undefined;
+    voidedReason?: string | undefined;
+    customFields?: {
+        name: string;
+        value: string;
+    }[] | undefined;
+}>>;
+/** Return the value of the event's named text custom field, or undefined when it has none. */
+declare function envelopeEventCustomFieldValue(event: EnvelopeEvent, name: string): string | undefined;
+/** A Connect message that is not a JSON SIM envelope event with GUID identities. */
+declare class ConnectMessageMalformedError extends Error {
+    constructor();
+}
+/** No X-DocuSign-Signature-N header matches the HMAC-SHA256 of the body. */
+declare class ConnectSignatureInvalidError extends Error {
+    constructor();
+}
+/** Accept any X-DocuSign-Signature-N whose standard base64 equals the body's HMAC-SHA256 under hmacKey. */
+declare function verifyConnectSignature(body: Uint8Array, headers: IncomingHttpHeaders, hmacKey: string): void;
+/**
+ * Decode a JSON SIM envelope outcome received at receivedAt. Another valid Connect event returns
+ * undefined, so the endpoint acknowledges it unrecorded; anything else throws ConnectMessageMalformedError.
+ */
+declare function decodeConnectMessage(body: Uint8Array, receivedAt: Date): TriggerEvent<EnvelopeEvent> | undefined;
+
+/** Manifest definition of envelopeEventReceived. */
+declare const EnvelopeEventReceivedTriggerDefinition: TriggerDefinition;
+/** One static application binding of envelopeEventReceived. */
+interface EnvelopeEventReceivedTriggerBindingConfig {
+    /** Static connection name. */ connectionName: string;
+    /** Static binding name. */ bindingName: string;
+    /** Optional Connector Studio configuration units; the connector declares none, so Dex Web saves the binding as {}, which records all three outcomes. */ configurationUI?: ConnectorConfigurationUI;
+}
+/** Declare a static envelopeEventReceived binding for Flow Definition tooling and Dex Web. */
+declare function defineEnvelopeEventReceivedTriggerBinding(config: EnvelopeEventReceivedTriggerBindingConfig): TriggerBindingDefinition;
+/** Configuration of one standalone envelopeEventReceived Trigger. */
+interface EnvelopeEventReceivedTriggerConfig {
+    /** DocuSign connection from newProjectConnection or newConnection with a DocuSignClient. */ connection: Connection;
+    /** Static connection name; must equal the connection's name. */ connectionName: string;
+    /** Static binding name. */ bindingName: string;
+    /** The binding's event filter. */ configuration: EnvelopeEventReceivedTriggerConfiguration;
+    /** Routes accepted events into the application. */ target: TriggerTarget<EnvelopeEvent>;
+}
+/**
+ * Create one envelopeEventReceived Trigger fed by the connection's shared Connect endpoint, which
+ * envelopeEventReceivedWebhookEndpoint returns for the application to mount. Every Trigger of one
+ * connection shares that endpoint. Throws a TypeError or the schema's error on invalid wiring.
+ */
+declare function newEnvelopeEventReceivedTrigger(config: EnvelopeEventReceivedTriggerConfig): TriggerRunner;
+/**
+ * Return the connection's Connect endpoint, creating it on first use, for an application to mount at the
+ * URL to Publish of its Connect configuration. Every envelopeEventReceived Trigger built from this
+ * connection feeds from it. It answers 503 while none of them runs and without a connect_hmac_key, so
+ * Connect retries; 400 for a bad signature or a body that is not JSON SIM; 413 above connectMaxBodyBytes,
+ * before the signature is checked; and 200 for another Connect event, unrecorded.
+ */
+declare function envelopeEventReceivedWebhookEndpoint(connection: Connection): WebhookEndpoint<Credentials, EnvelopeEvent>;
+/** One envelopeEventReceived binding from the project configuration and its application target. */
+interface ProjectEnvelopeEventReceivedTriggerRoute {
+    /** Configured binding name whose configuration filters the events. */ bindingName: string;
+    /** Receives the binding's events through its durable project inbox, such as a newDexRPCTriggerTarget that resumes the waiting Flow. */ target: TriggerTarget<EnvelopeEvent>;
+}
+/**
+ * Serves one connection's Connect endpoint while running its bindings. Mount serveHTTP at the Connect
+ * configuration's URL to Publish and run it for the life of the process. It is safe for concurrent requests.
+ */
+declare class EnvelopeEventReceivedEndpointRunner {
+    #private;
+    /** @internal Use newProjectEnvelopeEventReceivedEndpointRunner. */
+    constructor(endpoint: WebhookEndpoint<Credentials, EnvelopeEvent>, runners: readonly TriggerRunner[]);
+    /** Verify, record, and acknowledge one Connect delivery. It answers 503 until run has replayed every binding's pending events and started receiving, so Connect retries. */
+    serveHTTP(request: IncomingMessage, response: ServerResponse): Promise<void>;
+    /** Replay each binding's durable inbox, then deliver new events until the context ends, rejecting with TriggerDeliveryAbortedError, or a binding fails. */
+    run(context: TriggerContext): Promise<void>;
+    /** How many bindings are receiving events; a readiness check can wait until it equals the number of routes. */
+    runningSourceCount(): number;
+}
+/**
+ * Open connectionName and every route's binding from the loaded project and wrap each target in the
+ * binding's durable project inbox, so an event is stored before Connect receives 200. A route whose
+ * binding is not configured throws ObjectNotFoundError; an invalid configuration, a blank or duplicated
+ * binding name, or no routes throws. The client options' logger also applies to the inboxes.
+ */
+declare function newProjectEnvelopeEventReceivedEndpointRunner(project: LoadedProject, connectionName: string, routes: readonly ProjectEnvelopeEventReceivedTriggerRoute[], options?: DocuSignClientOptions): EnvelopeEventReceivedEndpointRunner;
+/** Wraps one binding's target so each event is stored before its acknowledgement. */
+type DurableEnvelopeEventReceivedTarget = (key: TriggerInboxKey, target: TriggerTarget<EnvelopeEvent>) => TriggerTarget<EnvelopeEvent>;
+/** @internal Run routes on connection with the bindings that configuration stores, wrapping each target with makeDurable. */
+declare function newEnvelopeEventReceivedEndpointRunner(connection: Connection, configuration: Configuration, routes: readonly ProjectEnvelopeEventReceivedTriggerRoute[], makeDurable: DurableEnvelopeEventReceivedTarget): EnvelopeEventReceivedEndpointRunner;
+
+export { CombinedDocument, type CombinedDocumentReference, type CombinedDocumentStore, Config, type ConnectEnvelopeEvent, ConnectEnvelopeEvents, ConnectEventEnvelopeCompleted, ConnectEventEnvelopeDeclined, ConnectEventEnvelopeVoided, ConnectMessageMalformedError, ConnectSignatureInvalidError, Connection, ConnectorID, CreateEnvelopeFromTemplateBranch, CreateEnvelopeFromTemplateBranchCreated, CreateEnvelopeFromTemplateBranchDefect, CreateEnvelopeFromTemplateBranchProviderRejected, CreateEnvelopeFromTemplateBranchUncertain, CreateEnvelopeFromTemplateDefinition, CreateEnvelopeFromTemplateInput, CreateEnvelopeFromTemplateMetadata, CreateEnvelopeFromTemplateOperation, type CreateEnvelopeFromTemplateStepConfig, CreatedEnvelope, CredentialSource, Credentials, DocuSignClient, type DocuSignClientOptions, DownloadCombinedDocumentBranch, DownloadCombinedDocumentBranchDefect, DownloadCombinedDocumentBranchDownloaded, DownloadCombinedDocumentBranchInvalidResponse, DownloadCombinedDocumentBranchNotFound, DownloadCombinedDocumentBranchProviderRejected, DownloadCombinedDocumentBranchTooLarge, DownloadCombinedDocumentDefinition, DownloadCombinedDocumentInput, DownloadCombinedDocumentMetadata, DownloadCombinedDocumentOperation, type DownloadCombinedDocumentStepConfig, type DurableEnvelopeEventReceivedTarget, Envelope, EnvelopeCustomField, type EnvelopeEvent, EnvelopeEventReceivedEndpointRunner, type EnvelopeEventReceivedTriggerBindingConfig, type EnvelopeEventReceivedTriggerConfig, type EnvelopeEventReceivedTriggerConfiguration, EnvelopeEventReceivedTriggerConfigurationSchema, EnvelopeEventReceivedTriggerDefinition, EnvelopeEventSchema, EnvelopeRecipients, GetEnvelopeBranch, GetEnvelopeBranchDefect, GetEnvelopeBranchFound, GetEnvelopeBranchInvalidResponse, GetEnvelopeBranchNotFound, GetEnvelopeBranchProviderRejected, GetEnvelopeDefinition, GetEnvelopeInput, GetEnvelopeMetadata, GetEnvelopeOperation, type GetEnvelopeStepConfig, ListEnvelopeRecipientsBranch, ListEnvelopeRecipientsBranchDefect, ListEnvelopeRecipientsBranchInvalidResponse, ListEnvelopeRecipientsBranchListed, ListEnvelopeRecipientsBranchNotFound, ListEnvelopeRecipientsBranchProviderRejected, ListEnvelopeRecipientsDefinition, ListEnvelopeRecipientsInput, ListEnvelopeRecipientsMetadata, ListEnvelopeRecipientsOperation, type ListEnvelopeRecipientsStepConfig, type ProjectEnvelopeEventReceivedTriggerRoute, ProviderID, VoidEnvelopeBranch, VoidEnvelopeBranchDefect, VoidEnvelopeBranchInvalidResponse, VoidEnvelopeBranchNotFound, VoidEnvelopeBranchNotVoidable, VoidEnvelopeBranchProviderRejected, VoidEnvelopeBranchVoided, VoidEnvelopeDefinition, VoidEnvelopeInput, VoidEnvelopeMetadata, VoidEnvelopeOperation, type VoidEnvelopeStepConfig, VoidedEnvelope, decodeConnectMessage, defineEnvelopeEventReceivedTriggerBinding, envelopeEventCustomFieldValue, envelopeEventReceivedWebhookEndpoint, newCreateEnvelopeFromTemplateStep, newDownloadCombinedDocumentStep, newEnvelopeEventReceivedEndpointRunner, newEnvelopeEventReceivedTrigger, newGetEnvelopeStep, newListEnvelopeRecipientsStep, newProjectConnection, newProjectEnvelopeEventReceivedEndpointRunner, newVoidEnvelopeStep, verifyConnectSignature };