mollie-api-typescript 0.6.2 → 0.8.0

package/src/funcs/subscriptionsListPayments.ts

@@ -109,9 +109,9 @@ async function $do(
   const query = encodeFormQuery({
     "from": payload.from,
     "limit": payload.limit,
-    "profileId": payload.profileId,
+    "profileId": payload.profileId ?? client._options.profileId,
     "sort": payload.sort,
-    "testmode": payload.testmode,
+    "testmode": payload.testmode ?? client._options.testmode,
   });
 
   const headers = new Headers(compactMap({

package/src/funcs/terminalsGet.ts

@@ -99,7 +99,7 @@ async function $do(
   const path = pathToFunc("/terminals/{terminalId}")(pathParams);
 
   const query = encodeFormQuery({
-    "testmode": payload.testmode,
+    "testmode": payload.testmode ?? client._options.testmode,
   });
 
   const headers = new Headers(compactMap({

package/src/funcs/terminalsList.ts

@@ -97,7 +97,7 @@ async function $do(
     "from": payload?.from,
     "limit": payload?.limit,
     "sort": payload?.sort,
-    "testmode": payload?.testmode,
+    "testmode": payload?.testmode ?? client._options.testmode,
   });
 
   const headers = new Headers(compactMap({

package/src/funcs/webhookEventsGet.ts

@@ -99,7 +99,7 @@ async function $do(
   const path = pathToFunc("/events/{id}")(pathParams);
 
   const query = encodeFormQuery({
-    "testmode": payload.testmode,
+    "testmode": payload.testmode ?? client._options.testmode,
   });
 
   const headers = new Headers(compactMap({

package/src/funcs/webhooksGet.ts

@@ -99,7 +99,7 @@ async function $do(
   const path = pathToFunc("/webhooks/{id}")(pathParams);
 
   const query = encodeFormQuery({
-    "testmode": payload.testmode,
+    "testmode": payload.testmode ?? client._options.testmode,
   });
 
   const headers = new Headers(compactMap({

package/src/funcs/webhooksList.ts

@@ -96,7 +96,7 @@ async function $do(
     "from": payload?.from,
     "limit": payload?.limit,
     "sort": payload?.sort,
-    "testmode": payload?.testmode,
+    "testmode": payload?.testmode ?? client._options.testmode,
   });
 
   const headers = new Headers(compactMap({

package/src/hooks/mollie-hooks.ts

@@ -1,23 +1,157 @@
 import { RequestInput } from "../lib/http.js";
 import { BeforeCreateRequestHook, HookContext } from "./types.js";
+import { SDK_METADATA } from "../lib/config.js";
 
 export class MollieHooks implements BeforeCreateRequestHook {
-    beforeCreateRequest(_: HookContext, input: RequestInput): RequestInput {
-        const idempotencyKey = "Idempotency-Key";
-
+    beforeCreateRequest(hookContext: HookContext, input: RequestInput): RequestInput {
         // Always normalize to Headers
-        const headers = new Headers(input.options?.headers);
+        let headers = new Headers(input.options?.headers);
+
+        // Handle Idempotency-Key
+        headers = this.handleIdempotencyKey(headers);
+
+        // Customize Customize the User Agent header
+        headers = this.customizeUserAgent(headers, hookContext);
+
+        input = {
+            ...input,
+            options: {
+                ...input.options,
+                headers,
+            },
+        };
+
+        // Populate the profileID and testmode if OAuth (this may update headers again)
+        if (this.isOAuthRequest(headers, hookContext)) {
+            input = this.populateProfileIdAndTestmode(input, hookContext);
+        }
+
+        return input;
+    }
+
+    private isOAuthRequest(headers: Headers, hookContext: HookContext): boolean {
+        const security = hookContext.options.security;
+
+        if (typeof security === "function") {
+            return false;
+        }
+
+        if (security === null) {
+            return false;
+        }
+
+        const oAuth = security?.oAuth;
+        if (!oAuth) {
+            return false;
+        }
+
+        return headers.get("Authorization") === `Bearer ${oAuth}`;
+    }
+
+    private handleIdempotencyKey(headers: Headers): Headers {
+        const idempotencyKey = "Idempotency-Key";
 
         // Only add if missing or empty
         if (!headers.has(idempotencyKey) || !headers.get(idempotencyKey)) {
             headers.set(idempotencyKey, this.generateIdempotencyKey());
         }
 
+        return headers;
+    }
+
+    private customizeUserAgent(headers: Headers, hookContext: HookContext): Headers {
+        const userAgentKey = "User-Agent";
+
+        const customUserAgent = hookContext.options.customUserAgent;
+
+        const genVersion = SDK_METADATA.genVersion;
+        const sdkVersion = SDK_METADATA.sdkVersion;
+        const nodeVersion = typeof process !== "undefined" && process.version ? process.version : "unknown";
+        const packageName = SDK_METADATA.userAgent.split(" ").at(-1);
+
+        let mollieUserAgent = `Speakeasy/${genVersion} TypeScript/${nodeVersion} ${packageName}/${sdkVersion}`;
+        if (customUserAgent) {
+            mollieUserAgent = `${mollieUserAgent} ${customUserAgent}`;
+        }
+
+        console.log("Setting User-Agent to:", mollieUserAgent);
+
+        headers.set(userAgentKey, mollieUserAgent);
+        return headers;
+    }
+
+    private populateProfileIdAndTestmode(input: RequestInput, hookContext: HookContext): RequestInput {
+        const clientProfileId = hookContext.options.profileId;
+        const clientTestmode = hookContext.options.testmode;
+
+        const method = input.options?.method || "GET";
+
+        if (method === "GET") {
+            // Update the query parameters. If testmode or profileId are not present, add them.
+            const url = new URL(input.url);
+            
+            // Add profileId if not already present
+            if (clientProfileId !== undefined && !url.searchParams.has('profileId')) {
+                url.searchParams.set('profileId', clientProfileId);
+            }
+            
+            // Add testmode if not already present
+            if (clientTestmode !== undefined && !url.searchParams.has('testmode')) {
+                url.searchParams.set('testmode', String(clientTestmode));
+            }
+            
+            return {
+                ...input,
+                url,
+            };
+        }
+
+        // It's POST, DELETE, PATCH
+        // Update the JSON body. If testmode or profileId are not present, add them.
+        let body: any = {};
+        
+        if (input.options?.body) {
+            try {
+                // Parse the existing body if it's a string
+                if (typeof input.options.body === 'string') {
+                    body = JSON.parse(input.options.body);
+                } else if (input.options.body instanceof ArrayBuffer || input.options.body instanceof Uint8Array) {
+                    const decoder = new TextDecoder();
+                    const text = decoder.decode(input.options.body);
+                    body = JSON.parse(text);
+                } else {
+                    // If it's already an object, use it
+                    body = input.options.body;
+                }
+            } catch (error) {
+                // If it's not JSON, return the request unchanged
+                return input;
+            }
+        }
+        
+        // Add profileId if not already present
+        if (clientProfileId !== undefined && !('profileId' in body)) {
+            body.profileId = clientProfileId;
+        }
+        
+        // Add testmode if not already present
+        if (clientTestmode !== undefined && !('testmode' in body)) {
+            body.testmode = clientTestmode;
+        }
+        
+        // Create a new request with updated body
+        const newContent = JSON.stringify(body);
+        
+        // Ensure headers is a Headers object
+        const headers = new Headers(input.options?.headers);
+        headers.set('Content-Length', String(new TextEncoder().encode(newContent).length));
+        
         return {
             ...input,
             options: {
                 ...input.options,
                 headers,
+                body: newContent,
             },
         };
     }

package/src/lib/config.ts

@@ -21,6 +21,21 @@ export type SDKOptions = {
    */
   security?: models.Security | (() => Promise<models.Security>) | undefined;
 
+  /**
+   * Allows setting the profileId parameter for all supported operations
+   */
+  profileId?: string | undefined;
+
+  /**
+   * Allows setting the testmode parameter for all supported operations
+   */
+  testmode?: boolean | undefined;
+
+  /**
+   * Allows setting the customUserAgent parameter for all supported operations
+   */
+  customUserAgent?: string | undefined;
+
   httpClient?: HTTPClient;
   /**
    * Allows overriding the default server used by the SDK
@@ -62,8 +77,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "1.0.0",
-  sdkVersion: "0.6.2",
-  genVersion: "2.730.5",
+  sdkVersion: "0.8.0",
+  genVersion: "2.737.0",
   userAgent:
-    "speakeasy-sdk/typescript 0.6.2 2.730.5 1.0.0 mollie-api-typescript",
+    "speakeasy-sdk/typescript 0.8.0 2.737.0 1.0.0 mollie-api-typescript",
 } as const;

package/src/lib/env.ts

@@ -3,12 +3,28 @@
  */
 
 import * as z from "zod/v3";
+import { SDKOptions } from "./config.js";
 import { dlv } from "./dlv.js";
 
 export interface Env {
   CLIENT_API_KEY?: string | undefined;
   CLIENT_O_AUTH?: string | undefined;
 
+  /**
+   * Sets the profileId parameter for all supported operations
+   */
+  CLIENT_PROFILE_ID?: string | undefined;
+
+  /**
+   * Sets the testmode parameter for all supported operations
+   */
+  CLIENT_TESTMODE?: boolean | undefined;
+
+  /**
+   * Sets the customUserAgent parameter for all supported operations
+   */
+  CLIENT_CUSTOM_USER_AGENT?: string | undefined;
+
   CLIENT_DEBUG?: boolean | undefined;
 }
 
@@ -16,6 +32,11 @@ export const envSchema: z.ZodType<Env, z.ZodTypeDef, unknown> = z.object({
   CLIENT_API_KEY: z.string().optional(),
   CLIENT_O_AUTH: z.string().optional(),
 
+  CLIENT_PROFILE_ID: z.string().optional(),
+  CLIENT_TESTMODE: z.enum(["true", "false"]).transform(v => v === "true")
+    .optional(),
+  CLIENT_CUSTOM_USER_AGENT: z.string().optional(),
+
   CLIENT_DEBUG: z.coerce.boolean().optional(),
 });
 
@@ -57,3 +78,24 @@ export function env(): Env {
 export function resetEnv() {
   envMemo = undefined;
 }
+
+/**
+ * Populates global parameters with environment variables.
+ */
+export function fillGlobals(options: SDKOptions): SDKOptions {
+  const clone = { ...options };
+
+  const envVars = env();
+
+  if (typeof envVars.CLIENT_PROFILE_ID !== "undefined") {
+    clone.profileId ??= envVars.CLIENT_PROFILE_ID;
+  }
+  if (typeof envVars.CLIENT_TESTMODE !== "undefined") {
+    clone.testmode ??= envVars.CLIENT_TESTMODE;
+  }
+  if (typeof envVars.CLIENT_CUSTOM_USER_AGENT !== "undefined") {
+    clone.customUserAgent ??= envVars.CLIENT_CUSTOM_USER_AGENT;
+  }
+
+  return clone;
+}

package/src/lib/sdks.ts

@@ -15,7 +15,7 @@ import { ERR, OK, Result } from "../types/fp.js";
 import { stringToBase64 } from "./base64.js";
 import { SDK_METADATA, SDKOptions, serverURLFromOptions } from "./config.js";
 import { encodeForm } from "./encodings.js";
-import { env } from "./env.js";
+import { env, fillGlobals } from "./env.js";
 import {
   HTTPClient,
   isAbortError,
@@ -108,7 +108,7 @@ export class ClientSDK {
     this._baseURL = url;
     this.#httpClient = options.httpClient || defaultHttpClient;
 
-    this._options = { ...options, hooks: this.#hooks };
+    this._options = { ...fillGlobals(options), hooks: this.#hooks };
 
     this.#logger = this._options.debugLogger;
     if (!this.#logger && env().CLIENT_DEBUG) {

package/src/mcp-server/cli/start/command.ts

@@ -51,6 +51,35 @@ export const startCommand = buildCommand({
           return z.string().parse(value);
         },
       },
+      "profile-id": {
+        kind: "parsed",
+        brief:
+          "Allows setting the profileId parameter for all supported operations",
+        optional: true,
+        parse: (value) => {
+          return z.string().parse(value);
+        },
+      },
+      testmode: {
+        kind: "parsed",
+        brief:
+          "Allows setting the testmode parameter for all supported operations",
+        optional: true,
+        parse: (value) => {
+          return z.enum(["true", "false"]).transform(v => v === "true").parse(
+            value,
+          );
+        },
+      },
+      "custom-user-agent": {
+        kind: "parsed",
+        brief:
+          "Allows setting the customUserAgent parameter for all supported operations",
+        optional: true,
+        parse: (value) => {
+          return z.string().parse(value);
+        },
+      },
       "server-url": {
         kind: "parsed",
         brief: "Overrides the default server URL used by the SDK",

package/src/mcp-server/cli/start/impl.ts

@@ -19,6 +19,9 @@ interface StartCommandFlags {
   readonly tool?: string[];
   readonly "api-key"?: string | undefined;
   readonly "o-auth"?: string | undefined;
+  readonly "profile-id"?: SDKOptions["profileId"] | undefined;
+  readonly testmode?: SDKOptions["testmode"] | undefined;
+  readonly "custom-user-agent"?: SDKOptions["customUserAgent"] | undefined;
   readonly "server-url"?: string;
   readonly "server-index"?: SDKOptions["serverIdx"];
   readonly "log-level": ConsoleLoggerLevel;
@@ -49,6 +52,9 @@ async function startStdio(flags: StartCommandFlags) {
     logger,
     allowedTools: flags.tool,
     security: { apiKey: flags["api-key"] ?? "", oAuth: flags["o-auth"] ?? "" },
+    profileId: flags["profile-id"],
+    testmode: flags.testmode,
+    customUserAgent: flags["custom-user-agent"],
     serverURL: flags["server-url"],
     serverIdx: flags["server-index"],
   });
@@ -69,6 +75,9 @@ async function startSSE(flags: StartCommandFlags) {
     logger,
     allowedTools: flags.tool,
     security: { apiKey: flags["api-key"] ?? "", oAuth: flags["o-auth"] ?? "" },
+    profileId: flags["profile-id"],
+    testmode: flags.testmode,
+    customUserAgent: flags["custom-user-agent"],
     serverURL: flags["server-url"],
     serverIdx: flags["server-index"],
   });

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.2",
+    currentVersion: "0.8.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -116,15 +116,21 @@ export function createMCPServer(deps: {
   scopes?: MCPScope[] | undefined;
   serverURL?: string | undefined;
   security?: SDKOptions["security"] | undefined;
+  profileId?: SDKOptions["profileId"] | undefined;
+  testmode?: SDKOptions["testmode"] | undefined;
+  customUserAgent?: SDKOptions["customUserAgent"] | undefined;
   serverIdx?: SDKOptions["serverIdx"] | undefined;
 }) {
   const server = new McpServer({
     name: "Client",
-    version: "0.6.2",
+    version: "0.8.0",
   });
 
   const client = new ClientCore({
     security: deps.security,
+    profileId: deps.profileId,
+    testmode: deps.testmode,
+    customUserAgent: deps.customUserAgent,
     serverURL: deps.serverURL,
     serverIdx: deps.serverIdx,
   });

package/src/models/operations/cancelrefund.ts

@@ -8,6 +8,19 @@ import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
+export type CancelRefundGlobals = {
+  /**
+   * Most API credentials are specifically created for either live mode or test mode. In those cases the `testmode` query
+   *
+   * @remarks
+   * parameter can be omitted. For organization-level credentials such as OAuth access tokens, you can enable test mode by
+   * setting the `testmode` query parameter to `true`.
+   *
+   * Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.
+   */
+  testmode?: boolean | undefined;
+};
+
 export type CancelRefundRequest = {
   /**
    * Provide the ID of the related payment.
@@ -26,13 +39,67 @@ export type CancelRefundRequest = {
    *
    * Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.
    */
-  testmode?: boolean | null | undefined;
+  testmode?: boolean | undefined;
   /**
    * A unique key to ensure idempotent requests. This key should be a UUID v4 string.
    */
   idempotencyKey?: string | undefined;
 };
 
+/** @internal */
+export const CancelRefundGlobals$inboundSchema: z.ZodType<
+  CancelRefundGlobals,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  testmode: z.boolean().optional(),
+});
+
+/** @internal */
+export type CancelRefundGlobals$Outbound = {
+  testmode?: boolean | undefined;
+};
+
+/** @internal */
+export const CancelRefundGlobals$outboundSchema: z.ZodType<
+  CancelRefundGlobals$Outbound,
+  z.ZodTypeDef,
+  CancelRefundGlobals
+> = z.object({
+  testmode: 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 CancelRefundGlobals$ {
+  /** @deprecated use `CancelRefundGlobals$inboundSchema` instead. */
+  export const inboundSchema = CancelRefundGlobals$inboundSchema;
+  /** @deprecated use `CancelRefundGlobals$outboundSchema` instead. */
+  export const outboundSchema = CancelRefundGlobals$outboundSchema;
+  /** @deprecated use `CancelRefundGlobals$Outbound` instead. */
+  export type Outbound = CancelRefundGlobals$Outbound;
+}
+
+export function cancelRefundGlobalsToJSON(
+  cancelRefundGlobals: CancelRefundGlobals,
+): string {
+  return JSON.stringify(
+    CancelRefundGlobals$outboundSchema.parse(cancelRefundGlobals),
+  );
+}
+
+export function cancelRefundGlobalsFromJSON(
+  jsonString: string,
+): SafeParseResult<CancelRefundGlobals, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => CancelRefundGlobals$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'CancelRefundGlobals' from JSON`,
+  );
+}
+
 /** @internal */
 export const CancelRefundRequest$inboundSchema: z.ZodType<
   CancelRefundRequest,
@@ -41,7 +108,7 @@ export const CancelRefundRequest$inboundSchema: z.ZodType<
 > = z.object({
   paymentId: z.string(),
   refundId: z.string(),
-  testmode: z.nullable(z.boolean()).optional(),
+  testmode: z.boolean().optional(),
   "idempotency-key": z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
@@ -53,7 +120,7 @@ export const CancelRefundRequest$inboundSchema: z.ZodType<
 export type CancelRefundRequest$Outbound = {
   paymentId: string;
   refundId: string;
-  testmode?: boolean | null | undefined;
+  testmode?: boolean | undefined;
   "idempotency-key"?: string | undefined;
 };
 
@@ -65,7 +132,7 @@ export const CancelRefundRequest$outboundSchema: z.ZodType<
 > = z.object({
   paymentId: z.string(),
   refundId: z.string(),
-  testmode: z.nullable(z.boolean()).optional(),
+  testmode: z.boolean().optional(),
   idempotencyKey: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {

package/src/models/operations/getbalance.ts

@@ -8,6 +8,19 @@ import { safeParse } from "../../lib/schemas.js";
 import { Result as SafeParseResult } from "../../types/fp.js";
 import { SDKValidationError } from "../errors/sdkvalidationerror.js";
 
+export type GetBalanceGlobals = {
+  /**
+   * Most API credentials are specifically created for either live mode or test mode. In those cases the `testmode` query
+   *
+   * @remarks
+   * parameter can be omitted. For organization-level credentials such as OAuth access tokens, you can enable test mode by
+   * setting the `testmode` query parameter to `true`.
+   *
+   * Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.
+   */
+  testmode?: boolean | undefined;
+};
+
 export type GetBalanceRequest = {
   /**
    * Provide the ID of the item you want to perform this operation on.
@@ -22,13 +35,67 @@ export type GetBalanceRequest = {
    *
    * Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.
    */
-  testmode?: boolean | null | undefined;
+  testmode?: boolean | undefined;
   /**
    * A unique key to ensure idempotent requests. This key should be a UUID v4 string.
    */
   idempotencyKey?: string | undefined;
 };
 
+/** @internal */
+export const GetBalanceGlobals$inboundSchema: z.ZodType<
+  GetBalanceGlobals,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  testmode: z.boolean().optional(),
+});
+
+/** @internal */
+export type GetBalanceGlobals$Outbound = {
+  testmode?: boolean | undefined;
+};
+
+/** @internal */
+export const GetBalanceGlobals$outboundSchema: z.ZodType<
+  GetBalanceGlobals$Outbound,
+  z.ZodTypeDef,
+  GetBalanceGlobals
+> = z.object({
+  testmode: 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 GetBalanceGlobals$ {
+  /** @deprecated use `GetBalanceGlobals$inboundSchema` instead. */
+  export const inboundSchema = GetBalanceGlobals$inboundSchema;
+  /** @deprecated use `GetBalanceGlobals$outboundSchema` instead. */
+  export const outboundSchema = GetBalanceGlobals$outboundSchema;
+  /** @deprecated use `GetBalanceGlobals$Outbound` instead. */
+  export type Outbound = GetBalanceGlobals$Outbound;
+}
+
+export function getBalanceGlobalsToJSON(
+  getBalanceGlobals: GetBalanceGlobals,
+): string {
+  return JSON.stringify(
+    GetBalanceGlobals$outboundSchema.parse(getBalanceGlobals),
+  );
+}
+
+export function getBalanceGlobalsFromJSON(
+  jsonString: string,
+): SafeParseResult<GetBalanceGlobals, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => GetBalanceGlobals$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'GetBalanceGlobals' from JSON`,
+  );
+}
+
 /** @internal */
 export const GetBalanceRequest$inboundSchema: z.ZodType<
   GetBalanceRequest,
@@ -36,7 +103,7 @@ export const GetBalanceRequest$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   id: z.string(),
-  testmode: z.nullable(z.boolean()).optional(),
+  testmode: z.boolean().optional(),
   "idempotency-key": z.string().optional(),
 }).transform((v) => {
   return remap$(v, {
@@ -47,7 +114,7 @@ export const GetBalanceRequest$inboundSchema: z.ZodType<
 /** @internal */
 export type GetBalanceRequest$Outbound = {
   id: string;
-  testmode?: boolean | null | undefined;
+  testmode?: boolean | undefined;
   "idempotency-key"?: string | undefined;
 };
 
@@ -58,7 +125,7 @@ export const GetBalanceRequest$outboundSchema: z.ZodType<
   GetBalanceRequest
 > = z.object({
   id: z.string(),
-  testmode: z.nullable(z.boolean()).optional(),
+  testmode: z.boolean().optional(),
   idempotencyKey: z.string().optional(),
 }).transform((v) => {
   return remap$(v, {