@cullet/erp-core 1.0.2 → 1.0.3

package/src/core/errors/serialization-error.ts

@@ -9,49 +9,49 @@ import type { AppErrorOptions } from "./types";
 type SerializationDirection = "serialize" | "deserialize";
 
 type SerializationFailureCategory =
-  | "invalid_json"
-  | "invalid_shape"
-  | "missing_field"
-  | "unexpected_field"
-  | "invalid_type"
-  | "schema_version_missing"
-  | "schema_version_unsupported"
-  | "mapping_not_implemented"
-  | "contract_mismatch"
-  | "parse_failed"
-  | "stringify_failed"
-  | "unknown";
+    | "invalid_json"
+    | "invalid_shape"
+    | "missing_field"
+    | "unexpected_field"
+    | "invalid_type"
+    | "schema_version_missing"
+    | "schema_version_unsupported"
+    | "mapping_not_implemented"
+    | "contract_mismatch"
+    | "parse_failed"
+    | "stringify_failed"
+    | "unknown";
 
 type SerializationBoundary =
-  | "http_in"
-  | "http_out"
-  | "graphql_in"
-  | "graphql_out"
-  | "dto_to_domain"
-  | "domain_to_dto"
-  | "persistence_to_domain"
-  | "domain_to_persistence"
-  | "event_in"
-  | "event_out"
-  | "projection"
-  | "unknown";
+    | "http_in"
+    | "http_out"
+    | "graphql_in"
+    | "graphql_out"
+    | "dto_to_domain"
+    | "domain_to_dto"
+    | "persistence_to_domain"
+    | "domain_to_persistence"
+    | "event_in"
+    | "event_out"
+    | "projection"
+    | "unknown";
 
 /**
  * Metadata shared by serialization/deserialization failures. Payload previews must be sanitized.
  */
 type SerializationErrorMetadata = {
-  direction: SerializationDirection;
-  category: SerializationFailureCategory;
-  boundary: SerializationBoundary;
-  contract: string;
-  schemaVersion?: number | string;
-  path?: string;
-  payloadPreview?: string;
-  correlationId?: string;
-  requestId?: string;
-  commandId?: string;
-  hint?: string;
-  details?: string;
+    direction: SerializationDirection;
+    category: SerializationFailureCategory;
+    boundary: SerializationBoundary;
+    contract: string;
+    schemaVersion?: number | string;
+    path?: string;
+    payloadPreview?: string;
+    correlationId?: string;
+    requestId?: string;
+    commandId?: string;
+    hint?: string;
+    details?: string;
 };
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -59,43 +59,43 @@ type SerializationErrorMetadata = {
 // ─────────────────────────────────────────────────────────────────────────────
 
 type SerializationErrorOptions = Omit<AppErrorOptions, "metadata"> & {
-  message: string;
-  code: string;
-  metadata: Omit<SerializationErrorMetadata, "direction" | "category">;
-  direction: SerializationDirection;
-  category: SerializationFailureCategory;
+    message: string;
+    code: string;
+    metadata: Omit<SerializationErrorMetadata, "direction" | "category">;
+    direction: SerializationDirection;
+    category: SerializationFailureCategory;
 };
 
 abstract class SerializationError extends AppError {
-  public readonly direction: SerializationDirection;
-  public readonly category: SerializationFailureCategory;
-  public readonly boundary: SerializationBoundary;
-  public readonly contract: string;
-
-  protected constructor(input: SerializationErrorOptions) {
-    super(input.message ?? "Serialization failure", input.code, {
-      cause: input.cause,
-      metadata: {
-        direction: input.direction,
-        category: input.category,
-        ...input.metadata,
-      },
-      type: input.type,
-      severity: input.severity,
-      correlationId: input.correlationId,
-      requestId: input.requestId,
-      commandId: input.commandId,
-      createdAtIso: input.createdAtIso,
-      publicMessage: input.publicMessage,
-    });
-
-    this.direction = input.direction;
-    this.category = input.category;
-    this.boundary = input.metadata.boundary;
-    this.contract = input.metadata.contract;
-
-    Object.freeze(this);
-  }
+    public readonly direction: SerializationDirection;
+    public readonly category: SerializationFailureCategory;
+    public readonly boundary: SerializationBoundary;
+    public readonly contract: string;
+
+    protected constructor(input: SerializationErrorOptions) {
+        super(input.message ?? "Serialization failure", input.code, {
+            cause: input.cause,
+            metadata: {
+                direction: input.direction,
+                category: input.category,
+                ...input.metadata,
+            },
+            type: input.type,
+            severity: input.severity,
+            correlationId: input.correlationId,
+            requestId: input.requestId,
+            commandId: input.commandId,
+            createdAtIso: input.createdAtIso,
+            publicMessage: input.publicMessage,
+        });
+
+        this.direction = input.direction;
+        this.category = input.category;
+        this.boundary = input.metadata.boundary;
+        this.contract = input.metadata.contract;
+
+        Object.freeze(this);
+    }
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -103,25 +103,25 @@ abstract class SerializationError extends AppError {
 // ─────────────────────────────────────────────────────────────────────────────
 
 class SerializationInError extends SerializationError {
-  private constructor(input: SerializationErrorOptions) {
-    super(input);
-  }
-
-  static failure(
-    category: SerializationFailureCategory,
-    metadata: Omit<SerializationErrorMetadata, "direction" | "category"> & {
-      cause?: unknown;
-    },
-  ): SerializationInError {
-    return new SerializationInError({
-      message: SerializationMessages.message("deserialize", category),
-      code: SerializationCodes.code("deserialize", category),
-      category,
-      direction: "deserialize",
-      metadata,
-      cause: metadata.cause,
-    });
-  }
+    private constructor(input: SerializationErrorOptions) {
+        super(input);
+    }
+
+    static failure(
+        category: SerializationFailureCategory,
+        metadata: Omit<SerializationErrorMetadata, "direction" | "category"> & {
+            cause?: unknown;
+        },
+    ): SerializationInError {
+        return new SerializationInError({
+            message: SerializationMessages.message("deserialize", category),
+            code: SerializationCodes.code("deserialize", category),
+            category,
+            direction: "deserialize",
+            metadata,
+            cause: metadata.cause,
+        });
+    }
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -129,25 +129,25 @@ class SerializationInError extends SerializationError {
 // ─────────────────────────────────────────────────────────────────────────────
 
 class SerializationOutError extends SerializationError {
-  private constructor(input: SerializationErrorOptions) {
-    super(input);
-  }
-
-  static failure(
-    category: SerializationFailureCategory,
-    metadata: Omit<SerializationErrorMetadata, "direction" | "category"> & {
-      cause?: unknown;
-    },
-  ): SerializationOutError {
-    return new SerializationOutError({
-      message: SerializationMessages.message("serialize", category),
-      code: SerializationCodes.code("serialize", category),
-      category,
-      direction: "serialize",
-      metadata,
-      cause: metadata.cause,
-    });
-  }
+    private constructor(input: SerializationErrorOptions) {
+        super(input);
+    }
+
+    static failure(
+        category: SerializationFailureCategory,
+        metadata: Omit<SerializationErrorMetadata, "direction" | "category"> & {
+            cause?: unknown;
+        },
+    ): SerializationOutError {
+        return new SerializationOutError({
+            message: SerializationMessages.message("serialize", category),
+            code: SerializationCodes.code("serialize", category),
+            category,
+            direction: "serialize",
+            metadata,
+            cause: metadata.cause,
+        });
+    }
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -155,49 +155,49 @@ class SerializationOutError extends SerializationError {
 // ─────────────────────────────────────────────────────────────────────────────
 
 class SerializationCodes {
-  static code(
-    direction: SerializationDirection,
-    category: SerializationFailureCategory,
-  ): string {
-    return serializationErrorCode(direction, category);
-  }
+    static code(
+        direction: SerializationDirection,
+        category: SerializationFailureCategory,
+    ): string {
+        return serializationErrorCode(direction, category);
+    }
 }
 
 class SerializationMessages {
-  static message(
-    direction: SerializationDirection,
-    category: SerializationFailureCategory,
-  ): string {
-    if (direction === "deserialize") {
-      if (category === "invalid_json") {
-        return "Invalid payload: malformed JSON";
-      }
-      if (category === "schema_version_missing") {
-        return "Invalid payload: schemaVersion is missing";
-      }
-      if (category === "schema_version_unsupported") {
-        return "Invalid payload: schemaVersion is not supported";
-      }
-      if (category === "invalid_shape") {
-        return "Invalid payload: incompatible shape";
-      }
-      if (category === "mapping_not_implemented") {
-        return "Unsupported payload: mapping not implemented";
-      }
-      if (category === "contract_mismatch") {
-        return "Payload does not match the expected contract";
-      }
-      return "Failed to parse incoming payload";
-    }
-
-    if (category === "stringify_failed") {
-      return "Failed to serialize the response";
-    }
-    if (category === "contract_mismatch") {
-      return "Response does not match the expected contract";
+    static message(
+        direction: SerializationDirection,
+        category: SerializationFailureCategory,
+    ): string {
+        if (direction === "deserialize") {
+            if (category === "invalid_json") {
+                return "Invalid payload: malformed JSON";
+            }
+            if (category === "schema_version_missing") {
+                return "Invalid payload: schemaVersion is missing";
+            }
+            if (category === "schema_version_unsupported") {
+                return "Invalid payload: schemaVersion is not supported";
+            }
+            if (category === "invalid_shape") {
+                return "Invalid payload: incompatible shape";
+            }
+            if (category === "mapping_not_implemented") {
+                return "Unsupported payload: mapping not implemented";
+            }
+            if (category === "contract_mismatch") {
+                return "Payload does not match the expected contract";
+            }
+            return "Failed to parse incoming payload";
+        }
+
+        if (category === "stringify_failed") {
+            return "Failed to serialize the response";
+        }
+        if (category === "contract_mismatch") {
+            return "Response does not match the expected contract";
+        }
+        return "Failed to build the response";
     }
-    return "Failed to build the response";
-  }
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -205,29 +205,29 @@ class SerializationMessages {
 // ─────────────────────────────────────────────────────────────────────────────
 
 function safePreview(value: unknown, limit = 240): string | undefined {
-  try {
-    const serialized =
-      typeof value === "string" ? value : JSON.stringify(value);
-    return serialized.length > limit
-      ? `${serialized.slice(0, limit)}…`
-      : serialized;
-  } catch {
-    return undefined;
-  }
+    try {
+        const serialized =
+            typeof value === "string" ? value : JSON.stringify(value);
+        return serialized.length > limit
+            ? `${serialized.slice(0, limit)}…`
+            : serialized;
+    } catch {
+        return undefined;
+    }
 }
 
 export {
-  safePreview,
-  SerializationCodes,
-  SerializationError,
-  SerializationInError as DeserializationError,
-  SerializationInError,
-  SerializationMessages,
-  SerializationOutError,
+    safePreview,
+    SerializationCodes,
+    SerializationError,
+    SerializationInError as DeserializationError,
+    SerializationInError,
+    SerializationMessages,
+    SerializationOutError,
 };
 export type {
-  SerializationBoundary,
-  SerializationDirection,
-  SerializationErrorMetadata,
-  SerializationFailureCategory,
+    SerializationBoundary,
+    SerializationDirection,
+    SerializationErrorMetadata,
+    SerializationFailureCategory,
 };

package/src/core/errors/temporal-error.ts

@@ -7,139 +7,141 @@ type TemporalKind = "expired" | "not_yet_valid";
 type TemporalPrecision = "EXACT" | "ESTIMATED" | "UNKNOWN" | "APPROXIMATE";
 
 type TemporalErrorMetadata = {
-  resourceType: string;
-  resourceId?: string;
-  operation?: string;
-  validFromIso?: string | null;
-  validUntilIso?: string | null;
-  evaluatedAtIso: string;
-  policyId?: string;
-  precision?: TemporalPrecision;
-  hint?: string;
-  details?: string;
-  correlationId?: string;
-  requestId?: string;
-  commandId?: string;
+    resourceType: string;
+    resourceId?: string;
+    operation?: string;
+    validFromIso?: string | null;
+    validUntilIso?: string | null;
+    evaluatedAtIso: string;
+    policyId?: string;
+    precision?: TemporalPrecision;
+    hint?: string;
+    details?: string;
+    correlationId?: string;
+    requestId?: string;
+    commandId?: string;
 };
 
 type TemporalErrorOptions = {
-  message: string;
-  code: string;
-  kind: TemporalKind;
-  metadata: TemporalErrorMetadata;
+    message: string;
+    code: string;
+    kind: TemporalKind;
+    metadata: TemporalErrorMetadata;
 } & AppErrorOptions;
 
 abstract class TemporalError extends AppError {
-  public readonly kind: TemporalKind;
-  public readonly resourceType: string;
-  public readonly evaluatedAtIso: string;
-
-  protected constructor(input: TemporalErrorOptions) {
-    super(input.message, input.code, {
-      ...input,
-      metadata: {
-        kind: input.kind,
-        ...input.metadata,
-      },
-    });
-
-    this.kind = input.kind;
-    this.resourceType = input.metadata.resourceType;
-    this.evaluatedAtIso = input.metadata.evaluatedAtIso;
-    Object.freeze(this);
-  }
+    public readonly kind: TemporalKind;
+    public readonly resourceType: string;
+    public readonly evaluatedAtIso: string;
+
+    protected constructor(input: TemporalErrorOptions) {
+        super(input.message, input.code, {
+            ...input,
+            metadata: {
+                kind: input.kind,
+                ...input.metadata,
+            },
+        });
+
+        this.kind = input.kind;
+        this.resourceType = input.metadata.resourceType;
+        this.evaluatedAtIso = input.metadata.evaluatedAtIso;
+        Object.freeze(this);
+    }
 }
 
 type TemporalCreationInput = TemporalErrorMetadata &
-  Partial<Omit<AppErrorOptions, "metadata">> & {
-    cause?: unknown;
-  };
+    Partial<Omit<AppErrorOptions, "metadata">> & {
+        cause?: unknown;
+    };
 
 class ExpiredError extends TemporalError {
-  private constructor(input: TemporalErrorOptions) {
-    super(input);
-  }
-
-  static detected(input: TemporalCreationInput): ExpiredError {
-    return new ExpiredError({
-      message: "The validity of the resource/action has expired",
-      code: ErrorCodes.temporal.expired,
-      kind: "expired",
-      metadata: {
-        ...input,
-        hint:
-          input.hint ??
-          "The window has expired. Request a new link or try again within the valid period.",
-      },
-      cause: input.cause,
-      type: input.type,
-      severity: input.severity,
-      correlationId: input.correlationId,
-      requestId: input.requestId,
-      commandId: input.commandId,
-      createdAtIso: input.createdAtIso,
-      publicMessage: input.publicMessage,
-    });
-  }
+    private constructor(input: TemporalErrorOptions) {
+        super(input);
+    }
+
+    static detected(input: TemporalCreationInput): ExpiredError {
+        return new ExpiredError({
+            message: "The validity of the resource/action has expired",
+            code: ErrorCodes.temporal.expired,
+            kind: "expired",
+            metadata: {
+                ...input,
+                hint:
+                    input.hint ??
+                    "The window has expired. Request a new link or try again within the valid period.",
+            },
+            cause: input.cause,
+            type: input.type,
+            severity: input.severity,
+            correlationId: input.correlationId,
+            requestId: input.requestId,
+            commandId: input.commandId,
+            createdAtIso: input.createdAtIso,
+            publicMessage: input.publicMessage,
+        });
+    }
 }
 
 class NotYetValidError extends TemporalError {
-  private constructor(input: TemporalErrorOptions) {
-    super(input);
-  }
-
-  static detected(input: TemporalCreationInput): NotYetValidError {
-    return new NotYetValidError({
-      message: "The resource/action is not yet valid",
-      code: ErrorCodes.temporal.notYetValid,
-      kind: "not_yet_valid",
-      metadata: {
-        ...input,
-        hint: input.hint ?? "Not yet within the valid period. Try again later.",
-      },
-      cause: input.cause,
-      type: input.type,
-      severity: input.severity,
-      correlationId: input.correlationId,
-      requestId: input.requestId,
-      commandId: input.commandId,
-      createdAtIso: input.createdAtIso,
-      publicMessage: input.publicMessage,
-    });
-  }
+    private constructor(input: TemporalErrorOptions) {
+        super(input);
+    }
+
+    static detected(input: TemporalCreationInput): NotYetValidError {
+        return new NotYetValidError({
+            message: "The resource/action is not yet valid",
+            code: ErrorCodes.temporal.notYetValid,
+            kind: "not_yet_valid",
+            metadata: {
+                ...input,
+                hint:
+                    input.hint ??
+                    "Not yet within the valid period. Try again later.",
+            },
+            cause: input.cause,
+            type: input.type,
+            severity: input.severity,
+            correlationId: input.correlationId,
+            requestId: input.requestId,
+            commandId: input.commandId,
+            createdAtIso: input.createdAtIso,
+            publicMessage: input.publicMessage,
+        });
+    }
 }
 
 function evaluateTemporalWindow(input: {
-  validFromIso?: string | null;
-  validUntilIso?: string | null;
-  evaluatedAtIso: string;
+    validFromIso?: string | null;
+    validUntilIso?: string | null;
+    evaluatedAtIso: string;
 }): { expired: boolean; notYetValid: boolean } | null {
-  const evaluatedMs = Date.parse(input.evaluatedAtIso);
-  if (Number.isNaN(evaluatedMs)) return null;
+    const evaluatedMs = Date.parse(input.evaluatedAtIso);
+    if (Number.isNaN(evaluatedMs)) return null;
 
-  let notYetValid = false;
+    let notYetValid = false;
 
-  if (input.validFromIso) {
-    const fromMs = Date.parse(input.validFromIso);
-    if (!Number.isNaN(fromMs) && evaluatedMs < fromMs) {
-      notYetValid = true;
+    if (input.validFromIso) {
+        const fromMs = Date.parse(input.validFromIso);
+        if (!Number.isNaN(fromMs) && evaluatedMs < fromMs) {
+            notYetValid = true;
+        }
     }
-  }
 
-  if (input.validUntilIso) {
-    const untilMs = Date.parse(input.validUntilIso);
-    if (!Number.isNaN(untilMs) && evaluatedMs > untilMs) {
-      return { expired: true, notYetValid: false };
+    if (input.validUntilIso) {
+        const untilMs = Date.parse(input.validUntilIso);
+        if (!Number.isNaN(untilMs) && evaluatedMs > untilMs) {
+            return { expired: true, notYetValid: false };
+        }
     }
-  }
 
-  return { expired: false, notYetValid };
+    return { expired: false, notYetValid };
 }
 
 export {
-  evaluateTemporalWindow,
-  ExpiredError,
-  NotYetValidError,
-  TemporalError,
+    evaluateTemporalWindow,
+    ExpiredError,
+    NotYetValidError,
+    TemporalError,
 };
 export type { TemporalErrorMetadata, TemporalKind, TemporalPrecision };