feat: send X-Axme-Client header for AXME analytics

src/client.ts

@@ -6,6 +6,7 @@ import {
   AxmeValidationError,
 } from "./errors.js";
 import { MeshClient } from "./mesh.js";
+import { SDK_VERSION } from "./version.js";
 
 export type AxmeClientConfig = {
   baseUrl?: string;
@@ -1921,6 +1922,7 @@ export class AxmeClient {
     const headers: Record<string, string> = {
       "x-api-key": this.apiKey,
       "Content-Type": "application/json",
+      "X-Axme-Client": `axme-sdk-typescript/${SDK_VERSION}`,
     };
     if (this.actorToken) {
       headers.Authorization = `Bearer ${this.actorToken}`;

src/index.ts

@@ -1,3 +1,4 @@
+export { SDK_VERSION } from "./version.js";
 export {
   AxmeClient,
   type AxmeClientConfig,

src/version.ts

@@ -0,0 +1,3 @@
+// Single source of truth for the SDK version sent in X-Axme-Client header.
+// Keep in sync with package.json version field on every release.
+export const SDK_VERSION = "0.2.0";

test/client.test.ts

@@ -50,6 +50,19 @@ test("health returns parsed payload", async () => {
   assert.deepEqual(await client.health(), { ok: true });
 });
 
+test("health sends X-Axme-Client header", async () => {
+  const { SDK_VERSION } = await import("../src/version.js");
+  const client = new AxmeClient(
+    { baseUrl: "https://api.axme.test", apiKey: "token" },
+    async (_input, init) => {
+      const headers = init?.headers as Record<string, string>;
+      assert.equal(headers["X-Axme-Client"], `axme-sdk-typescript/${SDK_VERSION}`);
+      return new Response(JSON.stringify({ ok: true }), { status: 200 });
+    },
+  );
+  await client.health();
+});
+
 test("health includes actor token authorization when configured", async () => {
   const client = new AxmeClient(
     {