@dintero/node-sdk 1.0.2

package/LICENSE

@@ -0,0 +1,19 @@
+Copyright (C) 2024 Dintero AS. (https://dintero.com)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# Dintero Node.js SDK
+
+[![Build Status](https://github.com/dintero/Dintero.Node.SDK/workflows/CI/badge.svg)](https://github.com/dintero/Dintero.Node.SDK/actions?query=workflow%3ACI+branch%3Amaster)
+
+The Dintero Node SDK provides convenient access to the Dintero API from
+applications written in server-side Javascript
+
+## Installation
+
+Install the package with:
+
+```sh
+npm install @dintero/node-sdk
+# or
+yarn add @dintero/node-sdk
+```
+
+## Usage
+
+To use the Dintero Node.js SDK, you will need to configure it with your **API credentials** that can be created in the Dintero Backoffice. These credentials include the **Client ID**, **Client Secret**, and **Audience**, which are required for authenticating your requests to the Dintero API.
+
+### Example: Client Setup
+
+You first need to create a client with the required credentials:
+
+```ts
+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',
+});
+
+export default client;
+
+```
+
+### Example: Session Profile
+
+```ts
+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',
+});
+
+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
+        },
+        profile_id: 'profile123',  // Replace with actual profile ID
+    },
+    headers: {
+        'Content-Type': 'application/json',
+        'Accept': 'application/json',
+    },
+});
+
+console.log('Session Profile Response:', sessionProfileResponse.data);
+```
+
+### Example: Fetching Settlement
+
+
+```ts
+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',
+});
+
+const settlementsResponse = await client.core.GET(`/accounts/${client.accountId}/settlements`, {
+    method: 'GET',
+    headers: {
+        'Accept': 'application/json',
+        },
+    }
+);
+console.log('Settlements Response:', settlementsResponse.data);
+```
+
+## Bugs
+
+Bugs can be reported to https://github.com/Dintero/Dintero.Node.SDK/issues
+
+## Security
+
+Contact us at [security@dintero.com](mailto:security@dintero.com)
+
+## Building from source
+
+```bash
+yarn install
+yarn run build
+```

package/dist/client.d.ts

@@ -0,0 +1,9 @@
+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;
+};

package/dist/client.js

@@ -0,0 +1,24 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = void 0;
+const openapi_fetch_1 = __importDefault(require("openapi-fetch"));
+const middleware_1 = require("./middleware");
+const createClient = (options) => {
+    const config = {
+        checkout: { baseUrl: "https://checkout.dintero.com" },
+        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);
+    return { checkout, core, accountId };
+};
+exports.createClient = createClient;

package/dist/dintero.d.ts

@@ -0,0 +1 @@
+export { createClient } from "./client";

package/dist/dintero.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return client_1.createClient; } });

package/dist/middleware.d.ts

@@ -0,0 +1,9 @@
+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

@@ -0,0 +1,74 @@
+"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

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

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,53 @@
+{
+    "name": "@dintero/node-sdk",
+    "version": "1.0.2",
+    "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.8.3",
+        "@types/jest": "29.5.12",
+        "@types/js-yaml": "4.0.9",
+        "@types/node": "20.14.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",
+        "swagger2openapi": "7.0.8",
+        "ts-jest": "29.2.5",
+        "ts-node": "10.9.2",
+        "typescript": "5.6.2"
+    },
+    "engines": {
+        "node": ">=20.0.0"
+    },
+    "dependencies": {
+        "openapi-fetch": "^0.12.0"
+    }
+}