@symbo.ls/sdk 3.2.3 → 3.2.7

package/dist/esm/services/BranchService.js

@@ -0,0 +1,1265 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/config/environment.js
+import { isDevelopment } from "@domql/utils";
+var CONFIG = {
+  // Common defaults for all environments
+  common: {
+    // NOTE: Google client id for google auth, need to configure URLs for each environment in Google console
+    googleClientId: "686286207466-bvd2fqs31rlm64fgich7rtpnc8ns2tqg.apps.googleusercontent.com",
+    // Feature toggles that apply across all environments by default
+    features: {
+      newUserOnboarding: true,
+      betaFeatures: false,
+      // Tracking is enabled by default unless overridden per environment
+      trackingEnabled: true
+    }
+  },
+  // Environment-specific configurations
+  local: {
+    // local
+    socketUrl: "http://localhost:8080",
+    // For socket api
+    apiUrl: "http://localhost:8080",
+    // For server api
+    basedEnv: "development",
+    // For based api
+    basedProject: "platform-v2-sm",
+    // For based api
+    basedOrg: "symbols",
+    // For based api
+    githubClientId: "Ov23liAFrsR0StbAO6PO",
+    // For github api
+    grafanaUrl: "",
+    // For grafana tracing
+    grafanaAppName: "Symbols Localhost",
+    // Environment-specific feature toggles (override common)
+    features: {
+      // Disable tracking by default on localhost/dev machines
+      trackingEnabled: false,
+      // Enable beta features in local dev
+      betaFeatures: true,
+      // Preserve common defaults explicitly for local
+      newUserOnboarding: true
+    },
+    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",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/7a3ba473cee2025c68513667024316b8",
+    // For grafana tracing
+    grafanaAppName: "Symbols Dev",
+    typesenseCollectionName: "docs",
+    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
+    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
+    typesensePort: "443",
+    typesenseProtocol: "https"
+  },
+  testing: {
+    socketUrl: "https://test.api.symbols.app",
+    apiUrl: "https://test.api.symbols.app",
+    basedEnv: "testing",
+    basedProject: "platform-v2-sm",
+    basedOrg: "symbols",
+    githubClientId: "Ov23liHxyWFBxS8f1gnF",
+    grafanaUrl: "",
+    // For grafana tracing
+    grafanaAppName: "Symbols Test",
+    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",
+    grafanaUrl: "",
+    // For grafana tracing
+    grafanaAppName: "Symbols Upcoming",
+    typesenseCollectionName: "docs",
+    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
+    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
+    typesensePort: "443",
+    typesenseProtocol: "https"
+  },
+  staging: {
+    socketUrl: "https://staging.api.symbols.app",
+    apiUrl: "https://staging.api.symbols.app",
+    basedEnv: "staging",
+    basedProject: "platform-v2-sm",
+    basedOrg: "symbols",
+    githubClientId: "Ov23ligwZDQVD0VfuWNa",
+    grafanaUrl: "",
+    // For grafana tracing
+    grafanaAppName: "Symbols Staging",
+    typesenseCollectionName: "docs",
+    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
+    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
+    typesensePort: "443",
+    typesenseProtocol: "https"
+  },
+  preview: {
+    socketUrl: "https://api.symbols.app",
+    apiUrl: "https://api.symbols.app",
+    basedEnv: "production",
+    basedProject: "platform-v2-sm",
+    basedOrg: "symbols",
+    githubClientId: "Ov23liFAlOEIXtX3dBtR",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/5c1089f3c3eea4ec5658e05c3f53baae",
+    // For grafana tracing
+    grafanaAppName: "Symbols Preview",
+    typesenseCollectionName: "docs",
+    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
+    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
+    typesensePort: "443",
+    typesenseProtocol: "https"
+  },
+  production: {
+    socketUrl: "https://api.symbols.app",
+    apiUrl: "https://api.symbols.app",
+    basedEnv: "production",
+    basedProject: "platform-v2-sm",
+    basedOrg: "symbols",
+    githubClientId: "Ov23liFAlOEIXtX3dBtR",
+    grafanaUrl: "https://faro-collector-prod-us-east-0.grafana.net/collect/5c1089f3c3eea4ec5658e05c3f53baae",
+    // For grafana tracing
+    grafanaAppName: "Symbols",
+    typesenseCollectionName: "docs",
+    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
+    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
+    typesensePort: "443",
+    typesenseProtocol: "https"
+  }
+};
+var getEnvironment = () => {
+  const env = process.env.SYMBOLS_APP_ENV || process.env.NODE_ENV;
+  if (!CONFIG[env]) {
+    throw new Error(`Unknown environment "${env}"`);
+  }
+  return env;
+};
+var getConfig = () => {
+  try {
+    const env = getEnvironment();
+    const envConfig = { ...CONFIG.common, ...CONFIG[env] };
+    const finalConfig = {
+      ...envConfig,
+      // Deep-merge feature flags so env-specific overrides don't drop common defaults
+      features: {
+        ...CONFIG.common.features || {},
+        ...CONFIG[env] && CONFIG[env].features || {}
+      },
+      socketUrl: process.env.SYMBOLS_APP_SOCKET_URL || envConfig.socketUrl,
+      apiUrl: process.env.SYMBOLS_APP_API_URL || envConfig.apiUrl,
+      basedEnv: process.env.SYMBOLS_APP_BASED_ENV || envConfig.basedEnv,
+      basedProject: process.env.SYMBOLS_APP_BASED_PROJECT || envConfig.basedProject,
+      basedOrg: process.env.SYMBOLS_APP_BASED_ORG || envConfig.basedOrg,
+      githubClientId: process.env.SYMBOLS_APP_GITHUB_CLIENT_ID || envConfig.githubClientId,
+      grafanaUrl: process.env.SYMBOLS_APP_GRAFANA_URL || envConfig.grafanaUrl,
+      typesenseCollectionName: process.env.TYPESENSE_COLLECTION_NAME || envConfig.typesenseCollectionName,
+      typesenseApiKey: process.env.TYPESENSE_API_KEY || envConfig.typesenseApiKey,
+      typesenseHost: process.env.TYPESENSE_HOST || envConfig.typesenseHost,
+      typesensePort: process.env.TYPESENSE_PORT || envConfig.typesensePort,
+      typesenseProtocol: process.env.TYPESENSE_PROTOCOL || envConfig.typesenseProtocol,
+      isDevelopment: isDevelopment(env),
+      isTesting: env === "testing",
+      isStaging: env === "staging",
+      isPreview: env === "preview",
+      isProduction: env === "production"
+      // Store all environment variables for potential future use
+    };
+    const requiredFields = [
+      "socketUrl",
+      "apiUrl",
+      "githubClientId",
+      "googleClientId"
+    ];
+    const missingFields = requiredFields.filter((field) => !finalConfig[field]);
+    if (missingFields.length > 0) {
+      console.error(
+        `Missing required configuration: ${missingFields.join(", ")}`
+      );
+    }
+    if (finalConfig.isDevelopment) {
+      console.warn(
+        "environment in SDK:",
+        env || process.env.NODE_ENV || process.env.NODE_ENV
+      );
+      console.log(finalConfig);
+    } else if (global.window) {
+      global.window.finalConfig = finalConfig;
+    }
+    return finalConfig;
+  } catch (error) {
+    console.error("Failed to load environment configuration:", error);
+    return {
+      ...CONFIG.development
+    };
+  }
+};
+var environment_default = getConfig();
+
+// src/utils/TokenManager.js
+var TokenManager = class {
+  constructor(options = {}) {
+    /**
+     * Memory storage fallback for server-side rendering
+     */
+    __publicField(this, "_memoryStorage", {
+      _data: {},
+      getItem: (key) => this._memoryStorage._data[key] || null,
+      setItem: (key, value) => {
+        this._memoryStorage._data[key] = value;
+      },
+      removeItem: (key) => {
+        delete this._memoryStorage._data[key];
+      },
+      clear: () => {
+        this._memoryStorage._data = {};
+      }
+    });
+    this.config = {
+      storagePrefix: "symbols_",
+      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
+      maxRetries: 3,
+      apiUrl: options.apiUrl || "/api",
+      onTokenRefresh: options.onTokenRefresh || null,
+      onTokenExpired: options.onTokenExpired || null,
+      onTokenError: options.onTokenError || null,
+      ...options
+    };
+    this.tokens = {
+      accessToken: null,
+      refreshToken: null,
+      expiresAt: null,
+      expiresIn: null
+    };
+    this.refreshPromise = null;
+    this.refreshTimeout = null;
+    this.retryCount = 0;
+    this.loadTokens();
+  }
+  /**
+   * Storage keys
+   */
+  get storageKeys() {
+    return {
+      accessToken: `${this.config.storagePrefix}access_token`,
+      refreshToken: `${this.config.storagePrefix}refresh_token`,
+      expiresAt: `${this.config.storagePrefix}expires_at`,
+      expiresIn: `${this.config.storagePrefix}expires_in`
+    };
+  }
+  /**
+   * Get storage instance based on configuration
+   */
+  get storage() {
+    if (typeof window === "undefined") {
+      return this._memoryStorage;
+    }
+    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 sessionStorageInstance || this._memoryStorage;
+      case "memory":
+        return this._memoryStorage;
+      default:
+        return localStorageInstance || this._memoryStorage;
+    }
+  }
+  /**
+   * Set tokens and persist to storage
+   */
+  setTokens(tokenData) {
+    const {
+      access_token: accessToken,
+      refresh_token: refreshToken,
+      expires_in: expiresIn,
+      token_type: tokenType = "Bearer"
+    } = tokenData;
+    if (!accessToken) {
+      throw new Error("Access token is required");
+    }
+    const now = Date.now();
+    const expiresAt = expiresIn ? now + expiresIn * 1e3 : null;
+    this.tokens = {
+      accessToken,
+      refreshToken: refreshToken || this.tokens.refreshToken,
+      expiresAt,
+      expiresIn,
+      tokenType
+    };
+    this.saveTokens();
+    this.scheduleRefresh();
+    if (this.config.onTokenRefresh) {
+      this.config.onTokenRefresh(this.tokens);
+    }
+    return this.tokens;
+  }
+  /**
+   * Get current access token
+   */
+  getAccessToken() {
+    return this.tokens.accessToken;
+  }
+  /**
+   * Get current refresh token
+   */
+  getRefreshToken() {
+    return this.tokens.refreshToken;
+  }
+  /**
+   * Get authorization header value
+   */
+  getAuthHeader() {
+    const token = this.getAccessToken();
+    if (!token) {
+      return null;
+    }
+    return `${this.tokens.tokenType || "Bearer"} ${token}`;
+  }
+  /**
+   * Check if access token is valid and not expired
+   */
+  isAccessTokenValid() {
+    if (!this.tokens.accessToken) {
+      return false;
+    }
+    if (!this.tokens.expiresAt) {
+      return true;
+    }
+    const now = Date.now();
+    const isValid = now < this.tokens.expiresAt - this.config.refreshBuffer;
+    if (!isValid) {
+      console.log("[TokenManager] Access token is expired or near expiry:", {
+        now: new Date(now).toISOString(),
+        expiresAt: new Date(this.tokens.expiresAt).toISOString(),
+        refreshBuffer: this.config.refreshBuffer
+      });
+    }
+    return isValid;
+  }
+  /**
+   * Check if access token exists and is not expired (without refresh buffer)
+   */
+  isAccessTokenActuallyValid() {
+    if (!this.tokens.accessToken) {
+      return false;
+    }
+    if (!this.tokens.expiresAt) {
+      return true;
+    }
+    const now = Date.now();
+    return now < this.tokens.expiresAt;
+  }
+  /**
+   * Check if tokens exist (regardless of expiry)
+   */
+  hasTokens() {
+    return Boolean(this.tokens.accessToken);
+  }
+  /**
+   * Check if refresh token exists
+   */
+  hasRefreshToken() {
+    return Boolean(this.tokens.refreshToken);
+  }
+  /**
+   * Automatically refresh tokens if needed
+   */
+  async ensureValidToken() {
+    if (!this.hasTokens()) {
+      return null;
+    }
+    if (this.isAccessTokenValid()) {
+      return this.getAccessToken();
+    }
+    if (!this.hasRefreshToken()) {
+      this.clearTokens();
+      if (this.config.onTokenExpired) {
+        this.config.onTokenExpired();
+      }
+      return null;
+    }
+    try {
+      await this.refreshTokens();
+      return this.getAccessToken();
+    } catch (error) {
+      this.clearTokens();
+      if (this.config.onTokenError) {
+        this.config.onTokenError(error);
+      }
+      throw error;
+    }
+  }
+  /**
+   * Refresh access token using refresh token
+   */
+  async refreshTokens() {
+    if (this.refreshPromise) {
+      return this.refreshPromise;
+    }
+    if (!this.hasRefreshToken()) {
+      throw new Error("No refresh token available");
+    }
+    if (this.retryCount >= this.config.maxRetries) {
+      throw new Error("Max refresh retries exceeded");
+    }
+    this.refreshPromise = this._performRefresh();
+    try {
+      const result = await this.refreshPromise;
+      this.retryCount = 0;
+      return result;
+    } catch (error) {
+      this.retryCount++;
+      throw error;
+    } finally {
+      this.refreshPromise = null;
+    }
+  }
+  /**
+   * Perform the actual token refresh request
+   */
+  async _performRefresh() {
+    var _a;
+    const refreshToken = this.getRefreshToken();
+    const response = await fetch(`${this.config.apiUrl}/core/auth/refresh`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ refreshToken })
+    });
+    if (!response.ok) {
+      const errorData = await response.json().catch(() => ({}));
+      throw new Error(errorData.message || `Token refresh failed: ${response.status}`);
+    }
+    const responseData = await response.json();
+    if (responseData.success && responseData.data && responseData.data.tokens) {
+      const { tokens } = responseData.data;
+      const tokenData = {
+        access_token: tokens.accessToken,
+        refresh_token: tokens.refreshToken,
+        expires_in: (_a = tokens.accessTokenExp) == null ? void 0 : _a.expiresIn,
+        token_type: "Bearer"
+      };
+      return this.setTokens(tokenData);
+    }
+    return this.setTokens(responseData);
+  }
+  /**
+   * Schedule automatic token refresh
+   */
+  scheduleRefresh() {
+    if (this.refreshTimeout) {
+      clearTimeout(this.refreshTimeout);
+      this.refreshTimeout = null;
+    }
+    if (!this.tokens.expiresAt || !this.hasRefreshToken()) {
+      return;
+    }
+    const now = Date.now();
+    const refreshTime = this.tokens.expiresAt - this.config.refreshBuffer;
+    const delay = Math.max(0, refreshTime - now);
+    this.refreshTimeout = setTimeout(async () => {
+      try {
+        await this.refreshTokens();
+      } catch (error) {
+        console.error("Automatic token refresh failed:", error);
+        if (this.config.onTokenError) {
+          this.config.onTokenError(error);
+        }
+      }
+    }, delay);
+  }
+  /**
+   * Save tokens to storage
+   */
+  saveTokens() {
+    try {
+      const { storage } = this;
+      const keys = this.storageKeys;
+      if (this.tokens.accessToken) {
+        storage.setItem(keys.accessToken, this.tokens.accessToken);
+      }
+      if (this.tokens.refreshToken) {
+        storage.setItem(keys.refreshToken, this.tokens.refreshToken);
+      }
+      if (this.tokens.expiresAt) {
+        storage.setItem(keys.expiresAt, this.tokens.expiresAt.toString());
+      }
+      if (this.tokens.expiresIn) {
+        storage.setItem(keys.expiresIn, this.tokens.expiresIn.toString());
+      }
+    } catch (error) {
+      console.error("[TokenManager] Error saving tokens to storage:", error);
+    }
+  }
+  /**
+   * Load tokens from storage
+   */
+  loadTokens() {
+    try {
+      const { storage } = this;
+      const keys = this.storageKeys;
+      const accessToken = storage.getItem(keys.accessToken);
+      const refreshToken = storage.getItem(keys.refreshToken);
+      const expiresAt = storage.getItem(keys.expiresAt);
+      const expiresIn = storage.getItem(keys.expiresIn);
+      if (accessToken) {
+        this.tokens = {
+          accessToken,
+          refreshToken,
+          expiresAt: expiresAt ? parseInt(expiresAt, 10) : null,
+          expiresIn: expiresIn ? parseInt(expiresIn, 10) : null,
+          tokenType: "Bearer"
+        };
+        this.scheduleRefresh();
+      }
+    } catch (error) {
+      console.error("[TokenManager] Error loading tokens from storage:", error);
+      this.tokens = {
+        accessToken: null,
+        refreshToken: null,
+        expiresAt: null,
+        expiresIn: null
+      };
+    }
+  }
+  /**
+   * Clear all tokens
+   */
+  clearTokens() {
+    this.tokens = {
+      accessToken: null,
+      refreshToken: null,
+      expiresAt: null,
+      expiresIn: null
+    };
+    const { storage } = this;
+    const keys = this.storageKeys;
+    Object.values(keys).forEach((key) => {
+      storage.removeItem(key);
+    });
+    if (this.refreshTimeout) {
+      clearTimeout(this.refreshTimeout);
+      this.refreshTimeout = null;
+    }
+    this.retryCount = 0;
+  }
+  /**
+   * Get token status information
+   */
+  getTokenStatus() {
+    const hasTokens = this.hasTokens();
+    const isValid = this.isAccessTokenValid();
+    const { expiresAt } = this.tokens;
+    const timeToExpiry = expiresAt ? expiresAt - Date.now() : null;
+    return {
+      hasTokens,
+      isValid,
+      hasRefreshToken: this.hasRefreshToken(),
+      expiresAt,
+      timeToExpiry,
+      willExpireSoon: timeToExpiry ? timeToExpiry < this.config.refreshBuffer : false
+    };
+  }
+  /**
+   * Cleanup resources
+   */
+  destroy() {
+    if (this.refreshTimeout) {
+      clearTimeout(this.refreshTimeout);
+      this.refreshTimeout = null;
+    }
+    this.refreshPromise = null;
+  }
+};
+var defaultTokenManager = null;
+var getTokenManager = (options) => {
+  if (!defaultTokenManager) {
+    defaultTokenManager = new TokenManager(options);
+  }
+  return defaultTokenManager;
+};
+
+// src/services/BaseService.js
+var BaseService = class {
+  constructor({ context, options } = {}) {
+    this._context = context || {};
+    this._options = options || {};
+    this._ready = false;
+    this._error = null;
+    this._apiUrl = null;
+    this._tokenManager = null;
+  }
+  // Initialize service
+  init({ context }) {
+    try {
+      const { apiUrl } = context || this._context;
+      this._apiUrl = apiUrl || environment_default.apiUrl;
+      if (!this._apiUrl) {
+        throw new Error("Service base URL not configured");
+      }
+      this._tokenManager = getTokenManager({
+        apiUrl: this._apiUrl,
+        onTokenError: (error) => {
+          console.error("Token management error:", error);
+        }
+      });
+      this._setReady();
+    } catch (error) {
+      this._setError(error);
+      throw error;
+    }
+  }
+  // Update context
+  updateContext(context) {
+    if (context && typeof context === "object") {
+      Object.assign(this._context, context);
+    }
+  }
+  // Get service status
+  getStatus() {
+    return {
+      ready: this._ready,
+      error: this._error,
+      context: { ...this._context }
+    };
+  }
+  // Check if service is ready
+  isReady() {
+    return this._ready;
+  }
+  // Protected helper methods
+  _setReady(ready = true) {
+    this._ready = ready;
+    this._error = null;
+  }
+  _setError(error) {
+    this._ready = false;
+    this._error = error;
+  }
+  _getTrackingService() {
+    var _a;
+    const services = (_a = this._context) == null ? void 0 : _a.services;
+    const tracking = services == null ? void 0 : services.tracking;
+    if (!tracking || typeof tracking.trackError !== "function") {
+      return null;
+    }
+    return tracking;
+  }
+  _shouldTrackErrors() {
+    var _a;
+    const name = (_a = this == null ? void 0 : this.constructor) == null ? void 0 : _a.name;
+    return name !== "TrackingService";
+  }
+  _trackServiceError(error, details = {}) {
+    var _a;
+    if (!this._shouldTrackErrors()) {
+      return;
+    }
+    try {
+      const tracking = this._getTrackingService();
+      if (!tracking) {
+        return;
+      }
+      const context = {
+        service: ((_a = this == null ? void 0 : this.constructor) == null ? void 0 : _a.name) || "UnknownService",
+        apiUrl: this._apiUrl || null,
+        ...details
+      };
+      tracking.trackError(error instanceof Error ? error : new Error(String(error)), context);
+    } catch {
+    }
+  }
+  _requireAuth() {
+    if (!this.getAuthToken()) {
+      throw new Error("Authentication required");
+    }
+  }
+  _requireReady(methodName = "unknown") {
+    if (!this.isReady()) {
+      throw new Error(`Service not initialized for method: ${methodName}`);
+    }
+  }
+  // Shared HTTP request method
+  async _request(endpoint, options = {}) {
+    const url = `${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
+        );
+      }
+    }
+    try {
+      const response = await fetch(url, {
+        ...options,
+        headers: {
+          ...defaultHeaders,
+          ...options.headers
+        }
+      });
+      if (!response.ok) {
+        let error = {
+          message: `HTTP ${response.status}: ${response.statusText}`
+        };
+        try {
+          error = await response.json();
+        } catch {
+        }
+        this._trackServiceError(
+          new Error(error.message || error.error || `HTTP ${response.status}: ${response.statusText}`),
+          {
+            endpoint,
+            methodName: options.methodName,
+            status: response.status,
+            statusText: response.statusText
+          }
+        );
+        throw new Error(error.message || error.error || "Request failed", { cause: error });
+      }
+      return response.status === 204 ? null : response.json();
+    } catch (error) {
+      this._trackServiceError(error, {
+        endpoint,
+        methodName: options.methodName
+      });
+      throw new Error(`Request failed: ${error.message}`, { cause: error });
+    }
+  }
+  // Helper method to determine if a method requires initialization
+  _requiresInit(methodName) {
+    const noInitMethods = /* @__PURE__ */ new Set([
+      "register",
+      "login",
+      "googleAuth",
+      "googleAuthCallback",
+      "githubAuth",
+      "requestPasswordReset",
+      "confirmPasswordReset",
+      "confirmRegistration",
+      "verifyEmail",
+      "getPlans",
+      "getPlan",
+      "listPublicProjects",
+      "getPublicProject"
+    ]);
+    return !noInitMethods.has(methodName);
+  }
+  // Cleanup method
+  destroy() {
+    if (this._tokenManager) {
+      this._tokenManager.destroy();
+      this._tokenManager = null;
+    }
+    this._ready = false;
+    this._setReady(false);
+  }
+};
+
+// src/services/BranchService.js
+var BranchService = class extends BaseService {
+  // ==================== BRANCH MANAGEMENT METHODS ====================
+  /**
+   * Get all branches for a project
+   */
+  async listBranches(projectId) {
+    this._requireReady("listBranches");
+    if (!projectId) {
+      throw new Error("Project ID is required");
+    }
+    try {
+      const response = await this._request(`/projects/${projectId}/branches`, {
+        method: "GET",
+        methodName: "listBranches"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to list branches: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Create a new branch from an existing branch
+   */
+  async createBranch(projectId, branchData) {
+    this._requireReady("createBranch");
+    if (!projectId) {
+      throw new Error("Project ID is required");
+    }
+    if (!branchData.name) {
+      throw new Error("Branch name is required");
+    }
+    const { name, source = "main" } = branchData;
+    try {
+      const response = await this._request(`/projects/${projectId}/branches`, {
+        method: "POST",
+        body: JSON.stringify({ name, source }),
+        methodName: "createBranch"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to create branch: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Delete a branch (cannot delete main branch)
+   */
+  async deleteBranch(projectId, branchName) {
+    this._requireReady("deleteBranch");
+    if (!projectId) {
+      throw new Error("Project ID is required");
+    }
+    if (!branchName) {
+      throw new Error("Branch name is required");
+    }
+    if (branchName === "main") {
+      throw new Error("Cannot delete main branch");
+    }
+    try {
+      const response = await this._request(
+        `/projects/${projectId}/branches/${encodeURIComponent(branchName)}`,
+        {
+          method: "DELETE",
+          methodName: "deleteBranch"
+        }
+      );
+      if (response.success) {
+        return response;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to delete branch: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Rename a branch (cannot rename main branch)
+   */
+  async renameBranch(projectId, branchName, newName) {
+    this._requireReady("renameBranch");
+    if (!projectId) {
+      throw new Error("Project ID is required");
+    }
+    if (!branchName) {
+      throw new Error("Current branch name is required");
+    }
+    if (!newName) {
+      throw new Error("New branch name is required");
+    }
+    if (branchName === "main") {
+      throw new Error("Cannot rename main branch");
+    }
+    try {
+      const response = await this._request(
+        `/projects/${projectId}/branches/${encodeURIComponent(
+          branchName
+        )}/rename`,
+        {
+          method: "POST",
+          body: JSON.stringify({ newName }),
+          methodName: "renameBranch"
+        }
+      );
+      if (response.success) {
+        return response;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to rename branch: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Get changes/diff for a branch compared to another version
+   */
+  async getBranchChanges(projectId, branchName = "main", options = {}) {
+    this._requireReady("getBranchChanges");
+    if (!projectId) {
+      throw new Error("Project ID is required");
+    }
+    if (!branchName) {
+      throw new Error("Branch name is required");
+    }
+    const { versionId, versionValue, target } = options;
+    const queryParams = new URLSearchParams();
+    if (versionId) {
+      queryParams.append("versionId", versionId);
+    }
+    if (versionValue) {
+      queryParams.append("versionValue", versionValue);
+    }
+    if (target) {
+      queryParams.append("target", target);
+    }
+    const queryString = queryParams.toString();
+    const url = `/projects/${projectId}/branches/${encodeURIComponent(
+      branchName
+    )}/changes${queryString ? `?${queryString}` : ""}`;
+    try {
+      const response = await this._request(url, {
+        method: "GET",
+        methodName: "getBranchChanges"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to get branch changes: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Merge changes between branches (preview or commit)
+   */
+  async mergeBranch(projectId, branchName, mergeData = {}) {
+    this._requireReady("mergeBranch");
+    if (!projectId) {
+      throw new Error("Project ID is required");
+    }
+    if (!branchName) {
+      throw new Error("Source branch name is required");
+    }
+    const {
+      target = "main",
+      message,
+      type = "patch",
+      commit = false,
+      changes
+    } = mergeData;
+    const requestBody = {
+      target,
+      type,
+      commit,
+      ...message && { message },
+      ...changes && { changes }
+    };
+    try {
+      const response = await this._request(
+        `/projects/${projectId}/branches/${encodeURIComponent(
+          branchName
+        )}/merge`,
+        {
+          method: "POST",
+          body: JSON.stringify(requestBody),
+          methodName: "mergeBranch"
+        }
+      );
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      if (error.message.includes("conflicts") || error.message.includes("409")) {
+        throw new Error(`Merge conflicts detected: ${error.message}`, { cause: error });
+      }
+      throw new Error(`Failed to merge branch: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Reset a branch to a clean state
+   */
+  async resetBranch(projectId, branchName) {
+    this._requireReady("resetBranch");
+    if (!projectId) {
+      throw new Error("Project ID is required");
+    }
+    if (!branchName) {
+      throw new Error("Branch name is required");
+    }
+    try {
+      const response = await this._request(
+        `/projects/${projectId}/branches/${encodeURIComponent(
+          branchName
+        )}/reset`,
+        {
+          method: "POST",
+          methodName: "resetBranch"
+        }
+      );
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to reset branch: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Publish a specific version as the live version
+   */
+  async publishVersion(projectId, publishData) {
+    this._requireReady("publishVersion");
+    if (!projectId) {
+      throw new Error("Project ID is required");
+    }
+    if (!publishData.version) {
+      throw new Error("Version is required");
+    }
+    const { version, branch = "main" } = publishData;
+    try {
+      const response = await this._request(`/projects/${projectId}/publish`, {
+        method: "POST",
+        body: JSON.stringify({ version, branch }),
+        methodName: "publishVersion"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to publish version: ${error.message}`, { cause: error });
+    }
+  }
+  // ==================== BRANCH HELPER METHODS ====================
+  /**
+   * Helper method to create a branch with validation
+   */
+  async createBranchWithValidation(projectId, name, source = "main") {
+    if (!name || name.trim().length === 0) {
+      throw new Error("Branch name cannot be empty");
+    }
+    if (name.includes(" ")) {
+      throw new Error("Branch name cannot contain spaces");
+    }
+    if (name === "main") {
+      throw new Error('Cannot create a branch named "main"');
+    }
+    const sanitizedName = name.trim().toLowerCase().replace(/[^a-z0-9-_]/gu, "-");
+    return await this.createBranch(projectId, {
+      name: sanitizedName,
+      source
+    });
+  }
+  /**
+   * Helper method to check if a branch exists
+   */
+  async branchExists(projectId, branchName) {
+    var _a;
+    try {
+      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}`, { cause: error });
+    }
+  }
+  /**
+   * Helper method to preview merge without committing
+   */
+  async previewMerge(projectId, sourceBranch, targetBranch = "main") {
+    return await this.mergeBranch(projectId, sourceBranch, {
+      target: targetBranch,
+      commit: false
+    });
+  }
+  /**
+   * Helper method to commit merge after preview
+   */
+  async commitMerge(projectId, sourceBranch, options = {}) {
+    const {
+      target = "main",
+      message = `Merge ${sourceBranch} into ${target}`,
+      type = "patch",
+      changes
+    } = options;
+    return await this.mergeBranch(projectId, sourceBranch, {
+      target,
+      message,
+      type,
+      commit: true,
+      changes
+    });
+  }
+  /**
+   * Helper method to create a feature branch from main
+   */
+  async createFeatureBranch(projectId, featureName) {
+    const branchName = `feature/${featureName.toLowerCase().replace(/[^a-z0-9-]/gu, "-")}`;
+    return await this.createBranch(projectId, {
+      name: branchName,
+      source: "main"
+    });
+  }
+  /**
+   * Helper method to create a hotfix branch from main
+   */
+  async createHotfixBranch(projectId, hotfixName) {
+    const branchName = `hotfix/${hotfixName.toLowerCase().replace(/[^a-z0-9-]/gu, "-")}`;
+    return await this.createBranch(projectId, {
+      name: branchName,
+      source: "main"
+    });
+  }
+  /**
+   * Helper method to get branch status summary
+   */
+  async getBranchStatus(projectId, branchName) {
+    var _a, _b, _c;
+    try {
+      const [branches, changes] = await Promise.all([
+        this.listBranches(projectId),
+        this.getBranchChanges(projectId, branchName).catch(() => null)
+      ]);
+      const exists = ((_a = branches == null ? void 0 : branches.data) == null ? void 0 : _a.includes(branchName)) || false;
+      const hasChanges = ((_b = changes == null ? void 0 : changes.data) == null ? void 0 : _b.length) > 0;
+      return {
+        exists,
+        hasChanges,
+        changeCount: ((_c = changes == null ? void 0 : changes.data) == null ? void 0 : _c.length) || 0,
+        canDelete: exists && branchName !== "main",
+        canRename: exists && branchName !== "main"
+      };
+    } catch (error) {
+      throw new Error(`Failed to get branch status: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Helper method to safely delete a branch with confirmation
+   */
+  async deleteBranchSafely(projectId, branchName, options = {}) {
+    const { force = false } = options;
+    if (!force) {
+      const status = await this.getBranchStatus(projectId, branchName);
+      if (!status.exists) {
+        throw new Error(`Branch '${branchName}' does not exist`);
+      }
+      if (!status.canDelete) {
+        throw new Error(`Branch '${branchName}' cannot be deleted`);
+      }
+      if (status.hasChanges) {
+        throw new Error(
+          `Branch '${branchName}' has uncommitted changes. Use force option to delete anyway.`
+        );
+      }
+    }
+    return await this.deleteBranch(projectId, branchName);
+  }
+  /**
+   * Helper method to get all branches with their status
+   */
+  async getBranchesWithStatus(projectId) {
+    try {
+      const branches = await this.listBranches(projectId);
+      const branchList = (branches == null ? void 0 : branches.data) || [];
+      const branchStatuses = await Promise.all(
+        branchList.map(async (branchName) => {
+          try {
+            const status = await this.getBranchStatus(projectId, branchName);
+            return {
+              name: branchName,
+              ...status
+            };
+          } catch (error) {
+            return {
+              name: branchName,
+              exists: true,
+              hasChanges: false,
+              changeCount: 0,
+              canDelete: branchName !== "main",
+              canRename: branchName !== "main",
+              error: error.message
+            };
+          }
+        })
+      );
+      return branchStatuses;
+    } catch (error) {
+      throw new Error(`Failed to get branches with status: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Helper method to validate branch name
+   */
+  validateBranchName(branchName) {
+    if (!branchName || typeof branchName !== "string") {
+      return {
+        isValid: false,
+        error: "Branch name must be a non-empty string"
+      };
+    }
+    if (branchName.trim().length === 0) {
+      return {
+        isValid: false,
+        error: "Branch name cannot be empty"
+      };
+    }
+    if (branchName.includes(" ")) {
+      return {
+        isValid: false,
+        error: "Branch name cannot contain spaces"
+      };
+    }
+    if (branchName === "main") {
+      return {
+        isValid: false,
+        error: 'Cannot use "main" as a branch name'
+      };
+    }
+    if (!/^[a-zA-Z0-9-_]+$/u.test(branchName)) {
+      return {
+        isValid: false,
+        error: "Branch name can only contain letters, numbers, hyphens, and underscores"
+      };
+    }
+    return {
+      isValid: true,
+      error: null
+    };
+  }
+  /**
+   * Helper method to sanitize branch name
+   */
+  sanitizeBranchName(branchName) {
+    if (!branchName) {
+      return "";
+    }
+    return branchName.trim().toLowerCase().replace(/[^a-z0-9-_]/gu, "-").replace(/-+/gu, "-").replace(/^-|-$/gu, "");
+  }
+};
+export {
+  BranchService
+};
+// @preserve-env