@cloudinary/asset-management-mcp 0.6.0

package/src/funcs/assetsListResourcesByContext.ts

@@ -0,0 +1,224 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { CloudinaryAssetMgmtCore } from "../core.js";
+import { encodeFormQuery, encodeSimple, queryJoin } 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 { Direction } from "../models/direction.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 { FieldsSpec } from "../models/fieldsspec.js";
+import {
+  ListResourcesByContextRequest,
+  ListResourcesByContextRequest$zodSchema,
+  ListResourcesByContextResponse,
+  ListResourcesByContextResponse$zodSchema,
+} from "../models/listresourcesbycontextop.js";
+import { ResourceType } from "../models/resourcetype.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get resources by context
+ *
+ * @remarks
+ * Retrieves resources matching specific context key/value pairs.
+ */
+export function assetsListResourcesByContext(
+  client$: CloudinaryAssetMgmtCore,
+  resource_type: ResourceType,
+  key: string,
+  value?: string | undefined,
+  next_cursor?: string | undefined,
+  max_results?: number | undefined,
+  direction?: Direction | undefined,
+  fields?: Array<FieldsSpec> | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    ListResourcesByContextResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    resource_type,
+    key,
+    value,
+    next_cursor,
+    max_results,
+    direction,
+    fields,
+    options,
+  ));
+}
+
+async function $do(
+  client$: CloudinaryAssetMgmtCore,
+  resource_type: ResourceType,
+  key: string,
+  value?: string | undefined,
+  next_cursor?: string | undefined,
+  max_results?: number | undefined,
+  direction?: Direction | undefined,
+  fields?: Array<FieldsSpec> | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      ListResourcesByContextResponse,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const input$: ListResourcesByContextRequest = {
+    resource_type: resource_type,
+    key: key,
+    value: value,
+    next_cursor: next_cursor,
+    max_results: max_results,
+    direction: direction,
+    fields: fields,
+  };
+
+  const parsed$ = safeParse(
+    input$,
+    (value$) => ListResourcesByContextRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+
+  const pathParams$ = {
+    cloud_name: encodeSimple("cloud_name", client$._options.cloud_name, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    resource_type: encodeSimple("resource_type", payload$.resource_type, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc(
+    "/v1_1/{cloud_name}/resources/{resource_type}/context",
+  )(
+    pathParams$,
+  );
+  const query$ = queryJoin(
+    encodeFormQuery({
+      "fields": payload$.fields,
+    }, { explode: false }),
+    encodeFormQuery({
+      "direction": payload$.direction,
+      "key": payload$.key,
+      "max_results": payload$.max_results,
+      "next_cursor": payload$.next_cursor,
+      "value": payload$.value,
+    }),
+  );
+
+  const headers$ = new Headers(compactMap({
+    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: "listResourcesByContext",
+    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: "GET",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    query: query$,
+    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<
+    ListResourcesByContextResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(200, ListResourcesByContextResponse$zodSchema, {
+      key: "list_response",
+    }),
+    M.json([400, 401], ListResourcesByContextResponse$zodSchema, {
+      key: "api_error",
+    }),
+  )(response, req$, { extraFields: responseFields$ });
+
+  return [result$, { status: "complete", request: req$, response }];
+}

package/src/funcs/assetsListResourcesByModerationKindAndStatus.ts

@@ -0,0 +1,236 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { CloudinaryAssetMgmtCore } from "../core.js";
+import { encodeFormQuery, encodeSimple, queryJoin } 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 { Direction } from "../models/direction.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 { FieldsSpec } from "../models/fieldsspec.js";
+import {
+  ListResourcesByModerationKindAndStatusModerationStatus,
+  ListResourcesByModerationKindAndStatusRequest,
+  ListResourcesByModerationKindAndStatusRequest$zodSchema,
+  ListResourcesByModerationKindAndStatusResponse,
+  ListResourcesByModerationKindAndStatusResponse$zodSchema,
+  ModerationKind,
+} from "../models/listresourcesbymoderationkindandstatusop.js";
+import { ResourceType } from "../models/resourcetype.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get resources by moderation kind and status
+ *
+ * @remarks
+ * Retrieves resources matching specific moderation kind and status.
+ */
+export function assetsListResourcesByModerationKindAndStatus(
+  client$: CloudinaryAssetMgmtCore,
+  resource_type: ResourceType,
+  moderation_kind: ModerationKind,
+  moderation_status: ListResourcesByModerationKindAndStatusModerationStatus,
+  fields?: Array<FieldsSpec> | undefined,
+  next_cursor?: string | undefined,
+  max_results?: number | undefined,
+  direction?: Direction | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    ListResourcesByModerationKindAndStatusResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    resource_type,
+    moderation_kind,
+    moderation_status,
+    fields,
+    next_cursor,
+    max_results,
+    direction,
+    options,
+  ));
+}
+
+async function $do(
+  client$: CloudinaryAssetMgmtCore,
+  resource_type: ResourceType,
+  moderation_kind: ModerationKind,
+  moderation_status: ListResourcesByModerationKindAndStatusModerationStatus,
+  fields?: Array<FieldsSpec> | undefined,
+  next_cursor?: string | undefined,
+  max_results?: number | undefined,
+  direction?: Direction | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      ListResourcesByModerationKindAndStatusResponse,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const input$: ListResourcesByModerationKindAndStatusRequest = {
+    resource_type: resource_type,
+    moderation_kind: moderation_kind,
+    moderation_status: moderation_status,
+    fields: fields,
+    next_cursor: next_cursor,
+    max_results: max_results,
+    direction: direction,
+  };
+
+  const parsed$ = safeParse(
+    input$,
+    (value$) =>
+      ListResourcesByModerationKindAndStatusRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+
+  const pathParams$ = {
+    cloud_name: encodeSimple("cloud_name", client$._options.cloud_name, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    moderation_kind: encodeSimple("moderation_kind", payload$.moderation_kind, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    moderation_status: encodeSimple(
+      "moderation_status",
+      payload$.moderation_status,
+      { explode: false, charEncoding: "percent" },
+    ),
+    resource_type: encodeSimple("resource_type", payload$.resource_type, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc(
+    "/v1_1/{cloud_name}/resources/{resource_type}/moderations/{moderation_kind}/{moderation_status}",
+  )(
+    pathParams$,
+  );
+  const query$ = queryJoin(
+    encodeFormQuery({
+      "fields": payload$.fields,
+    }, { explode: false }),
+    encodeFormQuery({
+      "direction": payload$.direction,
+      "max_results": payload$.max_results,
+      "next_cursor": payload$.next_cursor,
+    }),
+  );
+
+  const headers$ = new Headers(compactMap({
+    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: "listResourcesByModerationKindAndStatus",
+    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: "GET",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    query: query$,
+    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<
+    ListResourcesByModerationKindAndStatusResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(200, ListResourcesByModerationKindAndStatusResponse$zodSchema, {
+      key: "list_response",
+    }),
+    M.json(
+      [400, 401],
+      ListResourcesByModerationKindAndStatusResponse$zodSchema,
+      { key: "api_error" },
+    ),
+  )(response, req$, { extraFields: responseFields$ });
+
+  return [result$, { status: "complete", request: req$, response }];
+}

package/src/funcs/assetsListVideos.ts

@@ -0,0 +1,225 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { CloudinaryAssetMgmtCore } from "../core.js";
+import { encodeFormQuery, encodeSimple, queryJoin } 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 { Direction } from "../models/direction.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 { FieldsSpec } from "../models/fieldsspec.js";
+import { ListStorageType } from "../models/liststoragetype.js";
+import {
+  ListVideosRequest,
+  ListVideosRequest$zodSchema,
+  ListVideosResponse,
+  ListVideosResponse$zodSchema,
+} from "../models/listvideosop.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * Get video assets
+ *
+ * @remarks
+ * Retrieves a list of video assets. Results can be filtered by various criteria like tags, moderation status, prefix, or specific public IDs.
+ */
+export function assetsListVideos(
+  client$: CloudinaryAssetMgmtCore,
+  type?: ListStorageType | undefined,
+  prefix?: string | undefined,
+  public_ids?: Array<string> | undefined,
+  tags?: boolean | undefined,
+  next_cursor?: string | undefined,
+  max_results?: number | undefined,
+  direction?: Direction | undefined,
+  start_at?: string | undefined,
+  fields?: Array<FieldsSpec> | undefined,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    ListVideosResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client$,
+    type,
+    prefix,
+    public_ids,
+    tags,
+    next_cursor,
+    max_results,
+    direction,
+    start_at,
+    fields,
+    options,
+  ));
+}
+
+async function $do(
+  client$: CloudinaryAssetMgmtCore,
+  type?: ListStorageType | undefined,
+  prefix?: string | undefined,
+  public_ids?: Array<string> | undefined,
+  tags?: boolean | undefined,
+  next_cursor?: string | undefined,
+  max_results?: number | undefined,
+  direction?: Direction | undefined,
+  start_at?: string | undefined,
+  fields?: Array<FieldsSpec> | undefined,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      ListVideosResponse,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const input$: ListVideosRequest | undefined = {
+    type: type,
+    prefix: prefix,
+    public_ids: public_ids,
+    tags: tags,
+    next_cursor: next_cursor,
+    max_results: max_results,
+    direction: direction,
+    start_at: start_at,
+    fields: fields,
+  };
+
+  const parsed$ = safeParse(
+    input$,
+    (value$) => ListVideosRequest$zodSchema.optional().parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+
+  const pathParams$ = {
+    cloud_name: encodeSimple("cloud_name", client$._options.cloud_name, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path$ = pathToFunc("/v1_1/{cloud_name}/resources/video")(
+    pathParams$,
+  );
+  const query$ = queryJoin(
+    encodeFormQuery({
+      "fields": payload$?.fields,
+      "public_ids": payload$?.public_ids,
+    }, { explode: false }),
+    encodeFormQuery({
+      "direction": payload$?.direction,
+      "max_results": payload$?.max_results,
+      "next_cursor": payload$?.next_cursor,
+      "prefix": payload$?.prefix,
+      "start_at": payload$?.start_at,
+      "tags": payload$?.tags,
+      "type": payload$?.type,
+    }),
+  );
+
+  const headers$ = new Headers(compactMap({
+    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: "listVideos",
+    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: "GET",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    query: query$,
+    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<
+    ListVideosResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(200, ListVideosResponse$zodSchema, { key: "list_response" }),
+    M.json([400, 401], ListVideosResponse$zodSchema, { key: "api_error" }),
+  )(response, req$, { extraFields: responseFields$ });
+
+  return [result$, { status: "complete", request: req$, response }];
+}