generaltranslation 1.0.20 → 1.0.22

package/README.md

@@ -2,7 +2,9 @@
 
 <a href='https://www.generaltranslation.com' target="_blank">generaltranslation.com</a>
 
-A language toolkit for AI developers
+A language toolkit for AI developers. 
+
+Note: this package is in active development.
 
 ## Getting Started
 
@@ -42,6 +44,22 @@ console.log(codes) // ['fr', 'es']
 
 ## Async Toolkit Functions
 
+As language models are continuously benchmarked, we update our data in real time. Calling these async functions is 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.
+```
+import { getModelList } from 'generaltranslation'
+
+async function main() {
+    const models = await getModelList();
+    console.log(models) // ['gpt-4', ... ]
+}
+
+main();
+```
+
 ### async getModelLanguages(model)
 
 Get all languages known to be compatible with a given LLM. Returns an array of languages codes, [] if the model is unknown.

package/index.js

@@ -5,11 +5,11 @@
 
 const { getLanguageName, getLanguageCode } = require('./codes/codes.js');
 
-const { getModelInfo, getModelLanguages, isLanguageSupported } = require('./models/models.js');
+const { getModelList, getModelLanguages, isLanguageSupported } = require('./models/models.js');
 
 // ----- EXPORTS ----- //
 
 module.exports = {
     getLanguageName, getLanguageCode,
-    getModelInfo, getModelLanguages, isLanguageSupported
+    getModelList, getModelLanguages, isLanguageSupported
 }

package/models/models.js

@@ -1,15 +1,29 @@
 // ----- MODEL INFORMATION ----- //
 
+// Get all models and all languages
+// Returns an array of model names
+const getModelList = async () => {
+    try {
+        const result = await fetch(`https://gtx.dev/models`);
+        const models = await result.json();
+        return models;
+    } catch (error) {
+        console.error(error);
+        return null;
+    }
+}
+
 // Get all info about a given model
 // Returns an object or null if invalid
-const getModelInfo = async model => {
+const _getModelInfo = async model => {
     if (!model) return null;
     model = model?.toLowerCase();
     try {
         const result = await fetch(`https://gtx.dev/model/${model}`);
         const modelInfo = await result.json();
         return modelInfo;
-    } catch {
+    } catch (error) {
+        console.error(error)
         return null;
     }
 }
@@ -17,19 +31,20 @@ const getModelInfo = async model => {
 // Get all languages known to be compatible with a given LLM
 // Returns an array of languages codes, or [] if unknown
 const getModelLanguages = async model => {
-    const modelInfo = await getModelInfo(model);
+    const modelInfo = await _getModelInfo(model);
     return modelInfo?.languages || [];
 }
 
 // Returns true if a model is known to be compatible with a language
 // Returns false otherwise
 const isLanguageSupported = async (model, code) => {
+    if (!code) return false;
     const modelLanguages = await getModelLanguages(model);
     return modelLanguages?.includes(code) ? true : false;
 }
 
 module.exports = {
-    getModelInfo,
+    getModelList,
     getModelLanguages,
     isLanguageSupported
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generaltranslation",
-  "version": "1.0.20",
+  "version": "1.0.22",
   "description": "A language toolkit for AI developers",
   "main": "index.js",
   "scripts": {