@symbo.ls/sdk 2.32.0 → 2.32.2

package/dist/esm/services/CoreService.js

@@ -28,28 +28,18 @@ var CONFIG = {
     // For based api
     basedOrg: "symbols",
     // For based api
-    githubClientId: "Ov23liAFrsR0StbAO6PO",
+    githubClientId: "Ov23liHxyWFBxS8f1gnF",
     // 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"
+    githubClientId: "Ov23liHxyWFBxS8f1gnF"
   },
   testing: {
     socketUrl: "https://test.api.symbols.app",
@@ -57,22 +47,12 @@ var CONFIG = {
     basedEnv: "testing",
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
-    githubClientId: "Ov23liHxyWFBxS8f1gnF",
-    typesenseCollectionName: "docs",
-    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
-    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
-    typesensePort: "443",
-    typesenseProtocol: "https"
+    githubClientId: "Ov23liHxyWFBxS8f1gnF"
   },
   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"
+    githubClientId: "Ov23liWF7NvdZ056RV5J"
   },
   staging: {
     socketUrl: "https://staging.api.symbols.app",
@@ -80,12 +60,7 @@ var CONFIG = {
     basedEnv: "staging",
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
-    githubClientId: "Ov23ligwZDQVD0VfuWNa",
-    typesenseCollectionName: "docs",
-    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
-    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
-    typesensePort: "443",
-    typesenseProtocol: "https"
+    githubClientId: "Ov23ligwZDQVD0VfuWNa"
   },
   production: {
     socketUrl: "https://api.symbols.app",
@@ -93,12 +68,7 @@ var CONFIG = {
     basedEnv: "production",
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
-    githubClientId: "Ov23liFAlOEIXtX3dBtR",
-    typesenseCollectionName: "docs",
-    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
-    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
-    typesensePort: "443",
-    typesenseProtocol: "https"
+    githubClientId: "Ov23liFAlOEIXtX3dBtR"
   }
 };
 var getEnvironment = () => {
@@ -120,11 +90,6 @@ var getConfig = () => {
       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",
@@ -144,7 +109,7 @@ var getConfig = () => {
       );
     }
     if (finalConfig.isDevelopment) {
-      console.warn(
+      console.log(
         "environment in SDK:",
         env || process.env.NODE_ENV || process.env.NODE_ENV
       );
@@ -183,7 +148,7 @@ var TokenManager = class {
     });
     this.config = {
       storagePrefix: "symbols_",
-      storageType: typeof window === "undefined" || process.env.NODE_ENV === "test" || process.env.NODE_ENV === "testing" ? "memory" : "localStorage",
+      storageType: typeof window === "undefined" || process.env.NODE_ENV === "test" ? "memory" : "localStorage",
       // 'localStorage' | 'sessionStorage' | 'memory'
       refreshBuffer: 60 * 1e3,
       // Refresh 1 minute before expiry
@@ -223,26 +188,15 @@ var TokenManager = class {
     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);
+    const hasLocalStorage = typeof window.localStorage !== "undefined";
+    const hasSessionStorage = typeof window.sessionStorage !== "undefined";
     switch (this.config.storageType) {
       case "sessionStorage":
-        return sessionStorageInstance || this._memoryStorage;
+        return hasSessionStorage ? window.sessionStorage : this._memoryStorage;
       case "memory":
         return this._memoryStorage;
       default:
-        return localStorageInstance || this._memoryStorage;
+        return hasLocalStorage ? window.localStorage : this._memoryStorage;
     }
   }
   /**
@@ -581,10 +535,20 @@ var BaseService = class {
       }
       this._tokenManager = getTokenManager({
         apiUrl: this._apiUrl,
+        onTokenRefresh: (tokens) => {
+          this.updateContext({ authToken: tokens.accessToken });
+        },
+        onTokenExpired: () => {
+          this.updateContext({ authToken: null });
+        },
         onTokenError: (error) => {
           console.error("Token management error:", error);
         }
       });
+      const { authToken } = this._context;
+      if (authToken && !this._tokenManager.hasTokens()) {
+        this._tokenManager.setTokens({ access_token: authToken });
+      }
       this._setReady();
     } catch (error) {
       this._setError(error);
@@ -593,9 +557,7 @@ var BaseService = class {
   }
   // Update context
   updateContext(context) {
-    if (context && typeof context === "object") {
-      Object.assign(this._context, context);
-    }
+    this._context = { ...this._context, ...context };
   }
   // Get service status
   getStatus() {
@@ -650,6 +612,11 @@ var BaseService = class {
           error
         );
       }
+    } else if (this._requiresInit(options.methodName)) {
+      const { authToken } = this._context;
+      if (authToken) {
+        defaultHeaders.Authorization = `Bearer ${authToken}`;
+      }
     }
     try {
       const response = await fetch(url, {
@@ -667,11 +634,11 @@ var BaseService = class {
           error = await response.json();
         } catch {
         }
-        throw new Error(error.message || error.error || "Request failed", { cause: error });
+        throw new Error(error.message || error.error || "Request failed");
       }
       return response.status === 204 ? null : response.json();
     } catch (error) {
-      throw new Error(`Request failed: ${error.message}`, { cause: error });
+      throw new Error(`Request failed: ${error.message}`);
     }
   }
   // Helper method to determine if a method requires initialization
@@ -852,11 +819,11 @@ var CoreService = class extends BaseService {
           error = await response.json();
         } catch {
         }
-        throw new Error(error.message || error.error || "Request failed", { cause: error });
+        throw new Error(error.message || error.error || "Request failed");
       }
       return response.status === 204 ? null : response.json();
     } catch (error) {
-      throw new Error(`Request failed: ${error.message}`, { cause: error });
+      throw new Error(`Request failed: ${error.message}`);
     }
   }
   // ==================== AUTH METHODS ====================
@@ -872,7 +839,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Registration failed: ${error.message}`, { cause: error });
+      throw new Error(`Registration failed: ${error.message}`);
     }
   }
   async login(email, password) {
@@ -901,7 +868,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Login failed: ${error.message}`, { cause: error });
+      throw new Error(`Login failed: ${error.message}`);
     }
   }
   async logout() {
@@ -920,7 +887,7 @@ var CoreService = class extends BaseService {
         this._tokenManager.clearTokens();
       }
       this.updateContext({ authToken: null });
-      throw new Error(`Logout failed: ${error.message}`, { cause: error });
+      throw new Error(`Logout failed: ${error.message}`);
     }
   }
   async refreshToken(refreshToken) {
@@ -935,7 +902,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Token refresh failed: ${error.message}`, { cause: error });
+      throw new Error(`Token refresh failed: ${error.message}`);
     }
   }
   async googleAuth(idToken, inviteToken = null) {
@@ -968,7 +935,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Google auth failed: ${error.message}`, { cause: error });
+      throw new Error(`Google auth failed: ${error.message}`);
     }
   }
   async githubAuth(code, inviteToken = null) {
@@ -1001,7 +968,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`GitHub auth failed: ${error.message}`, { cause: error });
+      throw new Error(`GitHub auth failed: ${error.message}`);
     }
   }
   async googleAuthCallback(code, redirectUri, inviteToken = null) {
@@ -1034,7 +1001,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Google auth callback failed: ${error.message}`, { cause: error });
+      throw new Error(`Google auth callback failed: ${error.message}`);
     }
   }
   async requestPasswordReset(email) {
@@ -1049,7 +1016,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password reset request failed: ${error.message}`, { cause: error });
+      throw new Error(`Password reset request failed: ${error.message}`);
     }
   }
   async confirmPasswordReset(token, password) {
@@ -1064,7 +1031,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password reset confirmation failed: ${error.message}`, { cause: error });
+      throw new Error(`Password reset confirmation failed: ${error.message}`);
     }
   }
   async confirmRegistration(token) {
@@ -1079,7 +1046,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Registration confirmation failed: ${error.message}`, { cause: error });
+      throw new Error(`Registration confirmation failed: ${error.message}`);
     }
   }
   async requestPasswordChange() {
@@ -1094,7 +1061,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password change request failed: ${error.message}`, { cause: error });
+      throw new Error(`Password change request failed: ${error.message}`);
     }
   }
   async confirmPasswordChange(currentPassword, newPassword, code) {
@@ -1110,7 +1077,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Password change confirmation failed: ${error.message}`, { cause: error });
+      throw new Error(`Password change confirmation failed: ${error.message}`);
     }
   }
   async getMe() {
@@ -1125,7 +1092,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user profile: ${error.message}`, { cause: error });
+      throw new Error(`Failed to get user profile: ${error.message}`);
     }
   }
   /**
@@ -1241,7 +1208,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to update user profile: ${error.message}`, { cause: error });
+      throw new Error(`Failed to update user profile: ${error.message}`);
     }
   }
   async getUserProjects() {
@@ -1264,7 +1231,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user projects: ${error.message}`, { cause: error });
+      throw new Error(`Failed to get user projects: ${error.message}`);
     }
   }
   async getUser(userId) {
@@ -1282,7 +1249,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user: ${error.message}`, { cause: error });
+      throw new Error(`Failed to get user: ${error.message}`);
     }
   }
   async getUserByEmail(email) {
@@ -1300,7 +1267,7 @@ var CoreService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get user by email: ${error.message}`, { cause: error });
+      throw new Error(`Failed to get user by email: ${error.message}`);
     }
   }
   // ==================== PROJECT METHODS ====================

package/dist/esm/services/DnsService.js

@@ -28,28 +28,18 @@ var CONFIG = {
     // For based api
     basedOrg: "symbols",
     // For based api
-    githubClientId: "Ov23liAFrsR0StbAO6PO",
+    githubClientId: "Ov23liHxyWFBxS8f1gnF",
     // 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"
+    githubClientId: "Ov23liHxyWFBxS8f1gnF"
   },
   testing: {
     socketUrl: "https://test.api.symbols.app",
@@ -57,22 +47,12 @@ var CONFIG = {
     basedEnv: "testing",
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
-    githubClientId: "Ov23liHxyWFBxS8f1gnF",
-    typesenseCollectionName: "docs",
-    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
-    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
-    typesensePort: "443",
-    typesenseProtocol: "https"
+    githubClientId: "Ov23liHxyWFBxS8f1gnF"
   },
   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"
+    githubClientId: "Ov23liWF7NvdZ056RV5J"
   },
   staging: {
     socketUrl: "https://staging.api.symbols.app",
@@ -80,12 +60,7 @@ var CONFIG = {
     basedEnv: "staging",
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
-    githubClientId: "Ov23ligwZDQVD0VfuWNa",
-    typesenseCollectionName: "docs",
-    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
-    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
-    typesensePort: "443",
-    typesenseProtocol: "https"
+    githubClientId: "Ov23ligwZDQVD0VfuWNa"
   },
   production: {
     socketUrl: "https://api.symbols.app",
@@ -93,12 +68,7 @@ var CONFIG = {
     basedEnv: "production",
     basedProject: "platform-v2-sm",
     basedOrg: "symbols",
-    githubClientId: "Ov23liFAlOEIXtX3dBtR",
-    typesenseCollectionName: "docs",
-    typesenseApiKey: "awmcVpbWqZi9IUgmvslp1C5LKDU8tMjA",
-    typesenseHost: "tl2qpnwxev4cjm36p-1.a1.typesense.net",
-    typesensePort: "443",
-    typesenseProtocol: "https"
+    githubClientId: "Ov23liFAlOEIXtX3dBtR"
   }
 };
 var getEnvironment = () => {
@@ -120,11 +90,6 @@ var getConfig = () => {
       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",
@@ -144,7 +109,7 @@ var getConfig = () => {
       );
     }
     if (finalConfig.isDevelopment) {
-      console.warn(
+      console.log(
         "environment in SDK:",
         env || process.env.NODE_ENV || process.env.NODE_ENV
       );
@@ -183,7 +148,7 @@ var TokenManager = class {
     });
     this.config = {
       storagePrefix: "symbols_",
-      storageType: typeof window === "undefined" || process.env.NODE_ENV === "test" || process.env.NODE_ENV === "testing" ? "memory" : "localStorage",
+      storageType: typeof window === "undefined" || process.env.NODE_ENV === "test" ? "memory" : "localStorage",
       // 'localStorage' | 'sessionStorage' | 'memory'
       refreshBuffer: 60 * 1e3,
       // Refresh 1 minute before expiry
@@ -223,26 +188,15 @@ var TokenManager = class {
     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);
+    const hasLocalStorage = typeof window.localStorage !== "undefined";
+    const hasSessionStorage = typeof window.sessionStorage !== "undefined";
     switch (this.config.storageType) {
       case "sessionStorage":
-        return sessionStorageInstance || this._memoryStorage;
+        return hasSessionStorage ? window.sessionStorage : this._memoryStorage;
       case "memory":
         return this._memoryStorage;
       default:
-        return localStorageInstance || this._memoryStorage;
+        return hasLocalStorage ? window.localStorage : this._memoryStorage;
     }
   }
   /**
@@ -581,10 +535,20 @@ var BaseService = class {
       }
       this._tokenManager = getTokenManager({
         apiUrl: this._apiUrl,
+        onTokenRefresh: (tokens) => {
+          this.updateContext({ authToken: tokens.accessToken });
+        },
+        onTokenExpired: () => {
+          this.updateContext({ authToken: null });
+        },
         onTokenError: (error) => {
           console.error("Token management error:", error);
         }
       });
+      const { authToken } = this._context;
+      if (authToken && !this._tokenManager.hasTokens()) {
+        this._tokenManager.setTokens({ access_token: authToken });
+      }
       this._setReady();
     } catch (error) {
       this._setError(error);
@@ -593,9 +557,7 @@ var BaseService = class {
   }
   // Update context
   updateContext(context) {
-    if (context && typeof context === "object") {
-      Object.assign(this._context, context);
-    }
+    this._context = { ...this._context, ...context };
   }
   // Get service status
   getStatus() {
@@ -650,6 +612,11 @@ var BaseService = class {
           error
         );
       }
+    } else if (this._requiresInit(options.methodName)) {
+      const { authToken } = this._context;
+      if (authToken) {
+        defaultHeaders.Authorization = `Bearer ${authToken}`;
+      }
     }
     try {
       const response = await fetch(url, {
@@ -667,11 +634,11 @@ var BaseService = class {
           error = await response.json();
         } catch {
         }
-        throw new Error(error.message || error.error || "Request failed", { cause: error });
+        throw new Error(error.message || error.error || "Request failed");
       }
       return response.status === 204 ? null : response.json();
     } catch (error) {
-      throw new Error(`Request failed: ${error.message}`, { cause: error });
+      throw new Error(`Request failed: ${error.message}`);
     }
   }
   // Helper method to determine if a method requires initialization
@@ -723,7 +690,7 @@ var DnsService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to create DNS record: ${error.message}`, { cause: error });
+      throw new Error(`Failed to create DNS record: ${error.message}`);
     }
   }
   async getDnsRecord(domain) {
@@ -741,7 +708,7 @@ var DnsService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to get DNS record: ${error.message}`, { cause: error });
+      throw new Error(`Failed to get DNS record: ${error.message}`);
     }
   }
   async getCustomHost(hostname) {
@@ -777,7 +744,7 @@ var DnsService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to remove DNS record: ${error.message}`, { cause: error });
+      throw new Error(`Failed to remove DNS record: ${error.message}`);
     }
   }
   // Deprecated, use addProjectCustomDomains instead
@@ -801,7 +768,7 @@ var DnsService = class extends BaseService {
       }
       throw new Error(response.message);
     } catch (error) {
-      throw new Error(`Failed to set project domains: ${error.message}`, { cause: error });
+      throw new Error(`Failed to set project domains: ${error.message}`);
     }
   }
   // customDomains could be a string or an array of strings