@dintero/node-sdk 1.0.2 → 1.1.0

package/README.md

@@ -27,9 +27,9 @@ You first need to create a client with the required credentials:
 import { createClient } from "@dintero/node-sdk";
 
 const client = createClient({
-    clientId: 'your_client_id',   // Replace with your actual client ID
-    clientSecret: 'your_client_secret',  // Replace with your actual client secret
-    audience: 'https://api.dintero.com/v1/accounts/your_account_id',
+    clientId: "your_client_id",   // Replace with your actual client ID
+    clientSecret: "your_client_secret",  // Replace with your actual client secret
+    audience: "https://api.dintero.com/v1/accounts/your_account_id",
 });
 
 export default client;
@@ -39,69 +39,71 @@ export default client;
 ### Example: Session Profile
 
 ```ts
-import { createClient } from '@dintero/node-sdk';
+import { createClient } from "@dintero/node-sdk";
 
 const client = createClient({
-    clientId: 'your_client_id',   // Replace with your actual client ID
-    clientSecret: 'your_client_secret',  // Replace with your actual client secret
-    audience: 'https://api.dintero.com/v1/accounts/your_account_id',
+    clientId: "your_client_id",   // Replace with your actual client ID
+    clientSecret: "your_client_secret",  // Replace with your actual client secret
+    audience: "https://api.dintero.com/v1/accounts/your_account_id",
 });
 
-const sessionProfileResponse = await client.checkout.POST('/sessions-profile', {
-    method: 'POST',
-    body: {
-        url: {
-            return_url: 'https://example.com',  // Replace with actual return URL
-        },
-        order: {
-            amount: 1000,
-            currency: 'NOK',
-            items: [
-                {
-                    id: 'item1',
-                    line_id: 'line1',
-                    description: 'Item 1',
-                    amount: 1000,
-                    quantity: 1,
-                    vat_amount: 0,
-                    vat: 0,
-                    eligible_for_discount: false,
-                },
-            ],
-            partial_payment: false,
-            merchant_reference: 'ref123',  // Replace with actual merchant reference
+const sessionProfileResponse = await client.checkout.POST(
+    "/sessions-profile",
+    {
+        body: {
+            url: {
+                return_url: "https://example.com",  // Replace with actual return URL
+            },
+            order: {
+                amount: 1000,
+                currency: "NOK",
+                items: [
+                    {
+                        id: "item1",
+                        line_id: "line1",
+                        description: "Item 1",
+                        amount: 1000,
+                        quantity: 1,
+                        vat_amount: 0,
+                        vat: 0,
+                        eligible_for_discount: false,
+                    },
+                ],
+                partial_payment: false,
+                merchant_reference: "ref123",  // Replace with actual merchant reference
+            },
+            profile_id: "default"
         },
-        profile_id: 'profile123',  // Replace with actual profile ID
     },
-    headers: {
-        'Content-Type': 'application/json',
-        'Accept': 'application/json',
-    },
-});
+);
 
-console.log('Session Profile Response:', sessionProfileResponse.data);
+console.log("Session Profile Response:", sessionProfileResponse.data);
 ```
 
 ### Example: Fetching Settlement
 
 
 ```ts
-import { createClient } from '@dintero/node-sdk';
+import { createClient } from "@dintero/node-sdk";
 
 const client = createClient({
-    clientId: 'your_client_id',   // Replace with your actual client ID
-    clientSecret: 'your_client_secret',  // Replace with your actual client secret
-    audience: 'https://api.dintero.com/v1/accounts/your_account_id',
+    clientId: "your_client_id",   // Replace with your actual client ID
+    clientSecret: "your_client_secret",  // Replace with your actual client secret
+    audience: "https://api.dintero.com/v1/accounts/your_account_id",
 });
 
-const settlementsResponse = await client.core.GET(`/accounts/${client.accountId}/settlements`, {
-    method: 'GET',
-    headers: {
-        'Accept': 'application/json',
+const settlementsResponse = await client.core.GET(
+    "/accounts/{aid}/settlements",
+    {
+        params: {
+            path: {
+                aid: "T12345678",
+            },
         },
-    }
+    },
 );
-console.log('Settlements Response:', settlementsResponse.data);
+
+console.log("Settlements Response:", settlementsResponse.data);
 ```
 
 ## Bugs

package/dist/package.json

@@ -0,0 +1,53 @@
+{
+    "name": "@dintero/node-sdk",
+    "version": "1.1.0",
+    "description": "Node.js library for the Dintero API",
+    "main": "./dist/dintero.js",
+    "typings": "./dist/dintero.d.ts",
+    "files": [
+        "dist"
+    ],
+    "license": "MIT",
+    "private": false,
+    "publishConfig": {
+        "access": "public"
+    },
+    "author": "Dintero <support@dintero.com> (https://dintero.com/)",
+    "jest": {
+        "preset": "ts-jest",
+        "testMatch": [
+            "**/test/**/*.test.ts"
+        ]
+    },
+    "scripts": {
+        "build": "yarn -s build-ts && yarn -s lint",
+        "build-ts": "tsc -p ./tsconfig.build.json",
+        "test": "jest",
+        "lint": "biome check",
+        "convert-spec": "ts-node -T scripts/convert-spec.ts",
+        "semantic-release": "semantic-release",
+        "prepublishOnly": "yarn run build-ts"
+    },
+    "devDependencies": {
+        "@biomejs/biome": "1.9.3",
+        "@types/jest": "29.5.13",
+        "@types/js-yaml": "4.0.9",
+        "@types/node": "20.16.11",
+        "@types/swagger2openapi": "7.0.4",
+        "jest": "29.7.0",
+        "js-yaml": "4.1.0",
+        "msw": "2.4.11",
+        "openapi-typescript": "7.4.1",
+        "semantic-release": "24.1.2",
+        "swagger2openapi": "7.0.8",
+        "ts-jest": "29.2.5",
+        "ts-node": "10.9.2",
+        "typescript": "5.6.3"
+    },
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "dependencies": {
+        "openapi-fetch": "^0.12.0"
+    }
+}

package/dist/src/client.d.ts

@@ -0,0 +1,6 @@
+import type { CheckoutPaths, ClientOptions, CorePaths } from "./types";
+export declare const createClient: (options: ClientOptions) => {
+    checkout: import("openapi-fetch").Client<CheckoutPaths, `${string}/${string}`>;
+    core: import("openapi-fetch").Client<CorePaths, `${string}/${string}`>;
+    accountId: string;
+};

package/dist/{client.js → src/client.js}

@@ -12,13 +12,14 @@ const createClient = (options) => {
         core: { baseUrl: "https://api.dintero.com" },
         ...options,
     };
-    const authMiddleware = (0, middleware_1.createAuthMiddleware)(config);
-    const versionPrefixMiddleware = (0, middleware_1.createVersionPrefixMiddleware)();
     const checkout = (0, openapi_fetch_1.default)(config.checkout);
     const core = (0, openapi_fetch_1.default)(config.core);
     const accountId = (0, middleware_1.extractAccountId)(config.audience);
-    core.use(versionPrefixMiddleware, authMiddleware);
-    checkout.use(versionPrefixMiddleware, authMiddleware);
+    const authMiddleware = (0, middleware_1.createAuthMiddleware)(config, core);
+    const headersMiddleware = (0, middleware_1.createDefaultHeadersMiddleware)();
+    const versionPrefixMiddleware = (0, middleware_1.createVersionPrefixMiddleware)();
+    core.use(versionPrefixMiddleware, authMiddleware, headersMiddleware);
+    checkout.use(versionPrefixMiddleware, authMiddleware, headersMiddleware);
     return { checkout, core, accountId };
 };
 exports.createClient = createClient;

package/dist/src/middleware.d.ts

@@ -0,0 +1,59 @@
+import type { Client, Middleware } from "openapi-fetch";
+import type { CorePaths } from "./types";
+import type { ClientOptions } from "./types";
+export declare const extractAccountId: (audience: string) => string;
+export declare const accessToken: (config: Required<ClientOptions>, client: Client<CorePaths>) => Promise<import("openapi-fetch").FetchResponse<{
+    parameters: {
+        query?: never;
+        header?: never;
+        path: {
+            oid: import("./generated/payments").components["parameters"]["owner"];
+        };
+        cookie?: never;
+    };
+    requestBody: {
+        content: {
+            "application/json": import("./generated/payments").components["schemas"]["AuthToken"];
+        };
+    };
+    responses: {
+        200: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": import("./generated/payments").components["schemas"]["AccessToken"];
+            };
+        };
+        400: import("./generated/payments").components["responses"]["BadRequest"];
+        401: import("./generated/payments").components["responses"]["AccessForbidden"];
+        403: {
+            headers: {
+                [name: string]: unknown;
+            };
+            content: {
+                "application/json": import("./generated/payments").components["schemas"]["Error"] & {
+                    mfa_token?: string;
+                };
+            };
+        };
+        429: import("./generated/payments").components["responses"]["TooManyRequests"];
+        500: import("./generated/payments").components["responses"]["ServerError"];
+    };
+}, {
+    params: {
+        path: {
+            oid: string;
+        };
+    };
+    headers: {
+        Authorization: string;
+    };
+    body: {
+        grant_type: string;
+        audience: string;
+    };
+}, `${string}/${string}`>>;
+export declare const createAuthMiddleware: (config: Required<ClientOptions>, client: Client<CorePaths>) => Middleware;
+export declare const createDefaultHeadersMiddleware: () => Middleware;
+export declare const createVersionPrefixMiddleware: () => Middleware;

package/dist/src/middleware.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createVersionPrefixMiddleware = exports.createDefaultHeadersMiddleware = exports.createAuthMiddleware = exports.accessToken = exports.extractAccountId = void 0;
+const package_json_1 = require("../package.json");
+const extractAccountId = (audience) => {
+    if (!audience || !audience.includes("://")) {
+        throw new Error("Account ID could not be extracted from the audience URL.");
+    }
+    const audienceUrl = new URL(audience);
+    const pathParts = audienceUrl.pathname.split("/").filter(Boolean);
+    const accountId = audienceUrl.username || (pathParts.length >= 3 ? pathParts[2] : null);
+    if (!accountId) {
+        throw new Error("Account ID could not be extracted from the audience URL.");
+    }
+    return accountId;
+};
+exports.extractAccountId = extractAccountId;
+const accessToken = async (config, client) => {
+    const credentials = Buffer.from(`${config.clientId}:${config.clientSecret}`).toString("base64");
+    return await client.POST("/accounts/{oid}/auth/token", {
+        params: { path: { oid: (0, exports.extractAccountId)(config.audience) } },
+        headers: {
+            Authorization: `Basic ${credentials}`,
+        },
+        body: {
+            grant_type: "client_credentials",
+            audience: config.audience,
+        },
+    });
+};
+exports.accessToken = accessToken;
+const createAuthMiddleware = (config, client) => {
+    let auth = undefined;
+    let authExpires = 0;
+    return {
+        async onRequest({ request }) {
+            if (request.headers.get("Authorization")) {
+                return undefined;
+            }
+            const now = Math.floor(Date.now() / 1000);
+            if (!auth?.access_token || authExpires < now) {
+                const result = await (0, exports.accessToken)(config, client);
+                if (result.error || !result.data) {
+                    throw new Error(`Failed to fetch access token: ${result.response.status}`);
+                }
+                auth = result.data;
+                authExpires = now + Math.floor(auth.expires_in / 2);
+            }
+            request.headers.set("Authorization", `Bearer ${auth.access_token}`);
+            return request;
+        },
+    };
+};
+exports.createAuthMiddleware = createAuthMiddleware;
+const createDefaultHeadersMiddleware = () => ({
+    onRequest({ request }) {
+        if (!request.headers.get("User-Agent")) {
+            request.headers.set("User-Agent", `Dintero.Node.SDK/${package_json_1.version} (+https://github.com/Dintero/Dintero.Node.SDK)`);
+        }
+    },
+});
+exports.createDefaultHeadersMiddleware = createDefaultHeadersMiddleware;
+const createVersionPrefixMiddleware = () => ({
+    async onRequest({ request, schemaPath }) {
+        if (schemaPath.startsWith("/v")) {
+            return request;
+        }
+        const url = new URL(request.url);
+        url.pathname = `/v1${url.pathname ?? "/"}`;
+        return new Request(url.toString(), request);
+    },
+});
+exports.createVersionPrefixMiddleware = createVersionPrefixMiddleware;

package/dist/{client.d.ts → src/types.d.ts}

@@ -1,9 +1,14 @@
 import type { paths } from "./generated/payments";
-import type { ClientOptions } from "./types";
 export type CheckoutPaths = Pick<paths, "/sessions-profile" | "/accounts/{oid}/auth/token" | "/sessions/{session_id}" | "/sessions/{session_id}/cancel" | "/transactions/{id}/capture" | "/transactions/{id}/authorization" | "/transactions/{id}/refund" | "/transactions/{id}/void" | "/transactions/{id}" | "/transactions">;
 export type CorePaths = Pick<paths, "/accounts/{aid}/settlements" | "/accounts/{oid}/auth/token" | "/accounts/{aid}/reports/metadata" | "/accounts/{aid}/settlements/reports/configuration" | "/accounts/{aid}/settlements/reports/configuration/{id}" | "/accounts/{aid}/management/settings/approvals/payout-destinations" | "/accounts/{aid}/settlements/{settlementid}/attachments/{attachmentid}" | "/v2/accounts/{aid}/payout/fund-transfer" | "/v2/accounts/{aid}/payout/payout-destinations/{payout_destination_id}/balances" | "/v2/accounts/{aid}/payout/payout-destinations/{payout_destination_id}/transfers">;
-export declare const createClient: (options: ClientOptions) => {
-    checkout: import("openapi-fetch").Client<CheckoutPaths, `${string}/${string}`>;
-    core: import("openapi-fetch").Client<CorePaths, `${string}/${string}`>;
-    accountId: string;
+export type ClientOptions = {
+    clientId: string;
+    clientSecret: string;
+    audience: string;
+    core?: {
+        baseUrl: string;
+    };
+    checkout?: {
+        baseUrl: string;
+    };
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@dintero/node-sdk",
-    "version": "1.0.2",
+    "version": "1.1.0",
     "description": "Node.js library for the Dintero API",
     "main": "./dist/dintero.js",
     "typings": "./dist/dintero.d.ts",
@@ -29,20 +29,20 @@
         "prepublishOnly": "yarn run build-ts"
     },
     "devDependencies": {
-        "@biomejs/biome": "1.8.3",
-        "@types/jest": "29.5.12",
+        "@biomejs/biome": "1.9.3",
+        "@types/jest": "29.5.13",
         "@types/js-yaml": "4.0.9",
-        "@types/node": "20.14.11",
+        "@types/node": "20.16.11",
         "@types/swagger2openapi": "7.0.4",
         "jest": "29.7.0",
         "js-yaml": "4.1.0",
-        "msw": "2.4.3",
-        "openapi-typescript": "7.4.0",
-        "semantic-release": "24.1.1",
+        "msw": "2.4.11",
+        "openapi-typescript": "7.4.1",
+        "semantic-release": "24.1.2",
         "swagger2openapi": "7.0.8",
         "ts-jest": "29.2.5",
         "ts-node": "10.9.2",
-        "typescript": "5.6.2"
+        "typescript": "5.6.3"
     },
     "engines": {
         "node": ">=20.0.0"

package/dist/middleware.d.ts

@@ -1,9 +0,0 @@
-import type { Middleware } from "openapi-fetch";
-import type { ClientOptions } from "./types";
-export declare const extractAccountId: (audience: string) => string;
-export declare const fetchAccessToken: (config: Required<ClientOptions>) => Promise<{
-    accessToken: any;
-    expiresIn: any;
-}>;
-export declare const createAuthMiddleware: (config: Required<ClientOptions>) => Middleware;
-export declare const createVersionPrefixMiddleware: () => Middleware;

package/dist/middleware.js

@@ -1,74 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createVersionPrefixMiddleware = exports.createAuthMiddleware = exports.fetchAccessToken = exports.extractAccountId = void 0;
-const extractAccountId = (audience) => {
-    if (!audience || !audience.includes("://")) {
-        throw new Error("Account ID could not be extracted from the audience URL.");
-    }
-    const audienceUrl = new URL(audience);
-    const pathParts = audienceUrl.pathname.split("/").filter(Boolean);
-    const accountId = audienceUrl.username || (pathParts.length >= 3 ? pathParts[2] : null);
-    if (!accountId) {
-        throw new Error("Account ID could not be extracted from the audience URL.");
-    }
-    return accountId;
-};
-exports.extractAccountId = extractAccountId;
-const fetchAccessToken = async (config) => {
-    const accountId = (0, exports.extractAccountId)(config.audience);
-    const url = `${config.core.baseUrl}/v1/accounts/${accountId}/auth/token`;
-    const authToken = Buffer.from(`${config.clientId}:${config.clientSecret}`).toString("base64");
-    const response = await fetch(url, {
-        method: "POST",
-        headers: {
-            "Content-Type": "application/json",
-            Accept: "application/json",
-            Authorization: `Basic ${authToken}`,
-        },
-        body: JSON.stringify({
-            grant_type: "client_credentials",
-            audience: config.audience,
-        }),
-    });
-    const responseText = await response.text();
-    if (response.status !== 200) {
-        throw new Error(`Failed to fetch access token: ${response.statusText}. Details: ${responseText}`);
-    }
-    const json = JSON.parse(responseText);
-    return {
-        accessToken: json.access_token,
-        expiresIn: json.expires_in,
-    };
-};
-exports.fetchAccessToken = fetchAccessToken;
-const createAuthMiddleware = (config) => {
-    let accessToken = undefined;
-    let tokenExpiry = 0;
-    return {
-        async onRequest({ request }) {
-            if (request.headers.get("Authorization")) {
-                return request;
-            }
-            const currentTime = Math.floor(Date.now() / 1000);
-            if (!accessToken || tokenExpiry < currentTime) {
-                const tokenData = await (0, exports.fetchAccessToken)(config);
-                accessToken = tokenData.accessToken;
-                tokenExpiry = currentTime + Math.floor(tokenData.expiresIn / 2);
-            }
-            request.headers.set("Authorization", `Bearer ${accessToken}`);
-            return request;
-        },
-    };
-};
-exports.createAuthMiddleware = createAuthMiddleware;
-const createVersionPrefixMiddleware = () => ({
-    async onRequest({ request, schemaPath }) {
-        if (schemaPath.startsWith("/v")) {
-            return request;
-        }
-        const url = new URL(request.url);
-        url.pathname = `/v1${url.pathname ?? "/"}`;
-        return new Request(url.toString(), request);
-    },
-});
-exports.createVersionPrefixMiddleware = createVersionPrefixMiddleware;

package/dist/types.d.ts

@@ -1,11 +0,0 @@
-export type ClientOptions = {
-    clientId: string;
-    clientSecret: string;
-    audience: string;
-    core?: {
-        baseUrl: string;
-    };
-    checkout?: {
-        baseUrl: string;
-    };
-};