@cogitator-ai/a2a 0.7.7 → 0.8.0

package/dist/adapters/express.js

@@ -1,52 +1,75 @@
 import { Router, json } from 'express';
 import { createErrorResponse } from '../json-rpc.js';
 import * as errors from '../errors.js';
-import { isStreamRequest, pipeJsonRpcStream, SSE_HEADERS } from './shared.js';
-export function a2aExpress(server) {
-    const router = Router();
-    router.get('/.well-known/agent.json', (_req, res) => {
-        const cards = server.getAgentCards();
-        res.json(cards.length === 1 ? cards[0] : cards);
+import { handleA2AHttp } from './shared.js';
+const parseJson = json();
+function readBody(req, res) {
+    if (req.body !== undefined)
+        return Promise.resolve(req.body);
+    return new Promise((resolve, reject) => {
+        parseJson(req, res, (error) => {
+            if (error)
+                reject(error instanceof Error ? error : new SyntaxError(String(error)));
+            else
+                resolve(req.body);
+        });
     });
-    router.post(server.basePath, json(), async (req, res) => {
-        const contentType = req.headers['content-type'];
-        if (contentType && !contentType.startsWith('application/json')) {
-            res.json(createErrorResponse(null, errors.contentTypeNotSupported(contentType)));
+}
+async function send(res, response) {
+    switch (response.kind) {
+        case 'json':
+            res.status(response.status).set(response.headers).json(response.body);
             return;
-        }
-        const body = req.body;
-        const authToken = server.getAuthToken((name) => req.get(name));
-        if (isStreamRequest(body)) {
-            const controller = new AbortController();
-            res.on('close', () => controller.abort());
-            res.writeHead(200, SSE_HEADERS);
-            await pipeJsonRpcStream(server, body, authToken, controller.signal, (frame) => {
+        case 'empty':
+            res.status(response.status).end();
+            return;
+        case 'sse':
+            res.writeHead(200, response.headers);
+            await response.pipe((frame) => {
                 if (!res.writableEnded && !res.destroyed)
                     res.write(frame);
             });
             if (!res.writableEnded)
                 res.end();
             return;
-        }
+        case 'pass':
+            return;
+    }
+}
+/**
+ * Express router serving an A2A server: the Agent Card at `/.well-known/agent-card.json` (and the
+ * pre-v0.3 `/.well-known/agent.json`), JSON-RPC at `basePath`, and every agent's own card and
+ * endpoint under `<basePath>/<agent name>`.
+ */
+export function a2aExpress(server) {
+    const router = Router();
+    router.use(async (req, res, next) => {
+        const controller = new AbortController();
+        res.on('close', () => controller.abort());
         try {
-            const response = await server.handleJsonRpc(body, authToken);
-            if (response === null) {
-                res.status(204).end();
+            const response = await handleA2AHttp(server, {
+                method: req.method,
+                path: req.path,
+                mountUrl: `${req.protocol}://${req.get('host') ?? 'localhost'}${req.baseUrl}`,
+                header: (name) => req.get(name),
+                readBody: () => readBody(req, res),
+                signal: controller.signal,
+            });
+            if (response.kind === 'pass') {
+                next();
                 return;
             }
-            res.json(response);
+            await send(res, response);
         }
         catch (error) {
+            if (res.headersSent) {
+                if (!res.writableEnded)
+                    res.end();
+                return;
+            }
             res.json(createErrorResponse(null, errors.clientJsonRpcError(error, 'A2A request failed')));
         }
     });
-    router.use((err, _req, res, next) => {
-        if (err instanceof SyntaxError) {
-            res.json(createErrorResponse(null, errors.parseError('Invalid JSON body')));
-            return;
-        }
-        next(err);
-    });
     return router;
 }
 //# sourceMappingURL=express.js.map

package/dist/adapters/express.js.map

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

package/dist/adapters/fastify.d.ts

@@ -1,4 +1,9 @@
 import type { FastifyPluginAsync } from 'fastify';
 import type { A2AServer } from '../server.js';
+/**
+ * Fastify plugin serving an A2A server: the Agent Card at `/.well-known/agent-card.json` (and the
+ * pre-v0.3 `/.well-known/agent.json`), JSON-RPC at `basePath`, and every agent's own card and
+ * endpoint under `<basePath>/<agent name>`.
+ */
 export declare function a2aFastify(server: A2AServer): FastifyPluginAsync;
 //# sourceMappingURL=fastify.d.ts.map

package/dist/adapters/fastify.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../../src/adapters/fastify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,kBAAkB,EAAE,MAAM,SAAS,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,kBAAkB,CA6DhE"}
+{"version":3,"file":"fastify.d.ts","sourceRoot":"","sources":["../../src/adapters/fastify.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAmB,kBAAkB,EAAgC,MAAM,SAAS,CAAC;AACjG,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAO9C;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,SAAS,GAAG,kBAAkB,CA8EhE"}

package/dist/adapters/fastify.js

@@ -1,12 +1,24 @@
 import { createErrorResponse } from '../json-rpc.js';
 import * as errors from '../errors.js';
-import { firstHeader, isStreamRequest, pipeJsonRpcStream, SSE_HEADERS } from './shared.js';
+import { AGENT_CARD_PATH, LEGACY_AGENT_CARD_PATH } from '../types.js';
+import { firstHeader, handleA2AHttp, mountUrlOf } from './shared.js';
+import { trimTrailingSlashes } from '../url.js';
+/**
+ * Fastify plugin serving an A2A server: the Agent Card at `/.well-known/agent-card.json` (and the
+ * pre-v0.3 `/.well-known/agent.json`), JSON-RPC at `basePath`, and every agent's own card and
+ * endpoint under `<basePath>/<agent name>`.
+ */
 export function a2aFastify(server) {
     return async (fastify) => {
         fastify.setErrorHandler((error, _request, reply) => {
             if (error instanceof SyntaxError || error.statusCode === 400) {
                 return reply.send(createErrorResponse(null, errors.parseError('Invalid JSON body')));
             }
+            if (error.statusCode === 415) {
+                return reply
+                    .code(415)
+                    .send(createErrorResponse(null, errors.invalidRequest('Content-Type must be application/json')));
+            }
             if (typeof error.statusCode === 'number' &&
                 error.statusCode > 400 &&
                 error.statusCode < 500) {
@@ -14,42 +26,46 @@ export function a2aFastify(server) {
             }
             return reply.send(createErrorResponse(null, errors.clientJsonRpcError(error, 'A2A request failed')));
         });
-        fastify.get('/.well-known/agent.json', async (_request, reply) => {
-            const cards = server.getAgentCards();
-            return reply.send(cards.length === 1 ? cards[0] : cards);
-        });
-        fastify.post(server.basePath, async (request, reply) => {
-            const contentType = request.headers['content-type'];
-            if (contentType && !contentType.startsWith('application/json')) {
-                return reply.send(createErrorResponse(null, errors.contentTypeNotSupported(contentType)));
-            }
-            const body = request.body;
-            const authToken = server.getAuthToken((name) => firstHeader(request.headers[name.toLowerCase()]));
-            if (isStreamRequest(body)) {
-                void reply.hijack();
-                const raw = reply.raw;
-                const controller = new AbortController();
-                raw.on('close', () => controller.abort());
-                raw.writeHead(200, SSE_HEADERS);
-                await pipeJsonRpcStream(server, body, authToken, controller.signal, (frame) => {
-                    if (!raw.writableEnded && !raw.destroyed)
-                        raw.write(frame);
-                });
-                if (!raw.writableEnded)
-                    raw.end();
-                return;
-            }
-            try {
-                const response = await server.handleJsonRpc(body, authToken);
-                if (response === null) {
-                    return reply.code(204).send();
+        const serve = async (request, reply, relativePath) => {
+            const controller = new AbortController();
+            reply.raw.on('close', () => controller.abort());
+            const requestUrl = new URL(request.url, `${request.protocol}://${request.host}`);
+            const response = await handleA2AHttp(server, {
+                method: request.method,
+                path: relativePath,
+                mountUrl: mountUrlOf(requestUrl, relativePath),
+                header: (name) => firstHeader(request.headers[name.toLowerCase()]),
+                readBody: async () => request.body,
+                signal: controller.signal,
+            });
+            switch (response.kind) {
+                case 'json':
+                    return reply.code(response.status).headers(response.headers).send(response.body);
+                case 'empty':
+                    return reply.code(response.status).send();
+                case 'pass':
+                    return reply.callNotFound();
+                case 'sse': {
+                    void reply.hijack();
+                    const raw = reply.raw;
+                    raw.writeHead(200, response.headers);
+                    await response.pipe((frame) => {
+                        if (!raw.writableEnded && !raw.destroyed)
+                            raw.write(frame);
+                    });
+                    if (!raw.writableEnded)
+                        raw.end();
+                    return reply;
                 }
-                return reply.send(response);
-            }
-            catch (error) {
-                return reply.send(createErrorResponse(null, errors.clientJsonRpcError(error, 'A2A request failed')));
             }
-        });
+        };
+        const base = trimTrailingSlashes(server.basePath);
+        const agentPath = (request) => `${base}/${encodeURIComponent(request.params.agent ?? '')}`;
+        fastify.get(AGENT_CARD_PATH, (request, reply) => serve(request, reply, AGENT_CARD_PATH));
+        fastify.get(LEGACY_AGENT_CARD_PATH, (request, reply) => serve(request, reply, LEGACY_AGENT_CARD_PATH));
+        fastify.get(`${base}/:agent${AGENT_CARD_PATH}`, (request, reply) => serve(request, reply, `${agentPath(request)}${AGENT_CARD_PATH}`));
+        fastify.post(server.basePath, (request, reply) => serve(request, reply, server.basePath));
+        fastify.post(`${base}/:agent`, (request, reply) => serve(request, reply, agentPath(request)));
     };
 }
 //# sourceMappingURL=fastify.js.map

package/dist/adapters/fastify.js.map

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

package/dist/adapters/hono.d.ts

@@ -1,4 +1,9 @@
 import { Hono } from 'hono';
 import type { A2AServer } from '../server.js';
+/**
+ * Hono app serving an A2A server: the Agent Card at `/.well-known/agent-card.json` (and the
+ * pre-v0.3 `/.well-known/agent.json`), JSON-RPC at `basePath`, and every agent's own card and
+ * endpoint under `<basePath>/<agent name>`.
+ */
 export declare function a2aHono(server: A2AServer): Hono;
 //# sourceMappingURL=hono.d.ts.map

package/dist/adapters/hono.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../src/adapters/hono.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAM9C,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA+D/C"}
+{"version":3,"file":"hono.d.ts","sourceRoot":"","sources":["../../src/adapters/hono.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAgB,MAAM,MAAM,CAAC;AAE1C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAO9C;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAgD/C"}

package/dist/adapters/hono.js

@@ -2,64 +2,56 @@ import { Hono } from 'hono';
 import { streamSSE } from 'hono/streaming';
 import { createErrorResponse } from '../json-rpc.js';
 import * as errors from '../errors.js';
-import { buildSseErrorEvent } from './sse-error-event.js';
-import { isStreamRequest } from './shared.js';
+import { AGENT_CARD_PATH, LEGACY_AGENT_CARD_PATH } from '../types.js';
+import { handleA2AHttp, mountUrlOf } from './shared.js';
+import { trimTrailingSlashes } from '../url.js';
+/**
+ * Hono app serving an A2A server: the Agent Card at `/.well-known/agent-card.json` (and the
+ * pre-v0.3 `/.well-known/agent.json`), JSON-RPC at `basePath`, and every agent's own card and
+ * endpoint under `<basePath>/<agent name>`.
+ */
 export function a2aHono(server) {
     const app = new Hono();
-    app.get('/.well-known/agent.json', (c) => {
-        const cards = server.getAgentCards();
-        return c.json(cards.length === 1 ? cards[0] : cards);
-    });
-    app.post(server.basePath, async (c) => {
-        const contentType = c.req.header('content-type');
-        if (contentType && !contentType.startsWith('application/json')) {
-            return c.json(createErrorResponse(null, errors.contentTypeNotSupported(contentType)));
-        }
-        let body;
+    const serve = async (c, relativePath) => {
+        const controller = new AbortController();
+        c.req.raw.signal.addEventListener('abort', () => controller.abort(), { once: true });
         try {
-            body = await c.req.json();
-        }
-        catch {
-            return c.json(createErrorResponse(null, errors.parseError('Invalid JSON body')));
-        }
-        const authToken = server.getAuthToken((name) => c.req.header(name));
-        if (isStreamRequest(body)) {
-            c.header('X-Accel-Buffering', 'no');
-            return streamSSE(c, async (stream) => {
-                const controller = new AbortController();
-                stream.onAbort(() => controller.abort());
-                try {
-                    for await (const event of server.handleJsonRpcStream(body, authToken, controller.signal)) {
-                        if (controller.signal.aborted)
-                            return;
-                        await stream.writeSSE({ data: JSON.stringify(event) });
-                    }
-                    if (!controller.signal.aborted)
-                        await stream.writeSSE({ data: '[DONE]' });
-                }
-                catch (error) {
-                    if (controller.signal.aborted)
-                        return;
-                    try {
-                        await stream.writeSSE({ data: JSON.stringify(buildSseErrorEvent(error)) });
-                    }
-                    catch {
-                        return;
-                    }
-                }
+            const response = await handleA2AHttp(server, {
+                method: c.req.method,
+                path: relativePath,
+                mountUrl: mountUrlOf(new URL(c.req.url), relativePath),
+                header: (name) => c.req.header(name),
+                readBody: () => c.req.json(),
+                signal: controller.signal,
             });
-        }
-        try {
-            const response = await server.handleJsonRpc(body, authToken);
-            if (response === null) {
-                return c.body(null, 204);
+            switch (response.kind) {
+                case 'json':
+                    return c.json(response.body, response.status, response.headers);
+                case 'empty':
+                    return c.body(null, response.status);
+                case 'pass':
+                    return c.notFound();
+                case 'sse':
+                    c.header('X-Accel-Buffering', 'no');
+                    return streamSSE(c, async (stream) => {
+                        stream.onAbort(() => controller.abort());
+                        await response.pipe(async (frame) => {
+                            await stream.write(frame);
+                        });
+                    });
             }
-            return c.json(response);
         }
         catch (error) {
             return c.json(createErrorResponse(null, errors.clientJsonRpcError(error, 'A2A request failed')));
         }
-    });
+    };
+    const base = trimTrailingSlashes(server.basePath);
+    const agentPath = (c) => `${base}/${encodeURIComponent(c.req.param('agent') ?? '')}`;
+    app.get(AGENT_CARD_PATH, (c) => serve(c, AGENT_CARD_PATH));
+    app.get(LEGACY_AGENT_CARD_PATH, (c) => serve(c, LEGACY_AGENT_CARD_PATH));
+    app.get(`${base}/:agent${AGENT_CARD_PATH}`, (c) => serve(c, `${agentPath(c)}${AGENT_CARD_PATH}`));
+    app.post(server.basePath, (c) => serve(c, server.basePath));
+    app.post(`${base}/:agent`, (c) => serve(c, agentPath(c)));
     return app;
 }
 //# sourceMappingURL=hono.js.map

package/dist/adapters/hono.js.map

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

package/dist/adapters/koa.d.ts

@@ -1,4 +1,9 @@
 import type { Middleware } from 'koa';
 import type { A2AServer } from '../server.js';
+/**
+ * Koa middleware serving an A2A server: the Agent Card at `/.well-known/agent-card.json` (and the
+ * pre-v0.3 `/.well-known/agent.json`), JSON-RPC at `basePath`, and every agent's own card and
+ * endpoint under `<basePath>/<agent name>`. JSON bodies must be parsed by a body parser before it.
+ */
 export declare function a2aKoa(server: A2AServer): Middleware;
 //# sourceMappingURL=koa.d.ts.map

package/dist/adapters/koa.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"koa.d.ts","sourceRoot":"","sources":["../../src/adapters/koa.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAW,MAAM,KAAK,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CAyDpD"}
+{"version":3,"file":"koa.d.ts","sourceRoot":"","sources":["../../src/adapters/koa.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAW,MAAM,KAAK,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAW9C;;;;GAIG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,SAAS,GAAG,UAAU,CA2CpD"}

package/dist/adapters/koa.js

@@ -1,32 +1,52 @@
 import { createErrorResponse } from '../json-rpc.js';
 import * as errors from '../errors.js';
-import { isStreamRequest, pipeJsonRpcStream, SSE_HEADERS } from './shared.js';
+import { handleA2AHttp } from './shared.js';
+/** Where the middleware is mounted: the part of the original path before `ctx.path` (koa-mount). */
+function mountPath(ctx) {
+    const original = new URL(ctx.originalUrl, 'http://localhost').pathname;
+    return original.endsWith(ctx.path) ? original.slice(0, original.length - ctx.path.length) : '';
+}
+/**
+ * Koa middleware serving an A2A server: the Agent Card at `/.well-known/agent-card.json` (and the
+ * pre-v0.3 `/.well-known/agent.json`), JSON-RPC at `basePath`, and every agent's own card and
+ * endpoint under `<basePath>/<agent name>`. JSON bodies must be parsed by a body parser before it.
+ */
 export function a2aKoa(server) {
     return async (ctx, next) => {
-        if (ctx.path === '/.well-known/agent.json' && ctx.method === 'GET') {
-            const cards = server.getAgentCards();
-            ctx.body = cards.length === 1 ? cards[0] : cards;
+        const controller = new AbortController();
+        ctx.res.on('close', () => controller.abort());
+        let response;
+        try {
+            response = await handleA2AHttp(server, {
+                method: ctx.method,
+                path: ctx.path,
+                mountUrl: `${ctx.protocol}://${ctx.host}${mountPath(ctx)}`,
+                header: (name) => ctx.get(name) || undefined,
+                readBody: async () => ctx.request.body,
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            ctx.body = createErrorResponse(null, errors.clientJsonRpcError(error, 'A2A request failed'));
             return;
         }
-        if (ctx.path === server.basePath && ctx.method === 'POST') {
-            const contentType = ctx.headers['content-type'];
-            if (contentType && !contentType.startsWith('application/json')) {
-                ctx.body = createErrorResponse(null, errors.contentTypeNotSupported(contentType));
+        switch (response.kind) {
+            case 'pass':
+                await next();
                 return;
-            }
-            const body = ctx.request.body;
-            if (body === undefined) {
-                ctx.body = createErrorResponse(null, errors.parseError('Request body not parsed. Ensure body-parsing middleware is applied.'));
+            case 'json':
+                ctx.status = response.status;
+                ctx.set(response.headers);
+                ctx.body = response.body;
                 return;
-            }
-            const authToken = server.getAuthToken((name) => ctx.get(name) || undefined);
-            if (isStreamRequest(body)) {
+            case 'empty':
+                ctx.status = response.status;
+                return;
+            case 'sse': {
                 ctx.respond = false;
                 const res = ctx.res;
-                const controller = new AbortController();
-                res.on('close', () => controller.abort());
-                res.writeHead(200, SSE_HEADERS);
-                await pipeJsonRpcStream(server, body, authToken, controller.signal, (frame) => {
+                res.writeHead(200, response.headers);
+                await response.pipe((frame) => {
                     if (!res.writableEnded && !res.destroyed)
                         res.write(frame);
                 });
@@ -34,20 +54,7 @@ export function a2aKoa(server) {
                     res.end();
                 return;
             }
-            try {
-                const response = await server.handleJsonRpc(body, authToken);
-                if (response === null) {
-                    ctx.status = 204;
-                    return;
-                }
-                ctx.body = response;
-            }
-            catch (error) {
-                ctx.body = createErrorResponse(null, errors.clientJsonRpcError(error, 'A2A request failed'));
-            }
-            return;
         }
-        await next();
     };
 }
 //# sourceMappingURL=koa.js.map

package/dist/adapters/koa.js.map

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

package/dist/adapters/next.d.ts

@@ -1,6 +1,17 @@
 import type { A2AServer } from '../server.js';
+type RouteParams = Record<string, string | string[] | undefined>;
+/** The context Next.js passes a route handler; `agent` is read from a dynamic `[agent]` segment. */
+export interface NextRouteContext {
+    params?: RouteParams | Promise<RouteParams>;
+}
+/**
+ * Next.js App Router handlers for an A2A server. Export `GET` from the route that serves
+ * `/.well-known/agent-card.json` and `POST` from the route at `basePath`. In a dynamic
+ * `[agent]` route they serve that agent's own card and endpoint.
+ */
 export declare function a2aNext(server: A2AServer): {
-    GET(): Promise<Response>;
-    POST(request: Request): Promise<Response>;
+    GET(request: Request, context?: NextRouteContext): Promise<Response>;
+    POST(request: Request, context?: NextRouteContext): Promise<Response>;
 };
+export {};
 //# sourceMappingURL=next.d.ts.map

package/dist/adapters/next.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/adapters/next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAK9C,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS;WAExB,OAAO,CAAC,QAAQ,CAAC;kBAKV,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;EAwDlD"}
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../../src/adapters/next.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAO9C,KAAK,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAEjE,oGAAoG;AACpG,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CAC7C;AAwCD;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS;iBA4BlB,OAAO,YAAY,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;kBAQtD,OAAO,YAAY,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;EAM9E"}