@databricks/sdk-core 0.34.0 → 0.36.0

package/dist/clientinfo/agent.js

@@ -1,127 +1,149 @@
+import { sanitize } from "./clientinfo.js";
+
+//#region src/clientinfo/agent.ts
 /**
- * Detects the AI coding agent (e.g. Claude Code, Cursor, Gemini CLI) that
- * is running the current Node.js process. The detected product name is
- * appended to the user-agent header so that Databricks can understand
- * which agents are invoking the SDK.
- *
- * The agent list and precedence rules are kept in sync across the Go,
- * Java, Python, and TypeScript SDKs.
- *
- * @module
- */
-import { sanitize } from './clientinfo';
-// Name of the agents.md standard env var.
-const AGENT_ENV_VAR = 'AGENT';
-// Name of the Vercel @vercel/detect-agent convention env var. It serves
-// the same purpose as AGENT_ENV_VAR; agentEnvFallback consults it only when
-// AGENT_ENV_VAR is unset or empty.
-const AI_AGENT_ENV_VAR = 'AI_AGENT';
-// Caps fallback values to keep the user-agent bounded. Explicit-matcher
-// products are short by construction; only the fallback path can carry
-// arbitrary lengths.
+* Detects the AI coding agent (e.g. Claude Code, Cursor, Gemini CLI) that
+* is running the current Node.js process. The detected product name is
+* appended to the user-agent header so that Databricks can understand
+* which agents are invoking the SDK.
+*
+* The agent list and precedence rules are kept in sync across the Go,
+* Java, Python, and TypeScript SDKs.
+*
+* @module
+*/
+const AGENT_ENV_VAR = "AGENT";
+const AI_AGENT_ENV_VAR = "AI_AGENT";
 const MAX_AGENT_FALLBACK_LEN = 64;
-// Canonical list of AI coding agents. Keep this list, and the AGENT /
-// AI_AGENT fallback handling in agentEnvFallback, in sync with the Go,
-// Java, and Python SDKs. Agents are listed alphabetically by product name.
 const KNOWN_AGENTS = [
-    // The amp agent also sets AGENT=amp, handled by the central fallback.
-    { envVar: 'AMP_CURRENT_THREAD_ID', product: 'amp' },
-    { envVar: 'ANTIGRAVITY_AGENT', product: 'antigravity' },
-    { envVar: 'AUGMENT_AGENT', product: 'augment' },
-    { envVar: 'CLAUDECODE', product: 'claude-code' },
-    { envVar: 'CLINE_ACTIVE', product: 'cline' },
-    { envVar: 'CODEX_CI', product: 'codex' },
-    { envVar: 'COPILOT_CLI', product: 'copilot-cli' },
-    { envVar: 'CURSOR_AGENT', product: 'cursor' },
-    { envVar: 'GEMINI_CLI', product: 'gemini-cli' },
-    // The goose agent also sets AGENT=goose, handled by the central
-    // fallback.
-    { envVar: 'GOOSE_TERMINAL', product: 'goose' },
-    { envVar: 'KIRO', product: 'kiro' },
-    { envVar: 'OPENCLAW_SHELL', product: 'openclaw' },
-    { envVar: 'OPENCODE', product: 'opencode' },
-    // Set by VS Code 1.121+ for agent-initiated terminal commands
-    // (https://code.visualstudio.com/updates/v1_121).
-    { envVar: 'VSCODE_AGENT', product: 'vscode-agent' },
-    { envVar: 'WINDSURF_AGENT', product: 'windsurf' },
+	{
+		envVar: "AMP_CURRENT_THREAD_ID",
+		product: "amp"
+	},
+	{
+		envVar: "ANTIGRAVITY_AGENT",
+		product: "antigravity"
+	},
+	{
+		envVar: "AUGMENT_AGENT",
+		product: "augment"
+	},
+	{
+		envVar: "CLAUDECODE",
+		product: "claude-code"
+	},
+	{
+		envVar: "CLINE_ACTIVE",
+		product: "cline"
+	},
+	{
+		envVar: "CODEX_CI",
+		product: "codex"
+	},
+	{
+		envVar: "COPILOT_CLI",
+		product: "copilot-cli"
+	},
+	{
+		envVar: "CURSOR_AGENT",
+		product: "cursor"
+	},
+	{
+		envVar: "GEMINI_CLI",
+		product: "gemini-cli"
+	},
+	{
+		envVar: "GOOSE_TERMINAL",
+		product: "goose"
+	},
+	{
+		envVar: "KIRO",
+		product: "kiro"
+	},
+	{
+		envVar: "OPENCLAW_SHELL",
+		product: "openclaw"
+	},
+	{
+		envVar: "OPENCODE",
+		product: "opencode"
+	},
+	{
+		envVar: "VSCODE_AGENT",
+		product: "vscode-agent"
+	},
+	{
+		envVar: "WINDSURF_AGENT",
+		product: "windsurf"
+	}
 ];
 /**
- * Returns a sanitized, length-capped name from `AGENT` or `AI_AGENT`,
- * preferring `AGENT` when both are non-empty. Empty is treated as unset for
- * both. The value is passed through rather than categorized so that new
- * names are propagated without the need to update the list of known agents.
- */
+* Returns a sanitized, length-capped name from `AGENT` or `AI_AGENT`,
+* preferring `AGENT` when both are non-empty. Empty is treated as unset for
+* both. The value is passed through rather than categorized so that new
+* names are propagated without the need to update the list of known agents.
+*/
 function agentEnvFallback() {
-    let v = process.env[AGENT_ENV_VAR];
-    if (v === undefined || v === '') {
-        v = process.env[AI_AGENT_ENV_VAR];
-    }
-    if (v === undefined || v === '') {
-        return '';
-    }
-    // slice is a no-op when the value is already within the cap.
-    return sanitize(v).slice(0, MAX_AGENT_FALLBACK_LEN);
+	let v = process.env[AGENT_ENV_VAR];
+	if (v === void 0 || v === "") v = process.env[AI_AGENT_ENV_VAR];
+	if (v === void 0 || v === "") return "";
+	return sanitize(v).slice(0, MAX_AGENT_FALLBACK_LEN);
 }
 /**
- * Checks environment variables for known AI agents and returns the
- * detected product name.
- *
- * Explicit product-specific env vars always take precedence over the
- * generic `AGENT` and `AI_AGENT` env vars, so that an explicit signal
- * (e.g. `CLAUDECODE=1`) always wins over a conflicting `AGENT=<name>`
- * value.
- *
- * Returns:
- *
- * - The product name when exactly one known env var is set.
- * - `"multiple"` when multiple known env vars are set. Agent env vars
- *   can be stacked when one agent invokes another as a subagent (e.g.
- *   Claude Code spawning a Cursor CLI subprocess), so the child process
- *   inherits env vars from multiple layers.
- * - A sanitized, length-capped value from `AGENT` or `AI_AGENT` when no
- *   known env var is set (see {@link agentEnvFallback}).
- * - `""` when nothing is set.
- */
-export function lookupAgentProvider() {
-    const matches = [];
-    for (const a of KNOWN_AGENTS) {
-        if (a.envVar in process.env) {
-            matches.push(a.product);
-        }
-    }
-    if (matches.length === 1) {
-        return matches[0];
-    }
-    if (matches.length > 1) {
-        return 'multiple';
-    }
-    return agentEnvFallback();
+* Checks environment variables for known AI agents and returns the
+* detected product name.
+*
+* Explicit product-specific env vars always take precedence over the
+* generic `AGENT` and `AI_AGENT` env vars, so that an explicit signal
+* (e.g. `CLAUDECODE=1`) always wins over a conflicting `AGENT=<name>`
+* value.
+*
+* Returns:
+*
+* - The product name when exactly one known env var is set.
+* - `"multiple"` when multiple known env vars are set. Agent env vars
+*   can be stacked when one agent invokes another as a subagent (e.g.
+*   Claude Code spawning a Cursor CLI subprocess), so the child process
+*   inherits env vars from multiple layers.
+* - A sanitized, length-capped value from `AGENT` or `AI_AGENT` when no
+*   known env var is set (see {@link agentEnvFallback}).
+* - `""` when nothing is set.
+*/
+function lookupAgentProvider() {
+	const matches = [];
+	for (const a of KNOWN_AGENTS) if (a.envVar in process.env) matches.push(a.product);
+	if (matches.length === 1) return matches[0];
+	if (matches.length > 1) return "multiple";
+	return agentEnvFallback();
 }
 let cached;
 /**
- * Returns the detected AI agent name, cached for the process lifetime.
- *
- * Returns one of:
- *
- * - The known product name when exactly one agent is detected via
- *   explicit env matchers.
- * - `"multiple"` when multiple explicit matchers fire for different
- *   agents (typically nested agents, e.g. Cursor CLI running as a
- *   Claude Code subagent).
- * - A sanitized, length-capped value from `AGENT` or `AI_AGENT` when no
- *   explicit matcher fired (see {@link agentEnvFallback}).
- * - `""` when no agent is detected.
- */
-export function agentProvider() {
-    cached ??= lookupAgentProvider();
-    return cached;
+* Returns the detected AI agent name, cached for the process lifetime.
+*
+* Returns one of:
+*
+* - The known product name when exactly one agent is detected via
+*   explicit env matchers.
+* - `"multiple"` when multiple explicit matchers fire for different
+*   agents (typically nested agents, e.g. Cursor CLI running as a
+*   Claude Code subagent).
+* - A sanitized, length-capped value from `AGENT` or `AI_AGENT` when no
+*   explicit matcher fired (see {@link agentEnvFallback}).
+* - `""` when no agent is detected.
+*/
+function agentProvider() {
+	cached ??= lookupAgentProvider();
+	return cached;
 }
 /**
- * Clears the cached agent detection result so that the next call to
- * {@link agentProvider} re-evaluates the environment. Exported for
- * testing only.
- */
-export function clearAgentCache() {
-    cached = undefined;
+* Clears the cached agent detection result so that the next call to
+* {@link agentProvider} re-evaluates the environment. Exported for
+* testing only.
+*/
+function clearAgentCache() {
+	cached = void 0;
 }
+
+//#endregion
+export { agentProvider, clearAgentCache, lookupAgentProvider };
 //# sourceMappingURL=agent.js.map

package/dist/clientinfo/agent.js.map

@@ -1 +1 @@
-{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/clientinfo/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.js","names":[],"sources":["../../src/clientinfo/agent.ts"],"sourcesContent":["/**\n * Detects the AI coding agent (e.g. Claude Code, Cursor, Gemini CLI) that\n * is running the current Node.js process. The detected product name is\n * appended to the user-agent header so that Databricks can understand\n * which agents are invoking the SDK.\n *\n * The agent list and precedence rules are kept in sync across the Go,\n * Java, Python, and TypeScript SDKs.\n *\n * @module\n */\n\nimport {sanitize} from './clientinfo';\n\ninterface KnownAgent {\n  readonly envVar: string;\n  readonly product: string;\n}\n\n// Name of the agents.md standard env var.\nconst AGENT_ENV_VAR = 'AGENT';\n\n// Name of the Vercel @vercel/detect-agent convention env var. It serves\n// the same purpose as AGENT_ENV_VAR; agentEnvFallback consults it only when\n// AGENT_ENV_VAR is unset or empty.\nconst AI_AGENT_ENV_VAR = 'AI_AGENT';\n\n// Caps fallback values to keep the user-agent bounded. Explicit-matcher\n// products are short by construction; only the fallback path can carry\n// arbitrary lengths.\nconst MAX_AGENT_FALLBACK_LEN = 64;\n\n// Canonical list of AI coding agents. Keep this list, and the AGENT /\n// AI_AGENT fallback handling in agentEnvFallback, in sync with the Go,\n// Java, and Python SDKs. Agents are listed alphabetically by product name.\nconst KNOWN_AGENTS: readonly KnownAgent[] = [\n  // The amp agent also sets AGENT=amp, handled by the central fallback.\n  {envVar: 'AMP_CURRENT_THREAD_ID', product: 'amp'},\n  {envVar: 'ANTIGRAVITY_AGENT', product: 'antigravity'},\n  {envVar: 'AUGMENT_AGENT', product: 'augment'},\n  {envVar: 'CLAUDECODE', product: 'claude-code'},\n  {envVar: 'CLINE_ACTIVE', product: 'cline'},\n  {envVar: 'CODEX_CI', product: 'codex'},\n  {envVar: 'COPILOT_CLI', product: 'copilot-cli'},\n  {envVar: 'CURSOR_AGENT', product: 'cursor'},\n  {envVar: 'GEMINI_CLI', product: 'gemini-cli'},\n  // The goose agent also sets AGENT=goose, handled by the central\n  // fallback.\n  {envVar: 'GOOSE_TERMINAL', product: 'goose'},\n  {envVar: 'KIRO', product: 'kiro'},\n  {envVar: 'OPENCLAW_SHELL', product: 'openclaw'},\n  {envVar: 'OPENCODE', product: 'opencode'},\n  // Set by VS Code 1.121+ for agent-initiated terminal commands\n  // (https://code.visualstudio.com/updates/v1_121).\n  {envVar: 'VSCODE_AGENT', product: 'vscode-agent'},\n  {envVar: 'WINDSURF_AGENT', product: 'windsurf'},\n];\n\n/**\n * Returns a sanitized, length-capped name from `AGENT` or `AI_AGENT`,\n * preferring `AGENT` when both are non-empty. Empty is treated as unset for\n * both. The value is passed through rather than categorized so that new\n * names are propagated without the need to update the list of known agents.\n */\nfunction agentEnvFallback(): string {\n  let v = process.env[AGENT_ENV_VAR];\n  if (v === undefined || v === '') {\n    v = process.env[AI_AGENT_ENV_VAR];\n  }\n  if (v === undefined || v === '') {\n    return '';\n  }\n  // slice is a no-op when the value is already within the cap.\n  return sanitize(v).slice(0, MAX_AGENT_FALLBACK_LEN);\n}\n\n/**\n * Checks environment variables for known AI agents and returns the\n * detected product name.\n *\n * Explicit product-specific env vars always take precedence over the\n * generic `AGENT` and `AI_AGENT` env vars, so that an explicit signal\n * (e.g. `CLAUDECODE=1`) always wins over a conflicting `AGENT=<name>`\n * value.\n *\n * Returns:\n *\n * - The product name when exactly one known env var is set.\n * - `\"multiple\"` when multiple known env vars are set. Agent env vars\n *   can be stacked when one agent invokes another as a subagent (e.g.\n *   Claude Code spawning a Cursor CLI subprocess), so the child process\n *   inherits env vars from multiple layers.\n * - A sanitized, length-capped value from `AGENT` or `AI_AGENT` when no\n *   known env var is set (see {@link agentEnvFallback}).\n * - `\"\"` when nothing is set.\n */\nexport function lookupAgentProvider(): string {\n  const matches: string[] = [];\n  for (const a of KNOWN_AGENTS) {\n    if (a.envVar in process.env) {\n      matches.push(a.product);\n    }\n  }\n  if (matches.length === 1) {\n    return matches[0];\n  }\n  if (matches.length > 1) {\n    return 'multiple';\n  }\n  return agentEnvFallback();\n}\n\nlet cached: string | undefined;\n\n/**\n * Returns the detected AI agent name, cached for the process lifetime.\n *\n * Returns one of:\n *\n * - The known product name when exactly one agent is detected via\n *   explicit env matchers.\n * - `\"multiple\"` when multiple explicit matchers fire for different\n *   agents (typically nested agents, e.g. Cursor CLI running as a\n *   Claude Code subagent).\n * - A sanitized, length-capped value from `AGENT` or `AI_AGENT` when no\n *   explicit matcher fired (see {@link agentEnvFallback}).\n * - `\"\"` when no agent is detected.\n */\nexport function agentProvider(): string {\n  cached ??= lookupAgentProvider();\n  return cached;\n}\n\n/**\n * Clears the cached agent detection result so that the next call to\n * {@link agentProvider} re-evaluates the environment. Exported for\n * testing only.\n */\nexport function clearAgentCache(): void {\n  cached = undefined;\n}\n"],"mappings":";;;;;;;;;;;;;;AAoBA,MAAM,gBAAgB;AAKtB,MAAM,mBAAmB;AAKzB,MAAM,yBAAyB;AAK/B,MAAM,eAAsC;CAE1C;EAAC,QAAQ;EAAyB,SAAS;EAAM;CACjD;EAAC,QAAQ;EAAqB,SAAS;EAAc;CACrD;EAAC,QAAQ;EAAiB,SAAS;EAAU;CAC7C;EAAC,QAAQ;EAAc,SAAS;EAAc;CAC9C;EAAC,QAAQ;EAAgB,SAAS;EAAQ;CAC1C;EAAC,QAAQ;EAAY,SAAS;EAAQ;CACtC;EAAC,QAAQ;EAAe,SAAS;EAAc;CAC/C;EAAC,QAAQ;EAAgB,SAAS;EAAS;CAC3C;EAAC,QAAQ;EAAc,SAAS;EAAa;CAG7C;EAAC,QAAQ;EAAkB,SAAS;EAAQ;CAC5C;EAAC,QAAQ;EAAQ,SAAS;EAAO;CACjC;EAAC,QAAQ;EAAkB,SAAS;EAAW;CAC/C;EAAC,QAAQ;EAAY,SAAS;EAAW;CAGzC;EAAC,QAAQ;EAAgB,SAAS;EAAe;CACjD;EAAC,QAAQ;EAAkB,SAAS;EAAW;CAChD;;;;;;;AAQD,SAAS,mBAA2B;CAClC,IAAI,IAAI,QAAQ,IAAI;AACpB,KAAI,MAAM,UAAa,MAAM,GAC3B,KAAI,QAAQ,IAAI;AAElB,KAAI,MAAM,UAAa,MAAM,GAC3B,QAAO;AAGT,QAAO,SAAS,EAAE,CAAC,MAAM,GAAG,uBAAuB;;;;;;;;;;;;;;;;;;;;;;AAuBrD,SAAgB,sBAA8B;CAC5C,MAAM,UAAoB,EAAE;AAC5B,MAAK,MAAM,KAAK,aACd,KAAI,EAAE,UAAU,QAAQ,IACtB,SAAQ,KAAK,EAAE,QAAQ;AAG3B,KAAI,QAAQ,WAAW,EACrB,QAAO,QAAQ;AAEjB,KAAI,QAAQ,SAAS,EACnB,QAAO;AAET,QAAO,kBAAkB;;AAG3B,IAAI;;;;;;;;;;;;;;;AAgBJ,SAAgB,gBAAwB;AACtC,YAAW,qBAAqB;AAChC,QAAO;;;;;;;AAQT,SAAgB,kBAAwB;AACtC,UAAS"}

package/dist/clientinfo/base.d.ts

@@ -1,12 +1,8 @@
-/**
- * Shared state management for {@link ClientInfo} defaults. This module
- * is browser-safe and contains no Node.js-specific APIs.
- *
- * @module
- */
-import { ClientInfo } from './clientinfo';
-export declare const MODULE_NAME = "sdk-js-core";
-export declare const VERSION: string;
+import { ClientInfo } from "./clientinfo.js";
+
+//#region src/clientinfo/base.d.ts
+declare const MODULE_NAME = "sdk-js-core";
+declare const VERSION: string;
 /**
  * Sets the product name and version globally. The version must be a
  * valid semver string.
@@ -14,7 +10,7 @@ export declare const VERSION: string;
  * Must be called before any client is created. Not safe for concurrent
  * use.
  */
-export declare function setProduct(name: string, version: string): void;
+declare function setProduct(name: string, version: string): void;
 /**
  * Adds a partner identifier globally. Partner attribution is a
  * first-class concept used for support ticket routing.
@@ -22,7 +18,7 @@ export declare function setProduct(name: string, version: string): void;
  * Must be called before any client is created. Not safe for concurrent
  * use.
  */
-export declare function setPartner(partner: string): void;
+declare function setPartner(partner: string): void;
 /**
  * Adds a global key/value segment that will be included in every
  * {@link createDefault} call. Same key with different values is allowed
@@ -32,8 +28,10 @@ export declare function setPartner(partner: string): void;
  * Must be called before any client is created. Not safe for concurrent
  * use.
  */
-export declare function addToDefault(key: string, value: string): void;
-export declare function getBase(): ClientInfo;
-export declare function resetBase(): void;
-export declare function baseToString(): string;
+declare function addToDefault(key: string, value: string): void;
+declare function getBase(): ClientInfo;
+declare function resetBase(): void;
+declare function baseToString(): string;
+//#endregion
+export { MODULE_NAME, VERSION, addToDefault, baseToString, getBase, resetBase, setPartner, setProduct };
 //# sourceMappingURL=base.d.ts.map

package/dist/clientinfo/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/clientinfo/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,UAAU,EAA4B,MAAM,cAAc,CAAC;AAGnE,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,OAAO,EAAE,MAAwB,CAAC;AAM/C;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQ9D;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAEhD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAE7D;AAGD,wBAAgB,OAAO,IAAI,UAAU,CAEpC;AAGD,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAID,wBAAgB,YAAY,IAAI,MAAM,CAErC"}
+{"version":3,"file":"base.d.ts","names":[],"sources":["../../src/clientinfo/base.ts"],"mappings":";;;cAUa,WAAA;AAAA,cACA,OAAA;;;;;AAab;;;iBAAgB,UAAA,CAAW,IAAA,UAAc,OAAA;;AAiBzC;;;;;AAaA;iBAbgB,UAAA,CAAW,OAAA;;;;AAkB3B;;;;;AAKA;iBAVgB,YAAA,CAAa,GAAA,UAAa,KAAA;AAAA,iBAK1B,OAAA,CAAA,GAAW,UAAA;AAAA,iBAKX,SAAA,CAAA;AAAA,iBAMA,YAAA,CAAA"}

package/dist/clientinfo/base.js

@@ -1,62 +1,62 @@
+import { ClientInfo, ClientInfoError, isSemVer } from "./clientinfo.js";
+import { version } from "../package.js";
+
+//#region src/clientinfo/base.ts
 /**
- * Shared state management for {@link ClientInfo} defaults. This module
- * is browser-safe and contains no Node.js-specific APIs.
- *
- * @module
- */
-import { ClientInfo, ClientInfoError, isSemVer } from './clientinfo';
-import pkgJson from '../../package.json' with { type: 'json' };
-export const MODULE_NAME = 'sdk-js-core';
-export const VERSION = pkgJson.version;
-// Holds segments added via addToDefault, setProduct, and setPartner.
-// createDefault returns a copy of this with env detection appended.
+* Shared state management for {@link ClientInfo} defaults. This module
+* is browser-safe and contains no Node.js-specific APIs.
+*
+* @module
+*/
+const MODULE_NAME = "sdk-js-core";
+const VERSION = version;
 let base = ClientInfo.EMPTY;
 /**
- * Sets the product name and version globally. The version must be a
- * valid semver string.
- *
- * Must be called before any client is created. Not safe for concurrent
- * use.
- */
-export function setProduct(name, version) {
-    if (!isSemVer(version)) {
-        throw new ClientInfoError('INVALID_VERSION', `Invalid version: ${version}.`);
-    }
-    addToDefault(name, version);
+* Sets the product name and version globally. The version must be a
+* valid semver string.
+*
+* Must be called before any client is created. Not safe for concurrent
+* use.
+*/
+function setProduct(name, version) {
+	if (!isSemVer(version)) throw new ClientInfoError("INVALID_VERSION", `Invalid version: ${version}.`);
+	addToDefault(name, version);
 }
 /**
- * Adds a partner identifier globally. Partner attribution is a
- * first-class concept used for support ticket routing.
- *
- * Must be called before any client is created. Not safe for concurrent
- * use.
- */
-export function setPartner(partner) {
-    addToDefault('partner', partner);
+* Adds a partner identifier globally. Partner attribution is a
+* first-class concept used for support ticket routing.
+*
+* Must be called before any client is created. Not safe for concurrent
+* use.
+*/
+function setPartner(partner) {
+	addToDefault("partner", partner);
 }
 /**
- * Adds a global key/value segment that will be included in every
- * {@link createDefault} call. Same key with different values is allowed
- * (e.g., multiple partners). Exact key+value duplicates are silently
- * ignored.
- *
- * Must be called before any client is created. Not safe for concurrent
- * use.
- */
-export function addToDefault(key, value) {
-    base = base.with({ key, value });
+* Adds a global key/value segment that will be included in every
+* {@link createDefault} call. Same key with different values is allowed
+* (e.g., multiple partners). Exact key+value duplicates are silently
+* ignored.
+*
+* Must be called before any client is created. Not safe for concurrent
+* use.
+*/
+function addToDefault(key, value) {
+	base = base.with({
+		key,
+		value
+	});
 }
-// Returns the base ClientInfo for use in createDefault.
-export function getBase() {
-    return base;
+function getBase() {
+	return base;
 }
-// Resets the base segments. Exported for testing only.
-export function resetBase() {
-    base = ClientInfo.EMPTY;
+function resetBase() {
+	base = ClientInfo.EMPTY;
 }
-// Returns the base segments as a formatted string. Exported for
-// testing only.
-export function baseToString() {
-    return base.toString();
+function baseToString() {
+	return base.toString();
 }
+
+//#endregion
+export { MODULE_NAME, VERSION, addToDefault, baseToString, getBase, resetBase, setPartner, setProduct };
 //# sourceMappingURL=base.js.map

package/dist/clientinfo/base.js.map

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/clientinfo/base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAC,UAAU,EAAE,eAAe,EAAE,QAAQ,EAAC,MAAM,cAAc,CAAC;AACnE,OAAO,OAAO,MAAM,oBAAoB,CAAC,OAAM,IAAI,EAAE,MAAM,EAAC,CAAC;AAE7D,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;AACzC,MAAM,CAAC,MAAM,OAAO,GAAW,OAAO,CAAC,OAAO,CAAC;AAE/C,qEAAqE;AACrE,oEAAoE;AACpE,IAAI,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC;AAE5B;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,OAAe;IACtD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,eAAe,CACvB,iBAAiB,EACjB,oBAAoB,OAAO,GAAG,CAC/B,CAAC;IACJ,CAAC;IACD,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC9B,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe;IACxC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW,EAAE,KAAa;IACrD,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,EAAC,GAAG,EAAE,KAAK,EAAC,CAAC,CAAC;AACjC,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,OAAO;IACrB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,SAAS;IACvB,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC;AAC1B,CAAC;AAED,gEAAgE;AAChE,gBAAgB;AAChB,MAAM,UAAU,YAAY;IAC1B,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;AACzB,CAAC"}
+{"version":3,"file":"base.js","names":["pkgJson.version"],"sources":["../../src/clientinfo/base.ts"],"sourcesContent":["/**\n * Shared state management for {@link ClientInfo} defaults. This module\n * is browser-safe and contains no Node.js-specific APIs.\n *\n * @module\n */\n\nimport {ClientInfo, ClientInfoError, isSemVer} from './clientinfo';\nimport pkgJson from '../../package.json' with {type: 'json'};\n\nexport const MODULE_NAME = 'sdk-js-core';\nexport const VERSION: string = pkgJson.version;\n\n// Holds segments added via addToDefault, setProduct, and setPartner.\n// createDefault returns a copy of this with env detection appended.\nlet base = ClientInfo.EMPTY;\n\n/**\n * Sets the product name and version globally. The version must be a\n * valid semver string.\n *\n * Must be called before any client is created. Not safe for concurrent\n * use.\n */\nexport function setProduct(name: string, version: string): void {\n  if (!isSemVer(version)) {\n    throw new ClientInfoError(\n      'INVALID_VERSION',\n      `Invalid version: ${version}.`\n    );\n  }\n  addToDefault(name, version);\n}\n\n/**\n * Adds a partner identifier globally. Partner attribution is a\n * first-class concept used for support ticket routing.\n *\n * Must be called before any client is created. Not safe for concurrent\n * use.\n */\nexport function setPartner(partner: string): void {\n  addToDefault('partner', partner);\n}\n\n/**\n * Adds a global key/value segment that will be included in every\n * {@link createDefault} call. Same key with different values is allowed\n * (e.g., multiple partners). Exact key+value duplicates are silently\n * ignored.\n *\n * Must be called before any client is created. Not safe for concurrent\n * use.\n */\nexport function addToDefault(key: string, value: string): void {\n  base = base.with({key, value});\n}\n\n// Returns the base ClientInfo for use in createDefault.\nexport function getBase(): ClientInfo {\n  return base;\n}\n\n// Resets the base segments. Exported for testing only.\nexport function resetBase(): void {\n  base = ClientInfo.EMPTY;\n}\n\n// Returns the base segments as a formatted string. Exported for\n// testing only.\nexport function baseToString(): string {\n  return base.toString();\n}\n"],"mappings":";;;;;;;;;;AAUA,MAAa,cAAc;AAC3B,MAAa,UAAkBA;AAI/B,IAAI,OAAO,WAAW;;;;;;;;AAStB,SAAgB,WAAW,MAAc,SAAuB;AAC9D,KAAI,CAAC,SAAS,QAAQ,CACpB,OAAM,IAAI,gBACR,mBACA,oBAAoB,QAAQ,GAC7B;AAEH,cAAa,MAAM,QAAQ;;;;;;;;;AAU7B,SAAgB,WAAW,SAAuB;AAChD,cAAa,WAAW,QAAQ;;;;;;;;;;;AAYlC,SAAgB,aAAa,KAAa,OAAqB;AAC7D,QAAO,KAAK,KAAK;EAAC;EAAK;EAAM,CAAC;;AAIhC,SAAgB,UAAsB;AACpC,QAAO;;AAIT,SAAgB,YAAkB;AAChC,QAAO,WAAW;;AAKpB,SAAgB,eAAuB;AACrC,QAAO,KAAK,UAAU"}

package/dist/clientinfo/clientinfo.d.ts

@@ -1,3 +1,4 @@
+//#region src/clientinfo/clientinfo.d.ts
 /**
  * Collects information about the client and its environment into an
  * immutable {@link ClientInfo} value.
@@ -7,55 +8,56 @@
  *
  * @module
  */
-export type ClientInfoErrorCode = 'INVALID_KEY' | 'INVALID_VALUE' | 'INVALID_VERSION';
-export declare class ClientInfoError extends Error {
-    readonly code: ClientInfoErrorCode;
-    constructor(code: ClientInfoErrorCode, message: string);
+type ClientInfoErrorCode = 'INVALID_KEY' | 'INVALID_VALUE' | 'INVALID_VERSION';
+declare class ClientInfoError extends Error {
+  readonly code: ClientInfoErrorCode;
+  constructor(code: ClientInfoErrorCode, message: string);
 }
 interface Segment {
-    readonly key: string;
-    readonly value: string;
+  readonly key: string;
+  readonly value: string;
 }
-export declare function isSemVer(s: string): boolean;
-export declare function isValidSegment(s: string): boolean;
+declare function isSemVer(s: string): boolean;
+declare function isValidSegment(s: string): boolean;
 /**
  * Replaces characters that are not valid in segment values with
  * hyphens. Used for environment-sourced values (runtime version,
  * upstream) that we do not control and cannot reject.
  */
-export declare function sanitize(s: string): string;
+declare function sanitize(s: string): string;
 /**
  * ClientInfo is an immutable, ordered list of key/value segments. Use
  * {@link ClientInfo.with} to derive new values with additional segments.
  */
-export declare class ClientInfo {
-    static readonly EMPTY: ClientInfo;
-    readonly segments: readonly Segment[];
-    private constructor();
-    /**
-     * Returns a new {@link ClientInfo} with the given items appended. Accepts
-     * either individual key/value pairs or another {@link ClientInfo} whose
-     * segments are merged in order. The original is not modified; mixing the
-     * two forms in a single call is supported.
-     *
-     * Keys and values on pair arguments must contain only alphanumeric
-     * characters plus `_`, `.`, `+`, or `-`. Exact key+value duplicates are
-     * silently ignored. On error, an exception is thrown (all-or-nothing).
-     *
-     * @example
-     * ```ts
-     * base.with({key: 'partner', value: 'acme'});
-     * base.with(pkgClientInfo);
-     * base.with(pkgClientInfo, {key: 'sdk-feature', value: 'pagination'});
-     * ```
-     */
-    with(...items: (ClientInfo | Segment)[]): ClientInfo;
-    /**
-     * Returns a string representation of the client info suitable for
-     * inclusion in HTTP headers. Key/value pairs are formatted as
-     * "key/value" and joined by spaces in the order they were inserted.
-     */
-    toString(): string;
+declare class ClientInfo {
+  static readonly EMPTY: ClientInfo;
+  readonly segments: readonly Segment[];
+  private constructor();
+  /**
+   * Returns a new {@link ClientInfo} with the given items appended. Accepts
+   * either individual key/value pairs or another {@link ClientInfo} whose
+   * segments are merged in order. The original is not modified; mixing the
+   * two forms in a single call is supported.
+   *
+   * Keys and values on pair arguments must contain only alphanumeric
+   * characters plus `_`, `.`, `+`, or `-`. Exact key+value duplicates are
+   * silently ignored. On error, an exception is thrown (all-or-nothing).
+   *
+   * @example
+   * ```ts
+   * base.with({key: 'partner', value: 'acme'});
+   * base.with(pkgClientInfo);
+   * base.with(pkgClientInfo, {key: 'sdk-feature', value: 'pagination'});
+   * ```
+   */
+  with(...items: (ClientInfo | Segment)[]): ClientInfo;
+  /**
+   * Returns a string representation of the client info suitable for
+   * inclusion in HTTP headers. Key/value pairs are formatted as
+   * "key/value" and joined by spaces in the order they were inserted.
+   */
+  toString(): string;
 }
-export {};
+//#endregion
+export { ClientInfo, ClientInfoError, ClientInfoErrorCode, isSemVer, isValidSegment, sanitize };
 //# sourceMappingURL=clientinfo.d.ts.map

package/dist/clientinfo/clientinfo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"clientinfo.d.ts","sourceRoot":"","sources":["../../src/clientinfo/clientinfo.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,mBAAmB,GAC3B,aAAa,GACb,eAAe,GACf,iBAAiB,CAAC;AAEtB,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;gBAEvB,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,MAAM;CAKvD;AAED,UAAU,OAAO;IACf,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAcD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED;;;GAGG;AACH,qBAAa,UAAU;IACrB,MAAM,CAAC,QAAQ,CAAC,KAAK,aAAoB;IAEzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IAEtC,OAAO;IAMP;;;;;;;;;;;;;;;;OAgBG;IACH,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,UAAU,GAAG,OAAO,CAAC,EAAE,GAAG,UAAU;IA6BpD;;;;OAIG;IACH,QAAQ,IAAI,MAAM;CAGnB"}
+{"version":3,"file":"clientinfo.d.ts","names":[],"sources":["../../src/clientinfo/clientinfo.ts"],"mappings":";;AAUA;;;;;AAKA;;;KALY,mBAAA;AAAA,cAKC,eAAA,SAAwB,KAAA;EAAA,SAC1B,IAAA,EAAM,mBAAA;cAEH,IAAA,EAAM,mBAAA,EAAqB,OAAA;AAAA;AAAA,UAO/B,OAAA;EAAA,SACC,GAAA;EAAA,SACA,KAAA;AAAA;AAAA,iBAeK,QAAA,CAAS,CAAA;AAAA,iBAIT,cAAA,CAAe,CAAA;;;;AAvB9B;;iBAgCe,QAAA,CAAS,CAAA;;;AAbzB;;cAqBa,UAAA;EAAA,gBACK,KAAA,EAAK,UAAA;EAAA,SAEZ,QAAA,WAAmB,OAAA;EAAA,QAErB,WAAA,CAAA;EAtBqB;;;;AAS9B;;;;;AAQA;;;;;;;;EA4BE,IAAA,CAAA,GAAQ,KAAA,GAAQ,UAAA,GAAa,OAAA,MAAa,UAAA;EAAU;;;;;EAkCpD,QAAA,CAAA;AAAA"}