Brique

aggregate-kit

LE DOMAINE EN KIT.

aggregate-kit est un paquet npm de briques Domain-Driven Design pour TypeScript, sans dépendance, pour les bases de code en Clean Architecture.

Je copiais les mêmes briques de domaine d'un projet à l'autre. Je les ai extraites dans un seul paquet ESM, testé, que n'importe quelle base Clean Architecture peut importer.

  • Dépôt public
  • Mis à jour le
  • npm v1.0.0
  • 0 dépendance
  • ESM
  • 0dépendance
  • v1.0.0sur npm

Le problème

Dans chaque projet en Domain-Driven Design, je réécrivais les mêmes fondations : un type Result pour les erreurs métier, un Option pour l'absence, des entités, des agrégats, des value objects, des événements. Chaque copie dérivait un peu de la précédente, et les corrections d'un projet n'arrivaient jamais dans les autres. Il fallait une seule source, versionnée, que chaque base de code importe au lieu de recopier.

Ce que ça fait

Les erreurs deviennent des valeurs avec Result<T, E>, l'absence devient un Option<T>. Les agrégats collectent leurs événements de domaine, que pullDomainEvents() remet à une outbox. Les ports de repository et d'unit of work gardent le domaine pur. Avec ScopedRepository, une ressource qui appartient à quelqu'un d'autre se lit comme absente, jamais comme interdite. Les identifiants sont typés et générés en UUID v7.

Où ça en est

La version 1.0.0 est publiée sur npm depuis le 5 juin 2026, en ESM uniquement, pour Node 24 et plus. Au 14 novembre 2026, npm compte 5 téléchargements sur la dernière semaine. Le paquet n'a pas bougé depuis sa sortie : il fait ce pour quoi je l'ai écrit. Ses idées continuent de vivre dans les kits de domaine de mes autres projets.

Stack

Avec quoi je le construis

  • TypeScript
  • ESM
  • Node 24

Continuer

Mes autres builds

Voir tous les buildsTravailler avec moi