@miso.ai/doggoganger 0.9.0-beta.9 → 0.9.0

package/.github/workflows/npm-publish.yml

@@ -23,6 +23,7 @@ jobs:
       - run: git config --global user.name "${{ github.actor }}"
       - run: git config --global user.email "github-action-${{ github.actor }}@users.noreply.github.com"
       - run: npm run version ${{ steps.version.outputs.version }}
+      - run: npm run build
       - run: npm publish
         if: "!github.event.release.prerelease"
         env:

package/bin/data.js

@@ -0,0 +1,15 @@
+import { fileURLToPath } from 'url';
+import { dirname, resolve } from 'path';
+import { writeFileSync, readFileSync } from 'fs';
+import yaml from 'js-yaml';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+const WORDS_YAML = resolve(__dirname, '../data/words.yaml');
+const WORDS_JS = resolve(__dirname, '../src/data/words.js');
+
+const words = yaml.load(readFileSync(WORDS_YAML, 'utf8'));
+writeFileSync(WORDS_JS, `
+// genereated by bin/data.js
+export default ${JSON.stringify(words, null, 2)};
+`);

package/cli/index.js

@@ -10,6 +10,11 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const SRC_DIR = join(__dirname, '../src');
 
 let { watch, ...argv } = yargs(hideBin(process.argv))
+  .option('verbose', {
+    alias: 'v',
+    describe: 'Be verbose',
+    type: 'boolean',
+  })
   .option('port', {
     alias: 'p',
     describe: 'Port of mock API endpoint',
@@ -21,10 +26,6 @@ let { watch, ...argv } = yargs(hideBin(process.argv))
     describe: 'Watch files for changes',
     type: 'boolean',
   })
-  .option('answer-format', {
-    describe: 'Answer field format in answers API response',
-    type: 'string',
-  })
   .option('serve', {
     alias: 's',
     describe: 'Serve static files as well',
@@ -32,8 +33,8 @@ let { watch, ...argv } = yargs(hideBin(process.argv))
   })
   .argv;
 
-const { port, serve, ['answer-format']: answerFormat } = argv;
-argv = { port, serve, answerFormat };
+const { verbose, port, serve } = argv;
+argv = { verbose, port, serve };
 
 if (watch) {
   const exec = `node ${resolve(__dirname, 'server.js')} ${JSON.stringify(JSON.stringify(argv))}`;

package/dist/umd/doggoganger-browser.min.js

@@ -0,0 +1 @@
+!function(t,n){"object"==typeof exports&&"undefined"!=typeof module?module.exports=n():"function"==typeof define&&define.amd?define(n):(t="undefined"!=typeof globalThis?globalThis:t||self).doggoganger=n()}(this,(function(){"use strict";function t(t,n){return null!=n&&n>t?t+Math.floor(Math.random()*(n-t)):t}function n(){return Math.random().toString(36).substring(2,10)}function e(t){return`https://picsum.photos/seed/${Math.floor(1e3*Math.random())}/${Array.isArray(t)?t.length>1?`${t[0]}/${t[1]}`:""+t[0]:""+t}`}function r(t,n){return void 0!==n?Math.ceil(t*n):t}function o(){return 2*Math.random()-1}var s=["lorem","ipsum","dolor","sit","amet","consectetur","adipiscing","elit","curabitur","vel","hendrerit","libero","eleifend","blandit","nunc","ornare","odio","ut","orci","gravida","imperdiet","nullam","purus","lacinia","a","pretium","quis","congue","praesent","sagittis","laoreet","auctor","mauris","non","velit","eros","dictum","proin","accumsan","sapien","nec","massa","volutpat","venenatis","sed","eu","molestie","lacus","quisque","porttitor","ligula","dui","mollis","tempus","at","magna","vestibulum","turpis","ac","diam","tincidunt","id","condimentum","enim","sodales","in","hac","habitasse","platea","dictumst","aenean","neque","fusce","augue","leo","eget","semper","mattis","tortor","scelerisque","nulla","interdum","tellus","malesuada","rhoncus","porta","sem","aliquet","et","nam","suspendisse","potenti","vivamus","luctus","fringilla","erat","donec","justo","vehicula","ultricies","varius","ante","primis","faucibus","ultrices","posuere","cubilia","curae","etiam","cursus","aliquam","quam","dapibus","nisl","feugiat","egestas","class","aptent","taciti","sociosqu","ad","litora","torquent","per","conubia","nostra","inceptos","himenaeos","phasellus","nibh","pulvinar","vitae","urna","iaculis","lobortis","nisi","viverra","arcu","morbi","pellentesque","metus","commodo","ut","facilisis","felis","tristique","ullamcorper","placerat","aenean","convallis","sollicitudin","integer","rutrum","duis","est","etiam","bibendum","donec","pharetra","vulputate","maecenas","mi","fermentum","consequat","suscipit","aliquam","habitant","senectus","netus","fames","quisque","euismod","curabitur","lectus","elementum","tempor","risus","cras"];function i({decorates:n=[],output:e="string",size:r,min:o,max:i,...a}={}){let c=function(n=[5,10]){const e="number"==typeof n?n:t(...n);return function*(t){let n=0;for(let r of t){if(n++>=e)break;yield r}}}(r||[o,i])(function*({words:t=s,fixedStarts:n=0}={}){const e=t.length;for(let r=0;;r++)yield t[n>r?r:Math.floor(Math.random()*e)]}(a));for(const t of n)c=u(t)(c);return u(e)(c)}const a={string:function({separator:t=" "}={}){return n=>[...n].join(t)},array:function(){return t=>[...t]},title:function({}={}){return function*(t){for(let n of t)yield c(n)}},description:function({wordsPerSentence:t={avg:24,std:5,min:1},punctuation:n="."}={}){return function*(e){let r,o=0;for(let s of e)r&&(yield r),r=s,0===o&&(r=c(r),o=l(t)),0==--o&&(r+=n);r&&(r.endsWith(n)||(r+=n),yield r)}},multiline:function({wordsPerLine:t={avg:10,std:3,min:1}}={}){return n=>{let e=l(t),r="";for(let o of n)r&&(0==e--?(r+="\n",e=l(t)):r+=" "),r+=o;return r}}};function u(t){switch(typeof t){case"string":return a[t]();case"function":return t;case"object":if(Array.isArray(t)){const[n,e={}]=t;return a[n](e)}}throw Error("Unrecognized decorator/output form: "+t)}function c(t){return t[0].toUpperCase()+t.substring(1)}function l(t){if("number"==typeof t)return Math.round(n);let{avg:n,std:e,min:r,max:s}=t;void 0===e&&(e=n/4);let i=(o()+o()+o())*e+n;return void 0!==r&&(i=Math.max(r,i)),void 0!==s&&(i=Math.min(s,i)),Math.round(i)}const f="// module\nimport { a, b } from './module';\nimport * as module from './module';\nimport module from './module';\nexport default module;\nexport const a = 0;\nexport * from './module';\nexport * as module from './module';\n\n// variables\nlet a = 10;\nconst b = 20;\n\n// function declaration\nfunction sum(x, y) {\n  return x + y;\n}\n\n// generator function\nfunction* iterator() {\n  yield 0;\n  yield 1;\n}\n\n// arrow function\nconst multiply = (x, y) => x * y;\n\n// class\nclass Person {\n  constructor(name, age) {\n    this.name = name;\n    this.age = age;\n  }\n\n  greet() {\n    console.log('Hello, my name is Miso.');\n  }\n}\n\n// primitive\nconst str = 'Hello, world!';\nconst num = 10.99;\n\n// object\nconst person = new Person('John', 30);\nperson.greet();\n\n// object literal\nconst object = {\n  name: 'John',\n  [x]: 10,\n  ...props,\n};\n\n// array literal\nconst arr = [1, 2, 3, 4, 5, ...props];\n\n// regexp literal\nconst regexp = /\\w+/g;\n\n// operators\nconst sum = a + b;\nconst product = a * b;\nconst negation = -a;\nconst max = a > b ? a : b;\n\n// flow control\nlet i = 9;\nfor (const n of arr) {\n  if (n > i) {\n    console.log(n);\n  }\n  i++;\n}\n\n// async/await\n(async () => {\n  const result = await asyncFunction();\n})();\n\n// try/catch\ntry {\n} catch (e) {\n}\n\n// destructuring\nconst { name, age, ...rest } = person;\nconst [ x, y, ...rest ] = arr;\n\n// template literals\nconsole.log(`The sum of ${a} and ${b} is ${sum(a, b)}.`);";var d=Object.freeze({__proto__:null,javascript:function(){return f},js:function(){return f}});function p({features:n,blocks:r=[8,12],sampling:o=1}={}){let s=[];return[s,n]=function(t=[]){const n=new Set,e=[];for(const r of t)if(r.startsWith("lang-")){let t=r.slice(5);"javascript"===t&&(t="js"),n.add(t)}else e.push(r);return[[...n],e]}(n),function(t,n){const e=[];for(const r of t)1>n&&Math.random()>=n||e.push(r());return e}([()=>m({features:n}),()=>g({features:n}),...s.map((t=>()=>h({lang:t,features:n}))),...s.length?[]:[()=>h({features:n})],()=>g({features:n}),()=>function({columns:n=[2,4],rows:e=[2,8]}){n=t(...n),e=t(...e);const r=[...$({size:1},n-1),{size:[3,8]}],o=i({size:n,output:"array"}),s=r.map((()=>"---")),a=[o,s];for(let t=0;e-1>t;t++)a.push(r.map((({size:t})=>i({size:t}))));return a.map(x).join("\n")}({features:n}),()=>function({url:t,imageSize:n=[400,250],...r}={}){return t=t||e(n),`![${function({size:t=[1,3],content:n}={}){return n||i({size:t})}(r)}](${t})`}(),()=>g({features:n}),()=>"*-_".charAt(t(0,2)).repeat(t(3,6)),()=>m({features:n}),()=>g({features:n}),()=>w({features:n}),()=>g({features:n})],o).join("\n\n")}function m({level:n=[1,6],size:e=[1,8],content:r}){const o=r||i({size:e});return`${"#".repeat(t(...n))} ${o}`}function h({lang:n,content:e,size:r,fenceChar:o="`"}){return"random"===o&&(o="`~".charAt(t(0,1))),e=e||function({lang:t,size:n=[10,30]}){return t&&d[t]?d[t]():i({output:"multiline",size:n})}({lang:n,size:r}),`${o.repeat(3)}${n||""}\n${e}\n${o.repeat(3)}`}function g({size:t=[20,50]}){return i({size:t,decorates:["description",z()]})}const _=["ordered","bullet","task"];function w({features:n,type:e="random",count:r=[1,8],size:o=[5,15]}){r="number"==typeof r?r:t(...r);const s="random"===e?_[Math.floor(3*Math.random())]:e,i=[];for(;r>0;){const a=t(1,r);let u=g({features:n,size:o});a>1&&(u+="\n"+w({features:n,type:e,count:a-1,size:o})),i.push(M(s,u)),r-=a}return i.join("\n")}const y={"code-span":()=>["`","`"],"emphasis-1":()=>$(b(1),2),"emphasis-2":()=>$(b(2),2),"emphasis-3":()=>$(b(3),2),strikethrough:()=>["~","~"],link:({url:t="https://miso.ai"}={})=>["[",`](${t})`]};function b(n=[1,3]){return n="number"==typeof n?n:t(...n),"_*".charAt(t(0,1)).repeat(n)}const q=Object.keys(y),v=new Set(q);function z({features:n=q,size:e=[1,3],rest:r=[0,8]}={}){n=n.filter((t=>v.has(t)));const o=function(t){for(let n=t.length-1;n>0;n--){const e=Math.floor(Math.random()*(n+1));[t[n],t[e]]=[t[e],t[n]]}return t}([...n]);let s=o.length-1;const i=()=>"number"==typeof r?r:t(...r);return function*(r){let a,u,c=i();for(const l of r)if(u&&(yield u),0===c)if(a)u=`${l}${a}`,a=void 0,c=i();else{const[r,i]=y[0>s?n[t(0,n.length-1)]:o[s--]]();u=`${r}${l}`,a=i,c="number"==typeof e?e:t(...e)}else u=l,c--;u&&(yield void 0!==a?`${u}${a}`:u)}}function M(t,n){const[e,r]=n.split("\n",2),o=`${function(t,n="random"){switch(t){case"ordered":return"1.";case"bullet":return"-";case"task":return`- [${("random"===n?.5>Math.random():n)?"x":" "}]`;default:throw Error("unknown list item type: "+t)}}(t)} ${e}`;return r?o+"\n"+function(t,n){return n.split("\n").map((n=>" ".repeat(t)+n)).join("\n")}("ordered"===t?3:2,r):o}function x(t){return`| ${t.join(" | ")} |`}function $(t,n){const e=[];for(let r=0;n>r;r++)e.push("function"==typeof t?t():t);return e}function j({size:t=300}={}){return e(t)}function S({size:t=[1,3]}={}){return i({size:t,decorates:["title"],output:"array"})}function k({size:t=[1,4]}={}){return i({size:t,output:"array"})}function O({size:t=[2,6]}={}){return i({size:t,decorates:["title"]})}function A({size:t=[10,20],...n}={}){return i({size:t,decorates:[Object.keys(n).length?["description",n]:"description"]})}function T(){return Math.floor(1e4*Math.random())/100}function*C({rows:t,...n}={}){for(let e=0;t>e;e++)yield F({...n,index:e})}function F({}={}){const e=n(),r=function(n,e){const r=t(...e),o=[];for(let t=0;r>t;t++)o.push(n());return o}(T,[1,2]);return r.sort(),{product_id:e,authors:S(),categories:[],tags:k(),title:O(),description:A(),cover_image:j(),url:"/products/"+e,sale_price:r[0],original_price:r[r.length-1],rating:Math.floor(500*Math.random())/100+1,availability:Math.random()>.3?"IN_STOCK":"OUT_OF_STOCK"}}function*D({rows:t,...n}={}){for(let e=0;t>e;e++)yield L({...n,index:e})}function L({}={}){const t=n();return{product_id:t,authors:S(),categories:[],tags:k(),title:O({size:[4,10]}),snippet:A({size:[20,40]}),cover_image:j(),url:"/products/"+t}}function*P({rows:t,...n}={}){for(let e=0;t>e;e++)yield U({...n,index:e})}function U({}={}){return A({size:[4,8],punctuation:"?"})}function W({question:t,parent_question_id:n,timestamp:e=Date.now()},{answerFormat:o="markdown",answerSampling:s,answerLanguages:a=[]}={}){const u="10000000-1000-4000-8000-100000000000".replace(/[018]/g,(t=>(t^16*Math.random()>>t/4).toString(16))),c=function(t){const n=new Date(t).toISOString();return n.endsWith("Z")?n.slice(0,-1):n}(e),l=void 0!==s?Math.max(0,Math.min(1,s)):void 0,f=function({format:t,sampling:n,features:e}){return"markdown"===t?p({sampling:n,features:e}):i({min:r(50,n),max:r(50,n),decorates:["description"]})}({format:o,sampling:l,features:a.length?a.map((t=>"lang-"+t)):void 0}),d=[...D({rows:E(6,8,l)})];return{question:t,question_id:u,...n&&{parent_question_id:n},datetime:c,answer:f,sources:[...D({rows:E(4,6,l)})],related_resources:d,followup_questions:[...P({rows:E(3,6)})]}}function E(n,e,o){return t(r(n,o),r(e,o))}const H=[{name:"fetch",duration:1.5,text:"Checking the question and fetching results... "},{name:"verify",duration:1.5,text:"Verifying results... "},{name:"generate",duration:1.5,text:"Generating answer... "}];class I{constructor(t={}){this._options=t,this._answers=new Map}questions(t,n={}){return new J(t,{...this._options,...n})}}class J{constructor({question:t,parent_question_id:n},{answerFormat:e,answerSampling:r,answerLanguages:o,...s}={}){this._options=Object.freeze(s);const i=this.timestamp=Date.now();this._data=W({question:t,parent_question_id:n,timestamp:i},{answerFormat:e,answerSampling:r,answerLanguages:o})}get question_id(){return this._data.question_id}get(){const t=(Date.now()-this.timestamp)*(this._options.speedRate||1)/1e3,[n,e,r]=this._answer(t),o=this._sources(t,r),s=this._related_resources(t,r),i=this._followup_questions(t,r),{question_id:a,question:u,datetime:c,parent_question_id:l}=this._data;return{answer:e,answer_stage:n,datetime:c,finished:r,parent_question_id:l,question:u,question_id:a,sources:o,related_resources:s,followup_questions:i}}_answer(t){for(const n of H)if(0>(t-=n.duration))return[n.name,n.text,!1];const{answer:n}=this._data,e=Math.floor(100*t),r=e>=n.length;return["result",r?n:n.slice(0,e),r]}_sources(t,n){const{sources:e}=this._data;if(n)return e;const{length:r}=e;return e.slice(0,Math.floor(r*t/3))}_related_resources(t,n){const{related_resources:e}=this._data;if(n)return e;const{length:r}=e;return e.slice(0,Math.floor(r*t/3))}_followup_questions(t,n){const{followup_questions:e}=this._data;if(n||!e)return e;const{length:r}=e;return e.slice(0,Math.floor(r*t/3))}}class K{constructor(t){this._options=t}search({rows:t=5}){return{products:[...C({rows:t})]}}}class G{constructor(t){this._options=t}user_to_products({rows:t=5}){return{products:[...C({rows:t})]}}product_to_products({rows:t=5}){return{products:[...C({rows:t})]}}}class N{constructor(t){this._options=t}upload(t){return[]}}class R{constructor(t){this._options=t}upload(t){return[]}ids(){const t=[];for(let n=0;5e3>n;n++)t.push(V(n));return{ids:t}}}function V(t){return`${10>t?"p_000":100>t?"p_00":1e3>t?"p_0":"p_"}${t}`}class Z{constructor(t){this.ask=new I(t),this.search=new K(t),this.recommendation=new G(t),this.interactions=new N(t),this.products=new R(t)}}return{buildApi:(...t)=>new Z(...t)}}));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@miso.ai/doggoganger",
-  "version": "0.9.0-beta.9",
+  "version": "0.9.0",
   "description": "A dummy miso endpoint for demo and testing",
   "type": "module",
   "bin": {
@@ -10,7 +10,12 @@
     "access": "public"
   },
   "scripts": {
-    "start": "nodemon src/index.js",
+    "build:data": "node ./bin/data.js",
+    "build:js": "rollup -c",
+    "build": "npm run build:data && npm run build:js",
+    "start:js": "rollup -w -c rollup.config.dev.mjs",
+    "start": "nodemon cli/index.js",
+    "dev": "npm run start -- -- -v",
     "version": "node ./bin/version.js"
   },
   "repository": {
@@ -32,8 +37,13 @@
     "koa": "^2.14.1",
     "koa-body": "^6.0.1",
     "koa-static": "^5.0.0",
-    "nodemon": "^2.0.15",
-    "uuid": "^8.3.2",
+    "nodemon": "^2.0.22",
     "yargs": "^17.5.1"
+  },
+  "devDependencies": {
+    "@rollup/plugin-terser": "^0.4.3",
+    "rollup": "^3.23.0",
+    "rollup-plugin-livereload": "^2.0.5",
+    "rollup-plugin-serve": "^2.0.2"
   }
 }

package/rollup.config.dev.mjs

@@ -0,0 +1,3 @@
+import { config } from './rollup.util.mjs';
+
+export default config('dev');

package/rollup.config.mjs

@@ -0,0 +1,3 @@
+import { config } from './rollup.util.mjs';
+
+export default config('prod');

package/rollup.util.mjs

@@ -0,0 +1,42 @@
+import terser from '@rollup/plugin-terser';
+import serve from 'rollup-plugin-serve';
+import livereload from 'rollup-plugin-livereload';
+
+export function config(env) {
+  const prod = env === 'prod';
+  let plugins;
+  if (prod) {
+    plugins = [
+      terser({
+        compress: {
+          pure_getters: true,
+          unsafe: true,
+          unsafe_comps: true,
+          warnings: false
+        },
+      }),
+    ];
+  } else {
+    plugins = [
+      serve({
+        port: 10098,
+      }),
+      livereload({
+        delay: 500,
+        watch: 'dist',
+      }),
+    ];
+  }
+  return {
+    input: `src/browser.js`,
+    output: {
+      file: prod ? `dist/umd/doggoganger-browser.min.js` : `dist/umd/doggoganger-browser.js`,
+      format: 'umd',
+      name: 'doggoganger',
+      exports: 'default',
+      indent: !prod,
+    },
+    watch: !prod,
+    plugins,
+  };
+}

package/src/api/ask.js

@@ -1,8 +1,4 @@
-import Router from '@koa/router';
-import { v4 as uuid } from 'uuid';
-import { lorem, md, articles, utils } from '../data/index.js';
-
-const { randomInt } = utils;
+import { answer } from '../data/index.js';
 
 const CPS = 100;
 const ITEMS_LOADING_TIME = 3;
@@ -24,67 +20,51 @@ const STAGES = [
   },
 ];
 
-function formatDatetime(timestamp) {
-  const str = new Date(timestamp).toISOString();
-  return str.endsWith('Z') ? str.slice(0, -1) : str;
-}
+export default class Ask {
 
-function answer(format) {
-  switch (format) {
-    case 'markdown':
-      return md.markdown({});
-    case 'plaintext':
-    default:
-      return lorem.lorem({
-        min: 50,
-        max: 100,
-        decorates: ['description'],
-      });
+  constructor(options = {}) {
+    this._options = options;
+    this._answers = new Map();
   }
-}
 
-const answers = new Map();
-
-class Answer {
+  questions(payload, options = {}) {
+    return new Answer(payload, { ...this._options, ...options });
+  }
 
-  constructor(question, previous_question_id, { answerFormat = 'markdown' } = {}) {
-    this.question_id = uuid();
-    this.question = question;
-    this.previous_answer_id = previous_question_id;
-    this.timestamp = Date.now();
-    this.datetime = formatDatetime(this.timestamp);
+}
 
-    this.answer = answer(answerFormat);
-    this.relatedResources = [...articles({ rows: randomInt(6, 8) })];
-    this.sources = [...articles({ rows: randomInt(4, 6) })];
+class Answer {
 
-    this.previous_question_id = previous_question_id && answers.get(previous_question_id) || undefined;
-    answers.set(this.question_id, this);
+  constructor({ question, parent_question_id }, { answerFormat, answerSampling, answerLanguages, ...options } = {}) {
+    this._options = Object.freeze(options);
+    const timestamp = this.timestamp = Date.now();
+    this._data = answer({ question, parent_question_id, timestamp }, { answerFormat, answerSampling, answerLanguages });
   }
 
-  get id() {
-    return this.question_id;
+  get question_id() {
+    return this._data.question_id;
   }
 
   get() {
     const now = Date.now();
-    const elapsed = (now - this.timestamp) / 1000;
+    const elapsed = (now - this.timestamp) * (this._options.speedRate || 1) / 1000;
     const [answer_stage, answer, finished] = this._answer(elapsed);
-    const sources = this._sources(elapsed);
-    const related_resources = this._relatedResources(elapsed);
-    const { question_id, question, datetime, previous_question_id } = this;
+    const sources = this._sources(elapsed, finished);
+    const related_resources = this._related_resources(elapsed, finished);
+    const followup_questions = this._followup_questions(elapsed, finished);
+    const { question_id, question, datetime, parent_question_id } = this._data;
 
     return {
-      affiliation: undefined,
       answer,
       answer_stage,
       datetime,
       finished,
-      previous_question_id,
+      parent_question_id,
       question,
       question_id,
-      related_resources,
       sources,
+      related_resources,
+      followup_questions,
     };
   }
 
@@ -95,52 +75,41 @@ class Answer {
         return [stage.name, stage.text, false];
       }
     }
+    const { answer } = this._data;
     const length = Math.floor(elapsed * CPS);
-    const finished = length >= this.answer.length;
-    const text = finished ? this.answer : this.answer.slice(0, length);
+    const finished = length >= answer.length;
+    const text = finished ? answer : answer.slice(0, length);
     return ['result', text, finished];
   }
 
-  _sources(elapsed) {
-    const { sources } = this;
+  _sources(elapsed, finished) {
+    const { sources } = this._data;
+    if (finished) {
+      return sources;
+    }
     const { length } = sources;
     const loaded = Math.floor(length * elapsed / ITEMS_LOADING_TIME);
     return sources.slice(0, loaded);
   }
 
-  _relatedResources(elapsed) {
-    const { relatedResources } = this;
-    const { length } = relatedResources;
+  _related_resources(elapsed, finished) {
+    const { related_resources } = this._data;
+    if (finished) {
+      return related_resources;
+    }
+    const { length } = related_resources;
     const loaded = Math.floor(length * elapsed / ITEMS_LOADING_TIME);
-    return relatedResources.slice(0, loaded);
+    return related_resources.slice(0, loaded);
   }
 
-}
-
-export default function({ answerFormat }) {
-  const options = Object.freeze({ answerFormat });
-  const router = new Router();
-
-  router.post('/questions', (ctx) => {
-    const { question, previous_answer_id } = JSON.parse(ctx.request.body);
-    const answerFormat = ctx.get('x-answer-format') || options.answerFormat;
-    const answer = new Answer(question, previous_answer_id, { answerFormat });
-    const data = {
-      question_id: answer.id,
-    };
-    ctx.body = JSON.stringify({ data });
-  });
-
-  router.get('/questions/:id/answer', (ctx) => {
-    const { id } = ctx.params;
-    const answer = answers.get(id);
-    if (!answer) {
-      ctx.status = 404;
-    } else {
-      const data = answer.get();
-      ctx.body = JSON.stringify({ data });
+  _followup_questions(elapsed, finished) {
+    const { followup_questions } = this._data;
+    if (finished || !followup_questions) {
+      return followup_questions;
     }
-  });
+    const { length } = followup_questions;
+    const loaded = Math.floor(length * elapsed / ITEMS_LOADING_TIME);
+    return followup_questions.slice(0, loaded);
+  }
 
-  return router;
 }

package/src/api/index.js

@@ -1,20 +1,17 @@
-import Router from '@koa/router';
-import ask from './ask.js';
-import recommendation from './recommendation.js';
-import search from './search.js';
-import interactions from './interactions.js';
+import Ask from './ask.js';
+import Search from './search.js';
+import Recommendation from './recommendation.js';
+import Interactions from './interactions.js';
+import Products from './products.js';
 
-function use(router, path, middleware) {
-  router.use(path, middleware.routes(), middleware.allowedMethods());
-}
-
-export default function(options) {
-  const router = new Router();
+export default class Api {
 
-  use(router, '/ask', ask(options));
-  use(router, '/recommendation', recommendation);
-  use(router, '/search', search);
-  use(router, '/interactions', interactions);
+  constructor(options) {
+    this.ask = new Ask(options);
+    this.search = new Search(options);
+    this.recommendation = new Recommendation(options);
+    this.interactions = new Interactions(options);
+    this.products = new Products(options);
+  }
 
-  return router;
-};
+}

package/src/api/interactions.js

@@ -1,9 +1,13 @@
-import Router from '@koa/router';
+export default class Interactions {
 
-const router = new Router();
+  constructor(options) {
+    this._options = options;
+  }
 
-router.post('/', (ctx) => {
-  ctx.body = { took: 1, errors: false, data: [] };
-});
+  upload(records) {
+    return [];
+  }
 
-export default router;
+  // TODO: delete
+
+}

package/src/api/products.js

@@ -0,0 +1,28 @@
+export default class Products {
+
+  constructor(options) {
+    this._options = options;
+  }
+
+  upload(records) {
+    return [];
+  }
+
+  ids() {
+    const ids = [];
+    for (let i = 0; i < 5000; i++) {
+      ids.push(mockProductId(i));
+    }
+    return {
+      ids,
+    };
+  }
+
+  // TODO: delete (batch)
+
+}
+
+function mockProductId(i) {
+  const prefix = i < 10 ? 'p_000' : i < 100 ? 'p_00' : i < 1000 ? 'p_0' : 'p_';
+  return `${prefix}${i}`;
+}

package/src/api/recommendation.js

@@ -1,9 +1,21 @@
-import Router from '@koa/router';
-import { products } from './handlers.js';
+import { products } from '../data/index.js';
 
-const router = new Router();
+export default class Recommendation {
 
-router.post('/user_to_products', products);
-router.post('/product_to_products', products);
+  constructor(options) {
+    this._options = options;
+  }
 
-export default router;
+  user_to_products({ rows = 5 }) {
+    return {
+      products: [...products({ rows })],
+    };
+  }
+
+  product_to_products({ rows = 5 }) {
+    return {
+      products: [...products({ rows })],
+    };
+  }
+
+}

package/src/api/search.js

@@ -1,8 +1,15 @@
-import Router from '@koa/router';
-import { products } from './handlers.js';
+import { products } from '../data/index.js';
 
-const router = new Router();
+export default class Search {
 
-router.post('/search', products);
+  constructor(options) {
+    this._options = options;
+  }
 
-export default router;
+  search({ rows = 5 }) {
+    return {
+      products: [...products({ rows })],
+    };
+  }
+
+}

package/src/browser.js

@@ -0,0 +1,5 @@
+import Api from './api/index.js';
+
+export default {
+  buildApi: (...args) => new Api(...args),
+};

package/src/data/answers.js

@@ -0,0 +1,33 @@
+import { randomInt, formatDatetime, sample, uuid } from './utils.js';
+import * as fields from './fields.js';
+import { articles } from './articles.js';
+import { questions } from './questions.js';
+
+export function answer({ question, parent_question_id, timestamp = Date.now() }, { answerFormat = 'markdown', answerSampling, answerLanguages = [] } = {}) {
+
+  const question_id = uuid();
+  const datetime = formatDatetime(timestamp);
+
+  const sampling = answerSampling !== undefined ? Math.max(0, Math.min(1, answerSampling)) : undefined;
+  const features = answerLanguages.length ? answerLanguages.map(language => `lang-${language}`) : undefined;
+
+  const answer = fields.answer({ format: answerFormat, sampling, features });
+  const related_resources = [...articles({ rows: sampleRandomInt(6, 8, sampling) })];
+  const sources = [...articles({ rows: sampleRandomInt(4, 6, sampling) })];
+  const followup_questions = [...questions({ rows: sampleRandomInt(3, 6) })];
+
+  return {
+    question,
+    question_id,
+    ...(parent_question_id && { parent_question_id }),
+    datetime,
+    answer,
+    sources,
+    related_resources,
+    followup_questions,
+  };
+}
+
+function sampleRandomInt(min, max, sampling) {
+  return randomInt(sample(min, sampling), sample(max, sampling));
+}

package/src/data/fields.js

@@ -1,5 +1,6 @@
 import * as lorem from './lorem.js';
-import { imageUrl } from './utils.js';
+import { imageUrl, sample } from './utils.js';
+import * as md from './markdown/index.js';
 
 export function image({ size = 300 } = {}) {
   return imageUrl(size);
@@ -29,10 +30,11 @@ export function title({ size = [2, 6] } = {}) {
   });
 }
 
-export function description({ size = [10, 20] } = {}) {
+export function description({ size = [10, 20], ...options } = {}) {
+  const decorator = Object.keys(options).length ? ['description', options] : 'description';
   return lorem.lorem({
     size,
-    decorates: ['description'],
+    decorates: [decorator],
   });
 }
 
@@ -47,3 +49,17 @@ export function price() {
 export function rating() {
   return Math.floor(Math.random() * 500) / 100 + 1;
 }
+
+export function answer({ format, sampling, features }) {
+  switch (format) {
+    case 'markdown':
+      return md.markdown({ sampling, features });
+    case 'plaintext':
+    default:
+      return lorem.lorem({
+        min: sample(50, sampling),
+        max: sample(50, sampling),
+        decorates: ['description'],
+      });
+  }
+}

package/src/data/index.js

@@ -2,4 +2,6 @@ export * as md from './markdown/index.js';
 export * as lorem from './lorem.js';
 export * from './products.js';
 export * from './articles.js';
+export * from './questions.js';
+export * from './answers.js';
 export * as utils from './utils.js';

package/src/data/lorem.js

@@ -1,11 +1,5 @@
-import { readFileSync } from 'fs';
-import { fileURLToPath } from 'url';
-import { dirname, resolve } from 'path';
-import yaml from 'js-yaml';
-import { randomInt } from './utils.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const DEFAULT_WORDS = yaml.load(readFileSync(resolve(__dirname, './words.yaml'), 'utf8'));
+import { randomInt, gaussRandom } from './utils.js';
+import DEFAULT_WORDS from './words.js';
 
 export function lorem({ decorates = [], output = 'string', size, min, max, ...options } = {}) {
   let iterator = limit(size || [min, max])(base(options));
@@ -24,7 +18,18 @@ const FNS = {
 }
 
 function lookup(fn) {
-  return typeof fn === 'string' ? FNS[fn]() : fn;
+  switch (typeof fn) {
+    case 'string':
+      return FNS[fn]();
+    case 'function':
+      return fn;
+    case 'object':
+      if (Array.isArray(fn)) {
+        const [name, options = {}] = fn;
+        return FNS[name](options);
+      }
+  }
+  throw new Error(`Unrecognized decorator/output form: ${fn}`);
 }
 
 // base //
@@ -97,6 +102,7 @@ export function description({
     std: 5,
     min: 1,
   },
+  punctuation = '.',
 } = {}) {
   return function *(iterator) {
     let word;
@@ -111,12 +117,12 @@ export function description({
         slen = gaussMS(wordsPerSentence);
       }
       if (--slen === 0) {
-        word += '.';
+        word += punctuation;
       }
     }
     if (word) {
-      if (!word.endsWith('.')) {
-        word += '.';
+      if (!word.endsWith(punctuation)) {
+        word += punctuation;
       }
       yield word;
     }
@@ -146,11 +152,3 @@ function gaussMS(args) {
   }
   return Math.round(n);
 }
-
-function gaussRandom() {
-  return uniformRandom() + uniformRandom() + uniformRandom();
-}
-
-function uniformRandom() {
-  return Math.random() * 2 - 1;
-}