@adhd/apigen-plugin-api-fastify 0.1.0

package/lib/generate.d.ts

@@ -0,0 +1,5 @@
+import { HTTP_STATUS } from '@adhd/apigen-errors';
+import { PluginInput, PluginOutput } from '@adhd/apigen-core';
+
+export declare function generate(input: PluginInput): PluginOutput;
+export { HTTP_STATUS };

package/lib/plugin.d.ts

@@ -0,0 +1,4 @@
+import { OutputPlugin } from '@adhd/apigen-core';
+
+export declare const apiFastifyPlugin: OutputPlugin;
+export default apiFastifyPlugin;

package/lib/run.d.ts

@@ -0,0 +1,3 @@
+import { RunInput } from '@adhd/apigen-core';
+
+export declare function run(input: RunInput): Promise<void>;

package/lib/stream.d.ts

@@ -0,0 +1,24 @@
+import { ApiStream } from '@adhd/apigen-runtime';
+import { FastifyRequest, FastifyReply } from 'fastify';
+
+/**
+ * Stream `apiStream` to the HTTP response as SSE.
+ *
+ * Sets `Content-Type: text/event-stream` and `Transfer-Encoding: chunked`.
+ * Each chunk is serialised as a `data: <JSON>\n\n` SSE frame.
+ *
+ * Error handling:
+ * - before first chunk: the reply status is set to the `ApiError` HTTP status
+ *   (or 500) and the body is the `ApiError` JSON (normal §9 path).
+ * - after first chunk: a terminal `event: error\ndata: <JSON>\n\n` frame is
+ *   flushed and the response is ended (Connect semantics).
+ *
+ * Cancellation: when the client disconnects (`req.raw` emits `'close'`), the
+ * in-flight stream is aborted via an internal `AbortController`.  The stream
+ * terminates cleanly (end path — §11).
+ *
+ * @param stream  - the `ApiStream` from the harness
+ * @param req     - the Fastify request (used for client-disconnect detection)
+ * @param reply   - the Fastify reply (raw `res` is used for direct writes)
+ */
+export declare function sendStreamSse(stream: ApiStream<unknown>, req: FastifyRequest, reply: FastifyReply): Promise<void>;

package/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "@adhd/apigen-plugin-api-fastify",
+  "version": "0.1.0",
+  "main": "./index.js",
+  "dependencies": {
+    "@adhd/apigen-core": "^0.1.0",
+    "@adhd/apigen-runtime": "^0.1.0",
+    "fastify": "^4.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "module": "./index.mjs",
+  "types": "./index.d.ts"
+}