@cedarjs/cli-helpers 5.0.4-next.167 → 5.0.4

package/dist/cjs/auth/setupHelpers.js

@@ -0,0 +1,141 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var setupHelpers_exports = {};
+__export(setupHelpers_exports, {
+  standardAuthBuilder: () => standardAuthBuilder,
+  standardAuthHandler: () => standardAuthHandler
+});
+module.exports = __toCommonJS(setupHelpers_exports);
+var import_listr2 = require("listr2");
+var import_termi_link = require("termi-link");
+var import_telemetry = require("@cedarjs/telemetry");
+var import_colors = require("../lib/colors.js");
+var import_installHelpers = require("../lib/installHelpers.js");
+var import_authTasks = require("./authTasks.js");
+const standardAuthBuilder = (yargs) => {
+  return yargs.option("force", {
+    alias: "f",
+    default: false,
+    description: "Overwrite existing auth configuration",
+    type: "boolean"
+  }).option("verbose", {
+    alias: "v",
+    default: false,
+    description: "Log setup output",
+    type: "boolean"
+  }).epilogue(
+    `Also see the ${(0, import_termi_link.terminalLink)(
+      "CedarJS CLI Reference",
+      "https://cedarjs.com/docs/cli-commands#setup-auth"
+    )}`
+  );
+};
+function truthy(value) {
+  return !!value;
+}
+const standardAuthHandler = async ({
+  basedir,
+  forceArg,
+  provider,
+  authDecoderImport,
+  webAuthn = false,
+  webPackages = [],
+  apiPackages = [],
+  extraTasks,
+  notes,
+  verbose
+}) => {
+  const tasks = new import_listr2.Listr(
+    [
+      (0, import_authTasks.setAuthSetupMode)(forceArg),
+      (0, import_authTasks.generateAuthApiFiles)(basedir, webAuthn),
+      (0, import_authTasks.addConfigToWebApp)(),
+      (0, import_authTasks.createWebAuth)(basedir, webAuthn),
+      (0, import_authTasks.addConfigToRoutes)(),
+      (0, import_authTasks.addAuthConfigToGqlApi)(authDecoderImport),
+      webPackages.length && (0, import_installHelpers.addWebPackages)(webPackages),
+      apiPackages.length && (0, import_installHelpers.addApiPackages)(apiPackages),
+      (webPackages.length || apiPackages.length) && import_installHelpers.installPackages,
+      ...(extraTasks || []).filter(truthy),
+      notes && {
+        title: "One more thing...",
+        task: (ctx) => {
+          if (ctx.setupMode === "REPLACE") {
+            notes.push(
+              ...[
+                "",
+                `${import_colors.colors.warning(
+                  "Your existing auth provider has been replaced!"
+                )}`,
+                "You'll still need to manually remove your old auth provider's config,",
+                "functions, and dependencies (in your web and api package.json's)."
+              ]
+            );
+          }
+          if (ctx.setupMode === "COMBINE") {
+            notes.push(
+              import_colors.colors.warning(
+                `To avoid overwriting existing files we've generated new file names for the newly generated files. This probably means ${ctx.provider} auth doesn't work out of the box. You'll most likely have to manually merge some of the generated files with your existing auth files`
+              )
+            );
+          }
+        }
+      }
+    ].filter(truthy),
+    {
+      rendererOptions: { collapseSubtasks: false },
+      renderer: verbose ? "verbose" : "default",
+      ctx: {
+        setupMode: "UNKNOWN",
+        provider,
+        // provider name passed from CLI
+        force: forceArg
+      }
+    }
+  );
+  try {
+    await tasks.run();
+    if (notes) {
+      console.log(`
+   ${notes.join("\n   ")}
+`);
+    }
+  } catch (e) {
+    if (isErrorWithMessage(e)) {
+      (0, import_telemetry.errorTelemetry)(process.argv, e.message);
+      console.error(import_colors.colors.error(e.message));
+    }
+    if (isErrorWithErrorCode(e)) {
+      process.exit(e.exitCode || 1);
+    } else {
+      process.exit(1);
+    }
+  }
+};
+function isErrorWithMessage(e) {
+  return !!e.message;
+}
+function isErrorWithErrorCode(e) {
+  return !isNaN(e.exitCode);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  standardAuthBuilder,
+  standardAuthHandler
+});

package/dist/cjs/index.d.ts

@@ -0,0 +1,12 @@
+export * from './lib/index.js';
+export * from './lib/colors.js';
+export { loadEnvFiles } from './lib/loadEnvFiles.js';
+export { loadDefaultEnvFiles, loadNodeEnvDerivedEnvFile, loadUserSpecifiedEnvFiles, } from './lib/loadEnvFiles.js';
+export * from './lib/paths.js';
+export * from './lib/project.js';
+export * from './lib/version.js';
+export * from './auth/setupHelpers.js';
+export type { AuthHandlerArgs, AuthGeneratorCtx } from './auth/setupHelpers.js';
+export * from './lib/installHelpers.js';
+export * from './telemetry/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACpD,OAAO,EACL,mBAAmB,EACnB,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAA;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAChC,cAAc,kBAAkB,CAAA;AAChC,cAAc,wBAAwB,CAAA;AACtC,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAE/E,cAAc,yBAAyB,CAAA;AAEvC,cAAc,sBAAsB,CAAA"}

package/dist/cjs/index.js

@@ -0,0 +1,52 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var index_exports = {};
+__export(index_exports, {
+  loadDefaultEnvFiles: () => import_loadEnvFiles2.loadDefaultEnvFiles,
+  loadEnvFiles: () => import_loadEnvFiles.loadEnvFiles,
+  loadNodeEnvDerivedEnvFile: () => import_loadEnvFiles2.loadNodeEnvDerivedEnvFile,
+  loadUserSpecifiedEnvFiles: () => import_loadEnvFiles2.loadUserSpecifiedEnvFiles
+});
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require("./lib/index.js"), module.exports);
+__reExport(index_exports, require("./lib/colors.js"), module.exports);
+var import_loadEnvFiles = require("./lib/loadEnvFiles.js");
+var import_loadEnvFiles2 = require("./lib/loadEnvFiles.js");
+__reExport(index_exports, require("./lib/paths.js"), module.exports);
+__reExport(index_exports, require("./lib/project.js"), module.exports);
+__reExport(index_exports, require("./lib/version.js"), module.exports);
+__reExport(index_exports, require("./auth/setupHelpers.js"), module.exports);
+__reExport(index_exports, require("./lib/installHelpers.js"), module.exports);
+__reExport(index_exports, require("./telemetry/index.js"), module.exports);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadDefaultEnvFiles,
+  loadEnvFiles,
+  loadNodeEnvDerivedEnvFile,
+  loadUserSpecifiedEnvFiles,
+  ...require("./lib/index.js"),
+  ...require("./lib/colors.js"),
+  ...require("./lib/paths.js"),
+  ...require("./lib/project.js"),
+  ...require("./lib/version.js"),
+  ...require("./auth/setupHelpers.js"),
+  ...require("./lib/installHelpers.js"),
+  ...require("./telemetry/index.js")
+});

package/dist/cjs/lib/colors.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Canonical color/style palette for all Cedar CLI packages.
+ *
+ * Import from here rather than defining local copies:
+ *   import { colors } from '@cedarjs/cli-helpers'
+ *
+ * If you need a color that isn't here, add it here rather than
+ * introducing a one-off in another package.
+ */
+export declare const colors: {
+    error: import("ansis").Ansis;
+    warning: import("ansis").Ansis;
+    highlight: import("ansis").Ansis;
+    success: import("ansis").Ansis;
+    info: import("ansis").Ansis;
+    bold: import("ansis").Ansis;
+    underline: import("ansis").Ansis;
+    note: import("ansis").Ansis;
+    tip: import("ansis").Ansis;
+    important: import("ansis").Ansis;
+    caution: import("ansis").Ansis;
+    link: import("ansis").Ansis;
+};
+//# sourceMappingURL=colors.d.ts.map

package/dist/cjs/lib/colors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.d.ts","sourceRoot":"","sources":["../../../src/lib/colors.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AACH,eAAO,MAAM,MAAM;;;;;;;;;;;;;CAalB,CAAA"}

package/dist/cjs/lib/colors.js

@@ -0,0 +1,52 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var colors_exports = {};
+__export(colors_exports, {
+  colors: () => colors
+});
+module.exports = __toCommonJS(colors_exports);
+var import_ansis = __toESM(require("ansis"), 1);
+const colors = {
+  error: import_ansis.default.bold.red,
+  warning: import_ansis.default.hex("#ffa500"),
+  highlight: import_ansis.default.hex("#ffa500"),
+  success: import_ansis.default.green,
+  info: import_ansis.default.gray,
+  bold: import_ansis.default.bold,
+  underline: import_ansis.default.underline,
+  note: import_ansis.default.blue,
+  tip: import_ansis.default.green,
+  important: import_ansis.default.magenta,
+  caution: import_ansis.default.red,
+  link: import_ansis.default.underline
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  colors
+});

package/dist/cjs/lib/index.d.ts

@@ -0,0 +1,22 @@
+import type { ListrTaskWrapper, ListrRenderer } from 'listr2';
+import { Listr } from 'listr2';
+export declare const transformTSToJS: (filename: string, content: string) => string | Promise<string>;
+/**
+ * This returns the config present in `prettier.config.cjs` or
+ * `prettier.config.mjs` of a Cedar project.
+ */
+export declare const getPrettierOptions: () => Promise<any>;
+export declare const prettify: (templateFilename: string, renderedTemplate: string) => Promise<string>;
+export type ExistingFiles = 'OVERWRITE' | 'SKIP' | 'FAIL';
+export declare const writeFile: <Renderer extends typeof ListrRenderer>(target: string, contents: string, { existingFiles }?: {
+    existingFiles?: ExistingFiles;
+}, task?: ListrTaskWrapper<never, Renderer, Renderer>) => void;
+/**
+ * Creates a list of tasks that write files to the disk.
+ *
+ * @param files - {[filepath]: contents}
+ */
+export declare const writeFilesTask: <Renderer extends typeof ListrRenderer>(files: Record<string, string>, options: {
+    existingFiles: ExistingFiles;
+}) => Listr<never, Renderer, Renderer>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EAEd,MAAM,QAAQ,CAAA;AACf,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAU9B,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,SAAS,MAAM,6BA8BhE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,oBAsB9B,CAAA;AAED,eAAO,MAAM,QAAQ,GACnB,kBAAkB,MAAM,EACxB,kBAAkB,MAAM,KACvB,OAAO,CAAC,MAAM,CAwBhB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,MAAM,GAAG,MAAM,CAAA;AAEzD,eAAO,MAAM,SAAS,GAAI,QAAQ,SAAS,OAAO,aAAa,EAC7D,QAAQ,MAAM,EACd,UAAU,MAAM,EAChB,oBAA4B;IAAE,aAAa,CAAC,EAAE,aAAa,CAAA;CAAO,EAGlE,OAAM,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAI/C,SAoBF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,QAAQ,SAAS,OAAO,aAAa,EAClE,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,SAAS;IAAE,aAAa,EAAE,aAAa,CAAA;CAAE,qCAuB1C,CAAA"}

package/dist/cjs/lib/index.js

@@ -0,0 +1,147 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var lib_exports = {};
+__export(lib_exports, {
+  getPrettierOptions: () => getPrettierOptions,
+  prettify: () => prettify,
+  transformTSToJS: () => transformTSToJS,
+  writeFile: () => writeFile,
+  writeFilesTask: () => writeFilesTask
+});
+module.exports = __toCommonJS(lib_exports);
+var import_node_fs = __toESM(require("node:fs"), 1);
+var import_node_url = require("node:url");
+var import_path = __toESM(require("path"), 1);
+var babel = __toESM(require("@babel/core"), 1);
+var import_listr2 = require("listr2");
+var import_prettier = require("prettier");
+var import_colors = require("./colors.js");
+var import_paths = require("./paths.js");
+const transformTSToJS = (filename, content) => {
+  if (!content) {
+    return content;
+  }
+  const babelFileResult = babel.transform(content, {
+    filename,
+    // If you ran `yarn cedar generate` in `./web` transformSync would import the `.babelrc.js` file,
+    // in `./web`? despite us setting `configFile: false`.
+    cwd: process.env.NODE_ENV === "test" ? void 0 : (0, import_paths.getPaths)().base,
+    configFile: false,
+    plugins: [
+      [
+        "@babel/plugin-transform-typescript",
+        {
+          isTSX: true,
+          allExtensions: true
+        }
+      ]
+    ],
+    retainLines: true
+  });
+  if (!babelFileResult?.code) {
+    console.error(import_colors.colors.error(`Could not transform ${filename} to JS`));
+    process.exit(1);
+  }
+  return prettify(filename.replace(/\.ts(x)?$/, ".js$1"), babelFileResult.code);
+};
+const getPrettierOptions = async () => {
+  try {
+    const cjsPath = import_path.default.join((0, import_paths.getPaths)().base, "prettier.config.cjs");
+    const mjsPath = import_path.default.join((0, import_paths.getPaths)().base, "prettier.config.mjs");
+    const prettierConfigPath = import_node_fs.default.existsSync(cjsPath) ? cjsPath : mjsPath;
+    const { default: options } = await import((0, import_node_url.pathToFileURL)(prettierConfigPath).href);
+    if (options.tailwindConfig?.startsWith(".")) {
+      options.tailwindConfig = import_path.default.join(
+        process.env.CEDAR_CWD ?? process.env.RWJS_CWD ?? process.cwd(),
+        options.tailwindConfig
+      );
+    }
+    return options;
+  } catch {
+    return void 0;
+  }
+};
+const prettify = async (templateFilename, renderedTemplate) => {
+  const parser = {
+    ".css": "css",
+    ".js": "babel",
+    ".cjs": "babel",
+    ".mjs": "babel",
+    ".ts": "babel-ts",
+    ".mts": "babel-ts",
+    ".tsx": "babel-ts"
+  }[import_path.default.extname(templateFilename.replace(".template", ""))];
+  if (typeof parser === "undefined") {
+    return renderedTemplate;
+  }
+  const prettierOptions = await getPrettierOptions();
+  return (0, import_prettier.format)(renderedTemplate, {
+    ...prettierOptions,
+    parser
+  });
+};
+const writeFile = (target, contents, { existingFiles = "FAIL" } = {}, task = {}) => {
+  const { base } = (0, import_paths.getPaths)();
+  task.title = `Writing \`./${import_path.default.relative(base, target)}\``;
+  const exists = import_node_fs.default.existsSync(target);
+  if (exists && existingFiles === "FAIL") {
+    throw new Error(`${target} already exists.`);
+  }
+  if (exists && existingFiles === "SKIP") {
+    task.skip(`Skipping update of \`./${import_path.default.relative(base, target)}\``);
+    return;
+  }
+  const filename = import_path.default.basename(target);
+  const targetDir = target.replace(filename, "");
+  import_node_fs.default.mkdirSync(targetDir, { recursive: true });
+  import_node_fs.default.writeFileSync(target, contents);
+  task.title = `Successfully wrote file \`./${import_path.default.relative(base, target)}\``;
+};
+const writeFilesTask = (files, options) => {
+  const { base } = (0, import_paths.getPaths)();
+  return new import_listr2.Listr(
+    Object.keys(files).map((file) => {
+      const contents = files[file];
+      return {
+        title: `...waiting to write file \`./${import_path.default.relative(base, file)}\`...`,
+        task: (_ctx, task) => {
+          return writeFile(file, contents, options, task);
+        }
+      };
+    })
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getPrettierOptions,
+  prettify,
+  transformTSToJS,
+  writeFile,
+  writeFilesTask
+});

package/dist/cjs/lib/installHelpers.d.ts

@@ -0,0 +1,17 @@
+export declare const addWebPackages: (webPackages: string[]) => {
+    title: string;
+    task: () => Promise<void>;
+};
+export declare const addApiPackages: (apiPackages: string[]) => {
+    title: string;
+    task: () => Promise<void>;
+};
+export declare const addRootPackages: (packages: string[], devDependency?: boolean) => {
+    title: string;
+    task: () => Promise<void>;
+};
+export declare const installPackages: {
+    title: string;
+    task: () => Promise<void>;
+};
+//# sourceMappingURL=installHelpers.d.ts.map

package/dist/cjs/lib/installHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"installHelpers.d.ts","sourceRoot":"","sources":["../../../src/lib/installHelpers.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,EAAE;;;CAMlD,CAAA;AAEF,eAAO,MAAM,cAAc,GAAI,aAAa,MAAM,EAAE;;;CAMlD,CAAA;AAEF,eAAO,MAAM,eAAe,GAAI,UAAU,MAAM,EAAE,EAAE,uBAAqB;;;CAQxE,CAAA;AAED,eAAO,MAAM,eAAe;;;CAM3B,CAAA"}

package/dist/cjs/lib/installHelpers.js

@@ -0,0 +1,65 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var installHelpers_exports = {};
+__export(installHelpers_exports, {
+  addApiPackages: () => addApiPackages,
+  addRootPackages: () => addRootPackages,
+  addWebPackages: () => addWebPackages,
+  installPackages: () => installPackages
+});
+module.exports = __toCommonJS(installHelpers_exports);
+var import_packages = require("../packageManager/packages.js");
+var import_paths = require("./paths.js");
+const addWebPackages = (webPackages) => ({
+  title: `Adding required web packages...`,
+  task: async () => {
+    const cwd = (0, import_paths.getPaths)().web.base;
+    await (0, import_packages.addWorkspacePackages)("web", webPackages, { cwd });
+  }
+});
+const addApiPackages = (apiPackages) => ({
+  title: "Adding required api packages...",
+  task: async () => {
+    const cwd = (0, import_paths.getPaths)().api.base;
+    await (0, import_packages.addWorkspacePackages)("api", apiPackages, { cwd });
+  }
+});
+const addRootPackages = (packages, devDependency = false) => {
+  return {
+    title: "Installing packages...",
+    task: async () => {
+      const cwd = (0, import_paths.getPaths)().base;
+      await (0, import_packages.addRootPackages)(packages, { cwd, dev: devDependency });
+    }
+  };
+};
+const installPackages = {
+  title: "Installing packages...",
+  task: async () => {
+    const cwd = (0, import_paths.getPaths)().base;
+    await (0, import_packages.installPackages)({ cwd });
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addApiPackages,
+  addRootPackages,
+  addWebPackages,
+  installPackages
+});

package/dist/cjs/lib/loadEnvFiles.d.ts

@@ -0,0 +1,5 @@
+export declare function loadEnvFiles(): void;
+export declare function loadDefaultEnvFiles(cwd: string): void;
+export declare function loadNodeEnvDerivedEnvFile(cwd: string): void;
+export declare function loadUserSpecifiedEnvFiles(cwd: string, loadEnvFiles: string[]): void;
+//# sourceMappingURL=loadEnvFiles.d.ts.map

package/dist/cjs/lib/loadEnvFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loadEnvFiles.d.ts","sourceRoot":"","sources":["../../../src/lib/loadEnvFiles.ts"],"names":[],"mappings":"AAUA,wBAAgB,YAAY,SAsB3B;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,QAM9C;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,QAcpD;AAED,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,QAW5E"}

package/dist/cjs/lib/loadEnvFiles.js

@@ -0,0 +1,99 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var loadEnvFiles_exports = {};
+__export(loadEnvFiles_exports, {
+  loadDefaultEnvFiles: () => loadDefaultEnvFiles,
+  loadEnvFiles: () => loadEnvFiles,
+  loadNodeEnvDerivedEnvFile: () => loadNodeEnvDerivedEnvFile,
+  loadUserSpecifiedEnvFiles: () => loadUserSpecifiedEnvFiles
+});
+module.exports = __toCommonJS(loadEnvFiles_exports);
+var import_node_fs = __toESM(require("node:fs"), 1);
+var import_node_path = __toESM(require("node:path"), 1);
+var import_dotenv = require("dotenv");
+var import_dotenv_defaults = require("dotenv-defaults");
+var import_helpers = require("yargs/helpers");
+var import_yargs_parser = __toESM(require("yargs-parser"), 1);
+var import_project_config = require("@cedarjs/project-config");
+function loadEnvFiles() {
+  if (process.env.CEDAR_ENV_FILES_LOADED) {
+    return;
+  }
+  const { base } = (0, import_project_config.getPaths)();
+  loadDefaultEnvFiles(base);
+  loadNodeEnvDerivedEnvFile(base);
+  const { loadEnvFiles: loadEnvFiles2 } = (0, import_yargs_parser.default)((0, import_helpers.hideBin)(process.argv), {
+    array: ["load-env-files"],
+    default: {
+      loadEnvFiles: []
+    }
+  });
+  if (loadEnvFiles2.length > 0) {
+    loadUserSpecifiedEnvFiles(base, loadEnvFiles2);
+  }
+  process.env.CEDAR_ENV_FILES_LOADED = "true";
+}
+function loadDefaultEnvFiles(cwd) {
+  (0, import_dotenv_defaults.config)({
+    path: import_node_path.default.join(cwd, ".env"),
+    defaults: import_node_path.default.join(cwd, ".env.defaults"),
+    multiline: true
+  });
+}
+function loadNodeEnvDerivedEnvFile(cwd) {
+  if (!process.env.NODE_ENV) {
+    return;
+  }
+  const nodeEnvDerivedEnvFilePath = import_node_path.default.join(
+    cwd,
+    `.env.${process.env.NODE_ENV}`
+  );
+  if (!import_node_fs.default.existsSync(nodeEnvDerivedEnvFilePath)) {
+    return;
+  }
+  (0, import_dotenv.config)({ path: nodeEnvDerivedEnvFilePath, override: true });
+}
+function loadUserSpecifiedEnvFiles(cwd, loadEnvFiles2) {
+  for (const suffix of loadEnvFiles2) {
+    const envPath = import_node_path.default.join(cwd, `.env.${suffix}`);
+    if (!import_node_fs.default.existsSync(envPath)) {
+      throw new Error(
+        `Couldn't find an .env file at '${envPath}' as specified by '--load-env-files'`
+      );
+    }
+    (0, import_dotenv.config)({ path: envPath, override: true });
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  loadDefaultEnvFiles,
+  loadEnvFiles,
+  loadNodeEnvDerivedEnvFile,
+  loadUserSpecifiedEnvFiles
+});

package/dist/cjs/lib/paths.d.ts

@@ -0,0 +1,6 @@
+/**
+ * This wraps the core version of getPaths into something that catches the exception
+ * and displays a helpful error message.
+ */
+export declare function getPaths(): import("@cedarjs/project-config").Paths;
+//# sourceMappingURL=paths.d.ts.map