@solidxai/core 0.1.6-beta.14 → 0.1.6-beta.15

package/dist/helpers/bootstrap.helper.d.ts

@@ -10,4 +10,5 @@ export interface SolidBootstrapOptions {
     permissionsPolicyOverrides?: Partial<PermissionsPolicyConfig>;
 }
 export declare function bootstrapSolidApp(appModuleFactory: () => Promise<any>, options?: SolidBootstrapOptions): Promise<void>;
+export declare function bootstrapSolidCli(appModuleFactory: () => Promise<any>): Promise<void>;
 //# sourceMappingURL=bootstrap.helper.d.ts.map

package/dist/helpers/bootstrap.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.helper.d.ts","sourceRoot":"","sources":["../../src/helpers/bootstrap.helper.ts"],"names":[],"mappings":"AASA,OAAO,EAAmE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG7H,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IAEpC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;IAEtC,0BAA0B,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC/D;AAcD,wBAAsB,iBAAiB,CACrC,gBAAgB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,EACpC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAsGf"}
+{"version":3,"file":"bootstrap.helper.d.ts","sourceRoot":"","sources":["../../src/helpers/bootstrap.helper.ts"],"names":[],"mappings":"AAYA,OAAO,EAAmE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAyB7H,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IAEpC,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,OAAO,CAAC,EAAE,mBAAmB,GAAG,KAAK,CAAC;IAEtC,0BAA0B,CAAC,EAAE,OAAO,CAAC,uBAAuB,CAAC,CAAC;CAC/D;AAcD,wBAAsB,iBAAiB,CACrC,gBAAgB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,EACpC,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,IAAI,CAAC,CAgGf;AAgBD,wBAAsB,iBAAiB,CACrC,gBAAgB,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,GACnC,OAAO,CAAC,IAAI,CAAC,CAwCf"}

package/dist/helpers/bootstrap.helper.js

@@ -4,23 +4,36 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.bootstrapSolidApp = bootstrapSolidApp;
+exports.bootstrapSolidCli = bootstrapSolidCli;
 const common_1 = require("@nestjs/common");
 const core_1 = require("@nestjs/core");
 const swagger_1 = require("@nestjs/swagger");
 const helmet_1 = __importDefault(require("helmet"));
 const qs_1 = __importDefault(require("qs"));
+const fs_1 = require("fs");
+const path_1 = require("path");
 const nest_winston_1 = require("nest-winston");
+const nest_commander_1 = require("nest-commander");
 const wrap_response_interceptor_1 = require("../interceptors/wrap-response.interceptor");
 const cors_helper_1 = require("./cors.helper");
 const security_helper_1 = require("./security.helper");
 const environment_helper_1 = require("./environment.helper");
-async function bootstrapSolidApp(appModuleFactory, options = {}) {
+function registerGlobalProcessHandlers() {
     process.on('unhandledRejection', (reason, promise) => {
         console.error('Unhandled Rejection at:', promise, 'reason:', reason);
     });
     process.on('uncaughtException', (err) => {
         console.error('Uncaught Exception thrown:', err);
     });
+    process.on('warning', (warning) => {
+        if (warning.name === 'DeprecationWarning' && (warning.message.includes('client.query()') || warning.message.includes('punycode'))) {
+            return;
+        }
+        console.warn(warning);
+    });
+}
+async function bootstrapSolidApp(appModuleFactory, options = {}) {
+    registerGlobalProcessHandlers();
     const { globalPrefix = 'api', swagger = {}, permissionsPolicyOverrides = {} } = options;
     const appModule = await appModuleFactory();
     const app = await core_1.NestFactory.create(appModule);
@@ -83,4 +96,37 @@ async function bootstrapSolidApp(appModuleFactory, options = {}) {
     types.setTypeParser(types.builtins.INT8, (val) => parseInt(val));
     await app.listen(port);
 }
+async function bootstrapSolidCli(appModuleFactory) {
+    registerGlobalProcessHandlers();
+    process.on('exit', (code) => {
+        if (code !== 0) {
+            console.error(`Exiting with error status code: ${code}`);
+        }
+    });
+    const packageJsonPath = (0, path_1.resolve)(process.cwd(), 'package.json');
+    if (!(0, fs_1.existsSync)(packageJsonPath)) {
+        console.error('Does not seem to be a valid solid-api project.');
+        console.error('Exit reason: missing package.json in the current directory.');
+        process.exit(1);
+    }
+    const showLogs = process.argv.includes('--verbose') || process.argv.includes('-v');
+    for (const flag of ['--verbose', '-v']) {
+        const idx = process.argv.indexOf(flag);
+        if (idx !== -1)
+            process.argv.splice(idx, 1);
+    }
+    const appModule = await appModuleFactory();
+    process.env.SOLID_CLI_RUNNING = 'true';
+    const app = await nest_commander_1.CommandFactory.createWithoutRunning(appModule, {
+        logger: showLogs ? ['debug', 'error', 'fatal', 'log', 'verbose', 'warn'] : false,
+    });
+    try {
+        await nest_commander_1.CommandFactory.runApplication(app);
+    }
+    catch (e) {
+        console.error('CLI exited abruptly due to an error:', e);
+        process.exit(1);
+    }
+    process.exit(0);
+}
 //# sourceMappingURL=bootstrap.helper.js.map

package/dist/helpers/bootstrap.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"bootstrap.helper.js","sourceRoot":"","sources":["../../src/helpers/bootstrap.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { ValidationPipe } from '@nestjs/common';\nimport { NestFactory } from '@nestjs/core';\nimport { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';\nimport { NextFunction, Request, Response } from 'express';\nimport helmet from 'helmet';\nimport qs from 'qs';\nimport { WINSTON_MODULE_NEST_PROVIDER } from 'nest-winston';\nimport { WrapResponseInterceptor } from '../interceptors/wrap-response.interceptor';\nimport { buildDefaultCorsOptions } from './cors.helper';\nimport { buildDefaultSecurityHeaderOptions, buildPermissionsPolicyHeader, PermissionsPolicyConfig } from './security.helper';\nimport { parseBooleanEnv } from './environment.helper';\n\nexport interface SolidSwaggerOptions {\n  title?: string;\n  description?: string;\n  version?: string;\n}\n\nexport interface SolidBootstrapOptions {\n  /** Global API prefix. Defaults to 'api'. Set to '' to disable. */\n  globalPrefix?: string;\n  /** Swagger configuration. Set to false to disable Swagger entirely. */\n  swagger?: SolidSwaggerOptions | false;\n  /** Permissions-Policy header overrides (merged with defaults). */\n  permissionsPolicyOverrides?: Partial<PermissionsPolicyConfig>;\n}\n\n/**\n * Bootstraps a SolidX NestJS application with sensible defaults:\n * security headers, CORS, Winston logger, ValidationPipe,\n * WrapResponseInterceptor, qs deep query parsing, Swagger, and the\n * pg BIGINT type parser.\n *\n * @example\n * // main.ts\n * bootstrapSolidApp(() => AppModule.forRoot(), {\n *   swagger: { title: 'My API', description: 'My API description' },\n * });\n */\nexport async function bootstrapSolidApp(\n  appModuleFactory: () => Promise<any>,\n  options: SolidBootstrapOptions = {},\n): Promise<void> {\n  process.on('unhandledRejection', (reason, promise) => {\n    console.error('Unhandled Rejection at:', promise, 'reason:', reason);\n  });\n\n  process.on('uncaughtException', (err) => {\n    console.error('Uncaught Exception thrown:', err);\n  });\n\n  const { globalPrefix = 'api', swagger = {}, permissionsPolicyOverrides = {} } = options;\n\n  const appModule = await appModuleFactory();\n  const app = await NestFactory.create(appModule);\n\n  const apiEnabled = parseBooleanEnv('API_ENABLED', true);\n\n  if (!apiEnabled) {\n    await app.init();\n    app\n      .get(WINSTON_MODULE_NEST_PROVIDER)\n      .log('API server disabled via API_ENABLED=false. Skipping HTTP listen.', 'Bootstrap');\n    return;\n  }\n\n  // Health check at root path\n  const server = app.getHttpAdapter().getInstance();\n  server.get('/', (_req, res) => res.status(200).send('SOLID OK'));\n\n  // Security headers\n  app.use(helmet(buildDefaultSecurityHeaderOptions()));\n\n  // Permissions-Policy header\n  app.use((_req: Request, res: Response, next: NextFunction) => {\n    res.setHeader('Permissions-Policy', buildPermissionsPolicyHeader(permissionsPolicyOverrides));\n    next();\n  });\n\n  // Winston logger\n  app.useLogger(app.get(WINSTON_MODULE_NEST_PROVIDER));\n\n  const port = process.env.PORT || 3000;\n\n  if (globalPrefix) {\n    app.setGlobalPrefix(globalPrefix);\n  }\n\n  // qs-based deep query parsing (dot notation, nested objects, arrays)\n  app.use((req: Request, _res: Response, next: NextFunction) => {\n    if (req.query) {\n      req.query = qs.parse(req.url.split('?')[1], {\n        allowDots: true,\n        depth: 10,\n        arrayLimit: 100,\n      });\n    }\n    next();\n  });\n\n  // Global ValidationPipe\n  app.useGlobalPipes(\n    new ValidationPipe({\n      transform: true,\n      transformOptions: { enableImplicitConversion: true },\n    }),\n  );\n\n  // Swagger\n  if (swagger !== false) {\n    const { title = 'Solid Starters', description = 'Solid Starters API', version = '1.0' } = swagger;\n    const swaggerConfig = new DocumentBuilder()\n      .setTitle(title)\n      .setDescription(description)\n      .setVersion(version)\n      .setExternalDoc('Postman Collection', '/docs-json')\n      .addBearerAuth(\n        {\n          description: 'Please enter token in following format: Bearer <JWT>',\n          name: 'Authorization',\n          bearerFormat: 'Bearer',\n          scheme: 'Bearer',\n          type: 'http',\n          in: 'Header',\n        },\n        'jwt',\n      )\n      .build();\n    const document = SwaggerModule.createDocument(app, swaggerConfig);\n    SwaggerModule.setup('/docs', app, document);\n  }\n\n  // Global interceptor\n  app.useGlobalInterceptors(new WrapResponseInterceptor());\n\n  // CORS\n  app.enableCors(buildDefaultCorsOptions());\n\n  // Fix pg returning BIGINT columns as strings\n  // eslint-disable-next-line @typescript-eslint/no-var-requires\n  const types = require('pg').types;\n  types.setTypeParser(types.builtins.INT8, (val: string) => parseInt(val));\n\n  await app.listen(port);\n}\n"]}
+{"version":3,"file":"bootstrap.helper.js","sourceRoot":"","sources":["../../src/helpers/bootstrap.helper.ts"],"names":[],"mappings":"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","sourcesContent":["import { ValidationPipe } from '@nestjs/common';\nimport { NestFactory } from '@nestjs/core';\nimport { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';\nimport { NextFunction, Request, Response } from 'express';\nimport helmet from 'helmet';\nimport qs from 'qs';\nimport { existsSync } from 'fs';\nimport { resolve } from 'path';\nimport { WINSTON_MODULE_NEST_PROVIDER } from 'nest-winston';\nimport { CommandFactory } from 'nest-commander';\nimport { WrapResponseInterceptor } from '../interceptors/wrap-response.interceptor';\nimport { buildDefaultCorsOptions } from './cors.helper';\nimport { buildDefaultSecurityHeaderOptions, buildPermissionsPolicyHeader, PermissionsPolicyConfig } from './security.helper';\nimport { parseBooleanEnv } from './environment.helper';\n\n// ---- Shared process handlers ----\n\nfunction registerGlobalProcessHandlers() {\n  process.on('unhandledRejection', (reason, promise) => {\n    console.error('Unhandled Rejection at:', promise, 'reason:', reason);\n  });\n\n  process.on('uncaughtException', (err) => {\n    console.error('Uncaught Exception thrown:', err);\n  });\n\n  // Suppress pg deprecation warning caused by TypeORM's internal query scheduling\n  process.on('warning', (warning) => {\n    if (warning.name === 'DeprecationWarning' && (warning.message.includes('client.query()') || warning.message.includes('punycode'))) {\n      return;\n    }\n    console.warn(warning);\n  });\n}\n\n// ---- HTTP server bootstrap ----\n\nexport interface SolidSwaggerOptions {\n  title?: string;\n  description?: string;\n  version?: string;\n}\n\nexport interface SolidBootstrapOptions {\n  /** Global API prefix. Defaults to 'api'. Set to '' to disable. */\n  globalPrefix?: string;\n  /** Swagger configuration. Set to false to disable Swagger entirely. */\n  swagger?: SolidSwaggerOptions | false;\n  /** Permissions-Policy header overrides (merged with defaults). */\n  permissionsPolicyOverrides?: Partial<PermissionsPolicyConfig>;\n}\n\n/**\n * Bootstraps a SolidX NestJS HTTP application with sensible defaults:\n * security headers, CORS, Winston logger, ValidationPipe,\n * WrapResponseInterceptor, qs deep query parsing, Swagger, and the\n * pg BIGINT type parser.\n *\n * @example\n * // main.ts\n * bootstrapSolidApp(() => AppModule.forRoot(), {\n *   swagger: { title: 'My API', description: 'My API description' },\n * });\n */\nexport async function bootstrapSolidApp(\n  appModuleFactory: () => Promise<any>,\n  options: SolidBootstrapOptions = {},\n): Promise<void> {\n  registerGlobalProcessHandlers();\n\n  const { globalPrefix = 'api', swagger = {}, permissionsPolicyOverrides = {} } = options;\n\n  const appModule = await appModuleFactory();\n  const app = await NestFactory.create(appModule);\n\n  const apiEnabled = parseBooleanEnv('API_ENABLED', true);\n\n  if (!apiEnabled) {\n    await app.init();\n    app\n      .get(WINSTON_MODULE_NEST_PROVIDER)\n      .log('API server disabled via API_ENABLED=false. Skipping HTTP listen.', 'Bootstrap');\n    return;\n  }\n\n  // Health check at root path\n  const server = app.getHttpAdapter().getInstance();\n  server.get('/', (_req, res) => res.status(200).send('SOLID OK'));\n\n  // Security headers\n  app.use(helmet(buildDefaultSecurityHeaderOptions()));\n\n  // Permissions-Policy header\n  app.use((_req: Request, res: Response, next: NextFunction) => {\n    res.setHeader('Permissions-Policy', buildPermissionsPolicyHeader(permissionsPolicyOverrides));\n    next();\n  });\n\n  // Winston logger\n  app.useLogger(app.get(WINSTON_MODULE_NEST_PROVIDER));\n\n  const port = process.env.PORT || 3000;\n\n  if (globalPrefix) {\n    app.setGlobalPrefix(globalPrefix);\n  }\n\n  // qs-based deep query parsing (dot notation, nested objects, arrays)\n  app.use((req: Request, _res: Response, next: NextFunction) => {\n    if (req.query) {\n      req.query = qs.parse(req.url.split('?')[1], {\n        allowDots: true,\n        depth: 10,\n        arrayLimit: 100,\n      });\n    }\n    next();\n  });\n\n  // Global ValidationPipe\n  app.useGlobalPipes(\n    new ValidationPipe({\n      transform: true,\n      transformOptions: { enableImplicitConversion: true },\n    }),\n  );\n\n  // Swagger\n  if (swagger !== false) {\n    const { title = 'Solid Starters', description = 'Solid Starters API', version = '1.0' } = swagger;\n    const swaggerConfig = new DocumentBuilder()\n      .setTitle(title)\n      .setDescription(description)\n      .setVersion(version)\n      .setExternalDoc('Postman Collection', '/docs-json')\n      .addBearerAuth(\n        {\n          description: 'Please enter token in following format: Bearer <JWT>',\n          name: 'Authorization',\n          bearerFormat: 'Bearer',\n          scheme: 'Bearer',\n          type: 'http',\n          in: 'Header',\n        },\n        'jwt',\n      )\n      .build();\n    const document = SwaggerModule.createDocument(app, swaggerConfig);\n    SwaggerModule.setup('/docs', app, document);\n  }\n\n  // Global interceptor\n  app.useGlobalInterceptors(new WrapResponseInterceptor());\n\n  // CORS\n  app.enableCors(buildDefaultCorsOptions());\n\n  // Fix pg returning BIGINT columns as strings\n  // eslint-disable-next-line @typescript-eslint/no-var-requires\n  const types = require('pg').types;\n  types.setTypeParser(types.builtins.INT8, (val: string) => parseInt(val));\n\n  await app.listen(port);\n}\n\n// ---- CLI bootstrap ----\n\n/**\n * Bootstraps a SolidX NestJS CLI application using nest-commander.\n * Handles verbose flag stripping, project root validation, and clean process exit.\n *\n * @example\n * // main-cli.ts\n * #!/usr/bin/env node\n * import { bootstrapSolidCli } from '@solidxai/core';\n * import { AppModule } from './app.module';\n *\n * bootstrapSolidCli(() => AppModule.forRoot());\n */\nexport async function bootstrapSolidCli(\n  appModuleFactory: () => Promise<any>,\n): Promise<void> {\n  registerGlobalProcessHandlers();\n\n  process.on('exit', (code) => {\n    if (code !== 0) {\n      console.error(`Exiting with error status code: ${code}`);\n    }\n  });\n\n  // Validate that cwd is a valid Solid API project\n  const packageJsonPath = resolve(process.cwd(), 'package.json');\n  if (!existsSync(packageJsonPath)) {\n    console.error('Does not seem to be a valid solid-api project.');\n    console.error('Exit reason: missing package.json in the current directory.');\n    process.exit(1);\n  }\n\n  // Strip --verbose / -v before nest-commander processes argv\n  const showLogs = process.argv.includes('--verbose') || process.argv.includes('-v');\n  for (const flag of ['--verbose', '-v']) {\n    const idx = process.argv.indexOf(flag);\n    if (idx !== -1) process.argv.splice(idx, 1);\n  }\n\n  const appModule = await appModuleFactory();\n  process.env.SOLID_CLI_RUNNING = 'true';\n\n  // @ts-ignore\n  const app = await CommandFactory.createWithoutRunning(appModule, {\n    logger: showLogs ? ['debug', 'error', 'fatal', 'log', 'verbose', 'warn'] : false,\n  });\n\n  try {\n    await CommandFactory.runApplication(app);\n  } catch (e) {\n    console.error('CLI exited abruptly due to an error:', e);\n    process.exit(1);\n  }\n\n  process.exit(0);\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@solidxai/core",
-  "version": "0.1.6-beta.14",
+  "version": "0.1.6-beta.15",
   "description": "This module is a NestJS module containing all the required core providers required by a Solid application",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/helpers/bootstrap.helper.ts

@@ -4,12 +4,37 @@ import { DocumentBuilder, SwaggerModule } from '@nestjs/swagger';
 import { NextFunction, Request, Response } from 'express';
 import helmet from 'helmet';
 import qs from 'qs';
+import { existsSync } from 'fs';
+import { resolve } from 'path';
 import { WINSTON_MODULE_NEST_PROVIDER } from 'nest-winston';
+import { CommandFactory } from 'nest-commander';
 import { WrapResponseInterceptor } from '../interceptors/wrap-response.interceptor';
 import { buildDefaultCorsOptions } from './cors.helper';
 import { buildDefaultSecurityHeaderOptions, buildPermissionsPolicyHeader, PermissionsPolicyConfig } from './security.helper';
 import { parseBooleanEnv } from './environment.helper';
 
+// ---- Shared process handlers ----
+
+function registerGlobalProcessHandlers() {
+  process.on('unhandledRejection', (reason, promise) => {
+    console.error('Unhandled Rejection at:', promise, 'reason:', reason);
+  });
+
+  process.on('uncaughtException', (err) => {
+    console.error('Uncaught Exception thrown:', err);
+  });
+
+  // Suppress pg deprecation warning caused by TypeORM's internal query scheduling
+  process.on('warning', (warning) => {
+    if (warning.name === 'DeprecationWarning' && (warning.message.includes('client.query()') || warning.message.includes('punycode'))) {
+      return;
+    }
+    console.warn(warning);
+  });
+}
+
+// ---- HTTP server bootstrap ----
+
 export interface SolidSwaggerOptions {
   title?: string;
   description?: string;
@@ -26,7 +51,7 @@ export interface SolidBootstrapOptions {
 }
 
 /**
- * Bootstraps a SolidX NestJS application with sensible defaults:
+ * Bootstraps a SolidX NestJS HTTP application with sensible defaults:
  * security headers, CORS, Winston logger, ValidationPipe,
  * WrapResponseInterceptor, qs deep query parsing, Swagger, and the
  * pg BIGINT type parser.
@@ -41,13 +66,7 @@ export async function bootstrapSolidApp(
   appModuleFactory: () => Promise<any>,
   options: SolidBootstrapOptions = {},
 ): Promise<void> {
-  process.on('unhandledRejection', (reason, promise) => {
-    console.error('Unhandled Rejection at:', promise, 'reason:', reason);
-  });
-
-  process.on('uncaughtException', (err) => {
-    console.error('Uncaught Exception thrown:', err);
-  });
+  registerGlobalProcessHandlers();
 
   const { globalPrefix = 'api', swagger = {}, permissionsPolicyOverrides = {} } = options;
 
@@ -143,3 +162,61 @@ export async function bootstrapSolidApp(
 
   await app.listen(port);
 }
+
+// ---- CLI bootstrap ----
+
+/**
+ * Bootstraps a SolidX NestJS CLI application using nest-commander.
+ * Handles verbose flag stripping, project root validation, and clean process exit.
+ *
+ * @example
+ * // main-cli.ts
+ * #!/usr/bin/env node
+ * import { bootstrapSolidCli } from '@solidxai/core';
+ * import { AppModule } from './app.module';
+ *
+ * bootstrapSolidCli(() => AppModule.forRoot());
+ */
+export async function bootstrapSolidCli(
+  appModuleFactory: () => Promise<any>,
+): Promise<void> {
+  registerGlobalProcessHandlers();
+
+  process.on('exit', (code) => {
+    if (code !== 0) {
+      console.error(`Exiting with error status code: ${code}`);
+    }
+  });
+
+  // Validate that cwd is a valid Solid API project
+  const packageJsonPath = resolve(process.cwd(), 'package.json');
+  if (!existsSync(packageJsonPath)) {
+    console.error('Does not seem to be a valid solid-api project.');
+    console.error('Exit reason: missing package.json in the current directory.');
+    process.exit(1);
+  }
+
+  // Strip --verbose / -v before nest-commander processes argv
+  const showLogs = process.argv.includes('--verbose') || process.argv.includes('-v');
+  for (const flag of ['--verbose', '-v']) {
+    const idx = process.argv.indexOf(flag);
+    if (idx !== -1) process.argv.splice(idx, 1);
+  }
+
+  const appModule = await appModuleFactory();
+  process.env.SOLID_CLI_RUNNING = 'true';
+
+  // @ts-ignore
+  const app = await CommandFactory.createWithoutRunning(appModule, {
+    logger: showLogs ? ['debug', 'error', 'fatal', 'log', 'verbose', 'warn'] : false,
+  });
+
+  try {
+    await CommandFactory.runApplication(app);
+  } catch (e) {
+    console.error('CLI exited abruptly due to an error:', e);
+    process.exit(1);
+  }
+
+  process.exit(0);
+}