tshex-cli 1.0.13 → 1.0.14

package/templates/lib/shared/{application/DataTransferObject.ts → domain/errors.ts}

@@ -1,46 +1,46 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
-
-/**
-* @description 
-*/
-export default abstract class DataTransferObject
-{
-
-    [property: string]: unknown;
-
-    // public ATTRIBUTES
-
-    // protected ATTRIBUTES
-
-    // private ATTRIBUTES
-
-    // public static ATTRIBUTES
-
-    // protected static ATTRIBUTES
-
-    // private static ATTRIBUTES
-
-    // Constructor, Getters, Setters
-
-    // public METHODS
-
-    // protected METHODS
-
-    // private METHODS
-
-    // public static METHODS
-
-    // protected static METHODS
-
-    // private static METHODS
-
-} //:: class
+// Libraries
+
+// Same Layer
+
+// Lower Layers
+
+// Types
+
+// Constants
+
+/**
+ * @description
+ */
+export class ValueError extends Error {
+    [property: string]: unknown
+
+    // public ATTRIBUTES
+
+    // protected ATTRIBUTES
+
+    // private ATTRIBUTES
+
+    // public static ATTRIBUTES
+
+    // protected static ATTRIBUTES
+
+    // private static ATTRIBUTES
+
+    // Constructor, Getters, Setters
+
+    public constructor(received: string, expected: string) {
+        super(`Invalid value ${received} for ${expected}.`)
+    }
+
+    // public METHODS
+
+    // protected METHODS
+
+    // private METHODS
+
+    // public static METHODS
+
+    // protected static METHODS
+
+    // private static METHODS
+} //:: class

package/templates/lib/shared/domain/value-objects.ts

@@ -0,0 +1,194 @@
+// Libraries
+
+// Same Layer
+
+import { ValueError } from './errors.js'
+
+// Lower Layers
+
+// Types
+
+// Constants
+
+/**
+ * @see https://emailregex.com/
+ */
+const VALID_EMAIL_REGEX =
+    /^(([^<>()\[\]\\.,;:\s@"]+(\.[^<>()\[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/
+
+/**
+ * @description
+ */
+export abstract class ValueObject<T = unknown> {
+    [property: string]: unknown
+
+    // public ATTRIBUTES
+
+    public abstract readonly value: T
+
+    // protected ATTRIBUTES
+
+    // private ATTRIBUTES
+
+    // public static ATTRIBUTES
+
+    // protected static ATTRIBUTES
+
+    // private static ATTRIBUTES
+
+    // Constructor, Getters, Setters
+
+    // public METHODS
+
+    public toString(): string {
+        return String(this.value)
+    }
+
+    public abstract equals(other: ValueObject<T> | null | undefined): boolean
+
+    // protected METHODS
+
+    // private METHODS
+
+    // public static METHODS
+
+    public static isValid(value: unknown): boolean {
+        return (
+            value !== null &&
+            value !== undefined &&
+            Object.is(value, NaN) === false
+        )
+    }
+
+    // protected static METHODS
+
+    // private static METHODS
+} //:: class
+
+/**
+ * @description
+ */
+export class NullableBoolean extends ValueObject<boolean | null> {
+    [property: string]: unknown
+
+    // public ATTRIBUTES
+
+    public override readonly value: boolean | null
+
+    // protected ATTRIBUTES
+
+    // private ATTRIBUTES
+
+    // public static ATTRIBUTES
+
+    // protected static ATTRIBUTES
+
+    // private static ATTRIBUTES
+
+    // Constructor, Getters, Setters
+
+    protected constructor(value: boolean | null) {
+        super()
+        this.value = value
+    }
+
+    // public METHODS
+
+    public override equals(other: NullableBoolean | null | undefined): boolean {
+        if (other === null || other === undefined) return false
+        return this.value === other.value
+    }
+
+    public isIndeterminate(): boolean {
+        return this.value === null
+    }
+
+    // protected METHODS
+
+    // private METHODS
+
+    // public static METHODS
+
+    public static from(value: boolean | null): NullableBoolean {
+        return new this(value)
+    }
+
+    // protected static METHODS
+
+    // private static METHODS
+} //:: class
+
+/**
+ * @description
+ */
+export class Email extends ValueObject<string> {
+    [property: string]: unknown
+
+    // public ATTRIBUTES
+
+    public override readonly value: string
+
+    // protected ATTRIBUTES
+
+    // private ATTRIBUTES
+
+    // public static ATTRIBUTES
+
+    // protected static ATTRIBUTES
+
+    // private static ATTRIBUTES
+
+    // Constructor, Getters, Setters
+
+    protected constructor(value: string) {
+        super()
+        this.value = value
+    }
+
+    get username(): string | undefined {
+        return this.value.split('@').shift()
+    }
+
+    get domain(): string | undefined {
+        return this.value.split('@').pop()
+    }
+
+    get tld(): string | undefined {
+        return this.domain?.split('.').pop()
+    }
+
+    // public METHODS
+
+    public override equals(other: Email | null | undefined): boolean {
+        if (other === null || other === undefined) {
+            return false
+        }
+
+        return this.value === other.value
+    }
+
+    // protected METHODS
+
+    // private METHODS
+
+    // public static METHODS
+
+    public static override isValid(value: unknown): boolean {
+        if (super.isValid(value) === false) return false
+
+        return (
+            'string' === typeof value && VALID_EMAIL_REGEX.test(value as string)
+        )
+    }
+
+    public static from(value: string): Email {
+        if (this.isValid(value) === false)
+            throw new ValueError(value, this.name)
+
+        return new this(value)
+    }
+
+    // protected static METHODS
+
+    // private static METHODS
+} //:: class

package/templates/lib/shared/application/Logger.ts

@@ -1,54 +0,0 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
-
-/**
-* @description 
-*/
-export default abstract class Logger
-{
-
-    [property: string]: unknown;
-
-    // public ATTRIBUTES
-
-    // protected ATTRIBUTES
-
-    // private ATTRIBUTES
-
-    // public static ATTRIBUTES
-
-    // protected static ATTRIBUTES
-
-    // private static ATTRIBUTES
-
-    // Constructor, Getters, Setters
-
-    // public METHODS
-
-    public abstract debug(message: string): void;
-
-    public abstract info(message: string): void;
-
-    public abstract warning(message: string): void;
-
-    public abstract error(message: string): void;
-
-    // protected METHODS
-
-    // private METHODS
-
-    // public static METHODS
-
-    // protected static METHODS
-
-    // private static METHODS
-
-} //:: class

package/templates/lib/shared/application/data/DataManager.ts

@@ -1,50 +0,0 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
-
-/**
- * @description 
- */
-export default abstract class DataManager
-{
-
-    [property: string]: unknown;
-
-    // Public Attributes
-
-    // Protected Attributes
-
-    // Private Attributes
-
-    // Public Static Attributes
-
-    // Protected Static Attributes
-
-    // Private Static Attributes
-
-    // Constructor, Getters, Setters
-
-    // Public Methods
-
-    public abstract connect(...args: unknown[]): Promise<unknown>;
-
-    public abstract disconnect(): Promise<unknown>;
-
-    // Protected Methods
-
-    // Private Methods
-
-    // Public Static Methods
-
-    // Protected Static Methods
-
-    // Private Static Methods
-
-} //:: class

package/templates/lib/shared/application/data/Repository.ts

@@ -1,55 +0,0 @@
-// Libraries
-
-// Same Layer
-
-import type DataManager from './DataManager.js';
-
-// Lower Layers
-
-// Types
-
-// Constants
-
-
-/**
-* @description Represents a data source.
-*/
-export default abstract class Repository<M extends DataManager>
-{
-
-    [property: string]: unknown;
-
-    // Public Attributes
-
-    public manager: M;
-
-    // Protected Attributes
-
-    // Private Attributes
-
-    // Public Static Attributes
-
-    // Protected Static Attributes
-
-    // Private Static Attributes
-
-    // Constructor, Getters, Setters
-
-    public constructor(manager: M)
-    {
-        this.manager = manager;
-    }
-
-    // Public Methods
-
-    // Protected Methods
-
-    // Private Methods
-
-    // Public Static Methods
-
-    // Protected Static Methods
-
-    // Private Static Methods
-
-} //:: class

package/templates/lib/shared/application/events/Event.ts

@@ -1,56 +0,0 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
-
-/**
- * @description 
- */
-export default abstract class Event
-{
-
-    [property: string]: unknown;
-
-    // public ATTRIBUTES
-
-    public readonly timestamp: number;
-
-    public readonly details: Record<string, unknown>;
-
-    // protected ATTRIBUTES
-
-    // private ATTRIBUTES
-
-    // public static ATTRIBUTES
-
-    // protected static ATTRIBUTES
-
-    // private static ATTRIBUTES
-
-    // Constructor, Getters, Setters
-
-    public constructor(timestamp: number, details?: Record<string, unknown>)
-    {
-        this.timestamp = timestamp;
-        this.details = details ?? {};
-    }
-
-    // public METHODS
-
-    // protected METHODS
-
-    // private METHODS
-
-    // public static METHODS
-
-    // protected static METHODS
-
-    // private static METHODS
-
-} //:: class

package/templates/lib/shared/application/events/EventDispatcher.ts

@@ -1,55 +0,0 @@
-// Libraries
-
-// Same Layer
-
-import type Event from './Event.js';
-import type EventHandler from './EventHandler.js';
-
-// Lower Layers
-
-// Types
-
-// Constants
-
-
-/**
- * @description 
- */
-export default abstract class EventDispatcher
-{
-
-    [property: string]: unknown;
-
-    // public ATTRIBUTES
-
-    // protected ATTRIBUTES
-
-    // private ATTRIBUTES
-
-    // public static ATTRIBUTES
-
-    // protected static ATTRIBUTES
-
-    // private static ATTRIBUTES
-
-    // Constructor, Getters, Setters
-
-    // public METHODS
-
-    public abstract subscribe(key: unknown, handler: EventHandler): void;
-
-    public abstract unsubscribe(key: unknown, handler: EventHandler): void;
-
-    public abstract dispatch(event: Event): void;
-
-    // protected METHODS
-
-    // private METHODS
-
-    // public static METHODS
-
-    // protected static METHODS
-
-    // private static METHODS
-
-} //:: class

package/templates/lib/shared/application/events/EventHandler.ts

@@ -1,50 +0,0 @@
-// Libraries
-
-// Same Layer
-
-import type Event from './Event.js';
-
-// Lower Layers
-
-// Types
-
-// Constants
-
-
-/**
- * @description 
- */
-export default abstract class EventHandler
-{
-
-    [property: string]: unknown;
-
-    // public ATTRIBUTES
-
-    // protected ATTRIBUTES
-
-    // private ATTRIBUTES
-
-    // public static ATTRIBUTES
-
-    // protected static ATTRIBUTES
-
-    // private static ATTRIBUTES
-
-    // Constructor, Getters, Setters
-
-    // public METHODS
-
-    public abstract handle(event: Event): Promise<void>;
-
-    // protected METHODS
-
-    // private METHODS
-
-    // public static METHODS
-
-    // protected static METHODS
-
-    // private static METHODS
-
-} //:: class

package/templates/lib/shared/domain/errors/ValueError.ts

@@ -1,69 +0,0 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
-
-/**
-* @description 
-*/
-export default class ValueError extends Error
-{
-
-    [property: string]: unknown;
-
-    // public ATTRIBUTES
-
-    // protected ATTRIBUTES
-
-    // private ATTRIBUTES
-
-    // public static ATTRIBUTES
-
-    // protected static ATTRIBUTES
-
-    // private static ATTRIBUTES
-
-    // Constructor, Getters, Setters
-
-    public constructor(value: unknown, expected: string)
-    {
-        let valueRepr: string;
-
-        if (value === undefined) {
-            valueRepr = 'undefined';
-        }
-
-        else if (value === null) {
-            valueRepr = 'null';
-        }
-
-        else if (Object.is(value, NaN)) {
-            valueRepr = 'NaN';
-        }
-
-        else {
-            valueRepr = `${value.constructor.name}(${value.toString()})`;
-        }
-
-        super(`Invalid value ${valueRepr} for ${expected}.`);
-    }
-
-    // public METHODS
-
-    // protected METHODS
-
-    // private METHODS
-
-    // public static METHODS
-
-    // protected static METHODS
-
-    // private static METHODS
-
-} //:: class