@symbo.ls/sdk 2.32.2 → 2.32.5

package/dist/node/services/ProjectService.js

@@ -1,4 +1,7 @@
 import { BaseService } from "./BaseService.js";
+import { computeOrdersForTuples } from "../utils/ordering.js";
+import { preprocessChanges } from "../utils/changePreprocessor.js";
+import { deepStringifyFunctions } from "@domql/utils";
 class ProjectService extends BaseService {
   // ==================== PROJECT METHODS ====================
   async createProject(projectData) {
@@ -14,7 +17,7 @@ class ProjectService 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(params = {}) {
@@ -37,7 +40,7 @@ class ProjectService 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 });
     }
   }
   /**
@@ -68,7 +71,7 @@ class ProjectService 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) {
@@ -90,7 +93,7 @@ class ProjectService 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 });
     }
   }
   /**
@@ -115,7 +118,7 @@ class ProjectService 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) {
@@ -137,7 +140,7 @@ class ProjectService 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 });
     }
   }
   /**
@@ -171,7 +174,7 @@ class ProjectService 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, data) {
@@ -190,7 +193,7 @@ class ProjectService 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) {
@@ -212,7 +215,7 @@ class ProjectService 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) {
@@ -231,7 +234,7 @@ class ProjectService 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) {
@@ -250,7 +253,7 @@ class ProjectService 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) {
@@ -269,7 +272,7 @@ class ProjectService 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) {
@@ -288,7 +291,7 @@ class ProjectService 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) {
@@ -306,7 +309,7 @@ class ProjectService 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) {
@@ -325,7 +328,8 @@ class ProjectService 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 }
       );
     }
   }
@@ -345,7 +349,7 @@ class ProjectService 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 = {}) {
@@ -374,7 +378,7 @@ class ProjectService 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) {
@@ -393,7 +397,7 @@ class ProjectService 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) {
@@ -415,7 +419,7 @@ class ProjectService 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) {
@@ -436,7 +440,7 @@ class ProjectService 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 ====================
@@ -456,7 +460,7 @@ class ProjectService 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) {
@@ -474,7 +478,7 @@ class ProjectService 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) {
@@ -489,11 +493,11 @@ class ProjectService 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) {
@@ -512,7 +516,7 @@ class ProjectService 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) ====================
@@ -529,14 +533,20 @@ class ProjectService 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) => deepStringifyFunctions(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"
       });
@@ -545,7 +555,7 @@ class ProjectService 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 });
     }
   }
   /**
@@ -580,7 +590,7 @@ class ProjectService 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 });
     }
   }
   /**
@@ -610,7 +620,7 @@ class ProjectService 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 });
     }
   }
   /**
@@ -642,7 +652,7 @@ class ProjectService 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 });
     }
   }
   /**
@@ -742,7 +752,7 @@ class ProjectService 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) {
@@ -760,7 +770,7 @@ class ProjectService 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) {
@@ -778,7 +788,7 @@ class ProjectService 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 ====================
@@ -807,7 +817,7 @@ class ProjectService 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 });
     }
   }
 }

package/dist/node/services/PullRequestService.js

@@ -26,7 +26,7 @@ class PullRequestService 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 });
     }
   }
   /**
@@ -62,7 +62,7 @@ class PullRequestService 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 });
     }
   }
   /**
@@ -89,7 +89,7 @@ class PullRequestService 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 });
     }
   }
   /**
@@ -123,7 +123,7 @@ class PullRequestService 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 });
     }
   }
   /**
@@ -154,7 +154,7 @@ class PullRequestService 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 });
     }
   }
   /**
@@ -184,7 +184,7 @@ class PullRequestService 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 });
     }
   }
   /**
@@ -211,7 +211,7 @@ class PullRequestService 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 ====================

package/dist/node/services/ScreenshotService.js

@@ -0,0 +1,285 @@
+import { BaseService } from "./BaseService.js";
+class ScreenshotService 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: 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;
+  }
+}
+var ScreenshotService_default = ScreenshotService;
+export {
+  ScreenshotService,
+  ScreenshotService_default as default
+};