@symbo.ls/sdk 2.32.6 → 2.32.8

package/dist/esm/utils/CollabClient.js

@@ -17490,6 +17490,9 @@ var CONFIG = {
     // For based api
     githubClientId: "Ov23liAFrsR0StbAO6PO",
     // For github api
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/aef64330db80bdfeaac084317bf72f99",
+    // For grafana tracing
+    grafanaAppName: "Localhost Symbols",
     // Environment-specific feature toggles (override common)
     features: {
       betaFeatures: true
@@ -17505,6 +17508,9 @@ var CONFIG = {
     socketUrl: "https://dev.api.symbols.app",
     apiUrl: "https://dev.api.symbols.app",
     githubClientId: "Ov23liHxyWFBxS8f1gnF",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/7a3ba473cee2025c68513667024316b8",
+    // For grafana tracing
+    grafanaAppName: "Symbols Dev",
     typesenseCollectionName: "docs",
     typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
     typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
@@ -17518,6 +17524,9 @@ var CONFIG = {
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
     githubClientId: "Ov23liHxyWFBxS8f1gnF",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/7a3ba473cee2025c68513667024316b8",
+    // For grafana tracing
+    grafanaAppName: "Symbols Test",
     typesenseCollectionName: "docs",
     typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
     typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
@@ -17528,6 +17537,9 @@ var CONFIG = {
     socketUrl: "https://upcoming.api.symbols.app",
     apiUrl: "https://upcoming.api.symbols.app",
     githubClientId: "Ov23liWF7NvdZ056RV5J",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/7a3ba473cee2025c68513667024316b8",
+    // For grafana tracing
+    grafanaAppName: "Symbols Upcoming",
     typesenseCollectionName: "docs",
     typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
     typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
@@ -17541,6 +17553,9 @@ var CONFIG = {
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
     githubClientId: "Ov23ligwZDQVD0VfuWNa",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/7a3ba473cee2025c68513667024316b8",
+    // For grafana tracing
+    grafanaAppName: "Symbols Staging",
     typesenseCollectionName: "docs",
     typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
     typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
@@ -17554,6 +17569,9 @@ var CONFIG = {
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
     githubClientId: "Ov23liFAlOEIXtX3dBtR",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/5c1089f3c3eea4ec5658e05c3f53baae",
+    // For grafana tracing
+    grafanaAppName: "Symbols",
     typesenseCollectionName: "docs",
     typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
     typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
@@ -17580,6 +17598,7 @@ var getConfig = () => {
       basedProject: process.env.SYMBOLS_APP_BASED_PROJECT || envConfig.basedProject,
       basedOrg: process.env.SYMBOLS_APP_BASED_ORG || envConfig.basedOrg,
       githubClientId: process.env.SYMBOLS_APP_GITHUB_CLIENT_ID || envConfig.githubClientId,
+      grafanaUrl: process.env.SYMBOLS_APP_GRAFANA_URL || envConfig.grafanaUrl,
       typesenseCollectionName: process.env.TYPESENSE_COLLECTION_NAME || envConfig.typesenseCollectionName,
       typesenseApiKey: process.env.TYPESENSE_API_KEY || envConfig.typesenseApiKey,
       typesenseHost: process.env.TYPESENSE_HOST || envConfig.typesenseHost,
@@ -17750,8 +17769,8 @@ var CollabClient = class {
     __publicField(this, "_buffer", []);
     __publicField(this, "_flushTimer", null);
     __publicField(this, "_clientId", nanoid());
-    __publicField(this, "_outboxStore", null);
-    // Dexie table
+    __publicField(this, "_outboxStore", createMemoryOutbox());
+    // Dexie table fallback
     __publicField(this, "_readyResolve");
     __publicField(this, "ready", new Promise((res) => this._readyResolve = res));
     /* ---------- private handlers ---------- */
@@ -17793,6 +17812,12 @@ var CollabClient = class {
         await this._outboxStore.clear();
       }
     });
+    __publicField(this, "_onLiveMode", (flag) => {
+      this.live = flag;
+    });
+    __publicField(this, "_onError", (e) => {
+      console.warn("[collab] socket error", e);
+    });
     Object.assign(this, { jwt, projectId, branch, live });
     this.ydoc = new Doc();
     const hasIndexedDB = typeof globalThis.indexedDB !== "undefined";
@@ -17805,14 +17830,11 @@ var CollabClient = class {
         console.warn("[CollabClient] Failed to load IndexeddbPersistence:", err);
       });
     }
-    if (typeof window === "undefined" || !hasIndexedDB) {
-      this._outboxStore = createMemoryOutbox();
-    } else {
+    if (typeof window !== "undefined" && hasIndexedDB) {
       createDexieOutbox(`${projectId}:${branch}`).then((outboxStore) => {
         this._outboxStore = outboxStore;
       }).catch((err) => {
         console.warn("[CollabClient] Failed to load Dexie:", err);
-        this._outboxStore = createMemoryOutbox();
       });
     }
     this.socket = lookup2(environment_default.socketUrl, {
@@ -17822,9 +17844,7 @@ var CollabClient = class {
       reconnectionAttempts: Infinity,
       reconnectionDelayMax: 4e3
     });
-    this.socket.on("snapshot", this._onSnapshot).on("ops", this._onOps).on("commit", this._onCommit).on("liveMode", (flag) => {
-      this.live = flag;
-    }).on("connect", this._onConnect).on("error", (e) => console.warn("[collab] socket error", e));
+    this.socket.on("snapshot", this._onSnapshot).on("ops", this._onOps).on("commit", this._onCommit).on("liveMode", this._onLiveMode).on("connect", this._onConnect).on("error", this._onError);
     this._prevJson = this.ydoc.getMap("root").toJSON();
     this.ydoc.on("afterTransaction", (tr) => {
       if (tr.origin === "remote") {
@@ -17871,6 +17891,42 @@ var CollabClient = class {
     });
     this._buffer.length = 0;
   }
+  dispose() {
+    var _a;
+    clearTimeout(this._flushTimer);
+    this._flushTimer = null;
+    this._buffer.length = 0;
+    if ((_a = this._outboxStore) == null ? void 0 : _a.clear) {
+      try {
+        const result = this._outboxStore.clear();
+        if (result && typeof result.catch === "function") {
+          result.catch(() => {
+          });
+        }
+      } catch (error) {
+        console.warn("[CollabClient] Failed to clear outbox store during dispose:", error);
+      }
+    }
+    if (this.socket) {
+      this.socket.off("snapshot", this._onSnapshot);
+      this.socket.off("ops", this._onOps);
+      this.socket.off("commit", this._onCommit);
+      this.socket.off("liveMode", this._onLiveMode);
+      this.socket.off("connect", this._onConnect);
+      this.socket.off("error", this._onError);
+      this.socket.removeAllListeners();
+      this.socket.disconnect();
+      this.socket = null;
+    }
+    if (this.ydoc) {
+      this.ydoc.destroy();
+      this.ydoc = null;
+    }
+    if (typeof this._readyResolve === "function") {
+      this._readyResolve();
+      this._readyResolve = null;
+    }
+  }
 };
 function createMemoryOutbox() {
   const store = /* @__PURE__ */ new Map();

package/dist/node/config/environment.js

@@ -25,6 +25,9 @@ const CONFIG = {
     // For based api
     githubClientId: "Ov23liAFrsR0StbAO6PO",
     // For github api
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/aef64330db80bdfeaac084317bf72f99",
+    // For grafana tracing
+    grafanaAppName: "Localhost Symbols",
     // Environment-specific feature toggles (override common)
     features: {
       betaFeatures: true
@@ -40,6 +43,9 @@ const CONFIG = {
     socketUrl: "https://dev.api.symbols.app",
     apiUrl: "https://dev.api.symbols.app",
     githubClientId: "Ov23liHxyWFBxS8f1gnF",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/7a3ba473cee2025c68513667024316b8",
+    // For grafana tracing
+    grafanaAppName: "Symbols Dev",
     typesenseCollectionName: "docs",
     typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
     typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
@@ -53,6 +59,9 @@ const CONFIG = {
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
     githubClientId: "Ov23liHxyWFBxS8f1gnF",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/7a3ba473cee2025c68513667024316b8",
+    // For grafana tracing
+    grafanaAppName: "Symbols Test",
     typesenseCollectionName: "docs",
     typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
     typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
@@ -63,6 +72,9 @@ const CONFIG = {
     socketUrl: "https://upcoming.api.symbols.app",
     apiUrl: "https://upcoming.api.symbols.app",
     githubClientId: "Ov23liWF7NvdZ056RV5J",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/7a3ba473cee2025c68513667024316b8",
+    // For grafana tracing
+    grafanaAppName: "Symbols Upcoming",
     typesenseCollectionName: "docs",
     typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
     typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
@@ -76,6 +88,9 @@ const CONFIG = {
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
     githubClientId: "Ov23ligwZDQVD0VfuWNa",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/7a3ba473cee2025c68513667024316b8",
+    // For grafana tracing
+    grafanaAppName: "Symbols Staging",
     typesenseCollectionName: "docs",
     typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
     typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
@@ -89,6 +104,9 @@ const CONFIG = {
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
     githubClientId: "Ov23liFAlOEIXtX3dBtR",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/5c1089f3c3eea4ec5658e05c3f53baae",
+    // For grafana tracing
+    grafanaAppName: "Symbols",
     typesenseCollectionName: "docs",
     typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
     typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
@@ -116,6 +134,7 @@ const getConfig = () => {
       basedProject: process.env.SYMBOLS_APP_BASED_PROJECT || envConfig.basedProject,
       basedOrg: process.env.SYMBOLS_APP_BASED_ORG || envConfig.basedOrg,
       githubClientId: process.env.SYMBOLS_APP_GITHUB_CLIENT_ID || envConfig.githubClientId,
+      grafanaUrl: process.env.SYMBOLS_APP_GRAFANA_URL || envConfig.grafanaUrl,
       typesenseCollectionName: process.env.TYPESENSE_COLLECTION_NAME || envConfig.typesenseCollectionName,
       typesenseApiKey: process.env.TYPESENSE_API_KEY || envConfig.typesenseApiKey,
       typesenseHost: process.env.TYPESENSE_HOST || envConfig.typesenseHost,

package/dist/node/services/AuthService.js

@@ -302,10 +302,12 @@ class AuthService extends BaseService {
       throw new Error(`Password change confirmation failed: ${error.message}`, { cause: error });
     }
   }
-  async getMe() {
+  async getMe(options = {}) {
     this._requireReady("getMe");
     try {
-      const response = await this._request("/auth/me", {
+      const session = this._resolvePluginSession(options.session);
+      const endpoint = session ? `/auth/me?session=${encodeURIComponent(session)}` : "/auth/me";
+      const response = await this._request(endpoint, {
         method: "GET",
         methodName: "getMe"
       });

package/dist/node/services/CollabService.js

@@ -11,12 +11,20 @@ class CollabService extends BaseService {
     this._client = null;
     this._stateManager = null;
     this._connected = false;
+    this._connecting = false;
+    this._connectPromise = null;
+    this._connectionMeta = null;
+    this._pendingConnectReject = null;
     this._undoStack = [];
     this._redoStack = [];
     this._isUndoRedo = false;
     this._pendingOps = [];
+    this._onSocketConnect = this._onSocketConnect.bind(this);
+    this._onSocketDisconnect = this._onSocketDisconnect.bind(this);
+    this._onSocketError = this._onSocketError.bind(this);
   }
   init({ context }) {
+    super.init({ context });
     if (context == null ? void 0 : context.state) {
       try {
         this._stateManager = new RootStateManager(context.state);
@@ -80,86 +88,196 @@ class CollabService extends BaseService {
   }
   /* ---------- Connection Management ---------- */
   async connect(options = {}) {
-    var _a, _b, _c, _d, _e, _f;
-    this._ensureStateManager();
-    const {
-      authToken: jwt,
-      projectId,
-      branch = "main",
-      pro
-    } = {
-      ...this._context,
-      ...options
-    };
-    if (!projectId) {
-      const state = (_a = this._stateManager) == null ? void 0 : _a.root;
-      const el = state.__element;
-      el.call("openNotification", {
-        type: "error",
-        title: "projectId is required",
-        message: "projectId is required for CollabService connection"
-      });
-      throw new Error("projectId is required for CollabService connection");
-    }
-    if (this._client) {
-      await this.disconnect();
+    if (this._connectPromise) {
+      return this._connectPromise;
     }
-    this._client = new CollabClient({
-      jwt,
-      projectId,
-      branch,
-      live: Boolean(pro)
-    });
-    await new Promise((resolve) => {
-      var _a2, _b2;
-      if ((_a2 = this._client.socket) == null ? void 0 : _a2.connected) {
-        resolve();
-      } else {
-        (_b2 = this._client.socket) == null ? void 0 : _b2.once("connect", resolve);
+    this._connectPromise = (async () => {
+      var _a;
+      this._connecting = true;
+      this._connected = false;
+      this._ensureStateManager();
+      const mergedOptions = {
+        ...this._context,
+        ...options
+      };
+      let { authToken: jwt } = mergedOptions;
+      const {
+        projectId,
+        branch = "main",
+        pro
+      } = mergedOptions;
+      if (!jwt && this._tokenManager) {
+        try {
+          jwt = await this._tokenManager.ensureValidToken();
+        } catch (error) {
+          console.warn("[CollabService] Failed to obtain auth token from token manager", error);
+        }
+        if (!jwt && typeof this._tokenManager.getAccessToken === "function") {
+          jwt = this._tokenManager.getAccessToken();
+        }
       }
-    });
-    (_b = this._client.socket) == null ? void 0 : _b.on("ops", ({ changes }) => {
-      console.log(`ops event`);
-      this._stateManager.applyChanges(changes, { fromSocket: true });
-    });
-    (_c = this._client.socket) == null ? void 0 : _c.on("commit", ({ version }) => {
-      if (version) {
-        this._stateManager.setVersion(version);
+      if (!jwt) {
+        throw new Error("[CollabService] Cannot connect without auth token");
       }
-      rootBus.emit("checkpoint:done", { version, origin: "auto" });
-    });
-    (_d = this._client.socket) == null ? void 0 : _d.on("clients", this._handleClientsEvent.bind(this));
-    (_e = this._client.socket) == null ? void 0 : _e.on(
-      "bundle:done",
-      this._handleBundleDoneEvent.bind(this)
-    );
-    (_f = this._client.socket) == null ? void 0 : _f.on(
-      "bundle:error",
-      this._handleBundleErrorEvent.bind(this)
-    );
-    if (this._pendingOps.length) {
-      console.log(
-        `[CollabService] Flushing ${this._pendingOps.length} offline operation batch(es)`
-      );
-      this._pendingOps.forEach(({ changes, granularChanges, orders }) => {
-        this.socket.emit("ops", { changes, granularChanges, orders, ts: Date.now() });
+      this._context = {
+        ...this._context,
+        authToken: jwt,
+        projectId,
+        branch,
+        pro
+      };
+      if (!projectId) {
+        const state = (_a = this._stateManager) == null ? void 0 : _a.root;
+        const el = state.__element;
+        el.call("openNotification", {
+          type: "error",
+          title: "projectId is required",
+          message: "projectId is required for CollabService connection"
+        });
+        throw new Error("projectId is required for CollabService connection");
+      }
+      if (this._client) {
+        await this.disconnect();
+      }
+      this._client = new CollabClient({
+        jwt,
+        projectId,
+        branch,
+        live: Boolean(pro)
+      });
+      const { socket } = this._client;
+      try {
+        await new Promise((resolve, reject) => {
+          if (!socket) {
+            reject(new Error("[CollabService] Socket instance missing"));
+            return;
+          }
+          if (socket.connected) {
+            resolve();
+            return;
+          }
+          const cleanup = () => {
+            socket.off("connect", handleConnect);
+            socket.off("connect_error", handleError);
+            socket.off("error", handleError);
+            socket.off("disconnect", handleDisconnect);
+            if (this._pendingConnectReject === handleError) {
+              this._pendingConnectReject = null;
+            }
+          };
+          const handleConnect = () => {
+            cleanup();
+            resolve();
+          };
+          const handleError = (error) => {
+            cleanup();
+            reject(
+              error instanceof Error ? error : new Error(String(error || "Unknown connection error"))
+            );
+          };
+          const handleDisconnect = (reason) => {
+            handleError(
+              reason instanceof Error ? reason : new Error(
+                `[CollabService] Socket disconnected before connect: ${reason || "unknown"}`
+              )
+            );
+          };
+          this._pendingConnectReject = handleError;
+          socket.once("connect", handleConnect);
+          socket.once("connect_error", handleError);
+          socket.once("error", handleError);
+          socket.once("disconnect", handleDisconnect);
+        });
+      } catch (error) {
+        socket == null ? void 0 : socket.disconnect();
+        this._client = null;
+        this._connectionMeta = null;
+        throw error;
+      }
+      this._attachSocketLifecycleListeners();
+      if (socket == null ? void 0 : socket.connected) {
+        this._onSocketConnect();
+      }
+      socket == null ? void 0 : socket.on("ops", ({ changes }) => {
+        console.log(`ops event`);
+        this._stateManager.applyChanges(changes, { fromSocket: true });
       });
-      this._pendingOps.length = 0;
+      socket == null ? void 0 : socket.on("commit", ({ version }) => {
+        if (version) {
+          this._stateManager.setVersion(version);
+        }
+        rootBus.emit("checkpoint:done", { version, origin: "auto" });
+      });
+      socket == null ? void 0 : socket.on("clients", this._handleClientsEvent.bind(this));
+      socket == null ? void 0 : socket.on(
+        "bundle:done",
+        this._handleBundleDoneEvent.bind(this)
+      );
+      socket == null ? void 0 : socket.on(
+        "bundle:error",
+        this._handleBundleErrorEvent.bind(this)
+      );
+      if (this._pendingOps.length) {
+        console.log(
+          `[CollabService] Flushing ${this._pendingOps.length} offline operation batch(es)`
+        );
+        this._pendingOps.forEach(({ changes, granularChanges, orders }) => {
+          this.socket.emit("ops", { changes, granularChanges, orders, ts: Date.now() });
+        });
+        this._pendingOps.length = 0;
+      }
+      await this._client.ready;
+      this._connectionMeta = {
+        projectId,
+        branch,
+        live: Boolean(pro)
+      };
+      return this.getConnectionInfo();
+    })();
+    try {
+      return await this._connectPromise;
+    } finally {
+      this._connecting = false;
+      this._connectPromise = null;
     }
-    this._connected = true;
   }
   disconnect() {
     var _a;
     if ((_a = this._client) == null ? void 0 : _a.socket) {
-      this._client.socket.disconnect();
+      if (this._pendingConnectReject) {
+        this._pendingConnectReject(new Error("[CollabService] Connection attempt aborted"));
+        this._pendingConnectReject = null;
+      }
+      this._detachSocketLifecycleListeners();
+      if (typeof this._client.dispose === "function") {
+        this._client.dispose();
+      } else {
+        this._client.socket.disconnect();
+      }
     }
     this._client = null;
     this._connected = false;
+    this._connecting = false;
+    this._connectionMeta = null;
+    this._pendingConnectReject = null;
     console.log("[CollabService] Disconnected");
   }
   isConnected() {
     var _a, _b;
-    return this._connected && ((_b = (_a = this._client) == null ? void 0 : _a.socket) == null ? void 0 : _b.connected);
+    return Boolean(this._connected && ((_b = (_a = this._client) == null ? void 0 : _a.socket) == null ? void 0 : _b.connected));
+  }
+  getConnectionInfo() {
+    var _a, _b, _c;
+    return {
+      connected: this.isConnected(),
+      connecting: this._connecting,
+      projectId: ((_a = this._connectionMeta) == null ? void 0 : _a.projectId) ?? null,
+      branch: ((_b = this._connectionMeta) == null ? void 0 : _b.branch) ?? null,
+      live: ((_c = this._connectionMeta) == null ? void 0 : _c.live) ?? null,
+      pendingOps: this._pendingOps.length,
+      undoStackSize: this.getUndoStackSize(),
+      redoStackSize: this.getRedoStackSize()
+    };
   }
   /* convenient shortcuts */
   get ydoc() {
@@ -526,6 +644,38 @@ class CollabService extends BaseService {
     rootBus.emit("bundle:error", { project, ticket, error });
   }
   /* ---------- Manual checkpoint ---------- */
+  _attachSocketLifecycleListeners() {
+    var _a;
+    const socket = (_a = this._client) == null ? void 0 : _a.socket;
+    if (!socket) {
+      return;
+    }
+    socket.on("connect", this._onSocketConnect);
+    socket.on("disconnect", this._onSocketDisconnect);
+    socket.on("connect_error", this._onSocketError);
+  }
+  _detachSocketLifecycleListeners() {
+    var _a;
+    const socket = (_a = this._client) == null ? void 0 : _a.socket;
+    if (!socket) {
+      return;
+    }
+    socket.off("connect", this._onSocketConnect);
+    socket.off("disconnect", this._onSocketDisconnect);
+    socket.off("connect_error", this._onSocketError);
+  }
+  _onSocketConnect() {
+    this._connected = true;
+  }
+  _onSocketDisconnect(reason) {
+    this._connected = false;
+    if (reason && reason !== "io client disconnect") {
+      console.warn("[CollabService] Socket disconnected", reason);
+    }
+  }
+  _onSocketError(error) {
+    console.warn("[CollabService] Socket connection error", error);
+  }
   /**
    * Manually request a checkpoint / commit of buffered operations on the server.
    * Resolves with the new version number once the backend confirms via the

package/dist/node/services/ProjectService.js

@@ -154,7 +154,8 @@ class ProjectService extends BaseService {
     const {
       branch = "main",
       version = "latest",
-      includeHistory = false
+      includeHistory = false,
+      headers
     } = options;
     const queryParams = new URLSearchParams({
       branch,
@@ -166,7 +167,8 @@ class ProjectService extends BaseService {
         `/projects/key/${key}/data?${queryParams}`,
         {
           method: "GET",
-          methodName: "getProjectDataByKey"
+          methodName: "getProjectDataByKey",
+          ...headers ? { headers } : {}
         }
       );
       if (response.success) {
@@ -357,7 +359,7 @@ class ProjectService extends BaseService {
     if (!projectId || !email || !role) {
       throw new Error("Project ID, email, and role are required");
     }
-    const { name, callbackUrl } = options;
+    const { name, callbackUrl, headers } = options;
     const defaultCallbackUrl = typeof window === "undefined" ? "https://app.symbols.com/accept-invite" : `${window.location.origin}/accept-invite`;
     try {
       const requestBody = {
@@ -371,6 +373,7 @@ class ProjectService extends BaseService {
       const response = await this._request(`/projects/${projectId}/invite`, {
         method: "POST",
         body: JSON.stringify(requestBody),
+        ...headers ? { headers } : {},
         methodName: "inviteMember"
       });
       if (response.success) {
@@ -532,7 +535,7 @@ class ProjectService extends BaseService {
     if (!Array.isArray(changes)) {
       throw new Error("Changes must be an array");
     }
-    const { message, branch = "main", type = "patch" } = options;
+    const { message, branch = "main", type = "patch", headers } = options;
     const state = this._context && this._context.state;
     const { granularChanges, orders: preprocessorOrders } = preprocessChanges(state, changes, options);
     const derivedOrders = options.orders || (preprocessorOrders && preprocessorOrders.length ? preprocessorOrders : state ? computeOrdersForTuples(state, granularChanges) : []);
@@ -548,6 +551,7 @@ class ProjectService extends BaseService {
           type,
           ...derivedOrders && derivedOrders.length ? { orders: derivedOrders } : {}
         }),
+        ...headers ? { headers } : {},
         methodName: "applyProjectChanges"
       });
       if (response.success) {
@@ -570,7 +574,8 @@ class ProjectService extends BaseService {
     const {
       branch = "main",
       version = "latest",
-      includeHistory = false
+      includeHistory = false,
+      headers
     } = options;
     const queryParams = new URLSearchParams({
       branch,
@@ -582,7 +587,8 @@ class ProjectService extends BaseService {
         `/projects/${projectId}/data?${queryParams}`,
         {
           method: "GET",
-          methodName: "getProjectData"
+          methodName: "getProjectData",
+          ...headers ? { headers } : {}
         }
       );
       if (response.success) {
@@ -601,7 +607,7 @@ class ProjectService extends BaseService {
     if (!projectId) {
       throw new Error("Project ID is required");
     }
-    const { branch = "main", page = 1, limit = 50 } = options;
+    const { branch = "main", page = 1, limit = 50, headers } = options;
     const queryParams = new URLSearchParams({
       branch,
       page: page.toString(),
@@ -612,7 +618,8 @@ class ProjectService extends BaseService {
         `/projects/${projectId}/versions?${queryParams}`,
         {
           method: "GET",
-          methodName: "getProjectVersions"
+          methodName: "getProjectVersions",
+          ...headers ? { headers } : {}
         }
       );
       if (response.success) {
@@ -635,7 +642,7 @@ class ProjectService extends BaseService {
     if (!version) {
       throw new Error("Version is required");
     }
-    const { message, branch = "main", type = "patch" } = options;
+    const { message, branch = "main", type = "patch", headers } = options;
     try {
       const response = await this._request(`/projects/${projectId}/restore`, {
         method: "POST",
@@ -645,6 +652,7 @@ class ProjectService extends BaseService {
           branch,
           type
         }),
+        ...headers ? { headers } : {},
         methodName: "restoreProjectVersion"
       });
       if (response.success) {
@@ -794,7 +802,7 @@ class ProjectService extends BaseService {
   // ==================== RECENT PROJECT METHODS ====================
   async getRecentProjects(options = {}) {
     this._requireReady("getRecentProjects");
-    const { limit = 20 } = options;
+    const { limit = 20, headers } = options;
     const queryString = new URLSearchParams({
       limit: limit.toString()
     }).toString();
@@ -802,6 +810,7 @@ class ProjectService extends BaseService {
     try {
       const response = await this._request(url, {
         method: "GET",
+        ...headers ? { headers } : {},
         methodName: "getRecentProjects"
       });
       if (response.success) {