mollie-api-typescript 0.2.2 → 0.2.4

package/docs/sdks/settlements/README.md

@@ -40,6 +40,7 @@ async function run() {
     year: "2025",
     month: "1",
     currencies: "EUR",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -72,6 +73,7 @@ async function run() {
     year: "2025",
     month: "1",
     currencies: "EUR",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;
@@ -134,6 +136,7 @@ const client = new Client({
 async function run() {
   const result = await client.settlements.get({
     id: "stl_jDk30akdN",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -161,6 +164,7 @@ const client = new ClientCore({
 async function run() {
   const res = await settlementsGet(client, {
     id: "stl_jDk30akdN",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;
@@ -217,7 +221,9 @@ const client = new Client({
 });
 
 async function run() {
-  const result = await client.settlements.getOpen();
+  const result = await client.settlements.getOpen({
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
+  });
 
   console.log(result);
 }
@@ -242,7 +248,9 @@ const client = new ClientCore({
 });
 
 async function run() {
-  const res = await settlementsGetOpen(client);
+  const res = await settlementsGetOpen(client, {
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
+  });
   if (res.ok) {
     const { value: result } = res;
     console.log(result);
@@ -258,6 +266,7 @@ run();
 
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.GetOpenSettlementRequest](../../models/operations/getopensettlementrequest.md)                                                                                     | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
@@ -295,7 +304,9 @@ const client = new Client({
 });
 
 async function run() {
-  const result = await client.settlements.getNext();
+  const result = await client.settlements.getNext({
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
+  });
 
   console.log(result);
 }
@@ -320,7 +331,9 @@ const client = new ClientCore({
 });
 
 async function run() {
-  const res = await settlementsGetNext(client);
+  const res = await settlementsGetNext(client, {
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
+  });
   if (res.ok) {
     const { value: result } = res;
     console.log(result);
@@ -336,6 +349,7 @@ run();
 
 | Parameter                                                                                                                                                                      | Type                                                                                                                                                                           | Required                                                                                                                                                                       | Description                                                                                                                                                                    |
 | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `request`                                                                                                                                                                      | [operations.GetNextSettlementRequest](../../models/operations/getnextsettlementrequest.md)                                                                                     | :heavy_check_mark:                                                                                                                                                             | The request object to use for the request.                                                                                                                                     |
 | `options`                                                                                                                                                                      | RequestOptions                                                                                                                                                                 | :heavy_minus_sign:                                                                                                                                                             | Used to set various options for making HTTP requests.                                                                                                                          |
 | `options.fetchOptions`                                                                                                                                                         | [RequestInit](https://developer.mozilla.org/en-US/docs/Web/API/Request/Request#options)                                                                                        | :heavy_minus_sign:                                                                                                                                                             | Options that are passed to the underlying HTTP request. This can be used to inject extra headers for examples. All `Request` options, except `method` and `body`, are allowed. |
 | `options.retries`                                                                                                                                                              | [RetryConfig](../../lib/utils/retryconfig.md)                                                                                                                                  | :heavy_minus_sign:                                                                                                                                                             | Enables retrying HTTP requests under certain failure conditions.                                                                                                               |
@@ -379,6 +393,7 @@ async function run() {
     sort: "desc",
     profileId: "pfl_5B8cwPMGnU",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -411,6 +426,7 @@ async function run() {
     sort: "desc",
     profileId: "pfl_5B8cwPMGnU",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;
@@ -468,6 +484,7 @@ async function run() {
     limit: 50,
     embed: "payment",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -499,6 +516,7 @@ async function run() {
     limit: 50,
     embed: "payment",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;
@@ -556,6 +574,7 @@ async function run() {
     limit: 50,
     embed: "payment",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -587,6 +606,7 @@ async function run() {
     limit: 50,
     embed: "payment",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;
@@ -644,6 +664,7 @@ async function run() {
     limit: 50,
     embed: "payment",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -675,6 +696,7 @@ async function run() {
     limit: 50,
     embed: "payment",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;

package/docs/sdks/subscriptions/README.md

@@ -50,6 +50,7 @@ const client = new Client({
 async function run() {
   const result = await client.subscriptions.create({
     customerId: "cst_5B8cwPMGnU",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     subscriptionRequest: {
       id: "sub_5B8cwPMGnU",
       status: "active",
@@ -101,6 +102,7 @@ const client = new ClientCore({
 async function run() {
   const res = await subscriptionsCreate(client, {
     customerId: "cst_5B8cwPMGnU",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     subscriptionRequest: {
       id: "sub_5B8cwPMGnU",
       status: "active",
@@ -182,6 +184,7 @@ async function run() {
     limit: 50,
     sort: "desc",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -213,6 +216,7 @@ async function run() {
     limit: 50,
     sort: "desc",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;
@@ -266,6 +270,7 @@ async function run() {
     customerId: "cst_5B8cwPMGnU",
     subscriptionId: "sub_5B8cwPMGnU",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -295,6 +300,7 @@ async function run() {
     customerId: "cst_5B8cwPMGnU",
     subscriptionId: "sub_5B8cwPMGnU",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;
@@ -351,6 +357,7 @@ async function run() {
   const result = await client.subscriptions.update({
     customerId: "cst_5B8cwPMGnU",
     subscriptionId: "sub_5B8cwPMGnU",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     requestBody: {
       amount: {
         currency: "EUR",
@@ -392,6 +399,7 @@ async function run() {
   const res = await subscriptionsUpdate(client, {
     customerId: "cst_5B8cwPMGnU",
     subscriptionId: "sub_5B8cwPMGnU",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     requestBody: {
       amount: {
         currency: "EUR",
@@ -457,6 +465,7 @@ async function run() {
   const result = await client.subscriptions.cancel({
     customerId: "cst_5B8cwPMGnU",
     subscriptionId: "sub_5B8cwPMGnU",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     requestBody: {
       testmode: false,
     },
@@ -488,6 +497,7 @@ async function run() {
   const res = await subscriptionsCancel(client, {
     customerId: "cst_5B8cwPMGnU",
     subscriptionId: "sub_5B8cwPMGnU",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     requestBody: {
       testmode: false,
     },
@@ -547,6 +557,7 @@ async function run() {
     limit: 50,
     profileId: "pfl_5B8cwPMGnU",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -577,6 +588,7 @@ async function run() {
     limit: 50,
     profileId: "pfl_5B8cwPMGnU",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;
@@ -636,6 +648,7 @@ async function run() {
     sort: "desc",
     profileId: "pfl_5B8cwPMGnU",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -669,6 +682,7 @@ async function run() {
     sort: "desc",
     profileId: "pfl_5B8cwPMGnU",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;

package/docs/sdks/terminals/README.md

@@ -32,6 +32,7 @@ async function run() {
     limit: 50,
     sort: "desc",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -62,6 +63,7 @@ async function run() {
     limit: 50,
     sort: "desc",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;
@@ -114,6 +116,7 @@ async function run() {
   const result = await client.terminals.get({
     terminalId: "term_vytxeTZskVKR7C7WgdSP3d",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -142,6 +145,7 @@ async function run() {
   const res = await terminalsGet(client, {
     terminalId: "term_vytxeTZskVKR7C7WgdSP3d",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;

package/docs/sdks/wallets/README.md

@@ -43,9 +43,12 @@ const client = new Client({
 
 async function run() {
   const result = await client.wallets.requestApplePaySession({
-    validationUrl: "https://apple-pay-gateway-cert.apple.com/paymentservices/paymentSession",
-    domain: "pay.myshop.com",
-    profileId: "pfl_5B8cwPMGnU",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
+    requestBody: {
+      validationUrl: "https://apple-pay-gateway-cert.apple.com/paymentservices/paymentSession",
+      domain: "pay.myshop.com",
+      profileId: "pfl_5B8cwPMGnU",
+    },
   });
 
   console.log(result);
@@ -72,9 +75,12 @@ const client = new ClientCore({
 
 async function run() {
   const res = await walletsRequestApplePaySession(client, {
-    validationUrl: "https://apple-pay-gateway-cert.apple.com/paymentservices/paymentSession",
-    domain: "pay.myshop.com",
-    profileId: "pfl_5B8cwPMGnU",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
+    requestBody: {
+      validationUrl: "https://apple-pay-gateway-cert.apple.com/paymentservices/paymentSession",
+      domain: "pay.myshop.com",
+      profileId: "pfl_5B8cwPMGnU",
+    },
   });
   if (res.ok) {
     const { value: result } = res;

package/docs/sdks/webhookevents/README.md

@@ -27,6 +27,7 @@ async function run() {
   const result = await client.webhookEvents.get({
     id: "event_jd9v34P5YqN9pT8n3HJyH",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -55,6 +56,7 @@ async function run() {
   const res = await webhookEventsGet(client, {
     id: "event_jd9v34P5YqN9pT8n3HJyH",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;

package/docs/sdks/webhooks/README.md

@@ -30,10 +30,13 @@ const client = new Client({
 
 async function run() {
   const result = await client.webhooks.create({
-    name: "Webhook #1",
-    url: "https://mollie.com/",
-    webhookEventTypes: "payment-link.paid",
-    testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
+    requestBody: {
+      name: "Webhook #1",
+      url: "https://mollie.com/",
+      webhookEventTypes: "payment-link.paid",
+      testmode: false,
+    },
   });
 
   console.log(result);
@@ -60,10 +63,13 @@ const client = new ClientCore({
 
 async function run() {
   const res = await webhooksCreate(client, {
-    name: "Webhook #1",
-    url: "https://mollie.com/",
-    webhookEventTypes: "payment-link.paid",
-    testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
+    requestBody: {
+      name: "Webhook #1",
+      url: "https://mollie.com/",
+      webhookEventTypes: "payment-link.paid",
+      testmode: false,
+    },
   });
   if (res.ok) {
     const { value: result } = res;
@@ -119,6 +125,7 @@ async function run() {
     sort: "desc",
     eventTypes: "payment-link.paid",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -150,6 +157,7 @@ async function run() {
     sort: "desc",
     eventTypes: "payment-link.paid",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;
@@ -201,6 +209,7 @@ const client = new Client({
 async function run() {
   const result = await client.webhooks.update({
     id: "hook_B2EyhTH5N4KWUnoYPcgiH",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     requestBody: {
       name: "Webhook #1",
       url: "https://mollie.com/",
@@ -234,6 +243,7 @@ const client = new ClientCore({
 async function run() {
   const res = await webhooksUpdate(client, {
     id: "hook_B2EyhTH5N4KWUnoYPcgiH",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     requestBody: {
       name: "Webhook #1",
       url: "https://mollie.com/",
@@ -292,6 +302,7 @@ async function run() {
   const result = await client.webhooks.get({
     id: "hook_B2EyhTH5N4KWUnoYPcgiH",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);
@@ -320,6 +331,7 @@ async function run() {
   const res = await webhooksGet(client, {
     id: "hook_B2EyhTH5N4KWUnoYPcgiH",
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
   if (res.ok) {
     const { value: result } = res;
@@ -371,6 +383,7 @@ const client = new Client({
 async function run() {
   const result = await client.webhooks.delete({
     id: "hook_B2EyhTH5N4KWUnoYPcgiH",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     requestBody: {
       testmode: false,
     },
@@ -401,6 +414,7 @@ const client = new ClientCore({
 async function run() {
   const res = await webhooksDelete(client, {
     id: "hook_B2EyhTH5N4KWUnoYPcgiH",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     requestBody: {
       testmode: false,
     },
@@ -455,6 +469,7 @@ const client = new Client({
 async function run() {
   const result = await client.webhooks.test({
     id: "hook_B2EyhTH5N4KWUnoYPcgiH",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     requestBody: {
       testmode: false,
     },
@@ -485,6 +500,7 @@ const client = new ClientCore({
 async function run() {
   const res = await webhooksTest(client, {
     id: "hook_B2EyhTH5N4KWUnoYPcgiH",
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
     requestBody: {
       testmode: false,
     },

package/examples/balancesList.example.ts

@@ -20,11 +20,12 @@ const client = new Client({
 });
 
 async function main() {
-  const result = await client.list({
+  const result = await client.balances.list({
     currency: "EUR",
     from: "bal_gVMhHKqSSRYJyPsuoPNFH",
     limit: 50,
     testmode: false,
+    idempotencyKey: "123e4567-e89b-12d3-a456-426",
   });
 
   console.log(result);

package/examples/package-lock.json

@@ -18,7 +18,7 @@
     },
     "..": {
       "name": "mollie-api-typescript",
-      "version": "0.2.2",
+      "version": "0.2.4",
       "dependencies": {
         "zod": "^3.20.0"
       },

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "mollie-api-typescript",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mollie-api-typescript",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "author": "Speakeasy",
   "type": "module",
   "bin": {

package/src/funcs/balancesGet.ts

@@ -118,6 +118,11 @@ async function $do(
 
   const headers = new Headers(compactMap({
     Accept: "application/hal+json",
+    "idempotency-key": encodeSimple(
+      "idempotency-key",
+      payload["idempotency-key"],
+      { explode: false, charEncoding: "none" },
+    ),
   }));
 
   const securityInput = await extractSecurity(client._options.security);

package/src/funcs/balancesGetPrimary.ts

@@ -3,8 +3,10 @@
  */
 
 import { ClientCore } from "../core.js";
+import { 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";
@@ -19,6 +21,7 @@ import {
 import { ResponseValidationError } from "../models/errors/responsevalidationerror.js";
 import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
 import * as models from "../models/index.js";
+import * as operations from "../models/operations/index.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
 
@@ -34,6 +37,7 @@ import { Result } from "../types/fp.js";
  */
 export function balancesGetPrimary(
   client: ClientCore,
+  request?: operations.GetPrimaryBalanceRequest | undefined,
   options?: RequestOptions,
 ): APIPromise<
   Result<
@@ -50,12 +54,14 @@ export function balancesGetPrimary(
 > {
   return new APIPromise($do(
     client,
+    request,
     options,
   ));
 }
 
 async function $do(
   client: ClientCore,
+  request?: operations.GetPrimaryBalanceRequest | undefined,
   options?: RequestOptions,
 ): Promise<
   [
@@ -73,10 +79,29 @@ async function $do(
     APICall,
   ]
 > {
+  const parsed = safeParse(
+    request,
+    (value) =>
+      operations.GetPrimaryBalanceRequest$outboundSchema.optional().parse(
+        value,
+      ),
+    "Input validation failed",
+  );
+  if (!parsed.ok) {
+    return [parsed, { status: "invalid" }];
+  }
+  const payload = parsed.value;
+  const body = null;
+
   const path = pathToFunc("/balances/primary")();
 
   const headers = new Headers(compactMap({
     Accept: "application/hal+json",
+    "idempotency-key": encodeSimple(
+      "idempotency-key",
+      payload?.["idempotency-key"],
+      { explode: false, charEncoding: "none" },
+    ),
   }));
 
   const securityInput = await extractSecurity(client._options.security);
@@ -113,6 +138,7 @@ async function $do(
     baseURL: options?.serverURL,
     path: path,
     headers: headers,
+    body: body,
     userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1,
   }, options);

package/src/funcs/balancesGetReport.ts

@@ -113,6 +113,11 @@ async function $do(
 
   const headers = new Headers(compactMap({
     Accept: "application/hal+json",
+    "idempotency-key": encodeSimple(
+      "idempotency-key",
+      payload["idempotency-key"],
+      { explode: false, charEncoding: "none" },
+    ),
   }));
 
   const securityInput = await extractSecurity(client._options.security);

package/src/funcs/balancesList.ts

@@ -3,7 +3,7 @@
  */
 
 import { ClientCore } from "../core.js";
-import { encodeFormQuery } from "../lib/encodings.js";
+import { encodeFormQuery, encodeSimple } from "../lib/encodings.js";
 import * as M from "../lib/matchers.js";
 import { compactMap } from "../lib/primitives.js";
 import { safeParse } from "../lib/schemas.js";
@@ -102,6 +102,11 @@ async function $do(
 
   const headers = new Headers(compactMap({
     Accept: "application/hal+json",
+    "idempotency-key": encodeSimple(
+      "idempotency-key",
+      payload?.["idempotency-key"],
+      { explode: false, charEncoding: "none" },
+    ),
   }));
 
   const securityInput = await extractSecurity(client._options.security);

package/src/funcs/balancesListTransactions.ts

@@ -115,6 +115,11 @@ async function $do(
 
   const headers = new Headers(compactMap({
     Accept: "application/hal+json",
+    "idempotency-key": encodeSimple(
+      "idempotency-key",
+      payload["idempotency-key"],
+      { explode: false, charEncoding: "none" },
+    ),
   }));
 
   const securityInput = await extractSecurity(client._options.security);