@moovio/sdk 0.21.14 → 0.21.16

package/src/funcs/invoicesUpdateInvoice.ts

@@ -0,0 +1,207 @@
+/*
+ * 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 * as errors from "../models/errors/index.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";
+
+/**
+ * Updates an invoice.
+ *
+ * To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/)
+ * you'll need to specify the `/accounts/{accountID}/invoices.write` scope.
+ */
+export function invoicesUpdateInvoice(
+  client: MoovCore,
+  request: operations.UpdateInvoiceRequest,
+  options?: RequestOptions,
+): APIPromise<
+  Result<
+    operations.UpdateInvoiceResponse,
+    | errors.GenericError
+    | errors.UpdateInvoiceError
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >
+> {
+  return new APIPromise($do(
+    client,
+    request,
+    options,
+  ));
+}
+
+async function $do(
+  client: MoovCore,
+  request: operations.UpdateInvoiceRequest,
+  options?: RequestOptions,
+): Promise<
+  [
+    Result<
+      operations.UpdateInvoiceResponse,
+      | errors.GenericError
+      | errors.UpdateInvoiceError
+      | MoovError
+      | ResponseValidationError
+      | ConnectionError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | InvalidRequestError
+      | UnexpectedClientError
+      | SDKValidationError
+    >,
+    APICall,
+  ]
+> {
+  const parsed = safeParse(
+    request,
+    (value) => operations.UpdateInvoiceRequest$outboundSchema.parse(value),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = encodeJSON("body", payload.UpdateInvoice, { explode: true });
+
+  const pathParams = {
+    accountID: encodeSimple("accountID", payload.accountID, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+    invoiceID: encodeSimple("invoiceID", payload.invoiceID, {
+      explode: false,
+      charEncoding: "percent",
+    }),
+  };
+
+  const path = pathToFunc("/accounts/{accountID}/invoices/{invoiceID}")(
+    pathParams,
+  );
+
+  const headers = new Headers(compactMap({
+    "Content-Type": "application/json",
+    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: "updateInvoice",
+    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: "PATCH",
+    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: [
+      "400",
+      "401",
+      "403",
+      "404",
+      "409",
+      "422",
+      "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.UpdateInvoiceResponse,
+    | errors.GenericError
+    | errors.UpdateInvoiceError
+    | MoovError
+    | ResponseValidationError
+    | ConnectionError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | InvalidRequestError
+    | UnexpectedClientError
+    | SDKValidationError
+  >(
+    M.json(200, operations.UpdateInvoiceResponse$inboundSchema, {
+      hdrs: true,
+      key: "Result",
+    }),
+    M.jsonErr([400, 409], errors.GenericError$inboundSchema, { hdrs: true }),
+    M.jsonErr(422, errors.UpdateInvoiceError$inboundSchema, { hdrs: true }),
+    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

@@ -73,7 +73,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "latest",
-  sdkVersion: "0.21.14",
-  genVersion: "2.755.9",
-  userAgent: "speakeasy-sdk/typescript 0.21.14 2.755.9 latest @moovio/sdk",
+  sdkVersion: "0.21.16",
+  genVersion: "2.760.2",
+  userAgent: "speakeasy-sdk/typescript 0.21.16 2.760.2 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.21.14",
+    currentVersion: "0.21.16",
   },
 });
 

package/src/mcp-server/server.ts

@@ -102,6 +102,11 @@ import { tool$imagesUpload } from "./tools/imagesUpload.js";
 import { tool$industriesList } from "./tools/industriesList.js";
 import { tool$institutionsSearch } from "./tools/institutionsSearch.js";
 import { tool$institutionsSearchInstitutions } from "./tools/institutionsSearchInstitutions.js";
+import { tool$invoicesCreateInvoice } from "./tools/invoicesCreateInvoice.js";
+import { tool$invoicesGetInvoice } from "./tools/invoicesGetInvoice.js";
+import { tool$invoicesListInvoices } from "./tools/invoicesListInvoices.js";
+import { tool$invoicesMarkPaidInvoice } from "./tools/invoicesMarkPaidInvoice.js";
+import { tool$invoicesUpdateInvoice } from "./tools/invoicesUpdateInvoice.js";
 import { tool$issuingTransactionsGet } from "./tools/issuingTransactionsGet.js";
 import { tool$issuingTransactionsGetAuthorization } from "./tools/issuingTransactionsGetAuthorization.js";
 import { tool$issuingTransactionsList } from "./tools/issuingTransactionsList.js";
@@ -188,7 +193,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Moov",
-    version: "0.21.14",
+    version: "0.21.16",
   });
 
   const client = new MoovCore({
@@ -289,6 +294,11 @@ export function createMCPServer(deps: {
   tool(tool$imagesDelete);
   tool(tool$imagesUpdateMetadata);
   tool(tool$imagesGetPublic);
+  tool(tool$invoicesCreateInvoice);
+  tool(tool$invoicesListInvoices);
+  tool(tool$invoicesGetInvoice);
+  tool(tool$invoicesUpdateInvoice);
+  tool(tool$invoicesMarkPaidInvoice);
   tool(tool$paymentLinksCreate);
   tool(tool$paymentLinksList);
   tool(tool$paymentLinksGet);

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

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { invoicesCreateInvoice } from "../../funcs/invoicesCreateInvoice.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CreateInvoiceRequest$inboundSchema,
+};
+
+export const tool$invoicesCreateInvoice: ToolDefinition<typeof args> = {
+  name: "invoices-create-invoice",
+  description: `Create an invoice for a Moov 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}/invoices.write\` scope.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await invoicesCreateInvoice(
+      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/invoicesGetInvoice.ts

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

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { invoicesListInvoices } from "../../funcs/invoicesListInvoices.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListInvoicesRequest$inboundSchema,
+};
+
+export const tool$invoicesListInvoices: ToolDefinition<typeof args> = {
+  name: "invoices-list-invoices",
+  description: `List all the invoices created under a Moov 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}/invoices.read\` scope.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await invoicesListInvoices(
+      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/invoicesMarkPaidInvoice.ts

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { invoicesMarkPaidInvoice } from "../../funcs/invoicesMarkPaidInvoice.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.MarkPaidInvoiceRequest$inboundSchema,
+};
+
+export const tool$invoicesMarkPaidInvoice: ToolDefinition<typeof args> = {
+  name: "invoices-mark-paid-invoice",
+  description: `Marks an invoice as paid outside of the Moov platform.
+If a payment link was created, the corresponding payment link is canceled, but a receipt is still sent.
+
+To access this endpoint using an [access token](https://docs.moov.io/api/authentication/access-tokens/) 
+you'll need to specify the \`/accounts/{accountID}/invoices.write\` scope.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await invoicesMarkPaidInvoice(
+      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/invoicesUpdateInvoice.ts

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

@@ -0,0 +1,65 @@
+/*
+ * 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";
+
+export type AmountDecimalUpdate = {
+  /**
+   * A 3-letter ISO 4217 currency code.
+   */
+  currency?: string | undefined;
+  /**
+   * A decimal-formatted numerical string that represents up to 9 decimal place precision.
+   *
+   * @remarks
+   *
+   * For example, $12.987654321 is '12.987654321'.
+   */
+  valueDecimal?: string | undefined;
+};
+
+/** @internal */
+export const AmountDecimalUpdate$inboundSchema: z.ZodType<
+  AmountDecimalUpdate,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  currency: z.string().optional(),
+  valueDecimal: z.string().optional(),
+});
+/** @internal */
+export type AmountDecimalUpdate$Outbound = {
+  currency?: string | undefined;
+  valueDecimal?: string | undefined;
+};
+
+/** @internal */
+export const AmountDecimalUpdate$outboundSchema: z.ZodType<
+  AmountDecimalUpdate$Outbound,
+  z.ZodTypeDef,
+  AmountDecimalUpdate
+> = z.object({
+  currency: z.string().optional(),
+  valueDecimal: z.string().optional(),
+});
+
+export function amountDecimalUpdateToJSON(
+  amountDecimalUpdate: AmountDecimalUpdate,
+): string {
+  return JSON.stringify(
+    AmountDecimalUpdate$outboundSchema.parse(amountDecimalUpdate),
+  );
+}
+export function amountDecimalUpdateFromJSON(
+  jsonString: string,
+): SafeParseResult<AmountDecimalUpdate, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => AmountDecimalUpdate$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'AmountDecimalUpdate' from JSON`,
+  );
+}

package/src/models/components/createinvoice.ts

@@ -0,0 +1,84 @@
+/*
+ * 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 {
+  AmountDecimal,
+  AmountDecimal$inboundSchema,
+  AmountDecimal$Outbound,
+  AmountDecimal$outboundSchema,
+} from "./amountdecimal.js";
+import {
+  InvoiceLineItems,
+  InvoiceLineItems$inboundSchema,
+  InvoiceLineItems$Outbound,
+  InvoiceLineItems$outboundSchema,
+} from "./invoicelineitems.js";
+
+export type CreateInvoice = {
+  customerAccountID: string;
+  description: string;
+  /**
+   * A collection of line items for an invoice.
+   */
+  lineItems: InvoiceLineItems;
+  invoiceDate?: Date | undefined;
+  dueDate?: Date | undefined;
+  taxAmount?: AmountDecimal | undefined;
+};
+
+/** @internal */
+export const CreateInvoice$inboundSchema: z.ZodType<
+  CreateInvoice,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  customerAccountID: z.string(),
+  description: z.string(),
+  lineItems: InvoiceLineItems$inboundSchema,
+  invoiceDate: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  dueDate: z.string().datetime({ offset: true }).transform(v => new Date(v))
+    .optional(),
+  taxAmount: AmountDecimal$inboundSchema.optional(),
+});
+/** @internal */
+export type CreateInvoice$Outbound = {
+  customerAccountID: string;
+  description: string;
+  lineItems: InvoiceLineItems$Outbound;
+  invoiceDate?: string | undefined;
+  dueDate?: string | undefined;
+  taxAmount?: AmountDecimal$Outbound | undefined;
+};
+
+/** @internal */
+export const CreateInvoice$outboundSchema: z.ZodType<
+  CreateInvoice$Outbound,
+  z.ZodTypeDef,
+  CreateInvoice
+> = z.object({
+  customerAccountID: z.string(),
+  description: z.string(),
+  lineItems: InvoiceLineItems$outboundSchema,
+  invoiceDate: z.date().transform(v => v.toISOString()).optional(),
+  dueDate: z.date().transform(v => v.toISOString()).optional(),
+  taxAmount: AmountDecimal$outboundSchema.optional(),
+});
+
+export function createInvoiceToJSON(createInvoice: CreateInvoice): string {
+  return JSON.stringify(CreateInvoice$outboundSchema.parse(createInvoice));
+}
+export function createInvoiceFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateInvoice, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateInvoice$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateInvoice' from JSON`,
+  );
+}

package/src/models/components/createpaymentlink.ts

@@ -12,6 +12,12 @@ import {
   Amount$Outbound,
   Amount$outboundSchema,
 } from "./amount.js";
+import {
+  CreatePaymentLinkLineItems,
+  CreatePaymentLinkLineItems$inboundSchema,
+  CreatePaymentLinkLineItems$Outbound,
+  CreatePaymentLinkLineItems$outboundSchema,
+} from "./createpaymentlinklineitems.js";
 import {
   PaymentLinkCustomerOptions,
   PaymentLinkCustomerOptions$inboundSchema,
@@ -24,12 +30,6 @@ import {
   PaymentLinkDisplayOptions$Outbound,
   PaymentLinkDisplayOptions$outboundSchema,
 } from "./paymentlinkdisplayoptions.js";
-import {
-  PaymentLinkLineItems,
-  PaymentLinkLineItems$inboundSchema,
-  PaymentLinkLineItems$Outbound,
-  PaymentLinkLineItems$outboundSchema,
-} from "./paymentlinklineitems.js";
 import {
   PaymentLinkPaymentDetails,
   PaymentLinkPaymentDetails$inboundSchema,
@@ -92,7 +92,7 @@ export type CreatePaymentLink = {
    * @remarks
    * When line items are provided, their total plus sales tax must equal the payment link amount.
    */
-  lineItems?: PaymentLinkLineItems | undefined;
+  lineItems?: CreatePaymentLinkLineItems | undefined;
 };
 
 /** @internal */
@@ -111,7 +111,7 @@ export const CreatePaymentLink$inboundSchema: z.ZodType<
   customer: PaymentLinkCustomerOptions$inboundSchema.optional(),
   payment: PaymentLinkPaymentDetails$inboundSchema.optional(),
   payout: PaymentLinkPayoutDetails$inboundSchema.optional(),
-  lineItems: PaymentLinkLineItems$inboundSchema.optional(),
+  lineItems: CreatePaymentLinkLineItems$inboundSchema.optional(),
 });
 /** @internal */
 export type CreatePaymentLink$Outbound = {
@@ -124,7 +124,7 @@ export type CreatePaymentLink$Outbound = {
   customer?: PaymentLinkCustomerOptions$Outbound | undefined;
   payment?: PaymentLinkPaymentDetails$Outbound | undefined;
   payout?: PaymentLinkPayoutDetails$Outbound | undefined;
-  lineItems?: PaymentLinkLineItems$Outbound | undefined;
+  lineItems?: CreatePaymentLinkLineItems$Outbound | undefined;
 };
 
 /** @internal */
@@ -142,7 +142,7 @@ export const CreatePaymentLink$outboundSchema: z.ZodType<
   customer: PaymentLinkCustomerOptions$outboundSchema.optional(),
   payment: PaymentLinkPaymentDetails$outboundSchema.optional(),
   payout: PaymentLinkPayoutDetails$outboundSchema.optional(),
-  lineItems: PaymentLinkLineItems$outboundSchema.optional(),
+  lineItems: CreatePaymentLinkLineItems$outboundSchema.optional(),
 });
 
 export function createPaymentLinkToJSON(