@strapi/strapi 5.19.0 → 5.20.0

package/dist/cli/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,eAAO,MAAM,QAAQ,EAAE,aAAa,EA+BnC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/index.ts"],"names":[],"mappings":"AA8BA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,eAAO,MAAM,QAAQ,EAAE,aAAa,EAgCnC,CAAC"}

package/dist/cli/commands/openapi/generate.d.ts

@@ -0,0 +1,9 @@
+interface CommandOptions {
+    output?: string;
+}
+/**
+ * @experimental
+ */
+declare const action: (options: CommandOptions) => Promise<void>;
+export { action };
+//# sourceMappingURL=generate.d.ts.map

package/dist/cli/commands/openapi/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/openapi/generate.ts"],"names":[],"mappings":"AAWA,UAAU,cAAc;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAaD;;GAEG;AACH,QAAA,MAAM,MAAM,YAAmB,cAAc,kBAY5C,CAAC;AA2CF,OAAO,EAAE,MAAM,EAAE,CAAC"}

package/dist/cli/commands/openapi/index.d.ts

@@ -0,0 +1,7 @@
+import type { StrapiCommand } from '../../types';
+/**
+ * `$ strapi openapi`
+ */
+declare const command: StrapiCommand;
+export { command };
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/commands/openapi/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/openapi/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAIjD;;GAEG;AACH,QAAA,MAAM,OAAO,EAAE,aAad,CAAC;AAEF,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/package.json.js

@@ -1,6 +1,6 @@
 'use strict';
 
-var version = "5.19.0";
+var version = "5.20.0";
 
 exports.version = version;
 //# sourceMappingURL=package.json.js.map

package/dist/package.json.mjs

@@ -1,4 +1,4 @@
-var version = "5.19.0";
+var version = "5.20.0";
 
 export { version };
 //# sourceMappingURL=package.json.mjs.map

package/dist/src/cli/commands/index.js

@@ -24,6 +24,7 @@ var generate = require('./generate.js');
 var report = require('./report.js');
 var start = require('./start.js');
 var version = require('./version.js');
+var index = require('./openapi/index.js');
 var command = require('./export/command.js');
 var command$1 = require('./import/command.js');
 var command$2 = require('./transfer/command.js');
@@ -55,6 +56,7 @@ const commands = [
     command,
     command$1,
     command$2,
+    index.command,
     /**
    * Cloud
    */ cloudCli.buildStrapiCloudCommands

package/dist/src/cli/commands/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../../src/cli/commands/index.ts"],"sourcesContent":["import { buildStrapiCloudCommands as cloudCommands } from '@strapi/cloud-cli';\n\nimport { command as createAdminUser } from './admin/create-user';\nimport { command as resetAdminUserPassword } from './admin/reset-user-password';\nimport { command as listComponents } from './components/list';\nimport { command as configurationDump } from './configuration/dump';\nimport { command as configurationRestore } from './configuration/restore';\nimport { command as listContentTypes } from './content-types/list';\nimport { command as listControllers } from './controllers/list';\nimport { command as listHooks } from './hooks/list';\nimport { command as listMiddlewares } from './middlewares/list';\nimport { command as listPolicies } from './policies/list';\nimport { command as listRoutes } from './routes/list';\nimport { command as listServices } from './services/list';\nimport { command as disableTelemetry } from './telemetry/disable';\nimport { command as enableTelemetry } from './telemetry/enable';\nimport { command as generateTemplates } from './templates/generate';\nimport { command as generateTsTypes } from './ts/generate-types';\nimport { command as buildCommand } from './build';\nimport { command as consoleCommand } from './console';\nimport { command as developCommand } from './develop';\nimport { command as generateCommand } from './generate';\nimport { command as reportCommand } from './report';\nimport { command as startCommand } from './start';\nimport { command as versionCommand } from './version';\nimport exportCommand from './export/command';\nimport importCommand from './import/command';\nimport transferCommand from './transfer/command';\n\nimport { StrapiCommand } from '../types';\n\nexport const commands: StrapiCommand[] = [\n  createAdminUser,\n  resetAdminUserPassword,\n  listComponents,\n  configurationDump,\n  configurationRestore,\n  consoleCommand,\n  listContentTypes,\n  listControllers,\n  generateCommand,\n  listHooks,\n  listMiddlewares,\n  listPolicies,\n  reportCommand,\n  listRoutes,\n  listServices,\n  startCommand,\n  disableTelemetry,\n  enableTelemetry,\n  generateTemplates,\n  generateTsTypes,\n  versionCommand,\n  buildCommand,\n  developCommand,\n  exportCommand,\n  importCommand,\n  transferCommand,\n  /**\n   * Cloud\n   */\n  cloudCommands,\n];\n"],"names":["commands","createAdminUser","resetAdminUserPassword","listComponents","configurationDump","configurationRestore","consoleCommand","listContentTypes","listControllers","generateCommand","listHooks","listMiddlewares","listPolicies","reportCommand","listRoutes","listServices","startCommand","disableTelemetry","enableTelemetry","generateTemplates","generateTsTypes","versionCommand","buildCommand","developCommand","exportCommand","importCommand","transferCommand","cloudCommands"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA+BaA,QAA4B,GAAA;AACvCC,IAAAA,kBAAAA;AACAC,IAAAA,yBAAAA;AACAC,IAAAA,YAAAA;AACAC,IAAAA,YAAAA;AACAC,IAAAA,eAAAA;AACAC,IAAAA,eAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,gBAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,aAAAA;AACAC,IAAAA,eAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,kBAAAA;AACAC,IAAAA,qBAAAA;AACAC,IAAAA,eAAAA;AACAC,IAAAA,aAAAA;AACAC,IAAAA,eAAAA;AACAC,IAAAA,OAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACA;;MAGAC;;;;;"}
+{"version":3,"file":"index.js","sources":["../../../../src/cli/commands/index.ts"],"sourcesContent":["import { buildStrapiCloudCommands as cloudCommands } from '@strapi/cloud-cli';\n\nimport { command as createAdminUser } from './admin/create-user';\nimport { command as resetAdminUserPassword } from './admin/reset-user-password';\nimport { command as listComponents } from './components/list';\nimport { command as configurationDump } from './configuration/dump';\nimport { command as configurationRestore } from './configuration/restore';\nimport { command as listContentTypes } from './content-types/list';\nimport { command as listControllers } from './controllers/list';\nimport { command as listHooks } from './hooks/list';\nimport { command as listMiddlewares } from './middlewares/list';\nimport { command as listPolicies } from './policies/list';\nimport { command as listRoutes } from './routes/list';\nimport { command as listServices } from './services/list';\nimport { command as disableTelemetry } from './telemetry/disable';\nimport { command as enableTelemetry } from './telemetry/enable';\nimport { command as generateTemplates } from './templates/generate';\nimport { command as generateTsTypes } from './ts/generate-types';\nimport { command as buildCommand } from './build';\nimport { command as consoleCommand } from './console';\nimport { command as developCommand } from './develop';\nimport { command as generateCommand } from './generate';\nimport { command as reportCommand } from './report';\nimport { command as startCommand } from './start';\nimport { command as versionCommand } from './version';\nimport { command as openAPICommand } from './openapi';\nimport exportCommand from './export/command';\nimport importCommand from './import/command';\nimport transferCommand from './transfer/command';\n\nimport { StrapiCommand } from '../types';\n\nexport const commands: StrapiCommand[] = [\n  createAdminUser,\n  resetAdminUserPassword,\n  listComponents,\n  configurationDump,\n  configurationRestore,\n  consoleCommand,\n  listContentTypes,\n  listControllers,\n  generateCommand,\n  listHooks,\n  listMiddlewares,\n  listPolicies,\n  reportCommand,\n  listRoutes,\n  listServices,\n  startCommand,\n  disableTelemetry,\n  enableTelemetry,\n  generateTemplates,\n  generateTsTypes,\n  versionCommand,\n  buildCommand,\n  developCommand,\n  exportCommand,\n  importCommand,\n  transferCommand,\n  openAPICommand,\n  /**\n   * Cloud\n   */\n  cloudCommands,\n];\n"],"names":["commands","createAdminUser","resetAdminUserPassword","listComponents","configurationDump","configurationRestore","consoleCommand","listContentTypes","listControllers","generateCommand","listHooks","listMiddlewares","listPolicies","reportCommand","listRoutes","listServices","startCommand","disableTelemetry","enableTelemetry","generateTemplates","generateTsTypes","versionCommand","buildCommand","developCommand","exportCommand","importCommand","transferCommand","openAPICommand","cloudCommands"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgCaA,QAA4B,GAAA;AACvCC,IAAAA,kBAAAA;AACAC,IAAAA,yBAAAA;AACAC,IAAAA,YAAAA;AACAC,IAAAA,YAAAA;AACAC,IAAAA,eAAAA;AACAC,IAAAA,eAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,gBAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,aAAAA;AACAC,IAAAA,eAAAA;AACAC,IAAAA,cAAAA;AACAC,IAAAA,kBAAAA;AACAC,IAAAA,qBAAAA;AACAC,IAAAA,eAAAA;AACAC,IAAAA,aAAAA;AACAC,IAAAA,eAAAA;AACAC,IAAAA,OAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,aAAAA;AACA;;MAGAC;;;;;"}

package/dist/src/cli/commands/index.mjs

@@ -22,6 +22,7 @@ import { command as command$8 } from './generate.mjs';
 import { command as command$c } from './report.mjs';
 import { command as command$f } from './start.mjs';
 import { command as command$k } from './version.mjs';
+import { command as command$q } from './openapi/index.mjs';
 import command$n from './export/command.mjs';
 import command$o from './import/command.mjs';
 import command$p from './transfer/command.mjs';
@@ -53,6 +54,7 @@ const commands = [
     command$n,
     command$o,
     command$p,
+    command$q,
     /**
    * Cloud
    */ buildStrapiCloudCommands

package/dist/src/cli/commands/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sources":["../../../../src/cli/commands/index.ts"],"sourcesContent":["import { buildStrapiCloudCommands as cloudCommands } from '@strapi/cloud-cli';\n\nimport { command as createAdminUser } from './admin/create-user';\nimport { command as resetAdminUserPassword } from './admin/reset-user-password';\nimport { command as listComponents } from './components/list';\nimport { command as configurationDump } from './configuration/dump';\nimport { command as configurationRestore } from './configuration/restore';\nimport { command as listContentTypes } from './content-types/list';\nimport { command as listControllers } from './controllers/list';\nimport { command as listHooks } from './hooks/list';\nimport { command as listMiddlewares } from './middlewares/list';\nimport { command as listPolicies } from './policies/list';\nimport { command as listRoutes } from './routes/list';\nimport { command as listServices } from './services/list';\nimport { command as disableTelemetry } from './telemetry/disable';\nimport { command as enableTelemetry } from './telemetry/enable';\nimport { command as generateTemplates } from './templates/generate';\nimport { command as generateTsTypes } from './ts/generate-types';\nimport { command as buildCommand } from './build';\nimport { command as consoleCommand } from './console';\nimport { command as developCommand } from './develop';\nimport { command as generateCommand } from './generate';\nimport { command as reportCommand } from './report';\nimport { command as startCommand } from './start';\nimport { command as versionCommand } from './version';\nimport exportCommand from './export/command';\nimport importCommand from './import/command';\nimport transferCommand from './transfer/command';\n\nimport { StrapiCommand } from '../types';\n\nexport const commands: StrapiCommand[] = [\n  createAdminUser,\n  resetAdminUserPassword,\n  listComponents,\n  configurationDump,\n  configurationRestore,\n  consoleCommand,\n  listContentTypes,\n  listControllers,\n  generateCommand,\n  listHooks,\n  listMiddlewares,\n  listPolicies,\n  reportCommand,\n  listRoutes,\n  listServices,\n  startCommand,\n  disableTelemetry,\n  enableTelemetry,\n  generateTemplates,\n  generateTsTypes,\n  versionCommand,\n  buildCommand,\n  developCommand,\n  exportCommand,\n  importCommand,\n  transferCommand,\n  /**\n   * Cloud\n   */\n  cloudCommands,\n];\n"],"names":["commands","createAdminUser","resetAdminUserPassword","listComponents","configurationDump","configurationRestore","consoleCommand","listContentTypes","listControllers","generateCommand","listHooks","listMiddlewares","listPolicies","reportCommand","listRoutes","listServices","startCommand","disableTelemetry","enableTelemetry","generateTemplates","generateTsTypes","versionCommand","buildCommand","developCommand","exportCommand","importCommand","transferCommand","cloudCommands"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;MA+BaA,QAA4B,GAAA;AACvCC,IAAAA,OAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACA;;MAGAC;;;;;"}
+{"version":3,"file":"index.mjs","sources":["../../../../src/cli/commands/index.ts"],"sourcesContent":["import { buildStrapiCloudCommands as cloudCommands } from '@strapi/cloud-cli';\n\nimport { command as createAdminUser } from './admin/create-user';\nimport { command as resetAdminUserPassword } from './admin/reset-user-password';\nimport { command as listComponents } from './components/list';\nimport { command as configurationDump } from './configuration/dump';\nimport { command as configurationRestore } from './configuration/restore';\nimport { command as listContentTypes } from './content-types/list';\nimport { command as listControllers } from './controllers/list';\nimport { command as listHooks } from './hooks/list';\nimport { command as listMiddlewares } from './middlewares/list';\nimport { command as listPolicies } from './policies/list';\nimport { command as listRoutes } from './routes/list';\nimport { command as listServices } from './services/list';\nimport { command as disableTelemetry } from './telemetry/disable';\nimport { command as enableTelemetry } from './telemetry/enable';\nimport { command as generateTemplates } from './templates/generate';\nimport { command as generateTsTypes } from './ts/generate-types';\nimport { command as buildCommand } from './build';\nimport { command as consoleCommand } from './console';\nimport { command as developCommand } from './develop';\nimport { command as generateCommand } from './generate';\nimport { command as reportCommand } from './report';\nimport { command as startCommand } from './start';\nimport { command as versionCommand } from './version';\nimport { command as openAPICommand } from './openapi';\nimport exportCommand from './export/command';\nimport importCommand from './import/command';\nimport transferCommand from './transfer/command';\n\nimport { StrapiCommand } from '../types';\n\nexport const commands: StrapiCommand[] = [\n  createAdminUser,\n  resetAdminUserPassword,\n  listComponents,\n  configurationDump,\n  configurationRestore,\n  consoleCommand,\n  listContentTypes,\n  listControllers,\n  generateCommand,\n  listHooks,\n  listMiddlewares,\n  listPolicies,\n  reportCommand,\n  listRoutes,\n  listServices,\n  startCommand,\n  disableTelemetry,\n  enableTelemetry,\n  generateTemplates,\n  generateTsTypes,\n  versionCommand,\n  buildCommand,\n  developCommand,\n  exportCommand,\n  importCommand,\n  transferCommand,\n  openAPICommand,\n  /**\n   * Cloud\n   */\n  cloudCommands,\n];\n"],"names":["commands","createAdminUser","resetAdminUserPassword","listComponents","configurationDump","configurationRestore","consoleCommand","listContentTypes","listControllers","generateCommand","listHooks","listMiddlewares","listPolicies","reportCommand","listRoutes","listServices","startCommand","disableTelemetry","enableTelemetry","generateTemplates","generateTsTypes","versionCommand","buildCommand","developCommand","exportCommand","importCommand","transferCommand","openAPICommand","cloudCommands"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAgCaA,QAA4B,GAAA;AACvCC,IAAAA,OAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACAC,IAAAA,SAAAA;AACA;;MAGAC;;;;;"}

package/dist/src/cli/commands/openapi/generate.js

@@ -0,0 +1,76 @@
+'use strict';
+
+var core = require('@strapi/core');
+var openapi = require('@strapi/openapi');
+var chalk = require('chalk');
+var fse = require('fs-extra');
+var path = require('path');
+
+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 openapi__namespace = /*#__PURE__*/_interopNamespaceDefault(openapi);
+
+const DEFAULT_OUTPUT = path.join(process.cwd(), 'specification.json');
+const EXPERIMENTAL_MSG = chalk.yellow(`
+⚠️  The OpenAPI generation feature is currently experimental.
+    Its behavior and output might change in future releases without following semver.
+    Please report any issues you encounter on https://github.com/strapi/strapi/issues/new?template=BUG_REPORT.yml.
+`);
+/**
+ * @experimental
+ */ const action = async (options)=>{
+    console.warn(EXPERIMENTAL_MSG);
+    const filePath = options.output ?? DEFAULT_OUTPUT;
+    const app = await createStrapiApp();
+    const { document, durationMs } = openapi__namespace.generate(app, {
+        type: 'content-api'
+    });
+    writeDocumentToFile(document, filePath);
+    summarize(app, durationMs, filePath);
+    await teardownStrapiApp(app);
+};
+const createStrapiApp = async ()=>{
+    const appContext = await core.compileStrapi();
+    const app = core.createStrapi(appContext);
+    // Make sure to not log Strapi debug info
+    app.log.level = 'error';
+    // Load internals
+    await app.load();
+    // Make sure the routes are mounted before generating the specification
+    app.server.mount();
+    return app;
+};
+const writeDocumentToFile = (document, filePath)=>{
+    fse.outputFileSync(filePath, JSON.stringify(document, null, 2));
+};
+const teardownStrapiApp = async (app)=>{
+    await app.destroy();
+};
+const summarize = (app, durationMs, filePath)=>{
+    const cwd = process.cwd();
+    const relativeFilePath = path.relative(cwd, filePath);
+    const { name, version } = app.config.get('info');
+    const fName = chalk.cyan(name);
+    const fVersion = chalk.cyan(`v${version}`);
+    const fFile = chalk.magenta(relativeFilePath);
+    const fTime = chalk.green(`${durationMs}ms`);
+    console.log(chalk.bold(`Generated an OpenAPI specification for "${fName} ${fVersion}" at ${fFile} in ${fTime}`));
+};
+
+exports.action = action;
+//# sourceMappingURL=generate.js.map

package/dist/src/cli/commands/openapi/generate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.js","sources":["../../../../../src/cli/commands/openapi/generate.ts"],"sourcesContent":["import { compileStrapi, createStrapi } from '@strapi/core';\nimport * as openapi from '@strapi/openapi';\n\nimport type { Core } from '@strapi/types';\n\nimport chalk from 'chalk';\nimport fse from 'fs-extra';\nimport path from 'path';\n\nconst DEFAULT_OUTPUT = path.join(process.cwd(), 'specification.json');\n\ninterface CommandOptions {\n  output?: string;\n}\n\ninterface StrapiInfoConfig {\n  name: string;\n  version: string;\n}\n\nconst EXPERIMENTAL_MSG = chalk.yellow(`\n⚠️  The OpenAPI generation feature is currently experimental.\n    Its behavior and output might change in future releases without following semver.\n    Please report any issues you encounter on https://github.com/strapi/strapi/issues/new?template=BUG_REPORT.yml.\n`);\n\n/**\n * @experimental\n */\nconst action = async (options: CommandOptions) => {\n  console.warn(EXPERIMENTAL_MSG);\n\n  const filePath = options.output ?? DEFAULT_OUTPUT;\n  const app = await createStrapiApp();\n\n  const { document, durationMs } = openapi.generate(app, { type: 'content-api' });\n\n  writeDocumentToFile(document, filePath);\n  summarize(app, durationMs, filePath);\n\n  await teardownStrapiApp(app);\n};\n\nconst createStrapiApp = async (): Promise<Core.Strapi> => {\n  const appContext = await compileStrapi();\n  const app = createStrapi(appContext);\n\n  // Make sure to not log Strapi debug info\n  app.log.level = 'error';\n\n  // Load internals\n  await app.load();\n\n  // Make sure the routes are mounted before generating the specification\n  app.server.mount();\n\n  return app;\n};\n\nconst writeDocumentToFile = (document: unknown, filePath: string): void => {\n  fse.outputFileSync(filePath, JSON.stringify(document, null, 2));\n};\n\nconst teardownStrapiApp = async (app: Core.Strapi) => {\n  await app.destroy();\n};\n\nconst summarize = (app: Core.Strapi, durationMs: number, filePath: string): void => {\n  const cwd = process.cwd();\n  const relativeFilePath = path.relative(cwd, filePath);\n  const { name, version } = app.config.get<StrapiInfoConfig>('info');\n\n  const fName = chalk.cyan(name);\n  const fVersion = chalk.cyan(`v${version}`);\n  const fFile = chalk.magenta(relativeFilePath);\n  const fTime = chalk.green(`${durationMs}ms`);\n\n  console.log(\n    chalk.bold(\n      `Generated an OpenAPI specification for \"${fName} ${fVersion}\" at ${fFile} in ${fTime}`\n    )\n  );\n};\n\nexport { action };\n"],"names":["DEFAULT_OUTPUT","path","join","process","cwd","EXPERIMENTAL_MSG","chalk","yellow","action","options","console","warn","filePath","output","app","createStrapiApp","document","durationMs","openapi","generate","type","writeDocumentToFile","summarize","teardownStrapiApp","appContext","compileStrapi","createStrapi","log","level","load","server","mount","fse","outputFileSync","JSON","stringify","destroy","relativeFilePath","relative","name","version","config","get","fName","cyan","fVersion","fFile","magenta","fTime","green","bold"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;AASA,MAAMA,iBAAiBC,IAAKC,CAAAA,IAAI,CAACC,OAAAA,CAAQC,GAAG,EAAI,EAAA,oBAAA,CAAA;AAWhD,MAAMC,gBAAmBC,GAAAA,KAAAA,CAAMC,MAAM,CAAC;;;;AAItC,CAAC,CAAA;AAED;;IAGA,MAAMC,SAAS,OAAOC,OAAAA,GAAAA;AACpBC,IAAAA,OAAAA,CAAQC,IAAI,CAACN,gBAAAA,CAAAA;IAEb,MAAMO,QAAAA,GAAWH,OAAQI,CAAAA,MAAM,IAAIb,cAAAA;AACnC,IAAA,MAAMc,MAAM,MAAMC,eAAAA,EAAAA;IAElB,MAAM,EAAEC,QAAQ,EAAEC,UAAU,EAAE,GAAGC,kBAAAA,CAAQC,QAAQ,CAACL,GAAK,EAAA;QAAEM,IAAM,EAAA;AAAc,KAAA,CAAA;AAE7EC,IAAAA,mBAAAA,CAAoBL,QAAUJ,EAAAA,QAAAA,CAAAA;AAC9BU,IAAAA,SAAAA,CAAUR,KAAKG,UAAYL,EAAAA,QAAAA,CAAAA;AAE3B,IAAA,MAAMW,iBAAkBT,CAAAA,GAAAA,CAAAA;AAC1B;AAEA,MAAMC,eAAkB,GAAA,UAAA;AACtB,IAAA,MAAMS,aAAa,MAAMC,kBAAAA,EAAAA;AACzB,IAAA,MAAMX,MAAMY,iBAAaF,CAAAA,UAAAA,CAAAA;;IAGzBV,GAAIa,CAAAA,GAAG,CAACC,KAAK,GAAG,OAAA;;AAGhB,IAAA,MAAMd,IAAIe,IAAI,EAAA;;IAGdf,GAAIgB,CAAAA,MAAM,CAACC,KAAK,EAAA;IAEhB,OAAOjB,GAAAA;AACT,CAAA;AAEA,MAAMO,mBAAAA,GAAsB,CAACL,QAAmBJ,EAAAA,QAAAA,GAAAA;AAC9CoB,IAAAA,GAAAA,CAAIC,cAAc,CAACrB,QAAAA,EAAUsB,KAAKC,SAAS,CAACnB,UAAU,IAAM,EAAA,CAAA,CAAA,CAAA;AAC9D,CAAA;AAEA,MAAMO,oBAAoB,OAAOT,GAAAA,GAAAA;AAC/B,IAAA,MAAMA,IAAIsB,OAAO,EAAA;AACnB,CAAA;AAEA,MAAMd,SAAAA,GAAY,CAACR,GAAAA,EAAkBG,UAAoBL,EAAAA,QAAAA,GAAAA;IACvD,MAAMR,GAAAA,GAAMD,QAAQC,GAAG,EAAA;AACvB,IAAA,MAAMiC,gBAAmBpC,GAAAA,IAAAA,CAAKqC,QAAQ,CAAClC,GAAKQ,EAAAA,QAAAA,CAAAA;IAC5C,MAAM,EAAE2B,IAAI,EAAEC,OAAO,EAAE,GAAG1B,GAAI2B,CAAAA,MAAM,CAACC,GAAG,CAAmB,MAAA,CAAA;IAE3D,MAAMC,KAAAA,GAAQrC,KAAMsC,CAAAA,IAAI,CAACL,IAAAA,CAAAA;IACzB,MAAMM,QAAAA,GAAWvC,MAAMsC,IAAI,CAAC,CAAC,CAAC,EAAEJ,QAAQ,CAAC,CAAA;IACzC,MAAMM,KAAAA,GAAQxC,KAAMyC,CAAAA,OAAO,CAACV,gBAAAA,CAAAA;IAC5B,MAAMW,KAAAA,GAAQ1C,MAAM2C,KAAK,CAAC,CAAC,EAAEhC,UAAAA,CAAW,EAAE,CAAC,CAAA;AAE3CP,IAAAA,OAAAA,CAAQiB,GAAG,CACTrB,KAAAA,CAAM4C,IAAI,CACR,CAAC,wCAAwC,EAAEP,KAAAA,CAAM,CAAC,EAAEE,SAAS,KAAK,EAAEC,MAAM,IAAI,EAAEE,MAAM,CAAC,CAAA,CAAA;AAG7F,CAAA;;;;"}

package/dist/src/cli/commands/openapi/generate.mjs

@@ -0,0 +1,55 @@
+import { compileStrapi, createStrapi } from '@strapi/core';
+import * as openapi from '@strapi/openapi';
+import chalk from 'chalk';
+import fse from 'fs-extra';
+import path from 'path';
+
+const DEFAULT_OUTPUT = path.join(process.cwd(), 'specification.json');
+const EXPERIMENTAL_MSG = chalk.yellow(`
+⚠️  The OpenAPI generation feature is currently experimental.
+    Its behavior and output might change in future releases without following semver.
+    Please report any issues you encounter on https://github.com/strapi/strapi/issues/new?template=BUG_REPORT.yml.
+`);
+/**
+ * @experimental
+ */ const action = async (options)=>{
+    console.warn(EXPERIMENTAL_MSG);
+    const filePath = options.output ?? DEFAULT_OUTPUT;
+    const app = await createStrapiApp();
+    const { document, durationMs } = openapi.generate(app, {
+        type: 'content-api'
+    });
+    writeDocumentToFile(document, filePath);
+    summarize(app, durationMs, filePath);
+    await teardownStrapiApp(app);
+};
+const createStrapiApp = async ()=>{
+    const appContext = await compileStrapi();
+    const app = createStrapi(appContext);
+    // Make sure to not log Strapi debug info
+    app.log.level = 'error';
+    // Load internals
+    await app.load();
+    // Make sure the routes are mounted before generating the specification
+    app.server.mount();
+    return app;
+};
+const writeDocumentToFile = (document, filePath)=>{
+    fse.outputFileSync(filePath, JSON.stringify(document, null, 2));
+};
+const teardownStrapiApp = async (app)=>{
+    await app.destroy();
+};
+const summarize = (app, durationMs, filePath)=>{
+    const cwd = process.cwd();
+    const relativeFilePath = path.relative(cwd, filePath);
+    const { name, version } = app.config.get('info');
+    const fName = chalk.cyan(name);
+    const fVersion = chalk.cyan(`v${version}`);
+    const fFile = chalk.magenta(relativeFilePath);
+    const fTime = chalk.green(`${durationMs}ms`);
+    console.log(chalk.bold(`Generated an OpenAPI specification for "${fName} ${fVersion}" at ${fFile} in ${fTime}`));
+};
+
+export { action };
+//# sourceMappingURL=generate.mjs.map

package/dist/src/cli/commands/openapi/generate.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.mjs","sources":["../../../../../src/cli/commands/openapi/generate.ts"],"sourcesContent":["import { compileStrapi, createStrapi } from '@strapi/core';\nimport * as openapi from '@strapi/openapi';\n\nimport type { Core } from '@strapi/types';\n\nimport chalk from 'chalk';\nimport fse from 'fs-extra';\nimport path from 'path';\n\nconst DEFAULT_OUTPUT = path.join(process.cwd(), 'specification.json');\n\ninterface CommandOptions {\n  output?: string;\n}\n\ninterface StrapiInfoConfig {\n  name: string;\n  version: string;\n}\n\nconst EXPERIMENTAL_MSG = chalk.yellow(`\n⚠️  The OpenAPI generation feature is currently experimental.\n    Its behavior and output might change in future releases without following semver.\n    Please report any issues you encounter on https://github.com/strapi/strapi/issues/new?template=BUG_REPORT.yml.\n`);\n\n/**\n * @experimental\n */\nconst action = async (options: CommandOptions) => {\n  console.warn(EXPERIMENTAL_MSG);\n\n  const filePath = options.output ?? DEFAULT_OUTPUT;\n  const app = await createStrapiApp();\n\n  const { document, durationMs } = openapi.generate(app, { type: 'content-api' });\n\n  writeDocumentToFile(document, filePath);\n  summarize(app, durationMs, filePath);\n\n  await teardownStrapiApp(app);\n};\n\nconst createStrapiApp = async (): Promise<Core.Strapi> => {\n  const appContext = await compileStrapi();\n  const app = createStrapi(appContext);\n\n  // Make sure to not log Strapi debug info\n  app.log.level = 'error';\n\n  // Load internals\n  await app.load();\n\n  // Make sure the routes are mounted before generating the specification\n  app.server.mount();\n\n  return app;\n};\n\nconst writeDocumentToFile = (document: unknown, filePath: string): void => {\n  fse.outputFileSync(filePath, JSON.stringify(document, null, 2));\n};\n\nconst teardownStrapiApp = async (app: Core.Strapi) => {\n  await app.destroy();\n};\n\nconst summarize = (app: Core.Strapi, durationMs: number, filePath: string): void => {\n  const cwd = process.cwd();\n  const relativeFilePath = path.relative(cwd, filePath);\n  const { name, version } = app.config.get<StrapiInfoConfig>('info');\n\n  const fName = chalk.cyan(name);\n  const fVersion = chalk.cyan(`v${version}`);\n  const fFile = chalk.magenta(relativeFilePath);\n  const fTime = chalk.green(`${durationMs}ms`);\n\n  console.log(\n    chalk.bold(\n      `Generated an OpenAPI specification for \"${fName} ${fVersion}\" at ${fFile} in ${fTime}`\n    )\n  );\n};\n\nexport { action };\n"],"names":["DEFAULT_OUTPUT","path","join","process","cwd","EXPERIMENTAL_MSG","chalk","yellow","action","options","console","warn","filePath","output","app","createStrapiApp","document","durationMs","openapi","generate","type","writeDocumentToFile","summarize","teardownStrapiApp","appContext","compileStrapi","createStrapi","log","level","load","server","mount","fse","outputFileSync","JSON","stringify","destroy","relativeFilePath","relative","name","version","config","get","fName","cyan","fVersion","fFile","magenta","fTime","green","bold"],"mappings":";;;;;;AASA,MAAMA,iBAAiBC,IAAKC,CAAAA,IAAI,CAACC,OAAAA,CAAQC,GAAG,EAAI,EAAA,oBAAA,CAAA;AAWhD,MAAMC,gBAAmBC,GAAAA,KAAAA,CAAMC,MAAM,CAAC;;;;AAItC,CAAC,CAAA;AAED;;IAGA,MAAMC,SAAS,OAAOC,OAAAA,GAAAA;AACpBC,IAAAA,OAAAA,CAAQC,IAAI,CAACN,gBAAAA,CAAAA;IAEb,MAAMO,QAAAA,GAAWH,OAAQI,CAAAA,MAAM,IAAIb,cAAAA;AACnC,IAAA,MAAMc,MAAM,MAAMC,eAAAA,EAAAA;IAElB,MAAM,EAAEC,QAAQ,EAAEC,UAAU,EAAE,GAAGC,OAAAA,CAAQC,QAAQ,CAACL,GAAK,EAAA;QAAEM,IAAM,EAAA;AAAc,KAAA,CAAA;AAE7EC,IAAAA,mBAAAA,CAAoBL,QAAUJ,EAAAA,QAAAA,CAAAA;AAC9BU,IAAAA,SAAAA,CAAUR,KAAKG,UAAYL,EAAAA,QAAAA,CAAAA;AAE3B,IAAA,MAAMW,iBAAkBT,CAAAA,GAAAA,CAAAA;AAC1B;AAEA,MAAMC,eAAkB,GAAA,UAAA;AACtB,IAAA,MAAMS,aAAa,MAAMC,aAAAA,EAAAA;AACzB,IAAA,MAAMX,MAAMY,YAAaF,CAAAA,UAAAA,CAAAA;;IAGzBV,GAAIa,CAAAA,GAAG,CAACC,KAAK,GAAG,OAAA;;AAGhB,IAAA,MAAMd,IAAIe,IAAI,EAAA;;IAGdf,GAAIgB,CAAAA,MAAM,CAACC,KAAK,EAAA;IAEhB,OAAOjB,GAAAA;AACT,CAAA;AAEA,MAAMO,mBAAAA,GAAsB,CAACL,QAAmBJ,EAAAA,QAAAA,GAAAA;AAC9CoB,IAAAA,GAAAA,CAAIC,cAAc,CAACrB,QAAAA,EAAUsB,KAAKC,SAAS,CAACnB,UAAU,IAAM,EAAA,CAAA,CAAA,CAAA;AAC9D,CAAA;AAEA,MAAMO,oBAAoB,OAAOT,GAAAA,GAAAA;AAC/B,IAAA,MAAMA,IAAIsB,OAAO,EAAA;AACnB,CAAA;AAEA,MAAMd,SAAAA,GAAY,CAACR,GAAAA,EAAkBG,UAAoBL,EAAAA,QAAAA,GAAAA;IACvD,MAAMR,GAAAA,GAAMD,QAAQC,GAAG,EAAA;AACvB,IAAA,MAAMiC,gBAAmBpC,GAAAA,IAAAA,CAAKqC,QAAQ,CAAClC,GAAKQ,EAAAA,QAAAA,CAAAA;IAC5C,MAAM,EAAE2B,IAAI,EAAEC,OAAO,EAAE,GAAG1B,GAAI2B,CAAAA,MAAM,CAACC,GAAG,CAAmB,MAAA,CAAA;IAE3D,MAAMC,KAAAA,GAAQrC,KAAMsC,CAAAA,IAAI,CAACL,IAAAA,CAAAA;IACzB,MAAMM,QAAAA,GAAWvC,MAAMsC,IAAI,CAAC,CAAC,CAAC,EAAEJ,QAAQ,CAAC,CAAA;IACzC,MAAMM,KAAAA,GAAQxC,KAAMyC,CAAAA,OAAO,CAACV,gBAAAA,CAAAA;IAC5B,MAAMW,KAAAA,GAAQ1C,MAAM2C,KAAK,CAAC,CAAC,EAAEhC,UAAAA,CAAW,EAAE,CAAC,CAAA;AAE3CP,IAAAA,OAAAA,CAAQiB,GAAG,CACTrB,KAAAA,CAAM4C,IAAI,CACR,CAAC,wCAAwC,EAAEP,KAAAA,CAAM,CAAC,EAAEE,SAAS,KAAK,EAAEC,MAAM,IAAI,EAAEE,MAAM,CAAC,CAAA,CAAA;AAG7F,CAAA;;;;"}

package/dist/src/cli/commands/openapi/index.js

@@ -0,0 +1,17 @@
+'use strict';
+
+var commander = require('commander');
+var helpers = require('../../utils/helpers.js');
+var generate = require('./generate.js');
+
+/**
+ * `$ strapi openapi`
+ */ const command = ()=>{
+    const openapi = commander.createCommand('openapi').description('Manage OpenAPI specifications for your Strapi application');
+    // `$ strapi openapi generate [-o, --output <path>]`
+    openapi.command('generate').description('Generate an OpenAPI specification for the current Strapi application').option('-o, --output <path>', 'Output file path for the OpenAPI specification').action(helpers.runAction('openapi:generate', generate.action));
+    return openapi;
+};
+
+exports.command = command;
+//# sourceMappingURL=index.js.map

package/dist/src/cli/commands/openapi/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../../../../src/cli/commands/openapi/index.ts"],"sourcesContent":["import { createCommand } from 'commander';\n\nimport type { StrapiCommand } from '../../types';\nimport { runAction } from '../../utils/helpers';\nimport { action as generate } from './generate';\n\n/**\n * `$ strapi openapi`\n */\nconst command: StrapiCommand = () => {\n  const openapi = createCommand('openapi').description(\n    'Manage OpenAPI specifications for your Strapi application'\n  );\n\n  // `$ strapi openapi generate [-o, --output <path>]`\n  openapi\n    .command('generate')\n    .description('Generate an OpenAPI specification for the current Strapi application')\n    .option('-o, --output <path>', 'Output file path for the OpenAPI specification')\n    .action(runAction('openapi:generate', generate));\n\n  return openapi;\n};\n\nexport { command };\n"],"names":["command","openapi","createCommand","description","option","action","runAction","generate"],"mappings":";;;;;;AAMA;;AAEC,UACKA,OAAyB,GAAA,IAAA;AAC7B,IAAA,MAAMC,OAAUC,GAAAA,uBAAAA,CAAc,SAAWC,CAAAA,CAAAA,WAAW,CAClD,2DAAA,CAAA;;AAIFF,IAAAA,OAAAA,CACGD,OAAO,CAAC,UACRG,CAAAA,CAAAA,WAAW,CAAC,sEAAA,CAAA,CACZC,MAAM,CAAC,qBAAuB,EAAA,gDAAA,CAAA,CAC9BC,MAAM,CAACC,kBAAU,kBAAoBC,EAAAA,eAAAA,CAAAA,CAAAA;IAExC,OAAON,OAAAA;AACT;;;;"}

package/dist/src/cli/commands/openapi/index.mjs

@@ -0,0 +1,15 @@
+import { createCommand } from 'commander';
+import { runAction } from '../../utils/helpers.mjs';
+import { action } from './generate.mjs';
+
+/**
+ * `$ strapi openapi`
+ */ const command = ()=>{
+    const openapi = createCommand('openapi').description('Manage OpenAPI specifications for your Strapi application');
+    // `$ strapi openapi generate [-o, --output <path>]`
+    openapi.command('generate').description('Generate an OpenAPI specification for the current Strapi application').option('-o, --output <path>', 'Output file path for the OpenAPI specification').action(runAction('openapi:generate', action));
+    return openapi;
+};
+
+export { command };
+//# sourceMappingURL=index.mjs.map

package/dist/src/cli/commands/openapi/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../../../../src/cli/commands/openapi/index.ts"],"sourcesContent":["import { createCommand } from 'commander';\n\nimport type { StrapiCommand } from '../../types';\nimport { runAction } from '../../utils/helpers';\nimport { action as generate } from './generate';\n\n/**\n * `$ strapi openapi`\n */\nconst command: StrapiCommand = () => {\n  const openapi = createCommand('openapi').description(\n    'Manage OpenAPI specifications for your Strapi application'\n  );\n\n  // `$ strapi openapi generate [-o, --output <path>]`\n  openapi\n    .command('generate')\n    .description('Generate an OpenAPI specification for the current Strapi application')\n    .option('-o, --output <path>', 'Output file path for the OpenAPI specification')\n    .action(runAction('openapi:generate', generate));\n\n  return openapi;\n};\n\nexport { command };\n"],"names":["command","openapi","createCommand","description","option","action","runAction","generate"],"mappings":";;;;AAMA;;AAEC,UACKA,OAAyB,GAAA,IAAA;AAC7B,IAAA,MAAMC,OAAUC,GAAAA,aAAAA,CAAc,SAAWC,CAAAA,CAAAA,WAAW,CAClD,2DAAA,CAAA;;AAIFF,IAAAA,OAAAA,CACGD,OAAO,CAAC,UACRG,CAAAA,CAAAA,WAAW,CAAC,sEAAA,CAAA,CACZC,MAAM,CAAC,qBAAuB,EAAA,gDAAA,CAAA,CAC9BC,MAAM,CAACC,UAAU,kBAAoBC,EAAAA,MAAAA,CAAAA,CAAAA;IAExC,OAAON,OAAAA;AACT;;;;"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@strapi/strapi",
-  "version": "5.19.0",
+  "version": "5.20.0",
   "description": "An open source headless CMS solution to create and manage your own API. It provides a powerful dashboard and features to make your life easier. Databases supported: MySQL, MariaDB, PostgreSQL, SQLite",
   "keywords": [
     "strapi",
@@ -110,24 +110,25 @@
   },
   "dependencies": {
     "@pmmmwh/react-refresh-webpack-plugin": "0.5.15",
-    "@strapi/admin": "5.19.0",
-    "@strapi/cloud-cli": "5.19.0",
-    "@strapi/content-manager": "5.19.0",
-    "@strapi/content-releases": "5.19.0",
-    "@strapi/content-type-builder": "5.19.0",
-    "@strapi/core": "5.19.0",
-    "@strapi/data-transfer": "5.19.0",
-    "@strapi/database": "5.19.0",
-    "@strapi/email": "5.19.0",
-    "@strapi/generators": "5.19.0",
-    "@strapi/i18n": "5.19.0",
-    "@strapi/logger": "5.19.0",
-    "@strapi/permissions": "5.19.0",
-    "@strapi/review-workflows": "5.19.0",
-    "@strapi/types": "5.19.0",
-    "@strapi/typescript-utils": "5.19.0",
-    "@strapi/upload": "5.19.0",
-    "@strapi/utils": "5.19.0",
+    "@strapi/admin": "5.20.0",
+    "@strapi/cloud-cli": "5.20.0",
+    "@strapi/content-manager": "5.20.0",
+    "@strapi/content-releases": "5.20.0",
+    "@strapi/content-type-builder": "5.20.0",
+    "@strapi/core": "5.20.0",
+    "@strapi/data-transfer": "5.20.0",
+    "@strapi/database": "5.20.0",
+    "@strapi/email": "5.20.0",
+    "@strapi/generators": "5.20.0",
+    "@strapi/i18n": "5.20.0",
+    "@strapi/logger": "5.20.0",
+    "@strapi/openapi": "5.20.0",
+    "@strapi/permissions": "5.20.0",
+    "@strapi/review-workflows": "5.20.0",
+    "@strapi/types": "5.20.0",
+    "@strapi/typescript-utils": "5.20.0",
+    "@strapi/upload": "5.20.0",
+    "@strapi/utils": "5.20.0",
     "@types/nodemon": "1.19.6",
     "@vitejs/plugin-react-swc": "3.6.0",
     "boxen": "5.1.2",
@@ -181,11 +182,11 @@
     "@types/node": "18.19.24",
     "@types/webpack-bundle-analyzer": "4.7.0",
     "@types/webpack-hot-middleware": "2.25.9",
-    "eslint-config-custom": "5.19.0",
+    "eslint-config-custom": "5.20.0",
     "jest": "29.6.0",
     "react": "18.3.1",
     "react-dom": "18.3.1",
-    "tsconfig": "5.19.0"
+    "tsconfig": "5.20.0"
   },
   "peerDependencies": {
     "react": "^17.0.0 || ^18.0.0",