@moovio/sdk 26.7.0 → 26.10.0-dev.1

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",
+    currentVersion: "26.10.0-dev.1",
   },
 });
 

package/src/mcp-server/server.ts

@@ -182,6 +182,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";
@@ -216,7 +217,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Moov",
-    version: "26.7.0",
+    version: "26.10.0-dev.1",
   });
 
   const client = new MoovCore({
@@ -388,6 +389,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/index.ts

@@ -144,6 +144,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";
@@ -371,6 +372,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/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

@@ -97,6 +97,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,
+    ));
+  }
 }