@nexus_js/graphql 0.9.3

package/dist/remote-executor.d.ts

@@ -0,0 +1,126 @@
+/**
+ * @nexus_js/graphql - Remote GraphQL Executor
+ *
+ * Proxy to external GraphQL APIs with Nexus Shield integration.
+ * Use this to migrate legacy backends gradually by fronting them with Nexus security.
+ */
+import type { GraphQLSchema } from 'graphql';
+export interface RemoteExecutorOptions {
+    /**
+     * URL of the remote GraphQL endpoint.
+     * @example 'https://legacy-api.example.com/graphql'
+     */
+    url: string;
+    /**
+     * Optional headers to include in every request.
+     * Use for API keys or service-to-service auth.
+     * @example { 'x-api-key': process.env.LEGACY_API_KEY }
+     */
+    headers?: Record<string, string>;
+    /**
+     * Timeout for remote requests in milliseconds.
+     * @default 10000 (10 seconds)
+     */
+    timeoutMs?: number;
+    /**
+     * Whether to forward Authorization header from incoming request.
+     * @default false
+     */
+    forwardAuth?: boolean;
+    /**
+     * Transform outgoing variables before sending to remote.
+     * Use to rename fields or inject context.
+     */
+    transformVariables?: (variables: Record<string, unknown>) => Record<string, unknown>;
+    /**
+     * Transform incoming result after receiving from remote.
+     * Use to adapt legacy response format to Nexus conventions.
+     */
+    transformResult?: (result: unknown) => unknown;
+    /**
+     * Enable batching multiple operations into a single HTTP request.
+     * @default false
+     */
+    batch?: boolean;
+    /**
+     * Retry failed requests (network errors, 5xx).
+     * @default { attempts: 2, delayMs: 500 }
+     */
+    retry?: {
+        attempts: number;
+        delayMs: number;
+    };
+}
+export interface RemoteExecutionContext {
+    /**
+     * Nexus context from the incoming request.
+     */
+    nexusContext?: Record<string, unknown>;
+    /**
+     * Custom headers to merge with executor defaults.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Override timeout for this specific request.
+     */
+    timeoutMs?: number;
+}
+export interface RemoteExecutionResult<T = unknown> {
+    data?: T;
+    errors?: Array<{
+        message: string;
+        locations?: Array<{
+            line: number;
+            column: number;
+        }>;
+        path?: Array<string | number>;
+        extensions?: Record<string, unknown>;
+    }>;
+}
+/**
+ * Create a remote GraphQL executor that acts as a proxy to a legacy backend.
+ *
+ * Nexus Shield and rate limiting are applied BEFORE forwarding the request.
+ * This lets you add security to an insecure legacy API without modifying it.
+ *
+ * @example
+ * ```ts
+ * import { createRemoteExecutor } from '@nexus_js/graphql';
+ *
+ * const legacyApi = createRemoteExecutor({
+ *   url: 'https://old-api.company.com/graphql',
+ *   headers: { 'x-service-token': vault.get('LEGACY_TOKEN') },
+ *   timeoutMs: 5000,
+ *   forwardAuth: true,
+ * });
+ *
+ * // In resolver:
+ * const result = await legacyApi(
+ *   'query GetUser($id: ID!) { user(id: $id) { name email } }',
+ *   { id: '123' },
+ *   { nexusContext: ctx }
+ * );
+ * ```
+ */
+export declare function createRemoteExecutor(opts: RemoteExecutorOptions): <T = unknown>(query: string, variables?: Record<string, unknown>, context?: RemoteExecutionContext) => Promise<RemoteExecutionResult<T>>;
+/**
+ * Create a remote executor with introspection to fetch the remote schema.
+ * Useful for GraphQL schema stitching (federation).
+ *
+ * @example
+ * ```ts
+ * const { executor, schema } = await createRemoteExecutorWithSchema({
+ *   url: 'https://legacy.example.com/graphql',
+ * });
+ *
+ * // Use `schema` for stitching or merging with Nexus schema
+ * const stitchedSchema = stitchSchemas({
+ *   subschemas: [{ schema, executor }],
+ * });
+ * ```
+ */
+export declare function createRemoteExecutorWithSchema(opts: RemoteExecutorOptions): Promise<{
+    executor: ReturnType<typeof createRemoteExecutor>;
+    schema: GraphQLSchema | null;
+}>;
+//# sourceMappingURL=remote-executor.d.ts.map

package/dist/remote-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-executor.d.ts","sourceRoot":"","sources":["../src/remote-executor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,GAAG,EAAE,MAAM,CAAC;IAEZ;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,kBAAkB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAErF;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;IAE/C;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,KAAK,CAAC,EAAE;QACN,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED,MAAM,WAAW,sBAAsB;IACrC;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEjC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC,GAAG,OAAO;IAChD,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpD,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;QAC9B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC,CAAC;CACJ;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,qBAAqB,IA+IhC,CAAC,GAAG,OAAO,EACvC,OAAO,MAAM,EACb,YAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACvC,UAAU,sBAAsB,KAC/B,OAAO,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAMrC;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,8BAA8B,CAAC,IAAI,EAAE,qBAAqB,GAAG,OAAO,CAAC;IACzF,QAAQ,EAAE,UAAU,CAAC,OAAO,oBAAoB,CAAC,CAAC;IAClD,MAAM,EAAE,aAAa,GAAG,IAAI,CAAC;CAC9B,CAAC,CAiHD"}

package/dist/remote-executor.js

@@ -0,0 +1,270 @@
+/**
+ * @nexus_js/graphql - Remote GraphQL Executor
+ *
+ * Proxy to external GraphQL APIs with Nexus Shield integration.
+ * Use this to migrate legacy backends gradually by fronting them with Nexus security.
+ */
+/**
+ * Create a remote GraphQL executor that acts as a proxy to a legacy backend.
+ *
+ * Nexus Shield and rate limiting are applied BEFORE forwarding the request.
+ * This lets you add security to an insecure legacy API without modifying it.
+ *
+ * @example
+ * ```ts
+ * import { createRemoteExecutor } from '@nexus_js/graphql';
+ *
+ * const legacyApi = createRemoteExecutor({
+ *   url: 'https://old-api.company.com/graphql',
+ *   headers: { 'x-service-token': vault.get('LEGACY_TOKEN') },
+ *   timeoutMs: 5000,
+ *   forwardAuth: true,
+ * });
+ *
+ * // In resolver:
+ * const result = await legacyApi(
+ *   'query GetUser($id: ID!) { user(id: $id) { name email } }',
+ *   { id: '123' },
+ *   { nexusContext: ctx }
+ * );
+ * ```
+ */
+export function createRemoteExecutor(opts) {
+    const { url, headers: defaultHeaders = {}, timeoutMs: defaultTimeout = 10_000, forwardAuth = false, transformVariables, transformResult, batch = false, retry = { attempts: 2, delayMs: 500 }, } = opts;
+    // Batch queue for combining operations
+    let batchQueue = [];
+    let batchTimer = null;
+    async function executeSingle(query, variables, context) {
+        const finalVariables = transformVariables ? transformVariables(variables) : variables;
+        const timeout = context?.timeoutMs ?? defaultTimeout;
+        const reqHeaders = {
+            'Content-Type': 'application/json',
+            ...defaultHeaders,
+            ...(context?.headers ?? {}),
+        };
+        // Forward Authorization if configured
+        if (forwardAuth && context?.nexusContext) {
+            const authHeader = context.nexusContext?.request
+                ?.headers;
+            if (authHeader) {
+                const auth = authHeader.get('authorization');
+                if (auth)
+                    reqHeaders['authorization'] = auth;
+            }
+        }
+        const body = JSON.stringify({ query, variables: finalVariables });
+        let lastError = null;
+        for (let attempt = 0; attempt < retry.attempts; attempt++) {
+            try {
+                const controller = new AbortController();
+                const timeoutId = setTimeout(() => controller.abort(), timeout);
+                const response = await fetch(url, {
+                    method: 'POST',
+                    headers: reqHeaders,
+                    body,
+                    signal: controller.signal,
+                });
+                clearTimeout(timeoutId);
+                if (!response.ok) {
+                    // Retry on 5xx
+                    if (response.status >= 500 && attempt < retry.attempts - 1) {
+                        await new Promise((r) => setTimeout(r, retry.delayMs));
+                        continue;
+                    }
+                    throw new Error(`Remote GraphQL returned ${response.status}: ${await response.text()}`);
+                }
+                const json = (await response.json());
+                if (transformResult && json.data) {
+                    json.data = transformResult(json.data);
+                }
+                return json;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                // Retry on network errors
+                if (attempt < retry.attempts - 1) {
+                    await new Promise((r) => setTimeout(r, retry.delayMs));
+                }
+            }
+        }
+        throw lastError ?? new Error('Remote execution failed');
+    }
+    async function flushBatch() {
+        if (batchQueue.length === 0)
+            return;
+        const ops = [...batchQueue];
+        batchQueue = [];
+        try {
+            // Build batch request (standard GraphQL batch format: array of { query, variables })
+            const batchBody = ops.map((op) => ({
+                query: op.query,
+                variables: transformVariables ? transformVariables(op.variables) : op.variables,
+            }));
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', ...defaultHeaders },
+                body: JSON.stringify(batchBody),
+            });
+            if (!response.ok) {
+                throw new Error(`Batch request failed: ${response.status}`);
+            }
+            const results = (await response.json());
+            ops.forEach((op, i) => {
+                const result = results[i];
+                if (transformResult && result?.data) {
+                    result.data = transformResult(result.data);
+                }
+                op.resolve(result ?? { errors: [{ message: 'No result from batch' }] });
+            });
+        }
+        catch (err) {
+            ops.forEach((op) => op.reject(err instanceof Error ? err : new Error(String(err))));
+        }
+    }
+    function executeBatched(query, variables) {
+        return new Promise((resolve, reject) => {
+            batchQueue.push({ query, variables, resolve, reject });
+            if (!batchTimer) {
+                batchTimer = setTimeout(() => {
+                    batchTimer = null;
+                    void flushBatch();
+                }, 10); // 10ms batch window
+            }
+        });
+    }
+    return async function execute(query, variables = {}, context) {
+        if (batch && !context) {
+            return executeBatched(query, variables);
+        }
+        return executeSingle(query, variables, context);
+    };
+}
+/**
+ * Create a remote executor with introspection to fetch the remote schema.
+ * Useful for GraphQL schema stitching (federation).
+ *
+ * @example
+ * ```ts
+ * const { executor, schema } = await createRemoteExecutorWithSchema({
+ *   url: 'https://legacy.example.com/graphql',
+ * });
+ *
+ * // Use `schema` for stitching or merging with Nexus schema
+ * const stitchedSchema = stitchSchemas({
+ *   subschemas: [{ schema, executor }],
+ * });
+ * ```
+ */
+export async function createRemoteExecutorWithSchema(opts) {
+    const executor = createRemoteExecutor(opts);
+    // Fetch introspection query
+    const introspectionQuery = `
+    query IntrospectionQuery {
+      __schema {
+        queryType { name }
+        mutationType { name }
+        subscriptionType { name }
+        types {
+          ...FullType
+        }
+        directives {
+          name
+          description
+          locations
+          args {
+            ...InputValue
+          }
+        }
+      }
+    }
+    
+    fragment FullType on __Type {
+      kind
+      name
+      description
+      fields(includeDeprecated: true) {
+        name
+        description
+        args {
+          ...InputValue
+        }
+        type {
+          ...TypeRef
+        }
+        isDeprecated
+        deprecationReason
+      }
+      inputFields {
+        ...InputValue
+      }
+      interfaces {
+        ...TypeRef
+      }
+      enumValues(includeDeprecated: true) {
+        name
+        description
+        isDeprecated
+        deprecationReason
+      }
+      possibleTypes {
+        ...TypeRef
+      }
+    }
+    
+    fragment InputValue on __InputValue {
+      name
+      description
+      type { ...TypeRef }
+      defaultValue
+    }
+    
+    fragment TypeRef on __Type {
+      kind
+      name
+      ofType {
+        kind
+        name
+        ofType {
+          kind
+          name
+          ofType {
+            kind
+            name
+            ofType {
+              kind
+              name
+              ofType {
+                kind
+                name
+                ofType {
+                  kind
+                  name
+                  ofType {
+                    kind
+                    name
+                  }
+                }
+              }
+            }
+          }
+        }
+      }
+    }
+  `;
+    try {
+        const result = await executor(introspectionQuery);
+        if (result.errors) {
+            console.warn('Remote introspection failed:', result.errors);
+            return { executor, schema: null };
+        }
+        // Build schema from introspection result (requires graphql package)
+        // This is a placeholder — full implementation would use buildClientSchema
+        // from 'graphql/utilities' with result.data as IntrospectionQuery
+        return { executor, schema: null }; // TODO: implement buildClientSchema
+    }
+    catch (err) {
+        console.warn('Failed to introspect remote schema:', err);
+        return { executor, schema: null };
+    }
+}
+//# sourceMappingURL=remote-executor.js.map

package/dist/remote-executor.js.map

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

package/dist/stitching.d.ts

@@ -0,0 +1,145 @@
+/**
+ * @nexus_js/graphql - Schema Stitching & Federation
+ *
+ * Merge remote GraphQL schemas (legacy backends) with Nexus-native resolvers.
+ * This lets you gradually migrate by adding new fields to old types.
+ */
+import type { GraphQLSchema, GraphQLFieldResolver } from 'graphql';
+export interface SubschemaConfig {
+    /**
+     * GraphQL schema from remote or local source.
+     */
+    schema: GraphQLSchema;
+    /**
+     * Executor function for resolving fields from this subschema.
+     * For remote schemas, use createRemoteExecutor().
+     */
+    executor?: (opts: {
+        document: string;
+        variables?: Record<string, unknown>;
+        context?: unknown;
+    }) => Promise<{
+        data?: unknown;
+        errors?: unknown[];
+    }>;
+    /**
+     * Transforms to apply to this subschema before merging.
+     */
+    transforms?: Array<{
+        transformSchema?: (schema: GraphQLSchema) => GraphQLSchema;
+        transformRequest?: (request: unknown) => unknown;
+        transformResult?: (result: unknown) => unknown;
+    }>;
+    /**
+     * Batch configuration for this subschema.
+     */
+    batch?: boolean;
+}
+export interface StitchSchemasOptions {
+    /**
+     * Array of subschemas to merge.
+     * Each can be a local Nexus schema or a remote legacy schema.
+     */
+    subschemas: SubschemaConfig[];
+    /**
+     * Type merging configuration.
+     * Allows multiple subschemas to contribute fields to the same type.
+     *
+     * @example
+     * ```ts
+     * typeMerging: {
+     *   User: {
+     *     // If User exists in both schemas, merge their fields
+     *     selectionSet: '{ id }',
+     *     fieldName: 'user',
+     *     args: (obj) => ({ id: obj.id }),
+     *   }
+     * }
+     * ```
+     */
+    typeMerging?: Record<string, {
+        selectionSet: string;
+        fieldName: string;
+        args?: (obj: unknown) => Record<string, unknown>;
+    }>;
+    /**
+     * Resolvers to add or override in the stitched schema.
+     * Use this to add Nexus-specific business logic on top of legacy fields.
+     */
+    resolvers?: Record<string, Record<string, GraphQLFieldResolver<unknown, unknown>>>;
+    /**
+     * Schema directives to add to the stitched schema.
+     */
+    schemaDirectives?: Record<string, unknown>;
+}
+/**
+ * Stitch multiple GraphQL schemas into one unified schema.
+ *
+ * This is the core of Nexus's "Legacy Bridge" feature.
+ * You can combine:
+ * - Remote schemas from old backends (via createRemoteExecutor)
+ * - Local Nexus schemas with Shield/Vault integration
+ * - New resolvers that add security to legacy fields
+ *
+ * @example
+ * ```ts
+ * import { stitchSchemas } from '@nexus_js/graphql';
+ * import { createRemoteExecutor } from '@nexus_js/graphql';
+ *
+ * const legacyExecutor = createRemoteExecutor({
+ *   url: 'https://old-api.example.com/graphql',
+ * });
+ *
+ * const { executor: legacyExec, schema: legacySchema } =
+ *   await createRemoteExecutorWithSchema({ url: '...' });
+ *
+ * const stitched = stitchSchemas({
+ *   subschemas: [
+ *     { schema: legacySchema, executor: legacyExec },
+ *     { schema: nexusSchema },
+ *   ],
+ *   typeMerging: {
+ *     User: {
+ *       selectionSet: '{ id }',
+ *       fieldName: 'user',
+ *       args: (obj) => ({ id: obj.id }),
+ *     }
+ *   },
+ *   resolvers: {
+ *     User: {
+ *       // Add Shield protection to legacy User.apiKey field
+ *       apiKey: async (parent, args, context) => {
+ *         if (context.user?.role !== 'admin') return null;
+ *         return parent.apiKey; // Delegate to legacy
+ *       }
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export declare function stitchSchemas(opts: StitchSchemasOptions): GraphQLSchema;
+/**
+ * Helper to create a "gateway" resolver that delegates to multiple backends.
+ *
+ * Use this when you want Nexus to act as a unified API gateway
+ * that routes requests to different legacy services.
+ *
+ * @example
+ * ```ts
+ * const gateway = createGatewayResolver({
+ *   services: {
+ *     auth: createRemoteExecutor({ url: 'http://auth.internal/graphql' }),
+ *     payments: createRemoteExecutor({ url: 'http://payments.internal/graphql' }),
+ *   },
+ *   routing: {
+ *     'Query.user': 'auth',
+ *     'Query.payment': 'payments',
+ *   }
+ * });
+ * ```
+ */
+export declare function createGatewayResolver(opts: {
+    services: Record<string, ReturnType<typeof import('./remote-executor').createRemoteExecutor>>;
+    routing: Record<string, string>;
+}): GraphQLFieldResolver<unknown, unknown>;
+//# sourceMappingURL=stitching.d.ts.map

package/dist/stitching.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitching.d.ts","sourceRoot":"","sources":["../src/stitching.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,MAAM,EAAE,aAAa,CAAC;IAEtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE;QAChB,QAAQ,EAAE,MAAM,CAAC;QACjB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,KAAK,OAAO,CAAC;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC,CAAC;IAEtD;;OAEG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,aAAa,CAAC;QAC3D,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC;QACjD,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,CAAC;KAChD,CAAC,CAAC;IAEH;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,UAAU,EAAE,eAAe,EAAE,CAAC;IAE9B;;;;;;;;;;;;;;;OAeG;IACH,WAAW,CAAC,EAAE,MAAM,CAClB,MAAM,EACN;QACE,YAAY,EAAE,MAAM,CAAC;QACrB,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAClD,CACF,CAAC;IAEF;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEnF;;OAEG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,oBAAoB,GAAG,aAAa,CAyBvE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,cAAc,mBAAmB,EAAE,oBAAoB,CAAC,CAAC,CAAC;IAC9F,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,GAAG,oBAAoB,CAAC,OAAO,EAAE,OAAO,CAAC,CA0BzC"}

package/dist/stitching.js

@@ -0,0 +1,111 @@
+/**
+ * @nexus_js/graphql - Schema Stitching & Federation
+ *
+ * Merge remote GraphQL schemas (legacy backends) with Nexus-native resolvers.
+ * This lets you gradually migrate by adding new fields to old types.
+ */
+/**
+ * Stitch multiple GraphQL schemas into one unified schema.
+ *
+ * This is the core of Nexus's "Legacy Bridge" feature.
+ * You can combine:
+ * - Remote schemas from old backends (via createRemoteExecutor)
+ * - Local Nexus schemas with Shield/Vault integration
+ * - New resolvers that add security to legacy fields
+ *
+ * @example
+ * ```ts
+ * import { stitchSchemas } from '@nexus_js/graphql';
+ * import { createRemoteExecutor } from '@nexus_js/graphql';
+ *
+ * const legacyExecutor = createRemoteExecutor({
+ *   url: 'https://old-api.example.com/graphql',
+ * });
+ *
+ * const { executor: legacyExec, schema: legacySchema } =
+ *   await createRemoteExecutorWithSchema({ url: '...' });
+ *
+ * const stitched = stitchSchemas({
+ *   subschemas: [
+ *     { schema: legacySchema, executor: legacyExec },
+ *     { schema: nexusSchema },
+ *   ],
+ *   typeMerging: {
+ *     User: {
+ *       selectionSet: '{ id }',
+ *       fieldName: 'user',
+ *       args: (obj) => ({ id: obj.id }),
+ *     }
+ *   },
+ *   resolvers: {
+ *     User: {
+ *       // Add Shield protection to legacy User.apiKey field
+ *       apiKey: async (parent, args, context) => {
+ *         if (context.user?.role !== 'admin') return null;
+ *         return parent.apiKey; // Delegate to legacy
+ *       }
+ *     }
+ *   }
+ * });
+ * ```
+ */
+export function stitchSchemas(opts) {
+    const { subschemas, typeMerging, resolvers, schemaDirectives } = opts;
+    // PLACEHOLDER IMPLEMENTATION
+    // Full implementation would use @graphql-tools/stitch or similar
+    // For now, return a mock schema to show intent
+    console.warn('[Nexus] Schema stitching requires @graphql-tools/stitch. Install it separately:', 'npm install @graphql-tools/stitch @graphql-tools/delegate');
+    // Return first schema as fallback
+    if (subschemas.length === 0) {
+        throw new Error('stitchSchemas requires at least one subschema');
+    }
+    // TODO: Implement full stitching logic with type merging
+    // This would involve:
+    // 1. Merging type definitions from all subschemas
+    // 2. Creating delegating resolvers for remote fields
+    // 3. Applying transforms and type merging config
+    // 4. Adding custom resolvers on top
+    return subschemas[0].schema;
+}
+/**
+ * Helper to create a "gateway" resolver that delegates to multiple backends.
+ *
+ * Use this when you want Nexus to act as a unified API gateway
+ * that routes requests to different legacy services.
+ *
+ * @example
+ * ```ts
+ * const gateway = createGatewayResolver({
+ *   services: {
+ *     auth: createRemoteExecutor({ url: 'http://auth.internal/graphql' }),
+ *     payments: createRemoteExecutor({ url: 'http://payments.internal/graphql' }),
+ *   },
+ *   routing: {
+ *     'Query.user': 'auth',
+ *     'Query.payment': 'payments',
+ *   }
+ * });
+ * ```
+ */
+export function createGatewayResolver(opts) {
+    const { services, routing } = opts;
+    return async function gatewayResolver(parent, args, context, info) {
+        const fieldKey = `${info.parentType.name}.${info.fieldName}`;
+        const serviceName = routing[fieldKey];
+        if (!serviceName || !services[serviceName]) {
+            throw new Error(`No service configured for ${fieldKey}`);
+        }
+        const executor = services[serviceName];
+        const query = `
+      query ${info.fieldName}($args: JSON) {
+        ${info.fieldName}(args: $args)
+      }
+    `;
+        const result = await executor(query, { args }, { nexusContext: context });
+        if (result.errors && result.errors.length > 0) {
+            throw new Error(result.errors[0].message);
+        }
+        return result.data;
+    };
+}
+//# sourceMappingURL=stitching.js.map

package/dist/stitching.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stitching.js","sourceRoot":"","sources":["../src/stitching.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA+EH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,MAAM,UAAU,aAAa,CAAC,IAA0B;IACtD,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IAEtE,6BAA6B;IAC7B,iEAAiE;IACjE,+CAA+C;IAE/C,OAAO,CAAC,IAAI,CACV,iFAAiF,EACjF,2DAA2D,CAC5D,CAAC;IAEF,kCAAkC;IAClC,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,yDAAyD;IACzD,sBAAsB;IACtB,kDAAkD;IAClD,qDAAqD;IACrD,iDAAiD;IACjD,oCAAoC;IAEpC,OAAO,UAAU,CAAC,CAAC,CAAE,CAAC,MAAM,CAAC;AAC/B,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAGrC;IACC,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAEnC,OAAO,KAAK,UAAU,eAAe,CAAC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI;QAC/D,MAAM,QAAQ,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QAC7D,MAAM,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;QAEtC,IAAI,CAAC,WAAW,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC;YAC3C,MAAM,IAAI,KAAK,CAAC,6BAA6B,QAAQ,EAAE,CAAC,CAAC;QAC3D,CAAC;QAED,MAAM,QAAQ,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,KAAK,GAAG;cACJ,IAAI,CAAC,SAAS;UAClB,IAAI,CAAC,SAAS;;KAEnB,CAAC;QAEF,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,YAAY,EAAE,OAAkC,EAAE,CAAC,CAAC;QAErG,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC;QAC7C,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC"}