@symbo.ls/sdk 3.1.2 → 3.2.6

package/src/config/environment.js

@@ -10,7 +10,9 @@ const CONFIG = {
     // Feature toggles that apply across all environments by default
     features: {
       newUserOnboarding: true,
-      betaFeatures: false
+      betaFeatures: false,
+      // Tracking is enabled by default unless overridden per environment
+      trackingEnabled: true
     }
   },
 
@@ -18,58 +20,115 @@ const CONFIG = {
 
   local: {
     // local
-    baseUrl: 'http://localhost:8080', // For symstory api
     socketUrl: 'http://localhost:8080', // For socket api
-    routerUrl: 'http://localhost:8080', // For router 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: 'Ov23liHxyWFBxS8f1gnF', // For github api
+    githubClientId: 'Ov23liAFrsR0StbAO6PO', // For github api
+    grafanaUrl: '', // For grafana tracing
+    grafanaAppName: 'Symbols Localhost',
     // Environment-specific feature toggles (override common)
     features: {
-      betaFeatures: true // Enable beta features in local dev
-    }
+      // 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: {
-    baseUrl: 'https://dev.api.symbols.app',
     socketUrl: 'https://dev.api.symbols.app',
-    routerUrl: 'https://dev.api.symbols.app',
     apiUrl: 'https://dev.api.symbols.app',
-    basedEnv: 'development',
-    basedProject: 'platform-v2-sm',
-    basedOrg: 'symbols',
-    githubClientId: 'Ov23liHxyWFBxS8f1gnF'
+    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: {
-    baseUrl: 'https://test.api.symbols.app',
     socketUrl: 'https://test.api.symbols.app',
-    routerUrl: 'https://test.api.symbols.app',
     apiUrl: 'https://test.api.symbols.app',
     basedEnv: 'testing',
     basedProject: 'platform-v2-sm',
     basedOrg: 'symbols',
-    githubClientId: 'Ov23liHxyWFBxS8f1gnF'
+    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: {
-    baseUrl: 'https://staging.api.symbols.app',
     socketUrl: 'https://staging.api.symbols.app',
-    routerUrl: 'https://staging.api.symbols.app',
     apiUrl: 'https://staging.api.symbols.app',
     basedEnv: 'staging',
     basedProject: 'platform-v2-sm',
     basedOrg: 'symbols',
-    githubClientId: 'Ov23ligwZDQVD0VfuWNa'
+    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: {
-    baseUrl: 'https://api.symbols.app',
     socketUrl: 'https://api.symbols.app',
-    routerUrl: 'https://api.symbols.app',
     apiUrl: 'https://api.symbols.app',
     basedEnv: 'production',
     basedProject: 'platform-v2-sm',
     basedOrg: 'symbols',
-    githubClientId: 'Ov23liFAlOEIXtX3dBtR'
+    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'
   }
 }
 
@@ -95,9 +154,12 @@ export const getConfig = () => {
     // Create the final config with environment variable overrides
     const finalConfig = {
       ...envConfig,
-      baseUrl: process.env.SYMBOLS_APP_BASE_URL || envConfig.baseUrl,
+      // 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,
-      routerUrl: process.env.SYMBOLS_APP_ROUTER_URL || envConfig.routerUrl,
       apiUrl: process.env.SYMBOLS_APP_API_URL || envConfig.apiUrl,
       basedEnv: process.env.SYMBOLS_APP_BASED_ENV || envConfig.basedEnv,
       basedProject:
@@ -105,21 +167,28 @@ export const getConfig = () => {
       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
     }
 
     // Validate critical configuration values
     const requiredFields = [
-      'baseUrl',
       'socketUrl',
       'apiUrl',
-      'basedEnv',
-      'basedProject',
-      'basedOrg',
       'githubClientId',
       'googleClientId'
     ]
@@ -133,11 +202,13 @@ export const getConfig = () => {
     }
 
     if (finalConfig.isDevelopment) {
-      console.log(
+      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

package/src/index.js

@@ -1,14 +1,36 @@
 import {
-  createSymstoryService,
   createAuthService,
-  createAIService,
-  createSocketService,
-  createCoreService
+  createCollabService,
+  createProjectService,
+  createPlanService,
+  createFileService,
+  createPaymentService,
+  createDnsService,
+  createBranchService,
+  createPullRequestService,
+  createAdminService,
+  createSubscriptionService,
+  createScreenshotService,
+  createTrackingService,
+  createWaitlistService,
+  createMetricsService,
+  createIntegrationService,
+  createFeatureFlagService
 } from './services/index.js'
 
 import { SERVICE_METHODS } from './utils/services.js'
-import { SymstoryService } from './services/SymstoryService.js'
 import environment from './config/environment.js'
+import { rootBus } from './state/rootEventBus.js'
+
+const isBrowserEnvironment = () => typeof window !== 'undefined'
+
+export const isLocalhost = () => {
+  if (!isBrowserEnvironment()) {
+    return false
+  }
+  const host = window.location && window.location.hostname
+  return host === 'localhost' || host === '127.0.0.1' || host === '::1' || host === '' || !host
+}
 
 export class SDK {
   constructor (options = {}) {
@@ -16,6 +38,12 @@ export class SDK {
     this._context = {}
     this._options = this._validateOptions(options)
 
+    // Expose resolved environment config on SDK instance
+    this.environment = environment
+
+    // Expose root event bus on SDK instance
+    this.rootBus = rootBus
+
     // Create proxy methods for direct service access
     this._createServiceProxies()
   }
@@ -38,29 +66,114 @@ export class SDK {
         })
       ),
       this._initService(
-        'socket',
-        createSocketService({
+        'collab',
+        createCollabService({
+          context: this._context,
+          options: this._options
+        })
+      ),
+      // Initialize new modular services
+      this._initService(
+        'project',
+        createProjectService({
+          context: this._context,
+          options: this._options
+        })
+      ),
+      this._initService(
+        'plan',
+        createPlanService({
+          context: this._context,
+          options: this._options
+        })
+      ),
+      this._initService(
+        'subscription',
+        createSubscriptionService({
+          context: this._context,
+          options: this._options
+        })
+      ),
+      this._initService(
+        'file',
+        createFileService({
           context: this._context,
           options: this._options
         })
       ),
       this._initService(
-        'symstory',
-        createSymstoryService({
+        'payment',
+        createPaymentService({
           context: this._context,
           options: this._options
         })
       ),
       this._initService(
-        'ai',
-        createAIService({
+        'dns',
+        createDnsService({
           context: this._context,
           options: this._options
         })
       ),
       this._initService(
-        'core',
-        createCoreService({
+        'branch',
+        createBranchService({
+          context: this._context,
+          options: this._options
+        })
+      ),
+      this._initService(
+        'pullRequest',
+        createPullRequestService({
+          context: this._context,
+          options: this._options
+        })
+      ),
+      this._initService(
+        'admin',
+        createAdminService({
+          context: this._context,
+          options: this._options
+        })
+      ),
+      this._initService(
+        'screenshot',
+        createScreenshotService({
+          context: this._context,
+          options: this._options
+        })
+      ),
+      this._initService(
+        'tracking',
+        createTrackingService({
+          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
+        })
+      ),
+      this._initService(
+        'featureFlag',
+        createFeatureFlagService({
           context: this._context,
           options: this._options
         })
@@ -88,16 +201,36 @@ export class SDK {
   }
 
   _validateOptions (options) {
+    const onLocalhost = isLocalhost()
+    const hasGrafanaUrl = Boolean(environment.grafanaUrl)
     const defaults = {
       useNewServices: true, // Use new service implementations by default
-      baseUrl: environment.baseUrl,
+      apiUrl: environment.apiUrl,
       socketUrl: environment.socketUrl,
       timeout: 30000,
       retryAttempts: 3,
-      debug: false
+      debug: false,
+      tracking: {
+        // Force-disabled on localhost or when no Grafana URL is configured
+        enabled: onLocalhost ? false : (hasGrafanaUrl ? environment.features.trackingEnabled : false)
+      }
     }
 
-    return { ...defaults, ...options }
+    const merged = {
+      ...defaults,
+      ...options,
+      tracking: {
+        ...defaults.tracking,
+        ...(options.tracking || {})
+      }
+    }
+
+    // Enforce disabled tracking on localhost or when no Grafana URL configured, even if overridden
+    if (onLocalhost || !hasGrafanaUrl) {
+      merged.tracking.enabled = false
+    }
+
+    return merged
   }
 
   // Get service instance
@@ -110,25 +243,26 @@ export class SDK {
 
   // Update context
   updateContext (newContext) {
+    // Do not persist authToken in SDK context; TokenManager is the source of truth
+    const { ...sanitized } = newContext || {}
+
     this._context = {
       ...this._context,
-      ...newContext
+      ...sanitized
     }
 
     // Update context for all services
     for (const service of this._services.values()) {
       service.updateContext(this._context)
-      if (service instanceof SymstoryService) {
-        service.init()
-      }
     }
   }
 
   // Check if SDK is ready
   isReady () {
     const sdkServices = Array.from(this._services.values())
-    return sdkServices.length > 0 && sdkServices.every(service =>
-      service.isReady()
+    return (
+      sdkServices.length > 0 &&
+      sdkServices.every((service) => service.isReady())
     )
   }
 
@@ -167,26 +301,26 @@ export class SDK {
    * Destroys all services and cleans up resources
    * @returns {Promise<boolean>} Returns true when cleanup is complete
    */
-  async destroy() {
+  async destroy () {
     try {
       // Call destroy on all services
       const destroyPromises = Array.from(this._services.entries())
         .filter(([, service]) => typeof service.destroy === 'function')
         .map(async ([name, service]) => {
-          await service.destroy();
-          console.log(`Service ${name} destroyed successfully`);
-        });
+          await service.destroy()
+          console.log(`Service ${name} destroyed successfully`)
+        })
 
-      await Promise.all(destroyPromises);
+      await Promise.all(destroyPromises)
 
       // Clear services and reset state
-      this._services.clear();
-      this._context = {};
+      this._services.clear()
+      this._context = {}
 
-      return true;
+      return true
     } catch (error) {
-      console.error('Error during SDK destruction:', error);
-      throw error;
+      console.error('Error during SDK destruction:', error)
+      throw error
     }
   }
 }
@@ -195,11 +329,22 @@ export default SDK
 
 // Export services for direct usage
 export {
-  createSymstoryService,
   createAuthService,
-  createAIService,
-  createSocketService,
-  createCoreService
+  createCollabService,
+  createProjectService,
+  createPlanService,
+  createFileService,
+  createPaymentService,
+  createDnsService,
+  createBranchService,
+  createPullRequestService,
+  createAdminService,
+  createSubscriptionService,
+  createTrackingService,
+  createWaitlistService,
+  createMetricsService,
+  createIntegrationService,
+  createFeatureFlagService
 } from './services/index.js'
 
 // Export environment configuration