@apiquest/plugin-sse 1.0.2

package/README.md

@@ -0,0 +1,160 @@
+# @apiquest/plugin-sse
+
+Server-Sent Events (SSE) protocol plugin for ApiQuest. Provides support for testing SSE endpoints with event streaming and message validation.
+
+## Installation
+
+```bash
+npm install -g @apiquest/plugin-sse
+```
+
+## Features
+
+- SSE connection management
+- Event streaming with named events
+- Message data validation
+- Event counting and assertions
+- Custom headers support
+- Authentication integration (via `@apiquest/plugin-auth`)
+- Timeout configuration
+
+## Usage
+
+Set the collection protocol to `sse`:
+
+```json
+{
+  "$schema": "https://apiquest.net/schemas/collection-v1.0.json",
+  "protocol": "sse",
+  "items": [
+    {
+      "type": "request",
+      "id": "stream-events",
+      "name": "Stream Server Events",
+      "data": {
+        "url": "https://api.example.com/events",
+        "timeout": 30000,
+        "scripts": [
+          {
+            "event": "onMessage",
+            "script": "quest.test('Message received', () => {\n  const msg = quest.message;\n  expect(msg.data).to.be.a('string');\n});"
+          },
+          {
+            "event": "onComplete",
+            "script": "quest.test('Stream completed', () => {\n  expect(quest.messages.length).to.be.greaterThan(0);\n});"
+          }
+        ]
+      }
+    }
+  ]
+}
+```
+
+### With Custom Headers
+
+```json
+{
+  "data": {
+    "url": "https://api.example.com/stream",
+    "headers": {
+      "Accept": "text/event-stream",
+      "x-stream-id": "{{streamId}}"
+    },
+    "timeout": 60000
+  }
+}
+```
+
+### Event Scripts
+
+SSE requests support event-based scripts:
+
+- **onMessage** - Runs for each received message
+- **onError** - Runs when an error occurs
+- **onComplete** - Runs when the stream completes
+
+```json
+{
+  "data": {
+    "scripts": [
+      {
+        "event": "onMessage",
+        "script": "const data = JSON.parse(quest.message.data);\nquest.variables.set('lastEventId', data.id);\n\nquest.test('Valid event data', () => {\n  expect(data).to.have.property('timestamp');\n});"
+      },
+      {
+        "event": "onError",
+        "script": "console.error('Stream error:', quest.error);"
+      },
+      {
+        "event": "onComplete",
+        "script": "quest.test('Received messages', () => {\n  expect(quest.messages.length).to.equal(10);\n});"
+      }
+    ]
+  }
+}
+```
+
+### Message Counting
+
+Use `quest.expectMessages()` in the preRequestScript to enable deterministic test counting:
+
+```json
+{
+  "type": "request",
+  "id": "stream-events",
+  "name": "Stream Server Events",
+  "preRequestScript": "quest.expectMessages(5, 10000);",
+  "data": {
+    "url": "https://api.example.com/events",
+    "scripts": [
+      {
+        "event": "onMessage",
+        "script": "quest.test('Message received', () => {\n  expect(quest.message.data).to.exist;\n});"
+      }
+    ]
+  }
+}
+```
+
+This informs the runner to expect 5 messages, enabling accurate test count reporting (5 messages × tests per message).
+
+## Response Handling
+
+Access SSE data in scripts:
+
+```javascript
+// In onMessage script
+quest.test('Event has data', () => {
+  expect(quest.message.data).to.be.a('string');
+});
+
+quest.test('Event type is update', () => {
+  expect(quest.message.event).to.equal('update');
+});
+
+// In onComplete script
+quest.test('Received all messages', () => {
+  expect(quest.messages.length).to.equal(5);
+});
+
+quest.test('All messages valid', () => {
+  quest.messages.forEach(msg => {
+    const data = JSON.parse(msg.data);
+    expect(data).to.have.property('id');
+  });
+});
+```
+
+## Compatibility
+
+- **Authentication:** Works with `@apiquest/plugin-auth` for Bearer, Basic, API Key
+- **Node.js:** Requires Node.js 20+
+
+## Documentation
+
+- [Fracture Documentation](https://apiquest.net/docs/fracture)
+- [Schema Reference](https://apiquest.net/schemas/collection-v1.0.json)
+
+## License
+
+Dual-licensed under AGPL-3.0-or-later and commercial license. See LICENSE.txt for details.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { IProtocolPlugin } from '@apiquest/types';
+export declare const ssePlugin: IProtocolPlugin;
+export default ssePlugin;
+//# 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,KAAK,EAAE,eAAe,EAA2G,MAAM,iBAAiB,CAAC;AAkBhK,eAAO,MAAM,SAAS,EAAE,eA8WvB,CAAC;AAEF,eAAe,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,341 @@
+// Helper functions for string validation
+function isNullOrWhitespace(value) {
+    return value === null || value === undefined || value.trim() === '';
+}
+const ssePlugin = {
+    name: 'SSE Client',
+    version: '1.0.0',
+    description: 'Server-Sent Events (SSE) protocol support',
+    // What protocols this plugin provides
+    protocols: ['sse'],
+    // Supported authentication types
+    supportedAuthTypes: ['bearer', 'basic', 'apikey', 'none'],
+    // Accept additional auth plugins beyond the listed types
+    strictAuthList: false,
+    // Data schema for SSE requests
+    dataSchema: {
+        type: 'object',
+        required: ['url'],
+        properties: {
+            url: {
+                type: 'string',
+                description: 'SSE endpoint URL'
+            },
+            timeout: {
+                type: 'number',
+                description: 'Connection timeout in milliseconds',
+                default: 30000
+            },
+            headers: {
+                type: 'object',
+                description: 'HTTP headers',
+                additionalProperties: { type: 'string' }
+            }
+        }
+    },
+    // Options schema for runtime configuration
+    optionsSchema: {
+        timeout: {
+            type: 'number',
+            default: 30000,
+            description: 'Request timeout in milliseconds'
+        }
+    },
+    // Plugin events
+    events: [
+        {
+            name: 'onMessage',
+            description: 'Fired when an SSE message is received',
+            canHaveTests: true,
+            required: false
+        },
+        {
+            name: 'onError',
+            description: 'Fired when an error occurs during streaming',
+            canHaveTests: false,
+            required: false
+        },
+        {
+            name: 'onComplete',
+            description: 'Fired when the SSE stream completes',
+            canHaveTests: true,
+            required: false
+        }
+    ],
+    async execute(request, context, options, emitEvent, logger) {
+        const startTime = Date.now();
+        const url = String(request.data.url ?? '');
+        if (isNullOrWhitespace(url)) {
+            logger?.error('SSE request missing URL');
+            throw new Error('URL is required for SSE requests');
+        }
+        const headers = typeof request.data.headers === 'object' && request.data.headers !== null
+            ? Object.fromEntries(Object.entries(request.data.headers).map(([k, v]) => [k, String(v)]))
+            : {};
+        const sseOptions = options.plugins?.sse ?? {};
+        const sseTimeout = typeof sseOptions.timeout === 'number' ? sseOptions.timeout : null;
+        const timeout = (typeof request.data.timeout === 'number' ? request.data.timeout : null) ?? options.timeout?.request ?? sseTimeout ?? 30000;
+        logger?.debug('SSE request starting', { url, timeout });
+        const messages = [];
+        let messageCount = 0;
+        return new Promise((resolve, reject) => {
+            const controller = new AbortController();
+            const timeoutId = setTimeout(() => {
+                controller.abort();
+                logger?.debug('SSE connection timeout', { url, messageCount, duration: Date.now() - startTime });
+                resolve({
+                    status: 200,
+                    statusText: 'Stream Complete (Timeout)',
+                    body: JSON.stringify({ messages, count: messageCount }),
+                    headers: {},
+                    duration: Date.now() - startTime,
+                    messageCount,
+                    messages
+                });
+            }, timeout);
+            try {
+                // Use fetch with streaming which is more universally supported in Node.js
+                const signal = context.abortSignal || controller.signal;
+                // Handle abort signal
+                if (context.abortSignal) {
+                    context.abortSignal.addEventListener('abort', () => {
+                        controller.abort();
+                        clearTimeout(timeoutId);
+                        logger?.debug('SSE request aborted', { url, messageCount, duration: Date.now() - startTime });
+                        resolve({
+                            status: 0,
+                            statusText: 'Aborted',
+                            body: JSON.stringify({ messages, count: messageCount }),
+                            headers: {},
+                            duration: Date.now() - startTime,
+                            error: 'Request aborted',
+                            messageCount,
+                            messages
+                        });
+                    });
+                }
+                // Use fetch with streaming
+                fetch(url, {
+                    method: 'GET',
+                    headers: {
+                        ...headers,
+                        'Accept': 'text/event-stream',
+                        'Cache-Control': 'no-cache'
+                    },
+                    signal
+                }).then(async (response) => {
+                    if (!response.ok) {
+                        clearTimeout(timeoutId);
+                        logger?.warn('SSE connection failed', { status: response.status, statusText: response.statusText });
+                        resolve({
+                            status: response.status,
+                            statusText: response.statusText,
+                            body: await response.text(),
+                            headers: Object.fromEntries(response.headers.entries()),
+                            duration: Date.now() - startTime,
+                            messageCount: 0,
+                            messages: []
+                        });
+                        return;
+                    }
+                    if (!response.body) {
+                        clearTimeout(timeoutId);
+                        logger?.error('SSE response has no body');
+                        resolve({
+                            status: response.status,
+                            statusText: 'No Body',
+                            body: '',
+                            headers: Object.fromEntries(response.headers.entries()),
+                            duration: Date.now() - startTime,
+                            messageCount: 0,
+                            messages: []
+                        });
+                        return;
+                    }
+                    const reader = response.body.getReader();
+                    const decoder = new TextDecoder();
+                    let buffer = '';
+                    const processLine = async (line) => {
+                        if (line.startsWith('data:')) {
+                            const data = line.slice(5).trim();
+                            const message = { data };
+                            messages.push(message);
+                            messageCount++;
+                            logger?.trace('SSE message received', { messageCount, data: data.slice(0, 100) });
+                            // Emit onMessage event
+                            if (emitEvent) {
+                                try {
+                                    await emitEvent('onMessage', {
+                                        index: messageCount,
+                                        data: message
+                                    });
+                                }
+                                catch (err) {
+                                    logger?.error('SSE onMessage event error', { error: err instanceof Error ? err.message : String(err) });
+                                }
+                            }
+                        }
+                        else if (line.startsWith('event:')) {
+                            const lastMessage = messages[messages.length - 1];
+                            if (lastMessage) {
+                                lastMessage.event = line.slice(6).trim();
+                            }
+                        }
+                        else if (line.startsWith('id:')) {
+                            const lastMessage = messages[messages.length - 1];
+                            if (lastMessage) {
+                                lastMessage.id = line.slice(3).trim();
+                            }
+                        }
+                        else if (line.startsWith('retry:')) {
+                            const lastMessage = messages[messages.length - 1];
+                            if (lastMessage) {
+                                lastMessage.retry = parseInt(line.slice(6).trim(), 10);
+                            }
+                        }
+                    };
+                    try {
+                        while (true) {
+                            const { done, value } = await reader.read();
+                            if (done) {
+                                // Process remaining buffer
+                                if (buffer.trim()) {
+                                    const lines = buffer.split('\n');
+                                    for (const line of lines) {
+                                        if (line.trim()) {
+                                            await processLine(line);
+                                        }
+                                    }
+                                }
+                                clearTimeout(timeoutId);
+                                logger?.debug('SSE stream complete', { messageCount, duration: Date.now() - startTime });
+                                // Emit onComplete event
+                                if (emitEvent) {
+                                    try {
+                                        await emitEvent('onComplete', { messageCount, messages });
+                                    }
+                                    catch (err) {
+                                        logger?.error('SSE onComplete event error', { error: err instanceof Error ? err.message : String(err) });
+                                    }
+                                }
+                                resolve({
+                                    status: response.status,
+                                    statusText: 'Stream Complete',
+                                    body: JSON.stringify({ messages, count: messageCount }),
+                                    headers: Object.fromEntries(response.headers.entries()),
+                                    duration: Date.now() - startTime,
+                                    messageCount,
+                                    messages
+                                });
+                                break;
+                            }
+                            // Decode chunk and add to buffer
+                            buffer += decoder.decode(value, { stream: true });
+                            // Process complete lines
+                            const lines = buffer.split('\n');
+                            buffer = lines.pop() || ''; // Keep incomplete line in buffer
+                            for (const line of lines) {
+                                if (line.trim()) {
+                                    await processLine(line);
+                                }
+                            }
+                        }
+                    }
+                    catch (err) {
+                        clearTimeout(timeoutId);
+                        // Check if it was aborted
+                        if (signal.aborted) {
+                            logger?.debug('SSE stream aborted', { messageCount, duration: Date.now() - startTime });
+                            resolve({
+                                status: 0,
+                                statusText: 'Aborted',
+                                body: JSON.stringify({ messages, count: messageCount }),
+                                headers: {},
+                                duration: Date.now() - startTime,
+                                error: 'Request aborted',
+                                messageCount,
+                                messages
+                            });
+                        }
+                        else {
+                            logger?.error('SSE stream error', { error: err instanceof Error ? err.message : String(err) });
+                            // Emit onError event
+                            if (emitEvent) {
+                                try {
+                                    await emitEvent('onError', { error: err instanceof Error ? err.message : String(err) });
+                                }
+                                catch (emitErr) {
+                                    logger?.error('SSE onError event error', { error: emitErr instanceof Error ? emitErr.message : String(emitErr) });
+                                }
+                            }
+                            resolve({
+                                status: 0,
+                                statusText: 'Stream Error',
+                                body: JSON.stringify({ messages, count: messageCount }),
+                                headers: {},
+                                duration: Date.now() - startTime,
+                                error: err instanceof Error ? err.message : String(err),
+                                messageCount,
+                                messages
+                            });
+                        }
+                    }
+                }).catch((err) => {
+                    clearTimeout(timeoutId);
+                    logger?.error('SSE fetch error', { error: err instanceof Error ? err.message : String(err) });
+                    // Emit onError event
+                    if (emitEvent) {
+                        emitEvent('onError', { error: err instanceof Error ? err.message : String(err) }).catch((emitErr) => {
+                            logger?.error('SSE onError event error', { error: emitErr instanceof Error ? emitErr.message : String(emitErr) });
+                        });
+                    }
+                    resolve({
+                        status: 0,
+                        statusText: 'Connection Error',
+                        body: '',
+                        headers: {},
+                        duration: Date.now() - startTime,
+                        error: err instanceof Error ? err.message : String(err),
+                        messageCount: 0,
+                        messages: []
+                    });
+                });
+            }
+            catch (err) {
+                clearTimeout(timeoutId);
+                logger?.error('SSE unexpected error', { error: err instanceof Error ? err.message : String(err) });
+                resolve({
+                    status: 0,
+                    statusText: 'Error',
+                    body: '',
+                    headers: {},
+                    duration: Date.now() - startTime,
+                    error: err instanceof Error ? err.message : String(err),
+                    messageCount: 0,
+                    messages: []
+                });
+            }
+        });
+    },
+    validate(request, options) {
+        const errors = [];
+        // Check URL
+        if (typeof request.data.url !== 'string' || isNullOrWhitespace(request.data.url)) {
+            errors.push({
+                message: 'URL is required',
+                location: '',
+                source: 'protocol'
+            });
+        }
+        if (errors.length > 0) {
+            return {
+                valid: false,
+                errors
+            };
+        }
+        return { valid: true };
+    }
+};
+
+export { ssePlugin as default, ssePlugin };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,4 @@
+import type { IProtocolPlugin } from '@apiquest/types';
+export declare const httpPlugin: IProtocolPlugin;
+export default httpPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAA2G,MAAM,iBAAiB,CAAC;AAmBhK,eAAO,MAAM,UAAU,EAAE,eAmRxB,CAAC;AAEF,eAAe,UAAU,CAAC"}

package/esbuild.config.js

@@ -0,0 +1,34 @@
+import esbuild from 'esbuild';
+
+await esbuild.build({
+  entryPoints: ['src/index.ts'],
+  bundle: true,
+  outfile: 'dist/index.js',
+  format: 'esm',
+  platform: 'node',
+  target: 'node18',
+  // Externalize peerDependencies and Node.js built-ins
+  external: [
+    '@apiquest/fracture',
+    // Node.js built-in modules (got depends on these)
+    'http',
+    'https',
+    'http2',
+    'net',
+    'tls',
+    'stream',
+    'util',
+    'url',
+    'zlib',
+    'events',
+    'buffer',
+    'querystring',
+    'dns',
+    'fs',
+    'path',
+  ],
+  minify: false,
+  sourcemap: true,
+});
+
+console.log('✓ Built plugin-sse');

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@apiquest/plugin-sse",
+  "version": "1.0.2",
+  "description": "SSE protocol plugin for Quest",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "rollup -c && tsc --emitDeclarationOnly",
+    "dev": "rollup -c --watch",
+    "test": "vitest"
+  },
+  "keywords": [
+    "api",
+    "http",
+    "quest",
+    "plugin"
+  ],
+  "author": "ApiQuest",
+  "license": "AGPL-3.0-or-later",
+  "dependencies": {
+    "got": "^14.6.6",
+    "hpagent": "^1.2.0"
+  },
+  "devDependencies": {
+    "@apiquest/types": "workspace:*",
+    "@rollup/plugin-commonjs": "^25.0.0",
+    "@rollup/plugin-node-resolve": "^15.0.0",
+    "@rollup/plugin-typescript": "^11.0.0",
+    "@types/node": "^20.10.6",
+    "rollup": "^4.0.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "@apiquest/types": "^1.0.0"
+  },
+  "apiquest": {
+    "type": "protocol",
+    "runtime": [
+      "fracture"
+    ],
+    "capabilities": {
+      "provides": {
+        "protocols": [
+          "sse"
+        ]
+      },
+      "supports": {
+        "authTypes": [
+          "bearer",
+          "basic",
+          "oauth2",
+          "apikey",
+          "digest",
+          "ntlm"
+        ],
+        "strictAuthList": false
+      }
+    }
+  }
+}

package/rollup.config.js

@@ -0,0 +1,31 @@
+import typescript from '@rollup/plugin-typescript';
+import resolve from '@rollup/plugin-node-resolve';
+import commonjs from '@rollup/plugin-commonjs';
+
+export default {
+  input: 'src/index.ts',
+  output: {
+    file: 'dist/index.js',
+    format: 'esm',
+    sourcemap: true,
+  },
+  external: [
+    // Externalize peer dependencies
+    '@apiquest/fracture',
+  ],
+  plugins: [
+    // Resolve node modules
+    resolve({
+      preferBuiltins: true,  // Prefer Node.js built-in modules
+      exportConditions: ['node', 'import', 'default'],
+    }),
+    // Convert CommonJS to ESM (for any CJS dependencies) 
+    commonjs(),
+    // Compile TypeScript
+    typescript({
+      tsconfig: './tsconfig.json',
+      sourceMap: true,
+      declaration: false, // We'll use tsc for declarations
+    }),
+  ],
+};