@adonisjs/core 7.0.0-next.10 → 7.0.0-next.12

package/build/modules/ace/create_kernel.js

@@ -1,91 +0,0 @@
-/*
- * @adonisjs/ace
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-import { Kernel } from "./main.js";
-import { FsLoader, HelpCommand } from "../../modules/ace/main.js";
-/**
- * Create and configure an Ace command kernel for AdonisJS applications.
- * This function abstracts the kernel setup logic and can be used in different
- * environments with appropriate configurations.
- *
- * - In console environment, Ace manages the lifecycle of the process
- * - In other environments, Ace can be pulled from the container to run commands
- *
- * @param app - The AdonisJS application service instance
- * @param commandName - Optional specific command name for optimized loading
- *
- * @example
- * ```ts
- * const app = new Application(new URL('../', import.meta.url))
- * const kernel = createAceKernel(app)
- *
- * // Run a specific command
- * await kernel.handle(['make:controller', 'UserController'])
- * ```
- */
-export function createAceKernel(app, commandName) {
-    const kernel = new Kernel(app);
-    kernel.info.set('binary', 'node ace');
-    /**
-     * Lazy import commands mentioned in the "commands" array
-     * of rcFile
-     */
-    app.rcFile.commands.forEach((commandModule) => {
-        kernel.addLoader(() => typeof commandModule === 'function' ? commandModule() : app.import(commandModule));
-    });
-    /**
-     * When we know the command we are running ahead of time, then we
-     * defer loading the application commands if the command has
-     * already been registered by other loaders.
-     */
-    const fsLoader = new FsLoader(app.commandsPath());
-    kernel.addLoader({
-        async getMetaData() {
-            if (!commandName || !kernel.getCommand(commandName)) {
-                return fsLoader.getMetaData();
-            }
-            return [];
-        },
-        getCommand(command) {
-            return fsLoader.getCommand(command);
-        },
-    });
-    /**
-     * Custom global flags
-     */
-    kernel.defineFlag('ansi', {
-        type: 'boolean',
-        showNegatedVariantInHelp: true,
-        description: 'Force enable or disable colorful output',
-    });
-    kernel.defineFlag('help', {
-        type: 'boolean',
-        description: HelpCommand.description,
-    });
-    /**
-     * Flag listener to turn colors on/off
-     */
-    kernel.on('ansi', (_, $kernel, parsed) => {
-        if (parsed.flags.ansi === false) {
-            $kernel.ui.switchMode('silent');
-        }
-        if (parsed.flags.ansi === true) {
-            $kernel.ui.switchMode('normal');
-        }
-    });
-    /**
-     * 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);
-        await help.exec();
-        return $kernel.shortcircuit();
-    });
-    return kernel;
-}

package/build/modules/ace/kernel.js

@@ -1,40 +0,0 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-import { Kernel as AceKernel } from '@adonisjs/ace';
-import { ListCommand } from "./commands.js";
-/**
- * The Ace command kernel for AdonisJS applications. This kernel extends the base
- * Ace kernel with AdonisJS-specific functionality like dependency injection and
- * application lifecycle management.
- *
- * @example
- * ```ts
- * const app = new Application(new URL('../', import.meta.url))
- * const kernel = new Kernel(app)
- *
- * await kernel.handle(['make:controller', 'UserController'])
- * ```
- */
-export class Kernel extends AceKernel {
-    app;
-    /**
-     * Create a new Ace kernel instance
-     *
-     * @param app - The AdonisJS application instance
-     */
-    constructor(app) {
-        super(ListCommand, {
-            create: async (command, parsedOutput, $kernel) => {
-                return app.container.make(command, [app, $kernel, parsedOutput, $kernel.ui, $kernel.prompt]);
-            },
-            run: (command) => command.exec(),
-        });
-        this.app = app;
-    }
-}

package/build/modules/dumper/define_config.js

@@ -1,36 +0,0 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-/**
- * Define configuration for the dumper service exported by the
- * "@adonisjs/core/services/dumper" module. This function allows
- * you to customize HTML and console output formatting options.
- *
- * @param dumperConfig - Configuration object with HTML and console options
- * @param dumperConfig.html - HTML output formatting configuration
- * @param dumperConfig.console - Console output formatting configuration
- *
- * @example
- * ```ts
- * export default defineConfig({
- *   html: {
- *     showHidden: true,
- *     depth: 5,
- *     colors: true
- *   },
- *   console: {
- *     showHidden: false,
- *     depth: 3,
- *     collapse: ['Date', 'DateTime']
- *   }
- * })
- * ```
- */
-export function defineConfig(dumperConfig) {
-    return dumperConfig;
-}

package/build/modules/dumper/dumper.js

@@ -1,266 +0,0 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-import useColors from '@poppinss/colors';
-import { dump as consoleDump } from '@poppinss/dumper/console';
-import { createScript, createStyleSheet, dump } from '@poppinss/dumper/html';
-import { E_DUMP_DIE_EXCEPTION } from "./errors.js";
-const colors = useColors.ansi();
-const DUMP_TITLE_STYLES = `
-.adonisjs-dump-header {
-  font-family: JetBrains Mono, monaspace argon, Menlo, Monaco, Consolas, monospace;
-  background: #ff1639;
-  border-radius: 4px;
-  color: #fff;
-  border-bottom-left-radius: 0;
-  border-bottom-right-radius: 0;
-  padding: 0.4rem 1.2rem;
-  font-size: 1em;
-  display: flex;
-  justify-content: space-between;
-}
-.adonisjs-dump-header .adonisjs-dump-header-title {
-  font-weight: bold;
-  text-transform: uppercase;
-}
-.adonisjs-dump-header .adonisjs-dump-header-source {
-  font-weight: bold;
-  color: inherit;
-  text-decoration: underline;
-}
-.dumper-dump pre {
-  border-radius: 4px;
-  border-top-left-radius: 0;
-  border-top-right-radius: 0;
-}`;
-const IDE = process.env.ADONIS_IDE ?? process.env.EDITOR ?? '';
-/**
- * Dumper exposes the API to dump or die/dump values in your
- * AdonisJS application. An singleton instance of the Dumper
- * is shared as a service and may use it follows.
- *
- * ```ts
- * const dumper = container.make('dumper')
- *
- * dumper.configureHtmlOutput({
- *   // parser + html formatter config
- * })
- *
- * dumper.configureAnsiOutput({
- *   // parser + console formatter config
- * })
- *
- * const html = dumper.dumpToHtml(value)
- * const ansi = dumper.dumpToAnsi(value)
- *
- * // Returns style and script tags that must be
- * // injeted to the head of the HTML document
- *
- * const head = dumper.getHeadElements()
- * ```
- */
-export class Dumper {
-    #app;
-    /**
-     * Configuration for the HTML formatter
-     */
-    #htmlConfig = {};
-    /**
-     * Configuration for the Console formatter
-     */
-    #consoleConfig = {
-        collapse: ['DateTime', 'Date'],
-    };
-    /**
-     * A collections of known editors to create URLs to open
-     * them
-     */
-    #editors = {
-        textmate: 'txmt://open?url=file://%f&line=%l',
-        macvim: 'mvim://open?url=file://%f&line=%l',
-        emacs: 'emacs://open?url=file://%f&line=%l',
-        sublime: 'subl://open?url=file://%f&line=%l',
-        phpstorm: 'phpstorm://open?file=%f&line=%l',
-        atom: 'atom://core/open/file?filename=%f&line=%l',
-        vscode: 'vscode://file/%f:%l',
-    };
-    /**
-     * Creates a new Dumper instance
-     *
-     * @param app - The AdonisJS application instance
-     */
-    constructor(app) {
-        this.#app = app;
-    }
-    /**
-     * Returns the link to open the file using dd inside one
-     * of the known code editors. Constructs a URL that can be used
-     * to open the file at a specific line in supported editors.
-     *
-     * @param source - Optional source file information
-     * @param source.location - The file path to open
-     * @param source.line - The line number to jump to
-     */
-    #getEditorLink(source) {
-        const editorURL = this.#editors[IDE] || IDE;
-        if (!editorURL || !source) {
-            return;
-        }
-        return {
-            href: editorURL.replace('%f', source.location).replace('%l', String(source.line)),
-            text: `${this.#app.relativePath(source.location)}:${source.line}`,
-        };
-    }
-    /**
-     * Configure the HTML formatter output options
-     *
-     * @param config - Configuration options for HTML dump formatting
-     *
-     * @example
-     * ```ts
-     * dumper.configureHtmlOutput({
-     *   showHidden: true,
-     *   depth: 5,
-     *   colors: false
-     * })
-     * ```
-     */
-    configureHtmlOutput(config) {
-        this.#htmlConfig = config;
-        return this;
-    }
-    /**
-     * Configure the ANSI formatter output options for console display
-     *
-     * @param config - Configuration options for ANSI console formatting
-     *
-     * @example
-     * ```ts
-     * dumper.configureAnsiOutput({
-     *   showHidden: true,
-     *   depth: 3,
-     *   collapse: ['Date', 'DateTime']
-     * })
-     * ```
-     */
-    configureAnsiOutput(config) {
-        this.#consoleConfig = config;
-        return this;
-    }
-    /**
-     * Returns the style and script elements that need to be injected into
-     * the HTML document head for proper dump visualization
-     *
-     * @param cspNonce - Optional Content Security Policy nonce for inline scripts
-     *
-     * @example
-     * ```ts
-     * const headElements = dumper.getHeadElements('abc123')
-     * // Insert into your HTML head section
-     * ```
-     */
-    getHeadElements(cspNonce) {
-        return (`<style id="dumper-styles">` +
-            createStyleSheet() +
-            DUMP_TITLE_STYLES +
-            '</style>' +
-            `<script id="dumper-script"${cspNonce ? ` nonce="${cspNonce}"` : ''}>` +
-            createScript() +
-            '</script>');
-    }
-    /**
-     * Dump a value to formatted HTML output
-     *
-     * @param value - The value to dump and inspect
-     * @param options - Options for HTML output formatting
-     * @param options.cspNonce - Optional Content Security Policy nonce
-     * @param options.title - Optional title to display in the dump header
-     * @param options.source - Optional source file information for editor links
-     *
-     * @example
-     * ```ts
-     * const htmlOutput = dumper.dumpToHtml(user, {
-     *   title: 'User Object',
-     *   source: { location: '/app/controllers/user.ts', line: 42 }
-     * })
-     * ```
-     */
-    dumpToHtml(value, options = {}) {
-        const link = this.#getEditorLink(options.source) ?? null;
-        const title = options.title || 'DUMP';
-        return ('<div class="adonisjs-dump-header">' +
-            `<span class="adonisjs-dump-header-title">${title}</span>` +
-            (link ? `<a href="${link.href}" class="adonisjs-dump-header-source">${link.text}</a>` : '') +
-            '</div>' +
-            dump(value, { cspNonce: options.cspNonce, ...this.#htmlConfig }));
-    }
-    /**
-     * Dump a value to formatted ANSI output for console display
-     *
-     * @param value - The value to dump and inspect
-     * @param options - Options for ANSI output formatting
-     * @param options.title - Optional title to display in the dump header
-     * @param options.source - Optional source file information for editor links
-     *
-     * @example
-     * ```ts
-     * const ansiOutput = dumper.dumpToAnsi(user, {
-     *   title: 'User Debug',
-     *   source: { location: '/app/controllers/user.ts', line: 42 }
-     * })
-     * console.log(ansiOutput)
-     * ```
-     */
-    dumpToAnsi(value, options = {}) {
-        const columns = process.stdout.columns;
-        /**
-         * Link to the source file
-         */
-        const link = `${this.#getEditorLink(options.source)?.text ?? ''} `;
-        /**
-         * Dump title
-         */
-        const title = ` ${options.title || 'DUMP'}`;
-        /**
-         * Whitespace between the title and the link to align them
-         * on each side of x axis
-         */
-        const whiteSpaceLength = columns ? columns - link.length - title.length - 4 : 2;
-        const whiteSpace = new Array(whiteSpaceLength <= 0 ? 2 : whiteSpaceLength).join(' ');
-        /**
-         * Styled heading with background color and bold text
-         */
-        const heading = colors.bgRed().bold(`${title}${whiteSpace}${link}`);
-        return `${heading}\n${consoleDump(value, this.#consoleConfig)}`;
-    }
-    /**
-     * Dump values and die. This method dumps the provided value and then
-     * terminates the application. The output format is automatically chosen
-     * based on the execution context.
-     *
-     * - During an HTTP request, HTML output will be sent to the browser
-     * - Otherwise the value will be logged to the console in ANSI format
-     *
-     * @param value - The value to dump before terminating
-     * @param traceSourceIndex - Stack trace index for source location (default: 1)
-     *
-     * @example
-     * ```ts
-     * // This will dump the user object and terminate the application
-     * dumper.dd(user)
-     *
-     * // This will never execute
-     * console.log('This line will not run')
-     * ```
-     */
-    dd(value, traceSourceIndex = 1) {
-        const error = new E_DUMP_DIE_EXCEPTION(value, this);
-        error.setTraceSourceIndex(traceSourceIndex);
-        throw error;
-    }
-}

package/build/modules/dumper/errors.js

@@ -1,119 +0,0 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-import { inspect } from 'node:util';
-import { parse } from 'error-stack-parser-es';
-import { Exception } from '@poppinss/utils/exception';
-/**
- * DumpDie exception raised by the "dd" (dump and die) function.
- * This special exception terminates execution while dumping the provided
- * value as HTML (during HTTP requests) or ANSI (in console/CLI).
- *
- * @example
- * ```ts
- * // This will dump the user object and terminate
- * dumper.dd(user)
- *
- * // In HTTP context: sends HTML dump to browser
- * // In CLI context: prints ANSI dump to console
- * ```
- */
-class DumpDieException extends Exception {
-    static status = 500;
-    static code = 'E_DUMP_DIE_EXCEPTION';
-    #dumper;
-    #traceSourceIndex = 1;
-    value;
-    constructor(value, dumper) {
-        super('Dump and Die exception');
-        this.#dumper = dumper;
-        this.value = value;
-    }
-    /**
-     * Returns the source file and line number location for the error
-     */
-    #getErrorSource() {
-        if (this.fileName && this.lineNumber) {
-            return {
-                location: this.fileName,
-                line: this.lineNumber,
-            };
-        }
-        const source = parse(this)[this.#traceSourceIndex];
-        if (!source.fileName || !source.lineNumber) {
-            return;
-        }
-        return {
-            location: source.fileName,
-            line: source.lineNumber,
-        };
-    }
-    /**
-     * Set the stack trace index for determining the source location.
-     * This is useful when building nested helpers on top of dump/die functionality.
-     *
-     * @param index - Stack trace index (0 = current function, 1 = caller, etc.)
-     */
-    setTraceSourceIndex(index) {
-        this.#traceSourceIndex = index;
-        return this;
-    }
-    /**
-     * Preventing itself from getting reported by the
-     * AdonisJS exception reporter
-     */
-    report() { }
-    /**
-     * HTTP exception handler that renders the dump as HTML output.
-     * This method is called automatically by AdonisJS when a DumpDieException
-     * is thrown during an HTTP request.
-     *
-     * @param error - The DumpDieException instance
-     * @param ctx - HTTP context for the current request
-     */
-    async handle(error, ctx) {
-        const source = this.#getErrorSource();
-        /**
-         * Comes from the shield package
-         */
-        const cspNonce = 'nonce' in ctx.response ? ctx.response.nonce : undefined;
-        ctx.response
-            .status(500)
-            .send('<!DOCTYPE html>' +
-            '<html>' +
-            '<head>' +
-            '<meta charset="utf-8">' +
-            '<meta name="viewport" content="width=device-width">' +
-            `${this.#dumper.getHeadElements(cspNonce)}` +
-            '</head>' +
-            '<body>' +
-            `${this.#dumper.dumpToHtml(error.value, { cspNonce, source, title: 'DUMP DIE' })}` +
-            '</body>' +
-            '</html>');
-    }
-    /**
-     * Ace command exception handler that renders the dump as ANSI output.
-     * This method is called automatically by the Ace kernel when a DumpDieException
-     * is thrown during command execution.
-     *
-     * @param error - The DumpDieException instance
-     * @param kernel - Ace kernel instance
-     */
-    async render(error, kernel) {
-        const source = this.#getErrorSource();
-        kernel.ui.logger.log(this.#dumper.dumpToAnsi(error.value, { source, title: 'DUMP DIE' }));
-    }
-    /**
-     * Custom output for the Node.js util inspect
-     */
-    [inspect.custom]() {
-        const source = this.#getErrorSource();
-        return this.#dumper.dumpToAnsi(this.value, { source, title: 'DUMP DIE' });
-    }
-}
-export const E_DUMP_DIE_EXCEPTION = DumpDieException;

package/build/modules/hash/define_config.js

@@ -1,125 +0,0 @@
-/*
- * @adonisjs/core
- *
- * (c) AdonisJS
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-import { InvalidArgumentsException } from '@poppinss/utils/exception';
-import debug from "../../src/debug.js";
-import { configProvider } from "../../src/config_provider.js";
-/**
- * Define config for the hash service. This function creates a configuration
- * provider that lazily imports and resolves hash drivers when needed.
- *
- * @param config - Configuration object containing default hasher and list of hashers
- * @param config.default - Optional default hasher name (must exist in the list)
- * @param config.list - Record of hasher configurations or config providers
- *
- * @example
- * ```ts
- * const hashConfig = defineConfig({
- *   default: 'scrypt',
- *   list: {
- *     scrypt: drivers.scrypt({
- *       cost: 16384,
- *       blockSize: 8,
- *       parallelization: 1,
- *       saltSize: 16,
- *       keyLength: 64,
- *     }),
- *     bcrypt: drivers.bcrypt({
- *       rounds: 10,
- *     })
- *   }
- * })
- * ```
- */
-export function defineConfig(config) {
-    /**
-     * Hashers list should always be provided
-     */
-    if (!config.list) {
-        throw new InvalidArgumentsException('Missing "list" property in hash config');
-    }
-    /**
-     * The default hasher should be mentioned in the list
-     */
-    if (config.default && !config.list[config.default]) {
-        throw new InvalidArgumentsException(`Missing "list.${String(config.default)}" in hash config. It is referenced by the "default" property`);
-    }
-    /**
-     * Config provider to lazily import drivers as they are used inside
-     * the user application
-     */
-    return configProvider.create(async (app) => {
-        debug('resolving hash config');
-        const hashersList = Object.keys(config.list);
-        const hashers = {};
-        for (let hasherName of hashersList) {
-            const hasher = config.list[hasherName];
-            if (typeof hasher === 'function') {
-                hashers[hasherName] = hasher;
-            }
-            else {
-                hashers[hasherName] = await hasher.resolver(app);
-            }
-        }
-        return {
-            default: config.default,
-            list: hashers,
-        };
-    });
-}
-/**
- * Helpers to configure drivers inside the config file. These functions create
- * configuration providers that lazily import and instantiate hash drivers.
- *
- * - Import happens when you first use the hash module
- * - Construction of drivers happens when you first use a driver
- *
- * @example
- * ```ts
- * const hashConfig = defineConfig({
- *   default: 'bcrypt',
- *   list: {
- *     bcrypt: drivers.bcrypt({ rounds: 12 }),
- *     argon2: drivers.argon2({
- *       variant: 'id',
- *       memory: 65536,
- *       time: 3,
- *       parallelism: 4
- *     }),
- *     scrypt: drivers.scrypt({
- *       cost: 16384,
- *       blockSize: 8,
- *       parallelization: 1
- *     })
- *   }
- * })
- * ```
- */
-export const drivers = {
-    argon2: (config) => {
-        return configProvider.create(async () => {
-            const { Argon } = await import('./drivers/argon.js');
-            debug('configuring argon driver');
-            return () => new Argon(config);
-        });
-    },
-    bcrypt: (config) => {
-        return configProvider.create(async () => {
-            const { Bcrypt } = await import('./drivers/bcrypt.js');
-            debug('configuring bcrypt driver');
-            return () => new Bcrypt(config);
-        });
-    },
-    scrypt: (config) => {
-        return configProvider.create(async () => {
-            const { Scrypt } = await import('./drivers/scrypt.js');
-            debug('configuring scrypt driver');
-            return () => new Scrypt(config);
-        });
-    },
-};