nxus-qbd 0.3.2 → 0.3.4

package/README.md

@@ -1,252 +1,340 @@
-# nxus-qbd
-
-Official TypeScript SDK for the [Nxus](https://nx-us.net/docs/) QuickBooks Desktop API.
-
-## Runtime Support
-
-Runs on **Node.js 18+** and **Bun 1.0+**. The SDK uses native `fetch` and `AbortController` with no Node-specific dependencies.
-
-## Installation
-
-```bash
-npm install nxus-qbd
-pnpm add nxus-qbd
-bun add nxus-qbd
-```
-
-## Environments
-
-The SDK targets `https://api.nx-us.net/` by default.
-
-Use `environment: NxusEnvironment.DEVELOPMENT` to target `https://localhost:7242/`, or pass an explicit `baseUrl` override when you need a custom endpoint.
-
-```ts
-import { NxusClient, NxusEnvironment } from "nxus-qbd";
-
-const nxus = new NxusClient({
-  apiKey: "sk_live_...",
-  environment: NxusEnvironment.DEVELOPMENT,
-});
-```
-
-## Timeouts
-
-The SDK defaults to a `100_000ms` client timeout so normal callers can still
-receive the API's structured timeout responses for heavier QuickBooks
-operations.
-
-Advanced callers can override this globally or per request:
-
-```ts
-import { NxusClient } from "nxus-qbd";
-
-const nxus = new NxusClient({
-  apiKey: "sk_live_...",
-  timeout: 120_000,
-});
-
-const page = await nxus.transactions.list({
-  connectionId: "your-connection-id",
-  limit: 100,
-  DetailLevel: "all",
-  timeout: 30_000,
-});
-```
-
-Paginated/list requests can also send a backend timeout hint without changing
-the SDK's local abort timer:
-
-```ts
-const page = await nxus.transactions.list({
-  connectionId: "your-connection-id",
-  limit: 100,
-  DetailLevel: "all",
-  timeout: 30_000,
-  timeoutSeconds: 45,
-});
-```
-
-When `timeoutSeconds` is provided on a `.list()` call, the SDK sends it as the
-`X-Nxus-Timeout-Seconds` request header and keeps reusing that header for
-manual `getNextPage()` calls and `for await` auto-pagination. It is not added
-to the query string.
-
-## Automatic Retries
-
-The SDK automatically retries transient failures up to `2` additional times
-(3 total attempts) with exponential backoff and jitter.
-
-The `x-should-retry` response header from the API is the primary signal:
-
-- `true` → retry, even for statuses that wouldn't normally retry.
-- `false` → don't retry, even for statuses that normally would.
-
-When the header is absent (older backend, infrastructure-level error), the SDK
-falls back to retrying:
-
-- Network errors (fetch threw before receiving a response)
-- HTTP `408` (Request Timeout) and `429` (Too Many Requests)
-- HTTP `5xx`
-
-`409` is **not** in the fallback retry set: the API overloads `409` for both
-retryable lock contention (`ObjectInUse`, `LockFailed`) and terminal
-business-rule violations (`OutdatedEditSequence`, `NameNotUnique`). Without
-`x-should-retry` to disambiguate, the safe default is to surface the error to
-the caller. Servers that emit `x-should-retry: true` opt the retryable 409s
-back in.
-
-For backoff, the standard `Retry-After` response header (seconds or HTTP-date)
-is honored when present, with `error.retryAfter` (seconds) in the JSON body
-as a fallback. Local timeouts (the SDK's abort timer) are treated as
-cancellations and are not retried.
-
-Configure globally or per-request:
-
-```ts
-const nxus = new NxusClient({
-  apiKey: "sk_live_...",
-  maxRetries: 3, // default is 2; set to 0 to disable
-});
-
-// Disable retries for one call
-const created = await nxus.invoices.create({
-  customerRefListId: "...",
-  invoiceLineAdds: [{ itemRefListId: "...", amount: 100 }],
-  connectionId: "...",
-  maxRetries: 0,
-});
-```
-
-## Quick Start
-
-```ts
-import { NxusClient } from "nxus-qbd";
-
-const nxus = new NxusClient({ apiKey: "sk_live_..." });
-
-// List vendors
-const page = await nxus.vendors.list({ limit: 50, connectionId: "your-connection-id" });
-
-for (const vendor of page.data) {
-  console.log(vendor.name);
-}
-
-// Retrieve a single customer by QuickBooks ListID
-const customer = await nxus.customers.retrieve("80000001-1234567890", {
-  connectionId: "your-connection-id",
-});
-
-// Create an invoice (flat params)
-const invoice = await nxus.invoices.create({
-  customerRefListId: "80000001-1234567890",
-  invoiceLineAdds: [
-    { itemRefListId: "80000002-1234567890", amount: 150.0 },
-  ],
-  connectionId: "your-connection-id",
-});
-
-// Update a vendor (ID first, flat fields)
-const updated = await nxus.vendors.update("80000001-1234567890", {
-  name: "Acme (Updated)",
-  revisionNumber: vendor.revisionNumber,
-  connectionId: "your-connection-id",
-});
-
-// Delete
-await nxus.vendors.delete("80000001-1234567890", {
-  connectionId: "your-connection-id",
-});
-```
-
-## Connection Scoping
-
-Every request requires a `connectionId` to identify which QuickBooks Desktop company file to target. You can set it per-request or globally via the constructor:
-
-```ts
-// Per-request
-const page = await nxus.vendors.list({ limit: 10, connectionId: "your-connection-id" });
-const vendor = await nxus.vendors.retrieve("id", { connectionId: "your-connection-id" });
-
-// Global default
-const nxus = new NxusClient({
-  apiKey: "sk_live_...",
-  headers: { "X-Connection-Id": "your-connection-id" },
-});
-```
-
-## Auto-Pagination
-
-List methods return an `AutoPaginationPromise` that supports both manual page navigation and `for await` iteration:
-
-```ts
-// Auto-paginate through all records
-for await (const vendor of nxus.vendors.list({ limit: 100, timeoutSeconds: 45 })) {
-  console.log(vendor.name);
-}
-
-// Manual page-by-page navigation
-let page = await nxus.vendors.list({ limit: 50, timeoutSeconds: 45 });
-while (page.hasNextPage()) {
-  page = await page.getNextPage();
-}
-```
-
-> [!IMPORTANT]
-> **Processing Constraints**: Each paginated request must either complete or be cancelled before the subsequent request can be processed by the backend.
->
-> - **Async API (Primary)**: The Async API is the recommended way to handle these requests as it allows for better lifecycle management.
-> - **Sync Wrappers**: While sync wrappers are provided for convenience, you may need to increase your client-side timeouts to ensure large paginated sets complete successfully.
-
-## Examples
-
-Runnable examples live in [`examples/`](examples/):
-
-| Example | Description |
-|---|---|
-| [`basic-crud.ts`](examples/basic-crud.ts) | Create, retrieve, update, list, and delete a vendor |
-| [`authSetup.ts`](examples/authSetup.ts) | Create a connection, generate a hosted QWC auth flow URL, and check auth status |
-| [`auto-pagination.ts`](examples/auto-pagination.ts) | Auto-iteration across pages plus manual page navigation |
-| [`connection-scoped.ts`](examples/connection-scoped.ts) | Multi-company isolation with `connectionId` |
-| [`error-handling.ts`](examples/error-handling.ts) | Error categorization and typed SDK errors |
-| [`pagination-walkthrough.ts`](examples/pagination-walkthrough.ts) | Cursor handling walkthrough |
-| [`reports.ts`](examples/reports.ts) | Aging, general detail, and general summary reports |
-| [`timeout-tuning.ts`](examples/timeout-tuning.ts) | Default timeout behavior, client-wide overrides, and per-request timeout tuning |
-
-
-## Error Handling
-
-All methods throw `NxusApiError` on non-2xx responses:
-
-```ts
-import { NxusClient, NxusApiError } from "nxus-qbd";
-
-try {
-  await nxus.vendors.retrieve("non-existent-id");
-} catch (err) {
-  if (err instanceof NxusApiError) {
-    console.log(err.status);          // 404
-    console.log(err.userMessage);     // User-safe message
-    console.log(err.isNotFound);      // true
-    console.log(err.isAuthError);     // false
-    console.log(err.isRateLimited);   // false
-  }
-}
-```
-
-## Resources
-
-All QuickBooks Desktop resources are available as namespaced properties:
-
-| Category | Resources |
-|---|---|
-| **Transactions** | `invoices`, `bills`, `checks`, `deposits`, `estimates`, `creditMemos`, `purchaseOrders`, `salesReceipts`, `journalEntries`, `receivePayments`, `vendorCredits`, `creditCardCharges`, `creditCardBills`, `creditCardCredits`, `charges`, `buildAssemblies`, `arRefundCreditCards`, `salesTaxPaymentChecks`, `itemReceipts`, `checkBills`, `timeTrackings`, `transactions` |
-| **Lists** | `accounts`, `customers`, `vendors`, `employees`, `otherNames`, `currencies`, `terms`, `dateDrivenTerms`, `paymentMethods`, `shipMethods`, `salesTaxCodes`, `priceLevels`, `qbdClasses`, `customerTypes`, `vendorTypes`, `billingRates`, `inventorySites`, `barCodes`, `accountTaxLineInfos`, `unitOfMeasureSets`, `specialItems` |
-| **Read-only** | `billToPay` |
-| **Items** | `items`, `inventoryItems`, `itemDiscounts`, `itemFixedAssets`, `itemGroups`, `itemInventoryAssemblies`, `itemNonInventory`, `itemOtherCharges`, `itemPayments`, `itemSalesTax`, `itemSalesTaxGroups`, `serviceItems`, `itemSubtotals` |
-| **Payroll** | `payrollItemNonWages`, `payrollItemWages`, `workersCompCodes` |
-| **Reports** | `reports.retrieveAging()`, `reports.retrieveGeneralDetail()`, `reports.retrieveGeneralSummary()`, `reports.retrieveBudgetSummary()`, `reports.retrieveJob()`, `reports.retrieveTime()`, `reports.retrieveCustomDetail()`, `reports.retrieveCustomSummary()`, `reports.retrievePayrollDetail()` |
-| **Platform** | `authSessions`, `connections` |
-
-## License
-
-MIT
+# nxus-qbd
+
+Official TypeScript SDK for the [Nxus](https://nx-us.net/docs/) QuickBooks Desktop API.
+
+## Runtime Support
+
+Runs on **Node.js 18+** and **Bun 1.0+**. The SDK uses native `fetch` and `AbortController` with no Node-specific dependencies.
+
+## Installation
+
+```bash
+npm install nxus-qbd
+pnpm add nxus-qbd
+bun add nxus-qbd
+```
+
+## Environments
+
+The SDK targets `https://api.nx-us.net/` by default.
+
+Use `environment: NxusEnvironment.DEVELOPMENT` to target `https://localhost:7242/`, or pass an explicit `baseUrl` override when you need a custom endpoint.
+
+```ts
+import { NxusClient, NxusEnvironment } from "nxus-qbd";
+
+const nxus = new NxusClient({
+  apiKey: "sk_live_...",
+  environment: NxusEnvironment.DEVELOPMENT,
+});
+```
+
+## Timeouts
+
+The SDK defaults to a `100_000ms` client timeout so normal callers can still
+receive the API's structured timeout responses for heavier QuickBooks
+operations.
+
+Advanced callers can override this globally or per request:
+
+```ts
+import { NxusClient } from "nxus-qbd";
+
+const nxus = new NxusClient({
+  apiKey: "sk_live_...",
+  timeout: 120_000,
+});
+
+const page = await nxus.transactions.list({
+  connectionId: "your-connection-id",
+  limit: 100,
+  DetailLevel: "all",
+  timeout: 30_000,
+});
+```
+
+Paginated/list requests can also send a backend timeout hint without changing
+the SDK's local abort timer:
+
+```ts
+const page = await nxus.transactions.list({
+  connectionId: "your-connection-id",
+  limit: 100,
+  DetailLevel: "all",
+  timeout: 30_000,
+  timeoutSeconds: 45,
+});
+```
+
+When `timeoutSeconds` is provided on a `.list()` call, the SDK sends it as the
+`X-Nxus-Timeout-Seconds` request header and keeps reusing that header for
+manual `getNextPage()` calls and `for await` auto-pagination. It is not added
+to the query string.
+
+## Automatic Retries
+
+The SDK automatically retries transient failures up to `2` additional times
+(3 total attempts) with exponential backoff and jitter.
+
+The `x-should-retry` response header from the API is the primary signal:
+
+- `true` → retry, even for statuses that wouldn't normally retry.
+- `false` → don't retry, even for statuses that normally would.
+
+When the header is absent (older backend, infrastructure-level error), the SDK
+falls back to retrying:
+
+- Network errors (fetch threw before receiving a response)
+- HTTP `408` (Request Timeout) and `429` (Too Many Requests)
+- HTTP `5xx`
+
+`409` is **not** in the fallback retry set: the API overloads `409` for both
+retryable lock contention (`ObjectInUse`, `LockFailed`) and terminal
+business-rule violations (`OutdatedEditSequence`, `NameNotUnique`). Without
+`x-should-retry` to disambiguate, the safe default is to surface the error to
+the caller. Servers that emit `x-should-retry: true` opt the retryable 409s
+back in.
+
+For backoff, the standard `Retry-After` response header (seconds or HTTP-date)
+is honored when present, with `error.retryAfter` (seconds) in the JSON body
+as a fallback. Local timeouts (the SDK's abort timer) are treated as
+cancellations and are not retried.
+
+Configure globally or per-request:
+
+```ts
+const nxus = new NxusClient({
+  apiKey: "sk_live_...",
+  maxRetries: 3, // default is 2; set to 0 to disable
+});
+
+// Disable retries for one call
+const created = await nxus.invoices.create({
+  customerRefListId: "...",
+  invoiceLineAdds: [{ itemRefListId: "...", amount: 100 }],
+  connectionId: "...",
+  maxRetries: 0,
+});
+```
+
+## Verbose Logging
+
+Set `verbose: true` to emit structured logs for every request, response, retry,
+and error. Sensitive headers (`Authorization`, `Cookie`, `Set-Cookie`,
+`X-Api-Key`, `Proxy-Authorization`) are automatically redacted.
+
+```ts
+const nxus = new NxusClient({
+  apiKey: "sk_live_...",
+  verbose: true,                     // logs to console
+});
+```
+
+Plug in your own logger (winston, pino, etc.) by providing any object that
+implements `{ debug, info, warn, error }`:
+
+```ts
+import type { NxusLogger } from "nxus-qbd";
+
+const logger: NxusLogger = {
+  debug: (m, c) => myLogger.debug({ event: m, ...c }),
+  info:  (m, c) => myLogger.info({ event: m, ...c }),
+  warn:  (m, c) => myLogger.warn({ event: m, ...c }),
+  error: (m, c) => myLogger.error({ event: m, ...c }),
+};
+
+const nxus = new NxusClient({ apiKey: "sk_live_...", logger });
+```
+
+Providing a `logger` implies `verbose: true`. You can also opt-in on a single
+call via `{ verbose: true }` in request options.
+
+## Proxy Support
+
+Route traffic through an outbound HTTP/HTTPS proxy by passing `proxy`:
+
+```ts
+const nxus = new NxusClient({
+  apiKey: "sk_live_...",
+  proxy: "http://proxy.corp:8080",
+});
+```
+
+On Node, the SDK lazily loads `undici.ProxyAgent` (shipped with Node 18+) and
+wires it via `fetchOptions.dispatcher`. On Bun, the URL is passed through as
+the native `proxy` fetch option. For advanced cases — custom TLS, mTLS,
+per-request dispatchers — use the `fetchOptions` escape hatch:
+
+```ts
+import { ProxyAgent } from "undici";
+
+const nxus = new NxusClient({
+  apiKey: "sk_live_...",
+  fetchOptions: {
+    dispatcher: new ProxyAgent({
+      uri: "http://proxy.corp:8080",
+      token: `Basic ${Buffer.from("user:pass").toString("base64")}`,
+    }),
+  },
+});
+```
+
+`fetchOptions` may also be supplied per request to override the client default.
+
+## Raw HTTP Access
+
+When you need direct access to the underlying `Response` — headers, streaming
+bodies, custom status handling — use `transport.raw()`. Authentication, default
+headers, the timeout, and retries are still applied; only JSON parsing and the
+typed error mapping are bypassed.
+
+```ts
+import { NxusClient } from "nxus-qbd";
+
+const nxus = new NxusClient({ apiKey: "sk_live_..." });
+
+const res = await (nxus as unknown as { transport: { raw: (path: string, init?: RequestInit) => Promise<Response> } })
+  .transport.raw("/api/v1/vendors", { method: "GET" });
+
+console.log(res.status, res.headers.get("x-request-id"));
+const stream = res.body; // ReadableStream for large downloads
+```
+
+Non-2xx responses are returned, not thrown — the caller is responsible for
+checking `response.ok`. Use this only for cases the typed resource methods
+can't model (binary downloads, response-header inspection, custom error
+semantics).
+
+## Quick Start
+
+```ts
+import { NxusClient } from "nxus-qbd";
+
+const nxus = new NxusClient({ apiKey: "sk_live_..." });
+
+// List vendors
+const page = await nxus.vendors.list({ limit: 50, connectionId: "your-connection-id" });
+
+for (const vendor of page.data) {
+  console.log(vendor.name);
+}
+
+// Retrieve a single customer by QuickBooks ListID
+const customer = await nxus.customers.retrieve("80000001-1234567890", {
+  connectionId: "your-connection-id",
+});
+
+// Create an invoice (flat params)
+const invoice = await nxus.invoices.create({
+  customerRefListId: "80000001-1234567890",
+  invoiceLineAdds: [
+    { itemRefListId: "80000002-1234567890", amount: 150.0 },
+  ],
+  connectionId: "your-connection-id",
+});
+
+// Update a vendor (ID first, flat fields)
+const updated = await nxus.vendors.update("80000001-1234567890", {
+  name: "Acme (Updated)",
+  revisionNumber: vendor.revisionNumber,
+  connectionId: "your-connection-id",
+});
+
+// Delete
+await nxus.vendors.delete("80000001-1234567890", {
+  connectionId: "your-connection-id",
+});
+```
+
+## Connection Scoping
+
+Every request requires a `connectionId` to identify which QuickBooks Desktop company file to target. You can set it per-request or globally via the constructor:
+
+```ts
+// Per-request
+const page = await nxus.vendors.list({ limit: 10, connectionId: "your-connection-id" });
+const vendor = await nxus.vendors.retrieve("id", { connectionId: "your-connection-id" });
+
+// Global default
+const nxus = new NxusClient({
+  apiKey: "sk_live_...",
+  headers: { "X-Connection-Id": "your-connection-id" },
+});
+```
+
+## Auto-Pagination
+
+List methods return an `AutoPaginationPromise` that supports both manual page navigation and `for await` iteration:
+
+```ts
+// Auto-paginate through all records
+for await (const vendor of nxus.vendors.list({ limit: 100, timeoutSeconds: 45 })) {
+  console.log(vendor.name);
+}
+
+// Manual page-by-page navigation
+let page = await nxus.vendors.list({ limit: 50, timeoutSeconds: 45 });
+while (page.hasNextPage()) {
+  page = await page.getNextPage();
+}
+```
+
+> [!IMPORTANT]
+> **Processing Constraints**: Each paginated request must either complete or be cancelled before the subsequent request can be processed by the backend.
+>
+> - **Async API (Primary)**: The Async API is the recommended way to handle these requests as it allows for better lifecycle management.
+> - **Sync Wrappers**: While sync wrappers are provided for convenience, you may need to increase your client-side timeouts to ensure large paginated sets complete successfully.
+
+## Examples
+
+Runnable examples live in [`examples/`](examples/):
+
+| Example | Description |
+|---|---|
+| [`basic-crud.ts`](examples/basic-crud.ts) | Create, retrieve, update, list, and delete a vendor |
+| [`authSetup.ts`](examples/authSetup.ts) | Create a connection, generate a hosted QWC auth flow URL, and check auth status |
+| [`auto-pagination.ts`](examples/auto-pagination.ts) | Auto-iteration across pages plus manual page navigation |
+| [`connection-scoped.ts`](examples/connection-scoped.ts) | Multi-company isolation with `connectionId` |
+| [`error-handling.ts`](examples/error-handling.ts) | Error categorization and typed SDK errors |
+| [`pagination-walkthrough.ts`](examples/pagination-walkthrough.ts) | Cursor handling walkthrough |
+| [`reports.ts`](examples/reports.ts) | Aging, general detail, and general summary reports |
+| [`timeout-tuning.ts`](examples/timeout-tuning.ts) | Default timeout behavior, client-wide overrides, and per-request timeout tuning |
+
+
+## Error Handling
+
+All methods throw `NxusApiError` on non-2xx responses:
+
+```ts
+import { NxusClient, NxusApiError } from "nxus-qbd";
+
+try {
+  await nxus.vendors.retrieve("non-existent-id");
+} catch (err) {
+  if (err instanceof NxusApiError) {
+    console.log(err.status);          // 404
+    console.log(err.userMessage);     // User-safe message
+    console.log(err.isNotFound);      // true
+    console.log(err.isAuthError);     // false
+    console.log(err.isRateLimited);   // false
+  }
+}
+```
+
+## Resources
+
+All QuickBooks Desktop resources are available as namespaced properties:
+
+| Category | Resources |
+|---|---|
+| **Transactions** | `invoices`, `bills`, `checks`, `deposits`, `estimates`, `creditMemos`, `purchaseOrders`, `salesReceipts`, `journalEntries`, `receivePayments`, `vendorCredits`, `creditCardCharges`, `creditCardBills`, `creditCardCredits`, `charges`, `buildAssemblies`, `arRefundCreditCards`, `salesTaxPaymentChecks`, `itemReceipts`, `checkBills`, `timeTrackings`, `transactions` |
+| **Lists** | `accounts`, `customers`, `vendors`, `employees`, `otherNames`, `currencies`, `terms`, `dateDrivenTerms`, `paymentMethods`, `shipMethods`, `salesTaxCodes`, `priceLevels`, `qbdClasses`, `customerTypes`, `vendorTypes`, `billingRates`, `inventorySites`, `barCodes`, `accountTaxLineInfos`, `unitOfMeasureSets`, `specialItems` |
+| **Read-only** | `billToPay` |
+| **Items** | `items`, `inventoryItems`, `itemDiscounts`, `itemFixedAssets`, `itemGroups`, `itemInventoryAssemblies`, `itemNonInventory`, `itemOtherCharges`, `itemPayments`, `itemSalesTax`, `itemSalesTaxGroups`, `serviceItems`, `itemSubtotals` |
+| **Payroll** | `payrollItemNonWages`, `payrollItemWages`, `workersCompCodes` |
+| **Reports** | `reports.retrieveAging()`, `reports.retrieveGeneralDetail()`, `reports.retrieveGeneralSummary()`, `reports.retrieveBudgetSummary()`, `reports.retrieveJob()`, `reports.retrieveTime()`, `reports.retrieveCustomDetail()`, `reports.retrieveCustomSummary()`, `reports.retrievePayrollDetail()` |
+| **Platform** | `authSessions`, `connections` |
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -20,6 +20,7 @@
  * await nxus.vendors.delete('80000001-1234567890', { connectionId: '...' });
  * ```
  */
+import { type NxusLogger } from "./transport";
 import type { RequestOptions } from "./transport";
 import { type NxusEnvironment } from "./config";
 import { Resource, ReadOnlyResource, ListDeleteResource, ListRetrieveDeleteResource, ListRetrieveCreateResource, CrudNoUpdateResource, NoDeleteResource, CreateOnlyResource } from "./resources/base";
@@ -67,8 +68,32 @@ export interface NxusClientOptions {
      * `maxRetries` on the request options.
      */
     maxRetries?: number;
+    /**
+     * Emit debug logs for every request, response, retry, and error. Sensitive
+     * headers (Authorization, cookies, x-api-key) are redacted in the logs.
+     * Defaults to `false`. Providing `logger` implies `verbose: true`.
+     */
+    verbose?: boolean;
+    /**
+     * Custom structured logger. Plug in winston, pino, or any object that
+     * implements `{ debug, info, warn, error }`. When omitted and `verbose` is
+     * `true`, the SDK logs to `console`.
+     */
+    logger?: NxusLogger;
+    /**
+     * Outbound HTTP/HTTPS proxy URL (e.g. `"http://proxy.corp:8080"`). On Node,
+     * the SDK lazily loads `undici.ProxyAgent`. On Bun, the URL is passed
+     * through as the native `proxy` fetch option. No-op in browsers and Deno.
+     */
+    proxy?: string;
+    /**
+     * Extra options merged into every `fetch()` call. Escape hatch for
+     * runtime-specific features (e.g. custom `dispatcher` on Node/undici, `tls`
+     * on Bun).
+     */
+    fetchOptions?: Record<string, unknown>;
 }
-export type { RequestOptions };
+export type { RequestOptions, NxusLogger };
 export declare class NxusClient {
     private readonly transport;
     /**