@strapi/strapi 4.20.5 → 5.0.0-alpha.0

package/dist/node/core/plugins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugins.js","sources":["../../../src/node/core/plugins.ts"],"sourcesContent":["import os from 'node:os';\nimport path from 'node:path';\nimport fs from 'node:fs';\nimport camelCase from 'lodash/camelCase';\nimport { env } from '@strapi/utils';\nimport { getModule, PackageJson } from './dependencies';\nimport { convertModulePathToSystemPath, convertSystemPathToModulePath, loadFile } from './files';\nimport type { BaseContext } from '../types';\nimport { isError } from './errors';\n\ninterface LocalPluginMeta {\n  name: string;\n  /**\n   * camelCased version of the plugin name\n   */\n  importName: string;\n  /**\n   * The path to the plugin, relative to the app's root directory\n   * in system format\n   */\n  path: string;\n  /**\n   * The path to the plugin, relative to the runtime directory\n   * in module format (i.e. with forward slashes) because thats\n   * where it should be used as an import\n   */\n  modulePath: string;\n  type: 'local';\n}\n\ninterface ModulePluginMeta {\n  name: string;\n  /**\n   * camelCased version of the plugin name\n   */\n  importName: string;\n  /**\n   * Modules don't have a path because we never resolve them to their node_modules\n   * because we simply do not require it.\n   */\n  path?: never;\n  /**\n   * The path to the plugin, relative to the app's root directory\n   * in module format (i.e. with forward slashes)\n   */\n  modulePath: string;\n  type: 'module';\n}\n\ntype PluginMeta = LocalPluginMeta | ModulePluginMeta;\n\ninterface StrapiPlugin extends PackageJson {\n  strapi: {\n    description?: string;\n    displayName?: string;\n    kind: 'plugin';\n    name?: string;\n    required?: boolean;\n  };\n}\n\nconst validatePackageHasStrapi = (\n  pkg: PackageJson\n): pkg is PackageJson & { strapi: Record<string, unknown> } =>\n  'strapi' in pkg &&\n  typeof pkg.strapi === 'object' &&\n  !Array.isArray(pkg.strapi) &&\n  pkg.strapi !== null;\n\nconst validatePackageIsPlugin = (pkg: PackageJson): pkg is StrapiPlugin =>\n  validatePackageHasStrapi(pkg) && pkg.strapi.kind === 'plugin';\n\nconst getEnabledPlugins = async ({\n  cwd,\n  logger,\n  runtimeDir,\n  strapi,\n}: Pick<BaseContext, 'cwd' | 'logger' | 'strapi' | 'runtimeDir'>): Promise<\n  Record<string, PluginMeta>\n> => {\n  const plugins: Record<string, PluginMeta> = {};\n\n  /**\n   * This is the list of dependencies that are installed in the user's project.\n   * It will include libraries like \"react\", so we need to collect the ones that\n   * are plugins.\n   */\n  const deps = strapi.config.get('info.dependencies', {});\n\n  logger.debug(\"Dependencies from user's project\", os.EOL, deps);\n\n  for (const dep of Object.keys(deps)) {\n    const pkg = await getModule(dep, cwd);\n\n    if (pkg && validatePackageIsPlugin(pkg)) {\n      const name = pkg.strapi.name || pkg.name;\n\n      if (!name) {\n        /**\n         * Unlikely to happen, but you never know.\n         */\n        throw Error(\n          \"You're trying to import a plugin that doesn't have a name – check the package.json of that plugin!\"\n        );\n      }\n\n      plugins[name] = {\n        name,\n        importName: camelCase(name),\n        type: 'module',\n        modulePath: dep,\n      };\n    }\n  }\n\n  const userPluginsFile = await loadUserPluginsFile(strapi.dirs.app.config);\n\n  logger.debug(\"User's plugins file\", os.EOL, userPluginsFile);\n\n  for (const [userPluginName, userPluginConfig] of Object.entries(userPluginsFile)) {\n    if (userPluginConfig.enabled && userPluginConfig.resolve) {\n      const sysPath = convertModulePathToSystemPath(userPluginConfig.resolve);\n      plugins[userPluginName] = {\n        name: userPluginName,\n        importName: camelCase(userPluginName),\n        type: 'local',\n        /**\n         * User plugin paths are resolved from the entry point\n         * of the app, because that's how you import them.\n         */\n        modulePath: convertSystemPathToModulePath(path.relative(runtimeDir, sysPath)),\n        path: sysPath,\n      };\n    }\n  }\n\n  return plugins;\n};\n\nconst PLUGIN_CONFIGS = ['plugins.js', 'plugins.mjs', 'plugins.ts'];\n\ntype UserPluginConfigFile = Record<string, { enabled: boolean; resolve: string }>;\n\nconst loadUserPluginsFile = async (root: string): Promise<UserPluginConfigFile> => {\n  for (const file of PLUGIN_CONFIGS) {\n    const filePath = path.join(root, file);\n    const configFile = await loadFile(filePath);\n\n    if (configFile) {\n      /**\n       * Configs can be a function or they can be just an object!\n       */\n      return typeof configFile === 'function' ? configFile({ env }) : configFile;\n    }\n  }\n\n  return {};\n};\n\nconst getMapOfPluginsWithAdmin = (plugins: Record<string, PluginMeta>) =>\n  Object.values(plugins)\n    .filter((plugin) => {\n      if (!plugin) {\n        return false;\n      }\n\n      /**\n       * There are two ways a plugin should be imported, either it's local to the strapi app,\n       * or it's an actual npm module that's installed and resolved via node_modules.\n       *\n       * We first check if the plugin is local to the strapi app, using a regular `fs.existsSync` because\n       * the pathToPlugin will be relative i.e. `/Users/my-name/strapi-app/src/plugins/my-plugin`.\n       *\n       * If the file doesn't exist well then it's probably a node_module, so instead we use `require.resolve`\n       * which will resolve the path to the module in node_modules. If it fails with the specific code `MODULE_NOT_FOUND`\n       * then it doesn't have an admin part to the package.\n       */\n      try {\n        const isLocalPluginWithLegacyAdminFile =\n          plugin.path && fs.existsSync(path.join(plugin.path, 'strapi-admin.js'));\n\n        if (!isLocalPluginWithLegacyAdminFile) {\n          const isModuleWithFE = require.resolve(`${plugin.modulePath}/strapi-admin`);\n\n          return isModuleWithFE;\n        }\n\n        return isLocalPluginWithLegacyAdminFile;\n      } catch (err) {\n        if (\n          isError(err) &&\n          'code' in err &&\n          (err.code === 'MODULE_NOT_FOUND' || err.code === 'ERR_PACKAGE_PATH_NOT_EXPORTED')\n        ) {\n          /**\n           * the plugin does not contain FE code, so we\n           * don't want to import it anyway\n           */\n          return false;\n        }\n\n        throw err;\n      }\n    })\n    .map((plugin) => ({\n      ...plugin,\n      modulePath: `${plugin.modulePath}/strapi-admin`,\n    }));\n\nexport { getEnabledPlugins, getMapOfPluginsWithAdmin };\nexport type { PluginMeta, LocalPluginMeta, ModulePluginMeta };\n"],"names":["os","getModule","camelCase","convertModulePathToSystemPath","convertSystemPathToModulePath","path","loadFile","env","fs","isError"],"mappings":";;;;;;;;;;;;;;;AA6DA,MAAM,2BAA2B,CAC/B,QAEA,YAAY,OACZ,OAAO,IAAI,WAAW,YACtB,CAAC,MAAM,QAAQ,IAAI,MAAM,KACzB,IAAI,WAAW;AAEjB,MAAM,0BAA0B,CAAC,QAC/B,yBAAyB,GAAG,KAAK,IAAI,OAAO,SAAS;AAEvD,MAAM,oBAAoB,OAAO;AAAA,EAC/B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,MAEK;AACH,QAAM,UAAsC,CAAA;AAO5C,QAAM,OAAO,OAAO,OAAO,IAAI,qBAAqB,CAAA,CAAE;AAEtD,SAAO,MAAM,oCAAoCA,YAAG,QAAA,KAAK,IAAI;AAE7D,aAAW,OAAO,OAAO,KAAK,IAAI,GAAG;AACnC,UAAM,MAAM,MAAMC,aAAAA,UAAU,KAAK,GAAG;AAEhC,QAAA,OAAO,wBAAwB,GAAG,GAAG;AACvC,YAAM,OAAO,IAAI,OAAO,QAAQ,IAAI;AAEpC,UAAI,CAAC,MAAM;AAIH,cAAA;AAAA,UACJ;AAAA,QAAA;AAAA,MAEJ;AAEA,cAAQ,IAAI,IAAI;AAAA,QACd;AAAA,QACA,YAAYC,2BAAU,IAAI;AAAA,QAC1B,MAAM;AAAA,QACN,YAAY;AAAA,MAAA;AAAA,IAEhB;AAAA,EACF;AAEA,QAAM,kBAAkB,MAAM,oBAAoB,OAAO,KAAK,IAAI,MAAM;AAExE,SAAO,MAAM,uBAAuBF,YAAG,QAAA,KAAK,eAAe;AAE3D,aAAW,CAAC,gBAAgB,gBAAgB,KAAK,OAAO,QAAQ,eAAe,GAAG;AAC5E,QAAA,iBAAiB,WAAW,iBAAiB,SAAS;AAClD,YAAA,UAAUG,MAAAA,8BAA8B,iBAAiB,OAAO;AACtE,cAAQ,cAAc,IAAI;AAAA,QACxB,MAAM;AAAA,QACN,YAAYD,2BAAU,cAAc;AAAA,QACpC,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,QAKN,YAAYE,MAA8B,8BAAAC,cAAA,QAAK,SAAS,YAAY,OAAO,CAAC;AAAA,QAC5E,MAAM;AAAA,MAAA;AAAA,IAEV;AAAA,EACF;AAEO,SAAA;AACT;AAEA,MAAM,iBAAiB,CAAC,cAAc,eAAe,YAAY;AAIjE,MAAM,sBAAsB,OAAO,SAAgD;AACjF,aAAW,QAAQ,gBAAgB;AACjC,UAAM,WAAWA,cAAA,QAAK,KAAK,MAAM,IAAI;AAC/B,UAAA,aAAa,MAAMC,eAAS,QAAQ;AAE1C,QAAI,YAAY;AAId,aAAO,OAAO,eAAe,aAAa,WAAW,EAAA,KAAEC,MAAA,IAAA,CAAK,IAAI;AAAA,IAClE;AAAA,EACF;AAEA,SAAO;AACT;AAEM,MAAA,2BAA2B,CAAC,YAChC,OAAO,OAAO,OAAO,EAClB,OAAO,CAAC,WAAW;AAClB,MAAI,CAAC,QAAQ;AACJ,WAAA;AAAA,EACT;AAaI,MAAA;AACI,UAAA,mCACJ,OAAO,QAAQC,YAAG,QAAA,WAAWH,sBAAK,KAAK,OAAO,MAAM,iBAAiB,CAAC;AAExE,QAAI,CAAC,kCAAkC;AACrC,YAAM,iBAAiB,QAAQ,QAAQ,GAAG,OAAO,UAAU,eAAe;AAEnE,aAAA;AAAA,IACT;AAEO,WAAA;AAAA,WACA,KAAK;AAEV,QAAAI,eAAQ,GAAG,KACX,UAAU,QACT,IAAI,SAAS,sBAAsB,IAAI,SAAS,kCACjD;AAKO,aAAA;AAAA,IACT;AAEM,UAAA;AAAA,EACR;AACF,CAAC,EACA,IAAI,CAAC,YAAY;AAAA,EAChB,GAAG;AAAA,EACH,YAAY,GAAG,OAAO,UAAU;AAClC,EAAE;;;"}

package/dist/node/core/timer.d.ts

@@ -0,0 +1,8 @@
+export interface TimeMeasurer {
+    start: (name: string) => void;
+    end: (name: string) => number;
+    getTimings: () => Record<string, number>;
+}
+export declare function getTimer(): TimeMeasurer;
+export declare const prettyTime: (timeInMs: number) => string;
+//# sourceMappingURL=timer.d.ts.map

package/dist/node/core/timer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.d.ts","sourceRoot":"","sources":["../../../src/node/core/timer.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9B,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC9B,UAAU,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,wBAAgB,QAAQ,IAAI,YAAY,CAsBvC;AAED,eAAO,MAAM,UAAU,aAAc,MAAM,KAAG,MAE7C,CAAC"}

package/dist/node/core/timer.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const perf_hooks = require("perf_hooks");
+function getTimer() {
+  const timings = {};
+  const startTimes = {};
+  function start(name) {
+    if (typeof startTimes[name] !== "undefined") {
+      throw new Error(`Timer "${name}" already started, cannot overwrite`);
+    }
+    startTimes[name] = perf_hooks.performance.now();
+  }
+  function end(name) {
+    if (typeof startTimes[name] === "undefined") {
+      throw new Error(`Timer "${name}" never started, cannot end`);
+    }
+    timings[name] = perf_hooks.performance.now() - startTimes[name];
+    return timings[name];
+  }
+  return { start, end, getTimings: () => timings };
+}
+const prettyTime = (timeInMs) => {
+  return `${Math.ceil(timeInMs)}ms`;
+};
+exports.getTimer = getTimer;
+exports.prettyTime = prettyTime;
+//# sourceMappingURL=timer.js.map

package/dist/node/core/timer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timer.js","sources":["../../../src/node/core/timer.ts"],"sourcesContent":["import { performance } from 'perf_hooks';\n\nexport interface TimeMeasurer {\n  start: (name: string) => void;\n  end: (name: string) => number;\n  getTimings: () => Record<string, number>;\n}\n\nexport function getTimer(): TimeMeasurer {\n  const timings: Record<string, number> = {};\n  const startTimes: Record<string, number> = {};\n\n  function start(name: string): void {\n    if (typeof startTimes[name] !== 'undefined') {\n      throw new Error(`Timer \"${name}\" already started, cannot overwrite`);\n    }\n\n    startTimes[name] = performance.now();\n  }\n\n  function end(name: string): number {\n    if (typeof startTimes[name] === 'undefined') {\n      throw new Error(`Timer \"${name}\" never started, cannot end`);\n    }\n\n    timings[name] = performance.now() - startTimes[name];\n    return timings[name];\n  }\n\n  return { start, end, getTimings: () => timings };\n}\n\nexport const prettyTime = (timeInMs: number): string => {\n  return `${Math.ceil(timeInMs)}ms`;\n};\n"],"names":["performance"],"mappings":";;;AAQO,SAAS,WAAyB;AACvC,QAAM,UAAkC,CAAA;AACxC,QAAM,aAAqC,CAAA;AAE3C,WAAS,MAAM,MAAoB;AACjC,QAAI,OAAO,WAAW,IAAI,MAAM,aAAa;AAC3C,YAAM,IAAI,MAAM,UAAU,IAAI,qCAAqC;AAAA,IACrE;AAEW,eAAA,IAAI,IAAIA,WAAA,YAAY,IAAI;AAAA,EACrC;AAEA,WAAS,IAAI,MAAsB;AACjC,QAAI,OAAO,WAAW,IAAI,MAAM,aAAa;AAC3C,YAAM,IAAI,MAAM,UAAU,IAAI,6BAA6B;AAAA,IAC7D;AAEA,YAAQ,IAAI,IAAIA,WAAA,YAAY,IAAI,IAAI,WAAW,IAAI;AACnD,WAAO,QAAQ,IAAI;AAAA,EACrB;AAEA,SAAO,EAAE,OAAO,KAAK,YAAY,MAAM,QAAQ;AACjD;AAEa,MAAA,aAAa,CAAC,aAA6B;AACtD,SAAO,GAAG,KAAK,KAAK,QAAQ,CAAC;AAC/B;;;"}

package/dist/node/create-build-context.d.ts

@@ -0,0 +1,39 @@
+import { Strapi, FeaturesService } from '@strapi/types';
+import type { CLIContext } from '../cli/types';
+import { PluginMeta } from './core/plugins';
+import { AppFile } from './core/admin-customisations';
+import type { BaseContext } from './types';
+interface BaseOptions {
+    stats?: boolean;
+    minify?: boolean;
+    sourcemaps?: boolean;
+    bundler?: 'webpack' | 'vite';
+    open?: boolean;
+}
+interface BuildContext<TOptions = unknown> extends BaseContext {
+    /**
+     * The customisations defined by the user in their app.js file
+     */
+    customisations?: AppFile;
+    /**
+     * Features object with future flags
+     */
+    features?: FeaturesService['config'];
+    /**
+     * The build options
+     */
+    options: BaseOptions & TOptions;
+    /**
+     * The plugins to be included in the JS bundle
+     * incl. internal plugins, third party plugins & local plugins
+     */
+    plugins: PluginMeta[];
+}
+interface CreateBuildContextArgs<TOptions = unknown> extends CLIContext {
+    strapi?: Strapi;
+    options?: TOptions;
+}
+declare const createBuildContext: <TOptions extends BaseOptions>({ cwd, logger, tsconfig, strapi, options, }: CreateBuildContextArgs<TOptions>) => Promise<BuildContext<TOptions>>;
+export { createBuildContext };
+export type { BuildContext, CreateBuildContextArgs };
+//# sourceMappingURL=create-build-context.d.ts.map

package/dist/node/create-build-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-build-context.d.ts","sourceRoot":"","sources":["../../src/node/create-build-context.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG/C,OAAO,EAAE,UAAU,EAA+C,MAAM,gBAAgB,CAAC;AACzF,OAAO,EAAE,OAAO,EAAmB,MAAM,6BAA6B,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C,UAAU,WAAW;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7B,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,UAAU,YAAY,CAAC,QAAQ,GAAG,OAAO,CAAE,SAAQ,WAAW;IAC5D;;OAEG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB;;OAEG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,CAAC;IACrC;;OAEG;IACH,OAAO,EAAE,WAAW,GAAG,QAAQ,CAAC;IAChC;;;OAGG;IACH,OAAO,EAAE,UAAU,EAAE,CAAC;CACvB;AAED,UAAU,sBAAsB,CAAC,QAAQ,GAAG,OAAO,CAAE,SAAQ,UAAU;IACrE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,QAAQ,CAAC;CACpB;AASD,QAAA,MAAM,kBAAkB,kJAsGvB,CAAC;AAEF,OAAO,EAAE,kBAAkB,EAAE,CAAC;AAC9B,YAAY,EAAE,YAAY,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/node/create-build-context.js

@@ -0,0 +1,96 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const os = require("node:os");
+const path = require("node:path");
+const fs = require("node:fs/promises");
+const browserslist = require("browserslist");
+const core = require("@strapi/core");
+const env = require("./core/env.js");
+const plugins = require("./core/plugins.js");
+const adminCustomisations = require("./core/admin-customisations.js");
+const _interopDefault = (e) => e && e.__esModule ? e : { default: e };
+const os__default = /* @__PURE__ */ _interopDefault(os);
+const path__default = /* @__PURE__ */ _interopDefault(path);
+const fs__default = /* @__PURE__ */ _interopDefault(fs);
+const browserslist__default = /* @__PURE__ */ _interopDefault(browserslist);
+const DEFAULT_BROWSERSLIST = [
+  "last 3 major versions",
+  "Firefox ESR",
+  "last 2 Opera versions",
+  "not dead"
+];
+const createBuildContext = async ({
+  cwd,
+  logger,
+  tsconfig,
+  strapi,
+  options = {}
+}) => {
+  const strapiInstance = strapi ?? core.strapiFactory({
+    // Directories
+    appDir: cwd,
+    distDir: tsconfig?.config.options.outDir ?? "",
+    // Options
+    autoReload: true,
+    serveAdminPanel: false
+  });
+  const serverUrl = strapiInstance.config.get("server.url");
+  const adminPath = strapiInstance.config.get("admin.path");
+  const appDir = strapiInstance.dirs.app.root;
+  await env.loadEnv(cwd);
+  const env$1 = env.getStrapiAdminEnvVars({
+    ADMIN_PATH: adminPath,
+    STRAPI_ADMIN_BACKEND_URL: serverUrl,
+    STRAPI_TELEMETRY_DISABLED: String(strapiInstance.telemetry.isDisabled)
+  });
+  const envKeys = Object.keys(env$1);
+  if (envKeys.length > 0) {
+    logger.info(
+      [
+        "Including the following ENV variables as part of the JS bundle:",
+        ...envKeys.map((key) => `    - ${key}`)
+      ].join(os__default.default.EOL)
+    );
+  }
+  const distPath = path__default.default.join(strapiInstance.dirs.dist.root, "build");
+  const distDir = path__default.default.relative(cwd, distPath);
+  try {
+    logger.debug(`Cleaning dist folder: ${distPath}`);
+    await fs__default.default.rm(distPath, { recursive: true, force: true });
+    logger.debug("Cleaned dist folder");
+  } catch {
+    logger.debug("There was no dist folder to clean");
+  }
+  const runtimeDir = path__default.default.join(cwd, ".strapi", "client");
+  const entry = path__default.default.relative(cwd, path__default.default.join(runtimeDir, "app.js"));
+  const plugins$1 = await plugins.getEnabledPlugins({ cwd, logger, runtimeDir, strapi: strapiInstance });
+  logger.debug("Enabled plugins", os__default.default.EOL, plugins$1);
+  const pluginsWithFront = plugins.getMapOfPluginsWithAdmin(plugins$1);
+  logger.debug("Enabled plugins with FE", os__default.default.EOL, pluginsWithFront);
+  const target = browserslist__default.default.loadConfig({ path: cwd }) ?? DEFAULT_BROWSERSLIST;
+  const customisations = await adminCustomisations.loadUserAppFile({ appDir, runtimeDir });
+  const features = strapiInstance.config.get("features", void 0);
+  const { bundler = "webpack", ...restOptions } = options;
+  const buildContext = {
+    appDir,
+    basePath: `${adminPath}/`,
+    bundler,
+    customisations,
+    cwd,
+    distDir,
+    distPath,
+    entry,
+    env: env$1,
+    features,
+    logger,
+    options: restOptions,
+    plugins: pluginsWithFront,
+    runtimeDir,
+    strapi: strapiInstance,
+    target,
+    tsconfig
+  };
+  return buildContext;
+};
+exports.createBuildContext = createBuildContext;
+//# sourceMappingURL=create-build-context.js.map

package/dist/node/create-build-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-build-context.js","sources":["../../src/node/create-build-context.ts"],"sourcesContent":["import os from 'node:os';\nimport path from 'node:path';\nimport fs from 'node:fs/promises';\nimport browserslist from 'browserslist';\nimport { strapiFactory } from '@strapi/core';\nimport { Strapi, FeaturesService } from '@strapi/types';\n\nimport type { CLIContext } from '../cli/types';\nimport { getStrapiAdminEnvVars, loadEnv } from './core/env';\n\nimport { PluginMeta, getEnabledPlugins, getMapOfPluginsWithAdmin } from './core/plugins';\nimport { AppFile, loadUserAppFile } from './core/admin-customisations';\nimport type { BaseContext } from './types';\n\ninterface BaseOptions {\n  stats?: boolean;\n  minify?: boolean;\n  sourcemaps?: boolean;\n  bundler?: 'webpack' | 'vite';\n  open?: boolean;\n}\n\ninterface BuildContext<TOptions = unknown> extends BaseContext {\n  /**\n   * The customisations defined by the user in their app.js file\n   */\n  customisations?: AppFile;\n  /**\n   * Features object with future flags\n   */\n  features?: FeaturesService['config'];\n  /**\n   * The build options\n   */\n  options: BaseOptions & TOptions;\n  /**\n   * The plugins to be included in the JS bundle\n   * incl. internal plugins, third party plugins & local plugins\n   */\n  plugins: PluginMeta[];\n}\n\ninterface CreateBuildContextArgs<TOptions = unknown> extends CLIContext {\n  strapi?: Strapi;\n  options?: TOptions;\n}\n\nconst DEFAULT_BROWSERSLIST = [\n  'last 3 major versions',\n  'Firefox ESR',\n  'last 2 Opera versions',\n  'not dead',\n];\n\nconst createBuildContext = async <TOptions extends BaseOptions>({\n  cwd,\n  logger,\n  tsconfig,\n  strapi,\n  options = {} as TOptions,\n}: CreateBuildContextArgs<TOptions>): Promise<BuildContext<TOptions>> => {\n  /**\n   * If you make a new strapi instance when one already exists,\n   * you will overwrite the global and the app will _most likely_\n   * crash and die.\n   */\n  const strapiInstance =\n    strapi ??\n    strapiFactory({\n      // Directories\n      appDir: cwd,\n      distDir: tsconfig?.config.options.outDir ?? '',\n      // Options\n      autoReload: true,\n      serveAdminPanel: false,\n    });\n\n  const serverUrl = strapiInstance.config.get<string>('server.url');\n  const adminPath = strapiInstance.config.get<string>('admin.path');\n\n  const appDir = strapiInstance.dirs.app.root;\n\n  await loadEnv(cwd);\n\n  const env = getStrapiAdminEnvVars({\n    ADMIN_PATH: adminPath,\n    STRAPI_ADMIN_BACKEND_URL: serverUrl,\n    STRAPI_TELEMETRY_DISABLED: String(strapiInstance.telemetry.isDisabled),\n  });\n\n  const envKeys = Object.keys(env);\n\n  if (envKeys.length > 0) {\n    logger.info(\n      [\n        'Including the following ENV variables as part of the JS bundle:',\n        ...envKeys.map((key) => `    - ${key}`),\n      ].join(os.EOL)\n    );\n  }\n\n  const distPath = path.join(strapiInstance.dirs.dist.root, 'build');\n  const distDir = path.relative(cwd, distPath);\n\n  /**\n   * If the distPath already exists, clean it\n   */\n  try {\n    logger.debug(`Cleaning dist folder: ${distPath}`);\n    await fs.rm(distPath, { recursive: true, force: true });\n    logger.debug('Cleaned dist folder');\n  } catch {\n    // do nothing, it will fail if the folder does not exist\n    logger.debug('There was no dist folder to clean');\n  }\n\n  const runtimeDir = path.join(cwd, '.strapi', 'client');\n  const entry = path.relative(cwd, path.join(runtimeDir, 'app.js'));\n\n  const plugins = await getEnabledPlugins({ cwd, logger, runtimeDir, strapi: strapiInstance });\n\n  logger.debug('Enabled plugins', os.EOL, plugins);\n\n  const pluginsWithFront = getMapOfPluginsWithAdmin(plugins);\n\n  logger.debug('Enabled plugins with FE', os.EOL, pluginsWithFront);\n\n  const target = browserslist.loadConfig({ path: cwd }) ?? DEFAULT_BROWSERSLIST;\n\n  const customisations = await loadUserAppFile({ appDir, runtimeDir });\n\n  const features = strapiInstance.config.get('features', undefined);\n\n  const { bundler = 'webpack', ...restOptions } = options;\n\n  const buildContext = {\n    appDir,\n    basePath: `${adminPath}/`,\n    bundler,\n    customisations,\n    cwd,\n    distDir,\n    distPath,\n    entry,\n    env,\n    features,\n    logger,\n    options: restOptions as BaseOptions & TOptions,\n    plugins: pluginsWithFront,\n    runtimeDir,\n    strapi: strapiInstance,\n    target,\n    tsconfig,\n  } satisfies BuildContext<TOptions>;\n\n  return buildContext;\n};\n\nexport { createBuildContext };\nexport type { BuildContext, CreateBuildContextArgs };\n"],"names":["strapiFactory","loadEnv","env","getStrapiAdminEnvVars","os","path","fs","plugins","getEnabledPlugins","getMapOfPluginsWithAdmin","browserslist","loadUserAppFile"],"mappings":";;;;;;;;;;;;;;;AA+CA,MAAM,uBAAuB;AAAA,EAC3B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAEA,MAAM,qBAAqB,OAAqC;AAAA,EAC9D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,UAAU,CAAC;AACb,MAAyE;AAMjE,QAAA,iBACJ,UACAA,mBAAc;AAAA;AAAA,IAEZ,QAAQ;AAAA,IACR,SAAS,UAAU,OAAO,QAAQ,UAAU;AAAA;AAAA,IAE5C,YAAY;AAAA,IACZ,iBAAiB;AAAA,EAAA,CAClB;AAEH,QAAM,YAAY,eAAe,OAAO,IAAY,YAAY;AAChE,QAAM,YAAY,eAAe,OAAO,IAAY,YAAY;AAE1D,QAAA,SAAS,eAAe,KAAK,IAAI;AAEvC,QAAMC,IAAAA,QAAQ,GAAG;AAEjB,QAAMC,QAAMC,IAAAA,sBAAsB;AAAA,IAChC,YAAY;AAAA,IACZ,0BAA0B;AAAA,IAC1B,2BAA2B,OAAO,eAAe,UAAU,UAAU;AAAA,EAAA,CACtE;AAEK,QAAA,UAAU,OAAO,KAAKD,KAAG;AAE3B,MAAA,QAAQ,SAAS,GAAG;AACf,WAAA;AAAA,MACL;AAAA,QACE;AAAA,QACA,GAAG,QAAQ,IAAI,CAAC,QAAQ,SAAS,GAAG,EAAE;AAAA,MAAA,EACtC,KAAKE,YAAA,QAAG,GAAG;AAAA,IAAA;AAAA,EAEjB;AAEA,QAAM,WAAWC,cAAK,QAAA,KAAK,eAAe,KAAK,KAAK,MAAM,OAAO;AACjE,QAAM,UAAUA,cAAA,QAAK,SAAS,KAAK,QAAQ;AAKvC,MAAA;AACK,WAAA,MAAM,yBAAyB,QAAQ,EAAE;AAC1C,UAAAC,YAAA,QAAG,GAAG,UAAU,EAAE,WAAW,MAAM,OAAO,MAAM;AACtD,WAAO,MAAM,qBAAqB;AAAA,EAAA,QAC5B;AAEN,WAAO,MAAM,mCAAmC;AAAA,EAClD;AAEA,QAAM,aAAaD,cAAAA,QAAK,KAAK,KAAK,WAAW,QAAQ;AAC/C,QAAA,QAAQA,sBAAK,SAAS,KAAKA,sBAAK,KAAK,YAAY,QAAQ,CAAC;AAE1D,QAAAE,YAAU,MAAMC,QAAkB,kBAAA,EAAE,KAAK,QAAQ,YAAY,QAAQ,eAAA,CAAgB;AAE3F,SAAO,MAAM,mBAAmBJ,YAAG,QAAA,KAAKG,SAAO;AAEzC,QAAA,mBAAmBE,iCAAyBF,SAAO;AAEzD,SAAO,MAAM,2BAA2BH,YAAG,QAAA,KAAK,gBAAgB;AAEhE,QAAM,SAASM,sBAAAA,QAAa,WAAW,EAAE,MAAM,IAAA,CAAK,KAAK;AAEzD,QAAM,iBAAiB,MAAMC,oBAAA,gBAAgB,EAAE,QAAQ,WAAY,CAAA;AAEnE,QAAM,WAAW,eAAe,OAAO,IAAI,YAAY,MAAS;AAEhE,QAAM,EAAE,UAAU,WAAW,GAAG,gBAAgB;AAEhD,QAAM,eAAe;AAAA,IACnB;AAAA,IACA,UAAU,GAAG,SAAS;AAAA,IACtB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IAAA,KACAT;AAAAA,IACA;AAAA,IACA;AAAA,IACA,SAAS;AAAA,IACT,SAAS;AAAA,IACT;AAAA,IACA,QAAQ;AAAA,IACR;AAAA,IACA;AAAA,EAAA;AAGK,SAAA;AACT;;"}

package/dist/node/develop.d.ts

@@ -0,0 +1,16 @@
+import type { CLIContext } from '../cli/types';
+interface DevelopOptions extends CLIContext {
+    /**
+     * Which bundler to use for building.
+     *
+     * @default webpack
+     */
+    bundler?: 'webpack' | 'vite';
+    polling?: boolean;
+    open?: boolean;
+    watchAdmin?: boolean;
+}
+declare const develop: ({ cwd, polling, logger, tsconfig, watchAdmin, ...options }: DevelopOptions) => Promise<void>;
+export { develop };
+export type { DevelopOptions };
+//# sourceMappingURL=develop.d.ts.map

package/dist/node/develop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"develop.d.ts","sourceRoot":"","sources":["../../src/node/develop.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAS/C,UAAU,cAAe,SAAQ,UAAU;IACzC;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AA4CD,QAAA,MAAM,OAAO,+DAOV,cAAc,kBAwPhB,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC;AACnB,YAAY,EAAE,cAAc,EAAE,CAAC"}

package/dist/node/develop.js

@@ -0,0 +1,270 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const tsUtils = require("@strapi/typescript-utils");
+const utils = require("@strapi/utils");
+const chokidar = require("chokidar");
+const fs = require("node:fs/promises");
+const path = require("node:path");
+const cluster = require("node:cluster");
+const core = require("@strapi/core");
+const dependencies = require("./core/dependencies.js");
+const timer = require("./core/timer.js");
+const createBuildContext = require("./create-build-context.js");
+const staticFiles = require("./staticFiles.js");
+const _interopDefault = (e) => e && e.__esModule ? e : { default: e };
+function _interopNamespace(e) {
+  if (e && e.__esModule)
+    return e;
+  const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
+  if (e) {
+    for (const k in e) {
+      if (k !== "default") {
+        const d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: () => e[k]
+        });
+      }
+    }
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+const tsUtils__namespace = /* @__PURE__ */ _interopNamespace(tsUtils);
+const chokidar__default = /* @__PURE__ */ _interopDefault(chokidar);
+const fs__default = /* @__PURE__ */ _interopDefault(fs);
+const path__default = /* @__PURE__ */ _interopDefault(path);
+const cluster__default = /* @__PURE__ */ _interopDefault(cluster);
+const cleanupDistDirectory = async ({
+  tsconfig,
+  logger,
+  timer: timer$1
+}) => {
+  const distDir = tsconfig?.config?.options?.outDir;
+  if (!distDir || // we don't have a dist dir
+  await fs__default.default.access(distDir).then(() => false).catch(() => true)) {
+    return;
+  }
+  const timerName = `cleaningDist${Date.now()}`;
+  timer$1.start(timerName);
+  const cleaningSpinner = logger.spinner(`Cleaning dist dir ${distDir}`).start();
+  try {
+    const dirContent = await fs__default.default.readdir(distDir);
+    const validFilenames = dirContent.filter((filename) => filename !== "build");
+    for (const filename of validFilenames) {
+      await fs__default.default.rm(path__default.default.resolve(distDir, filename), { recursive: true });
+    }
+  } catch (err) {
+    const generatingDuration2 = timer$1.end(timerName);
+    cleaningSpinner.text = `Error cleaning dist dir: ${err} (${timer.prettyTime(generatingDuration2)})`;
+    cleaningSpinner?.fail();
+    return;
+  }
+  const generatingDuration = timer$1.end(timerName);
+  cleaningSpinner.text = `Cleaning dist dir (${timer.prettyTime(generatingDuration)})`;
+  cleaningSpinner?.succeed();
+};
+const develop = async ({
+  cwd,
+  polling,
+  logger,
+  tsconfig,
+  watchAdmin,
+  ...options
+}) => {
+  const timer$1 = timer.getTimer();
+  if (cluster__default.default.isPrimary) {
+    const { didInstall } = await dependencies.checkRequiredDependencies({ cwd, logger }).catch((err) => {
+      logger.error(err.message);
+      process.exit(1);
+    });
+    if (didInstall) {
+      return;
+    }
+    if (tsconfig?.config) {
+      await cleanupDistDirectory({ tsconfig, logger, timer: timer$1 });
+      await tsUtils__namespace.compile(cwd, { configOptions: { ignoreDiagnostics: true } });
+    }
+    if (!watchAdmin) {
+      timer$1.start("createBuildContext");
+      const contextSpinner = logger.spinner(`Building build context`).start();
+      console.log("");
+      const ctx = await createBuildContext.createBuildContext({
+        cwd,
+        logger,
+        tsconfig,
+        options
+      });
+      const contextDuration = timer$1.end("createBuildContext");
+      contextSpinner.text = `Building build context (${timer.prettyTime(contextDuration)})`;
+      contextSpinner.succeed();
+      timer$1.start("creatingAdmin");
+      const adminSpinner = logger.spinner(`Creating admin`).start();
+      await staticFiles.writeStaticClientFiles(ctx);
+      if (ctx.bundler === "webpack") {
+        const { build: buildWebpack } = await Promise.resolve().then(() => require("./webpack/build.js"));
+        await buildWebpack(ctx);
+      } else if (ctx.bundler === "vite") {
+        const { build: buildVite } = await Promise.resolve().then(() => require("./vite/build.js"));
+        await buildVite(ctx);
+      }
+      const adminDuration = timer$1.end("creatingAdmin");
+      adminSpinner.text = `Creating admin (${timer.prettyTime(adminDuration)})`;
+      adminSpinner.succeed();
+    }
+    cluster__default.default.on("message", async (worker, message) => {
+      switch (message) {
+        case "reload": {
+          if (tsconfig?.config) {
+            await cleanupDistDirectory({ tsconfig, logger, timer: timer$1 });
+            await tsUtils__namespace.compile(cwd, { configOptions: { ignoreDiagnostics: true } });
+          }
+          logger.debug("cluster has the reload message, sending the worker kill message");
+          worker.send("kill");
+          break;
+        }
+        case "killed": {
+          logger.debug("cluster has the killed message, forking the cluster");
+          cluster__default.default.fork();
+          break;
+        }
+        case "stop": {
+          process.exit(1);
+          break;
+        }
+      }
+    });
+    cluster__default.default.fork();
+  }
+  if (cluster__default.default.isWorker) {
+    timer$1.start("loadStrapi");
+    const loadStrapiSpinner = logger.spinner(`Loading Strapi`).start();
+    const strapi = core.strapiFactory({
+      appDir: cwd,
+      distDir: tsconfig?.config.options.outDir ?? "",
+      autoReload: true,
+      serveAdminPanel: !watchAdmin
+    });
+    let bundleWatcher;
+    if (watchAdmin) {
+      timer$1.start("createBuildContext");
+      const contextSpinner = logger.spinner(`Building build context`).start();
+      console.log("");
+      const ctx = await createBuildContext.createBuildContext({
+        cwd,
+        logger,
+        strapi,
+        tsconfig,
+        options
+      });
+      const contextDuration = timer$1.end("createBuildContext");
+      contextSpinner.text = `Building build context (${timer.prettyTime(contextDuration)})`;
+      contextSpinner.succeed();
+      timer$1.start("creatingAdmin");
+      const adminSpinner = logger.spinner(`Creating admin`).start();
+      await staticFiles.writeStaticClientFiles(ctx);
+      if (ctx.bundler === "webpack") {
+        const { watch: watchWebpack } = await Promise.resolve().then(() => require("./webpack/watch.js"));
+        bundleWatcher = await watchWebpack(ctx);
+      } else if (ctx.bundler === "vite") {
+        const { watch: watchVite } = await Promise.resolve().then(() => require("./vite/watch.js"));
+        bundleWatcher = await watchVite(ctx);
+      }
+      const adminDuration = timer$1.end("creatingAdmin");
+      adminSpinner.text = `Creating admin (${timer.prettyTime(adminDuration)})`;
+      adminSpinner.succeed();
+    }
+    const strapiInstance = await strapi.load();
+    const loadStrapiDuration = timer$1.end("loadStrapi");
+    loadStrapiSpinner.text = `Loading Strapi (${timer.prettyTime(loadStrapiDuration)})`;
+    loadStrapiSpinner.succeed();
+    if (tsconfig?.config || strapi.config.get("typescript.autogenerate") !== false) {
+      timer$1.start("generatingTS");
+      const generatingTsSpinner = logger.spinner(`Generating types`).start();
+      await tsUtils__namespace.generators.generate({
+        strapi: strapiInstance,
+        pwd: cwd,
+        rootDir: void 0,
+        logger: { silent: true, debug: false },
+        artifacts: { contentTypes: true, components: true }
+      });
+      const generatingDuration = timer$1.end("generatingTS");
+      generatingTsSpinner.text = `Generating types (${timer.prettyTime(generatingDuration)})`;
+      generatingTsSpinner.succeed();
+    }
+    if (tsconfig?.config) {
+      timer$1.start("compilingTS");
+      const compilingTsSpinner = logger.spinner(`Compiling TS`).start();
+      await cleanupDistDirectory({ tsconfig, logger, timer: timer$1 });
+      await tsUtils__namespace.compile(cwd, { configOptions: { ignoreDiagnostics: false } });
+      const compilingDuration = timer$1.end("compilingTS");
+      compilingTsSpinner.text = `Compiling TS (${timer.prettyTime(compilingDuration)})`;
+      compilingTsSpinner.succeed();
+    }
+    const restart = async () => {
+      if (strapiInstance.reload.isWatching && !strapiInstance.reload.isReloading) {
+        strapiInstance.reload.isReloading = true;
+        strapiInstance.reload();
+      }
+    };
+    const watcher = chokidar__default.default.watch(cwd, {
+      ignoreInitial: true,
+      usePolling: polling,
+      ignored: [
+        /(^|[/\\])\../,
+        // dot files
+        /tmp/,
+        "**/src/admin/**",
+        "**/src/plugins/**/admin/**",
+        "**/dist/src/plugins/test/admin/**",
+        "**/documentation",
+        "**/documentation/**",
+        "**/node_modules",
+        "**/node_modules/**",
+        "**/plugins.json",
+        "**/build",
+        "**/build/**",
+        "**/index.html",
+        "**/public",
+        "**/public/**",
+        strapiInstance.dirs.static.public,
+        utils.strings.joinBy("/", strapiInstance.dirs.static.public, "**"),
+        "**/*.db*",
+        "**/exports/**",
+        "**/dist/**",
+        "**/*.d.ts",
+        "**/.yalc/**",
+        "**/yalc.lock",
+        ...strapiInstance.config.get("admin.watchIgnoreFiles", [])
+      ]
+    }).on("add", (path2) => {
+      strapiInstance.log.info(`File created: ${path2}`);
+      restart();
+    }).on("change", (path2) => {
+      strapiInstance.log.info(`File changed: ${path2}`);
+      restart();
+    }).on("unlink", (path2) => {
+      strapiInstance.log.info(`File deleted: ${path2}`);
+      restart();
+    });
+    process.on("message", async (message) => {
+      switch (message) {
+        case "kill": {
+          logger.debug(
+            "child process has the kill message, destroying the strapi instance and sending the killed process message"
+          );
+          await watcher.close();
+          await strapiInstance.destroy();
+          if (bundleWatcher) {
+            bundleWatcher.close();
+          }
+          process.send?.("killed");
+          break;
+        }
+      }
+    });
+    strapiInstance.start();
+  }
+};
+exports.develop = develop;
+//# sourceMappingURL=develop.js.map

package/dist/node/develop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"develop.js","sources":["../../src/node/develop.ts"],"sourcesContent":["import * as tsUtils from '@strapi/typescript-utils';\nimport { strings } from '@strapi/utils';\nimport chokidar from 'chokidar';\nimport fs from 'node:fs/promises';\nimport path from 'node:path';\nimport cluster from 'node:cluster';\nimport { strapiFactory } from '@strapi/core';\n\nimport type { CLIContext } from '../cli/types';\nimport { checkRequiredDependencies } from './core/dependencies';\nimport { getTimer, prettyTime, type TimeMeasurer } from './core/timer';\nimport { createBuildContext } from './create-build-context';\nimport type { WebpackWatcher } from './webpack/watch';\nimport type { ViteWatcher } from './vite/watch';\n\nimport { writeStaticClientFiles } from './staticFiles';\n\ninterface DevelopOptions extends CLIContext {\n  /**\n   * Which bundler to use for building.\n   *\n   * @default webpack\n   */\n  bundler?: 'webpack' | 'vite';\n  polling?: boolean;\n  open?: boolean;\n  watchAdmin?: boolean;\n}\n\n// This method removes all non-admin build files from the dist directory\nconst cleanupDistDirectory = async ({\n  tsconfig,\n  logger,\n  timer,\n}: Pick<DevelopOptions, 'tsconfig' | 'logger'> & { timer: TimeMeasurer }) => {\n  const distDir = tsconfig?.config?.options?.outDir;\n\n  if (\n    !distDir || // we don't have a dist dir\n    (await fs\n      .access(distDir)\n      .then(() => false)\n      .catch(() => true)) // it doesn't exist -- if it does but no access, that will be caught later\n  ) {\n    return;\n  }\n\n  const timerName = `cleaningDist${Date.now()}`;\n  timer.start(timerName);\n  const cleaningSpinner = logger.spinner(`Cleaning dist dir ${distDir}`).start();\n\n  try {\n    const dirContent = await fs.readdir(distDir);\n    const validFilenames = dirContent\n      // Ignore the admin build folder\n      .filter((filename) => filename !== 'build');\n    for (const filename of validFilenames) {\n      await fs.rm(path.resolve(distDir, filename), { recursive: true });\n    }\n  } catch (err: unknown) {\n    const generatingDuration = timer.end(timerName);\n    cleaningSpinner.text = `Error cleaning dist dir: ${err} (${prettyTime(generatingDuration)})`;\n    cleaningSpinner?.fail();\n    return;\n  }\n\n  const generatingDuration = timer.end(timerName);\n  cleaningSpinner.text = `Cleaning dist dir (${prettyTime(generatingDuration)})`;\n  cleaningSpinner?.succeed();\n};\n\nconst develop = async ({\n  cwd,\n  polling,\n  logger,\n  tsconfig,\n  watchAdmin,\n  ...options\n}: DevelopOptions) => {\n  const timer = getTimer();\n\n  if (cluster.isPrimary) {\n    const { didInstall } = await checkRequiredDependencies({ cwd, logger }).catch((err) => {\n      logger.error(err.message);\n      process.exit(1);\n    });\n\n    if (didInstall) {\n      return;\n    }\n\n    if (tsconfig?.config) {\n      // Build without diagnostics in case schemas have changed\n      await cleanupDistDirectory({ tsconfig, logger, timer });\n      await tsUtils.compile(cwd, { configOptions: { ignoreDiagnostics: true } });\n    }\n\n    /**\n     * IF we're not watching the admin we're going to build it, this makes\n     * sure that at least the admin is built for users & they can interact\n     * with the application.\n     */\n    if (!watchAdmin) {\n      timer.start('createBuildContext');\n      const contextSpinner = logger.spinner(`Building build context`).start();\n      console.log('');\n\n      const ctx = await createBuildContext({\n        cwd,\n        logger,\n        tsconfig,\n        options,\n      });\n      const contextDuration = timer.end('createBuildContext');\n      contextSpinner.text = `Building build context (${prettyTime(contextDuration)})`;\n      contextSpinner.succeed();\n\n      timer.start('creatingAdmin');\n      const adminSpinner = logger.spinner(`Creating admin`).start();\n\n      await writeStaticClientFiles(ctx);\n\n      if (ctx.bundler === 'webpack') {\n        const { build: buildWebpack } = await import('./webpack/build');\n        await buildWebpack(ctx);\n      } else if (ctx.bundler === 'vite') {\n        const { build: buildVite } = await import('./vite/build');\n        await buildVite(ctx);\n      }\n\n      const adminDuration = timer.end('creatingAdmin');\n      adminSpinner.text = `Creating admin (${prettyTime(adminDuration)})`;\n      adminSpinner.succeed();\n    }\n\n    cluster.on('message', async (worker, message) => {\n      switch (message) {\n        case 'reload': {\n          if (tsconfig?.config) {\n            // Build without diagnostics in case schemas have changed\n            await cleanupDistDirectory({ tsconfig, logger, timer });\n            await tsUtils.compile(cwd, { configOptions: { ignoreDiagnostics: true } });\n          }\n          logger.debug('cluster has the reload message, sending the worker kill message');\n          worker.send('kill');\n          break;\n        }\n        case 'killed': {\n          logger.debug('cluster has the killed message, forking the cluster');\n          cluster.fork();\n          break;\n        }\n        case 'stop': {\n          process.exit(1);\n          break;\n        }\n        default:\n          break;\n      }\n    });\n\n    cluster.fork();\n  }\n\n  if (cluster.isWorker) {\n    timer.start('loadStrapi');\n    const loadStrapiSpinner = logger.spinner(`Loading Strapi`).start();\n\n    const strapi = strapiFactory({\n      appDir: cwd,\n      distDir: tsconfig?.config.options.outDir ?? '',\n      autoReload: true,\n      serveAdminPanel: !watchAdmin,\n    });\n\n    /**\n     * If we're watching the admin panel then we're going to attach the watcher\n     * as a strapi middleware.\n     */\n    let bundleWatcher: WebpackWatcher | ViteWatcher | undefined;\n\n    if (watchAdmin) {\n      timer.start('createBuildContext');\n      const contextSpinner = logger.spinner(`Building build context`).start();\n      console.log('');\n\n      const ctx = await createBuildContext({\n        cwd,\n        logger,\n        strapi,\n        tsconfig,\n        options,\n      });\n      const contextDuration = timer.end('createBuildContext');\n      contextSpinner.text = `Building build context (${prettyTime(contextDuration)})`;\n      contextSpinner.succeed();\n\n      timer.start('creatingAdmin');\n      const adminSpinner = logger.spinner(`Creating admin`).start();\n\n      await writeStaticClientFiles(ctx);\n\n      if (ctx.bundler === 'webpack') {\n        const { watch: watchWebpack } = await import('./webpack/watch');\n        bundleWatcher = await watchWebpack(ctx);\n      } else if (ctx.bundler === 'vite') {\n        const { watch: watchVite } = await import('./vite/watch');\n        bundleWatcher = await watchVite(ctx);\n      }\n\n      const adminDuration = timer.end('creatingAdmin');\n      adminSpinner.text = `Creating admin (${prettyTime(adminDuration)})`;\n      adminSpinner.succeed();\n    }\n\n    const strapiInstance = await strapi.load();\n\n    const loadStrapiDuration = timer.end('loadStrapi');\n    loadStrapiSpinner.text = `Loading Strapi (${prettyTime(loadStrapiDuration)})`;\n    loadStrapiSpinner.succeed();\n\n    // For TS projects, type generation is a requirement for the develop command so that the server can restart\n    // For JS projects, we respect the experimental autogenerate setting\n    if (tsconfig?.config || strapi.config.get('typescript.autogenerate') !== false) {\n      timer.start('generatingTS');\n      const generatingTsSpinner = logger.spinner(`Generating types`).start();\n\n      await tsUtils.generators.generate({\n        strapi: strapiInstance,\n        pwd: cwd,\n        rootDir: undefined,\n        logger: { silent: true, debug: false },\n        artifacts: { contentTypes: true, components: true },\n      });\n\n      const generatingDuration = timer.end('generatingTS');\n      generatingTsSpinner.text = `Generating types (${prettyTime(generatingDuration)})`;\n      generatingTsSpinner.succeed();\n    }\n\n    if (tsconfig?.config) {\n      timer.start('compilingTS');\n      const compilingTsSpinner = logger.spinner(`Compiling TS`).start();\n\n      await cleanupDistDirectory({ tsconfig, logger, timer });\n      await tsUtils.compile(cwd, { configOptions: { ignoreDiagnostics: false } });\n\n      const compilingDuration = timer.end('compilingTS');\n      compilingTsSpinner.text = `Compiling TS (${prettyTime(compilingDuration)})`;\n      compilingTsSpinner.succeed();\n    }\n\n    const restart = async () => {\n      if (strapiInstance.reload.isWatching && !strapiInstance.reload.isReloading) {\n        strapiInstance.reload.isReloading = true;\n        strapiInstance.reload();\n      }\n    };\n\n    const watcher = chokidar\n      .watch(cwd, {\n        ignoreInitial: true,\n        usePolling: polling,\n        ignored: [\n          /(^|[/\\\\])\\../, // dot files\n          /tmp/,\n          '**/src/admin/**',\n          '**/src/plugins/**/admin/**',\n          '**/dist/src/plugins/test/admin/**',\n          '**/documentation',\n          '**/documentation/**',\n          '**/node_modules',\n          '**/node_modules/**',\n          '**/plugins.json',\n          '**/build',\n          '**/build/**',\n          '**/index.html',\n          '**/public',\n          '**/public/**',\n          strapiInstance.dirs.static.public,\n          strings.joinBy('/', strapiInstance.dirs.static.public, '**'),\n          '**/*.db*',\n          '**/exports/**',\n          '**/dist/**',\n          '**/*.d.ts',\n          '**/.yalc/**',\n          '**/yalc.lock',\n          ...strapiInstance.config.get('admin.watchIgnoreFiles', []),\n        ],\n      })\n      .on('add', (path) => {\n        strapiInstance.log.info(`File created: ${path}`);\n        restart();\n      })\n      .on('change', (path) => {\n        strapiInstance.log.info(`File changed: ${path}`);\n        restart();\n      })\n      .on('unlink', (path) => {\n        strapiInstance.log.info(`File deleted: ${path}`);\n        restart();\n      });\n\n    process.on('message', async (message) => {\n      switch (message) {\n        case 'kill': {\n          logger.debug(\n            'child process has the kill message, destroying the strapi instance and sending the killed process message'\n          );\n          await watcher.close();\n\n          await strapiInstance.destroy();\n\n          if (bundleWatcher) {\n            bundleWatcher.close();\n          }\n          process.send?.('killed');\n          break;\n        }\n        default:\n          break;\n      }\n    });\n\n    strapiInstance.start();\n  }\n};\n\nexport { develop };\nexport type { DevelopOptions };\n"],"names":["timer","fs","path","generatingDuration","prettyTime","getTimer","cluster","checkRequiredDependencies","tsUtils","createBuildContext","writeStaticClientFiles","strapiFactory","chokidar","strings"],"mappings":"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"}

package/dist/node/staticFiles.d.ts

@@ -0,0 +1,14 @@
+import type { BuildContext } from './create-build-context';
+interface GetDocumentHTMLArgs extends Pick<BuildContext, 'logger'> {
+    props?: {
+        entryPath?: string;
+    };
+}
+/**
+ * TODO: Here in the future we could add the ability
+ * to load a user's Document component?
+ */
+declare const getDocumentHTML: ({ logger, props }: GetDocumentHTMLArgs) => string;
+declare const writeStaticClientFiles: (ctx: BuildContext) => Promise<void>;
+export { writeStaticClientFiles, getDocumentHTML };
+//# sourceMappingURL=staticFiles.d.ts.map

package/dist/node/staticFiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"staticFiles.d.ts","sourceRoot":"","sources":["../../src/node/staticFiles.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAqC3D,UAAU,mBAAoB,SAAQ,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC;IAChE,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED;;;GAGG;AACH,QAAA,MAAM,eAAe,sBAA4B,mBAAmB,WAKnE,CAAC;AAgBF,QAAA,MAAM,sBAAsB,QAAe,YAAY,kBAqCtD,CAAC;AAEF,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,CAAC"}