@daytonaio/sdk 0.173.0 → 0.175.0

package/esm/types/Pty.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Options for creating a PTY session
+ */
+export interface PtyCreateOptions {
+    /**
+     * The unique identifier for the PTY session
+     */
+    id: string;
+    /**
+     * Starting directory for the PTY session, defaults to the sandbox's working directory
+     */
+    cwd?: string;
+    /**
+     * Environment variables for the PTY session
+     */
+    envs?: Record<string, string>;
+    /**
+     * Number of terminal columns
+     */
+    cols?: number;
+    /**
+     * Number of terminal rows
+     */
+    rows?: number;
+}
+/**
+ * Options for connecting to a PTY session
+ */
+export interface PtyConnectOptions {
+    /**
+     * Callback to handle PTY output data
+     */
+    onData: (data: Uint8Array) => void | Promise<void>;
+}
+/**
+ * PTY session result on exit
+ */
+export interface PtyResult {
+    /**
+     * Exit code when the PTY process ends
+     */
+    exitCode?: number;
+    /**
+     * Error message if the PTY failed
+     */
+    error?: string;
+}
+//# sourceMappingURL=Pty.d.ts.map

package/esm/types/Pty.js

@@ -0,0 +1,6 @@
+/*
+ * Copyright 2025 Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export {};
+//# sourceMappingURL=Pty.js.map

package/esm/types/Pty.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pty.js","sourceRoot":"","sources":["../../../../../../libs/sdk-typescript/src/types/Pty.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/esm/utils/Binary.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Converts various data types to Uint8Array
+ */
+export declare function toUint8Array(data: string | ArrayBuffer | ArrayBufferView): Uint8Array;
+/**
+ * Concatenates multiple Uint8Array chunks into a single Uint8Array
+ */
+export declare function concatUint8Arrays(parts: Uint8Array[]): Uint8Array;
+/**
+ * Converts Uint8Array to Buffer (uses polyfill in non-Node environments)
+ */
+export declare function toBuffer(data: Uint8Array): Buffer;
+/**
+ * Decodes Uint8Array to UTF-8 string
+ */
+export declare function utf8Decode(data: Uint8Array): string;
+/**
+ * Finds all occurrences of a pattern in a byte buffer
+ */
+export declare function findAllBytes(buffer: Uint8Array, pattern: Uint8Array): number[];
+/**
+ * Finds the first occurrence of a pattern in a byte buffer within a range
+ */
+export declare function findBytesInRange(buffer: Uint8Array, start: number, end: number, pattern: Uint8Array): number;
+/**
+ * Checks if a sequence starts at a given position in a byte buffer
+ * Returns the position after the sequence if found, -1 otherwise
+ */
+export declare function indexAfterSequence(buffer: Uint8Array, start: number, sequence: Uint8Array): number;
+/**
+ * Collects all bytes from various stream types into a single Uint8Array
+ */
+export declare function collectStreamBytes(stream: any): Promise<Uint8Array>;
+/**
+ * Checks if value is a File object (browser environment)
+ */
+export declare function isFile(value: any): boolean;
+//# sourceMappingURL=Binary.d.ts.map

package/esm/utils/Binary.js

@@ -0,0 +1,163 @@
+/*
+ * Copyright 2025 Daytona Platforms Inc.
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { DaytonaError } from '../errors/DaytonaError.js';
+import { dynamicRequire } from './Import.js';
+let _BufferCtor = null;
+function getBufferCtor() {
+    if (!_BufferCtor)
+        _BufferCtor = dynamicRequire('buffer', '"Buffer" is not supported: ').Buffer;
+    return _BufferCtor;
+}
+/**
+ * Converts various data types to Uint8Array
+ */
+export function toUint8Array(data) {
+    if (typeof data === 'string') {
+        return new TextEncoder().encode(data);
+    }
+    if (data instanceof ArrayBuffer) {
+        return new Uint8Array(data);
+    }
+    if (ArrayBuffer.isView(data)) {
+        return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+    }
+    throw new DaytonaError('Unsupported data type for byte conversion.');
+}
+/**
+ * Concatenates multiple Uint8Array chunks into a single Uint8Array
+ */
+export function concatUint8Arrays(parts) {
+    const size = parts.reduce((sum, part) => sum + part.byteLength, 0);
+    const result = new Uint8Array(size);
+    let offset = 0;
+    for (const part of parts) {
+        result.set(part, offset);
+        offset += part.byteLength;
+    }
+    return result;
+}
+/**
+ * Converts Uint8Array to Buffer (uses polyfill in non-Node environments)
+ */
+export function toBuffer(data) {
+    return getBufferCtor().from(data);
+}
+/**
+ * Decodes Uint8Array to UTF-8 string
+ */
+export function utf8Decode(data) {
+    return new TextDecoder('utf-8').decode(data);
+}
+/**
+ * Finds all occurrences of a pattern in a byte buffer
+ */
+export function findAllBytes(buffer, pattern) {
+    const results = [];
+    let i = 0;
+    while (i <= buffer.length - pattern.length) {
+        let match = true;
+        for (let j = 0; j < pattern.length; j++) {
+            if (buffer[i + j] !== pattern[j]) {
+                match = false;
+                break;
+            }
+        }
+        if (match) {
+            results.push(i);
+            i += pattern.length;
+        }
+        else {
+            i++;
+        }
+    }
+    return results;
+}
+/**
+ * Finds the first occurrence of a pattern in a byte buffer within a range
+ */
+export function findBytesInRange(buffer, start, end, pattern) {
+    let i = start;
+    while (i <= end - pattern.length) {
+        let match = true;
+        for (let j = 0; j < pattern.length; j++) {
+            if (buffer[i + j] !== pattern[j]) {
+                match = false;
+                break;
+            }
+        }
+        if (match)
+            return i;
+        i++;
+    }
+    return -1;
+}
+/**
+ * Checks if a sequence starts at a given position in a byte buffer
+ * Returns the position after the sequence if found, -1 otherwise
+ */
+export function indexAfterSequence(buffer, start, sequence) {
+    for (let j = 0; j < sequence.length; j++) {
+        if (buffer[start + j] !== sequence[j])
+            return -1;
+    }
+    return start + sequence.length;
+}
+/**
+ * Collects all bytes from various stream types into a single Uint8Array
+ */
+export async function collectStreamBytes(stream) {
+    if (!stream)
+        return new Uint8Array(0);
+    // ReadableStream (WHATWG)
+    if (typeof stream.getReader === 'function') {
+        const reader = stream.getReader();
+        const chunks = [];
+        try {
+            while (true) {
+                const { done, value } = await reader.read();
+                if (done)
+                    break;
+                if (value?.byteLength) {
+                    chunks.push(value);
+                }
+            }
+        }
+        finally {
+            await reader.cancel();
+        }
+        return concatUint8Arrays(chunks);
+    }
+    // AsyncIterable
+    if (stream?.[Symbol.asyncIterator]) {
+        const chunks = [];
+        for await (const chunk of stream) {
+            chunks.push(toUint8Array(chunk));
+        }
+        return concatUint8Arrays(chunks);
+    }
+    // Direct data types
+    if (typeof stream === 'string' || stream instanceof ArrayBuffer || ArrayBuffer.isView(stream)) {
+        return toUint8Array(stream);
+    }
+    // Blob
+    if (typeof Blob !== 'undefined' && stream instanceof Blob) {
+        const arrayBuffer = await stream.arrayBuffer();
+        return new Uint8Array(arrayBuffer);
+    }
+    // Response
+    if (typeof Response !== 'undefined' && stream instanceof Response) {
+        const arrayBuffer = await stream.arrayBuffer();
+        return new Uint8Array(arrayBuffer);
+    }
+    throw new DaytonaError('Unsupported stream type for byte collection.');
+}
+/**
+ * Checks if value is a File object (browser environment)
+ */
+export function isFile(value) {
+    const FileConstructor = globalThis.File;
+    return typeof FileConstructor !== 'undefined' && value instanceof FileConstructor;
+}
+//# sourceMappingURL=Binary.js.map

package/esm/utils/Binary.js.map

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

package/esm/utils/FileTransfer.d.ts

@@ -0,0 +1,39 @@
+import type { Readable } from 'stream';
+import { DaytonaError } from '../errors/DaytonaError.js';
+import type { DownloadMetadata, UploadProgress, UploadSource } from '../FileSystem.js';
+/**
+ * Safely aborts a stream
+ */
+export declare function abortStream(stream: any): void;
+/**
+ * Normalizes response data to extract the actual stream
+ */
+export declare function normalizeResponseStream(responseData: any): any;
+/**
+ * Processes multipart response using busboy (Node.js path).
+ *
+ * Once the file stream has been handed off via `onFileStream`, errors from the
+ * busboy stream are the consumer's concern — they arrive via the file stream's
+ * own 'error' event. The inner Promise resolves cleanly in that case to avoid
+ * surfacing late teardown errors (busboy's `_final`, premature pipe close)
+ * after the caller has already started consuming the file.
+ */
+export declare function processDownloadFilesResponseWithBusboy(stream: any, headers: Record<string, string>, metadataMap: Map<string, DownloadMetadata>, onFileStream?: (source: string, fileStream: any, totalBytes?: number) => void): Promise<void>;
+export declare function processDownloadFilesResponseWithBuffered(stream: any, headers: Record<string, string>, metadataMap: Map<string, DownloadMetadata>): Promise<void>;
+/** Construct the cancellation error thrown when an upload is aborted. */
+export declare function createAbortError(remotePath: string): DaytonaError;
+/**
+ * Coerces every accepted upload source shape into a Node ``Readable`` so the
+ * downstream multipart writer has a uniform input type. Web ``ReadableStream``
+ * is bridged via ``Readable.fromWeb``; in-memory bytes via ``Readable.from``;
+ * local paths via ``fs.createReadStream``; existing ``Readable`` is passed
+ * through unchanged.
+ */
+export declare function coerceUploadSource(source: UploadSource): Promise<Readable>;
+/**
+ * Wraps an upload source in a pass-through that counts bytes and invokes
+ * ``onProgress`` per chunk. When ``onProgress`` is omitted the source is
+ * returned unchanged so there is zero overhead in the no-progress path.
+ */
+export declare function wrapWithUploadProgress(source: Readable, onProgress: ((progress: UploadProgress) => void) | undefined, signal?: AbortSignal): Readable;
+//# sourceMappingURL=FileTransfer.d.ts.map