@moovio/sdk 26.7.0-dev.6 → 26.10.0-dev.0

package/src/funcs/transfersGetRiskOutcomes.ts

@@ -0,0 +1,182 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { MoovCore } from "../core.js";
+import { encodeSimple } from "../lib/encodings.js";
+import { matchStatusCode } from "../lib/http.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 the risk rules that contributed to a transfer's risk decision.
+ *
+ * This endpoint has limited availability and must be enabled for your account by Moov.
+ *
+ * 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 transfersGetRiskOutcomes(
+  client: MoovCore,
+  request: operations.GetTransferRiskOutcomesRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.GetTransferRiskOutcomesResponse,
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MoovCore,
+  request: operations.GetTransferRiskOutcomesRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.GetTransferRiskOutcomesResponse,
+      | MoovError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.GetTransferRiskOutcomesRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
+  const pathParams = {
+    transferID: encodeSimple("transferID", payload.transferID, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+  const path = pathToFunc("/transfers/{transferID}/risk-outcomes")(pathParams);
+
+  const headers = new Headers(compactMap({
+    Accept: "application/json",
+    "X-Account-ID": encodeSimple("X-Account-ID", payload["X-Account-ID"], {
+      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: "getTransferRiskOutcomes",
+    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,
+    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,
+    isErrorStatusCode: (statusCode: number) =>
+      matchStatusCode({ status: statusCode } as Response, ["4XX", "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.GetTransferRiskOutcomesResponse,
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.GetTransferRiskOutcomesResponse$inboundSchema, {
+      hdrs: true,
+      key: "Result",
+    }),
+    M.fail([401, 403, 404, 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

@@ -72,9 +72,9 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 
 export const SDK_METADATA = {
   language: "typescript",
-  openapiDocVersion: "v2026.07.00",
-  sdkVersion: "26.7.0-dev.6",
+  openapiDocVersion: "v2026.10.00",
+  sdkVersion: "26.10.0-dev.0",
   genVersion: "2.917.0",
   userAgent:
-    "speakeasy-sdk/typescript 26.7.0-dev.6 2.917.0 v2026.07.00 @moovio/sdk",
+    "speakeasy-sdk/typescript 26.10.0-dev.0 2.917.0 v2026.10.00 @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: "26.7.0-dev.6",
+    currentVersion: "26.10.0-dev.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -181,6 +181,7 @@ import { tool$transfersGenerateOptions } from "./tools/transfersGenerateOptions.
 import { tool$transfersGet } from "./tools/transfersGet.js";
 import { tool$transfersGetCancellation } from "./tools/transfersGetCancellation.js";
 import { tool$transfersGetRefund } from "./tools/transfersGetRefund.js";
+import { tool$transfersGetRiskOutcomes } from "./tools/transfersGetRiskOutcomes.js";
 import { tool$transfersInitiateRefund } from "./tools/transfersInitiateRefund.js";
 import { tool$transfersList } from "./tools/transfersList.js";
 import { tool$transfersListCancellations } from "./tools/transfersListCancellations.js";
@@ -215,7 +216,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Moov",
-    version: "26.7.0-dev.6",
+    version: "26.10.0-dev.0",
   });
 
   const client = new MoovCore({
@@ -386,6 +387,7 @@ export function createMCPServer(deps: {
   tool(tool$transfersListRefunds);
   tool(tool$transfersGetRefund);
   tool(tool$transfersCreateReversal);
+  tool(tool$transfersGetRiskOutcomes);
   tool(tool$underwritingGet);
   tool(tool$underwritingSave);
   tool(tool$underwritingUpsert);

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

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { transfersGetRiskOutcomes } from "../../funcs/transfersGetRiskOutcomes.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetTransferRiskOutcomesRequest$inboundSchema,
+};
+
+export const tool$transfersGetRiskOutcomes: ToolDefinition<typeof args> = {
+  name: "transfers-get-risk-outcomes",
+  description:
+    `Retrieve the risk rules that contributed to a transfer's risk decision.
+
+This endpoint has limited availability and must be enabled for your account by Moov.
+
+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 transfersGetRiskOutcomes(
+      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/contributingrule.ts

@@ -0,0 +1,58 @@
+/*
+ * 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 * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * A risk rule that contributed to a transfer's risk decision.
+ */
+export type ContributingRule = {
+  /**
+   * Human-readable name of the contributing risk rule.
+   */
+  name: string;
+};
+
+/** @internal */
+export const ContributingRule$inboundSchema: z.ZodType<
+  ContributingRule,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: types.string(),
+});
+/** @internal */
+export type ContributingRule$Outbound = {
+  name: string;
+};
+
+/** @internal */
+export const ContributingRule$outboundSchema: z.ZodType<
+  ContributingRule$Outbound,
+  z.ZodTypeDef,
+  ContributingRule
+> = z.object({
+  name: z.string(),
+});
+
+export function contributingRuleToJSON(
+  contributingRule: ContributingRule,
+): string {
+  return JSON.stringify(
+    ContributingRule$outboundSchema.parse(contributingRule),
+  );
+}
+export function contributingRuleFromJSON(
+  jsonString: string,
+): SafeParseResult<ContributingRule, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ContributingRule$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ContributingRule' from JSON`,
+  );
+}

package/src/models/components/filedetails.ts

@@ -26,7 +26,7 @@ export type FileDetails = {
   fileName: string;
   accountID: string;
   /**
-   * The file's purpose.
+   * The purpose of the file being uploaded.
    */
   filePurpose: FilePurpose;
   /**

package/src/models/components/filepurpose.ts

@@ -7,7 +7,7 @@ import * as openEnums from "../../types/enums.js";
 import { OpenEnum } from "../../types/enums.js";
 
 /**
- * The file's purpose.
+ * The purpose of the file being uploaded.
  */
 export const FilePurpose = {
   BusinessVerification: "business_verification",
@@ -18,7 +18,7 @@ export const FilePurpose = {
   IdentityVerification: "identity_verification",
 } as const;
 /**
- * The file's purpose.
+ * The purpose of the file being uploaded.
  */
 export type FilePurpose = OpenEnum<typeof FilePurpose>;
 

package/src/models/components/index.ts

@@ -143,6 +143,7 @@ export * from "./completebankaccountverification.js";
 export * from "./completedmicrodeposits.js";
 export * from "./completemicrodeposits.js";
 export * from "./contact.js";
+export * from "./contributingrule.js";
 export * from "./createaccount.js";
 export * from "./createaccountsettings.js";
 export * from "./createaccounttype.js";
@@ -369,6 +370,7 @@ export * from "./othercardfees.js";
 export * from "./partialscheduleaccount.js";
 export * from "./partnerfees.js";
 export * from "./partnerpricingagreement.js";
+export * from "./partnerriskoutcomesresponse.js";
 export * from "./patchaccount.js";
 export * from "./patchbusiness.js";
 export * from "./patchindividual.js";

package/src/models/components/onboardinginvite.ts

@@ -40,7 +40,7 @@ export type OnboardingInvite = {
    */
   link: string;
   /**
-   * The scopes requested by the inviter.
+   * Optional URL to redirect the user to after they complete the onboarding process.
    */
   returnURL?: string | undefined;
   /**

package/src/models/components/partnerriskoutcomesresponse.ts

@@ -0,0 +1,77 @@
+/*
+ * 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 * as types from "../../types/primitives.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  ContributingRule,
+  ContributingRule$inboundSchema,
+  ContributingRule$Outbound,
+  ContributingRule$outboundSchema,
+} from "./contributingrule.js";
+
+/**
+ * The risk rules that contributed to a transfer's risk decision.
+ *
+ * @remarks
+ *
+ * This information has limited availability and must be enabled for your account by Moov.
+ */
+export type PartnerRiskOutcomesResponse = {
+  /**
+   * Identifier of the transfer these outcomes belong to.
+   */
+  transferID: string;
+  /**
+   * The risk rules that contributed to the decision. May be empty when no rules are disclosed.
+   */
+  contributingRules: Array<ContributingRule>;
+};
+
+/** @internal */
+export const PartnerRiskOutcomesResponse$inboundSchema: z.ZodType<
+  PartnerRiskOutcomesResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  transferID: types.string(),
+  contributingRules: z.array(ContributingRule$inboundSchema),
+});
+/** @internal */
+export type PartnerRiskOutcomesResponse$Outbound = {
+  transferID: string;
+  contributingRules: Array<ContributingRule$Outbound>;
+};
+
+/** @internal */
+export const PartnerRiskOutcomesResponse$outboundSchema: z.ZodType<
+  PartnerRiskOutcomesResponse$Outbound,
+  z.ZodTypeDef,
+  PartnerRiskOutcomesResponse
+> = z.object({
+  transferID: z.string(),
+  contributingRules: z.array(ContributingRule$outboundSchema),
+});
+
+export function partnerRiskOutcomesResponseToJSON(
+  partnerRiskOutcomesResponse: PartnerRiskOutcomesResponse,
+): string {
+  return JSON.stringify(
+    PartnerRiskOutcomesResponse$outboundSchema.parse(
+      partnerRiskOutcomesResponse,
+    ),
+  );
+}
+export function partnerRiskOutcomesResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<PartnerRiskOutcomesResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => PartnerRiskOutcomesResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'PartnerRiskOutcomesResponse' from JSON`,
+  );
+}

package/src/models/operations/gettransferriskoutcomes.ts

@@ -0,0 +1,136 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import * as types from "../../types/primitives.js";
+import * as components from "../components/index.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type GetTransferRiskOutcomesRequest = {
+  /**
+   * Identifier for the transfer.
+   */
+  transferID: string;
+  /**
+   * The account the transfer belongs to. When omitted, the account is resolved
+   *
+   * @remarks
+   * from the calling credentials.
+   */
+  xAccountID?: string | undefined;
+};
+
+export type GetTransferRiskOutcomesResponse = {
+  headers: { [k: string]: Array<string> };
+  result: components.PartnerRiskOutcomesResponse;
+};
+
+/** @internal */
+export const GetTransferRiskOutcomesRequest$inboundSchema: z.ZodType<
+  GetTransferRiskOutcomesRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  transferID: types.string(),
+  "X-Account-ID": types.optional(types.string()),
+}).transform((v) => {
+  return remap$(v, {
+    "X-Account-ID": "xAccountID",
+  });
+});
+/** @internal */
+export type GetTransferRiskOutcomesRequest$Outbound = {
+  transferID: string;
+  "X-Account-ID"?: string | undefined;
+};
+
+/** @internal */
+export const GetTransferRiskOutcomesRequest$outboundSchema: z.ZodType<
+  GetTransferRiskOutcomesRequest$Outbound,
+  z.ZodTypeDef,
+  GetTransferRiskOutcomesRequest
+> = z.object({
+  transferID: z.string(),
+  xAccountID: z.string().optional(),
+}).transform((v) => {
+  return remap$(v, {
+    xAccountID: "X-Account-ID",
+  });
+});
+
+export function getTransferRiskOutcomesRequestToJSON(
+  getTransferRiskOutcomesRequest: GetTransferRiskOutcomesRequest,
+): string {
+  return JSON.stringify(
+    GetTransferRiskOutcomesRequest$outboundSchema.parse(
+      getTransferRiskOutcomesRequest,
+    ),
+  );
+}
+export function getTransferRiskOutcomesRequestFromJSON(
+  jsonString: string,
+): SafeParseResult<GetTransferRiskOutcomesRequest, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetTransferRiskOutcomesRequest$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetTransferRiskOutcomesRequest' from JSON`,
+  );
+}
+
+/** @internal */
+export const GetTransferRiskOutcomesResponse$inboundSchema: z.ZodType<
+  GetTransferRiskOutcomesResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  Headers: z.record(z.array(z.string())).default({}),
+  Result: components.PartnerRiskOutcomesResponse$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "Headers": "headers",
+    "Result": "result",
+  });
+});
+/** @internal */
+export type GetTransferRiskOutcomesResponse$Outbound = {
+  Headers: { [k: string]: Array<string> };
+  Result: components.PartnerRiskOutcomesResponse$Outbound;
+};
+
+/** @internal */
+export const GetTransferRiskOutcomesResponse$outboundSchema: z.ZodType<
+  GetTransferRiskOutcomesResponse$Outbound,
+  z.ZodTypeDef,
+  GetTransferRiskOutcomesResponse
+> = z.object({
+  headers: z.record(z.array(z.string())),
+  result: components.PartnerRiskOutcomesResponse$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    headers: "Headers",
+    result: "Result",
+  });
+});
+
+export function getTransferRiskOutcomesResponseToJSON(
+  getTransferRiskOutcomesResponse: GetTransferRiskOutcomesResponse,
+): string {
+  return JSON.stringify(
+    GetTransferRiskOutcomesResponse$outboundSchema.parse(
+      getTransferRiskOutcomesResponse,
+    ),
+  );
+}
+export function getTransferRiskOutcomesResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<GetTransferRiskOutcomesResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetTransferRiskOutcomesResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetTransferRiskOutcomesResponse' from JSON`,
+  );
+}

package/src/models/operations/index.ts

@@ -96,6 +96,7 @@ export * from "./gettermsofservicetoken.js";
 export * from "./getticket.js";
 export * from "./gettransfer.js";
 export * from "./gettransferconfig.js";
+export * from "./gettransferriskoutcomes.js";
 export * from "./getunderwriting.js";
 export * from "./getwallet.js";
 export * from "./getwallettransaction.js";

package/src/sdk/transfers.ts

@@ -10,6 +10,7 @@ import { transfersGenerateOptions } from "../funcs/transfersGenerateOptions.js";
 import { transfersGet } from "../funcs/transfersGet.js";
 import { transfersGetCancellation } from "../funcs/transfersGetCancellation.js";
 import { transfersGetRefund } from "../funcs/transfersGetRefund.js";
+import { transfersGetRiskOutcomes } from "../funcs/transfersGetRiskOutcomes.js";
 import { transfersInitiateRefund } from "../funcs/transfersInitiateRefund.js";
 import { transfersList } from "../funcs/transfersList.js";
 import { transfersListCancellations } from "../funcs/transfersListCancellations.js";
@@ -268,4 +269,23 @@ export class Transfers extends ClientSDK {
       options,
     ));
   }
+
+  /**
+   * Retrieve the risk rules that contributed to a transfer's risk decision.
+   *
+   * This endpoint has limited availability and must be enabled for your account by Moov.
+   *
+   * 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.
+   */
+  async getRiskOutcomes(
+    request: operations.GetTransferRiskOutcomesRequest,
+    options?: RequestOptions,
+  ): Promise<operations.GetTransferRiskOutcomesResponse> {
+    return unwrapAsync(transfersGetRiskOutcomes(
+      this,
+      request,
+      options,
+    ));
+  }
 }