tshex-cli 1.0.13 → 1.0.15

package/templates/lib/shared/application/{Service.ts → services.ts}

@@ -1,47 +1,43 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
-
-/**
- * @description 
- * function arguments are Entity
- */
-export default abstract class Service
-{
-
-    [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
+ * function arguments are Entity
+ */
+export abstract class Service {
+    [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

package/templates/lib/shared/domain/{Aggregate.ts → aggregates.ts}

@@ -1,48 +1,44 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
-
-/**
- * @description An Aggregate is a class that contains business logic that doesn't belong to any entity.
- * It is used to perform operations that don't fit into an entity or involve multiple entities.
- * Normally, method arguments are entities.
- */
-export default abstract class Aggregate
-{
-
-    [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 An Aggregate is a class that contains business logic that doesn't belong to any entity.
+ * It is used to perform operations that don't fit into an entity or involve multiple entities.
+ * Normally, method arguments are entities.
+ */
+export abstract class Aggregate {
+    [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

package/templates/lib/shared/domain/{Entity.ts → entities.ts}

@@ -1,50 +1,46 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
-
-/**
- * @description An Entity is a class that represents a domain concept or element.
- */
-export default abstract class Entity
-{
-
-    [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 equals(other: Entity): boolean;
-
-    public abstract flatten(): Record<string, unknown>;
-
-    // protected METHODS
-
-    // private METHODS
-
-    // public static METHODS
-
-    // protected static METHODS
-
-    // private static METHODS
-
-} //:: class
+// Libraries
+
+// Same Layer
+
+// Lower Layers
+
+// Types
+
+// Constants
+
+/**
+ * @description An Entity is a class that represents a domain concept or element.
+ */
+export abstract class Entity {
+    [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 equals(other: Entity): boolean
+
+    public abstract toJSON(): Record<string, unknown>
+
+    // protected METHODS
+
+    // private METHODS
+
+    // public static METHODS
+
+    // protected static METHODS
+
+    // private static METHODS
+} //:: class

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