generaltranslation 1.1.24 → 1.1.25

package/README.md

@@ -54,35 +54,27 @@ const codes = gt.getLanguageCodes(['French', 'Spanish'])
 console.log(codes) // ['fr', 'es']
 ```
 
-## Which languages do AI models understand?
+## Get a user's language
 
-We continually benchmark AI models and add new models as they are released. That means these functions have to be <code>async</code>. This information is provided as a public service. It's completely free and requires no API key.
+### getUserLanguage() 
 
-### async getModelList()
-
-Get the latest list of models for which there is data. Returns an array of model names.
+Returns a user's default browser language. Meant for use in a web browser.
 
 ```
-const models = await gt.getModelList();
-console.log(models) // ['gpt-4', ... ]
+const userLanguage = getUserLanguage();
+console.log(userLanguage) // 'en'
 ```
 
-### async getModelLanguages(model)
-
-Get all languages known to be compatible with a given AI model. Returns an array of languages codes, or null if the model is unknown.
+If invoked on an instance of the GT class, this function will return the default language of that instance, similar to accessing the `defaultLanguage` property.
 
 ```
-const languages = await gt.getModelLanguages('mixtral-8x7b')
-console.log(languages) // ['en', 'fr', 'de', 'es', 'it']
-```
-
-### async isSupportedLanguage(model, code)
+import GT from 'generaltranslation'
 
-Returns true if a model is known to be compatible with a given language, represented by an ISO-639 language code. Returns false otherwise.
+const gt = new GT({
+    defaultLanguage: 'en'
+});
 
-```
-const supported = await gt.isSupportedLanguage('gpt-4', 'fr')
-console.log(supported) // true
+console.log(gt.getUserLanguage()) // same as gt.defaultLanguage
 ```
 
 ## Prompt Internationalization API
@@ -149,4 +141,35 @@ This also works:
 
 ```
 const translatedPrompt = await gt.translatePrompt({ text: 'Tell me a story' }, 'es');
-```
+```
+
+## Which languages do AI models understand?
+
+We continually benchmark AI models and add new models as they are released. That means these functions have to be <code>async</code>. This information is provided as a public service. It's completely free and requires no API key.
+
+### async getModelList()
+
+Get the latest list of models for which there is data. Returns an array of model names.
+
+```
+const models = await gt.getModelList();
+console.log(models) // ['gpt-4', ... ]
+```
+
+### async getModelLanguages(model)
+
+Get all languages known to be compatible with a given AI model. Returns an array of languages codes, or null if the model is unknown.
+
+```
+const languages = await gt.getModelLanguages('mixtral-8x7b')
+console.log(languages) // ['en', 'fr', 'de', 'es', 'it']
+```
+
+### async isSupportedLanguage(model, code)
+
+Returns true if a model is known to be compatible with a given language, represented by an ISO-639 language code. Returns false otherwise.
+
+```
+const supported = await gt.isSupportedLanguage('gpt-4', 'fr')
+console.log(supported) // true
+```

package/client/getUserLanguage.js

@@ -2,7 +2,7 @@
 // e.g. 'en-US', not necessarily 'en'
 // generaltranslation handles this well, but other libraries may not
 // (it's a skill issue I'm afraid) 
-export default function _getUserLanguage(defaultLanguage = '') {
+export default function _getUserLanguage({defaultLanguage = ''} = {}) {
     if (typeof window !== 'undefined' && window?.navigator) {
         return navigator?.language || navigator?.userLanguage || defaultLanguage || '';
     } else if (defaultLanguage) {

package/index.js

@@ -17,7 +17,7 @@ export default class GT {
         defaultLanguage = 'en',
         baseURL = 'https://translate.gtx.dev'
     } = {}) {
-        this.apiKey = apiKey;
+        this.apiKey = apiKey || (typeof process !== 'undefined' ? process.env.GT_API_KEY : '');
         this.defaultLanguage = defaultLanguage;
         this.baseURL = baseURL;
     }
@@ -36,7 +36,9 @@ export default class GT {
 
     // Get a user's browser language
     getUserLanguage = () => {
-        return _getUserLanguage(this.defaultLanguage);
+        return _getUserLanguage({
+            defaultLanguage: this.defaultLanguage
+        });
     }
 
     // Prompt I18N

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generaltranslation",
-  "version": "1.1.24",
+  "version": "1.1.25",
   "description": "A language toolkit for AI developers",
   "main": "index.js",
   "type": "module",