dex-connector-docusign 0.1.0__py3-none-any.whl

dex_connector_docusign-0.1.0.dist-info/METADATA

@@ -0,0 +1,100 @@
+Metadata-Version: 2.5
+Name: dex-connector-docusign
+Version: 0.1.0
+Summary: DocuSign eSignature connector for Dex Flows
+Project-URL: Source, https://github.com/superdurable/dex-connectors-library/tree/main/connectors/docusign/python
+License-Expression: MIT
+License-File: LICENSE
+Requires-Python: >=3.11
+Requires-Dist: dex-connectors-sdk==0.7.0
+Requires-Dist: dex-python-sdk>=1.28.0
+Requires-Dist: httpx>=0.27
+Description-Content-Type: text/markdown
+
+# DocuSign eSignature Python connector
+
+This package implements `createEnvelopeFromTemplate`, `getEnvelope`,
+`listEnvelopeRecipients`, `voidEnvelope`, and `downloadCombinedDocument` for
+Dex Python Flows. The `envelopeEventReceived` Connect Trigger remains Go-only.
+The manifest owns operation identities, retry policies, branches, configuration,
+and OAuth methods. The Python package version is `v0.1.0` and requires
+`dex-connectors-sdk==0.7.0`.
+
+`new_project_connection` loads the static connection name from Dex project
+configuration. It uses the generated OAuth credential decoder and refresh
+driver for production and developer accounts. Each provider call resolves the
+current access token, reads `/oauth/userinfo` to choose the account and regional
+API host, and rejects a host outside the selected environment. The PDF operation
+returns a digest, byte count, and optional store location; PDF bytes never enter
+a Dex Result. `CombinedDocumentStore` accepts bounded PDF bytes outside Dex and
+must be idempotent and atomic.
+
+## Runnable example
+
+[`examples/envelope_status/flow.py`](examples/envelope_status/flow.py) reads
+an envelope with the static `docusign-esignature` connection. It persists only
+the request and safe envelope summary. Its optional `notFound`,
+`providerRejected`, `invalidResponse`, and `defect` branches are intentionally
+unwired, so Dex fails the Flow if one is selected.
+
+From `connectors/docusign/python`, install dependencies and produce a strict
+FDG 2.0 file for Dex Web:
+
+```sh
+uv sync --locked
+dexcli visualize examples/envelope_status/flow.py --language python \
+  --schema-version 2.0 --lint app --json --out build/envelope-status \
+  --python .venv/bin/python
+```
+
+Start `dexcli dev` with that rendering directory. In Dex Web **Connections**,
+create `docusign / docusign-esignature`, choose Production account or Developer
+account, and follow the authorization guide in the connector manifest. Register
+Dex Web's exact redirect URI in the DocuSign app. The OAuth scopes are
+`signature` and `extended`; Dex handles access and refresh tokens. The account
+ID may stay blank to use the authorizing user's default account. A Connect HMAC
+key is optional for this read-only example. Use the owner-only
+`connections.json` exported by Dex Web as `DEX_CONNECTOR_CONFIG_FILE`.
+
+Run the Worker and start a Flow with the included sample input:
+
+```sh
+DEX_FLOW_SERVICE_ADDRESS=127.0.0.1:40901 \
+DEX_CONNECTOR_CONFIG_FILE=/path/to/connections.json \
+uv run python -m examples.envelope_status.main
+
+DEX_FLOW_SERVICE_ADDRESS=127.0.0.1:40901 \
+DEX_CONNECTOR_CONFIG_FILE=/path/to/connections.json \
+uv run python -m examples.envelope_status.start \
+  docusign-envelope-001 examples/envelope_status/sample-input.json
+```
+
+The Worker binding in [`main.py`](examples/envelope_status/main.py) is the
+application entrypoint:
+
+```python
+project = await load_from_environment()
+connection = new_project_connection(project, CONNECTION_NAME)
+try:
+    await run_worker(EnvelopeStatusFlow(connection))
+finally:
+    await connection.aclose()
+    await project.close()
+```
+
+Run the real Dex integration test against a local `dexcli dev` server:
+
+```sh
+DEX_FLOW_SERVICE_ADDRESS=127.0.0.1:40901 \
+uv run pytest examples/envelope_status/integration_test.py
+```
+
+The test binds its HTTP provider stand-in to an OS-assigned free port. It checks
+retry after a 429 and failure on an unwired `notFound` branch through a real Dex
+Worker and Client. The 52 Go-recorded conformance scenarios exercise every
+operation's provider requests and exact SDK-encoded outputs. OAuth refresh
+agreement has its own generated Go and Python suites.
+
+Live DocuSign authorization, account selection, regional host resolution,
+provider error codes, envelope read-back timing, PDF downloads, and Connect
+configuration have not been verified with a real DocuSign account.

dex_connector_docusign-0.1.0.dist-info/RECORD

@@ -0,0 +1,22 @@
+dex_connectors/docusign/__init__.py,sha256=Pm8B9FeNJeacB29fOUNyLrvA2m2ZdxmxNgWW51TfNRw,510
+dex_connectors/docusign/client.py,sha256=S3NT6ARw79F6KUhx6AOUvKYd5uCpcPK4DqUalvn1zvo,23421
+dex_connectors/docusign/connection.py,sha256=WtA9CQHZ8eHXN8YN2c5Cf_IjaMS9COaa2XRIofdo1Nc,386
+dex_connectors/docusign/dex-connector.json,sha256=nNpiFnVxeYeZvo_eumEUz35R-11g6B-FbNidwCVk2x0,4848
+dex_connectors/docusign/models.py,sha256=S1kENoabj3T4wd8SyCHLZYL8hjHj-SwuDvbirPemtoM,291
+dex_connectors/docusign/operations.py,sha256=otjmkaoD6WsfJ6WnbQ-IzD7PKUBpu1zKjgjh-jiOrE0,41749
+dex_connectors/docusign/py.typed,sha256=ShfMsAGzSt4xuhCaf20ibgtfXl4pXomZb00ovUw6CeI,66
+dex_connectors/docusign/steps.py,sha256=GE9hwfyspRv7Y1CDqlX8aGmLzETjTB1uFhXZdOGXphA,189
+dex_connectors/docusign/_generated/__init__.py,sha256=ShfMsAGzSt4xuhCaf20ibgtfXl4pXomZb00ovUw6CeI,66
+dex_connectors/docusign/_generated/config.py,sha256=3I2gAtwjuUTUxBgfma-eqKNR9mbiBYCqn6wB_fq4SkE,828
+dex_connectors/docusign/_generated/connection.py,sha256=liRG98Xr0wW5CulpM2aLM0bfv8bax7QKsz7r3UprLME,16241
+dex_connectors/docusign/_generated/definitions.py,sha256=ehuGbI0wRejSJx0Ilcl8p1Xni5O2HiqDeklJ3SRfTpw,6289
+dex_connectors/docusign/_generated/mock.py,sha256=iSYM3nBzb-jNtS8bWQznpBYtSra68Tk1hVIMOJ_W3pY,19618
+dex_connectors/docusign/_generated/models.py,sha256=g4klgaeVWHth_jpZLI0KTas2yRoFLx5lluqsoS4b6lM,18983
+dex_connectors/docusign/_generated/refresh.py,sha256=FN-xVR5_jsgrBqpJtT74GClodQw8YU5lJT86L01Myto,2562
+dex_connectors/docusign/_generated/steps.py,sha256=Cs0asCwd7SKJsYbZ9ap_Yi44WqnYMpjFz8RUyzismaY,14269
+dex_connectors/docusign/_generated/timestamps.py,sha256=Z8VwrE60w-33InIMgEMLiMPTFyRjj6oBq8tUro8Ssi8,3164
+dex_connectors/docusign/docusignmock/__init__.py,sha256=sEODfqQ6BJ0_cxRmH7FUHlzuhGC26jntpGD0cmUtm_U,167
+dex_connector_docusign-0.1.0.dist-info/METADATA,sha256=dxx2RmgU0_I2yPnR1ACfIr_pUOdIpZVMw7KN2YDvErc,4298
+dex_connector_docusign-0.1.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+dex_connector_docusign-0.1.0.dist-info/licenses/LICENSE,sha256=WNj87Zd5micrAShl1LujOPM6PDzDqjlNLrryDZ4hE0M,1070
+dex_connector_docusign-0.1.0.dist-info/RECORD,,

dex_connector_docusign-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

dex_connector_docusign-0.1.0.dist-info/licenses/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.

dex_connectors/docusign/__init__.py

@@ -0,0 +1,17 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+"""Dex-native DocuSign eSignature operations."""
+
+from .client import Client, CombinedDocumentStore
+from .connection import Connection, new_connection, new_connection_with_operations, new_project_connection
+from .models import *  # noqa: F403
+from .steps import *  # noqa: F403
+
+__all__ = [
+    "Client",
+    "CombinedDocumentStore",
+    "Connection",
+    "new_connection",
+    "new_connection_with_operations",
+    "new_project_connection",
+]

dex_connectors/docusign/_generated/__init__.py

@@ -0,0 +1,2 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT

dex_connectors/docusign/_generated/config.py

@@ -0,0 +1,31 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+# ruff: noqa
+
+from dataclasses import dataclass
+
+from dex_connectors.sdk import SecretString
+
+
+@dataclass(frozen=True, slots=True)
+class Config:
+
+    account_id: str = ''
+    max_response_bytes: int = 1048576
+    max_document_bytes: int = 67108864
+    connect_max_body_bytes: int = 2097152
+
+setattr(Config, '__module__', 'dex_connectors.docusign.client')
+
+
+@dataclass(frozen=True, slots=True)
+class Credentials:
+
+    auth_method_id: str = "docusign-oauth"
+    oauth_client_id: str | None = None
+    oauth_client_secret: SecretString | None = None
+    access_token: SecretString | None = None
+    refresh_token: SecretString | None = None
+    connect_hmac_key: SecretString = SecretString('')
+
+setattr(Credentials, '__module__', 'dex_connectors.docusign.client')

dex_connectors/docusign/_generated/connection.py

@@ -0,0 +1,274 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+# ruff: noqa
+
+from typing import Any
+
+import httpx
+from dex_connectors.sdk import ConnectionRef, Mutation, Query, Call, SecretString, CredentialRefreshDriver
+from dex_connectors.sdk.projectconfig import ConnectionKey, LoadedProject
+from dex_connectors.sdk.projectconfig.provider import RefreshingCredentialProvider
+from dex_connectors.sdk.oauthtoken import ManifestCredentialRefreshDriver
+
+from ..client import Client, Config, Credentials
+from .definitions import CONNECTOR_ID, CREATE_ENVELOPE_FROM_TEMPLATE_DEFINITION, DOWNLOAD_COMBINED_DOCUMENT_DEFINITION, GET_ENVELOPE_DEFINITION, LIST_ENVELOPE_RECIPIENTS_DEFINITION, VOID_ENVELOPE_DEFINITION
+from .refresh import AUTHORIZATION, CREDENTIAL_FIELDS
+from ..models import CombinedDocument, CreateEnvelopeFromTemplateInput, CreatedEnvelope, DownloadCombinedDocumentInput, Envelope, EnvelopeRecipients, GetEnvelopeInput, ListEnvelopeRecipientsInput, VoidEnvelopeInput, VoidedEnvelope
+
+class Connection:
+
+    __slots__ = ('_create_envelope_from_template', '_get_envelope', '_list_envelope_recipients', '_void_envelope', '_download_combined_document', '_client', 'reference')
+
+    def __init__(self,
+        reference: ConnectionRef,
+        create_envelope_from_template: Mutation[CreateEnvelopeFromTemplateInput, CreatedEnvelope],
+        get_envelope: Query[GetEnvelopeInput, Envelope],
+        list_envelope_recipients: Query[ListEnvelopeRecipientsInput, EnvelopeRecipients],
+        void_envelope: Mutation[VoidEnvelopeInput, VoidedEnvelope],
+        download_combined_document: Query[DownloadCombinedDocumentInput, CombinedDocument],
+        client: Client | None = None,
+    ) -> None:
+        reference.validate()
+        if reference.provider != CONNECTOR_ID or create_envelope_from_template is None or get_envelope is None or list_envelope_recipients is None or void_envelope is None or download_combined_document is None:
+            raise ValueError("DocuSign eSignature connection provider and operations are required")
+        if create_envelope_from_template.definition().operation != CREATE_ENVELOPE_FROM_TEMPLATE_DEFINITION.operation:
+            raise ValueError("DocuSign eSignature connection operation identity differs")
+        if get_envelope.definition().operation != GET_ENVELOPE_DEFINITION.operation:
+            raise ValueError("DocuSign eSignature connection operation identity differs")
+        if list_envelope_recipients.definition().operation != LIST_ENVELOPE_RECIPIENTS_DEFINITION.operation:
+            raise ValueError("DocuSign eSignature connection operation identity differs")
+        if void_envelope.definition().operation != VOID_ENVELOPE_DEFINITION.operation:
+            raise ValueError("DocuSign eSignature connection operation identity differs")
+        if download_combined_document.definition().operation != DOWNLOAD_COMBINED_DOCUMENT_DEFINITION.operation:
+            raise ValueError("DocuSign eSignature connection operation identity differs")
+        self.reference = reference
+        self._create_envelope_from_template = create_envelope_from_template
+        self._get_envelope = get_envelope
+        self._list_envelope_recipients = list_envelope_recipients
+        self._void_envelope = void_envelope
+        self._download_combined_document = download_combined_document
+        self._client = client
+
+    def create_envelope_from_template(self) -> Mutation[CreateEnvelopeFromTemplateInput, CreatedEnvelope]:
+        return self._create_envelope_from_template
+
+    def get_envelope(self) -> Query[GetEnvelopeInput, Envelope]:
+        return self._get_envelope
+
+    def list_envelope_recipients(self) -> Query[ListEnvelopeRecipientsInput, EnvelopeRecipients]:
+        return self._list_envelope_recipients
+
+    def void_envelope(self) -> Mutation[VoidEnvelopeInput, VoidedEnvelope]:
+        return self._void_envelope
+
+    def download_combined_document(self) -> Query[DownloadCombinedDocumentInput, CombinedDocument]:
+        return self._download_combined_document
+
+    async def aclose(self) -> None:
+        if self._client is not None:
+            await self._client.aclose()
+
+    def __repr__(self) -> str:
+        return "docusign.Connection([REDACTED])"
+
+    def __reduce__(self) -> tuple[object, ...]:
+        raise TypeError("DocuSign eSignature connections cannot be serialized")
+
+setattr(Connection, '__module__', 'dex_connectors.docusign.connection')
+
+
+def new_connection(client: Client, reference: ConnectionRef) -> Connection:
+    if client is None:
+        raise ValueError("DocuSign eSignature client is required")
+    return Connection(reference, client.create_envelope_from_template(), client.get_envelope(), client.list_envelope_recipients(), client.void_envelope(), client.download_combined_document(), client)
+
+setattr(new_connection, '__module__', 'dex_connectors.docusign.connection')
+
+
+def new_connection_with_operations(
+    create_envelope_from_template: Mutation[CreateEnvelopeFromTemplateInput, CreatedEnvelope],
+    get_envelope: Query[GetEnvelopeInput, Envelope],
+    list_envelope_recipients: Query[ListEnvelopeRecipientsInput, EnvelopeRecipients],
+    void_envelope: Mutation[VoidEnvelopeInput, VoidedEnvelope],
+    download_combined_document: Query[DownloadCombinedDocumentInput, CombinedDocument],
+    reference: ConnectionRef,
+) -> Connection:
+    return Connection(reference, create_envelope_from_template, get_envelope, list_envelope_recipients, void_envelope, download_combined_document)
+
+setattr(new_connection_with_operations, '__module__', 'dex_connectors.docusign.connection')
+
+
+def decode_credentials(material: dict[str, Any], *, shared: bool = False) -> Credentials:
+    if not isinstance(material, dict):
+        raise ValueError("DocuSign eSignature stored credential does not match the connector credential fields")
+    if set(material) - set(('oauth_client_id', 'oauth_client_secret', 'access_token', 'refresh_token', 'connect_hmac_key', 'auth_method')):
+        raise ValueError("DocuSign eSignature stored credential does not match the connector credential fields")
+    is_shared = shared
+    oauth_client_id = material.get("oauth_client_id")
+    if oauth_client_id is not None and not (isinstance(oauth_client_id, str)):
+        raise ValueError("DocuSign eSignature credential oauth_client_id has an invalid type")
+    oauth_client_secret = material.get("oauth_client_secret")
+    if oauth_client_secret is not None and not (isinstance(oauth_client_secret, str)):
+        raise ValueError("DocuSign eSignature credential oauth_client_secret has an invalid type")
+    access_token = material.get("access_token")
+    if access_token is not None and not (isinstance(access_token, str)):
+        raise ValueError("DocuSign eSignature credential access_token has an invalid type")
+    refresh_token = material.get("refresh_token")
+    if refresh_token is not None and not (isinstance(refresh_token, str)):
+        raise ValueError("DocuSign eSignature credential refresh_token has an invalid type")
+    connect_hmac_key = material.get("connect_hmac_key")
+    if connect_hmac_key is not None and not (isinstance(connect_hmac_key, str)):
+        raise ValueError("DocuSign eSignature credential connect_hmac_key has an invalid type")
+    selected_method = material.get('auth_method')
+    if selected_method is None:
+        selected_method = ''
+    if not isinstance(selected_method, str):
+        raise ValueError("DocuSign eSignature credential auth_method is invalid")
+    method = selected_method or "docusign-oauth"
+    values: dict[str, Any] = {'auth_method_id': method}
+    if method == "docusign-oauth":
+        if not oauth_client_id:
+            raise ValueError("DocuSign eSignature credential oauth_client_id is required")
+        if oauth_client_id:
+            values["oauth_client_id"] = oauth_client_id
+        if not oauth_client_secret and not is_shared:
+            raise ValueError("DocuSign eSignature credential oauth_client_secret is required")
+        if oauth_client_secret:
+            values["oauth_client_secret"] = SecretString(oauth_client_secret)
+        if not access_token:
+            raise ValueError("DocuSign eSignature credential access_token is required")
+        if access_token:
+            values["access_token"] = SecretString(access_token)
+        if not refresh_token and not is_shared:
+            raise ValueError("DocuSign eSignature credential refresh_token is required")
+        if refresh_token:
+            values["refresh_token"] = SecretString(refresh_token)
+        values["connect_hmac_key"] = SecretString(connect_hmac_key or '')
+    elif method == "docusign-developer-oauth":
+        if not oauth_client_id:
+            raise ValueError("DocuSign eSignature credential oauth_client_id is required")
+        if oauth_client_id:
+            values["oauth_client_id"] = oauth_client_id
+        if not oauth_client_secret and not is_shared:
+            raise ValueError("DocuSign eSignature credential oauth_client_secret is required")
+        if oauth_client_secret:
+            values["oauth_client_secret"] = SecretString(oauth_client_secret)
+        if not access_token:
+            raise ValueError("DocuSign eSignature credential access_token is required")
+        if access_token:
+            values["access_token"] = SecretString(access_token)
+        if not refresh_token and not is_shared:
+            raise ValueError("DocuSign eSignature credential refresh_token is required")
+        if refresh_token:
+            values["refresh_token"] = SecretString(refresh_token)
+        values["connect_hmac_key"] = SecretString(connect_hmac_key or '')
+    else:
+        raise ValueError("DocuSign eSignature credential auth_method is invalid")
+    return Credentials(**values)
+
+
+def decode_shared_credentials(material: dict[str, Any]) -> Credentials:
+    return decode_credentials(material, shared=True)
+
+
+def encode_credentials(credentials: Credentials) -> dict[str, Any]:
+    material: dict[str, Any] = {}
+    method = credentials.auth_method_id or "docusign-oauth"
+    material['auth_method'] = method
+    if method == "docusign-oauth":
+        if credentials.oauth_client_id:
+            material["oauth_client_id"] = credentials.oauth_client_id
+        if (credentials.oauth_client_secret.reveal() if credentials.oauth_client_secret is not None else ''):
+            material["oauth_client_secret"] = (credentials.oauth_client_secret.reveal() if credentials.oauth_client_secret is not None else '')
+        if (credentials.access_token.reveal() if credentials.access_token is not None else ''):
+            material["access_token"] = (credentials.access_token.reveal() if credentials.access_token is not None else '')
+        if (credentials.refresh_token.reveal() if credentials.refresh_token is not None else ''):
+            material["refresh_token"] = (credentials.refresh_token.reveal() if credentials.refresh_token is not None else '')
+        if (credentials.connect_hmac_key.reveal() if credentials.connect_hmac_key is not None else ''):
+            material["connect_hmac_key"] = (credentials.connect_hmac_key.reveal() if credentials.connect_hmac_key is not None else '')
+    elif method == "docusign-developer-oauth":
+        if credentials.oauth_client_id:
+            material["oauth_client_id"] = credentials.oauth_client_id
+        if (credentials.oauth_client_secret.reveal() if credentials.oauth_client_secret is not None else ''):
+            material["oauth_client_secret"] = (credentials.oauth_client_secret.reveal() if credentials.oauth_client_secret is not None else '')
+        if (credentials.access_token.reveal() if credentials.access_token is not None else ''):
+            material["access_token"] = (credentials.access_token.reveal() if credentials.access_token is not None else '')
+        if (credentials.refresh_token.reveal() if credentials.refresh_token is not None else ''):
+            material["refresh_token"] = (credentials.refresh_token.reveal() if credentials.refresh_token is not None else '')
+        if (credentials.connect_hmac_key.reveal() if credentials.connect_hmac_key is not None else ''):
+            material["connect_hmac_key"] = (credentials.connect_hmac_key.reveal() if credentials.connect_hmac_key is not None else '')
+    else:
+        raise ValueError("DocuSign eSignature credential auth_method is invalid")
+    decode_credentials(material)
+    return material
+
+
+class _ProjectCredentialSource:
+    def __init__(self, project: LoadedProject, key: ConnectionKey, http_client: httpx.AsyncClient, settings: dict[str, Any]) -> None:
+        self.provider = RefreshingCredentialProvider(
+            project.connections, key, decode_credentials, encode_credentials, decode_shared_credentials
+        )
+        self.driver = ManifestCredentialRefreshDriver[Credentials]("DocuSign eSignature", AUTHORIZATION, CREDENTIAL_FIELDS, http_client, settings=settings)
+
+    async def resolve(self, call: Call) -> Credentials:
+        return await self.provider.resolve_with_refresh(call, self.driver)
+
+    async def resolve_with_refresh(self, call: Call, driver: CredentialRefreshDriver[Credentials] | None = None) -> Credentials:
+        return await self.provider.resolve_with_refresh(call, driver or self.driver)
+
+    async def resolve_after_rejection(self, call: Call, driver: CredentialRefreshDriver[Credentials] | None = None) -> Credentials:
+        return await self.provider.resolve_after_rejection(call, driver or self.driver)
+
+
+def new_project_connection(
+    project: LoadedProject, connection_name: str, http_client: httpx.AsyncClient | None = None
+) -> Connection:
+    if project is None:
+        raise ValueError("DocuSign eSignature connection requires loaded project configuration")
+    reference = ConnectionRef(CONNECTOR_ID, connection_name)
+    reference.validate()
+    key = ConnectionKey(CONNECTOR_ID, connection_name)
+    matching = [
+        entry
+        for entry in project.configuration.connections
+        if entry.connector_id == CONNECTOR_ID and entry.connection_name == connection_name
+    ]
+    if len(matching) != 1:
+        raise ValueError("DocuSign eSignature project connection is missing or duplicated")
+    if matching[0].provider != CONNECTOR_ID:
+        raise ValueError("DocuSign eSignature project connection provider differs")
+    config = _decode_config(matching[0].configuration)
+    http_client = http_client or httpx.AsyncClient()
+    client = Client(config, _ProjectCredentialSource(project, key, http_client, matching[0].configuration), http_client)
+    return new_connection(client, reference)
+
+setattr(new_project_connection, '__module__', 'dex_connectors.docusign.connection')
+
+
+def _decode_config(value: dict[str, Any]) -> Config:
+    if set(value) - {"accountId", "maxResponseBytes", "maxDocumentBytes", "connectMaxBodyBytes"}:
+        raise ValueError("DocuSign eSignature configuration has unknown fields")
+    config_arguments: dict[str, Any] = {}
+    if "accountId" in value:
+        account_id = value["accountId"]
+        if not (isinstance(account_id, str)):
+            raise ValueError("DocuSign eSignature configuration accountId has an invalid type")
+        config_arguments['account_id'] = account_id
+    else:
+        config_arguments['account_id'] = ''
+    if "maxResponseBytes" in value:
+        max_response_bytes = value["maxResponseBytes"]
+        if not (type(max_response_bytes) is int):
+            raise ValueError("DocuSign eSignature configuration maxResponseBytes has an invalid type")
+        config_arguments['max_response_bytes'] = max_response_bytes
+    if "maxDocumentBytes" in value:
+        max_document_bytes = value["maxDocumentBytes"]
+        if not (type(max_document_bytes) is int):
+            raise ValueError("DocuSign eSignature configuration maxDocumentBytes has an invalid type")
+        config_arguments['max_document_bytes'] = max_document_bytes
+    if "connectMaxBodyBytes" in value:
+        connect_max_body_bytes = value["connectMaxBodyBytes"]
+        if not (type(connect_max_body_bytes) is int):
+            raise ValueError("DocuSign eSignature configuration connectMaxBodyBytes has an invalid type")
+        config_arguments['connect_max_body_bytes'] = connect_max_body_bytes
+    return Config(**config_arguments)

dex_connectors/docusign/_generated/definitions.py

@@ -0,0 +1,117 @@
+# Copyright (c) 2026 Super Durable
+# SPDX-License-Identifier: MIT
+# ruff: noqa
+
+from datetime import timedelta
+
+from dex_connectors.sdk import (
+    BranchDefinition,
+    MutationDefinition,
+    OperationRef,
+    QueryDefinition,
+    RetryPolicy,
+    StepDefaults,
+    default_connector_step_execute_retry_policy,
+)
+
+CONNECTOR_ID = "docusign"
+PROVIDER = "docusign"
+CREATE_ENVELOPE_FROM_TEMPLATE_OPERATION_ID = "createEnvelopeFromTemplate"
+GET_ENVELOPE_OPERATION_ID = "getEnvelope"
+LIST_ENVELOPE_RECIPIENTS_OPERATION_ID = "listEnvelopeRecipients"
+VOID_ENVELOPE_OPERATION_ID = "voidEnvelope"
+DOWNLOAD_COMBINED_DOCUMENT_OPERATION_ID = "downloadCombinedDocument"
+CREATED = "created"
+DEFECT = "defect"
+DOWNLOADED = "downloaded"
+FOUND = "found"
+INVALID_RESPONSE = "invalidResponse"
+LISTED = "listed"
+NOT_FOUND = "notFound"
+NOT_VOIDABLE = "notVoidable"
+PROVIDER_REJECTED = "providerRejected"
+TOO_LARGE = "tooLarge"
+UNCERTAIN = "uncertain"
+VOIDED = "voided"
+
+CREATE_ENVELOPE_FROM_TEMPLATE_DEFINITION = MutationDefinition(
+    OperationRef(CONNECTOR_ID, CREATE_ENVELOPE_FROM_TEMPLATE_OPERATION_ID),
+    (
+        BranchDefinition(CREATED, "DocuSign holds the envelope this Step execution created; wasRecovered tells whether a later attempt found it by its custom field after an interrupted one.", False),
+        BranchDefinition(PROVIDER_REJECTED, "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.", True),
+        BranchDefinition(UNCERTAIN, "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.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=60),
+        1,
+        execute_retry=RetryPolicy(timedelta(seconds=1), 2, timedelta(seconds=60), 6, timedelta(seconds=3900)),
+    ),
+)
+
+GET_ENVELOPE_DEFINITION = QueryDefinition(
+    OperationRef(CONNECTOR_ID, GET_ENVELOPE_OPERATION_ID),
+    (
+        BranchDefinition(FOUND, "DocuSign returned the envelope.", False),
+        BranchDefinition(NOT_FOUND, "The envelope does not exist in the connection's account or the user may not see it.", True),
+        BranchDefinition(PROVIDER_REJECTED, "DocuSign conclusively rejected the read, such as a revoked consent or a user without access to the account.", True),
+        BranchDefinition(INVALID_RESPONSE, "DocuSign returned a malformed or oversized response.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        2,
+        execute_retry=RetryPolicy(timedelta(seconds=1), 2, timedelta(seconds=60), 0, timedelta(seconds=3900)),
+    ),
+)
+
+LIST_ENVELOPE_RECIPIENTS_DEFINITION = QueryDefinition(
+    OperationRef(CONNECTOR_ID, LIST_ENVELOPE_RECIPIENTS_OPERATION_ID),
+    (
+        BranchDefinition(LISTED, "DocuSign returned the envelope's recipients.", False),
+        BranchDefinition(NOT_FOUND, "The envelope does not exist in the connection's account or the user may not see it.", True),
+        BranchDefinition(PROVIDER_REJECTED, "DocuSign conclusively rejected the read, such as a revoked consent or a user without access to the account.", True),
+        BranchDefinition(INVALID_RESPONSE, "DocuSign returned a malformed or oversized response.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        2,
+        execute_retry=RetryPolicy(timedelta(seconds=1), 2, timedelta(seconds=60), 0, timedelta(seconds=3900)),
+    ),
+)
+
+VOID_ENVELOPE_DEFINITION = MutationDefinition(
+    OperationRef(CONNECTOR_ID, VOID_ENVELOPE_OPERATION_ID),
+    (
+        BranchDefinition(VOIDED, "The envelope is voided, by this call or earlier; wasAlreadyVoided tells which.", False),
+        BranchDefinition(NOT_VOIDABLE, "The envelope is completed, declined, or still a draft, which DocuSign does not void; status names which.", True),
+        BranchDefinition(NOT_FOUND, "The envelope does not exist in the connection's account or the user may not see it.", True),
+        BranchDefinition(PROVIDER_REJECTED, "DocuSign conclusively rejected the void, such as a user who is not the sender or lacks permission.", True),
+        BranchDefinition(INVALID_RESPONSE, "DocuSign returned a malformed or oversized response.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=30),
+        2,
+        execute_retry=RetryPolicy(timedelta(seconds=1), 2, timedelta(seconds=60), 0, timedelta(seconds=3900)),
+    ),
+)
+
+DOWNLOAD_COMBINED_DOCUMENT_DEFINITION = QueryDefinition(
+    OperationRef(CONNECTOR_ID, DOWNLOAD_COMBINED_DOCUMENT_OPERATION_ID),
+    (
+        BranchDefinition(DOWNLOADED, "DocuSign returned the combined PDF and its digest was recorded, and stored when the client has a CombinedDocumentStore.", False),
+        BranchDefinition(NOT_FOUND, "The envelope does not exist in the connection's account or the user may not see it.", True),
+        BranchDefinition(TOO_LARGE, "The combined PDF exceeds the connection's maxDocumentBytes; nothing was stored.", True),
+        BranchDefinition(PROVIDER_REJECTED, "DocuSign conclusively rejected the download, such as a revoked consent or a user without access to the envelope.", True),
+        BranchDefinition(INVALID_RESPONSE, "DocuSign returned something other than a complete PDF, or the CombinedDocumentStore rejected it.", True),
+        BranchDefinition(DEFECT, "Local input, connection configuration, or connector definition is invalid.", True),
+    ),
+    StepDefaults(
+        timedelta(seconds=120),
+        2,
+        heartbeat_timeout=timedelta(seconds=30),
+        execute_retry=RetryPolicy(timedelta(seconds=1), 2, timedelta(seconds=60), 0, timedelta(seconds=3900)),
+    ),
+)