Skip to content

[graphql] Add ./mutation-engine subpath export for standalone mutation pipeline usage - #11565

Merged
Timothee Guerin (timotheeguerin) merged 3 commits into
microsoft:mainfrom
pinterest:graphql-mutation-engine-exports
Aug 5, 2026
Merged

[graphql] Add ./mutation-engine subpath export for standalone mutation pipeline usage#11565
Timothee Guerin (timotheeguerin) merged 3 commits into
microsoft:mainfrom
pinterest:graphql-mutation-engine-exports

Conversation

@FionaBronwen

Copy link
Copy Markdown
Contributor

Summary

Add a ./mutation-engine subpath export to @typespec/graphql to enable consumers to use the GraphQL mutation pipeline independently of the emitter. This allows for other future GraphQL related packages to use the GraphQL mutation engine to transform the input TSP into GraphQL compatible shapes in using the same library, reducing duplicate implementations.

The subpath exports:

  • mutateSchema, createGraphQLMutationEngine — orchestration
  • resolveTypeUsage — type usage analysis (input vs output)
  • GraphQLTypeContext, TypeGraph — types
  • Mutation classes (GraphQLModelMutation, etc.)

Test plan

  • Existing tests pass (368 tests)
  • Package builds successfully
  • Subpath resolves correctly

…n pipeline usage

Add a `./mutation-engine` subpath export to enable consumers to use the
GraphQL mutation pipeline independently of the emitter. This is needed
for multi-stage mutation pipelines where GraphQL transformations run as
an intermediate stage.

The subpath exports mutateSchema, createGraphQLMutationEngine,
resolveTypeUsage, GraphQLTypeContext, TypeGraph, and the mutation classes.

This keeps the render path (graphql, alloy) separate from the mutation
path, avoiding unnecessary dependencies for mutation-only consumers.
@azure-pipelines

Copy link
Copy Markdown
Azure Pipelines:
Successfully started running 1 pipeline(s).
1 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

@microsoft-github-policy-service microsoft-github-policy-service Bot added the emitter:graphql Issues for @typespec/graphql emitter label Aug 5, 2026
@pkg-pr-new

pkg-pr-new Bot commented Aug 5, 2026

Copy link
Copy Markdown

Open in StackBlitz

npm i https://pkg.pr.new/@typespec/graphql@11565

commit: 3c9bec7

@github-actions

github-actions Bot commented Aug 5, 2026

Copy link
Copy Markdown
Contributor

All changed packages have been documented.

  • @typespec/graphql
Show changes

@typespec/graphql - fix ✏️

Add ./mutation-engine subpath export for standalone mutation pipeline usage

Add subpath export for mutation engine usage in GraphQL.
…-56.md

Co-authored-by: Timothee Guerin <timothee.guerin@outlook.com>
Merged via the queue into microsoft:main with commit 0fba3fe Aug 5, 2026
28 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

emitter:graphql Issues for @typespec/graphql emitter

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants