@nexusm/sdk 5.0.0 → 5.1.0

package/dist/index.mjs

@@ -727,6 +727,30 @@ var HttpClient = class {
     this.cache.invalidate(path.split("/").filter(Boolean)[0] ?? path);
     return result;
   }
+  /**
+   * Send a GET request and return the raw response body as a string.
+   *
+   * Intended for file-download endpoints (e.g. `GET /dashboard/export`) that
+   * return `text/csv` or `application/json` as a raw file stream rather than a
+   * JSON-parsed object.  The retry and auth interceptors still apply; the
+   * response cache is intentionally bypassed (export payloads are not cacheable
+   * at the SDK layer).
+   *
+   * @param path   - URL path relative to the base URL (e.g. `/dashboard/export`).
+   * @param params - Optional query parameters.
+   * @param signal - Optional {@link AbortSignal} to cancel the request.
+   * @returns The raw response body as a string.
+   */
+  async getText(path, params, signal) {
+    return this.retry.execute(async () => {
+      const response = await this.axios.get(path, {
+        params,
+        signal,
+        responseType: "text"
+      });
+      return response.data;
+    });
+  }
   /**
    * Send a DELETE request.
    *
@@ -1343,6 +1367,35 @@ var ErrorService = class extends BaseService {
   }
 };
 
+// src/services/dashboard.ts
+var DashboardService = class extends BaseService {
+  /**
+   * Export a dashboard dataset as raw file content.
+   *
+   * Sends `GET /dashboard/export` with the given query parameters and returns
+   * the raw response body as a string.  The string is exactly the file the
+   * server would send for a browser download:
+   * - `format: 'csv'` (default) → comma-separated text
+   * - `format: 'json'`          → JSON text (not parsed into an object)
+   *
+   * @param params  - Dataset selection and format options.
+   * @param options - Optional request options (e.g. AbortSignal).
+   * @returns Raw file body string.
+   *
+   * @throws {ApiError} HTTP 401 — missing or invalid API key.
+   * @throws {ApiError} HTTP 403 — `target_tenant_id` requires admin scope.
+   * @throws {ApiError} HTTP 422 — `dataset` is not one of the six whitelisted values.
+   */
+  async export(params, options) {
+    const query = { dataset: params.dataset };
+    if (params.format !== void 0) query["format"] = params.format;
+    if (params.target_tenant_id !== void 0) {
+      query["target_tenant_id"] = params.target_tenant_id;
+    }
+    return this.http.getText("/dashboard/export", query, options?.signal);
+  }
+};
+
 // src/client.ts
 var NexusClient = class {
   /**
@@ -1364,6 +1417,7 @@ var NexusClient = class {
     this.tenants = new TenantService(this.http);
     this.feedback = new FeedbackService(this.http);
     this.errors = new ErrorService(this.http);
+    this.dashboard = new DashboardService(this.http);
     if (resolved.autoErrorReport) {
       this.http.onApiError = (statusCode, method, url, detail) => {
         this.errors.submit({