@moovio/sdk 26.4.0-dev.5 → 26.4.0-dev.7

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

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { invoicesCreateInvoicePayment } from "../../funcs/invoicesCreateInvoicePayment.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CreateInvoicePaymentRequest$inboundSchema,
+};
+
+export const tool$invoicesCreateInvoicePayment: ToolDefinition<typeof args> = {
+  name: "invoices-create-invoice-payment",
+  description:
+    `Creates a payment resource to represent that an invoice was paid outside of the Moov platform.
+If a payment link was created for the invoice, 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 invoicesCreateInvoicePayment(
+      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/invoicesListInvoicePayments.ts

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { invoicesListInvoicePayments } from "../../funcs/invoicesListInvoicePayments.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListInvoicePaymentsRequest$inboundSchema,
+};
+
+export const tool$invoicesListInvoicePayments: ToolDefinition<typeof args> = {
+  name: "invoices-list-invoice-payments",
+  description: `List all the payments made towards 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.read\` scope.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await invoicesListInvoicePayments(
+      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/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,87 @@
+/*
+ * 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 {
+  CreateInvoiceLineItems,
+  CreateInvoiceLineItems$inboundSchema,
+  CreateInvoiceLineItems$Outbound,
+  CreateInvoiceLineItems$outboundSchema,
+} from "./createinvoicelineitems.js";
+
+export type CreateInvoice = {
+  /**
+   * A unique identifier for a Moov resource. Supports UUID format (xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx) or typed format with base32-encoded UUID and type suffix (e.g., kuoaydiojf7uszaokc2ggnaaaa_xfer).
+   */
+  customerAccountID: string;
+  description?: string | undefined;
+  /**
+   * A collection of line items for an invoice.
+   */
+  lineItems: CreateInvoiceLineItems;
+  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().optional(),
+  lineItems: CreateInvoiceLineItems$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 | undefined;
+  lineItems: CreateInvoiceLineItems$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().optional(),
+  lineItems: CreateInvoiceLineItems$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/createinvoicelineitem.ts

@@ -0,0 +1,100 @@
+/*
+ * 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 {
+  CreateInvoiceLineItemOption,
+  CreateInvoiceLineItemOption$inboundSchema,
+  CreateInvoiceLineItemOption$Outbound,
+  CreateInvoiceLineItemOption$outboundSchema,
+} from "./createinvoicelineitemoption.js";
+
+/**
+ * Represents a single item in an invoice, including optional modifiers and quantity.
+ */
+export type CreateInvoiceLineItem = {
+  /**
+   * The name of the item.
+   */
+  name: string;
+  /**
+   * The base price of the item before applying option modifiers.
+   */
+  basePrice: AmountDecimal;
+  /**
+   * The quantity of this item.
+   */
+  quantity: number;
+  /**
+   *   Optional unique identifier associating the line item with a product.
+   *
+   * @remarks
+   *   This is for reporting or tracking purposes, and does not populate other details of the line item.
+   */
+  productID?: string | undefined;
+  /**
+   * Optional list of modifiers applied to this item (e.g., toppings, upgrades, customizations).
+   */
+  options?: Array<CreateInvoiceLineItemOption> | undefined;
+};
+
+/** @internal */
+export const CreateInvoiceLineItem$inboundSchema: z.ZodType<
+  CreateInvoiceLineItem,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string(),
+  basePrice: AmountDecimal$inboundSchema,
+  quantity: z.number().int(),
+  productID: z.string().optional(),
+  options: z.array(CreateInvoiceLineItemOption$inboundSchema).optional(),
+});
+/** @internal */
+export type CreateInvoiceLineItem$Outbound = {
+  name: string;
+  basePrice: AmountDecimal$Outbound;
+  quantity: number;
+  productID?: string | undefined;
+  options?: Array<CreateInvoiceLineItemOption$Outbound> | undefined;
+};
+
+/** @internal */
+export const CreateInvoiceLineItem$outboundSchema: z.ZodType<
+  CreateInvoiceLineItem$Outbound,
+  z.ZodTypeDef,
+  CreateInvoiceLineItem
+> = z.object({
+  name: z.string(),
+  basePrice: AmountDecimal$outboundSchema,
+  quantity: z.number().int(),
+  productID: z.string().optional(),
+  options: z.array(CreateInvoiceLineItemOption$outboundSchema).optional(),
+});
+
+export function createInvoiceLineItemToJSON(
+  createInvoiceLineItem: CreateInvoiceLineItem,
+): string {
+  return JSON.stringify(
+    CreateInvoiceLineItem$outboundSchema.parse(createInvoiceLineItem),
+  );
+}
+export function createInvoiceLineItemFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateInvoiceLineItem, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateInvoiceLineItem$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateInvoiceLineItem' from JSON`,
+  );
+}

package/src/models/components/createinvoicelineitemoption.ts

@@ -0,0 +1,86 @@
+/*
+ * 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";
+
+/**
+ * Represents a modifier or option applied to a line item.
+ */
+export type CreateInvoiceLineItemOption = {
+  /**
+   * The name of the option or modifier.
+   */
+  name: string;
+  /**
+   * The quantity of this option.
+   */
+  quantity: number;
+  /**
+   * Optional price modification applied by this option. Can be positive, negative, or zero.
+   */
+  priceModifier?: AmountDecimal | undefined;
+  /**
+   * Optional group identifier to categorize related options (e.g., 'toppings').
+   */
+  group?: string | undefined;
+};
+
+/** @internal */
+export const CreateInvoiceLineItemOption$inboundSchema: z.ZodType<
+  CreateInvoiceLineItemOption,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  name: z.string(),
+  quantity: z.number().int(),
+  priceModifier: AmountDecimal$inboundSchema.optional(),
+  group: z.string().optional(),
+});
+/** @internal */
+export type CreateInvoiceLineItemOption$Outbound = {
+  name: string;
+  quantity: number;
+  priceModifier?: AmountDecimal$Outbound | undefined;
+  group?: string | undefined;
+};
+
+/** @internal */
+export const CreateInvoiceLineItemOption$outboundSchema: z.ZodType<
+  CreateInvoiceLineItemOption$Outbound,
+  z.ZodTypeDef,
+  CreateInvoiceLineItemOption
+> = z.object({
+  name: z.string(),
+  quantity: z.number().int(),
+  priceModifier: AmountDecimal$outboundSchema.optional(),
+  group: z.string().optional(),
+});
+
+export function createInvoiceLineItemOptionToJSON(
+  createInvoiceLineItemOption: CreateInvoiceLineItemOption,
+): string {
+  return JSON.stringify(
+    CreateInvoiceLineItemOption$outboundSchema.parse(
+      createInvoiceLineItemOption,
+    ),
+  );
+}
+export function createInvoiceLineItemOptionFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateInvoiceLineItemOption, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateInvoiceLineItemOption$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateInvoiceLineItemOption' from JSON`,
+  );
+}

package/src/models/components/createinvoicelineitemoptionvalidationerror.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 { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  AmountDecimalValidationError,
+  AmountDecimalValidationError$inboundSchema,
+  AmountDecimalValidationError$Outbound,
+  AmountDecimalValidationError$outboundSchema,
+} from "./amountdecimalvalidationerror.js";
+
+export type CreateInvoiceLineItemOptionValidationError = {
+  name?: string | undefined;
+  group?: string | undefined;
+  priceModifier?: AmountDecimalValidationError | undefined;
+  quantity?: string | undefined;
+};
+
+/** @internal */
+export const CreateInvoiceLineItemOptionValidationError$inboundSchema:
+  z.ZodType<CreateInvoiceLineItemOptionValidationError, z.ZodTypeDef, unknown> =
+    z.object({
+      name: z.string().optional(),
+      group: z.string().optional(),
+      priceModifier: AmountDecimalValidationError$inboundSchema.optional(),
+      quantity: z.string().optional(),
+    });
+/** @internal */
+export type CreateInvoiceLineItemOptionValidationError$Outbound = {
+  name?: string | undefined;
+  group?: string | undefined;
+  priceModifier?: AmountDecimalValidationError$Outbound | undefined;
+  quantity?: string | undefined;
+};
+
+/** @internal */
+export const CreateInvoiceLineItemOptionValidationError$outboundSchema:
+  z.ZodType<
+    CreateInvoiceLineItemOptionValidationError$Outbound,
+    z.ZodTypeDef,
+    CreateInvoiceLineItemOptionValidationError
+  > = z.object({
+    name: z.string().optional(),
+    group: z.string().optional(),
+    priceModifier: AmountDecimalValidationError$outboundSchema.optional(),
+    quantity: z.string().optional(),
+  });
+
+export function createInvoiceLineItemOptionValidationErrorToJSON(
+  createInvoiceLineItemOptionValidationError:
+    CreateInvoiceLineItemOptionValidationError,
+): string {
+  return JSON.stringify(
+    CreateInvoiceLineItemOptionValidationError$outboundSchema.parse(
+      createInvoiceLineItemOptionValidationError,
+    ),
+  );
+}
+export function createInvoiceLineItemOptionValidationErrorFromJSON(
+  jsonString: string,
+): SafeParseResult<
+  CreateInvoiceLineItemOptionValidationError,
+  SDKValidationError
+> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      CreateInvoiceLineItemOptionValidationError$inboundSchema.parse(
+        JSON.parse(x),
+      ),
+    `Failed to parse 'CreateInvoiceLineItemOptionValidationError' from JSON`,
+  );
+}

package/src/models/components/createinvoicelineitems.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 {
+  CreateInvoiceLineItem,
+  CreateInvoiceLineItem$inboundSchema,
+  CreateInvoiceLineItem$Outbound,
+  CreateInvoiceLineItem$outboundSchema,
+} from "./createinvoicelineitem.js";
+
+/**
+ * A collection of line items for an invoice.
+ */
+export type CreateInvoiceLineItems = {
+  /**
+   * The list of line items.
+   */
+  items: Array<CreateInvoiceLineItem>;
+};
+
+/** @internal */
+export const CreateInvoiceLineItems$inboundSchema: z.ZodType<
+  CreateInvoiceLineItems,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  items: z.array(CreateInvoiceLineItem$inboundSchema),
+});
+/** @internal */
+export type CreateInvoiceLineItems$Outbound = {
+  items: Array<CreateInvoiceLineItem$Outbound>;
+};
+
+/** @internal */
+export const CreateInvoiceLineItems$outboundSchema: z.ZodType<
+  CreateInvoiceLineItems$Outbound,
+  z.ZodTypeDef,
+  CreateInvoiceLineItems
+> = z.object({
+  items: z.array(CreateInvoiceLineItem$outboundSchema),
+});
+
+export function createInvoiceLineItemsToJSON(
+  createInvoiceLineItems: CreateInvoiceLineItems,
+): string {
+  return JSON.stringify(
+    CreateInvoiceLineItems$outboundSchema.parse(createInvoiceLineItems),
+  );
+}
+export function createInvoiceLineItemsFromJSON(
+  jsonString: string,
+): SafeParseResult<CreateInvoiceLineItems, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreateInvoiceLineItems$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreateInvoiceLineItems' from JSON`,
+  );
+}