@moovio/sdk 26.4.0-dev.16 → 26.4.0-dev.17

package/src/funcs/transfersBatchGetTransfers.ts

@@ -0,0 +1,180 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { MoovCore } from "../core.js";
+import { encodeJSON, 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";
+
+/**
+ * Retrieve transfer details for multiple transfers in one request. The response is a map from each
+ * requested transfer ID to its full transfer details when available; IDs that are not found or not
+ * accessible under this account are omitted from the map.
+ *
+ * Read our [transfers overview guide](https://docs.moov.io/guides/money-movement/overview/) to learn more.
+ *
+ * To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+ * you'll need to specify the `/accounts/{accountID}/transfers.read` scope.
+ */
+export function transfersBatchGetTransfers(
+  client: MoovCore,
+  request: operations.BatchGetTransfersRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.BatchGetTransfersResponse,
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MoovCore,
+  request: operations.BatchGetTransfersRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.BatchGetTransfersResponse,
+      | MoovError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.BatchGetTransfersRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.BatchGetTransfersRequest, {
+    explode: true,
+  });
+
+  const pathParams = {
+    accountID: encodeSimple("accountID", payload.accountID, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/accounts/{accountID}/transfers/.fetch")(pathParams);
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    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: "batchGetTransfers",
+    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: "POST",
+    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.BatchGetTransfersResponse,
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.BatchGetTransfersResponse$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

@@ -68,8 +68,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "v2026.04.00",
-  sdkVersion: "26.4.0-dev.16",
-  genVersion: "2.869.10",
+  sdkVersion: "26.4.0-dev.17",
+  genVersion: "2.879.13",
   userAgent:
-    "speakeasy-sdk/typescript 26.4.0-dev.16 2.869.10 v2026.04.00 @moovio/sdk",
+    "speakeasy-sdk/typescript 26.4.0-dev.17 2.879.13 v2026.04.00 @moovio/sdk",
 } as const;

package/src/lib/encodings.ts

@@ -479,6 +479,23 @@ export const encodeSpaceDelimitedQuery = queryEncoder(encodeSpaceDelimited);
 export const encodePipeDelimitedQuery = queryEncoder(encodePipeDelimited);
 export const encodeDeepObjectQuery = queryEncoder(encodeDeepObject);
 
+function isBlobLike(val: unknown): val is Blob {
+  if (val instanceof Blob) {
+    return true;
+  }
+
+  if (typeof val !== "object" || val == null || !(Symbol.toStringTag in val)) {
+    return false;
+  }
+
+  const tag = val[Symbol.toStringTag];
+  if (tag !== "Blob" && tag !== "File") {
+    return false;
+  }
+
+  return "stream" in val && typeof val.stream === "function";
+}
+
 export function appendForm(
   fd: FormData,
   key: string,
@@ -487,11 +504,22 @@ export function appendForm(
 ): void {
   if (value == null) {
     return;
-  } else if (value instanceof Blob && fileName) {
-    fd.append(key, value, fileName);
-  } else if (value instanceof Blob) {
-    fd.append(key, value);
+  } else if (isBlobLike(value)) {
+    if (fileName) {
+      fd.append(key, value as Blob, fileName);
+    } else {
+      fd.append(key, value as Blob);
+    }
   } else {
     fd.append(key, String(value));
   }
 }
+
+export async function normalizeBlob(
+  value: Pick<Blob, "arrayBuffer" | "type">,
+): Promise<Blob> {
+  if (value instanceof Blob) {
+    return value;
+  }
+  return new Blob([await value.arrayBuffer()], { type: value.type });
+}

package/src/lib/security.ts

@@ -239,15 +239,27 @@ function applyBearer(
 
 export function resolveGlobalSecurity(
   security: Partial<components.Security> | null | undefined,
+  allowedFields?: number[],
 ): SecurityState | null {
-  return resolveSecurity(
+  let inputs: SecurityInput[][] = [
     [
       {
         type: "http:basic",
         value: { username: security?.username, password: security?.password },
       },
     ],
-  );
+  ];
+
+  if (allowedFields) {
+    inputs = allowedFields.map((i) => {
+      if (i < 0 || i >= inputs.length) {
+        throw new RangeError(`invalid allowedFields index ${i}`);
+      }
+      return inputs[i]!;
+    });
+  }
+
+  return resolveSecurity(...inputs);
 }
 
 export async function extractSecurity<

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

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "26.4.0-dev.16",
+    currentVersion: "26.4.0-dev.17",
   },
 });
 

package/src/mcp-server/server.ts

@@ -167,6 +167,7 @@ import { tool$terminalApplicationsCreateVersion } from "./tools/terminalApplicat
 import { tool$terminalApplicationsDelete } from "./tools/terminalApplicationsDelete.js";
 import { tool$terminalApplicationsGet } from "./tools/terminalApplicationsGet.js";
 import { tool$terminalApplicationsList } from "./tools/terminalApplicationsList.js";
+import { tool$transfersBatchGetTransfers } from "./tools/transfersBatchGetTransfers.js";
 import { tool$transfersCreate } from "./tools/transfersCreate.js";
 import { tool$transfersCreateCancellation } from "./tools/transfersCreateCancellation.js";
 import { tool$transfersCreateReversal } from "./tools/transfersCreateReversal.js";
@@ -206,7 +207,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Moov",
-    version: "26.4.0-dev.16",
+    version: "26.4.0-dev.17",
   });
 
   const client = new MoovCore({
@@ -361,6 +362,7 @@ export function createMCPServer(deps: {
   tool(tool$transfersGenerateOptions);
   tool(tool$transfersCreate);
   tool(tool$transfersList);
+  tool(tool$transfersBatchGetTransfers);
   tool(tool$transfersGet);
   tool(tool$transfersUpdate);
   tool(tool$transfersCreateCancellation);

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

@@ -12,12 +12,12 @@ const args = {
 
 export const tool$applePayLinkToken: ToolDefinition<typeof args> = {
   name: "apple-pay-link-token",
-  description: `Connect an Apple Pay token to the specified account. 
+  description: `Connect an Apple Pay token to the specified account.
 
-Read our [Apple Pay tutorial](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) to learn more. 
+Read our [Apple Pay tutorial](https://docs.moov.io/guides/sources/cards/apple-pay/#register-your-domains) to learn more.
 The \`token\` data is defined by Apple Pay and should be passed through from Apple Pay's response unmodified.
 
-To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) 
+To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
 you'll need to specify the \`/accounts/{accountID}/cards.write\` scope.`,
   args,
   tool: async (client, args, ctx) => {

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

@@ -31,6 +31,8 @@ you'll need to specify the \`/accounts/{accountID}/issued-cards.write\` scope.`,
       };
     }
 
-    return formatResult(void 0, apiCall);
+    const value = result.value.result;
+
+    return formatResult(value, apiCall);
   },
 };

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

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { transfersBatchGetTransfers } from "../../funcs/transfersBatchGetTransfers.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.BatchGetTransfersRequest$inboundSchema,
+};
+
+export const tool$transfersBatchGetTransfers: ToolDefinition<typeof args> = {
+  name: "transfers-batch-get-transfers",
+  description:
+    `Retrieve transfer details for multiple transfers in one request. The response is a map from each
+requested transfer ID to its full transfer details when available; IDs that are not found or not
+accessible under this account are omitted from the map.
+
+Read our [transfers overview guide](https://docs.moov.io/guides/money-movement/overview/) to learn more.
+
+To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+you'll need to specify the \`/accounts/{accountID}/transfers.read\` scope.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await transfersBatchGetTransfers(
+      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/batchgettransfersrequest.ts

@@ -0,0 +1,54 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Array of transfer IDs to fetch.
+ */
+export type BatchGetTransfersRequest = {
+  transferIDs: Array<string>;
+};
+
+/** @internal */
+export const BatchGetTransfersRequest$inboundSchema: z.ZodType<
+  BatchGetTransfersRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  transferIDs: z.array(z.string()),
+});
+/** @internal */
+export type BatchGetTransfersRequest$Outbound = {
+  transferIDs: Array<string>;
+};
+
+/** @internal */
+export const BatchGetTransfersRequest$outboundSchema: z.ZodType<
+  BatchGetTransfersRequest$Outbound,
+  z.ZodTypeDef,
+  BatchGetTransfersRequest
+> = z.object({
+  transferIDs: z.array(z.string()),
+});
+
+export function batchGetTransfersRequestToJSON(
+  batchGetTransfersRequest: BatchGetTransfersRequest,
+): string {
+  return JSON.stringify(
+    BatchGetTransfersRequest$outboundSchema.parse(batchGetTransfersRequest),
+  );
+}
+export function batchGetTransfersRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<BatchGetTransfersRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BatchGetTransfersRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BatchGetTransfersRequest' from JSON`,
+  );
+}

package/src/models/components/cardpayouttype.ts

@@ -0,0 +1,26 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../../types/enums.js";
+
+/**
+ * Specifies the type of card payout for push-to-card transfers, used to determine the business application identifier (BAI) sent to the card network.
+ */
+export const CardPayoutType = {
+  Loyalty: "loyalty",
+} as const;
+/**
+ * Specifies the type of card payout for push-to-card transfers, used to determine the business application identifier (BAI) sent to the card network.
+ */
+export type CardPayoutType = ClosedEnum<typeof CardPayoutType>;
+
+/** @internal */
+export const CardPayoutType$inboundSchema: z.ZodNativeEnum<
+  typeof CardPayoutType
+> = z.nativeEnum(CardPayoutType);
+/** @internal */
+export const CardPayoutType$outboundSchema: z.ZodNativeEnum<
+  typeof CardPayoutType
+> = CardPayoutType$inboundSchema;

package/src/models/components/createtransferdestinationcard.ts

@@ -6,12 +6,21 @@ import * as z from "zod/v3";
 import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  CardPayoutType,
+  CardPayoutType$inboundSchema,
+  CardPayoutType$outboundSchema,
+} from "./cardpayouttype.js";
 
 export type CreateTransferDestinationCard = {
   /**
    * An optional override of the default card statement descriptor for a transfer. Accounts must be enabled by Moov to set this field.
    */
   dynamicDescriptor?: string | undefined;
+  /**
+   * An optional field to specify the type of card payout, used to route the transfer with the appropriate business application identifier (BAI).
+   */
+  payoutType?: CardPayoutType | undefined;
 };
 
 /** @internal */
@@ -21,10 +30,12 @@ export const CreateTransferDestinationCard$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   dynamicDescriptor: z.string().optional(),
+  payoutType: CardPayoutType$inboundSchema.optional(),
 });
 /** @internal */
 export type CreateTransferDestinationCard$Outbound = {
   dynamicDescriptor?: string | undefined;
+  payoutType?: string | undefined;
 };
 
 /** @internal */
@@ -34,6 +45,7 @@ export const CreateTransferDestinationCard$outboundSchema: z.ZodType<
   CreateTransferDestinationCard
 > = z.object({
   dynamicDescriptor: z.string().optional(),
+  payoutType: CardPayoutType$outboundSchema.optional(),
 });
 
 export function createTransferDestinationCardToJSON(

package/src/models/components/index.ts

@@ -69,6 +69,7 @@ export * from "./bankaccountverificationmethod.js";
 export * from "./bankaccountverificationstatus.js";
 export * from "./bankaccountwaitfor.js";
 export * from "./basicpaymentmethod.js";
+export * from "./batchgettransfersrequest.js";
 export * from "./billablefee.js";
 export * from "./billingcountandamount.js";
 export * from "./billinginterchangeprogramfee.js";
@@ -112,6 +113,7 @@ export * from "./cardpaymentdetailserror.js";
 export * from "./cardpaymentpaymentmethod.js";
 export * from "./cardpaymentsettings.js";
 export * from "./cardpaymenttransferpaymentmethod.js";
+export * from "./cardpayouttype.js";
 export * from "./cardpresentpaymentpaymentmethod.js";
 export * from "./cardpresentpaymenttransferpaymentmethod.js";
 export * from "./cardtransactiondetails.js";
@@ -393,8 +395,12 @@ export * from "./productoptiongroupvalidationerror.js";
 export * from "./productoptionvalidationerror.js";
 export * from "./productrequest.js";
 export * from "./profile.js";
+export * from "./pullfromapplepaypaymentmethod.js";
+export * from "./pullfromapplepaytransferpaymentmethod.js";
 export * from "./pullfromcardpaymentmethod.js";
 export * from "./pullfromcardtransferpaymentmethod.js";
+export * from "./pushtoapplepaypaymentmethod.js";
+export * from "./pushtoapplepaytransferpaymentmethod.js";
 export * from "./pushtocardpaymentmethod.js";
 export * from "./pushtocardtransferpaymentmethod.js";
 export * from "./qrcode.js";
@@ -425,9 +431,11 @@ export * from "./reversedwithrefund.js";
 export * from "./revoketokenrequest.js";
 export * from "./rtpcreditpaymentmethod.js";
 export * from "./rtpcredittransferpaymentmethod.js";
+export * from "./rtpfailurecode.js";
 export * from "./rtpinstitution.js";
 export * from "./rtprejectioncode.js";
 export * from "./rtpservices.js";
+export * from "./rtptransactionstatus.js";
 export * from "./runtransfer.js";
 export * from "./scheduledtransferimagemetadata.js";
 export * from "./scheduledtransferlineitem.js";

package/src/models/components/paymentmethod.ts

@@ -60,12 +60,24 @@ import {
   MoovWalletPaymentMethod$Outbound,
   MoovWalletPaymentMethod$outboundSchema,
 } from "./moovwalletpaymentmethod.js";
+import {
+  PullFromApplePayPaymentMethod,
+  PullFromApplePayPaymentMethod$inboundSchema,
+  PullFromApplePayPaymentMethod$Outbound,
+  PullFromApplePayPaymentMethod$outboundSchema,
+} from "./pullfromapplepaypaymentmethod.js";
 import {
   PullFromCardPaymentMethod,
   PullFromCardPaymentMethod$inboundSchema,
   PullFromCardPaymentMethod$Outbound,
   PullFromCardPaymentMethod$outboundSchema,
 } from "./pullfromcardpaymentmethod.js";
+import {
+  PushToApplePayPaymentMethod,
+  PushToApplePayPaymentMethod$inboundSchema,
+  PushToApplePayPaymentMethod$Outbound,
+  PushToApplePayPaymentMethod$outboundSchema,
+} from "./pushtoapplepaypaymentmethod.js";
 import {
   PushToCardPaymentMethod,
   PushToCardPaymentMethod$inboundSchema,
@@ -94,7 +106,9 @@ export type PaymentMethod =
   | PullFromCardPaymentMethod
   | ApplePayPaymentMethod
   | CardPresentPaymentPaymentMethod
-  | InstantBankCreditPaymentMethod;
+  | InstantBankCreditPaymentMethod
+  | PushToApplePayPaymentMethod
+  | PullFromApplePayPaymentMethod;
 
 /** @internal */
 export const PaymentMethod$inboundSchema: z.ZodType<
@@ -114,6 +128,8 @@ export const PaymentMethod$inboundSchema: z.ZodType<
   ApplePayPaymentMethod$inboundSchema,
   CardPresentPaymentPaymentMethod$inboundSchema,
   InstantBankCreditPaymentMethod$inboundSchema,
+  PushToApplePayPaymentMethod$inboundSchema,
+  PullFromApplePayPaymentMethod$inboundSchema,
 ]);
 /** @internal */
 export type PaymentMethod$Outbound =
@@ -128,7 +144,9 @@ export type PaymentMethod$Outbound =
   | PullFromCardPaymentMethod$Outbound
   | ApplePayPaymentMethod$Outbound
   | CardPresentPaymentPaymentMethod$Outbound
-  | InstantBankCreditPaymentMethod$Outbound;
+  | InstantBankCreditPaymentMethod$Outbound
+  | PushToApplePayPaymentMethod$Outbound
+  | PullFromApplePayPaymentMethod$Outbound;
 
 /** @internal */
 export const PaymentMethod$outboundSchema: z.ZodType<
@@ -148,6 +166,8 @@ export const PaymentMethod$outboundSchema: z.ZodType<
   ApplePayPaymentMethod$outboundSchema,
   CardPresentPaymentPaymentMethod$outboundSchema,
   InstantBankCreditPaymentMethod$outboundSchema,
+  PushToApplePayPaymentMethod$outboundSchema,
+  PullFromApplePayPaymentMethod$outboundSchema,
 ]);
 
 export function paymentMethodToJSON(paymentMethod: PaymentMethod): string {

package/src/models/components/paymentmethodtype.ts

@@ -21,6 +21,8 @@ export const PaymentMethodType = {
   ApplePay: "apple-pay",
   CardPresentPayment: "card-present-payment",
   InstantBankCredit: "instant-bank-credit",
+  PushToApplePay: "push-to-apple-pay",
+  PullFromApplePay: "pull-from-apple-pay",
 } as const;
 /**
  * The payment method type that represents a payment rail and directionality