Αρχείο αλλαγών
Μόνο το @nestjs-pipeline/correlation κυκλοφορεί στην έκδοση 0.4.4, μια έκδοση διορθώσεων. Τα άλλα 13 πακέτα @nestjs-pipeline/* μένουν στην 0.4.3 και τα πέντε πακέτα @cqrs-ddd/* αυτού του αποθετηρίου στην 0.4.2.
Διορθώσεις
Ενότητα με τίτλο «Διορθώσεις»@nestjs-pipeline/correlation: κάθε εγγραφή στο correlation store ελέγχει το ID, και καμία επιλογή δεν απενεργοποιεί τον έλεγχο. Ένα ID που δεν είναι μη κενό string από εκτυπώσιμους χαρακτήρες ASCII (0x20 έως 0x7E), ή που αρχίζει ή τελειώνει με κενό, θεωρείται ότι λείπει: ταrunWithCorrelationId,@WithCorrelationκαι κάθε preset τουCorrelationFromκρατούν το τρέχον ID ή παράγουν νέο, και τοcorrelationSource.runεκτελείται χωρίς ID. Πριν, αποθήκευαν οποιαδήποτε τιμή λάμβαναν, οπότε ένα ID από μήνυμα ουράς ή από header του gRPC ή του Kafka μπορούσε να μεταφέρει CR/LF στα logs και στα headers της απάντησης. ΤοHttpCorrelationMiddlewareεφαρμόζει τον ίδιο έλεγχο πριν από τοvalidateIncoming, το οποίο πριν μπορούσε να αποδεχτεί ένα τέτοιο ID. Ο προεπιλεγμένος κανόνας HTTP (το πολύ 128 χαρακτήρες που ταιριάζουν με τοDEFAULT_CORRELATION_ID_PATTERN) δεν αλλάζει.
Τα 14 πακέτα @nestjs-pipeline/* κυκλοφορούν στην έκδοση 0.4.3, μια έκδοση μόνο για README: ο κώδικας, το API και οι απαιτήσεις είναι αυτά της έκδοσης 0.4.2.
Αλλαγές
Ενότητα με τίτλο «Αλλαγές»- Κάθε README ξεκινά με μια σημείωση: από την έκδοση 0.5.0 το πακέτο συνεχίζει ως ο
@cqrs-dddδιάδοχός του (@nestjs-pipeline/coreως@cqrs-ddd/pipeline,@nestjs-pipeline/<name>ως@cqrs-ddd/pipeline-<name>), που αναπτύσσεται στο https://github.com/aristoteliss/ddd-cqrs και τεκμηριώνεται στο https://aristoteliss.github.io/ddd-cqrs/. Οι εκδόσεις 0.1 έως 0.4 παραμένουν στο npm, και η 0.4.x λαμβάνει μόνο διορθώσεις. - Τα πέντε πακέτα
@cqrs-ddd/*αυτού του repository παραμένουν στην έκδοση 0.4.2: από την έκδοση 0.5.0 δημοσιεύονται από το ddd-cqrs.
Κάθε πακέτο κυκλοφορεί στην έκδοση 0.4.2. Το API και οι απαιτήσεις είναι αυτά της έκδοσης 0.4.1.
Αλλαγές
Ενότητα με τίτλο «Αλλαγές»- Το
homepageκάθε πακέτου, ο σύνδεσμος Homepage στο npm, είναι ο οδηγός του στον ιστότοπο τεκμηρίωσης, https://aristoteliss.github.io/nestjs-pipeline/.
Κάθε πακέτο κυκλοφορεί στην έκδοση 0.4.1. Το API και οι απαιτήσεις είναι αυτά της έκδοσης 0.4.0, με πέντε επιπλέον εξαγόμενους τύπους.
Προσθήκες
Ενότητα με τίτλο «Προσθήκες»@cqrs-ddd/mikro-orm: εξάγει τοVersionedAggregate, τον τύπο entity που δέχεται τοoptimisticDelete, και τοTimestamp, τις τιμές που διαβάζει τοUnixTimestampType.@nestjs-pipeline/core: εξάγει τοErrorClass, τον τύπο κλειδιού τουLoggingBehaviorOptions.mapLogLevel.@nestjs-pipeline/resilience: εξάγει τοAnyPolicy, την πολιτική που επιστρέφει τοbuildResiliencePolicy.@nestjs-pipeline/zod: εξάγει τοAbstractConstructor, τον τύπο κλάσηςBaseτωνcreateCommand,createQueryκαιcreateZodRequest.
Αλλαγές
Ενότητα με τίτλο «Αλλαγές»- Το εγχειρίδιο είναι ο ιστότοπος τεκμηρίωσης, https://aristoteliss.github.io/nestjs-pipeline/· το README κάθε πακέτου είναι σύντομο και συνδέεται με τον οδηγό του και το API reference.
- Οι σύνδεσμοι JSDoc των πακέτων επιλύονται: το API reference του ιστότοπου τεκμηρίωσης και τα declarations που διαθέτει κάθε πακέτο δεν εμφανίζουν πλέον ανεπίλυτο σύνδεσμο
import('…').
Κάθε πακέτο κυκλοφορεί στην έκδοση 0.4.0, ως ES module. Το API και οι απαιτήσεις είναι αυτά της έκδοσης 0.3.0.
Breaking Changes
Ενότητα με τίτλο «Breaking Changes»- Κάθε πακέτο δημοσιεύεται ως ES module (
"type": "module") με χάρτηexports. Μια εφαρμογή ES module το κάνει import· μια εφαρμογή CommonJS το φορτώνει μεrequire()(Node.js 22.12 ή νεότερο, το ελάχιστο όριο των πακέτων). Μια εφαρμογή CommonJS που κάνει compile με TypeScriptmodule: node16μεταβαίνει σεnodenext,node20ήbundler. - Μόνο τα entry points στο
exportsεπιλύονται: το root κάθε πακέτου, τα/domain,/application,/persistenceκαι/httpτου@cqrs-ddd/core, και το/package.json. Τα μονοπάτια εντός τουdistδεν επιλύονται πλέον. - Τα πακέτα που έχουν peer dependency στο
@nestjs-pipeline/coreαπαιτούν^0.4.0αυτού, και το@cqrs-ddd/mikro-ormαπαιτεί@cqrs-ddd/core^0.4.0.
Αλλαγές
Ενότητα με τίτλο «Αλλαγές»- Το
@nestjs-pipeline/cacheφορτώνει τον προαιρετικό του adapter store@keyv/*μέσω τουcreateRequire, σύγχρονα, όπως και πριν. - Ο έλεγχος έκδοσης (release check) φορτώνει κάθε πακέτο από έναν καταναλωτή CommonJS και έναν ES module, εκτελεί type-check με TypeScript
Bundlerresolution, και φορτώνει κάθε entry point στο Bun μέσωimportκαιrequire().
Κάθε πακέτο κυκλοφορεί στην έκδοση 0.3.0, για το NestJS 12.
Απαιτήσεις για κάθε πακέτο
Ενότητα με τίτλο «Απαιτήσεις για κάθε πακέτο»- Node.js 22.12 ή νεότερο (
engines): μια εφαρμογή CommonJS φορτώνει τα ES modules που δημοσιεύει το NestJS 12 μέσω τουrequire()της Node για ES modules. Το@cqrs-ddd/mikro-ormαπαιτεί 22.17, όπως και το@mikro-orm/core7 peer dependency του. - NestJS
^12.1.0(@nestjs/common,@nestjs/core,@nestjs/cqrs) για κάθε πακέτο@nestjs-pipeline/*που έχει peer dependency στο NestJS. Τα NestJS 11 και 12.0.x δεν υποστηρίζονται: το 12.0.x παραλείπει τους δείκτες@Optional()μιας βασικής κλάσης σε μια υποκλάση που δεν δηλώνει δικό της constructor. - Τα πακέτα που έχουν peer dependency στο
@nestjs-pipeline/coreαπαιτούν^0.3.0αυτού. - Μια εφαρμογή CommonJS που κάνει compile με TypeScript
module: node16μεταβαίνει σεnodenext,node20ήbundler· τοnode16απορρίπτει imports από ES modules (TS1479).
Breaking Changes
Ενότητα με τίτλο «Breaking Changes»@nestjs-pipeline/zod: ΤοZodPipeαφαιρέθηκε. Δηλώστε το schema με{ schema }στα@Body,@Paramή@Query, και καταχωρίστε τοStandardSchemaValidationPipeτου Nest μία φορά μεexceptionFactory: zodBadRequest.@nestjs-pipeline/resilience: απαιτείcockatiel^4.0.0, των οποίων οι πολιτικές αναφέρουν σφάλματα ωςunknown.
Προσθήκες
Ενότητα με τίτλο «Προσθήκες»@nestjs-pipeline/zod:zodBadRequest, το exception factory για τοStandardSchemaValidationPipeτου Nest· απαντά με 400 με το body που δίνει τοZodValidationFilter.@cqrs-ddd/core:IAggregateRoot, το συμβόλαιο event-buffering, αντίστοιχο με αυτό του NestJS 12, το οποίο ικανοποιούν τόσο τα aggregates αυτού του πακέτου όσο και του NestJS. Ταpublish,publishAllκαιcommitτουAggregateRootδέχονται προαιρετικό dispatcher context και επιστρέφουν το αποτέλεσμα του publisher· τοcommitπαραδίδει ένα αντίγραφο των συμβάντων και εκκαθαρίζει το buffer μόλις επιστρέψει τοpublishAll.IDomainEventPublisher.publishAll(events, dispatcherContext?).@nestjs-pipeline/job-context: ΤοtenantsτουJobContextModule.forRootδέχεται επίσης συνάρτηση, η οποία καλείται μία φορά κατά την κατασκευή των providers της εφαρμογής, ώστε η λίστα να μπορεί να προέρχεται από configuration που διαβάζεται κατά την εκκίνηση.
Αλλαγές
Ενότητα με τίτλο «Αλλαγές»@cqrs-ddd/core: ΤοCommandBaseHandlerδέχεται οποιοδήποτε αποτέλεσμαIAggregateRootκαι περνά το aggregate στοpublishAllως dispatcher context, όπως κάνει οEventPublisherτου NestJS.@nestjs-pipeline/core: Οι handlers εντοπίζονται μέσω τουDiscoveryServiceτου Nest και του κλειδιού metadata που καταγράφει κάθε δημόσιος decorator handler του@nestjs/cqrs, επειδή το@nestjs/cqrs12 εξάγει μόνο το root του πακέτου του. Το bootstrap αποτυγχάνει όταν ένας decorator καταγράφει οτιδήποτε άλλο εκτός από ένα κλειδί.@nestjs-pipeline/idempotency: Το προεπιλεγμένο exception filter του NestJS 12 απαντά σε ένα απλόErrorπου φέρειstatusCodeμε 500, επομένως καταχωρίστε τοIdempotencyConflictFilterγια να διατηρήσετε τις απαντήσεις 409 και 422.@nestjs-pipeline/rate-limit: δοκιμασμένο με rate-limiter-flexible 11, το οποίο πετά σφάλμα όταν δημιουργείται limiter χωρίς πεπερασμέναpointsήduration.
Διορθώσεις
Ενότητα με τίτλο «Διορθώσεις»@cqrs-ddd/core: ΤοCommandBaseHandler.execute()περιμένει (awaits) αυτό που επιστρέφει τοpublishAll(), μετά την εκκαθάριση του buffer, ώστε ένας publisher που απορρίπτει (rejects) να απορρίπτει και το command. Η απόρριψη ήταν προηγουμένως unhandled, και η Node τερμάτιζε τη διεργασία.@nestjs-pipeline/audit,/cache,/deadletter,/feature-flags,/idempotency,/rate-limit,/resilience(behavior καιResiliencePolicies) καιLoggingBehaviorτου core: με τον προεπιλεγμένο logger του Nest, κάθε εγγραφή εκτυπώνει το context της μία φορά· το όνομα της κλάσης εκτυπωνόταν ξανά ως ξεχωριστή εγγραφή. Ο fallbackLoggerδεν έχει δικό του context και delta χρονοσήμανσης.@cqrs-ddd/mikro-orm: Τοengines.nodeείναι>=22.17.0, το ελάχιστο όριο του@mikro-orm/core7 peer dependency του.
Μια έκδοση των @nestjs-pipeline/zod, /casl, /feature-flags, /idempotency και /rate-limit· τα υπόλοιπα διατηρούν τις εκδόσεις τους. Σε αντίθεση με την 0.2.1, απαιτείται αλλαγή κώδικα στο σημείο όπου καταχωρίζονται τα exception filters.
Αλλαγές
Ενότητα με τίτλο «Αλλαγές»- Τα exception filters
ZodValidationFilter,UnauthorizedActionFilter,FeatureDisabledFilter,IdempotencyConflictFilterκαιRateLimitExceededFilterδέχονται τοHttpAdapterHostτου Nest ως πρώτο όρισμα του constructor τους και απαντούν μέσω τουhttpAdapter.reply(τοRateLimitExceededFilterθέτει τοRetry-AfterμεhttpAdapter.setHeader). Καταχωρίστε τα ως{ provide: APP_FILTER, useClass: X }, ή περάστε τοapp.get(HttpAdapterHost)στοuseGlobalFilters(new X(...)). Οι επιλογές τουFeatureDisabledFilterαποτελούν το δεύτερο όρισμά του. - Τα πέντε πακέτα δηλώνουν το
@nestjs/core^11.0.0ως peer dependency.
Διορθώσεις
Ενότητα με τίτλο «Διορθώσεις»- Στο Fastify, ένα σφάλμα πακέτου που προέκυπτε σε middleware του Nest έφτανε στο φίλτρο του με την raw απόκριση της Node· το φίλτρο πετούσε
TypeError: response.status is not a functionκαι το αίτημα δεν λάμβανε απάντηση. Τα φίλτρα πλέον απαντούν κανονικά.
Μια patch έκδοση των παρακάτω δέκα πακέτων· τα υπόλοιπα παραμένουν στο 0.2.0. Κάθε αλλαγή είναι προσθήκη ή διόρθωση τεκμηρίωσης: καμία εξαγωγή, υπογραφή, behavior ή εύρος peer dependencies του 0.2.0 δεν αλλάζει, επομένως η αναβάθμιση δεν απαιτεί αλλαγές κώδικα.
Προσθήκες
Ενότητα με τίτλο «Προσθήκες»@cqrs-ddd/core: ΤοrequireTenant(purpose, source?)επιστρέφει το tenant για μια λειτουργία ευαίσθητη σε θέματα ασφαλείας, από τοsourceή τον καταχωρισμένο resolver, και πετάMissingTenantContextErrorόταν δεν υπάρχει κανένα. ΤοrequireTenantId(source, purpose), το ίδιο με αντεστραμμένα ορίσματα, είναι deprecated και το καλεί εσωτερικά.@nestjs-pipeline/casl:abilityDigest(context?), το SHA-256 των ενεργών κανόνων (συνθήκες επιλυμένες έναντι του principal), για scopes κλειδιών cache και replay scopes idempotency·requireAbilityDigest(context?), το οποίο πετά το νέοMissingAbilityErrorαντί να επιστρέφειundefined·CaslAuthorizer.dependsOnEntity(action, subject), αν ένας κανόνας υπό συνθήκη αποφασίζει βάσει γνωρισμάτων entity. Προσθέτει το@cqrs-ddd/safe-stringifyως εξάρτηση.@nestjs-pipeline/opentelemetry:AttributesBehaviorμεAttributesBehaviorOptions(factories). Εκτελεί attribute factories μόλις ολοκληρωθεί η υπόλοιπη αλυσίδα, επιτυχώς ή όχι, και προσθέτει το αποτέλεσμα στο attribute bag που διαβάζουν ταTraceBehaviorκαιMetricsBehavior. Ένα αποτυχημένο factory δεν συνεισφέρει τίποτα· τα υπόλοιπα συνεχίζουν να εφαρμόζονται.- Attribute builders, καθένας στο
src/helpers/build-attributes.ts, που επιστρέφουν{}όταν το behavior τους δεν εκτελέστηκε και ποτέ κλειδί cache, idempotency ή rate-limit:@nestjs-pipeline/cache:buildCacheAttributes→cache.hit.@nestjs-pipeline/idempotency:buildIdempotencyAttributes→idempotency.replayed,idempotency.ownership_lost.@nestjs-pipeline/rate-limit:buildRateLimitAttributes→rate_limit.remaining_points.@nestjs-pipeline/feature-flags:buildFeatureFlagAttributes→feature_flag.key,feature_flag.enabled,feature_flag.variant,feature_flag.reason,feature_flag.error_code.@nestjs-pipeline/deadletter:buildDeadLetterAttributes→dead_letter.captured.
Τεκμηρίωση
Ενότητα με τίτλο «Τεκμηρίωση»@nestjs-pipeline/zod: τα παραδείγματα χρησιμοποιούνz.email()καιz.uuid()αντί των deprecatedz.string().email()καιz.string().uuid().@nestjs-pipeline/audit: το παράδειγμα actor διαβάζει τοgetSessionPrincipal().@nestjs-pipeline/feature-flags: το παράδειγμα module χρησιμοποιείTypedInMemoryProvider(@openfeature/server-sdk1.23+·InMemoryProviderπριν από αυτό).
Κάθε πακέτο κυκλοφορεί στην έκδοση 0.2.0. Πέντε υπήρχαν στο npm προηγουμένως· δεκατρία κυκλοφορούν για πρώτη φορά.
Απαιτήσεις για κάθε πακέτο
Ενότητα με τίτλο «Απαιτήσεις για κάθε πακέτο»- Node.js 22 ή νεότερο (
engines). - NestJS 11 για κάθε πακέτο
@nestjs-pipeline/*που έχει peer dependency στο NestJS (το@nestjs-pipeline/tenantδεν έχει peer dependencies). Το NestJS 10 δεν υποστηρίζεται πλέον. - Τα πακέτα που έχουν peer dependency στο
@nestjs-pipeline/coreαπαιτούν^0.2.0αυτού αντί για οποιαδήποτε έκδοση.
Αναβάθμιση από 0.1.x
Ενότητα με τίτλο «Αναβάθμιση από 0.1.x»Η ενότητα Αναβάθμιση από 0.1.x παρουσιάζει τις συνήθεις αλλαγές με κώδικα πριν και μετά.
@nestjs-pipeline/core (από 0.1.18)
Ενότητα με τίτλο «@nestjs-pipeline/core (από 0.1.18)»Breaking Changes:
- Peer dependencies είναι τα
@nestjs/common,@nestjs/coreκαι@nestjs/cqrs^11.0.0. - Αφαιρέθηκαν από το δημόσιο API:
PipelineBootstrapService,PIPELINE_MODULE_OPTIONS,PIPELINE_OPTIONS_REGISTRY,clearPipelineOptionsRegistry,SET_RESPONSEκαιSET_ORIGINAL_CORRELATION_ID. Ρυθμίστε το pipeline μέσω τωνPipelineModule.forRootήforRootAsync· ένα behavior δεν μπορεί πλέον να ορίσει το response ή το αρχικό correlation ID ενός context. - Το
context.correlationIdείναι μόνο για ανάγνωση (read-only), και τοoriginalCorrelationIdαφαιρέθηκε: ένα behavior δεν μπορεί πλέον να αντικαταστήσει το correlation ID ενός εκτελούμενου pipeline. Ορίστε το στο σημείο εισόδου της εργασίας (HttpCorrelationMiddleware,@WithCorrelation,runWithCorrelationId). - Οι επιλογές module
correlationIdFactoryκαιcorrelationIdRunnerαφαιρέθηκαν. Ένα pipeline λαμβάνει το tenant και το correlation id του από την επιλογή modulesourcesκατά την εκκίνησή του (tenantSourceτου@nestjs-pipeline/tenant,correlationSourceτου@nestjs-pipeline/correlation), ή από το pipeline στο οποίο είναι εμφωλευμένο, παράγει έναuuidv7()correlation id όταν δεν υπάρχει κανένα, και εκτελεί τα behaviors του εντός των δύο αυτών τιμών. Ορίστε τα στο σημείο εισόδου της εργασίας στην εφαρμογή:runWithTenantτου@nestjs-pipeline/tenant,HttpCorrelationMiddlewareήrunWithCorrelationIdτου@nestjs-pipeline/correlation. - Η νέα επιλογή
diagnosticsέχει προεπιλογή'strict': ένας handler του οποίου το pipeline δεν ικανοποιεί τοPIPELINE_BEHAVIOR_CONTRACTενός behavior οδηγεί το bootstrap σεPipelineConfigurationError. Περάστε'warn'ή'off'για να το χαλαρώσετε. - Το
loggerProviderέχει τύποPipelineLoggerProviderαντί για οποιοδήποτεProvider: τοprovideτου πρέπει να είναιLOGGING_BEHAVIOR_LOGGER. - Τα
@cqrs-ddd/uuidv7,@cqrs-ddd/untypedκαι@cqrs-ddd/safe-stringifyείναι νέες εξαρτήσεις runtime. - Το
getBehaviorId(cls)επιστρέφει την ίδια την κλάση όταν δεν έχει οριστείPIPELINE_BEHAVIOR_ID, αντί γιαcls.name, ώστε δύο behaviors με το ίδιο όνομα κλάσης να μην συγκρούονται. - Το
PIPELINE_BEHAVIOR_IDείναιSymbol.for('@nestjs-pipeline/core:PIPELINE_BEHAVIOR_ID')αντί για τοπικόSymbol, ώστε να ταιριάζει σε διπλότυπα αντίγραφα του core. - Όταν πολλές εφαρμογές NestJS στην ίδια διεργασία τυλίγουν την ίδια κλάση handler, η κλήση της σε ένα instance που δεν δημιουργήθηκε από καμία εξ αυτών πετά εξαίρεση, αντί να εκτελείται χωρίς κανένα pipeline.
- Το
LoggingBehaviorαποκρύπτει (masks) ευαίσθητα πεδία στα καταγεγραμμένα payloads από προεπιλογή (redactSensitiveKeys: true, χρησιμοποιώντας τοDEFAULT_REDACT_KEYS). Η αντιστοίχιση κλειδιών αγνοεί πεζά/κεφαλαία,_και-, επομένως τοrefreshTokenαποκρύπτει επίσης τοrefresh_token. ΤοexcludeKeysεφαρμόζεται επίσης στις ιδιότητες των κλωνοποιημένων αντικειμένωνErrorκαι στα κλειδιάMap.
Προσθήκες:
PipelineModule.forRootAsync(PipelineModuleAsyncOptions,PipelineOptionsFactory,PipelineLoggerProvider),PipelineModuleFeatureOptions, η επιλογήdiagnostics, ο helper πρόθεσηςlogging()και το@SkipPipeline.- Στοιχεία pipeline (pipeline items):
createPipelineItem,getPipelineItem,setPipelineItem,hasPipelineItem,requirePipelineItem,MissingPipelineItemError. - Συμβόλαια behaviors και διαγνωστικά bootstrap:
PIPELINE_BEHAVIOR_CONTRACT,PipelineConfigurationErrorκαι οι τύποι τους. context.tenantId, το tenant της εκτέλεσης· είναι write-once, επομένως η ανάθεση διαφορετικού tenant πετά σφάλμα. ΤοSET_TENANT_IDτο ορίζει σε έναν προσαρμοσμένο runner.- Επιλογές του
LoggingBehavior:redactKeysκαιredactSensitiveKeys. toPostgresJson.tenantSegmentsκαιTenantPartitionOptions, το τμήμα tenant για τα factories κλειδιών cache, idempotency και rate-limit, καθώς και τοMissingPartitionError, η βάση των σφαλμάτων partition τους. Το factory κλειδιών cache δέχεται πλέον και τοincludeTenant.- Η επιλογή module
sourcesμε ταContextSourceκαιContextSources: από όπου τα pipelines λαμβάνουν το tenant και correlation id τους. Το bootstrap προειδοποιεί όταν παραλείπεται· περάστεsources: {}για σκόπιμη εκτέλεση χωρίς sources.
Αφαιρέθηκαν από το δημόσιο API: uuidv7, isUuidV7 και untyped. Εισαγάγετέ τα από τα @cqrs-ddd/uuidv7 και @cqrs-ddd/untyped. Οι serializers, τους οποίους η 0.1.18 δεν εξήγαγε, είναι δημόσιοι στο @cqrs-ddd/safe-stringify.
@nestjs-pipeline/correlation (από 0.1.8)
Ενότητα με τίτλο «@nestjs-pipeline/correlation (από 0.1.8)»Breaking Changes:
- Peer dependency:
@nestjs/common^11.0.0(ήταν^10.0.0 || ^11.0.0). Εξακολουθεί να μην εξαρτάται από κανένα πακέτο pipeline· τα@cqrs-ddd/uuidv7και@cqrs-ddd/untypedείναι νέες εξαρτήσεις. - Τα
setCorrelationFallbackκαιuuidv7δεν εξάγονται πλέον. Εισαγάγετε τοuuidv7από το@cqrs-ddd/uuidv7, το οποίο έχει το ίδιο API και αποτέλεσμα. - Το
correlationStoreαντικαθίσταται από τοcorrelationSource. Περάστε το στοPipelineModule.forRoot({ sources: { correlationId: correlationSource } })ώστε το pipeline να λαμβάνει το id και τοgetCorrelationId()σε έναν handler να επιστρέφει το id του pipeline. ΤαrunWithCorrelationId,getCorrelationId,correlationHeadersκαι@WithCorrelationδιατηρούν το API τους. - Το
HttpCorrelationMiddlewareορίζει το correlation header στην απόκριση, μετατρέπει σε πεζά το ρυθμισμένο όνομα header και πετά σφάλμα κατά την κατασκευή αν δεν είναι έγκυρο. Νέες επιλογές:acceptIncoming,trimIncoming,maxLengthκαιvalidateIncoming. - Το
addCorrelationIdπετάTypeErrorγια οποιαδήποτε τιμή δεν είναι απλό αντικείμενο (περιλαμβάνονται instances κλάσεων), όχι μόνο για πίνακες. - Ένα εισερχόμενο correlation ID μεγαλύτερο από 128 χαρακτήρες, ή που δεν ταιριάζει με το
DEFAULT_CORRELATION_ID_PATTERN, απορρίπτεται και αντικαθίσταται από τοπικά παραγόμενο ID.
Προσθήκες: correlationSource, DEFAULT_CORRELATION_HEADER, DEFAULT_CORRELATION_ID_MAX_LENGTH, DEFAULT_CORRELATION_ID_PATTERN.
@nestjs-pipeline/opentelemetry (από 0.1.8)
Ενότητα με τίτλο «@nestjs-pipeline/opentelemetry (από 0.1.8)»Breaking Changes: @nestjs/common ^11.0.0· @nestjs-pipeline/core ^0.2.0.
- Το
TraceBehaviorδεν υλοποιεί πλέον τοonModuleInit, δεν κάνει inject logger και δεν ελέγχει πλέον αν έχει καταχωριστεί SDK. - Το
TraceBehaviorOptionsεξάγεται μόνο ως τύπος. - Ένα tracer, meter ή callback εμπλουτισμού που πετά σφάλμα δεν αντικαθιστά ποτέ το αποτέλεσμα ή το σφάλμα του handler, και δεν εκτελεί ποτέ τον handler δύο φορές.
Προσθήκες: τα spans φέρουν pipeline.tenant_id, pipeline.outcome και error.type· το MetricsBehavior καταγράφει έναν μετρητή pipeline.handler.active και προσθέτει ετικέτες στα όργανα μέτρησης με outcome και pipeline.outcome. Επίσης προστέθηκαν: MetricsBehavior και metrics(), trace(), buildTraceAttributes, buildMetricAttributes, addPipelineTelemetryAttributes, getPipelineTelemetryAttributes, PIPELINE_OTEL_ATTRIBUTES, PIPELINE_TELEMETRY_ATTRIBUTES και οι τύποι τους.
@nestjs-pipeline/zod (από 0.1.6)
Ενότητα με τίτλο «@nestjs-pipeline/zod (από 0.1.6)»Breaking Changes:
- Peer dependencies:
zod^4.3.0(ήταν^4.0.0),@nestjs/common^11.0.0,@nestjs-pipeline/core^0.2.0. - Το
ZOD_SCHEMA, το deprecated ψευδώνυμο, αφαιρέθηκε· χρησιμοποιήστε τοZOD_SCHEMA_KEY. - Το
ZodValidationBehaviorεφαρμόζει το parsed output στο request αντί μόνο να επικυρώνει: κάνει parse μεsafeParseAsync, διαγράφει κλειδιά που αφαιρεί το schema και αναθέτει εξαναγκασμένες (coerced) και προεπιλεγμένες τιμές πριν από την εκτέλεση του handler. Ένα κορυφαίο output που δεν είναι απλό αντικείμενο απορρίπτεται μεTypeError, όπως και ένα μη αντικειμενικό request με schema. - Το
ZodPipe.transform()επιστρέφειPromiseκαι κάνει parse ασύγχρονα.
Προσθήκες:
createCommand,createQueryκαιcreateZodRequest, με ταInferInput,InferOutputκαι τους τύπους κλάσεων.updatableκαιupdatableFieldsOf: επισημάνετε ένα πεδίο command στο schema του, και τοcreateCommand()παραθέτει τα επισημασμένα πεδία ωςupdatableFields.createZodMapper·getRawInput,getValidatedData,ZOD_RAW_INPUT_KEY,ZOD_VALIDATED_DATA_KEY.
@nestjs-pipeline/casl (από 0.1.1)
Ενότητα με τίτλο «@nestjs-pipeline/casl (από 0.1.1)»Breaking Changes:
- Peer dependencies:
@casl/ability^7.0.0(ήταν^6.0.0),@nestjs/common^11.0.0,@nestjs-pipeline/core^0.2.0. - Το API των providers αντικαθίσταται από μία ενιαία πηγή δικαιωμάτων (permission source). Αφαιρέθηκαν:
CASL_ROLE_PROVIDER,CASL_USER_CAPABILITY_PROVIDER,CASL_USER_CONTEXT_RESOLVER,CASL_USER_CONTEXT_KEY,CASL_SUBJECT_CONTEXT_PATHS,CASL_FIELDS_FROM_REQUEST,CASL_BEHAVIOR_LOGGER,IRoleProvider,IUserCapabilityProvider,IUserContextResolver,StaticRoleProvider,CaslUserContext,RoleDefinition,UserCapabilities,buildAbilityFromRules,capabilityToRawRuleκαιcapabilitiesToRawRules. Υλοποιήστε τοICaslPermissionSource, του οποίου τοload()επιστρέφει{ principal, rules }ήnull, και καταχωρίστε το μεCaslModule.forRoot({ permissionSource }). - Το
buildAbility(roles, user, additional, denied)γίνεταιbuildAbility(rules, principal). - Το
CaslBehaviorOptionsχάνει ταsubjectFromRequest,subjectContextPaths,fieldsFromRequest,skipCheckκαιprebuiltAbility· τοrulesείναι υποχρεωτικό και μη κενό (τοrequires()το κατασκευάζει). ΤοCaslBehaviorδεν δέχεται πλέον logger. - Μια άρνηση πρόσβασης πετά
UnauthorizedActionException(επεκτείνει τοError) αντί για τοForbiddenExceptionτου NestJS· καταχωρίστε τοUnauthorizedActionFilterγια απάντηση HTTP 403. - Μια συνθήκη κανόνα της οποίας το placeholder επιλύεται σε αντικείμενο πετά σφάλμα, επειδή το CASL θα διάβαζε το αντικείμενο ως τελεστές ερωτήματος (query operators).
Προσθήκες: requires(), CaslAuthorizer (can, authorize, project), UnauthorizedActionException και UnauthorizedActionFilter (HTTP 403), getCaslAbility, getCaslPrincipal, hasEntityConditions, CASL_PERMISSION_SOURCE, CASL_PRINCIPAL_KEY, CASL_BEHAVIOR_ID, CASL_ACTIONS, CASL_SUBJECTS και οι τύποι τους.
Πρώτες εκδόσεις
Ενότητα με τίτλο «Πρώτες εκδόσεις»@nestjs-pipeline/audit: καταγράφει κάθε ελεγμένο αίτημα, σε επιτυχία και αποτυχία, σε έναAuditSink(console από προεπιλογή, Postgres ενσωματωμένο), με redaction των payloads. Μόνο τα commands ελέγχονται εκτός αν τοcaptureKindsπεριλαμβάνει queries ή events. Ένα sink που υλοποιεί τοbegin(όπως το Postgres sink) λαμβάνει μια εκκρεμή εγγραφή πριν από την εκτέλεση του handler, και στη συνέχεια την τελική εγγραφή υπό το ίδιο id, ώστε η διακοπή μιας διεργασίας να αφήνει μια γραμμήpendingαντί για καμία. Με την προεπιλογήfailOpen: true, μια αποτυχία του sink καταγράφεται στα logs και το αποτέλεσμα του αιτήματος διατηρείται. ΜεfailOpen: false, μια αποτυχία του sink αποτυγχάνει ένα επιτυχές αίτημα· αν ο handler είχε ήδη αποτύχει, το δικό του σφάλμα επανεκπέμπεται αμετάβλητο και η αποτυχία του sink καταγράφεται στα logs.@nestjs-pipeline/cache: read-through caching για queries βασισμένο στα cache-manager 7 και Keyv. Τοkeyείναι υποχρεωτικό: δεν υπάρχει προεπιλεγμένο κλειδί.@nestjs-pipeline/deadletter: συλλαμβάνει αποτυχημένα αιτήματα μέσω ενόςDeadLetterTransport(ενσωματωμένα transports για BullMQ, RabbitMQ και Postgres)· events από προεπιλογή, commands και queries όταν αναφέρονται στοcaptureKinds. Το Postgres transport είναι έναDeadLetterStore, και τοDeadLetterRedriverεπανεκτελεί μια αποθηκευμένη εγγραφή, μετρά τις αποτυχημένες προσπάθειες και την επιλύει· ένα redacted payload δεν επανεκτελείται χωρίςrebuild. Τοrethrow: falseαποσιωπά το σφάλμα ενός event handler μόνο, και συνιστά bootstrap σφάλμα σε έναν command ή query handler. Το RabbitMQ transport έχει δοκιμαστεί μόνο με mocked channel.@nestjs-pipeline/feature-flags: ελέγχει την πρόσβαση σε handlers μέσω του OpenFeature. ΤοFeatureDisabledFilterαπαντά με HTTP 403, ή 404 με{ status: 404 }για απόκρυψη του feature. ΤοallowedVariantsπεριορίζει βάσει variant, και τοerrorPolicy('use-default'ή'throw') αποφασίζει τη συμπεριφορά σε σφάλμα παρόχου.@nestjs-pipeline/idempotency: αποτροπή ταυτόχρονων διπλότυπων εκτελέσεων και επανάληψη επιτυχών απαντήσεων, με stores για μνήμη (προεπιλογή), Redis και Postgres. Μια αποτυχημένη εκτέλεση απελευθερώνει το κλειδί της από προεπιλογή. Το Postgres store διατηρεί τις αποκρίσεις ως κείμενο JSON, ώστε κάθε απόκριση, συμπεριλαμβανομένης οποιασδήποτε με χαρακτήρες NUL ή μη συζευγμένα surrogates, να αναπαράγεται επακριβώς. Τα κλειδιά δέχονται ταincludeTenantκαιrequireTenantτου core, και τοMissingIdempotencyPartitionErrorεπεκτείνει τοMissingPartitionErrorτου core.@nestjs-pipeline/rate-limit: rate limiting ανά command βασισμένο στο rate-limiter-flexible, εφαρμοζόμενο ανεξάρτητα από το πού αποστέλλεται το command, με φίλτρο HTTP 429. ΤοkeyFactoryείναι υποχρεωτικό: δεν υπάρχει προεπιλεγμένο bucket. Τοpointsείναι σταθερό ή υπολογιζόμενο κόστος ανά command· το0δεν χρεώνει τίποτα.@nestjs-pipeline/resilience: resilience βασισμένο στο cockatiel, σε δύο μέρη. Ονοματισμένες πολιτικές για εξωτερικές εξαρτήσεις (retry, circuit breaker, timeout, bulkhead, fallback), δηλωμένες στοResilienceModule.forRoot({ policies })ήforRootAsync, κατασκευασμένες και επικυρωμένες κατά την εκκίνηση, και κοινόχρηστες μέσω τωνResiliencePoliciesή@InjectResiliencePolicy(name). ΤοResilienceBehaviorεφαρμόζει retry, timeout και bulkhead γύρω από έναν ολόκληρο handler· η χρήση circuit breaker ή fallback εκεί συνιστά σφάλμα bootstrap. Τα retry, circuit breaker και fallback απαιτούν ένα κατηγόρημα (predicate)handleήhandleAllErrors: true.@nestjs-pipeline/tenant: τοrunWithTenant()ορίζει το τρέχον tenant και τοcurrentTenantId()το διαβάζει· τοtenantSourceπαραδίδει το ίδιο store σταPipelineModule.forRoot({ sources })καιJobContextModule.forRoot. Δεν έχει εξαρτήσεις.@nestjs-pipeline/job-context: μεταφέρει το tenant, το correlation id και την ταυτότητα principal ενός αιτήματος στα queue jobs που προγραμματίζει (withJobContext,@InJobContext), επανελεγχόμενα μέσω ενόςIJobPrincipalτης εφαρμογής κατά την εκτέλεση του job, και παρέχει στις εργασίες συστήματος ρητό principal και δικαιώματα ανά tenant (@AsSystem). Διαβάζει και αποκαθιστά το tenant και correlation id μέσω τωνsourcesτουJobContextModule.forRootκαι δεν εξαρτάται από κανένα άλλο πακέτο pipeline.@cqrs-ddd/core: δομικά στοιχεία DDD ανεξάρτητα από framework (aggregates, domain events,CommandBaseHandler, συμβόλαια repository, decorators κύκλου ζωής persistence που αντιστοιχίζουν μοναδικές παραβιάσεις ανά ιδιότητα entity μέσω ενός pluggable persistence dialect (IPersistenceDialect,setPersistenceDialect), ένα revision-fenced repository cache (CACHE_TOKEN, μεMemoryCacheγια μία διεργασία), κλειδιά cache με tenant scope, αντιστοίχιση καταστάσεων HTTP, και τους κανόνες τιμώνtextRuleκαιnumberRule, οι οποίοι πετούνInvalidValueExceptionή μια προσαρμοσμένη υποκλάση της εφαρμογής). Δεν εξαρτάται από κανένα framework: τοCommandBaseHandlerδέχεται οποιοδήποτεIDomainEventPublisher, οι decorators cache δέχονται ένανlogger, και τα κλειδιά cache λαμβάνουν το tenant τους από έναν resolver που καταχωρίζει η εφαρμογή με τοsetTenantResolver. Δεν έχει peer dependencies και καμία εξάρτηση από ORM.@cqrs-ddd/mikro-orm: οι MikroORM 7 adapters του@cqrs-ddd/core—AggregateRepository,optimisticUpdate,optimisticDelete,assertAutocommit,MikroOrmDialect(διαβάζει τον παραβιασμένο μοναδικό περιορισμό από τα metadata του ORM, για PostgreSQL και SQLite),mapPersistenceError/isTransientPersistenceError,MikroOrmCache(μεCacheEntrySchemaκαιcreateCacheTableSqlγια τον πίνακά του),TenantStore(οEntityManagerτου ενεργού tenant, με βάση δεδομένων ή schema ανά tenant) καιUnixTimestampType, το οποίο πετάTypeErrorγια μια τιμή χωρίς έγκυρο χρόνο. Τα@cqrs-ddd/coreκαι@mikro-orm/coreείναι απαιτούμενα peer dependencies.@cqrs-ddd/uuidv7: παραγωγή και επικύρωση UUIDv7 κατά RFC 9562, χωρίς εξαρτήσεις.@cqrs-ddd/untyped:untyped(value), μια ασφαλής ως προς τους τύπους αντικατάσταση τουas anyπου διαβάζει μη δηλωμένες ιδιότητες ωςunknown· χωρίς εξαρτήσεις.@cqrs-ddd/safe-stringify: ένας αυστηρός, key-sorted serializer για ταυτότητες και ένας ασφαλής, redacting serializer για logs, με βοηθητικά εργαλεία τμημάτων κλειδιών (key segments)· χωρίς εξαρτήσεις. Το output του είναι παγωμένο (frozen), ώστε τα αποθηκευμένα κλειδιά cache να παραμένουν έγκυρα.