mollie-api-typescript 1.3.2 → 1.3.4

package/src/funcs/webhookEventsGet.ts

@@ -32,6 +32,8 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Retrieve a single webhook event object by its event ID.
+ *
+ * If set, this operation will use either {@link Security.organizationAccessToken} or {@link Security.oAuth} from the global security.
  */
 export function webhookEventsGet(
   client: ClientCore,
@@ -112,7 +114,7 @@ async function $do(
   }));
 
   const securityInput = await extractSecurity(client._options.security);
-  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const requestSecurity = resolveGlobalSecurity(securityInput, [1, 2]);
 
   const context = {
     options: client._options,

package/src/funcs/webhooksCreate.ts

@@ -32,6 +32,8 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * A webhook must have a name, an url and a list of event types. You can also create webhooks in the webhooks settings section of the Dashboard.
+ *
+ * If set, this operation will use either {@link Security.organizationAccessToken} or {@link Security.oAuth} from the global security.
  */
 export function webhooksCreate(
   client: ClientCore,
@@ -104,7 +106,7 @@ async function $do(
   }));
 
   const securityInput = await extractSecurity(client._options.security);
-  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const requestSecurity = resolveGlobalSecurity(securityInput, [1, 2]);
 
   const context = {
     options: client._options,

package/src/funcs/webhooksDelete.ts

@@ -32,6 +32,8 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Delete a single webhook object by its webhook ID.
+ *
+ * If set, this operation will use either {@link Security.organizationAccessToken} or {@link Security.oAuth} from the global security.
  */
 export function webhooksDelete(
   client: ClientCore,
@@ -109,7 +111,7 @@ async function $do(
   }));
 
   const securityInput = await extractSecurity(client._options.security);
-  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const requestSecurity = resolveGlobalSecurity(securityInput, [1, 2]);
 
   const context = {
     options: client._options,

package/src/funcs/webhooksGet.ts

@@ -32,6 +32,8 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Retrieve a single webhook object by its ID.
+ *
+ * If set, this operation will use either {@link Security.organizationAccessToken} or {@link Security.oAuth} from the global security.
  */
 export function webhooksGet(
   client: ClientCore,
@@ -112,7 +114,7 @@ async function $do(
   }));
 
   const securityInput = await extractSecurity(client._options.security);
-  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const requestSecurity = resolveGlobalSecurity(securityInput, [1, 2]);
 
   const context = {
     options: client._options,

package/src/funcs/webhooksList.ts

@@ -39,6 +39,8 @@ import {
  *
  * @remarks
  * Returns a paginated list of your webhooks. If no webhook endpoints are available, the resulting array will be empty. This request should never throw an error.
+ *
+ * If set, this operation will use either {@link Security.organizationAccessToken} or {@link Security.oAuth} from the global security.
  */
 export function webhooksList(
   client: ClientCore,
@@ -128,7 +130,7 @@ async function $do(
   }));
 
   const securityInput = await extractSecurity(client._options.security);
-  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const requestSecurity = resolveGlobalSecurity(securityInput, [1, 2]);
 
   const context = {
     options: client._options,

package/src/funcs/webhooksTest.ts

@@ -32,6 +32,8 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Sends a test event to the webhook to verify the endpoint is working as expected.
+ *
+ * If set, this operation will use either {@link Security.organizationAccessToken} or {@link Security.oAuth} from the global security.
  */
 export function webhooksTest(
   client: ClientCore,
@@ -109,7 +111,7 @@ async function $do(
   }));
 
   const securityInput = await extractSecurity(client._options.security);
-  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const requestSecurity = resolveGlobalSecurity(securityInput, [1, 2]);
 
   const context = {
     options: client._options,

package/src/funcs/webhooksUpdate.ts

@@ -32,6 +32,8 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Updates the webhook. You may edit the name, url and the list of subscribed event types.
+ *
+ * If set, this operation will use either {@link Security.organizationAccessToken} or {@link Security.oAuth} from the global security.
  */
 export function webhooksUpdate(
   client: ClientCore,
@@ -109,7 +111,7 @@ async function $do(
   }));
 
   const securityInput = await extractSecurity(client._options.security);
-  const requestSecurity = resolveGlobalSecurity(securityInput);
+  const requestSecurity = resolveGlobalSecurity(securityInput, [1, 2]);
 
   const context = {
     options: client._options,

package/src/lib/config.ts

@@ -78,8 +78,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "1.3.2",
-  genVersion: "2.869.25",
+  sdkVersion: "1.3.4",
+  genVersion: "2.879.1",
   userAgent:
-    "speakeasy-sdk/typescript 1.3.2 2.869.25 1.0.0 mollie-api-typescript",
+    "speakeasy-sdk/typescript 1.3.4 2.879.1 1.0.0 mollie-api-typescript",
 } as const;

package/src/lib/security.ts

@@ -241,8 +241,9 @@ function applyBearer(
 
 export function resolveGlobalSecurity(
   security: Partial<models.Security> | null | undefined,
+  allowedFields?: number[],
 ): SecurityState | null {
-  return resolveSecurity(
+  let inputs: SecurityInput[][] = [
     [
       {
         fieldName: "Authorization",
@@ -265,7 +266,18 @@ export function resolveGlobalSecurity(
         value: security?.oAuth ?? env().CLIENT_O_AUTH,
       },
     ],
-  );
+  ];
+
+  if (allowedFields) {
+    inputs = allowedFields.map((i) => {
+      if (i < 0 || i >= inputs.length) {
+        throw new RangeError(`invalid allowedFields index ${i}`);
+      }
+      return inputs[i]!;
+    });
+  }
+
+  return resolveSecurity(...inputs);
 }
 
 export async function extractSecurity<

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

@@ -20,7 +20,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "1.3.2",
+    currentVersion: "1.3.4",
   },
 });
 

package/src/mcp-server/server.ts

@@ -105,6 +105,9 @@ import { tool$subscriptionsListPayments } from "./tools/subscriptionsListPayment
 import { tool$subscriptionsUpdate } from "./tools/subscriptionsUpdate.js";
 import { tool$terminalsGet } from "./tools/terminalsGet.js";
 import { tool$terminalsList } from "./tools/terminalsList.js";
+import { tool$transfersCreate } from "./tools/transfersCreate.js";
+import { tool$transfersGet } from "./tools/transfersGet.js";
+import { tool$verifyPayeesCreate } from "./tools/verifyPayeesCreate.js";
 import { tool$walletsRequestApplePaySession } from "./tools/walletsRequestApplePaySession.js";
 import { tool$webhookEventsGet } from "./tools/webhookEventsGet.js";
 import { tool$webhooksCreate } from "./tools/webhooksCreate.js";
@@ -127,7 +130,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Client",
-    version: "1.3.2",
+    version: "1.3.4",
   });
 
   const client = new ClientCore({
@@ -259,6 +262,9 @@ export function createMCPServer(deps: {
   tool(tool$salesInvoicesGet);
   tool(tool$salesInvoicesUpdate);
   tool(tool$salesInvoicesDelete);
+  tool(tool$transfersCreate);
+  tool(tool$transfersGet);
+  tool(tool$verifyPayeesCreate);
 
   return server;
 }

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

@@ -0,0 +1,61 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 973b197c2696
+ */
+
+import { transfersCreate } from "../../funcs/transfersCreate.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.CreateTransferRequest$inboundSchema,
+};
+
+export const tool$transfersCreate: ToolDefinition<typeof args> = {
+  name: "transfers-create",
+  description: `Create transfer
+
+> 🚧 Beta feature
+>
+> This feature is currently in beta testing, and the final specification may still change.
+
+Create a SEPA Credit Transfer from your Mollie Business Account.
+
+To initiate a transfer, you must provide the transfer scheme, the amount, the debtor IBAN (your Mollie Business
+Account IBAN), and the creditor (recipient) details.
+
+Each request must include an \`Idempotency-Key\` header to prevent duplicate transfers, and must be signed using the
+\`X-Client-Signature\` and \`X-Client-Signed-At\` headers.
+
+### Simulating transfer scenarios in test mode
+
+In test mode, you can simulate various transfer scenarios by adjusting the transfer amount. This allows you to
+mimic the typical status progression of a real-world transfer. Note that a transfer's progression will stop once
+it reaches a final status: \`blocked\`, \`failed\`, or \`processed\`.
+
+| Amount  | Scenario                                           | Webhook sequence                                                                                                                                                   |
+|---------|----------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------|
+| \`11.00\` | Transfer initiated, pending review by Mollie       | \`business-account-transfer.requested\` → \`business-account-transfer.initiated\` → \`business-account-transfer.pending-review\`                                         |
+| \`12.00\` | Transfer initiated, blocked by Mollie              | \`business-account-transfer.requested\` → \`business-account-transfer.initiated\` → \`business-account-transfer.pending-review\` → \`business-account-transfer.blocked\`   |
+| \`13.00\` | Transfer initiated, failed on scheme submission    | \`business-account-transfer.requested\` → \`business-account-transfer.initiated\` → \`business-account-transfer.failed\`                                                 |
+| Other   | Default: transfer is processed                     | \`business-account-transfer.requested\` → \`business-account-transfer.initiated\` → \`business-account-transfer.processed\`                                              |`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await transfersCreate(
+      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/transfersGet.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: dc03b8b6e094
+ */
+
+import { transfersGet } from "../../funcs/transfersGet.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.GetTransferRequest$inboundSchema,
+};
+
+export const tool$transfersGet: ToolDefinition<typeof args> = {
+  name: "transfers-get",
+  description: `Get transfer
+
+> 🚧 Beta feature
+>
+> This feature is currently in beta testing, and the final specification may still change.
+
+Retrieve a single transfer object by its transfer ID. This allows you to check the current status
+and details of a previously created transfer.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await transfersGet(
+      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/verifyPayeesCreate.ts

@@ -0,0 +1,59 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: b7a84eda5fc9
+ */
+
+import { verifyPayeesCreate } from "../../funcs/verifyPayeesCreate.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: operations.VerifyPayeeRequest$inboundSchema.optional(),
+};
+
+export const tool$verifyPayeesCreate: ToolDefinition<typeof args> = {
+  name: "verify-payees-create",
+  description: `Verify Payee
+
+> 🚧 Beta feature
+>
+> This feature is currently in beta testing, and the final specification may still change.
+
+Perform a Verification of Payee (VoP) check. This allows you to verify the account holder name against the
+records held by the receiving bank before initiating a transfer.
+
+The verification result indicates whether the provided name matches, closely matches, or does not match the
+name on file at the receiving bank. This helps prevent misdirected payments.
+
+### Simulating verification scenarios in test mode
+
+In test mode, you can simulate various verification outcomes by adjusting the creditor name in the
+\`creditorBankAccount.accountHolderName\` property. This allows you to test all possible Verification of Payee
+results without needing special properties. The names are case insensitive.
+
+| Account holder name                    | Scenario                                      | Verification result | Suggested name |
+|----------------------------------------|-----------------------------------------------|---------------------|----------------|
+| \`John Close Match\`                     | Name closely matches the bank records          | \`close-match\`       | \`John Match\`   |
+| \`John No Match\`                        | Name does not match the bank records           | \`no-match\`          | —              |
+| \`John Unavailable\`                     | Verification is not available                  | \`not-available\`     | —              |
+| Any other name                         | Default: name matches the bank records         | \`match\`             | —              |`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await verifyPayeesCreate(
+      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/accountnumberformat.ts

@@ -0,0 +1,27 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 37f5aec7abed
+ */
+
+import * as z from "zod/v3";
+import { ClosedEnum } from "../types/enums.js";
+
+/**
+ * The format of the account number.
+ */
+export const AccountNumberFormat = {
+  Iban: "iban",
+} as const;
+/**
+ * The format of the account number.
+ */
+export type AccountNumberFormat = ClosedEnum<typeof AccountNumberFormat>;
+
+/** @internal */
+export const AccountNumberFormat$inboundSchema: z.ZodNativeEnum<
+  typeof AccountNumberFormat
+> = z.nativeEnum(AccountNumberFormat);
+/** @internal */
+export const AccountNumberFormat$outboundSchema: z.ZodNativeEnum<
+  typeof AccountNumberFormat
+> = AccountNumberFormat$inboundSchema;

package/src/models/accountnumberformatresponse.ts

@@ -0,0 +1,34 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 490b5d1720ba
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * The format of the account number.
+ */
+export const AccountNumberFormatResponse = {
+  Iban: "iban",
+} as const;
+/**
+ * The format of the account number.
+ */
+export type AccountNumberFormatResponse = OpenEnum<
+  typeof AccountNumberFormatResponse
+>;
+
+/** @internal */
+export const AccountNumberFormatResponse$inboundSchema: z.ZodType<
+  AccountNumberFormatResponse,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(AccountNumberFormatResponse);
+/** @internal */
+export const AccountNumberFormatResponse$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  AccountNumberFormatResponse
+> = openEnums.outboundSchema(AccountNumberFormatResponse);

package/src/models/creditdebitindicator.ts

@@ -0,0 +1,33 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: d02b12646cee
+ */
+
+import * as z from "zod/v3";
+import * as openEnums from "../types/enums.js";
+import { OpenEnum } from "../types/enums.js";
+
+/**
+ * Indicates whether the transfer is a credit or debit transaction from the perspective of the account holder.
+ */
+export const CreditDebitIndicator = {
+  Credit: "credit",
+  Debit: "debit",
+} as const;
+/**
+ * Indicates whether the transfer is a credit or debit transaction from the perspective of the account holder.
+ */
+export type CreditDebitIndicator = OpenEnum<typeof CreditDebitIndicator>;
+
+/** @internal */
+export const CreditDebitIndicator$inboundSchema: z.ZodType<
+  CreditDebitIndicator,
+  z.ZodTypeDef,
+  unknown
+> = openEnums.inboundSchema(CreditDebitIndicator);
+/** @internal */
+export const CreditDebitIndicator$outboundSchema: z.ZodType<
+  string,
+  z.ZodTypeDef,
+  CreditDebitIndicator
+> = openEnums.outboundSchema(CreditDebitIndicator);

package/src/models/creditorbankaccount.ts

@@ -0,0 +1,77 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: a51965af674f
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import {
+  AccountNumberFormat,
+  AccountNumberFormat$inboundSchema,
+  AccountNumberFormat$outboundSchema,
+} from "./accountnumberformat.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+/**
+ * The bank account details of the creditor (recipient) for Verification of Payee.
+ */
+export type CreditorBankAccount = {
+  /**
+   * The full name of the creditor account holder to verify against bank records.
+   */
+  accountHolderName: string;
+  /**
+   * The format of the account number.
+   */
+  format: AccountNumberFormat;
+  /**
+   * The bank account details of the creditor.
+   */
+  accountNumber: string;
+};
+
+/** @internal */
+export const CreditorBankAccount$inboundSchema: z.ZodType<
+  CreditorBankAccount,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  accountHolderName: z.string(),
+  format: AccountNumberFormat$inboundSchema,
+  accountNumber: z.string(),
+});
+/** @internal */
+export type CreditorBankAccount$Outbound = {
+  accountHolderName: string;
+  format: string;
+  accountNumber: string;
+};
+
+/** @internal */
+export const CreditorBankAccount$outboundSchema: z.ZodType<
+  CreditorBankAccount$Outbound,
+  z.ZodTypeDef,
+  CreditorBankAccount
+> = z.object({
+  accountHolderName: z.string(),
+  format: AccountNumberFormat$outboundSchema,
+  accountNumber: z.string(),
+});
+
+export function creditorBankAccountToJSON(
+  creditorBankAccount: CreditorBankAccount,
+): string {
+  return JSON.stringify(
+    CreditorBankAccount$outboundSchema.parse(creditorBankAccount),
+  );
+}
+export function creditorBankAccountFromJSON(
+  jsonString: string,
+): SafeParseResult<CreditorBankAccount, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreditorBankAccount$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreditorBankAccount' from JSON`,
+  );
+}

package/src/models/creditorbankaccountresponse.ts

@@ -0,0 +1,79 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ * @generated-id: 65e8ad895881
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../lib/schemas.js";
+import { Result as SafeParseResult } from "../types/fp.js";
+import {
+  AccountNumberFormatResponse,
+  AccountNumberFormatResponse$inboundSchema,
+  AccountNumberFormatResponse$outboundSchema,
+} from "./accountnumberformatresponse.js";
+import { SDKValidationError } from "./errors/sdkvalidationerror.js";
+
+/**
+ * The bank account details of the creditor (recipient) for Verification of Payee.
+ */
+export type CreditorBankAccountResponse = {
+  /**
+   * The full name of the creditor account holder to verify against bank records.
+   */
+  accountHolderName: string;
+  /**
+   * The format of the account number.
+   */
+  format: AccountNumberFormatResponse;
+  /**
+   * The bank account details of the creditor.
+   */
+  accountNumber: string;
+};
+
+/** @internal */
+export const CreditorBankAccountResponse$inboundSchema: z.ZodType<
+  CreditorBankAccountResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  accountHolderName: z.string(),
+  format: AccountNumberFormatResponse$inboundSchema,
+  accountNumber: z.string(),
+});
+/** @internal */
+export type CreditorBankAccountResponse$Outbound = {
+  accountHolderName: string;
+  format: string;
+  accountNumber: string;
+};
+
+/** @internal */
+export const CreditorBankAccountResponse$outboundSchema: z.ZodType<
+  CreditorBankAccountResponse$Outbound,
+  z.ZodTypeDef,
+  CreditorBankAccountResponse
+> = z.object({
+  accountHolderName: z.string(),
+  format: AccountNumberFormatResponse$outboundSchema,
+  accountNumber: z.string(),
+});
+
+export function creditorBankAccountResponseToJSON(
+  creditorBankAccountResponse: CreditorBankAccountResponse,
+): string {
+  return JSON.stringify(
+    CreditorBankAccountResponse$outboundSchema.parse(
+      creditorBankAccountResponse,
+    ),
+  );
+}
+export function creditorBankAccountResponseFromJSON(
+  jsonString: string,
+): SafeParseResult<CreditorBankAccountResponse, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CreditorBankAccountResponse$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CreditorBankAccountResponse' from JSON`,
+  );
+}