@moovio/sdk 0.6.0 → 0.6.1

package/src/funcs/transfersCreateCancellation.ts

@@ -0,0 +1,184 @@
+/*
+ * 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 { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.js";
+import * as errors from "../models/errors/index.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";
+
+/**
+ *   Initiate a cancellation for a card, ACH, or queued transfer.
+ *
+ *   To access this endpoint using a [token](https://docs.moov.io/api/authentication/access-tokens/) you'll need
+ *   to specify the `/accounts/{accountID}/transfers.write` scope.
+ */
+export function transfersCreateCancellation(
+  client: MoovCore,
+  request: operations.CreateCancellationRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.CreateCancellationResponse,
+    | errors.GenericError
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MoovCore,
+  request: operations.CreateCancellationRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.CreateCancellationResponse,
+      | errors.GenericError
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.CreateCancellationRequest$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",
+    }),
+    transferID: encodeSimple("transferID", payload.transferID, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc(
+    "/accounts/{accountID}/transfers/{transferID}/cancellations",
+  )(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 = {
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "createCancellation",
+    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: "POST",
+    baseURL: options?.serverURL,
+    path: path,
+    headers: headers,
+    body: body,
+    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: ["400", "401", "403", "404", "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.CreateCancellationResponse,
+    | errors.GenericError
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json([200, 202], operations.CreateCancellationResponse$inboundSchema, {
+      hdrs: true,
+      key: "Result",
+    }),
+    M.jsonErr(400, errors.GenericError$inboundSchema, { hdrs: true }),
+    M.fail([401, 403, 404, 429]),
+    M.fail([500, 504]),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/funcs/transfersGetCancellation.ts

@@ -0,0 +1,183 @@
+/*
+ * 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 { APIError } from "../models/errors/apierror.js";
+import {
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
+} from "../models/errors/httpclienterrors.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";
+
+/**
+ *   Get details of a cancellation for a transfer.
+ *
+ *   To access this endpoint using a [token](https://docs.moov.io/api/authentication/access-tokens/) you'll need
+ *   to specify the `/accounts/{accountID}/transfers.read` scope.
+ */
+export function transfersGetCancellation(
+  client: MoovCore,
+  request: operations.GetCancellationRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.GetCancellationResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MoovCore,
+  request: operations.GetCancellationRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.GetCancellationResponse,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.GetCancellationRequest$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",
+    }),
+    cancellationID: encodeSimple("cancellationID", payload.cancellationID, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    transferID: encodeSimple("transferID", payload.transferID, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc(
+    "/accounts/{accountID}/transfers/{transferID}/cancellations/{cancellationID}",
+  )(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 = {
+    baseURL: options?.serverURL ?? client._baseURL ?? "",
+    operationID: "getCancellation",
+    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,
+    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", "404", "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.GetCancellationResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(200, operations.GetCancellationResponse$inboundSchema, {
+      hdrs: true,
+      key: "Result",
+    }),
+    M.fail([401, 403, 404, 429]),
+    M.fail([500, 504]),
+    M.fail("4XX"),
+    M.fail("5XX"),
+  )(response, { extraFields: responseFields });
+  if (!result.ok) {
+    return [result, { status: "complete", request: req, response }];
+  }
+
+  return [result, { status: "complete", request: req, response }];
+}

package/src/lib/config.ts

@@ -69,7 +69,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "latest",
-  sdkVersion: "0.6.0",
-  genVersion: "2.539.0",
-  userAgent: "speakeasy-sdk/typescript 0.6.0 2.539.0 latest @moovio/sdk",
+  sdkVersion: "0.6.1",
+  genVersion: "2.539.1",
+  userAgent: "speakeasy-sdk/typescript 0.6.1 2.539.1 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.6.0",
+    currentVersion: "0.6.1",
   },
 });
 

package/src/mcp-server/server.ts

@@ -121,9 +121,11 @@ import { tool$terminalApplicationsDelete } from "./tools/terminalApplicationsDel
 import { tool$terminalApplicationsGet } from "./tools/terminalApplicationsGet.js";
 import { tool$terminalApplicationsList } from "./tools/terminalApplicationsList.js";
 import { tool$transfersCreate } from "./tools/transfersCreate.js";
+import { tool$transfersCreateCancellation } from "./tools/transfersCreateCancellation.js";
 import { tool$transfersCreateReversal } from "./tools/transfersCreateReversal.js";
 import { tool$transfersGenerateOptions } from "./tools/transfersGenerateOptions.js";
 import { tool$transfersGet } from "./tools/transfersGet.js";
+import { tool$transfersGetCancellation } from "./tools/transfersGetCancellation.js";
 import { tool$transfersGetRefund } from "./tools/transfersGetRefund.js";
 import { tool$transfersInitiateRefund } from "./tools/transfersInitiateRefund.js";
 import { tool$transfersList } from "./tools/transfersList.js";
@@ -147,7 +149,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Moov",
-    version: "0.6.0",
+    version: "0.6.1",
   });
 
   const client = new MoovCore({
@@ -254,6 +256,8 @@ export function createMCPServer(deps: {
   tool(tool$transfersList);
   tool(tool$transfersGet);
   tool(tool$transfersUpdate);
+  tool(tool$transfersCreateCancellation);
+  tool(tool$transfersGetCancellation);
   tool(tool$transfersInitiateRefund);
   tool(tool$transfersListRefunds);
   tool(tool$transfersGetRefund);

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

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { transfersCreateCancellation } from "../../funcs/transfersCreateCancellation.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CreateCancellationRequest$inboundSchema,
+};
+
+export const tool$transfersCreateCancellation: ToolDefinition<typeof args> = {
+  name: "transfers_create-cancellation",
+  description: `  Initiate a cancellation for a card, ACH, or queued transfer.
+  
+  To access this endpoint using a [token](https://docs.moov.io/api/authentication/access-tokens/) you'll need 
+  to specify the \`/accounts/{accountID}/transfers.write\` scope.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await transfersCreateCancellation(
+      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/transfersGetCancellation.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { transfersGetCancellation } from "../../funcs/transfersGetCancellation.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetCancellationRequest$inboundSchema,
+};
+
+export const tool$transfersGetCancellation: ToolDefinition<typeof args> = {
+  name: "transfers_get-cancellation",
+  description: `  Get details of a cancellation for a transfer.
+  
+  To access this endpoint using a [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 transfersGetCancellation(
+      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/transfer.ts

@@ -12,6 +12,12 @@ import {
   Amount$Outbound,
   Amount$outboundSchema,
 } from "./amount.js";
+import {
+  Cancellation,
+  Cancellation$inboundSchema,
+  Cancellation$Outbound,
+  Cancellation$outboundSchema,
+} from "./cancellation.js";
 import {
   CardAcquiringDispute,
   CardAcquiringDispute$inboundSchema,
@@ -102,6 +108,7 @@ export type Transfer = {
    */
   moovFeeDetails?: MoovFeeDetails | undefined;
   groupID?: string | undefined;
+  cancellations?: Array<Cancellation> | undefined;
   refundedAmount?: Amount | undefined;
   refunds?: Array<CardAcquiringRefund> | undefined;
   disputedAmount?: Amount | undefined;
@@ -133,6 +140,7 @@ export const Transfer$inboundSchema: z.ZodType<
   moovFeeDecimal: z.string().optional(),
   moovFeeDetails: MoovFeeDetails$inboundSchema.optional(),
   groupID: z.string().optional(),
+  cancellations: z.array(Cancellation$inboundSchema).optional(),
   refundedAmount: Amount$inboundSchema.optional(),
   refunds: z.array(CardAcquiringRefund$inboundSchema).optional(),
   disputedAmount: Amount$inboundSchema.optional(),
@@ -159,6 +167,7 @@ export type Transfer$Outbound = {
   moovFeeDecimal?: string | undefined;
   moovFeeDetails?: MoovFeeDetails$Outbound | undefined;
   groupID?: string | undefined;
+  cancellations?: Array<Cancellation$Outbound> | undefined;
   refundedAmount?: Amount$Outbound | undefined;
   refunds?: Array<CardAcquiringRefund$Outbound> | undefined;
   disputedAmount?: Amount$Outbound | undefined;
@@ -189,6 +198,7 @@ export const Transfer$outboundSchema: z.ZodType<
   moovFeeDecimal: z.string().optional(),
   moovFeeDetails: MoovFeeDetails$outboundSchema.optional(),
   groupID: z.string().optional(),
+  cancellations: z.array(Cancellation$outboundSchema).optional(),
   refundedAmount: Amount$outboundSchema.optional(),
   refunds: z.array(CardAcquiringRefund$outboundSchema).optional(),
   disputedAmount: Amount$outboundSchema.optional(),

package/src/models/errors/transfer.ts

@@ -48,6 +48,7 @@ export type TransferData = {
    */
   moovFeeDetails?: components.MoovFeeDetails | undefined;
   groupID?: string | undefined;
+  cancellations?: Array<components.Cancellation> | undefined;
   refundedAmount?: components.Amount | undefined;
   refunds?: Array<components.CardAcquiringRefund> | undefined;
   disputedAmount?: components.Amount | undefined;
@@ -100,6 +101,7 @@ export class Transfer extends Error {
    */
   moovFeeDetails?: components.MoovFeeDetails | undefined;
   groupID?: string | undefined;
+  cancellations?: Array<components.Cancellation> | undefined;
   refundedAmount?: components.Amount | undefined;
   refunds?: Array<components.CardAcquiringRefund> | undefined;
   disputedAmount?: components.Amount | undefined;
@@ -133,6 +135,7 @@ export class Transfer extends Error {
     if (err.moovFeeDecimal != null) this.moovFeeDecimal = err.moovFeeDecimal;
     if (err.moovFeeDetails != null) this.moovFeeDetails = err.moovFeeDetails;
     if (err.groupID != null) this.groupID = err.groupID;
+    if (err.cancellations != null) this.cancellations = err.cancellations;
     if (err.refundedAmount != null) this.refundedAmount = err.refundedAmount;
     if (err.refunds != null) this.refunds = err.refunds;
     if (err.disputedAmount != null) this.disputedAmount = err.disputedAmount;
@@ -167,6 +170,7 @@ export const Transfer$inboundSchema: z.ZodType<
   moovFeeDecimal: z.string().optional(),
   moovFeeDetails: components.MoovFeeDetails$inboundSchema.optional(),
   groupID: z.string().optional(),
+  cancellations: z.array(components.Cancellation$inboundSchema).optional(),
   refundedAmount: components.Amount$inboundSchema.optional(),
   refunds: z.array(components.CardAcquiringRefund$inboundSchema).optional(),
   disputedAmount: components.Amount$inboundSchema.optional(),
@@ -196,6 +200,7 @@ export type Transfer$Outbound = {
   moovFeeDecimal?: string | undefined;
   moovFeeDetails?: components.MoovFeeDetails$Outbound | undefined;
   groupID?: string | undefined;
+  cancellations?: Array<components.Cancellation$Outbound> | undefined;
   refundedAmount?: components.Amount$Outbound | undefined;
   refunds?: Array<components.CardAcquiringRefund$Outbound> | undefined;
   disputedAmount?: components.Amount$Outbound | undefined;
@@ -228,6 +233,7 @@ export const Transfer$outboundSchema: z.ZodType<
     moovFeeDecimal: z.string().optional(),
     moovFeeDetails: components.MoovFeeDetails$outboundSchema.optional(),
     groupID: z.string().optional(),
+    cancellations: z.array(components.Cancellation$outboundSchema).optional(),
     refundedAmount: components.Amount$outboundSchema.optional(),
     refunds: z.array(components.CardAcquiringRefund$outboundSchema).optional(),
     disputedAmount: components.Amount$outboundSchema.optional(),