@cqrs-ddd/pipeline-zod
Επικυρώνει και καθαρίζει τα inputs χρησιμοποιώντας schemas Zod πριν την εκτέλεση λειτουργιών. Άγνωστες ιδιότητες αφαιρούνται, εφαρμόζονται μετατροπές τύπων (coercions) και προεπιλογές, ενώ μη έγκυρα payloads απορρίπτονται με δομημένα validation errors.
Υποστηρίζει δύο μοτίβα:
- Ρητή διακόσμηση schema μέσω του
validated(schema)στο call site ή στον handler. - Ενσωματωμένα schemas σε κλάσεις μέσω των
createCommand(schema)καιcreateQuery(schema)που επικυρώνονται καθολικά από τοZodValidationBehavior.
Εγκατάσταση
Ενότητα με τίτλο «Εγκατάσταση»Απαιτεί Node.js 22.12 ή νεότερο και Zod 4.3 ή νεότερο.
Μοτίβα χρήσης
Ενότητα με τίτλο «Μοτίβα χρήσης»Μοτίβο 1: Διακόσμηση Call-Site (validated)
Ενότητα με τίτλο «Μοτίβο 1: Διακόσμηση Call-Site (validated)»Η διακοσμημένη συνάρτηση ή handler λαμβάνει ένα καθαρό, επικυρωμένο αντίγραφο. Το αρχικό όρισμα εισόδου δεν τροποποιείται ποτέ:
Συναρτήσεις πολλαπλών ορισμάτων
Ενότητα με τίτλο «Συναρτήσεις πολλαπλών ορισμάτων»Συναρτήσεις με πολλαπλά ορίσματα επικυρώνονται με z.tuple():
Μοτίβο 2: Κλάσεις αιτημάτων με ενσωματωμένα Schemas
Ενότητα με τίτλο «Μοτίβο 2: Κλάσεις αιτημάτων με ενσωματωμένα Schemas»Δημιουργήστε κλάσεις command και query που ενσωματώνουν το validation schema τους:
Όταν το ZodValidationBehavior εκτελείται καθολικά (globally), επικυρώνει αυτόματα κάθε κλάση αιτήματος με ενσωματωμένο schema:
Ενημερώσιμα πεδία & Field-Level Authorization
Ενότητα με τίτλο «Ενημερώσιμα πεδία & Field-Level Authorization»Για partial update (PATCH) commands, χρησιμοποιήστε το updatable για να δηλώσετε τα επιτρεπόμενα πεδία για έλεγχο εξουσιοδότησης με το @cqrs-ddd/pipeline-casl:
Αντιστοίχιση HTTP στο Edge (createZodMapper)
Ενότητα με τίτλο «Αντιστοίχιση HTTP στο Edge (createZodMapper)»Χρησιμοποιήστε το createZodMapper στο HTTP boundary (Express, Fastify, NestJS controllers) για να μετατρέψετε raw payloads σε strongly typed instances commands ή queries:
Το CreateUserMapper.map() ρίχνει σύγχρονα ZodValidationError σε αποτυχία validation.
Ενσωμάτωση NestJS (@cqrs-ddd/nestjs)
Ενότητα με τίτλο «Ενσωμάτωση NestJS (@cqrs-ddd/nestjs)»Σε εφαρμογές NestJS, χρησιμοποιήστε το @UsePipeline(validated(Schema)) απευθείας σε @CommandHandler ή @QueryHandler:
Το παγκόσμιο ErrorFilter μεταφράζει το ZodValidationError σε BadRequestException του NestJS.
Διαχείριση σφαλμάτων & HTTP αντιστοίχιση
Ενότητα με τίτλο «Διαχείριση σφαλμάτων & HTTP αντιστοίχιση»Όταν το validation αποτυγχάνει, ρίχνεται ZodValidationError:
Σειρά των behaviors
Ενότητα με τίτλο «Σειρά των behaviors»Τοποθετείτε πάντοτε το validation πριν από behaviors που εξετάζουν το περιεχόμενο του αιτήματος (όπως caching, rate limiting και idempotency):