@miso.ai/client-sdk-codegen 1.12.0 → 1.12.1-beta.1

package/dist/cjs/{params.js → encoding.js}

@@ -3,9 +3,9 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.decodeParameters = decodeParameters;
-exports.encodeParameters = encodeParameters;
-function encodeParameters(params) {
+exports.decodeConfig = decodeConfig;
+exports.encodeConfig = encodeConfig;
+function encodeConfig(params) {
   if (params === undefined || params === null) {
     return undefined;
   }
@@ -15,7 +15,7 @@ function encodeParameters(params) {
   // JSON string -> base64
   return base64Encode(JSON.stringify(params));
 }
-function decodeParameters(params) {
+function decodeConfig(params) {
   if (params === undefined || params === null) {
     return undefined;
   }

package/dist/cjs/index.js

@@ -10,15 +10,15 @@ var _exportNames = {
 exports.ui = exports.spec = void 0;
 var _spec = _interopRequireWildcard(require("./spec/index.js"));
 exports.spec = _spec;
-var _params = require("./params.js");
-Object.keys(_params).forEach(function (key) {
+var _encoding = require("./encoding.js");
+Object.keys(_encoding).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _params[key]) return;
+  if (key in exports && exports[key] === _encoding[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function () {
-      return _params[key];
+      return _encoding[key];
     }
   });
 });

package/dist/cjs/spec/features.js

@@ -8,27 +8,61 @@ var _utils = require("./utils.js");
 var _workflowsSlug = require("./workflows.slug.js");
 const _excluded = ["slug", "workflows"];
 function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
-var _default = exports.default = [{
-  slug: 'use-api',
-  workflows: '*'
+const DEFAULT_BOOLEAN_OPTIONS = [{
+  name: 'Off',
+  value: undefined
 }, {
+  name: 'On',
+  value: true
+}];
+var _default = exports.default = [
+/*
+{
+  slug: 'use-api',
+  workflows: '*',
+},
+*/
+/*
+{
   slug: 'use-link',
-  workflows: 'ahes'
-}, {
+  workflows: 'ahes',
+  options: DEFAULT_BOOLEAN_OPTIONS,
+},
+*/
+{
   slug: 'autocomplete',
-  workflows: 'hs'
-}, {
+  workflows: 'hs',
+  options: DEFAULT_BOOLEAN_OPTIONS
+},
+/*
+{
   slug: 'pagination',
-  workflows: 'hs'
-}, {
+  workflows: 'hs',
+  options: DEFAULT_BOOLEAN_OPTIONS,
+},
+*/
+{
   slug: 'facets',
-  workflows: 'hs'
+  workflows: 'hs',
+  options: [{
+    name: 'Off',
+    value: undefined
+  }, {
+    name: 'Categories',
+    value: ['categories']
+  }]
+}, {
+  slug: 'answer-box',
+  workflows: 'h',
+  options: DEFAULT_BOOLEAN_OPTIONS
 }, {
   slug: 'follow-up',
-  workflows: 'a'
+  workflows: 'a',
+  options: DEFAULT_BOOLEAN_OPTIONS
 }, {
   slug: 'auto-query',
-  workflows: 'ahes'
+  workflows: 'ahes',
+  options: DEFAULT_BOOLEAN_OPTIONS
 }].reduce((map, _ref) => {
   let {
       slug,

package/dist/cjs/spec/index.js

@@ -9,6 +9,18 @@ Object.defineProperty(exports, "features", {
     return _features.default;
   }
 });
+Object.defineProperty(exports, "resolvePreset", {
+  enumerable: true,
+  get: function () {
+    return _presets.resolvePreset;
+  }
+});
+Object.defineProperty(exports, "sdks", {
+  enumerable: true,
+  get: function () {
+    return _sdks.default;
+  }
+});
 Object.defineProperty(exports, "workflows", {
   enumerable: true,
   get: function () {
@@ -17,4 +29,6 @@ Object.defineProperty(exports, "workflows", {
 });
 var _workflows = _interopRequireDefault(require("./workflows.js"));
 var _features = _interopRequireDefault(require("./features.js"));
+var _sdks = _interopRequireDefault(require("./sdks.js"));
+var _presets = require("./presets.js");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }

package/dist/cjs/spec/presets.js

@@ -3,14 +3,18 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.search = exports.hybridSearch = void 0;
+exports.hybridSearch = void 0;
+exports.resolvePreset = resolvePreset;
+exports.search = void 0;
+var _commons = require("@miso.ai/commons");
+const _excluded = ["workflow", "preset"];
+function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
 const hybridSearch = exports.hybridSearch = Object.freeze({
   standard: Object.freeze({
     workflow: 'hybrid-search',
     autoQuery: true,
     autocomplete: true,
-    facets: ['categories'],
-    answerBox: true
+    facets: ['categories']
   }),
   minimal: Object.freeze({
     workflow: 'hybrid-search'
@@ -26,4 +30,35 @@ const search = exports.search = Object.freeze({
   minimal: Object.freeze({
     workflow: 'search'
   })
-});
+});
+const PRESETS = {
+  ['hybrid-search']: hybridSearch,
+  search
+};
+function resolvePreset(_ref = {}) {
+  let {
+      workflow,
+      preset
+    } = _ref,
+    options = _objectWithoutPropertiesLoose(_ref, _excluded);
+  if (!workflow) {
+    throw new Error('Workflow is required');
+  }
+  workflow = (0, _commons.lowerCamelToKebab)(workflow); // just in case
+  const presets = PRESETS[workflow];
+  if (!presets) {
+    throw new Error(`Workflow "${workflow}" presets not found`);
+  }
+  if (!preset) {
+    return Object.assign({
+      workflow
+    }, options);
+  }
+  if (!presets[preset]) {
+    throw new Error(`Preset "${preset}" not found in workflow "${workflow}"`);
+  }
+  // let rest of options override
+  return Object.assign({
+    workflow
+  }, presets[preset], options);
+}

package/dist/cjs/spec/sdks.js

@@ -0,0 +1,15 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _default = exports.default = [{
+  slug: 'misocmd',
+  name: '3rd-party script',
+  description: 'Load SDK from a CDN script tag.'
+}, {
+  slug: 'module',
+  name: 'Module',
+  description: 'Import SDK as a module to be bundled with your app.'
+}];

package/dist/cjs/spec/workflows.js

@@ -9,6 +9,7 @@ var _utils = require("./utils.js");
 var _workflowsSlug = require("./workflows.slug.js");
 var _features = _interopRequireDefault(require("./features.js"));
 var presets = _interopRequireWildcard(require("./presets.js"));
+var _sdks = _interopRequireDefault(require("./sdks.js"));
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 function getFeatures(features, slug) {
@@ -26,7 +27,8 @@ var _default = exports.default = _workflowsSlug.WORKFLOW_SLUGS.reduce((obj, slug
     slug,
     name: (0, _utils.toName)(slug),
     features: getFeatures(_features.default, slug),
-    presets: getPresets(presets, slug)
+    presets: getPresets(presets, slug),
+    sdks: _sdks.default
   });
   return obj;
 }, {});

package/dist/cjs/template/features.js

@@ -4,16 +4,25 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.autoQuery = autoQuery;
-exports.facets = facets;
+exports.autocomplete = autocomplete;
 var _helpers = require("./helpers.js");
-function facets(options) {
-  return options ? `workflow.useFacets(${(0, _helpers.format)(options, {
+/**
+ * @param {boolean | object} options
+ * - false => ''
+ * - true => `workflow.autoQuery();`
+ * - object => `workflow.autoQuery({ ... });`
+ */
+function autoQuery(options) {
+  return options ? `// start query if URL parameter is present\nworkflow.autoQuery(${(0, _helpers.format)(options === true ? undefined : options, {
     multiline: true
   })});` : '';
 }
-function autoQuery(options) {
-  // TODO: consider when options === false
-  return options ? `workflow.autoQuery(${typeof options === 'object' ? (0, _helpers.format)(options, {
-    multiline: true
-  }) : ''});` : '';
+
+/**
+ * @param {boolean} options
+ * - false => ''
+ * - true => `workflow.autocomplete.enable();`
+ */
+function autocomplete(options) {
+  return options ? `workflow.autocomplete.enable();` : '';
 }

package/dist/cjs/template/helpers.js

@@ -7,12 +7,9 @@ exports.blocks = blocks;
 exports.format = format;
 exports.indent = indent;
 exports.paragraphs = paragraphs;
-exports.resolvePreset = resolvePreset;
-const _excluded = ["preset"];
-function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
 function indent(str, level = 1) {
-  // TODO: trim and deal with blank lines
-  return str.replace(/\n/g, '\n' + ' '.repeat(level));
+  const spaces = ' '.repeat(level);
+  return str.split('\n').map(removeTrailingSpace).map(line => line ? spaces + line : '').join('\n');
 }
 
 /**
@@ -23,8 +20,12 @@ function indent(str, level = 1) {
  * @returns {string}
  */
 function format(value, {
-  multiline = false
+  multiline = false,
+  omitUndefined = true
 } = {}) {
+  if (omitUndefined && value === undefined) {
+    return '';
+  }
   // use single quote
   // no quote for simple key in object
   return JSON.stringify(value, null, multiline ? 2 : 0).replace(/"/g, "'").replace(/\s*:\s*/g, ': ');
@@ -36,7 +37,7 @@ function format(value, {
  * @returns {string}
  */
 function blocks(...blocks) {
-  return blocks.map(block => block.trim()).filter(block => block).join('\n');
+  return blocks.map(removeTrailingSpace).map(removeStartingNewLine).filter(block => block).join('\n');
 }
 
 /**
@@ -45,28 +46,12 @@ function blocks(...blocks) {
  * @returns {string}
  */
 function paragraphs(...paragraphs) {
-  return paragraphs.map(paragraph => paragraph.trim()).filter(paragraph => paragraph).join('\n\n');
+  return paragraphs.map(removeTrailingSpace).map(removeStartingNewLine).filter(paragraph => paragraph).join('\n\n');
 }
-
-/**
- * Resolve preset options
- * @param {Object} presets - Available presets
- * @param {Object} options - Options to resolve
- * @param {string} options.preset - Preset to use
- * @param {Object} options - Other options
- * @returns {Object} Resolved options
- */
-function resolvePreset(presets, _ref = {}) {
-  let {
-      preset
-    } = _ref,
-    options = _objectWithoutPropertiesLoose(_ref, _excluded);
-  if (!preset) {
-    return options;
-  }
-  if (!presets[preset]) {
-    throw new Error(`Preset "${preset}" is not found`);
-  }
-  // let rest of options override
-  return Object.assign({}, presets[preset], options);
+function removeTrailingSpace(str) {
+  return str.replace(/\s+$/g, '');
+}
+function removeStartingNewLine(str) {
+  // remove only leading newlines, preserve other leading whitespace
+  return str.replace(/^[\r\n]+/g, '');
 }

package/dist/cjs/template/index.js

@@ -8,15 +8,15 @@ var _exportNames = {
   helpers: true
 };
 exports.helpers = exports.features = void 0;
-var _entrypoints = require("./entrypoints.js");
-Object.keys(_entrypoints).forEach(function (key) {
+var _sdk = require("./sdk.js");
+Object.keys(_sdk).forEach(function (key) {
   if (key === "default" || key === "__esModule") return;
   if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
-  if (key in exports && exports[key] === _entrypoints[key]) return;
+  if (key in exports && exports[key] === _sdk[key]) return;
   Object.defineProperty(exports, key, {
     enumerable: true,
     get: function () {
-      return _entrypoints[key];
+      return _sdk[key];
     }
   });
 });

package/dist/cjs/template/sdk.js

@@ -0,0 +1,36 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.misocmd = misocmd;
+exports.module = _module;
+exports.sdk = sdk;
+var _helpers = require("./helpers.js");
+function sdk({
+  sdk = 'misocmd'
+} = {}, body) {
+  switch (sdk) {
+    case 'module':
+      return _module(body);
+    case 'misocmd':
+      return misocmd(body);
+    default:
+      throw new Error(`Invalid SDK setup option: ${sdk}`);
+  }
+}
+function misocmd(body) {
+  return `
+const misocmd = window.misocmd || (window.misocmd = []);
+misocmd.push(async () => {
+${(0, _helpers.indent)(body, 2)}
+});
+`.trim();
+}
+function _module(body) {
+  return `
+import MisoClient from '@miso.ai/client-sdk';
+
+${body}
+`.trim();
+}

package/dist/cjs/ui/hybrid-search.js

@@ -4,9 +4,8 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.hybridSearch = hybridSearch;
-var _presets = require("../spec/presets.js");
-var _helpers = require("../template/helpers.js");
-var _index = require("../template/index.js");
+var _index = require("../spec/index.js");
+var _index2 = require("../template/index.js");
 var _features = require("../template/features.js");
 const _excluded = ["facets"];
 function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
@@ -24,10 +23,10 @@ function normalizeOptions(_ref = {}) {
   });
 }
 function hybridSearch(options) {
-  options = normalizeOptions((0, _helpers.resolvePreset)(_presets.hybridSearch, options));
+  options = normalizeOptions((0, _index.resolvePreset)(options));
   const items = [{
     type: 'html',
-    name: 'HTML',
+    name: 'HTML (Main)',
     content: html(options)
   }, {
     type: 'js',
@@ -37,33 +36,58 @@ function hybridSearch(options) {
   return items;
 }
 function js(options) {
-  // TODO: support loading from Node module
   // TODO: useLink
-  return (0, _index.misocmd)(`
-// client
-${(0, _index.createClient)(options)}
-
-// workflow
-const workflow = client.ui.hybridSearch;
-
-// setup: TODO
-
-${jsElements(options)}
-
-${(0, _features.autoQuery)(options.autoQuery)}
-`);
+  return (0, _index2.sdk)(options, _index2.helpers.paragraphs(client(options), workflow(options), setup(options), views(options), (0, _features.autoQuery)(options.autoQuery)));
+}
+function client(options) {
+  return `
+// access Miso client
+${(0, _index2.createClient)(options)}`;
+}
+function workflow(options) {
+  return `
+// access workflow
+const workflow = client.ui.hybridSearch;`;
+}
+function setup(options) {
+  const items = [];
+  const useApiCall = useApi(options);
+  if (useApiCall) {
+    items.push(useApiCall);
+  }
+  if (options.autocomplete) {
+    items.push((0, _features.autocomplete)(options.autocomplete));
+  }
+  return items.length ? _index2.helpers.blocks(`// setup`, ...items) : '';
 }
-function jsElements(options) {
+function useApi(options) {
+  const params = {};
+  if (options.facets) {
+    params.facets = options.facets;
+  }
+  return Object.keys(params).length ? `workflow.useApi(${_index2.helpers.format(params, {
+    multiline: true
+  })});` : '';
+}
+function views(options) {
   if (options.elements === false) {
     return '';
   }
+  const templatesHelpersUsed = [`templates`];
+  let templatesRootParams = undefined;
+  if (options.answerBox) {
+    templatesHelpersUsed.push(`wireAnswerBox`);
+    templatesRootParams = Object.assign({}, templatesRootParams, {
+      answerBox: true
+    });
+  }
   return `
 // render Miso elements
 await client.ui.ready;
-const { templates, wireAnswerBox } = MisoClient.ui.defaults.hybridSearch;
+const { ${templatesHelpersUsed.join(', ')} } = MisoClient.ui.defaults.hybridSearch;
 const rootElement = document.querySelector('#miso-hybrid-search-combo');
-rootElement.innerHTML = templates.root();
-wireAnswerBox(client, rootElement);
+rootElement.innerHTML = templates.root(${_index2.helpers.format(templatesRootParams)});
+${options.answerBox ? `wireAnswerBox(client, rootElement);` : ''}
 `.trim();
 }
 function html(options) {

package/dist/cjs/ui/search.js

@@ -4,9 +4,8 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.search = search;
-var _presets = require("../spec/presets.js");
-var _helpers = require("../template/helpers.js");
-var _index = require("../template/index.js");
+var _index = require("../spec/index.js");
+var _index2 = require("../template/index.js");
 var _features = require("../template/features.js");
 const _excluded = ["facets"];
 function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
@@ -23,7 +22,7 @@ function normalizeOptions(_ref = {}) {
   });
 }
 function search(options) {
-  options = normalizeOptions((0, _helpers.resolvePreset)(_presets.search, options));
+  options = normalizeOptions((0, _index.resolvePreset)(options));
   // TODO: extra styles for concatenate format
   const items = [];
   if (options.elements !== false) {
@@ -45,29 +44,40 @@ function search(options) {
   return items;
 }
 function js(options) {
-  // TODO: support loading from Node module
-  return (0, _index.misocmd)(`
-// client
-${(0, _index.createClient)(options)}
-
-// workflow
-const workflow = client.ui.search;
-
-// setup: TODO
-${(0, _features.facets)(options.facets)}
-
-${(0, _features.autoQuery)(options.autoQuery)}
-`);
+  return (0, _index2.sdk)(options, _index2.helpers.paragraphs(client(options), workflow(options), setup(options), (0, _features.autoQuery)(options.autoQuery)));
 }
-function html(options) {
-  if (options.elements === false) {
-    return '';
-  }
+function client(options) {
   return `
-${htmlSearchBox(options)}
-<hr>
-${htmlResults(options)}
-`.trim();
+// access Miso client
+${(0, _index2.createClient)(options)}`;
+}
+function workflow(options) {
+  return `
+// access workflow
+const workflow = client.ui.search;`;
+}
+function setup(options) {
+  const items = [];
+  const useApiCall = useApi(options);
+  if (useApiCall) {
+    items.push(useApiCall);
+  }
+  if (options.autocomplete) {
+    items.push(autocomplete(options.autocomplete));
+  }
+  return items.length ? _index2.helpers.blocks(`// setup`, ...items) : '';
+}
+function useApi(options) {
+  const params = {};
+  if (options.facets) {
+    params.facets = options.facets;
+  }
+  return Object.keys(params).length ? `workflow.useApi(${_index2.helpers.format(params, {
+    multiline: true
+  })});` : '';
+}
+function autocomplete(options) {
+  return options ? `workflow.autocomplete.enable();` : '';
 }
 function htmlSearchBox(options) {
   return `

package/dist/cjs/ui/ui.js

@@ -6,22 +6,22 @@ Object.defineProperty(exports, "__esModule", {
 exports.ui = ui;
 var _hybridSearch = require("./hybrid-search.js");
 var _search = require("./search.js");
-const _excluded = ["workflow"];
+const _excluded = ["apiKey"];
 function _objectWithoutPropertiesLoose(r, e) { if (null == r) return {}; var t = {}; for (var n in r) if ({}.hasOwnProperty.call(r, n)) { if (-1 !== e.indexOf(n)) continue; t[n] = r[n]; } return t; }
-const workflows = {
+const WORKFLOWS = {
   ['hybrid-search']: _hybridSearch.hybridSearch,
   search: _search.search
 };
 function normalizeOptions(_ref = {}) {
   let {
-      workflow
+      apiKey = 'your_api_key'
     } = _ref,
     options = _objectWithoutPropertiesLoose(_ref, _excluded);
-  if (!workflow) {
+  if (!options.workflow) {
     throw new Error('Workflow is required');
   }
   return Object.assign({
-    workflow
+    apiKey
   }, options);
 }
 function ui(options) {
@@ -29,8 +29,8 @@ function ui(options) {
   const {
     workflow
   } = options;
-  if (!workflows[workflow]) {
+  if (!WORKFLOWS[workflow]) {
     throw new Error(`Workflow "${workflow}" is not found`);
   }
-  return workflows[workflow](options);
+  return WORKFLOWS[workflow](options);
 }

package/package.json

@@ -26,7 +26,7 @@
     "url": "https://github.com/MisoAI/miso-client-js-sdk/issues"
   },
   "dependencies": {
-    "@miso.ai/commons": "1.12.0"
+    "@miso.ai/commons": "1.12.1-beta.1"
   },
-  "version": "1.12.0"
+  "version": "1.12.1-beta.1"
 }

package/src/{params.js → encoding.js}

@@ -1,4 +1,4 @@
-export function encodeParameters(params) {
+export function encodeConfig(params) {
   if (params === undefined || params === null) {
     return undefined;
   }
@@ -9,7 +9,7 @@ export function encodeParameters(params) {
   return base64Encode(JSON.stringify(params));
 }
 
-export function decodeParameters(params) {
+export function decodeConfig(params) {
   if (params === undefined || params === null) {
     return undefined;
   }

package/src/index.js

@@ -1,4 +1,4 @@
 export * as spec from './spec/index.js';
-export * from './params.js';
+export * from './encoding.js';
 export * from './codegen.js';
 export * as ui from './ui/index.js';

package/src/spec/features.js

@@ -1,34 +1,59 @@
 import { toName } from './utils.js';
 import { resolveWorkflows } from './workflows.slug.js';
 
+const DEFAULT_BOOLEAN_OPTIONS = [
+  { name: 'Off', value: undefined },
+  { name: 'On', value: true },
+];
+
 export default [
+  /*
   {
     slug: 'use-api',
     workflows: '*',
   },
+  */
+  /*
   {
     slug: 'use-link',
     workflows: 'ahes',
+    options: DEFAULT_BOOLEAN_OPTIONS,
   },
+  */
   {
     slug: 'autocomplete',
     workflows: 'hs',
+    options: DEFAULT_BOOLEAN_OPTIONS,
   },
+  /*
   {
     slug: 'pagination',
     workflows: 'hs',
+    options: DEFAULT_BOOLEAN_OPTIONS,
   },
+  */
   {
     slug: 'facets',
     workflows: 'hs',
+    options: [
+      { name: 'Off', value: undefined },
+      { name: 'Categories', value: ['categories'] },
+    ],
+  },
+  {
+    slug: 'answer-box',
+    workflows: 'h',
+    options: DEFAULT_BOOLEAN_OPTIONS,
   },
   {
     slug: 'follow-up',
     workflows: 'a',
+    options: DEFAULT_BOOLEAN_OPTIONS,
   },
   {
     slug: 'auto-query',
     workflows: 'ahes',
+    options: DEFAULT_BOOLEAN_OPTIONS,
   },
 ].reduce((map, { slug, workflows, ...rest }) => {
   map[slug] = Object.freeze({

package/src/spec/index.js

@@ -1,2 +1,4 @@
 export { default as workflows } from './workflows.js';
 export { default as features } from './features.js';
+export { default as sdks } from './sdks.js';
+export { resolvePreset } from './presets.js';

package/src/spec/presets.js

@@ -1,10 +1,11 @@
+import { lowerCamelToKebab } from '@miso.ai/commons';
+
 export const hybridSearch = Object.freeze({
   standard: Object.freeze({
     workflow: 'hybrid-search',
     autoQuery: true,
     autocomplete: true,
     facets: ['categories'],
-    answerBox: true,
   }),
   minimal: Object.freeze({
     workflow: 'hybrid-search',
@@ -22,3 +23,34 @@ export const search = Object.freeze({
     workflow: 'search',
   }),
 });
+
+const PRESETS = {
+  ['hybrid-search']: hybridSearch,
+  search,
+};
+
+export function resolvePreset({ workflow, preset, ...options } = {}) {
+  if (!workflow) {
+    throw new Error('Workflow is required');
+  }
+  workflow = lowerCamelToKebab(workflow); // just in case
+  const presets = PRESETS[workflow];
+  if (!presets) {
+    throw new Error(`Workflow "${workflow}" presets not found`);
+  }
+  if (!preset) {
+    return {
+      workflow,
+      ...options,
+    };
+  }
+  if (!presets[preset]) {
+    throw new Error(`Preset "${preset}" not found in workflow "${workflow}"`);
+  }
+  // let rest of options override
+  return {
+    workflow,
+    ...presets[preset],
+    ...options,
+  };
+}

package/src/spec/sdks.js

@@ -0,0 +1,12 @@
+export default [
+  {
+    slug: 'misocmd',
+    name: '3rd-party script',
+    description: 'Load SDK from a CDN script tag.',
+  },
+  {
+    slug: 'module',
+    name: 'Module',
+    description: 'Import SDK as a module to be bundled with your app.',
+  },
+];

package/src/spec/workflows.js

@@ -3,6 +3,7 @@ import { toName } from './utils.js';
 import { WORKFLOW_SLUGS } from './workflows.slug.js';
 import features from './features.js';
 import * as presets from './presets.js';
+import { default as sdks } from './sdks.js';
 
 function getFeatures(features, slug) {
   return Object.values(features).filter(feature => feature.workflows.includes(slug));
@@ -22,6 +23,7 @@ export default WORKFLOW_SLUGS.reduce((obj, slug) => {
     name: toName(slug),
     features: getFeatures(features, slug),
     presets: getPresets(presets, slug),
+    sdks,
   });
   return obj;
 }, {});

package/src/template/features.js

@@ -1,10 +1,20 @@
 import { format } from './helpers.js';
 
-export function facets(options) {
-  return options ? `workflow.useFacets(${format(options, { multiline: true })});` : '';
+/**
+ * @param {boolean | object} options
+ * - false => ''
+ * - true => `workflow.autoQuery();`
+ * - object => `workflow.autoQuery({ ... });`
+ */
+export function autoQuery(options) {
+  return options ? `// start query if URL parameter is present\nworkflow.autoQuery(${format(options === true ? undefined : options, { multiline: true })});` : '';
 }
 
-export function autoQuery(options) {
-  // TODO: consider when options === false
-  return options ? `workflow.autoQuery(${typeof options === 'object' ? format(options, { multiline: true }) : ''});` : '';
+/**
+ * @param {boolean} options
+ * - false => ''
+ * - true => `workflow.autocomplete.enable();`
+ */
+export function autocomplete(options) {
+  return options ? `workflow.autocomplete.enable();` : '';
 }

package/src/template/helpers.js

@@ -1,6 +1,6 @@
 export function indent(str, level = 1) {
-  // TODO: trim and deal with blank lines
-  return str.replace(/\n/g, '\n' + ' '.repeat(level));
+  const spaces = ' '.repeat(level);
+  return str.split('\n').map(removeTrailingSpace).map(line => line ? spaces + line : '').join('\n');
 }
 
 /**
@@ -10,7 +10,10 @@ export function indent(str, level = 1) {
  * @param {boolean} options.multiline - Whether to use multiline
  * @returns {string}
  */
-export function format(value, { multiline = false } = {}) {
+export function format(value, { multiline = false, omitUndefined = true } = {}) {
+  if (omitUndefined && value === undefined) {
+    return '';
+  }
   // use single quote
   // no quote for simple key in object
   return JSON.stringify(value, null, multiline ? 2 : 0).replace(/"/g, "'").replace(/\s*:\s*/g, ': ');
@@ -22,7 +25,11 @@ export function format(value, { multiline = false } = {}) {
  * @returns {string}
  */
 export function blocks(...blocks) {
-  return blocks.map(block => block.trim()).filter(block => block).join('\n');
+  return blocks
+    .map(removeTrailingSpace)
+    .map(removeStartingNewLine)
+    .filter(block => block)
+    .join('\n');
 }
 
 /**
@@ -31,27 +38,18 @@ export function blocks(...blocks) {
  * @returns {string}
  */
 export function paragraphs(...paragraphs) {
-  return paragraphs.map(paragraph => paragraph.trim()).filter(paragraph => paragraph).join('\n\n');
+  return paragraphs
+    .map(removeTrailingSpace)
+    .map(removeStartingNewLine)
+    .filter(paragraph => paragraph)
+    .join('\n\n');
 }
 
-/**
- * Resolve preset options
- * @param {Object} presets - Available presets
- * @param {Object} options - Options to resolve
- * @param {string} options.preset - Preset to use
- * @param {Object} options - Other options
- * @returns {Object} Resolved options
- */
-export function resolvePreset(presets, { preset, ...options } = {}) {
-  if (!preset) {
-    return options;
-  }
-  if (!presets[preset]) {
-    throw new Error(`Preset "${preset}" is not found`);
-  }
-  // let rest of options override
-  return {
-    ...presets[preset],
-    ...options,
-  };
+function removeTrailingSpace(str) {
+  return str.replace(/\s+$/g, '');
+}
+
+function removeStartingNewLine(str) {
+  // remove only leading newlines, preserve other leading whitespace
+  return str.replace(/^[\r\n]+/g, '');
 }

package/src/template/index.js

@@ -1,4 +1,4 @@
-export * from './entrypoints.js';
+export * from './sdk.js';
 export * from './client.js';
 export * as features from './features.js';
 export * as helpers from './helpers.js';

package/src/template/sdk.js

@@ -0,0 +1,29 @@
+import { indent } from './helpers.js';
+
+export function sdk({ sdk = 'misocmd' } = {}, body) {
+  switch (sdk) {
+    case 'module':
+      return module(body);
+    case 'misocmd':
+      return misocmd(body);
+    default:
+      throw new Error(`Invalid SDK setup option: ${sdk}`);
+  }
+}
+
+export function misocmd(body) {
+  return `
+const misocmd = window.misocmd || (window.misocmd = []);
+misocmd.push(async () => {
+${indent(body, 2)}
+});
+`.trim();
+}
+
+export function module(body) {
+  return `
+import MisoClient from '@miso.ai/client-sdk';
+
+${body}
+`.trim();
+}

package/src/ui/hybrid-search.js

@@ -1,7 +1,6 @@
-import { hybridSearch as presets } from '../spec/presets.js';
-import { resolvePreset } from '../template/helpers.js';
-import { misocmd, createClient } from '../template/index.js';
-import { autoQuery } from '../template/features.js';
+import { resolvePreset } from '../spec/index.js';
+import { sdk, createClient, helpers as h } from '../template/index.js';
+import { autoQuery, autocomplete } from '../template/features.js';
 
 // TODO: refactor these
 function normalizeOptions({ facets, ...options } = {}) {
@@ -15,11 +14,11 @@ function normalizeOptions({ facets, ...options } = {}) {
 }
 
 export function hybridSearch(options) {
-  options = normalizeOptions(resolvePreset(presets, options));
+  options = normalizeOptions(resolvePreset(options));
   const items = [
     {
       type: 'html',
-      name: 'HTML',
+      name: 'HTML (Main)',
       content: html(options),
     },
     {
@@ -32,34 +31,65 @@ export function hybridSearch(options) {
 }
 
 function js(options) {
-  // TODO: support loading from Node module
   // TODO: useLink
-  return misocmd(`
-// client
-${createClient(options)}
+  return sdk(options, h.paragraphs(
+    client(options),
+    workflow(options),
+    setup(options),
+    views(options),
+    autoQuery(options.autoQuery),
+  ));
+}
 
-// workflow
-const workflow = client.ui.hybridSearch;
+function client(options) {
+  return `
+// access Miso client
+${createClient(options)}`;
+}
 
-// setup: TODO
+function workflow(options) {
+  return `
+// access workflow
+const workflow = client.ui.hybridSearch;`;
+}
 
-${jsElements(options)}
+function setup(options) {
+  const items = [];
+  const useApiCall = useApi(options);
+  if (useApiCall) {
+    items.push(useApiCall);
+  }
+  if (options.autocomplete) {
+    items.push(autocomplete(options.autocomplete));
+  }
+  return items.length ? h.blocks(`// setup`, ...items) : '';
+}
 
-${autoQuery(options.autoQuery)}
-`);
+function useApi(options) {
+  const params = {};
+  if (options.facets) {
+    params.facets = options.facets;
+  }
+  return Object.keys(params).length ? `workflow.useApi(${h.format(params, { multiline: true })});` : '';
 }
 
-function jsElements(options) {
+function views(options) {
   if (options.elements === false) {
     return '';
   }
+  const templatesHelpersUsed = [`templates`];
+  let templatesRootParams = undefined;
+  if (options.answerBox) {
+    templatesHelpersUsed.push(`wireAnswerBox`);
+    templatesRootParams = { ...templatesRootParams, answerBox: true };
+  }
   return `
 // render Miso elements
 await client.ui.ready;
-const { templates, wireAnswerBox } = MisoClient.ui.defaults.hybridSearch;
+const { ${templatesHelpersUsed.join(', ')} } = MisoClient.ui.defaults.hybridSearch;
 const rootElement = document.querySelector('#miso-hybrid-search-combo');
-rootElement.innerHTML = templates.root();
-wireAnswerBox(client, rootElement);
+rootElement.innerHTML = templates.root(${h.format(templatesRootParams)});
+${options.answerBox ? `wireAnswerBox(client, rootElement);` : ''}
 `.trim();
 }
 

package/src/ui/search.js

@@ -1,7 +1,6 @@
-import { search as presets } from '../spec/presets.js';
-import { resolvePreset } from '../template/helpers.js';
-import { misocmd, createClient } from '../template/index.js';
-import { facets, autoQuery } from '../template/features.js';
+import { resolvePreset } from '../spec/index.js';
+import { sdk, createClient, helpers as h } from '../template/index.js';
+import { autoQuery } from '../template/features.js';
 
 function normalizeOptions({ facets, ...options } = {}) {
   if (facets === true) {
@@ -14,7 +13,7 @@ function normalizeOptions({ facets, ...options } = {}) {
 }
 
 export function search(options) {
-  options = normalizeOptions(resolvePreset(presets, options));
+  options = normalizeOptions(resolvePreset(options));
   // TODO: extra styles for concatenate format
   const items = [];
   if (options.elements !== false) {
@@ -42,30 +41,48 @@ export function search(options) {
 }
 
 function js(options) {
-  // TODO: support loading from Node module
-  return misocmd(`
-// client
-${createClient(options)}
+  return sdk(options, h.paragraphs(
+    client(options),
+    workflow(options),
+    setup(options),
+    autoQuery(options.autoQuery),
+  ));
+}
 
-// workflow
-const workflow = client.ui.search;
+function client(options) {
+  return `
+// access Miso client
+${createClient(options)}`;
+}
 
-// setup: TODO
-${facets(options.facets)}
+function workflow(options) {
+  return `
+// access workflow
+const workflow = client.ui.search;`;
+}
 
-${autoQuery(options.autoQuery)}
-`);
+function setup(options) {
+  const items = [];
+  const useApiCall = useApi(options);
+  if (useApiCall) {
+    items.push(useApiCall);
+  }
+  if (options.autocomplete) {
+    items.push(autocomplete(options.autocomplete));
+  }
+  return items.length ? h.blocks(`// setup`, ...items) : '';
 }
 
-function html(options) {
-  if (options.elements === false) {
-    return '';
+function useApi(options) {
+  const params = {};
+  if (options.facets) {
+    params.facets = options.facets;
   }
-  return `
-${htmlSearchBox(options)}
-<hr>
-${htmlResults(options)}
-`.trim();
+  return Object.keys(params).length ? `workflow.useApi(${h.format(params, { multiline: true })});` : '';
+}
+
+function autocomplete(options) {
+  return options ? `workflow.autocomplete.enable();` : '';
 }
 
 function htmlSearchBox(options) {

package/src/ui/ui.js

@@ -1,17 +1,17 @@
 import { hybridSearch } from './hybrid-search.js';
 import { search } from './search.js';
 
-const workflows = {
+const WORKFLOWS = {
   ['hybrid-search']: hybridSearch,
   search,
 };
 
-function normalizeOptions({ workflow, ...options } = {}) {
-  if (!workflow) {
+function normalizeOptions({ apiKey = 'your_api_key', ...options } = {}) {
+  if (!options.workflow) {
     throw new Error('Workflow is required');
   }
   return {
-    workflow,
+    apiKey,
     ...options,
   };
 }
@@ -19,8 +19,8 @@ function normalizeOptions({ workflow, ...options } = {}) {
 export function ui(options) {
   options = normalizeOptions(options);
   const { workflow } = options;
-  if (!workflows[workflow]) {
+  if (!WORKFLOWS[workflow]) {
     throw new Error(`Workflow "${workflow}" is not found`);
   }
-  return workflows[workflow](options);
+  return WORKFLOWS[workflow](options);
 }

package/dist/cjs/template/entrypoints.js

@@ -1,15 +0,0 @@
-"use strict";
-
-Object.defineProperty(exports, "__esModule", {
-  value: true
-});
-exports.misocmd = misocmd;
-var _helpers = require("./helpers.js");
-function misocmd(body) {
-  return `
-const misocmd = window.misocmd || (window.misocmd = []);
-misocmd.push(async () => {
-${(0, _helpers.indent)(body, 2)}
-});
-`.trim();
-}

package/src/template/entrypoints.js

@@ -1,10 +0,0 @@
-import { indent } from './helpers.js';
-
-export function misocmd(body) {
-  return `
-const misocmd = window.misocmd || (window.misocmd = []);
-misocmd.push(async () => {
-${indent(body, 2)}
-});
-`.trim();
-}