@ordergroove/smi-serve 1.7.3 → 1.7.5

package/CHANGELOG.md

@@ -3,6 +3,25 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+## [1.7.5](https://github.com/ordergroove/plush-toys/compare/@ordergroove/smi-serve@1.7.4...@ordergroove/smi-serve@1.7.5) (2024-04-22)
+
+**Note:** Version bump only for package @ordergroove/smi-serve
+
+
+
+
+
+## [1.7.4](https://github.com/ordergroove/plush-toys/compare/@ordergroove/smi-serve@1.7.3...@ordergroove/smi-serve@1.7.4) (2024-04-22)
+
+
+### Bug Fixes
+
+* use cwd when constructing filepaths ([9dd0743](https://github.com/ordergroove/plush-toys/commit/9dd0743ade2daad9deb0f0c551162db4c52d6f03))
+
+
+
+
+
 ## [1.7.3](https://github.com/ordergroove/plush-toys/compare/@ordergroove/smi-serve@1.7.2...@ordergroove/smi-serve@1.7.3) (2024-04-19)
 
 

package/README.md

@@ -1,14 +1,10 @@
 # @ordergroove/smi-serve
 
-This README document provides an overview and usage instructions for the `smi-serve` program.
-
-## Overview
-
-`smi-serve` is a command-line tool designed to manage authentication credentials, initialize directories for use with Ordergroove's services, and start a development server.
+`smi-serve` is a CLI tool to scaffold and run a local dev environment for Ordergroove's Subscription Manager templates.
 
 ## Installation
 
-Before using `smi-serve`, ensure you have Node.js installed on your system. If not, you can download and install it from [nodejs.org](https://nodejs.org/).
+Before using `smi-serve`, ensure you have Node.js installed on your system. If not, you can download and install it from [nodejs.org](https://nodejs.org/). The smi-serve tool requires Node 18 or later.
 
 ## Usage
 

package/__mocks__/fs/promises.js

@@ -0,0 +1,2 @@
+const { fs } = require('memfs');
+module.exports = fs.promises;

package/__mocks__/fs.js

@@ -0,0 +1,2 @@
+const { fs } = require('memfs');
+module.exports = fs;

package/jest.config.js

@@ -0,0 +1,7 @@
+module.exports = {
+  // needed to prevent error when requiring esbuild during unit tests
+  // "Invariant violation: "Buffer.from("") instanceof Uint8Array" is incorrectly false"
+  globals: {
+    Uint8Array: Uint8Array
+  }
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ordergroove/smi-serve",
-  "version": "1.7.3",
-  "description": "Utility to serve a SMI template locally",
+  "version": "1.7.5",
+  "description": "Utility to serve a Subscription Manager template locally",
   "keywords": [],
   "author": "Eugenio Lattanzio <eugenio.lattanzio@ordergroove.com>",
   "license": "ISC",
@@ -11,7 +11,7 @@
     "url": "git+https://github.com/ordergroove/plush-toys.git"
   },
   "scripts": {
-    "test": "echo \"Error: run tests from root\" && exit 0"
+    "test": "../../node_modules/.bin/jest"
   },
   "bugs": {
     "url": "https://github.com/ordergroove/plush-toys/issues"
@@ -32,5 +32,8 @@
     "ora": "^5.4.1",
     "yargs": "^17.7.2"
   },
-  "gitHead": "9ed3442b896ca9d86606d9ae93fda79c330ba575"
+  "devDependencies": {
+    "memfs": "^4.8.2"
+  },
+  "gitHead": "53bdf51afea74383c5e1dc80e12b3ae92116192c"
 }

package/smi-serve.js

@@ -10,7 +10,7 @@ const figures = require('figures');
 const { getcwd, getNetFreePort, readRcEnv } = require('./src/utils');
 const { cliCallSelectMerchant } = require('./src/select-merchant');
 const { deploy } = require('./src/deploy');
-const { init, DirNotEmpty } = require('./src/init');
+const { init, DirNotEmpty, OG_RC_FILE } = require('./src/init');
 const { serve } = require('./src/serve');
 
 function box(text) {
@@ -25,7 +25,7 @@ ${text
 }
 
 async function initOrServe(args) {
-  const files = await glob(`${getcwd()}/**/*.*`, { ignore: ['**/node_modules/**', 'node_modules/**'] });
+  const files = await glob(`${getcwd(args)}/**/*.*`, { ignore: ['**/node_modules/**', 'node_modules/**'] });
   const mainLiquid = files.find(it => it.includes('main.liquid'));
   if (!mainLiquid) {
     const { initialize } = await inquirer.prompt([
@@ -63,7 +63,6 @@ Platform: ${merchant.ecommerce_platform}
         Alterations, additions, or deletions to the Subscription Manager will be visible to your customers
         in real-time after you deploy.\n`);
 
-    if (args.verbose) console.log(args);
     try {
       await fn(args);
       console.log(`${figures.tick} SUCCESS`);
@@ -71,8 +70,8 @@ Platform: ${merchant.ecommerce_platform}
       if (err instanceof DirNotEmpty) {
         console.error(`${figures.cross} ERROR`);
         console.error(`\
-The directory is not empty and fetching will override your local changes 
-try force fetch by using -f modifier
+The directory is not empty and fetching will override your local changes.
+To overwrite your local changes, re-run the command with "-f". 
 `);
       } else {
         throw err;
@@ -82,88 +81,89 @@ try force fetch by using -f modifier
 }
 
 async function program() {
-  yargs(hideBin(process.argv))
-    .command({
-      command: 'select-merchant',
-      describe: 'Select a different Ordergroove merchant',
-      handler: wrapHandler(cliCallSelectMerchant)
-    })
-    .command({
-      command: 'init',
-      alias: ['fetch'],
-      describe: 'Initialize the current directory with smi assets from og rc3',
-      builder: y =>
-        y
-          .option('overwrite', {
-            alias: 'f',
-            type: 'boolean',
-            description: 'Overwrite files if exists locally'
-          })
-          .option('entrypoint', {
-            type: 'boolean',
-            description: 'generate entrypoint.js'
-          })
-          .option('yes', {
-            alias: 'y',
-            type: 'boolean',
-            description: 'Initilizes it with rc3 config, otherwise it prompts'
-          }),
+  return (
+    yargs(hideBin(process.argv))
+      .command({
+        command: 'select-merchant',
+        describe: 'Select a different Ordergroove merchant',
+        handler: wrapHandler(cliCallSelectMerchant)
+      })
+      .command({
+        command: 'init',
+        alias: ['fetch'],
+        describe: 'Initialize the current directory with the assets from your live Subscription Manager theme',
+        builder: y =>
+          y
+            .option('overwrite', {
+              alias: 'f',
+              type: 'boolean',
+              description: 'Allow overwriting existing files'
+            })
+            .option('yes', {
+              alias: 'y',
+              type: 'boolean',
+              description: 'Skip prompts and initialize with your live theme'
+            }),
 
-      handler: wrapHandler(init)
-    })
-    .command({
-      command: 'deploy',
-      describe: 'Deploy changes to ordergroove',
-      handler: wrapHandler(deploy)
-    })
-    .command({
-      command: '$0',
-      alias: ['serve'],
-      describe: 'Start the dev server',
-      handler: wrapHandler(initOrServe)
-    })
-    .option('verbose', {
-      alias: 'v',
-      type: 'boolean',
-      description: 'Run with verbose logging'
-    })
-    .option('outdir', {
-      alias: 'o',
-      type: 'string',
-      default: 'node_modules/.smi-serve-build',
-      description: 'Output directory'
-    })
-    .option('configFile', {
-      alias: ['c', 'config-file'],
-      type: 'string',
-      default: '.ogrc.json',
-      description: 'Ordergroove configuration file'
-    })
-    .option('cwd', {
-      alias: ['w', 'working-dir'],
-      type: 'string',
-      default: '.',
-      description: 'Sets the current working directory'
-    })
-    .option('port', {
-      alias: 'p',
-      type: 'number',
-      description: 'http port',
-      default: await getNetFreePort()
-    })
-    .option('impersonate', {
-      alias: 'i',
-      type: 'string',
-      description: 'Enable customer impersonation'
-    })
-    .option('env', {
-      alias: 'e',
-      type: 'string',
-      choices: ['prod', 'staging', 'local'],
-      default: 'prod',
-      description: 'Ordergroove enviromnet staging/prod'
-    })
-    .parse();
+        handler: wrapHandler(init)
+      })
+      .command({
+        command: 'deploy',
+        describe: 'Publish your template changes to your live theme',
+        handler: wrapHandler(deploy)
+      })
+      .command({
+        command: '$0',
+        alias: ['serve'],
+        describe: 'Start the dev server',
+        handler: wrapHandler(initOrServe)
+      })
+      .option('verbose', {
+        alias: 'v',
+        type: 'boolean',
+        description: 'Enable verbose logging'
+      })
+      .option('outdir', {
+        alias: 'o',
+        type: 'string',
+        default: 'node_modules/.smi-serve-build',
+        description: 'Where to output the bundle for local dev'
+      })
+      .option('configFile', {
+        alias: ['c', 'config-file'],
+        type: 'string',
+        default: OG_RC_FILE,
+        description: 'Name of the Ordergroove configuration file'
+      })
+      .option('cwd', {
+        alias: ['w', 'working-dir'],
+        type: 'string',
+        default: '.',
+        description: 'Path to the working directory. The directory must already exist.'
+      })
+      .option('port', {
+        alias: 'p',
+        type: 'number',
+        description: 'Which local port to run the dev server on',
+        default: await getNetFreePort()
+      })
+      .option('impersonate', {
+        alias: 'i',
+        type: 'string'
+      })
+      // impersonate only works for superusers; hide it from help for now
+      .hide('impersonate')
+      .option('env', {
+        alias: 'e',
+        type: 'string',
+        choices: ['prod', 'staging', 'local'],
+        default: 'prod',
+        description: 'Which Ordergroove environment to use'
+      })
+      .parse()
+  );
 }
 
 if (require.main === module) program();
+
+module.exports = program;

package/smi-serve.spec.js

@@ -0,0 +1,118 @@
+// mock Node fs to be in memory
+jest.mock('fs');
+jest.mock('fs/promises');
+const { vol } = require('memfs');
+
+// mock all fetch calls
+jest.mock('node-fetch', () => require('fetch-mock').sandbox());
+const fetchMock = require('node-fetch');
+
+// don't run local dev server logic
+jest.mock('./src/serve');
+// mock login function to return a mock token
+jest.mock('./src/login', () => ({
+  ...jest.requireActual('./src/login'),
+  login: jest.fn().mockReturnValue(Promise.resolve('mock-auth'))
+}));
+jest.mock('./src/utils', () => ({
+  ...jest.requireActual('./src/utils'),
+  exec: jest.fn() // don't attempt to spawn new processes
+}));
+
+const smiServe = require('./smi-serve');
+
+function runCommand(command) {
+  // the first two args don't matter, but it sends the correct number of CLI args
+  process.argv = ['node', 'smi-serve.js', ...command.split(' ')];
+  return smiServe();
+}
+
+describe('smi-serve', () => {
+  let originalArgv;
+
+  beforeEach(() => {
+    // wipe mock filesystem
+    vol.fromJSON({}, '/');
+    originalArgv = process.argv;
+  });
+
+  afterEach(() => {
+    process.argv = originalArgv;
+    fetchMock.reset();
+  });
+
+  it('inits with expected files', async () => {
+    fetchMock.get('https://rc3.ordergroove.com/api/merchants/', mockSingleMerchantResponse());
+    fetchMock.get('https://rc3.ordergroove.com/configs/msi/?merchant_public_id=yum-id', mockMSIConfig());
+
+    await runCommand('init --cwd / -y');
+
+    const files = vol.toJSON();
+    for (const file of Object.keys(files)) {
+      if (file.endsWith('.json')) {
+        files[file] = JSON.parse(files[file]);
+      }
+    }
+    expect(files).toEqual({
+      '/.gitignore': '.ogrc.json\nnode_modules/\n',
+      '/.ogrc.json': {
+        prod: {
+          token: 'mock-auth'
+        }
+      },
+      '/package.json': {
+        author: '',
+        description: 'Ordergroove Subscription Manager for test merchant on shopify platform (yum-id)}',
+        keywords: ['Ordergroove Subscription Manager', 'test merchant', 'yum-id'],
+        main: 'views/main.liquid',
+        ordergroove: {
+          coreVersion: '0.31.6',
+          templatesVersion: '0.40.1'
+        },
+        scripts: {
+          deploy: 'smi-serve deploy',
+          start: 'smi-serve'
+        }
+      },
+      '/styles/main.less': '* { color: red; }',
+      '/views/main.liquid': '<h1>Hello world</h1>'
+    });
+  });
+});
+
+function mockSingleMerchantResponse() {
+  return [
+    {
+      name: 'test merchant',
+      public_id: 'yum-id',
+      ecommerce_platform: 'shopify'
+    }
+  ];
+}
+
+function mockMSIConfig() {
+  return {
+    configs: {
+      smi: {
+        files: [
+          {
+            name: '/views/main.liquid',
+            content: '<h1>Hello world</h1>'
+          },
+          {
+            name: '/styles/main.less',
+            content: '* { color: red; }'
+          }
+        ]
+      },
+      provisioned_with: {
+        '@ordergroove/smi-templates': '0.40.1'
+      }
+    },
+    meta_fields: {
+      dependencies: {
+        '@ordergroove/smi-core': '0.31.6'
+      }
+    }
+  };
+}

package/src/auth.js

@@ -1,19 +1,11 @@
-const http = require('http');
 const inquirer = require('inquirer');
 const inquirerPrompt = require('inquirer-autocomplete-prompt');
 
-const { open, getNetFreePort, readRcEnv, writeRcEnv, isValidToken } = require('./utils');
+const { readRcEnv, writeRcEnv, isValidToken } = require('./utils');
+const { login, getRC3Url } = require('./login');
 
 inquirer.registerPrompt('autocomplete', inquirerPrompt);
 
-function getRC3Url({ env }) {
-  if (env.startsWith('st')) return `https://rc3.stg.ordergroove.com/`;
-  if (env.startsWith('l')) return `http://0.0.0.0:3000/`;
-  return `https://rc3.ordergroove.com/`;
-}
-
-exports.getRC3Url = getRC3Url;
-
 async function getValidLoginAndCurrentMerchant(args) {
   const existingSettings = await readRcEnv(args);
   let token, merchant;
@@ -35,92 +27,4 @@ async function getValidLoginAndCurrentMerchant(args) {
 }
 exports.getValidLoginAndCurrentMerchant = getValidLoginAndCurrentMerchant;
 
-async function login(args) {
-  /* eslint-disable no-async-promise-executor */
-  return await new Promise(async (resolveAuth, rejectAuth) => {
-    const port = await getNetFreePort();
-
-    let server;
-
-    const sockets = new Set();
-    /**
-     * Forcefully terminates HTTP server.
-     */
-    const terminateServer = () => {
-      clearTimeout(authRejectTimeout);
-      return new Promise((resolve, reject) => {
-        [...sockets].forEach(socket => {
-          socket.destroy();
-          sockets.delete(socket);
-        });
-
-        server.close(err => {
-          process.nextTick(() => {
-            if (err) {
-              reject(err);
-            } else {
-              resolve();
-            }
-          });
-        });
-      });
-    };
-
-    async function requestListener(req, res) {
-      if (req.method === 'POST' && req.headers['content-type'] === 'application/x-www-form-urlencoded') {
-        let body = '';
-
-        req.on('data', chunk => {
-          body += chunk.toString();
-        });
-
-        req.on('end', async () => {
-          const params = new URLSearchParams(body);
-          const token = params.get('token');
-
-          if (!isValidToken(token)) {
-            res.writeHead(400);
-            res.end('Invalid request\n');
-            return;
-          }
-
-          resolveAuth(token);
-
-          res.writeHead(302, { Location: getRC3Url(args) });
-          res.end();
-          await terminateServer();
-        });
-      } else {
-        res.writeHead(200, { 'Content-Type': 'text/html' });
-        res.end('Invalid request\n');
-      }
-    }
-
-    server = http.createServer(requestListener);
-    server.on('connection', socket => {
-      sockets.add(socket);
-
-      server.once('close', () => {
-        sockets.delete(socket);
-      });
-    });
-
-    server.listen(port, '127.0.0.1', () => {
-      const loginUrl = `${getRC3Url(args)}?${new URLSearchParams([
-        ['login_redirect', `http://localhost:${port}`],
-        ['sm_local_dev', 'true']
-      ])}`;
-      console.log('A browser window has been opened to Ordergroove. Please log in through your browser to continue.');
-      console.log(`Browsing ${loginUrl}`);
-      open(loginUrl);
-    });
-
-    // terminate the program after 5 minutes waiting for auth.
-    const authRejectTimeout = setTimeout(
-      () => {
-        rejectAuth(new Error('Auth timeout'));
-      },
-      5 * 60 * 1000
-    );
-  });
-}
+exports.getRC3Url = getRC3Url;

package/src/deploy.js

@@ -63,11 +63,11 @@ async function deploy(args) {
     '**/package-lock.json'
   ];
 
-  const files = await glob(`${getcwd()}/**/*.*`, { ignore: ignoreFiles });
+  const files = await glob(`${getcwd(args)}/**/*.*`, { ignore: ignoreFiles });
 
   const fileList = await Promise.all(
     files.map(async file => ({
-      name: file.substring(getcwd().length),
+      name: file.substring(getcwd(args).length),
       content: await fs.promises.readFile(file, 'utf8')
     }))
   );
@@ -90,7 +90,7 @@ async function deploy(args) {
     console.log(err);
   }
 
-  const packageJson = readPackageJson();
+  const packageJson = readPackageJson(getcwd(args));
   const smiTemplatesVersion = packageJson[packageJsonKeys.OG_SECTION]?.[packageJsonKeys.TEMPLATES_VERSION];
 
   const newRequest = {
@@ -135,7 +135,7 @@ async function deploy(args) {
     }
   );
   if (response.status === 201) {
-    console.log('SMI changes deployed');
+    console.log('Subscription Manager changes deployed');
   } else {
     console.error(response.status, await response.text());
   }

package/src/impersonate.js

@@ -65,10 +65,10 @@ async function impersonate(args) {
   console.log(`\
 
 -------------------------------------------------------------------------------
-    Browsing SMI for customer: ${customer.first_name} ${customer.last_name} (${customer.email})
+    Browsing Subscription Manager for customer: ${customer.first_name} ${customer.last_name} (${customer.email})
 
     Please note: 
-      This tool browses the live SMI of the customer you are impersonating. 
+      This tool browses the live Subscription Manager of the customer you are impersonating. 
       Do not make any changes to orders/subscriptions as they will actually 
       take effect. This tool is intended for troubleshooting and previewing 
       only. Please use the CSA to edit order/subscription data.        

package/src/init.js

@@ -3,7 +3,7 @@ const fetch = require('node-fetch');
 const path = require('path');
 const inquirer = require('inquirer');
 
-const { chooseMerchant, getRC3Url } = require('./auth');
+const { getRC3Url } = require('./auth');
 const {
   getcwd,
   exec,
@@ -16,7 +16,6 @@ const { serve } = require('./serve');
 const { getValidSettings } = require('./select-merchant');
 
 const SUBSCRIPTION_MANAGEMENT_ENDPOINT = 'msi';
-const SMI_CORE_NAME = '@ordergroove/smi-core';
 const SMI_TEMPLATES_NAME = '@ordergroove/smi-templates';
 const OG_RC_FILE = '.ogrc.json';
 
@@ -46,7 +45,7 @@ async function updateJsonFile(filename, config) {
   await fs.promises.writeFile(filename, JSON.stringify(original, null, 4), { encoding: 'utf8' });
 }
 
-const downloadAndExtract = async url => {
+const downloadAndExtract = async (url, args) => {
   try {
     console.log(`Downloading ZIP file from ${url}`);
     const response = await fetch(url);
@@ -54,7 +53,7 @@ const downloadAndExtract = async url => {
     if (!response.ok) {
       throw new Error(`Failed to download ZIP file. Status code: ${response.status}`);
     }
-    const cwd = getcwd();
+    const cwd = getcwd(args);
     const zipFileName = path.basename(url);
     const zipFilePath = path.join(cwd, zipFileName);
 
@@ -62,7 +61,7 @@ const downloadAndExtract = async url => {
 
     console.log('ZIP file downloaded successfully');
 
-    await unzip(zipFilePath, getcwd());
+    await unzip(zipFilePath, cwd);
   } catch (error) {
     console.error('Error:', error.message);
   }
@@ -101,10 +100,10 @@ async function init(args) {
         {
           type: 'list',
           name: 'useMerchantSpecific',
-          message: 'What templates do you want to initialize it with?',
+          message: 'Which templates do you want to use?',
           choices: [
-            { value: true, name: `Pull "${merchant.name}" templates stored in ${getRC3Url(args)}` },
-            { value: false, name: 'Fresh install latest version of @ordergroove/smi-templates' }
+            { value: true, name: `Pull the live theme for "${merchant.name}" from Ordergroove` },
+            { value: false, name: 'Use the latest files from the default Subscription Manager template' }
           ]
         }
       ]);
@@ -117,7 +116,7 @@ async function init(args) {
     }
 
     (msiConfigs.smi.files || []).forEach(({ content, name }) => {
-      const filepath = `.${name}`;
+      const filepath = path.join(args.cwd, name);
       fs.mkdirSync(path.dirname(filepath), { recursive: true });
       fs.writeFileSync(filepath, content, { encoding: 'utf8' });
     });
@@ -129,7 +128,8 @@ async function init(args) {
     smiTemplateVersion = await getMerchantTemplatesVersion(smiVersion);
 
     await downloadAndExtract(
-      `https://static.ordergroove.com/@ordergroove/smi-templates/${smiTemplateVersion}/dist/smi-template.zip`
+      `https://static.ordergroove.com/@ordergroove/smi-templates/${smiTemplateVersion}/dist/smi-template.zip`,
+      args
     );
   }
 
@@ -139,52 +139,24 @@ async function init(args) {
     smiVersion = 'latest';
   }
 
-  // skip this for now
-  const installEntrypoint = args.entrypoint;
-
-  // this auth_config will be the one in rc, since sos will update
-  // it with whatever is on subscription-settings endpoint
-  //
-  // const { configs: merchantSettings } = await getConfigs(SUBSCRIPTION_SETTINGS_ENDPOINT, merchant, token);
-  // const auth_config = {
-  //   auth_url: merchantSettings.authUrl,
-  //   env: merchantSettings.env
-  // };
-
-  const auth_config = {};
-
-  //
-  if (installEntrypoint) {
-    // put some runtime config with merchant id
-    fs.writeFileSync(
-      './runtime-config.js',
-      `\
-export const merchant_id = ${JSON.stringify(merchant.public_id)}; 
-export const auth_config = ${JSON.stringify(auth_config)};
-`
-    );
-
-    fs.writeFileSync('entrypoint.js', fs.readFileSync(`${__dirname}/../entrypoint.js`, 'utf8'));
-  }
-
   // write a .gitignore just in case
   fs.writeFileSync(
-    '.gitignore',
+    path.join(args.cwd, '.gitignore'),
     `\
 ${OG_RC_FILE}
 node_modules/
 `
   );
 
-  await updateJsonFile('package.json', {
+  await updateJsonFile(path.join(args.cwd, 'package.json'), {
     scripts: {
       start: 'smi-serve',
       deploy: 'smi-serve deploy'
     },
-    description: `Ordergroove SMI for ${merchant.name} on ${merchant.ecommerce_platform} platform (${merchant.public_id})}`,
+    description: `Ordergroove Subscription Manager for ${merchant.name} on ${merchant.ecommerce_platform} platform (${merchant.public_id})}`,
     author: getAuthorNameFromToken(token),
-    main: installEntrypoint ? 'entrypoint.js' : 'views/main.liquid',
-    keywords: ['Ordergroove SMI', merchant.name, merchant.public_id],
+    main: 'views/main.liquid',
+    keywords: ['Ordergroove Subscription Manager', merchant.name, merchant.public_id],
     [packageJsonKeys.OG_SECTION]: {
       [packageJsonKeys.CORE_VERSION]: smiVersion,
       [packageJsonKeys.TEMPLATES_VERSION]: smiTemplateVersion
@@ -192,7 +164,7 @@ node_modules/
   });
 
   // initialize it as npm package
-  await exec('npm', 'init', '-y');
+  await exec(args.cwd, 'npm', 'init', '-y');
 
   // install used smi-serve to allow dev
   // await exec('npm', 'install', '--save-dev', '@ordergroove/smi-serve');

package/src/login.js

@@ -0,0 +1,102 @@
+const http = require('http');
+const { open, getNetFreePort, isValidToken } = require('./utils');
+
+async function login(args) {
+  /* eslint-disable no-async-promise-executor */
+  return await new Promise(async (resolveAuth, rejectAuth) => {
+    const port = await getNetFreePort();
+
+    let server;
+
+    const sockets = new Set();
+    /**
+     * Forcefully terminates HTTP server.
+     */
+    const terminateServer = () => {
+      clearTimeout(authRejectTimeout);
+      return new Promise((resolve, reject) => {
+        [...sockets].forEach(socket => {
+          socket.destroy();
+          sockets.delete(socket);
+        });
+
+        server.close(err => {
+          process.nextTick(() => {
+            if (err) {
+              reject(err);
+            } else {
+              resolve();
+            }
+          });
+        });
+      });
+    };
+
+    async function requestListener(req, res) {
+      if (req.method === 'POST' && req.headers['content-type'] === 'application/x-www-form-urlencoded') {
+        let body = '';
+
+        req.on('data', chunk => {
+          body += chunk.toString();
+        });
+
+        req.on('end', async () => {
+          const params = new URLSearchParams(body);
+          const token = params.get('token');
+
+          if (!isValidToken(token)) {
+            res.writeHead(400);
+            res.end('Invalid request\n');
+            return;
+          }
+
+          resolveAuth(token);
+
+          res.writeHead(302, { Location: getRC3Url(args) });
+          res.end();
+          await terminateServer();
+        });
+      } else {
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end('Invalid request\n');
+      }
+    }
+
+    server = http.createServer(requestListener);
+    server.on('connection', socket => {
+      sockets.add(socket);
+
+      server.once('close', () => {
+        sockets.delete(socket);
+      });
+    });
+
+    server.listen(port, '127.0.0.1', () => {
+      const loginUrl = `${getRC3Url(args)}?${new URLSearchParams([
+        ['login_redirect', `http://localhost:${port}`],
+        ['sm_local_dev', 'true']
+      ])}`;
+      console.log('A browser window has been opened to Ordergroove. Please log in through your browser to continue.');
+      console.log(`Browsing ${loginUrl}`);
+      open(loginUrl);
+    });
+
+    // terminate the program after 5 minutes waiting for auth.
+    const authRejectTimeout = setTimeout(
+      () => {
+        rejectAuth(new Error('Auth timeout'));
+      },
+      5 * 60 * 1000
+    );
+  });
+}
+
+exports.login = login;
+
+function getRC3Url({ env }) {
+  if (env.startsWith('st')) return `https://rc3.stg.ordergroove.com/`;
+  if (env.startsWith('l')) return `http://0.0.0.0:3000/`;
+  return `https://rc3.ordergroove.com/`;
+}
+
+exports.getRC3Url = getRC3Url;

package/src/partials/index.html

@@ -1,6 +1,6 @@
 <html>
   <head>
-    <title>SMI Demo Page</title>
+    <title>Subscription Manager Demo Page</title>
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <link rel="stylesheet" href="/main.css" />

package/src/serve.js

@@ -20,7 +20,7 @@ async function getGlobals(argv) {
     hmacAuth = customer && [customer.merchant_user_id, customer.ts, customer.hash].join('|');
   }
 
-  const packageJson = readPackageJson();
+  const packageJson = readPackageJson(getcwd(argv));
   const smiCoreVersion = packageJson[packageJsonKeys.OG_SECTION]?.[packageJsonKeys.CORE_VERSION] || 'latest';
 
   return {
@@ -31,20 +31,21 @@ async function getGlobals(argv) {
   };
 }
 
-const smiDevModePlugin = globals => {
+const smiDevModePlugin = (globals, args) => {
+  const cwd = getcwd(args);
   /** @type {import('esbuild').Plugin} */
   const plugin = {
     name: 'resolve_smi_templates',
     setup(build) {
       build.onLoad({ filter: /main\.liquid/ }, async () => {
         // load only liquid,js,json files (less files are handled by lessPlugin)
-        const files = await glob(`${getcwd()}/**/*.{liquid,json,js}`, {
+        const files = await glob(`${cwd}/**/*.{liquid,json,js}`, {
           ignore: ['**/node_modules/**', 'node_modules/**']
         });
 
         const fileList = await Promise.all(
           files.map(async file => ({
-            name: file.substring(getcwd().length),
+            name: file.substring(cwd.length),
             content: await fs.promises.readFile(file, 'utf8').catch(() => '')
           }))
         );
@@ -77,7 +78,7 @@ const smiDevModePlugin = globals => {
       build.onResolve({ filter: /^~\// }, args => {
         return build.resolve(args.path.replace('~/', './'), {
           kind: 'import-statement',
-          resolveDir: getcwd()
+          resolveDir: cwd
         });
       });
     }
@@ -93,12 +94,13 @@ async function serve(argv) {
   const [mainLess] = await glob('**/main.@(less|css)');
 
   if (!mainLiquid) {
-    throw new Error('main.liquid not found, please create a main.liquid file under src/views/main.liquid');
+    throw new Error('You need a main.liquid file in the /views folder to run the Subscription Manager.');
   }
 
-  fs.mkdirSync(path.join(getcwd(), outdir), { recursive: true });
+  const cwd = getcwd(argv);
+  fs.mkdirSync(path.join(cwd, outdir), { recursive: true });
 
-  const smiIndexFile = path.join(getcwd(), outdir, 'index.html');
+  const smiIndexFile = path.join(cwd, outdir, 'index.html');
   const smiIndexSource = fs.readFileSync(`${__dirname}/partials/index.html`, 'utf8');
   fs.writeFileSync(smiIndexFile, smiIndexSource, { encoding: 'utf8' });
 
@@ -110,7 +112,7 @@ async function serve(argv) {
     entryNames: '[name]',
 
     logLevel: verbose ? 'verbose' : 'error',
-    nodePaths: [path.join(getcwd(), 'node_modules')],
+    nodePaths: [path.join(cwd, 'node_modules')],
     format: 'esm',
     globalName: 'smiTemplate',
     loader: {
@@ -120,12 +122,12 @@ async function serve(argv) {
     legalComments: 'none',
     sourcemap: true,
 
-    outdir: path.join(getcwd(), outdir),
-    plugins: [smiDevModePlugin(globals), lessLoader()]
+    outdir: path.join(cwd, outdir),
+    plugins: [smiDevModePlugin(globals, argv), lessLoader()]
   };
 
   if (!mainLess) {
-    console.warn('styles not found, you can create a main.less file under src/styles/main.less');
+    console.warn('No styles found. To apply CSS, create a main.less file inside the /styles folder.');
   }
 
   const ctx = await esbuild.context(buildConf);
@@ -133,8 +135,7 @@ async function serve(argv) {
   await ctx.watch();
 
   const { port: actualPort, host: actualHost } = await ctx.serve({
-    servedir: path.join(getcwd(), outdir),
-    // host,
+    servedir: path.join(cwd, outdir),
     port
   });
 
@@ -149,7 +150,7 @@ async function serve(argv) {
   const text = await esbuild.analyzeMetafile(result.metafile, {
     verbose: true
   });
-  fs.writeFileSync(path.join(getcwd(), outdir, 'bundle-report.html'), `<pre id="esbuild-metadata">${text}</pre>`);
+  fs.writeFileSync(path.join(cwd, outdir, 'bundle-report.html'), `<pre id="esbuild-metadata">${text}</pre>`);
 
   return result;
 }

package/src/utils.js

@@ -10,8 +10,8 @@ const fetch = require('node-fetch');
 
 exports.glob = util.promisify(require('glob'));
 
-function getcwd() {
-  return process.cwd();
+function getcwd(argv) {
+  return path.join(process.cwd(), argv.cwd);
 }
 
 exports.getcwd = getcwd;
@@ -50,9 +50,11 @@ exports.open = function open(loginUrl) {
  * @param  {...any} args
  * @returns
  */
-exports.exec = async function exec(cmd, ...args) {
+exports.exec = async function exec(cwd, cmd, ...args) {
   return new Promise((resolve, reject) => {
-    const child = spawn(cmd, args);
+    const child = spawn(cmd, args, {
+      cwd
+    });
     const stdout = '';
     const stderr = '';
 
@@ -94,9 +96,10 @@ exports.unzip = async function unzip(zipFilePath, outdir) {
 };
 
 async function readRc(args) {
-  if (fs.existsSync(args.configFile)) {
+  const configPath = path.join(args.cwd, args.configFile);
+  if (fs.existsSync(configPath)) {
     try {
-      const source = await fs.promises.readFile(args.configFile, 'utf8');
+      const source = await fs.promises.readFile(configPath, 'utf8');
       return JSON.parse(source);
     } catch (err) {
       console.error(err);
@@ -114,7 +117,7 @@ exports.readRcEnv = readRcEnv;
 
 async function writeRc(args, settings) {
   await fs.promises.writeFile(
-    args.configFile,
+    path.join(args.cwd, args.configFile),
     JSON.stringify(
       {
         ...(await readRc(args)),
@@ -134,9 +137,9 @@ async function writeRcEnv(args, settings) {
 
 exports.writeRcEnv = writeRcEnv;
 
-function readPackageJson() {
+function readPackageJson(cwd) {
   try {
-    const packageJson = fs.readFileSync(path.join(getcwd(), 'package.json'), 'utf8');
+    const packageJson = fs.readFileSync(path.join(cwd, 'package.json'), 'utf8');
     return JSON.parse(packageJson);
   } catch {
     return {};