@superdurable/connector-docusign 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Super Durable
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,11 @@
-# Temporary Holding Version
+# DocuSign TypeScript connector
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+`@superdurable/connector-docusign` provides five eSignature operations for Dex Flows: `createEnvelopeFromTemplate`, `getEnvelope`, `listEnvelopeRecipients`, `voidEnvelope`, and `downloadCombinedDocument`. The package uses the manifest's production and developer OAuth methods, with automatic refresh through the generated credential wiring. DocuSign Connect trigger delivery remains Go-only.
+
+The package exports generated operation-specific Step factories, typed models, mock cases, `DocuSignClient`, and `newProjectConnection`. Applications configure a named DocuSign connection in Dex Web using the [connector authorization guide](../README.md). Never put access tokens, refresh tokens, client secrets, Connect HMAC keys, or signed PDFs in Flow inputs, Attributes, Results, or logs.
+
+The [envelope status example](examples/envelope-status/README.md) is a runnable Flow, Worker, and Client using the static `docusign-envelope-reader` connection. Its integration test runs through a real Dex Worker and Client with a local DocuSign stand-in. Provider replay scenarios under [`conformance/connectors/docusign`](../../../conformance/connectors/docusign/) check Go and TypeScript request and classification parity. Real DocuSign OAuth authorization, regional account lookup, eSignature requests, and Connect configuration require verification in Dex Web with a user-controlled provider account; they were not exercised by these local tests.
+
+The optional `CombinedDocumentStore` supplied to `DocuSignClient` stores a downloaded PDF outside Dex and returns a safe location of at most 1024 bytes. Without a store, `downloadCombinedDocument` returns only its byte count and SHA-256 digest. A store must consume the whole content atomically and be safe to call again after a retry.
+
+From this package directory, run `npm ci`, `npm run check`, and `npm run test:integration` with `DEX_FLOW_SERVICE_ADDRESS` pointing to a running `dexcli dev` server.

package/dex-connector.json

@@ -0,0 +1,206 @@
+{
+  "connectorId": "docusign",
+  "releaseTag": "connectors/docusign/go/v0.24.0",
+  "package": {
+    "ecosystem": "npm",
+    "name": "@superdurable/connector-docusign",
+    "version": "0.1.0"
+  },
+  "factories": [
+    {
+      "name": "newCreateEnvelopeFromTemplateStep",
+      "kind": "mutation",
+      "operationId": "createEnvelopeFromTemplate",
+      "fields": {
+        "stepType": "stepType",
+        "annotations": "annotations",
+        "connectionName": "connectionName",
+        "resultAttribute": "resultAttribute"
+      },
+      "branches": [
+        {
+          "id": "created",
+          "field": "created",
+          "optional": false
+        },
+        {
+          "id": "providerRejected",
+          "field": "providerRejected",
+          "optional": true
+        },
+        {
+          "id": "uncertain",
+          "field": "uncertain",
+          "optional": true
+        },
+        {
+          "id": "defect",
+          "field": "defect",
+          "optional": true
+        }
+      ]
+    },
+    {
+      "name": "newGetEnvelopeStep",
+      "kind": "query",
+      "operationId": "getEnvelope",
+      "fields": {
+        "stepType": "stepType",
+        "annotations": "annotations",
+        "connectionName": "connectionName",
+        "resultAttribute": "resultAttribute"
+      },
+      "branches": [
+        {
+          "id": "found",
+          "field": "found",
+          "optional": false
+        },
+        {
+          "id": "notFound",
+          "field": "notFound",
+          "optional": true
+        },
+        {
+          "id": "providerRejected",
+          "field": "providerRejected",
+          "optional": true
+        },
+        {
+          "id": "invalidResponse",
+          "field": "invalidResponse",
+          "optional": true
+        },
+        {
+          "id": "defect",
+          "field": "defect",
+          "optional": true
+        }
+      ]
+    },
+    {
+      "name": "newListEnvelopeRecipientsStep",
+      "kind": "query",
+      "operationId": "listEnvelopeRecipients",
+      "fields": {
+        "stepType": "stepType",
+        "annotations": "annotations",
+        "connectionName": "connectionName",
+        "resultAttribute": "resultAttribute"
+      },
+      "branches": [
+        {
+          "id": "listed",
+          "field": "listed",
+          "optional": false
+        },
+        {
+          "id": "notFound",
+          "field": "notFound",
+          "optional": true
+        },
+        {
+          "id": "providerRejected",
+          "field": "providerRejected",
+          "optional": true
+        },
+        {
+          "id": "invalidResponse",
+          "field": "invalidResponse",
+          "optional": true
+        },
+        {
+          "id": "defect",
+          "field": "defect",
+          "optional": true
+        }
+      ]
+    },
+    {
+      "name": "newVoidEnvelopeStep",
+      "kind": "mutation",
+      "operationId": "voidEnvelope",
+      "fields": {
+        "stepType": "stepType",
+        "annotations": "annotations",
+        "connectionName": "connectionName",
+        "resultAttribute": "resultAttribute"
+      },
+      "branches": [
+        {
+          "id": "voided",
+          "field": "voided",
+          "optional": false
+        },
+        {
+          "id": "notVoidable",
+          "field": "notVoidable",
+          "optional": true
+        },
+        {
+          "id": "notFound",
+          "field": "notFound",
+          "optional": true
+        },
+        {
+          "id": "providerRejected",
+          "field": "providerRejected",
+          "optional": true
+        },
+        {
+          "id": "invalidResponse",
+          "field": "invalidResponse",
+          "optional": true
+        },
+        {
+          "id": "defect",
+          "field": "defect",
+          "optional": true
+        }
+      ]
+    },
+    {
+      "name": "newDownloadCombinedDocumentStep",
+      "kind": "query",
+      "operationId": "downloadCombinedDocument",
+      "fields": {
+        "stepType": "stepType",
+        "annotations": "annotations",
+        "connectionName": "connectionName",
+        "resultAttribute": "resultAttribute"
+      },
+      "branches": [
+        {
+          "id": "downloaded",
+          "field": "downloaded",
+          "optional": false
+        },
+        {
+          "id": "notFound",
+          "field": "notFound",
+          "optional": true
+        },
+        {
+          "id": "tooLarge",
+          "field": "tooLarge",
+          "optional": true
+        },
+        {
+          "id": "providerRejected",
+          "field": "providerRejected",
+          "optional": true
+        },
+        {
+          "id": "invalidResponse",
+          "field": "invalidResponse",
+          "optional": true
+        },
+        {
+          "id": "defect",
+          "field": "defect",
+          "optional": true
+        }
+      ]
+    }
+  ]
+}

package/dist/chunk-42O7OZRV.js

@@ -0,0 +1,420 @@
+// src/generated/models.ts
+import { z } from "zod";
+import { SecretString } from "@superdurable/connectors-sdk";
+var goTimeJSONPattern = /^(\d{4})-(\d{2})-(\d{2})T(\d{1,2}):(\d{2}):(\d{2})(?:[.,](\d+))?(Z|([+-])(\d{2}):(\d{2}))$/;
+function isGoTimeJSON(value) {
+  const match = goTimeJSONPattern.exec(value);
+  if (!match) return false;
+  const [, yearText, monthText, dayText, hourText, minuteText, secondText, , zone, , zoneHourText, zoneMinuteText] = match;
+  const year = Number(yearText);
+  const month = Number(monthText);
+  const day = Number(dayText);
+  const isLeap = year % 4 === 0 && (year % 100 !== 0 || year % 400 === 0);
+  const monthDays = [31, isLeap ? 29 : 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31];
+  return month >= 1 && month <= 12 && day >= 1 && day <= monthDays[month - 1] && Number(hourText) <= 23 && Number(minuteText) <= 59 && Number(secondText) <= 59 && (zone === "Z" || Number(zoneHourText) <= 24 && Number(zoneMinuteText) <= 60);
+}
+function canonicalGoTimeJSON(value) {
+  const match = goTimeJSONPattern.exec(value);
+  const [, year, month, day, hour, minute, second, fraction, zone, sign, zoneHour, zoneMinute] = match;
+  const clock = year + "-" + month + "-" + day + "T" + hour.padStart(2, "0") + ":" + minute + ":" + second;
+  const digits = (fraction ?? "").slice(0, 9).replace(/0+$/, "");
+  const offsetMinutes = zone === "Z" ? 0 : (Number(zoneHour) * 60 + Number(zoneMinute)) * (sign === "+" ? 1 : -1);
+  if (Math.abs(offsetMinutes) >= 1440) return value;
+  const offset = offsetMinutes === 0 ? "Z" : (offsetMinutes > 0 ? "+" : "-") + String(Math.floor(Math.abs(offsetMinutes) / 60)).padStart(2, "0") + ":" + String(Math.abs(offsetMinutes) % 60).padStart(2, "0");
+  return clock + (digits ? "." + digits : "") + offset;
+}
+var GoTimeJSONSchema = z.string().refine(isGoTimeJSON, "invalid Go time.Time JSON timestamp").transform(canonicalGoTimeJSON);
+var ConfigSchema = z.object({
+  "accountId": z.string().optional(),
+  "maxResponseBytes": z.number().int().optional(),
+  "maxDocumentBytes": z.number().int().optional(),
+  "connectMaxBodyBytes": z.number().int().optional()
+});
+function decodeCredentials(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) throw new TypeError("credential fields are invalid");
+  const fields = value;
+  const allowed = /* @__PURE__ */ new Set(["auth_method", "access_token", "connect_hmac_key", "oauth_client_id", "oauth_client_secret", "refresh_token"]);
+  if (Object.keys(fields).some((key) => !allowed.has(key))) throw new TypeError("stored credential does not match the connector credential fields");
+  if (fields["access_token"] != null && !(typeof fields["access_token"] === "string")) throw new TypeError("credential access_token has an invalid type");
+  if (fields["connect_hmac_key"] != null && !(typeof fields["connect_hmac_key"] === "string")) throw new TypeError("credential connect_hmac_key has an invalid type");
+  if (fields["oauth_client_id"] != null && !(typeof fields["oauth_client_id"] === "string")) throw new TypeError("credential oauth_client_id has an invalid type");
+  if (fields["oauth_client_secret"] != null && !(typeof fields["oauth_client_secret"] === "string")) throw new TypeError("credential oauth_client_secret has an invalid type");
+  if (fields["refresh_token"] != null && !(typeof fields["refresh_token"] === "string")) throw new TypeError("credential refresh_token has an invalid type");
+  const selectedMethod = fields["auth_method"] ?? "";
+  if (typeof selectedMethod !== "string") throw new TypeError("credential auth_method is invalid");
+  const method = selectedMethod || "docusign-oauth";
+  const credentials = { authMethodId: method };
+  if (method === "docusign-oauth") {
+    if (!fields["oauth_client_id"]) throw new TypeError("credential oauth_client_id is required");
+    if (fields["oauth_client_id"]) credentials.oauthClientId = fields["oauth_client_id"];
+    if (!fields["oauth_client_secret"]) throw new TypeError("credential oauth_client_secret is required");
+    if (fields["oauth_client_secret"]) credentials.oauthClientSecret = new SecretString(fields["oauth_client_secret"]);
+    if (!fields["access_token"]) throw new TypeError("credential access_token is required");
+    if (fields["access_token"]) credentials.accessToken = new SecretString(fields["access_token"]);
+    if (!fields["refresh_token"]) throw new TypeError("credential refresh_token is required");
+    if (fields["refresh_token"]) credentials.refreshToken = new SecretString(fields["refresh_token"]);
+    credentials.connectHmacKey = new SecretString(fields["connect_hmac_key"] ?? "");
+  } else if (method === "docusign-developer-oauth") {
+    if (!fields["oauth_client_id"]) throw new TypeError("credential oauth_client_id is required");
+    if (fields["oauth_client_id"]) credentials.oauthClientId = fields["oauth_client_id"];
+    if (!fields["oauth_client_secret"]) throw new TypeError("credential oauth_client_secret is required");
+    if (fields["oauth_client_secret"]) credentials.oauthClientSecret = new SecretString(fields["oauth_client_secret"]);
+    if (!fields["access_token"]) throw new TypeError("credential access_token is required");
+    if (fields["access_token"]) credentials.accessToken = new SecretString(fields["access_token"]);
+    if (!fields["refresh_token"]) throw new TypeError("credential refresh_token is required");
+    if (fields["refresh_token"]) credentials.refreshToken = new SecretString(fields["refresh_token"]);
+    credentials.connectHmacKey = new SecretString(fields["connect_hmac_key"] ?? "");
+  } else {
+    throw new TypeError("credential auth_method is invalid");
+  }
+  return credentials;
+}
+function decodeSharedCredentials(value) {
+  if (!value || typeof value !== "object" || Array.isArray(value)) throw new TypeError("credential fields are invalid");
+  const fields = value;
+  const allowed = /* @__PURE__ */ new Set(["auth_method", "access_token", "connect_hmac_key", "oauth_client_id", "oauth_client_secret", "refresh_token"]);
+  if (Object.keys(fields).some((key) => !allowed.has(key))) throw new TypeError("stored credential does not match the connector credential fields");
+  if (fields["access_token"] != null && !(typeof fields["access_token"] === "string")) throw new TypeError("credential access_token has an invalid type");
+  if (fields["connect_hmac_key"] != null && !(typeof fields["connect_hmac_key"] === "string")) throw new TypeError("credential connect_hmac_key has an invalid type");
+  if (fields["oauth_client_id"] != null && !(typeof fields["oauth_client_id"] === "string")) throw new TypeError("credential oauth_client_id has an invalid type");
+  if (fields["oauth_client_secret"] != null && !(typeof fields["oauth_client_secret"] === "string")) throw new TypeError("credential oauth_client_secret has an invalid type");
+  if (fields["refresh_token"] != null && !(typeof fields["refresh_token"] === "string")) throw new TypeError("credential refresh_token has an invalid type");
+  const selectedMethod = fields["auth_method"] ?? "";
+  if (typeof selectedMethod !== "string") throw new TypeError("credential auth_method is invalid");
+  const method = selectedMethod || "docusign-oauth";
+  const credentials = { authMethodId: method };
+  if (method === "docusign-oauth") {
+    if (!fields["oauth_client_id"]) throw new TypeError("credential oauth_client_id is required");
+    if (fields["oauth_client_id"]) credentials.oauthClientId = fields["oauth_client_id"];
+    if (fields["oauth_client_secret"]) credentials.oauthClientSecret = new SecretString(fields["oauth_client_secret"]);
+    if (!fields["access_token"]) throw new TypeError("credential access_token is required");
+    if (fields["access_token"]) credentials.accessToken = new SecretString(fields["access_token"]);
+    if (fields["refresh_token"]) credentials.refreshToken = new SecretString(fields["refresh_token"]);
+    credentials.connectHmacKey = new SecretString(fields["connect_hmac_key"] ?? "");
+  } else if (method === "docusign-developer-oauth") {
+    if (!fields["oauth_client_id"]) throw new TypeError("credential oauth_client_id is required");
+    if (fields["oauth_client_id"]) credentials.oauthClientId = fields["oauth_client_id"];
+    if (fields["oauth_client_secret"]) credentials.oauthClientSecret = new SecretString(fields["oauth_client_secret"]);
+    if (!fields["access_token"]) throw new TypeError("credential access_token is required");
+    if (fields["access_token"]) credentials.accessToken = new SecretString(fields["access_token"]);
+    if (fields["refresh_token"]) credentials.refreshToken = new SecretString(fields["refresh_token"]);
+    credentials.connectHmacKey = new SecretString(fields["connect_hmac_key"] ?? "");
+  } else {
+    throw new TypeError("credential auth_method is invalid");
+  }
+  return credentials;
+}
+var TemplateRoleSchema = z.strictObject({
+  "roleName": z.string(),
+  "name": z.string(),
+  "email": z.string(),
+  "routingOrder": z.number().int().optional()
+});
+var EnvelopeCustomFieldSchema = z.strictObject({
+  "name": z.string(),
+  "value": z.string()
+});
+var CreateEnvelopeFromTemplateInputSchema = z.strictObject({
+  "templateId": z.string(),
+  "templateRoles": z.array(TemplateRoleSchema).nullable(),
+  "emailSubject": z.string().optional(),
+  "emailBlurb": z.string().optional(),
+  "isDraft": z.boolean().optional(),
+  "customFields": z.array(EnvelopeCustomFieldSchema).optional()
+});
+var CreatedEnvelopeSchema = z.strictObject({
+  "envelopeId": z.string(),
+  "status": z.string(),
+  "statusChangedAt": GoTimeJSONSchema.nullable().optional(),
+  "wasRecovered": z.boolean().optional()
+});
+var GetEnvelopeInputSchema = z.strictObject({
+  "envelopeId": z.string()
+});
+var EnvelopeSchema = z.strictObject({
+  "envelopeId": z.string(),
+  "status": z.string(),
+  "emailSubject": z.string().optional(),
+  "createdAt": GoTimeJSONSchema.nullable().optional(),
+  "sentAt": GoTimeJSONSchema.nullable().optional(),
+  "deliveredAt": GoTimeJSONSchema.nullable().optional(),
+  "completedAt": GoTimeJSONSchema.nullable().optional(),
+  "declinedAt": GoTimeJSONSchema.nullable().optional(),
+  "voidedAt": GoTimeJSONSchema.nullable().optional(),
+  "statusChangedAt": GoTimeJSONSchema.nullable().optional(),
+  "expiresAt": GoTimeJSONSchema.nullable().optional(),
+  "voidedReason": z.string().optional(),
+  "customFields": z.array(EnvelopeCustomFieldSchema).optional()
+});
+var ListEnvelopeRecipientsInputSchema = z.strictObject({
+  "envelopeId": z.string()
+});
+var RecipientSchema = z.strictObject({
+  "recipientId": z.string(),
+  "type": z.string(),
+  "name": z.string().optional(),
+  "email": z.string().optional(),
+  "roleName": z.string().optional(),
+  "routingOrder": z.number().int(),
+  "status": z.string(),
+  "sentAt": GoTimeJSONSchema.nullable().optional(),
+  "deliveredAt": GoTimeJSONSchema.nullable().optional(),
+  "signedAt": GoTimeJSONSchema.nullable().optional(),
+  "declinedAt": GoTimeJSONSchema.nullable().optional(),
+  "declinedReason": z.string().optional()
+});
+var EnvelopeRecipientsSchema = z.strictObject({
+  "envelopeId": z.string(),
+  "currentRoutingOrder": z.number().int().optional(),
+  "recipients": z.array(RecipientSchema).nullable()
+});
+var VoidEnvelopeInputSchema = z.strictObject({
+  "envelopeId": z.string(),
+  "voidedReason": z.string()
+});
+var VoidedEnvelopeSchema = z.strictObject({
+  "envelopeId": z.string(),
+  "wasAlreadyVoided": z.boolean().optional(),
+  "status": z.string().optional(),
+  "voidedReason": z.string().optional()
+});
+var DownloadCombinedDocumentInputSchema = z.strictObject({
+  "envelopeId": z.string(),
+  "includeCertificate": z.boolean().optional()
+});
+var CombinedDocumentSchema = z.strictObject({
+  "envelopeId": z.string(),
+  "contentType": z.string(),
+  "byteCount": z.number().int(),
+  "sha256": z.string(),
+  "includesCertificate": z.boolean().optional(),
+  "storedLocation": z.string().optional()
+});
+
+// src/generated/definitions.ts
+var ConnectorID = "docusign";
+var ProviderID = "docusign";
+var CreateEnvelopeFromTemplateBranch = {
+  Created: "created",
+  ProviderRejected: "providerRejected",
+  Uncertain: "uncertain",
+  Defect: "defect"
+};
+var CreateEnvelopeFromTemplateBranchCreated = CreateEnvelopeFromTemplateBranch.Created;
+var CreateEnvelopeFromTemplateBranchProviderRejected = CreateEnvelopeFromTemplateBranch.ProviderRejected;
+var CreateEnvelopeFromTemplateBranchUncertain = CreateEnvelopeFromTemplateBranch.Uncertain;
+var CreateEnvelopeFromTemplateBranchDefect = CreateEnvelopeFromTemplateBranch.Defect;
+var CreateEnvelopeFromTemplateDefinition = {
+  operation: { connectorId: ConnectorID, operationId: "createEnvelopeFromTemplate" },
+  branches: [
+    { id: "created", description: "DocuSign holds the envelope this Step execution created; wasRecovered tells whether a later attempt found it by its custom field after an interrupted one." },
+    { id: "providerRejected", description: "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.", optional: true },
+    { id: "uncertain", description: "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.", optional: true },
+    { id: "defect", description: "Local input, connection configuration, or connector definition is invalid.", optional: true }
+  ],
+  stepDefaults: { executeMethodTimeoutMs: 6e4, executeDurability: "sync", executeRetry: { initialIntervalMs: 1e3, backoffCoefficient: 2, maximumIntervalMs: 6e4, maximumAttempts: 6, totalDurationMs: 39e5 } }
+};
+var CreateEnvelopeFromTemplateMetadata = { kind: "mutation", idempotency: "required", authorization: "required" };
+var GetEnvelopeBranch = {
+  Found: "found",
+  NotFound: "notFound",
+  ProviderRejected: "providerRejected",
+  InvalidResponse: "invalidResponse",
+  Defect: "defect"
+};
+var GetEnvelopeBranchFound = GetEnvelopeBranch.Found;
+var GetEnvelopeBranchNotFound = GetEnvelopeBranch.NotFound;
+var GetEnvelopeBranchProviderRejected = GetEnvelopeBranch.ProviderRejected;
+var GetEnvelopeBranchInvalidResponse = GetEnvelopeBranch.InvalidResponse;
+var GetEnvelopeBranchDefect = GetEnvelopeBranch.Defect;
+var GetEnvelopeDefinition = {
+  operation: { connectorId: ConnectorID, operationId: "getEnvelope" },
+  branches: [
+    { id: "found", description: "DocuSign returned the envelope." },
+    { id: "notFound", description: "The envelope does not exist in the connection's account or the user may not see it.", optional: true },
+    { id: "providerRejected", description: "DocuSign conclusively rejected the read, such as a revoked consent or a user without access to the account.", optional: true },
+    { id: "invalidResponse", description: "DocuSign returned a malformed or oversized response.", optional: true },
+    { id: "defect", description: "Local input, connection configuration, or connector definition is invalid.", optional: true }
+  ],
+  stepDefaults: { executeMethodTimeoutMs: 3e4, executeDurability: "async", executeRetry: { initialIntervalMs: 1e3, backoffCoefficient: 2, maximumIntervalMs: 6e4, maximumAttempts: 0, totalDurationMs: 39e5 } }
+};
+var GetEnvelopeMetadata = { kind: "query", idempotency: "none", authorization: "required" };
+var ListEnvelopeRecipientsBranch = {
+  Listed: "listed",
+  NotFound: "notFound",
+  ProviderRejected: "providerRejected",
+  InvalidResponse: "invalidResponse",
+  Defect: "defect"
+};
+var ListEnvelopeRecipientsBranchListed = ListEnvelopeRecipientsBranch.Listed;
+var ListEnvelopeRecipientsBranchNotFound = ListEnvelopeRecipientsBranch.NotFound;
+var ListEnvelopeRecipientsBranchProviderRejected = ListEnvelopeRecipientsBranch.ProviderRejected;
+var ListEnvelopeRecipientsBranchInvalidResponse = ListEnvelopeRecipientsBranch.InvalidResponse;
+var ListEnvelopeRecipientsBranchDefect = ListEnvelopeRecipientsBranch.Defect;
+var ListEnvelopeRecipientsDefinition = {
+  operation: { connectorId: ConnectorID, operationId: "listEnvelopeRecipients" },
+  branches: [
+    { id: "listed", description: "DocuSign returned the envelope's recipients." },
+    { id: "notFound", description: "The envelope does not exist in the connection's account or the user may not see it.", optional: true },
+    { id: "providerRejected", description: "DocuSign conclusively rejected the read, such as a revoked consent or a user without access to the account.", optional: true },
+    { id: "invalidResponse", description: "DocuSign returned a malformed or oversized response.", optional: true },
+    { id: "defect", description: "Local input, connection configuration, or connector definition is invalid.", optional: true }
+  ],
+  stepDefaults: { executeMethodTimeoutMs: 3e4, executeDurability: "async", executeRetry: { initialIntervalMs: 1e3, backoffCoefficient: 2, maximumIntervalMs: 6e4, maximumAttempts: 0, totalDurationMs: 39e5 } }
+};
+var ListEnvelopeRecipientsMetadata = { kind: "query", idempotency: "none", authorization: "required" };
+var VoidEnvelopeBranch = {
+  Voided: "voided",
+  NotVoidable: "notVoidable",
+  NotFound: "notFound",
+  ProviderRejected: "providerRejected",
+  InvalidResponse: "invalidResponse",
+  Defect: "defect"
+};
+var VoidEnvelopeBranchVoided = VoidEnvelopeBranch.Voided;
+var VoidEnvelopeBranchNotVoidable = VoidEnvelopeBranch.NotVoidable;
+var VoidEnvelopeBranchNotFound = VoidEnvelopeBranch.NotFound;
+var VoidEnvelopeBranchProviderRejected = VoidEnvelopeBranch.ProviderRejected;
+var VoidEnvelopeBranchInvalidResponse = VoidEnvelopeBranch.InvalidResponse;
+var VoidEnvelopeBranchDefect = VoidEnvelopeBranch.Defect;
+var VoidEnvelopeDefinition = {
+  operation: { connectorId: ConnectorID, operationId: "voidEnvelope" },
+  branches: [
+    { id: "voided", description: "The envelope is voided, by this call or earlier; wasAlreadyVoided tells which." },
+    { id: "notVoidable", description: "The envelope is completed, declined, or still a draft, which DocuSign does not void; status names which.", optional: true },
+    { id: "notFound", description: "The envelope does not exist in the connection's account or the user may not see it.", optional: true },
+    { id: "providerRejected", description: "DocuSign conclusively rejected the void, such as a user who is not the sender or lacks permission.", optional: true },
+    { id: "invalidResponse", description: "DocuSign returned a malformed or oversized response.", optional: true },
+    { id: "defect", description: "Local input, connection configuration, or connector definition is invalid.", optional: true }
+  ],
+  stepDefaults: { executeMethodTimeoutMs: 3e4, executeDurability: "async", executeRetry: { initialIntervalMs: 1e3, backoffCoefficient: 2, maximumIntervalMs: 6e4, maximumAttempts: 0, totalDurationMs: 39e5 } }
+};
+var VoidEnvelopeMetadata = { kind: "mutation", idempotency: "required", authorization: "required" };
+var DownloadCombinedDocumentBranch = {
+  Downloaded: "downloaded",
+  NotFound: "notFound",
+  TooLarge: "tooLarge",
+  ProviderRejected: "providerRejected",
+  InvalidResponse: "invalidResponse",
+  Defect: "defect"
+};
+var DownloadCombinedDocumentBranchDownloaded = DownloadCombinedDocumentBranch.Downloaded;
+var DownloadCombinedDocumentBranchNotFound = DownloadCombinedDocumentBranch.NotFound;
+var DownloadCombinedDocumentBranchTooLarge = DownloadCombinedDocumentBranch.TooLarge;
+var DownloadCombinedDocumentBranchProviderRejected = DownloadCombinedDocumentBranch.ProviderRejected;
+var DownloadCombinedDocumentBranchInvalidResponse = DownloadCombinedDocumentBranch.InvalidResponse;
+var DownloadCombinedDocumentBranchDefect = DownloadCombinedDocumentBranch.Defect;
+var DownloadCombinedDocumentDefinition = {
+  operation: { connectorId: ConnectorID, operationId: "downloadCombinedDocument" },
+  branches: [
+    { id: "downloaded", description: "DocuSign returned the combined PDF and its digest was recorded, and stored when the client has a CombinedDocumentStore." },
+    { id: "notFound", description: "The envelope does not exist in the connection's account or the user may not see it.", optional: true },
+    { id: "tooLarge", description: "The combined PDF exceeds the connection's maxDocumentBytes; nothing was stored.", optional: true },
+    { id: "providerRejected", description: "DocuSign conclusively rejected the download, such as a revoked consent or a user without access to the envelope.", optional: true },
+    { id: "invalidResponse", description: "DocuSign returned something other than a complete PDF, or the CombinedDocumentStore rejected it.", optional: true },
+    { id: "defect", description: "Local input, connection configuration, or connector definition is invalid.", optional: true }
+  ],
+  stepDefaults: { executeMethodTimeoutMs: 12e4, executeDurability: "async", executeRetry: { initialIntervalMs: 1e3, backoffCoefficient: 2, maximumIntervalMs: 6e4, maximumAttempts: 0, totalDurationMs: 39e5 } }
+};
+var DownloadCombinedDocumentMetadata = { kind: "query", idempotency: "none", authorization: "required" };
+
+// src/generated/connection.ts
+import { ConnectionRefSchema } from "@superdurable/connectors-sdk";
+import { newRefreshingCredentialProvider } from "@superdurable/connectors-sdk/projectconfig";
+var Connection = class {
+  /** Stable provider and connection name. */
+  reference;
+  /** Bound provider operations. */
+  operations;
+  /** Validate a reference and bind operations. */
+  constructor(reference, operations) {
+    this.reference = ConnectionRefSchema.parse(reference);
+    if (this.reference.provider !== ProviderID) throw new TypeError("connection provider differs from the manifest");
+    if (!operations) throw new TypeError("connector operations are required");
+    this.operations = operations;
+  }
+};
+function newConnection(client, reference) {
+  if (!client) throw new TypeError("connector client is required");
+  return new Connection(reference, client);
+}
+function newConnectionWithOperations(operations, reference) {
+  return new Connection(reference, operations);
+}
+function newProjectConnection(project, connectionName, createClient) {
+  if (!project) throw new TypeError("loaded project is required");
+  const reference = ConnectionRefSchema.parse({ provider: ProviderID, name: connectionName });
+  const selected = project.configuration.connections.find((entry) => entry.connectorId === ConnectorID && entry.connectionName === connectionName);
+  if (!selected || selected.provider !== ProviderID) throw new TypeError("project connection is not configured");
+  return newConnection(createClient(project, connectionName), reference);
+}
+function newProjectCredentialProvider(project, connectionName, decode, encode, decodeShared) {
+  return newRefreshingCredentialProvider(project.connections, { connectorId: ConnectorID, connectionName }, decode, encode, decodeShared);
+}
+
+export {
+  ConfigSchema,
+  decodeCredentials,
+  decodeSharedCredentials,
+  TemplateRoleSchema,
+  EnvelopeCustomFieldSchema,
+  CreateEnvelopeFromTemplateInputSchema,
+  CreatedEnvelopeSchema,
+  GetEnvelopeInputSchema,
+  EnvelopeSchema,
+  ListEnvelopeRecipientsInputSchema,
+  RecipientSchema,
+  EnvelopeRecipientsSchema,
+  VoidEnvelopeInputSchema,
+  VoidedEnvelopeSchema,
+  DownloadCombinedDocumentInputSchema,
+  CombinedDocumentSchema,
+  ConnectorID,
+  ProviderID,
+  CreateEnvelopeFromTemplateBranch,
+  CreateEnvelopeFromTemplateBranchCreated,
+  CreateEnvelopeFromTemplateBranchProviderRejected,
+  CreateEnvelopeFromTemplateBranchUncertain,
+  CreateEnvelopeFromTemplateBranchDefect,
+  CreateEnvelopeFromTemplateDefinition,
+  CreateEnvelopeFromTemplateMetadata,
+  GetEnvelopeBranch,
+  GetEnvelopeBranchFound,
+  GetEnvelopeBranchNotFound,
+  GetEnvelopeBranchProviderRejected,
+  GetEnvelopeBranchInvalidResponse,
+  GetEnvelopeBranchDefect,
+  GetEnvelopeDefinition,
+  GetEnvelopeMetadata,
+  ListEnvelopeRecipientsBranch,
+  ListEnvelopeRecipientsBranchListed,
+  ListEnvelopeRecipientsBranchNotFound,
+  ListEnvelopeRecipientsBranchProviderRejected,
+  ListEnvelopeRecipientsBranchInvalidResponse,
+  ListEnvelopeRecipientsBranchDefect,
+  ListEnvelopeRecipientsDefinition,
+  ListEnvelopeRecipientsMetadata,
+  VoidEnvelopeBranch,
+  VoidEnvelopeBranchVoided,
+  VoidEnvelopeBranchNotVoidable,
+  VoidEnvelopeBranchNotFound,
+  VoidEnvelopeBranchProviderRejected,
+  VoidEnvelopeBranchInvalidResponse,
+  VoidEnvelopeBranchDefect,
+  VoidEnvelopeDefinition,
+  VoidEnvelopeMetadata,
+  DownloadCombinedDocumentBranch,
+  DownloadCombinedDocumentBranchDownloaded,
+  DownloadCombinedDocumentBranchNotFound,
+  DownloadCombinedDocumentBranchTooLarge,
+  DownloadCombinedDocumentBranchProviderRejected,
+  DownloadCombinedDocumentBranchInvalidResponse,
+  DownloadCombinedDocumentBranchDefect,
+  DownloadCombinedDocumentDefinition,
+  DownloadCombinedDocumentMetadata,
+  Connection,
+  newConnection,
+  newConnectionWithOperations,
+  newProjectConnection,
+  newProjectCredentialProvider
+};