mathsgod/light-db-graphqlite-mappers

Light DB GraphQLite Mappers

v1.0.1 2026-06-01 02:55 UTC

Requires

• thecodingmachine/graphqlite: ^8.0

Requires (Dev)

• mathsgod/light-db: dev-main

MIT

• Raymond Chong

README

A GraphQLite type mapper that exposes Light\Db\Query objects as paginated GraphQL types with metadata.

Installation

composer require mathsgod/light-db-graphqlite-mappers

What it does

When a GraphQL field returns a Light\Db\Query instance, this mapper automatically wraps it into a structured type with two fields:

Field	Type	Description
data	[T!]!	The list of records, supports limit / offset
meta	DB_META!	Metadata about the query result

DB_META fields

Field	Type	Description
total	Int	Total number of matching records
class	String	Fully qualified class name
key	String	Primary key field name
name	String	Short class name

Usage

Register the type mapper with your GraphQLite SchemaFactory:

use Light\Db\GraphQLite\Mappers\TypeMapper;

$schemaFactory->addTypeMapper(new TypeMapper($factoryContext));

Then return a Light\Db\Query from any GraphQL query method and type-hint the sub-type:

use TheCodingMachine\GraphQLite\Annotations\Query;
use Light\Db\Query;

#[Query]
public function users(): Query /* <User> */
{
    return User::query();
}

The generated GraphQL type will be DB_QUERY_User with data and meta fields.

Example GraphQL query

{
    users {
        data(limit: 10, offset: 0) {
            id
            name
        }
        meta {
            total
            key
        }
    }
}

Requirements

• PHP 8.1+
• thecodingmachine/graphqlite ^8.0
• mathsgod/light-db

License

MIT