@rsdk/actx 6.0.0-next.29 → 6.0.0-next.30

package/dist/context-carrier.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Источник пар ключ→значение (заголовки/метадата точки входа), из которого
+ * `ContextEnricher` обогащает async-контекст. Транспортно-нейтрален: его
+ * структурно реализует `GenericHeaders` из транспортов
+ * и т.п.
+ */
+export interface ContextCarrier {
+    get(key: string): string | undefined;
+}

package/dist/context-carrier.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=context-carrier.js.map

package/dist/context-carrier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-carrier.js","sourceRoot":"","sources":["../src/context-carrier.ts"],"names":[],"mappings":""}

package/dist/context.enricher.d.ts

@@ -0,0 +1,14 @@
+import type { ContextCarrier } from './context-carrier';
+/**
+ * Обогатитель контекста: кладёт данные из `carrier` в УЖЕ открытый
+ * async-контекст. Программный аналог интерсептора-обогатителя из пайплайна
+ * (например, `TracingInterceptor`), но переиспользуемый на любом входе.
+ */
+export interface ContextEnricher {
+    enrich(carrier: ContextCarrier): void;
+}
+/**
+ * DI-токен со списком всех `ContextEnricher`. Собирается из встроенных
+ * (трейсинг) и плагинных обогатителей.
+ */
+export declare const CONTEXT_ENRICHERS: unique symbol;

package/dist/context.enricher.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CONTEXT_ENRICHERS = void 0;
+/**
+ * DI-токен со списком всех `ContextEnricher`. Собирается из встроенных
+ * (трейсинг) и плагинных обогатителей.
+ */
+exports.CONTEXT_ENRICHERS = Symbol('CONTEXT_ENRICHERS');
+//# sourceMappingURL=context.enricher.js.map

package/dist/context.enricher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.enricher.js","sourceRoot":"","sources":["../src/context.enricher.ts"],"names":[],"mappings":";;;AAWA;;;GAGG;AACU,QAAA,iBAAiB,GAAG,MAAM,CAAC,mBAAmB,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1,2 +1,6 @@
 export { AsyncContextModule } from './async-context.module';
 export { createAsyncContextProvider, AsyncContextProvider, } from './async-context.provider';
+export { IngressContext } from './ingress.context';
+export { CONTEXT_ENRICHERS } from './context.enricher';
+export type { ContextEnricher } from './context.enricher';
+export type { ContextCarrier } from './context-carrier';

package/dist/index.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createAsyncContextProvider = exports.AsyncContextModule = void 0;
+exports.CONTEXT_ENRICHERS = exports.IngressContext = exports.createAsyncContextProvider = exports.AsyncContextModule = void 0;
 var async_context_module_1 = require("./async-context.module");
 Object.defineProperty(exports, "AsyncContextModule", { enumerable: true, get: function () { return async_context_module_1.AsyncContextModule; } });
 var async_context_provider_1 = require("./async-context.provider");
 Object.defineProperty(exports, "createAsyncContextProvider", { enumerable: true, get: function () { return async_context_provider_1.createAsyncContextProvider; } });
+var ingress_context_1 = require("./ingress.context");
+Object.defineProperty(exports, "IngressContext", { enumerable: true, get: function () { return ingress_context_1.IngressContext; } });
+var context_enricher_1 = require("./context.enricher");
+Object.defineProperty(exports, "CONTEXT_ENRICHERS", { enumerable: true, get: function () { return context_enricher_1.CONTEXT_ENRICHERS; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAE3B,mEAGkC;AAFhC,oIAAA,0BAA0B,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,+DAA4D;AAAnD,0HAAA,kBAAkB,OAAA;AAE3B,mEAGkC;AAFhC,oIAAA,0BAA0B,OAAA;AAI5B,qDAAmD;AAA1C,iHAAA,cAAc,OAAA;AACvB,uDAAuD;AAA9C,qHAAA,iBAAiB,OAAA"}

package/dist/ingress.context.d.ts

@@ -0,0 +1,27 @@
+import type { ContextEnricher } from './context.enricher';
+import type { ContextCarrier } from './context-carrier';
+/**
+ * Транспортно-нейтральная точка входа: открывает свежий async-контекст,
+ * обогащает его данными из `carrier` всеми зарегистрированными
+ * `ContextEnricher` и выполняет `fn` внутри этого контекста.
+ *
+ * Программный двойник цепочки `AsyncContextInterceptor` (открыть scope) +
+ * интерсепторы-обогатители (`TracingInterceptor` и т.п.) для входов без
+ * NestJS-пайплайна: pull-консьюмеры (NATS).
+ * Открывает контекст тем же `AsyncContextStorage.run`, что и интерсептор.
+ *
+ * @example
+ * ingress.run(new NatsHeaders(msg.headers), () => handle(msg));
+ */
+export declare class IngressContext {
+    private readonly enrichers;
+    constructor(enrichers: ContextEnricher[]);
+    run<T>(carrier: ContextCarrier, fn: () => T): T;
+    /**
+     * Фиксирует текущий async-контекст и возвращает раннер, исполняющий `fn`
+     * в этом зафиксированном контексте. Для отложенного кода (ленивый генератор),
+     * который должен помнить контекст точки создания/подписки. Если контекста
+     * нет — раннер просто выполняет `fn` как есть.
+     */
+    capture(): <T>(fn: () => T) => T;
+}

package/dist/ingress.context.js

@@ -0,0 +1,62 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IngressContext = void 0;
+const common_1 = require("@nestjs/common");
+const async_context_storage_1 = require("./async-context.storage");
+const context_enricher_1 = require("./context.enricher");
+/**
+ * Транспортно-нейтральная точка входа: открывает свежий async-контекст,
+ * обогащает его данными из `carrier` всеми зарегистрированными
+ * `ContextEnricher` и выполняет `fn` внутри этого контекста.
+ *
+ * Программный двойник цепочки `AsyncContextInterceptor` (открыть scope) +
+ * интерсепторы-обогатители (`TracingInterceptor` и т.п.) для входов без
+ * NestJS-пайплайна: pull-консьюмеры (NATS).
+ * Открывает контекст тем же `AsyncContextStorage.run`, что и интерсептор.
+ *
+ * @example
+ * ingress.run(new NatsHeaders(msg.headers), () => handle(msg));
+ */
+let IngressContext = class IngressContext {
+    enrichers;
+    constructor(enrichers) {
+        this.enrichers = enrichers;
+    }
+    run(carrier, fn) {
+        return async_context_storage_1.AsyncContextStorage.run(new Map(), () => {
+            for (const enricher of this.enrichers) {
+                enricher.enrich(carrier);
+            }
+            return fn();
+        });
+    }
+    /**
+     * Фиксирует текущий async-контекст и возвращает раннер, исполняющий `fn`
+     * в этом зафиксированном контексте. Для отложенного кода (ленивый генератор),
+     * который должен помнить контекст точки создания/подписки. Если контекста
+     * нет — раннер просто выполняет `fn` как есть.
+     */
+    capture() {
+        const store = async_context_storage_1.AsyncContextStorage.getStore();
+        return (fn) => store ? async_context_storage_1.AsyncContextStorage.run(store, fn) : fn();
+    }
+};
+exports.IngressContext = IngressContext;
+exports.IngressContext = IngressContext = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(context_enricher_1.CONTEXT_ENRICHERS)),
+    __metadata("design:paramtypes", [Array])
+], IngressContext);
+//# sourceMappingURL=ingress.context.js.map

package/dist/ingress.context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ingress.context.js","sourceRoot":"","sources":["../src/ingress.context.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAAoD;AAEpD,mEAA8D;AAE9D,yDAAuD;AAGvD;;;;;;;;;;;;GAYG;AAEI,IAAM,cAAc,GAApB,MAAM,cAAc;IAGN;IAFnB,YAEmB,SAA4B;QAA5B,cAAS,GAAT,SAAS,CAAmB;IAC5C,CAAC;IAEJ,GAAG,CAAI,OAAuB,EAAE,EAAW;QACzC,OAAO,2CAAmB,CAAC,GAAG,CAAC,IAAI,GAAG,EAAY,EAAE,GAAG,EAAE;YACvD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;gBACtC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;YAC3B,CAAC;YAED,OAAO,EAAE,EAAE,CAAC;QACd,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,OAAO;QACL,MAAM,KAAK,GAAG,2CAAmB,CAAC,QAAQ,EAAE,CAAC;QAE7C,OAAO,CAAI,EAAW,EAAK,EAAE,CAC3B,KAAK,CAAC,CAAC,CAAC,2CAAmB,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACtD,CAAC;CACF,CAAA;AA5BY,wCAAc;yBAAd,cAAc;IAD1B,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,oCAAiB,CAAC,CAAA;;GAFjB,cAAc,CA4B1B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rsdk/actx",
-  "version": "6.0.0-next.29",
+  "version": "6.0.0-next.30",
   "description": "Library for AsyncLocalStorage",
   "license": "Apache License 2.0",
   "publishConfig": {
@@ -15,5 +15,5 @@
     "@nestjs/core": "<=10.4.8",
     "rxjs": "^7.8.1"
   },
-  "gitHead": "c9daf2934e4d1dbb88a5955d8869179b0846976f"
+  "gitHead": "b3508ef34ae639383ce55056f597f2783303bd9f"
 }

package/src/context-carrier.ts

@@ -0,0 +1,9 @@
+/**
+ * Источник пар ключ→значение (заголовки/метадата точки входа), из которого
+ * `ContextEnricher` обогащает async-контекст. Транспортно-нейтрален: его
+ * структурно реализует `GenericHeaders` из транспортов
+ * и т.п.
+ */
+export interface ContextCarrier {
+  get(key: string): string | undefined;
+}

package/src/context.enricher.ts

@@ -0,0 +1,16 @@
+import type { ContextCarrier } from './context-carrier';
+
+/**
+ * Обогатитель контекста: кладёт данные из `carrier` в УЖЕ открытый
+ * async-контекст. Программный аналог интерсептора-обогатителя из пайплайна
+ * (например, `TracingInterceptor`), но переиспользуемый на любом входе.
+ */
+export interface ContextEnricher {
+  enrich(carrier: ContextCarrier): void;
+}
+
+/**
+ * DI-токен со списком всех `ContextEnricher`. Собирается из встроенных
+ * (трейсинг) и плагинных обогатителей.
+ */
+export const CONTEXT_ENRICHERS = Symbol('CONTEXT_ENRICHERS');

package/src/index.ts

@@ -4,3 +4,8 @@ export {
   createAsyncContextProvider,
   AsyncContextProvider,
 } from './async-context.provider';
+
+export { IngressContext } from './ingress.context';
+export { CONTEXT_ENRICHERS } from './context.enricher';
+export type { ContextEnricher } from './context.enricher';
+export type { ContextCarrier } from './context-carrier';

package/src/ingress.context.ts

@@ -0,0 +1,50 @@
+import { Inject, Injectable } from '@nestjs/common';
+
+import { AsyncContextStorage } from './async-context.storage';
+import type { ContextEnricher } from './context.enricher';
+import { CONTEXT_ENRICHERS } from './context.enricher';
+import type { ContextCarrier } from './context-carrier';
+
+/**
+ * Транспортно-нейтральная точка входа: открывает свежий async-контекст,
+ * обогащает его данными из `carrier` всеми зарегистрированными
+ * `ContextEnricher` и выполняет `fn` внутри этого контекста.
+ *
+ * Программный двойник цепочки `AsyncContextInterceptor` (открыть scope) +
+ * интерсепторы-обогатители (`TracingInterceptor` и т.п.) для входов без
+ * NestJS-пайплайна: pull-консьюмеры (NATS).
+ * Открывает контекст тем же `AsyncContextStorage.run`, что и интерсептор.
+ *
+ * @example
+ * ingress.run(new NatsHeaders(msg.headers), () => handle(msg));
+ */
+@Injectable()
+export class IngressContext {
+  constructor(
+    @Inject(CONTEXT_ENRICHERS)
+    private readonly enrichers: ContextEnricher[],
+  ) {}
+
+  run<T>(carrier: ContextCarrier, fn: () => T): T {
+    return AsyncContextStorage.run(new Map<any, any>(), () => {
+      for (const enricher of this.enrichers) {
+        enricher.enrich(carrier);
+      }
+
+      return fn();
+    });
+  }
+
+  /**
+   * Фиксирует текущий async-контекст и возвращает раннер, исполняющий `fn`
+   * в этом зафиксированном контексте. Для отложенного кода (ленивый генератор),
+   * который должен помнить контекст точки создания/подписки. Если контекста
+   * нет — раннер просто выполняет `fn` как есть.
+   */
+  capture(): <T>(fn: () => T) => T {
+    const store = AsyncContextStorage.getStore();
+
+    return <T>(fn: () => T): T =>
+      store ? AsyncContextStorage.run(store, fn) : fn();
+  }
+}