tshex-cli 1.0.17 → 1.0.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tshex-cli",
-  "version": "1.0.17",
+  "version": "1.0.19",
   "author": "https://github.com/virtualitems/",
   "description": "Typescript Hexagonal Architecture CLI",
   "type": "module",
@@ -26,25 +26,23 @@
   "bugs": {
     "url": "https://github.com/virtualitems/tshex-cli/issues"
   },
+  "types": "./source/index.d.ts",
   "files": [
     "./build",
     "./source",
     "./templates"
   ],
-  "types": "./source/index.d.ts",
-  "devDependencies": {
-    "@types/node": "^22.5.4",
-    "typescript": "^5.4.5"
+  "bin": {
+    "tshex": "./build/main.js"
   },
   "dependencies": {
     "commander": "^12.1.0"
   },
-  "bin": {
-    "tshex": "./build/main.js"
+  "devDependencies": {
+    "@types/node": "^22.5.4",
+    "typescript": "^5.4.5"
   },
   "scripts": {
-    "examples": "tsc -p examples",
-    "build": "tsc",
-    "dev": "tsc -w"
+    "build": "tsc"
   }
 }

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

@@ -0,0 +1,15 @@
+import { DataManager } from './managers.js'
+
+/**
+ * @description Declares the connection contract with a data source driver.
+ * It connects to the source, returns an enabled data manager, and disconnects when the work is done.
+ * This declaration belongs to the application layer as a contract,
+ * while its concrete implementation belongs to the adapters layer.
+ */
+export abstract class DriverAdapter<M extends DataManager = DataManager> {
+    [property: string]: unknown
+
+    public abstract connect(...args: unknown[]): Promise<M>
+
+    public abstract disconnect(): Promise<unknown>
+} //:: class

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

@@ -0,0 +1,81 @@
+/**
+ * @description Declares a filtering operation over plain source records.
+ */
+export interface Filterable<S = Record<string, unknown>> {
+    filter(selector: S): Promise<Array<S>>
+}
+
+/**
+ * @description Declares a sorting operation over plain source records.
+ */
+export interface Sortable<S = Record<string, unknown>> {
+    sort(selector: S): Promise<Array<S>>
+}
+
+/**
+ * @description Declares a creation operation for plain source records.
+ */
+export interface Creatable<D = Record<string, unknown>> {
+    create(data: D): Promise<unknown>
+}
+
+/**
+ * @description Declares an update operation that selects source records and applies new plain data.
+ */
+export interface Updatable<S = Record<string, unknown>, D = Record<string, unknown>> {
+    update(selector: S, data: D): Promise<unknown>
+}
+
+/**
+ * @description Declares a deletion operation over source records selected by plain criteria.
+ */
+export interface Deletable<S = Record<string, unknown>> {
+    delete(selector: S): Promise<unknown>
+}
+
+/**
+ * @description Declares an aggregation operation over source records.
+ */
+export interface Aggregatable<S = Record<string, unknown>> {
+    aggregate(selector: S): Promise<S>
+}
+
+/**
+ * @description Declares operations for selecting or preloading relationships from a data source.
+ */
+export interface Relatable {
+    selectRelated(...args: unknown[]): unknown
+
+    prefetchRelated(...args: unknown[]): unknown
+}
+
+/**
+ * @description Operates on a data source using plain objects and arrays.
+ * It exposes the raw data without transforming it.
+ */
+export abstract class DataManager<T = Record<string, unknown>> {
+    [property: string]: unknown
+
+    public none(): Array<T> {
+        return []
+    }
+
+    public abstract all(): Promise<Array<T>>
+} //:: class
+
+/**
+ * @description Extends a data manager with set operations over data collections.
+ */
+export abstract class DatasetManager<T = Record<string, unknown>> extends DataManager<T> {
+    [property: string]: unknown
+
+    public abstract union(other: Array<T>): Promise<Array<T>>
+
+    public abstract intersection(other: Array<T>): Promise<Array<T>>
+
+    public abstract difference(other: Array<T>): Promise<Array<T>>
+
+    public abstract symmetricDifference(other: Array<T>): Promise<Array<T>>
+
+    public abstract complement(other: Array<T>): Promise<Array<T>>
+} //:: class

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

@@ -0,0 +1,29 @@
+import { type DataManager } from './managers.js'
+import { type DriverAdapter } from './drivers.js'
+
+/**
+ * @description Acts as an intermediary between plain source data and domain objects.
+ * It transforms records into domain representations and can translate them back when needed.
+ */
+export abstract class Repository<
+    DataShape extends Record<string, unknown> = Record<string, unknown>,
+    EntityShape extends Record<string, unknown> = Record<string, unknown>
+> {
+    [property: string]: unknown
+
+    public constructor(public readonly driver: DriverAdapter<DataManager<DataShape>>) {}
+
+    public async all(): Promise<Array<EntityShape>> {
+        const connection = await this.driver.connect()
+        const raw = await connection.all()
+        const entities = this.transformList(raw)
+        await this.driver.disconnect()
+        return entities
+    }
+
+    protected transformList(data: Array<DataShape>): Array<EntityShape> {
+        return data.map(this.transform)
+    }
+
+    protected abstract transform(data: DataShape): EntityShape
+} //:: class

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

@@ -1,121 +1,35 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
 /**
- * @description
+ * @description Represents something that occurred in the application.
+ * It carries the event time and its plain details.
  */
 export abstract class Event {
     [property: string]: unknown
 
-    // public ATTRIBUTES
-
-    // protected ATTRIBUTES
-
-    // private ATTRIBUTES
-
-    // public static ATTRIBUTES
-
-    // protected static ATTRIBUTES
-
-    // private static ATTRIBUTES
-
-    // Constructor, Getters, Setters
-
     public constructor(
         public readonly timestamp: number = Date.now(),
         public readonly details: Record<string, unknown> = {}
     ) {}
-
-    // public METHODS
-
-    // protected METHODS
-
-    // private METHODS
-
-    // public static METHODS
-
-    // protected static METHODS
-
-    // private static METHODS
 } //:: class
 
 /**
- * @description
+ * @description Represents a reaction to an application event.
  */
 export 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
 
 /**
- * @description
+ * @description Declares the interaction contract with an event bus.
+ * It subscribes handlers, removes subscriptions, and dispatches events.
  */
 export 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/http.ts

@@ -1,48 +1,35 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
 /**
  * @description
  */
-export class HttpResponseBody {
-    [property: string]: unknown
-
-    // public ATTRIBUTES
-
-    // protected ATTRIBUTES
-
-    // private ATTRIBUTES
-
-    // public static ATTRIBUTES
-
-    // protected static ATTRIBUTES
-
-    // private static ATTRIBUTES
-
-    // Constructor, Getters, Setters
-
-    public constructor(
-        public readonly data: Record<string, unknown> | null = null,
-        public readonly errors: string[] | null = null,
-        public readonly links: Record<string, URL> | null = null
-    ) {}
-
-    // public METHODS
+export interface HttpRequest {}
 
-    // protected METHODS
-
-    // private METHODS
+/**
+ * @description
+ */
+export interface HttpResponse {}
 
-    // public static METHODS
+/**
+ * @description
+ */
+export interface HttpResponseBody {
+    readonly data: Record<string, unknown> | null
+    readonly errors: string[] | null
+    readonly links: Record<string, URL> | null
+}
 
-    // protected static METHODS
+/**
+ * @description
+ */
+export interface HttpRequestHandler {
+    handle(request: HttpRequest): HttpResponse | Promise<HttpResponse>
+}
 
-    // private static METHODS
-} //:: class
+/**
+ * @description
+ */
+export interface HttpMiddleware {
+    process(
+        request: HttpRequest,
+        handler: HttpRequestHandler
+    ): HttpResponse | Promise<HttpResponse>
+}

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

@@ -9,7 +9,8 @@ export const ERROR = 40
 export const CRITICAL = 50
 
 /**
- * @description
+ * @description Declares the logging contract used by the application layer.
+ * Adapters implement this abstraction to send logs to external systems.
  */
 export abstract class Logger {
     [property: string]: unknown

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

@@ -1,43 +1,7 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
 /**
- * @description
- * function arguments are Entity
+ * @description Represents an application use case.
+ * A service coordinates domain capabilities and collaborators to complete a process that fulfills a system purpose.
  */
 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/application/validations.ts

@@ -2,9 +2,5 @@
  * @description
  */
 export interface Validatable {
-    [property: string]: unknown
-
     isValid(): boolean
-
-    validate(): unknown
 }

package/templates/lib/shared/domain/aggregates.ts

@@ -1,44 +1,7 @@
-// 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.
+ * @description Represents a logical unit that groups multiple entities.
+ * Its operations depend on the identities and collaboration of the entities that compose that unit.
  */
 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/entities.ts

@@ -1,46 +1,17 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
 /**
- * @description An Entity is a class that represents a domain concept or element.
+ * @description Represents a domain concept with its own identity.
+ * Two instances describe the same element when they share that identity.
  */
 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
+    public toJSON(): Record<string, unknown> {
+        return this
+    }
 
-    // private static METHODS
+    public toString(): string {
+        return String(this.constructor.name)
+    }
 } //:: class

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

@@ -1,46 +1,10 @@
-// Libraries
-
-// Same Layer
-
-// Lower Layers
-
-// Types
-
-// Constants
-
 /**
- * @description
+ * @description Represents a received value that does not satisfy the rule expected by a domain concept.
  */
 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