@symbo.ls/sdk 2.32.2 → 2.32.5

package/dist/esm/services/CoreService.js

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

package/dist/esm/services/DnsService.js

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