@cloudinary/asset-management-mcp 0.6.0

package/src/models/direction.ts

@@ -0,0 +1,12 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export const Direction$zodSchema = z.enum([
+  "asc",
+  "desc",
+]);
+
+export type Direction = z.infer<typeof Direction$zodSchema>;

package/src/models/downloadassetop.ts

@@ -0,0 +1,98 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ApiError, ApiError$zodSchema } from "./apierror.js";
+import { ResourceType, ResourceType$zodSchema } from "./resourcetype.js";
+import { StorageType, StorageType$zodSchema } from "./storagetype.js";
+
+export type DownloadAssetGlobals = { cloud_name?: string | undefined };
+
+export const DownloadAssetGlobals$zodSchema: z.ZodType<
+  DownloadAssetGlobals,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  cloud_name: z.string().describe("The cloud name of your product environment.")
+    .optional(),
+});
+
+export type DownloadAssetRequest = {
+  resource_type: ResourceType;
+  public_id: string;
+  format?: string | undefined;
+  type?: StorageType | undefined;
+  expires_at?: number | undefined;
+  attachment?: boolean | undefined;
+  target_filename?: string | undefined;
+  transformation?: string | undefined;
+  api_key?: string | undefined;
+  signature?: string | undefined;
+  timestamp?: number | undefined;
+};
+
+export const DownloadAssetRequest$zodSchema: z.ZodType<
+  DownloadAssetRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  api_key: z.string().describe(
+    "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs.",
+  ).optional(),
+  attachment: z.boolean().default(false).describe(
+    "Whether to force download as an attachment.",
+  ),
+  expires_at: z.number().int().describe(
+    "Unix timestamp indicating when the download URL should expire.",
+  ).optional(),
+  format: z.string().describe(
+    "The format to convert the asset to before downloading.",
+  ).optional(),
+  public_id: z.string().describe("The public ID of the asset."),
+  resource_type: ResourceType$zodSchema,
+  signature: z.string().describe(
+    "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.\n"
+      + "",
+  ).optional(),
+  target_filename: z.string().describe(
+    "The desired filename for the downloaded file.",
+  ).optional(),
+  timestamp: z.number().int().describe(
+    "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs.",
+  ).optional(),
+  transformation: z.string().describe(
+    "A transformation to apply to the asset before downloading.",
+  ).optional(),
+  type: StorageType$zodSchema.optional(),
+});
+
+export type DownloadAssetResponse = {
+  ContentType: string;
+  StatusCode: number;
+  RawResponse: Response;
+  twoHundredImageWildcardBytes?: Uint8Array | string | undefined;
+  twoHundredVideoWildcardBytes?: Uint8Array | string | undefined;
+  twoHundredApplicationOctetStreamBytes?: Uint8Array | string | undefined;
+  api_error?: ApiError | undefined;
+};
+
+export const DownloadAssetResponse$zodSchema: z.ZodType<
+  DownloadAssetResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  ContentType: z.string(),
+  RawResponse: z.instanceof(Response),
+  StatusCode: z.number().int(),
+  api_error: ApiError$zodSchema.optional(),
+  twoHundredApplicationOctetStreamBytes: z.string().base64().describe(
+    "Asset downloaded successfully",
+  ).optional(),
+  twoHundredImageWildcardBytes: z.string().base64().describe(
+    "Asset downloaded successfully",
+  ).optional(),
+  twoHundredVideoWildcardBytes: z.string().base64().describe(
+    "Asset downloaded successfully",
+  ).optional(),
+});

package/src/models/downloadbackupassetop.ts

@@ -0,0 +1,181 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export type DownloadBackupAssetGlobals = { cloud_name?: string | undefined };
+
+export const DownloadBackupAssetGlobals$zodSchema: z.ZodType<
+  DownloadBackupAssetGlobals,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  cloud_name: z.string().describe("The cloud name of your product environment.")
+    .optional(),
+});
+
+export type DownloadBackupAssetRequest = {
+  asset_id: string;
+  version_id: string;
+  api_key?: string | undefined;
+  signature?: string | undefined;
+  timestamp?: number | undefined;
+};
+
+export const DownloadBackupAssetRequest$zodSchema: z.ZodType<
+  DownloadBackupAssetRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  api_key: z.string().describe(
+    "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs.",
+  ).optional(),
+  asset_id: z.string().describe(
+    "The asset ID of the resource. Must be a 32-character hexadecimal string.",
+  ),
+  signature: z.string().describe(
+    "(Required for signed REST API calls) Used to authenticate the request and based on the parameters you use in the request. When using the Cloudinary SDKs for signed requests, the signature is automatically generated and added to the request. If you manually generate your own signed POST request, you need to manually generate the signature parameter and add it to the request together with the api_key and timestamp parameters.\n"
+      + "",
+  ).optional(),
+  timestamp: z.number().int().describe(
+    "The timestamp to use for the request in unix time. This is automatically computed by the Cloudinary's SDKs.",
+  ).optional(),
+  version_id: z.string().describe(
+    "The version ID of the backup to download. Must be a 32-character hexadecimal string.",
+  ),
+});
+
+export type NotFoundError = { message?: string | undefined };
+
+export const NotFoundError$zodSchema: z.ZodType<
+  NotFoundError,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  message: z.string().optional(),
+});
+
+/**
+ * Version not found
+ */
+export type DownloadBackupAssetNotFoundResponseBody = {
+  error?: NotFoundError | undefined;
+};
+
+export const DownloadBackupAssetNotFoundResponseBody$zodSchema: z.ZodType<
+  DownloadBackupAssetNotFoundResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  error: z.lazy(() => NotFoundError$zodSchema).optional(),
+}).describe("Version not found");
+
+export type DownloadBackupAssetUnauthorizedError = {
+  message?: string | undefined;
+  http_code?: number | undefined;
+};
+
+export const DownloadBackupAssetUnauthorizedError$zodSchema: z.ZodType<
+  DownloadBackupAssetUnauthorizedError,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  http_code: z.number().int().optional(),
+  message: z.string().optional(),
+});
+
+/**
+ * Authentication failed
+ */
+export type DownloadBackupAssetUnauthorizedResponseBody = {
+  error?: DownloadBackupAssetUnauthorizedError | undefined;
+};
+
+export const DownloadBackupAssetUnauthorizedResponseBody$zodSchema: z.ZodType<
+  DownloadBackupAssetUnauthorizedResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  error: z.lazy(() => DownloadBackupAssetUnauthorizedError$zodSchema)
+    .optional(),
+}).describe("Authentication failed");
+
+export type BadRequestError = {
+  message?: string | undefined;
+  http_code?: number | undefined;
+};
+
+export const BadRequestError$zodSchema: z.ZodType<
+  BadRequestError,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  http_code: z.number().int().optional(),
+  message: z.string().optional(),
+});
+
+/**
+ * Bad request
+ */
+export type DownloadBackupAssetBadRequestResponseBody = {
+  error?: BadRequestError | undefined;
+};
+
+export const DownloadBackupAssetBadRequestResponseBody$zodSchema: z.ZodType<
+  DownloadBackupAssetBadRequestResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  error: z.lazy(() => BadRequestError$zodSchema).optional(),
+}).describe("Bad request");
+
+export type DownloadBackupAssetResponse = {
+  ContentType: string;
+  StatusCode: number;
+  RawResponse: Response;
+  twoHundredApplicationOctetStreamBytes?: Uint8Array | string | undefined;
+  twoHundredImageWildcardBytes?: Uint8Array | string | undefined;
+  twoHundredVideoWildcardBytes?: Uint8Array | string | undefined;
+  twoHundredTextPlainBytes?: Uint8Array | string | undefined;
+  fourHundredApplicationJsonObject?:
+    | DownloadBackupAssetBadRequestResponseBody
+    | undefined;
+  fourHundredAndOneApplicationJsonObject?:
+    | DownloadBackupAssetUnauthorizedResponseBody
+    | undefined;
+  fourHundredAndFourApplicationJsonObject?:
+    | DownloadBackupAssetNotFoundResponseBody
+    | undefined;
+};
+
+export const DownloadBackupAssetResponse$zodSchema: z.ZodType<
+  DownloadBackupAssetResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  ContentType: z.string(),
+  RawResponse: z.instanceof(Response),
+  StatusCode: z.number().int(),
+  fourHundredAndFourApplicationJsonObject: z.lazy(() =>
+    DownloadBackupAssetNotFoundResponseBody$zodSchema
+  ).optional(),
+  fourHundredAndOneApplicationJsonObject: z.lazy(() =>
+    DownloadBackupAssetUnauthorizedResponseBody$zodSchema
+  ).optional(),
+  fourHundredApplicationJsonObject: z.lazy(() =>
+    DownloadBackupAssetBadRequestResponseBody$zodSchema
+  ).optional(),
+  twoHundredApplicationOctetStreamBytes: z.string().base64().describe(
+    "Asset backup downloaded successfully",
+  ).optional(),
+  twoHundredImageWildcardBytes: z.string().base64().describe(
+    "Asset backup downloaded successfully",
+  ).optional(),
+  twoHundredTextPlainBytes: z.string().base64().describe(
+    "Asset backup downloaded successfully",
+  ).optional(),
+  twoHundredVideoWildcardBytes: z.string().base64().describe(
+    "Asset backup downloaded successfully",
+  ).optional(),
+});

package/src/models/errors/apierror.ts

@@ -0,0 +1,21 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export class APIError extends Error {
+  constructor(
+    message: string,
+    public readonly httpMeta: {
+      response: Response;
+      request: Request;
+      body: string;
+    },
+  ) {
+    super(
+      `${message}: Status ${httpMeta.response.status} Content-Type ${
+        httpMeta.response.headers.get("content-type") || ""
+      } Body: ${httpMeta.body}`,
+    );
+    this.name = "APIError";
+  }
+}

package/src/models/errors/httpclienterrors.ts

@@ -0,0 +1,62 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+/**
+ * Base class for all HTTP errors.
+ */
+export class HTTPClientError extends Error {
+  /** The underlying cause of the error. */
+  override readonly cause: unknown;
+  override name = "HTTPClientError";
+  constructor(message: string, opts?: { cause?: unknown }) {
+    let msg = message;
+    if (opts?.cause) {
+      msg += `: ${opts.cause}`;
+    }
+
+    super(msg, opts);
+    // In older runtimes, the cause field would not have been assigned through
+    // the super() call.
+    if (typeof this.cause === "undefined") {
+      this.cause = opts?.cause;
+    }
+  }
+}
+
+/**
+ * An error to capture unrecognised or unexpected errors when making HTTP calls.
+ */
+export class UnexpectedClientError extends HTTPClientError {
+  override name = "UnexpectedClientError";
+}
+
+/**
+ * An error that is raised when any inputs used to create a request are invalid.
+ */
+export class InvalidRequestError extends HTTPClientError {
+  override name = "InvalidRequestError";
+}
+
+/**
+ * An error that is raised when a HTTP request was aborted by the client error.
+ */
+export class RequestAbortedError extends HTTPClientError {
+  override readonly name = "RequestAbortedError";
+}
+
+/**
+ * An error that is raised when a HTTP request timed out due to an AbortSignal
+ * signal timeout.
+ */
+export class RequestTimeoutError extends HTTPClientError {
+  override readonly name = "RequestTimeoutError";
+}
+
+/**
+ * An error that is raised when a HTTP client is unable to make a request to
+ * a server.
+ */
+export class ConnectionError extends HTTPClientError {
+  override readonly name = "ConnectionError";
+}

package/src/models/errors/sdkvalidationerror.ts

@@ -0,0 +1,97 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+export class SDKValidationError extends Error {
+  /**
+   * The raw value that failed validation.
+   */
+  public readonly rawValue: unknown;
+
+  /**
+   * The raw message that failed validation.
+   */
+  public readonly rawMessage: unknown;
+
+  constructor(message: string, cause: unknown, rawValue: unknown) {
+    super(`${message}: ${cause}`);
+    this.name = "SDKValidationError";
+    this.cause = cause;
+    this.rawValue = rawValue;
+    this.rawMessage = message;
+  }
+
+  /**
+   * Return a pretty-formatted error message if the underlying validation error
+   * is a ZodError or some other recognized error type, otherwise return the
+   * default error message.
+   */
+  public pretty(): string {
+    if (this.cause instanceof z.ZodError) {
+      return `${this.rawMessage}\n${formatZodError(this.cause)}`;
+    } else {
+      return this.toString();
+    }
+  }
+}
+
+export function formatZodError(err: z.ZodError, level = 0): string {
+  let pre = "  ".repeat(level);
+  pre = level > 0 ? `│${pre}` : pre;
+  pre += " ".repeat(level);
+
+  let message = "";
+  const append = (str: string) => (message += `\n${pre}${str}`);
+
+  const len = err.issues.length;
+  const headline = len === 1 ? `${len} issue found` : `${len} issues found`;
+
+  if (len) {
+    append(`┌ ${headline}:`);
+  }
+
+  for (const issue of err.issues) {
+    let path = issue.path.join(".");
+    path = path ? `<root>.${path}` : "<root>";
+    append(`│ • [${path}]: ${issue.message} (${issue.code})`);
+    switch (issue.code) {
+      case "invalid_literal":
+      case "invalid_type": {
+        append(`│     Want: ${issue.expected}`);
+        append(`│      Got: ${issue.received}`);
+        break;
+      }
+      case "unrecognized_keys": {
+        append(`│     Keys: ${issue.keys.join(", ")}`);
+        break;
+      }
+      case "invalid_enum_value": {
+        append(`│     Allowed: ${issue.options.join(", ")}`);
+        append(`│         Got: ${issue.received}`);
+        break;
+      }
+      case "invalid_union_discriminator": {
+        append(`│     Allowed: ${issue.options.join(", ")}`);
+        break;
+      }
+      case "invalid_union": {
+        const len = issue.unionErrors.length;
+        append(
+          `│   ✖︎ Attemped to deserialize into one of ${len} union members:`,
+        );
+        issue.unionErrors.forEach((err, i) => {
+          append(`│   ✖︎ Member ${i + 1} of ${len}`);
+          append(`${formatZodError(err, level + 1)}`);
+        });
+      }
+    }
+  }
+
+  if (err.issues.length) {
+    append(`└─*`);
+  }
+
+  return message.slice(1);
+}