@furystack/rest-service 13.0.0 → 14.1.0

package/esm/endpoint-generators/utils.js

@@ -1,26 +1,39 @@
-import { addStore, InMemoryStore, User } from '@furystack/core';
+import { defineStore, InMemoryStore, User } from '@furystack/core';
+import { defineDataSet } from '@furystack/repository';
 import { DefaultSession } from '../models/default-session.js';
-import '@furystack/repository';
-import '../helpers.js';
-import { getRepository } from '@furystack/repository';
+import { SessionStore, UserStore } from '../user-store.js';
+/**
+ * Mock entity used by endpoint-generator specs.
+ */
 export class MockClass {
 }
+/**
+ * Store token for {@link MockClass}. The default factory throws so each spec
+ * explicitly opts into an in-memory backing via `setupContext`.
+ */
+export const MockStore = defineStore({
+    name: 'test/MockStore',
+    model: MockClass,
+    primaryKey: 'id',
+    factory: () => {
+        throw new Error('MockStore is not configured in this injector');
+    },
+});
+/**
+ * Data set token over {@link MockStore}.
+ */
+export const MockDataSet = defineDataSet({
+    name: 'test/MockDataSet',
+    store: MockStore,
+});
+/**
+ * Binds in-memory implementations of {@link UserStore}, {@link SessionStore}
+ * and {@link MockStore} on the provided injector. Endpoint-generator specs
+ * and integration tests call this at setup time.
+ */
 export const setupContext = (i) => {
-    addStore(i, new InMemoryStore({
-        model: MockClass,
-        primaryKey: 'id',
-    }))
-        .addStore(new InMemoryStore({
-        model: User,
-        primaryKey: 'username',
-    }))
-        .addStore(new InMemoryStore({
-        model: DefaultSession,
-        primaryKey: 'sessionId',
-    }));
-    getRepository(i)
-        .createDataSet(MockClass, 'id')
-        .createDataSet(User, 'username')
-        .createDataSet(DefaultSession, 'sessionId');
+    i.bind(UserStore, () => new InMemoryStore({ model: User, primaryKey: 'username' }));
+    i.bind(SessionStore, () => new InMemoryStore({ model: DefaultSession, primaryKey: 'sessionId' }));
+    i.bind(MockStore, () => new InMemoryStore({ model: MockClass, primaryKey: 'id' }));
 };
 //# sourceMappingURL=utils.js.map

package/esm/endpoint-generators/utils.js.map

@@ -1 +1 @@
-{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/endpoint-generators/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,uBAAuB,CAAA;AAC9B,OAAO,eAAe,CAAA;AACtB,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAErD,MAAM,OAAO,SAAS;CAGrB;AAED,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAW,EAAE,EAAE;IAC1C,QAAQ,CACN,CAAC,EACD,IAAI,aAAa,CAAC;QAChB,KAAK,EAAE,SAAS;QAChB,UAAU,EAAE,IAAI;KACjB,CAAC,CACH;SACE,QAAQ,CACP,IAAI,aAAa,CAAC;QAChB,KAAK,EAAE,IAAI;QACX,UAAU,EAAE,UAAU;KACvB,CAAC,CACH;SACA,QAAQ,CACP,IAAI,aAAa,CAAC;QAChB,KAAK,EAAE,cAAc;QACrB,UAAU,EAAE,WAAW;KACxB,CAAC,CACH,CAAA;IACH,aAAa,CAAC,CAAC,CAAC;SACb,aAAa,CAAC,SAAS,EAAE,IAAI,CAAC;SAC9B,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC;SAC/B,aAAa,CAAC,cAAc,EAAE,WAAW,CAAC,CAAA;AAC/C,CAAC,CAAA"}
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/endpoint-generators/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAE1D;;GAEG;AACH,MAAM,OAAO,SAAS;CAGrB;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAC;IACnC,IAAI,EAAE,gBAAgB;IACtB,KAAK,EAAE,SAAS;IAChB,UAAU,EAAE,IAAI;IAChB,OAAO,EAAE,GAAG,EAAE;QACZ,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAA;IACjE,CAAC;CACF,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,aAAa,CAAC;IACvC,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,SAAS;CACjB,CAAC,CAAA;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAW,EAAQ,EAAE;IAChD,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CAAA;IACnF,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC,CAAA;IACjG,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,aAAa,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AACpF,CAAC,CAAA"}

package/esm/get-schema-from-api.d.ts

@@ -1,5 +1,5 @@
 import type { ApiEndpointSchema, RestApi, Schema } from '@furystack/rest';
-import type { RestApiImplementation } from './api-manager.js';
+import type { RestApiImplementation } from './rest-api-runtime.js';
 export declare const defaultSchema: Schema;
 export declare const getSchemaFromApi: <T extends RestApiImplementation<RestApi>>({ api, name, description, version, }: {
     api: T;

package/esm/get-schema-from-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"get-schema-from-api.d.ts","sourceRoot":"","sources":["../src/get-schema-from-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,iBAAiB,EAAU,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAA;AAG7D,eAAO,MAAM,aAAa,EAAE,MA2B3B,CAAA;AAcD,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,qBAAqB,CAAC,OAAO,CAAC,EAAE,sCAKxE;IACD,GAAG,EAAE,CAAC,CAAA;IACN,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,KAAG,iBAuBH,CAAA"}
+{"version":3,"file":"get-schema-from-api.d.ts","sourceRoot":"","sources":["../src/get-schema-from-api.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAyB,iBAAiB,EAAU,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAExG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAA;AAElE,eAAO,MAAM,aAAa,EAAE,MA2B3B,CAAA;AAcD,eAAO,MAAM,gBAAgB,GAAI,CAAC,SAAS,qBAAqB,CAAC,OAAO,CAAC,EAAE,sCAKxE;IACD,GAAG,EAAE,CAAC,CAAA;IACN,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,KAAG,iBAwBH,CAAA"}

package/esm/get-schema-from-api.js

@@ -42,6 +42,7 @@ export const getSchemaFromApi = ({ api, name = 'FuryStack API', description = 'A
         if (!endpoints[methodKey]) {
             endpoints[methodKey] = {};
         }
+        // eslint-disable-next-line @typescript-eslint/no-unnecessary-type-assertion -- false positive: TS narrows `endpointList` to a union the iterator can't index without this cast
         Object.entries(endpointList).forEach(([url, requestAction]) => {
             if (method && url && requestAction) {
                 endpoints[methodKey][url] = getDefinitionFromAction(url, requestAction);

package/esm/get-schema-from-api.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-schema-from-api.js","sourceRoot":"","sources":["../src/get-schema-from-api.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,WAAW,EAAE;QACX,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,IAAI;iBAC3B;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,IAAI;iBAC3B;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,IAAI;iBAC3B;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,IAAI;iBAC3B;aACF;YACD,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,kCAAkC;YAC/C,oBAAoB,EAAE,IAAI;SAC3B;KACF;CACF,CAAA;AAED,MAAM,iBAAiB,GAAG,SAAS,CAAA;AAEnC,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAE,MAA0C,EAAyB,EAAE;IAClH,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,QAAQ,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa;QAC/F,UAAU,EAAE,YAAY,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB;QACnH,eAAe,EACb,iBAAiB,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK;KAC9G,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAA2C,EACzE,GAAG,EACH,IAAI,GAAG,eAAe,EACtB,WAAW,GAAG,uDAAuD,EACrE,OAAO,GAAG,OAAO,GAMlB,EAAqB,EAAE;IACtB,MAAM,SAAS,GAAmC,EAAE,CAAA;IAEpD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE;QACrD,MAAM,SAAS,GAAG,MAAgB,CAAA;QAClC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,CAAA;QAC3B,CAAC;QACD,MAAM,CAAC,OAAO,CAAC,YAAkE,CAAC,CAAC,OAAO,CACxF,CAAC,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,EAAE;YACvB,IAAI,MAAM,IAAI,GAAG,IAAI,aAAa,EAAE,CAAC;gBACnC,SAAS,CAAC,SAAS,CAAE,CAAC,GAAG,CAAC,GAAG,uBAAuB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;YAC1E,CAAC;QACH,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,IAAI;QACJ,WAAW;QACX,OAAO;QACP,SAAS;KACV,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"get-schema-from-api.js","sourceRoot":"","sources":["../src/get-schema-from-api.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,WAAW,EAAE;QACX,OAAO,EAAE;YACP,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,IAAI;iBAC3B;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,IAAI;iBAC3B;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,IAAI;iBAC3B;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,QAAQ;oBACd,oBAAoB,EAAE,IAAI;iBAC3B;aACF;YACD,QAAQ,EAAE,EAAE;YACZ,WAAW,EAAE,kCAAkC;YAC/C,oBAAoB,EAAE,IAAI;SAC3B;KACF;CACF,CAAA;AAED,MAAM,iBAAiB,GAAG,SAAS,CAAA;AAEnC,MAAM,uBAAuB,GAAG,CAAC,IAAY,EAAE,MAA0C,EAAyB,EAAE;IAClH,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,QAAQ,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,aAAa;QAC/F,UAAU,EAAE,YAAY,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,iBAAiB;QACnH,eAAe,EACb,iBAAiB,IAAI,MAAM,IAAI,OAAO,MAAM,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,KAAK;KAC9G,CAAA;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAA2C,EACzE,GAAG,EACH,IAAI,GAAG,eAAe,EACtB,WAAW,GAAG,uDAAuD,EACrE,OAAO,GAAG,OAAO,GAMlB,EAAqB,EAAE;IACtB,MAAM,SAAS,GAAmC,EAAE,CAAA;IAEpD,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,EAAE,YAAY,CAAC,EAAE,EAAE;QACrD,MAAM,SAAS,GAAG,MAAgB,CAAA;QAClC,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;YAC1B,SAAS,CAAC,SAAS,CAAC,GAAG,EAAE,CAAA;QAC3B,CAAC;QACD,+KAA+K;QAC/K,MAAM,CAAC,OAAO,CAAC,YAAkE,CAAC,CAAC,OAAO,CACxF,CAAC,CAAC,GAAG,EAAE,aAAa,CAAC,EAAE,EAAE;YACvB,IAAI,MAAM,IAAI,GAAG,IAAI,aAAa,EAAE,CAAC;gBACnC,SAAS,CAAC,SAAS,CAAE,CAAC,GAAG,CAAC,GAAG,uBAAuB,CAAC,GAAG,EAAE,aAAa,CAAC,CAAA;YAC1E,CAAC;QACH,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,OAAO;QACL,IAAI;QACJ,WAAW;QACX,OAAO;QACP,SAAS;KACV,CAAA;AACH,CAAC,CAAA"}

package/esm/get-schema-from-api.spec.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-schema-from-api.spec.js","sourceRoot":"","sources":["../src/get-schema-from-api.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAE7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAC1E,OAAO,EAAE,UAAU,EAAsB,MAAM,oCAAoC,CAAA;AACnF,OAAO,gBAAgB,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,MAAM,aAAa,GAAuB,KAAK,IAAI,EAAE;IACnD,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;AACtC,CAAC,CAAA;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,GAAG,GAAG;YACV,GAAG,EAAE;gBACH,UAAU,EAAE,aAAa;aAC1B;SAC4C,CAAA;QAE/C,MAAM,MAAM,GAAG,gBAAgB,CAAC;YAC9B,GAAG,EAAE,GAAG;YACR,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,OAAO;SACjB,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE;gBACT,GAAG,EAAE;oBACH,UAAU,EAAE;wBACV,eAAe,EAAE,KAAK;wBACtB,IAAI,EAAE,UAAU;wBAChB,MAAM,EAAE,aAAa;wBACrB,UAAU,EAAE,SAAS;qBACtB;iBACF;aACF;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,GAAG,GAAG;YACV,GAAG,EAAE;gBACH,iBAAiB,EAAE,QAAQ,CAAC;oBAC1B,MAAM,EAAE,gBAAgB;oBACxB,UAAU,EAAE,eAAe;iBAC5B,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aAC9C;SAC4C,CAAA;QAE/C,MAAM,MAAM,GAAG,gBAAgB,CAAC;YAC9B,GAAG,EAAE,GAAG;YACR,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,OAAO;SACjB,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE;gBACT,GAAG,EAAE;oBACH,iBAAiB,EAAE;wBACjB,eAAe,EAAE,KAAK;wBACtB,IAAI,EAAE,iBAAiB;wBACvB,MAAM,EAAE,gBAAgB;wBACxB,UAAU,EAAE,eAAe;qBAC5B;iBACF;aACF;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"get-schema-from-api.spec.js","sourceRoot":"","sources":["../src/get-schema-from-api.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAA;AAE1E,OAAO,EAAE,UAAU,EAAsB,MAAM,oCAAoC,CAAA;AACnF,OAAO,gBAAgB,MAAM,yCAAyC,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAC5F,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAExC,MAAM,aAAa,GAAuB,KAAK,IAAI,EAAE;IACnD,OAAO,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAA;AACtC,CAAC,CAAA;AAED,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,GAAG,GAAG;YACV,GAAG,EAAE;gBACH,UAAU,EAAE,aAAa;aAC1B;SAC4C,CAAA;QAE/C,MAAM,MAAM,GAAG,gBAAgB,CAAC;YAC9B,GAAG,EAAE,GAAG;YACR,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,OAAO;SACjB,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE;gBACT,GAAG,EAAE;oBACH,UAAU,EAAE;wBACV,eAAe,EAAE,KAAK;wBACtB,IAAI,EAAE,UAAU;wBAChB,MAAM,EAAE,aAAa;wBACrB,UAAU,EAAE,SAAS;qBACtB;iBACF;aACF;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IAEF,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,GAAG,GAAG;YACV,GAAG,EAAE;gBACH,iBAAiB,EAAE,QAAQ,CAAC;oBAC1B,MAAM,EAAE,gBAAgB;oBACxB,UAAU,EAAE,eAAe;iBAC5B,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;aAC9C;SAC4C,CAAA;QAE/C,MAAM,MAAM,GAAG,gBAAgB,CAAC;YAC9B,GAAG,EAAE,GAAG;YACR,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,OAAO;SACjB,CAAC,CAAA;QACF,MAAM,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC;YACrB,IAAI,EAAE,UAAU;YAChB,WAAW,EAAE,sBAAsB;YACnC,OAAO,EAAE,OAAO;YAChB,SAAS,EAAE;gBACT,GAAG,EAAE;oBACH,iBAAiB,EAAE;wBACjB,eAAe,EAAE,KAAK;wBACtB,IAAI,EAAE,iBAAiB;wBACvB,MAAM,EAAE,gBAAgB;wBACxB,UAAU,EAAE,eAAe;qBAC5B;iBACF;aACF;SACF,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/esm/helpers.d.ts

@@ -1,105 +1,71 @@
-import type { User } from '@furystack/core';
 import type { Injector } from '@furystack/inject';
 import type { RestApi } from '@furystack/rest';
-import type { ImplementApiOptions } from './api-manager.js';
 import { HttpAuthenticationSettings } from './http-authentication-settings.js';
-import type { DefaultSession } from './models/default-session.js';
-import type { ProxyOptions } from './proxy-manager.js';
-import type { StaticServerOptions } from './static-server-manager.js';
+import { type ServerApi } from './http-server-pool.js';
+import type { CorsOptions } from './models/cors-options.js';
+import { type ProxyOptions } from './proxy-runtime.js';
+import { type RestApiImplementation } from './rest-api-runtime.js';
+import { type StaticServerOptions } from './static-site-runtime.js';
 /**
- * Sets up the @furystack/rest-service with the provided settings
- * @param api The API implementation details
- * @returns a promise that resolves when the API is added to the server
+ * Options accepted by {@link useRestService}. Cross-cutting concerns
+ * (authentication, telemetry) have moved to DI tokens — they are not
+ * configured here.
  */
-export declare const useRestService: <T extends RestApi>(api: ImplementApiOptions<T>) => Promise<{
-    shouldExec: (msg: import("./server-manager.js").OnRequest) => boolean;
-    onRequest: (msg: import("./server-manager.js").OnRequest) => Promise<void>;
-}>;
+export interface ImplementApiOptions<T extends RestApi> {
+    /** The structure of the implemented API. */
+    api: RestApiImplementation<T>;
+    /** Injector used to resolve request-scoped services and to acquire the HTTP server. */
+    injector: Injector;
+    /** Optional host name; defaults to `localhost`. */
+    hostName?: string;
+    /** Root path prepended to every API route. */
+    root: string;
+    /** Port the API should listen on. */
+    port: number;
+    /** Optional CORS configuration applied to every matched request. */
+    cors?: CorsOptions;
+    /** Optional query-string deserialiser override. */
+    deserializeQueryParams?: (param: string) => Record<string, unknown>;
+    /** When `true`, adds `GET /schema` and `GET /openapi.json` endpoints. */
+    enableGetSchema?: boolean;
+    /** OpenAPI display name. */
+    name?: string;
+    /** OpenAPI description. */
+    description?: string;
+    /** OpenAPI version. */
+    version?: string;
+}
 /**
- * Sets up the HTTP Authentication with pluggable providers.
- *
- * Registers Basic Auth (if enabled) and Cookie Auth as built-in providers,
- * then appends any custom providers passed via settings.
+ * Acquires a pooled HTTP server (creating one if needed), compiles `api`
+ * and attaches a {@link ServerApi} that dispatches matching requests.
+ * Multiple `useRestService` calls on the same `port` + `hostName` share a
+ * single underlying HTTP server.
+ */
+export declare const useRestService: <T extends RestApi>(options: ImplementApiOptions<T>) => Promise<ServerApi>;
+/**
+ * Installs HTTP authentication on the given injector: builds the provider
+ * chain (Basic + Cookie by default), appends any caller-provided providers
+ * and rebinds {@link HttpAuthenticationSettings}.
  *
- * @param injector  The Injector instance
- * @param settings Settings for HTTP Authentication
+ * Prerequisite: {@link UserStore} and {@link SessionStore} must be bound to
+ * persistent implementations before calling this helper, since the Basic
+ * and Cookie providers need to read users and sessions immediately.
  */
-export declare const useHttpAuthentication: <TUser extends User, TSession extends DefaultSession>(injector: Injector, settings?: Partial<HttpAuthenticationSettings<TUser, TSession>>) => void;
+export declare const useHttpAuthentication: (injector: Injector, overrides?: Partial<HttpAuthenticationSettings>) => void;
 /**
- * Sets up a static file server
- * @param options The settings for the static file server
- * @param options.injector The Injector instance
- * @param options.settings Settings for the static file server
- * @returns a promise that resolves when the server is ready
+ * Attaches a static-file {@link ServerApi} to the pooled HTTP server
+ * identified by `options.port`/`options.hostName`.
  */
 export declare const useStaticFiles: (options: {
     injector: Injector;
-} & StaticServerOptions) => Promise<void>;
+} & StaticServerOptions) => Promise<ServerApi>;
 /**
- * Sets up a proxy server that forwards HTTP requests from a source URL to a target URL.
- *
- * The proxy acts as an intermediary, forwarding requests and responses while allowing
- * transformation of headers, cookies, and paths. It returns 502 Bad Gateway on errors
- * and emits 'onProxyFailed' events for monitoring.
- *
- * WebSocket connections can also be proxied by setting `enableWebsockets: true`, allowing
- * bidirectional real-time communication through the proxy.
- *
- * @param options The settings for the proxy server
- * @param options.injector The Injector instance
- * @param options.sourceBaseUrl The base URL path to match for proxying (e.g., '/api', '/old').
- *                               Can be specified with or without a trailing slash.
- * @param options.targetBaseUrl The target server URL (must be a valid HTTP/HTTPS URL)
- * @param options.pathRewrite Optional function to rewrite the path before forwarding.
- *                            Receives the path after sourceBaseUrl, including leading slash and query string.
- *                            Example: for 'GET /api/users?active=true' with sourceBaseUrl='/api',
- *                            pathRewrite receives '/users?active=true'
- * @param options.sourceHostName The hostname for the source server (optional, defaults to all interfaces)
- * @param options.sourcePort The port for the source server
- * @param options.headers Optional function to transform request headers.
- *                        **Note**: Receives headers AFTER filtering hop-by-hop headers
- *                        (Connection, Keep-Alive, Transfer-Encoding, Upgrade, etc.) for security
- *                        and protocol compliance. The proxy automatically adds X-Forwarded-* headers.
- *                        This transformation applies to both HTTP and WebSocket requests.
- * @param options.cookies Optional function to transform request cookies (array of cookie strings)
- * @param options.responseCookies Optional function to transform response Set-Cookie headers
- * @param options.timeout Optional timeout in milliseconds for proxy requests (default: 30000).
- *                        If exceeded, the request is aborted and 502 is returned.
- *                        Applies to both HTTP and WebSocket upgrade requests.
- * @param options.enableWebsockets Optional flag to enable WebSocket proxying (default: false).
- *                                 When enabled, WebSocket upgrade requests will be forwarded to the target.
- * @returns a promise that resolves when the proxy is set up
- * @example
- * ```ts
- * // Basic HTTP proxy with timeout
- * await useProxy({
- *   injector,
- *   sourceBaseUrl: '/api',
- *   targetBaseUrl: 'https://api.example.com',
- *   sourcePort: 3000,
- *   timeout: 5000,
- * })
- *
- * // Proxy with WebSocket support
- * await useProxy({
- *   injector,
- *   sourceBaseUrl: '/ws',
- *   targetBaseUrl: 'https://ws.example.com',
- *   sourcePort: 3000,
- *   enableWebsockets: true,
- * })
- *
- * // Proxy with error monitoring (HTTP and WebSocket)
- * const proxyManager = injector.getInstance(ProxyManager)
- * proxyManager.subscribe('onProxyFailed', ({ from, to, error }) => {
- *   console.error(`HTTP Proxy failed: ${from} -> ${to}`, error)
- * })
- * proxyManager.subscribe('onWebSocketProxyFailed', ({ from, to, error }) => {
- *   console.error(`WebSocket Proxy failed: ${from} -> ${to}`, error)
- * })
- * ```
+ * Attaches a proxy {@link ServerApi} that forwards HTTP (and optionally
+ * WebSocket) traffic from `options.sourceBaseUrl` to `options.targetBaseUrl`.
+ * Emits `onProxyFailed` and `onWebSocketProxyFailed` events into the shared
+ * {@link ServerTelemetryToken} — subscribe there for observability.
  */
 export declare const useProxy: (options: {
     injector: Injector;
-} & ProxyOptions) => Promise<void>;
+} & ProxyOptions) => Promise<ServerApi>;
 //# sourceMappingURL=helpers.d.ts.map

package/esm/helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAI9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AAM3D,OAAO,EAAE,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AAC9E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAEtD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAA;AAGrE;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAU,CAAC,SAAS,OAAO,EAAE,KAAK,mBAAmB,CAAC,CAAC,CAAC;;;EACpB,CAAA;AAE/D;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,KAAK,SAAS,IAAI,EAAE,QAAQ,SAAS,cAAc,EACvF,UAAU,QAAQ,EAClB,WAAW,OAAO,CAAC,0BAA0B,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC,SAiChE,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,GAAI,SAAS;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAAG,mBAAmB,kBAGnF,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+DG;AACH,eAAO,MAAM,QAAQ,GAAI,SAAS;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAAG,YAAY,kBAGtE,CAAA"}
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAA;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAS9C,OAAO,EAAqC,0BAA0B,EAAE,MAAM,mCAAmC,CAAA;AACjH,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAE3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAC3D,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAC3E,OAAO,EAAgC,KAAK,qBAAqB,EAAqB,MAAM,uBAAuB,CAAA;AAEnH,OAAO,EAA4B,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAG7F;;;;GAIG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,OAAO;IACpD,4CAA4C;IAC5C,GAAG,EAAE,qBAAqB,CAAC,CAAC,CAAC,CAAA;IAC7B,uFAAuF;IACvF,QAAQ,EAAE,QAAQ,CAAA;IAClB,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAA;IACZ,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAA;IACZ,oEAAoE;IACpE,IAAI,CAAC,EAAE,WAAW,CAAA;IAClB,mDAAmD;IACnD,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnE,yEAAyE;IACzE,eAAe,CAAC,EAAE,OAAO,CAAA;IACzB,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,uBAAuB;IACvB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAU,CAAC,SAAS,OAAO,EAAE,SAAS,mBAAmB,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,SAAS,CAwD1G,CAAA;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,QAAQ,EAAE,YAAY,OAAO,CAAC,0BAA0B,CAAC,KAAG,IA+B3G,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAU,SAAS;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAAG,mBAAmB,KAAG,OAAO,CAAC,SAAS,CAO7G,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,GAAU,SAAS;IAAE,QAAQ,EAAE,QAAQ,CAAA;CAAE,GAAG,YAAY,KAAG,OAAO,CAAC,SAAS,CAQhG,CAAA"}

package/esm/helpers.js

@@ -1,119 +1,117 @@
 import { useSystemIdentityContext } from '@furystack/core';
 import { PasswordAuthenticator } from '@furystack/security';
-import { ApiManager } from './api-manager.js';
+import { PathHelper } from '@furystack/utils';
 import { createBasicAuthProvider } from './authentication-providers/basic-auth-provider.js';
 import { createCookieAuthProvider } from './authentication-providers/cookie-auth-provider.js';
 import { authenticateUserWithDataSet, findSessionById, findUserByName } from './authentication-providers/helpers.js';
-import { HttpAuthenticationSettings } from './http-authentication-settings.js';
-import { ProxyManager } from './proxy-manager.js';
-import { StaticServerManager } from './static-server-manager.js';
+import { CreateGetOpenApiDocumentAction } from './endpoint-generators/create-get-openapi-document-action.js';
+import { CreateGetSchemaAction } from './endpoint-generators/create-get-schema-action.js';
+import { defaultHttpAuthenticationSettings, HttpAuthenticationSettings } from './http-authentication-settings.js';
+import { HttpServerPoolToken } from './http-server-pool.js';
+import { HttpUserContext } from './http-user-context.js';
+import { buildProxyServerApi } from './proxy-runtime.js';
+import { compileApi, onRestApiMessage, shouldExecRequest } from './rest-api-runtime.js';
+import { ServerTelemetryToken } from './server-telemetry.js';
+import { buildStaticSiteServerApi } from './static-site-runtime.js';
 /**
- * Sets up the @furystack/rest-service with the provided settings
- * @param api The API implementation details
- * @returns a promise that resolves when the API is added to the server
+ * Acquires a pooled HTTP server (creating one if needed), compiles `api`
+ * and attaches a {@link ServerApi} that dispatches matching requests.
+ * Multiple `useRestService` calls on the same `port` + `hostName` share a
+ * single underlying HTTP server.
  */
-export const useRestService = async (api) => await api.injector.getInstance(ApiManager).addApi({ ...api });
+export const useRestService = async (options) => {
+    const { injector, api, hostName, port, root, cors, deserializeQueryParams, enableGetSchema, name, description, version, } = options;
+    const extendedApi = enableGetSchema
+        ? {
+            ...api,
+            GET: {
+                ...api.GET,
+                '/schema': CreateGetSchemaAction(api, name, description, version),
+                '/openapi.json': CreateGetOpenApiDocumentAction(api, name, description, version),
+            },
+        }
+        : api;
+    const supportedMethods = Object.keys(extendedApi);
+    const rootApiPath = PathHelper.normalize(root);
+    const compiledApi = compileApi(extendedApi, root);
+    const serverApi = {
+        shouldExec: ({ req }) => shouldExecRequest({
+            method: req.method?.toUpperCase(),
+            url: PathHelper.normalize(req.url || ''),
+            rootApiPath,
+            supportedMethods,
+        }),
+        onRequest: (msg) => onRestApiMessage({
+            ...msg,
+            compiledApi,
+            rootApiPath,
+            port,
+            supportedMethods,
+            cors,
+            injector,
+            hostName,
+            deserializeQueryParams,
+        }),
+    };
+    const pool = injector.get(HttpServerPoolToken);
+    const record = await pool.acquire({ port, hostName });
+    record.apis.push(serverApi);
+    return serverApi;
+};
 /**
- * Sets up the HTTP Authentication with pluggable providers.
- *
- * Registers Basic Auth (if enabled) and Cookie Auth as built-in providers,
- * then appends any custom providers passed via settings.
+ * Installs HTTP authentication on the given injector: builds the provider
+ * chain (Basic + Cookie by default), appends any caller-provided providers
+ * and rebinds {@link HttpAuthenticationSettings}.
  *
- * @param injector  The Injector instance
- * @param settings Settings for HTTP Authentication
+ * Prerequisite: {@link UserStore} and {@link SessionStore} must be bound to
+ * persistent implementations before calling this helper, since the Basic
+ * and Cookie providers need to read users and sessions immediately.
  */
-export const useHttpAuthentication = (injector, settings) => {
-    const mergedSettings = Object.assign(new HttpAuthenticationSettings(), settings);
+export const useHttpAuthentication = (injector, overrides) => {
+    const mergedSettings = {
+        ...defaultHttpAuthenticationSettings(),
+        ...overrides,
+    };
     const systemInjector = useSystemIdentityContext({ injector, username: 'useHttpAuthentication' });
-    const passwordAuthenticator = injector.getInstance(PasswordAuthenticator);
-    const userDataSet = mergedSettings.getUserDataSet(systemInjector);
-    const sessionDataSet = mergedSettings.getSessionDataSet(systemInjector);
+    const passwordAuthenticator = injector.get(PasswordAuthenticator);
+    const userDataSet = systemInjector.get(mergedSettings.userDataSet);
+    const sessionDataSet = systemInjector.get(mergedSettings.sessionDataSet);
     const providers = [];
     if (mergedSettings.enableBasicAuth) {
         providers.push(createBasicAuthProvider((username, password) => authenticateUserWithDataSet(passwordAuthenticator, userDataSet, systemInjector, username, password)));
     }
     providers.push(createCookieAuthProvider(mergedSettings.cookieName, (sessionId) => findSessionById(sessionDataSet, systemInjector, sessionId), (username) => findUserByName(userDataSet, systemInjector, username)));
-    providers.push(...(settings?.authenticationProviders ?? []));
+    providers.push(...(overrides?.authenticationProviders ?? []));
     mergedSettings.authenticationProviders = providers;
-    injector.setExplicitInstance(mergedSettings, HttpAuthenticationSettings);
+    injector.bind(HttpAuthenticationSettings, () => mergedSettings);
+    injector.invalidate(HttpAuthenticationSettings);
+    injector.invalidate(HttpUserContext);
 };
 /**
- * Sets up a static file server
- * @param options The settings for the static file server
- * @param options.injector The Injector instance
- * @param options.settings Settings for the static file server
- * @returns a promise that resolves when the server is ready
+ * Attaches a static-file {@link ServerApi} to the pooled HTTP server
+ * identified by `options.port`/`options.hostName`.
  */
-export const useStaticFiles = (options) => {
+export const useStaticFiles = async (options) => {
     const { injector, ...settings } = options;
-    return injector.getInstance(StaticServerManager).addStaticSite(settings);
+    const pool = injector.get(HttpServerPoolToken);
+    const record = await pool.acquire({ port: settings.port, hostName: settings.hostName });
+    const serverApi = buildStaticSiteServerApi(settings);
+    record.apis.push(serverApi);
+    return serverApi;
 };
 /**
- * Sets up a proxy server that forwards HTTP requests from a source URL to a target URL.
- *
- * The proxy acts as an intermediary, forwarding requests and responses while allowing
- * transformation of headers, cookies, and paths. It returns 502 Bad Gateway on errors
- * and emits 'onProxyFailed' events for monitoring.
- *
- * WebSocket connections can also be proxied by setting `enableWebsockets: true`, allowing
- * bidirectional real-time communication through the proxy.
- *
- * @param options The settings for the proxy server
- * @param options.injector The Injector instance
- * @param options.sourceBaseUrl The base URL path to match for proxying (e.g., '/api', '/old').
- *                               Can be specified with or without a trailing slash.
- * @param options.targetBaseUrl The target server URL (must be a valid HTTP/HTTPS URL)
- * @param options.pathRewrite Optional function to rewrite the path before forwarding.
- *                            Receives the path after sourceBaseUrl, including leading slash and query string.
- *                            Example: for 'GET /api/users?active=true' with sourceBaseUrl='/api',
- *                            pathRewrite receives '/users?active=true'
- * @param options.sourceHostName The hostname for the source server (optional, defaults to all interfaces)
- * @param options.sourcePort The port for the source server
- * @param options.headers Optional function to transform request headers.
- *                        **Note**: Receives headers AFTER filtering hop-by-hop headers
- *                        (Connection, Keep-Alive, Transfer-Encoding, Upgrade, etc.) for security
- *                        and protocol compliance. The proxy automatically adds X-Forwarded-* headers.
- *                        This transformation applies to both HTTP and WebSocket requests.
- * @param options.cookies Optional function to transform request cookies (array of cookie strings)
- * @param options.responseCookies Optional function to transform response Set-Cookie headers
- * @param options.timeout Optional timeout in milliseconds for proxy requests (default: 30000).
- *                        If exceeded, the request is aborted and 502 is returned.
- *                        Applies to both HTTP and WebSocket upgrade requests.
- * @param options.enableWebsockets Optional flag to enable WebSocket proxying (default: false).
- *                                 When enabled, WebSocket upgrade requests will be forwarded to the target.
- * @returns a promise that resolves when the proxy is set up
- * @example
- * ```ts
- * // Basic HTTP proxy with timeout
- * await useProxy({
- *   injector,
- *   sourceBaseUrl: '/api',
- *   targetBaseUrl: 'https://api.example.com',
- *   sourcePort: 3000,
- *   timeout: 5000,
- * })
- *
- * // Proxy with WebSocket support
- * await useProxy({
- *   injector,
- *   sourceBaseUrl: '/ws',
- *   targetBaseUrl: 'https://ws.example.com',
- *   sourcePort: 3000,
- *   enableWebsockets: true,
- * })
- *
- * // Proxy with error monitoring (HTTP and WebSocket)
- * const proxyManager = injector.getInstance(ProxyManager)
- * proxyManager.subscribe('onProxyFailed', ({ from, to, error }) => {
- *   console.error(`HTTP Proxy failed: ${from} -> ${to}`, error)
- * })
- * proxyManager.subscribe('onWebSocketProxyFailed', ({ from, to, error }) => {
- *   console.error(`WebSocket Proxy failed: ${from} -> ${to}`, error)
- * })
- * ```
+ * Attaches a proxy {@link ServerApi} that forwards HTTP (and optionally
+ * WebSocket) traffic from `options.sourceBaseUrl` to `options.targetBaseUrl`.
+ * Emits `onProxyFailed` and `onWebSocketProxyFailed` events into the shared
+ * {@link ServerTelemetryToken} — subscribe there for observability.
  */
-export const useProxy = (options) => {
+export const useProxy = async (options) => {
     const { injector, ...settings } = options;
-    return injector.getInstance(ProxyManager).addProxy(settings);
+    const telemetry = injector.get(ServerTelemetryToken);
+    const pool = injector.get(HttpServerPoolToken);
+    const record = await pool.acquire({ port: settings.sourcePort, hostName: settings.sourceHostName });
+    const serverApi = buildProxyServerApi(settings, telemetry);
+    record.apis.push(serverApi);
+    return serverApi;
 };
 //# sourceMappingURL=helpers.js.map

package/esm/helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../src/helpers.ts"],"names":[],"mappings":"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"}

package/esm/helpers.spec.d.ts

@@ -1,2 +1,3 @@
-export {};
+import type { User } from '@furystack/core';
+export type { User };
 //# sourceMappingURL=helpers.spec.d.ts.map

package/esm/helpers.spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helpers.spec.d.ts","sourceRoot":"","sources":["../src/helpers.spec.ts"],"names":[],"mappings":""}
+{"version":3,"file":"helpers.spec.d.ts","sourceRoot":"","sources":["../src/helpers.spec.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AA4G3C,YAAY,EAAE,IAAI,EAAE,CAAA"}