@nodaro/sdk 1.11.0 → 1.12.0

package/dist/index.d.cts

@@ -4438,6 +4438,14 @@ interface ClientOptions {
     fetch?: typeof fetch;
     /** Default request timeout in ms. Default 60s. */
     timeoutMs?: number;
+    /**
+     * Overrides the `X-Nodaro-Client` label. Defaults to `sdk/<version>`.
+     *
+     * Exists for `@nodaro/cli`, which is a wrapper AROUND this SDK: without an
+     * override every CLI invocation would be recorded as an SDK call and the two
+     * surfaces could never be told apart.
+     */
+    clientLabel?: string;
 }
 interface RequestOptions {
     body?: unknown;
@@ -4466,6 +4474,10 @@ declare class NodaroClient {
     readonly baseUrl: string;
     readonly auth: Auth;
     readonly timeoutMs: number;
+    /** Value sent as `X-Nodaro-Client`; recorded by the backend as job provenance. */
+    readonly clientLabel: string;
+    /** Whether to actually send it — see the note on {@link CLIENT_HEADER}. */
+    private readonly sendClientHeader;
     private readonly fetchOverride;
     /**
      * Resolved lazily so consumers can swap `globalThis.fetch` after the

package/dist/index.d.ts

@@ -4438,6 +4438,14 @@ interface ClientOptions {
     fetch?: typeof fetch;
     /** Default request timeout in ms. Default 60s. */
     timeoutMs?: number;
+    /**
+     * Overrides the `X-Nodaro-Client` label. Defaults to `sdk/<version>`.
+     *
+     * Exists for `@nodaro/cli`, which is a wrapper AROUND this SDK: without an
+     * override every CLI invocation would be recorded as an SDK call and the two
+     * surfaces could never be told apart.
+     */
+    clientLabel?: string;
 }
 interface RequestOptions {
     body?: unknown;
@@ -4466,6 +4474,10 @@ declare class NodaroClient {
     readonly baseUrl: string;
     readonly auth: Auth;
     readonly timeoutMs: number;
+    /** Value sent as `X-Nodaro-Client`; recorded by the backend as job provenance. */
+    readonly clientLabel: string;
+    /** Whether to actually send it — see the note on {@link CLIENT_HEADER}. */
+    private readonly sendClientHeader;
     private readonly fetchOverride;
     /**
      * Resolved lazily so consumers can swap `globalThis.fetch` after the

package/dist/index.js

@@ -2117,10 +2117,17 @@ var CommunityResource = class {
 };
 
 // src/client.ts
+var SDK_VERSION = "1.12.0" ;
+var CLIENT_HEADER = "X-Nodaro-Client";
+var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class {
   baseUrl;
   auth;
   timeoutMs;
+  /** Value sent as `X-Nodaro-Client`; recorded by the backend as job provenance. */
+  clientLabel;
+  /** Whether to actually send it — see the note on {@link CLIENT_HEADER}. */
+  sendClientHeader;
   fetchOverride;
   /**
    * Resolved lazily so consumers can swap `globalThis.fetch` after the
@@ -2161,6 +2168,8 @@ var NodaroClient = class {
     this.auth = opts.auth;
     this.fetchOverride = opts.fetch;
     this.timeoutMs = opts.timeoutMs ?? 6e4;
+    this.clientLabel = opts.clientLabel ?? `sdk/${SDK_VERSION}`;
+    this.sendClientHeader = opts.clientLabel !== void 0 || !isBrowser();
     this.workflows = new WorkflowsResource(this);
     this.projects = new ProjectsResource(this);
     this.jobs = new JobsResource(this);
@@ -2193,6 +2202,7 @@ var NodaroClient = class {
     const isFormData = typeof FormData !== "undefined" && options.body instanceof FormData;
     const headers = {
       ...isFormData ? {} : { "Content-Type": "application/json" },
+      ...this.sendClientHeader ? { [CLIENT_HEADER]: this.clientLabel } : {},
       ...options.headers ?? {}
     };
     if (token) headers["Authorization"] = `Bearer ${token}`;