@daytonaio/sdk 0.170.0 → 0.171.0-alpha.3

package/esm/utils/Stream.js

@@ -0,0 +1,360 @@
+import { STDOUT_PREFIX_BYTES, STDERR_PREFIX_BYTES, MAX_PREFIX_LEN } from '../Process.js';
+function isStreamTerminationError(err) {
+    if (!err || typeof err !== 'object')
+        return false;
+    const e = err;
+    // Typical Undici / fetch termination cases
+    if (e.name === 'AbortError')
+        return true;
+    if (typeof e.message === 'string' && /terminated/i.test(e.message))
+        return true;
+    if (e.code === 'UND_ERR_SOCKET')
+        return true;
+    // Look into nested causes, Undici often nests errors
+    if (e.cause)
+        return isStreamTerminationError(e.cause);
+    return false;
+}
+/**
+ * Process a streaming response from fetch(), where getStream() returns a Fetch Response.
+ *
+ * @param getStream – zero-arg function that does `await fetch(...)` and returns the Response
+ * @param onChunk – called with each decoded UTF-8 chunk
+ * @param shouldTerminate – pollable; if true for two consecutive timeouts (or once if requireConsecutiveTermination=false), the loop breaks
+ * @param chunkTimeout – milliseconds to wait for a new chunk before calling shouldTerminate()
+ * @param requireConsecutiveTermination – whether you need two time-outs in a row to break
+ */
+export async function processStreamingResponse(getStream, onChunk, shouldTerminate, chunkTimeout = 2000, requireConsecutiveTermination = true) {
+    const res = await getStream();
+    if (!res.body)
+        throw new Error('No streaming support');
+    const reader = res.body.getReader();
+    const decoder = new TextDecoder('utf-8');
+    const TIMEOUT = Symbol();
+    let exitCheckStreak = 0;
+    // Only one pending read promise at a time:
+    let readPromise = null;
+    try {
+        while (true) {
+            // Start a read if none in flight
+            if (!readPromise) {
+                readPromise = reader.read().then((r) => (r.done ? null : (r.value ?? new Uint8Array(0))));
+            }
+            // Race that single read against your timeout
+            const timeoutPromise = new Promise((r) => setTimeout(() => r(TIMEOUT), chunkTimeout));
+            const result = await Promise.race([readPromise, timeoutPromise]);
+            if (result === TIMEOUT) {
+                // no data yet, but the readPromise is still pending
+                const stop = await shouldTerminate();
+                if (stop) {
+                    exitCheckStreak++;
+                    if (!requireConsecutiveTermination || exitCheckStreak > 1) {
+                        try {
+                            await reader.cancel();
+                        }
+                        catch {
+                            /* ignore */
+                        }
+                        readPromise = null;
+                        break;
+                    }
+                }
+                else {
+                    exitCheckStreak = 0;
+                }
+                // loop again—but do NOT overwrite readPromise!
+            }
+            else {
+                // readPromise has resolved
+                readPromise = null;
+                if (result === null) {
+                    // stream closed
+                    break;
+                }
+                // valid chunk - use {stream: true} to buffer incomplete UTF-8 sequences
+                onChunk(decoder.decode(result, { stream: true }));
+                exitCheckStreak = 0;
+            }
+        }
+    }
+    catch (err) {
+        if (!isStreamTerminationError(err)) {
+            throw err;
+        }
+    }
+    finally {
+        // Flush any remaining buffered bytes from the decoder
+        const remaining = decoder.decode();
+        if (remaining) {
+            onChunk(remaining);
+        }
+        try {
+            await reader.cancel();
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+/**
+ * Demultiplexes a WebSocket stream into separate stdout and stderr streams.
+ *
+ * @param socket - The WebSocket instance to demultiplex.
+ * @param onStdout - Callback function for stdout messages.
+ * @param onStderr - Callback function for stderr messages.
+ */
+export function stdDemuxStream(ws, onStdout, onStderr) {
+    return new Promise((resolve, reject) => {
+        // If running in a browser or any WebSocket supporting binaryType, use ArrayBuffer for binary data
+        if ('binaryType' in ws) {
+            ws.binaryType = 'arraybuffer'; // ensure binary frames yield ArrayBuffer, not Blob
+        }
+        // Separate decoders for stdout and stderr to maintain independent UTF-8 decoding state
+        const stdoutDecoder = new TextDecoder('utf-8');
+        const stderrDecoder = new TextDecoder('utf-8');
+        const buf = []; // Buffer to accumulate incoming chunks
+        let currentDataType = null; // Track current stream type
+        // Helper function to emit payload data
+        const emit = (payload) => {
+            if (payload.length === 0)
+                return;
+            // Use {stream: true} to buffer incomplete UTF-8 sequences for the next chunk
+            if (currentDataType === 'stdout') {
+                const text = stdoutDecoder.decode(payload, { stream: true });
+                onStdout(text);
+            }
+            else if (currentDataType === 'stderr') {
+                const text = stderrDecoder.decode(payload, { stream: true });
+                onStderr(text);
+            }
+            // If currentDataType is null, drop unlabeled bytes (shouldn't happen with proper labeling)
+        };
+        // Helper function to find a subarray within a larger array
+        const findSubarray = (haystack, needle) => {
+            if (needle.length === 0)
+                return 0;
+            if (haystack.length < needle.length)
+                return -1;
+            for (let i = 0; i <= haystack.length - needle.length; i++) {
+                let found = true;
+                for (let j = 0; j < needle.length; j++) {
+                    if (haystack[i + j] !== needle[j]) {
+                        found = false;
+                        break;
+                    }
+                }
+                if (found)
+                    return i;
+            }
+            return -1;
+        };
+        // Event handler for incoming messages (Node: Buffer/ArrayBuffer/String; Browser: event.data etc.)
+        const handleMessage = (event) => {
+            // Normalize event/data between Node (ws) and browser WebSocket
+            const data = event && event instanceof Object && 'data' in event ? event.data : event;
+            try {
+                // Prepare a Uint8Array for the message data
+                let bytes;
+                if (typeof data === 'string') {
+                    // Convert string to bytes for consistent byte-based demuxing
+                    bytes = new TextEncoder().encode(data);
+                }
+                else if (data instanceof ArrayBuffer) {
+                    bytes = new Uint8Array(data);
+                }
+                else if (ArrayBuffer.isView(data)) {
+                    // Covers Node.js Buffer (Uint8Array subclass) and other TypedArrays
+                    bytes = new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+                }
+                else if (data instanceof Blob) {
+                    // Browser binary frames might be Blob if binaryType wasn't set in time. Convert to ArrayBuffer asynchronously.
+                    data.arrayBuffer().then((buf) => {
+                        try {
+                            processChunk(new Uint8Array(buf));
+                        }
+                        catch (err) {
+                            handleError(err);
+                        }
+                    }, (err) => {
+                        handleError(err);
+                    });
+                    return; // will continue asynchronously once blob is read
+                }
+                else {
+                    throw new Error(`Unsupported message data type: ${Object.prototype.toString.call(data)}`);
+                }
+                // Process the chunk
+                processChunk(bytes);
+            }
+            catch (err) {
+                // On any synchronous error in processing, clean up and reject.
+                cleanup();
+                try {
+                    ws.close();
+                }
+                catch {
+                    /* ignore if already closed */
+                }
+                reject(err);
+            }
+        };
+        // Process a chunk of data with buffering and safe region handling
+        const processChunk = (chunk) => {
+            if (chunk.length === 0)
+                return;
+            // Add chunk to buffer
+            buf.push(...chunk);
+            // Process as much as we can, preserving only bytes that could be part of a prefix
+            while (true) {
+                const bufArray = new Uint8Array(buf);
+                // Calculate how many bytes we can safely process
+                // We need to keep bytes that could potentially be the start of a prefix marker
+                let safeLen = buf.length;
+                // Check if the last few bytes could be part of a prefix marker
+                if (buf.length >= MAX_PREFIX_LEN) {
+                    // Check if the last byte could be part of a prefix (must be 0x01 or 0x02)
+                    const lastByte = buf[buf.length - 1];
+                    if (lastByte !== 0x01 && lastByte !== 0x02) {
+                        // Last byte can't be part of any prefix, safe to process everything
+                        safeLen = buf.length;
+                    }
+                    else if (buf.length >= MAX_PREFIX_LEN + 1) {
+                        // Check second-to-last byte if buffer is long enough
+                        const secondLastByte = buf[buf.length - 2];
+                        if (secondLastByte !== 0x01 && secondLastByte !== 0x02) {
+                            // Second-to-last byte can't be part of any prefix, safe to process all but last byte
+                            safeLen = buf.length - 1;
+                        }
+                        else {
+                            // Both last bytes could be part of prefix, keep MAX_PREFIX_LEN - 1 bytes
+                            safeLen = buf.length - (MAX_PREFIX_LEN - 1);
+                        }
+                    }
+                    else {
+                        // Buffer is exactly MAX_PREFIX_LEN, keep MAX_PREFIX_LEN - 1 bytes
+                        safeLen = buf.length - (MAX_PREFIX_LEN - 1);
+                    }
+                }
+                else {
+                    // Buffer shorter than MAX_PREFIX_LEN, keep MAX_PREFIX_LEN - 1 bytes
+                    safeLen = buf.length - (MAX_PREFIX_LEN - 1);
+                }
+                if (safeLen <= 0) {
+                    break;
+                }
+                // Find earliest next marker within the safe region
+                const safeRegion = bufArray.subarray(0, safeLen);
+                const stdoutIndex = findSubarray(safeRegion, STDOUT_PREFIX_BYTES);
+                const stderrIndex = findSubarray(safeRegion, STDERR_PREFIX_BYTES);
+                let nextIdx = -1;
+                let nextKind = null;
+                let nextLen = 0;
+                if (stdoutIndex !== -1 && (stderrIndex === -1 || stdoutIndex < stderrIndex)) {
+                    nextIdx = stdoutIndex;
+                    nextKind = 'stdout';
+                    nextLen = STDOUT_PREFIX_BYTES.length;
+                }
+                else if (stderrIndex !== -1) {
+                    nextIdx = stderrIndex;
+                    nextKind = 'stderr';
+                    nextLen = STDERR_PREFIX_BYTES.length;
+                }
+                if (nextIdx === -1) {
+                    // No full marker in safe region: emit everything we safely can as payload
+                    const toEmit = bufArray.subarray(0, safeLen);
+                    emit(toEmit);
+                    buf.splice(0, safeLen);
+                    break; // wait for more data to resolve any partial marker at the end
+                }
+                // We found a marker. Emit preceding bytes (if any) under the current stream.
+                if (nextIdx > 0) {
+                    const toEmit = bufArray.subarray(0, nextIdx);
+                    emit(toEmit);
+                }
+                // Advance past the marker and switch current stream
+                buf.splice(0, nextIdx + nextLen);
+                currentDataType = nextKind;
+            }
+        };
+        // Event handler for errors
+        const handleError = (error) => {
+            // Convert Event or plain error to Error instance for consistency
+            const err = error && error instanceof Event ? new Error('WebSocket error') : error;
+            cleanup();
+            try {
+                ws.close();
+            }
+            catch {
+                /* ignore if already closed */
+            }
+            reject(err);
+        };
+        // Event handler for socket closure
+        const handleClose = () => {
+            // Flush any remaining buffered payload on clean close
+            if (buf.length > 0 && currentDataType) {
+                const remainingBytes = new Uint8Array(buf);
+                // Use {stream: false} or omit to flush any buffered incomplete UTF-8 sequences
+                if (currentDataType === 'stdout') {
+                    const text = stdoutDecoder.decode(remainingBytes, { stream: false });
+                    onStdout(text);
+                }
+                else if (currentDataType === 'stderr') {
+                    const text = stderrDecoder.decode(remainingBytes, { stream: false });
+                    onStderr(text);
+                }
+            }
+            else {
+                // Flush any remaining bytes in the decoders even if buf is empty
+                const stdoutFlushed = stdoutDecoder.decode();
+                const stderrFlushed = stderrDecoder.decode();
+                if (stdoutFlushed)
+                    onStdout(stdoutFlushed);
+                if (stderrFlushed)
+                    onStderr(stderrFlushed);
+            }
+            cleanup();
+            resolve();
+        };
+        // Cleanup function to remove all listeners to avoid memory leaks
+        const cleanup = () => {
+            if (ws.removeEventListener) {
+                // Browser (EventTarget) style cleanup
+                ws.removeEventListener('message', handleMessage);
+                ws.removeEventListener('error', handleError);
+                ws.removeEventListener('close', handleClose);
+            }
+            if (ws.off) {
+                // Node.js ws (EventEmitter) style cleanup (supported in Node 14+)
+                ws.off('message', handleMessage);
+                ws.off('error', handleError);
+                ws.off('close', handleClose);
+            }
+            else if (ws.removeListener) {
+                // Node.js ws fallback for older Node versions
+                ;
+                ws.removeListener('message', handleMessage);
+                ws.removeListener('error', handleError);
+                ws.removeListener('close', handleClose);
+            }
+        };
+        // Attach event listeners in a way compatible with both Node (EventEmitter) and browser (EventTarget):
+        if (ws.addEventListener) {
+            // Browser or WebSocket implementation with EventTarget interface
+            ws.addEventListener('message', handleMessage);
+            ws.addEventListener('error', handleError);
+            ws.addEventListener('close', handleClose);
+        }
+        else if (ws.on) {
+            // Node.js ws library (EventEmitter) interface
+            ws.on('message', handleMessage); // ws@8+ yields Buffer for text frames, which we handle via TextDecoder
+            ws.on('error', handleError);
+            ws.on('close', handleClose);
+        }
+        else {
+            // Unknown WebSocket interface - should not happen with isomorphic-ws
+            throw new Error('Unsupported WebSocket implementation');
+        }
+    });
+}
+//# sourceMappingURL=Stream.js.map

package/esm/utils/Stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Stream.js","sourceRoot":"","sources":["../../../../../../libs/sdk-typescript/src/utils/Stream.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAErF,SAAS,wBAAwB,CAAC,GAAY;IAC5C,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;IAEjD,MAAM,CAAC,GAAG,GAAU,CAAA;IAEpB,2CAA2C;IAC3C,IAAI,CAAC,CAAC,IAAI,KAAK,YAAY;QAAE,OAAO,IAAI,CAAA;IACxC,IAAI,OAAO,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IAC/E,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,IAAI,CAAA;IAE5C,qDAAqD;IACrD,IAAI,CAAC,CAAC,KAAK;QAAE,OAAO,wBAAwB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;IAErD,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,SAAkC,EAClC,OAAgC,EAChC,eAAuC,EACvC,YAAY,GAAG,IAAI,EACnB,6BAA6B,GAAG,IAAI;IAEpC,MAAM,GAAG,GAAG,MAAM,SAAS,EAAE,CAAA;IAC7B,IAAI,CAAC,GAAG,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;IACtD,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,SAAS,EAAE,CAAA;IACnC,MAAM,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAA;IACxC,MAAM,OAAO,GAAG,MAAM,EAAE,CAAA;IACxB,IAAI,eAAe,GAAG,CAAC,CAAA;IAEvB,2CAA2C;IAC3C,IAAI,WAAW,GAAsC,IAAI,CAAA;IAEzD,IAAI,CAAC;QACH,OAAO,IAAI,EAAE,CAAC;YACZ,iCAAiC;YACjC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACjB,WAAW,GAAG,MAAM,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAC3F,CAAC;YAED,6CAA6C;YAC7C,MAAM,cAAc,GAAG,IAAI,OAAO,CAAiB,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC,CAAA;YACrG,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,cAAc,CAAC,CAAC,CAAA;YAEhE,IAAI,MAAM,KAAK,OAAO,EAAE,CAAC;gBACvB,oDAAoD;gBACpD,MAAM,IAAI,GAAG,MAAM,eAAe,EAAE,CAAA;gBACpC,IAAI,IAAI,EAAE,CAAC;oBACT,eAAe,EAAE,CAAA;oBACjB,IAAI,CAAC,6BAA6B,IAAI,eAAe,GAAG,CAAC,EAAE,CAAC;wBAC1D,IAAI,CAAC;4BACH,MAAM,MAAM,CAAC,MAAM,EAAE,CAAA;wBACvB,CAAC;wBAAC,MAAM,CAAC;4BACP,YAAY;wBACd,CAAC;wBACD,WAAW,GAAG,IAAI,CAAA;wBAClB,MAAK;oBACP,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,eAAe,GAAG,CAAC,CAAA;gBACrB,CAAC;gBACD,+CAA+C;YACjD,CAAC;iBAAM,CAAC;gBACN,2BAA2B;gBAC3B,WAAW,GAAG,IAAI,CAAA;gBAClB,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBACpB,gBAAgB;oBAChB,MAAK;gBACP,CAAC;gBACD,wEAAwE;gBACxE,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;gBACjD,eAAe,GAAG,CAAC,CAAA;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,wBAAwB,CAAC,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,GAAG,CAAA;QACX,CAAC;IACH,CAAC;YAAS,CAAC;QACT,sDAAsD;QACtD,MAAM,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,CAAA;QAClC,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,SAAS,CAAC,CAAA;QACpB,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,MAAM,EAAE,CAAA;QACvB,CAAC;QAAC,MAAM,CAAC;YACP,YAAY;QACd,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,EAAa,EACb,QAAgC,EAChC,QAAgC;IAEhC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,kGAAkG;QAClG,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC;YACvB,EAAE,CAAC,UAAU,GAAG,aAAa,CAAA,CAAC,mDAAmD;QACnF,CAAC;QAED,uFAAuF;QACvF,MAAM,aAAa,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAA;QAC9C,MAAM,aAAa,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAA;QAC9C,MAAM,GAAG,GAAa,EAAE,CAAA,CAAC,uCAAuC;QAChE,IAAI,eAAe,GAA+B,IAAI,CAAA,CAAC,4BAA4B;QAEnF,uCAAuC;QACvC,MAAM,IAAI,GAAG,CAAC,OAAmB,EAAE,EAAE;YACnC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAChC,6EAA6E;YAC7E,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;gBACjC,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;gBAC5D,QAAQ,CAAC,IAAI,CAAC,CAAA;YAChB,CAAC;iBAAM,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;gBACxC,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;gBAC5D,QAAQ,CAAC,IAAI,CAAC,CAAA;YAChB,CAAC;YACD,2FAA2F;QAC7F,CAAC,CAAA;QAED,2DAA2D;QAC3D,MAAM,YAAY,GAAG,CAAC,QAAoB,EAAE,MAAkB,EAAU,EAAE;YACxE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,CAAC,CAAA;YACjC,IAAI,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM;gBAAE,OAAO,CAAC,CAAC,CAAA;YAE9C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBAC1D,IAAI,KAAK,GAAG,IAAI,CAAA;gBAChB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;oBACvC,IAAI,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;wBAClC,KAAK,GAAG,KAAK,CAAA;wBACb,MAAK;oBACP,CAAC;gBACH,CAAC;gBACD,IAAI,KAAK;oBAAE,OAAO,CAAC,CAAA;YACrB,CAAC;YACD,OAAO,CAAC,CAAC,CAAA;QACX,CAAC,CAAA;QAED,kGAAkG;QAClG,MAAM,aAAa,GAAG,CAAC,KAAyD,EAAE,EAAE;YAClF,+DAA+D;YAC/D,MAAM,IAAI,GAAG,KAAK,IAAI,KAAK,YAAY,MAAM,IAAI,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;YACrF,IAAI,CAAC;gBACH,4CAA4C;gBAC5C,IAAI,KAAiB,CAAA;gBACrB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC7B,6DAA6D;oBAC7D,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;gBACxC,CAAC;qBAAM,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;oBACvC,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAA;gBAC9B,CAAC;qBAAM,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBACpC,oEAAoE;oBACpE,KAAK,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;gBACvE,CAAC;qBAAM,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;oBAChC,+GAA+G;oBAC/G,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,CACrB,CAAC,GAAgB,EAAE,EAAE;wBACnB,IAAI,CAAC;4BACH,YAAY,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;wBACnC,CAAC;wBAAC,OAAO,GAAG,EAAE,CAAC;4BACb,WAAW,CAAC,GAAG,CAAC,CAAA;wBAClB,CAAC;oBACH,CAAC,EACD,CAAC,GAAQ,EAAE,EAAE;wBACX,WAAW,CAAC,GAAG,CAAC,CAAA;oBAClB,CAAC,CACF,CAAA;oBACD,OAAM,CAAC,iDAAiD;gBAC1D,CAAC;qBAAM,CAAC;oBACN,MAAM,IAAI,KAAK,CAAC,kCAAkC,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;gBAC3F,CAAC;gBAED,oBAAoB;gBACpB,YAAY,CAAC,KAAK,CAAC,CAAA;YACrB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,+DAA+D;gBAC/D,OAAO,EAAE,CAAA;gBACT,IAAI,CAAC;oBACH,EAAE,CAAC,KAAK,EAAE,CAAA;gBACZ,CAAC;gBAAC,MAAM,CAAC;oBACP,8BAA8B;gBAChC,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,CAAA;YACb,CAAC;QACH,CAAC,CAAA;QAED,kEAAkE;QAClE,MAAM,YAAY,GAAG,CAAC,KAAiB,EAAE,EAAE;YACzC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAM;YAE9B,sBAAsB;YACtB,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,CAAA;YAElB,kFAAkF;YAClF,OAAO,IAAI,EAAE,CAAC;gBACZ,MAAM,QAAQ,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAA;gBAEpC,iDAAiD;gBACjD,+EAA+E;gBAC/E,IAAI,OAAO,GAAG,GAAG,CAAC,MAAM,CAAA;gBAExB,+DAA+D;gBAC/D,IAAI,GAAG,CAAC,MAAM,IAAI,cAAc,EAAE,CAAC;oBACjC,0EAA0E;oBAC1E,MAAM,QAAQ,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;oBACpC,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;wBAC3C,oEAAoE;wBACpE,OAAO,GAAG,GAAG,CAAC,MAAM,CAAA;oBACtB,CAAC;yBAAM,IAAI,GAAG,CAAC,MAAM,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;wBAC5C,qDAAqD;wBACrD,MAAM,cAAc,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;wBAC1C,IAAI,cAAc,KAAK,IAAI,IAAI,cAAc,KAAK,IAAI,EAAE,CAAC;4BACvD,qFAAqF;4BACrF,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAA;wBAC1B,CAAC;6BAAM,CAAC;4BACN,yEAAyE;4BACzE,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC,CAAA;wBAC7C,CAAC;oBACH,CAAC;yBAAM,CAAC;wBACN,kEAAkE;wBAClE,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC,CAAA;oBAC7C,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,oEAAoE;oBACpE,OAAO,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,cAAc,GAAG,CAAC,CAAC,CAAA;gBAC7C,CAAC;gBAED,IAAI,OAAO,IAAI,CAAC,EAAE,CAAC;oBACjB,MAAK;gBACP,CAAC;gBAED,mDAAmD;gBACnD,MAAM,UAAU,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;gBAChD,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAA;gBACjE,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,EAAE,mBAAmB,CAAC,CAAA;gBAEjE,IAAI,OAAO,GAAG,CAAC,CAAC,CAAA;gBAChB,IAAI,QAAQ,GAA+B,IAAI,CAAA;gBAC/C,IAAI,OAAO,GAAG,CAAC,CAAA;gBAEf,IAAI,WAAW,KAAK,CAAC,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,CAAC,IAAI,WAAW,GAAG,WAAW,CAAC,EAAE,CAAC;oBAC5E,OAAO,GAAG,WAAW,CAAA;oBACrB,QAAQ,GAAG,QAAQ,CAAA;oBACnB,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAA;gBACtC,CAAC;qBAAM,IAAI,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC;oBAC9B,OAAO,GAAG,WAAW,CAAA;oBACrB,QAAQ,GAAG,QAAQ,CAAA;oBACnB,OAAO,GAAG,mBAAmB,CAAC,MAAM,CAAA;gBACtC,CAAC;gBAED,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;oBACnB,0EAA0E;oBAC1E,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;oBAC5C,IAAI,CAAC,MAAM,CAAC,CAAA;oBACZ,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;oBACtB,MAAK,CAAC,8DAA8D;gBACtE,CAAC;gBAED,6EAA6E;gBAC7E,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;oBAChB,MAAM,MAAM,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAA;oBAC5C,IAAI,CAAC,MAAM,CAAC,CAAA;gBACd,CAAC;gBAED,oDAAoD;gBACpD,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAA;gBAChC,eAAe,GAAG,QAAQ,CAAA;YAC5B,CAAC;QACH,CAAC,CAAA;QAED,2BAA2B;QAC3B,MAAM,WAAW,GAAG,CAAC,KAAU,EAAE,EAAE;YACjC,iEAAiE;YACjE,MAAM,GAAG,GAAG,KAAK,IAAI,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;YAClF,OAAO,EAAE,CAAA;YACT,IAAI,CAAC;gBACH,EAAE,CAAC,KAAK,EAAE,CAAA;YACZ,CAAC;YAAC,MAAM,CAAC;gBACP,8BAA8B;YAChC,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,CAAA;QACb,CAAC,CAAA;QAED,mCAAmC;QACnC,MAAM,WAAW,GAAG,GAAG,EAAE;YACvB,sDAAsD;YACtD,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,eAAe,EAAE,CAAC;gBACtC,MAAM,cAAc,GAAG,IAAI,UAAU,CAAC,GAAG,CAAC,CAAA;gBAC1C,+EAA+E;gBAC/E,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;oBACjC,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;oBACpE,QAAQ,CAAC,IAAI,CAAC,CAAA;gBAChB,CAAC;qBAAM,IAAI,eAAe,KAAK,QAAQ,EAAE,CAAC;oBACxC,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;oBACpE,QAAQ,CAAC,IAAI,CAAC,CAAA;gBAChB,CAAC;YACH,CAAC;iBAAM,CAAC;gBACN,iEAAiE;gBACjE,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,EAAE,CAAA;gBAC5C,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,EAAE,CAAA;gBAC5C,IAAI,aAAa;oBAAE,QAAQ,CAAC,aAAa,CAAC,CAAA;gBAC1C,IAAI,aAAa;oBAAE,QAAQ,CAAC,aAAa,CAAC,CAAA;YAC5C,CAAC;YACD,OAAO,EAAE,CAAA;YACT,OAAO,EAAE,CAAA;QACX,CAAC,CAAA;QAED,iEAAiE;QACjE,MAAM,OAAO,GAAG,GAAG,EAAE;YACnB,IAAI,EAAE,CAAC,mBAAmB,EAAE,CAAC;gBAC3B,sCAAsC;gBACtC,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,aAAoB,CAAC,CAAA;gBACvD,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAkB,CAAC,CAAA;gBACnD,EAAE,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAkB,CAAC,CAAA;YACrD,CAAC;YACD,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC;gBACX,kEAAkE;gBAClE,EAAE,CAAC,GAAG,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA;gBAChC,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;gBAC5B,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;YAC9B,CAAC;iBAAM,IAAK,EAAU,CAAC,cAAc,EAAE,CAAC;gBACtC,8CAA8C;gBAC9C,CAAC;gBAAC,EAAU,CAAC,cAAc,CAAC,SAAS,EAAE,aAAa,CAAC,CACpD;gBAAC,EAAU,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAChD;gBAAC,EAAU,CAAC,cAAc,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;YACnD,CAAC;QACH,CAAC,CAAA;QAED,sGAAsG;QACtG,IAAI,EAAE,CAAC,gBAAgB,EAAE,CAAC;YACxB,iEAAiE;YACjE,EAAE,CAAC,gBAAgB,CAAC,SAAS,EAAE,aAAoB,CAAC,CAAA;YACpD,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAkB,CAAC,CAAA;YAChD,EAAE,CAAC,gBAAgB,CAAC,OAAO,EAAE,WAAkB,CAAC,CAAA;QAClD,CAAC;aAAM,IAAK,EAAU,CAAC,EAAE,EAAE,CAAC;YAC1B,8CAA8C;YAC9C,EAAE,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,CAAC,CAAA,CAAC,uEAAuE;YACvG,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;YAC3B,EAAE,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;QAC7B,CAAC;aAAM,CAAC;YACN,qEAAqE;YACrE,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAA;QACzD,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/esm/utils/WebSocket.d.ts

@@ -0,0 +1,10 @@
+import WebSocket from 'isomorphic-ws';
+/**
+ * Creates an authenticated WebSocket connection to the sandbox toolbox.
+ *
+ * @param url - The websocket URL (ws[s]://...)
+ * @param headers - Headers to forward when running in Node environments
+ * @param getPreviewToken - Lazy getter for preview tokens (required for browser/serverless runtimes)
+ */
+export declare function createSandboxWebSocket(url: string, headers: Record<string, any>, getPreviewToken: () => Promise<string>): Promise<WebSocket>;
+//# sourceMappingURL=WebSocket.d.ts.map

package/esm/utils/WebSocket.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocket.d.ts","sourceRoot":"","sources":["../../../../../../libs/sdk-typescript/src/utils/WebSocket.ts"],"names":[],"mappings":"AAKA,OAAO,SAAS,MAAM,eAAe,CAAA;AAGrC;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAC5B,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GACrC,OAAO,CAAC,SAAS,CAAC,CAWpB"}

package/esm/utils/WebSocket.js

@@ -0,0 +1,22 @@
+/*
+ * Copyright 2025 Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import WebSocket from 'isomorphic-ws';
+import { RUNTIME, Runtime } from './Runtime.js';
+/**
+ * Creates an authenticated WebSocket connection to the sandbox toolbox.
+ *
+ * @param url - The websocket URL (ws[s]://...)
+ * @param headers - Headers to forward when running in Node environments
+ * @param getPreviewToken - Lazy getter for preview tokens (required for browser/serverless runtimes)
+ */
+export async function createSandboxWebSocket(url, headers, getPreviewToken) {
+    if (RUNTIME === Runtime.BROWSER || RUNTIME === Runtime.DENO || RUNTIME === Runtime.SERVERLESS) {
+        const previewToken = await getPreviewToken();
+        const separator = url.includes('?') ? '&' : '?';
+        return new WebSocket(`${url}${separator}DAYTONA_SANDBOX_AUTH_KEY=${previewToken}`, `X-Daytona-SDK-Version~${String(headers['X-Daytona-SDK-Version'] ?? '')}`);
+    }
+    return new WebSocket(url, { headers });
+}
+//# sourceMappingURL=WebSocket.js.map

package/esm/utils/WebSocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebSocket.js","sourceRoot":"","sources":["../../../../../../libs/sdk-typescript/src/utils/WebSocket.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,SAAS,MAAM,eAAe,CAAA;AACrC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAE5C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,GAAW,EACX,OAA4B,EAC5B,eAAsC;IAEtC,IAAI,OAAO,KAAK,OAAO,CAAC,OAAO,IAAI,OAAO,KAAK,OAAO,CAAC,IAAI,IAAI,OAAO,KAAK,OAAO,CAAC,UAAU,EAAE,CAAC;QAC9F,MAAM,YAAY,GAAG,MAAM,eAAe,EAAE,CAAA;QAC5C,MAAM,SAAS,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;QAC/C,OAAO,IAAI,SAAS,CAClB,GAAG,GAAG,GAAG,SAAS,4BAA4B,YAAY,EAAE,EAC5D,yBAAyB,MAAM,CAAC,OAAO,CAAC,uBAAuB,CAAC,IAAI,EAAE,CAAC,EAAE,CAC1E,CAAA;IACH,CAAC;IAED,OAAO,IAAI,SAAS,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,CAAC,CAAA;AACxC,CAAC"}

package/esm/utils/otel.decorator.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Configuration options for span instrumentation
+ */
+export interface SpanConfig {
+    /**
+     * Custom name for the span. If not provided, uses `ClassName.methodName` format
+     */
+    name?: string;
+    /**
+     * Additional attributes to attach to the span
+     */
+    attributes?: Record<string, string>;
+}
+/**
+ * Configuration options for metric instrumentation
+ */
+export interface MetricConfig {
+    /**
+     * Custom name for the metric. If not provided, uses `ClassName.methodName` format
+     */
+    name?: string;
+    /**
+     * Description for the metrics being collected
+     */
+    description?: string;
+    /**
+     * Additional labels to attach to the metrics
+     */
+    labels?: Record<string, string>;
+}
+/**
+ * Configuration options for the combined instrumentation decorator
+ */
+export interface InstrumentationConfig {
+    /**
+     * Custom name for the span and metric. If not provided, uses `ClassName.methodName` format
+     */
+    name?: string;
+    /**
+     * Description for the metrics being collected
+     */
+    description?: string;
+    /**
+     * Additional labels/attributes to attach to spans and metrics
+     */
+    labels?: Record<string, string>;
+    /**
+     * Enable trace collection (default: true)
+     */
+    enableTraces?: boolean;
+    /**
+     * Enable metrics collection (default: true)
+     */
+    enableMetrics?: boolean;
+}
+/**
+ * Decorator for instrumenting methods with OpenTelemetry spans (traces only)
+ *
+ * @param config - Configuration object or string name for the span
+ *
+ */
+export declare function WithSpan(config?: string | SpanConfig): (target: object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
+/**
+ * Decorator for instrumenting methods with OpenTelemetry metrics (metrics only)
+ *
+ * Collects two metrics:
+ * - Counter: `{name}_executions` - tracks number of executions with status (success/error)
+ * - Histogram: `{name}_duration` - tracks execution duration in milliseconds
+ *
+ * @param config - Configuration object or string name for the metric
+ *
+ */
+export declare function WithMetric(config?: string | MetricConfig): (target: object, propertyKey: string | symbol, descriptor: PropertyDescriptor) => void;
+/**
+ * Decorator for instrumenting methods with both OpenTelemetry traces and metrics
+ *
+ * This decorator composes @WithSpan and @WithMetric to provide both trace and metric collection.
+ * You can selectively enable/disable traces or metrics using the config options.
+ *
+ * @param config - Configuration object or string name for the instrumentation
+ */
+export declare function WithInstrumentation(config?: string | InstrumentationConfig): MethodDecorator;
+//# sourceMappingURL=otel.decorator.d.ts.map

package/esm/utils/otel.decorator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"otel.decorator.d.ts","sourceRoot":"","sources":["../../../../../../libs/sdk-typescript/src/utils/otel.decorator.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAA;IACb;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAaD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,UAAU,IAC3C,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,YAAY,kBAAkB,UA0CrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,IAC/C,QAAQ,MAAM,EAAE,aAAa,MAAM,GAAG,MAAM,EAAE,YAAY,kBAAkB,UA6CrF;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,qBAAqB,GAAG,eAAe,CAiB5F"}

package/esm/utils/otel.decorator.js

@@ -0,0 +1,136 @@
+/*
+ * Copyright 2025 Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { trace, context, metrics, SpanStatusCode } from '@opentelemetry/api';
+// Lazy initialization to ensure SDK is started before getting tracer/meter
+const getTracer = () => trace.getTracer('');
+const getMeter = () => metrics.getMeter('');
+const executionHistograms = new Map();
+/**
+ * Converts a string to snake_case for Prometheus-friendly metric names
+ */
+function toSnakeCase(str) {
+    return str
+        .replace(/([A-Z])/g, '_$1')
+        .toLowerCase()
+        .replace(/^_/, '')
+        .replace(/\./g, '_');
+}
+/**
+ * Decorator for instrumenting methods with OpenTelemetry spans (traces only)
+ *
+ * @param config - Configuration object or string name for the span
+ *
+ */
+export function WithSpan(config) {
+    return (target, propertyKey, descriptor) => {
+        const originalMethod = descriptor.value;
+        const methodName = String(propertyKey);
+        descriptor.value = async function (...args) {
+            const cfg = typeof config === 'string' ? { name: config } : config || {};
+            const { name, attributes = {} } = cfg;
+            const spanName = name || `${target.constructor.name}.${methodName}`;
+            const allAttributes = {
+                component: target.constructor.name,
+                method: methodName,
+                ...attributes,
+            };
+            const span = getTracer().startSpan(spanName, {
+                attributes: allAttributes,
+            }, context.active());
+            return context.with(trace.setSpan(context.active(), span), async () => {
+                try {
+                    const result = await originalMethod.apply(this, args);
+                    span.setStatus({ code: SpanStatusCode.OK });
+                    return result;
+                }
+                catch (error) {
+                    span.setStatus({
+                        code: SpanStatusCode.ERROR,
+                        message: error instanceof Error ? error.message : String(error),
+                    });
+                    span.recordException(error instanceof Error ? error : new Error(String(error)));
+                    throw error;
+                }
+                finally {
+                    span.end();
+                }
+            });
+        };
+    };
+}
+/**
+ * Decorator for instrumenting methods with OpenTelemetry metrics (metrics only)
+ *
+ * Collects two metrics:
+ * - Counter: `{name}_executions` - tracks number of executions with status (success/error)
+ * - Histogram: `{name}_duration` - tracks execution duration in milliseconds
+ *
+ * @param config - Configuration object or string name for the metric
+ *
+ */
+export function WithMetric(config) {
+    return (target, propertyKey, descriptor) => {
+        const originalMethod = descriptor.value;
+        const methodName = String(propertyKey);
+        descriptor.value = async function (...args) {
+            const cfg = typeof config === 'string' ? { name: config } : config || {};
+            const { name, description, labels = {} } = cfg;
+            const metricName = toSnakeCase(name || `${target.constructor.name}.${methodName}`);
+            const allLabels = {
+                component: target.constructor.name,
+                method: methodName,
+                ...labels,
+            };
+            // Get or create histogram for this method
+            if (!executionHistograms.has(metricName)) {
+                executionHistograms.set(metricName, getMeter().createHistogram(`${metricName}_duration`, {
+                    description: description || `Duration of executions for ${metricName}`,
+                    unit: 'ms',
+                }));
+            }
+            const histogram = executionHistograms.get(metricName);
+            if (!histogram) {
+                throw new Error(`Histogram not found for metric: ${metricName}`);
+            }
+            const startTime = Date.now();
+            let status = 'success';
+            try {
+                const result = await originalMethod.apply(this, args);
+                return result;
+            }
+            catch (error) {
+                status = 'error';
+                throw error;
+            }
+            finally {
+                const duration = Date.now() - startTime;
+                histogram.record(duration, { ...allLabels, status });
+            }
+        };
+    };
+}
+/**
+ * Decorator for instrumenting methods with both OpenTelemetry traces and metrics
+ *
+ * This decorator composes @WithSpan and @WithMetric to provide both trace and metric collection.
+ * You can selectively enable/disable traces or metrics using the config options.
+ *
+ * @param config - Configuration object or string name for the instrumentation
+ */
+export function WithInstrumentation(config) {
+    const cfg = typeof config === 'string' ? { name: config } : config || {};
+    const { enableTraces = true, enableMetrics = true, name, description, labels } = cfg;
+    const decorators = [];
+    if (enableTraces) {
+        decorators.push(WithSpan({ name, attributes: labels }));
+    }
+    if (enableMetrics) {
+        decorators.push(WithMetric({ name, description, labels }));
+    }
+    return (target, propertyKey, descriptor) => {
+        decorators.forEach((decorator) => decorator(target, propertyKey, descriptor));
+    };
+}
+//# sourceMappingURL=otel.decorator.js.map

package/esm/utils/otel.decorator.js.map

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