@symbo.ls/sdk 2.32.0 → 2.32.2

package/dist/esm/services/ScreenshotService.js

@@ -1,992 +0,0 @@
-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
-    }
-  },
-  // 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
-    // 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",
-    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",
-    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",
-    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",
-    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",
-    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,
-      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,
-      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",
-      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;
-  }
-  _requireAuth() {
-    if (!this._context.authToken) {
-      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 {
-        }
-        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}`, { 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/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, params = {}) {
-    this._requireReady("getProjectScreenshots");
-    if (!projectKey) {
-      throw new Error("projectKey is required");
-    }
-    const { type = "all", status, limit = 50, offset = 0 } = params;
-    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 (offset != null) {
-      qs.set("offset", String(offset));
-    }
-    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: true,
-        process_descriptions: true,
-        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;
-  }
-};
-var ScreenshotService_default = ScreenshotService;
-export {
-  ScreenshotService,
-  ScreenshotService_default as default
-};
-// @preserve-env