@nwire/apollo 0.10.1 → 0.11.0

package/dist/apollo-interop.d.ts

@@ -44,7 +44,7 @@
  * one-liner that says "this GraphQL field is implemented by this Nwire
  * action" — same migration story Express got.
  */
-import type { ActionDefinition, ForgeApp } from "@nwire/forge";
+import type { ActionDefinition, ForgeDispatcher } from "@nwire/forge";
 import { type MessageEnvelope } from "@nwire/envelope";
 import type { ApolloServerOptions, BaseContext } from "@apollo/server";
 import type { GraphQLFormattedError } from "graphql";
@@ -55,7 +55,7 @@ import type { GraphQLFormattedError } from "graphql";
  */
 export interface NwireApolloContext extends BaseContext {
     /** The Nwire app to dispatch actions through. */
-    readonly app: ForgeApp;
+    readonly dispatcher: ForgeDispatcher;
     /**
      * The fresh envelope seeded for this GraphQL request. Resolvers can
      * dispatch through `runtime` and the envelope will be derived as a
@@ -87,11 +87,11 @@ export interface ActionResolverOptions<TContext extends BaseContext = NwireApoll
     readonly extractInput?: (args: Record<string, unknown>, context: TContext) => unknown;
     readonly extractEnvelope?: (context: TContext) => MessageEnvelope;
     /**
-     * How to find the app. Defaults to `context.app`. Provide this if
-     * your context shape names the app differently or pulls it from a
-     * DI container.
+     * How to find the dispatcher. Defaults to `context.dispatcher`. Provide
+     * this if your context names it differently or pulls it from a DI
+     * container.
      */
-    readonly resolveApp?: (context: TContext) => ForgeApp;
+    readonly resolveDispatcher?: (context: TContext) => ForgeDispatcher;
 }
 /**
  * Wrap a Nwire `ActionDefinition` as a GraphQL field resolver.
@@ -141,7 +141,7 @@ export declare function actionResolver<TContext extends NwireApolloContext = Nwi
  * type usable in any integration without a forced cast.
  */
 export interface NwireApolloContextOptions<TArgs = unknown> {
-    readonly app: ForgeApp;
+    readonly dispatcher: ForgeDispatcher;
     /**
      * Build a request-scoped envelope. The integration arg (`req`, headers,
      * etc.) is available so caller can read auth headers. Defaults to a
@@ -176,7 +176,7 @@ export declare function nwireApolloContext<TArgs = unknown>(options: NwireApollo
  *     `startStandaloneServer` / `expressMiddleware` as appropriate.
  */
 export interface MountNwireOptions<TArgs = unknown> {
-    readonly app: ForgeApp;
+    readonly dispatcher: ForgeDispatcher;
     readonly extractEnvelope?: (args: TArgs) => MessageEnvelope;
     readonly extractUser?: (args: TArgs) => unknown;
 }

package/dist/apollo-interop.js

@@ -77,34 +77,34 @@ export function actionResolver(action, options = {}) {
         // to the whole args object so query-style resolvers (where each arg
         // is named separately) work without configuration.
         "input" in args ? args.input : args);
-    const resolveApp = options.resolveApp ?? ((ctx) => ctx.app);
+    const resolveDispatcher = options.resolveDispatcher ?? ((ctx) => ctx.dispatcher);
     const extractEnvelope = options.extractEnvelope ??
         ((ctx) => 
         // If `nwireApolloContext` is used the envelope is already on the
         // context; otherwise fall back to seeding one from the loose user
-        // field. Either way `runtime.dispatch` derives a child envelope for
-        // the actual action, so this just sets the root of the chain.
+        // field. Either way the dispatcher derives a child envelope for the
+        // actual action, so this just sets the root of the chain.
         ctx.envelope ?? seedEnvelope({ user: ctx.user }));
     return async (_parent, args, context) => {
-        const app = resolveApp(context);
+        const dispatcher = resolveDispatcher(context);
         const envelope = extractEnvelope(context);
         const input = extractInput(args, context);
-        return app.dispatch(action, input, envelope);
+        return dispatcher.dispatch(action, input, envelope);
     };
 }
 export function nwireApolloContext(options) {
-    const { app, extractEnvelope, extractUser } = options;
+    const { dispatcher, extractEnvelope, extractUser } = options;
     return async (args) => {
         const user = extractUser?.(args);
         const envelope = extractEnvelope?.(args) ?? seedEnvelope(user !== undefined ? { user } : {});
-        return { app, envelope, user };
+        return { dispatcher, envelope, user };
     };
 }
 export function mountNwireOnApollo(options) {
     return {
         formatError: formatNwireError,
         context: nwireApolloContext({
-            app: options.app,
+            dispatcher: options.dispatcher,
             extractEnvelope: options.extractEnvelope,
             extractUser: options.extractUser,
         }),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nwire/apollo",
-  "version": "0.10.1",
+  "version": "0.11.0",
   "description": "Nwire — Apollo Server (v4) interop adapter. actionResolver(action) plugs a Nwire ActionDefinition into a GraphQL schema as a field resolver; nwireApolloContext({ runtime }) adds runtime.dispatch + envelope to Apollo's per-request context; mountNwireOnApollo() registers Nwire-aware error mapping (defineError -> extensions.code). Opt-in, peer dep, ~60 LOC of real code.",
   "keywords": [
     "adapter",
@@ -28,8 +28,8 @@
     "access": "public"
   },
   "dependencies": {
-    "@nwire/envelope": "0.10.1",
-    "@nwire/forge": "0.10.1"
+    "@nwire/forge": "0.11.0",
+    "@nwire/envelope": "0.11.0"
   },
   "devDependencies": {
     "@apollo/server": "^4.11.0",