@documenso/sdk-typescript 0.3.0 → 0.4.0

package/src/funcs/templatesRecipientsGet.ts

@@ -116,7 +116,7 @@ async function $do(
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "recipient-getTemplateRecipient",
-    oAuth2Scopes: [],
+    oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,
 

package/src/funcs/templatesRecipientsUpdate.ts

@@ -108,7 +108,7 @@ async function $do(
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "recipient-updateTemplateRecipient",
-    oAuth2Scopes: [],
+    oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,
 

package/src/funcs/templatesRecipientsUpdateMany.ts

@@ -108,7 +108,7 @@ async function $do(
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "recipient-updateTemplateRecipients",
-    oAuth2Scopes: [],
+    oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,
 

package/src/funcs/templatesUpdate.ts

@@ -103,7 +103,7 @@ async function $do(
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "template-updateTemplate",
-    oAuth2Scopes: [],
+    oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,
 

package/src/funcs/templatesUse.ts

@@ -108,7 +108,7 @@ async function $do(
     options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "template-createDocumentFromTemplate",
-    oAuth2Scopes: [],
+    oAuth2Scopes: null,
 
     resolvedSecurity: requestSecurity,
 

package/src/lib/config.ts

@@ -58,8 +58,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.0.0",
-  sdkVersion: "0.3.0",
-  genVersion: "2.623.0",
+  sdkVersion: "0.4.0",
+  genVersion: "2.727.9",
   userAgent:
-    "speakeasy-sdk/typescript 0.3.0 2.623.0 0.0.0 @documenso/sdk-typescript",
+    "speakeasy-sdk/typescript 0.4.0 2.727.9 0.0.0 @documenso/sdk-typescript",
 } as const;

package/src/lib/env.ts

@@ -18,6 +18,18 @@ export const envSchema: z.ZodType<Env, z.ZodTypeDef, unknown> = z.object({
   DOCUMENSO_DEBUG: z.coerce.boolean().optional(),
 });
 
+/**
+ * Checks for the existence of the Deno global object to determine the environment.
+ * @returns {boolean} True if the runtime is Deno, false otherwise.
+ */
+function isDeno() {
+  if ("Deno" in globalThis) {
+    return true;
+  }
+
+  return false;
+}
+
 let envMemo: Env | undefined = undefined;
 /**
  * Reads and validates environment variables.
@@ -27,9 +39,14 @@ export function env(): Env {
     return envMemo;
   }
 
-  envMemo = envSchema.parse(
-    dlv(globalThis, "process.env") ?? dlv(globalThis, "Deno.env") ?? {},
-  );
+  let envObject: Record<string, unknown> = {};
+  if (isDeno()) {
+    envObject = (globalThis as any).Deno?.env?.toObject?.() ?? {};
+  } else {
+    envObject = dlv(globalThis, "process.env") ?? {};
+  }
+
+  envMemo = envSchema.parse(envObject);
   return envMemo;
 }
 

package/src/lib/files.ts

@@ -38,3 +38,45 @@ export async function readableStreamToArrayBuffer(
 
   return concatenatedChunks.buffer as ArrayBuffer;
 }
+
+/**
+ * Determines the MIME content type based on a file's extension.
+ * Returns null if the extension is not recognized.
+ */
+export function getContentTypeFromFileName(fileName: string): string | null {
+  if (!fileName) return null;
+
+  const ext = fileName.toLowerCase().split(".").pop();
+  if (!ext) return null;
+
+  const mimeTypes: Record<string, string> = {
+    json: "application/json",
+    xml: "application/xml",
+    html: "text/html",
+    htm: "text/html",
+    txt: "text/plain",
+    csv: "text/csv",
+    pdf: "application/pdf",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    svg: "image/svg+xml",
+    js: "application/javascript",
+    css: "text/css",
+    zip: "application/zip",
+    tar: "application/x-tar",
+    gz: "application/gzip",
+    mp4: "video/mp4",
+    mp3: "audio/mpeg",
+    wav: "audio/wav",
+    webp: "image/webp",
+    ico: "image/x-icon",
+    woff: "font/woff",
+    woff2: "font/woff2",
+    ttf: "font/ttf",
+    otf: "font/otf",
+  };
+
+  return mimeTypes[ext] || null;
+}

package/src/lib/security.ts

@@ -7,8 +7,8 @@ import { env } from "./env.js";
 
 type OAuth2PasswordFlow = {
   username: string;
-  password?: string | undefined;
-  clientID: string;
+  password: string;
+  clientID?: string | undefined;
   clientSecret?: string | undefined;
   tokenURL: string;
 };
@@ -84,7 +84,10 @@ type SecurityInputOAuth2 = {
 type SecurityInputOAuth2ClientCredentials = {
   type: "oauth2:client_credentials";
   value:
-    | { clientID?: string | undefined; clientSecret?: string | undefined }
+    | {
+      clientID?: string | undefined;
+      clientSecret?: string | undefined;
+    }
     | null
     | string
     | undefined;

package/src/lib/url.ts

@@ -10,7 +10,7 @@ export function pathToFunc(
   pathPattern: string,
   options?: { charEncoding?: "percent" | "none" },
 ): (params?: Params) => string {
-  const paramRE = /\{([a-zA-Z0-9_]+?)\}/g;
+  const paramRE = /\{([a-zA-Z0-9_][a-zA-Z0-9_-]*?)\}/g;
 
   return function buildURLPath(params: Record<string, unknown> = {}): string {
     return pathPattern.replace(paramRE, function (_, placeholder) {

package/src/mcp-server/cli/start/command.ts

@@ -6,7 +6,6 @@ import { buildCommand } from "@stricli/core";
 import { numberParser } from "@stricli/core";
 import * as z from "zod";
 import { consoleLoggerLevels } from "../../console-logger.js";
-import { mcpScopes } from "../../scopes.js";
 
 export const startCommand = buildCommand({
   loader: async () => {
@@ -37,18 +36,6 @@ export const startCommand = buildCommand({
           return z.string().parse(value);
         },
       },
-      ...(mcpScopes.length
-        ? {
-          scope: {
-            kind: "enum",
-            brief:
-              "Mount tools/resources that match given scope (repeatable flag)",
-            values: mcpScopes,
-            variadic: true,
-            optional: true,
-          },
-        }
-        : {}),
       "api-key": {
         kind: "parsed",
         brief: "Sets the apiKey auth field for the API",

package/src/mcp-server/cli/start/impl.ts

@@ -11,14 +11,12 @@ import {
   ConsoleLoggerLevel,
   createConsoleLogger,
 } from "../../console-logger.js";
-import { MCPScope } from "../../scopes.js";
 import { createMCPServer } from "../../server.js";
 
 interface StartCommandFlags {
   readonly transport: "stdio" | "sse";
   readonly port: number;
   readonly tool?: string[];
-  readonly scope?: MCPScope[];
   readonly "api-key"?: string | undefined;
   readonly "server-url"?: string;
   readonly "server-index"?: SDKOptions["serverIdx"];
@@ -49,7 +47,6 @@ async function startStdio(flags: StartCommandFlags) {
   const server = createMCPServer({
     logger,
     allowedTools: flags.tool,
-    scopes: flags.scope,
     ...{ apiKey: flags["api-key"] ?? "" },
     serverURL: flags["server-url"],
     serverIdx: flags["server-index"],
@@ -70,7 +67,6 @@ async function startSSE(flags: StartCommandFlags) {
   const mcpServer = createMCPServer({
     logger,
     allowedTools: flags.tool,
-    scopes: flags.scope,
     ...{ apiKey: flags["api-key"] ?? "" },
     serverURL: flags["server-url"],
     serverIdx: flags["server-index"],

package/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.3.0",
+    currentVersion: "0.4.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -13,6 +13,7 @@ import {
 } from "./resources.js";
 import { MCPScope } from "./scopes.js";
 import { createRegisterTool } from "./tools.js";
+import { tool$documentDocumentDownload } from "./tools/documentDocumentDownload.js";
 import { tool$documentsCreateV0 } from "./tools/documentsCreateV0.js";
 import { tool$documentsDelete } from "./tools/documentsDelete.js";
 import { tool$documentsDistribute } from "./tools/documentsDistribute.js";
@@ -25,7 +26,6 @@ import { tool$documentsFieldsUpdate } from "./tools/documentsFieldsUpdate.js";
 import { tool$documentsFieldsUpdateMany } from "./tools/documentsFieldsUpdateMany.js";
 import { tool$documentsFind } from "./tools/documentsFind.js";
 import { tool$documentsGet } from "./tools/documentsGet.js";
-import { tool$documentsMoveToTeam } from "./tools/documentsMoveToTeam.js";
 import { tool$documentsRecipientsCreate } from "./tools/documentsRecipientsCreate.js";
 import { tool$documentsRecipientsCreateMany } from "./tools/documentsRecipientsCreateMany.js";
 import { tool$documentsRecipientsDelete } from "./tools/documentsRecipientsDelete.js";
@@ -49,7 +49,6 @@ import { tool$templatesFieldsUpdate } from "./tools/templatesFieldsUpdate.js";
 import { tool$templatesFieldsUpdateMany } from "./tools/templatesFieldsUpdateMany.js";
 import { tool$templatesFind } from "./tools/templatesFind.js";
 import { tool$templatesGet } from "./tools/templatesGet.js";
-import { tool$templatesMoveToTeam } from "./tools/templatesMoveToTeam.js";
 import { tool$templatesRecipientsCreate } from "./tools/templatesRecipientsCreate.js";
 import { tool$templatesRecipientsCreateMany } from "./tools/templatesRecipientsCreateMany.js";
 import { tool$templatesRecipientsDelete } from "./tools/templatesRecipientsDelete.js";
@@ -58,6 +57,7 @@ import { tool$templatesRecipientsUpdate } from "./tools/templatesRecipientsUpdat
 import { tool$templatesRecipientsUpdateMany } from "./tools/templatesRecipientsUpdateMany.js";
 import { tool$templatesUpdate } from "./tools/templatesUpdate.js";
 import { tool$templatesUse } from "./tools/templatesUse.js";
+import { tool$templateTemplateCreateTemplateTemporary } from "./tools/templateTemplateCreateTemplateTemporary.js";
 
 export function createMCPServer(deps: {
   logger: ConsoleLogger;
@@ -69,7 +69,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Documenso",
-    version: "0.3.0",
+    version: "0.4.0",
   });
 
   const client = new DocumensoCore({
@@ -99,22 +99,22 @@ export function createMCPServer(deps: {
   const register = { tool, resource, resourceTemplate, prompt };
   void register; // suppress unused warnings
 
-  tool(tool$documentsFind);
   tool(tool$documentsGet);
-  tool(tool$documentsCreateV0);
+  tool(tool$documentsFind);
   tool(tool$documentsUpdate);
   tool(tool$documentsDelete);
-  tool(tool$documentsMoveToTeam);
+  tool(tool$documentsDuplicate);
   tool(tool$documentsDistribute);
   tool(tool$documentsRedistribute);
-  tool(tool$documentsDuplicate);
+  tool(tool$documentsCreateV0);
+  tool(tool$documentDocumentDownload);
   tool(tool$templatesFind);
   tool(tool$templatesGet);
   tool(tool$templatesUpdate);
   tool(tool$templatesDuplicate);
   tool(tool$templatesDelete);
   tool(tool$templatesUse);
-  tool(tool$templatesMoveToTeam);
+  tool(tool$templateTemplateCreateTemplateTemporary);
   tool(tool$embeddingEmbeddingPresignCreateEmbeddingPresignToken);
   tool(tool$embeddingEmbeddingPresignVerifyEmbeddingPresignToken);
   tool(tool$documentsFieldsGet);

package/src/mcp-server/tools/{templatesMoveToTeam.ts → documentDocumentDownload.ts}

@@ -2,22 +2,22 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { templatesMoveToTeam } from "../../funcs/templatesMoveToTeam.js";
+import { documentDocumentDownload } from "../../funcs/documentDocumentDownload.js";
 import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.TemplateMoveTemplateToTeamRequest$inboundSchema,
+  request: operations.DocumentDownloadRequest$inboundSchema,
 };
 
-export const tool$templatesMoveToTeam: ToolDefinition<typeof args> = {
-  name: "templates-move-to-team",
-  description: `Move template
+export const tool$documentDocumentDownload: ToolDefinition<typeof args> = {
+  name: "document-document-download",
+  description: `Download document (beta)
 
-Move a template to a team`,
+Get a pre-signed download URL for the original or signed version of a document`,
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await templatesMoveToTeam(
+    const [result, apiCall] = await documentDocumentDownload(
       client,
       args.request,
       { fetchOptions: { signal: ctx.signal } },

package/src/mcp-server/tools/documentsDelete.ts

@@ -7,7 +7,7 @@ import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.DocumentDeleteDocumentRequest$inboundSchema,
+  request: operations.DocumentDeleteRequest$inboundSchema,
 };
 
 export const tool$documentsDelete: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/documentsDistribute.ts

@@ -7,7 +7,7 @@ import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.DocumentSendDocumentRequest$inboundSchema,
+  request: operations.DocumentDistributeRequest$inboundSchema,
 };
 
 export const tool$documentsDistribute: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/documentsDuplicate.ts

@@ -7,7 +7,7 @@ import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.DocumentDuplicateDocumentRequest$inboundSchema,
+  request: operations.DocumentDuplicateRequest$inboundSchema,
 };
 
 export const tool$documentsDuplicate: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/documentsFind.ts

@@ -7,7 +7,7 @@ import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.DocumentFindDocumentsRequest$inboundSchema,
+  request: operations.DocumentFindRequest$inboundSchema,
 };
 
 export const tool$documentsFind: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/documentsGet.ts

@@ -7,7 +7,7 @@ import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.DocumentGetDocumentWithDetailsByIdRequest$inboundSchema,
+  request: operations.DocumentGetRequest$inboundSchema,
 };
 
 export const tool$documentsGet: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/documentsRedistribute.ts

@@ -7,7 +7,7 @@ import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.DocumentResendDocumentRequest$inboundSchema,
+  request: operations.DocumentRedistributeRequest$inboundSchema,
 };
 
 export const tool$documentsRedistribute: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/documentsUpdate.ts

@@ -7,7 +7,7 @@ import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.DocumentUpdateDocumentRequest$inboundSchema,
+  request: operations.DocumentUpdateRequest$inboundSchema,
 };
 
 export const tool$documentsUpdate: ToolDefinition<typeof args> = {

package/src/mcp-server/tools/templateTemplateCreateTemplateTemporary.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { templateTemplateCreateTemplateTemporary } from "../../funcs/templateTemplateCreateTemplateTemporary.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.TemplateCreateTemplateTemporaryRequest$inboundSchema,
+};
+
+export const tool$templateTemplateCreateTemplateTemporary: ToolDefinition<
+  typeof args
+> = {
+  name: "template-template-create-template-temporary",
+  description: `Create template
+
+You will need to upload the PDF to the provided URL returned. Note: Once V2 API is released, this will be removed since we will allow direct uploads, instead of using an upload URL.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await templateTemplateCreateTemplateTemporary(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/models/errors/apierror.ts

@@ -25,8 +25,14 @@ export class APIError extends DocumensoError {
       }`;
     }
     const body = httpMeta.body || `""`;
-    message += body.length > 100 ? "\n" : " ";
-    message += `Body ${body}`;
+    message += body.length > 100 ? "\n" : ". ";
+    let bodyDisplay = body;
+    if (body.length > 10000) {
+      const truncated = body.substring(0, 10000);
+      const remaining = body.length - 10000;
+      bodyDisplay = `${truncated}...and ${remaining} more chars`;
+    }
+    message += `Body: ${bodyDisplay}`;
     message = message.trim();
     super(message, httpMeta);
     this.name = "APIError";

package/src/models/errors/documentcreatedocumenttemporary.ts

@@ -41,9 +41,7 @@ export class DocumentCreateDocumentTemporaryInternalServerError
     err: DocumentCreateDocumentTemporaryInternalServerErrorData,
     httpMeta: { response: Response; request: Request; body: string },
   ) {
-    const message = "message" in err && typeof err.message === "string"
-      ? err.message
-      : `API error occurred: ${JSON.stringify(err)}`;
+    const message = err.message || `API error occurred: ${JSON.stringify(err)}`;
     super(message, httpMeta);
     this.data$ = err;
     this.code = err.code;
@@ -82,9 +80,7 @@ export class DocumentCreateDocumentTemporaryBadRequestError
     err: DocumentCreateDocumentTemporaryBadRequestErrorData,
     httpMeta: { response: Response; request: Request; body: string },
   ) {
-    const message = "message" in err && typeof err.message === "string"
-      ? err.message
-      : `API error occurred: ${JSON.stringify(err)}`;
+    const message = err.message || `API error occurred: ${JSON.stringify(err)}`;
     super(message, httpMeta);
     this.data$ = err;
     this.code = err.code;