@cloudinary/environment-config-mcp 0.5.0

package/src/funcs/uploadPresetsUpdateUploadPreset.ts

@@ -0,0 +1,183 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { CloudinaryEnvConfigCore } from "../core.js";
+import { encodeJSON, encodeSimple } from "../lib/encodings.js";
+import * as M from "../lib/matchers.js";
+import { compactMap } from "../lib/primitives.js";
+import { safeParse } from "../lib/schemas.js";
+import { RequestOptions } from "../lib/sdks.js";
+import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
+import { pathToFunc } from "../lib/url.js";
+import { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import {
+  UpdateUploadPresetRequest,
+  UpdateUploadPresetRequest$zodSchema,
+  UpdateUploadPresetResponse,
+  UpdateUploadPresetResponse$zodSchema,
+} from "../models/updateuploadpresetop.js";
+import { UploadPreset } from "../models/uploadpreset.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Updates an existing upload preset's configuration settings
+ */
+export function uploadPresetsUpdateUploadPreset(
+  client$: CloudinaryEnvConfigCore,
+  name: string,
+  upload_preset: UploadPreset,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    UpdateUploadPresetResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    name,
+    upload_preset,
+    options,
+  ));
+}
+
+async function $do(
+  client$: CloudinaryEnvConfigCore,
+  name: string,
+  upload_preset: UploadPreset,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      UpdateUploadPresetResponse,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const input$: UpdateUploadPresetRequest = {
+    name: name,
+    upload_preset: upload_preset,
+  };
+
+  const parsed$ = safeParse(
+    input$,
+    (value$) => UpdateUploadPresetRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = encodeJSON("body", payload$.upload_preset, { explode: true });
+
+  const pathParams$ = {
+    cloud_name: encodeSimple("cloud_name", client$._options.cloud_name, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    name: encodeSimple("name", payload$.name, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc("/v1_1/{cloud_name}/upload_presets/{name}")(
+    pathParams$,
+  );
+
+  const headers$ = new Headers(compactMap({
+    "Content-Type": "application/json",
+    Accept: "application/json",
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "updateUploadPreset",
+    oAuth2Scopes: null,
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries
+      || client$._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504",
+    ],
+  };
+
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "PUT",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs
+      || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
+
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  const response = doResult.value;
+  const responseFields$ = {
+    HttpMeta: { Response: response, Request: req$ },
+  };
+
+  const [result$] = await M.match<
+    UpdateUploadPresetResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(200, UpdateUploadPresetResponse$zodSchema, { key: "object" }),
+    M.json([400, 401, 404], UpdateUploadPresetResponse$zodSchema, {
+      key: "api_error",
+    }),
+  )(response, req$, { extraFields: responseFields$ });
+
+  return [result$, { status: "complete", request: req$, response }];
+}

package/src/hooks/cloudConfig.ts

@@ -0,0 +1,51 @@
+export class CloudConfig {
+    cloudName: string;
+    apiKey: string;
+    apiSecret: string;
+
+    constructor() {
+        this.cloudName = "";
+        this.apiKey = "";
+        this.apiSecret = "";
+
+        // Access process through globalThis
+        const process = (globalThis as any)?.process;
+
+        // First, try to parse CLOUDINARY_URL if it exists
+        let envVar: string | undefined = undefined;
+
+        if (process?.env?.CLOUDINARY_URL) {
+            envVar = process.env.CLOUDINARY_URL;
+        }
+
+        if (envVar) {
+            try {
+                const url = new URL(envVar);
+                this.cloudName = url.host;
+                this.apiKey = url.username || "";
+                this.apiSecret = url.password || "";
+            } catch (error) {
+                throw new Error(`Invalid CLOUDINARY_URL: '${envVar}'`);
+            }
+        }
+
+        // Then, check for individual environment variables (these take precedence)
+        if (process?.env) {
+            if (process.env.CLOUDINARY_CLOUD_NAME) {
+                this.cloudName = process.env.CLOUDINARY_CLOUD_NAME;
+            }
+            if (process.env.CLOUDINARY_API_KEY) {
+                this.apiKey = process.env.CLOUDINARY_API_KEY;
+            }
+            if (process.env.CLOUDINARY_API_SECRET) {
+                this.apiSecret = process.env.CLOUDINARY_API_SECRET;
+            }
+        }
+
+        // Automatically set CLOUDINARY_CLOUD_NAME if not already set
+        // This ensures the SDK can find cloudName during initialization
+        if (this.cloudName && process?.env && !process.env.CLOUDINARY_CLOUD_NAME) {
+            process.env.CLOUDINARY_CLOUD_NAME = this.cloudName;
+        }
+    }
+}

package/src/hooks/cloudinaryAuthHook.ts

@@ -0,0 +1,239 @@
+import {CloudConfig} from "./cloudConfig.js";
+import {BeforeRequestContext, BeforeRequestHook} from "./types.js";
+
+export class CloudinaryAuthHook
+    implements BeforeRequestHook {
+
+    private readonly cloudConfig: CloudConfig;
+
+    constructor() {
+        this.cloudConfig = new CloudConfig();
+    }
+
+    async beforeRequest(hookCtx: BeforeRequestContext, request: Request): Promise<Request> {
+        let security = hookCtx.securitySource;
+        // Resolve the security source if it's a function (for dynamic token refresh)
+        if (typeof security === 'function') {
+            security = await security();
+        }
+
+        // Prioritize OAuth2 bearer token if it's provided.
+        if (security && typeof security === 'object' && 'oauth2' in security && typeof security.oauth2 === 'string') {
+            const token = security.oauth2;
+            if (token) {
+                request.headers.set("Authorization", `Bearer ${token}`);
+                return request;
+            }
+        }
+
+        // Fallback to API key/secret signing if no OAuth token is present.
+        let { apiKey, apiSecret } = this.cloudConfig;
+
+        // Optionally merge user-supplied security overrides
+        if (security) {
+            // Handle custom cloudinaryAuth format
+            if ('cloudinaryAuth' in security && security.cloudinaryAuth) {
+                // Support both camelCase and snake_case for compatibility
+                if (security.cloudinaryAuth.apiKey || security.cloudinaryAuth.api_key) {
+                    apiKey = security.cloudinaryAuth.apiKey || security.cloudinaryAuth.api_key;
+                }
+                if (security.cloudinaryAuth.apiSecret || security.cloudinaryAuth.api_secret) {
+                    apiSecret = security.cloudinaryAuth.apiSecret || security.cloudinaryAuth.api_secret;
+                }
+            }
+            // Handle standard SDK security format (used by MCP server)
+            else if ('apiKey' in security || 'apiSecret' in security) {
+                if ('apiKey' in security && security.apiKey) {
+                    apiKey = security.apiKey;
+                }
+                if ('apiSecret' in security && security.apiSecret) {
+                    apiSecret = security.apiSecret;
+                }
+            }
+        }
+
+        if (!apiKey || !apiSecret) {
+            return request;
+        }
+
+        if (this.SIGNED_PATHS.every(path => request.url.indexOf(path) === -1)) {
+            // generate  Authorization header using basic auth where apiKey:apiSecret is encoded in base64
+            const authHeader = `Basic ${Buffer.from(`${apiKey}:${apiSecret}`).toString("base64")}`;
+            request.headers.set("Authorization", authHeader);
+            return request;
+        }
+
+        // Extract query parameters regardless of body existence
+        const url = new URL(request.url);
+        const queryParams = this.paramsFromQuery(url.searchParams);
+
+        // Handle case with only query parameters (no body)
+        if (!request.body) {
+            return this.signQueryOnlyRequest(request, apiKey, apiSecret, queryParams);
+        }
+
+        // if content-type is application/json, parse the body as json and add the signature, timestamp and apiKey to the body
+        if (request.headers.get("Content-Type") === "application/json") {
+            const preprocessedBody = await this.preprocessJsonRequest(request);
+            return this.signJsonRequest(request, apiKey, apiSecret, queryParams, preprocessedBody);
+        }
+
+        // if content-type is multipart/form-data, parse the body as form data and add the signature, timestamp and apiKey to the body
+        if (request.headers.get("Content-Type")?.startsWith("multipart/form-data")) {
+            return this.signFormDataRequest(request, apiKey, apiSecret, queryParams);
+        }
+
+        // Default case - just sign query parameters if any exist
+        if (queryParams.length > 0) {
+            return this.signQueryOnlyRequest(request, apiKey, apiSecret, queryParams);
+        }
+
+        return request;
+    }
+
+    paramsFromQuery(searchParams: URLSearchParams): string[] {
+        const params = [];
+        for (const [key, value] of searchParams.entries()) {
+            if (key !== "file" && key !== "cloud_name" && key !== "resource_type" && key !== "api_key" && key !== "signature" && key !== "timestamp") {
+                params.push(`${key}=${value}`);
+            }
+        }
+        return params;
+    }
+
+    async signQueryOnlyRequest(request: Request, apiKey: string, apiSecret: string, queryParams: string[]): Promise<Request> {
+        const url = new URL(request.url);
+        // Check if already signed
+        if (url.searchParams.has("signature")) {
+            return request;
+        }
+
+        const { signature, timestamp } = await this.computeSignature(queryParams, apiSecret);
+        url.searchParams.set("signature", signature);
+        url.searchParams.set("timestamp", timestamp.toString());
+        url.searchParams.set("api_key", apiKey);
+
+        return new Request(url.toString(), request);
+    }
+
+    async computeSignature(params: string[], apiSecret: string) {
+        const crypto = await import('node:crypto');
+        // Create a string with the parameters used in the POST request to Cloudinary:
+        //     All parameters added to the method call should be included except: file, cloud_name, resource_type and your api_key.
+        //     Sort all the parameters in alphabetical order.
+        //     Separate the parameter names from their values with an = and join the parameter/value pairs together with an &.
+        // Append your API secret to the end of the string.
+        // Create a hexadecimal message digest (hash value) of the string using an SHA cryptographic function.
+        const timestamp = Math.floor(Date.now() / 1000);
+        params.push(`timestamp=${timestamp}`);
+        params.sort();
+        const paramsString = params.join("&");
+        const signature = crypto.createHash('sha256').update(`${paramsString}${apiSecret}`).digest('hex');
+
+        return { signature, timestamp };
+    }
+
+    paramsToSignFormData(form: FormData) {
+        const params = [];
+        for (const [key, value] of form.entries()) {
+            if (key !== "file" && key !== "cloud_name" && key !== "resource_type" && key !== "api_key" && key !== "signature") {
+                params.push(`${key}=${value}`);
+            }
+        }
+        return params;
+    }
+
+    paramsToSignJson(json: Record<string, string>) {
+        const params = [];
+        for (const [key, value] of Object.entries(json)) {
+            if (key !== "file" && key !== "cloud_name" && key !== "resource_type" && key !== "api_key" && key !== "signature") {
+                params.push(`${key}=${value}`);
+            }
+        }
+        return params;
+    }
+
+    async preprocessJsonRequest(request: Request): Promise<any> {
+        const body = await request.json();
+
+        // Handle file:// URLs by converting to base64 data URIs
+        if (body.file && typeof body.file === 'string' && body.file.startsWith('file://')) {
+            body.file = await this.convertFileToDataUri(body.file);
+        }
+
+        return body;
+    }
+
+    async signJsonRequest(request: Request, apiKey: string, apiSecret: string, queryParams: string[] = [], preprocessedBody?: any) {
+        const body = preprocessedBody || await request.json();
+        if (body.signature) {
+            return request;
+        }
+
+        const bodyParams = this.paramsToSignJson(body);
+        const allParams = [...bodyParams, ...queryParams];
+        const { signature, timestamp } = await this.computeSignature(allParams, apiSecret);
+        body.signature = signature;
+        body.timestamp = timestamp;
+        body.api_key = apiKey;
+        return new Request(request, { body: JSON.stringify(body) });
+    }
+
+    private async convertFileToDataUri(fileUrl: string): Promise<string> {
+        // Remove 'file://' prefix to get the actual file path
+        const filePath = fileUrl.replace(/^file:\/\//, '');
+
+        try {
+            // Import required Node.js modules
+            const { readFile } = await import('node:fs/promises');
+
+            // Read the file as a buffer
+            const fileBuffer = await readFile(filePath);
+
+            // Convert to base64
+            const base64Data = fileBuffer.toString('base64');
+
+            // Use generic MIME type for all files
+            const mimeType = 'application/octet-stream';
+
+            // Return as data URI
+            return `data:${mimeType};base64,${base64Data}`;
+
+        } catch (error) {
+            // If file reading fails, log error and return original URL
+            console.error(`Failed to read file: ${filePath}`, error);
+            throw new Error(`Failed to read file: ${filePath}. ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+
+    async signFormDataRequest(request: Request, apiKey: string, apiSecret: string, queryParams: string[] = []) {
+        const form = await request.clone().formData();
+        if (form.get("signature")) {
+            return request;
+        }
+
+        const bodyParams = this.paramsToSignFormData(form);
+        const allParams = [...bodyParams, ...queryParams];
+        const { signature, timestamp } = await this.computeSignature(allParams, apiSecret);
+
+        // add the signature, timestamp and apiKey to the URL as query parameters
+        const url = new URL(request.url);
+        url.searchParams.set("signature", signature);
+        url.searchParams.set("timestamp", timestamp.toString());
+        url.searchParams.set("api_key", apiKey);
+
+        // construct a new request with the same URL and the same form data and the same method
+        // remove the basic authentication header
+        const newHeaders = new Headers(request.headers);
+        newHeaders.delete("Authorization");
+        return new Request(url.toString(), request);
+    }
+
+    SIGNED_ACTIONS = [
+        'explicit', 'upload', 'download', 'destroy', 'sprite', 'tags', 'context', 'metadata_update', 'text', 'multi', 'explode',
+        'rename', 'create_slideshow', 'create_video', 'create_collage', 'generate_archive'];
+
+    SIGNED_PATHS = ["image", "video", "raw", "auto", "asset"].flatMap(resourceType => this.SIGNED_ACTIONS.map(action => `${resourceType}/${action}`));
+
+
+}

package/src/hooks/hooks.ts

@@ -0,0 +1,132 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { initHooks } from "./registration.js";
+import {
+  AfterErrorContext,
+  AfterErrorHook,
+  AfterSuccessContext,
+  AfterSuccessHook,
+  BeforeCreateRequestContext,
+  BeforeCreateRequestHook,
+  BeforeRequestContext,
+  BeforeRequestHook,
+  Hook,
+  Hooks,
+  SDKInitHook,
+} from "./types.js";
+
+import { SDKOptions } from "../lib/config.js";
+import { RequestInput } from "../lib/http.js";
+
+export class SDKHooks implements Hooks {
+  sdkInitHooks: SDKInitHook[] = [];
+  beforeCreateRequestHooks: BeforeCreateRequestHook[] = [];
+  beforeRequestHooks: BeforeRequestHook[] = [];
+  afterSuccessHooks: AfterSuccessHook[] = [];
+  afterErrorHooks: AfterErrorHook[] = [];
+
+  constructor() {
+    const presetHooks: Array<Hook> = [];
+
+    for (const hook of presetHooks) {
+      if ("sdkInit" in hook) {
+        this.registerSDKInitHook(hook);
+      }
+      if ("beforeCreateRequest" in hook) {
+        this.registerBeforeCreateRequestHook(hook);
+      }
+      if ("beforeRequest" in hook) {
+        this.registerBeforeRequestHook(hook);
+      }
+      if ("afterSuccess" in hook) {
+        this.registerAfterSuccessHook(hook);
+      }
+      if ("afterError" in hook) {
+        this.registerAfterErrorHook(hook);
+      }
+    }
+    initHooks(this);
+  }
+
+  registerSDKInitHook(hook: SDKInitHook) {
+    this.sdkInitHooks.push(hook);
+  }
+
+  registerBeforeCreateRequestHook(hook: BeforeCreateRequestHook) {
+    this.beforeCreateRequestHooks.push(hook);
+  }
+
+  registerBeforeRequestHook(hook: BeforeRequestHook) {
+    this.beforeRequestHooks.push(hook);
+  }
+
+  registerAfterSuccessHook(hook: AfterSuccessHook) {
+    this.afterSuccessHooks.push(hook);
+  }
+
+  registerAfterErrorHook(hook: AfterErrorHook) {
+    this.afterErrorHooks.push(hook);
+  }
+
+  sdkInit(opts: SDKOptions): SDKOptions {
+    return this.sdkInitHooks.reduce((opts, hook) => hook.sdkInit(opts), opts);
+  }
+
+  beforeCreateRequest(
+    hookCtx: BeforeCreateRequestContext,
+    input: RequestInput,
+  ): RequestInput {
+    let inp = input;
+
+    for (const hook of this.beforeCreateRequestHooks) {
+      inp = hook.beforeCreateRequest(hookCtx, inp);
+    }
+
+    return inp;
+  }
+
+  async beforeRequest(
+    hookCtx: BeforeRequestContext,
+    request: Request,
+  ): Promise<Request> {
+    let req = request;
+
+    for (const hook of this.beforeRequestHooks) {
+      req = await hook.beforeRequest(hookCtx, req);
+    }
+
+    return req;
+  }
+
+  async afterSuccess(
+    hookCtx: AfterSuccessContext,
+    response: Response,
+  ): Promise<Response> {
+    let res = response;
+
+    for (const hook of this.afterSuccessHooks) {
+      res = await hook.afterSuccess(hookCtx, res);
+    }
+
+    return res;
+  }
+
+  async afterError(
+    hookCtx: AfterErrorContext,
+    response: Response | null,
+    error: unknown,
+  ): Promise<{ response: Response | null; error: unknown }> {
+    let res = response;
+    let err = error;
+
+    for (const hook of this.afterErrorHooks) {
+      const result = await hook.afterError(hookCtx, res, err);
+      res = result.response;
+      err = result.error;
+    }
+
+    return { response: res, error: err };
+  }
+}

package/src/hooks/index.ts

@@ -0,0 +1,7 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export * from "./hooks.js";
+export * from "./types.js";
+

package/src/hooks/oauth2scopes.ts

@@ -0,0 +1,19 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+/**
+ * Available scopes for the  OAuth 2.0 scheme (authorizationCode flow).
+ *
+ * @remarks
+ * OAuth2 Authorization Code flow for user authentication
+ */
+export type OAuth2Scope =
+  /**
+   * Allows managing assets, including reading, updating, and deleting.
+   */
+  | "asset_management"
+  /**
+   * Allows uploading new assets.
+   */
+  | "upload";

package/src/hooks/registration.ts

@@ -0,0 +1,19 @@
+import { Hooks } from "./types.js";
+import { CloudinaryAuthHook } from "./cloudinaryAuthHook.js";
+import { UserAgentHook } from "./userAgentHook.js";
+/*
+ * This file is only ever generated once on the first generation and then is free to be modified.
+ * Any hooks you wish to add should be registered in the initHooks function. Feel free to define them
+ * in this file or in separate files in the hooks folder.
+ */
+
+export function initHooks(hooks: Hooks) {
+  // Add hooks by calling hooks.register{ClientInit/BeforeCreateRequest/BeforeRequest/AfterSuccess/AfterError}Hook
+  // with an instance of a hook that implements that specific Hook interface
+  // Hooks are registered per SDK instance, and are valid for the lifetime of the SDK instance
+    const cloudinaryAuthHook = new CloudinaryAuthHook();
+    hooks.registerBeforeRequestHook(cloudinaryAuthHook);
+
+    const userAgentHook = new UserAgentHook();
+    hooks.registerSDKInitHook(userAgentHook);
+}