@moovio/sdk 0.15.6 → 0.16.0

package/src/funcs/imagesGetPublic.ts

@@ -0,0 +1,196 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { MoovCore } from "../core.js";
+import { encodeFormQuery, 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 { pathToFunc } from "../lib/url.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { MoovError } from "../models/errors/mooverror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+export enum GetPublicAcceptEnum {
+  imageJpeg = "image/jpeg",
+  imagePng = "image/png",
+  imageWebp = "image/webp",
+}
+
+/**
+ * Get an image by its public ID.
+ */
+export function imagesGetPublic(
+  client: MoovCore,
+  request: operations.GetPublicImageRequest,
+  options?: RequestOptions & { acceptHeaderOverride?: GetPublicAcceptEnum },
+): APIPromise<
+  Result<
+    operations.GetPublicImageResponse | undefined,
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MoovCore,
+  request: operations.GetPublicImageRequest,
+  options?: RequestOptions & { acceptHeaderOverride?: GetPublicAcceptEnum },
+): Promise<
+  [
+    Result<
+      operations.GetPublicImageResponse | undefined,
+      | MoovError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.GetPublicImageRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    publicID: encodeSimple("publicID", payload.publicID, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/images/{publicID}")(pathParams);
+
+  const query = encodeFormQuery({
+    "size": payload.size,
+  }, { explode: false });
+
+  const headers = new Headers(compactMap({
+    Accept: options?.acceptHeaderOverride
+      || "image/jpeg;q=1, image/png;q=0.7, image/webp;q=0",
+    "if-none-match": encodeSimple("if-none-match", payload["if-none-match"], {
+      explode: false,
+      charEncoding: "none",
+    }),
+  }));
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "getPublicImage",
+    oAuth2Scopes: [],
+
+    resolvedSecurity: null,
+
+    securitySource: null,
+    retryConfig: options?.retries
+      || client._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
+  };
+
+  const requestRes = client._createRequest(context, {
+    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: ["404", "429", "4XX", "500", "502", "504", "5XX"],
+    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<
+    operations.GetPublicImageResponse | undefined,
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.stream(200, operations.GetPublicImageResponse$inboundSchema.optional(), {
+      ctype: "image/webp",
+      hdrs: true,
+      key: "Result",
+    }),
+    M.stream(200, operations.GetPublicImageResponse$inboundSchema.optional(), {
+      ctype: "image/png",
+      hdrs: true,
+      key: "Result",
+    }),
+    M.stream(200, operations.GetPublicImageResponse$inboundSchema.optional(), {
+      ctype: "image/jpeg",
+      hdrs: true,
+      key: "Result",
+    }),
+    M.nil(304, operations.GetPublicImageResponse$inboundSchema.optional(), {
+      hdrs: true,
+    }),
+    M.fail([404, 429]),
+    M.fail([500, 502, 504]),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/imagesList.ts

@@ -0,0 +1,176 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { MoovCore } from "../core.js";
+import { 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 {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import { MoovError } from "../models/errors/mooverror.js";
+import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
+import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
+import * as operations from "../models/operations/index.js";
+import { APICall, APIPromise } from "../types/async.js";
+import { Result } from "../types/fp.js";
+
+/**
+ * List metadata for all images in the specified account.
+ */
+export function imagesList(
+  client: MoovCore,
+  request: operations.ListImageMetadataRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.ListImageMetadataResponse,
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MoovCore,
+  request: operations.ListImageMetadataRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.ListImageMetadataResponse,
+      | MoovError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.ListImageMetadataRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    accountID: encodeSimple("accountID", payload.accountID, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/accounts/{accountID}/images")(pathParams);
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+    "x-moov-version": encodeSimple(
+      "x-moov-version",
+      client._options.xMoovVersion,
+      { explode: false, charEncoding: "none" },
+    ),
+  }));
+
+  const securityInput = await extractSecurity(client._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
+
+  const context = {
+    options: client._options,
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "listImageMetadata",
+    oAuth2Scopes: [],
+
+    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,
+    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: ["401", "403", "429", "4XX", "500", "504", "5XX"],
+    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<
+    operations.ListImageMetadataResponse,
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.ListImageMetadataResponse$inboundSchema, {
+      hdrs: true,
+      key: "Result",
+    }),
+    M.fail([401, 403, 429]),
+    M.fail([500, 504]),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, req, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -73,7 +73,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "latest",
-  sdkVersion: "0.15.6",
-  genVersion: "2.716.16",
-  userAgent: "speakeasy-sdk/typescript 0.15.6 2.716.16 latest @moovio/sdk",
+  sdkVersion: "0.16.0",
+  genVersion: "2.721.3",
+  userAgent: "speakeasy-sdk/typescript 0.16.0 2.721.3 latest @moovio/sdk",
 } as const;

package/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.15.6",
+    currentVersion: "0.16.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -88,6 +88,10 @@ import { tool$feePlansRetrieveFees } from "./tools/feePlansRetrieveFees.js";
 import { tool$filesGet } from "./tools/filesGet.js";
 import { tool$filesList } from "./tools/filesList.js";
 import { tool$filesUpload } from "./tools/filesUpload.js";
+import { tool$imagesDelete } from "./tools/imagesDelete.js";
+import { tool$imagesGetMetadata } from "./tools/imagesGetMetadata.js";
+import { tool$imagesGetPublic } from "./tools/imagesGetPublic.js";
+import { tool$imagesList } from "./tools/imagesList.js";
 import { tool$industriesList } from "./tools/industriesList.js";
 import { tool$institutionsSearch } from "./tools/institutionsSearch.js";
 import { tool$institutionsSearchInstitutions } from "./tools/institutionsSearchInstitutions.js";
@@ -172,7 +176,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Moov",
-    version: "0.15.6",
+    version: "0.16.0",
   });
 
   const client = new MoovCore({
@@ -262,6 +266,10 @@ export function createMCPServer(deps: {
   tool(tool$filesUpload);
   tool(tool$filesList);
   tool(tool$filesGet);
+  tool(tool$imagesList);
+  tool(tool$imagesGetMetadata);
+  tool(tool$imagesDelete);
+  tool(tool$imagesGetPublic);
   tool(tool$paymentLinksCreate);
   tool(tool$paymentLinksList);
   tool(tool$paymentLinksGet);

package/src/mcp-server/tools/imagesDelete.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { imagesDelete } from "../../funcs/imagesDelete.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.DeleteImageRequest$inboundSchema,
+};
+
+export const tool$imagesDelete: ToolDefinition<typeof args> = {
+  name: "images-delete",
+  description: `Permanently delete an image by its ID.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await imagesDelete(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(void 0, apiCall);
+  },
+};

package/src/mcp-server/tools/imagesGetMetadata.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { imagesGetMetadata } from "../../funcs/imagesGetMetadata.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetImageMetadataRequest$inboundSchema,
+};
+
+export const tool$imagesGetMetadata: ToolDefinition<typeof args> = {
+  name: "images-get-metadata",
+  description: `Retrieve metadata for a specific image by its ID.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await imagesGetMetadata(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value.result;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/imagesGetPublic.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { imagesGetPublic } from "../../funcs/imagesGetPublic.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetPublicImageRequest$inboundSchema,
+};
+
+export const tool$imagesGetPublic: ToolDefinition<typeof args> = {
+  name: "images-get-public",
+  description: `Get an image by its public ID.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await imagesGetPublic(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value?.result;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/imagesList.ts

@@ -0,0 +1,35 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { imagesList } from "../../funcs/imagesList.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListImageMetadataRequest$inboundSchema,
+};
+
+export const tool$imagesList: ToolDefinition<typeof args> = {
+  name: "images-list",
+  description: `List metadata for all images in the specified account.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await imagesList(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value.result;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/models/components/imagemetadata.ts

@@ -0,0 +1,90 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Metadata about an uploaded image.
+ */
+export type ImageMetadata = {
+  imageID: string;
+  /**
+   * Alternative text for the image.
+   */
+  altText?: string | undefined;
+  /**
+   * A public URL to access the image. An optional `size={width}x{height}`
+   *
+   * @remarks
+   * query parameter can be provided to resize the image.
+   */
+  link: string;
+  createdOn: Date;
+  updatedOn: Date;
+};
+
+/** @internal */
+export const ImageMetadata$inboundSchema: z.ZodType<
+  ImageMetadata,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  imageID: z.string(),
+  altText: z.string().optional(),
+  link: z.string(),
+  createdOn: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  updatedOn: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+
+/** @internal */
+export type ImageMetadata$Outbound = {
+  imageID: string;
+  altText?: string | undefined;
+  link: string;
+  createdOn: string;
+  updatedOn: string;
+};
+
+/** @internal */
+export const ImageMetadata$outboundSchema: z.ZodType<
+  ImageMetadata$Outbound,
+  z.ZodTypeDef,
+  ImageMetadata
+> = z.object({
+  imageID: z.string(),
+  altText: z.string().optional(),
+  link: z.string(),
+  createdOn: z.date().transform(v => v.toISOString()),
+  updatedOn: z.date().transform(v => v.toISOString()),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace ImageMetadata$ {
+  /** @deprecated use `ImageMetadata$inboundSchema` instead. */
+  export const inboundSchema = ImageMetadata$inboundSchema;
+  /** @deprecated use `ImageMetadata$outboundSchema` instead. */
+  export const outboundSchema = ImageMetadata$outboundSchema;
+  /** @deprecated use `ImageMetadata$Outbound` instead. */
+  export type Outbound = ImageMetadata$Outbound;
+}
+
+export function imageMetadataToJSON(imageMetadata: ImageMetadata): string {
+  return JSON.stringify(ImageMetadata$outboundSchema.parse(imageMetadata));
+}
+
+export function imageMetadataFromJSON(
+  jsonString: string,
+): SafeParseResult<ImageMetadata, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ImageMetadata$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ImageMetadata' from JSON`,
+  );
+}

package/src/models/components/index.ts

@@ -218,6 +218,7 @@ export * from "./governmentid.js";
 export * from "./governmentiderror.js";
 export * from "./granttype.js";
 export * from "./guestprofile.js";
+export * from "./imagemetadata.js";
 export * from "./incurredfee.js";
 export * from "./individualname.js";
 export * from "./individualnameerror.js";

package/src/models/components/paymentmethodswallet.ts

@@ -19,8 +19,8 @@ export type PaymentMethodsWallet = {
    * Type of a wallet.
    *
    * @remarks
-   *   - `default`: The primary system-generated wallet automatically created by Moov when an account is granted the wallet capability. This generates a moov-wallet payment method that is available for use immediately. Only one default wallet exists per account.
-   *   - `general`: A user-defined wallet created via the API to segment funds for specific use cases. Users can create multiple general wallets per account to support internal business models or financial reporting needs.
+   *   - `default`: The system-generated wallet automatically created when an account is granted the wallet capability.
+   *   - `general`: An additional, user-defined wallet created via API or Dashboard.
    */
   walletType: WalletType;
 };