@webpieces/core-context 0.3.279 → 0.3.281

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@webpieces/core-context",
-  "version": "0.3.279",
+  "version": "0.3.281",
   "description": "AsyncLocalStorage-based context management for request-scoped data",
   "type": "commonjs",
   "main": "./src/index.js",
@@ -22,7 +22,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@webpieces/core-util": "0.3.279",
+    "@webpieces/core-util": "0.3.281",
     "@inversifyjs/binding-decorators": "1.1.5",
     "inversify": "7.10.4",
     "reflect-metadata": "0.2.2"

package/src/frameworkProvide.d.ts

@@ -0,0 +1,18 @@
+import { ContainerModule } from 'inversify';
+import type { ServiceIdentifier } from 'inversify';
+/**
+ * Framework equivalent of @provideSingleton: registers the class as a singleton bound to
+ * itself, into the webpieces framework registry (NOT the binding-decorators global one).
+ */
+export declare function provideFrameworkSingleton(): ClassDecorator;
+/**
+ * Framework equivalent of @provideSingletonAs: binds the impl to a token (Symbol or abstract
+ * class) as a singleton, into the webpieces framework registry.
+ */
+export declare function provideFrameworkSingletonAs<T>(serviceIdentifier: ServiceIdentifier<T>): ClassDecorator;
+/**
+ * Build a ContainerModule binding every provideFrameworkSingleton(As) class. Load this into
+ * the webpieces framework + app containers (the router does this) alongside the client's own
+ * buildProviderModule().
+ */
+export declare function buildFrameworkModule(): ContainerModule;

package/src/frameworkProvide.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.provideFrameworkSingleton = provideFrameworkSingleton;
+exports.provideFrameworkSingletonAs = provideFrameworkSingletonAs;
+exports.buildFrameworkModule = buildFrameworkModule;
+const inversify_1 = require("inversify");
+class FrameworkBinding {
+    serviceIdentifier;
+    target;
+    constructor(serviceIdentifier, target) {
+        this.serviceIdentifier = serviceIdentifier;
+        this.target = target;
+    }
+}
+/** The webpieces-only binding registry (a plain module-level list, one per hosted core-context). */
+const frameworkRegistry = [];
+/**
+ * Framework equivalent of @provideSingleton: registers the class as a singleton bound to
+ * itself, into the webpieces framework registry (NOT the binding-decorators global one).
+ */
+function provideFrameworkSingleton() {
+    // webpieces-disable no-any-unknown -- decorator target is any class constructor
+    return (target) => {
+        frameworkRegistry.push(new FrameworkBinding(target, target));
+        return target;
+    };
+}
+/**
+ * Framework equivalent of @provideSingletonAs: binds the impl to a token (Symbol or abstract
+ * class) as a singleton, into the webpieces framework registry.
+ */
+function provideFrameworkSingletonAs(serviceIdentifier) {
+    // webpieces-disable no-any-unknown -- decorator target is any class constructor
+    return (target) => {
+        frameworkRegistry.push(new FrameworkBinding(serviceIdentifier, target));
+        return target;
+    };
+}
+/**
+ * Build a ContainerModule binding every provideFrameworkSingleton(As) class. Load this into
+ * the webpieces framework + app containers (the router does this) alongside the client's own
+ * buildProviderModule().
+ */
+function buildFrameworkModule() {
+    return new inversify_1.ContainerModule((options) => {
+        for (const binding of frameworkRegistry) {
+            options.bind(binding.serviceIdentifier).to(binding.target).inSingletonScope();
+        }
+    });
+}
+//# sourceMappingURL=frameworkProvide.js.map

package/src/frameworkProvide.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworkProvide.js","sourceRoot":"","sources":["../../../../../packages/core/core-context/src/frameworkProvide.ts"],"names":[],"mappings":";;AAoCA,8DAMC;AAMD,kEAMC;AAOD,oDAMC;AAnED,yCAA4C;AAsB5C,MAAM,gBAAgB;IAEE;IACA;IAFpB,YACoB,iBAAoC,EACpC,MAAe;QADf,sBAAiB,GAAjB,iBAAiB,CAAmB;QACpC,WAAM,GAAN,MAAM,CAAS;IAChC,CAAC;CACP;AAED,oGAAoG;AACpG,MAAM,iBAAiB,GAAuB,EAAE,CAAC;AAEjD;;;GAGG;AACH,SAAgB,yBAAyB;IACrC,gFAAgF;IAChF,OAAO,CAAC,MAAW,EAAE,EAAE;QACnB,iBAAiB,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAC7D,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAgB,2BAA2B,CAAI,iBAAuC;IAClF,gFAAgF;IAChF,OAAO,CAAC,MAAW,EAAE,EAAE;QACnB,iBAAiB,CAAC,IAAI,CAAC,IAAI,gBAAgB,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC,CAAC;QACxE,OAAO,MAAM,CAAC;IAClB,CAAC,CAAC;AACN,CAAC;AAED;;;;GAIG;AACH,SAAgB,oBAAoB;IAChC,OAAO,IAAI,2BAAe,CAAC,CAAC,OAAmC,EAAE,EAAE;QAC/D,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,CAAC;YACtC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAClF,CAAC;IACL,CAAC,CAAC,CAAC;AACP,CAAC","sourcesContent":["import { ContainerModule } from 'inversify';\nimport type { ContainerModuleLoadOptions, ServiceIdentifier } from 'inversify';\n\n/**\n * Framework-only DI provider decorators — a SEPARATE registry from the client-facing\n * @provideSingleton (which uses @inversifyjs/binding-decorators' single global registry).\n *\n * WHY: binding-decorators registers every @provideSingleton class under ONE global\n * reflect-metadata key, and buildProviderModule() scoops up that whole key. If webpieces\n * framework classes (RouteBuilderImpl, the filters, WebpiecesRouter) used @provideSingleton,\n * a CLIENT app's buildProviderModule() would drag those framework internals into its own\n * container. To keep the two worlds separate:\n *   - packages/** (framework libs) MUST use provideFrameworkSingleton (this registry),\n *     enforced by the no-global-providesingleton-in-packages ESLint rule.\n *   - apps/** (and downstream client projects) use plain @provideSingleton (the global one).\n * The router loads BOTH buildFrameworkModule() and buildProviderModule(), so everything\n * resolves — but a client's buildProviderModule() only ever sees the client's own classes.\n */\n\n// webpieces-disable no-any-unknown -- decorator targets are arbitrary class constructors\ntype AnyCtor = new (...args: any[]) => unknown;\n\nclass FrameworkBinding {\n    constructor(\n        public readonly serviceIdentifier: ServiceIdentifier,\n        public readonly target: AnyCtor,\n    ) {}\n}\n\n/** The webpieces-only binding registry (a plain module-level list, one per hosted core-context). */\nconst frameworkRegistry: FrameworkBinding[] = [];\n\n/**\n * Framework equivalent of @provideSingleton: registers the class as a singleton bound to\n * itself, into the webpieces framework registry (NOT the binding-decorators global one).\n */\nexport function provideFrameworkSingleton(): ClassDecorator {\n    // webpieces-disable no-any-unknown -- decorator target is any class constructor\n    return (target: any) => {\n        frameworkRegistry.push(new FrameworkBinding(target, target));\n        return target;\n    };\n}\n\n/**\n * Framework equivalent of @provideSingletonAs: binds the impl to a token (Symbol or abstract\n * class) as a singleton, into the webpieces framework registry.\n */\nexport function provideFrameworkSingletonAs<T>(serviceIdentifier: ServiceIdentifier<T>): ClassDecorator {\n    // webpieces-disable no-any-unknown -- decorator target is any class constructor\n    return (target: any) => {\n        frameworkRegistry.push(new FrameworkBinding(serviceIdentifier, target));\n        return target;\n    };\n}\n\n/**\n * Build a ContainerModule binding every provideFrameworkSingleton(As) class. Load this into\n * the webpieces framework + app containers (the router does this) alongside the client's own\n * buildProviderModule().\n */\nexport function buildFrameworkModule(): ContainerModule {\n    return new ContainerModule((options: ContainerModuleLoadOptions) => {\n        for (const binding of frameworkRegistry) {\n            options.bind(binding.serviceIdentifier).to(binding.target).inSingletonScope();\n        }\n    });\n}\n"]}

package/src/index.d.ts

@@ -1,4 +1,5 @@
 export { RequestContext } from './RequestContext';
 export { provideSingleton, provideSingletonAs, provideTransient } from './provide';
+export { provideFrameworkSingleton, provideFrameworkSingletonAs, buildFrameworkModule, } from './frameworkProvide';
 export { ContextMgr, RequestIdChainProcessor } from '@webpieces/core-util';
 export { RequestContextReader } from './RequestContextReader';

package/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.RequestContextReader = exports.RequestIdChainProcessor = exports.ContextMgr = exports.provideTransient = exports.provideSingletonAs = exports.provideSingleton = exports.RequestContext = void 0;
+exports.RequestContextReader = exports.RequestIdChainProcessor = exports.ContextMgr = exports.buildFrameworkModule = exports.provideFrameworkSingletonAs = exports.provideFrameworkSingleton = exports.provideTransient = exports.provideSingletonAs = exports.provideSingleton = exports.RequestContext = void 0;
 // Context management with AsyncLocalStorage
 var RequestContext_1 = require("./RequestContext");
 Object.defineProperty(exports, "RequestContext", { enumerable: true, get: function () { return RequestContext_1.RequestContext; } });
@@ -9,6 +9,12 @@ var provide_1 = require("./provide");
 Object.defineProperty(exports, "provideSingleton", { enumerable: true, get: function () { return provide_1.provideSingleton; } });
 Object.defineProperty(exports, "provideSingletonAs", { enumerable: true, get: function () { return provide_1.provideSingletonAs; } });
 Object.defineProperty(exports, "provideTransient", { enumerable: true, get: function () { return provide_1.provideTransient; } });
+// Framework-only DI registry (packages/** use these; keeps framework classes out of a
+// client's buildProviderModule() global scan). See frameworkProvide.ts.
+var frameworkProvide_1 = require("./frameworkProvide");
+Object.defineProperty(exports, "provideFrameworkSingleton", { enumerable: true, get: function () { return frameworkProvide_1.provideFrameworkSingleton; } });
+Object.defineProperty(exports, "provideFrameworkSingletonAs", { enumerable: true, get: function () { return frameworkProvide_1.provideFrameworkSingletonAs; } });
+Object.defineProperty(exports, "buildFrameworkModule", { enumerable: true, get: function () { return frameworkProvide_1.buildFrameworkModule; } });
 // Outbound-header machinery — MOVED to browser+node @webpieces/core-util so the
 // isomorphic http-client can use ContextMgr without pulling in this Node-only
 // (AsyncLocalStorage) package. Re-exported here for back-compat.

package/src/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/core/core-context/src/index.ts"],"names":[],"mappings":";;;AAAA,4CAA4C;AAC5C,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,mFAAmF;AACnF,qCAAmF;AAA1E,2GAAA,gBAAgB,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAE/D,gFAAgF;AAChF,8EAA8E;AAC9E,iEAAiE;AACjE,kDAA2E;AAAlE,uGAAA,UAAU,OAAA;AAAE,oHAAA,uBAAuB,OAAA;AAC5C,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA","sourcesContent":["// Context management with AsyncLocalStorage\nexport { RequestContext } from './RequestContext';\n\n// DI provider decorators (shared DI seam; http-routing re-exports for back-compat)\nexport { provideSingleton, provideSingletonAs, provideTransient } from './provide';\n\n// Outbound-header machinery — MOVED to browser+node @webpieces/core-util so the\n// isomorphic http-client can use ContextMgr without pulling in this Node-only\n// (AsyncLocalStorage) package. Re-exported here for back-compat.\nexport { ContextMgr, RequestIdChainProcessor } from '@webpieces/core-util';\nexport { RequestContextReader } from './RequestContextReader';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/core/core-context/src/index.ts"],"names":[],"mappings":";;;AAAA,4CAA4C;AAC5C,mDAAkD;AAAzC,gHAAA,cAAc,OAAA;AAEvB,mFAAmF;AACnF,qCAAmF;AAA1E,2GAAA,gBAAgB,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAC/D,sFAAsF;AACtF,wEAAwE;AACxE,uDAI4B;AAHxB,6HAAA,yBAAyB,OAAA;AACzB,+HAAA,2BAA2B,OAAA;AAC3B,wHAAA,oBAAoB,OAAA;AAGxB,gFAAgF;AAChF,8EAA8E;AAC9E,iEAAiE;AACjE,kDAA2E;AAAlE,uGAAA,UAAU,OAAA;AAAE,oHAAA,uBAAuB,OAAA;AAC5C,+DAA8D;AAArD,4HAAA,oBAAoB,OAAA","sourcesContent":["// Context management with AsyncLocalStorage\nexport { RequestContext } from './RequestContext';\n\n// DI provider decorators (shared DI seam; http-routing re-exports for back-compat)\nexport { provideSingleton, provideSingletonAs, provideTransient } from './provide';\n// Framework-only DI registry (packages/** use these; keeps framework classes out of a\n// client's buildProviderModule() global scan). See frameworkProvide.ts.\nexport {\n    provideFrameworkSingleton,\n    provideFrameworkSingletonAs,\n    buildFrameworkModule,\n} from './frameworkProvide';\n\n// Outbound-header machinery — MOVED to browser+node @webpieces/core-util so the\n// isomorphic http-client can use ContextMgr without pulling in this Node-only\n// (AsyncLocalStorage) package. Re-exported here for back-compat.\nexport { ContextMgr, RequestIdChainProcessor } from '@webpieces/core-util';\nexport { RequestContextReader } from './RequestContextReader';\n"]}