/ 
Punk-GraphQL-0.02
/ Punk::GraphQL

NAME

Punk::GraphQL - GraphQL endpoints for Punk applications

VERSION

Version 0.02

SYNOPSIS

package MyApp;
use Punk;
use Punk::Plugin::GraphQL;

plugin 'GraphQL';

graphql '/graphql' => 'schema/app.graphql', {
	resolvers => {
		Query    => 'Books',              # MyApp::Controller::Books
		Mutation => { rename => 'Books#rename' },
	},
	context  => 'Books#context',
	guard    => 'Auth#user',
	graphiql => 1,
};

# resolvers take the same targets as routes - 'Controller#method'
# strings or coderefs - and a whole type may name a controller
# class, wiring every field with a same-named method:

package MyApp::Controller::Books;

sub user {
	my ($root, $args, $ctx) = @_;
	return $ctx->{db}->user($args->{id});
}

sub context {
	my ($c) = @_;
	return ({ db => $c->db });
}

1;

# app.psgi
MyApp->to_app;

DESCRIPTION

Punk::GraphQL mounts a GraphQL-over-HTTP endpoint into a Punk application, executing requests through GraphQL::Houtou, an XS-first GraphQL parser and native-VM runtime.

SEE ALSO

Punk::Plugin::GraphQL - the plugin, keyword, and handler reference

GraphQL::Houtou - the execution engine

Punk - the web framework

AUTHOR

LNATION, <email at lnation.org>

LICENSE AND COPYRIGHT

This software is Copyright (c) 2026 by LNATION.

This is free software, licensed under:

The Artistic License 2.0 (GPL Compatible)