@moovio/sdk 26.4.0-dev.10 → 26.4.0-dev.11

package/src/funcs/resolutionLinksList.ts

@@ -0,0 +1,180 @@
+/*
+ * 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 resolution links for the specified account.
+ *
+ * To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+ * you'll need to specify the `/accounts/{accountID}/profile.read` scope.
+ */
+export function resolutionLinksList(
+  client: MoovCore,
+  request: operations.ListResolutionLinksRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.ListResolutionLinksResponse,
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MoovCore,
+  request: operations.ListResolutionLinksRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.ListResolutionLinksResponse,
+      | MoovError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.ListResolutionLinksRequest$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}/resolution-links")(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: "listResolutionLinks",
+    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,
+    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.ListResolutionLinksResponse,
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.ListResolutionLinksResponse$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/hooks/moov-version-hook.ts

@@ -1,9 +1,13 @@
-import { SDK_METADATA, SDKOptions } from "../lib/config";
-import { SDKInitHook } from "./types";
+import { SDK_METADATA } from "../lib/config.js";
+import { BeforeRequestContext, BeforeRequestHook } from "./types.js";
 
-export class MoovVersionHook implements SDKInitHook {
-  sdkInit(opts: SDKOptions): SDKOptions {
-    opts.xMoovVersion = SDK_METADATA.openapiDocVersion;
-    return opts;
+export class MoovVersionHook implements BeforeRequestHook {
+  beforeRequest(
+    _hookCtx: BeforeRequestContext,
+    request: Request,
+  ): Request {
+    const newRequest = new Request(request);
+    newRequest.headers.set("X-Moov-Version", SDK_METADATA.openapiDocVersion);
+    return newRequest;
   }
 }

package/src/hooks/registration.ts

@@ -13,5 +13,5 @@ export function initHooks(hooks: Hooks) {
   // Hooks are registered per SDK instance, and are valid for the lifetime of the SDK instance
 
   const versionHook = new MoovVersionHook();
-  hooks.registerSDKInitHook(versionHook);
+  hooks.registerBeforeRequestHook(versionHook);
 }

package/src/lib/config.ts

@@ -73,8 +73,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "v2026.04.00",
-  sdkVersion: "26.4.0-dev.10",
-  genVersion: "2.856.1",
+  sdkVersion: "26.4.0-dev.11",
+  genVersion: "2.859.2",
   userAgent:
-    "speakeasy-sdk/typescript 26.4.0-dev.10 2.856.1 v2026.04.00 @moovio/sdk",
+    "speakeasy-sdk/typescript 26.4.0-dev.11 2.859.2 v2026.04.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.4.0-dev.10",
+    currentVersion: "26.4.0-dev.11",
   },
 });
 

package/src/mcp-server/server.ts

@@ -139,6 +139,10 @@ import { tool$representativesDelete } from "./tools/representativesDelete.js";
 import { tool$representativesGet } from "./tools/representativesGet.js";
 import { tool$representativesList } from "./tools/representativesList.js";
 import { tool$representativesUpdate } from "./tools/representativesUpdate.js";
+import { tool$resolutionLinksCreate } from "./tools/resolutionLinksCreate.js";
+import { tool$resolutionLinksDisable } from "./tools/resolutionLinksDisable.js";
+import { tool$resolutionLinksGet } from "./tools/resolutionLinksGet.js";
+import { tool$resolutionLinksList } from "./tools/resolutionLinksList.js";
 import { tool$schedulingCancel } from "./tools/schedulingCancel.js";
 import { tool$schedulingCreate } from "./tools/schedulingCreate.js";
 import { tool$schedulingGet } from "./tools/schedulingGet.js";
@@ -203,7 +207,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Moov",
-    version: "26.4.0-dev.10",
+    version: "26.4.0-dev.11",
   });
 
   const client = new MoovCore({
@@ -329,6 +333,10 @@ export function createMCPServer(deps: {
   tool(tool$representativesDelete);
   tool(tool$representativesGet);
   tool(tool$representativesUpdate);
+  tool(tool$resolutionLinksCreate);
+  tool(tool$resolutionLinksList);
+  tool(tool$resolutionLinksGet);
+  tool(tool$resolutionLinksDisable);
   tool(tool$schedulingCreate);
   tool(tool$schedulingList);
   tool(tool$schedulingUpdate);

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

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { resolutionLinksCreate } from "../../funcs/resolutionLinksCreate.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CreateResolutionLinkRequest$inboundSchema,
+};
+
+export const tool$resolutionLinksCreate: ToolDefinition<typeof args> = {
+  name: "resolution-links-create",
+  description:
+    `Create a resolution link for the specified account. Resolution links are temporary, secure links
+sent to merchants to resolve account requirements such as KYC verification or document uploads.  Only one active resolution link
+is allowed per connected account. 
+
+To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+you'll need to specify the \`/accounts/{accountID}/profile.write\`, \`/accounts/{accountID}/representatives.write\` and \`/accounts/{accountID}/files.write\` scopes.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await resolutionLinksCreate(
+      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/resolutionLinksDisable.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { resolutionLinksDisable } from "../../funcs/resolutionLinksDisable.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.DisableResolutionLinkRequest$inboundSchema,
+};
+
+export const tool$resolutionLinksDisable: ToolDefinition<typeof args> = {
+  name: "resolution-links-disable",
+  description:
+    `Disable a resolution link. Disabled resolution links can no longer be used by merchants.
+
+To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+you'll need to specify the \`/accounts/{accountID}/profile.write\` scope.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await resolutionLinksDisable(
+      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/resolutionLinksGet.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { resolutionLinksGet } from "../../funcs/resolutionLinksGet.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetResolutionLinkRequest$inboundSchema,
+};
+
+export const tool$resolutionLinksGet: ToolDefinition<typeof args> = {
+  name: "resolution-links-get",
+  description: `Get a resolution link by code.
+
+To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+you'll need to specify the \`/accounts/{accountID}/profile.read\` scope.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await resolutionLinksGet(
+      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/resolutionLinksList.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { resolutionLinksList } from "../../funcs/resolutionLinksList.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListResolutionLinksRequest$inboundSchema,
+};
+
+export const tool$resolutionLinksList: ToolDefinition<typeof args> = {
+  name: "resolution-links-list",
+  description: `List resolution links for the specified account.
+
+To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+you'll need to specify the \`/accounts/{accountID}/profile.read\` scope.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await resolutionLinksList(
+      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/createresolutionlink.ts

@@ -0,0 +1,63 @@
+/*
+ * 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";
+import {
+  ResolutionLinkRecipient,
+  ResolutionLinkRecipient$inboundSchema,
+  ResolutionLinkRecipient$Outbound,
+  ResolutionLinkRecipient$outboundSchema,
+} from "./resolutionlinkrecipient.js";
+
+/**
+ * Request body for creating a resolution link.
+ */
+export type CreateResolutionLink = {
+  /**
+   * The recipient contact information for the resolution link.
+   */
+  recipient: ResolutionLinkRecipient;
+};
+
+/** @internal */
+export const CreateResolutionLink$inboundSchema: z.ZodType<
+  CreateResolutionLink,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  recipient: ResolutionLinkRecipient$inboundSchema,
+});
+/** @internal */
+export type CreateResolutionLink$Outbound = {
+  recipient: ResolutionLinkRecipient$Outbound;
+};
+
+/** @internal */
+export const CreateResolutionLink$outboundSchema: z.ZodType<
+  CreateResolutionLink$Outbound,
+  z.ZodTypeDef,
+  CreateResolutionLink
+> = z.object({
+  recipient: ResolutionLinkRecipient$outboundSchema,
+});
+
+export function createResolutionLinkToJSON(
+  createResolutionLink: CreateResolutionLink,
+): string {
+  return JSON.stringify(
+    CreateResolutionLink$outboundSchema.parse(createResolutionLink),
+  );
+}
+export function createResolutionLinkFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateResolutionLink, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateResolutionLink$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateResolutionLink' from JSON`,
+  );
+}

package/src/models/components/index.ts

@@ -174,6 +174,7 @@ export * from "./createprofileerror.js";
 export * from "./createrefund.js";
 export * from "./createrefundresponse.js";
 export * from "./createrepresentative.js";
+export * from "./createresolutionlink.js";
 export * from "./createreversal.js";
 export * from "./createruntransfer.js";
 export * from "./createscheduledtransferlineitem.js";
@@ -415,6 +416,8 @@ export * from "./requirementerror.js";
 export * from "./requirementerrorcode.js";
 export * from "./requirementid.js";
 export * from "./residual.js";
+export * from "./resolutionlink.js";
+export * from "./resolutionlinkrecipient.js";
 export * from "./returnpolicytype.js";
 export * from "./reversal.js";
 export * from "./reversedwithcancellation.js";

package/src/models/components/resolutionlink.ts

@@ -0,0 +1,110 @@
+/*
+ * 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";
+
+/**
+ * A temporary, secure link sent to a merchant to resolve account requirements such as KYC verification or document uploads.
+ */
+export type ResolutionLink = {
+  /**
+   * A unique nanoid identifier for the resolution link.
+   */
+  code: string;
+  /**
+   * The ID of the merchant account this resolution link is associated with.
+   */
+  accountID: string;
+  /**
+   * The ID of the partner account this resolution link is associated with.
+   */
+  partnerAccountID: string;
+  /**
+   * The recipient contact information for the resolution link.
+   */
+  recipient: string;
+  /**
+   * The URL of the resolution link.
+   */
+  url: string;
+  /**
+   * The date and time the resolution link was created.
+   */
+  createdOn: Date;
+  /**
+   * The date and time the resolution link was last updated.
+   */
+  updatedOn: Date;
+  /**
+   * The date and time the resolution link was disabled, if applicable.
+   */
+  disabledOn?: Date | undefined;
+  /**
+   * The date and time the resolution link expires.
+   */
+  expiresOn: Date;
+};
+
+/** @internal */
+export const ResolutionLink$inboundSchema: z.ZodType<
+  ResolutionLink,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  code: z.string(),
+  accountID: z.string(),
+  partnerAccountID: z.string(),
+  recipient: z.string(),
+  url: z.string(),
+  createdOn: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  updatedOn: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  disabledOn: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  expiresOn: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+});
+/** @internal */
+export type ResolutionLink$Outbound = {
+  code: string;
+  accountID: string;
+  partnerAccountID: string;
+  recipient: string;
+  url: string;
+  createdOn: string;
+  updatedOn: string;
+  disabledOn?: string | undefined;
+  expiresOn: string;
+};
+
+/** @internal */
+export const ResolutionLink$outboundSchema: z.ZodType<
+  ResolutionLink$Outbound,
+  z.ZodTypeDef,
+  ResolutionLink
+> = z.object({
+  code: z.string(),
+  accountID: z.string(),
+  partnerAccountID: z.string(),
+  recipient: z.string(),
+  url: z.string(),
+  createdOn: z.date().transform(v => v.toISOString()),
+  updatedOn: z.date().transform(v => v.toISOString()),
+  disabledOn: z.date().transform(v => v.toISOString()).optional(),
+  expiresOn: z.date().transform(v => v.toISOString()),
+});
+
+export function resolutionLinkToJSON(resolutionLink: ResolutionLink): string {
+  return JSON.stringify(ResolutionLink$outboundSchema.parse(resolutionLink));
+}
+export function resolutionLinkFromJSON(
+  jsonString: string,
+): SafeParseResult<ResolutionLink, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ResolutionLink$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ResolutionLink' from JSON`,
+  );
+}

package/src/models/components/resolutionlinkrecipient.ts

@@ -0,0 +1,70 @@
+/*
+ * 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";
+import {
+  PhoneNumber,
+  PhoneNumber$inboundSchema,
+  PhoneNumber$Outbound,
+  PhoneNumber$outboundSchema,
+} from "./phonenumber.js";
+
+/**
+ * Contact information for the recipient of a resolution link. Provide either `email` or `phone`, but not both.
+ */
+export type ResolutionLinkRecipient = {
+  /**
+   * The email address of the recipient.
+   */
+  email?: string | undefined;
+  /**
+   * The phone number of the recipient.
+   */
+  phone?: PhoneNumber | undefined;
+};
+
+/** @internal */
+export const ResolutionLinkRecipient$inboundSchema: z.ZodType<
+  ResolutionLinkRecipient,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  email: z.string().optional(),
+  phone: PhoneNumber$inboundSchema.optional(),
+});
+/** @internal */
+export type ResolutionLinkRecipient$Outbound = {
+  email?: string | undefined;
+  phone?: PhoneNumber$Outbound | undefined;
+};
+
+/** @internal */
+export const ResolutionLinkRecipient$outboundSchema: z.ZodType<
+  ResolutionLinkRecipient$Outbound,
+  z.ZodTypeDef,
+  ResolutionLinkRecipient
+> = z.object({
+  email: z.string().optional(),
+  phone: PhoneNumber$outboundSchema.optional(),
+});
+
+export function resolutionLinkRecipientToJSON(
+  resolutionLinkRecipient: ResolutionLinkRecipient,
+): string {
+  return JSON.stringify(
+    ResolutionLinkRecipient$outboundSchema.parse(resolutionLinkRecipient),
+  );
+}
+export function resolutionLinkRecipientFromJSON(
+  jsonString: string,
+): SafeParseResult<ResolutionLinkRecipient, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ResolutionLinkRecipient$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ResolutionLinkRecipient' from JSON`,
+  );
+}