@symbo.ls/sdk 2.32.2 → 2.32.4

package/dist/esm/index.js

@@ -14111,18 +14111,28 @@ var CONFIG = {
     // For based api
     basedOrg: "symbols",
     // For based api
-    githubClientId: "Ov23liHxyWFBxS8f1gnF",
+    githubClientId: "Ov23liAFrsR0StbAO6PO",
     // For github api
     // Environment-specific feature toggles (override common)
     features: {
       betaFeatures: true
       // Enable beta features in local dev
-    }
+    },
+    typesenseCollectionName: "docs",
+    typesenseApiKey: "vZya3L2zpq8L6iI5WWMUZJZABvT63VDb",
+    typesenseHost: "localhost",
+    typesensePort: "8108",
+    typesenseProtocol: "http"
   },
   development: {
     socketUrl: "https://dev.api.symbols.app",
     apiUrl: "https://dev.api.symbols.app",
-    githubClientId: "Ov23liHxyWFBxS8f1gnF"
+    githubClientId: "Ov23liHxyWFBxS8f1gnF",
+    typesenseCollectionName: "docs",
+    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
+    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
+    typesensePort: "443",
+    typesenseProtocol: "https"
   },
   testing: {
     socketUrl: "https://test.api.symbols.app",
@@ -14130,12 +14140,22 @@ var CONFIG = {
     basedEnv: "testing",
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
-    githubClientId: "Ov23liHxyWFBxS8f1gnF"
+    githubClientId: "Ov23liHxyWFBxS8f1gnF",
+    typesenseCollectionName: "docs",
+    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
+    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
+    typesensePort: "443",
+    typesenseProtocol: "https"
   },
   upcoming: {
     socketUrl: "https://upcoming.api.symbols.app",
     apiUrl: "https://upcoming.api.symbols.app",
-    githubClientId: "Ov23liWF7NvdZ056RV5J"
+    githubClientId: "Ov23liWF7NvdZ056RV5J",
+    typesenseCollectionName: "docs",
+    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
+    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
+    typesensePort: "443",
+    typesenseProtocol: "https"
   },
   staging: {
     socketUrl: "https://staging.api.symbols.app",
@@ -14143,7 +14163,12 @@ var CONFIG = {
     basedEnv: "staging",
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
-    githubClientId: "Ov23ligwZDQVD0VfuWNa"
+    githubClientId: "Ov23ligwZDQVD0VfuWNa",
+    typesenseCollectionName: "docs",
+    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
+    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
+    typesensePort: "443",
+    typesenseProtocol: "https"
   },
   production: {
     socketUrl: "https://api.symbols.app",
@@ -14151,7 +14176,12 @@ var CONFIG = {
     basedEnv: "production",
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
-    githubClientId: "Ov23liFAlOEIXtX3dBtR"
+    githubClientId: "Ov23liFAlOEIXtX3dBtR",
+    typesenseCollectionName: "docs",
+    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
+    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
+    typesensePort: "443",
+    typesenseProtocol: "https"
   }
 };
 var getEnvironment = () => {
@@ -14173,6 +14203,11 @@ 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,
+      typesenseCollectionName: process.env.TYPESENSE_COLLECTION_NAME || envConfig.typesenseCollectionName,
+      typesenseApiKey: process.env.TYPESENSE_API_KEY || envConfig.typesenseApiKey,
+      typesenseHost: process.env.TYPESENSE_HOST || envConfig.typesenseHost,
+      typesensePort: process.env.TYPESENSE_PORT || envConfig.typesensePort,
+      typesenseProtocol: process.env.TYPESENSE_PROTOCOL || envConfig.typesenseProtocol,
       isDevelopment: isDevelopment(env),
       isTesting: env === "testing",
       isStaging: env === "staging",
@@ -14192,7 +14227,7 @@ var getConfig = () => {
       );
     }
     if (finalConfig.isDevelopment) {
-      console.log(
+      console.warn(
         "environment in SDK:",
         env || process.env.NODE_ENV || process.env.NODE_ENV
       );
@@ -14231,7 +14266,7 @@ var TokenManager = class {
     });
     this.config = {
       storagePrefix: "symbols_",
-      storageType: typeof window === "undefined" || process.env.NODE_ENV === "test" ? "memory" : "localStorage",
+      storageType: typeof window === "undefined" || process.env.NODE_ENV === "test" || process.env.NODE_ENV === "testing" ? "memory" : "localStorage",
       // 'localStorage' | 'sessionStorage' | 'memory'
       refreshBuffer: 60 * 1e3,
       // Refresh 1 minute before expiry
@@ -14271,15 +14306,26 @@ var TokenManager = class {
     if (typeof window === "undefined") {
       return this._memoryStorage;
     }
-    const hasLocalStorage = typeof window.localStorage !== "undefined";
-    const hasSessionStorage = typeof window.sessionStorage !== "undefined";
+    const safeGetStorage = (provider) => {
+      try {
+        const storage = provider();
+        const testKey = `${this.config.storagePrefix}__tm_test__`;
+        storage.setItem(testKey, "1");
+        storage.removeItem(testKey);
+        return storage;
+      } catch {
+        return null;
+      }
+    };
+    const localStorageInstance = safeGetStorage(() => window.localStorage);
+    const sessionStorageInstance = safeGetStorage(() => window.sessionStorage);
     switch (this.config.storageType) {
       case "sessionStorage":
-        return hasSessionStorage ? window.sessionStorage : this._memoryStorage;
+        return sessionStorageInstance || this._memoryStorage;
       case "memory":
         return this._memoryStorage;
       default:
-        return hasLocalStorage ? window.localStorage : this._memoryStorage;
+        return localStorageInstance || this._memoryStorage;
     }
   }
   /**
@@ -14618,20 +14664,10 @@ var BaseService = class {
       }
       this._tokenManager = getTokenManager({
         apiUrl: this._apiUrl,
-        onTokenRefresh: (tokens) => {
-          this.updateContext({ authToken: tokens.accessToken });
-        },
-        onTokenExpired: () => {
-          this.updateContext({ authToken: null });
-        },
         onTokenError: (error) => {
           console.error("Token management error:", error);
         }
       });
-      const { authToken } = this._context;
-      if (authToken && !this._tokenManager.hasTokens()) {
-        this._tokenManager.setTokens({ access_token: authToken });
-      }
       this._setReady();
     } catch (error) {
       this._setError(error);
@@ -14640,7 +14676,9 @@ var BaseService = class {
   }
   // Update context
   updateContext(context) {
-    this._context = { ...this._context, ...context };
+    if (context && typeof context === "object") {
+      Object.assign(this._context, context);
+    }
   }
   // Get service status
   getStatus() {
@@ -14695,11 +14733,6 @@ var BaseService = class {
           error
         );
       }
-    } else if (this._requiresInit(options.methodName)) {
-      const { authToken } = this._context;
-      if (authToken) {
-        defaultHeaders.Authorization = `Bearer ${authToken}`;
-      }
     }
     try {
       const response = await fetch(url2, {
@@ -14717,11 +14750,11 @@ var BaseService = class {
           error = await response.json();
         } catch {
         }
-        throw new Error(error.message || error.error || "Request failed");
+        throw new Error(error.message || error.error || "Request failed", { cause: error });
       }
       return response.status === 204 ? null : response.json();
     } catch (error) {
-      throw new Error(`Request failed: ${error.message}`);
+      throw new Error(`Request failed: ${error.message}`, { cause: error });
     }
   }
   // Helper method to determine if a method requires initialization
@@ -14902,118 +14935,10 @@ var AuthService = class extends BaseService {
       "pro2",
       "enterprise"
     ]);
-    this._initialized = false;
-    this._apiUrl = null;
-    this._tokenManager = null;
     this._projectRoleCache = /* @__PURE__ */ new Map();
     this._roleCacheExpiry = 5 * 60 * 1e3;
   }
-  init({ context }) {
-    try {
-      const { appKey, authToken } = context || this._context;
-      this._apiUrl = environment_default.apiUrl;
-      if (!this._apiUrl) {
-        throw new Error("Auth service base URL not configured");
-      }
-      this._tokenManager = getTokenManager({
-        apiUrl: this._apiUrl,
-        onTokenRefresh: (tokens) => {
-          this.updateContext({ authToken: tokens.accessToken });
-        },
-        onTokenExpired: () => {
-          this.updateContext({ authToken: null });
-        },
-        onTokenError: (error) => {
-          console.error("Token management error:", error);
-        }
-      });
-      if (authToken && !this._tokenManager.hasTokens()) {
-        this._tokenManager.setTokens({ access_token: authToken });
-      }
-      this._info = {
-        config: {
-          apiUrl: this._apiUrl,
-          appKey: appKey ? `${appKey.substr(0, 4)}...${appKey.substr(-4)}` : null,
-          hasToken: Boolean(authToken)
-        }
-      };
-      this._initialized = true;
-      this._setReady();
-    } catch (error) {
-      this._setError(error);
-      throw error;
-    }
-  }
-  // Helper method to make HTTP requests
-  async _request(endpoint, options = {}) {
-    const url2 = `${this._apiUrl}/core${endpoint}`;
-    const defaultHeaders = {};
-    if (!(options.body instanceof FormData)) {
-      defaultHeaders["Content-Type"] = "application/json";
-    }
-    if (this._requiresInit(options.methodName) && this._tokenManager) {
-      try {
-        const validToken = await this._tokenManager.ensureValidToken();
-        if (validToken) {
-          const authHeader = this._tokenManager.getAuthHeader();
-          if (authHeader) {
-            defaultHeaders.Authorization = authHeader;
-          }
-        }
-      } catch (error) {
-        console.warn(
-          "Token management failed, proceeding without authentication:",
-          error
-        );
-      }
-    } else if (this._requiresInit(options.methodName)) {
-      const { authToken } = this._context;
-      if (authToken) {
-        defaultHeaders.Authorization = `Bearer ${authToken}`;
-      }
-    }
-    try {
-      const response = await fetch(url2, {
-        ...options,
-        headers: {
-          ...defaultHeaders,
-          ...options.headers
-        }
-      });
-      if (!response.ok) {
-        let error = {
-          message: `HTTP ${response.status}: ${response.statusText}`
-        };
-        try {
-          error = await response.json();
-        } catch {
-        }
-        throw new Error(error.message || error.error || "Request failed");
-      }
-      return response.status === 204 ? null : response.json();
-    } catch (error) {
-      throw new Error(`Request failed: ${error.message}`);
-    }
-  }
-  _requiresInit(methodName) {
-    const noInitMethods = /* @__PURE__ */ new Set([
-      "register",
-      "login",
-      "googleAuth",
-      "googleAuthCallback",
-      "githubAuth",
-      "requestPasswordReset",
-      "confirmPasswordReset",
-      "confirmRegistration",
-      "verifyEmail"
-    ]);
-    return !noInitMethods.has(methodName);
-  }
-  _requireReady(methodName) {
-    if (this._requiresInit(methodName) && !this._initialized) {
-      throw new Error("Auth service not initialized");
-    }
-  }
+  // Use BaseService.init/_request/_requireReady implementations
   // ==================== AUTH METHODS ====================
   async register(userData) {
     try {
@@ -15027,7 +14952,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Registration failed: ${error.message}`);
+      throw new Error(`Registration failed: ${error.message}`, { cause: error });
     }
   }
   async login(email, password) {
@@ -15049,14 +14974,13 @@ var AuthService = class extends BaseService {
         if (this._tokenManager) {
           this._tokenManager.setTokens(tokenData);
         }
-        this.updateContext({ authToken: tokens.accessToken });
       }
       if (response.success) {
         return response.data;
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Login failed: ${error.message}`);
+      throw new Error(`Login failed: ${error.message}`, { cause: error });
     }
   }
   async logout() {
@@ -15069,13 +14993,11 @@ var AuthService = class extends BaseService {
       if (this._tokenManager) {
         this._tokenManager.clearTokens();
       }
-      this.updateContext({ authToken: null });
     } catch (error) {
       if (this._tokenManager) {
         this._tokenManager.clearTokens();
       }
-      this.updateContext({ authToken: null });
-      throw new Error(`Logout failed: ${error.message}`);
+      throw new Error(`Logout failed: ${error.message}`, { cause: error });
     }
   }
   async refreshToken(refreshToken) {
@@ -15090,7 +15012,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Token refresh failed: ${error.message}`);
+      throw new Error(`Token refresh failed: ${error.message}`, { cause: error });
     }
   }
   async googleAuth(idToken, inviteToken = null) {
@@ -15116,14 +15038,13 @@ var AuthService = class extends BaseService {
         if (this._tokenManager) {
           this._tokenManager.setTokens(tokenData);
         }
-        this.updateContext({ authToken: tokens.accessToken });
       }
       if (response.success) {
         return response.data;
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Google auth failed: ${error.message}`);
+      throw new Error(`Google auth failed: ${error.message}`, { cause: error });
     }
   }
   async githubAuth(code, inviteToken = null) {
@@ -15149,14 +15070,13 @@ var AuthService = class extends BaseService {
         if (this._tokenManager) {
           this._tokenManager.setTokens(tokenData);
         }
-        this.updateContext({ authToken: tokens.accessToken });
       }
       if (response.success) {
         return response.data;
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`GitHub auth failed: ${error.message}`);
+      throw new Error(`GitHub auth failed: ${error.message}`, { cause: error });
     }
   }
   async googleAuthCallback(code, redirectUri, inviteToken = null) {
@@ -15182,14 +15102,13 @@ var AuthService = class extends BaseService {
         if (this._tokenManager) {
           this._tokenManager.setTokens(tokenData);
         }
-        this.updateContext({ authToken: tokens.accessToken });
       }
       if (response.success) {
         return response.data;
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Google auth callback failed: ${error.message}`);
+      throw new Error(`Google auth callback failed: ${error.message}`, { cause: error });
     }
   }
   async requestPasswordReset(email) {
@@ -15204,7 +15123,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password reset request failed: ${error.message}`);
+      throw new Error(`Password reset request failed: ${error.message}`, { cause: error });
     }
   }
   async confirmPasswordReset(token, password) {
@@ -15219,7 +15138,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password reset confirmation failed: ${error.message}`);
+      throw new Error(`Password reset confirmation failed: ${error.message}`, { cause: error });
     }
   }
   async confirmRegistration(token) {
@@ -15234,7 +15153,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Registration confirmation failed: ${error.message}`);
+      throw new Error(`Registration confirmation failed: ${error.message}`, { cause: error });
     }
   }
   async requestPasswordChange() {
@@ -15249,7 +15168,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password change request failed: ${error.message}`);
+      throw new Error(`Password change request failed: ${error.message}`, { cause: error });
     }
   }
   async confirmPasswordChange(currentPassword, newPassword, code) {
@@ -15265,7 +15184,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password change confirmation failed: ${error.message}`);
+      throw new Error(`Password change confirmation failed: ${error.message}`, { cause: error });
     }
   }
   async getMe() {
@@ -15280,7 +15199,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user profile: ${error.message}`);
+      throw new Error(`Failed to get user profile: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -15380,7 +15299,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user profile: ${error.message}`);
+      throw new Error(`Failed to get user profile: ${error.message}`, { cause: error });
     }
   }
   async updateUserProfile(profileData) {
@@ -15396,7 +15315,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to update user profile: ${error.message}`);
+      throw new Error(`Failed to update user profile: ${error.message}`, { cause: error });
     }
   }
   async getUserProjects() {
@@ -15419,7 +15338,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user projects: ${error.message}`);
+      throw new Error(`Failed to get user projects: ${error.message}`, { cause: error });
     }
   }
   async getUser(userId) {
@@ -15437,7 +15356,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user: ${error.message}`);
+      throw new Error(`Failed to get user: ${error.message}`, { cause: error });
     }
   }
   async getUserByEmail(email) {
@@ -15455,7 +15374,7 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user by email: ${error.message}`);
+      throw new Error(`Failed to get user by email: ${error.message}`, { cause: error });
     }
   }
   // ==================== PROJECT ROLE METHODS ====================
@@ -15468,6 +15387,9 @@ var AuthService = class extends BaseService {
     if (!projectId) {
       throw new Error("Project ID is required");
     }
+    if (!this.hasValidTokens()) {
+      return "guest";
+    }
     const cacheKey = `role_${projectId}`;
     const cached = this._projectRoleCache.get(cacheKey);
     if (cached && Date.now() - cached.timestamp < this._roleCacheExpiry) {
@@ -15488,7 +15410,11 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get project role: ${error.message}`);
+      const message = (error == null ? void 0 : error.message) || "";
+      if (/401|403|unauthorized|no token|invalid token/iu.test(message)) {
+        return "guest";
+      }
+      throw new Error(`Failed to get project role: ${message}`, { cause: error });
     }
   }
   /**
@@ -15500,6 +15426,9 @@ var AuthService = class extends BaseService {
     if (!projectKey) {
       throw new Error("Project key is required");
     }
+    if (!this.hasValidTokens()) {
+      return "guest";
+    }
     const cacheKey = `role_key_${projectKey}`;
     const cached = this._projectRoleCache.get(cacheKey);
     if (cached && Date.now() - cached.timestamp < this._roleCacheExpiry) {
@@ -15520,7 +15449,11 @@ var AuthService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get project role by key: ${error.message}`);
+      const message = (error == null ? void 0 : error.message) || "";
+      if (/401|403|unauthorized|no token|invalid token/iu.test(message)) {
+        return "guest";
+      }
+      throw new Error(`Failed to get project role by key: ${message}`, { cause: error });
     }
   }
   /**
@@ -15623,7 +15556,7 @@ var AuthService = class extends BaseService {
     try {
       return await this.getMe();
     } catch (error) {
-      throw new Error(`Failed to get current user: ${error.message}`);
+      throw new Error(`Failed to get current user: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -15780,7 +15713,6 @@ var AuthService = class extends BaseService {
       this._tokenManager = null;
     }
     this._projectRoleCache.clear();
-    this._initialized = false;
     this._setReady(false);
   }
 };
@@ -15933,11 +15865,11 @@ var CoreService = class extends BaseService {
           error = await response.json();
         } catch {
         }
-        throw new Error(error.message || error.error || "Request failed");
+        throw new Error(error.message || error.error || "Request failed", { cause: error });
       }
       return response.status === 204 ? null : response.json();
     } catch (error) {
-      throw new Error(`Request failed: ${error.message}`);
+      throw new Error(`Request failed: ${error.message}`, { cause: error });
     }
   }
   // ==================== AUTH METHODS ====================
@@ -15953,7 +15885,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Registration failed: ${error.message}`);
+      throw new Error(`Registration failed: ${error.message}`, { cause: error });
     }
   }
   async login(email, password) {
@@ -15982,7 +15914,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Login failed: ${error.message}`);
+      throw new Error(`Login failed: ${error.message}`, { cause: error });
     }
   }
   async logout() {
@@ -16001,7 +15933,7 @@ var CoreService = class extends BaseService {
         this._tokenManager.clearTokens();
       }
       this.updateContext({ authToken: null });
-      throw new Error(`Logout failed: ${error.message}`);
+      throw new Error(`Logout failed: ${error.message}`, { cause: error });
     }
   }
   async refreshToken(refreshToken) {
@@ -16016,7 +15948,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Token refresh failed: ${error.message}`);
+      throw new Error(`Token refresh failed: ${error.message}`, { cause: error });
     }
   }
   async googleAuth(idToken, inviteToken = null) {
@@ -16049,7 +15981,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Google auth failed: ${error.message}`);
+      throw new Error(`Google auth failed: ${error.message}`, { cause: error });
     }
   }
   async githubAuth(code, inviteToken = null) {
@@ -16082,7 +16014,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`GitHub auth failed: ${error.message}`);
+      throw new Error(`GitHub auth failed: ${error.message}`, { cause: error });
     }
   }
   async googleAuthCallback(code, redirectUri, inviteToken = null) {
@@ -16115,7 +16047,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Google auth callback failed: ${error.message}`);
+      throw new Error(`Google auth callback failed: ${error.message}`, { cause: error });
     }
   }
   async requestPasswordReset(email) {
@@ -16130,7 +16062,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password reset request failed: ${error.message}`);
+      throw new Error(`Password reset request failed: ${error.message}`, { cause: error });
     }
   }
   async confirmPasswordReset(token, password) {
@@ -16145,7 +16077,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password reset confirmation failed: ${error.message}`);
+      throw new Error(`Password reset confirmation failed: ${error.message}`, { cause: error });
     }
   }
   async confirmRegistration(token) {
@@ -16160,7 +16092,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Registration confirmation failed: ${error.message}`);
+      throw new Error(`Registration confirmation failed: ${error.message}`, { cause: error });
     }
   }
   async requestPasswordChange() {
@@ -16175,7 +16107,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password change request failed: ${error.message}`);
+      throw new Error(`Password change request failed: ${error.message}`, { cause: error });
     }
   }
   async confirmPasswordChange(currentPassword, newPassword, code) {
@@ -16191,7 +16123,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password change confirmation failed: ${error.message}`);
+      throw new Error(`Password change confirmation failed: ${error.message}`, { cause: error });
     }
   }
   async getMe() {
@@ -16206,7 +16138,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user profile: ${error.message}`);
+      throw new Error(`Failed to get user profile: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -16322,7 +16254,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to update user profile: ${error.message}`);
+      throw new Error(`Failed to update user profile: ${error.message}`, { cause: error });
     }
   }
   async getUserProjects() {
@@ -16345,7 +16277,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user projects: ${error.message}`);
+      throw new Error(`Failed to get user projects: ${error.message}`, { cause: error });
     }
   }
   async getUser(userId) {
@@ -16363,7 +16295,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user: ${error.message}`);
+      throw new Error(`Failed to get user: ${error.message}`, { cause: error });
     }
   }
   async getUserByEmail(email) {
@@ -16381,7 +16313,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user by email: ${error.message}`);
+      throw new Error(`Failed to get user by email: ${error.message}`, { cause: error });
     }
   }
   // ==================== PROJECT METHODS ====================
@@ -21953,12 +21885,54 @@ function isPlainObject(o) {
   return o && typeof o === "object" && !Array.isArray(o);
 }
 function deepEqual(a, b) {
-  try {
-    return JSON.stringify(a) === JSON.stringify(b);
-  } catch (err) {
-    console.warn("deepEqual error", err);
+  if (Object.is(a, b)) {
+    return true;
+  }
+  if (typeof a === "function" && typeof b === "function") {
+    try {
+      return a.toString() === b.toString();
+    } catch {
+      return false;
+    }
+  }
+  if (typeof a === "function" || typeof b === "function") {
     return false;
   }
+  if (a instanceof Date && b instanceof Date) {
+    return a.getTime() === b.getTime();
+  }
+  if (a instanceof RegExp && b instanceof RegExp) {
+    return String(a) === String(b);
+  }
+  if (Array.isArray(a) && Array.isArray(b)) {
+    if (a.length !== b.length) {
+      return false;
+    }
+    for (let i = 0; i < a.length; i++) {
+      if (!deepEqual(a[i], b[i])) {
+        return false;
+      }
+    }
+    return true;
+  }
+  if (a && b && typeof a === "object" && typeof b === "object") {
+    const aKeys = Object.keys(a);
+    const bKeys = Object.keys(b);
+    if (aKeys.length !== bKeys.length) {
+      return false;
+    }
+    for (let i = 0; i < aKeys.length; i++) {
+      const key = aKeys[i];
+      if (!Object.hasOwn(b, key)) {
+        return false;
+      }
+      if (!deepEqual(a[key], b[key])) {
+        return false;
+      }
+    }
+    return true;
+  }
+  return false;
 }
 function getRootMap(ydoc) {
   return ydoc.getMap("root");
@@ -28337,86 +28311,452 @@ var validateParams = {
 };
 
 // src/services/CollabService.js
-import { deepStringify } from "@domql/utils";
-var CollabService = class extends BaseService {
-  constructor(config) {
-    super(config);
-    this._client = null;
-    this._stateManager = null;
-    this._connected = false;
-    this._undoStack = [];
-    this._redoStack = [];
-    this._isUndoRedo = false;
-    this._pendingOps = [];
+import { deepStringifyFunctions } from "@domql/utils";
+
+// src/utils/ordering.js
+function isObjectLike(val) {
+  return val && typeof val === "object" && !Array.isArray(val);
+}
+function normalizePath(path) {
+  if (Array.isArray(path)) {
+    return path;
   }
-  init({ context }) {
-    if (context == null ? void 0 : context.state) {
-      try {
-        this._stateManager = new RootStateManager(context.state);
-      } catch (err) {
-        this._setError(err);
-        throw err;
-      }
-    }
-    this._setReady();
+  if (typeof path === "string") {
+    return [path];
   }
-  /**
-   * Overridden to re-initialise the state manager once the root state becomes
-   * available via a subsequent SDK `updateContext()` call.
-   */
-  updateContext(context = {}) {
-    super.updateContext(context);
-    if (context.state) {
-      this._stateManager = new RootStateManager(context.state);
+  return [];
+}
+function getParentPathsFromTuples(tuples = []) {
+  const seen = /* @__PURE__ */ new Set();
+  const parents = [];
+  const META_KEYS = /* @__PURE__ */ new Set([
+    "style",
+    "class",
+    "text",
+    "html",
+    "content",
+    "data",
+    "attr",
+    "state",
+    "scope",
+    "define",
+    "on",
+    "extend",
+    "extends",
+    "childExtend",
+    "childExtends",
+    "children",
+    "component",
+    "context",
+    "tag",
+    "key",
+    "__order",
+    "if"
+  ]);
+  for (let i = 0; i < tuples.length; i++) {
+    const tuple = tuples[i];
+    if (!Array.isArray(tuple) || tuple.length < 2) {
+      continue;
     }
-  }
-  /**
-   * Ensure that the state manager exists. This is called right before any
-   * operation that requires access to the root state (e.g. `connect()`).
-   * Throws an explicit error if the root state is still missing so that the
-   * caller can react accordingly.
-   */
-  _ensureStateManager() {
-    var _a, _b;
-    if (!this._stateManager) {
-      if (!((_a = this._context) == null ? void 0 : _a.state)) {
-        throw new Error("[CollabService] Cannot operate without root state");
+    const path = normalizePath(tuple[1]);
+    if (!path.length) {
+      continue;
+    }
+    if (path[0] === "schema") {
+      continue;
+    }
+    const immediateParent = path.slice(0, -1);
+    if (immediateParent.length) {
+      const key = JSON.stringify(immediateParent);
+      if (!seen.has(key)) {
+        seen.add(key);
+        parents.push(immediateParent);
       }
-      this._stateManager = new RootStateManager(this._context.state);
     }
-    const root = (_b = this._stateManager) == null ? void 0 : _b.root;
-    if (root && !root.__element) {
-      root.__element = {
-        /**
-         * Very small subset of the DOMQL `call` API that we rely on inside the
-         * CollabService for browser notifications and data helpers.
-         * In a Node.js test context we simply log or return fallbacks.
-         */
-        call: (method, ...args2) => {
-          switch (method) {
-            case "openNotification": {
-              const [payload = {}] = args2;
-              const { type = "info", title = "", message = "" } = payload;
-              const logger = type === "error" ? console.error : console.log;
-              logger(`[Notification] ${title}${message ? ` \u2013 ${message}` : ""}`);
-              return;
-            }
-            case "deepStringify": {
-              return deepStringify(...args2);
-            }
-            default:
-              return {};
-          }
+    const last2 = path[path.length - 1];
+    if (META_KEYS.has(last2) && path.length >= 2) {
+      const containerParent = path.slice(0, -2);
+      if (containerParent.length) {
+        const key2 = JSON.stringify(containerParent);
+        if (!seen.has(key2)) {
+          seen.add(key2);
+          parents.push(containerParent);
         }
-      };
+      }
+    }
+    for (let j = 0; j < path.length; j++) {
+      const seg = path[j];
+      if (!META_KEYS.has(seg)) {
+        continue;
+      }
+      const containerParent2 = path.slice(0, j);
+      if (!containerParent2.length) {
+        continue;
+      }
+      const key3 = JSON.stringify(containerParent2);
+      if (!seen.has(key3)) {
+        seen.add(key3);
+        parents.push(containerParent2);
+      }
     }
   }
-  /* ---------- Connection Management ---------- */
-  async connect(options = {}) {
-    var _a, _b, _c, _d, _e, _f;
-    this._ensureStateManager();
-    const {
-      authToken: jwt,
+  return parents;
+}
+function computeOrdersFromState(root, parentPaths = []) {
+  if (!root || typeof root.getByPath !== "function") {
+    return [];
+  }
+  const orders = [];
+  const EXCLUDE_KEYS = /* @__PURE__ */ new Set(["__order"]);
+  for (let i = 0; i < parentPaths.length; i++) {
+    const parentPath = parentPaths[i];
+    const obj = (() => {
+      try {
+        return root.getByPath(parentPath);
+      } catch {
+        return null;
+      }
+    })();
+    if (!isObjectLike(obj)) {
+      continue;
+    }
+    const keys2 = Object.keys(obj).filter((k) => !EXCLUDE_KEYS.has(k));
+    orders.push({ path: parentPath, keys: keys2 });
+  }
+  return orders;
+}
+function normaliseSchemaCode(code) {
+  if (typeof code !== "string" || !code.length) {
+    return "";
+  }
+  return code.replaceAll("/////n", "\n").replaceAll("/////tilde", "`");
+}
+function parseExportedObject(code) {
+  const src = normaliseSchemaCode(code);
+  if (!src) {
+    return null;
+  }
+  const body = src.replace(/^\s*export\s+default\s*/u, "return ");
+  try {
+    return new Function(body)();
+  } catch {
+    return null;
+  }
+}
+function extractTopLevelKeysFromCode(code) {
+  const obj = parseExportedObject(code);
+  if (!obj || typeof obj !== "object") {
+    return [];
+  }
+  return Object.keys(obj);
+}
+function computeOrdersForTuples(root, tuples = []) {
+  const pendingChildrenByContainer = /* @__PURE__ */ new Map();
+  for (let i = 0; i < tuples.length; i++) {
+    const t = tuples[i];
+    if (!Array.isArray(t)) {
+      continue;
+    }
+    const [action, path] = t;
+    const p = normalizePath(path);
+    if (!Array.isArray(p) || p.length < 3) {
+      continue;
+    }
+    if (p[0] === "schema") {
+      continue;
+    }
+    const [typeName, containerKey, childKey] = p;
+    const containerPath = [typeName, containerKey];
+    const key = JSON.stringify(containerPath);
+    if (!pendingChildrenByContainer.has(key)) {
+      pendingChildrenByContainer.set(key, /* @__PURE__ */ new Set());
+    }
+    if (action === "update" || action === "set") {
+      pendingChildrenByContainer.get(key).add(childKey);
+    }
+  }
+  const preferredOrderMap = /* @__PURE__ */ new Map();
+  for (let i = 0; i < tuples.length; i++) {
+    const t = tuples[i];
+    if (!Array.isArray(t)) {
+      continue;
+    }
+    const [action, path, value2] = t;
+    const p = normalizePath(path);
+    if (action !== "update" || !Array.isArray(p) || p.length < 3) {
+      continue;
+    }
+    if (p[0] !== "schema") {
+      continue;
+    }
+    const [, type, key] = p;
+    const containerPath = [type, key];
+    const uses = value2 && Array.isArray(value2.uses) ? value2.uses : null;
+    const code = value2 && value2.code;
+    const obj = (() => {
+      try {
+        return root && typeof root.getByPath === "function" ? root.getByPath(containerPath) : null;
+      } catch {
+        return null;
+      }
+    })();
+    if (!obj) {
+      continue;
+    }
+    const present = new Set(Object.keys(obj));
+    const EXCLUDE_KEYS = /* @__PURE__ */ new Set(["__order"]);
+    const codeKeys = extractTopLevelKeysFromCode(code);
+    let resolved = [];
+    const pendingKey = JSON.stringify(containerPath);
+    const pendingChildren = pendingChildrenByContainer.get(pendingKey) || /* @__PURE__ */ new Set();
+    const eligible = /* @__PURE__ */ new Set([...present, ...pendingChildren]);
+    if (Array.isArray(codeKeys) && codeKeys.length) {
+      resolved = codeKeys.filter((k) => eligible.has(k) && !EXCLUDE_KEYS.has(k));
+    }
+    if (Array.isArray(uses) && uses.length) {
+      for (let u = 0; u < uses.length; u++) {
+        const keyName = uses[u];
+        if (eligible.has(keyName) && !EXCLUDE_KEYS.has(keyName) && !resolved.includes(keyName)) {
+          resolved.push(keyName);
+        }
+      }
+    }
+    if (pendingChildren.size) {
+      for (const child of pendingChildren) {
+        if (!EXCLUDE_KEYS.has(child) && !resolved.includes(child)) {
+          resolved.push(child);
+        }
+      }
+    }
+    if (resolved.length) {
+      preferredOrderMap.set(JSON.stringify(containerPath), { path: containerPath, keys: resolved });
+    }
+  }
+  const parents = getParentPathsFromTuples(tuples);
+  const orders = [];
+  const seen = /* @__PURE__ */ new Set();
+  preferredOrderMap.forEach((v) => {
+    const k = JSON.stringify(v.path);
+    if (!seen.has(k)) {
+      seen.add(k);
+      orders.push(v);
+    }
+  });
+  const fallbackOrders = computeOrdersFromState(root, parents);
+  for (let i = 0; i < fallbackOrders.length; i++) {
+    const v = fallbackOrders[i];
+    const k = JSON.stringify(v.path);
+    if (seen.has(k)) {
+      continue;
+    }
+    const pending = pendingChildrenByContainer.get(k);
+    if (pending && pending.size) {
+      const existing = new Set(v.keys);
+      for (const child of pending) {
+        if (existing.has(child)) {
+          continue;
+        }
+        v.keys.push(child);
+      }
+    }
+    seen.add(k);
+    orders.push(v);
+  }
+  return orders;
+}
+
+// src/utils/changePreprocessor.js
+function isPlainObject2(val) {
+  return val && typeof val === "object" && !Array.isArray(val);
+}
+function getByPathSafe(root, path) {
+  if (!root || typeof root.getByPath !== "function") {
+    return null;
+  }
+  try {
+    return root.getByPath(path);
+  } catch {
+    return null;
+  }
+}
+function preprocessChanges(root, tuples = [], options = {}) {
+  const expandTuple = (t) => {
+    const [action, path, value2] = t || [];
+    const isSchemaPath = Array.isArray(path) && path[0] === "schema";
+    if (action === "delete") {
+      return [t];
+    }
+    const canConsiderExpansion = action === "update" && Array.isArray(path) && (path.length === 1 || path.length === 2 || isSchemaPath && path.length === 3) && isPlainObject2(value2);
+    if (!canConsiderExpansion) {
+      return [t];
+    }
+    const prev = getByPathSafe(root, path) || {};
+    const next = value2 || {};
+    if (!isPlainObject2(prev) || !isPlainObject2(next)) {
+      return [t];
+    }
+    const ops = diffJson(prev, next, []);
+    if (!ops.length) {
+      return [t];
+    }
+    const out = [];
+    for (let i = 0; i < ops.length; i++) {
+      const op = ops[i];
+      const fullPath = [...path, ...op.path];
+      const last2 = fullPath[fullPath.length - 1];
+      if (op.action === "set") {
+        out.push(["update", fullPath, op.value]);
+      } else if (op.action === "del") {
+        if (last2 !== "__order") {
+          out.push(["delete", fullPath]);
+        }
+      }
+    }
+    return out;
+  };
+  const minimizeTuples = (input) => {
+    const out = [];
+    const seen2 = /* @__PURE__ */ new Set();
+    for (let i = 0; i < input.length; i++) {
+      const expanded = expandTuple(input[i]);
+      for (let k = 0; k < expanded.length; k++) {
+        const tuple = expanded[k];
+        const isDelete = Array.isArray(tuple) && tuple[0] === "delete";
+        const isOrderKey = isDelete && Array.isArray(tuple[1]) && tuple[1][tuple[1].length - 1] === "__order";
+        if (!isOrderKey) {
+          const key = JSON.stringify(tuple);
+          if (!seen2.has(key)) {
+            seen2.add(key);
+            out.push(tuple);
+          }
+        }
+      }
+    }
+    return out;
+  };
+  const granularChanges = (() => {
+    try {
+      const res = minimizeTuples(tuples);
+      if (options.append && options.append.length) {
+        res.push(...options.append);
+      }
+      return res;
+    } catch {
+      return Array.isArray(tuples) ? tuples.slice() : [];
+    }
+  })();
+  const baseOrders = computeOrdersForTuples(root, granularChanges);
+  const preferOrdersMap = /* @__PURE__ */ new Map();
+  for (let i = 0; i < tuples.length; i++) {
+    const t = tuples[i];
+    if (!Array.isArray(t) || t.length < 3) {
+      continue;
+    }
+    const [action, path, value2] = t;
+    if (action !== "update" || !Array.isArray(path) || path.length !== 1 && path.length !== 2 || !isPlainObject2(value2)) {
+      continue;
+    }
+    const keys2 = Object.keys(value2).filter((k) => k !== "__order");
+    const key = JSON.stringify(path);
+    preferOrdersMap.set(key, { path, keys: keys2 });
+  }
+  const mergedOrders = [];
+  const seen = /* @__PURE__ */ new Set();
+  preferOrdersMap.forEach((v, k) => {
+    seen.add(k);
+    mergedOrders.push(v);
+  });
+  for (let i = 0; i < baseOrders.length; i++) {
+    const v = baseOrders[i];
+    const k = JSON.stringify(v.path);
+    if (!seen.has(k)) {
+      seen.add(k);
+      mergedOrders.push(v);
+    }
+  }
+  return { granularChanges, orders: mergedOrders };
+}
+
+// src/services/CollabService.js
+var CollabService = class extends BaseService {
+  constructor(config) {
+    super(config);
+    this._client = null;
+    this._stateManager = null;
+    this._connected = false;
+    this._undoStack = [];
+    this._redoStack = [];
+    this._isUndoRedo = false;
+    this._pendingOps = [];
+  }
+  init({ context }) {
+    if (context == null ? void 0 : context.state) {
+      try {
+        this._stateManager = new RootStateManager(context.state);
+      } catch (err) {
+        this._setError(err);
+        throw err;
+      }
+    }
+    this._setReady();
+  }
+  /**
+   * Overridden to re-initialise the state manager once the root state becomes
+   * available via a subsequent SDK `updateContext()` call.
+   */
+  updateContext(context = {}) {
+    super.updateContext(context);
+    if (context.state) {
+      this._stateManager = new RootStateManager(context.state);
+    }
+  }
+  /**
+   * Ensure that the state manager exists. This is called right before any
+   * operation that requires access to the root state (e.g. `connect()`).
+   * Throws an explicit error if the root state is still missing so that the
+   * caller can react accordingly.
+   */
+  _ensureStateManager() {
+    var _a, _b;
+    if (!this._stateManager) {
+      if (!((_a = this._context) == null ? void 0 : _a.state)) {
+        throw new Error("[CollabService] Cannot operate without root state");
+      }
+      this._stateManager = new RootStateManager(this._context.state);
+    }
+    const root = (_b = this._stateManager) == null ? void 0 : _b.root;
+    if (root && !root.__element) {
+      root.__element = {
+        /**
+         * Very small subset of the DOMQL `call` API that we rely on inside the
+         * CollabService for browser notifications and data helpers.
+         * In a Node.js test context we simply log or return fallbacks.
+         */
+        call: (method, ...args2) => {
+          switch (method) {
+            case "openNotification": {
+              const [payload = {}] = args2;
+              const { type = "info", title = "", message = "" } = payload;
+              const logger = type === "error" ? console.error : console.log;
+              logger(`[Notification] ${title}${message ? ` \u2013 ${message}` : ""}`);
+              return;
+            }
+            case "deepStringifyFunctions": {
+              return deepStringifyFunctions(...args2);
+            }
+            default:
+              return {};
+          }
+        }
+      };
+    }
+  }
+  /* ---------- Connection Management ---------- */
+  async connect(options = {}) {
+    var _a, _b, _c, _d, _e, _f;
+    this._ensureStateManager();
+    const {
+      authToken: jwt,
       projectId,
       branch = "main",
       pro
@@ -28437,57 +28777,49 @@ var CollabService = class extends BaseService {
     if (this._client) {
       await this.disconnect();
     }
-    try {
-      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);
-        }
-      });
-      console.log("[CollabService] socket connected");
-      (_b = this._client.socket) == null ? void 0 : _b.on("ops", ({ changes }) => {
-        console.log(`ops event`);
-        console.log(changes);
-        this._stateManager.applyChanges(changes, { fromSocket: true });
-      });
-      (_c = this._client.socket) == null ? void 0 : _c.on("commit", ({ version: version2 }) => {
-        if (version2) {
-          this._stateManager.setVersion(version2);
-        }
-        rootBus.emit("checkpoint:done", { version: version2, 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(({ tuples }) => {
-          this.socket.emit("ops", { changes: tuples, ts: Date.now() });
-        });
-        this._pendingOps.length = 0;
+    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._connected = true;
-      console.log("[CollabService] Connected to project:", projectId);
-    } catch (err) {
-      console.error("[CollabService] Connection failed:", err);
-      throw err;
+    });
+    (_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: version2 }) => {
+      if (version2) {
+        this._stateManager.setVersion(version2);
+      }
+      rootBus.emit("checkpoint:done", { version: version2, 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._pendingOps.length = 0;
     }
+    this._connected = true;
   }
   disconnect() {
     var _a;
@@ -28525,24 +28857,60 @@ var CollabService = class extends BaseService {
   }
   /* ---------- data helpers ---------- */
   updateData(tuples, options = {}) {
-    var _a;
+    var _a, _b, _c;
     this._ensureStateManager();
     const { isUndo = false, isRedo = false } = options;
     if (!isUndo && !isRedo && !this._isUndoRedo) {
       this._trackForUndo(tuples, options);
     }
+    const root = (_a = this._stateManager) == null ? void 0 : _a.root;
+    const { granularChanges: processedTuples, orders } = preprocessChanges(
+      root,
+      tuples,
+      options
+    );
     if (options.append && options.append.length) {
-      tuples.push(...options.append);
+      processedTuples.push(...options.append);
     }
     this._stateManager.applyChanges(tuples, { ...options });
-    tuples = deepStringify(tuples, []);
+    const state = (_b = this._stateManager) == null ? void 0 : _b.root;
+    const el = state == null ? void 0 : state.__element;
+    const stringifiedGranularTuples = (el == null ? void 0 : el.call) ? el.call(
+      "deepStringifyFunctions",
+      processedTuples,
+      Array.isArray(processedTuples) ? [] : {}
+    ) : deepStringifyFunctions(
+      processedTuples,
+      Array.isArray(processedTuples) ? [] : {}
+    );
+    const stringifiedTuples = (el == null ? void 0 : el.call) ? el.call(
+      "deepStringifyFunctions",
+      tuples,
+      Array.isArray(tuples) ? [] : {}
+    ) : deepStringifyFunctions(tuples, Array.isArray(tuples) ? [] : {});
     if (!this.isConnected()) {
       console.warn("[CollabService] Not connected, queuing real-time update");
-      this._pendingOps.push({ tuples, options });
+      this._pendingOps.push({
+        changes: stringifiedTuples,
+        granularChanges: stringifiedGranularTuples,
+        orders,
+        options
+      });
       return;
     }
-    if ((_a = this.socket) == null ? void 0 : _a.connected) {
-      this.socket.emit("ops", { changes: tuples, ts: Date.now() });
+    if ((_c = this.socket) == null ? void 0 : _c.connected) {
+      console.log("[CollabService] Sending operations to the backend", {
+        changes: stringifiedTuples,
+        granularChanges: stringifiedGranularTuples,
+        orders,
+        ts: Date.now()
+      });
+      this.socket.emit("ops", {
+        changes: stringifiedTuples,
+        granularChanges: stringifiedGranularTuples,
+        orders,
+        ts: Date.now()
+      });
     }
     return { success: true };
   }
@@ -28683,7 +29051,7 @@ var CollabService = class extends BaseService {
       const updatedOpts = { ...opts, skipComponentsChangedEvent: true };
       return this.updateData(tuples, updatedOpts);
     } catch (error) {
-      throw new Error(`Failed to add item: ${error.message}`);
+      throw new Error(`Failed to add item: ${error.message}`, { cause: error });
     }
   }
   addMultipleItems(items, opts = {}) {
@@ -28712,7 +29080,7 @@ var CollabService = class extends BaseService {
         title: "Failed to add item",
         message: error.message
       });
-      throw new Error(`Failed to add item: ${error.message}`);
+      throw new Error(`Failed to add item: ${error.message}`, { cause: error });
     }
   }
   updateItem(type, data2, opts = {}) {
@@ -28734,7 +29102,9 @@ var CollabService = class extends BaseService {
         title: "Failed to update item",
         message: error.message
       });
-      throw new Error(`Failed to update item: ${error.message}`);
+      throw new Error(`Failed to update item: ${error.message}`, {
+        cause: error
+      });
     }
   }
   deleteItem(type, key, opts = {}) {
@@ -28759,7 +29129,9 @@ var CollabService = class extends BaseService {
         title: "Failed to delete item",
         message: error.message
       });
-      throw new Error(`Failed to delete item: ${error.message}`);
+      throw new Error(`Failed to delete item: ${error.message}`, {
+        cause: error
+      });
     }
   }
   /* ---------- socket event helpers ---------- */
@@ -28852,6 +29224,7 @@ var CollabService = class extends BaseService {
 };
 
 // src/services/ProjectService.js
+import { deepStringifyFunctions as deepStringifyFunctions2 } from "@domql/utils";
 var ProjectService = class extends BaseService {
   // ==================== PROJECT METHODS ====================
   async createProject(projectData) {
@@ -28867,7 +29240,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to create project: ${error.message}`);
+      throw new Error(`Failed to create project: ${error.message}`, { cause: error });
     }
   }
   async getProjects(params2 = {}) {
@@ -28890,7 +29263,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get projects: ${error.message}`);
+      throw new Error(`Failed to get projects: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -28921,7 +29294,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to list public projects: ${error.message}`);
+      throw new Error(`Failed to list public projects: ${error.message}`, { cause: error });
     }
   }
   async getProject(projectId) {
@@ -28943,7 +29316,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get project: ${error.message}`);
+      throw new Error(`Failed to get project: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -28968,7 +29341,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get public project: ${error.message}`);
+      throw new Error(`Failed to get public project: ${error.message}`, { cause: error });
     }
   }
   async getProjectByKey(key) {
@@ -28990,7 +29363,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get project by key: ${error.message}`);
+      throw new Error(`Failed to get project by key: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29024,7 +29397,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get project data by key: ${error.message}`);
+      throw new Error(`Failed to get project data by key: ${error.message}`, { cause: error });
     }
   }
   async updateProject(projectId, data2) {
@@ -29043,7 +29416,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to update project: ${error.message}`);
+      throw new Error(`Failed to update project: ${error.message}`, { cause: error });
     }
   }
   async updateProjectComponents(projectId, components) {
@@ -29065,7 +29438,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to update project components: ${error.message}`);
+      throw new Error(`Failed to update project components: ${error.message}`, { cause: error });
     }
   }
   async updateProjectSettings(projectId, settings) {
@@ -29084,7 +29457,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to update project settings: ${error.message}`);
+      throw new Error(`Failed to update project settings: ${error.message}`, { cause: error });
     }
   }
   async updateProjectName(projectId, name) {
@@ -29103,7 +29476,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to update project name: ${error.message}`);
+      throw new Error(`Failed to update project name: ${error.message}`, { cause: error });
     }
   }
   async updateProjectPackage(projectId, pkg) {
@@ -29122,7 +29495,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to update project package: ${error.message}`);
+      throw new Error(`Failed to update project package: ${error.message}`, { cause: error });
     }
   }
   async duplicateProject(projectId, newName, newKey, targetUserId) {
@@ -29141,7 +29514,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to duplicate project: ${error.message}`);
+      throw new Error(`Failed to duplicate project: ${error.message}`, { cause: error });
     }
   }
   async removeProject(projectId) {
@@ -29159,7 +29532,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to remove project: ${error.message}`);
+      throw new Error(`Failed to remove project: ${error.message}`, { cause: error });
     }
   }
   async checkProjectKeyAvailability(key) {
@@ -29178,7 +29551,8 @@ var ProjectService = class extends BaseService {
       throw new Error(response.message);
     } catch (error) {
       throw new Error(
-        `Failed to check project key availability: ${error.message}`
+        `Failed to check project key availability: ${error.message}`,
+        { cause: error }
       );
     }
   }
@@ -29198,7 +29572,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get project members: ${error.message}`);
+      throw new Error(`Failed to get project members: ${error.message}`, { cause: error });
     }
   }
   async inviteMember(projectId, email, role = "guest", options = {}) {
@@ -29227,7 +29601,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to invite member: ${error.message}`);
+      throw new Error(`Failed to invite member: ${error.message}`, { cause: error });
     }
   }
   async acceptInvite(token) {
@@ -29246,7 +29620,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to accept invite: ${error.message}`);
+      throw new Error(`Failed to accept invite: ${error.message}`, { cause: error });
     }
   }
   async updateMemberRole(projectId, memberId, role) {
@@ -29268,7 +29642,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to update member role: ${error.message}`);
+      throw new Error(`Failed to update member role: ${error.message}`, { cause: error });
     }
   }
   async removeMember(projectId, memberId) {
@@ -29289,7 +29663,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to remove member: ${error.message}`);
+      throw new Error(`Failed to remove member: ${error.message}`, { cause: error });
     }
   }
   // ==================== PROJECT LIBRARY METHODS ====================
@@ -29309,7 +29683,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get available libraries: ${error.message}`);
+      throw new Error(`Failed to get available libraries: ${error.message}`, { cause: error });
     }
   }
   async getProjectLibraries(projectId) {
@@ -29327,7 +29701,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get project libraries: ${error.message}`);
+      throw new Error(`Failed to get project libraries: ${error.message}`, { cause: error });
     }
   }
   async addProjectLibraries(projectId, libraryIds) {
@@ -29342,11 +29716,11 @@ var ProjectService = class extends BaseService {
         methodName: "addProjectLibraries"
       });
       if (response.success) {
-        return response.data;
+        return response;
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to add project libraries: ${error.message}`);
+      throw new Error(`Failed to add project libraries: ${error.message}`, { cause: error });
     }
   }
   async removeProjectLibraries(projectId, libraryIds) {
@@ -29365,7 +29739,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to remove project libraries: ${error.message}`);
+      throw new Error(`Failed to remove project libraries: ${error.message}`, { cause: error });
     }
   }
   // ==================== PROJECT DATA METHODS (SYMSTORY REPLACEMENT) ====================
@@ -29382,14 +29756,20 @@ var ProjectService = class extends BaseService {
       throw new Error("Changes must be an array");
     }
     const { message, branch = "main", type = "patch" } = 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) : []);
+    const stringify = (val) => deepStringifyFunctions2(val, Array.isArray(val) ? [] : {});
     try {
       const response = await this._request(`/projects/${projectId}/changes`, {
         method: "POST",
         body: JSON.stringify({
-          changes,
+          changes: stringify(changes),
+          granularChanges: stringify(granularChanges),
           message,
           branch,
-          type
+          type,
+          ...derivedOrders && derivedOrders.length ? { orders: derivedOrders } : {}
         }),
         methodName: "applyProjectChanges"
       });
@@ -29398,7 +29778,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to apply project changes: ${error.message}`);
+      throw new Error(`Failed to apply project changes: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29433,7 +29813,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get project data: ${error.message}`);
+      throw new Error(`Failed to get project data: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29463,7 +29843,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get project versions: ${error.message}`);
+      throw new Error(`Failed to get project versions: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29495,7 +29875,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to restore project version: ${error.message}`);
+      throw new Error(`Failed to restore project version: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29595,7 +29975,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get favorite projects: ${error.message}`);
+      throw new Error(`Failed to get favorite projects: ${error.message}`, { cause: error });
     }
   }
   async addFavoriteProject(projectId) {
@@ -29613,7 +29993,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to add favorite project: ${error.message}`);
+      throw new Error(`Failed to add favorite project: ${error.message}`, { cause: error });
     }
   }
   async removeFavoriteProject(projectId) {
@@ -29631,7 +30011,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to remove favorite project: ${error.message}`);
+      throw new Error(`Failed to remove favorite project: ${error.message}`, { cause: error });
     }
   }
   // ==================== RECENT PROJECT METHODS ====================
@@ -29660,7 +30040,7 @@ var ProjectService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get recent projects: ${error.message}`);
+      throw new Error(`Failed to get recent projects: ${error.message}`, { cause: error });
     }
   }
 };
@@ -29682,7 +30062,7 @@ var PlanService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get plans: ${error.message}`);
+      throw new Error(`Failed to get plans: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29702,7 +30082,7 @@ var PlanService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get plan: ${error.message}`);
+      throw new Error(`Failed to get plan: ${error.message}`, { cause: error });
     }
   }
   // ==================== ADMIN PLAN METHODS ====================
@@ -29721,7 +30101,7 @@ var PlanService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get admin plans: ${error.message}`);
+      throw new Error(`Failed to get admin plans: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29743,7 +30123,7 @@ var PlanService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to create plan: ${error.message}`);
+      throw new Error(`Failed to create plan: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29768,7 +30148,7 @@ var PlanService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to update plan: ${error.message}`);
+      throw new Error(`Failed to update plan: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29789,7 +30169,7 @@ var PlanService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to delete plan: ${error.message}`);
+      throw new Error(`Failed to delete plan: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29807,7 +30187,7 @@ var PlanService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to initialize plans: ${error.message}`);
+      throw new Error(`Failed to initialize plans: ${error.message}`, { cause: error });
     }
   }
   // ==================== PLAN HELPER METHODS ====================
@@ -29822,7 +30202,7 @@ var PlanService = class extends BaseService {
       }
       return plans;
     } catch (error) {
-      throw new Error(`Failed to get plans with validation: ${error.message}`);
+      throw new Error(`Failed to get plans with validation: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29839,7 +30219,7 @@ var PlanService = class extends BaseService {
       }
       return plan;
     } catch (error) {
-      throw new Error(`Failed to get plan with validation: ${error.message}`);
+      throw new Error(`Failed to get plan with validation: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29891,7 +30271,7 @@ var PlanService = class extends BaseService {
       const plans = await this.getPlans();
       return plans.filter((plan) => plan.active !== false);
     } catch (error) {
-      throw new Error(`Failed to get active plans: ${error.message}`);
+      throw new Error(`Failed to get active plans: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29905,7 +30285,7 @@ var PlanService = class extends BaseService {
         return price >= minPrice && price <= maxPrice;
       });
     } catch (error) {
-      throw new Error(`Failed to get plans by price range: ${error.message}`);
+      throw new Error(`Failed to get plans by price range: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29923,7 +30303,7 @@ var PlanService = class extends BaseService {
       }
       return plan;
     } catch (error) {
-      throw new Error(`Failed to get plan by key: ${error.message}`);
+      throw new Error(`Failed to get plan by key: ${error.message}`, { cause: error });
     }
   }
 };
@@ -29964,7 +30344,7 @@ var SubscriptionService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to create subscription: ${error.message}`);
+      throw new Error(`Failed to create subscription: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -29985,7 +30365,7 @@ var SubscriptionService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get project subscription status: ${error.message}`);
+      throw new Error(`Failed to get project subscription status: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30006,7 +30386,7 @@ var SubscriptionService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get subscription usage: ${error.message}`);
+      throw new Error(`Failed to get subscription usage: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30027,7 +30407,7 @@ var SubscriptionService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to cancel subscription: ${error.message}`);
+      throw new Error(`Failed to cancel subscription: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30064,7 +30444,7 @@ var SubscriptionService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to list invoices: ${error.message}`);
+      throw new Error(`Failed to list invoices: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30091,7 +30471,7 @@ var SubscriptionService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get portal URL: ${error.message}`);
+      throw new Error(`Failed to get portal URL: ${error.message}`, { cause: error });
     }
   }
   // ==================== SUBSCRIPTION HELPER METHODS ====================
@@ -30126,7 +30506,7 @@ var SubscriptionService = class extends BaseService {
       const status = await this.getProjectStatus(projectId);
       return status.hasSubscription === true;
     } catch (error) {
-      throw new Error(`Failed to check subscription status: ${error.message}`);
+      throw new Error(`Failed to check subscription status: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30140,7 +30520,7 @@ var SubscriptionService = class extends BaseService {
       }
       return status.subscription;
     } catch (error) {
-      throw new Error(`Failed to get project subscription: ${error.message}`);
+      throw new Error(`Failed to get project subscription: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30154,7 +30534,7 @@ var SubscriptionService = class extends BaseService {
       }
       return status.usage;
     } catch (error) {
-      throw new Error(`Failed to get project usage: ${error.message}`);
+      throw new Error(`Failed to get project usage: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30168,7 +30548,7 @@ var SubscriptionService = class extends BaseService {
         pagination: result.pagination || {}
       };
     } catch (error) {
-      throw new Error(`Failed to get invoices with pagination: ${error.message}`);
+      throw new Error(`Failed to get invoices with pagination: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30179,7 +30559,7 @@ var SubscriptionService = class extends BaseService {
       const usage = await this.getUsage(subscriptionId);
       return usage && usage.subscription && usage.subscription.status === "active";
     } catch (error) {
-      throw new Error(`Failed to check subscription status: ${error.message}`);
+      throw new Error(`Failed to check subscription status: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30190,7 +30570,7 @@ var SubscriptionService = class extends BaseService {
       const usage = await this.getUsage(subscriptionId);
       return usage.limits || {};
     } catch (error) {
-      throw new Error(`Failed to get subscription limits: ${error.message}`);
+      throw new Error(`Failed to get subscription limits: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30226,7 +30606,7 @@ var SubscriptionService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to change subscription: ${error.message}`);
+      throw new Error(`Failed to change subscription: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30254,7 +30634,7 @@ var SubscriptionService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to downgrade subscription: ${error.message}`);
+      throw new Error(`Failed to downgrade subscription: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -30343,7 +30723,7 @@ var FileService = class extends BaseService {
         message: response.message
       };
     } catch (error) {
-      throw new Error(`File upload failed: ${error.message}`);
+      throw new Error(`File upload failed: ${error.message}`, { cause: error });
     }
   }
   async updateProjectIcon(projectId, iconFile) {
@@ -30367,7 +30747,7 @@ var FileService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to update project icon: ${error.message}`);
+      throw new Error(`Failed to update project icon: ${error.message}`, { cause: error });
     }
   }
   // ==================== FILE HELPER METHODS ====================
@@ -30517,7 +30897,7 @@ var PaymentService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to checkout: ${error.message}`);
+      throw new Error(`Failed to checkout: ${error.message}`, { cause: error });
     }
   }
   async getSubscriptionStatus(projectId) {
@@ -30538,7 +30918,7 @@ var PaymentService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get subscription status: ${error.message}`);
+      throw new Error(`Failed to get subscription status: ${error.message}`, { cause: error });
     }
   }
   // ==================== PAYMENT HELPER METHODS ====================
@@ -30754,7 +31134,7 @@ var DnsService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to create DNS record: ${error.message}`);
+      throw new Error(`Failed to create DNS record: ${error.message}`, { cause: error });
     }
   }
   async getDnsRecord(domain) {
@@ -30772,7 +31152,7 @@ var DnsService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get DNS record: ${error.message}`);
+      throw new Error(`Failed to get DNS record: ${error.message}`, { cause: error });
     }
   }
   async getCustomHost(hostname) {
@@ -30808,7 +31188,7 @@ var DnsService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to remove DNS record: ${error.message}`);
+      throw new Error(`Failed to remove DNS record: ${error.message}`, { cause: error });
     }
   }
   // Deprecated, use addProjectCustomDomains instead
@@ -30832,7 +31212,7 @@ var DnsService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to set project domains: ${error.message}`);
+      throw new Error(`Failed to set project domains: ${error.message}`, { cause: error });
     }
   }
   // customDomains could be a string or an array of strings
@@ -31108,7 +31488,7 @@ var BranchService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to list branches: ${error.message}`);
+      throw new Error(`Failed to list branches: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31134,7 +31514,7 @@ var BranchService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to create branch: ${error.message}`);
+      throw new Error(`Failed to create branch: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31164,7 +31544,7 @@ var BranchService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to delete branch: ${error.message}`);
+      throw new Error(`Failed to delete branch: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31200,7 +31580,7 @@ var BranchService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to rename branch: ${error.message}`);
+      throw new Error(`Failed to rename branch: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31239,7 +31619,7 @@ var BranchService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get branch changes: ${error.message}`);
+      throw new Error(`Failed to get branch changes: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31286,7 +31666,7 @@ var BranchService = class extends BaseService {
       if (error.message.includes("conflicts") || error.message.includes("409")) {
         throw new Error(`Merge conflicts detected: ${error.message}`);
       }
-      throw new Error(`Failed to merge branch: ${error.message}`);
+      throw new Error(`Failed to merge branch: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31315,7 +31695,7 @@ var BranchService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to reset branch: ${error.message}`);
+      throw new Error(`Failed to reset branch: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31341,7 +31721,7 @@ var BranchService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to publish version: ${error.message}`);
+      throw new Error(`Failed to publish version: ${error.message}`, { cause: error });
     }
   }
   // ==================== BRANCH HELPER METHODS ====================
@@ -31373,7 +31753,7 @@ var BranchService = class extends BaseService {
       const branches = await this.listBranches(projectId);
       return ((_a = branches == null ? void 0 : branches.data) == null ? void 0 : _a.includes(branchName)) || false;
     } catch (error) {
-      throw new Error(`Failed to check if branch exists: ${error.message}`);
+      throw new Error(`Failed to check if branch exists: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31443,7 +31823,7 @@ var BranchService = class extends BaseService {
         canRename: exists && branchName !== "main"
       };
     } catch (error) {
-      throw new Error(`Failed to get branch status: ${error.message}`);
+      throw new Error(`Failed to get branch status: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31578,7 +31958,7 @@ var PullRequestService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to create pull request: ${error.message}`);
+      throw new Error(`Failed to create pull request: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31614,7 +31994,7 @@ var PullRequestService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to list pull requests: ${error.message}`);
+      throw new Error(`Failed to list pull requests: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31641,7 +32021,7 @@ var PullRequestService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get pull request: ${error.message}`);
+      throw new Error(`Failed to get pull request: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31675,7 +32055,7 @@ var PullRequestService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to review pull request: ${error.message}`);
+      throw new Error(`Failed to review pull request: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31706,7 +32086,7 @@ var PullRequestService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to add pull request comment: ${error.message}`);
+      throw new Error(`Failed to add pull request comment: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31736,7 +32116,7 @@ var PullRequestService = class extends BaseService {
       if (error.message.includes("conflicts") || error.message.includes("409")) {
         throw new Error(`Pull request has merge conflicts: ${error.message}`);
       }
-      throw new Error(`Failed to merge pull request: ${error.message}`);
+      throw new Error(`Failed to merge pull request: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -31763,7 +32143,7 @@ var PullRequestService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get pull request diff: ${error.message}`);
+      throw new Error(`Failed to get pull request diff: ${error.message}`, { cause: error });
     }
   }
   // ==================== PULL REQUEST HELPER METHODS ====================
@@ -32083,7 +32463,7 @@ var AdminService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get admin users: ${error.message}`);
+      throw new Error(`Failed to get admin users: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -32114,7 +32494,7 @@ var AdminService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to assign projects to user: ${error.message}`);
+      throw new Error(`Failed to assign projects to user: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -32143,7 +32523,7 @@ var AdminService = class extends BaseService {
       if ((_a = error.message) == null ? void 0 : _a.includes("Duplicate")) {
         throw new Error("Username already exists");
       }
-      throw new Error(`Failed to update user: ${error.message}`);
+      throw new Error(`Failed to update user: ${error.message}`, { cause: error });
     }
   }
   // ==================== ADMIN HELPER METHODS ====================
@@ -32273,7 +32653,7 @@ var AdminService = class extends BaseService {
       });
       return stats;
     } catch (error) {
-      throw new Error(`Failed to get user stats: ${error.message}`);
+      throw new Error(`Failed to get user stats: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -32360,6 +32740,287 @@ var AdminService = class extends BaseService {
   }
 };
 
+// src/services/ScreenshotService.js
+var ScreenshotService = class extends BaseService {
+  constructor(config) {
+    super(config);
+    this._debounceTimers = /* @__PURE__ */ new Map();
+    this._inflightRefreshes = /* @__PURE__ */ new Map();
+  }
+  // ==================== PROJECT-LEVEL OPERATIONS ====================
+  async createScreenshotProject(payload) {
+    this._requireReady("createScreenshotProject");
+    try {
+      const response = await this._request("/screenshots/projects", {
+        method: "POST",
+        body: JSON.stringify(payload),
+        methodName: "createScreenshotProject"
+      });
+      if (response.success) {
+        return response;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to create screenshot project: ${error.message}`, { cause: error });
+    }
+  }
+  async getProjectScreenshots(projectKey, params2 = {}) {
+    this._requireReady("getProjectScreenshots");
+    if (!projectKey) {
+      throw new Error("projectKey is required");
+    }
+    const { type = "all", status, limit = 50, offset: offset2 = 0 } = params2;
+    const qs = new URLSearchParams();
+    if (type) {
+      qs.set("type", type);
+    }
+    if (status) {
+      qs.set("status", status);
+    }
+    if (limit != null) {
+      qs.set("limit", String(limit));
+    }
+    if (offset2 != null) {
+      qs.set("offset", String(offset2));
+    }
+    try {
+      const response = await this._request(
+        `/screenshots/projects/${encodeURIComponent(projectKey)}${qs.toString() ? `?${qs.toString()}` : ""}`,
+        { method: "GET", methodName: "getProjectScreenshots" }
+      );
+      if (response.success) {
+        return response;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to get project screenshots: ${error.message}`, { cause: error });
+    }
+  }
+  async reprocessProjectScreenshots(projectKey, body = {}) {
+    this._requireReady("reprocessProjectScreenshots");
+    if (!projectKey) {
+      throw new Error("projectKey is required");
+    }
+    try {
+      const response = await this._request(
+        `/screenshots/projects/${encodeURIComponent(projectKey)}/reprocess`,
+        { method: "POST", body: JSON.stringify(body), methodName: "reprocessProjectScreenshots" }
+      );
+      if (response.success) {
+        return response;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to reprocess screenshots: ${error.message}`, { cause: error });
+    }
+  }
+  async recreateProjectScreenshots(projectKey, body = {}) {
+    this._requireReady("recreateProjectScreenshots");
+    if (!projectKey) {
+      throw new Error("projectKey is required");
+    }
+    try {
+      const response = await this._request(
+        `/screenshots/projects/${encodeURIComponent(projectKey)}/recreate`,
+        { method: "POST", body: JSON.stringify(body), methodName: "recreateProjectScreenshots" }
+      );
+      if (response.success) {
+        return response;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to recreate screenshots: ${error.message}`, { cause: error });
+    }
+  }
+  async deleteProjectScreenshots(projectKey) {
+    this._requireReady("deleteProjectScreenshots");
+    if (!projectKey) {
+      throw new Error("projectKey is required");
+    }
+    try {
+      const response = await this._request(
+        `/screenshots/projects/${encodeURIComponent(projectKey)}`,
+        { method: "DELETE", methodName: "deleteProjectScreenshots" }
+      );
+      if (response.success) {
+        return response;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to delete project screenshots: ${error.message}`, { cause: error });
+    }
+  }
+  // ==================== THUMBNAIL ====================
+  async getThumbnailCandidate(projectKey, options = {}) {
+    this._requireReady("getThumbnailCandidate");
+    if (!projectKey) {
+      throw new Error("projectKey is required");
+    }
+    const { includeData = false } = options;
+    const qs = new URLSearchParams();
+    if (includeData) {
+      qs.set("include_data", "true");
+    }
+    try {
+      const response = await this._request(
+        `/screenshots/projects/${encodeURIComponent(projectKey)}/thumbnail/candidate${qs.toString() ? `?${qs.toString()}` : ""}`,
+        { method: "GET", methodName: "getThumbnailCandidate" }
+      );
+      if (response.success) {
+        return response;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to get thumbnail candidate: ${error.message}`, { cause: error });
+    }
+  }
+  async updateProjectThumbnail(projectKey, body = {}) {
+    this._requireReady("updateProjectThumbnail");
+    if (!projectKey) {
+      throw new Error("projectKey is required");
+    }
+    try {
+      const response = await this._request(
+        `/screenshots/projects/${encodeURIComponent(projectKey)}/thumbnail`,
+        { method: "POST", body: JSON.stringify(body), methodName: "updateProjectThumbnail" }
+      );
+      if (response.success) {
+        return response;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to update project thumbnail: ${error.message}`, { cause: error });
+    }
+  }
+  // ==================== INDIVIDUAL SHOTS ====================
+  async getPageScreenshot(screenshotId, format = "json") {
+    this._requireReady("getPageScreenshot");
+    if (!screenshotId) {
+      throw new Error("screenshotId is required");
+    }
+    const qs = new URLSearchParams();
+    if (format) {
+      qs.set("format", format);
+    }
+    try {
+      return await this._request(
+        `/screenshots/pages/${encodeURIComponent(screenshotId)}${qs.toString() ? `?${qs.toString()}` : ""}`,
+        { method: "GET", methodName: "getPageScreenshot" }
+      );
+    } catch (error) {
+      throw new Error(`Failed to get page screenshot: ${error.message}`, { cause: error });
+    }
+  }
+  async getComponentScreenshot(screenshotId, format = "json") {
+    this._requireReady("getComponentScreenshot");
+    if (!screenshotId) {
+      throw new Error("screenshotId is required");
+    }
+    const qs = new URLSearchParams();
+    if (format) {
+      qs.set("format", format);
+    }
+    try {
+      return await this._request(
+        `/screenshots/components/${encodeURIComponent(screenshotId)}${qs.toString() ? `?${qs.toString()}` : ""}`,
+        { method: "GET", methodName: "getComponentScreenshot" }
+      );
+    } catch (error) {
+      throw new Error(`Failed to get component screenshot: ${error.message}`, { cause: error });
+    }
+  }
+  async getScreenshotByKey(projectKey, type, key, format = "json") {
+    this._requireReady("getScreenshotByKey");
+    if (!projectKey) {
+      throw new Error("projectKey is required");
+    }
+    if (!type || !["component", "page"].includes(String(type))) {
+      throw new Error("type must be 'component' or 'page'");
+    }
+    if (!key) {
+      throw new Error("key is required");
+    }
+    const qs = new URLSearchParams();
+    if (format) {
+      qs.set("format", format);
+    }
+    const sub = type === "component" ? "components" : "pages";
+    try {
+      return await this._request(
+        `/screenshots/projects/${encodeURIComponent(projectKey)}/${sub}/${encodeURIComponent(key)}${qs.toString() ? `?${qs.toString()}` : ""}`,
+        { method: "GET", methodName: "getScreenshotByKey" }
+      );
+    } catch (error) {
+      throw new Error(`Failed to get screenshot by key: ${error.message}`, { cause: error });
+    }
+  }
+  async getQueueStatistics() {
+    this._requireReady("getQueueStatistics");
+    try {
+      const response = await this._request("/screenshots/queue/stats", {
+        method: "GET",
+        methodName: "getQueueStatistics"
+      });
+      if (response.success) {
+        return response;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to get queue statistics: ${error.message}`, { cause: error });
+    }
+  }
+  // ==================== COMBINATION/DEBOUNCED ====================
+  /**
+   * Debounced thumbnail refresh that recreates screenshots and then updates thumbnail.
+   * Subsequent calls within debounce window reset the timer.
+   */
+  async refreshThumbnail(projectKey, options = {}) {
+    this._requireReady("refreshThumbnail");
+    if (!projectKey) {
+      throw new Error("projectKey is required");
+    }
+    const {
+      debounceMs = 15e3,
+      waitAfterRecreateMs = 2e4,
+      recreate = {
+        process_pages: true,
+        process_components: false,
+        process_descriptions: false,
+        force: false,
+        priority: 5
+      },
+      thumbnail = {
+        strategy: "auto",
+        force: true
+      }
+    } = options;
+    const existingTimer = this._debounceTimers.get(projectKey);
+    if (existingTimer) {
+      clearTimeout(existingTimer);
+    }
+    const executionPromise = await new Promise((resolve) => {
+      const timer = setTimeout(async () => {
+        try {
+          await this.recreateProjectScreenshots(projectKey, recreate);
+          await new Promise((resolveDelay) => {
+            setTimeout(resolveDelay, waitAfterRecreateMs);
+          });
+          const result = await this.updateProjectThumbnail(projectKey, thumbnail);
+          resolve(result);
+        } catch (e) {
+          resolve({ success: false, error: (e == null ? void 0 : e.message) || String(e) });
+        } finally {
+          this._debounceTimers.delete(projectKey);
+          this._inflightRefreshes.delete(projectKey);
+        }
+      }, debounceMs);
+      this._debounceTimers.set(projectKey, timer);
+    });
+    this._inflightRefreshes.set(projectKey, executionPromise);
+    return executionPromise;
+  }
+};
+
 // src/services/index.js
 var createService = (ServiceClass, config) => new ServiceClass(config);
 var createAuthService = (config) => createService(AuthService, config);
@@ -32374,6 +33035,7 @@ var createDnsService = (config) => createService(DnsService, config);
 var createBranchService = (config) => createService(BranchService, config);
 var createPullRequestService = (config) => createService(PullRequestService, config);
 var createAdminService = (config) => createService(AdminService, config);
+var createScreenshotService = (config) => createService(ScreenshotService, config);
 
 // src/utils/services.js
 var SERVICE_METHODS = {
@@ -32601,7 +33263,20 @@ var SERVICE_METHODS = {
   promoteToAdmin: "admin",
   demoteFromAdmin: "admin",
   // Utility methods
-  getHealthStatus: "core"
+  getHealthStatus: "core",
+  // Screenshot methods
+  createScreenshotProject: "screenshot",
+  getProjectScreenshots: "screenshot",
+  reprocessProjectScreenshots: "screenshot",
+  recreateProjectScreenshots: "screenshot",
+  deleteProjectScreenshots: "screenshot",
+  getThumbnailCandidate: "screenshot",
+  updateProjectThumbnail: "screenshot",
+  getPageScreenshot: "screenshot",
+  getComponentScreenshot: "screenshot",
+  getScreenshotByKey: "screenshot",
+  getQueueStatistics: "screenshot",
+  refreshThumbnail: "screenshot"
 };
 
 // src/index.js
@@ -32610,6 +33285,7 @@ var SDK = class {
     this._services = /* @__PURE__ */ new Map();
     this._context = {};
     this._options = this._validateOptions(options);
+    this.rootBus = rootBus;
     this._createServiceProxies();
   }
   // Initialize SDK with context
@@ -32703,6 +33379,13 @@ var SDK = class {
           context: this._context,
           options: this._options
         })
+      ),
+      this._initService(
+        "screenshot",
+        createScreenshotService({
+          context: this._context,
+          options: this._options
+        })
       )
     ]);
     return this;
@@ -32740,9 +33423,10 @@ var SDK = class {
   }
   // Update context
   updateContext(newContext) {
+    const { authToken, ...sanitized } = newContext || {};
     this._context = {
       ...this._context,
-      ...newContext
+      ...sanitized
     };
     for (const service of this._services.values()) {
       service.updateContext(this._context);
@@ -32751,9 +33435,7 @@ var SDK = class {
   // Check if SDK is ready
   isReady() {
     const sdkServices = Array.from(this._services.values());
-    return sdkServices.length > 0 && sdkServices.every(
-      (service) => service.isReady()
-    );
+    return sdkServices.length > 0 && sdkServices.every((service) => service.isReady());
   }
   // Get SDK status
   getStatus() {