@cloudinary/environment-config-mcp 0.5.0

package/src/hooks/types.ts

@@ -0,0 +1,107 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { SDKOptions } from "../lib/config.js";
+import { RequestInput } from "../lib/http.js";
+import { RetryConfig } from "../lib/retries.js";
+import { SecurityState } from "../lib/security.js";
+
+export type HookContext = {
+  baseURL: string | URL;
+  operationID: string;
+  oAuth2Scopes: string[] | null;
+  securitySource?: any | (() => Promise<any>);
+  retryConfig: RetryConfig;
+  resolvedSecurity: SecurityState | null;
+  options: SDKOptions;
+};
+
+export type Awaitable<T> = T | Promise<T>;
+
+export type BeforeCreateRequestContext = HookContext & {};
+export type BeforeRequestContext = HookContext & {};
+export type AfterSuccessContext = HookContext & {};
+export type AfterErrorContext = HookContext & {};
+
+/**
+ * SDKInitHook is called when the SDK is initializing. The
+ * hook can return a new baseURL and HTTP client to be used by the SDK.
+ */
+export interface SDKInitHook {
+  sdkInit: (opts: SDKOptions) => SDKOptions;
+}
+
+export interface BeforeCreateRequestHook {
+  /**
+   * A hook that is called before the SDK creates a `Request` object. The hook
+   * can modify how a request is constructed since certain modifications, like
+   * changing the request URL, cannot be done on a request object directly.
+   */
+  beforeCreateRequest: (
+    hookCtx: BeforeCreateRequestContext,
+    input: RequestInput,
+  ) => RequestInput;
+}
+
+export interface BeforeRequestHook {
+  /**
+   * A hook that is called before the SDK sends a request. The hook can
+   * introduce instrumentation code such as logging, tracing and metrics or
+   * replace the request before it is sent or throw an error to stop the
+   * request from being sent.
+   */
+  beforeRequest: (
+    hookCtx: BeforeRequestContext,
+    request: Request,
+  ) => Awaitable<Request>;
+}
+
+export interface AfterSuccessHook {
+  /**
+   * A hook that is called after the SDK receives a response. The hook can
+   * introduce instrumentation code such as logging, tracing and metrics or
+   * modify the response before it is handled or throw an error to stop the
+   * response from being handled.
+   */
+  afterSuccess: (
+    hookCtx: AfterSuccessContext,
+    response: Response,
+  ) => Awaitable<Response>;
+}
+
+export interface AfterErrorHook {
+  /**
+   * A hook that is called after the SDK encounters an error, or a
+   * non-successful response. The hook can introduce instrumentation code such
+   * as logging, tracing and metrics or modify the response or error values.
+   */
+  afterError: (
+    hookCtx: AfterErrorContext,
+    response: Response | null,
+    error: unknown,
+  ) => Awaitable<{
+    response: Response | null;
+    error: unknown;
+  }>;
+}
+
+export interface Hooks {
+  /** Registers a hook to be used by the SDK for initialization event. */
+  registerSDKInitHook(hook: SDKInitHook): void;
+  /** Registers a hook to be used by the SDK for to modify `Request` construction. */
+  registerBeforeCreateRequestHook(hook: BeforeCreateRequestHook): void;
+  /** Registers a hook to be used by the SDK for the before request event. */
+  registerBeforeRequestHook(hook: BeforeRequestHook): void;
+  /** Registers a hook to be used by the SDK for the after success event. */
+  registerAfterSuccessHook(hook: AfterSuccessHook): void;
+  /** Registers a hook to be used by the SDK for the after error event. */
+  registerAfterErrorHook(hook: AfterErrorHook): void;
+}
+
+export type Hook =
+  | SDKInitHook
+  | BeforeCreateRequestHook
+  | BeforeRequestHook
+  | AfterSuccessHook
+  | AfterErrorHook;

package/src/hooks/userAgentHook.ts

@@ -0,0 +1,78 @@
+import { SDKInitHook } from "./types.js";
+import { SDKOptions, SDK_METADATA } from "../lib/config.js";
+
+// Extract product name from package name part
+function getProductName(packageName: string): string {
+    try {
+        if (packageName) {
+            // Extract package name from the package part
+            // Format: "@cloudinary/asset-management-mcp"
+            const match = packageName.match(/@cloudinary\/(.+)/);
+            if (match && match[1]) {
+                // Convert kebab-case to PascalCase: "asset-management-mcp" -> "AssetManagementMcp"
+                return match[1]
+                    .split('-')
+                    .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+                    .join('');
+            }
+        }
+        return "Unknown";
+    } catch {
+        return "Unknown";
+    }
+}
+
+function isRemoteMCP(): boolean {
+    // Check if we are running in the OAuth wrapper environment
+    const process = (globalThis as any)?.process;
+    return process?.env?.['OAUTH_WRAPPER_ORIGIN'] !== undefined;
+}
+
+function getRuntime(): string {
+    return 'MCP';
+}
+
+function getSystemInfo(): string {
+    const process = (globalThis as any)?.process;
+    const nodeVersion = process?.version || 'unknown'; // e.g., "v18.17.0"
+    const platform = process?.platform || 'unknown'; // e.g., "darwin", "linux", "win32"
+    const arch = process?.arch || 'unknown'; // e.g., "x64", "arm64"
+
+    return `Node.js ${nodeVersion.startsWith('v') ? nodeVersion.substring(1) : nodeVersion}; ${platform} ${arch}`;
+}
+
+function getEnvDetails(): string {
+    return isRemoteMCP() ? '; RemoteMCP' : '';
+}
+
+function buildUserAgent(sdkVersion: string, genVersion: string, openapiDocVersion: string, packageName: string, runtime: string): string {
+    const productName = getProductName(packageName);
+    const systemInfo = getSystemInfo();
+    const envDetails = getEnvDetails();
+
+    return `Cloudinary/${productName} ${runtime}/${sdkVersion} Gen/${genVersion} Schema/${openapiDocVersion} (${systemInfo}${envDetails})`;
+}
+
+export class UserAgentHook implements SDKInitHook {
+    sdkInit(opts: SDKOptions): SDKOptions {
+        const originalUserAgent = SDK_METADATA.userAgent;
+
+        if (originalUserAgent && originalUserAgent.startsWith("speakeasy-sdk/")) {
+            const parts = originalUserAgent.split(" ");
+
+            if (parts.length >= 5) {
+                const sdkVersion = parts[1];
+                const genVersion = parts[2];
+                const openapiDocVersion = parts[3];
+                const packageName = parts[4];
+
+                // Ensure all parts are defined before proceeding
+                if (sdkVersion && genVersion && openapiDocVersion && packageName) {
+                    const runtime = getRuntime();
+                    opts.userAgent = buildUserAgent(sdkVersion, genVersion, openapiDocVersion, packageName, runtime);
+                }
+            }
+        }
+        return opts;
+    }
+}

package/src/lib/base64.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export function bytesToBase64(u8arr: Uint8Array): string {
+  return btoa(String.fromCodePoint(...u8arr));
+}
+
+export function bytesFromBase64(encoded: string): Uint8Array {
+  return Uint8Array.from(atob(encoded), (c) => c.charCodeAt(0));
+}
+
+export function stringToBytes(str: string): Uint8Array {
+  return new TextEncoder().encode(str);
+}
+
+export function stringFromBytes(u8arr: Uint8Array): string {
+  return new TextDecoder().decode(u8arr);
+}
+
+export function stringToBase64(str: string): string {
+  return bytesToBase64(stringToBytes(str));
+}
+
+export function stringFromBase64(b64str: string): string {
+  return stringFromBytes(bytesFromBase64(b64str));
+}
+
+export const zodOutbound = z
+  .instanceof(Uint8Array)
+  .or(z.string().transform(stringToBytes));
+
+export const zodInbound = z
+  .instanceof(Uint8Array)
+  .or(z.string().transform(bytesFromBase64));

package/src/lib/config.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { Security } from "../models/security.js";
+import { ClosedEnum } from "../types/enums.js";
+import { HTTPClient } from "./http.js";
+import { Logger } from "./logger.js";
+import { RetryConfig } from "./retries.js";
+import { Params, pathToFunc } from "./url.js";
+
+/**
+ * Contains the list of servers available to the SDK
+ */
+export const ServerList = [
+  /**
+   * Regional API endpoints for optimal performance.
+   */
+  "https://{region}.cloudinary.com",
+  /**
+   * Custom domains for enterprise deployments.
+   */
+  "https://{host}",
+] as const;
+
+/**
+ * Regional endpoint selection
+ */
+export const ServerRegion = {
+  Api: "api",
+  ApiEu: "api-eu",
+  ApiAp: "api-ap",
+} as const;
+/**
+ * Regional endpoint selection
+ */
+export type ServerRegion = ClosedEnum<typeof ServerRegion>;
+
+export type SDKOptions = {
+  /**
+   * The security details required to authenticate the SDK
+   */
+  security?: Security | (() => Promise<Security>) | undefined;
+
+  /**
+   * Allows setting the cloud_name parameter for all supported operations
+   */
+  cloud_name?: string | undefined;
+
+  httpClient?: HTTPClient;
+  /**
+   * Allows overriding the default server used by the SDK
+   */
+  serverIdx?: number | undefined;
+  /**
+   * Sets the region variable for url substitution
+   */
+  region?: ServerRegion | undefined;
+  /**
+   * Sets the host variable for url substitution
+   */
+  host?: string | undefined;
+  /**
+   * Allows overriding the default server URL used by the SDK
+   */
+  serverURL?: string | undefined;
+  /**
+   * Allows overriding the default user agent used by the SDK
+   */
+  userAgent?: string | undefined;
+  /**
+   * Allows overriding the default retry config used by the SDK
+   */
+  retryConfig?: RetryConfig;
+  timeoutMs?: number;
+  debugLogger?: Logger | undefined;
+};
+
+export function serverURLFromOptions(options: SDKOptions): URL | null {
+  let serverURL = options.serverURL;
+
+  const serverParams: Params[] = [
+    {
+      "region": options.region ?? "api",
+    },
+    {
+      "host": options.host ?? "api.cloudinary.com",
+    },
+  ];
+  let params: Params = {};
+
+  if (!serverURL) {
+    const serverIdx = options.serverIdx ?? 0;
+    if (serverIdx < 0 || serverIdx >= ServerList.length) {
+      throw new Error(`Invalid server index ${serverIdx}`);
+    }
+    serverURL = ServerList[serverIdx] || "";
+    params = serverParams[serverIdx] || {};
+  }
+
+  const u = pathToFunc(serverURL)(params);
+  return new URL(u);
+}
+
+export const SDK_METADATA = {
+  language: "typescript",
+  openapiDocVersion: "0.3.6",
+  sdkVersion: "0.5.0",
+  genVersion: "2.767.2",
+  userAgent:
+    "speakeasy-sdk/mcp-typescript 0.5.0 2.767.2 0.3.6 @cloudinary/environment-config-mcp",
+} as const;

package/src/lib/dlv.ts

@@ -0,0 +1,53 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+/*
+MIT License
+
+Copyright (c) 2024 Jason Miller <jason@developit.ca> (http://jasonformat.com)
+
+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.
+*/
+
+/**
+ * @param obj The object to walk
+ * @param key The key path to walk the object with
+ * @param def A default value to return if the result is undefined
+ *
+ * @example
+ * dlv(obj, "a.b.c.d")
+ * @example
+ * dlv(object, ["a", "b", "c", "d"])
+ * @example
+ * dlv(object, "foo.bar.baz", "Hello, default value!")
+ */
+export function dlv<T = any>(
+  obj: any,
+  key: string | string[],
+  def?: T,
+  p?: number,
+  undef?: never,
+): T | undefined {
+  key = Array.isArray(key) ? key : key.split(".");
+  for (p = 0; p < key.length; p++) {
+    const k = key[p];
+    obj = k != null && obj ? obj[k] : undef;
+  }
+  return obj === undef ? def : obj;
+}