mollie-api-typescript 0.2.8 → 0.3.0

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { balanceTransfersGet } from "../../funcs/balanceTransfersGet.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetConnectBalanceTransferRequest$inboundSchema,
+};
+
+export const tool$balanceTransfersGet: ToolDefinition<typeof args> = {
+  name: "balance-transfers-get",
+  description: `Get a Connect balance transfer
+
+Retrieve a single Connect balance transfer object by its ID.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await balanceTransfersGet(
+      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;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { balanceTransfersList } from "../../funcs/balanceTransfersList.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.ListConnectBalanceTransfersRequest$inboundSchema
+    .optional(),
+};
+
+export const tool$balanceTransfersList: ToolDefinition<typeof args> = {
+  name: "balance-transfers-list",
+  description: `List all Connect balance transfers
+
+Returns a paginated list of balance transfers associated with your organization. These may be a balance transfer that was received or sent from your balance, or a balance transfer that you initiated on behalf of your clients. If no balance transfers are available, the resulting array will be empty. This request should never throw an error.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await balanceTransfersList(
+      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;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/models/balancetransfercategory.ts

@@ -0,0 +1,47 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * The type of the transfer. Different fees may apply to different types of transfers.
+ */
+export const BalanceTransferCategory = {
+  InvoiceCollection: "invoice_collection",
+  Purchase: "purchase",
+  Chargeback: "chargeback",
+  Refund: "refund",
+  ServicePenalty: "service_penalty",
+  DiscountCompensation: "discount_compensation",
+  ManualCorrection: "manual_correction",
+  Fee: "fee",
+} as const;
+/**
+ * The type of the transfer. Different fees may apply to different types of transfers.
+ */
+export type BalanceTransferCategory = ClosedEnum<
+  typeof BalanceTransferCategory
+>;
+
+/** @internal */
+export const BalanceTransferCategory$inboundSchema: z.ZodNativeEnum<
+  typeof BalanceTransferCategory
+> = z.nativeEnum(BalanceTransferCategory);
+
+/** @internal */
+export const BalanceTransferCategory$outboundSchema: z.ZodNativeEnum<
+  typeof BalanceTransferCategory
+> = BalanceTransferCategory$inboundSchema;
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace BalanceTransferCategory$ {
+  /** @deprecated use `BalanceTransferCategory$inboundSchema` instead. */
+  export const inboundSchema = BalanceTransferCategory$inboundSchema;
+  /** @deprecated use `BalanceTransferCategory$outboundSchema` instead. */
+  export const outboundSchema = BalanceTransferCategory$outboundSchema;
+}

package/src/models/balancetransfercategoryresponse.ts

@@ -0,0 +1,62 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  catchUnrecognizedEnum,
+  OpenEnum,
+  Unrecognized,
+} from "../types/enums.js";
+
+/**
+ * The type of the transfer. Different fees may apply to different types of transfers.
+ */
+export const BalanceTransferCategoryResponse = {
+  InvoiceCollection: "invoice_collection",
+  Purchase: "purchase",
+  Chargeback: "chargeback",
+  Refund: "refund",
+  ServicePenalty: "service_penalty",
+  DiscountCompensation: "discount_compensation",
+  ManualCorrection: "manual_correction",
+  Fee: "fee",
+} as const;
+/**
+ * The type of the transfer. Different fees may apply to different types of transfers.
+ */
+export type BalanceTransferCategoryResponse = OpenEnum<
+  typeof BalanceTransferCategoryResponse
+>;
+
+/** @internal */
+export const BalanceTransferCategoryResponse$inboundSchema: z.ZodType<
+  BalanceTransferCategoryResponse,
+  z.ZodTypeDef,
+  unknown
+> = z
+  .union([
+    z.nativeEnum(BalanceTransferCategoryResponse),
+    z.string().transform(catchUnrecognizedEnum),
+  ]);
+
+/** @internal */
+export const BalanceTransferCategoryResponse$outboundSchema: z.ZodType<
+  BalanceTransferCategoryResponse,
+  z.ZodTypeDef,
+  BalanceTransferCategoryResponse
+> = z.union([
+  z.nativeEnum(BalanceTransferCategoryResponse),
+  z.string().and(z.custom<Unrecognized<string>>()),
+]);
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace BalanceTransferCategoryResponse$ {
+  /** @deprecated use `BalanceTransferCategoryResponse$inboundSchema` instead. */
+  export const inboundSchema = BalanceTransferCategoryResponse$inboundSchema;
+  /** @deprecated use `BalanceTransferCategoryResponse$outboundSchema` instead. */
+  export const outboundSchema = BalanceTransferCategoryResponse$outboundSchema;
+}

package/src/models/balancetransferpartytype.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * Defines the type of the party. At the moment, only `organization` is supported.
+ */
+export const BalanceTransferPartyType = {
+  Organization: "organization",
+} as const;
+/**
+ * Defines the type of the party. At the moment, only `organization` is supported.
+ */
+export type BalanceTransferPartyType = ClosedEnum<
+  typeof BalanceTransferPartyType
+>;
+
+/** @internal */
+export const BalanceTransferPartyType$inboundSchema: z.ZodNativeEnum<
+  typeof BalanceTransferPartyType
+> = z.nativeEnum(BalanceTransferPartyType);
+
+/** @internal */
+export const BalanceTransferPartyType$outboundSchema: z.ZodNativeEnum<
+  typeof BalanceTransferPartyType
+> = BalanceTransferPartyType$inboundSchema;
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace BalanceTransferPartyType$ {
+  /** @deprecated use `BalanceTransferPartyType$inboundSchema` instead. */
+  export const inboundSchema = BalanceTransferPartyType$inboundSchema;
+  /** @deprecated use `BalanceTransferPartyType$outboundSchema` instead. */
+  export const outboundSchema = BalanceTransferPartyType$outboundSchema;
+}

package/src/models/balancetransferpartytyperesponse.ts

@@ -0,0 +1,55 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  catchUnrecognizedEnum,
+  OpenEnum,
+  Unrecognized,
+} from "../types/enums.js";
+
+/**
+ * Defines the type of the party. At the moment, only `organization` is supported.
+ */
+export const BalanceTransferPartyTypeResponse = {
+  Organization: "organization",
+} as const;
+/**
+ * Defines the type of the party. At the moment, only `organization` is supported.
+ */
+export type BalanceTransferPartyTypeResponse = OpenEnum<
+  typeof BalanceTransferPartyTypeResponse
+>;
+
+/** @internal */
+export const BalanceTransferPartyTypeResponse$inboundSchema: z.ZodType<
+  BalanceTransferPartyTypeResponse,
+  z.ZodTypeDef,
+  unknown
+> = z
+  .union([
+    z.nativeEnum(BalanceTransferPartyTypeResponse),
+    z.string().transform(catchUnrecognizedEnum),
+  ]);
+
+/** @internal */
+export const BalanceTransferPartyTypeResponse$outboundSchema: z.ZodType<
+  BalanceTransferPartyTypeResponse,
+  z.ZodTypeDef,
+  BalanceTransferPartyTypeResponse
+> = z.union([
+  z.nativeEnum(BalanceTransferPartyTypeResponse),
+  z.string().and(z.custom<Unrecognized<string>>()),
+]);
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace BalanceTransferPartyTypeResponse$ {
+  /** @deprecated use `BalanceTransferPartyTypeResponse$inboundSchema` instead. */
+  export const inboundSchema = BalanceTransferPartyTypeResponse$inboundSchema;
+  /** @deprecated use `BalanceTransferPartyTypeResponse$outboundSchema` instead. */
+  export const outboundSchema = BalanceTransferPartyTypeResponse$outboundSchema;
+}

package/src/models/balancetransferstatus.ts

@@ -0,0 +1,55 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  catchUnrecognizedEnum,
+  OpenEnum,
+  Unrecognized,
+} from "../types/enums.js";
+
+/**
+ * The status of the transfer.
+ */
+export const BalanceTransferStatus = {
+  Created: "created",
+  Failed: "failed",
+  Succeeded: "succeeded",
+} as const;
+/**
+ * The status of the transfer.
+ */
+export type BalanceTransferStatus = OpenEnum<typeof BalanceTransferStatus>;
+
+/** @internal */
+export const BalanceTransferStatus$inboundSchema: z.ZodType<
+  BalanceTransferStatus,
+  z.ZodTypeDef,
+  unknown
+> = z
+  .union([
+    z.nativeEnum(BalanceTransferStatus),
+    z.string().transform(catchUnrecognizedEnum),
+  ]);
+
+/** @internal */
+export const BalanceTransferStatus$outboundSchema: z.ZodType<
+  BalanceTransferStatus,
+  z.ZodTypeDef,
+  BalanceTransferStatus
+> = z.union([
+  z.nativeEnum(BalanceTransferStatus),
+  z.string().and(z.custom<Unrecognized<string>>()),
+]);
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace BalanceTransferStatus$ {
+  /** @deprecated use `BalanceTransferStatus$inboundSchema` instead. */
+  export const inboundSchema = BalanceTransferStatus$inboundSchema;
+  /** @deprecated use `BalanceTransferStatus$outboundSchema` instead. */
+  export const outboundSchema = BalanceTransferStatus$outboundSchema;
+}

package/src/models/balancetransferstatusreasonresponse.ts

@@ -0,0 +1,65 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  catchUnrecognizedEnum,
+  OpenEnum,
+  Unrecognized,
+} from "../types/enums.js";
+
+/**
+ * A machine-readable code that indicates the reason for the transfer's status.
+ */
+export const BalanceTransferStatusReasonResponse = {
+  RequestCreated: "request_created",
+  Success: "success",
+  SourceNotAllowed: "source_not_allowed",
+  DestinationNotAllowed: "destination_not_allowed",
+  InsufficientFunds: "insufficient_funds",
+  InvalidSourceBalance: "invalid_source_balance",
+  InvalidDestinationBalance: "invalid_destination_balance",
+  TransferRequestExpired: "transfer_request_expired",
+  TransferLimitReached: "transfer_limit_reached",
+} as const;
+/**
+ * A machine-readable code that indicates the reason for the transfer's status.
+ */
+export type BalanceTransferStatusReasonResponse = OpenEnum<
+  typeof BalanceTransferStatusReasonResponse
+>;
+
+/** @internal */
+export const BalanceTransferStatusReasonResponse$inboundSchema: z.ZodType<
+  BalanceTransferStatusReasonResponse,
+  z.ZodTypeDef,
+  unknown
+> = z
+  .union([
+    z.nativeEnum(BalanceTransferStatusReasonResponse),
+    z.string().transform(catchUnrecognizedEnum),
+  ]);
+
+/** @internal */
+export const BalanceTransferStatusReasonResponse$outboundSchema: z.ZodType<
+  BalanceTransferStatusReasonResponse,
+  z.ZodTypeDef,
+  BalanceTransferStatusReasonResponse
+> = z.union([
+  z.nativeEnum(BalanceTransferStatusReasonResponse),
+  z.string().and(z.custom<Unrecognized<string>>()),
+]);
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace BalanceTransferStatusReasonResponse$ {
+  /** @deprecated use `BalanceTransferStatusReasonResponse$inboundSchema` instead. */
+  export const inboundSchema =
+    BalanceTransferStatusReasonResponse$inboundSchema;
+  /** @deprecated use `BalanceTransferStatusReasonResponse$outboundSchema` instead. */
+  export const outboundSchema =
+    BalanceTransferStatusReasonResponse$outboundSchema;
+}

package/src/models/createwebhook.ts

@@ -29,6 +29,10 @@ import {
  * An object with several relevant URLs. Every URL object will contain an `href` and a `type` field.
  */
 export type CreateWebhookLinks = {
+  /**
+   * In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
+   */
+  self: Url;
   /**
    * In v2 endpoints, URLs are commonly represented as objects with an `href` and `type` field.
    */
@@ -88,11 +92,13 @@ export const CreateWebhookLinks$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
+  self: Url$inboundSchema,
   documentation: Url$inboundSchema,
 });
 
 /** @internal */
 export type CreateWebhookLinks$Outbound = {
+  self: Url$Outbound;
   documentation: Url$Outbound;
 };
 
@@ -102,6 +108,7 @@ export const CreateWebhookLinks$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   CreateWebhookLinks
 > = z.object({
+  self: Url$outboundSchema,
   documentation: Url$outboundSchema,
 });
 

package/src/models/entitybalancetransfer.ts

@@ -0,0 +1,131 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import {
+  Amount,
+  Amount$inboundSchema,
+  Amount$Outbound,
+  Amount$outboundSchema,
+} from "./amount.js";
+import {
+  BalanceTransferCategory,
+  BalanceTransferCategory$inboundSchema,
+  BalanceTransferCategory$outboundSchema,
+} from "./balancetransfercategory.js";
+import {
+  EntityBalanceTransferParty,
+  EntityBalanceTransferParty$inboundSchema,
+  EntityBalanceTransferParty$Outbound,
+  EntityBalanceTransferParty$outboundSchema,
+} from "./entitybalancetransferparty.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+export type EntityBalanceTransfer = {
+  id: string;
+  /**
+   * In v2 endpoints, monetary amounts are represented as objects with a `currency` and `value` field.
+   */
+  amount: Amount;
+  /**
+   * A party involved in the balance transfer, either the sender or the receiver.
+   */
+  source: EntityBalanceTransferParty;
+  /**
+   * A party involved in the balance transfer, either the sender or the receiver.
+   */
+  destination: EntityBalanceTransferParty;
+  /**
+   * The transfer description for initiating party.
+   */
+  description: string;
+  /**
+   * The type of the transfer. Different fees may apply to different types of transfers.
+   */
+  category?: BalanceTransferCategory | undefined;
+  /**
+   * Whether to create the entity in test mode or live mode.
+   *
+   * @remarks
+   *
+   * Most API credentials are specifically created for either live mode or test mode, in which case this parameter can be
+   * omitted. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting
+   * `testmode` to `true`.
+   */
+  testmode?: boolean | null | undefined;
+};
+
+/** @internal */
+export const EntityBalanceTransfer$inboundSchema: z.ZodType<
+  EntityBalanceTransfer,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  amount: Amount$inboundSchema,
+  source: EntityBalanceTransferParty$inboundSchema,
+  destination: EntityBalanceTransferParty$inboundSchema,
+  description: z.string(),
+  category: BalanceTransferCategory$inboundSchema.optional(),
+  testmode: z.nullable(z.boolean()).optional(),
+});
+
+/** @internal */
+export type EntityBalanceTransfer$Outbound = {
+  id: string;
+  amount: Amount$Outbound;
+  source: EntityBalanceTransferParty$Outbound;
+  destination: EntityBalanceTransferParty$Outbound;
+  description: string;
+  category?: string | undefined;
+  testmode?: boolean | null | undefined;
+};
+
+/** @internal */
+export const EntityBalanceTransfer$outboundSchema: z.ZodType<
+  EntityBalanceTransfer$Outbound,
+  z.ZodTypeDef,
+  EntityBalanceTransfer
+> = z.object({
+  id: z.string(),
+  amount: Amount$outboundSchema,
+  source: EntityBalanceTransferParty$outboundSchema,
+  destination: EntityBalanceTransferParty$outboundSchema,
+  description: z.string(),
+  category: BalanceTransferCategory$outboundSchema.optional(),
+  testmode: z.nullable(z.boolean()).optional(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace EntityBalanceTransfer$ {
+  /** @deprecated use `EntityBalanceTransfer$inboundSchema` instead. */
+  export const inboundSchema = EntityBalanceTransfer$inboundSchema;
+  /** @deprecated use `EntityBalanceTransfer$outboundSchema` instead. */
+  export const outboundSchema = EntityBalanceTransfer$outboundSchema;
+  /** @deprecated use `EntityBalanceTransfer$Outbound` instead. */
+  export type Outbound = EntityBalanceTransfer$Outbound;
+}
+
+export function entityBalanceTransferToJSON(
+  entityBalanceTransfer: EntityBalanceTransfer,
+): string {
+  return JSON.stringify(
+    EntityBalanceTransfer$outboundSchema.parse(entityBalanceTransfer),
+  );
+}
+
+export function entityBalanceTransferFromJSON(
+  jsonString: string,
+): SafeParseResult<EntityBalanceTransfer, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => EntityBalanceTransfer$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'EntityBalanceTransfer' from JSON`,
+  );
+}

package/src/models/entitybalancetransferparty.ts

@@ -0,0 +1,88 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import {
+  BalanceTransferPartyType,
+  BalanceTransferPartyType$inboundSchema,
+  BalanceTransferPartyType$outboundSchema,
+} from "./balancetransferpartytype.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+/**
+ * A party involved in the balance transfer, either the sender or the receiver.
+ */
+export type EntityBalanceTransferParty = {
+  /**
+   * Defines the type of the party. At the moment, only `organization` is supported.
+   */
+  type: BalanceTransferPartyType;
+  id: string;
+  /**
+   * The transfer description for the transfer party. This is the description that will appear in the financial reports of the party.
+   */
+  description: string;
+};
+
+/** @internal */
+export const EntityBalanceTransferParty$inboundSchema: z.ZodType<
+  EntityBalanceTransferParty,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  type: BalanceTransferPartyType$inboundSchema,
+  id: z.string(),
+  description: z.string(),
+});
+
+/** @internal */
+export type EntityBalanceTransferParty$Outbound = {
+  type: string;
+  id: string;
+  description: string;
+};
+
+/** @internal */
+export const EntityBalanceTransferParty$outboundSchema: z.ZodType<
+  EntityBalanceTransferParty$Outbound,
+  z.ZodTypeDef,
+  EntityBalanceTransferParty
+> = z.object({
+  type: BalanceTransferPartyType$outboundSchema,
+  id: z.string(),
+  description: z.string(),
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace EntityBalanceTransferParty$ {
+  /** @deprecated use `EntityBalanceTransferParty$inboundSchema` instead. */
+  export const inboundSchema = EntityBalanceTransferParty$inboundSchema;
+  /** @deprecated use `EntityBalanceTransferParty$outboundSchema` instead. */
+  export const outboundSchema = EntityBalanceTransferParty$outboundSchema;
+  /** @deprecated use `EntityBalanceTransferParty$Outbound` instead. */
+  export type Outbound = EntityBalanceTransferParty$Outbound;
+}
+
+export function entityBalanceTransferPartyToJSON(
+  entityBalanceTransferParty: EntityBalanceTransferParty,
+): string {
+  return JSON.stringify(
+    EntityBalanceTransferParty$outboundSchema.parse(entityBalanceTransferParty),
+  );
+}
+
+export function entityBalanceTransferPartyFromJSON(
+  jsonString: string,
+): SafeParseResult<EntityBalanceTransferParty, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => EntityBalanceTransferParty$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'EntityBalanceTransferParty' from JSON`,
+  );
+}