ts-procedures 7.1.2 → 7.2.0

package/README.md

@@ -2,6 +2,14 @@
 
 A TypeScript RPC framework that creates type-safe, schema-validated procedure calls with a single function definition. Define your procedures once and get full type inference, runtime validation and procedure documentation/configuration.
 
+## Goals of this Project
+
+1. Full type safety
+2. Auto generated documentation and client api spec
+3. Fast and performant
+4. Excellent DX (and agent documentation)
+
+
 ## Installation
 
 ```bash

package/agent_config/claude-code/skills/ts-procedures/api-reference.md

@@ -1392,6 +1392,42 @@ type DefinitionInfo = {
 
 ---
 
+## Astro adapter — `ts-procedures/astro`
+
+For Astro apps, mount one or more pre-built Hono apps inside a single catch-all endpoint:
+
+```ts
+// src/pages/api/[...rest].ts
+import { createAstroHandler } from 'ts-procedures/astro'
+import { apiApp } from '../../server/api'
+
+export const { ALL } = createAstroHandler({
+  apps: apiApp,
+  pathPrefix: '/api',
+})
+```
+
+Inside factory-context closures, read Astro's APIContext via `getAstroContext`:
+
+```ts
+import { getAstroContext } from 'ts-procedures/astro'
+
+new HonoAPIAppBuilder()
+  .register(usersAPI, (c) => {
+    const astro = getAstroContext(c)
+    return { db, user: astro.locals.user ?? null }
+  })
+  .build()
+```
+
+Multi-app: pass an array; first non-404 response wins. All-404 falls back to the adapter's own 404. Streams pass through unchanged.
+
+Constraints:
+- Astro 5+ in SSR (or `prerender = false`).
+- Express builders are NOT supported by this adapter — Hono builders only.
+
+---
+
 ## Imports
 
 ```typescript

package/agent_config/claude-code/skills/ts-procedures/patterns.md

@@ -1195,3 +1195,17 @@ const axiosAdapter: ClientAdapter = {
   },
 }
 ```
+
+---
+
+### Astro integration
+
+When a downstream developer is building inside an Astro app, recommend the catch-all pattern:
+
+1. Build the Hono app ONCE in `src/server/api.ts` using `HonoAPIAppBuilder` / `HonoRPCAppBuilder` / `HonoStreamAppBuilder` exactly as you would for any other deployment.
+2. Inside the factory-context closure, call `getAstroContext(c)` to read `locals`, `cookies`, `params`, etc.
+3. Mount the built app(s) in a single catch-all file: `src/pages/api/[...rest].ts`. Use `pathPrefix: '/api'` so your Hono routes don't need to repeat the prefix.
+
+Anti-pattern: don't create one Astro file per procedure — that loses the centralized factory wiring and forces the developer to repeat the context closure.
+
+Anti-pattern: don't try to use `express-rpc` with the Astro adapter. The adapter only accepts Web-Fetch apps (Hono).

package/agent_config/claude-code/skills/ts-procedures-scaffold/SKILL.md

@@ -35,6 +35,7 @@ If either argument is missing, ask the user for `<type>` and `<Name>`.
 | `hono-stream` | `templates/hono-stream.md` | `{{Name}}.stream-rpc.ts`, `{{Name}}.stream-rpc.test.ts` |
 | `hono-api` | `templates/hono-api.md` | `{{Name}}.api.ts`, `{{Name}}.api.test.ts` |
 | `client` | `templates/client.md` | `{{Name}}.client.ts`, `{{Name}}.client.test.ts` |
+| `astro-catchall` | `templates/astro-catchall.md` | `src/pages/api/[...rest].ts` |
 
 ## Rules
 

package/agent_config/claude-code/skills/ts-procedures-scaffold/templates/astro-catchall.md

@@ -0,0 +1,23 @@
+# Astro Catch-All Template
+
+Catch-all Astro API route that serves every ts-procedures route from a single file.
+
+## Implementation — `src/pages/api/[...rest].ts`
+
+```typescript
+// src/pages/api/[...rest].ts
+//
+// Catch-all entry point that serves every ts-procedures route from a single Astro file.
+// Adjust `pathPrefix` to match the directory the file lives in (e.g., '/api' for
+// src/pages/api/[...rest].ts; '/v1' for src/pages/v1/[...rest].ts).
+//
+// Build your Hono app(s) ONCE in a sibling module, then drop them in here.
+
+import { createAstroHandler } from 'ts-procedures/astro'
+import { apiApp } from '../../server/api' // ← your built Hono app(s)
+
+export const { ALL } = createAstroHandler({
+  apps: apiApp,
+  pathPrefix: '/api',
+})
+```

package/agent_config/copilot/copilot-instructions.md

@@ -192,6 +192,10 @@ const app = new HonoAPIAppBuilder({ pathPrefix: '/api' })
 // GET /api/users/:id → 200, POST /api/users → 201
 ```
 
+## Astro adapter
+
+Catch-all endpoint pattern. Build Hono apps once with HonoAPI/RPC/Stream builders, mount via `createAstroHandler` in `src/pages/api/[...rest].ts` with `pathPrefix: '/api'`. Read Astro context inside factory closures with `getAstroContext(c)`. Multi-app dispatch is first-non-404-wins. Express builders are not supported.
+
 ## Error Handling
 
 | Error Class | Trigger | HTTP Status |

package/agent_config/cursor/cursorrules

@@ -192,6 +192,10 @@ const app = new HonoAPIAppBuilder({ pathPrefix: '/api' })
 // GET /api/users/:id → 200, POST /api/users → 201
 ```
 
+## Astro adapter
+
+Catch-all endpoint pattern. Build Hono apps once with HonoAPI/RPC/Stream builders, mount via `createAstroHandler` in `src/pages/api/[...rest].ts` with `pathPrefix: '/api'`. Read Astro context inside factory closures with `getAstroContext(c)`. Multi-app dispatch is first-non-404-wins. Express builders are not supported.
+
 ## Error Handling
 
 | Error Class | Trigger | HTTP Status |

package/build/implementations/http/astro/astro-context.d.ts

@@ -0,0 +1,19 @@
+import type { APIContext } from 'astro';
+import type { Context as HonoContext } from 'hono';
+/**
+ * Internal — stash the Astro APIContext for the Request that Hono will receive.
+ *
+ * The key MUST be the post-rewrite Request (the one passed to `app.fetch`),
+ * because that is what Hono exposes via `c.req.raw` and what `getAstroContext`
+ * reads back. When no `pathPrefix` rewrite happens, this is the same Request
+ * that Astro originally invoked the adapter with.
+ */
+export declare function setAstroContext(request: Request, apiContext: APIContext): void;
+/**
+ * Reads Astro's APIContext from inside a Hono factory-context closure.
+ *
+ * Throws when the request is not in scope — typically because the Hono app
+ * is being served outside the Astro adapter (e.g., bound to a Node listener
+ * or via a different adapter) and the closure was invoked there.
+ */
+export declare function getAstroContext(c: HonoContext): APIContext;

package/build/implementations/http/astro/astro-context.js

@@ -0,0 +1,28 @@
+const astroContextMap = new WeakMap();
+/**
+ * Internal — stash the Astro APIContext for the Request that Hono will receive.
+ *
+ * The key MUST be the post-rewrite Request (the one passed to `app.fetch`),
+ * because that is what Hono exposes via `c.req.raw` and what `getAstroContext`
+ * reads back. When no `pathPrefix` rewrite happens, this is the same Request
+ * that Astro originally invoked the adapter with.
+ */
+export function setAstroContext(request, apiContext) {
+    astroContextMap.set(request, apiContext);
+}
+/**
+ * Reads Astro's APIContext from inside a Hono factory-context closure.
+ *
+ * Throws when the request is not in scope — typically because the Hono app
+ * is being served outside the Astro adapter (e.g., bound to a Node listener
+ * or via a different adapter) and the closure was invoked there.
+ */
+export function getAstroContext(c) {
+    const ctx = astroContextMap.get(c.req.raw);
+    if (!ctx) {
+        throw new Error('getAstroContext was called outside an Astro request scope. ' +
+            'Ensure this Hono app is being served via createAstroHandler when this closure runs.');
+    }
+    return ctx;
+}
+//# sourceMappingURL=astro-context.js.map

package/build/implementations/http/astro/astro-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"astro-context.js","sourceRoot":"","sources":["../../../../src/implementations/http/astro/astro-context.ts"],"names":[],"mappings":"AAGA,MAAM,eAAe,GAAG,IAAI,OAAO,EAAuB,CAAA;AAE1D;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgB,EAAE,UAAsB;IACtE,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;AAC1C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,CAAc;IAC5C,MAAM,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IAC1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,6DAA6D;YAC3D,qFAAqF,CACxF,CAAA;IACH,CAAC;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/build/implementations/http/astro/create-handler.d.ts

@@ -0,0 +1,26 @@
+import type { Hono } from 'hono';
+import type { APIRoute } from 'astro';
+export type AstroAdapterConfig = {
+    /** One or more built Hono apps. Order matters in first-match dispatch. */
+    apps: Hono | Hono[];
+    /**
+     * Path prefix matching the Astro catch-all mount point.
+     * For src/pages/api/[...rest].ts use '/api'. The adapter strips this
+     * before delegating, so Hono routes do NOT need to repeat the prefix.
+     *
+     * Normalization: leading and trailing slashes are optional; '/api',
+     * 'api', and '/api/' are equivalent. Undefined or '/' means no rewrite.
+     */
+    pathPrefix?: string;
+};
+export type AstroHandlers = {
+    ALL: APIRoute;
+    GET: APIRoute;
+    POST: APIRoute;
+    PUT: APIRoute;
+    PATCH: APIRoute;
+    DELETE: APIRoute;
+    HEAD: APIRoute;
+    OPTIONS: APIRoute;
+};
+export declare function createAstroHandler(config: AstroAdapterConfig): AstroHandlers;

package/build/implementations/http/astro/create-handler.js

@@ -0,0 +1,28 @@
+import { setAstroContext } from './astro-context.js';
+import { stripPrefix } from './rewrite-request.js';
+const HTTP_METHODS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS'];
+export function createAstroHandler(config) {
+    const apps = Array.isArray(config.apps) ? config.apps : [config.apps];
+    if (apps.length === 0) {
+        throw new Error('createAstroHandler: `apps` must contain at least one Hono app.');
+    }
+    const ALL = async (apiContext) => {
+        const rewritten = stripPrefix(apiContext.request, config.pathPrefix);
+        if (rewritten === null) {
+            return new Response(null, { status: 404 });
+        }
+        setAstroContext(rewritten, apiContext);
+        for (const app of apps) {
+            const res = await app.fetch(rewritten);
+            if (res.status !== 404)
+                return res;
+        }
+        return new Response(null, { status: 404 });
+    };
+    const handlers = { ALL };
+    for (const method of HTTP_METHODS) {
+        handlers[method] = ALL;
+    }
+    return handlers;
+}
+//# sourceMappingURL=create-handler.js.map

package/build/implementations/http/astro/create-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-handler.js","sourceRoot":"","sources":["../../../../src/implementations/http/astro/create-handler.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AA2BlD,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,CAAU,CAAA;AAE1F,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC3D,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IAErE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAA;IACnF,CAAC;IAED,MAAM,GAAG,GAAa,KAAK,EAAE,UAAU,EAAE,EAAE;QACzC,MAAM,SAAS,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,CAAC,CAAA;QACpE,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;YACvB,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;QAC5C,CAAC;QACD,eAAe,CAAC,SAAS,EAAE,UAAU,CAAC,CAAA;QAEtC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;YACtC,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;gBAAE,OAAO,GAAG,CAAA;QACpC,CAAC;QACD,OAAO,IAAI,QAAQ,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAA;IAC5C,CAAC,CAAA;IAED,MAAM,QAAQ,GAAG,EAAE,GAAG,EAAmB,CAAA;IACzC,KAAK,MAAM,MAAM,IAAI,YAAY,EAAE,CAAC;QAClC,QAAQ,CAAC,MAAM,CAAC,GAAG,GAAG,CAAA;IACxB,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC"}

package/build/implementations/http/astro/index.d.ts

@@ -0,0 +1,3 @@
+export { createAstroHandler } from './create-handler.js';
+export type { AstroAdapterConfig, AstroHandlers } from './create-handler.js';
+export { getAstroContext } from './astro-context.js';

package/build/implementations/http/astro/index.js

@@ -0,0 +1,6 @@
+// Public surface for ts-procedures/astro.
+// Note: setAstroContext is intentionally NOT re-exported — it's an
+// internal helper used only by createAstroHandler.
+export { createAstroHandler } from './create-handler.js';
+export { getAstroContext } from './astro-context.js';
+//# sourceMappingURL=index.js.map

package/build/implementations/http/astro/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/implementations/http/astro/index.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,mEAAmE;AACnE,mDAAmD;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAA"}

package/build/implementations/http/astro/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/build/implementations/http/astro/index.test.js

@@ -0,0 +1,295 @@
+import { describe, expect, test } from 'vitest';
+import { Hono } from 'hono';
+import { Type } from 'typebox';
+import { stripPrefix } from './rewrite-request.js';
+import { setAstroContext, getAstroContext } from './astro-context.js';
+import { createAstroHandler } from './create-handler.js';
+import { Procedures } from '../../../index.js';
+import { HonoAPIAppBuilder } from '../hono-api/index.js';
+import { HonoStreamAppBuilder } from '../hono-stream/index.js';
+// Minimal stand-in for Astro's APIContext for unit tests.
+function fakeApiContext(overrides = {}) {
+    return {
+        locals: { user: { id: 'u-1' } },
+        cookies: {},
+        params: {},
+        request: new Request('https://example.test/'),
+        url: new URL('https://example.test/'),
+        redirect: () => new Response(null, { status: 302 }),
+        ...overrides,
+    };
+}
+function buildSimpleUserApi() {
+    const API = Procedures();
+    API.Create('GetUser', {
+        path: '/users/:id',
+        method: 'get',
+        schema: {
+            input: { pathParams: Type.Object({ id: Type.String() }) },
+            returnType: Type.Object({ id: Type.String(), name: Type.String() }),
+        },
+    }, async (ctx, { pathParams }) => {
+        const u = ctx.db.get(pathParams.id);
+        if (!u)
+            throw new Error('not found');
+        return u;
+    });
+    const db = new Map([['1', { id: '1', name: 'Ada' }]]);
+    return new HonoAPIAppBuilder().register(API, () => ({ db })).build();
+}
+describe('stripPrefix', () => {
+    test('returns original request when prefix is undefined', () => {
+        const req = new Request('https://example.test/api/users/1');
+        expect(stripPrefix(req, undefined)).toBe(req);
+    });
+    test('returns original request when normalized prefix is "/"', () => {
+        const req = new Request('https://example.test/users/1');
+        expect(stripPrefix(req, '/')).toBe(req);
+        expect(stripPrefix(req, '')).toBe(req);
+    });
+    test('strips a leading-slash prefix', () => {
+        const req = new Request('https://example.test/api/users/1');
+        const out = stripPrefix(req, '/api');
+        expect(new URL(out.url).pathname).toBe('/users/1');
+    });
+    test('strips a no-slash prefix (normalized)', () => {
+        const req = new Request('https://example.test/api/users/1');
+        const out = stripPrefix(req, 'api');
+        expect(new URL(out.url).pathname).toBe('/users/1');
+    });
+    test('strips a trailing-slash prefix (normalized)', () => {
+        const req = new Request('https://example.test/api/users/1');
+        const out = stripPrefix(req, '/api/');
+        expect(new URL(out.url).pathname).toBe('/users/1');
+    });
+    test('exact-match prefix becomes "/"', () => {
+        const req = new Request('https://example.test/api');
+        const out = stripPrefix(req, '/api');
+        expect(new URL(out.url).pathname).toBe('/');
+    });
+    test('returns null when path does not start with prefix (404 short-circuit)', () => {
+        const req = new Request('https://example.test/other/users/1');
+        expect(stripPrefix(req, '/api')).toBeNull();
+    });
+    test('returns null when path shares prefix characters but not a segment boundary', () => {
+        // /apikey starts with /api but is not under /api — must NOT rewrite.
+        expect(stripPrefix(new Request('https://example.test/apikey/secret'), '/api')).toBeNull();
+        expect(stripPrefix(new Request('https://example.test/api-v2/x'), '/api')).toBeNull();
+        expect(stripPrefix(new Request('https://example.test/api_internal'), '/api')).toBeNull();
+    });
+    test('preserves the query string through the rewrite', () => {
+        const req = new Request('https://example.test/api/users?limit=10&tag=a&tag=b');
+        const out = stripPrefix(req, '/api');
+        const url = new URL(out.url);
+        expect(url.pathname).toBe('/users');
+        expect(url.search).toBe('?limit=10&tag=a&tag=b');
+    });
+    test('preserves the request method', () => {
+        const req = new Request('https://example.test/api/users', { method: 'POST' });
+        const out = stripPrefix(req, '/api');
+        expect(out.method).toBe('POST');
+    });
+    test('preserves headers', () => {
+        const req = new Request('https://example.test/api/users', {
+            method: 'POST',
+            headers: { 'X-Trace-Id': 'abc-123', 'Content-Type': 'application/json' },
+        });
+        const out = stripPrefix(req, '/api');
+        expect(out.headers.get('X-Trace-Id')).toBe('abc-123');
+        expect(out.headers.get('Content-Type')).toBe('application/json');
+    });
+});
+describe('astro-context', () => {
+    test('getAstroContext returns the APIContext stashed for the request seen by Hono', async () => {
+        const req = new Request('https://example.test/probe');
+        const apiContext = fakeApiContext();
+        setAstroContext(req, apiContext);
+        const app = new Hono();
+        let observed = null;
+        app.get('/probe', (c) => {
+            observed = getAstroContext(c);
+            return c.json({ ok: true });
+        });
+        const res = await app.fetch(req);
+        expect(res.status).toBe(200);
+        expect(observed).toBe(apiContext);
+    });
+    test('getAstroContext throws when called outside an Astro request scope', async () => {
+        const app = new Hono();
+        let captured = null;
+        app.get('/probe', (c) => {
+            try {
+                getAstroContext(c);
+            }
+            catch (err) {
+                captured = err;
+            }
+            return c.json({ ok: true });
+        });
+        await app.fetch(new Request('https://example.test/probe'));
+        expect(captured).toBeInstanceOf(Error);
+        expect(captured.message).toMatch(/outside an Astro request scope/i);
+    });
+});
+describe('createAstroHandler — single app, no prefix', () => {
+    test('exports ALL plus the seven HTTP method handlers', () => {
+        const handlers = createAstroHandler({ apps: buildSimpleUserApi() });
+        expect(typeof handlers.ALL).toBe('function');
+        for (const m of ['GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS']) {
+            expect(typeof handlers[m]).toBe('function');
+        }
+    });
+    test('GET roundtrips through the underlying Hono app', async () => {
+        const { ALL } = createAstroHandler({ apps: buildSimpleUserApi() });
+        const apiContext = fakeApiContext({
+            request: new Request('https://example.test/users/1'),
+            url: new URL('https://example.test/users/1'),
+        });
+        const res = await ALL(apiContext);
+        expect(res.status).toBe(200);
+        expect(await res.json()).toEqual({ id: '1', name: 'Ada' });
+    });
+});
+describe('createAstroHandler — pathPrefix + getAstroContext', () => {
+    test('strips pathPrefix before delegating', async () => {
+        // Underlying Hono app has no /api in its routes.
+        const app = buildSimpleUserApi();
+        const { ALL } = createAstroHandler({ apps: app, pathPrefix: '/api' });
+        const apiContext = fakeApiContext({
+            request: new Request('https://example.test/api/users/1'),
+            url: new URL('https://example.test/api/users/1'),
+        });
+        const res = await ALL(apiContext);
+        expect(res.status).toBe(200);
+        expect(await res.json()).toEqual({ id: '1', name: 'Ada' });
+    });
+    test('returns 404 directly when request path is outside the prefix', async () => {
+        const { ALL } = createAstroHandler({ apps: buildSimpleUserApi(), pathPrefix: '/api' });
+        const apiContext = fakeApiContext({
+            request: new Request('https://example.test/somewhere-else'),
+            url: new URL('https://example.test/somewhere-else'),
+        });
+        const res = await ALL(apiContext);
+        expect(res.status).toBe(404);
+    });
+    test('factory closure can read APIContext via getAstroContext', async () => {
+        const API = Procedures();
+        API.Create('WhoAmI', { path: '/whoami', method: 'get', schema: { returnType: Type.Object({ userId: Type.Union([Type.String(), Type.Null()]) }) } }, async (ctx) => ({ userId: ctx.user?.id ?? null }));
+        const app = new HonoAPIAppBuilder()
+            .register(API, (c) => {
+            const astro = getAstroContext(c);
+            return { user: astro.locals.user ?? null };
+        })
+            .build();
+        const { ALL } = createAstroHandler({ apps: app });
+        const apiContext = fakeApiContext({
+            locals: { user: { id: 'u-42' } },
+            request: new Request('https://example.test/whoami'),
+            url: new URL('https://example.test/whoami'),
+        });
+        const res = await ALL(apiContext);
+        expect(res.status).toBe(200);
+        expect(await res.json()).toEqual({ userId: 'u-42' });
+    });
+});
+describe('createAstroHandler — multi-app dispatch', () => {
+    function makeAppWithRoute(path, status, body) {
+        const app = new Hono();
+        app.all(path, (c) => c.json(body, status));
+        return app;
+    }
+    test('first 404 falls through to the second app', async () => {
+        const a = makeAppWithRoute('/only-a', 200, { from: 'a' });
+        const b = makeAppWithRoute('/only-b', 200, { from: 'b' });
+        const { ALL } = createAstroHandler({ apps: [a, b] });
+        const apiContext = fakeApiContext({
+            request: new Request('https://example.test/only-b'),
+            url: new URL('https://example.test/only-b'),
+        });
+        const res = await ALL(apiContext);
+        expect(res.status).toBe(200);
+        expect(await res.json()).toEqual({ from: 'b' });
+    });
+    test('a non-404 response from the first app short-circuits dispatch', async () => {
+        const a = makeAppWithRoute('/error', 500, { boom: true });
+        const b = makeAppWithRoute('/error', 200, { from: 'b' });
+        const { ALL } = createAstroHandler({ apps: [a, b] });
+        const apiContext = fakeApiContext({
+            request: new Request('https://example.test/error'),
+            url: new URL('https://example.test/error'),
+        });
+        const res = await ALL(apiContext);
+        expect(res.status).toBe(500);
+        expect(await res.json()).toEqual({ boom: true });
+    });
+    test('all-404 returns the adapter\'s own 404 with empty body', async () => {
+        const a = makeAppWithRoute('/x', 200, { from: 'a' });
+        const b = makeAppWithRoute('/y', 200, { from: 'b' });
+        const { ALL } = createAstroHandler({ apps: [a, b] });
+        const apiContext = fakeApiContext({
+            request: new Request('https://example.test/nope'),
+            url: new URL('https://example.test/nope'),
+        });
+        const res = await ALL(apiContext);
+        expect(res.status).toBe(404);
+        expect(await res.text()).toBe('');
+    });
+});
+describe('createAstroHandler — streams', () => {
+    test('SSE events from a HonoStream builder pass through the adapter', async () => {
+        const STREAM = Procedures();
+        STREAM.CreateStream('Counter', {
+            scope: 'counter',
+            version: 1,
+            schema: {
+                yieldType: Type.Object({ n: Type.Number() }),
+            },
+        }, async function* () {
+            yield { n: 1 };
+            yield { n: 2 };
+            yield { n: 3 };
+        });
+        const streamApp = new HonoStreamAppBuilder().register(STREAM, () => ({})).build();
+        const { ALL } = createAstroHandler({ apps: streamApp });
+        const apiContext = fakeApiContext({
+            request: new Request('https://example.test/counter/counter/1', { method: 'GET' }),
+            url: new URL('https://example.test/counter/counter/1'),
+        });
+        const res = await ALL(apiContext);
+        expect(res.status).toBe(200);
+        expect(res.headers.get('content-type')).toContain('text/event-stream');
+        // Drain the SSE body and assert all three events appear in order.
+        const text = await res.text();
+        expect(text).toContain('event: Counter');
+        expect(text).toContain('data: {"n":1}');
+        expect(text).toContain('data: {"n":2}');
+        expect(text).toContain('data: {"n":3}');
+    });
+});
+describe('createAstroHandler — abort signal', () => {
+    test("aborting the incoming request aborts the procedure handler's ctx.signal", async () => {
+        let observedSignal;
+        const aborted = new Promise((resolve) => {
+            const API = Procedures();
+            API.Create('Hang', { path: '/hang', method: 'get', schema: { returnType: Type.Object({ ok: Type.Boolean() }) } }, async (ctx) => {
+                observedSignal = ctx.signal;
+                ctx.signal?.addEventListener('abort', () => resolve(), { once: true });
+                // Wait for abort or a generous timeout.
+                await new Promise((r) => setTimeout(r, 200));
+                return { ok: true };
+            });
+            const app = new HonoAPIAppBuilder().register(API, () => ({})).build();
+            const { ALL } = createAstroHandler({ apps: app });
+            const controller = new AbortController();
+            const apiContext = fakeApiContext({
+                request: new Request('https://example.test/hang', { signal: controller.signal }),
+                url: new URL('https://example.test/hang'),
+            });
+            ALL(apiContext).catch(() => { });
+            setTimeout(() => controller.abort(), 20);
+        });
+        await aborted;
+        expect(observedSignal?.aborted).toBe(true);
+    });
+});
+//# sourceMappingURL=index.test.js.map

package/build/implementations/http/astro/index.test.js.map

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

package/build/implementations/http/astro/rewrite-request.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Returns a Request with `prefix` stripped from the URL pathname.
+ *
+ * - `prefix` undefined or normalizing to '/' → returns the original request unchanged.
+ * - Path does not start with the normalized prefix at a segment boundary → returns `null`
+ *   (caller short-circuits to 404). E.g. with prefix '/api', the request '/apikey'
+ *   returns null because 'key' is not preceded by a path separator.
+ * - Otherwise → returns a new Request with the rewritten URL and method/headers/body/signal/duplex
+ *   preserved via `new Request(url, init)`.
+ *
+ * Normalization: leading and trailing slashes are optional. '/api', 'api', and '/api/' are equivalent.
+ */
+export declare function stripPrefix(request: Request, prefix: string | undefined): Request | null;

package/build/implementations/http/astro/rewrite-request.js

@@ -0,0 +1,32 @@
+/**
+ * Returns a Request with `prefix` stripped from the URL pathname.
+ *
+ * - `prefix` undefined or normalizing to '/' → returns the original request unchanged.
+ * - Path does not start with the normalized prefix at a segment boundary → returns `null`
+ *   (caller short-circuits to 404). E.g. with prefix '/api', the request '/apikey'
+ *   returns null because 'key' is not preceded by a path separator.
+ * - Otherwise → returns a new Request with the rewritten URL and method/headers/body/signal/duplex
+ *   preserved via `new Request(url, init)`.
+ *
+ * Normalization: leading and trailing slashes are optional. '/api', 'api', and '/api/' are equivalent.
+ */
+export function stripPrefix(request, prefix) {
+    if (prefix === undefined)
+        return request;
+    const normalized = '/' + prefix.replace(/^\/|\/$/g, '');
+    if (normalized === '/')
+        return request;
+    const url = new URL(request.url);
+    if (!url.pathname.startsWith(normalized))
+        return null;
+    // Segment-boundary guard: the character right after the prefix in the path
+    // MUST be either undefined (exact match) or '/' (real segment boundary).
+    // Without this, '/apikey' would falsely match prefix '/api'.
+    const nextChar = url.pathname[normalized.length];
+    if (nextChar !== undefined && nextChar !== '/')
+        return null;
+    const rest = url.pathname.slice(normalized.length);
+    url.pathname = rest === '' ? '/' : rest;
+    return new Request(url, request);
+}
+//# sourceMappingURL=rewrite-request.js.map