@keystrokehq/docusign 0.0.1

package/dist/client.mjs

@@ -0,0 +1,286 @@
+import { DocusignApiError } from "./errors.mjs";
+import { r as toQueryValue } from "./shared-DTUCJayR.mjs";
+import { CredentialRevokedError } from "@keystrokehq/core/errors";
+
+//#region src/client.ts
+/**
+* Hand-rolled typed DocuSign eSignature REST v2.1 client.
+*
+* Responsibilities:
+*   - account-scoped URL construction (`{baseUri}/restapi/v2.1/accounts/{accountId}`)
+*   - JSON, binary, and multipart request/response handling
+*   - retry on 429 + 5xx with `Retry-After` honoring and jittered exponential
+*     backoff for transient failures
+*   - error normalization through `DocusignApiError`
+*   - `listAll` pagination walker for endpoints that expose `nextUri`
+*   - minimal surface — each domain file builds a typed request from the
+*     low-level `request`/`requestBinary`/`requestMultipart` helpers instead
+*     of depending on a huge method-per-endpoint wrapper object.
+*
+* Why not the official `docusign-esign` SDK: it pulls `superagent`, `node:fs`,
+* and `jsonwebtoken` which do not work in Cloudflare Workers / V8 isolates.
+* See IMPLEMENTATION_NOTES.md § 3.
+*/
+const ESIGNATURE_API_PREFIX = "/restapi/v2.1/accounts";
+const MAX_RETRIES = 3;
+const BASE_RETRY_DELAY_MS = 250;
+const MAX_RETRY_DELAY_MS = 8e3;
+function normalizeBaseUri(baseUri) {
+	return baseUri.endsWith("/") ? baseUri.slice(0, -1) : baseUri;
+}
+function jitter(ms) {
+	return ms + Math.floor(Math.random() * ms * .25);
+}
+function parseRetryAfterHeader(value) {
+	if (!value) return void 0;
+	const asNumber = Number(value);
+	if (Number.isFinite(asNumber)) return Math.max(0, asNumber * 1e3);
+	const asDate = Date.parse(value);
+	if (Number.isFinite(asDate)) return Math.max(0, asDate - Date.now());
+}
+async function sleep(ms) {
+	await new Promise((resolve) => setTimeout(resolve, ms));
+}
+function applyQuery(url, query) {
+	if (!query) return;
+	for (const [key, value] of Object.entries(query)) {
+		const serialized = toQueryValue(value);
+		if (serialized !== void 0) url.searchParams.set(key, serialized);
+	}
+}
+function resolveUrl(internals, init) {
+	const base = normalizeBaseUri(internals.baseUri);
+	const prefix = init.accountScoped === false ? "" : `${ESIGNATURE_API_PREFIX}/${internals.accountId}`;
+	const path = init.path.startsWith("/") ? init.path : `/${init.path}`;
+	const url = new URL(`${base}${prefix}${path}`);
+	applyQuery(url, init.query);
+	return url.toString();
+}
+function buildResolvedRequest(internals, init) {
+	const method = init.method ?? "GET";
+	const url = resolveUrl(internals, init);
+	const headers = {
+		Authorization: `Bearer ${internals.accessToken}`,
+		Accept: init.accept ?? "application/json",
+		...init.headers ?? {}
+	};
+	let body;
+	if (init.body !== void 0) if (init.body instanceof Uint8Array) {
+		body = init.body;
+		headers["Content-Type"] = headers["Content-Type"] ?? "application/octet-stream";
+	} else if (typeof init.body === "string") {
+		body = init.body;
+		headers["Content-Type"] = headers["Content-Type"] ?? "application/json";
+	} else {
+		body = JSON.stringify(init.body);
+		headers["Content-Type"] = headers["Content-Type"] ?? "application/json";
+	}
+	return {
+		url,
+		method,
+		headers,
+		body
+	};
+}
+function extractRequestId(headers) {
+	return headers.get("X-DocuSign-TraceToken") ?? headers.get("x-docusign-tracetoken") ?? void 0;
+}
+function collectHeaders(headers) {
+	const collected = {};
+	headers.forEach((value, key) => {
+		collected[key.toLowerCase()] = value;
+	});
+	return collected;
+}
+async function readErrorBody(response) {
+	const contentType = response.headers.get("content-type") ?? "";
+	try {
+		if (contentType.includes("application/json")) return await response.json();
+		return await response.text();
+	} catch {
+		return;
+	}
+}
+async function readJsonBody(response) {
+	if (response.status === 204) return void 0;
+	if ((response.headers.get("content-type") ?? "").includes("application/json")) return await response.json();
+	return await response.text();
+}
+function isAuthError(error) {
+	if (error instanceof DocusignApiError) return error.kind === "auth";
+	return false;
+}
+function buildMultipartBody(parts) {
+	const boundary = `----docusign-${Math.random().toString(36).slice(2)}${Date.now().toString(36)}`;
+	const delimiter = `--${boundary}`;
+	const closing = `--${boundary}--`;
+	const chunks = [];
+	const encoder = new TextEncoder();
+	for (const part of parts) {
+		const header = `${delimiter}\r\nContent-Disposition: ${part.filename ? `form-data; name="${part.name}"; filename="${part.filename}"` : `form-data; name="${part.name}"`}\r\nContent-Type: ${part.contentType}\r\n\r\n`;
+		chunks.push(encoder.encode(header));
+		const rawContent = part.serializeAsJson ? JSON.stringify(part.content) : part.content;
+		if (typeof rawContent === "string") chunks.push(encoder.encode(rawContent));
+		else if (rawContent instanceof Uint8Array) chunks.push(rawContent);
+		else chunks.push(encoder.encode(JSON.stringify(rawContent)));
+		chunks.push(encoder.encode("\r\n"));
+	}
+	chunks.push(encoder.encode(`${closing}\r\n`));
+	const totalLength = chunks.reduce((size, chunk) => size + chunk.length, 0);
+	const combined = new Uint8Array(totalLength);
+	let offset = 0;
+	for (const chunk of chunks) {
+		combined.set(chunk, offset);
+		offset += chunk.length;
+	}
+	return {
+		body: combined,
+		contentType: `multipart/form-data; boundary=${boundary}`
+	};
+}
+async function performRequest(resolved, internals) {
+	let attempt = 0;
+	while (true) {
+		let response;
+		try {
+			response = await fetch(resolved.url, {
+				method: resolved.method,
+				headers: resolved.headers,
+				body: resolved.body
+			});
+		} catch (cause) {
+			if (attempt >= MAX_RETRIES) throw new DocusignApiError(`DocuSign ${resolved.method} ${resolved.url} network error.`, {
+				kind: "network",
+				retryable: true,
+				cause
+			});
+			await sleep(Math.min(MAX_RETRY_DELAY_MS, jitter(BASE_RETRY_DELAY_MS * 2 ** attempt)));
+			attempt += 1;
+			continue;
+		}
+		if (response.status === 429 || response.status >= 500) {
+			if (attempt >= MAX_RETRIES) return response;
+			const delay = parseRetryAfterHeader(response.headers.get("retry-after")) ?? jitter(BASE_RETRY_DELAY_MS * 2 ** attempt);
+			await sleep(Math.min(MAX_RETRY_DELAY_MS, delay));
+			attempt += 1;
+			continue;
+		}
+		return response;
+	}
+}
+async function resolveErrorFromResponse(resolved, response) {
+	const body = await readErrorBody(response);
+	return DocusignApiError.fromResponse({
+		status: response.status,
+		body,
+		requestId: extractRequestId(response.headers),
+		retryAfterMs: parseRetryAfterHeader(response.headers.get("retry-after")),
+		url: resolved.url,
+		method: resolved.method
+	});
+}
+function createDocusignClient(credentials) {
+	const accessToken = credentials.DOCUSIGN_ACCESS_TOKEN.trim();
+	const accountId = credentials.DOCUSIGN_ACCOUNT_ID.trim();
+	const baseUri = credentials.DOCUSIGN_BASE_URI.trim();
+	if (accessToken.length === 0 || accountId.length === 0 || baseUri.length === 0) throw new CredentialRevokedError("keystroke:docusign", "DocuSign credentials are missing required fields (access token, account id, base URI). Re-run `keystroke connect docusign`.");
+	const internals = {
+		accessToken,
+		accountId,
+		baseUri
+	};
+	async function request(init) {
+		const resolved = buildResolvedRequest(internals, init);
+		const response = await performRequest(resolved, internals);
+		if (!response.ok) {
+			const error = await resolveErrorFromResponse(resolved, response);
+			if (isAuthError(error)) throw new CredentialRevokedError("keystroke:docusign", `DocuSign authentication failed while calling ${resolved.method} ${resolved.url}. The stored credentials may be revoked or expired.`);
+			throw error;
+		}
+		return await readJsonBody(response);
+	}
+	async function requestBinary(init) {
+		const resolved = buildResolvedRequest(internals, {
+			...init,
+			accept: init.accept ?? "application/pdf"
+		});
+		const response = await performRequest(resolved, internals);
+		if (!response.ok) {
+			const error = await resolveErrorFromResponse(resolved, response);
+			if (isAuthError(error)) throw new CredentialRevokedError("keystroke:docusign", `DocuSign authentication failed while downloading ${resolved.method} ${resolved.url}.`);
+			throw error;
+		}
+		return {
+			body: new Uint8Array(await response.arrayBuffer()),
+			contentType: response.headers.get("content-type") ?? void 0,
+			contentDisposition: response.headers.get("content-disposition") ?? void 0,
+			status: response.status,
+			headers: collectHeaders(response.headers)
+		};
+	}
+	async function requestMultipart(init) {
+		const { parts, headers, ...rest } = init;
+		const { body, contentType } = buildMultipartBody(parts);
+		return request({
+			...rest,
+			body,
+			headers: {
+				...headers ?? {},
+				"Content-Type": contentType
+			}
+		});
+	}
+	async function* listAll(init, options) {
+		let cursor = {
+			path: init.path,
+			query: init.query
+		};
+		while (true) {
+			const payload = await request({
+				...init,
+				path: cursor.path ?? init.path,
+				query: cursor.query ?? init.query
+			});
+			for (const item of options.items(payload)) yield item;
+			const nextUri = extractNextUri(payload);
+			if (!nextUri) return;
+			const relative = extractRelativePath(nextUri, internals);
+			if (!relative) return;
+			cursor = relative;
+		}
+	}
+	return {
+		accountId,
+		baseUri,
+		request,
+		requestBinary,
+		requestMultipart,
+		listAll
+	};
+}
+function extractNextUri(payload) {
+	if (typeof payload !== "object" || payload === null) return void 0;
+	const nextUri = payload.nextUri;
+	return typeof nextUri === "string" && nextUri.length > 0 ? nextUri : void 0;
+}
+function extractRelativePath(nextUri, internals) {
+	try {
+		const absolute = nextUri.startsWith("http") ? new URL(nextUri) : new URL(nextUri, normalizeBaseUri(internals.baseUri));
+		const prefix = `${ESIGNATURE_API_PREFIX}/${internals.accountId}`;
+		const pathname = absolute.pathname;
+		const path = pathname.startsWith(prefix) ? pathname.slice(prefix.length) : pathname;
+		const query = {};
+		absolute.searchParams.forEach((value, key) => {
+			query[key] = value;
+		});
+		return {
+			path,
+			query
+		};
+	} catch {
+		return;
+	}
+}
+
+//#endregion
+export { createDocusignClient };

package/dist/clm.d.mts

@@ -0,0 +1,18 @@
+import { z } from "zod";
+import * as _keystrokehq_core0 from "@keystrokehq/core";
+import * as _keystrokehq_core_credential_set0 from "@keystrokehq/core/credential-set";
+
+//#region src/clm.d.ts
+declare const clmNotImplemented: _keystrokehq_core0.Operation<z.ZodObject<{}, z.core.$catchall<z.ZodUnknown>>, z.ZodObject<{
+  [x: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$catchall<z.ZodUnknown>>, readonly [_keystrokehq_core0.CredentialSet<"docusign", z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>>[] | undefined>], undefined>;
+//#endregion
+export { clmNotImplemented };

package/dist/clm.mjs

@@ -0,0 +1,20 @@
+import { docusignGenericObjectSchema } from "./schemas/index.mjs";
+import { n as definePlanGatedOperation } from "./operation-helpers-BMTArRh9.mjs";
+import { z } from "zod";
+
+//#region src/clm.ts
+/**
+* DocuSign CLM (SpringCM) — plan-gated in v1.
+*/
+const clmNotImplemented = definePlanGatedOperation({
+	id: "clm_not_implemented",
+	slug: "DOCUSIGN_CLM_NOT_IMPLEMENTED",
+	name: "DocuSign CLM (not implemented)",
+	description: "Placeholder for DocuSign Contract Lifecycle Management. Plan-gated in v1.",
+	input: z.object({}).catchall(z.unknown()),
+	output: docusignGenericObjectSchema,
+	reason: "DocuSign CLM is a plan-gated product with a region-specific host (`https://apiuatna11.springcm.com/v2/...`). Not enabled in this Keystroke deployment."
+});
+
+//#endregion
+export { clmNotImplemented };

package/dist/cloud-storage.d.mts

@@ -0,0 +1,122 @@
+import { z } from "zod";
+import * as _keystrokehq_core0 from "@keystrokehq/core";
+import * as _keystrokehq_core_credential_set0 from "@keystrokehq/core/credential-set";
+
+//#region src/cloud-storage.d.ts
+declare const configureCloudStorageRedirectUrl: _keystrokehq_core0.Operation<z.ZodObject<{
+  userId: z.ZodString;
+  serviceId: z.ZodString;
+  cloudStorage: z.ZodObject<{
+    [x: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+  }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+  [x: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$catchall<z.ZodUnknown>>, readonly [_keystrokehq_core0.CredentialSet<"docusign", z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const getUserCloudStorageProviderConfiguration: _keystrokehq_core0.Operation<z.ZodObject<{
+  userId: z.ZodString;
+  serviceId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  [x: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$catchall<z.ZodUnknown>>, readonly [_keystrokehq_core0.CredentialSet<"docusign", z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const retrieveCloudStorageProviderConfiguration: _keystrokehq_core0.Operation<z.ZodObject<{
+  userId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  [x: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$catchall<z.ZodUnknown>>, readonly [_keystrokehq_core0.CredentialSet<"docusign", z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const deleteUserAuthForCloudStorageProviders: _keystrokehq_core0.Operation<z.ZodObject<{
+  userId: z.ZodString;
+  cloudStorage: z.ZodObject<{
+    [x: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+  }, z.core.$catchall<z.ZodUnknown>>;
+}, z.core.$strip>, z.ZodObject<{
+  success: z.ZodBoolean;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"docusign", z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const deleteUserCloudStorageAuthentication: _keystrokehq_core0.Operation<z.ZodObject<{
+  userId: z.ZodString;
+  serviceId: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+  success: z.ZodBoolean;
+}, z.core.$strip>, readonly [_keystrokehq_core0.CredentialSet<"docusign", z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const listCloudStorageItems: _keystrokehq_core0.Operation<z.ZodObject<{
+  userId: z.ZodString;
+  serviceId: z.ZodString;
+  cloudStorageFolderPath: z.ZodOptional<z.ZodString>;
+  cloudStorageFolderidPlain: z.ZodOptional<z.ZodString>;
+  count: z.ZodOptional<z.ZodNumber>;
+  order: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  orderBy: z.ZodOptional<z.ZodString>;
+  searchText: z.ZodOptional<z.ZodString>;
+  startPosition: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  [x: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$catchall<z.ZodUnknown>>, readonly [_keystrokehq_core0.CredentialSet<"docusign", z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>>[] | undefined>], undefined>;
+declare const retrieveItemsInCloudStorageFolder: _keystrokehq_core0.Operation<z.ZodObject<{
+  userId: z.ZodString;
+  serviceId: z.ZodString;
+  folderId: z.ZodString;
+  count: z.ZodOptional<z.ZodNumber>;
+  startPosition: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>, z.ZodObject<{
+  [x: string]: z.core.$ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
+}, z.core.$catchall<z.ZodUnknown>>, readonly [_keystrokehq_core0.CredentialSet<"docusign", z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>, readonly _keystrokehq_core_credential_set0.CredentialConnection<z.ZodObject<{
+  DOCUSIGN_ACCESS_TOKEN: z.ZodString;
+  DOCUSIGN_ACCOUNT_ID: z.ZodString;
+  DOCUSIGN_BASE_URI: z.ZodURL;
+}, z.core.$strip>>[] | undefined>], undefined>;
+//#endregion
+export { configureCloudStorageRedirectUrl, deleteUserAuthForCloudStorageProviders, deleteUserCloudStorageAuthentication, getUserCloudStorageProviderConfiguration, listCloudStorageItems, retrieveCloudStorageProviderConfiguration, retrieveItemsInCloudStorageFolder };

package/dist/cloud-storage.mjs

@@ -0,0 +1,115 @@
+import { docusignGenericObjectSchema, docusignLooseObjectSchema, docusignSuccessSchema } from "./schemas/index.mjs";
+import { r as defineRestOperation } from "./operation-helpers-BMTArRh9.mjs";
+import { z } from "zod";
+
+//#region src/cloud-storage.ts
+/**
+* Cloud storage integration (per-user provider config + items). Covers PLAN.md § 6.27.
+*/
+const userId = z.object({ userId: z.string().min(1) });
+const userProvider = userId.extend({ serviceId: z.string().min(1) });
+const configureCloudStorageRedirectUrl = defineRestOperation({
+	id: "configure_cloud_storage_redirect_url",
+	slug: "DOCUSIGN_CONFIGURE_CLOUD_STORAGE_REDIRECT_URL",
+	name: "Configure Cloud Storage Redirect URL",
+	description: "Configure the OAuth redirect URL for a cloud-storage provider for a user.",
+	needsApproval: true,
+	method: "POST",
+	path: (ctx) => `/users/${ctx.encode(String(ctx.input.userId))}/cloud_storage/${ctx.encode(String(ctx.input.serviceId))}`,
+	input: userProvider.extend({ cloudStorage: docusignLooseObjectSchema() }),
+	output: docusignGenericObjectSchema,
+	body: (input) => input.cloudStorage
+});
+const getUserCloudStorageProviderConfiguration = defineRestOperation({
+	id: "get_user_cloud_storage_provider_configuration",
+	slug: "DOCUSIGN_GET_USER_CLOUD_STORAGE_PROVIDER_CONFIGURATION",
+	name: "Get User Cloud Storage Provider",
+	description: "Get the cloud-storage provider config for a user.",
+	method: "GET",
+	path: (ctx) => `/users/${ctx.encode(String(ctx.input.userId))}/cloud_storage/${ctx.encode(String(ctx.input.serviceId))}`,
+	input: userProvider,
+	output: docusignGenericObjectSchema
+});
+const retrieveCloudStorageProviderConfiguration = defineRestOperation({
+	id: "retrieve_cloud_storage_provider_configuration",
+	slug: "DOCUSIGN_RETRIEVE_CLOUD_STORAGE_PROVIDER_CONFIGURATION",
+	name: "Retrieve Cloud Storage Provider",
+	description: "List configured cloud-storage providers for a user.",
+	method: "GET",
+	path: (ctx) => `/users/${ctx.encode(String(ctx.input.userId))}/cloud_storage`,
+	input: userId,
+	output: docusignGenericObjectSchema
+});
+const deleteUserAuthForCloudStorageProviders = defineRestOperation({
+	id: "delete_user_auth_for_cloud_storage_providers",
+	slug: "DOCUSIGN_DELETE_USER_AUTH_FOR_CLOUD_STORAGE_PROVIDERS",
+	name: "Delete User Cloud Storage Auth (bulk)",
+	description: "Remove a user authentication from a cloud-storage provider.",
+	needsApproval: true,
+	method: "DELETE",
+	path: (ctx) => `/users/${ctx.encode(String(ctx.input.userId))}/cloud_storage`,
+	input: userId.extend({ cloudStorage: docusignLooseObjectSchema() }),
+	output: docusignSuccessSchema,
+	body: (input) => input.cloudStorage,
+	transformResponse: () => ({ success: true })
+});
+const deleteUserCloudStorageAuthentication = defineRestOperation({
+	id: "delete_user_cloud_storage_authentication",
+	slug: "DOCUSIGN_DELETE_USER_CLOUD_STORAGE_AUTHENTICATION",
+	name: "Delete User Cloud Storage Authentication",
+	description: "Remove a single cloud-storage authentication for a user.",
+	needsApproval: true,
+	method: "DELETE",
+	path: (ctx) => `/users/${ctx.encode(String(ctx.input.userId))}/cloud_storage/${ctx.encode(String(ctx.input.serviceId))}`,
+	input: userProvider,
+	output: docusignSuccessSchema,
+	transformResponse: () => ({ success: true })
+});
+const listCloudStorageItems = defineRestOperation({
+	id: "list_cloud_storage_items",
+	slug: "DOCUSIGN_LIST_CLOUD_STORAGE_ITEMS",
+	name: "List Cloud Storage Items",
+	description: "List items available in a configured cloud-storage provider for a user.",
+	method: "GET",
+	path: (ctx) => `/users/${ctx.encode(String(ctx.input.userId))}/cloud_storage/${ctx.encode(String(ctx.input.serviceId))}/folders`,
+	input: userProvider.extend({
+		cloudStorageFolderPath: z.string().optional(),
+		cloudStorageFolderidPlain: z.string().optional(),
+		count: z.number().int().positive().optional(),
+		order: z.enum(["asc", "desc"]).optional(),
+		orderBy: z.string().optional(),
+		searchText: z.string().optional(),
+		startPosition: z.number().int().nonnegative().optional()
+	}),
+	output: docusignGenericObjectSchema,
+	query: (input) => ({
+		cloud_storage_folder_path: input.cloudStorageFolderPath,
+		cloud_storage_folderid_plain: input.cloudStorageFolderidPlain,
+		count: input.count,
+		order: input.order,
+		order_by: input.orderBy,
+		search_text: input.searchText,
+		start_position: input.startPosition
+	})
+});
+const retrieveItemsInCloudStorageFolder = defineRestOperation({
+	id: "retrieve_items_in_cloud_storage_folder",
+	slug: "DOCUSIGN_RETRIEVE_ITEMS_IN_CLOUD_STORAGE_FOLDER",
+	name: "Retrieve Items In Cloud Storage Folder",
+	description: "Retrieve items inside a specific cloud-storage folder.",
+	method: "GET",
+	path: (ctx) => `/users/${ctx.encode(String(ctx.input.userId))}/cloud_storage/${ctx.encode(String(ctx.input.serviceId))}/folders/${ctx.encode(String(ctx.input.folderId))}`,
+	input: userProvider.extend({
+		folderId: z.string().min(1),
+		count: z.number().int().positive().optional(),
+		startPosition: z.number().int().nonnegative().optional()
+	}),
+	output: docusignGenericObjectSchema,
+	query: (input) => ({
+		count: input.count,
+		start_position: input.startPosition
+	})
+});
+
+//#endregion
+export { configureCloudStorageRedirectUrl, deleteUserAuthForCloudStorageProviders, deleteUserCloudStorageAuthentication, getUserCloudStorageProviderConfiguration, listCloudStorageItems, retrieveCloudStorageProviderConfiguration, retrieveItemsInCloudStorageFolder };