@kadi.build/core 0.0.1-alpha.10 → 0.0.1-alpha.12

package/dist/utils/StdioMessageWriter.js

@@ -0,0 +1,162 @@
+/**
+ * Stdio Message Writer
+ *
+ * Writes Content-Length framed messages to a stream (LSP-style).
+ * Ensures reliable message delivery even when other output is written to the stream.
+ *
+ * Message format:
+ * ```
+ * Content-Length: 67\r\n
+ * \r\n
+ * {"jsonrpc":"2.0","id":1,"result":{"value":42}}
+ * ```
+ *
+ * @module utils/StdioMessageWriter
+ */
+/**
+ * Message writer for Content-Length framed messages
+ *
+ * Implements the LSP (Language Server Protocol) message framing format.
+ * Automatically calculates content length and formats headers.
+ *
+ * @example
+ * ```typescript
+ * const writer = new StdioMessageWriter(process.stdout);
+ *
+ * // Write a JSON-RPC message
+ * await writer.write({
+ *   jsonrpc: '2.0',
+ *   id: 1,
+ *   result: { value: 42 }
+ * });
+ * ```
+ */
+export class StdioMessageWriter {
+    /**
+     * Output stream
+     */
+    stream;
+    /**
+     * Whether the writer has been destroyed
+     */
+    destroyed = false;
+    /**
+     * Header separator
+     */
+    static HEADER_SEPARATOR = '\r\n';
+    /**
+     * Create a new message writer
+     *
+     * @param stream - Output stream (typically stdout)
+     */
+    constructor(stream) {
+        this.stream = stream;
+    }
+    /**
+     * Write a framed message to the stream
+     *
+     * Serializes the message to JSON, calculates byte length, formats
+     * Content-Length header, and writes everything to the stream.
+     *
+     * @param message - Message object to write (will be JSON-stringified)
+     * @returns Promise that resolves when message is fully written
+     *
+     * @throws {Error} If writer is destroyed or write fails
+     *
+     * @example
+     * ```typescript
+     * await writer.write({
+     *   jsonrpc: '2.0',
+     *   id: 1,
+     *   method: 'invoke',
+     *   params: { toolName: 'add', toolInput: { a: 5, b: 3 } }
+     * });
+     * ```
+     */
+    async write(message) {
+        if (this.destroyed) {
+            throw new Error('Cannot write: StdioMessageWriter has been destroyed');
+        }
+        // Serialize message to JSON
+        const messageJson = JSON.stringify(message);
+        // Calculate UTF-8 byte length (not character length!)
+        const messageBytes = Buffer.from(messageJson, 'utf8');
+        const contentLength = messageBytes.length;
+        // Format header
+        const header = `Content-Length: ${contentLength}${StdioMessageWriter.HEADER_SEPARATOR}${StdioMessageWriter.HEADER_SEPARATOR}`;
+        // Write header + message
+        const fullMessage = header + messageJson;
+        // Write to stream and handle backpressure
+        return new Promise((resolve, reject) => {
+            const writeSucceeded = this.stream.write(fullMessage, 'utf8', (error) => {
+                if (error) {
+                    reject(new Error(`Failed to write message: ${error.message}`));
+                }
+                else {
+                    resolve();
+                }
+            });
+            // If write returned false, wait for drain event
+            if (!writeSucceeded) {
+                this.stream.once('drain', () => {
+                    resolve();
+                });
+            }
+        });
+    }
+    /**
+     * Flush the stream
+     *
+     * Ensures all buffered data is written to the underlying stream.
+     *
+     * @returns Promise that resolves when flush is complete
+     */
+    async flush() {
+        if (this.destroyed) {
+            return;
+        }
+        return new Promise((resolve) => {
+            // Check if stream has end() method (for proper cleanup)
+            if (typeof this.stream.end === 'function') {
+                // Don't actually end the stream, just make sure it's flushed
+                // We'll use cork/uncork if available
+                if (typeof this.stream.uncork === 'function') {
+                    this.stream.uncork();
+                }
+            }
+            // Wait for drain if needed
+            if (this.stream.writableNeedDrain) {
+                this.stream.once('drain', () => resolve());
+            }
+            else {
+                resolve();
+            }
+        });
+    }
+    /**
+     * Destroy the writer
+     *
+     * Cleans up resources. After calling destroy(), the writer cannot be used.
+     * Note: This does NOT close the underlying stream.
+     */
+    destroy() {
+        this.destroyed = true;
+    }
+    /**
+     * Check if writer is destroyed
+     *
+     * @returns true if destroyed
+     */
+    isDestroyed() {
+        return this.destroyed;
+    }
+    /**
+     * Get the underlying stream
+     *
+     * @returns The writable stream
+     */
+    getStream() {
+        return this.stream;
+    }
+}
+//# sourceMappingURL=StdioMessageWriter.js.map

package/dist/utils/StdioMessageWriter.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kadi.build/core",
-  "version": "0.0.1-alpha.10",
+  "version": "0.0.1-alpha.12",
   "description": "A module that is a comprehensive toolkit for developers integrating with the KADI infrastructure.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -84,6 +84,7 @@
     "eslint-config-prettier": "^9.1.2",
     "eslint-plugin-prettier": "^5.5.4",
     "prettier": "^3.6.2",
+    "tsx": "^4.20.6",
     "typescript": "^5.9.2",
     "vitest": "^3.2.4"
   }