@ordergroove/smi-serve 1.7.4 → 1.8.0

package/CHANGELOG.md

@@ -3,6 +3,31 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [1.8.0](https://github.com/ordergroove/plush-toys/compare/@ordergroove/smi-serve@1.7.5...@ordergroove/smi-serve@1.8.0) (2024-04-25)
+
+
+### Bug Fixes
+
+* default to latest template if configs not found ([cf94386](https://github.com/ordergroove/plush-toys/commit/cf943860ac1738e1ba8196efdd11769654ba2dc1))
+* do not crash dev server on error ([7742204](https://github.com/ordergroove/plush-toys/commit/7742204b14fb9ae9ecfff46b9773f12e524f4390))
+
+
+### Features
+
+* allow running smi-serve on local smi-templates ([c1bf5f7](https://github.com/ordergroove/plush-toys/commit/c1bf5f7002afc1284e65daa79b46acfc1fc97887))
+
+
+
+
+
+## [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)
 
 

package/LOCAL_DEV.md

@@ -0,0 +1,27 @@
+This document contains instructions for development of the smi-serve tool itself, since the main README.md is intended for external users of the tool.
+
+## Testing changes to smi-serve
+
+Inside the `/packages/smi-serve` directory in plush-toys, run `npm link`. This should make your local version of the package available across your system.
+
+In a new directory outside of plush-toys, run `npx @ordergroove/smi-serve init` or whatever command you want to test. This should use your local version of smi-serve. You can verify that it is working correctly by adding a console.log message inside `smi-serve.js`. You can also verify by running `npm ls --global @ordergroove/smi-serve` - it should point to your local plush-toys directory:
+
+```
+/Users/username/node/v18.18.2/lib
+└── @ordergroove/smi-serve@1.7.5 -> ./../../../../../code/plush-toys/packages/smi-serve
+```
+
+## Unlinking smi-serve
+
+If you want to use the published version of the package instead, you will need to uninstall the package globally. Since smi-serve is not added as a project dependency, it is installed in the global npm scope.
+
+To remove the link to your local package, run `npm uninstall @ordergroove/smi-serve -g`. You can verify that the command succeeded by running `npm ls --global @ordergroove/smi-serve`. It should show something like:
+
+```
+/Users/username/node/v18.18.2/lib
+└── (empty)
+```
+
+## Debugging
+
+After linking to your local version of smi-serve, you can debug the tool inside VS Code. First, add a `debugger` statement inside the smi-serve code you are running. Then, inside your test project directory, open the [JavaScript debug terminal](https://code.visualstudio.com/docs/nodejs/nodejs-debugging#_javascript-debug-terminal) and run the command you want to debug. VS Code's debugger should launch and automatically break when it gets to that statement. You can then set breakpoints in the code and inspect the running process.

package/README.md

@@ -1,73 +1,66 @@
 # @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.
+
+## Getting started
 
-## Usage
+To initialize the current directory for local Subscription Manager development, run `npx @ordergroove/smi-serve init`. This will authenticate you with Ordergroove, retrieve your current Subscription Manager assets, and start a dev server.
 
-To use `smi-serve` via `npx`, follow the instructions below:
+After initialization, you can restart the dev server with `npx @ordergroove/smi-serve`.
 
-### 1\. Initialization
+When you are ready to push your changes to production, run `npx @ordergroove/smi-serve deploy` to deploy your changes to Ordergroove.
 
-To initialize the current directory with assets from Ordergroove RC3 and start the development server, use:
+## Configuration file
 
-`npx @ordergroove/smi-serve init`
+This tool generates a `.ogrc.json` file to store authentication information. This file should not be committed to source control.
 
-This command initializes the current directory with assets from Ordergroove RC3 and starts a development server for serving the initialized assets. Any initialization errors will be displayed.
-Options:
+## Command reference
 
-- `-y` Answer all prompts as yes and silent the prompts
-- `--force` or `-f` Force override local files if present
+You can run each command with `npx @ordergroove/smi-serve [command]`, e.g. `npx @ordergroove/smi-serve init`.
 
-### 2\. Start the Development Server
+To see all available commands and flags, run `npx @ordergroove/smi-serve --help`. For documentation specific to individual commands, run `npx @ordergroove/smi-serve [command] --help`.
 
-If no command is specified, the default behavior is to start the development server. This can also be explicitly invoked using:
+### init
 
-`npx @ordergroove/smi-serve serve`
+Initializes the current directory with the assets from your live Subscription Manager theme and starts a dev server. This only needs to be run when you need to retrieve the latest assets from Ordergroove; otherwise you can start the dev server directly with `npx @ordergroove/smi-serve serve`.
 
-This command starts the development server and serves assets. The server's behavior can be modified using various options.
+### serve
 
-### 3\. Deploy Changes to Ordergroove
+Starts a development server. This is the default command, so it can also be run by entering `npx @ordergroove/smi-serve`.
 
-To deploy changes to Ordergroove, use the deploy command:
+By default it will choose a random available port, but you can customize this with the `--port` flag.
 
-`npx @ordergroove/smi-serve deploy`
+### deploy
 
-This command deploys changes to Ordergroove based on the configured settings. Ensure you have the necessary authentication and configuration set up.
+Publishes your template changes to your live Subscription Manager theme. Before publishing, it will summarize which files have changed and ask for confirmation.
 
-### 4\. Select a new merchant
+### select-merchant
 
-If you have access to multiple merchants, you can use the `select-merchant` command to switch to a new merchant. This can be useful if you manage multiple merchant accounts and would like to deploy changes from one merchant to another merchant.
+If you have access to multiple merchants, this lets you select a new merchant to be used by the other commands. This can be useful if you manage multiple merchant accounts.
 
-`npx @ordergroove/smi-serve select-merchant`
+## FAQs
 
-This command allows you to select a new merchant from those available with your Ordergroove credentials.
+### How do I run commands against Ordergroove's staging environment?
 
-#### Options
+You can use the flag `--env staging` to make requests against Ordergroove's staging environment. For example, run `npx @ordergroove/smi-serve init --env staging` to initialize with assets from staging.
 
-You can use a configuration file (.ogrc.json by default) to store settings from the command line. The following option is available:
+Keep in mind that if you use this flag, _every command_ you run must also include it.
 
---configFile or -c: Specify the path to the Ordergroove configuration file. Defaults to .ogrc.json.
+### How do I integrate with source control?
 
-This config is auto generated when you login and placed into the current working directory.
+Once you run the `init` command, you can initialize the folder as a Git repository with `git init` and push to the source control provider of your choice. When you are ready to deploy the changes, run `npx @ordergroove/smi-serve deploy`.
 
----
+Make sure to commit the autogenerated `.gitignore`, which prevents you from committing the `.ogrc.json` file to source control. The `ogrc` file contains authentication tokens and should not be committed.
 
-The program provides several options to customize its behavior:
+### How do I merge in updates that have been made via the Subscription Manager editor in RC3?
 
-- `--verbose` or `-v`: Enable verbose logging.
-- `--outdir` or `-o`: Specify the output directory for build artifacts. Defaults to `node_modules/.smi-serve-build`.
-- `--port` or `-p`: Specify the HTTP port for the development server. Defaults to an available free port.
-- `--env` or `-e`: Specify the Ordergroove environment: prod or staging. Defaults to prod.
-- `--impersonate` or `-i`: Enable customer impersonation.
+Ordergroove regularly makes updates to its Subscription Manager templates to fix bugs and add new features. To compare the latest changes with your current template files, first initialize the repo with a source control provider like Git and commit your current template files. You can then re-run the `init` command with the `-f` flag to overwrite your files with the latest Subscription Manager template. Use Git's diff tools to compare what has changed and add back any customizations as necessary.
 
-Example usage with options:
+## Limitations
 
-`npx @ordergroove/smi-serve serve --verbose --port 8080 --production`
+- smi-serve only reads and writes from your currently published Subscription Manager theme. Draft themes are not currently supported.
+- SSO users and My Organization admins are not currently supported.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ordergroove/smi-serve",
-  "version": "1.7.4",
-  "description": "Utility to serve a SMI template locally",
+  "version": "1.8.0",
+  "description": "Utility to serve a Subscription Manager template locally",
   "keywords": [],
   "author": "Eugenio Lattanzio <eugenio.lattanzio@ordergroove.com>",
   "license": "ISC",
@@ -35,5 +35,5 @@
   "devDependencies": {
     "memfs": "^4.8.2"
   },
-  "gitHead": "150aa71aa473d76c6738352fafef37970aab7e36"
+  "gitHead": "3e6249c8cad48b89a413586ebfcbd82378873c1e"
 }

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) {
@@ -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,92 @@ try force fetch by using -f modifier
 }
 
 async function program() {
-  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 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: '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: '$0',
+        alias: ['serve'],
+        describe: 'Start the dev server',
+        handler: wrapHandler(initOrServe)
+      })
+      .command({
+        command: 'deploy',
+        describe: 'Publish your template changes to your live theme',
+        handler: wrapHandler(deploy)
+      })
+      .command({
+        command: 'select-merchant',
+        describe: 'Select a different Ordergroove merchant',
+        handler: wrapHandler(cliCallSelectMerchant)
+      })
+      .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'
+      })
+      .option('local-assets', {
+        type: 'boolean',
+        description: 'Use local SM packages'
+      })
+      .hide('local-assets')
+      .parse()
+  );
 }
 
 if (require.main === module) program();

package/smi-serve.spec.js

@@ -62,8 +62,8 @@ describe('smi-serve', () => {
       },
       '/package.json': {
         author: '',
-        description: 'Ordergroove SMI for test merchant on shopify platform (yum-id)}',
-        keywords: ['Ordergroove SMI', 'test merchant', 'yum-id'],
+        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',

package/src/deploy.js

@@ -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';
 
@@ -95,23 +94,32 @@ async function init(args) {
 
   let smiVersion = meta_fields?.dependencies['@ordergroove/smi-core'] || 'latest';
 
-  const { useMerchantSpecific } = args.yes
-    ? { useMerchantSpecific: true }
-    : await inquirer.prompt([
-        {
-          type: 'list',
-          name: 'useMerchantSpecific',
-          message: 'What templates do you want to initialize it with?',
-          choices: [
-            { value: true, name: `Pull "${merchant.name}" templates stored in ${getRC3Url(args)}` },
-            { value: false, name: 'Fresh install latest version of @ordergroove/smi-templates' }
-          ]
-        }
-      ]);
+  const hasConfigs = msiConfigs.smi && msiConfigs.smi.files;
+  let useMerchantSpecific = true;
+
+  if (hasConfigs) {
+    let result = args.yes
+      ? { useMerchantSpecific: true }
+      : await inquirer.prompt([
+          {
+            type: 'list',
+            name: 'useMerchantSpecific',
+            message: 'Which templates do you want to use?',
+            choices: [
+              { 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' }
+            ]
+          }
+        ]);
+    ({ useMerchantSpecific } = result);
+  } else {
+    console.log('Configs not found, defaulting to latest Subscription Manager template.');
+    useMerchantSpecific = false;
+  }
 
   let smiTemplateVersion;
 
-  if (useMerchantSpecific && msiConfigs.smi && msiConfigs.smi.files) {
+  if (useMerchantSpecific) {
     if (msiConfigs.provisioned_with && SMI_TEMPLATES_NAME in msiConfigs.provisioned_with) {
       smiTemplateVersion = msiConfigs.provisioned_with[SMI_TEMPLATES_NAME];
     }
@@ -124,8 +132,6 @@ async function init(args) {
 
     console.log('Templates initialized');
   } else {
-    console.log('Configs not found, defaulting to latest.');
-
     smiTemplateVersion = await getMerchantTemplatesVersion(smiVersion);
 
     await downloadAndExtract(
@@ -140,34 +146,6 @@ 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(
     path.join(args.cwd, '.gitignore'),
@@ -182,10 +160,10 @@ node_modules/
       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

package/src/partials/devmode.js

@@ -1,5 +1,5 @@
 // virtual JSON file containing build-time variables
-import { OG_ENV, OG_MERCHANT_ID, OG_HMAC_AUTH, OG_SMI_CORE_VERSION } from 'virtual:globals.json';
+import { OG_ENV, OG_MERCHANT_ID, OG_HMAC_AUTH, OG_SMI_CORE_VERSION, OG_LOCAL_ASSETS } from 'virtual:globals.json';
 
 const params = new URLSearchParams(window.location.search);
 
@@ -17,3 +17,5 @@ export const auth_config = params.has('auth')
     : null;
 
 export const smi_core_version = OG_SMI_CORE_VERSION;
+
+export const use_local_assets = OG_LOCAL_ASSETS;

package/src/partials/entrypoint.js

@@ -1,16 +1,18 @@
 // ~/ refers to the working directory of the project using smi-serve
 import mainTemplate from '~/views/main.liquid';
 
-import { merchant_id, auth_config, smi_core_version } from './devmode';
+import { merchant_id, auth_config, smi_core_version, use_local_assets } from './devmode';
+
+const baseUrl = use_local_assets
+  ? 'http://localhost:8080'
+  : `https://static.ordergroove.com/@ordergroove/smi-core/${smi_core_version}/dist`;
 
 // only run on initial load, not hot reload
 if (!window.og?.smi) {
   if (auth_config && merchant_id) {
-    waitForScriptToLoad(`https://static.ordergroove.com/@ordergroove/smi-core/${smi_core_version}/dist/smi.js`).then(
-      () => {
-        window.og.smi.bootstrap({ merchant_id, ...auth_config }, mainTemplate);
-      }
-    );
+    waitForScriptToLoad(`${baseUrl}/smi.js`).then(() => {
+      window.og.smi.bootstrap({ merchant_id, ...auth_config }, mainTemplate);
+    });
   } else {
     waitForScriptToLoad(`https://static.ordergroove.com/@ordergroove/smi-preview/latest/`).then(() => {
       const smiPreview = window.og['smi-preview'];

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

@@ -27,7 +27,8 @@ async function getGlobals(argv) {
     OG_MERCHANT_ID: merchant ? merchant.public_id : '',
     OG_HMAC_AUTH: hmacAuth,
     OG_ENV: argv.env,
-    OG_SMI_CORE_VERSION: smiCoreVersion
+    OG_SMI_CORE_VERSION: smiCoreVersion,
+    OG_LOCAL_ASSETS: !!argv.localAssets
   };
 }
 
@@ -50,13 +51,25 @@ const smiDevModePlugin = (globals, args) => {
           }))
         );
 
-        const contents = await precompile(fileList);
-
-        return {
-          watchFiles: files,
-          contents: `export default ${contents}`,
-          loader: 'js'
-        };
+        try {
+          const contents = await precompile(fileList);
+          return {
+            watchFiles: files,
+            contents: `export default ${contents}`,
+            loader: 'js'
+          };
+        } catch (e) {
+          return {
+            watchFiles: files,
+            errors: [
+              {
+                text: e.toString(),
+                detail: e
+              }
+            ],
+            loader: 'js'
+          };
+        }
       });
 
       // allow importing a non-existent 'virtual:globals.json' file containing build-time variables
@@ -90,14 +103,14 @@ async function serve(argv) {
   await getValidLoginAndCurrentMerchant(argv);
   const { port, outdir, verbose } = argv;
 
-  const [mainLiquid] = await glob('**/main.liquid');
-  const [mainLess] = await glob('**/main.@(less|css)');
+  const cwd = getcwd(argv);
+  const [mainLiquid] = await glob('**/main.liquid', { cwd });
+  const [mainLess] = await glob('**/main.@(less|css)', { cwd });
 
   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.');
   }
 
-  const cwd = getcwd(argv);
   fs.mkdirSync(path.join(cwd, outdir), { recursive: true });
 
   const smiIndexFile = path.join(cwd, outdir, 'index.html');
@@ -108,7 +121,7 @@ async function serve(argv) {
 
   /** @type {import('esbuild').BuildOptions} */
   const buildConf = {
-    entryPoints: [path.join(__dirname, 'partials', 'entrypoint.js'), mainLess],
+    entryPoints: [path.join(__dirname, 'partials', 'entrypoint.js'), path.join(cwd, mainLess)],
     entryNames: '[name]',
 
     logLevel: verbose ? 'verbose' : 'error',
@@ -127,7 +140,7 @@ async function serve(argv) {
   };
 
   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);
@@ -136,23 +149,10 @@ async function serve(argv) {
 
   const { port: actualPort, host: actualHost } = await ctx.serve({
     servedir: path.join(cwd, outdir),
-    // host,
     port
   });
 
   console.log(`Dev server listening on http://${actualHost}:${actualPort}`);
   open(`http://${actualHost}:${actualPort}`);
-
-  const result = await esbuild.build({
-    metafile: true,
-    ...buildConf
-  });
-
-  const text = await esbuild.analyzeMetafile(result.metafile, {
-    verbose: true
-  });
-  fs.writeFileSync(path.join(cwd, outdir, 'bundle-report.html'), `<pre id="esbuild-metadata">${text}</pre>`);
-
-  return result;
 }
 exports.serve = serve;