implement alpha release of semantics API #128

lib/common.js

@@ -18,7 +18,7 @@ function serveRequest(desc, func, req, res) {
 
           if(_.isObject(httpresult.headers))
               _.each(httpresult.headers, function(value, key) {
-                  debug("function %s sets header %s", desc, key);
+                  // debug("function %s sets header %s", desc, key);
                   res.setHeader(key, value);
               });
 

lib/contentAPI.js

@@ -109,6 +109,17 @@ module.exports = [
         desc: "Timeline CSV",
         route: '/api/v2/timeline/:timelineId/csv/',
         func: require('../routes/personal').timelineCSV,
+    },
+    /* semantics APIs */
+    {
+        desc: "Semantics",
+        route: '/api/v2/:lang/semantics/:paging?',
+        func: require('../routes/semantics').semantics,
+    },
+    {
+        desc: "Labels",
+        route: '/api/v2/:lang/labels/:paging?',
+        func: require('../routes/semantics').labels,
     }
 ];
 

routes/semantics.js

@@ -0,0 +1,63 @@
+const _ = require('lodash');
+const moment = require('moment');
+const Promise = require('bluebird');
+const debug = require('debug')('routes:semantics');
+const nconf = require('nconf');
+
+const mongo = require('../lib/mongo');
+const params = require('../lib/params');
+
+const supported = [ "es", "en", "pt", "vi", "it", "sv", "pl", "hu", "bg", "de", "ro", "tl", "fr" ];
+const LanguageError = {
+    error: true,
+    message: 'missing language',
+    supported,
+    reminder: 'the list of supported language comes from a mongodb.distinct call, should be updated'
+};
+function validLanguage(propl) {
+    return (_.size(propl) == 2 || supported.indexOf(propl) !== -1);
+}
+
+function labels(req) {
+    const { amount, skip } = params.optionParsing(req.params.paging, 100);
+    debug("labels request, amount %d skip %d", amount, skip);
+
+    if(!validLanguage(req.params.lang))
+        return LanguageError;
+
+    return mongo
+        .readLimit(nconf.get('schema').labels, { lang: req.params.lang }, { when: -1 }, amount, skip)
+        .then(function(data) {
+            debug("retrived %d objects, with amount %d skip %d", _.size(data), amount, skip);
+            return { json: data };
+        })
+        .catch(function(e) {
+            debug("data (error): %s", e);
+            return { 'text': `error: ${e}` };
+        });
+};
+
+function semantics(req) {
+    const { amount, skip } = params.optionParsing(req.params.paging, 100);
+    debug("semantic request, amount %d skip %d", amount, skip);
+
+    if(!validLanguage(req.params.lang))
+        return LanguageError;
+
+    return mongo
+        .readLimit(nconf.get('schema').semantics, { lang: req.params.lang }, { when: -1 }, amount, skip)
+        .then(function(data) {
+            debug("retrived %d objects, with amount %d skip %d", _.size(data), amount, skip);
+            return { json: data };
+        })
+        .catch(function(e) {
+            debug("data (error): %s", e);
+            return { 'text': `error: ${e}` };
+        });
+};
+
+
+module.exports = {
+    labels,
+    semantics,
+};