@revenexx/node 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Revenexx
+
+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,136 @@
+> **This repository is auto-generated by the [Revenexx SDK Generator](https://github.com/revenexx/sdk-generator). Do not submit changes directly — they will be overwritten on the next generation run.**
+
+# Revenexx API — revenexx Revenexx Node SDK
+
+![License](https://img.shields.io/github/license/revenexx-sdks/node.svg?style=flat-square)
+![Version](https://img.shields.io/badge/api%20version-1.0.0-blue.svg?style=flat-square)
+[![Build Status](https://img.shields.io/travis/com/appwrite/sdk-generator?style=flat-square)](https://travis-ci.com/appwrite/sdk-generator)
+[![Twitter Account](https://img.shields.io/twitter/follow/revenexx?color=00acee&label=twitter&style=flat-square)](https://twitter.com/revenexx)
+
+Revenexx Node.js SDK for server-side applications.
+
+![Revenexx API — revenexx](https://revenexx.com/images/logo.svg)
+
+## Installation
+
+To install via [NPM](https://www.npmjs.com/):
+
+```bash
+npm install @revenexx/node --save
+```
+
+
+## Getting Started
+
+### Init your SDK
+
+Initialize your SDK with your Revenexx API endpoint and your credentials. Use `setTenant()` to scope your requests to a tenant, sent as the `X-Revenexx-Tenant` header on every request. The client supports two authentication methods:
+
+- **API key** — a gateway-managed scoped key (`rvxk_…`), set via `setApiKeyAuth()`. Intended for server-side or trusted environments; never embed an API key in code shipped to the browser.
+- **Bearer token** — a Zitadel-issued JWT for interactive callers, set via `setBearerAuth()`. The value is sent as the `Authorization` header verbatim, so include the `Bearer ` prefix.
+
+```js
+const { Client } = require('@revenexx/node');
+
+const client = new Client();
+
+client
+    .setEndpoint('https://api.revenexx.com') // Your Revenexx API endpoint
+    .setTenant('<TENANT_SLUG>')              // The tenant your requests are scoped to
+    .setApiKeyAuth('rvxk_...')               // Your scoped API key
+;
+```
+
+Or, with a user JWT:
+
+```js
+client
+    .setEndpoint('https://api.revenexx.com')
+    .setTenant('<TENANT_SLUG>')
+    .setBearerAuth(`Bearer ${jwt}`)
+;
+```
+
+### Make Your First Request
+
+Once your client is set up, instantiate any of the Revenexx services with it and send a request. All service methods accept a single params object and return a promise. Full documentation for every service method can be found in the [API References](https://revenexx.com/docs).
+
+```js
+const { Client, Products } = require('@revenexx/node');
+
+const products = new Products(client);
+
+const result = await products.productsList();
+```
+
+### Full Example
+
+```js
+const { Client, Products } = require('@revenexx/node');
+
+const client = new Client();
+
+client
+    .setEndpoint('https://api.revenexx.com')
+    .setTenant('<TENANT_SLUG>')
+    .setApiKeyAuth('rvxk_...')
+;
+
+const products = new Products(client);
+
+const result = await products.productsList();
+
+const product = await products.productsGet({ id: '<PRODUCT_ID>' });
+console.log(product);
+```
+
+### Type Safety with Models
+
+The SDK ships with full TypeScript definitions. Response types live in the `Models` namespace, and every service method is typed against them — including nullable fields, which are typed as `| null`.
+
+```typescript
+import { Client, Customers, type Models } from "@revenexx/node";
+
+const customers = new Customers(client);
+
+const address: Models.Address = await customers.customersAddressesGet({
+    id: '<ADDRESS_ID>',
+});
+
+console.log(address.street, address.city);
+console.log(address.company); // string | null
+```
+
+### Error Handling
+
+The Revenexx Node SDK raises a `RevenexxAPIRevenexxException` object with `message`, `code` and `response` properties. You can handle any errors by catching the exception and present the `message` to the user or handle it yourself based on the provided error information.
+
+```javascript
+const { RevenexxAPIRevenexxException, Products } = require('@revenexx/node');
+
+const products = new Products(client);
+
+try {
+    const product = await products.productsGet({ id: '<PRODUCT_ID>' });
+    console.log(product);
+} catch (error) {
+    if (error instanceof RevenexxAPIRevenexxException) {
+        console.error(error.code, error.message);
+    }
+}
+```
+
+### Learn more
+
+You can use the following resources to learn more and get help
+
+- 📜 [Revenexx Docs](https://revenexx.com/docs)
+- 💬 [Discord Community](https://revenexx.com/discord)
+
+## Contribution
+
+This library is auto-generated by the Revenexx custom [SDK Generator](https://github.com/revenexx/sdk-generator). To learn more about how you can help us improve this SDK, please check the [contribution guide](https://github.com/revenexx/sdk-generator/blob/main/CONTRIBUTING.md) before sending a pull-request.
+
+## License
+
+Please see the [ license]() file for more information.

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@revenexx/node",
+  "homepage": "https://revenexx.com",
+  "description": "Revenexx Node.js SDK.",
+  "version": "0.0.1",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "type": "commonjs",
+  "scripts": {
+    "build": "tsup"
+  },
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./file": {
+      "import": {
+        "types": "./dist/inputFile.d.mts",
+        "default": "./dist/inputFile.mjs"
+      },
+      "require": {
+        "types": "./dist/inputFile.d.ts",
+        "default": "./dist/inputFile.js"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/revenexx-sdks/node"
+  },
+  "devDependencies": {
+    "@types/json-bigint": "1.0.4",
+    "@types/node": "20.11.25",
+    "tsup": "7.2.0",
+    "esbuild-plugin-file-path-extensions": "^2.0.0",
+    "tslib": "2.6.2",
+    "typescript": "5.4.2"
+  },
+  "dependencies": {
+    "json-bigint": "1.0.0",
+    "node-fetch-native-with-agent": "1.7.2"
+  }
+}