@cloudinary/asset-management-mcp 0.6.2 → 0.7.0

package/src/models/destroyassetop.ts

@@ -3,19 +3,18 @@
  */
 
 import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
 import { ApiError, ApiError$zodSchema } from "./apierror.js";
 import { ResourceType, ResourceType$zodSchema } from "./resourcetype.js";
 
 export type DestroyAssetGlobals = { cloud_name?: string | undefined };
 
-export const DestroyAssetGlobals$zodSchema: z.ZodType<
-  DestroyAssetGlobals,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  cloud_name: z.string().describe("The cloud name of your product environment.")
-    .optional(),
-});
+export const DestroyAssetGlobals$zodSchema: z.ZodType<DestroyAssetGlobals> = z
+  .object({
+    cloud_name: z.string().describe(
+      "The cloud name of your product environment.",
+    ).optional(),
+  });
 
 export type DestroyAssetRequest = {
   resource_type: ResourceType;
@@ -23,27 +22,30 @@ export type DestroyAssetRequest = {
   invalidate?: boolean | undefined;
 };
 
-export const DestroyAssetRequest$zodSchema: z.ZodType<
-  DestroyAssetRequest,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  invalidate: z.boolean().default(false).describe(
-    "Whether to invalidate CDN cached copies of the asset",
-  ),
-  public_id: z.string().describe("The public ID of the asset."),
-  resource_type: ResourceType$zodSchema,
-});
+export const DestroyAssetRequest$zodSchema: z.ZodType<DestroyAssetRequest> = z
+  .object({
+    invalidate: z.boolean().default(false).describe(
+      "Whether to invalidate CDN cached copies of the asset",
+    ),
+    public_id: z.string().describe("The public ID of the asset."),
+    resource_type: ResourceType$zodSchema,
+  });
 
 /**
  * Indicates successful deletion
  */
+export const DestroyAssetResult = {
+  Ok: "ok",
+} as const;
+/**
+ * Indicates successful deletion
+ */
+export type DestroyAssetResult = ClosedEnum<typeof DestroyAssetResult>;
+
 export const DestroyAssetResult$zodSchema = z.enum([
   "ok",
 ]).describe("Indicates successful deletion");
 
-export type DestroyAssetResult = z.infer<typeof DestroyAssetResult$zodSchema>;
-
 /**
  * Asset/resource destroyed successfully
  */
@@ -52,20 +54,15 @@ export type DestroyAssetResponseBody = {
 };
 
 export const DestroyAssetResponseBody$zodSchema: z.ZodType<
-  DestroyAssetResponseBody,
-  z.ZodTypeDef,
-  unknown
+  DestroyAssetResponseBody
 > = z.object({
   result: DestroyAssetResult$zodSchema.optional(),
 }).describe("Asset/resource destroyed successfully");
 
 export type DestroyAssetResponse = ApiError | DestroyAssetResponseBody;
 
-export const DestroyAssetResponse$zodSchema: z.ZodType<
-  DestroyAssetResponse,
-  z.ZodTypeDef,
-  unknown
-> = z.union([
-  ApiError$zodSchema,
-  z.lazy(() => DestroyAssetResponseBody$zodSchema),
-]);
+export const DestroyAssetResponse$zodSchema: z.ZodType<DestroyAssetResponse> = z
+  .union([
+    ApiError$zodSchema,
+    z.lazy(() => DestroyAssetResponseBody$zodSchema),
+  ]);

package/src/models/destroybyassetidop.ts

@@ -12,9 +12,7 @@ import {
 export type DestroyByAssetIdGlobals = { cloud_name?: string | undefined };
 
 export const DestroyByAssetIdGlobals$zodSchema: z.ZodType<
-  DestroyByAssetIdGlobals,
-  z.ZodTypeDef,
-  unknown
+  DestroyByAssetIdGlobals
 > = z.object({
   cloud_name: z.string().describe("The cloud name of your product environment.")
     .optional(),
@@ -23,9 +21,7 @@ export const DestroyByAssetIdGlobals$zodSchema: z.ZodType<
 export type DestroyByAssetIdResponse = DestroyResponse | ApiError;
 
 export const DestroyByAssetIdResponse$zodSchema: z.ZodType<
-  DestroyByAssetIdResponse,
-  z.ZodTypeDef,
-  unknown
+  DestroyByAssetIdResponse
 > = z.union([
   DestroyResponse$zodSchema,
   ApiError$zodSchema,

package/src/models/destroyfolderop.ts

@@ -7,24 +7,19 @@ import { ApiError, ApiError$zodSchema } from "./apierror.js";
 
 export type DestroyFolderGlobals = { cloud_name?: string | undefined };
 
-export const DestroyFolderGlobals$zodSchema: z.ZodType<
-  DestroyFolderGlobals,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  cloud_name: z.string().describe("The cloud name of your product environment.")
-    .optional(),
-});
+export const DestroyFolderGlobals$zodSchema: z.ZodType<DestroyFolderGlobals> = z
+  .object({
+    cloud_name: z.string().describe(
+      "The cloud name of your product environment.",
+    ).optional(),
+  });
 
 export type DestroyFolderRequest = { folder: string };
 
-export const DestroyFolderRequest$zodSchema: z.ZodType<
-  DestroyFolderRequest,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  folder: z.string(),
-});
+export const DestroyFolderRequest$zodSchema: z.ZodType<DestroyFolderRequest> = z
+  .object({
+    folder: z.string(),
+  });
 
 /**
  * Folder deleted successfully
@@ -32,20 +27,15 @@ export const DestroyFolderRequest$zodSchema: z.ZodType<
 export type DestroyFolderResponseBody = { deleted: Array<string> };
 
 export const DestroyFolderResponseBody$zodSchema: z.ZodType<
-  DestroyFolderResponseBody,
-  z.ZodTypeDef,
-  unknown
+  DestroyFolderResponseBody
 > = z.object({
   deleted: z.array(z.string()),
 }).describe("Folder deleted successfully");
 
 export type DestroyFolderResponse = DestroyFolderResponseBody | ApiError;
 
-export const DestroyFolderResponse$zodSchema: z.ZodType<
-  DestroyFolderResponse,
-  z.ZodTypeDef,
-  unknown
-> = z.union([
-  z.lazy(() => DestroyFolderResponseBody$zodSchema),
-  ApiError$zodSchema,
-]);
+export const DestroyFolderResponse$zodSchema: z.ZodType<DestroyFolderResponse> =
+  z.union([
+    z.lazy(() => DestroyFolderResponseBody$zodSchema),
+    ApiError$zodSchema,
+  ]);

package/src/models/destroyrequest.ts

@@ -14,16 +14,12 @@ export type DestroyRequest = {
   callback?: string | undefined;
 };
 
-export const DestroyRequest$zodSchema: z.ZodType<
-  DestroyRequest,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
+export const DestroyRequest$zodSchema: z.ZodType<DestroyRequest> = z.object({
   api_key: z.string().optional(),
   asset_id: z.string(),
   callback: z.string().optional(),
   invalidate: z.boolean().optional(),
   notification_url: z.string().optional(),
   signature: z.string().optional(),
-  timestamp: z.number().int().optional(),
+  timestamp: z.int().optional(),
 });

package/src/models/destroyresponse.ts

@@ -3,27 +3,31 @@
  */
 
 import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
 
 /**
  * The result of the deletion operation.
  */
+export const Result = {
+  Ok: "ok",
+  NotFound: "not found",
+} as const;
+/**
+ * The result of the deletion operation.
+ */
+export type Result = ClosedEnum<typeof Result>;
+
 export const Result$zodSchema = z.enum([
   "ok",
   "not found",
 ]).describe("The result of the deletion operation.");
 
-export type Result = z.infer<typeof Result$zodSchema>;
-
 export type DestroyResponse = {
   result: Result;
   asset_folder?: string | undefined;
 };
 
-export const DestroyResponse$zodSchema: z.ZodType<
-  DestroyResponse,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
+export const DestroyResponse$zodSchema: z.ZodType<DestroyResponse> = z.object({
   asset_folder: z.string().optional(),
   result: Result$zodSchema,
 });

package/src/models/direction.ts

@@ -3,10 +3,15 @@
  */
 
 import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+export const Direction = {
+  Asc: "asc",
+  Desc: "desc",
+} as const;
+export type Direction = ClosedEnum<typeof Direction>;
 
 export const Direction$zodSchema = z.enum([
   "asc",
   "desc",
 ]);
-
-export type Direction = z.infer<typeof Direction$zodSchema>;

package/src/models/downloadassetop.ts

@@ -3,20 +3,19 @@
  */
 
 import * as z from "zod";
+import * as b64$ from "../lib/base64.js";
 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 const DownloadAssetGlobals$zodSchema: z.ZodType<DownloadAssetGlobals> = z
+  .object({
+    cloud_name: z.string().describe(
+      "The cloud name of your product environment.",
+    ).optional(),
+  });
 
 export type DownloadAssetRequest = {
   resource_type: ResourceType;
@@ -32,40 +31,36 @@ export type DownloadAssetRequest = {
   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 const DownloadAssetRequest$zodSchema: z.ZodType<DownloadAssetRequest> = 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.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.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 =
   | ApiError
@@ -76,13 +71,16 @@ export type DownloadAssetResponse =
   | Uint8Array
   | string;
 
-export const DownloadAssetResponse$zodSchema: z.ZodType<
-  DownloadAssetResponse,
-  z.ZodTypeDef,
-  unknown
-> = z.union([
-  ApiError$zodSchema,
-  z.string().base64().describe("Asset downloaded successfully"),
-  z.string().base64().describe("Asset downloaded successfully"),
-  z.string().base64().describe("Asset downloaded successfully"),
-]);
+export const DownloadAssetResponse$zodSchema: z.ZodType<DownloadAssetResponse> =
+  z.union([
+    ApiError$zodSchema,
+    z.string().describe("Base64-encoded binary content").transform(
+      b64$.bytesFromBase64,
+    ),
+    z.string().describe("Base64-encoded binary content").transform(
+      b64$.bytesFromBase64,
+    ),
+    z.string().describe("Base64-encoded binary content").transform(
+      b64$.bytesFromBase64,
+    ),
+  ]);

package/src/models/downloadbackupassetop.ts

@@ -3,13 +3,12 @@
  */
 
 import * as z from "zod";
+import * as b64$ from "../lib/base64.js";
 
 export type DownloadBackupAssetGlobals = { cloud_name?: string | undefined };
 
 export const DownloadBackupAssetGlobals$zodSchema: z.ZodType<
-  DownloadBackupAssetGlobals,
-  z.ZodTypeDef,
-  unknown
+  DownloadBackupAssetGlobals
 > = z.object({
   cloud_name: z.string().describe("The cloud name of your product environment.")
     .optional(),
@@ -24,9 +23,7 @@ export type DownloadBackupAssetRequest = {
 };
 
 export const DownloadBackupAssetRequest$zodSchema: z.ZodType<
-  DownloadBackupAssetRequest,
-  z.ZodTypeDef,
-  unknown
+  DownloadBackupAssetRequest
 > = z.object({
   api_key: z.string().describe(
     "The API key to use for the request. This is automatically computed by the Cloudinary's SDKs.",
@@ -35,10 +32,9 @@ export const DownloadBackupAssetRequest$zodSchema: z.ZodType<
     "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"
-      + "",
+    "(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(
+  timestamp: z.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(
@@ -48,11 +44,7 @@ export const DownloadBackupAssetRequest$zodSchema: z.ZodType<
 
 export type NotFoundError = { message?: string | undefined };
 
-export const NotFoundError$zodSchema: z.ZodType<
-  NotFoundError,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
+export const NotFoundError$zodSchema: z.ZodType<NotFoundError> = z.object({
   message: z.string().optional(),
 });
 
@@ -64,9 +56,7 @@ export type DownloadBackupAssetNotFoundResponseBody = {
 };
 
 export const DownloadBackupAssetNotFoundResponseBody$zodSchema: z.ZodType<
-  DownloadBackupAssetNotFoundResponseBody,
-  z.ZodTypeDef,
-  unknown
+  DownloadBackupAssetNotFoundResponseBody
 > = z.object({
   error: z.lazy(() => NotFoundError$zodSchema).optional(),
 }).describe("Version not found");
@@ -77,11 +67,9 @@ export type DownloadBackupAssetUnauthorizedError = {
 };
 
 export const DownloadBackupAssetUnauthorizedError$zodSchema: z.ZodType<
-  DownloadBackupAssetUnauthorizedError,
-  z.ZodTypeDef,
-  unknown
+  DownloadBackupAssetUnauthorizedError
 > = z.object({
-  http_code: z.number().int().optional(),
+  http_code: z.int().optional(),
   message: z.string().optional(),
 });
 
@@ -93,9 +81,7 @@ export type DownloadBackupAssetUnauthorizedResponseBody = {
 };
 
 export const DownloadBackupAssetUnauthorizedResponseBody$zodSchema: z.ZodType<
-  DownloadBackupAssetUnauthorizedResponseBody,
-  z.ZodTypeDef,
-  unknown
+  DownloadBackupAssetUnauthorizedResponseBody
 > = z.object({
   error: z.lazy(() => DownloadBackupAssetUnauthorizedError$zodSchema)
     .optional(),
@@ -106,12 +92,8 @@ export type BadRequestError = {
   http_code?: number | undefined;
 };
 
-export const BadRequestError$zodSchema: z.ZodType<
-  BadRequestError,
-  z.ZodTypeDef,
-  unknown
-> = z.object({
-  http_code: z.number().int().optional(),
+export const BadRequestError$zodSchema: z.ZodType<BadRequestError> = z.object({
+  http_code: z.int().optional(),
   message: z.string().optional(),
 });
 
@@ -123,9 +105,7 @@ export type DownloadBackupAssetBadRequestResponseBody = {
 };
 
 export const DownloadBackupAssetBadRequestResponseBody$zodSchema: z.ZodType<
-  DownloadBackupAssetBadRequestResponseBody,
-  z.ZodTypeDef,
-  unknown
+  DownloadBackupAssetBadRequestResponseBody
 > = z.object({
   error: z.lazy(() => BadRequestError$zodSchema).optional(),
 }).describe("Bad request");
@@ -144,14 +124,20 @@ export type DownloadBackupAssetResponse =
   | DownloadBackupAssetNotFoundResponseBody;
 
 export const DownloadBackupAssetResponse$zodSchema: z.ZodType<
-  DownloadBackupAssetResponse,
-  z.ZodTypeDef,
-  unknown
+  DownloadBackupAssetResponse
 > = z.union([
-  z.string().base64().describe("Asset backup downloaded successfully"),
-  z.string().base64().describe("Asset backup downloaded successfully"),
-  z.string().base64().describe("Asset backup downloaded successfully"),
-  z.string().base64().describe("Asset backup downloaded successfully"),
+  z.string().describe("Base64-encoded binary content").transform(
+    b64$.bytesFromBase64,
+  ),
+  z.string().describe("Base64-encoded binary content").transform(
+    b64$.bytesFromBase64,
+  ),
+  z.string().describe("Base64-encoded binary content").transform(
+    b64$.bytesFromBase64,
+  ),
+  z.string().describe("Base64-encoded binary content").transform(
+    b64$.bytesFromBase64,
+  ),
   z.lazy(() => DownloadBackupAssetBadRequestResponseBody$zodSchema),
   z.lazy(() => DownloadBackupAssetUnauthorizedResponseBody$zodSchema),
   z.lazy(() => DownloadBackupAssetNotFoundResponseBody$zodSchema),

package/src/models/errors/sdkvalidationerror.ts

@@ -37,61 +37,6 @@ export class SDKValidationError extends Error {
   }
 }
 
-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);
+export function formatZodError(err: z.ZodError): string {
+  return z.prettifyError(err);
 }