@quilted/create 0.1.68 → 0.1.69

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @quilted/create
 
+## 0.1.69
+
+### Patch Changes
+
+- [`741949fa`](https://github.com/lemonmade/quilt/commit/741949faf946b7d98150c48c29310ffd74ab2e27) Thanks [@lemonmade](https://github.com/lemonmade)! - Add service template
+
 ## 0.1.68
 
 ### Patch Changes

package/build/cjs/cli.cjs

@@ -23,7 +23,7 @@ var index$1 = require('./node_modules/.pnpm/colorette@2.0.19/node_modules/colore
 
 /* eslint no-console: off */
 
-const VALID_PROJECT_KINDS = new Set(['app', 'package', 'module']);
+const VALID_PROJECT_KINDS = new Set(['app', 'package', 'module', 'service']);
 run().catch(error => {
   if (AbortError.AbortError.test(error)) return;
   console.error(error);
@@ -68,6 +68,9 @@ async function run() {
       }, {
         title: 'Package',
         value: 'package'
+      }, {
+        title: 'Backend service',
+        value: 'service'
       }]
     });
   }
@@ -96,5 +99,13 @@ async function run() {
         await createProject();
         break;
       }
+    case 'service':
+      {
+        const {
+          createService
+        } = await Promise.resolve().then(function () { return require('./service.cjs'); });
+        await createService();
+        break;
+      }
   }
 }

package/build/cjs/module.cjs

@@ -76,7 +76,7 @@ async function createModule() {
     root: directory
   });
   const partOfMonorepo = inWorkspace || createAsMonorepo;
-  const moduleDirectory = createAsMonorepo ? path__namespace.join(directory, 'app') : directory;
+  const moduleDirectory = createAsMonorepo ? path__namespace.join(directory, shared.toValidPackageName(name)) : directory;
   if (fs__namespace.existsSync(directory)) {
     await shared.emptyDirectory(directory);
     if (moduleDirectory !== directory) {

package/build/cjs/node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.cjs

@@ -200,6 +200,6 @@ arg.ArgError = ArgError;
 
 var arg_1 = arg;
 
-var parseArguments = /*@__PURE__*/_commonjsHelpers.getDefaultExportFromCjs(arg_1);
+var arg$1 = /*@__PURE__*/_commonjsHelpers.getDefaultExportFromCjs(arg_1);
 
-exports["default"] = parseArguments;
+exports["default"] = arg$1;

package/build/cjs/service.cjs

@@ -0,0 +1,298 @@
+'use strict';
+
+var fs = require('node:fs');
+var path = require('node:path');
+var index$1 = require('./node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.cjs');
+var index = require('./node_modules/.pnpm/colorette@2.0.19/node_modules/colorette/index.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/TemplateTag/TemplateTag.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/commaLists/commaLists.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/commaListsAnd/commaListsAnd.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/commaListsOr/commaListsOr.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/html/html.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/safeHtml/safeHtml.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/oneLine/oneLine.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/oneLineTrim/oneLineTrim.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/oneLineCommaLists/oneLineCommaLists.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/oneLineCommaListsOr/oneLineCommaListsOr.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/oneLineCommaListsAnd/oneLineCommaListsAnd.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/inlineLists/inlineLists.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/oneLineInlineLists/oneLineInlineLists.cjs');
+var stripIndent = require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/stripIndent/stripIndent.cjs');
+require('./node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/stripIndents/stripIndents.cjs');
+var help = require('./help.cjs');
+var shared = require('./shared.cjs');
+var prompts = require('./shared/prompts.cjs');
+var tsconfig = require('./shared/tsconfig.cjs');
+var packageManager = require('./shared/package-manager.cjs');
+var prompt = require('./packages/cli-kit/source/prompt.cjs');
+
+function _interopNamespaceDefault(e) {
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n["default"] = e;
+  return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
+
+async function createService() {
+  const argv = getArgv();
+  if (argv['--help']) {
+    help.printHelp({
+      kind: 'service',
+      packageManager: argv['--package-manager']?.toLowerCase()
+    });
+    return;
+  }
+  const inWorkspace = await prompts.getInWorkspace(argv);
+  const name = await getName(argv);
+  const directory = await getDirectory(argv, {
+    name
+  });
+  const entry = await getEntry(argv, {
+    name
+  });
+  const createAsMonorepo = !inWorkspace && (await prompts.getCreateAsMonorepo(argv, {
+    type: 'service',
+    default: false
+  }));
+  const setupExtras = await prompts.getExtrasToSetup(argv, {
+    inWorkspace
+  });
+  const shouldInstall = await prompts.getShouldInstall(argv);
+  const packageManager$1 = await prompts.getPackageManager(argv, {
+    root: directory
+  });
+  const partOfMonorepo = inWorkspace || createAsMonorepo;
+  const serviceDirectory = createAsMonorepo ? path__namespace.join(directory, shared.toValidPackageName(name)) : directory;
+  if (fs__namespace.existsSync(directory)) {
+    await shared.emptyDirectory(directory);
+    if (serviceDirectory !== directory) {
+      fs__namespace.mkdirSync(serviceDirectory, {
+        recursive: true
+      });
+    }
+  } else {
+    fs__namespace.mkdirSync(serviceDirectory, {
+      recursive: true
+    });
+  }
+  const rootDirectory = inWorkspace ? process.cwd() : directory;
+  const outputRoot = shared.createOutputTarget(rootDirectory);
+  const serviceTemplate = shared.loadTemplate('service-basic');
+  const workspaceTemplate = shared.loadTemplate('workspace');
+
+  // If we aren’t already in a workspace, copy the workspace files over, which
+  // are needed if we are making a monorepo or not.
+  if (!inWorkspace) {
+    await workspaceTemplate.copy(directory, file => {
+      // When this is a single project, we use the project’s Quilt  configuration as the base.
+      if (file === 'quilt.workspace.ts') return createAsMonorepo;
+
+      // We need to make some adjustments to the root package.json
+      if (file === 'package.json') return false;
+      return true;
+    });
+
+    // If we are creating a monorepo, we need to add the root package.json and
+    // package manager workspace configuration.
+    if (createAsMonorepo) {
+      const serviceRelativeToRoot = shared.relativeDirectoryForDisplay(path__namespace.relative(directory, serviceDirectory));
+      const workspacePackageJson = JSON.parse(await workspaceTemplate.read('package.json'));
+      workspacePackageJson.name = shared.toValidPackageName(name);
+      workspacePackageJson.workspaces = [serviceRelativeToRoot, './packages/*'];
+      if (packageManager$1.type === 'pnpm') {
+        await outputRoot.write('pnpm-workspace.yaml', await shared.format(`
+              packages:
+              - '${serviceRelativeToRoot}'
+              - './packages/*'
+            `, {
+          as: 'yaml'
+        }));
+      }
+      await outputRoot.write('package.json', await shared.format(JSON.stringify(workspacePackageJson), {
+        as: 'json-stringify'
+      }));
+    } else {
+      const [projectPackageJson, projectTSConfig, workspacePackageJson] = await Promise.all([serviceTemplate.read('package.json').then(content => JSON.parse(content)), serviceTemplate.read('tsconfig.json').then(content => JSON.parse(content)), workspaceTemplate.read('package.json').then(content => JSON.parse(content))]);
+      const combinedPackageJson = shared.mergeWorkspaceAndProjectPackageJsons(projectPackageJson, workspacePackageJson);
+      adjustPackageJson(combinedPackageJson, {
+        name,
+        entry
+      });
+      delete combinedPackageJson.workspaces;
+      let quiltProject = await serviceTemplate.read('quilt.project.ts');
+      quiltProject = quiltProject.replace('quiltService', 'quiltWorkspace, quiltService').replace('quiltService(', 'quiltWorkspace(), quiltService(').replace('service.ts', entry.replace(/^\.[/]/, ''));
+      await outputRoot.write('quilt.project.ts', await shared.format(quiltProject, {
+        as: 'typescript'
+      }));
+      await outputRoot.write('package.json', await shared.format(JSON.stringify(combinedPackageJson), {
+        as: 'json-stringify'
+      }));
+      await outputRoot.write('tsconfig.json', await shared.format(JSON.stringify(projectTSConfig), {
+        as: 'json'
+      }));
+    }
+    if (setupExtras.has('github')) {
+      await shared.loadTemplate('github').copy(directory);
+    }
+    if (setupExtras.has('vscode')) {
+      await shared.loadTemplate('vscode').copy(directory);
+    }
+  }
+  await serviceTemplate.copy(serviceDirectory, file => {
+    // If we are in a monorepo, we can use all the template files as they are
+    if (file === 'tsconfig.json') {
+      return partOfMonorepo;
+    }
+
+    // We will adjust the entry file and quilt project file
+    if (file === 'service.ts' || file === 'quilt.project.ts') {
+      return false;
+    }
+
+    // We need to make some adjustments the project’s package.json
+    return file !== 'package.json';
+  });
+  await outputRoot.write(path__namespace.join(serviceDirectory, entry), await serviceTemplate.read('service.ts'));
+  let quiltProject = await serviceTemplate.read('quilt.project.ts');
+  quiltProject = quiltProject.replace('service.ts', entry.replace(/^\.[/]/, ''));
+  await outputRoot.write(path__namespace.join(serviceDirectory, 'quilt.project.ts'), await shared.format(quiltProject, {
+    as: 'typescript'
+  }));
+  if (partOfMonorepo) {
+    // Write the app’s package.json (the root one was already created)
+    const projectPackageJson = JSON.parse(await serviceTemplate.read('package.json'));
+    adjustPackageJson(projectPackageJson, {
+      name,
+      entry
+    });
+    await outputRoot.write(path__namespace.join(serviceDirectory, 'package.json'), await shared.format(JSON.stringify(projectPackageJson), {
+      as: 'json-stringify'
+    }));
+    await Promise.all([tsconfig.addToTsConfig(serviceDirectory, outputRoot), packageManager.addToPackageManagerWorkspaces(serviceDirectory, outputRoot, packageManager$1.type)]);
+  }
+  if (shouldInstall) {
+    console.log();
+    // TODO: better loading, handle errors
+    await packageManager$1.install();
+  }
+  const commands = [];
+  if (!inWorkspace && directory !== process.cwd()) {
+    commands.push(`cd ${index.cyan(shared.relativeDirectoryForDisplay(path__namespace.relative(process.cwd(), directory)))} ${index.dim('# Move into your new service’s directory')}`);
+  }
+  if (!shouldInstall) {
+    commands.push(`${packageManager$1.commands.install()} ${index.dim('# Install all your dependencies')}`);
+  }
+  if (commands.length === 0) {
+    console.log();
+    console.log('Your new service is ready to go!');
+  } else {
+    const whatsNext = stripIndent["default"]`
+      Your new service is ready to go! There’s just ${commands.length > 1 ? 'a few more steps' : 'one more step'} you’ll need to take
+      in order to start developing:
+    `;
+    console.log();
+    console.log(whatsNext);
+    console.log();
+    console.log(commands.map(command => `  ${command}`).join('\n'));
+  }
+  const followUp = stripIndent["default"]`
+    Quilt can also help you build, develop, test, lint, and type-check your new service.
+    You can learn more about building services with Quilt by reading the documentation:
+    ${index.underline(index.magenta('https://github.com/lemonmade/quilt/tree/main/documentation'))}
+
+    Have fun! 🎉
+  `;
+  console.log();
+  console.log(followUp);
+}
+
+// Argument handling
+
+function getArgv() {
+  const argv = index$1["default"]({
+    '--yes': Boolean,
+    '-y': '--yes',
+    '--name': String,
+    '--directory': String,
+    '--entry': String,
+    '--install': Boolean,
+    '--no-install': Boolean,
+    '--monorepo': Boolean,
+    '--no-monorepo': Boolean,
+    '--package-manager': String,
+    '--extras': [String],
+    '--no-extras': Boolean,
+    '--help': Boolean,
+    '-h': '--help'
+  }, {
+    permissive: true
+  });
+  return argv;
+}
+async function getName(argv) {
+  let {
+    '--name': name
+  } = argv;
+  if (name == null) {
+    name = await prompt.prompt({
+      type: 'text',
+      message: 'What would you like to name your new service?',
+      initial: 'my-service'
+    });
+  }
+  return name;
+}
+async function getEntry(argv, {
+  name
+}) {
+  if (argv['--entry']) {
+    return argv['--entry'];
+  }
+  return `${shared.toValidPackageName(name)}.ts`;
+}
+async function getDirectory(argv, {
+  name
+}) {
+  let directory = path__namespace.resolve(argv['--directory'] ?? shared.toValidPackageName(name));
+  while (!argv['--yes']) {
+    if (fs__namespace.existsSync(directory) && !(await shared.isEmpty(directory))) {
+      const relativeDirectory = path__namespace.relative(process.cwd(), directory);
+      const empty = await prompt.prompt({
+        type: 'confirm',
+        message: `Directory ${index.bold(shared.relativeDirectoryForDisplay(relativeDirectory))} is not empty, is it safe to empty it?`,
+        initial: true
+      });
+      if (empty) break;
+      const promptDirectory = await prompt.prompt({
+        type: 'text',
+        message: 'What directory do you want to create your new service in?'
+      });
+      directory = path__namespace.resolve(promptDirectory);
+    } else {
+      break;
+    }
+  }
+  return directory;
+}
+function adjustPackageJson(packageJson, {
+  name
+}) {
+  packageJson.name = name;
+  packageJson.main = `./build/runtime/runtime.js`;
+  return packageJson;
+}
+
+exports.createService = createService;

package/build/esm/app.mjs

@@ -1,6 +1,6 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import parseArguments from './node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.mjs';
+import arg from './node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.mjs';
 import { cyan as cyan_1, bold as bold_1, dim as dim_1, underline as underline_1, magenta as magenta_1 } from './node_modules/.pnpm/colorette@2.0.19/node_modules/colorette/index.mjs';
 import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/TemplateTag/TemplateTag.mjs';
 import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/commaLists/commaLists.mjs';
@@ -207,7 +207,7 @@ async function createApp() {
 // Argument handling
 
 function getArgv() {
-  const argv = parseArguments({
+  const argv = arg({
     '--yes': Boolean,
     '-y': '--yes',
     '--name': String,

package/build/esm/cli.mjs

@@ -1,6 +1,6 @@
 import { printHelp } from './help.mjs';
 import { AbortError } from './packages/events/source/abort/AbortError.mjs';
-import parseArguments from './node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.mjs';
+import arg from './node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.mjs';
 import stripIndent from './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/stripIndent/stripIndent.mjs';
 import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/TemplateTag/TemplateTag.mjs';
 import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/commaLists/commaLists.mjs';
@@ -21,14 +21,14 @@ import { bold as bold_1 } from './node_modules/.pnpm/colorette@2.0.19/node_modul
 
 /* eslint no-console: off */
 
-const VALID_PROJECT_KINDS = new Set(['app', 'package', 'module']);
+const VALID_PROJECT_KINDS = new Set(['app', 'package', 'module', 'service']);
 run().catch(error => {
   if (AbortError.test(error)) return;
   console.error(error);
   process.exitCode = 1;
 });
 async function run() {
-  const permissiveArgs = parseArguments({
+  const permissiveArgs = arg({
     '--help': Boolean,
     '-h': '--help',
     '--package-manager': String
@@ -66,6 +66,9 @@ async function run() {
       }, {
         title: 'Package',
         value: 'package'
+      }, {
+        title: 'Backend service',
+        value: 'service'
       }]
     });
   }
@@ -94,5 +97,13 @@ async function run() {
         await createProject();
         break;
       }
+    case 'service':
+      {
+        const {
+          createService
+        } = await import('./service.mjs');
+        await createService();
+        break;
+      }
   }
 }

package/build/esm/module.mjs

@@ -1,6 +1,6 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import parseArguments from './node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.mjs';
+import arg from './node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.mjs';
 import { cyan as cyan_1, dim as dim_1, underline as underline_1, magenta as magenta_1, bold as bold_1 } from './node_modules/.pnpm/colorette@2.0.19/node_modules/colorette/index.mjs';
 import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/TemplateTag/TemplateTag.mjs';
 import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/commaLists/commaLists.mjs';
@@ -18,7 +18,7 @@ import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/oneLi
 import stripIndent from './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/stripIndent/stripIndent.mjs';
 import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/stripIndents/stripIndents.mjs';
 import { printHelp } from './help.mjs';
-import { emptyDirectory, relativeDirectoryForDisplay, toValidPackageName, format, mergeWorkspaceAndProjectPackageJsons, loadTemplate, isEmpty, createOutputTarget } from './shared.mjs';
+import { toValidPackageName, emptyDirectory, relativeDirectoryForDisplay, format, mergeWorkspaceAndProjectPackageJsons, loadTemplate, isEmpty, createOutputTarget } from './shared.mjs';
 import { getInWorkspace, getCreateAsMonorepo, getExtrasToSetup, getShouldInstall, getPackageManager } from './shared/prompts.mjs';
 import { addToTsConfig } from './shared/tsconfig.mjs';
 import { addToPackageManagerWorkspaces } from './shared/package-manager.mjs';
@@ -54,7 +54,7 @@ async function createModule() {
     root: directory
   });
   const partOfMonorepo = inWorkspace || createAsMonorepo;
-  const moduleDirectory = createAsMonorepo ? path.join(directory, 'app') : directory;
+  const moduleDirectory = createAsMonorepo ? path.join(directory, toValidPackageName(name)) : directory;
   if (fs.existsSync(directory)) {
     await emptyDirectory(directory);
     if (moduleDirectory !== directory) {
@@ -201,7 +201,7 @@ async function createModule() {
 // Argument handling
 
 function getArgv() {
-  const argv = parseArguments({
+  const argv = arg({
     '--yes': Boolean,
     '-y': '--yes',
     '--name': String,

package/build/esm/node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.mjs

@@ -196,6 +196,6 @@ arg.ArgError = ArgError;
 
 var arg_1 = arg;
 
-var parseArguments = /*@__PURE__*/getDefaultExportFromCjs(arg_1);
+var arg$1 = /*@__PURE__*/getDefaultExportFromCjs(arg_1);
 
-export { parseArguments as default };
+export { arg$1 as default };

package/build/esm/package.mjs

@@ -20,7 +20,7 @@ import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/oneLi
 import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/inlineLists/inlineLists.mjs';
 import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/oneLineInlineLists/oneLineInlineLists.mjs';
 import './node_modules/.pnpm/common-tags@1.8.2/node_modules/common-tags/es/stripIndents/stripIndents.mjs';
-import parseArguments from './node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.mjs';
+import arg from './node_modules/.pnpm/arg@5.0.2/node_modules/arg/index.mjs';
 import { prompt } from './packages/cli-kit/source/prompt.mjs';
 import { cyan as cyan_1, dim as dim_1, bold as bold_1, underline as underline_1, magenta as magenta_1 } from './node_modules/.pnpm/colorette@2.0.19/node_modules/colorette/index.mjs';
 
@@ -276,7 +276,7 @@ async function createProject() {
 // Argument handling
 
 function getArguments() {
-  const args = parseArguments({
+  const args = arg({
     '--yes': Boolean,
     '-y': '--yes',
     '--name': String,