@capixjs/transport-graphql 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Capix Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,107 @@
+# @capixjs/transport-graphql
+
+GraphQL transport for [Capix](https://github.com/capix/capix). Serves a spec-compliant GraphQL endpoint and an optional GraphiQL playground from your Capix capability registry.
+
+## Install
+
+```bash
+npm install @capixjs/core @capixjs/transport-graphql zod
+```
+
+## Usage
+
+```ts
+import { createServer } from '@capixjs/core';
+import { graphqlTransport } from '@capixjs/transport-graphql';
+import { buildContext, capabilities } from './capabilities.js';
+
+createServer({
+  context: buildContext,
+  capabilities,
+  transports: [
+    graphqlTransport({ port: 4000 }),
+  ],
+}).start();
+```
+
+GraphQL endpoint: `http://localhost:4000/graphql`  
+Playground: `http://localhost:4000/graphql/playground`
+
+## Schema mapping
+
+Capability registries are mapped to a GraphQL schema automatically:
+
+| Capix | GraphQL |
+|-------|---------|
+| `intent: 'query'` | `Query` field |
+| All other intents | `Mutation` field |
+| `users.getUser` | `users_getUser` field |
+| `z.string()` input | `String!` arg |
+| `z.number()` input | `Float!` arg |
+| `z.boolean()` input | `Boolean!` arg |
+| `.output(schema)` | Named output type |
+| No `.output()` | `JSON` scalar |
+| `z.coerce.number().default(N)` | Optional `Float` arg |
+
+## Querying
+
+```graphql
+# Named output type (capability uses .output())
+{ users_getUser(id: "1") { id name email } }
+
+# JSON scalar (no .output() — entire object returned as-is)
+{ system_ping }
+
+# Variables work for all argument types
+query GetUser($id: String!) {
+  users_getUser(id: $id) { id name }
+}
+```
+
+## Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `port` | `number` | — | Port to listen on |
+| `host` | `string` | `'0.0.0.0'` | Host to bind to |
+| `path` | `string` | `'/graphql'` | GraphQL endpoint path |
+| `playground` | `boolean` | `true` | Serve GraphiQL at `{path}/playground` |
+| `capabilities` | `GroupTree` | server default | Per-transport capability registry |
+
+## Per-transport capabilities
+
+```ts
+createServer({
+  context: buildContext,
+  transports: [
+    graphqlTransport({
+      port: 4000,
+      capabilities: { users: { list, get } },  // only these capabilities on GraphQL
+    }),
+  ],
+});
+```
+
+## Auth header forwarding
+
+The GraphQL transport forwards `Authorization` and other request headers to `buildContext` unchanged. Use `getHeader(req, 'authorization')` inside your context builder to read them:
+
+```ts
+import { defineContext, getHeader } from '@capixjs/core';
+
+const buildContext = defineContext(async (req) => ({
+  requestId: crypto.randomUUID(),
+  user: await verifyToken(getHeader(req, 'authorization')),
+}));
+```
+
+## Limitations
+
+- **No subscriptions**: the GraphQL transport is request/response only. For real-time updates, use `wsTransport` with an event bus alongside the GraphQL transport.
+- **`z.lazy` falls back to JSON scalar**: recursive schemas defined with `z.lazy()` cannot be statically typed in the generated GraphQL schema and are represented as the `JSON` scalar.
+- **No file uploads**: multipart file uploads are not supported in the GraphQL transport. Use the REST transport for file upload capabilities.
+- **No batching**: the transport handles one operation per request.
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { graphqlTransport } from './transport.js';
+export type { GraphQLTransportOptions } from './transport.js';
+export { buildGraphQLSchema, JSONScalar } from './schema-builder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,YAAY,EAAE,uBAAuB,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { graphqlTransport } from './transport.js';
+export { buildGraphQLSchema, JSONScalar } from './schema-builder.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/schema-builder.d.ts

@@ -0,0 +1,16 @@
+/**
+ * schema-builder.ts — Converts a Capix registry into a GraphQL schema.
+ *
+ * Rules:
+ *   - intent: 'query'  → Query field
+ *   - all other intents → Mutation field
+ *   - Dot-path names become underscore-separated field names (users.getUser → users_getUser)
+ *   - Zod input schema fields → individual GraphQL args
+ *   - Zod output schema → named GraphQL output type; absent → JSONScalar
+ *   - Type cache prevents duplicate type definitions across fields
+ */
+import { GraphQLSchema, GraphQLScalarType } from 'graphql';
+import type { CapabilityRegistry, InvokeFn } from '@capixjs/core';
+export declare const JSONScalar: GraphQLScalarType<unknown, unknown>;
+export declare function buildGraphQLSchema(registry: CapabilityRegistry, invoke: InvokeFn): GraphQLSchema;
+//# sourceMappingURL=schema-builder.d.ts.map

package/dist/schema-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-builder.d.ts","sourceRoot":"","sources":["../src/schema-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,aAAa,EAQb,iBAAiB,EAGlB,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,EAAE,kBAAkB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAElE,eAAO,MAAM,UAAU,qCAerB,CAAC;AAoIH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,MAAM,EAAE,QAAQ,GAAG,aAAa,CA2DhG"}

package/dist/schema-builder.js

@@ -0,0 +1,200 @@
+/**
+ * schema-builder.ts — Converts a Capix registry into a GraphQL schema.
+ *
+ * Rules:
+ *   - intent: 'query'  → Query field
+ *   - all other intents → Mutation field
+ *   - Dot-path names become underscore-separated field names (users.getUser → users_getUser)
+ *   - Zod input schema fields → individual GraphQL args
+ *   - Zod output schema → named GraphQL output type; absent → JSONScalar
+ *   - Type cache prevents duplicate type definitions across fields
+ */
+import { GraphQLSchema, GraphQLObjectType, GraphQLInputObjectType, GraphQLString, GraphQLFloat, GraphQLBoolean, GraphQLList, GraphQLNonNull, GraphQLScalarType, GraphQLEnumType, Kind, } from 'graphql';
+export const JSONScalar = new GraphQLScalarType({
+    name: 'JSON',
+    description: 'Arbitrary JSON value',
+    serialize: (v) => v,
+    parseValue: (v) => v,
+    parseLiteral: (ast) => {
+        switch (ast.kind) {
+            case Kind.INT: return parseInt(ast.value, 10);
+            case Kind.FLOAT: return parseFloat(ast.value);
+            case Kind.STRING: return ast.value;
+            case Kind.BOOLEAN: return ast.value;
+            case Kind.NULL: return null;
+            default: return null;
+        }
+    },
+});
+function zodDef(schema) {
+    return schema?._def ?? {};
+}
+function resolveShape(d) {
+    return typeof d.shape === 'function' ? d.shape() : (d.shape ?? {});
+}
+function zodToGqlOutput(schema, typeName, cache) {
+    const d = zodDef(schema);
+    switch (d.typeName) {
+        case 'ZodString': return new GraphQLNonNull(GraphQLString);
+        case 'ZodNumber': return new GraphQLNonNull(GraphQLFloat);
+        case 'ZodBoolean': return new GraphQLNonNull(GraphQLBoolean);
+        case 'ZodDefault': {
+            // Unwrap default — value is optional in GraphQL (no NonNull)
+            const inner = zodToGqlOutput(d.innerType, typeName, cache);
+            return inner instanceof GraphQLNonNull ? inner.ofType : inner;
+        }
+        case 'ZodEffects':
+            // z.coerce.* and z.preprocess() — unwrap to inner schema
+            return zodToGqlOutput(d.schema, typeName, cache);
+        case 'ZodOptional':
+        case 'ZodNullable': {
+            const inner = zodToGqlOutput(d.innerType, typeName, cache);
+            return inner instanceof GraphQLNonNull ? inner.ofType : inner;
+        }
+        case 'ZodArray': {
+            const inner = zodToGqlOutput(d.type, `${typeName}Item`, cache);
+            return new GraphQLNonNull(new GraphQLList(inner));
+        }
+        case 'ZodObject': {
+            const cached = cache.get(typeName);
+            if (cached)
+                return new GraphQLNonNull(cached);
+            const shape = resolveShape(d);
+            const objectType = new GraphQLObjectType({
+                name: typeName,
+                fields: () => {
+                    const fields = {};
+                    for (const [key, val] of Object.entries(shape)) {
+                        fields[key] = { type: zodToGqlOutput(val, `${typeName}_${key}`, cache) };
+                    }
+                    return fields;
+                },
+            });
+            cache.set(typeName, objectType);
+            return new GraphQLNonNull(objectType);
+        }
+        case 'ZodEnum': {
+            const valList = d.values ?? [];
+            const enumValues = {};
+            for (const v of valList)
+                enumValues[String(v)] = { value: String(v) };
+            return new GraphQLNonNull(new GraphQLEnumType({ name: typeName, values: enumValues }));
+        }
+        case 'ZodAny':
+        case 'ZodUnknown':
+        default:
+            return JSONScalar;
+    }
+}
+function zodToGqlInput(schema, typeName, cache) {
+    const d = zodDef(schema);
+    switch (d.typeName) {
+        case 'ZodString': return new GraphQLNonNull(GraphQLString);
+        case 'ZodNumber': return new GraphQLNonNull(GraphQLFloat);
+        case 'ZodBoolean': return new GraphQLNonNull(GraphQLBoolean);
+        case 'ZodDefault': {
+            // Unwrap default — field is optional in GraphQL (no NonNull)
+            const inner = zodToGqlInput(d.innerType, typeName, cache);
+            return inner instanceof GraphQLNonNull ? inner.ofType : inner;
+        }
+        case 'ZodEffects':
+            // z.coerce.* and z.preprocess() — unwrap to inner schema
+            return zodToGqlInput(d.schema, typeName, cache);
+        case 'ZodOptional':
+        case 'ZodNullable': {
+            const inner = zodToGqlInput(d.innerType, typeName, cache);
+            return inner instanceof GraphQLNonNull ? inner.ofType : inner;
+        }
+        case 'ZodArray': {
+            const inner = zodToGqlInput(d.type, `${typeName}Item`, cache);
+            return new GraphQLNonNull(new GraphQLList(inner));
+        }
+        case 'ZodObject': {
+            const cached = cache.get(typeName);
+            if (cached)
+                return new GraphQLNonNull(cached);
+            const shape = resolveShape(d);
+            const inputType = new GraphQLInputObjectType({
+                name: typeName,
+                fields: () => {
+                    const fields = {};
+                    for (const [key, val] of Object.entries(shape)) {
+                        fields[key] = { type: zodToGqlInput(val, `${typeName}_${key}`, cache) };
+                    }
+                    return fields;
+                },
+            });
+            cache.set(typeName, inputType);
+            return new GraphQLNonNull(inputType);
+        }
+        case 'ZodEnum': {
+            const valList = d.values ?? [];
+            const enumValues = {};
+            for (const v of valList)
+                enumValues[String(v)] = { value: String(v) };
+            return new GraphQLNonNull(new GraphQLEnumType({ name: `${typeName}Enum`, values: enumValues }));
+        }
+        case 'ZodAny':
+        case 'ZodUnknown':
+        default:
+            return JSONScalar;
+    }
+}
+function toTypeName(dotPath) {
+    return dotPath.split(/[._]/).map((p) => p.charAt(0).toUpperCase() + p.slice(1)).join('');
+}
+export function buildGraphQLSchema(registry, invoke) {
+    const outputCache = new Map();
+    const inputCache = new Map();
+    const queryFields = {};
+    const mutationFields = {};
+    for (const [name, cap] of registry) {
+        const fnName = name.replaceAll('.', '_');
+        const typeName = toTypeName(name);
+        const args = {};
+        if (cap.inputSchema !== null) {
+            const shape = resolveShape(zodDef(cap.inputSchema));
+            for (const [key, val] of Object.entries(shape)) {
+                args[key] = { type: zodToGqlInput(val, `${typeName}_${key}Input`, inputCache) };
+            }
+        }
+        const returnType = cap.outputSchema !== null
+            ? zodToGqlOutput(cap.outputSchema, `${typeName}Output`, outputCache)
+            : JSONScalar;
+        const field = {
+            type: returnType,
+            args,
+            resolve: async (_root, resolvedArgs, context) => {
+                const signal = AbortSignal.timeout(30_000);
+                const response = await invoke({
+                    capability: name,
+                    input: resolvedArgs,
+                    headers: context?.headers ?? {},
+                    signal,
+                });
+                if (!response.ok) {
+                    const { error, message } = response.error;
+                    throw new Error(`${error}: ${message}`);
+                }
+                return response.data;
+            },
+        };
+        if (cap.intent === 'query') {
+            queryFields[fnName] = field;
+        }
+        else {
+            mutationFields[fnName] = field;
+        }
+    }
+    // GraphQL requires at least one field in Query
+    if (Object.keys(queryFields).length === 0) {
+        queryFields['_empty'] = { type: GraphQLString, resolve: () => 'empty' };
+    }
+    return new GraphQLSchema({
+        query: new GraphQLObjectType({ name: 'Query', fields: queryFields }),
+        ...(Object.keys(mutationFields).length > 0
+            ? { mutation: new GraphQLObjectType({ name: 'Mutation', fields: mutationFields }) }
+            : {}),
+    });
+}
+//# sourceMappingURL=schema-builder.js.map

package/dist/schema-builder.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,22 @@
+/**
+ * transport.ts — GraphQL transport using graphql-http (spec-compliant).
+ *
+ * Serves a GraphQL endpoint and an optional GraphiQL playground.
+ * Forwards request headers to capability resolvers via context.
+ */
+import type { GroupTree, TransportWithCapabilities } from '@capixjs/core';
+export type GraphQLTransportOptions = {
+    readonly port: number;
+    readonly host?: string;
+    /** URL path for the GraphQL endpoint. Default: '/graphql' */
+    readonly path?: string;
+    /**
+     * Serve a GraphiQL playground at `{path}/playground`. Default: true.
+     * Set to false to disable in production.
+     */
+    readonly playground?: boolean;
+    /** Capability registry for this transport only. Overrides the server-level default. */
+    readonly capabilities?: GroupTree;
+};
+export declare function graphqlTransport(options: GraphQLTransportOptions): TransportWithCapabilities;
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAqC,SAAS,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAE7G,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,uFAAuF;IACvF,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,CAAC;CACnC,CAAC;AA2BF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,uBAAuB,GAAG,yBAAyB,CA2E5F"}

package/dist/transport.js

@@ -0,0 +1,102 @@
+/**
+ * transport.ts — GraphQL transport using graphql-http (spec-compliant).
+ *
+ * Serves a GraphQL endpoint and an optional GraphiQL playground.
+ * Forwards request headers to capability resolvers via context.
+ */
+import * as http from 'node:http';
+import { createHandler } from 'graphql-http/lib/use/node';
+import { buildGraphQLSchema } from './schema-builder.js';
+function playgroundHtml(endpoint) {
+    return `<!DOCTYPE html>
+<html>
+<head>
+  <meta charset="utf-8" />
+  <title>Capix GraphQL Playground</title>
+  <link rel="stylesheet" href="https://unpkg.com/graphiql/graphiql.min.css" />
+  <style>body { margin: 0; } #graphiql { height: 100vh; }</style>
+</head>
+<body>
+  <div id="graphiql"></div>
+  <script src="https://unpkg.com/react@18/umd/react.production.min.js"></script>
+  <script src="https://unpkg.com/react-dom@18/umd/react-dom.production.min.js"></script>
+  <script src="https://unpkg.com/graphiql/graphiql.min.js"></script>
+  <script>
+    const root = ReactDOM.createRoot(document.getElementById('graphiql'));
+    root.render(React.createElement(GraphiQL, {
+      fetcher: GraphiQL.createFetcher({ url: '${endpoint}' }),
+      defaultEditorToolsVisibility: true,
+    }));
+  </script>
+</body>
+</html>`;
+}
+export function graphqlTransport(options) {
+    let server = null;
+    const gqlPath = options.path ?? '/graphql';
+    const playPath = `${gqlPath}/playground`;
+    const showPlayground = options.playground !== false;
+    return {
+        ...(options.capabilities !== undefined ? { _capabilities: options.capabilities } : {}),
+        async mount(invoke, mountOptions) {
+            const schema = buildGraphQLSchema(mountOptions.registry, invoke);
+            const gqlHandler = createHandler({
+                schema,
+                context: (req) => {
+                    const rawHeaders = req.raw.headers;
+                    const headers = {};
+                    for (const [key, val] of Object.entries(rawHeaders)) {
+                        if (val !== undefined) {
+                            headers[key] = Array.isArray(val) ? val.join(', ') : val;
+                        }
+                    }
+                    return { headers };
+                },
+            });
+            function httpHandler(req, res) {
+                const url = req.url ?? '/';
+                const pathname = url.split('?')[0] ?? '';
+                if (showPlayground && pathname === playPath) {
+                    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+                    res.end(playgroundHtml(gqlPath));
+                    return;
+                }
+                if (pathname === gqlPath || pathname === `${gqlPath}/`) {
+                    gqlHandler(req, res).catch((err) => {
+                        console.error('[capix:graphql] Handler error:', err);
+                        if (!res.headersSent) {
+                            res.writeHead(500);
+                            res.end('Internal error');
+                        }
+                    });
+                    return;
+                }
+                res.writeHead(404);
+                res.end();
+            }
+            console.log('\nCapix GraphQL transport starting...');
+            console.log(`  ✓ GraphQL    http://localhost:${options.port}${gqlPath}`);
+            if (showPlayground) {
+                console.log(`  ✓ Playground http://localhost:${options.port}${playPath}`);
+            }
+            return new Promise((resolve, reject) => {
+                server = http.createServer(httpHandler);
+                server.on('error', reject);
+                server.listen(options.port, options.host ?? '0.0.0.0', () => resolve());
+            });
+        },
+        async unmount() {
+            return new Promise((resolve, reject) => {
+                if (!server)
+                    return resolve();
+                server.close((err) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve();
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@capixjs/transport-graphql",
+  "version": "0.1.0-alpha.1",
+  "description": "Capix GraphQL transport",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.test.*",
+    "LICENSE"
+  ],
+  "keywords": [
+    "capix",
+    "graphql",
+    "transport",
+    "typescript"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "graphql": "^16.0.0",
+    "graphql-http": "^1.22.0"
+  },
+  "peerDependencies": {
+    "@capixjs/core": ">=0.1.0-0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^1.6.0",
+    "zod": "^3.23.0",
+    "@capixjs/core": "workspace:*"
+  }
+}