From 558ee2b9bc5c765b7e5a581374c02b9575887e1b Mon Sep 17 00:00:00 2001
From: Pablo Baleztena <pablo@ultharsoftware.com>
Date: Wed, 16 Oct 2024 16:18:19 -0300
Subject: [PATCH] [fabric/domain] Refactor use-cases to commands and queries

---
 packages/fabric/domain/use-case/command.ts    | 37 +++++++++++++++++++
 packages/fabric/domain/use-case/index.ts      |  3 +-
 .../{use-case-definition.ts => query.ts}      | 11 ++++--
 3 files changed, 47 insertions(+), 4 deletions(-)
 create mode 100644 packages/fabric/domain/use-case/command.ts
 rename packages/fabric/domain/use-case/{use-case-definition.ts => query.ts} (73%)

diff --git a/packages/fabric/domain/use-case/command.ts b/packages/fabric/domain/use-case/command.ts
new file mode 100644
index 0000000..5280260
--- /dev/null
+++ b/packages/fabric/domain/use-case/command.ts
@@ -0,0 +1,37 @@
+// deno-lint-ignore-file no-explicit-any
+import type { TaggedError } from "@fabric/core";
+import type { UseCase } from "./use-case.ts";
+
+export type Command<
+  TDependencies = any,
+  TPayload = any,
+  TEvent extends Event = any,
+  TErrors extends TaggedError<string> = any,
+> = BasicCommandDefinition<TDependencies, TPayload, TEvent, TErrors>;
+
+interface BasicCommandDefinition<
+  TDependencies,
+  TPayload,
+  TEvent extends Event,
+  TErrors extends TaggedError<string>,
+> {
+  /**
+   * The use case name.
+   */
+  name: string;
+
+  /**
+   * Whether the use case requires authentication or not.
+   */
+  isAuthRequired: boolean;
+
+  /**
+   * Permissions required to execute the use case.
+   */
+  permissions?: string[];
+
+  /**
+   * The use case function.
+   */
+  useCase: UseCase<TDependencies, TPayload, TEvent, TErrors>;
+}
diff --git a/packages/fabric/domain/use-case/index.ts b/packages/fabric/domain/use-case/index.ts
index b2be5af..3375c3a 100644
--- a/packages/fabric/domain/use-case/index.ts
+++ b/packages/fabric/domain/use-case/index.ts
@@ -1,2 +1,3 @@
-export * from "./use-case-definition.ts";
+export * from "./command.ts";
+export * from "./query.ts";
 export * from "./use-case.ts";
diff --git a/packages/fabric/domain/use-case/use-case-definition.ts b/packages/fabric/domain/use-case/query.ts
similarity index 73%
rename from packages/fabric/domain/use-case/use-case-definition.ts
rename to packages/fabric/domain/use-case/query.ts
index 1eb4726..754e5e5 100644
--- a/packages/fabric/domain/use-case/use-case-definition.ts
+++ b/packages/fabric/domain/use-case/query.ts
@@ -2,14 +2,14 @@
 import type { TaggedError } from "@fabric/core";
 import type { UseCase } from "./use-case.ts";
 
-export type UseCaseDefinition<
+export type Query<
   TDependencies = any,
   TPayload = any,
   TOutput = any,
   TErrors extends TaggedError<string> = any,
-> = BasicUseCaseDefinition<TDependencies, TPayload, TOutput, TErrors>;
+> = BasicQueryDefinition<TDependencies, TPayload, TOutput, TErrors>;
 
-interface BasicUseCaseDefinition<
+interface BasicQueryDefinition<
   TDependencies,
   TPayload,
   TOutput,
@@ -25,6 +25,11 @@ interface BasicUseCaseDefinition<
    */
   isAuthRequired: boolean;
 
+  /**
+   * Permissions required to execute the use case.
+   */
+  permissions?: string[];
+
   /**
    * The use case function.
    */