@miso.ai/doggoganger-api 0.0.1 → 0.10.0-beta.0

package/lib/api/api.js

@@ -0,0 +1,21 @@
+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';
+
+export function api(options) {
+  return new Api(options);
+}
+
+export class Api {
+
+  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);
+  }
+
+}

package/lib/api/ask.js

@@ -1,5 +1,5 @@
+import { misoData } from '../data/index.js';
 import { trimObj } from '../utils.js';
-import { answer, searchResults, questions, completions, utils } from '../data/index.js';
 
 const CPS = 100;
 const ITEMS_LOADING_TIME = 3;
@@ -25,40 +25,43 @@ const STAGES = [
 const MODE_QUESTION = 0;
 const MODE_SEARCH = 1;
 
-export default class Ask {
+export class Ask {
 
   constructor(options = {}) {
     this._options = options;
     this._answers = new Map();
   }
 
-  questions(payload, options = {}) {
-    const answer = this._createAnswer(MODE_QUESTION, payload, options);
+  questions(payload, { seed, ...options } = {}) {
+    const data = misoData({ seed });
+    const answer = this._createAnswer(data, MODE_QUESTION, payload, options);
     const { question_id } = answer;
     return { question_id };
   }
 
-  search(payload, options = {}) {
-    const miso_id = utils.uuid();
-    const result = { miso_id, ...searchResults(payload) };
+  search(payload, { seed, ...options } = {}) {
+    const data = misoData({ seed });
+    const miso_id = data._lorem.prng.uuid();
+    const result = { miso_id, ...data.searchResults(payload) };
     if (payload.answer === undefined || payload.answer) {
-      result.question_id = this._createAnswer(MODE_SEARCH, payload, options).question_id;
+      result.question_id = this._createAnswer(data, MODE_SEARCH, payload, options).question_id;
     }
     return result;
   }
 
-  autocomplete({ q, completion_fields = ['title'], rows = 5 }) {
+  autocomplete({ q, completion_fields = ['title'], rows = 5, ...rest }, { seed } = {}) {
+    const data = misoData({ seed });
     return {
-      completions: completions({ q, completion_fields, rows }),
+      completions: data.completions({ q, completion_fields, rows }),
     };
   }
 
-  search_autocomplete(args) {
-    return this.autocomplete(args);
+  search_autocomplete(args, options) {
+    return this.autocomplete(args, options);
   }
 
-  _createAnswer(mode, payload, options = {}) {
-    const answer = new Answer(mode, payload, { ...this._options, ...options });
+  _createAnswer(data, mode, payload, options = {}) {
+    const answer = new Answer(data, mode, payload, { ...this._options, ...options });
     this._answers.set(answer.question_id, answer);
     return answer;
   }
@@ -73,27 +76,28 @@ export default class Ask {
     return answer.get();
   }
 
-  related_questions(payload) {
-    const miso_id = utils.uuid();
+  related_questions(payload, { seed } = {}) {
+    const data = misoData({ seed });
+    const miso_id = data._lorem.prng.uuid();
     return {
-      related_questions: [...questions(payload)],
+      related_questions: data.questions(payload),
       miso_id,
     };
   }
 
-  trending_questions(payload) {
-    return this.related_questions(payload);
+  trending_questions(payload, options) {
+    return this.related_questions(payload, options);
   }
 
 }
 
 class Answer {
 
-  constructor(mode, payload, { answerFormat, answerSampling, answerLanguages, ...options } = {}) {
+  constructor(data, mode, payload, { answerFormat, answerSampling, answerLanguages, ...options } = {}) {
     this._mode = mode;
     this._options = Object.freeze(options);
     const timestamp = this.timestamp = Date.now();
-    this._data = answer({ ...payload, timestamp }, { answerFormat, answerSampling, answerLanguages });
+    this._data = data.answer({ ...payload, timestamp }, { answerFormat, answerSampling, answerLanguages });
   }
 
   get question_id() {

package/lib/api/index.js

@@ -1,17 +1 @@
-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';
-
-export default class Api {
-
-  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);
-  }
-
-}
+export * from './api.js';

package/lib/api/interactions.js

@@ -1,10 +1,10 @@
-export default class Interactions {
+export class Interactions {
 
   constructor(options) {
     this._options = options;
   }
 
-  upload(records) {
+  upload(records, { seed } = {}) {
     return [];
   }
 

package/lib/api/products.js

@@ -1,18 +1,18 @@
-export default class Products {
+export class Products {
 
   constructor(options) {
     this._options = options;
   }
 
-  upload(records) {
+  upload(records, { seed } = {}) {
     return [];
   }
 
-  batchDelete(ids) {
+  batchDelete(ids, { seed } = {}) {
     return [];
   }
 
-  ids() {
+  ids({ seed } = {}) {
     const ids = [];
     for (let i = 0; i < 5000; i++) {
       ids.push(mockProductId(i));

package/lib/api/recommendation.js

@@ -1,20 +1,22 @@
-import { products } from '../data/index.js';
+import { misoData } from '../data/index.js';
 
-export default class Recommendation {
+export class Recommendation {
 
   constructor(options) {
     this._options = options;
   }
 
-  user_to_products({ rows = 5 }) {
+  user_to_products({ rows = 5, ...rest }, { seed } = {}) {
+    const data = misoData({ seed });
     return {
-      products: [...products({ rows })],
+      products: data.products({ rows }),
     };
   }
 
-  product_to_products({ rows = 5 }) {
+  product_to_products({ rows = 5, ...rest }, { seed } = {}) {
+    const data = misoData({ seed });
     return {
-      products: [...products({ rows })],
+      products: data.products({ rows }),
     };
   }
 

package/lib/api/search.js

@@ -1,20 +1,22 @@
-import { products, completions } from '../data/index.js';
+import { misoData } from '../data/index.js';
 
-export default class Search {
+export class Search {
 
   constructor(options) {
     this._options = options;
   }
 
-  search({ rows = 5 }) {
+  search({ rows = 5, ...rest }, { seed } = {}) {
+    const data = misoData({ seed });
     return {
-      products: [...products({ rows })],
+      products: data.products({ rows }),
     };
   }
 
-  autocomplete({ q, completion_fields = ['title'], rows = 5 }) {
+  autocomplete({ q, completion_fields = ['title'], rows = 5, ...rest }, { seed } = {}) {
+    const data = misoData({ seed });
     return {
-      completions: completions({ q, completion_fields, rows }),
+      completions: data.completions({ q, completion_fields, rows }),
     };
   }
 

package/lib/data/answers.js

@@ -1,69 +1,74 @@
-import { fields, utils } from '@miso.ai/lorem';
-import { articles } from './articles.js';
-import { images as _images } from './images.js';
-import { questions } from './questions.js';
-import { facets as generateFacetFields } from './facets.js';
+import { formatDatetime, sample, excludeHtml } from '../utils.js';
 
-const { randomInt, formatDatetime, sample, uuid, shuffle, excludeHtml } = utils;
+export class Answers {
 
-export function answer({
-  _ctrl = {},
-  question,
-  parent_question_id,
-  fl = ['cover_image', 'url'],
-  source_fl = ['cover_image', 'url'],
-  related_resource_fl = ['cover_image', 'url'],
-  cite_link = false,
-  cite_start = '[',
-  cite_end = ']',
-  rows = 10,
-  facets,
-  timestamp = Date.now(),
-  _meta: {
-    page = 0,
-  } = {},
-}, { answerFormat = 'markdown', answerSampling, answerLanguages = [] } = {}) {
+  constructor(data) {
+    this._data = data;
+  }
 
-  const question_id = uuid();
-  const datetime = formatDatetime(timestamp);
+  _answer({
+    _ctrl = {},
+    question,
+    parent_question_id,
+    fl = ['cover_image', 'url'],
+    source_fl = ['cover_image', 'url'],
+    related_resource_fl = ['cover_image', 'url'],
+    cite_link = false,
+    cite_start = '[',
+    cite_end = ']',
+    rows = 10,
+    facets,
+    timestamp = Date.UTC(2026, 0, 1),
+    _meta: {
+      page = 0,
+    } = {},
+  }, { answerFormat = 'markdown', answerSampling, answerLanguages = [] } = {}) {
 
-  const sampling = answerSampling !== undefined ? Math.max(0, Math.min(1, answerSampling)) : undefined;
-  const features = answerLanguages.length ? answerLanguages.map(language => `lang-${language}`) : undefined;
+    const data = this._data;
+    const { fields, prng, utils } = data._lorem;
 
-  const related_resources = [...articles({ rows: sampleRandomInt(6, 8, sampling), fl: related_resource_fl })].map(excludeHtml);
-  const images = [..._images({ rows: sampleRandomInt(2, 12, sampling) })];
-  const sources = [...articles({ rows: sampleRandomInt(4, 6, sampling), fl: source_fl })].map(excludeHtml);
+    const question_id = prng.uuid();
+    const datetime = formatDatetime(timestamp);
 
-  const total = _ctrl.total !== undefined ? _ctrl.total : randomInt(1000, 10000);
-  const products = [...articles({ rows: Math.min(total - page * rows, rows), fl })].map(excludeHtml);
+    const sampling = answerSampling !== undefined ? Math.max(0, Math.min(1, answerSampling)) : undefined;
+    const features = answerLanguages.length ? answerLanguages.map(language => `lang-${language}`) : undefined;
 
-  const facet_counts = facets ? { facet_fields: generateFacetFields({ facets, _ctrl }) } : undefined;
+    const related_resources = data.articles({ rows: this._sampleRandomInt(6, 8, sampling), fl: related_resource_fl }).map(excludeHtml);
+    const images = data.images({ rows: this._sampleRandomInt(2, 12, sampling) });
+    const sources = data.articles({ rows: this._sampleRandomInt(4, 6, sampling), fl: source_fl }).map(excludeHtml);
 
-  const citation = {
-    link: cite_link !== '0' && !!cite_link,
-    start: cite_start,
-    end: cite_end,
-    unused: shuffle([...Array(sources.length).keys()]),
-  };
-  const answer = fields.answer({ sources, citation, format: answerFormat, sampling, features });
-  const followup_questions = [...questions({ rows: sampleRandomInt(3, 6) })];
+    const total = _ctrl.total !== undefined ? _ctrl.total : prng.randomInt(1000, 10000);
+    const products = data.articles({ rows: Math.min(total - page * rows, rows), fl }).map(excludeHtml);
 
-  return {
-    question,
-    question_id,
-    ...(parent_question_id && { parent_question_id }),
-    datetime,
-    answer,
-    images,
-    sources,
-    products,
-    total,
-    facet_counts,
-    related_resources,
-    followup_questions,
-  };
-}
+    const facet_counts = facets ? { facet_fields: data.facets({ facets, _ctrl }) } : undefined;
+
+    const citation = {
+      link: cite_link !== '0' && !!cite_link,
+      start: cite_start,
+      end: cite_end,
+      unused: utils.shuffle([...Array(sources.length).keys()]),
+    };
+    const answer = fields.answer({ sources, citation, format: answerFormat, sampling, features });
+    const followup_questions = data.questions({ rows: this._sampleRandomInt(3, 6) });
+
+    return {
+      question,
+      question_id,
+      ...(parent_question_id && { parent_question_id }),
+      datetime,
+      answer,
+      images,
+      sources,
+      products,
+      total,
+      facet_counts,
+      related_resources,
+      followup_questions,
+    };
+  }
+
+  _sampleRandomInt(min, max, sampling) {
+    return this._data._lorem.prng.randomInt(sample(min, sampling), sample(max, sampling));
+  }
 
-function sampleRandomInt(min, max, sampling) {
-  return randomInt(sample(min, sampling), sample(max, sampling));
 }

package/lib/data/articles.js

@@ -1,5 +1,3 @@
-import { fields, utils } from '@miso.ai/lorem';
-
 const FIELDS = new Set([
   'cover_image',
   'url',
@@ -8,43 +6,49 @@ const FIELDS = new Set([
   'published_at',
 ]);
 
-export function *articles({ rows, ...options } = {}) {
-  for (let i = 0; i < rows; i++) {
-    yield article({ ...options, index: i });
+export class Articles {
+
+  constructor(data) {
+    this._lorem = data._lorem;
   }
-}
 
-function article({ html, fl = [] } = {}) {
-  const id = utils.id();
-
-  const article = {
-    product_id: id,
-    authors: fields.authors(),
-    categories: [],
-    tags: fields.tags(),
-    title: fields.title({ size: [4, 10] }),
-    snippet: fields.description({ size: [20, 40] }),
-    html: fields.html(html),
-  };
-
-  for (const field of fl) {
-    if (FIELDS.has(field)) {
-      article[field] = property(article, field);
+  _article({ html, fl = [] } = {}) {
+    const { fields, prng } = this._lorem;
+
+    const id = prng.shortId();
+
+    const article = {
+      product_id: id,
+      authors: fields.authors(),
+      categories: [],
+      tags: fields.tags(),
+      title: fields.title({ size: [4, 10] }),
+      snippet: fields.description({ size: [20, 40] }),
+      html: fields.html(html),
+    };
+
+    for (const field of fl) {
+      if (FIELDS.has(field)) {
+        article[field] = this._property(article, field);
+      }
     }
+
+    return article;
   }
 
-  return article;
-}
+  _property({ product_id }, field) {
+    const { fields } = this._lorem;
 
-function property({ product_id }, field) {
-  switch (field) {
-    case 'cover_image':
-      return fields.image();
-    case 'url':
-      return `/products/${product_id}`;
-    case 'created_at':
-    case 'updated_at':
-    case 'published_at':
-      return fields.date();
+    switch (field) {
+      case 'cover_image':
+        return fields.image();
+      case 'url':
+        return `/products/${product_id}`;
+      case 'created_at':
+      case 'updated_at':
+      case 'published_at':
+        return fields.date();
+    }
   }
+
 }

package/lib/data/completions.js

@@ -1,37 +1,45 @@
-import { fields, utils } from '@miso.ai/lorem';
+export class Completions {
 
-export function completions({ q, completion_fields, rows } = {}) {
-  let index = 0;
-  const result = {};
-  for (const field of completion_fields) {
-    result[field] = completionsForField(field, q, index, rows);
-    index += rows;
+  constructor(data) {
+    this._lorem = data._lorem;
   }
-  return result;
-}
 
-function completionsForField(field, q, index, rows) {
-  const completions = [];
-  for (let i = 0; i < rows; i++) {
-    completions.push(completion(field, q, index));
+  _completions({ q, completion_fields, rows } = {}) {
+    let index = 0;
+    const result = {};
+    for (const field of completion_fields) {
+      result[field] = this._completionsForField(field, q, index, rows);
+      index += rows;
+    }
+    return result;
   }
-  return completions;
-}
 
-function completion(field, q, index) {
-  const text = fields.title();
-  const i = utils.randomInt(0, text.length);
-  const prefix = text.substring(0, i);
-  const suffix = text.substring(i);
-  return {
-    text: `${prefix}${q}${suffix}`,
-    text_with_markups: `${marked(prefix)}${q}${marked(suffix)}`,
-    text_with_inverted_markups: `${prefix}${marked(q)}${suffix}`,
-    _field: field,
-    _index: index,
-  };
-}
+  _completionsForField(field, q, index, rows) {
+    const completions = [];
+    for (let i = 0; i < rows; i++) {
+      completions.push(this._completion(field, q, index));
+    }
+    return completions;
+  }
+
+  _completion(field, q, index) {
+    const { fields, prng } = this._lorem;
+
+    const text = fields.title();
+    const i = prng.randomInt(0, text.length);
+    const prefix = text.substring(0, i);
+    const suffix = text.substring(i);
+    return {
+      text: `${prefix}${q}${suffix}`,
+      text_with_markups: `${this._marked(prefix)}${q}${this._marked(suffix)}`,
+      text_with_inverted_markups: `${prefix}${this._marked(q)}${suffix}`,
+      _field: field,
+      _index: index,
+    };
+  }
+
+  _marked(text) {
+    return text.length > 0 ? `<mark>${text}</mark>` : '';
+  }
 
-function marked(text) {
-  return text.length > 0 ? `<mark>${text}</mark>` : '';
 }

package/lib/data/data.js

@@ -0,0 +1,89 @@
+import { lorem } from '@miso.ai/lorem';
+import { Products } from './products.js';
+import { Articles } from './articles.js';
+import { Questions } from './questions.js';
+import { Images } from './images.js';
+import { Completions } from './completions.js';
+import { Facets } from './facets.js';
+import { Search } from './search.js';
+import { Answers } from './answers.js';
+
+export function misoData(options) {
+  return new MisoData(options);
+}
+
+class MisoData {
+
+  constructor(options) {
+    this._lorem = lorem(options);
+
+    // Initialize in dependency order
+    this._articles = new Articles(this);
+    this._products = new Products(this);
+    this._questions = new Questions(this);
+    this._images = new Images(this);
+    this._completions = new Completions(this);
+    this._facets = new Facets(this);
+
+    // These depend on the above
+    this._search = new Search(this);
+    this._answers = new Answers(this);
+  }
+
+  // Articles
+  articles({ rows, ...options } = {}) {
+    const results = [];
+    for (let i = 0; i < rows; i++) {
+      results.push(this._articles._article({ ...options, index: i }));
+    }
+    return results;
+  }
+
+  // Products
+  products({ rows, ...options } = {}) {
+    const results = [];
+    for (let i = 0; i < rows; i++) {
+      results.push(this._products._product({ ...options, index: i }));
+    }
+    return results;
+  }
+
+  // Questions
+  questions({ rows = 5, ...options } = {}) {
+    const results = [];
+    for (let i = 0; i < rows; i++) {
+      results.push(this._questions._question({ ...options, index: i }));
+    }
+    return results;
+  }
+
+  // Images
+  images({ rows, ...options } = {}) {
+    const results = [];
+    for (let i = 0; i < rows; i++) {
+      results.push(this._images._image({ ...options, index: i }));
+    }
+    return results;
+  }
+
+  // Completions
+  completions(options) {
+    return this._completions._completions(options);
+  }
+
+  // Facets
+  facets(options) {
+    return this._facets._facets(options);
+  }
+
+  // Search
+  searchResults(options) {
+    return this._search._searchResults(options);
+  }
+
+  // Answers
+  answer(payload, options) {
+    return this._answers._answer(payload, options);
+  }
+
+}

package/lib/data/facets.js

@@ -1,5 +1,3 @@
-import { fields } from '@miso.ai/lorem';
-
 const DEFAULT_FACET_SIZE = 5;
 const MAX_FACET_SIZE = 10;
 const MIN_FACET_SIZE = 1;
@@ -7,52 +5,60 @@ const MIN_FACET_SIZE = 1;
 const HIGHEST_FACET_COUNT_RATIO_RANGE = [1000, 5000];
 const NEXT_FACET_COUNT_RATIO_RANGE = [0.75, 0.25];
 
-export function facets({ facets, ...options } = {}) {
-  const results = {};
-  for (let facet of facets) {
-    if (typeof facet === 'string') {
-      facet = { field: facet };
+export class Facets {
+
+  constructor(data) {
+    this._lorem = data._lorem;
+  }
+
+  _facets({ facets, ...options } = {}) {
+    const results = {};
+    for (let facet of facets) {
+      if (typeof facet === 'string') {
+        facet = { field: facet };
+      }
+      results[facet.field] = this._facetCountList(facet, options);
     }
-    results[facet.field] = facetCountList(facet, options);
+    return results;
   }
-  return results;
-}
 
-function facetCountList(facet, { _ctrl = {}, ...options } = {}) {
-  let { field, size = DEFAULT_FACET_SIZE } = facet;
-  size = _ctrl.total === 0 ? 0 : Math.max(MIN_FACET_SIZE, Math.min(size, MAX_FACET_SIZE));
-  let count = highestFacetCountValue(field, options);
+  _facetCountList(facet, { _ctrl = {}, ...options } = {}) {
+    let { field, size = DEFAULT_FACET_SIZE } = facet;
+    size = _ctrl.total === 0 ? 0 : Math.max(MIN_FACET_SIZE, Math.min(size, MAX_FACET_SIZE));
+    let count = this._highestFacetCountValue(field, options);
 
-  const usedTerms = new Set();
-  const results = [];
-  for (let i = 0; i < size; i++) {
-    results.push([ getTerm(field, usedTerms), count ]);
-    count = nextFacetCountValue(count, field, options);
+    const usedTerms = new Set();
+    const results = [];
+    for (let i = 0; i < size; i++) {
+      results.push([this._getTerm(field, usedTerms), count]);
+      count = this._nextFacetCountValue(count, field, options);
+    }
+    return results;
   }
-  return results;
-}
 
-function getTerm(field, usedTerms) {
-  if (usedTerms.size > 50) {
-    return fields.term({ field });
-  }
-  while (true) {
-    const term = fields.term({ field });
-    if (!usedTerms.has(term)) {
-      usedTerms.add(term);
-      return term;
+  _getTerm(field, usedTerms) {
+    const { fields } = this._lorem;
+    if (usedTerms.size > 50) {
+      return fields.term({ field });
+    }
+    while (true) {
+      const term = fields.term({ field });
+      if (!usedTerms.has(term)) {
+        usedTerms.add(term);
+        return term;
+      }
     }
   }
-}
 
-function highestFacetCountValue(field, options) {
-  // TODO: capped at _ctrl.total
-  const [min, max] = HIGHEST_FACET_COUNT_RATIO_RANGE;
-  return Math.ceil(Math.random() * (max - min) + min);
-}
+  _highestFacetCountValue(field, options) {
+    const [min, max] = HIGHEST_FACET_COUNT_RATIO_RANGE;
+    return this._lorem.prng.randomInt(min, max);
+  }
+
+  _nextFacetCountValue(value, field, options) {
+    const [min, max] = NEXT_FACET_COUNT_RATIO_RANGE;
+    const ratio = min + this._lorem.prng.random() * (max - min);
+    return Math.ceil(value * ratio);
+  }
 
-function nextFacetCountValue(value, field, options) {
-  const [min, max] = NEXT_FACET_COUNT_RATIO_RANGE;
-  const ratio = Math.random() * (max - min) + min;
-  return Math.ceil(value * ratio);
 }

package/lib/data/images.js

@@ -1,22 +1,24 @@
-import { fields, utils } from '@miso.ai/lorem';
+export class Images {
 
-export function *images({ rows, ...options } = {}) {
-  for (let i = 0; i < rows; i++) {
-    yield image({ ...options, index: i });
+  constructor(data) {
+    this._lorem = data._lorem;
   }
-}
 
-function image({ fl = [] } = {}) {
-  const id = utils.id();
+  _image({ fl = [] } = {}) {
+    const { fields, prng } = this._lorem;
+
+    const id = prng.shortId();
+
+    return {
+      product_id: id,
+      image_src: fields.image({ size: [1200, 400] }),
+      image_alt: fields.title({ size: [2, 4] }),
+      title: fields.title({ size: [4, 10] }),
+      url: `/products/${id}`,
+      created_at: fields.date(),
+      updated_at: fields.date(),
+      published_at: fields.date(),
+    };
+  }
 
-  return {
-    product_id: id,
-    image_src: fields.image({ size: [1200, 400] }),
-    image_alt: fields.title({ size: [2, 4] }),
-    title: fields.title({ size: [4, 10] }),
-    url: `/products/${id}`,
-    created_at: fields.date(),
-    updated_at: fields.date(),
-    published_at: fields.date(),
-  };
 }

package/lib/data/index.js

@@ -1,8 +1,4 @@
-export * from '@miso.ai/lorem';
-export * from './products.js';
-export * from './articles.js';
-export * from './questions.js';
-export * from './answers.js';
-export * from './search.js';
-export * from './completions.js';
-export * from './images.js';
+export * from './data.js';
+
+// Re-export lorem
+export { lorem } from '@miso.ai/lorem';

package/lib/data/products.js

@@ -1,29 +1,30 @@
-import { fields, utils } from '@miso.ai/lorem';
+export class Products {
 
-export function *products({ rows, ...options } = {}) {
-  for (let i = 0; i < rows; i++) {
-    yield product({ ...options, index: i });
+  constructor(data) {
+    this._lorem = data._lorem;
   }
-}
 
-function product({} = {}) {
-  const id = utils.id();
-  const prices = utils.repeat(fields.price, [1, 2]);
-  prices.sort();
+  _product({} = {}) {
+    const { fields, prng, utils } = this._lorem;
+
+    const id = prng.shortId();
+    const prices = utils.repeat(() => fields.price(), [1, 2]);
+    prices.sort((a, b) => a - b);
+
+    return {
+      product_id: id,
+      authors: fields.authors(),
+      categories: [],
+      tags: fields.tags(),
+      title: fields.title(),
+      description: fields.description(),
+      cover_image: fields.image(),
+      url: `https://dummy.miso.ai/products/${id}`,
+      sale_price: prices[0],
+      original_price: prices[prices.length - 1],
+      rating: fields.rating(),
+      availability: fields.availability(),
+    };
+  }
 
-  return {
-    product_id: id,
-    authors: fields.authors(),
-    categories: [],
-    tags: fields.tags(),
-    title: fields.title(),
-    description: fields.description(),
-    //html,
-    cover_image: fields.image(),
-    url: `https://dummy.miso.ai/products/${id}`,
-    sale_price: prices[0],
-    original_price: prices[prices.length - 1],
-    rating: fields.rating(),
-    availability: fields.availability(),
-  };
 }

package/lib/data/questions.js

@@ -1,11 +1,11 @@
-import { fields } from '@miso.ai/lorem';
+export class Questions {
 
-export function *questions({ rows = 5, ...options } = {}) {
-  for (let i = 0; i < rows; i++) {
-    yield question({ ...options, index: i });
+  constructor(data) {
+    this._lorem = data._lorem;
+  }
+
+  _question({} = {}) {
+    return this._lorem.fields.description({ size: [4, 8], punctuation: '?' });
   }
-}
 
-function question({} = {}) {
-  return fields.description({ size: [4, 8], punctuation: '?' });
 }

package/lib/data/search.js

@@ -1,24 +1,31 @@
-import { utils } from '@miso.ai/lorem';
-import { articles } from './articles.js';
-import { facets as generateFacetFields } from './facets.js';
+import { excludeHtml } from '../utils.js';
 
-export function searchResults({
-  _ctrl = {},
-  q,
-  fl = ['cover_image', 'url'],
-  rows = 10,
-  facets,
-  _meta: {
-    page = 0,
-  } = {},
-}) {
-  const total = _ctrl.total !== undefined ? _ctrl.total : utils.randomInt(1000, 10000);
-  const products = [...articles({ rows: Math.min(total - page * rows, rows), fl })].map(utils.excludeHtml);
-  const facet_counts = facets ? { facet_fields: generateFacetFields({ facets, _ctrl }) } : undefined;
+export class Search {
+
+  constructor(data) {
+    this._data = data;
+  }
+
+  _searchResults({
+    _ctrl = {},
+    q,
+    fl = ['cover_image', 'url'],
+    rows = 10,
+    facets,
+    _meta: {
+      page = 0,
+    } = {},
+  }) {
+    const { prng } = this._data._lorem;
+    const total = _ctrl.total !== undefined ? _ctrl.total : prng.randomInt(1000, 10000);
+    const products = this._data.articles({ rows: Math.min(total - page * rows, rows), fl }).map(excludeHtml);
+    const facet_counts = facets ? { facet_fields: this._data.facets({ facets, _ctrl }) } : undefined;
+
+    return {
+      products,
+      total,
+      facet_counts,
+    };
+  }
 
-  return {
-    products,
-    total,
-    facet_counts,
-  };
 }

package/lib/index.js

@@ -1,4 +1,2 @@
-export { default as Api } from './api/index.js';
-import * as data from './data/index.js';
-
-export { data };
+export * from './api/index.js';
+export * from './data/index.js';

package/lib/utils.js

@@ -10,3 +10,16 @@ export function trimObj(obj) {
   }
   return trimmed;
 }
+
+export function formatDatetime(timestamp) {
+  const str = new Date(timestamp).toISOString();
+  return str.endsWith('Z') ? str.slice(0, -1) : str;
+}
+
+export function sample(size, sampling) {
+  return sampling !== undefined ? Math.ceil(size * sampling) : size;
+}
+
+export function excludeHtml({ html, ...rest }) {
+  return rest;
+}

package/package.json

@@ -6,7 +6,9 @@
   "publishConfig": {
     "access": "public"
   },
-  "scripts": {},
+  "scripts": {
+    "test": "uvu test"
+  },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/MisoAI/doggoganger.git"
@@ -20,7 +22,7 @@
     "url": "https://github.com/MisoAI/doggoganger/issues"
   },
   "dependencies": {
-    "@miso.ai/lorem": "0.0.1"
+    "@miso.ai/lorem": "0.10.0-beta.0"
   },
-  "version": "0.0.1"
+  "version": "0.10.0-beta.0"
 }

package/test/prng.test.js

@@ -0,0 +1,51 @@
+import { test } from 'uvu';
+import * as assert from 'uvu/assert';
+import { misoData } from '../lib/index.js';
+
+const SEED = 42;
+
+function generate(seed) {
+  const data = misoData({ seed });
+
+  return {
+    // Products
+    products: data.products({ rows: 3 }),
+
+    // Articles
+    articles: data.articles({ rows: 3, fl: ['cover_image', 'url'] }),
+
+    // Questions
+    questions: data.questions({ rows: 3 }),
+
+    // Images
+    images: data.images({ rows: 3 }),
+
+    // Completions
+    completions: data.completions({ q: 'test', completion_fields: ['title'], rows: 3 }),
+
+    // Facets
+    facets: data.facets({ facets: ['category', 'brand'] }),
+
+    // Search results
+    searchResults: data.searchResults({ q: 'test', rows: 5 }),
+
+    // Answer
+    answer: data.answer({ question: 'What is this?' }, { answerFormat: 'markdown' }),
+  };
+}
+
+test('same seed produces identical output', () => {
+  const output1 = generate(SEED);
+  const output2 = generate(SEED);
+
+  assert.equal(output1, output2);
+});
+
+test('different seeds produce different output', () => {
+  const output1 = generate(SEED);
+  const output2 = generate(SEED + 1);
+
+  assert.not.equal(output1, output2);
+});
+
+test.run();

package/package.json.bak

@@ -1,26 +0,0 @@
-{
-  "name": "@miso.ai/doggoganger-api",
-  "description": "A dummy Miso API module",
-  "type": "module",
-  "main": "lib/index.js",
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/MisoAI/doggoganger.git"
-  },
-  "homepage": "https://github.com/MisoAI/doggoganger/",
-  "license": "MIT",
-  "contributors": [
-    "simonpai <simon.pai@askmiso.com>"
-  ],
-  "bugs": {
-    "url": "https://github.com/MisoAI/doggoganger/issues"
-  },
-  "dependencies": {
-    "@miso.ai/lorem": "file:packages/lorem"
-  }
-}