@adonisjs/repl 3.1.10 → 4.0.0-0

package/build/commands/AdonisRepl.js

@@ -1,33 +0,0 @@
-"use strict";
-/*
- * @adonisjs/repl
- *
- * (c) Harminder Virk <virk@adonisjs.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const standalone_1 = require("@adonisjs/core/build/standalone");
-class ReplCommand extends standalone_1.BaseCommand {
-    async run() {
-        this.application.container.withBindings(['Adonis/Core/Route'], (Route) => {
-            Route.commit();
-        });
-        this.application.container.use('Adonis/Addons/Repl').start();
-        /**
-         * Gracefully shutdown the application
-         */
-        this.application.container.use('Adonis/Addons/Repl').server.on('exit', async () => {
-            await this.application.shutdown();
-        });
-    }
-}
-exports.default = ReplCommand;
-ReplCommand.commandName = 'repl';
-ReplCommand.description = 'Start a new REPL session';
-ReplCommand.settings = {
-    loadApp: true,
-    environment: 'repl',
-    stayAlive: true,
-};

package/build/commands/index.d.ts

@@ -1,2 +0,0 @@
-declare const _default: string[];
-export default _default;

package/build/commands/index.js

@@ -1,11 +0,0 @@
-"use strict";
-/*
- * @adonisjs/repl
- *
- * (c) Harminder Virk <virk@adonisjs.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.default = ['@adonisjs/repl/build/commands/AdonisRepl'];

package/build/providers/ReplProvider.d.ts

@@ -1,7 +0,0 @@
-import { ApplicationContract } from '@ioc:Adonis/Core/Application';
-export default class ReplProvider {
-    protected app: ApplicationContract;
-    constructor(app: ApplicationContract);
-    static needsApplication: boolean;
-    register(): void;
-}

package/build/providers/ReplProvider.js

@@ -1,26 +0,0 @@
-"use strict";
-/*
- * @adonisjs/repl
- *
- * (c) Harminder Virk <virk@adonisjs.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-const path_1 = require("path");
-const os_1 = require("os");
-class ReplProvider {
-    constructor(app) {
-        this.app = app;
-    }
-    register() {
-        this.app.container.singleton('Adonis/Addons/Repl', () => {
-            const compiler = global[Symbol.for('REQUIRE_TS_COMPILER')];
-            const { Repl } = require('../src/Repl');
-            return new Repl(compiler, (0, path_1.join)((0, os_1.homedir)(), '.adonis_repl_history'));
-        });
-    }
-}
-exports.default = ReplProvider;
-ReplProvider.needsApplication = true;

package/build/src/Compiler/index.d.ts

@@ -1,29 +0,0 @@
-import { Compiler as TsCompiler } from '@adonisjs/require-ts/build/src/Compiler';
-/**
- * Exposes the API to compile the user land code to be executed
- * inside Node.JS REPL.
- */
-export declare class Compiler {
-    private tsCompiler?;
-    compilesTs: boolean;
-    constructor(tsCompiler?: TsCompiler | undefined);
-    /**
-     * Process the await keywords in the code
-     */
-    private processAwait;
-    /**
-     * Compiles code using typescript
-     */
-    private compileTypescript;
-    /**
-     * Compiles the code to be executed in the Node.js REPL. Under
-     * the hood
-     *
-     * - Typescript code is compiled
-     * - Await keywords are wrapped in async IIFE
-     */
-    compile(statement: string, filename: string): Promise<{
-        compiled: string;
-        awaitPromise: boolean;
-    }>;
-}

package/build/src/Compiler/index.js

@@ -1,68 +0,0 @@
-"use strict";
-/*
- * @adonisjs/repl
- *
- * (c) Harminder Virk <virk@adonisjs.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Compiler = void 0;
-const node_repl_await_1 = require("node-repl-await");
-const ImportsParser_1 = require("../ImportsParser");
-/**
- * Exposes the API to compile the user land code to be executed
- * inside Node.JS REPL.
- */
-class Compiler {
-    constructor(tsCompiler) {
-        this.tsCompiler = tsCompiler;
-        this.compilesTs = !!this.tsCompiler;
-    }
-    /**
-     * Process the await keywords in the code
-     */
-    processAwait(statement) {
-        const potentialWrappedCode = (0, node_repl_await_1.processTopLevelAwait)(statement);
-        if (!potentialWrappedCode) {
-            return { compiled: statement, awaitPromise: false };
-        }
-        return { compiled: potentialWrappedCode, awaitPromise: true };
-    }
-    /**
-     * Compiles code using typescript
-     */
-    async compileTypescript(statement, filename) {
-        const lines = statement.split(/\n|\r\n/);
-        let compiledOutput = statement;
-        /**
-         * In case of a single line, we process the import
-         * keywords and define local variables to hold
-         * the import reference
-         */
-        if (lines.length <= 2) {
-            compiledOutput = await new ImportsParser_1.ImportsParser().parse(statement);
-        }
-        /**
-         * Compile using typescript compiler and patch the
-         * `sourceMappingUrl` comment to be a block level comment.
-         */
-        compiledOutput = this.tsCompiler.compile(filename, compiledOutput, true);
-        return `${compiledOutput.replace('//# sourceMappingURL=', '/**# sourceMappingURL=')} */`;
-    }
-    /**
-     * Compiles the code to be executed in the Node.js REPL. Under
-     * the hood
-     *
-     * - Typescript code is compiled
-     * - Await keywords are wrapped in async IIFE
-     */
-    async compile(statement, filename) {
-        if (this.tsCompiler) {
-            statement = await this.compileTypescript(statement, filename);
-        }
-        return this.processAwait(statement);
-    }
-}
-exports.Compiler = Compiler;

package/build/src/ImportsParser/index.d.ts

@@ -1,51 +0,0 @@
-/**
- * This is a crazy attempt to hack around the Typescript behavior around un-used
- * imports. Writing half baked parsers is something I want to avoid everytime.
- * However, there isn't any other way (atleast I don't know about it).
- *
- * In REPL, you usually write one line of code at a time. For example:
- * - You write 2 + 2 and then press enter. The REPL prints 4
- * - You write `await Database.query().first()` and it prints the query result.
- *
- * However, when you write `import User from 'App/Models/User'` and expect to
- * access User variable then you are out of luck.
- *
- * - The import statement will go to the typescript compiler
- * - It will compile the code and sees that no one is using this import.
- *   And hence it will just remove it from the compiled output.
- *
- * Bang! No import/require exists and hence no `User` variable exists.
- *
- * To hack around it, we need to monitor and parse import statements and hold
- * a reference to them so that the compiler doesn't remove. For example:
- *
- * Converting
- * ```ts
- * 	import User from 'App/Models/User'
- * ```
- *
- * To
- * ```ts
- * 	import repl_User from 'App/Models/User'; var User = repl_User
- * ```
- *
- * Now you can access the `User` variable.
- *
- * The tough part is attempting to parse all styles in which an import
- * statement can be written. Lucikly, there are 4 different ways to
- * do that as per the spec http://www.ecma-international.org/ecma-262/6.0/#table-40
- *
- * 		import v from "mod";									(Import default)
- * 		import * as ns from "mod";						(Import alias)
- * 		import {x} from "mod";								(Import named)
- * 		import {x as v} from "mod";						(Import named + aliases)
- *
- * However, we have to be tolerant to the white spaces.
- */
-export declare class ImportsParser {
-    private parseImport;
-    /**
-     * Parse a given line of code
-     */
-    parse(line: string): Promise<string>;
-}

package/build/src/ImportsParser/index.js

@@ -1,137 +0,0 @@
-"use strict";
-/*
- * @adonisjs/repl
- *
- * (c) Harminder Virk <virk@adonisjs.com>
- *
- * For the full copyright and license information, please view the LICENSE
- * file that was distributed with this source code.
- */
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ImportsParser = void 0;
-const parse_imports_1 = __importDefault(require("parse-imports"));
-/**
- * This is a crazy attempt to hack around the Typescript behavior around un-used
- * imports. Writing half baked parsers is something I want to avoid everytime.
- * However, there isn't any other way (atleast I don't know about it).
- *
- * In REPL, you usually write one line of code at a time. For example:
- * - You write 2 + 2 and then press enter. The REPL prints 4
- * - You write `await Database.query().first()` and it prints the query result.
- *
- * However, when you write `import User from 'App/Models/User'` and expect to
- * access User variable then you are out of luck.
- *
- * - The import statement will go to the typescript compiler
- * - It will compile the code and sees that no one is using this import.
- *   And hence it will just remove it from the compiled output.
- *
- * Bang! No import/require exists and hence no `User` variable exists.
- *
- * To hack around it, we need to monitor and parse import statements and hold
- * a reference to them so that the compiler doesn't remove. For example:
- *
- * Converting
- * ```ts
- * 	import User from 'App/Models/User'
- * ```
- *
- * To
- * ```ts
- * 	import repl_User from 'App/Models/User'; var User = repl_User
- * ```
- *
- * Now you can access the `User` variable.
- *
- * The tough part is attempting to parse all styles in which an import
- * statement can be written. Lucikly, there are 4 different ways to
- * do that as per the spec http://www.ecma-international.org/ecma-262/6.0/#table-40
- *
- * 		import v from "mod";									(Import default)
- * 		import * as ns from "mod";						(Import alias)
- * 		import {x} from "mod";								(Import named)
- * 		import {x as v} from "mod";						(Import named + aliases)
- *
- * However, we have to be tolerant to the white spaces.
- */
-class ImportsParser {
-    async parseImport(statement) {
-        statement = statement.trim();
-        /**
-         * Return the value as it is when doesn't include the import
-         * keyword
-         */
-        if (!statement.startsWith('import')) {
-            return statement;
-        }
-        /**
-         * Parse all imports in the current line
-         */
-        const imports = await (0, parse_imports_1.default)(statement);
-        const importsAsArray = [...imports];
-        return importsAsArray
-            .map(({ moduleSpecifier, importClause }) => {
-            const tokens = [];
-            const localVariables = [];
-            /**
-             * Has `* as` namespace import
-             */
-            if (importClause && importClause.namespace) {
-                const identifier = `repl_${importClause.namespace}`;
-                tokens.push(`* as ${identifier}`);
-                localVariables.push(`var ${importClause.namespace} = ${identifier}`);
-            }
-            /**
-             * Has default namespace import
-             */
-            if (importClause && importClause.default) {
-                const identifier = `repl_${importClause.default}`;
-                tokens.push(identifier);
-                localVariables.push(`var ${importClause.default} = ${identifier}`);
-            }
-            /**
-             * Has named imports
-             */
-            if (importClause && importClause.named.length) {
-                importClause.named.forEach((name, index) => {
-                    const identifier = `repl_${name.binding}`;
-                    let expression = '';
-                    /**
-                     * Add starting curly brace to named aliases
-                     */
-                    if (index === 0) {
-                        expression += '{';
-                    }
-                    /**
-                     * Setup expression
-                     */
-                    expression += `${name.specifier} as ${identifier}`;
-                    /**
-                     * Add ending curly brace to named aliases
-                     */
-                    if (index + 1 === importClause.named.length) {
-                        expression += '}';
-                    }
-                    tokens.push(expression);
-                    localVariables.push(`var ${name.binding} = ${identifier}`);
-                });
-            }
-            const localVariablesDeclaration = `${localVariables.join('; ')}`;
-            return `import ${tokens.join(',')} from ${moduleSpecifier.code}; ${localVariablesDeclaration}`;
-        })
-            .join('');
-    }
-    /**
-     * Parse a given line of code
-     */
-    async parse(line) {
-        const parsedStatement = await Promise.all(line.split(';').map((statement) => {
-            return this.parseImport(statement);
-        }));
-        return parsedStatement.join('; ');
-    }
-}
-exports.ImportsParser = ImportsParser;

package/build/src/Repl/index.d.ts

@@ -1,91 +0,0 @@
-/// <reference types="node" />
-import { REPLServer } from 'repl';
-import { ReplContract, Handler, ContextOptions } from '@ioc:Adonis/Addons/Repl';
-import { Compiler as TsCompiler } from '@adonisjs/require-ts/build/src/Compiler';
-/**
- * Exposes the API to work the REPL server
- */
-export declare class Repl implements ReplContract {
-    private tsCompiler?;
-    private historyFilePath?;
-    /**
-     * Compiler to compile REPL input
-     */
-    private compiler;
-    /**
-     * Length of the longest custom method name. We need to show a
-     * symmetric view of custom methods and their description
-     */
-    private longestCustomMethodName;
-    /**
-     * Set of registered ready callbacks
-     */
-    private onReadyCallbacks;
-    /**
-     * A set of registered custom methods
-     */
-    private customMethods;
-    /**
-     * Reference to the underlying REPL server. Available
-     * after `start` is invoked.
-     */
-    server: REPLServer;
-    /**
-     * Reference to the colors to print colorful messages
-     */
-    colors: import("@poppinss/colors/build/src/Base").Colors;
-    constructor(tsCompiler?: TsCompiler | undefined, historyFilePath?: string | undefined);
-    /**
-     * Find if the error is recoverable or not
-     */
-    private isRecoverableError;
-    /**
-     * Custom eval method to execute the user code
-     */
-    private eval;
-    private registerCustomMethodWithContext;
-    /**
-     * Register custom methods with the server context
-     */
-    private registerCustomMethodsWithContext;
-    /**
-     * Setup context with default globals
-     */
-    private setupContext;
-    /**
-     * Setup history file
-     */
-    private setupHistory;
-    /**
-     * Prints the welcome message
-     */
-    private printWelcomeMessage;
-    /**
-     * Prints the help for the custom methods
-     */
-    private printCustomMethodsHelp;
-    /**
-     * Prints the help for the context properties
-     */
-    private printContextHelp;
-    /**
-     * Prints the context to the console
-     */
-    private ls;
-    /**
-     * Notify by writing to the console
-     */
-    notify(message: string): void;
-    /**
-     * Start the REPL session
-     */
-    start(): this;
-    /**
-     * Register a callback to be invoked once the server is ready
-     */
-    ready(callback: (repl: ReplContract) => void): this;
-    /**
-     * Register a custom loader function to be added to the context
-     */
-    addMethod(name: string, handler: Handler, options?: ContextOptions): this;
-}