@symbo.ls/sdk 2.34.4 → 2.34.7

package/dist/esm/utils/services.js

@@ -273,7 +273,32 @@ var SERVICE_METHODS = {
   flushQueue: "tracking",
   getClient: "tracking",
   isEnabled: "tracking",
-  isInitialized: "tracking"
+  isInitialized: "tracking",
+  // Waitlist methods
+  joinWaitlist: "waitlist",
+  listWaitlistEntries: "waitlist",
+  updateWaitlistEntry: "waitlist",
+  inviteWaitlistEntry: "waitlist",
+  // Metrics methods
+  getContributions: "metrics",
+  // Integration methods
+  integrationWhoami: "integration",
+  listIntegrations: "integration",
+  createIntegration: "integration",
+  updateIntegration: "integration",
+  createIntegrationApiKey: "integration",
+  listIntegrationApiKeys: "integration",
+  revokeIntegrationApiKey: "integration",
+  createIntegrationWebhook: "integration",
+  listIntegrationWebhooks: "integration",
+  updateIntegrationWebhook: "integration",
+  deleteIntegrationWebhook: "integration",
+  listIntegrationWebhookDeliveries: "integration",
+  replayIntegrationWebhookDelivery: "integration",
+  listGitHubConnectors: "integration",
+  createGitHubConnector: "integration",
+  updateGitHubConnector: "integration",
+  deleteGitHubConnector: "integration"
 };
 export {
   SERVICE_METHODS

package/dist/node/index.js

@@ -11,7 +11,10 @@ import {
   createAdminService,
   createSubscriptionService,
   createScreenshotService,
-  createTrackingService
+  createTrackingService,
+  createWaitlistService,
+  createMetricsService,
+  createIntegrationService
 } from "./services/index.js";
 import { SERVICE_METHODS } from "./utils/services.js";
 import environment from "./config/environment.js";
@@ -131,6 +134,27 @@ class SDK {
           context: this._context,
           options: this._options
         })
+      ),
+      this._initService(
+        "waitlist",
+        createWaitlistService({
+          context: this._context,
+          options: this._options
+        })
+      ),
+      this._initService(
+        "metrics",
+        createMetricsService({
+          context: this._context,
+          options: this._options
+        })
+      ),
+      this._initService(
+        "integration",
+        createIntegrationService({
+          context: this._context,
+          options: this._options
+        })
       )
     ]);
     return this;
@@ -259,7 +283,10 @@ import {
   createPullRequestService as createPullRequestService2,
   createAdminService as createAdminService2,
   createSubscriptionService as createSubscriptionService2,
-  createTrackingService as createTrackingService2
+  createTrackingService as createTrackingService2,
+  createWaitlistService as createWaitlistService2,
+  createMetricsService as createMetricsService2,
+  createIntegrationService as createIntegrationService2
 } from "./services/index.js";
 import { default as default2 } from "./config/environment.js";
 export {
@@ -270,12 +297,15 @@ export {
   createCollabService2 as createCollabService,
   createDnsService2 as createDnsService,
   createFileService2 as createFileService,
+  createIntegrationService2 as createIntegrationService,
+  createMetricsService2 as createMetricsService,
   createPaymentService2 as createPaymentService,
   createPlanService2 as createPlanService,
   createProjectService2 as createProjectService,
   createPullRequestService2 as createPullRequestService,
   createSubscriptionService2 as createSubscriptionService,
   createTrackingService2 as createTrackingService,
+  createWaitlistService2 as createWaitlistService,
   index_default as default,
   default2 as environment,
   isLocalhost

package/dist/node/services/BranchService.js

@@ -195,7 +195,7 @@ class BranchService extends BaseService {
       throw new Error(response.message);
     } catch (error) {
       if (error.message.includes("conflicts") || error.message.includes("409")) {
-        throw new Error(`Merge conflicts detected: ${error.message}`);
+        throw new Error(`Merge conflicts detected: ${error.message}`, { cause: error });
       }
       throw new Error(`Failed to merge branch: ${error.message}`, { cause: error });
     }
@@ -408,7 +408,7 @@ class BranchService extends BaseService {
       );
       return branchStatuses;
     } catch (error) {
-      throw new Error(`Failed to get branches with status: ${error.message}`);
+      throw new Error(`Failed to get branches with status: ${error.message}`, { cause: error });
     }
   }
   /**
@@ -439,7 +439,7 @@ class BranchService extends BaseService {
         error: 'Cannot use "main" as a branch name'
       };
     }
-    if (!/^[a-zA-Z0-9-_]+$/.test(branchName)) {
+    if (!/^[a-zA-Z0-9-_]+$/u.test(branchName)) {
       return {
         isValid: false,
         error: "Branch name can only contain letters, numbers, hyphens, and underscores"
@@ -457,7 +457,7 @@ class BranchService extends BaseService {
     if (!branchName) {
       return "";
     }
-    return branchName.trim().toLowerCase().replace(/[^a-z0-9-_]/gu, "-").replace(/-+/g, "-").replace(/^-|-$/g, "");
+    return branchName.trim().toLowerCase().replace(/[^a-z0-9-_]/gu, "-").replace(/-+/gu, "-").replace(/^-|-$/gu, "");
   }
 }
 export {

package/dist/node/services/IntegrationService.js

@@ -0,0 +1,519 @@
+import { BaseService } from "./BaseService.js";
+class IntegrationService extends BaseService {
+  // ==================== INTEGRATION METHODS ====================
+  /**
+   * Programmatic auth sanity check (API key based).
+   *
+   * Mirrors: GET /integrations/whoami (requireApiKey)
+   *
+   * Assumption: backend reads API key from `x-api-key` header.
+   * You can override via `options.headers`.
+   */
+  async integrationWhoami(apiKey, options = {}) {
+    this._requireReady("integrationWhoami");
+    if (!apiKey) {
+      throw new Error("API key is required");
+    }
+    const headers = {
+      "x-api-key": apiKey,
+      ...options.headers || {}
+    };
+    try {
+      const response = await this._request("/integrations/whoami", {
+        method: "GET",
+        headers,
+        methodName: "integrationWhoami"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to validate integration API key: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * List integrations visible to the user.
+   *
+   * Mirrors: GET /integrations?orgId=&projectId=
+   */
+  async listIntegrations(options = {}) {
+    this._requireReady("listIntegrations");
+    const { orgId, projectId } = options || {};
+    const queryParams = new URLSearchParams();
+    if (orgId != null) {
+      queryParams.append("orgId", String(orgId));
+    }
+    if (projectId != null) {
+      queryParams.append("projectId", String(projectId));
+    }
+    const queryString = queryParams.toString();
+    const url = `/integrations${queryString ? `?${queryString}` : ""}`;
+    try {
+      const response = await this._request(url, {
+        method: "GET",
+        methodName: "listIntegrations"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to list integrations: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Create an integration.
+   *
+   * Mirrors: POST /integrations
+   */
+  async createIntegration(data = {}) {
+    this._requireReady("createIntegration");
+    if (!data || typeof data !== "object") {
+      throw new Error("Integration payload is required");
+    }
+    if (!data.name) {
+      throw new Error("Integration name is required");
+    }
+    if (!data.ownerType) {
+      throw new Error("ownerType is required");
+    }
+    try {
+      const response = await this._request("/integrations", {
+        method: "POST",
+        body: JSON.stringify(data),
+        methodName: "createIntegration"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to create integration: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Update an integration.
+   *
+   * Mirrors: PATCH /integrations/:integrationId
+   */
+  async updateIntegration(integrationId, update = {}) {
+    this._requireReady("updateIntegration");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    if (!update || typeof update !== "object") {
+      throw new Error("Update payload is required");
+    }
+    try {
+      const response = await this._request(`/integrations/${integrationId}`, {
+        method: "PATCH",
+        body: JSON.stringify(update),
+        methodName: "updateIntegration"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to update integration: ${error.message}`, { cause: error });
+    }
+  }
+  // ==================== INTEGRATION API KEY METHODS ====================
+  /**
+   * Create a new API key for an integration.
+   *
+   * Mirrors: POST /integrations/:integrationId/api-keys
+   */
+  async createIntegrationApiKey(integrationId, data = {}) {
+    this._requireReady("createIntegrationApiKey");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    if (!data || typeof data !== "object") {
+      throw new Error("API key payload is required");
+    }
+    try {
+      const response = await this._request(`/integrations/${integrationId}/api-keys`, {
+        method: "POST",
+        body: JSON.stringify(data),
+        methodName: "createIntegrationApiKey"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to create integration API key: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * List API keys for an integration.
+   *
+   * Mirrors: GET /integrations/:integrationId/api-keys
+   */
+  async listIntegrationApiKeys(integrationId) {
+    this._requireReady("listIntegrationApiKeys");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    try {
+      const response = await this._request(`/integrations/${integrationId}/api-keys`, {
+        method: "GET",
+        methodName: "listIntegrationApiKeys"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to list integration API keys: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Revoke an API key for an integration.
+   *
+   * Mirrors: POST /integrations/:integrationId/api-keys/:keyId/revoke
+   */
+  async revokeIntegrationApiKey(integrationId, keyId) {
+    this._requireReady("revokeIntegrationApiKey");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    if (!keyId) {
+      throw new Error("API key ID is required");
+    }
+    try {
+      const response = await this._request(
+        `/integrations/${integrationId}/api-keys/${keyId}/revoke`,
+        {
+          method: "POST",
+          methodName: "revokeIntegrationApiKey"
+        }
+      );
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to revoke integration API key: ${error.message}`, { cause: error });
+    }
+  }
+  // ==================== WEBHOOK METHODS ====================
+  /**
+   * Create a webhook endpoint for an integration.
+   *
+   * Mirrors: POST /integrations/:integrationId/webhooks
+   */
+  async createIntegrationWebhook(integrationId, data = {}) {
+    this._requireReady("createIntegrationWebhook");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    if (!data || typeof data !== "object") {
+      throw new Error("Webhook payload is required");
+    }
+    try {
+      const response = await this._request(`/integrations/${integrationId}/webhooks`, {
+        method: "POST",
+        body: JSON.stringify(data),
+        methodName: "createIntegrationWebhook"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to create integration webhook: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * List webhook endpoints for an integration.
+   *
+   * Mirrors: GET /integrations/:integrationId/webhooks
+   */
+  async listIntegrationWebhooks(integrationId) {
+    this._requireReady("listIntegrationWebhooks");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    try {
+      const response = await this._request(`/integrations/${integrationId}/webhooks`, {
+        method: "GET",
+        methodName: "listIntegrationWebhooks"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to list integration webhooks: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Update a webhook endpoint for an integration.
+   *
+   * Mirrors: PATCH /integrations/:integrationId/webhooks/:webhookId
+   */
+  async updateIntegrationWebhook(integrationId, webhookId, update = {}) {
+    this._requireReady("updateIntegrationWebhook");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    if (!webhookId) {
+      throw new Error("Webhook ID is required");
+    }
+    if (!update || typeof update !== "object") {
+      throw new Error("Update payload is required");
+    }
+    try {
+      const response = await this._request(
+        `/integrations/${integrationId}/webhooks/${webhookId}`,
+        {
+          method: "PATCH",
+          body: JSON.stringify(update),
+          methodName: "updateIntegrationWebhook"
+        }
+      );
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to update integration webhook: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Delete a webhook endpoint for an integration.
+   *
+   * Mirrors: DELETE /integrations/:integrationId/webhooks/:webhookId
+   */
+  async deleteIntegrationWebhook(integrationId, webhookId) {
+    this._requireReady("deleteIntegrationWebhook");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    if (!webhookId) {
+      throw new Error("Webhook ID is required");
+    }
+    try {
+      const response = await this._request(
+        `/integrations/${integrationId}/webhooks/${webhookId}`,
+        {
+          method: "DELETE",
+          methodName: "deleteIntegrationWebhook"
+        }
+      );
+      if (response && response.success) {
+        return response.data;
+      }
+      if (response == null) {
+        return null;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to delete integration webhook: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * List webhook deliveries for an integration webhook.
+   *
+   * Mirrors: GET /integrations/:integrationId/webhooks/:webhookId/deliveries
+   */
+  async listIntegrationWebhookDeliveries(integrationId, webhookId, options = {}) {
+    this._requireReady("listIntegrationWebhookDeliveries");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    if (!webhookId) {
+      throw new Error("Webhook ID is required");
+    }
+    const { page, limit, status, includePayload } = options || {};
+    const queryParams = new URLSearchParams();
+    if (page != null) {
+      queryParams.append("page", String(page));
+    }
+    if (limit != null) {
+      queryParams.append("limit", String(limit));
+    }
+    if (status != null) {
+      queryParams.append("status", String(status));
+    }
+    if (includePayload != null) {
+      queryParams.append("includePayload", String(includePayload));
+    }
+    const queryString = queryParams.toString();
+    const url = `/integrations/${integrationId}/webhooks/${webhookId}/deliveries${queryString ? `?${queryString}` : ""}`;
+    try {
+      const response = await this._request(url, {
+        method: "GET",
+        methodName: "listIntegrationWebhookDeliveries"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to list webhook deliveries: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Replay a webhook delivery.
+   *
+   * Mirrors: POST /integrations/:integrationId/webhooks/:webhookId/replay
+   * Body: { deliveryId }
+   */
+  async replayIntegrationWebhookDelivery(integrationId, webhookId, deliveryId) {
+    this._requireReady("replayIntegrationWebhookDelivery");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    if (!webhookId) {
+      throw new Error("Webhook ID is required");
+    }
+    if (!deliveryId) {
+      throw new Error("deliveryId is required");
+    }
+    try {
+      const response = await this._request(
+        `/integrations/${integrationId}/webhooks/${webhookId}/replay`,
+        {
+          method: "POST",
+          body: JSON.stringify({ deliveryId }),
+          methodName: "replayIntegrationWebhookDelivery"
+        }
+      );
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to replay webhook delivery: ${error.message}`, { cause: error });
+    }
+  }
+  // ==================== CONNECTOR METHODS (GITHUB) ====================
+  /**
+   * List GitHub connectors for an integration.
+   *
+   * Mirrors: GET /integrations/:integrationId/connectors/github
+   */
+  async listGitHubConnectors(integrationId) {
+    this._requireReady("listGitHubConnectors");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    try {
+      const response = await this._request(`/integrations/${integrationId}/connectors/github`, {
+        method: "GET",
+        methodName: "listGitHubConnectors"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to list GitHub connectors: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Create a GitHub connector for an integration.
+   *
+   * Mirrors: POST /integrations/:integrationId/connectors/github
+   */
+  async createGitHubConnector(integrationId, data = {}) {
+    this._requireReady("createGitHubConnector");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    if (!data || typeof data !== "object") {
+      throw new Error("Connector payload is required");
+    }
+    if (!data.projectId) {
+      throw new Error("projectId is required");
+    }
+    if (!data.repository) {
+      throw new Error("repository is required");
+    }
+    try {
+      const response = await this._request(`/integrations/${integrationId}/connectors/github`, {
+        method: "POST",
+        body: JSON.stringify(data),
+        methodName: "createGitHubConnector"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to create GitHub connector: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Update a GitHub connector.
+   *
+   * Mirrors: PATCH /integrations/:integrationId/connectors/github/:connectorId
+   */
+  async updateGitHubConnector(integrationId, connectorId, update = {}) {
+    this._requireReady("updateGitHubConnector");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    if (!connectorId) {
+      throw new Error("Connector ID is required");
+    }
+    if (!update || typeof update !== "object") {
+      throw new Error("Update payload is required");
+    }
+    try {
+      const response = await this._request(
+        `/integrations/${integrationId}/connectors/github/${connectorId}`,
+        {
+          method: "PATCH",
+          body: JSON.stringify(update),
+          methodName: "updateGitHubConnector"
+        }
+      );
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to update GitHub connector: ${error.message}`, { cause: error });
+    }
+  }
+  /**
+   * Delete a GitHub connector.
+   *
+   * Mirrors: DELETE /integrations/:integrationId/connectors/github/:connectorId
+   */
+  async deleteGitHubConnector(integrationId, connectorId) {
+    this._requireReady("deleteGitHubConnector");
+    if (!integrationId) {
+      throw new Error("Integration ID is required");
+    }
+    if (!connectorId) {
+      throw new Error("Connector ID is required");
+    }
+    try {
+      const response = await this._request(
+        `/integrations/${integrationId}/connectors/github/${connectorId}`,
+        {
+          method: "DELETE",
+          methodName: "deleteGitHubConnector"
+        }
+      );
+      if (response && response.success) {
+        return response.data;
+      }
+      if (response == null) {
+        return null;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to delete GitHub connector: ${error.message}`, { cause: error });
+    }
+  }
+}
+export {
+  IntegrationService
+};

package/dist/node/services/MetricsService.js

@@ -0,0 +1,43 @@
+import { BaseService } from "./BaseService.js";
+class MetricsService extends BaseService {
+  // ==================== METRICS METHODS ====================
+  /**
+   * Contribution heat-map stats.
+   *
+   * Mirrors: GET /metrics/contributions (MetricsController.getContributions)
+   */
+  async getContributions(options = {}) {
+    this._requireReady("getContributions");
+    const { projectId, userId, from, to } = options || {};
+    const queryParams = new URLSearchParams();
+    if (projectId != null) {
+      queryParams.append("projectId", String(projectId));
+    }
+    if (userId != null) {
+      queryParams.append("userId", String(userId));
+    }
+    if (from != null) {
+      queryParams.append("from", String(from));
+    }
+    if (to != null) {
+      queryParams.append("to", String(to));
+    }
+    const queryString = queryParams.toString();
+    const url = `/metrics/contributions${queryString ? `?${queryString}` : ""}`;
+    try {
+      const response = await this._request(url, {
+        method: "GET",
+        methodName: "getContributions"
+      });
+      if (response.success) {
+        return response.data;
+      }
+      throw new Error(response.message);
+    } catch (error) {
+      throw new Error(`Failed to get contribution stats: ${error.message}`, { cause: error });
+    }
+  }
+}
+export {
+  MetricsService
+};