@missionsquad/mcp-msq 0.1.0

package/dist/msq-client.js

@@ -0,0 +1,218 @@
+import { readFile } from 'node:fs/promises';
+import { basename } from 'node:path';
+import { appConfig, resolveRequestConfig } from './config.js';
+import { MsqApiError, MsqTransportError } from './errors.js';
+function parseContentLength(rawHeader) {
+    if (!rawHeader) {
+        return null;
+    }
+    const parsed = Number(rawHeader);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return null;
+    }
+    return Math.floor(parsed);
+}
+async function readResponseBodyWithLimit(response, maxBytes) {
+    if (!response.body) {
+        return {
+            buffer: Buffer.alloc(0),
+            bytesRead: 0,
+            truncated: false,
+        };
+    }
+    const reader = response.body.getReader();
+    const chunks = [];
+    let bytesRead = 0;
+    let bytesKept = 0;
+    let truncated = false;
+    while (true) {
+        const { value, done } = await reader.read();
+        if (done) {
+            break;
+        }
+        if (!value) {
+            continue;
+        }
+        bytesRead += value.byteLength;
+        if (bytesKept < maxBytes) {
+            const remaining = maxBytes - bytesKept;
+            const nextSlice = value.byteLength > remaining ? value.subarray(0, remaining) : value;
+            if (nextSlice.byteLength > 0) {
+                chunks.push(Buffer.from(nextSlice));
+                bytesKept += nextSlice.byteLength;
+            }
+        }
+        if (bytesRead > maxBytes) {
+            truncated = true;
+            await reader.cancel();
+            break;
+        }
+    }
+    return {
+        buffer: Buffer.concat(chunks),
+        bytesRead,
+        truncated,
+    };
+}
+export class MissionSquadClient {
+    requestConfig;
+    constructor(requestConfig) {
+        this.requestConfig = requestConfig;
+    }
+    async requestJson(options) {
+        const url = this.buildUrl(options.path, options.query);
+        const headers = {
+            'x-api-key': this.requestConfig.apiKey,
+            ...this.compactHeaders(options.headers),
+        };
+        let body;
+        if (options.body !== undefined) {
+            headers['Content-Type'] = 'application/json';
+            body = JSON.stringify(options.body);
+        }
+        const response = await this.fetchWithTimeout(url, {
+            method: options.method,
+            headers,
+            body,
+        });
+        return this.parseStructuredResponse(response, url);
+    }
+    async uploadFile(options) {
+        const payload = await readFile(options.filePath);
+        const filename = options.filename?.trim() || basename(options.filePath);
+        const form = new FormData();
+        form.append('file', new Blob([payload]), filename);
+        form.append('purpose', options.purpose);
+        if (options.relativePath) {
+            form.append('relativePath', options.relativePath);
+        }
+        if (options.collectionName) {
+            form.append('collectionName', options.collectionName);
+        }
+        const url = this.buildUrl('files');
+        const response = await this.fetchWithTimeout(url, {
+            method: 'POST',
+            headers: {
+                'x-api-key': this.requestConfig.apiKey,
+            },
+            body: form,
+        });
+        return this.parseStructuredResponse(response, url);
+    }
+    async getFileContent(options) {
+        const maxBytes = options.maxBytes ?? this.requestConfig.defaultFileContentMaxBytes;
+        const url = this.buildUrl(`files/${encodeURIComponent(options.fileId)}/content`);
+        const response = await this.fetchWithTimeout(url, {
+            method: 'GET',
+            headers: {
+                'x-api-key': this.requestConfig.apiKey,
+            },
+        });
+        if (!response.ok) {
+            const errorPayload = await this.parseErrorPayload(response);
+            throw new MsqApiError(`MissionSquad API request failed with ${response.status} ${response.statusText}.`, response.status, response.statusText, url, errorPayload);
+        }
+        const limited = await readResponseBodyWithLimit(response, maxBytes);
+        return {
+            contentType: response.headers.get('content-type'),
+            contentLength: parseContentLength(response.headers.get('content-length')),
+            bytesRead: limited.bytesRead,
+            truncated: limited.truncated,
+            base64: limited.buffer.toString('base64'),
+        };
+    }
+    buildUrl(path, query) {
+        const normalizedPath = path.startsWith('/') ? path.slice(1) : path;
+        const baseUrlWithSlash = this.requestConfig.baseUrl.endsWith('/')
+            ? this.requestConfig.baseUrl
+            : `${this.requestConfig.baseUrl}/`;
+        const url = new URL(normalizedPath, baseUrlWithSlash);
+        if (query) {
+            for (const [key, value] of Object.entries(query)) {
+                if (value !== undefined) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        return url.toString();
+    }
+    compactHeaders(headers) {
+        if (!headers) {
+            return {};
+        }
+        const output = {};
+        for (const [key, value] of Object.entries(headers)) {
+            if (value !== undefined) {
+                output[key] = value;
+            }
+        }
+        return output;
+    }
+    async fetchWithTimeout(url, init) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => {
+            controller.abort();
+        }, this.requestConfig.httpTimeoutMs);
+        try {
+            return await fetch(url, {
+                ...init,
+                signal: controller.signal,
+            });
+        }
+        catch (error) {
+            if (error instanceof Error && error.name === 'AbortError') {
+                throw new MsqTransportError(`MissionSquad API request timed out after ${this.requestConfig.httpTimeoutMs}ms.`, error);
+            }
+            throw new MsqTransportError('MissionSquad API request failed before receiving a response.', error);
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    async parseStructuredResponse(response, url) {
+        const payload = await this.parseResponseBody(response);
+        if (!response.ok) {
+            throw new MsqApiError(`MissionSquad API request failed with ${response.status} ${response.statusText}.`, response.status, response.statusText, url, payload);
+        }
+        return payload;
+    }
+    async parseResponseBody(response) {
+        const contentType = response.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json')) {
+            try {
+                return await response.json();
+            }
+            catch {
+                return { parseError: 'Invalid JSON response body.' };
+            }
+        }
+        const text = await response.text();
+        if (text.length === 0) {
+            return null;
+        }
+        return text;
+    }
+    async parseErrorPayload(response) {
+        const contentType = response.headers.get('content-type') ?? '';
+        if (contentType.includes('application/json')) {
+            try {
+                return await response.json();
+            }
+            catch {
+                return { parseError: 'Invalid JSON error response body.' };
+            }
+        }
+        try {
+            const text = await response.text();
+            return text.length > 0 ? text : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+export function createMissionSquadClient(extraArgs) {
+    const requestConfig = resolveRequestConfig(extraArgs, appConfig);
+    return new MissionSquadClient(requestConfig);
+}
+//# sourceMappingURL=msq-client.js.map

package/dist/msq-client.js.map

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