nuxt-graphql-middleware 4.2.0 → 4.3.0

package/dist/runtime/composables/useAsyncGraphqlQuery.js

@@ -1,6 +1,12 @@
+import {
+  encodeContext
+} from "./../helpers/composables.js";
 import { isRef, unref } from "vue";
 import { buildRequestParams } from "./../helpers/index.js";
 import { performRequest } from "./nuxtApp.js";
+import {
+  clientOptions
+} from "#graphql-middleware-client-options";
 import { useAsyncData, useAppConfig, useNuxtApp } from "#imports";
 import { hash } from "ohash";
 export function useAsyncGraphqlQuery(name, ...args) {
@@ -28,16 +34,26 @@ export function useAsyncGraphqlQuery(name, ...args) {
   }
   return useAsyncData(
     key,
-    () => performRequest(
-      "query",
-      name,
-      "get",
-      {
-        params: buildRequestParams(unref(variables)),
-        ...fetchOptions
-      },
-      asyncDataOptions.graphqlCaching
-    ),
+    () => {
+      const globalClientContext = clientOptions.buildClientContext ? clientOptions.buildClientContext() : {};
+      return performRequest(
+        "query",
+        name,
+        "get",
+        {
+          ...fetchOptions,
+          params: {
+            ...fetchOptions?.params || {},
+            ...buildRequestParams(unref(variables)),
+            ...encodeContext({
+              ...globalClientContext,
+              ...asyncDataOptions.clientContext || {}
+            })
+          }
+        },
+        asyncDataOptions.graphqlCaching
+      );
+    },
     asyncDataOptions
   );
 }

package/dist/runtime/composables/useGraphqlMutation.d.ts

@@ -1,5 +1,5 @@
-import { type GraphqlMiddlewareMutationName, type GetMutationArgs, type MutationObjectArgs, type GetMutationResult } from './shared.js';
-import type { GraphqlMiddlewareMutation } from '#build/nuxt-graphql-middleware';
+import { type GraphqlMiddlewareMutationName, type GetMutationArgs, type MutationObjectArgs, type GetMutationResult } from './../helpers/composables.js';
+import type { GraphqlMiddlewareMutation } from '#nuxt-graphql-middleware/generated-types';
 import type { GraphqlResponse } from '#graphql-middleware-server-options-build';
 /**
  * Performs a GraphQL mutation.

package/dist/runtime/composables/useGraphqlMutation.js

@@ -1,8 +1,25 @@
+import {
+  encodeContext
+} from "./../helpers/composables.js";
 import { performRequest } from "./nuxtApp.js";
+import { clientOptions } from "#graphql-middleware-client-options";
 export function useGraphqlMutation(...args) {
-  const [name, body, fetchOptions = {}] = typeof args[0] === "string" ? [args[0], args[1], args[2]?.fetchOptions] : [args[0].name, args[0].variables, args[0].fetchOptions];
+  const [name, body, fetchOptions = {}, overrideClientContext = {}] = typeof args[0] === "string" ? [args[0], args[1], args[2]?.fetchOptions, args[2]?.clientContext] : [
+    args[0].name,
+    args[0].variables,
+    args[0].fetchOptions,
+    args[0].clientContext
+  ];
+  const globalClientContext = clientOptions.buildClientContext ? clientOptions.buildClientContext() : {};
   return performRequest("mutation", name, "post", {
+    ...fetchOptions,
     body,
-    ...fetchOptions
+    params: {
+      ...fetchOptions.params || {},
+      ...encodeContext({
+        ...globalClientContext,
+        ...overrideClientContext
+      })
+    }
   });
 }

package/dist/runtime/composables/useGraphqlQuery.d.ts

@@ -1,5 +1,5 @@
-import { type GraphqlMiddlewareQueryName, type GetQueryArgs, type QueryObjectArgs, type GetQueryResult } from './shared.js';
-import type { GraphqlMiddlewareQuery } from '#build/nuxt-graphql-middleware';
+import { type GraphqlMiddlewareQueryName, type GetQueryArgs, type QueryObjectArgs, type GetQueryResult } from './../helpers/composables.js';
+import type { GraphqlMiddlewareQuery } from '#nuxt-graphql-middleware/generated-types';
 import type { GraphqlResponse } from '#graphql-middleware-server-options-build';
 /**
  * Performs a GraphQL query.

package/dist/runtime/composables/useGraphqlQuery.js

@@ -1,19 +1,44 @@
+import {
+  encodeContext
+} from "./../helpers/composables.js";
 import { buildRequestParams } from "./../helpers/index.js";
 import { performRequest } from "./nuxtApp.js";
+import { clientOptions } from "#graphql-middleware-client-options";
 export function useGraphqlQuery(...args) {
-  const [name, variables, fetchOptions = {}, graphqlCaching = {}] = typeof args[0] === "string" ? [args[0], args[1], args[2]?.fetchOptions, args[2]?.graphqlCaching] : [
+  const [
+    name,
+    variables,
+    fetchOptions = {},
+    graphqlCaching = {},
+    overrideClientContext = {}
+  ] = typeof args[0] === "string" ? [
+    args[0],
+    args[1],
+    args[2]?.fetchOptions,
+    args[2]?.graphqlCaching,
+    args[2]?.clientContext
+  ] : [
     args[0].name,
     args[0].variables,
     args[0].fetchOptions,
-    args[0].graphqlCaching
+    args[0].graphqlCaching,
+    args[0].clientContext
   ];
+  const globalClientContext = clientOptions.buildClientContext ? clientOptions.buildClientContext() : {};
   return performRequest(
     "query",
     name,
     "get",
     {
-      params: buildRequestParams(variables),
-      ...fetchOptions
+      ...fetchOptions,
+      params: {
+        ...fetchOptions.params || {},
+        ...buildRequestParams(variables),
+        ...encodeContext({
+          ...globalClientContext,
+          ...overrideClientContext
+        })
+      }
     },
     graphqlCaching
   );

package/dist/runtime/composables/useGraphqlUploadMutation.d.ts

@@ -1,5 +1,5 @@
-import { type GraphqlMiddlewareMutationName, type GetMutationArgs, type MutationObjectArgs, type GetMutationResult } from './shared.js';
-import type { GraphqlMiddlewareMutation } from '#build/nuxt-graphql-middleware';
+import { type GraphqlMiddlewareMutationName, type GetMutationArgs, type MutationObjectArgs, type GetMutationResult } from './../helpers/composables.js';
+import type { GraphqlMiddlewareMutation } from '#nuxt-graphql-middleware/generated-types';
 import type { GraphqlResponse } from '#graphql-middleware-server-options-build';
 /**
  * Performs a GraphQL upload mutation.

package/dist/runtime/composables/useGraphqlUploadMutation.js

@@ -1,6 +1,8 @@
 import {
-  getEndpoint
-} from "./shared.js";
+  getEndpoint,
+  encodeContext
+} from "./../helpers/composables.js";
+import { clientOptions } from "#graphql-middleware-client-options";
 import { useGraphqlState } from "#imports";
 function createFormData(variables) {
   const formData = new FormData();
@@ -34,7 +36,12 @@ function createFormData(variables) {
   return formData;
 }
 export function useGraphqlUploadMutation(...args) {
-  const [name, variables, fetchOptions = {}] = typeof args[0] === "string" ? [args[0], args[1]] : [args[0].name, args[0].variables, args[0].fetchOptions];
+  const [name, variables, fetchOptions = {}, overrideClientContext = {}] = typeof args[0] === "string" ? [args[0], args[1], args[2]?.fetchOptions, args[2]?.clientContext] : [
+    args[0].name,
+    args[0].variables,
+    args[0].fetchOptions,
+    args[0].clientContext
+  ];
   if (!variables) {
     throw new Error(
       'Using "useGraphqlUploadMutation" without variables is not supported.'
@@ -42,9 +49,18 @@ export function useGraphqlUploadMutation(...args) {
   }
   const state = useGraphqlState();
   const formData = createFormData(variables);
+  const globalClientContext = clientOptions.buildClientContext ? clientOptions.buildClientContext() : {};
+  const clientContext = encodeContext({
+    ...globalClientContext,
+    ...overrideClientContext
+  });
   return $fetch(getEndpoint("upload", name), {
     ...state && state.fetchOptions ? state.fetchOptions : {},
     ...fetchOptions || {},
+    params: {
+      ...clientContext,
+      ...fetchOptions.params || {}
+    },
     method: "POST",
     body: formData
   }).then((v) => {

package/dist/runtime/{composables/shared.d.ts → helpers/composables.d.ts}

@@ -1,11 +1,13 @@
 import type { FetchOptions } from 'ofetch';
-import type { GraphqlMiddlewareQuery, GraphqlMiddlewareMutation } from '#build/nuxt-graphql-middleware';
+import type { GraphqlMiddlewareQuery, GraphqlMiddlewareMutation } from '#nuxt-graphql-middleware/generated-types';
 import type { RequestCacheOptions } from '#graphql-middleware/types';
+import type { GraphqlClientContext } from '#graphql-middleware-client-options';
 export type GraphqlMiddlewareQueryName = keyof GraphqlMiddlewareQuery;
 export type GraphqlMiddlewareMutationName = keyof GraphqlMiddlewareMutation;
 export type GraphqlComposableOptions = {
     fetchOptions?: FetchOptions;
     graphqlCaching?: RequestCacheOptions;
+    clientContext?: Partial<GraphqlClientContext>;
 };
 export type GetQueryArgs<T extends GraphqlMiddlewareQueryName, M extends GraphqlMiddlewareQuery> = M[T][0] extends null ? [T, (null | undefined)?, GraphqlComposableOptions?] : M[T][1] extends false ? [T, M[T][0], GraphqlComposableOptions?] : [T, M[T][0]?, GraphqlComposableOptions?];
 export type GetMutationArgs<T extends GraphqlMiddlewareMutationName, M extends GraphqlMiddlewareMutation> = M[T][0] extends null ? [T, (null | undefined)?, GraphqlComposableOptions?] : M[T][1] extends false ? [T, M[T][0], GraphqlComposableOptions?] : [T, M[T][0]?, GraphqlComposableOptions?];
@@ -16,21 +18,26 @@ export type QueryObjectArgs<T extends GraphqlMiddlewareQueryName, M extends Grap
     name: T;
     fetchOptions?: FetchOptions;
     graphqlCaching?: RequestCacheOptions;
+    clientContext?: Partial<GraphqlClientContext>;
     variables?: null;
 } : {
     name: T;
     variables: M[T][0];
     fetchOptions?: FetchOptions;
     graphqlCaching?: RequestCacheOptions;
+    clientContext?: Partial<GraphqlClientContext>;
 };
 export type MutationObjectArgs<T extends GraphqlMiddlewareMutationName, M extends GraphqlMiddlewareMutation> = M[T][0] extends null ? {
     name: T;
     variables?: null;
     fetchOptions?: FetchOptions;
+    clientContext?: Partial<GraphqlClientContext>;
 } : {
     name: T;
     variables: M[T][0];
     fetchOptions?: FetchOptions;
+    clientContext?: Partial<GraphqlClientContext>;
 };
 export type PickFrom<T, K extends Array<string>> = T extends Array<any> ? T : T extends Record<string, any> ? keyof T extends K[number] ? T : K[number] extends never ? T : Pick<T, K[number]> : T;
 export type KeysOf<T> = Array<T extends T ? (keyof T extends string ? keyof T : never) : never>;
+export declare function encodeContext(context: Record<string, string | null | undefined>): Record<string, string>;

package/dist/runtime/helpers/composables.js

@@ -0,0 +1,17 @@
+import { useRuntimeConfig } from "#imports";
+import { CLIENT_CONTEXT_PREFIX } from "../settings/index.js";
+export function getEndpoint(operation, operationName) {
+  const config = useRuntimeConfig();
+  return `${config?.public?.["nuxt-graphql-middleware"]?.serverApiPrefix}/${operation}/${operationName}`;
+}
+export function encodeContext(context) {
+  return Object.entries(context).reduce(
+    (acc, [key, value]) => {
+      if (typeof value === "string") {
+        acc[CLIENT_CONTEXT_PREFIX + key] = value;
+      }
+      return acc;
+    },
+    {}
+  );
+}

package/dist/runtime/server/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "../../../.nuxt/tsconfig.server.json"
+}

package/dist/runtime/server/utils/index.d.ts

@@ -0,0 +1,3 @@
+import type { FetchOptions } from 'ofetch';
+import type { GraphqlResponse } from '#graphql-middleware-server-options-build';
+export declare function performRequest<T>(operation: string, operationName: string, method: 'get' | 'post', options: FetchOptions): Promise<GraphqlResponse<T>>;

package/dist/runtime/server/utils/index.js

@@ -0,0 +1,12 @@
+import { getEndpoint } from "./../../helpers/composables.js";
+export function performRequest(operation, operationName, method, options) {
+  return $fetch(getEndpoint(operation, operationName), {
+    ...options,
+    method
+  }).then((v) => {
+    return {
+      data: v.data,
+      errors: v.errors || []
+    };
+  });
+}

package/dist/runtime/server/utils/useGraphqlMutation.d.ts

@@ -0,0 +1,7 @@
+import type { GraphqlResponse } from '#graphql-middleware-server-options-build';
+import { type GraphqlMiddlewareMutationName, type GetMutationArgs, type MutationObjectArgs, type GetMutationResult } from './../../helpers/composables.js';
+import type { GraphqlMiddlewareMutation } from '#nuxt-graphql-middleware/generated-types';
+/**
+ * Performs a GraphQL mutation.
+ */
+export declare function useGraphqlMutation<T extends GraphqlMiddlewareMutationName, R extends GetMutationResult<T, GraphqlMiddlewareMutation>>(...args: GetMutationArgs<T, GraphqlMiddlewareMutation> | [MutationObjectArgs<T, GraphqlMiddlewareMutation>]): Promise<GraphqlResponse<R>>;

package/dist/runtime/server/utils/useGraphqlMutation.js

@@ -0,0 +1,20 @@
+import {
+  encodeContext
+} from "./../../helpers/composables.js";
+import { performRequest } from "./index.js";
+export function useGraphqlMutation(...args) {
+  const [name, body, fetchOptions = {}, clientContext = {}] = typeof args[0] === "string" ? [args[0], args[1], args[2]?.fetchOptions, args[2]?.clientContext] : [
+    args[0].name,
+    args[0].variables,
+    args[0].fetchOptions,
+    args[0].clientContext
+  ];
+  return performRequest("mutation", name, "post", {
+    ...fetchOptions,
+    body,
+    params: {
+      ...encodeContext(clientContext),
+      ...fetchOptions.params || {}
+    }
+  });
+}

package/dist/runtime/server/utils/useGraphqlQuery.d.ts

@@ -0,0 +1,7 @@
+import type { GraphqlResponse } from '#graphql-middleware-server-options-build';
+import { type GraphqlMiddlewareQueryName, type GetQueryArgs, type QueryObjectArgs, type GetQueryResult } from './../../helpers/composables.js';
+import type { GraphqlMiddlewareQuery } from '#nuxt-graphql-middleware/generated-types';
+/**
+ * Performs a GraphQL query.
+ */
+export declare function useGraphqlQuery<T extends GraphqlMiddlewareQueryName, R extends GetQueryResult<T, GraphqlMiddlewareQuery>>(...args: GetQueryArgs<T, GraphqlMiddlewareQuery> | [QueryObjectArgs<T, GraphqlMiddlewareQuery>]): Promise<GraphqlResponse<R>>;

package/dist/runtime/server/utils/useGraphqlQuery.js

@@ -0,0 +1,21 @@
+import {
+  encodeContext
+} from "./../../helpers/composables.js";
+import { buildRequestParams } from "./../../helpers/index.js";
+import { performRequest } from "./index.js";
+export function useGraphqlQuery(...args) {
+  const [name, variables, fetchOptions = {}, clientContext = {}] = typeof args[0] === "string" ? [args[0], args[1], args[2]?.fetchOptions, args[2]?.clientContext] : [
+    args[0].name,
+    args[0].variables,
+    args[0].fetchOptions,
+    args[0].clientContext
+  ];
+  return performRequest("query", name, "get", {
+    ...fetchOptions,
+    params: {
+      ...fetchOptions.params || {},
+      ...buildRequestParams(variables),
+      ...encodeContext(clientContext)
+    }
+  });
+}

package/dist/runtime/serverHandler/helpers/index.d.ts

@@ -1,18 +1,22 @@
 import { type QueryObject } from 'ufo';
 import type { H3Event } from 'h3';
 import type { FetchOptions, FetchResponse, FetchError } from 'ofetch';
-import type { GraphqlMiddlewareRuntimeConfig, GraphqlMiddlewareServerOptions } from './../../../types.js';
+import type { GraphqlMiddlewareRequestContext, GraphqlMiddlewareRuntimeConfig, GraphqlMiddlewareServerOptions } from './../../../types.js';
 import { GraphqlMiddlewareOperation } from './../../settings/index.js';
 import { type Documents } from '#graphql-documents';
 export declare function queryParamToVariables(query: QueryObject): any;
+/**
+ * Extract the client context from the query params.
+ */
+export declare function extractRequestContext(query: QueryObject): GraphqlMiddlewareRequestContext<any>;
 /**
  * Get the URL of the GraphQL endpoint.
  */
-export declare function getEndpoint(config: GraphqlMiddlewareRuntimeConfig, serverOptions: GraphqlMiddlewareServerOptions, event: H3Event, operation: GraphqlMiddlewareOperation, operationName: string): string | Promise<string>;
+export declare function getEndpoint(config: GraphqlMiddlewareRuntimeConfig, serverOptions: GraphqlMiddlewareServerOptions<any, any>, event: H3Event, operation: GraphqlMiddlewareOperation, operationName: string, context: GraphqlMiddlewareRequestContext<any>): string | Promise<string>;
 /**
  * Get the options for the $fetch request to the GraphQL server.
  */
-export declare function getFetchOptions(serverOptions: GraphqlMiddlewareServerOptions, event: H3Event, operation: GraphqlMiddlewareOperation, operationName: string): FetchOptions | Promise<FetchOptions>;
+export declare function getFetchOptions(serverOptions: GraphqlMiddlewareServerOptions<any, any>, event: H3Event, operation: GraphqlMiddlewareOperation, operationName: string, context: GraphqlMiddlewareRequestContext<any>): FetchOptions | Promise<FetchOptions>;
 export declare function throwError(statusMessage: string, statusCode?: number): never;
 /**
  * Assure that the request is valid.
@@ -21,8 +25,8 @@ export declare function validateRequest(method?: string, operation?: GraphqlMidd
 /**
  * Handle GraphQL server response.
  */
-export declare function onServerResponse(serverOptions: GraphqlMiddlewareServerOptions, event: H3Event, response: FetchResponse<any>, operation?: string, operationName?: string): any;
+export declare function onServerResponse(serverOptions: GraphqlMiddlewareServerOptions<any, any>, event: H3Event, response: FetchResponse<any>, operation: string, operationName: string, context: GraphqlMiddlewareRequestContext<any>): any;
 /**
  * Handle GraphQL server errors.
  */
-export declare function onServerError(serverOptions: GraphqlMiddlewareServerOptions, event: H3Event, error: FetchError, operation?: string, operationName?: string): any;
+export declare function onServerError(serverOptions: GraphqlMiddlewareServerOptions<any, any>, event: H3Event, error: FetchError, operation: string, operationName: string, context: GraphqlMiddlewareRequestContext<any>): any;

package/dist/runtime/serverHandler/helpers/index.js

@@ -1,5 +1,8 @@
 import { createError } from "h3";
-import { GraphqlMiddlewareOperation } from "./../../settings/index.js";
+import {
+  CLIENT_CONTEXT_PREFIX,
+  GraphqlMiddlewareOperation
+} from "./../../settings/index.js";
 export function queryParamToVariables(query) {
   try {
     if (query.__variables && typeof query.__variables === "string") {
@@ -9,12 +12,28 @@ export function queryParamToVariables(query) {
   }
   return query;
 }
-export function getEndpoint(config, serverOptions, event, operation, operationName) {
+export function extractRequestContext(query) {
+  const client = {};
+  for (const property in query) {
+    if (property.startsWith(CLIENT_CONTEXT_PREFIX)) {
+      const value = query[property];
+      if (typeof value === "string") {
+        const key = property.replace(CLIENT_CONTEXT_PREFIX, "");
+        client[key] = value;
+      }
+    }
+  }
+  return {
+    client
+  };
+}
+export function getEndpoint(config, serverOptions, event, operation, operationName, context) {
   if (serverOptions.graphqlEndpoint) {
     const result = serverOptions.graphqlEndpoint(
       event,
       operation,
-      operationName
+      operationName,
+      context
     );
     if (result) {
       return Promise.resolve(result);
@@ -25,9 +44,14 @@ export function getEndpoint(config, serverOptions, event, operation, operationNa
   }
   throw new Error("Failed to determine endpoint for GraphQL server.");
 }
-export function getFetchOptions(serverOptions, event, operation, operationName) {
+export function getFetchOptions(serverOptions, event, operation, operationName, context) {
   if (serverOptions.serverFetchOptions) {
-    return serverOptions.serverFetchOptions(event, operation, operationName) || {};
+    return serverOptions.serverFetchOptions(
+      event,
+      operation,
+      operationName,
+      context
+    ) || {};
   }
   return {};
 }
@@ -60,20 +84,27 @@ export function validateRequest(method, operation, name, documents) {
     throwError(`Operation "${operation}" with name "${name}" not found.`);
   }
 }
-export function onServerResponse(serverOptions, event, response, operation, operationName) {
+export function onServerResponse(serverOptions, event, response, operation, operationName, context) {
   if (serverOptions.onServerResponse) {
     return serverOptions.onServerResponse(
       event,
       response,
       operation,
-      operationName
+      operationName,
+      context
     );
   }
   return response._data;
 }
-export function onServerError(serverOptions, event, error, operation, operationName) {
+export function onServerError(serverOptions, event, error, operation, operationName, context) {
   if (serverOptions.onServerError) {
-    return serverOptions.onServerError(event, error, operation, operationName);
+    return serverOptions.onServerError(
+      event,
+      error,
+      operation,
+      operationName,
+      context
+    );
   }
   const message = error && "message" in error ? error.message : "";
   throw createError({

package/dist/runtime/serverHandler/index.js

@@ -5,7 +5,8 @@ import {
   getFetchOptions,
   validateRequest,
   onServerResponse,
-  onServerError
+  onServerError,
+  extractRequestContext
 } from "./helpers/index.js";
 import { GraphqlMiddlewareOperation } from "./../settings/index.js";
 import { documents } from "#graphql-documents";
@@ -17,14 +18,17 @@ export default defineEventHandler(async (event) => {
   const operationName = event.context?.params?.name;
   validateRequest(method, operation, operationName, documents);
   const operationDocument = documents[operation][operationName];
-  const variables = operation === GraphqlMiddlewareOperation.Query ? queryParamToVariables(getQuery(event)) : await readBody(event);
+  const queryParams = getQuery(event);
+  const context = extractRequestContext(queryParams);
+  const variables = operation === GraphqlMiddlewareOperation.Query ? queryParamToVariables(queryParams) : await readBody(event);
   if (serverOptions.doGraphqlRequest) {
     return serverOptions.doGraphqlRequest({
       event,
       operation,
       operationName,
       operationDocument,
-      variables
+      variables,
+      context
     });
   }
   const runtimeConfig = useRuntimeConfig().graphqlMiddleware;
@@ -33,13 +37,15 @@ export default defineEventHandler(async (event) => {
     serverOptions,
     event,
     operation,
-    operationName
+    operationName,
+    context
   );
   const fetchOptions = await getFetchOptions(
     serverOptions,
     event,
     operation,
-    operationName
+    operationName,
+    context
   );
   return $fetch.raw(endpoint, {
     // @todo: Remove any once https://github.com/unjs/nitro/pull/883 is released.
@@ -56,7 +62,8 @@ export default defineEventHandler(async (event) => {
       event,
       response,
       operation,
-      operationName
+      operationName,
+      context
     );
   }).catch((error) => {
     return onServerError(
@@ -64,7 +71,8 @@ export default defineEventHandler(async (event) => {
       event,
       error,
       operation,
-      operationName
+      operationName,
+      context
     );
   });
 });

package/dist/runtime/serverHandler/upload.js

@@ -1,6 +1,7 @@
 import {
   defineEventHandler,
-  readMultipartFormData
+  readMultipartFormData,
+  getQuery
 } from "h3";
 import {
   getEndpoint,
@@ -8,7 +9,8 @@ import {
   validateRequest,
   onServerResponse,
   onServerError,
-  throwError
+  throwError,
+  extractRequestContext
 } from "./helpers/index.js";
 import { GraphqlMiddlewareOperation } from "./../settings/index.js";
 import { documents } from "#graphql-documents";
@@ -52,6 +54,8 @@ export default defineEventHandler(async (event) => {
     const blob = new Blob([file.data]);
     formData.append(file.name, blob, file.filename);
   }
+  const queryParams = getQuery(event);
+  const context = extractRequestContext(queryParams);
   if (serverOptions.doGraphqlRequest) {
     return serverOptions.doGraphqlRequest({
       event,
@@ -59,7 +63,8 @@ export default defineEventHandler(async (event) => {
       operationName,
       operationDocument,
       variables,
-      formData
+      formData,
+      context
     });
   }
   const runtimeConfig = useRuntimeConfig().graphqlMiddleware;
@@ -68,13 +73,15 @@ export default defineEventHandler(async (event) => {
     serverOptions,
     event,
     operation,
-    operationName
+    operationName,
+    context
   );
   const fetchOptions = await getFetchOptions(
     serverOptions,
     event,
     operation,
-    operationName
+    operationName,
+    context
   );
   return $fetch.raw(endpoint, {
     ...fetchOptions,
@@ -86,7 +93,8 @@ export default defineEventHandler(async (event) => {
       event,
       response,
       operation,
-      operationName
+      operationName,
+      context
     );
   }).catch((error) => {
     return onServerError(
@@ -94,7 +102,8 @@ export default defineEventHandler(async (event) => {
       event,
       error,
       operation,
-      operationName
+      operationName,
+      context
     );
   });
 });

package/dist/runtime/serverOptions/defineGraphqlServerOptions.d.ts

@@ -1,2 +1,3 @@
+import type { GraphqlClientContext } from '#graphql-middleware-client-options';
 import { type GraphqlMiddlewareServerOptions } from './../../types.js';
-export declare function defineGraphqlServerOptions<T extends object>(options: GraphqlMiddlewareServerOptions<T>): GraphqlMiddlewareServerOptions<T>;
+export declare function defineGraphqlServerOptions<T extends object>(options: GraphqlMiddlewareServerOptions<T, GraphqlClientContext>): GraphqlMiddlewareServerOptions<T, GraphqlClientContext>;

package/dist/runtime/settings/index.d.ts

@@ -6,7 +6,7 @@ export declare enum GraphqlMiddlewareTemplate {
     /**
      * Signature for the GraphQL composable arguments and return types.
      */
-    ComposableContext = "nuxt-graphql-middleware.d.ts",
+    ComposableContext = "nuxt-graphql-middleware/generated-types.d.ts",
     /**
      * Exports a single opject containing the compiled queries and mutations.
      */
@@ -16,3 +16,4 @@ export declare enum GraphqlMiddlewareOperation {
     Query = "query",
     Mutation = "mutation"
 }
+export declare const CLIENT_CONTEXT_PREFIX = "__gqlc_";

package/dist/runtime/settings/index.js

@@ -1,6 +1,6 @@
 export var GraphqlMiddlewareTemplate = /* @__PURE__ */ ((GraphqlMiddlewareTemplate2) => {
   GraphqlMiddlewareTemplate2["OperationTypes"] = "graphql-operations.d.ts";
-  GraphqlMiddlewareTemplate2["ComposableContext"] = "nuxt-graphql-middleware.d.ts";
+  GraphqlMiddlewareTemplate2["ComposableContext"] = "nuxt-graphql-middleware/generated-types.d.ts";
   GraphqlMiddlewareTemplate2["Documents"] = "graphql-documents.mjs";
   return GraphqlMiddlewareTemplate2;
 })(GraphqlMiddlewareTemplate || {});
@@ -9,3 +9,4 @@ export var GraphqlMiddlewareOperation = /* @__PURE__ */ ((GraphqlMiddlewareOpera
   GraphqlMiddlewareOperation2["Mutation"] = "mutation";
   return GraphqlMiddlewareOperation2;
 })(GraphqlMiddlewareOperation || {});
+export const CLIENT_CONTEXT_PREFIX = "__gqlc_";