nxus-qbd 0.1.0

package/dist/transport.js

@@ -0,0 +1,141 @@
+/**
+ * NxusHttpTransport — internal HTTP transport layer using native `fetch`.
+ *
+ * Handles authentication, base URL resolution, JSON serialization,
+ * and error mapping for all SDK requests.
+ */
+import { NxusApiError } from './helpers/errors';
+function normalizeErrorPayload(errorBody, response) {
+    if (errorBody == null) {
+        return {
+            status: response.status,
+            message: response.statusText,
+        };
+    }
+    if (typeof errorBody !== 'object') {
+        return errorBody;
+    }
+    const normalized = { ...errorBody };
+    if (normalized.status == null) {
+        normalized.status = response.status;
+    }
+    const nestedError = normalized.error;
+    if (nestedError && typeof nestedError === 'object') {
+        normalized.error = {
+            ...nestedError,
+            httpStatusCode: nestedError.httpStatusCode ?? response.status,
+        };
+    }
+    return normalized;
+}
+// ---------------------------------------------------------------------------
+// Transport
+// ---------------------------------------------------------------------------
+export class NxusHttpTransport {
+    baseUrl;
+    apiKey;
+    defaultHeaders;
+    defaultTimeout;
+    constructor(options) {
+        // Ensure trailing slash for consistent URL joining
+        this.baseUrl = options.baseUrl.replace(/\/+$/, '');
+        this.apiKey = options.apiKey;
+        this.defaultHeaders = options.headers ?? {};
+        this.defaultTimeout = options.timeout ?? 30_000;
+    }
+    async get(path, query, options) {
+        const url = this.buildUrl(path, query);
+        return this.request(url, { method: 'GET' }, options);
+    }
+    async post(path, body, options) {
+        const url = this.buildUrl(path);
+        return this.request(url, {
+            method: 'POST',
+            body: body != null ? JSON.stringify(body) : undefined,
+        }, options);
+    }
+    async delete(path, options) {
+        const url = this.buildUrl(path);
+        return this.request(url, { method: 'DELETE' }, options);
+    }
+    // -------------------------------------------------------------------------
+    // Internal
+    // -------------------------------------------------------------------------
+    buildUrl(path, query) {
+        const url = new URL(path, this.baseUrl + '/');
+        // The URL constructor resolves relative to base — if path starts with /
+        // we need to set it directly
+        if (path.startsWith('/')) {
+            url.pathname = path;
+        }
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    async request(url, init, options) {
+        const headers = {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${this.apiKey}`,
+            ...this.defaultHeaders,
+            ...options?.headers,
+        };
+        if (options?.connectionId) {
+            headers['X-Connection-Id'] = options.connectionId;
+        }
+        const timeout = options?.timeout ?? this.defaultTimeout;
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), timeout);
+        try {
+            const response = await fetch(url, {
+                ...init,
+                headers,
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                let errorBody;
+                try {
+                    errorBody = await response.json();
+                }
+                catch {
+                    errorBody = await response.text().catch(() => null);
+                }
+                throw NxusApiError.from(normalizeErrorPayload(errorBody, response));
+            }
+            // 204 No Content
+            if (response.status === 204) {
+                return undefined;
+            }
+            const text = await response.text();
+            if (!text) {
+                return undefined;
+            }
+            return JSON.parse(text);
+        }
+        catch (error) {
+            if (error instanceof NxusApiError)
+                throw error;
+            if (error instanceof DOMException && error.name === 'AbortError') {
+                throw new NxusApiError({
+                    message: `Request timed out after ${timeout}ms`,
+                    userMessage: 'The request timed out. Please try again.',
+                    status: 0,
+                });
+            }
+            throw new NxusApiError({
+                message: error instanceof Error ? error.message : 'Network request failed',
+                userMessage: 'A network error occurred. Please check your connection and try again.',
+                status: 0,
+                raw: error,
+            });
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "nxus-qbd",
+  "version": "0.1.0",
+  "description": "Official Node.js/TypeScript SDK for the Nxus QuickBooks Desktop API",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./models": {
+      "import": "./dist/models/index.js",
+      "types": "./dist/models/index.d.ts"
+    },
+    "./models/core": {
+      "import": "./dist/models/core/index.js",
+      "types": "./dist/models/core/index.d.ts"
+    },
+    "./models/qbd": {
+      "import": "./dist/models/qbd/index.js",
+      "types": "./dist/models/qbd/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "devDependencies": {
+    "@hey-api/openapi-ts": "^0.93.1",
+    "dotenv": "^16.4.0",
+    "prettier": "^3.4.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "keywords": [
+    "nxus",
+    "quickbooks",
+    "quickbooks-desktop",
+    "qbd",
+    "sdk",
+    "api",
+    "accounting"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nxus-app/nxus-qbd.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "generate": "openapi-ts && pnpm run generate:models",
+    "generate:live": "OPENAPI_SPEC_URL=https://api.nx-us.net/openapi/v1.json openapi-ts && pnpm run generate:models",
+    "generate:local": "OPENAPI_SPEC_URL=https://localhost:7242/openapi/v1.json openapi-ts && pnpm run generate:models",
+    "generate:models": "node ./scripts/generate-model-exports.mjs",
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}