@btravstack/graphql-server 0.30.0 → 0.31.0

package/README.md

@@ -6,9 +6,34 @@ A GraphQL Yoga answerer for the protocol-neutral
 server dependency. `graphql(defineAuth(), { schema })` contributes a
 `HttpHandler` member. A request-scoped unit and the Node incoming request are
 available to resolvers.
+Use `GraphqlModule` for a deployment root:
+
+```ts
+import { GraphqlModule, graphql } from "@btravstack/graphql-server";
+import { defineAuth } from "@btravstack/http-server";
+import { createSchema } from "graphql-yoga";
+
+const schema = createSchema({
+  typeDefs: "type Query { hello: String! }",
+  resolvers: { Query: { hello: () => "world" } },
+});
+
+export const GatewayApi = GraphqlModule("GatewayApi")({
+  answerer: graphql(defineAuth(), { schema }),
+});
+```
+
+The module composes the listener, authenticators and declared request modules.
+It exports the runtime ports and available `Logger` / `HealthChecks` without
+exposing business ports automatically. Its socket options are the HTTP
+runtime's, excluding `cors` and `compression`. Set CORS on `graphql()`; the
+answerer does not apply HTTP compression. Schema, authentication and Yoga
+options stay on `graphql()`.
+
 Pass `units` with `unit` to check each injected port against the module the
-selected request kind actually forks. Pass the same `units` record to
-`httpServer({ unit: units })` so the runtime can apply unit test overrides.
+selected request kind actually forks. `GraphqlModule` binds that record to
+the runtime automatically; a manually composed root passes the same `units`
+record to `httpServer({ unit: units })`.
 Yoga plugins and CORS policy are explicit
 options; the wildcard CORS default and Yoga console logging are disabled, and
 a masked defect is reported to `Observers` instead. GraphiQL,

package/dist/index.cjs

@@ -5,6 +5,7 @@ let _btravstack_core = require("@btravstack/core");
 let _btravstack_di = require("@btravstack/di");
 let _btravstack_http_server_internal = require("@btravstack/http-server/internal");
 let unthrown = require("unthrown");
+let _btravstack_http_server = require("@btravstack/http-server");
 //#region src/field.ts
 /**
 * A resolver's answer from a `Result`, so a modeled failure is never thrown by
@@ -158,8 +159,33 @@ const graphql = (api, options) => {
 		}),
 		onStop: (answerer) => answerer[dispose]()
 	});
-	return Object.assign(typed, { authenticators: api.providers });
+	return Object.assign(typed, {
+		authenticators: api.providers,
+		units: options.units
+	});
+};
+//#endregion
+//#region src/graphql-module.ts
+/** Declare a GraphQL HTTP application without repeating runtime or authenticator wiring. */
+const GraphqlModule = (name) => (options) => {
+	const starter = (0, _btravstack_http_server.httpServer)({
+		...options,
+		unit: options.answerer.units
+	});
+	const imports = [...options.imports ?? [], starter];
+	const provides = [
+		options.answerer,
+		...options.answerer.authenticators,
+		...options.provides ?? []
+	];
+	return (0, _btravstack_di.Module)(name)({
+		imports,
+		provides,
+		exports: [...(0, _btravstack_http_server_internal.applicationExports)(imports, provides), ...options.exports ?? []],
+		needs: [...options.needs ?? [], _btravstack_config.Env]
+	});
 };
 //#endregion
+exports.GraphqlModule = GraphqlModule;
 exports.fieldResult = fieldResult;
 exports.graphql = graphql;

package/dist/index.d.cts

@@ -1,12 +1,13 @@
 import { GraphQLError, GraphQLSchema } from "graphql";
 import { AsyncResult, Result } from "unthrown";
 import { IncomingMessage } from "node:http";
-import { ConfigInvalid, EnvReading } from "@btravstack/config";
+import { ConfigInvalid, Env, EnvReading } from "@btravstack/config";
 import { OneScheme, Requirements } from "@btravstack/contract";
 import { Observers } from "@btravstack/core";
-import { AnyPort, Provider, Scope } from "@btravstack/di";
-import { Authenticators, HttpAuth, HttpConfig, HttpHandler, HttpUnit, KindOf, Kinds, Principal, RequiresGate, SchemePortsOf, SchemesFrom, SchemesOf, UnitFor, UnitsNeedsOf, UnitsOf } from "@btravstack/http-server/internal";
+import { AnyModule, AnyPort, AnyProvider, Exportable, Module, NeedsGate, Provider, Scope } from "@btravstack/di";
+import { AnyUnitModule, Authenticators, CookieSchemes, HttpAuth, HttpConfig, HttpHandler, HttpServerEnv, HttpUnit, KindOf, Kinds, Principal, RequiresGate, SchemePortsOf, SchemesFrom, SchemesOf, UnitFor, UnitsNeedsOf, UnitsOf } from "@btravstack/http-server/internal";
 import { Plugin, YogaInitialContext, YogaServerOptions } from "graphql-yoga";
+import { HttpConfig as HttpConfig$1, HttpHandler as HttpHandler$1, HttpOptions, HttpRuntime } from "@btravstack/http-server";
 //#region src/field.d.ts
 /**
  * A resolver's answer from a `Result`, so a modeled failure is never thrown by
@@ -90,6 +91,31 @@ type GraphqlOptions<A extends Authenticators, Units extends UnitsOf<A>, R extend
 };
 export declare const graphql: <A extends Authenticators, Units extends UnitsOf<A> = Record<never, never>, const R extends Requirements & { readonly [I in keyof R]: OneScheme<R[I]>; } = never, U extends Readonly<Record<string, AnyPort>> = Record<never, never>, const PS extends readonly unknown[] = []>(api: HttpAuth<A>, options: GraphqlOptions<A, Units, R, U, PS>) => Provider<HttpHandler, ConfigInvalid, HttpConfig | HttpUnit | Observers | Scope | SchemePortsOf<R> | UnitsNeedsOf<Units> | EnvReading<never, "GRAPHQL_DEVELOPER_TOOLS" | "GRAPHQL_MAX_TOKENS">> & {
   authenticators: readonly import("@btravstack/http-server/internal").SchemeProviders<A>[];
+  units: (Units & { readonly [K in Exclude<keyof Units, Kinds<A>>]: never; }) | undefined;
 };
 //#endregion
+//#region src/graphql-module.d.ts
+type AnyAnswerer = Provider<InstanceType<typeof HttpHandler$1>, unknown, unknown> & {
+  readonly authenticators: readonly AnyProvider[];
+  readonly units: Readonly<Record<string, AnyUnitModule>> | undefined;
+};
+type UnitsOf$1<A> = A extends {
+  readonly units: infer U;
+} ? U : never;
+type AuthOf<A> = A extends {
+  readonly authenticators: readonly (infer P)[];
+} ? P : never;
+type HttpStarter<Units> = Module<HttpRuntime | HttpConfig$1 | InstanceType<typeof HttpHandler$1> | HttpUnit | CookieSchemes | Observers, ConfigInvalid, HttpServerEnv | UnitsNeedsOf<Units>>;
+type Imports<I extends readonly AnyModule[], A> = readonly [...I, HttpStarter<UnitsOf$1<A>>];
+type Provides<P extends readonly AnyProvider[], A> = readonly (A | AuthOf<A> | P[number])[];
+type EnvAnd<N extends readonly AnyPort[]> = readonly [...N, typeof Env];
+/** Declare a GraphQL HTTP application without repeating runtime or authenticator wiring. */
+export declare const GraphqlModule: <const Name extends string>(name: Name) => <A extends AnyAnswerer, const I extends readonly AnyModule[] = [], const P extends readonly AnyProvider[] = [], const X extends readonly Exportable<Imports<I, A>, Provides<P, A>>[] = [], const N extends readonly AnyPort[] = []>(options: Omit<HttpOptions, "unit" | "cors" | "compression"> & {
+  readonly answerer: A;
+  readonly imports?: I;
+  readonly provides?: P;
+  readonly exports?: X;
+  readonly needs?: N;
+} & NeedsGate<Imports<I, A>, Provides<P, A>, EnvAnd<N>>) => Module<(Extract<(readonly [...(typeof HttpHandler$1 | typeof HttpRuntime | (import("@btravstack/core").HealthChecks extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number], AnyModule> extends (infer T_3) ? T_3 extends Extract<(readonly [...(typeof HttpHandler$1 | typeof HttpRuntime | (import("@btravstack/core").HealthChecks extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number], AnyModule> ? T_3 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((readonly [...(typeof HttpHandler$1 | typeof HttpRuntime | (import("@btravstack/core").HealthChecks extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number] extends (infer E_1) ? E_1 extends AnyPort ? InstanceType<E_1> : E_1 extends AnyProvider ? InstanceType<E_1["port"]> : never : never), ((A extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never) | (P[number] extends (infer T_4) ? T_4 extends P[number] ? T_4 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never) | (AuthOf<A> extends (infer T_5) ? T_5 extends AuthOf<A> ? T_5 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never))[1] | ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T_6) ? T_6 extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T_6 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[1], Exclude<((A extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never) | (P[number] extends (infer T_7) ? T_7 extends P[number] ? T_7 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never) | (AuthOf<A> extends (infer T_8) ? T_8 extends AuthOf<A> ? T_8 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never))[2], ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T_9) ? T_9 extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T_9 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((A extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never) | (P[number] extends (infer T_7) ? T_7 extends P[number] ? T_7 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never) | (AuthOf<A> extends (infer T_8) ? T_8 extends AuthOf<A> ? T_8 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never))[0]> | Exclude<((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T_9) ? T_9 extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T_9 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[2], ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T_9) ? T_9 extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T_9 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((A extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never) | (P[number] extends (infer T_7) ? T_7 extends P[number] ? T_7 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never) | (AuthOf<A> extends (infer T_8) ? T_8 extends AuthOf<A> ? T_8 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never))[0]>>;
+//#endregion
 export type { GraphqlContext, GraphqlOptions };

package/dist/index.d.mts

@@ -1,9 +1,10 @@
 import { Plugin, YogaInitialContext, YogaServerOptions } from "graphql-yoga";
-import { ConfigInvalid, EnvReading } from "@btravstack/config";
+import { ConfigInvalid, Env, EnvReading } from "@btravstack/config";
 import { Observers } from "@btravstack/core";
-import { AnyPort, Provider, Scope } from "@btravstack/di";
-import { Authenticators, HttpAuth, HttpConfig, HttpHandler, HttpUnit, KindOf, Kinds, Principal, RequiresGate, SchemePortsOf, SchemesFrom, SchemesOf, UnitFor, UnitsNeedsOf, UnitsOf } from "@btravstack/http-server/internal";
+import { AnyModule, AnyPort, AnyProvider, Exportable, Module, NeedsGate, Provider, Scope } from "@btravstack/di";
+import { AnyUnitModule, Authenticators, CookieSchemes, HttpAuth, HttpConfig, HttpHandler, HttpServerEnv, HttpUnit, KindOf, Kinds, Principal, RequiresGate, SchemePortsOf, SchemesFrom, SchemesOf, UnitFor, UnitsNeedsOf, UnitsOf } from "@btravstack/http-server/internal";
 import { AsyncResult, Result } from "unthrown";
+import { HttpConfig as HttpConfig$1, HttpHandler as HttpHandler$1, HttpOptions, HttpRuntime } from "@btravstack/http-server";
 import { GraphQLError, GraphQLSchema } from "graphql";
 import { IncomingMessage } from "node:http";
 import { OneScheme, Requirements } from "@btravstack/contract";
@@ -90,6 +91,31 @@ type GraphqlOptions<A extends Authenticators, Units extends UnitsOf<A>, R extend
 };
 export declare const graphql: <A extends Authenticators, Units extends UnitsOf<A> = Record<never, never>, const R extends Requirements & { readonly [I in keyof R]: OneScheme<R[I]>; } = never, U extends Readonly<Record<string, AnyPort>> = Record<never, never>, const PS extends readonly unknown[] = []>(api: HttpAuth<A>, options: GraphqlOptions<A, Units, R, U, PS>) => Provider<HttpHandler, ConfigInvalid, HttpConfig | HttpUnit | Observers | Scope | SchemePortsOf<R> | UnitsNeedsOf<Units> | EnvReading<never, "GRAPHQL_DEVELOPER_TOOLS" | "GRAPHQL_MAX_TOKENS">> & {
   authenticators: readonly import("@btravstack/http-server/internal").SchemeProviders<A>[];
+  units: (Units & { readonly [K in Exclude<keyof Units, Kinds<A>>]: never; }) | undefined;
 };
 //#endregion
+//#region src/graphql-module.d.ts
+type AnyAnswerer = Provider<InstanceType<typeof HttpHandler$1>, unknown, unknown> & {
+  readonly authenticators: readonly AnyProvider[];
+  readonly units: Readonly<Record<string, AnyUnitModule>> | undefined;
+};
+type UnitsOf$1<A> = A extends {
+  readonly units: infer U;
+} ? U : never;
+type AuthOf<A> = A extends {
+  readonly authenticators: readonly (infer P)[];
+} ? P : never;
+type HttpStarter<Units> = Module<HttpRuntime | HttpConfig$1 | InstanceType<typeof HttpHandler$1> | HttpUnit | CookieSchemes | Observers, ConfigInvalid, HttpServerEnv | UnitsNeedsOf<Units>>;
+type Imports<I extends readonly AnyModule[], A> = readonly [...I, HttpStarter<UnitsOf$1<A>>];
+type Provides<P extends readonly AnyProvider[], A> = readonly (A | AuthOf<A> | P[number])[];
+type EnvAnd<N extends readonly AnyPort[]> = readonly [...N, typeof Env];
+/** Declare a GraphQL HTTP application without repeating runtime or authenticator wiring. */
+export declare const GraphqlModule: <const Name extends string>(name: Name) => <A extends AnyAnswerer, const I extends readonly AnyModule[] = [], const P extends readonly AnyProvider[] = [], const X extends readonly Exportable<Imports<I, A>, Provides<P, A>>[] = [], const N extends readonly AnyPort[] = []>(options: Omit<HttpOptions, "unit" | "cors" | "compression"> & {
+  readonly answerer: A;
+  readonly imports?: I;
+  readonly provides?: P;
+  readonly exports?: X;
+  readonly needs?: N;
+} & NeedsGate<Imports<I, A>, Provides<P, A>, EnvAnd<N>>) => Module<(Extract<(readonly [...(typeof HttpHandler$1 | typeof HttpRuntime | (import("@btravstack/core").HealthChecks extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number], AnyModule> extends (infer T_3) ? T_3 extends Extract<(readonly [...(typeof HttpHandler$1 | typeof HttpRuntime | (import("@btravstack/core").HealthChecks extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number], AnyModule> ? T_3 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((readonly [...(typeof HttpHandler$1 | typeof HttpRuntime | (import("@btravstack/core").HealthChecks extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T) ? T extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | (A extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never) | (P[number] extends (infer T_1) ? T_1 extends P[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) | (AuthOf<A> extends (infer T_2) ? T_2 extends AuthOf<A> ? T_2 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number] extends (infer E_1) ? E_1 extends AnyPort ? InstanceType<E_1> : E_1 extends AnyProvider ? InstanceType<E_1["port"]> : never : never), ((A extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never) | (P[number] extends (infer T_4) ? T_4 extends P[number] ? T_4 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never) | (AuthOf<A> extends (infer T_5) ? T_5 extends AuthOf<A> ? T_5 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never))[1] | ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T_6) ? T_6 extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T_6 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[1], Exclude<((A extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never) | (P[number] extends (infer T_7) ? T_7 extends P[number] ? T_7 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never) | (AuthOf<A> extends (infer T_8) ? T_8 extends AuthOf<A> ? T_8 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never))[2], ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T_9) ? T_9 extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T_9 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((A extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never) | (P[number] extends (infer T_7) ? T_7 extends P[number] ? T_7 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never) | (AuthOf<A> extends (infer T_8) ? T_8 extends AuthOf<A> ? T_8 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never))[0]> | Exclude<((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T_9) ? T_9 extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T_9 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[2], ((readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] extends (infer T_9) ? T_9 extends (readonly [...I, HttpStarter<UnitsOf$1<A>>])[number] ? T_9 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((A extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never) | (P[number] extends (infer T_7) ? T_7 extends P[number] ? T_7 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never) | (AuthOf<A> extends (infer T_8) ? T_8 extends AuthOf<A> ? T_8 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never))[0]>>;
+//#endregion
 export type { GraphqlContext, GraphqlOptions };

package/dist/index.mjs

@@ -1,9 +1,10 @@
 import { createGraphQLError, createYoga, handleStreamOrSingleExecutionResult, maskError } from "graphql-yoga";
 import { Config, Env } from "@btravstack/config";
 import { Observers, observe } from "@btravstack/core";
-import { Provider } from "@btravstack/di";
-import { HttpConfig, HttpHandler, HttpUnit, forkUnit, principalOf, resolveScheme, schemeDeps, schemeServices } from "@btravstack/http-server/internal";
+import { Module, Provider } from "@btravstack/di";
+import { HttpConfig, HttpHandler, HttpUnit, applicationExports, forkUnit, principalOf, resolveScheme, schemeDeps, schemeServices } from "@btravstack/http-server/internal";
 import { P } from "unthrown";
+import { httpServer } from "@btravstack/http-server";
 //#region src/field.ts
 /**
 * A resolver's answer from a `Result`, so a modeled failure is never thrown by
@@ -157,7 +158,31 @@ const graphql = (api, options) => {
 		}),
 		onStop: (answerer) => answerer[dispose]()
 	});
-	return Object.assign(typed, { authenticators: api.providers });
+	return Object.assign(typed, {
+		authenticators: api.providers,
+		units: options.units
+	});
+};
+//#endregion
+//#region src/graphql-module.ts
+/** Declare a GraphQL HTTP application without repeating runtime or authenticator wiring. */
+const GraphqlModule = (name) => (options) => {
+	const starter = httpServer({
+		...options,
+		unit: options.answerer.units
+	});
+	const imports = [...options.imports ?? [], starter];
+	const provides = [
+		options.answerer,
+		...options.answerer.authenticators,
+		...options.provides ?? []
+	];
+	return Module(name)({
+		imports,
+		provides,
+		exports: [...applicationExports(imports, provides), ...options.exports ?? []],
+		needs: [...options.needs ?? [], Env]
+	});
 };
 //#endregion
-export { fieldResult, graphql };
+export { GraphqlModule, fieldResult, graphql };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/graphql-server",
-  "version": "0.30.0",
+  "version": "0.31.0",
   "description": "The GraphQL Yoga answerer for @btravstack/http-server",
   "keywords": [
     "graphql",
@@ -41,29 +41,29 @@
     "./package.json": "./package.json"
   },
   "devDependencies": {
-    "@btravstack/config": "0.30.0",
-    "@btravstack/contract": "0.30.0",
-    "@btravstack/core": "0.30.0",
-    "@btravstack/di": "0.30.0",
-    "@btravstack/http-server": "0.30.0",
+    "@btravstack/config": "0.31.0",
+    "@btravstack/contract": "0.31.0",
+    "@btravstack/core": "0.31.0",
+    "@btravstack/di": "0.31.0",
+    "@btravstack/http-server": "0.31.0",
     "@btravstack/tsconfig": "0.4.0",
     "@types/node": "26.6.4",
-    "@unthrown/vitest": "5.12.0",
+    "@unthrown/vitest": "5.12.1",
     "@vitest/coverage-v8": "5.0.3",
     "graphql": "17.0.2",
     "graphql-yoga": "5.24.1",
     "tsdown": "0.23.0",
     "typescript": "7.0.2",
     "typescript-consumer": "npm:typescript@5.9.3",
-    "unthrown": "5.12.0",
+    "unthrown": "5.12.1",
     "vitest": "5.0.3"
   },
   "peerDependencies": {
-    "@btravstack/config": "^0.30.0",
-    "@btravstack/contract": "^0.30.0",
-    "@btravstack/core": "^0.30.0",
-    "@btravstack/di": "^0.30.0",
-    "@btravstack/http-server": "^0.30.0",
+    "@btravstack/config": "^0.31.0",
+    "@btravstack/contract": "^0.31.0",
+    "@btravstack/core": "^0.31.0",
+    "@btravstack/di": "^0.31.0",
+    "@btravstack/http-server": "^0.31.0",
     "graphql": "^16.6.0 || ^17.0.0",
     "graphql-yoga": "^5.24.1",
     "unthrown": "^5.7.0"