@dudousxd/nestjs-diagnostics 0.7.0 → 0.7.2

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @dudousxd/nestjs-diagnostics
 
+## 0.7.2
+
+### Patch Changes
+
+- [`db48c6e`](https://github.com/DavideCarvalho/nestjs-diagnostics/commit/db48c6e5484bbccbb8ed34a633816ad1ed252c47) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Document the capability token trio in English, and correct two claims
+
+  Comment-only change to `capability.ts`, `inject-capability.ts` and
+  `conformance.ts`, the only three source files whose doc comments were written in
+  Portuguese. Two statements were also wrong and are fixed: `capability()` is not
+  the single source of the `@dudousxd/nestjs-<lib>:<name>` naming (`CONTEXT_ACCESSOR`
+  spells the same token by hand, as `capability.spec.ts` pins), and
+  `assertCapabilityNaming` checks the token's name, not that `capability()` minted
+  it. `InjectCapability`'s dangling pointer to an out-of-repo plan is replaced with
+  the in-repo `CapabilityOf` type and the reason it is exported from the `/nestjs`
+  subpath only. No runtime behavior changes.
+
+## 0.7.1
+
+### Patch Changes
+
+- [`96d300d`](https://github.com/DavideCarvalho/nestjs-diagnostics/commit/96d300d3af86b77fbdf16b307d986aec922945c4) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - add NestJS 12 to the supported peer range
+
 ## 0.7.0
 
 ### Minor Changes

package/dist/capability.d.ts

@@ -1,15 +1,20 @@
 /**
- * O token de DI estável para a capability `<lib>:<name>`. Fonte única do naming
- * `@dudousxd/nestjs-<lib>:<name>`. Como usa o registry global de símbolos
- * (`Symbol.for`), produtor e consumidor em libs diferentes — sem se importarem —
- * resolvem o MESMO símbolo. Espelha o `channelName(lib, event)` do transporte de
- * eventos, do outro lado do mesmo protocolo.
+ * The stable DI token for the capability `<lib>:<name>`, built from the canonical
+ * `@dudousxd/nestjs-<lib>:<name>` name. Because it goes through the global symbol
+ * registry (`Symbol.for`), a producer and a consumer living in different libs —
+ * neither importing the other — resolve the SAME symbol. Mirrors the event
+ * transport's `channelName(lib, event)`, on the other side of the same protocol.
+ *
+ * The naming is a convention, not an exclusive factory: a token spelled by hand
+ * with the same string IS the same symbol, which is what lets a lib adopt this
+ * without a breaking change. `CONTEXT_ACCESSOR` in `context-accessor.ts` is
+ * exactly that case — `capability('context', 'accessor')` resolves to it.
  */
 export declare function capability(lib: string, name: string): symbol;
 /**
- * Registry tipado de capabilities, augmentado pelas libs via declaration merging
- * — espelho exato do `ChannelRegistry` do transporte de eventos. Vazio por
- * padrão; o caminho não-tipado (`unknown`) está sempre disponível.
+ * Typed capability registry, augmented by libs through declaration merging — the
+ * exact mirror of the event transport's `ChannelRegistry`. Empty by default; the
+ * untyped (`unknown`) path is always available.
  *
  * ```ts
  * declare module '@dudousxd/nestjs-diagnostics' {
@@ -22,9 +27,9 @@ export declare function capability(lib: string, name: string): symbol;
 export interface CapabilityRegistry {
 }
 /**
- * O tipo declarado para `(TLib, TName)` no {@link CapabilityRegistry}, ou
- * `unknown` quando o par não está registrado. Espelha `PayloadOf` do
- * transporte de eventos.
+ * The type declared for `(TLib, TName)` in the {@link CapabilityRegistry}, or
+ * `unknown` when the pair is not registered. Mirrors `PayloadOf` from the event
+ * transport.
  */
 export type CapabilityOf<TLib extends string, TName extends string> = TLib extends keyof CapabilityRegistry ? TName extends keyof CapabilityRegistry[TLib] ? CapabilityRegistry[TLib][TName] : unknown : unknown;
 //# sourceMappingURL=capability.d.ts.map

package/dist/capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;CAAG;AAEtC;;;;GAIG;AACH,MAAM,MAAM,YAAY,CACtB,IAAI,SAAS,MAAM,EACnB,KAAK,SAAS,MAAM,IAClB,IAAI,SAAS,MAAM,kBAAkB,GACrC,KAAK,SAAS,MAAM,kBAAkB,CAAC,IAAI,CAAC,GAC1C,kBAAkB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAC/B,OAAO,GACT,OAAO,CAAC"}
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;CAAG;AAEtC;;;;GAIG;AACH,MAAM,MAAM,YAAY,CACtB,IAAI,SAAS,MAAM,EACnB,KAAK,SAAS,MAAM,IAClB,IAAI,SAAS,MAAM,kBAAkB,GACrC,KAAK,SAAS,MAAM,kBAAkB,CAAC,IAAI,CAAC,GAC1C,kBAAkB,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAC/B,OAAO,GACT,OAAO,CAAC"}

package/dist/capability.js

@@ -1,9 +1,14 @@
 /**
- * O token de DI estável para a capability `<lib>:<name>`. Fonte única do naming
- * `@dudousxd/nestjs-<lib>:<name>`. Como usa o registry global de símbolos
- * (`Symbol.for`), produtor e consumidor em libs diferentes — sem se importarem —
- * resolvem o MESMO símbolo. Espelha o `channelName(lib, event)` do transporte de
- * eventos, do outro lado do mesmo protocolo.
+ * The stable DI token for the capability `<lib>:<name>`, built from the canonical
+ * `@dudousxd/nestjs-<lib>:<name>` name. Because it goes through the global symbol
+ * registry (`Symbol.for`), a producer and a consumer living in different libs —
+ * neither importing the other — resolve the SAME symbol. Mirrors the event
+ * transport's `channelName(lib, event)`, on the other side of the same protocol.
+ *
+ * The naming is a convention, not an exclusive factory: a token spelled by hand
+ * with the same string IS the same symbol, which is what lets a lib adopt this
+ * without a breaking change. `CONTEXT_ACCESSOR` in `context-accessor.ts` is
+ * exactly that case — `capability('context', 'accessor')` resolves to it.
  */
 export function capability(lib, name) {
     return Symbol.for(`@dudousxd/nestjs-${lib}:${name}`);

package/dist/capability.js.map

@@ -1 +1 @@
-{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,IAAY;IAClD,OAAO,MAAM,CAAC,GAAG,CAAC,oBAAoB,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC"}
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../src/capability.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,IAAY;IAClD,OAAO,MAAM,CAAC,GAAG,CAAC,oBAAoB,GAAG,IAAI,IAAI,EAAE,CAAC,CAAC;AACvD,CAAC"}

package/dist/conformance.d.ts

@@ -1,9 +1,13 @@
 /**
- * Trava anti-drift para contract tests: assere que TODO token exportado por uma
- * lib segue o naming canônico `@dudousxd/nestjs-<lib>:<name>` (i.e. foi criado
- * por `capability(lib, ...)`). `Symbol.for(k).description === k`, então basta
- * checar o prefixo da `description` — não é preciso comparar identidade.
- * Lança um erro que NOMEIA o export ofensor, virando o drift em teste vermelho.
+ * Anti-drift latch for contract tests: asserts that EVERY token a lib exports
+ * follows the canonical `@dudousxd/nestjs-<lib>:<name>` naming. Because
+ * `Symbol.for(k).description === k`, checking the `description` prefix is enough —
+ * no identity comparison needed. Throws an error that NAMES the offending export,
+ * turning drift into a red test.
+ *
+ * It checks the NAME, not the provenance: a symbol spelled by hand with the right
+ * prefix passes exactly like one built by `capability(lib, ...)`. That is the
+ * point — the canonical name is the contract, not the factory call.
  */
 export declare function assertCapabilityNaming(lib: string, tokens: Record<string, symbol>): void;
 //# sourceMappingURL=conformance.d.ts.map

package/dist/conformance.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAWxF"}
+{"version":3,"file":"conformance.d.ts","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAWxF"}

package/dist/conformance.js

@@ -1,9 +1,13 @@
 /**
- * Trava anti-drift para contract tests: assere que TODO token exportado por uma
- * lib segue o naming canônico `@dudousxd/nestjs-<lib>:<name>` (i.e. foi criado
- * por `capability(lib, ...)`). `Symbol.for(k).description === k`, então basta
- * checar o prefixo da `description` — não é preciso comparar identidade.
- * Lança um erro que NOMEIA o export ofensor, virando o drift em teste vermelho.
+ * Anti-drift latch for contract tests: asserts that EVERY token a lib exports
+ * follows the canonical `@dudousxd/nestjs-<lib>:<name>` naming. Because
+ * `Symbol.for(k).description === k`, checking the `description` prefix is enough —
+ * no identity comparison needed. Throws an error that NAMES the offending export,
+ * turning drift into a red test.
+ *
+ * It checks the NAME, not the provenance: a symbol spelled by hand with the right
+ * prefix passes exactly like one built by `capability(lib, ...)`. That is the
+ * point — the canonical name is the contract, not the factory call.
  */
 export function assertCapabilityNaming(lib, tokens) {
     const prefix = `@dudousxd/nestjs-${lib}:`;

package/dist/conformance.js.map

@@ -1 +1 @@
-{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW,EAAE,MAA8B;IAChF,MAAM,MAAM,GAAG,oBAAoB,GAAG,GAAG,CAAC;IAC1C,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC;QAC/B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,qBAAqB,UAAU,qBAAqB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI;gBAC1E,2BAA2B,MAAM,sBAAsB,GAAG,aAAa,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"conformance.js","sourceRoot":"","sources":["../src/conformance.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW,EAAE,MAA8B;IAChF,MAAM,MAAM,GAAG,oBAAoB,GAAG,GAAG,CAAC;IAC1C,KAAK,MAAM,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC;QAC/B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CACb,qBAAqB,UAAU,qBAAqB,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI;gBAC1E,2BAA2B,MAAM,sBAAsB,GAAG,aAAa,CAC1E,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/inject-capability.d.ts

@@ -1,9 +1,14 @@
 /**
- * Injeta a capability de um peer `<lib>:<name>` OPCIONALMENTE — equivale a
- * `@Optional() @Inject(capability(lib, name))`, sem a string mágica copiada à
- * mão. Quando o produtor (a outra lib) está ausente, o parâmetro recebe
- * `undefined` em vez de quebrar a injeção. O tipo do parâmetro é anotado pelo
- * consumidor (ver nota no plano sobre declaration merging cross-repo).
+ * Injects a peer lib's `<lib>:<name>` capability OPTIONALLY — equivalent to
+ * `@Optional() @Inject(capability(lib, name))`, without the magic string copied by
+ * hand. When the producer lib is absent, the parameter receives `undefined`
+ * instead of breaking injection.
+ *
+ * The decorator carries no type of its own: annotate the parameter on the consumer
+ * side, e.g. with {@link import('./capability.js').CapabilityOf CapabilityOf}.
+ *
+ * Exported from the `/nestjs` subpath only, never from the main barrel: this file
+ * imports `@nestjs/common`, and the root entry point stays Nest-free.
  */
 export declare function InjectCapability(lib: string, name: string): ParameterDecorator;
 //# sourceMappingURL=inject-capability.d.ts.map

package/dist/inject-capability.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inject-capability.d.ts","sourceRoot":"","sources":["../src/inject-capability.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAM9E"}
+{"version":3,"file":"inject-capability.d.ts","sourceRoot":"","sources":["../src/inject-capability.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,kBAAkB,CAM9E"}

package/dist/inject-capability.js

@@ -1,11 +1,16 @@
 import { Inject, Optional } from '@nestjs/common';
 import { capability } from './capability.js';
 /**
- * Injeta a capability de um peer `<lib>:<name>` OPCIONALMENTE — equivale a
- * `@Optional() @Inject(capability(lib, name))`, sem a string mágica copiada à
- * mão. Quando o produtor (a outra lib) está ausente, o parâmetro recebe
- * `undefined` em vez de quebrar a injeção. O tipo do parâmetro é anotado pelo
- * consumidor (ver nota no plano sobre declaration merging cross-repo).
+ * Injects a peer lib's `<lib>:<name>` capability OPTIONALLY — equivalent to
+ * `@Optional() @Inject(capability(lib, name))`, without the magic string copied by
+ * hand. When the producer lib is absent, the parameter receives `undefined`
+ * instead of breaking injection.
+ *
+ * The decorator carries no type of its own: annotate the parameter on the consumer
+ * side, e.g. with {@link import('./capability.js').CapabilityOf CapabilityOf}.
+ *
+ * Exported from the `/nestjs` subpath only, never from the main barrel: this file
+ * imports `@nestjs/common`, and the root entry point stays Nest-free.
  */
 export function InjectCapability(lib, name) {
     const token = capability(lib, name);

package/dist/inject-capability.js.map

@@ -1 +1 @@
-{"version":3,"file":"inject-capability.js","sourceRoot":"","sources":["../src/inject-capability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,IAAY;IACxD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACpC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;QAC7C,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"inject-capability.js","sourceRoot":"","sources":["../src/inject-capability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW,EAAE,IAAY;IACxD,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACpC,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,EAAE;QAC7C,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;QAChD,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dudousxd/nestjs-diagnostics",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "A standard convention for @dudousxd/nestjs-* libs to emit observability events over node:diagnostics_channel.",
   "license": "MIT",
   "repository": {
@@ -25,8 +25,8 @@
     }
   },
   "peerDependencies": {
-    "@nestjs/common": "^10 || ^11",
-    "@nestjs/core": "^10 || ^11",
+    "@nestjs/common": "^10 || ^11 || ^12",
+    "@nestjs/core": "^10 || ^11 || ^12",
     "reflect-metadata": "^0.2"
   },
   "peerDependenciesMeta": {
@@ -58,14 +58,14 @@
     "**/trace.ts"
   ],
   "devDependencies": {
-    "@nestjs/common": "^11",
-    "@nestjs/core": "^11",
-    "@nestjs/testing": "^11",
-    "@types/node": "^20.0.0",
-    "reflect-metadata": "^0.2",
-    "typescript": "^5.4.0",
-    "unplugin-swc": "^1.5.1",
-    "vitest": "^3.0.0"
+    "@nestjs/common": "12.0.1",
+    "@nestjs/core": "12.0.1",
+    "@nestjs/testing": "12.0.1",
+    "@types/node": "20.19.43",
+    "reflect-metadata": "0.2.2",
+    "typescript": "5.9.3",
+    "unplugin-swc": "1.6.0",
+    "vitest": "3.2.7"
   },
   "engines": {
     "node": ">=20"