@cullet/erp-core 1.0.1 → 1.0.3

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

@@ -9,77 +9,77 @@ import { assertJsonSafeMetadata } from "./utils";
 // ─────────────────────────────────────────────────────────────────────────────
 
 abstract class AppError extends Error {
-  public readonly code: string;
-  public readonly cause?: unknown;
-  public readonly metadata?: JsonSafeRecord;
-  public readonly type?: string;
-  public readonly severity?: ErrorSeverity;
-  public readonly createdAtIso: string;
-  public readonly publicMessage?: string;
-  /**
-   * Identifies a single execution "story" in the system. All operations
-   * related to the same logical flow must share the same correlationId.
-   */
-  public readonly correlationId?: string;
-  /**
-   * Identifies a specific technical request attempt (each retry may produce
-   * a new requestId), even when the correlationId stays the same.
-   */
-  public readonly requestId?: string;
-  /**
-   * Marks the business intent / idempotency key; stays the same across
-   * technical retries and multiple requests that represent the same intent.
-   */
-  public readonly commandId?: string;
+    public readonly code: string;
+    public readonly cause?: unknown;
+    public readonly metadata?: JsonSafeRecord;
+    public readonly type?: string;
+    public readonly severity?: ErrorSeverity;
+    public readonly createdAtIso: string;
+    public readonly publicMessage?: string;
+    /**
+     * Identifies a single execution "story" in the system. All operations
+     * related to the same logical flow must share the same correlationId.
+     */
+    public readonly correlationId?: string;
+    /**
+     * Identifies a specific technical request attempt (each retry may produce
+     * a new requestId), even when the correlationId stays the same.
+     */
+    public readonly requestId?: string;
+    /**
+     * Marks the business intent / idempotency key; stays the same across
+     * technical retries and multiple requests that represent the same intent.
+     */
+    public readonly commandId?: string;
 
-  protected constructor(
-    message: string,
-    code: string,
-    options?: AppErrorOptions,
-  ) {
-    super(message);
+    protected constructor(
+        message: string,
+        code: string,
+        options?: AppErrorOptions,
+    ) {
+        super(message);
 
-    this.name = new.target.name;
-    this.code = code;
-    this.cause = options?.cause;
-    this.type = options?.type;
-    this.severity = options?.severity;
-    this.correlationId = options?.correlationId;
-    this.requestId = options?.requestId;
-    this.commandId = options?.commandId;
-    this.createdAtIso = options?.createdAtIso ?? new Date().toISOString();
-    this.publicMessage = options?.publicMessage;
+        this.name = new.target.name;
+        this.code = code;
+        this.cause = options?.cause;
+        this.type = options?.type;
+        this.severity = options?.severity;
+        this.correlationId = options?.correlationId;
+        this.requestId = options?.requestId;
+        this.commandId = options?.commandId;
+        this.createdAtIso = options?.createdAtIso ?? new Date().toISOString();
+        this.publicMessage = options?.publicMessage;
 
-    this.metadata = options?.metadata
-      ? assertJsonSafeMetadata(options.metadata)
-      : undefined;
+        this.metadata = options?.metadata
+            ? assertJsonSafeMetadata(options.metadata)
+            : undefined;
 
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
 
-  /**
-   * Returns a JSON-safe representation of the error.
-   * Does NOT include `cause` by default (to avoid leaking internal details).
-   */
-  public toJSON(): Record<string, unknown> {
-    const payload: Record<string, unknown> = {
-      name: this.name,
-      code: this.code,
-      type: this.type,
-      severity: this.severity,
-      message: this.message,
-      publicMessage: this.publicMessage,
-      createdAtIso: this.createdAtIso,
-      metadata: this.metadata,
-    };
+    /**
+     * Returns a JSON-safe representation of the error.
+     * Does NOT include `cause` by default (to avoid leaking internal details).
+     */
+    public toJSON(): Record<string, unknown> {
+        const payload: Record<string, unknown> = {
+            name: this.name,
+            code: this.code,
+            type: this.type,
+            severity: this.severity,
+            message: this.message,
+            publicMessage: this.publicMessage,
+            createdAtIso: this.createdAtIso,
+            metadata: this.metadata,
+        };
 
-    if (this.correlationId !== undefined)
-      payload.correlationId = this.correlationId;
-    if (this.requestId !== undefined) payload.requestId = this.requestId;
-    if (this.commandId !== undefined) payload.commandId = this.commandId;
+        if (this.correlationId !== undefined)
+            payload.correlationId = this.correlationId;
+        if (this.requestId !== undefined) payload.requestId = this.requestId;
+        if (this.commandId !== undefined) payload.commandId = this.commandId;
 
-    return payload;
-  }
+        return payload;
+    }
 }
 
 export { AppError };

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

@@ -7,137 +7,137 @@ import type { AppErrorOptions, ErrorSeverity } from "./types";
 // ─────────────────────────────────────────────────────────────────────────────
 
 type AuthenticationErrorReason =
-  | "missing_token"
-  | "malformed_token"
-  | "invalid_token"
-  | "expired_token"
-  | "revoked_token"
-  | "invalid_credentials"
-  | "session_not_found"
-  | "session_expired"
-  | "unknown";
+    | "missing_token"
+    | "malformed_token"
+    | "invalid_token"
+    | "expired_token"
+    | "revoked_token"
+    | "invalid_credentials"
+    | "session_not_found"
+    | "session_expired"
+    | "unknown";
 
 type AuthenticationErrorMetadata = {
-  reason: AuthenticationErrorReason;
-  authScheme?: "bearer" | "cookie" | "basic" | "unknown";
-  tokenLocation?: "header" | "cookie" | "query" | "unknown";
-  expiresAtIso?: string;
-  correlationId?: string;
-  requestId?: string;
-  details?: string;
+    reason: AuthenticationErrorReason;
+    authScheme?: "bearer" | "cookie" | "basic" | "unknown";
+    tokenLocation?: "header" | "cookie" | "query" | "unknown";
+    expiresAtIso?: string;
+    correlationId?: string;
+    requestId?: string;
+    details?: string;
 };
 
 type AuthenticationErrorFactoryOptions = Omit<
-  AuthenticationErrorMetadata,
-  "reason"
+    AuthenticationErrorMetadata,
+    "reason"
 > &
-  Omit<AppErrorOptions, "metadata">;
+    Omit<AppErrorOptions, "metadata">;
 
 // ─────────────────────────────────────────────────────────────────────────────
 // AuthenticationError
 // ─────────────────────────────────────────────────────────────────────────────
 
 class AuthenticationError extends AppError {
-  public readonly reason: AuthenticationErrorReason;
-
-  private constructor(params: {
-    message: string;
-    code: string;
-    reason: AuthenticationErrorReason;
-    metadata?: Omit<AuthenticationErrorMetadata, "reason">;
-    cause?: unknown;
-    type?: string;
-    severity?: ErrorSeverity;
-    correlationId?: string;
-    requestId?: string;
-    commandId?: string;
-    createdAtIso?: string;
-    publicMessage?: string;
-  }) {
-    super(params.message, params.code, {
-      cause: params.cause,
-      metadata: {
-        reason: params.reason,
-        ...(params.metadata ?? {}),
-      },
-      type: params.type,
-      severity: params.severity,
-      correlationId: params.correlationId,
-      requestId: params.requestId,
-      commandId: params.commandId,
-      createdAtIso: params.createdAtIso,
-      publicMessage: params.publicMessage,
-    });
-
-    this.reason = params.reason;
-    Object.freeze(this);
-  }
-
-  // ─────────────────────────────────────────────────────────────────────────
-  // Factory methods
-  // ─────────────────────────────────────────────────────────────────────────
-
-  static missingToken(
-    options?: AuthenticationErrorFactoryOptions,
-  ): AuthenticationError {
-    return new AuthenticationError({
-      message: "Missing credentials",
-      code: ErrorCodes.authentication.missingToken,
-      reason: "missing_token",
-      metadata: compactMetadata(options),
-      ...extractAppErrorOptions(options),
-    });
-  }
-
-  static invalidToken(
-    options?: AuthenticationErrorFactoryOptions & { cause?: unknown },
-  ): AuthenticationError {
-    return new AuthenticationError({
-      message: "Invalid credentials",
-      code: ErrorCodes.authentication.invalidToken,
-      reason: "invalid_token",
-      metadata: compactMetadata({
-        authScheme: options?.authScheme,
-        tokenLocation: options?.tokenLocation,
-        details: options?.details,
-        correlationId: options?.correlationId,
-        requestId: options?.requestId,
-      }),
-      ...extractAppErrorOptions(options),
-    });
-  }
-
-  static expiredToken(
-    options?: AuthenticationErrorFactoryOptions & { sessionId?: string },
-  ): AuthenticationError {
-    return new AuthenticationError({
-      message: "Expired credentials",
-      code: ErrorCodes.authentication.expiredToken,
-      reason: "expired_token",
-      metadata: compactMetadata(options),
-      ...extractAppErrorOptions(options),
-    });
-  }
-
-  static invalidCredentials(
-    options?: Pick<
-      AuthenticationErrorFactoryOptions,
-      | "correlationId"
-      | "requestId"
-      | "type"
-      | "severity"
-      | "createdAtIso"
-      | "publicMessage"
-    >,
-  ): AuthenticationError {
-    return new AuthenticationError({
-      message: "Invalid username or password",
-      code: ErrorCodes.authentication.invalidCredentials,
-      reason: "invalid_credentials",
-      metadata: compactMetadata(options),
-      ...extractAppErrorOptions(options),
-    });
-  }
+    public readonly reason: AuthenticationErrorReason;
+
+    private constructor(params: {
+        message: string;
+        code: string;
+        reason: AuthenticationErrorReason;
+        metadata?: Omit<AuthenticationErrorMetadata, "reason">;
+        cause?: unknown;
+        type?: string;
+        severity?: ErrorSeverity;
+        correlationId?: string;
+        requestId?: string;
+        commandId?: string;
+        createdAtIso?: string;
+        publicMessage?: string;
+    }) {
+        super(params.message, params.code, {
+            cause: params.cause,
+            metadata: {
+                reason: params.reason,
+                ...(params.metadata ?? {}),
+            },
+            type: params.type,
+            severity: params.severity,
+            correlationId: params.correlationId,
+            requestId: params.requestId,
+            commandId: params.commandId,
+            createdAtIso: params.createdAtIso,
+            publicMessage: params.publicMessage,
+        });
+
+        this.reason = params.reason;
+        Object.freeze(this);
+    }
+
+    // ─────────────────────────────────────────────────────────────────────────
+    // Factory methods
+    // ─────────────────────────────────────────────────────────────────────────
+
+    static missingToken(
+        options?: AuthenticationErrorFactoryOptions,
+    ): AuthenticationError {
+        return new AuthenticationError({
+            message: "Missing credentials",
+            code: ErrorCodes.authentication.missingToken,
+            reason: "missing_token",
+            metadata: compactMetadata(options),
+            ...extractAppErrorOptions(options),
+        });
+    }
+
+    static invalidToken(
+        options?: AuthenticationErrorFactoryOptions & { cause?: unknown },
+    ): AuthenticationError {
+        return new AuthenticationError({
+            message: "Invalid credentials",
+            code: ErrorCodes.authentication.invalidToken,
+            reason: "invalid_token",
+            metadata: compactMetadata({
+                authScheme: options?.authScheme,
+                tokenLocation: options?.tokenLocation,
+                details: options?.details,
+                correlationId: options?.correlationId,
+                requestId: options?.requestId,
+            }),
+            ...extractAppErrorOptions(options),
+        });
+    }
+
+    static expiredToken(
+        options?: AuthenticationErrorFactoryOptions & { sessionId?: string },
+    ): AuthenticationError {
+        return new AuthenticationError({
+            message: "Expired credentials",
+            code: ErrorCodes.authentication.expiredToken,
+            reason: "expired_token",
+            metadata: compactMetadata(options),
+            ...extractAppErrorOptions(options),
+        });
+    }
+
+    static invalidCredentials(
+        options?: Pick<
+            AuthenticationErrorFactoryOptions,
+            | "correlationId"
+            | "requestId"
+            | "type"
+            | "severity"
+            | "createdAtIso"
+            | "publicMessage"
+        >,
+    ): AuthenticationError {
+        return new AuthenticationError({
+            message: "Invalid username or password",
+            code: ErrorCodes.authentication.invalidCredentials,
+            reason: "invalid_credentials",
+            metadata: compactMetadata(options),
+            ...extractAppErrorOptions(options),
+        });
+    }
 }
 
 // ─────────────────────────────────────────────────────────────────────────────
@@ -145,26 +145,26 @@ class AuthenticationError extends AppError {
 // ─────────────────────────────────────────────────────────────────────────────
 
 function extractAppErrorOptions(options?: Partial<AppErrorOptions>) {
-  return {
-    cause: options?.cause,
-    type: options?.type,
-    severity: options?.severity,
-    correlationId: options?.correlationId,
-    requestId: options?.requestId,
-    commandId: options?.commandId,
-    createdAtIso: options?.createdAtIso,
-    publicMessage: options?.publicMessage,
-  };
+    return {
+        cause: options?.cause,
+        type: options?.type,
+        severity: options?.severity,
+        correlationId: options?.correlationId,
+        requestId: options?.requestId,
+        commandId: options?.commandId,
+        createdAtIso: options?.createdAtIso,
+        publicMessage: options?.publicMessage,
+    };
 }
 
 function compactMetadata<T extends Record<string, unknown>>(
-  input?: T,
+    input?: T,
 ): T | undefined {
-  if (!input) return undefined;
+    if (!input) return undefined;
 
-  return Object.fromEntries(
-    Object.entries(input).filter(([, value]) => value !== undefined),
-  ) as T;
+    return Object.fromEntries(
+        Object.entries(input).filter(([, value]) => value !== undefined),
+    ) as T;
 }
 
 export { AuthenticationError };