packages/fabric/core/src/array/array-element.spec.ts

@@ -1,12 +0,0 @@
-import { describe, expectTypeOf, test } from "vitest";
-
-describe("ArrayElement utils", () => {
-  test("Given an array, it should return the element type of the array", () => {
-    type ArrayElement<T extends readonly unknown[]> =
-      T extends readonly (infer U)[] ? U : never;
-
-    type result = ArrayElement<["a", "b", "c"]>;
-
-    expectTypeOf<result>().toEqualTypeOf<"a" | "b" | "c">();
-  });
-});

packages/fabric/core/src/array/array-element.ts

@@ -1,17 +0,0 @@
-/**
- * Get the element type of an array.
- */
-export type ArrayElement<T extends readonly unknown[]> =
-  T extends readonly (infer U)[] ? U : never;
-
-/**
- * Get the first element type of a tuple.
- */
-export type TupleFirstElement<T extends readonly unknown[]> =
-  T extends readonly [infer U, ...unknown[]] ? U : never;
-
-/**
- * Get the LAST element type of a tuple.
- */
-export type TupleLastElement<T extends readonly unknown[]> =
-  T extends readonly [...unknown[], infer U] ? U : never;

packages/fabric/core/src/array/index.ts

@@ -1 +0,0 @@
-export * from "./array-element.js";

packages/fabric/core/src/domain/entity/files/domain-file.ts

@@ -1,5 +1,5 @@
-import { BaseFile } from "../../../files/base-file.js";
 import { Entity } from "../entity.js";
+import { BaseFile } from "./base-file.js";
 
 /**
  * Represents a file as managed by the domain.

packages/fabric/core/src/domain/entity/files/image-file.ts

@@ -1,5 +1,5 @@
-import { ImageMimeType } from "../../../files/mime-type.js";
 import { DomainFile } from "./domain-file.js";
+import { ImageMimeType } from "./mime-type.js";
 
 /**
  * Represents an image file.

packages/fabric/core/src/domain/entity/files/index.ts

@@ -1,2 +1,10 @@
+export * from "./base-file.js";
+export * from "./bytes.js";
 export * from "./domain-file.js";
 export * from "./image-file.js";
+export * from "./invalid-file-type-error.js";
+export * from "./is-mime-type.js";
+export * from "./is-uploaded-file.js";
+export * from "./media-file.js";
+export * from "./mime-type.js";
+export * from "./uploaded-file.js";

packages/fabric/core/src/domain/entity/files/invalid-file-type-error.ts

@@ -1,4 +1,4 @@
-import { TaggedError } from "../error/tagged-error.js";
+import { TaggedError } from "../../../error/tagged-error.js";
 
 export class InvalidFileTypeError extends TaggedError<"InvalidFileTypeError"> {
   constructor() {

packages/fabric/core/src/domain/entity/files/is-mime-type.ts

@@ -5,7 +5,7 @@ import { MimeType } from "./mime-type.js";
  */
 export function isMimeType<T extends MimeType>(
   expectedMimeType: T,
-  actualMimeType: string,
+  actualFileType: string,
-): actualMimeType is T {
+): actualFileType is T {
-  return actualMimeType.match("^" + expectedMimeType + "$") !== null;
+  return actualFileType.match("^" + expectedMimeType + "$") !== null;
 }

packages/fabric/core/src/domain/entity/files/is-uploaded-file.ts

@@ -1,5 +1,5 @@
 import validator from "validator";
-import { isRecord } from "../record/is-record.js";
+import { isRecord } from "../../../record/is-record.js";
 import { InMemoryFile } from "./uploaded-file.js";
 
 const { isBase64, isMimeType } = validator;

packages/fabric/core/src/domain/entity/files/media-file.ts

@@ -1,4 +1,4 @@
-import { DomainFile } from "../domain/entity/files/domain-file.js";
+import { DomainFile } from "./domain-file.js";
 
 /**
  * Represents a media file, either an image, a video or an audio file.

packages/fabric/core/src/domain/entity/files/uploaded-file.ts

@@ -1,4 +1,4 @@
-import { Base64String } from "../domain/types/base-64.js";
+import { Base64String } from "../../types/base-64.js";
 import { BaseFile } from "./base-file.js";
 
 /**

packages/fabric/core/src/domain/entity/index.ts

@@ -1 +1,2 @@
 export * from "./entity.js";
+export * from "./files/index.js";

packages/fabric/core/src/domain/events/event.ts

@@ -1,8 +1,5 @@
 import { TaggedVariant } from "../../variant/variant.js";
 
-/**
- * An event is a tagged variant with a payload and a timestamp.
- */
 export interface Event<TTag extends string, TPayload>
   extends TaggedVariant<TTag> {
   payload: TPayload;

packages/fabric/core/src/domain/security/policy-map.ts

@@ -1,6 +1,3 @@
-/**
- * A PolicyMap maps user types to their security policies.
- */
 export type PolicyMap<
   UserType extends string,
   PolicyType extends string,

packages/fabric/core/src/domain/types/index.ts

@@ -1,3 +1,3 @@
 export * from "./email.js";
-export * from "./semver.js";
+export * from "./sem-ver.js";
 export * from "./uuid.js";

packages/fabric/core/src/domain/use-case/use-case.ts

@@ -3,6 +3,11 @@ import { AsyncResult } from "../../result/async-result.js";
 
 /**
  * A use case is a piece of domain logic that can be executed.
+ *
+ * It can be one of two types:
+ *
+ *  - `Query`: A use case that only reads data.
+ *  - `Command`: A use case that modifies data.
  */
 export type UseCase<
   TDependencies,

packages/fabric/core/src/error/is-error.ts

@@ -1,8 +1,15 @@
+import { VariantTag } from "../variant/variant.js";
 import { TaggedError } from "./tagged-error.js";
 
 /**
  * Indicates if a value is an error.
+ *
+ * In case it is an error, the type of the error is able to be inferred.
  */
 export function isError(err: unknown): err is TaggedError<string> {
-  return err instanceof TaggedError;
+  return (
+    err instanceof Error &&
+    VariantTag in err &&
+    typeof err[VariantTag] === "string"
+  );
 }

packages/fabric/core/src/error/tagged-error.ts

@@ -1,7 +1,9 @@
 import { TaggedVariant, VariantTag } from "../variant/index.js";
 
 /**
- * A TaggedError is a tagged variant with an error message.
+ * Un TaggedError es un error que tiene un tag que lo identifica, lo cual
+ * permite a los consumidores de la instancia de error identificar el tipo de
+ * error que ocurrió.
  */
 export class TaggedError<Tag extends string>
   extends Error

packages/fabric/core/src/error/unexpected-error.ts

@@ -1,11 +1,11 @@
 import { TaggedError } from "./tagged-error.js";
 
 /**
- * `UnexpectedError` represents any type of unexpected error.
+ * `UnexpectedError` representa cualquier tipo de error inesperado.
  *
- * This error is used to represent errors that should not occur in
+ * Este error se utiliza para representar errores que no deberían ocurrir en
- * the application logic, but that could always happen and
+ * la lógica de la aplicación, pero que siempre podrían suceder y
- * we must be prepared to handle.
+ * debemos estar preparados para manejarlos.
  */
 export class UnexpectedError extends TaggedError<"UnexpectedError"> {
   constructor() {

packages/fabric/core/src/files/index.ts

@@ -1,8 +0,0 @@
-export * from "./base-file.js";
-export * from "./bytes.js";
-export * from "./invalid-file-type-error.js";
-export * from "./is-mime-type.js";
-export * from "./is-uploaded-file.js";
-export * from "./media-file.js";
-export * from "./mime-type.js";
-export * from "./uploaded-file.js";

packages/fabric/core/src/index.ts

@@ -1,4 +1,3 @@
-export * from "./array/index.js";
 export * from "./domain/index.js";
 export * from "./error/index.js";
 export * from "./record/index.js";

packages/fabric/core/src/time/timeout.spec.ts

@@ -32,7 +32,7 @@ describe("timeout", () => {
     },
   );
 
-  test("using timeout we can define a timeout in milliseconds", async () => {
+  test("using ms we can define a timeout in milliseconds", async () => {
     const start = Date.now();
     await timeout(100);
     const end = Date.now();