@adonisjs/core 6.1.5-3 → 6.1.5-5

package/build/src/ignitor/test.js

@@ -1,13 +1,38 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+/**
+ * The Test runner process is used to start the tests runner process
+ */
 export class TestRunnerProcess {
+    /**
+     * Ignitor reference
+     */
     #ignitor;
+    /**
+     * The callback that configures the tests runner. This callback
+     * runs at the time of starting the app.
+     */
     #configureCallback = () => { };
     constructor(ignitor) {
         this.#ignitor = ignitor;
     }
+    /**
+     * Register a callback that runs after booting the AdonisJS app
+     * and just before the provider's ready hook
+     */
     configure(callback) {
         this.#configureCallback = callback;
         return this;
     }
+    /**
+     * Runs a callback after starting the app
+     */
     async run(callback) {
         const app = this.#ignitor.createApp('test');
         await app.init();

package/build/src/internal_helpers.d.ts

@@ -1,9 +1,15 @@
 import { ApplicationService } from './types.js';
+import { RcFile } from '@adonisjs/application/types';
+/**
+ * Imports assembler optionally
+ */
 export declare function importAssembler(app: ApplicationService): Promise<typeof import('@adonisjs/assembler') | undefined>;
+/**
+ * Imports typescript optionally
+ */
 export declare function importTypeScript(app: ApplicationService): Promise<typeof import('typescript') | undefined>;
-export declare function detectAssetsBundler(app: ApplicationService): Promise<{
-    name: string;
-    devServerCommand: string;
-    buildCommand: string;
-} | undefined>;
-//# sourceMappingURL=internal_helpers.d.ts.map
+/**
+ * Detects the assets bundler in use. The rcFile.assetsBundler is
+ * used when exists.
+ */
+export declare function detectAssetsBundler(app: ApplicationService): Promise<RcFile['assetsBundler']>;

package/build/src/internal_helpers.js

@@ -1,32 +1,60 @@
-import fs from 'node:fs';
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+import { existsSync } from 'node:fs';
+/**
+ * Imports assembler optionally
+ */
 export async function importAssembler(app) {
     try {
         return await app.import('@adonisjs/assembler');
     }
     catch { }
 }
+/**
+ * Imports typescript optionally
+ */
 export async function importTypeScript(app) {
     try {
         return await app.importDefault('typescript');
     }
     catch { }
 }
+/**
+ * Generates an array of filenames with different JavaScript
+ * extensions for the given filename
+ */
+function generateJsFilenames(filename) {
+    const extensions = ['.js', '.ts', '.cjs', '.mjs', '.cts', '.mts'];
+    return extensions.map((extension) => filename + extension);
+}
+/**
+ * Detects the assets bundler in use. The rcFile.assetsBundler is
+ * used when exists.
+ */
 export async function detectAssetsBundler(app) {
     if (app.rcFile.assetsBundler) {
         return app.rcFile.assetsBundler;
     }
-    if (fs.existsSync(app.makePath('vite.config.js'))) {
+    const possibleViteConfigFiles = generateJsFilenames('vite.config');
+    if (possibleViteConfigFiles.some((config) => existsSync(app.makePath(config)))) {
         return {
             name: 'vite',
-            devServerCommand: 'vite',
-            buildCommand: 'vite build',
+            devServer: { command: 'vite' },
+            build: { command: 'vite', args: ['build'] },
         };
     }
-    if (fs.existsSync(app.makePath('webpack.config.js'))) {
+    const possibleEncoreConfigFiles = generateJsFilenames('webpack.config');
+    if (possibleEncoreConfigFiles.some((config) => existsSync(app.makePath(config)))) {
         return {
             name: 'encore',
-            devServerCommand: 'encore dev-server',
-            buildCommand: 'encore',
+            devServer: { command: 'encore', args: ['dev-server'] },
+            build: { command: 'encore', args: ['production'] },
         };
     }
 }

package/build/src/test_utils/http.d.ts

@@ -1,11 +1,18 @@
-/// <reference types="node" resolution-mode="require"/>
-/// <reference types="node" resolution-mode="require"/>
+/// <reference types="@types/node" resolution-mode="require"/>
+/// <reference types="@types/node" resolution-mode="require"/>
 import type { TestUtils } from './main.js';
 import type { Server as NodeHttpsServer } from 'node:https';
 import { IncomingMessage, ServerResponse, Server as NodeHttpServer } from 'node:http';
+/**
+ * Http server utils are used to start the AdonisJS HTTP server
+ * during testing
+ */
 export declare class HttpServerUtils {
     #private;
     constructor(utils: TestUtils);
+    /**
+     * Testing hook to start the HTTP server to listen for new request.
+     * The return value is a function to close the HTTP server.
+     */
     start(serverCallback?: (handler: (req: IncomingMessage, res: ServerResponse) => any) => NodeHttpsServer | NodeHttpServer): Promise<() => Promise<void>>;
 }
-//# sourceMappingURL=http.d.ts.map

package/build/src/test_utils/http.js

@@ -1,10 +1,25 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 import debug from '../debug.js';
 import { createServer } from 'node:http';
+/**
+ * Http server utils are used to start the AdonisJS HTTP server
+ * during testing
+ */
 export class HttpServerUtils {
     #utils;
     constructor(utils) {
         this.#utils = utils;
     }
+    /**
+     * Starts the http server a given host and port
+     */
     #listen(nodeHttpServer) {
         return new Promise((resolve, reject) => {
             const host = process.env.HOST || '0.0.0.0';
@@ -19,6 +34,10 @@ export class HttpServerUtils {
             });
         });
     }
+    /**
+     * Testing hook to start the HTTP server to listen for new request.
+     * The return value is a function to close the HTTP server.
+     */
     async start(serverCallback) {
         const createHTTPServer = serverCallback || createServer;
         const server = await this.#utils.app.container.make('server');

package/build/src/test_utils/main.d.ts

@@ -1,20 +1,37 @@
-/// <reference types="node" resolution-mode="require"/>
+/// <reference types="@types/node" resolution-mode="require"/>
 import Macroable from '@poppinss/macroable';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { HttpServerUtils } from './http.js';
 import { CookieClient } from '../../modules/http.js';
 import type { ApplicationService } from '../types.js';
+/**
+ * Test utils has a collection of helper methods to make testing
+ * experience great for AdonisJS applications
+ */
 export declare class TestUtils extends Macroable {
     #private;
     app: ApplicationService;
+    /**
+     * Check if utils have been booted
+     */
     get isBooted(): boolean;
     cookies: CookieClient;
     constructor(app: ApplicationService);
+    /**
+     * Boot test utils. It requires the app to be booted
+     * and container to have all the bindings
+     */
     boot(): Promise<void>;
+    /**
+     * Returns an instance of the HTTP server testing
+     * utils
+     */
     httpServer(): HttpServerUtils;
+    /**
+     * Create an instance of HTTP context for testing
+     */
     createHttpContext(options?: {
         req?: IncomingMessage;
         res?: ServerResponse;
     }): Promise<import("../../modules/http.js").HttpContext>;
 }
-//# sourceMappingURL=main.d.ts.map

package/build/src/test_utils/main.js

@@ -1,11 +1,26 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 import { Socket } from 'node:net';
 import Macroable from '@poppinss/macroable';
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { HttpServerUtils } from './http.js';
 import { CookieClient } from '../../modules/http.js';
+/**
+ * Test utils has a collection of helper methods to make testing
+ * experience great for AdonisJS applications
+ */
 export class TestUtils extends Macroable {
     app;
     #booted = false;
+    /**
+     * Check if utils have been booted
+     */
     get isBooted() {
         return this.#booted;
     }
@@ -13,15 +28,26 @@ export class TestUtils extends Macroable {
         super();
         this.app = app;
     }
+    /**
+     * Boot test utils. It requires the app to be booted
+     * and container to have all the bindings
+     */
     async boot() {
         if (!this.isBooted) {
             this.#booted = true;
             this.cookies = new CookieClient(await this.app.container.make('encryption'));
         }
     }
+    /**
+     * Returns an instance of the HTTP server testing
+     * utils
+     */
     httpServer() {
         return new HttpServerUtils(this);
     }
+    /**
+     * Create an instance of HTTP context for testing
+     */
     async createHttpContext(options = {}) {
         const req = options.req || new IncomingMessage(new Socket());
         const res = options.res || new ServerResponse(req);

package/build/src/types.d.ts

@@ -11,9 +11,17 @@ import type { ContainerResolveEventData } from '../types/container.js';
 import type { LoggerConfig, LoggerManagerConfig } from '../types/logger.js';
 import type { Argon, Bcrypt, HashManager, Scrypt } from '../modules/hash/main.js';
 import type { ArgonConfig, BcryptConfig, ScryptConfig, ManagerDriverFactory } from '../types/hash.js';
+/**
+ * Options accepted by ignitor
+ */
 export type IgnitorOptions = {
     importer: Importer;
 };
+/**
+ * A list of known events. The interface must be extended in
+ * user land code or packages to register events and their
+ * types.
+ */
 export interface EventsList {
     'container:resolved': ContainerResolveEventData<ContainerBindings>;
     'http:request_handled': HttpRequestFinishedPayload;
@@ -22,33 +30,81 @@ export interface EventsList {
         host: string;
     };
 }
+/**
+ * The loggers list inferred from the user application
+ * config
+ */
 export interface LoggersList {
 }
 export type InferLoggers<T extends LoggerManagerConfig<any>> = T['loggers'];
+/**
+ * A list of globally available hash drivers
+ */
 export interface HashDriversList {
     bcrypt: (config: BcryptConfig) => Bcrypt;
     argon2: (config: ArgonConfig) => Argon;
     scrypt: (config: ScryptConfig) => Scrypt;
 }
+/**
+ * A list of known hashers inferred from the user config
+ */
 export interface HashersList {
 }
 export type InferHashers<T extends {
     list: Record<string, ManagerDriverFactory>;
 }> = T['list'];
+/**
+ * ----------------------------------------------------------------
+ * Container services
+ * -----------------------------------------------------------------
+ *
+ * Types for the container singleton services. Defining them
+ * upfront so that we do not have to define them in
+ * multiple places.
+ */
+/**
+ * Application service is a singleton resolved from
+ * the container
+ */
 export interface ApplicationService extends Application<ContainerBindings extends Record<any, any> ? ContainerBindings : never> {
 }
+/**
+ * Logger service is a singleton logger instance registered
+ * to the container.
+ */
 export interface LoggerService extends LoggerManager<LoggersList extends Record<string, LoggerConfig> ? LoggersList : never> {
 }
+/**
+ * Emitter service is a singleton emitter instance registered
+ * to the container.
+ */
 export interface EmitterService extends Emitter<EventsList> {
 }
+/**
+ * Encryption service is a singleton Encryption class instance
+ * registered to the container.
+ */
 export interface EncryptionService extends Encryption {
 }
+/**
+ * Http server service added to the container as a singleton
+ */
 export interface HttpServerService extends Server {
 }
+/**
+ * Http server service added to the container as a singleton
+ */
 export interface HttpRouterService extends Router {
 }
+/**
+ * Hash service is a singleton instance of the HashManager
+ * registered in the container
+ */
 export interface HashService extends HashManager<HashersList extends Record<string, ManagerDriverFactory> ? HashersList : never> {
 }
+/**
+ * A list of known container bindings.
+ */
 export interface ContainerBindings {
     ace: Kernel;
     app: ApplicationService;
@@ -61,4 +117,3 @@ export interface ContainerBindings {
     router: HttpRouterService;
     testUtils: TestUtils;
 }
-//# sourceMappingURL=types.d.ts.map

package/build/src/types.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 {};

package/build/stubs/index.d.ts

@@ -1,2 +1 @@
 export declare const stubsRoot: string;
-//# sourceMappingURL=index.d.ts.map

package/build/stubs/index.js

@@ -1,2 +1,10 @@
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 import { getDirname } from '@poppinss/utils';
 export const stubsRoot = getDirname(import.meta.url);

package/build/toolkit/commands/index_commands.d.ts

@@ -1,8 +1,11 @@
 import { BaseCommand } from '@adonisjs/ace';
+/**
+ * Generates index of commands with a loader. Must be called against
+ * the TypeScript compiled output.
+ */
 export default class IndexCommand extends BaseCommand {
     static commandName: string;
     static description: string;
     commandsDir: string;
     run(): Promise<any>;
 }
-//# sourceMappingURL=index_commands.d.ts.map

package/build/toolkit/commands/index_commands.js

@@ -1,15 +1,24 @@
+/*
+ * @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 { join } from 'node:path';
 import { args, BaseCommand, IndexGenerator } from '@adonisjs/ace';
-class IndexCommand extends BaseCommand {
+/**
+ * Generates index of commands with a loader. Must be called against
+ * the TypeScript compiled output.
+ */
+export default class IndexCommand extends BaseCommand {
     static commandName = 'index';
     static description = 'Create an index of commands along with a lazy loader';
     async run() {
@@ -17,7 +26,5 @@ class IndexCommand extends BaseCommand {
     }
 }
 __decorate([
-    args.string({ description: 'Relative path from cwd to the commands directory' }),
-    __metadata("design:type", String)
+    args.string({ description: 'Relative path from cwd to the commands directory' })
 ], IndexCommand.prototype, "commandsDir", void 0);
-export default IndexCommand;

package/build/toolkit/main.d.ts

@@ -1,3 +1,2 @@
 #!/usr/bin/env node
 export {};
-//# sourceMappingURL=main.d.ts.map

package/build/toolkit/main.js

@@ -1,4 +1,12 @@
 #!/usr/bin/env node
+/*
+ * @adonisjs/core
+ *
+ * (c) AdonisJS
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
 import IndexCommand from './commands/index_commands.js';
 import { Kernel, ListLoader, HelpCommand } from '@adonisjs/ace';
 const kernel = Kernel.create();
@@ -7,6 +15,9 @@ kernel.defineFlag('help', {
     type: 'boolean',
     description: HelpCommand.description,
 });
+/**
+ * Flag listener to display the help
+ */
 kernel.on('help', async (command, $kernel, parsed) => {
     parsed.args.unshift(command.commandName);
     const help = new HelpCommand($kernel, parsed, kernel.ui, kernel.prompt);

package/build/types/ace.d.ts

@@ -3,4 +3,3 @@ export type CommandOptions = BaseCommandOptions & {
     startApp?: boolean;
 };
 export * from '@adonisjs/ace/types';
-//# sourceMappingURL=ace.d.ts.map

package/build/types/ace.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/ace/types';

package/build/types/app.d.ts

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

package/build/types/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/types';

package/build/types/bodyparser.d.ts

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

package/build/types/bodyparser.js

@@ -1 +1,9 @@
+/*
+ * @adonisjs/ace
+ *
+ * (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/types';

package/build/types/container.d.ts

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

package/build/types/container.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/fold/types';

package/build/types/encryption.d.ts

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

package/build/types/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/types';

package/build/types/events.d.ts

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

package/build/types/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/types';

package/build/types/hash.d.ts

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

package/build/types/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/types';

package/build/types/http.d.ts

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

package/build/types/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/types';

package/build/types/logger.d.ts

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

package/build/types/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/types';