@univ-lehavre/atlas-errors

Erreurs applicatives normalisées pour les applications Atlas.

About

Ce package définit une base ApplicationError, des erreurs concrètes pour session, JSON, content-type, email, domaine autorisé et magic link, puis les convertit en réponses API structurées. Il sert de couche commune entre validateurs, services Appwrite et routes SvelteKit.

Features

• Typed errors: Error classes with codes and HTTP statuses
• Authentication errors: SessionError, MagicUrlLoginValidationError
• Validation errors: InvalidJsonBodyError, InvalidContentTypeError, NotAnEmailError
• API mapping: Automatic conversion to standardized JSON responses

Installation

pnpm add @univ-lehavre/atlas-errors

Usage

import {
  SessionError,
  InvalidJsonBodyError,
  InvalidContentTypeError,
  NotAnEmailError,
  mapErrorToApiResponse,
} from '@univ-lehavre/atlas-errors';

// Throw a typed error
if (!session) {
  throw new SessionError('No active session', { cause: 'Cookie expired' });
}

// Convert an error to API response
try {
  // ... operation
} catch (error) {
  const { body, status } = mapErrorToApiResponse(error);
  return json(body, { status });
}

API

Error Classes

| Class | HTTP Code | Description | |-------|-----------|-------------| | SessionError | 401 | Missing or invalid session | | InvalidJsonBodyError | 400 | Invalid JSON request body | | InvalidContentTypeError | 400 | Content-Type not application/json | | NotAnEmailError | 400 | Invalid or unauthorized email | | NotPartOfAllianceError | 400 | Unauthorized email domain | | MagicUrlLoginValidationError | 400 | Invalid magic URL parameters | | UserIdValidationError | 400 | Invalid user ID | | RequestBodyValidationError | 400 | Invalid request body |

Functions

| Function | Description | |----------|-------------| | mapErrorToApiResponse(error) | Converts an error to a structured API response |

Scripts

pnpm -F @univ-lehavre/atlas-errors dev      # Development
pnpm -F @univ-lehavre/atlas-errors build    # Build
pnpm -F @univ-lehavre/atlas-errors test     # Tests
pnpm -F @univ-lehavre/atlas-errors lint     # ESLint

Documentation

• API Documentation

Organization

This package is part of Atlas, a set of tools developed by Le Havre Normandie University to facilitate research and collaboration between researchers.

Atlas is developed as part of two projects led by Le Havre Normandie University:

• Campus Polytechnique des Territoires Maritimes et Portuaires: research and training program focused on maritime and port issues
• EUNICoast: European university alliance bringing together institutions located in European coastal areas

License

MIT