@adonisjs/core 6.1.5-4 → 6.1.5-6

package/build/commands/test.js

@@ -1,21 +1,33 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
     var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
     if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
 import { BaseCommand, flags, args } from '../modules/ace/main.js';
 import { detectAssetsBundler, importAssembler, importTypeScript } from '../src/internal_helpers.js';
-class Test extends BaseCommand {
+/**
+ * Test command is used to run tests with optional file watcher. Under the
+ * hood, we run "bin/test.js" file.
+ */
+export default class Test extends BaseCommand {
     static commandName = 'test';
     static description = 'Run tests along with the file watcher to re-run tests on file change';
     static options = {
         allowUnknownFlags: true,
         staysAlive: true,
     };
+    /**
+     * Log a development dependency is missing
+     */
     #logMissingDevelopmentDependency(dependency) {
         this.logger.error([
             `Cannot find package "${dependency}"`,
@@ -25,6 +37,48 @@ class Test extends BaseCommand {
             'If you are run tests inside a CI, make sure the NODE_ENV is set to "development"',
         ].join('\n'));
     }
+    /**
+     * Collection of unknown flags to pass to Japa
+     */
+    #getPassthroughFlags() {
+        return this.parsed.unknownFlags
+            .map((flag) => {
+            const value = this.parsed.flags[flag];
+            /**
+             * Not mentioning value when value is "true"
+             */
+            if (value === true) {
+                return [`--${flag}`];
+            }
+            /**
+             * Repeating flag multiple times when value is an array
+             */
+            if (Array.isArray(value)) {
+                return value.map((v) => [`--${flag}`, v]);
+            }
+            return [`--${flag}`, value];
+        })
+            .flat(2);
+    }
+    /**
+     * Returns the assets bundler config
+     */
+    async #getAssetsBundlerConfig() {
+        const assetsBundler = await detectAssetsBundler(this.app);
+        return assetsBundler
+            ? {
+                serve: this.assets === false ? false : true,
+                driver: assetsBundler.name,
+                cmd: assetsBundler.devServer.command,
+                args: (assetsBundler.devServer.args || []).concat(this.assetsArgs || []),
+            }
+            : {
+                serve: false,
+            };
+    }
+    /**
+     * Runs tests
+     */
     async run() {
         const assembler = await importAssembler(this.app);
         if (!assembler) {
@@ -32,55 +86,52 @@ class Test extends BaseCommand {
             this.exitCode = 1;
             return;
         }
-        const assetsBundler = await detectAssetsBundler(this.app);
-        const testRunner = new assembler.TestRunner(this.app.appRoot, {
+        this.testsRunner = new assembler.TestRunner(this.app.appRoot, {
             clearScreen: this.clear === false ? false : true,
             nodeArgs: this.parsed.nodeArgs,
-            scriptArgs: this.parsed.unknownFlags
-                .map((flag) => {
-                const value = this.parsed.flags[flag];
-                if (value === true) {
-                    return [`--${flag}`];
-                }
-                if (Array.isArray(value)) {
-                    return value.map((v) => [`--${flag}`, v]);
-                }
-                return [`--${flag}`, value];
-            })
-                .flat(2),
-            assets: assetsBundler
-                ? {
-                    serve: this.assets === false ? false : true,
-                    driver: assetsBundler.name,
-                    cmd: assetsBundler.devServerCommand,
-                    args: this.assetsArgs || [],
-                }
-                : {
-                    serve: false,
-                },
+            scriptArgs: this.#getPassthroughFlags(),
+            assets: await this.#getAssetsBundlerConfig(),
             filters: {
                 suites: this.suites,
                 files: this.files,
                 groups: this.groups,
                 tags: this.tags,
-                ignoreTags: this.ignoreTags,
                 tests: this.tests,
             },
+            failed: this.failed,
+            retries: this.retries,
+            timeout: this.timeout,
+            reporters: this.reporters,
             suites: this.app.rcFile.tests.suites.map((suite) => {
                 return {
                     name: suite.name,
-                    files: Array.isArray(suite.files) ? suite.files : [suite.files],
+                    files: suite.files,
                 };
             }),
             metaFiles: this.app.rcFile.metaFiles,
         });
-        testRunner.setLogger(this.logger);
-        testRunner.onClose((exitCode) => {
+        /**
+         * Share command logger with assembler, so that CLI flags like --no-ansi has
+         * similar impact for assembler logs as well.
+         */
+        this.testsRunner.setLogger(this.logger);
+        /**
+         * Exit command when the test runner is closed
+         */
+        this.testsRunner.onClose((exitCode) => {
             this.exitCode = exitCode;
+            this.terminate();
         });
-        testRunner.onError(() => {
+        /**
+         * Exit command when the dev server crashes
+         */
+        this.testsRunner.onError(() => {
             this.exitCode = 1;
+            this.terminate();
         });
+        /**
+         * Start the test runner in watch mode
+         */
         if (this.watch) {
             const ts = await importTypeScript(this.app);
             if (!ts) {
@@ -88,10 +139,10 @@ class Test extends BaseCommand {
                 this.exitCode = 1;
                 return;
             }
-            await testRunner.runAndWatch(ts, { poll: this.poll || false });
+            await this.testsRunner.runAndWatch(ts, { poll: this.poll || false });
         }
         else {
-            await testRunner.run();
+            await this.testsRunner.run();
         }
     }
 }
@@ -99,57 +150,54 @@ __decorate([
     args.spread({
         description: 'Mention suite names to run tests for selected suites',
         required: false,
-    }),
-    __metadata("design:type", Array)
+    })
 ], Test.prototype, "suites", void 0);
 __decorate([
-    flags.array({ description: 'Filter tests by the filename' }),
-    __metadata("design:type", Array)
+    flags.array({ description: 'Filter tests by the filename' })
 ], Test.prototype, "files", void 0);
 __decorate([
-    flags.array({ description: 'Filter tests by tags' }),
-    __metadata("design:type", Array)
+    flags.array({ description: 'Filter tests by tags' })
 ], Test.prototype, "tags", void 0);
 __decorate([
-    flags.array({ description: 'Run tests that does not have mentioned tags' }),
-    __metadata("design:type", Array)
-], Test.prototype, "ignoreTags", void 0);
-__decorate([
-    flags.array({ description: 'Filter tests by parent group title' }),
-    __metadata("design:type", Array)
+    flags.array({ description: 'Filter tests by parent group title' })
 ], Test.prototype, "groups", void 0);
 __decorate([
-    flags.array({ description: 'Filter tests by test title' }),
-    __metadata("design:type", Array)
+    flags.array({ description: 'Filter tests by test title' })
 ], Test.prototype, "tests", void 0);
 __decorate([
-    flags.boolean({ description: 'Watch filesystem and re-run tests on file change' }),
-    __metadata("design:type", Boolean)
+    flags.array({ description: 'Activate one or more test reporters' })
+], Test.prototype, "reporters", void 0);
+__decorate([
+    flags.boolean({ description: 'Watch filesystem and re-run tests on file change' })
 ], Test.prototype, "watch", void 0);
 __decorate([
-    flags.boolean({ description: 'Use polling to detect filesystem changes' }),
-    __metadata("design:type", Boolean)
+    flags.boolean({ description: 'Use polling to detect filesystem changes' })
 ], Test.prototype, "poll", void 0);
+__decorate([
+    flags.number({ description: 'Define default timeout for all tests' })
+], Test.prototype, "timeout", void 0);
+__decorate([
+    flags.number({ description: 'Define default retries for all tests' })
+], Test.prototype, "retries", void 0);
+__decorate([
+    flags.boolean({ description: 'Execute tests failed during the last run' })
+], Test.prototype, "failed", void 0);
 __decorate([
     flags.boolean({
         description: 'Clear the terminal for new logs after file change',
         showNegatedVariantInHelp: true,
         default: true,
-    }),
-    __metadata("design:type", Boolean)
+    })
 ], Test.prototype, "clear", void 0);
 __decorate([
     flags.boolean({
         description: 'Start assets bundler dev server.',
         showNegatedVariantInHelp: true,
         default: true,
-    }),
-    __metadata("design:type", Boolean)
+    })
 ], Test.prototype, "assets", void 0);
 __decorate([
     flags.array({
         description: 'Define CLI arguments to pass to the assets bundler',
-    }),
-    __metadata("design:type", Array)
+    })
 ], Test.prototype, "assetsArgs", void 0);
-export default Test;

package/build/factories/app.d.ts

@@ -1,2 +1 @@
 export * from '@adonisjs/application/factories';
-//# sourceMappingURL=app.d.ts.map

package/build/factories/app.js

@@ -1 +1,9 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 export * from '@adonisjs/application/factories';

package/build/factories/bodyparser.d.ts

@@ -1,2 +1 @@
 export * from '@adonisjs/bodyparser/factories';
-//# sourceMappingURL=bodyparser.d.ts.map

package/build/factories/bodyparser.js

@@ -1 +1,9 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 export * from '@adonisjs/bodyparser/factories';

package/build/factories/core/ace.d.ts

@@ -1,9 +1,11 @@
-/// <reference types="node" resolution-mode="require"/>
+/// <reference types="@types/node" resolution-mode="require"/>
 import { Ignitor } from '../../src/ignitor/main.js';
 import type { IgnitorOptions } from '../../src/types.js';
 import type { Kernel } from '../../modules/ace/kernel.js';
+/**
+ * Creates an instance of Ace kernel
+ */
 export declare class AceFactory {
     make(ignitor: Ignitor): Promise<Kernel>;
     make(appRoot: URL, options: IgnitorOptions): Promise<Kernel>;
 }
-//# sourceMappingURL=ace.d.ts.map

package/build/factories/core/ace.js

@@ -1,6 +1,17 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 import { IgnitorFactory } from './ignitor.js';
 import { Ignitor } from '../../src/ignitor/main.js';
 import { createAceKernel } from '../../modules/ace/create_kernel.js';
+/**
+ * Creates an instance of Ace kernel
+ */
 export class AceFactory {
     async make(ignitorOrAppRoot, options) {
         if (ignitorOrAppRoot instanceof Ignitor) {

package/build/factories/core/ignitor.d.ts

@@ -1,17 +1,35 @@
-/// <reference types="node" resolution-mode="require"/>
+/// <reference types="@types/node" resolution-mode="require"/>
 import { Ignitor } from '../../src/ignitor/main.js';
 import type { ApplicationService, IgnitorOptions } from '../../src/types.js';
 type FactoryParameters = {
     rcFileContents: Record<string, any>;
     config: Record<string, any>;
 };
+/**
+ * Ignitor factory creates an instance of the AdonisJS ignitor
+ */
 export declare class IgnitorFactory {
     #private;
+    /**
+     * Define preload actions to run.
+     */
     preload(action: (app: ApplicationService) => void | Promise<void>): this;
+    /**
+     * Merge custom factory parameters
+     */
     merge(params: Partial<FactoryParameters>): this;
+    /**
+     * Load core provider when booting the app
+     */
     withCoreProviders(): this;
+    /**
+     * Merge default config for the core features. A shallow merge
+     * is performed.
+     */
     withCoreConfig(): this;
+    /**
+     * Create ignitor instance
+     */
     create(appRoot: URL, options: IgnitorOptions): Ignitor;
 }
 export {};
-//# sourceMappingURL=ignitor.d.ts.map

package/build/factories/core/ignitor.js

@@ -1,16 +1,36 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 import { Ignitor } from '../../src/ignitor/main.js';
 import { defineConfig as defineHttpConfig } from '../../modules/http.js';
 import { defineConfig as defineLoggerConfig } from '../../modules/logger.js';
 import { defineConfig as defineHashConfig } from '../../modules/hash/main.js';
 import { defineConfig as defineBodyParserConfig } from '../../modules/bodyparser/main.js';
+/**
+ * Ignitor factory creates an instance of the AdonisJS ignitor
+ */
 export class IgnitorFactory {
     #preloadActions = [];
     #parameters = {};
+    /**
+     * A flag to know if we should load the core providers
+     */
     #loadCoreProviders = false;
+    /**
+     * Define preload actions to run.
+     */
     preload(action) {
         this.#preloadActions.push(action);
         return this;
     }
+    /**
+     * Merge core providers with user defined providers
+     */
     #mergeCoreProviders(providers) {
         return [
             '@adonisjs/core/providers/app_provider',
@@ -18,6 +38,9 @@ export class IgnitorFactory {
             '@adonisjs/core/providers/http_provider',
         ].concat(providers || []);
     }
+    /**
+     * Merge custom factory parameters
+     */
     merge(params) {
         if (params.config) {
             this.#parameters.config = Object.assign(this.#parameters.config || {}, params.config);
@@ -27,10 +50,17 @@ export class IgnitorFactory {
         }
         return this;
     }
+    /**
+     * Load core provider when booting the app
+     */
     withCoreProviders() {
         this.#loadCoreProviders = true;
         return this;
     }
+    /**
+     * Merge default config for the core features. A shallow merge
+     * is performed.
+     */
     withCoreConfig() {
         this.merge({
             config: {
@@ -58,6 +88,9 @@ export class IgnitorFactory {
         });
         return this;
     }
+    /**
+     * Create ignitor instance
+     */
     create(appRoot, options) {
         return new Ignitor(appRoot, options).tap((app) => {
             app.booted(async () => {

package/build/factories/core/main.d.ts

@@ -2,4 +2,3 @@ export { AceFactory } from './ace.js';
 export { StubsFactory } from '../stubs.js';
 export { IgnitorFactory } from './ignitor.js';
 export { TestUtilsFactory } from './test_utils.js';
-//# sourceMappingURL=main.d.ts.map

package/build/factories/core/main.js

@@ -1,3 +1,11 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 export { AceFactory } from './ace.js';
 export { StubsFactory } from '../stubs.js';
 export { IgnitorFactory } from './ignitor.js';

package/build/factories/core/test_utils.d.ts

@@ -1,9 +1,11 @@
-/// <reference types="node" resolution-mode="require"/>
+/// <reference types="@types/node" resolution-mode="require"/>
 import { Ignitor } from '../../index.js';
 import type { IgnitorOptions } from '../../src/types.js';
 import { TestUtils } from '../../src/test_utils/main.js';
+/**
+ * Creates an instance of TestUtils class
+ */
 export declare class TestUtilsFactory {
     create(ignitor: Ignitor): TestUtils;
     create(appRoot: URL, options: IgnitorOptions): TestUtils;
 }
-//# sourceMappingURL=test_utils.d.ts.map

package/build/factories/core/test_utils.js

@@ -1,6 +1,17 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 import { Ignitor } from '../../index.js';
 import { IgnitorFactory } from './ignitor.js';
 import { TestUtils } from '../../src/test_utils/main.js';
+/**
+ * Creates an instance of TestUtils class
+ */
 export class TestUtilsFactory {
     create(ignitorOrAppRoot, options) {
         if (ignitorOrAppRoot instanceof Ignitor) {

package/build/factories/encryption.d.ts

@@ -1,2 +1 @@
 export * from '@adonisjs/encryption/factories';
-//# sourceMappingURL=encryption.d.ts.map

package/build/factories/encryption.js

@@ -1 +1,9 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 export * from '@adonisjs/encryption/factories';

package/build/factories/events.d.ts

@@ -1,2 +1 @@
 export * from '@adonisjs/events/factories';
-//# sourceMappingURL=events.d.ts.map

package/build/factories/events.js

@@ -1 +1,9 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 export * from '@adonisjs/events/factories';

package/build/factories/hash.d.ts

@@ -1,2 +1 @@
 export * from '@adonisjs/hash/factories';
-//# sourceMappingURL=hash.d.ts.map

package/build/factories/hash.js

@@ -1 +1,9 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 export * from '@adonisjs/hash/factories';

package/build/factories/http.d.ts

@@ -1,2 +1 @@
 export * from '@adonisjs/http-server/factories';
-//# sourceMappingURL=http.d.ts.map

package/build/factories/http.js

@@ -1 +1,9 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 export * from '@adonisjs/http-server/factories';

package/build/factories/logger.d.ts

@@ -1,2 +1 @@
 export * from '@adonisjs/logger/factories';
-//# sourceMappingURL=logger.d.ts.map

package/build/factories/logger.js

@@ -1 +1,9 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 export * from '@adonisjs/logger/factories';

package/build/factories/stubs.d.ts

@@ -2,9 +2,19 @@ import type { ApplicationService } from '../src/types.js';
 type FactoryParameters = {
     app: ApplicationService;
 };
+/**
+ * Prepares stubs from "@adonisjs/core" package. We do not publish this class as it
+ * is for internal testing only using the "stubsRoot" of the core package
+ */
 export declare class StubsFactory {
     #private;
+    /**
+     * Merge custom factory parameters
+     */
     merge(params: Partial<FactoryParameters>): this;
+    /**
+     * Prepares a stub
+     */
     prepare(stubPath: string, data: Record<string, any>): Promise<{
         contents: any;
         destination: any;
@@ -13,4 +23,3 @@ export declare class StubsFactory {
     }>;
 }
 export {};
-//# sourceMappingURL=stubs.d.ts.map

package/build/factories/stubs.js

@@ -1,14 +1,35 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 import { AppFactory } from '@adonisjs/application/factories';
 import { stubsRoot } from '../index.js';
+/**
+ * Prepares stubs from "@adonisjs/core" package. We do not publish this class as it
+ * is for internal testing only using the "stubsRoot" of the core package
+ */
 export class StubsFactory {
     #parameters = {};
+    /**
+     * Returns an instance of application
+     */
     #getApp() {
         return this.#parameters.app || new AppFactory().create(new URL('./', import.meta.url), () => { });
     }
+    /**
+     * Merge custom factory parameters
+     */
     merge(params) {
         this.#parameters = Object.assign(this.#parameters, params);
         return this;
     }
+    /**
+     * Prepares a stub
+     */
     async prepare(stubPath, data) {
         const app = this.#getApp();
         await app.init();

package/build/index.d.ts

@@ -1,4 +1,4 @@
-/// <reference types="node" resolution-mode="require"/>
+/// <reference types="@types/node" resolution-mode="require"/>
 export { stubsRoot } from './stubs/index.js';
 export { inject } from './modules/container.js';
 export { Ignitor } from './src/ignitor/main.js';
@@ -140,5 +140,8 @@ export declare const errors: {
     E_INSECURE_APP_KEY: new (args?: any, options?: ErrorOptions | undefined) => import("@poppinss/utils").Exception;
     E_MISSING_APP_KEY: new (args?: any, options?: ErrorOptions | undefined) => import("@poppinss/utils").Exception;
 };
+/**
+ * Pretty prints an error with colorful output using
+ * Youch terminal
+ */
 export declare function prettyPrintError(error: any): Promise<void>;
-//# sourceMappingURL=index.d.ts.map

package/build/index.js

@@ -1,3 +1,11 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 import { errors as aceErrors } from '@adonisjs/ace';
 import { errors as envErrors } from '@adonisjs/env';
 import { errors as appErrors } from '@adonisjs/application';
@@ -13,7 +21,12 @@ export const errors = {
     ...aceErrors,
     ...envErrors,
 };
+/**
+ * Pretty prints an error with colorful output using
+ * Youch terminal
+ */
 export async function prettyPrintError(error) {
+    // @ts-expect-error
     const { default: youchTerminal } = await import('youch-terminal');
     const { default: Youch } = await import('youch');
     const youch = new Youch(error, {});