@valkyrjaio/valkyrja 26.0.0

package/src/Valkyrja/Application/Provider/HttpApplicationComponentProvider.ts

@@ -0,0 +1,20 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { ContainerComponentProvider } from '../../Container/Provider/ContainerComponentProvider.js';
+import { ApplicationComponentProvider } from './ApplicationComponentProvider.js';
+
+import type { ApplicationContract } from '../Kernel/Contract/ApplicationContract.js';
+import type { ComponentProviderContract } from './Contract/ComponentProviderContract.js';
+
+export class HttpApplicationComponentProvider extends ApplicationComponentProvider {
+    override getComponentProviders(_app: ApplicationContract): ComponentProviderContract[] {
+        return [new ContainerComponentProvider()];
+    }
+}

package/src/Valkyrja/Application/Throwable/Contract/ApplicationThrowable.ts

@@ -0,0 +1,12 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ValkyrjaThrowable } from '../../../Throwable/Contract/ValkyrjaThrowable.js';
+
+export type ApplicationThrowable = ValkyrjaThrowable;

package/src/Valkyrja/Application/Throwable/Exception/Abstract/ApplicationInvalidArgumentException.ts

@@ -0,0 +1,16 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { ValkyrjaInvalidArgumentException } from '../../../../Throwable/Exception/Abstract/ValkyrjaInvalidArgumentException.js';
+
+import type { ApplicationThrowable } from '../../Contract/ApplicationThrowable.js';
+
+export abstract class ApplicationInvalidArgumentException
+    extends ValkyrjaInvalidArgumentException
+    implements ApplicationThrowable {}

package/src/Valkyrja/Application/Throwable/Exception/Abstract/ApplicationRuntimeException.ts

@@ -0,0 +1,14 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { ValkyrjaRuntimeException } from '../../../../Throwable/Exception/Abstract/ValkyrjaRuntimeException.js';
+
+import type { ApplicationThrowable } from '../../Contract/ApplicationThrowable.js';
+
+export abstract class ApplicationRuntimeException extends ValkyrjaRuntimeException implements ApplicationThrowable {}

package/src/Valkyrja/Cli/Interaction/Argument/Argument.ts

@@ -0,0 +1,25 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ArgumentContract } from './Contract/ArgumentContract.js';
+import { ObjectFactory } from '../../../Type/Object/Factory/ObjectFactory.js';
+
+export class Argument implements ArgumentContract {
+    constructor(protected value: string) {}
+
+    getValue(): string {
+        return this.value;
+    }
+
+    withValue(value: string): this {
+        const clone = ObjectFactory.clone(this);
+        clone.value = value;
+        return clone;
+    }
+}

package/src/Valkyrja/Cli/Interaction/Argument/Contract/ArgumentContract.ts

@@ -0,0 +1,19 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export interface ArgumentContract {
+    getValue(): string;
+    withValue(value: string): this;
+}
+
+export namespace ArgumentContract {
+    export function instanceOf(value: unknown): value is ArgumentContract {
+        return typeof value === 'object' && value !== null && 'getValue' in value;
+    }
+}

package/src/Valkyrja/Cli/Interaction/Argument/Factory/ArgumentFactory.ts

@@ -0,0 +1,16 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { Argument } from '../Argument.js';
+
+export abstract class ArgumentFactory {
+    static fromArg(arg: string): Argument {
+        return new Argument(arg);
+    }
+}

package/src/Valkyrja/Cli/Interaction/Constant/CliInteractionServiceId.ts

@@ -0,0 +1,16 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export class CliInteractionServiceId {
+    static readonly CliInteractionConfigContract =
+        'Valkyrja.Cli.Interaction.Data.CliInteractionConfigContract' as const;
+    static readonly OutputFactoryContract = 'Valkyrja.Cli.Interaction.Output.Factory.OutputFactoryContract' as const;
+    static readonly InputContract = 'Valkyrja.Cli.Interaction.Input.InputContract' as const;
+    static readonly OutputContract = 'Valkyrja.Cli.Interaction.Output.OutputContract' as const;
+}

package/src/Valkyrja/Cli/Interaction/Data/CliInteractionConfig.ts

@@ -0,0 +1,18 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { CliInteractionConfigContract } from './Contract/CliInteractionConfigContract.js';
+
+export class CliInteractionConfig implements CliInteractionConfigContract {
+    constructor(
+        public isQuiet: boolean = false,
+        public isInteractive: boolean = true,
+        public isSilent: boolean = false,
+    ) {}
+}

package/src/Valkyrja/Cli/Interaction/Data/Contract/CliInteractionConfigContract.ts

@@ -0,0 +1,20 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export interface CliInteractionConfigContract {
+    isQuiet: boolean;
+    isInteractive: boolean;
+    isSilent: boolean;
+}
+
+export namespace CliInteractionConfigContract {
+    export function instanceOf(value: unknown): value is CliInteractionConfigContract {
+        return typeof value === 'object' && value !== null && 'isQuiet' in value;
+    }
+}

package/src/Valkyrja/Cli/Interaction/Enum/BackgroundColor.ts

@@ -0,0 +1,33 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export enum BackgroundColor {
+    BLACK = 40,
+    RED = 41,
+    GREEN = 42,
+    YELLOW = 43,
+    BLUE = 44,
+    MAGENTA = 45,
+    CYAN = 46,
+    WHITE = 47,
+    DARK_GRAY = 100,
+    LIGHT_RED = 101,
+    LIGHT_GREEN = 102,
+    LIGHT_YELLOW = 103,
+    LIGHT_BLUE = 104,
+    LIGHT_MAGENTA = 105,
+    LIGHT_CYAN = 106,
+    LIGHT_WHITE = 107,
+}
+
+export namespace BackgroundColor {
+    export function getDefault(): number {
+        return 49;
+    }
+}

package/src/Valkyrja/Cli/Interaction/Enum/ExitCode.ts

@@ -0,0 +1,30 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export enum ExitCode {
+    SUCCESS = 0,
+    ERROR = 1,
+
+    USAGE_ERROR = 64,
+    DATA_ERROR = 65,
+    NO_INPUT = 67,
+    NO_USER = 68,
+    UNAVAILABLE = 69,
+    SOFTWARE_ERROR = 70,
+    OS_ERROR = 71,
+    OS_FILE_ERROR = 72,
+    CANT_CREATE = 73,
+    IO_ERROR = 74,
+    TEMP_FAIL = 75,
+    PROTOCOL_ERROR = 76,
+    NO_PERMISSION = 77,
+    CONFIG_ERROR = 78,
+
+    AUTO_EXIT = 255,
+}

package/src/Valkyrja/Cli/Interaction/Enum/OptionType.ts

@@ -0,0 +1,13 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export enum OptionType {
+    SHORT = 'SHORT',
+    LONG = 'LONG',
+}

package/src/Valkyrja/Cli/Interaction/Enum/Style.ts

@@ -0,0 +1,33 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export enum Style {
+    BOLD = 1,
+    UNDERSCORE = 4,
+    BLINK = 5,
+    INVERSE = 7,
+    CONCEAL = 8,
+}
+
+export namespace Style {
+    export function getDefault(style: Style): number {
+        switch (style) {
+            case Style.BOLD:
+                return 22;
+            case Style.UNDERSCORE:
+                return 24;
+            case Style.BLINK:
+                return 25;
+            case Style.INVERSE:
+                return 27;
+            case Style.CONCEAL:
+                return 28;
+        }
+    }
+}

package/src/Valkyrja/Cli/Interaction/Enum/TextColor.ts

@@ -0,0 +1,33 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export enum TextColor {
+    BLACK = 30,
+    RED = 31,
+    GREEN = 32,
+    YELLOW = 33,
+    BLUE = 34,
+    MAGENTA = 35,
+    CYAN = 36,
+    WHITE = 37,
+    DARK_GRAY = 90,
+    LIGHT_RED = 91,
+    LIGHT_GREEN = 92,
+    LIGHT_YELLOW = 93,
+    LIGHT_BLUE = 94,
+    LIGHT_MAGENTA = 95,
+    LIGHT_CYAN = 96,
+    LIGHT_WHITE = 97,
+}
+
+export namespace TextColor {
+    export function getDefault(): number {
+        return 39;
+    }
+}

package/src/Valkyrja/Cli/Interaction/Format/BackgroundColorFormat.ts

@@ -0,0 +1,17 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { BackgroundColor } from '../Enum/BackgroundColor.js';
+import { Format } from './Format.js';
+
+export class BackgroundColorFormat extends Format {
+    constructor(backgroundColor: BackgroundColor) {
+        super(String(backgroundColor), String(BackgroundColor.getDefault()));
+    }
+}

package/src/Valkyrja/Cli/Interaction/Format/Contract/FormatContract.ts

@@ -0,0 +1,21 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+export interface FormatContract {
+    getSetCode(): string;
+    withSetCode(setCode: string): this;
+    getUnsetCode(): string;
+    withUnsetCode(unsetCode: string): this;
+}
+
+export namespace FormatContract {
+    export function instanceOf(value: unknown): value is FormatContract {
+        return typeof value === 'object' && value !== null && 'getSetCode' in value;
+    }
+}

package/src/Valkyrja/Cli/Interaction/Format/Format.ts

@@ -0,0 +1,38 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { FormatContract } from './Contract/FormatContract.js';
+import { ObjectFactory } from '../../../Type/Object/Factory/ObjectFactory.js';
+
+export class Format implements FormatContract {
+    constructor(
+        protected setCode: string,
+        protected unsetCode: string,
+    ) {}
+
+    getSetCode(): string {
+        return this.setCode;
+    }
+
+    withSetCode(setCode: string): this {
+        const clone = ObjectFactory.clone(this);
+        clone.setCode = setCode;
+        return clone;
+    }
+
+    getUnsetCode(): string {
+        return this.unsetCode;
+    }
+
+    withUnsetCode(unsetCode: string): this {
+        const clone = ObjectFactory.clone(this);
+        clone.unsetCode = unsetCode;
+        return clone;
+    }
+}

package/src/Valkyrja/Cli/Interaction/Format/StyleFormat.ts

@@ -0,0 +1,17 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { Style } from '../Enum/Style.js';
+import { Format } from './Format.js';
+
+export class StyleFormat extends Format {
+    constructor(style: Style) {
+        super(String(style), String(Style.getDefault(style)));
+    }
+}

package/src/Valkyrja/Cli/Interaction/Format/TextColorFormat.ts

@@ -0,0 +1,17 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { TextColor } from '../Enum/TextColor.js';
+import { Format } from './Format.js';
+
+export class TextColorFormat extends Format {
+    constructor(textColor: TextColor) {
+        super(String(textColor), String(TextColor.getDefault()));
+    }
+}

package/src/Valkyrja/Cli/Interaction/Formatter/Contract/FormatterContract.ts

@@ -0,0 +1,22 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { FormatContract } from '../../Format/Contract/FormatContract.js';
+
+export interface FormatterContract {
+    getFormats(): FormatContract[];
+    withFormats(...formats: FormatContract[]): this;
+    formatText(text: string): string;
+}
+
+export namespace FormatterContract {
+    export function instanceOf(value: unknown): value is FormatterContract {
+        return typeof value === 'object' && value !== null && 'formatText' in value;
+    }
+}

package/src/Valkyrja/Cli/Interaction/Formatter/ErrorFormatter.ts

@@ -0,0 +1,20 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { BackgroundColor } from '../Enum/BackgroundColor.js';
+import { TextColor } from '../Enum/TextColor.js';
+import { BackgroundColorFormat } from '../Format/BackgroundColorFormat.js';
+import { TextColorFormat } from '../Format/TextColorFormat.js';
+import { Formatter } from './Formatter.js';
+
+export class ErrorFormatter extends Formatter {
+    constructor() {
+        super(new TextColorFormat(TextColor.LIGHT_WHITE), new BackgroundColorFormat(BackgroundColor.RED));
+    }
+}

package/src/Valkyrja/Cli/Interaction/Formatter/Formatter.ts

@@ -0,0 +1,46 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { FormatContract } from '../Format/Contract/FormatContract.js';
+import type { FormatterContract } from './Contract/FormatterContract.js';
+import { ObjectFactory } from '../../../Type/Object/Factory/ObjectFactory.js';
+
+export class Formatter implements FormatterContract {
+    protected formats: FormatContract[];
+
+    constructor(...formats: FormatContract[]) {
+        this.formats = formats;
+    }
+
+    getFormats(): FormatContract[] {
+        return this.formats;
+    }
+
+    withFormats(...formats: FormatContract[]): this {
+        const clone = ObjectFactory.clone(this);
+        clone.formats = formats;
+        return clone;
+    }
+
+    formatText(text: string): string {
+        if (this.formats.length === 0) {
+            return text;
+        }
+
+        const set: string[] = [];
+        const unset: string[] = [];
+
+        for (const format of this.formats) {
+            set.push(format.getSetCode());
+            unset.push(format.getUnsetCode());
+        }
+
+        return `\x1b[${set.join(';')}m${text}\x1b[${unset.join(';')}m`;
+    }
+}

package/src/Valkyrja/Cli/Interaction/Formatter/HighlightedTextFormatter.ts

@@ -0,0 +1,18 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { TextColor } from '../Enum/TextColor.js';
+import { TextColorFormat } from '../Format/TextColorFormat.js';
+import { Formatter } from './Formatter.js';
+
+export class HighlightedTextFormatter extends Formatter {
+    constructor() {
+        super(new TextColorFormat(TextColor.YELLOW));
+    }
+}

package/src/Valkyrja/Cli/Interaction/Formatter/QuestionFormatter.ts

@@ -0,0 +1,18 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { TextColor } from '../Enum/TextColor.js';
+import { TextColorFormat } from '../Format/TextColorFormat.js';
+import { Formatter } from './Formatter.js';
+
+export class QuestionFormatter extends Formatter {
+    constructor() {
+        super(new TextColorFormat(TextColor.MAGENTA));
+    }
+}

package/src/Valkyrja/Cli/Interaction/Formatter/SuccessFormatter.ts

@@ -0,0 +1,20 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { BackgroundColor } from '../Enum/BackgroundColor.js';
+import { TextColor } from '../Enum/TextColor.js';
+import { BackgroundColorFormat } from '../Format/BackgroundColorFormat.js';
+import { TextColorFormat } from '../Format/TextColorFormat.js';
+import { Formatter } from './Formatter.js';
+
+export class SuccessFormatter extends Formatter {
+    constructor() {
+        super(new TextColorFormat(TextColor.LIGHT_WHITE), new BackgroundColorFormat(BackgroundColor.GREEN));
+    }
+}

package/src/Valkyrja/Cli/Interaction/Formatter/WarningFormatter.ts

@@ -0,0 +1,20 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import { BackgroundColor } from '../Enum/BackgroundColor.js';
+import { TextColor } from '../Enum/TextColor.js';
+import { BackgroundColorFormat } from '../Format/BackgroundColorFormat.js';
+import { TextColorFormat } from '../Format/TextColorFormat.js';
+import { Formatter } from './Formatter.js';
+
+export class WarningFormatter extends Formatter {
+    constructor() {
+        super(new TextColorFormat(TextColor.BLACK), new BackgroundColorFormat(BackgroundColor.YELLOW));
+    }
+}

package/src/Valkyrja/Cli/Interaction/Input/Contract/InputContract.ts

@@ -0,0 +1,36 @@
+/*
+ * This file is part of the Valkyrja package.
+ *
+ * (c) Melech Mizrachi <melechmizrachi@gmail.com>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+import type { ArgumentContract } from '../../Argument/Contract/ArgumentContract.js';
+import type { OptionContract } from '../../Option/Contract/OptionContract.js';
+
+export interface InputContract {
+    getCaller(): string;
+    withCaller(caller: string): this;
+    getCommandName(): string;
+    withCommandName(commandName: string): this;
+    getArguments(): ArgumentContract[];
+    withArguments(...arguments_: ArgumentContract[]): this;
+    withAddedArgument(argument: ArgumentContract): this;
+    withoutArgument(value: string): this;
+    withoutArguments(): this;
+    getOptions(): OptionContract[];
+    getOption(name: string): OptionContract[];
+    hasOption(name: string): boolean;
+    withOptions(...options: OptionContract[]): this;
+    withAddedOption(option: OptionContract): this;
+    withoutOption(name: string): this;
+    withoutOptions(): this;
+}
+
+export namespace InputContract {
+    export function instanceOf(value: unknown): value is InputContract {
+        return typeof value === 'object' && value !== null && 'getCaller' in value;
+    }
+}