@daytonaio/sdk 0.175.0 → 0.178.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/cjs/CodeInterpreter.d.ts +3 -2
- package/cjs/CodeInterpreter.js.map +1 -1
- package/cjs/ComputerUse.d.ts +104 -2
- package/cjs/ComputerUse.js +851 -763
- package/cjs/ComputerUse.js.map +1 -1
- package/cjs/Daytona.d.ts +4 -3
- package/cjs/Daytona.js +429 -443
- package/cjs/Daytona.js.map +1 -1
- package/cjs/FileSystem.d.ts +2 -2
- package/cjs/FileSystem.js +491 -521
- package/cjs/FileSystem.js.map +1 -1
- package/cjs/Git.d.ts +2 -1
- package/cjs/Git.js +287 -310
- package/cjs/Git.js.map +1 -1
- package/cjs/LspServer.d.ts +2 -1
- package/cjs/LspServer.js +209 -226
- package/cjs/LspServer.js.map +1 -1
- package/cjs/ObjectStorage.js +170 -166
- package/cjs/ObjectStorage.js.map +1 -1
- package/cjs/Process.d.ts +4 -3
- package/cjs/Process.js +562 -600
- package/cjs/Process.js.map +1 -1
- package/cjs/PtyHandle.d.ts +2 -2
- package/cjs/PtyHandle.js +327 -338
- package/cjs/PtyHandle.js.map +1 -1
- package/cjs/Sandbox.d.ts +4 -3
- package/cjs/Sandbox.js +756 -821
- package/cjs/Sandbox.js.map +1 -1
- package/cjs/Snapshot.d.ts +3 -2
- package/cjs/Snapshot.js +203 -213
- package/cjs/Snapshot.js.map +1 -1
- package/cjs/Volume.d.ts +2 -1
- package/cjs/Volume.js +90 -92
- package/cjs/Volume.js.map +1 -1
- package/cjs/errors/DaytonaError.d.ts +2 -1
- package/cjs/errors/DaytonaError.js.map +1 -1
- package/cjs/index.d.ts +2 -2
- package/cjs/index.js +2 -1
- package/cjs/index.js.map +1 -1
- package/cjs/types/CodeInterpreter.d.ts +1 -1
- package/cjs/utils/Binary.js +14 -2
- package/cjs/utils/Binary.js.map +1 -1
- package/cjs/utils/otel.decorator.d.ts +7 -8
- package/cjs/utils/otel.decorator.js +24 -30
- package/cjs/utils/otel.decorator.js.map +1 -1
- package/esm/CodeInterpreter.d.ts +3 -2
- package/esm/CodeInterpreter.js.map +1 -1
- package/esm/ComputerUse.d.ts +104 -2
- package/esm/ComputerUse.js +857 -763
- package/esm/ComputerUse.js.map +1 -1
- package/esm/Daytona.d.ts +4 -3
- package/esm/Daytona.js +431 -444
- package/esm/Daytona.js.map +1 -1
- package/esm/FileSystem.d.ts +2 -2
- package/esm/FileSystem.js +493 -522
- package/esm/FileSystem.js.map +1 -1
- package/esm/Git.d.ts +2 -1
- package/esm/Git.js +289 -311
- package/esm/Git.js.map +1 -1
- package/esm/LspServer.d.ts +2 -1
- package/esm/LspServer.js +211 -227
- package/esm/LspServer.js.map +1 -1
- package/esm/ObjectStorage.js +172 -167
- package/esm/ObjectStorage.js.map +1 -1
- package/esm/Process.d.ts +4 -3
- package/esm/Process.js +564 -601
- package/esm/Process.js.map +1 -1
- package/esm/PtyHandle.d.ts +2 -2
- package/esm/PtyHandle.js +329 -339
- package/esm/PtyHandle.js.map +1 -1
- package/esm/Sandbox.d.ts +4 -3
- package/esm/Sandbox.js +759 -823
- package/esm/Sandbox.js.map +1 -1
- package/esm/Snapshot.d.ts +3 -2
- package/esm/Snapshot.js +206 -215
- package/esm/Snapshot.js.map +1 -1
- package/esm/Volume.d.ts +2 -1
- package/esm/Volume.js +92 -93
- package/esm/Volume.js.map +1 -1
- package/esm/errors/DaytonaError.d.ts +2 -1
- package/esm/errors/DaytonaError.js.map +1 -1
- package/esm/index.d.ts +2 -2
- package/esm/index.js +1 -1
- package/esm/index.js.map +1 -1
- package/esm/types/CodeInterpreter.d.ts +1 -1
- package/esm/utils/Binary.js +14 -2
- package/esm/utils/Binary.js.map +1 -1
- package/esm/utils/otel.decorator.d.ts +7 -8
- package/esm/utils/otel.decorator.js +26 -32
- package/esm/utils/otel.decorator.js.map +1 -1
- package/package.json +3 -3
package/cjs/FileSystem.js
CHANGED
|
@@ -24,552 +24,522 @@ function createFileDownloadError(error, errorDetails) {
|
|
|
24
24
|
*
|
|
25
25
|
* @class
|
|
26
26
|
*/
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
|
|
32
|
-
|
|
33
|
-
|
|
34
|
-
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
}
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
}
|
|
74
|
-
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
throw createFileDownloadError(response[0].error, response[0].errorDetails);
|
|
27
|
+
let FileSystem = (() => {
|
|
28
|
+
let _instanceExtraInitializers = [];
|
|
29
|
+
let _createFolder_decorators;
|
|
30
|
+
let _deleteFile_decorators;
|
|
31
|
+
let _downloadFile_decorators;
|
|
32
|
+
let _downloadFileStream_decorators;
|
|
33
|
+
let _downloadFiles_decorators;
|
|
34
|
+
let _findFiles_decorators;
|
|
35
|
+
let _getFileDetails_decorators;
|
|
36
|
+
let _listFiles_decorators;
|
|
37
|
+
let _moveFiles_decorators;
|
|
38
|
+
let _replaceInFiles_decorators;
|
|
39
|
+
let _searchFiles_decorators;
|
|
40
|
+
let _setFilePermissions_decorators;
|
|
41
|
+
let _uploadFile_decorators;
|
|
42
|
+
let _uploadFileStream_decorators;
|
|
43
|
+
let _uploadFiles_decorators;
|
|
44
|
+
return class FileSystem {
|
|
45
|
+
static {
|
|
46
|
+
const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
|
|
47
|
+
_createFolder_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
48
|
+
_deleteFile_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
49
|
+
_downloadFile_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
50
|
+
_downloadFileStream_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
51
|
+
_downloadFiles_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
52
|
+
_findFiles_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
53
|
+
_getFileDetails_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
54
|
+
_listFiles_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
55
|
+
_moveFiles_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
56
|
+
_replaceInFiles_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
57
|
+
_searchFiles_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
58
|
+
_setFilePermissions_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
59
|
+
_uploadFile_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
60
|
+
_uploadFileStream_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
61
|
+
_uploadFiles_decorators = [(0, otel_decorator_1.WithInstrumentation)()];
|
|
62
|
+
tslib_1.__esDecorate(this, null, _createFolder_decorators, { kind: "method", name: "createFolder", static: false, private: false, access: { has: obj => "createFolder" in obj, get: obj => obj.createFolder }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
63
|
+
tslib_1.__esDecorate(this, null, _deleteFile_decorators, { kind: "method", name: "deleteFile", static: false, private: false, access: { has: obj => "deleteFile" in obj, get: obj => obj.deleteFile }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
64
|
+
tslib_1.__esDecorate(this, null, _downloadFile_decorators, { kind: "method", name: "downloadFile", static: false, private: false, access: { has: obj => "downloadFile" in obj, get: obj => obj.downloadFile }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
65
|
+
tslib_1.__esDecorate(this, null, _downloadFileStream_decorators, { kind: "method", name: "downloadFileStream", static: false, private: false, access: { has: obj => "downloadFileStream" in obj, get: obj => obj.downloadFileStream }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
66
|
+
tslib_1.__esDecorate(this, null, _downloadFiles_decorators, { kind: "method", name: "downloadFiles", static: false, private: false, access: { has: obj => "downloadFiles" in obj, get: obj => obj.downloadFiles }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
67
|
+
tslib_1.__esDecorate(this, null, _findFiles_decorators, { kind: "method", name: "findFiles", static: false, private: false, access: { has: obj => "findFiles" in obj, get: obj => obj.findFiles }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
68
|
+
tslib_1.__esDecorate(this, null, _getFileDetails_decorators, { kind: "method", name: "getFileDetails", static: false, private: false, access: { has: obj => "getFileDetails" in obj, get: obj => obj.getFileDetails }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
69
|
+
tslib_1.__esDecorate(this, null, _listFiles_decorators, { kind: "method", name: "listFiles", static: false, private: false, access: { has: obj => "listFiles" in obj, get: obj => obj.listFiles }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
70
|
+
tslib_1.__esDecorate(this, null, _moveFiles_decorators, { kind: "method", name: "moveFiles", static: false, private: false, access: { has: obj => "moveFiles" in obj, get: obj => obj.moveFiles }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
71
|
+
tslib_1.__esDecorate(this, null, _replaceInFiles_decorators, { kind: "method", name: "replaceInFiles", static: false, private: false, access: { has: obj => "replaceInFiles" in obj, get: obj => obj.replaceInFiles }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
72
|
+
tslib_1.__esDecorate(this, null, _searchFiles_decorators, { kind: "method", name: "searchFiles", static: false, private: false, access: { has: obj => "searchFiles" in obj, get: obj => obj.searchFiles }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
73
|
+
tslib_1.__esDecorate(this, null, _setFilePermissions_decorators, { kind: "method", name: "setFilePermissions", static: false, private: false, access: { has: obj => "setFilePermissions" in obj, get: obj => obj.setFilePermissions }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
74
|
+
tslib_1.__esDecorate(this, null, _uploadFile_decorators, { kind: "method", name: "uploadFile", static: false, private: false, access: { has: obj => "uploadFile" in obj, get: obj => obj.uploadFile }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
75
|
+
tslib_1.__esDecorate(this, null, _uploadFileStream_decorators, { kind: "method", name: "uploadFileStream", static: false, private: false, access: { has: obj => "uploadFileStream" in obj, get: obj => obj.uploadFileStream }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
76
|
+
tslib_1.__esDecorate(this, null, _uploadFiles_decorators, { kind: "method", name: "uploadFiles", static: false, private: false, access: { has: obj => "uploadFiles" in obj, get: obj => obj.uploadFiles }, metadata: _metadata }, null, _instanceExtraInitializers);
|
|
77
|
+
if (_metadata) Object.defineProperty(this, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
|
|
79
78
|
}
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
|
|
85
|
-
if (isNonStreamingRuntime) {
|
|
86
|
-
throw new DaytonaError_1.DaytonaError('downloadFileStream is not supported in browser or serverless environments. Use downloadFile instead.');
|
|
79
|
+
clientConfig = tslib_1.__runInitializers(this, _instanceExtraInitializers);
|
|
80
|
+
apiClient;
|
|
81
|
+
constructor(clientConfig, apiClient) {
|
|
82
|
+
this.clientConfig = clientConfig;
|
|
83
|
+
this.apiClient = apiClient;
|
|
87
84
|
}
|
|
88
|
-
|
|
89
|
-
|
|
85
|
+
/**
|
|
86
|
+
* Create a new directory in the Sandbox with specified permissions.
|
|
87
|
+
*
|
|
88
|
+
* @param {string} path - Path where the directory should be created. Relative paths are resolved based on the sandbox working directory.
|
|
89
|
+
* @param {string} mode - Directory permissions in octal format (e.g. "755")
|
|
90
|
+
* @returns {Promise<void>}
|
|
91
|
+
*
|
|
92
|
+
* @example
|
|
93
|
+
* // Create a directory with standard permissions
|
|
94
|
+
* await fs.createFolder('app/data', '755');
|
|
95
|
+
*/
|
|
96
|
+
async createFolder(path, mode) {
|
|
97
|
+
const response = await this.apiClient.createFolder(path, mode);
|
|
98
|
+
return response.data;
|
|
90
99
|
}
|
|
91
|
-
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
100
|
+
/**
|
|
101
|
+
* Deletes a file or directory from the Sandbox.
|
|
102
|
+
*
|
|
103
|
+
* @param {string} path - Path to the file or directory to delete. Relative paths are resolved based on the sandbox working directory.
|
|
104
|
+
* @param {boolean} [recursive] - If the file is a directory, this must be true to delete it.
|
|
105
|
+
* @returns {Promise<void>}
|
|
106
|
+
*
|
|
107
|
+
* @example
|
|
108
|
+
* // Delete a file
|
|
109
|
+
* await fs.deleteFile('app/temp.log');
|
|
110
|
+
*/
|
|
111
|
+
async deleteFile(path, recursive) {
|
|
112
|
+
const response = await this.apiClient.deleteFile(path, recursive);
|
|
113
|
+
return response.data;
|
|
103
114
|
}
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
115
|
+
async downloadFile(src, dst, timeout = 30 * 60) {
|
|
116
|
+
const remotePath = src;
|
|
117
|
+
if (typeof dst !== 'string') {
|
|
118
|
+
if (dst) {
|
|
119
|
+
timeout = dst;
|
|
120
|
+
}
|
|
121
|
+
const response = await this.downloadFiles([{ source: remotePath }], timeout);
|
|
122
|
+
if (response[0].error) {
|
|
123
|
+
throw createFileDownloadError(response[0].error, response[0].errorDetails);
|
|
124
|
+
}
|
|
125
|
+
return response[0].result;
|
|
126
|
+
}
|
|
127
|
+
const response = await this.downloadFiles([{ source: remotePath, destination: dst }], timeout);
|
|
128
|
+
if (response[0].error) {
|
|
129
|
+
throw createFileDownloadError(response[0].error, response[0].errorDetails);
|
|
107
130
|
}
|
|
108
|
-
throw err;
|
|
109
131
|
}
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
|
|
127
|
-
|
|
128
|
-
|
|
129
|
-
|
|
130
|
-
|
|
131
|
-
|
|
132
|
-
|
|
133
|
-
|
|
134
|
-
|
|
132
|
+
async downloadFileStream(remotePath, timeoutOrOptions) {
|
|
133
|
+
const options = typeof timeoutOrOptions === 'number' ? { timeout: timeoutOrOptions } : (timeoutOrOptions ?? {});
|
|
134
|
+
const timeout = options.timeout ?? 30 * 60;
|
|
135
|
+
const isNonStreamingRuntime = Runtime_1.RUNTIME === Runtime_1.Runtime.BROWSER || Runtime_1.RUNTIME === Runtime_1.Runtime.SERVERLESS;
|
|
136
|
+
if (isNonStreamingRuntime) {
|
|
137
|
+
throw new DaytonaError_1.DaytonaError('downloadFileStream is not supported in browser or serverless environments. Use downloadFile instead.');
|
|
138
|
+
}
|
|
139
|
+
if (options.signal?.aborted) {
|
|
140
|
+
throw new DaytonaError_1.DaytonaError('Download cancelled');
|
|
141
|
+
}
|
|
142
|
+
const toDownloadCancelledError = () => new DaytonaError_1.DaytonaError('Download cancelled');
|
|
143
|
+
const isCanceledError = (err) => {
|
|
144
|
+
const error = err;
|
|
145
|
+
return Boolean(axios_1.default.isCancel?.(err) || error?.name === 'CanceledError' || error?.code === 'ERR_CANCELED');
|
|
146
|
+
};
|
|
147
|
+
let response;
|
|
148
|
+
try {
|
|
149
|
+
response = await this.apiClient.downloadFiles({ paths: [remotePath] }, {
|
|
150
|
+
responseType: 'stream',
|
|
151
|
+
timeout: timeout * 1000,
|
|
152
|
+
signal: options.signal,
|
|
153
|
+
});
|
|
154
|
+
}
|
|
155
|
+
catch (err) {
|
|
156
|
+
if (options.signal?.aborted || isCanceledError(err)) {
|
|
157
|
+
throw toDownloadCancelledError();
|
|
135
158
|
}
|
|
136
|
-
|
|
137
|
-
}
|
|
138
|
-
|
|
139
|
-
|
|
140
|
-
|
|
141
|
-
|
|
142
|
-
|
|
159
|
+
throw err;
|
|
160
|
+
}
|
|
161
|
+
const responseStream = (0, FileTransfer_1.normalizeResponseStream)(response.data);
|
|
162
|
+
const metadataMap = new Map();
|
|
163
|
+
metadataMap.set(remotePath, {});
|
|
164
|
+
return new Promise((resolve, reject) => {
|
|
165
|
+
let resolvedStream = null;
|
|
166
|
+
(0, FileTransfer_1.processDownloadFilesResponseWithBusboy)(responseStream, response.headers, metadataMap, (_source, fileStream, totalBytes) => {
|
|
167
|
+
if (options.onProgress) {
|
|
168
|
+
const { Transform } = require('stream');
|
|
169
|
+
let bytesReceived = 0;
|
|
170
|
+
const progress = new Transform({
|
|
171
|
+
transform(chunk, _encoding, callback) {
|
|
172
|
+
bytesReceived += chunk.length;
|
|
173
|
+
options.onProgress({ bytesReceived, totalBytes });
|
|
174
|
+
callback(null, chunk);
|
|
175
|
+
},
|
|
176
|
+
});
|
|
177
|
+
fileStream.pipe(progress);
|
|
178
|
+
// busboy's teardown can emit 'error' on the file stream after 'end',
|
|
179
|
+
// even when every byte was delivered — ignore those late errors.
|
|
180
|
+
let fileStreamEnded = false;
|
|
181
|
+
fileStream.once('end', () => {
|
|
182
|
+
fileStreamEnded = true;
|
|
183
|
+
});
|
|
184
|
+
fileStream.on('error', (err) => {
|
|
185
|
+
if (fileStreamEnded)
|
|
186
|
+
return;
|
|
187
|
+
if (!progress.destroyed)
|
|
188
|
+
progress.destroy(err);
|
|
189
|
+
});
|
|
190
|
+
resolvedStream = progress;
|
|
143
191
|
}
|
|
144
192
|
else {
|
|
145
|
-
|
|
193
|
+
resolvedStream = fileStream;
|
|
146
194
|
}
|
|
195
|
+
resolve(resolvedStream);
|
|
196
|
+
})
|
|
197
|
+
.then(() => {
|
|
198
|
+
if (!resolvedStream) {
|
|
199
|
+
const metadata = metadataMap.get(remotePath);
|
|
200
|
+
if (metadata?.error) {
|
|
201
|
+
reject(createFileDownloadError(metadata.error, metadata.errorDetails));
|
|
202
|
+
}
|
|
203
|
+
else {
|
|
204
|
+
reject(new DaytonaError_1.DaytonaError(`No file data received for: ${remotePath}`));
|
|
205
|
+
}
|
|
206
|
+
}
|
|
207
|
+
})
|
|
208
|
+
.catch((err) => {
|
|
209
|
+
const normalizedError = options.signal?.aborted || isCanceledError(err) ? toDownloadCancelledError() : err;
|
|
210
|
+
if (!resolvedStream) {
|
|
211
|
+
reject(normalizedError);
|
|
212
|
+
return;
|
|
213
|
+
}
|
|
214
|
+
const stream = resolvedStream;
|
|
215
|
+
if (stream.destroyed || stream.readableEnded) {
|
|
216
|
+
return;
|
|
217
|
+
}
|
|
218
|
+
stream.destroy(normalizedError instanceof Error ? normalizedError : new Error(String(normalizedError)));
|
|
219
|
+
});
|
|
220
|
+
});
|
|
221
|
+
}
|
|
222
|
+
/**
|
|
223
|
+
* Downloads multiple files from the Sandbox. If the files already exist locally, they will be overwritten.
|
|
224
|
+
*
|
|
225
|
+
* @param {FileDownloadRequest[]} files - Array of file download requests.
|
|
226
|
+
* @param {number} [timeoutSec] - Timeout for the download operation in seconds. 0 means no timeout.
|
|
227
|
+
* Default is 30 minutes.
|
|
228
|
+
* @returns {Promise<FileDownloadResponse[]>} Array of download results.
|
|
229
|
+
*
|
|
230
|
+
* @throws {DaytonaError} If the request itself fails (network issues, invalid request/response, etc.). Individual
|
|
231
|
+
* file download errors are returned in `FileDownloadResponse.error`. When the daemon provides structured
|
|
232
|
+
* per-file metadata, it is also available in `FileDownloadResponse.errorDetails`.
|
|
233
|
+
*
|
|
234
|
+
* @example
|
|
235
|
+
* // Download multiple files
|
|
236
|
+
* const results = await fs.downloadFiles([
|
|
237
|
+
* { source: 'tmp/data.json' },
|
|
238
|
+
* { source: 'tmp/config.json', destination: 'local_config.json' }
|
|
239
|
+
* ]);
|
|
240
|
+
* results.forEach(result => {
|
|
241
|
+
* if (result.error) {
|
|
242
|
+
* console.error(`Error downloading ${result.source}: ${result.error}`);
|
|
243
|
+
* } else if (result.result) {
|
|
244
|
+
* console.log(`Downloaded ${result.source} to ${result.result}`);
|
|
245
|
+
* }
|
|
246
|
+
* });
|
|
247
|
+
*/
|
|
248
|
+
async downloadFiles(files, timeoutSec = 30 * 60) {
|
|
249
|
+
if (files.length === 0)
|
|
250
|
+
return [];
|
|
251
|
+
const isNonStreamingRuntime = Runtime_1.RUNTIME === Runtime_1.Runtime.BROWSER || Runtime_1.RUNTIME === Runtime_1.Runtime.SERVERLESS;
|
|
252
|
+
// Prepare destinations and metadata
|
|
253
|
+
const metadataMap = new Map();
|
|
254
|
+
for (const f of files) {
|
|
255
|
+
metadataMap.set(f.source, { destination: f.destination });
|
|
256
|
+
if (f.destination) {
|
|
257
|
+
const fs = await (0, Import_1.dynamicImport)('fs', 'Downloading files to local files is not supported: ');
|
|
258
|
+
await fs.promises.mkdir(pathe.dirname(f.destination), { recursive: true });
|
|
147
259
|
}
|
|
148
|
-
}
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
reject(normalizedError);
|
|
153
|
-
return;
|
|
154
|
-
}
|
|
155
|
-
const stream = resolvedStream;
|
|
156
|
-
if (stream.destroyed || stream.readableEnded) {
|
|
157
|
-
return;
|
|
158
|
-
}
|
|
159
|
-
stream.destroy(normalizedError instanceof Error ? normalizedError : new Error(String(normalizedError)));
|
|
260
|
+
}
|
|
261
|
+
const response = await this.apiClient.downloadFiles({ paths: files.map((f) => f.source) }, {
|
|
262
|
+
responseType: isNonStreamingRuntime ? 'arraybuffer' : 'stream',
|
|
263
|
+
timeout: timeoutSec * 1000,
|
|
160
264
|
});
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
168
|
-
* Default is 30 minutes.
|
|
169
|
-
* @returns {Promise<FileDownloadResponse[]>} Array of download results.
|
|
170
|
-
*
|
|
171
|
-
* @throws {DaytonaError} If the request itself fails (network issues, invalid request/response, etc.). Individual
|
|
172
|
-
* file download errors are returned in `FileDownloadResponse.error`. When the daemon provides structured
|
|
173
|
-
* per-file metadata, it is also available in `FileDownloadResponse.errorDetails`.
|
|
174
|
-
*
|
|
175
|
-
* @example
|
|
176
|
-
* // Download multiple files
|
|
177
|
-
* const results = await fs.downloadFiles([
|
|
178
|
-
* { source: 'tmp/data.json' },
|
|
179
|
-
* { source: 'tmp/config.json', destination: 'local_config.json' }
|
|
180
|
-
* ]);
|
|
181
|
-
* results.forEach(result => {
|
|
182
|
-
* if (result.error) {
|
|
183
|
-
* console.error(`Error downloading ${result.source}: ${result.error}`);
|
|
184
|
-
* } else if (result.result) {
|
|
185
|
-
* console.log(`Downloaded ${result.source} to ${result.result}`);
|
|
186
|
-
* }
|
|
187
|
-
* });
|
|
188
|
-
*/
|
|
189
|
-
async downloadFiles(files, timeoutSec = 30 * 60) {
|
|
190
|
-
if (files.length === 0)
|
|
191
|
-
return [];
|
|
192
|
-
const isNonStreamingRuntime = Runtime_1.RUNTIME === Runtime_1.Runtime.BROWSER || Runtime_1.RUNTIME === Runtime_1.Runtime.SERVERLESS;
|
|
193
|
-
// Prepare destinations and metadata
|
|
194
|
-
const metadataMap = new Map();
|
|
195
|
-
for (const f of files) {
|
|
196
|
-
metadataMap.set(f.source, { destination: f.destination });
|
|
197
|
-
if (f.destination) {
|
|
198
|
-
const fs = await (0, Import_1.dynamicImport)('fs', 'Downloading files to local files is not supported: ');
|
|
199
|
-
await fs.promises.mkdir(pathe.dirname(f.destination), { recursive: true });
|
|
265
|
+
const stream = (0, FileTransfer_1.normalizeResponseStream)(response.data);
|
|
266
|
+
// Node.js path: use busboy for efficient streaming
|
|
267
|
+
if (isNonStreamingRuntime) {
|
|
268
|
+
await (0, FileTransfer_1.processDownloadFilesResponseWithBuffered)(stream, response.headers, metadataMap);
|
|
269
|
+
}
|
|
270
|
+
else {
|
|
271
|
+
await (0, FileTransfer_1.processDownloadFilesResponseWithBusboy)(stream, response.headers, metadataMap);
|
|
200
272
|
}
|
|
273
|
+
return files.map((f) => {
|
|
274
|
+
const metadata = metadataMap.get(f.source);
|
|
275
|
+
const error = metadata?.error || (!metadata?.result ? 'No data received for this file' : undefined);
|
|
276
|
+
return {
|
|
277
|
+
source: f.source,
|
|
278
|
+
result: error ? undefined : metadata.result,
|
|
279
|
+
error,
|
|
280
|
+
errorDetails: error ? metadata?.errorDetails : undefined,
|
|
281
|
+
};
|
|
282
|
+
});
|
|
283
|
+
}
|
|
284
|
+
/**
|
|
285
|
+
* Searches for text patterns within files in the Sandbox.
|
|
286
|
+
*
|
|
287
|
+
* @param {string} path - Directory to search in. Relative paths are resolved based on the sandbox working directory.
|
|
288
|
+
* @param {string} pattern - Search pattern
|
|
289
|
+
* @returns {Promise<Array<Match>>} Array of matches with file and line information
|
|
290
|
+
*
|
|
291
|
+
* @example
|
|
292
|
+
* // Find all TODO comments in TypeScript files
|
|
293
|
+
* const matches = await fs.findFiles('app/src', 'TODO:');
|
|
294
|
+
* matches.forEach(match => {
|
|
295
|
+
* console.log(`${match.file}:${match.line}: ${match.content}`);
|
|
296
|
+
* });
|
|
297
|
+
*/
|
|
298
|
+
async findFiles(path, pattern) {
|
|
299
|
+
const response = await this.apiClient.findInFiles(path, pattern);
|
|
300
|
+
return response.data;
|
|
201
301
|
}
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
|
|
205
|
-
|
|
206
|
-
|
|
207
|
-
|
|
208
|
-
|
|
209
|
-
|
|
302
|
+
/**
|
|
303
|
+
* Retrieves detailed information about a file or directory.
|
|
304
|
+
*
|
|
305
|
+
* @param {string} path - Path to the file or directory. Relative paths are resolved based on the sandbox working directory.
|
|
306
|
+
* @returns {Promise<FileInfo>} Detailed file information including size, permissions, modification time
|
|
307
|
+
*
|
|
308
|
+
* @example
|
|
309
|
+
* // Get file details
|
|
310
|
+
* const info = await fs.getFileDetails('app/config.json');
|
|
311
|
+
* console.log(`Size: ${info.size}, Modified: ${info.modTime}`);
|
|
312
|
+
*/
|
|
313
|
+
async getFileDetails(path) {
|
|
314
|
+
const response = await this.apiClient.getFileInfo(path);
|
|
315
|
+
return response.data;
|
|
210
316
|
}
|
|
211
|
-
|
|
212
|
-
|
|
317
|
+
/**
|
|
318
|
+
* Lists contents of a directory in the Sandbox.
|
|
319
|
+
*
|
|
320
|
+
* @param {string} path - Directory path to list. Relative paths are resolved based on the sandbox working directory.
|
|
321
|
+
* @returns {Promise<FileInfo[]>} Array of file and directory information
|
|
322
|
+
*
|
|
323
|
+
* @example
|
|
324
|
+
* // List directory contents
|
|
325
|
+
* const files = await fs.listFiles('app/src');
|
|
326
|
+
* files.forEach(file => {
|
|
327
|
+
* console.log(`${file.name} (${file.size} bytes)`);
|
|
328
|
+
* });
|
|
329
|
+
*/
|
|
330
|
+
async listFiles(path) {
|
|
331
|
+
const response = await this.apiClient.listFiles(path);
|
|
332
|
+
return response.data;
|
|
213
333
|
}
|
|
214
|
-
|
|
215
|
-
|
|
216
|
-
|
|
217
|
-
|
|
218
|
-
|
|
219
|
-
|
|
220
|
-
|
|
221
|
-
|
|
334
|
+
/**
|
|
335
|
+
* Moves or renames a file or directory.
|
|
336
|
+
*
|
|
337
|
+
* @param {string} source - Source path. Relative paths are resolved based on the sandbox working directory.
|
|
338
|
+
* @param {string} destination - Destination path. Relative paths are resolved based on the sandbox working directory.
|
|
339
|
+
* @returns {Promise<void>}
|
|
340
|
+
*
|
|
341
|
+
* @example
|
|
342
|
+
* // Move a file to a new location
|
|
343
|
+
* await fs.moveFiles('app/temp/data.json', 'app/data/data.json');
|
|
344
|
+
*/
|
|
345
|
+
async moveFiles(source, destination) {
|
|
346
|
+
const response = await this.apiClient.moveFile(source, destination);
|
|
347
|
+
return response.data;
|
|
348
|
+
}
|
|
349
|
+
/**
|
|
350
|
+
* Replaces text content in multiple files.
|
|
351
|
+
*
|
|
352
|
+
* @param {string[]} files - Array of file paths to process. Relative paths are resolved based on the sandbox working directory.
|
|
353
|
+
* @param {string} pattern - Pattern to replace
|
|
354
|
+
* @param {string} newValue - Replacement text
|
|
355
|
+
* @returns {Promise<Array<ReplaceResult>>} Results of the replace operation for each file
|
|
356
|
+
*
|
|
357
|
+
* @example
|
|
358
|
+
* // Update version number across multiple files
|
|
359
|
+
* const results = await fs.replaceInFiles(
|
|
360
|
+
* ['app/package.json', 'app/version.ts'],
|
|
361
|
+
* '"version": "1.0.0"',
|
|
362
|
+
* '"version": "1.1.0"'
|
|
363
|
+
* );
|
|
364
|
+
*/
|
|
365
|
+
async replaceInFiles(files, pattern, newValue) {
|
|
366
|
+
const replaceRequest = {
|
|
367
|
+
files,
|
|
368
|
+
newValue,
|
|
369
|
+
pattern,
|
|
222
370
|
};
|
|
223
|
-
|
|
224
|
-
|
|
225
|
-
/**
|
|
226
|
-
* Searches for text patterns within files in the Sandbox.
|
|
227
|
-
*
|
|
228
|
-
* @param {string} path - Directory to search in. Relative paths are resolved based on the sandbox working directory.
|
|
229
|
-
* @param {string} pattern - Search pattern
|
|
230
|
-
* @returns {Promise<Array<Match>>} Array of matches with file and line information
|
|
231
|
-
*
|
|
232
|
-
* @example
|
|
233
|
-
* // Find all TODO comments in TypeScript files
|
|
234
|
-
* const matches = await fs.findFiles('app/src', 'TODO:');
|
|
235
|
-
* matches.forEach(match => {
|
|
236
|
-
* console.log(`${match.file}:${match.line}: ${match.content}`);
|
|
237
|
-
* });
|
|
238
|
-
*/
|
|
239
|
-
async findFiles(path, pattern) {
|
|
240
|
-
const response = await this.apiClient.findInFiles(path, pattern);
|
|
241
|
-
return response.data;
|
|
242
|
-
}
|
|
243
|
-
/**
|
|
244
|
-
* Retrieves detailed information about a file or directory.
|
|
245
|
-
*
|
|
246
|
-
* @param {string} path - Path to the file or directory. Relative paths are resolved based on the sandbox working directory.
|
|
247
|
-
* @returns {Promise<FileInfo>} Detailed file information including size, permissions, modification time
|
|
248
|
-
*
|
|
249
|
-
* @example
|
|
250
|
-
* // Get file details
|
|
251
|
-
* const info = await fs.getFileDetails('app/config.json');
|
|
252
|
-
* console.log(`Size: ${info.size}, Modified: ${info.modTime}`);
|
|
253
|
-
*/
|
|
254
|
-
async getFileDetails(path) {
|
|
255
|
-
const response = await this.apiClient.getFileInfo(path);
|
|
256
|
-
return response.data;
|
|
257
|
-
}
|
|
258
|
-
/**
|
|
259
|
-
* Lists contents of a directory in the Sandbox.
|
|
260
|
-
*
|
|
261
|
-
* @param {string} path - Directory path to list. Relative paths are resolved based on the sandbox working directory.
|
|
262
|
-
* @returns {Promise<FileInfo[]>} Array of file and directory information
|
|
263
|
-
*
|
|
264
|
-
* @example
|
|
265
|
-
* // List directory contents
|
|
266
|
-
* const files = await fs.listFiles('app/src');
|
|
267
|
-
* files.forEach(file => {
|
|
268
|
-
* console.log(`${file.name} (${file.size} bytes)`);
|
|
269
|
-
* });
|
|
270
|
-
*/
|
|
271
|
-
async listFiles(path) {
|
|
272
|
-
const response = await this.apiClient.listFiles(path);
|
|
273
|
-
return response.data;
|
|
274
|
-
}
|
|
275
|
-
/**
|
|
276
|
-
* Moves or renames a file or directory.
|
|
277
|
-
*
|
|
278
|
-
* @param {string} source - Source path. Relative paths are resolved based on the sandbox working directory.
|
|
279
|
-
* @param {string} destination - Destination path. Relative paths are resolved based on the sandbox working directory.
|
|
280
|
-
* @returns {Promise<void>}
|
|
281
|
-
*
|
|
282
|
-
* @example
|
|
283
|
-
* // Move a file to a new location
|
|
284
|
-
* await fs.moveFiles('app/temp/data.json', 'app/data/data.json');
|
|
285
|
-
*/
|
|
286
|
-
async moveFiles(source, destination) {
|
|
287
|
-
const response = await this.apiClient.moveFile(source, destination);
|
|
288
|
-
return response.data;
|
|
289
|
-
}
|
|
290
|
-
/**
|
|
291
|
-
* Replaces text content in multiple files.
|
|
292
|
-
*
|
|
293
|
-
* @param {string[]} files - Array of file paths to process. Relative paths are resolved based on the sandbox working directory.
|
|
294
|
-
* @param {string} pattern - Pattern to replace
|
|
295
|
-
* @param {string} newValue - Replacement text
|
|
296
|
-
* @returns {Promise<Array<ReplaceResult>>} Results of the replace operation for each file
|
|
297
|
-
*
|
|
298
|
-
* @example
|
|
299
|
-
* // Update version number across multiple files
|
|
300
|
-
* const results = await fs.replaceInFiles(
|
|
301
|
-
* ['app/package.json', 'app/version.ts'],
|
|
302
|
-
* '"version": "1.0.0"',
|
|
303
|
-
* '"version": "1.1.0"'
|
|
304
|
-
* );
|
|
305
|
-
*/
|
|
306
|
-
async replaceInFiles(files, pattern, newValue) {
|
|
307
|
-
const replaceRequest = {
|
|
308
|
-
files,
|
|
309
|
-
newValue,
|
|
310
|
-
pattern,
|
|
311
|
-
};
|
|
312
|
-
const response = await this.apiClient.replaceInFiles(replaceRequest);
|
|
313
|
-
return response.data;
|
|
314
|
-
}
|
|
315
|
-
/**
|
|
316
|
-
* Searches for files and directories by name pattern in the Sandbox.
|
|
317
|
-
*
|
|
318
|
-
* @param {string} path - Directory to search in. Relative paths are resolved based on the sandbox working directory.
|
|
319
|
-
* @param {string} pattern - File name pattern (supports globs)
|
|
320
|
-
* @returns {Promise<SearchFilesResponse>} Search results with matching files
|
|
321
|
-
*
|
|
322
|
-
* @example
|
|
323
|
-
* // Find all TypeScript files
|
|
324
|
-
* const result = await fs.searchFiles('app', '*.ts');
|
|
325
|
-
* result.files.forEach(file => console.log(file));
|
|
326
|
-
*/
|
|
327
|
-
async searchFiles(path, pattern) {
|
|
328
|
-
const response = await this.apiClient.searchFiles(path, pattern);
|
|
329
|
-
return response.data;
|
|
330
|
-
}
|
|
331
|
-
/**
|
|
332
|
-
* Sets permissions and ownership for a file or directory.
|
|
333
|
-
*
|
|
334
|
-
* @param {string} path - Path to the file or directory. Relative paths are resolved based on the sandbox working directory.
|
|
335
|
-
* @param {FilePermissionsParams} permissions - Permission settings
|
|
336
|
-
* @returns {Promise<void>}
|
|
337
|
-
*
|
|
338
|
-
* @example
|
|
339
|
-
* // Set file permissions and ownership
|
|
340
|
-
* await fs.setFilePermissions('app/script.sh', {
|
|
341
|
-
* owner: 'daytona',
|
|
342
|
-
* group: 'users',
|
|
343
|
-
* mode: '755' // Execute permission for shell script
|
|
344
|
-
* });
|
|
345
|
-
*/
|
|
346
|
-
async setFilePermissions(path, permissions) {
|
|
347
|
-
const response = await this.apiClient.setFilePermissions(path, permissions.owner, permissions.group, permissions.mode);
|
|
348
|
-
return response.data;
|
|
349
|
-
}
|
|
350
|
-
async uploadFile(src, dst, timeout = 30 * 60) {
|
|
351
|
-
await this.uploadFiles([{ source: src, destination: dst }], timeout);
|
|
352
|
-
}
|
|
353
|
-
/**
|
|
354
|
-
* Uploads a single file to the Sandbox using true streaming, with optional progress
|
|
355
|
-
* tracking and cancellation. Memory usage stays flat regardless of source size: the
|
|
356
|
-
* SDK pipes the source through a transform that counts bytes and forwards to the
|
|
357
|
-
* underlying multipart upload without buffering the whole payload. The HTTP layer
|
|
358
|
-
* uses chunked transfer encoding, so the source's natural EOF terminates the upload —
|
|
359
|
-
* no advance size is needed.
|
|
360
|
-
*
|
|
361
|
-
* @param {UploadSource} source - The data to upload. Accepts the same `Buffer | string`
|
|
362
|
-
* inputs as {@link FileSystem.uploadFile}, plus Node `Readable` streams and Web
|
|
363
|
-
* `ReadableStream` instances. When a string is passed, it is treated as a local
|
|
364
|
-
* file path and read in streaming chunks.
|
|
365
|
-
* @param {string} remotePath - Destination path in the Sandbox. Relative paths are
|
|
366
|
-
* resolved against the sandbox working directory.
|
|
367
|
-
* @param {UploadStreamOptions} [options] - Streaming options: AbortSignal, onProgress
|
|
368
|
-
* callback, timeout.
|
|
369
|
-
* @returns {Promise<void>}
|
|
370
|
-
*
|
|
371
|
-
* @example
|
|
372
|
-
* // Upload a 2 GB file with progress tracking and the ability to cancel
|
|
373
|
-
* import { createReadStream } from 'fs';
|
|
374
|
-
* const controller = new AbortController();
|
|
375
|
-
* await sandbox.fs.uploadFileStream(createReadStream('big.bin'), 'tmp/big.bin', {
|
|
376
|
-
* signal: controller.signal,
|
|
377
|
-
* onProgress: ({ bytesSent }) => console.log(`${bytesSent} bytes sent`),
|
|
378
|
-
* });
|
|
379
|
-
*/
|
|
380
|
-
async uploadFileStream(source, remotePath, options = {}) {
|
|
381
|
-
const isNonStreamingRuntime = Runtime_1.RUNTIME === Runtime_1.Runtime.DENO || Runtime_1.RUNTIME === Runtime_1.Runtime.BROWSER || Runtime_1.RUNTIME === Runtime_1.Runtime.SERVERLESS;
|
|
382
|
-
if (isNonStreamingRuntime) {
|
|
383
|
-
throw new DaytonaError_1.DaytonaError('uploadFileStream is not supported in browser, Deno, or serverless runtimes. Use uploadFile instead.');
|
|
371
|
+
const response = await this.apiClient.replaceInFiles(replaceRequest);
|
|
372
|
+
return response.data;
|
|
384
373
|
}
|
|
385
|
-
|
|
386
|
-
|
|
374
|
+
/**
|
|
375
|
+
* Searches for files and directories by name pattern in the Sandbox.
|
|
376
|
+
*
|
|
377
|
+
* @param {string} path - Directory to search in. Relative paths are resolved based on the sandbox working directory.
|
|
378
|
+
* @param {string} pattern - File name pattern (supports globs)
|
|
379
|
+
* @returns {Promise<SearchFilesResponse>} Search results with matching files
|
|
380
|
+
*
|
|
381
|
+
* @example
|
|
382
|
+
* // Find all TypeScript files
|
|
383
|
+
* const result = await fs.searchFiles('app', '*.ts');
|
|
384
|
+
* result.files.forEach(file => console.log(file));
|
|
385
|
+
*/
|
|
386
|
+
async searchFiles(path, pattern) {
|
|
387
|
+
const response = await this.apiClient.searchFiles(path, pattern);
|
|
388
|
+
return response.data;
|
|
387
389
|
}
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
|
|
393
|
-
|
|
394
|
-
|
|
395
|
-
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
399
|
-
|
|
400
|
-
|
|
401
|
-
|
|
402
|
-
|
|
403
|
-
|
|
404
|
-
|
|
390
|
+
/**
|
|
391
|
+
* Sets permissions and ownership for a file or directory.
|
|
392
|
+
*
|
|
393
|
+
* @param {string} path - Path to the file or directory. Relative paths are resolved based on the sandbox working directory.
|
|
394
|
+
* @param {FilePermissionsParams} permissions - Permission settings
|
|
395
|
+
* @returns {Promise<void>}
|
|
396
|
+
*
|
|
397
|
+
* @example
|
|
398
|
+
* // Set file permissions and ownership
|
|
399
|
+
* await fs.setFilePermissions('app/script.sh', {
|
|
400
|
+
* owner: 'daytona',
|
|
401
|
+
* group: 'users',
|
|
402
|
+
* mode: '755' // Execute permission for shell script
|
|
403
|
+
* });
|
|
404
|
+
*/
|
|
405
|
+
async setFilePermissions(path, permissions) {
|
|
406
|
+
const response = await this.apiClient.setFilePermissions(path, permissions.owner, permissions.group, permissions.mode);
|
|
407
|
+
return response.data;
|
|
408
|
+
}
|
|
409
|
+
async uploadFile(src, dst, timeout = 30 * 60) {
|
|
410
|
+
await this.uploadFiles([{ source: src, destination: dst }], timeout);
|
|
405
411
|
}
|
|
406
|
-
|
|
412
|
+
/**
|
|
413
|
+
* Uploads a single file to the Sandbox using true streaming, with optional progress
|
|
414
|
+
* tracking and cancellation. Memory usage stays flat regardless of source size: the
|
|
415
|
+
* SDK pipes the source through a transform that counts bytes and forwards to the
|
|
416
|
+
* underlying multipart upload without buffering the whole payload. The HTTP layer
|
|
417
|
+
* uses chunked transfer encoding, so the source's natural EOF terminates the upload —
|
|
418
|
+
* no advance size is needed.
|
|
419
|
+
*
|
|
420
|
+
* @param {UploadSource} source - The data to upload. Accepts the same `Buffer | string`
|
|
421
|
+
* inputs as {@link FileSystem.uploadFile}, plus Node `Readable` streams and Web
|
|
422
|
+
* `ReadableStream` instances. When a string is passed, it is treated as a local
|
|
423
|
+
* file path and read in streaming chunks.
|
|
424
|
+
* @param {string} remotePath - Destination path in the Sandbox. Relative paths are
|
|
425
|
+
* resolved against the sandbox working directory.
|
|
426
|
+
* @param {UploadStreamOptions} [options] - Streaming options: AbortSignal, onProgress
|
|
427
|
+
* callback, timeout.
|
|
428
|
+
* @returns {Promise<void>}
|
|
429
|
+
*
|
|
430
|
+
* @example
|
|
431
|
+
* // Upload a 2 GB file with progress tracking and the ability to cancel
|
|
432
|
+
* import { createReadStream } from 'fs';
|
|
433
|
+
* const controller = new AbortController();
|
|
434
|
+
* await sandbox.fs.uploadFileStream(createReadStream('big.bin'), 'tmp/big.bin', {
|
|
435
|
+
* signal: controller.signal,
|
|
436
|
+
* onProgress: ({ bytesSent }) => console.log(`${bytesSent} bytes sent`),
|
|
437
|
+
* });
|
|
438
|
+
*/
|
|
439
|
+
async uploadFileStream(source, remotePath, options = {}) {
|
|
440
|
+
const isNonStreamingRuntime = Runtime_1.RUNTIME === Runtime_1.Runtime.DENO || Runtime_1.RUNTIME === Runtime_1.Runtime.BROWSER || Runtime_1.RUNTIME === Runtime_1.Runtime.SERVERLESS;
|
|
441
|
+
if (isNonStreamingRuntime) {
|
|
442
|
+
throw new DaytonaError_1.DaytonaError('uploadFileStream is not supported in browser, Deno, or serverless runtimes. Use uploadFile instead.');
|
|
443
|
+
}
|
|
407
444
|
if (options.signal?.aborted) {
|
|
408
445
|
throw (0, FileTransfer_1.createAbortError)(remotePath);
|
|
409
446
|
}
|
|
410
|
-
|
|
411
|
-
|
|
412
|
-
|
|
413
|
-
|
|
414
|
-
|
|
415
|
-
|
|
416
|
-
|
|
417
|
-
|
|
418
|
-
|
|
419
|
-
|
|
420
|
-
|
|
421
|
-
|
|
422
|
-
|
|
423
|
-
|
|
424
|
-
|
|
425
|
-
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
|
|
429
|
-
|
|
430
|
-
|
|
431
|
-
|
|
432
|
-
|
|
433
|
-
|
|
434
|
-
* source: Buffer.from('{"key": "value"}'),
|
|
435
|
-
* destination: '/tmp/config.json'
|
|
436
|
-
* }
|
|
437
|
-
* ];
|
|
438
|
-
* await fs.uploadFiles(files);
|
|
439
|
-
*/
|
|
440
|
-
async uploadFiles(files, timeout = 30 * 60) {
|
|
441
|
-
const isNonStreamingRuntime = Runtime_1.RUNTIME === Runtime_1.Runtime.DENO || Runtime_1.RUNTIME === Runtime_1.Runtime.BROWSER || Runtime_1.RUNTIME === Runtime_1.Runtime.SERVERLESS;
|
|
442
|
-
const FormDataClass = isNonStreamingRuntime
|
|
443
|
-
? FormData
|
|
444
|
-
: (await (0, Import_1.dynamicImport)('form-data', 'Uploading files is not supported: '));
|
|
445
|
-
const form = new FormDataClass();
|
|
446
|
-
for (const [i, { source, destination }] of files.entries()) {
|
|
447
|
-
form.append(`files[${i}].path`, destination);
|
|
448
|
-
const payload = await this.makeFilePayload(source);
|
|
449
|
-
form.append(`files[${i}].file`, payload, destination);
|
|
450
|
-
}
|
|
451
|
-
if (isNonStreamingRuntime) {
|
|
452
|
-
const url = `${this.clientConfig.basePath}/files/bulk-upload`;
|
|
453
|
-
await fetch(url, {
|
|
454
|
-
method: 'POST',
|
|
455
|
-
headers: this.clientConfig.baseOptions.headers,
|
|
456
|
-
body: form,
|
|
457
|
-
signal: timeout ? AbortSignal.timeout(timeout * 1000) : undefined,
|
|
458
|
-
});
|
|
459
|
-
}
|
|
460
|
-
else {
|
|
461
|
-
await this.apiClient.uploadFiles({
|
|
462
|
-
data: form,
|
|
463
|
-
maxRedirects: 0,
|
|
464
|
-
timeout: timeout * 1000,
|
|
465
|
-
});
|
|
447
|
+
const timeout = options.timeout ?? 30 * 60;
|
|
448
|
+
const sourceStream = await (0, FileTransfer_1.coerceUploadSource)(source);
|
|
449
|
+
const tracked = (0, FileTransfer_1.wrapWithUploadProgress)(sourceStream, options.onProgress, options.signal);
|
|
450
|
+
const FormDataClass = (await (0, Import_1.dynamicImport)('form-data', 'Uploading files is not supported: '));
|
|
451
|
+
const form = new FormDataClass();
|
|
452
|
+
form.append('files[0].path', remotePath);
|
|
453
|
+
// No knownLength: form-data falls back to chunked transfer encoding, which the
|
|
454
|
+
// daemon's MultipartReader handles transparently. The source's EOF terminates
|
|
455
|
+
// the upload — no advance byte count needed.
|
|
456
|
+
form.append('files[0].file', tracked, { filename: remotePath });
|
|
457
|
+
try {
|
|
458
|
+
await this.apiClient.uploadFiles({
|
|
459
|
+
data: form,
|
|
460
|
+
maxRedirects: 0,
|
|
461
|
+
timeout: timeout * 1000,
|
|
462
|
+
signal: options.signal,
|
|
463
|
+
});
|
|
464
|
+
}
|
|
465
|
+
catch (err) {
|
|
466
|
+
if (options.signal?.aborted) {
|
|
467
|
+
throw (0, FileTransfer_1.createAbortError)(remotePath);
|
|
468
|
+
}
|
|
469
|
+
throw err;
|
|
470
|
+
}
|
|
466
471
|
}
|
|
467
|
-
|
|
468
|
-
|
|
469
|
-
|
|
470
|
-
|
|
471
|
-
|
|
472
|
-
|
|
472
|
+
/**
|
|
473
|
+
* Uploads multiple files to the Sandbox. If files already exist at the destination paths,
|
|
474
|
+
* they will be overwritten.
|
|
475
|
+
*
|
|
476
|
+
* @param {FileUpload[]} files - Array of files to upload.
|
|
477
|
+
* @param {number} [timeout] - Timeout for the upload operation in seconds. 0 means no timeout.
|
|
478
|
+
* Default is 30 minutes.
|
|
479
|
+
* @returns {Promise<void>}
|
|
480
|
+
*
|
|
481
|
+
* @example
|
|
482
|
+
* // Upload multiple text files
|
|
483
|
+
* const files = [
|
|
484
|
+
* {
|
|
485
|
+
* source: Buffer.from('Content of file 1'),
|
|
486
|
+
* destination: '/tmp/file1.txt'
|
|
487
|
+
* },
|
|
488
|
+
* {
|
|
489
|
+
* source: 'app/data/file2.txt',
|
|
490
|
+
* destination: '/tmp/file2.txt'
|
|
491
|
+
* },
|
|
492
|
+
* {
|
|
493
|
+
* source: Buffer.from('{"key": "value"}'),
|
|
494
|
+
* destination: '/tmp/config.json'
|
|
495
|
+
* }
|
|
496
|
+
* ];
|
|
497
|
+
* await fs.uploadFiles(files);
|
|
498
|
+
*/
|
|
499
|
+
async uploadFiles(files, timeout = 30 * 60) {
|
|
500
|
+
const isNonStreamingRuntime = Runtime_1.RUNTIME === Runtime_1.Runtime.DENO || Runtime_1.RUNTIME === Runtime_1.Runtime.BROWSER || Runtime_1.RUNTIME === Runtime_1.Runtime.SERVERLESS;
|
|
501
|
+
const FormDataClass = isNonStreamingRuntime
|
|
502
|
+
? FormData
|
|
503
|
+
: (await (0, Import_1.dynamicImport)('form-data', 'Uploading files is not supported: '));
|
|
504
|
+
const form = new FormDataClass();
|
|
505
|
+
for (const [i, { source, destination }] of files.entries()) {
|
|
506
|
+
form.append(`files[${i}].path`, destination);
|
|
507
|
+
const payload = await this.makeFilePayload(source);
|
|
508
|
+
form.append(`files[${i}].file`, payload, destination);
|
|
509
|
+
}
|
|
510
|
+
if (isNonStreamingRuntime) {
|
|
511
|
+
const url = `${this.clientConfig.basePath}/files/bulk-upload`;
|
|
512
|
+
await fetch(url, {
|
|
513
|
+
method: 'POST',
|
|
514
|
+
headers: this.clientConfig.baseOptions.headers,
|
|
515
|
+
body: form,
|
|
516
|
+
signal: timeout ? AbortSignal.timeout(timeout * 1000) : undefined,
|
|
517
|
+
});
|
|
518
|
+
}
|
|
519
|
+
else {
|
|
520
|
+
await this.apiClient.uploadFiles({
|
|
521
|
+
data: form,
|
|
522
|
+
maxRedirects: 0,
|
|
523
|
+
timeout: timeout * 1000,
|
|
524
|
+
});
|
|
525
|
+
}
|
|
473
526
|
}
|
|
474
|
-
|
|
475
|
-
|
|
476
|
-
|
|
477
|
-
|
|
527
|
+
async makeFilePayload(source) {
|
|
528
|
+
// String = file path
|
|
529
|
+
if (typeof source === 'string') {
|
|
530
|
+
const fs = await (0, Import_1.dynamicImport)('fs', 'Uploading file from local file system is not supported: ');
|
|
531
|
+
return fs.createReadStream(source);
|
|
532
|
+
}
|
|
533
|
+
// Blob
|
|
534
|
+
if (Runtime_1.RUNTIME === Runtime_1.Runtime.BROWSER || Runtime_1.RUNTIME === Runtime_1.Runtime.SERVERLESS || Runtime_1.RUNTIME === Runtime_1.Runtime.DENO) {
|
|
535
|
+
// Use .slice() to ensure we have a concrete ArrayBuffer, not ArrayBufferLike
|
|
536
|
+
return new Blob([source.slice()], { type: 'application/octet-stream' });
|
|
537
|
+
}
|
|
538
|
+
// Readable stream
|
|
539
|
+
const stream = await (0, Import_1.dynamicImport)('stream', 'Uploading file is not supported: ');
|
|
540
|
+
return stream.Readable.from(source);
|
|
478
541
|
}
|
|
479
|
-
|
|
480
|
-
|
|
481
|
-
return stream.Readable.from(source);
|
|
482
|
-
}
|
|
483
|
-
}
|
|
542
|
+
};
|
|
543
|
+
})();
|
|
484
544
|
exports.FileSystem = FileSystem;
|
|
485
|
-
tslib_1.__decorate([
|
|
486
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
487
|
-
tslib_1.__metadata("design:type", Function),
|
|
488
|
-
tslib_1.__metadata("design:paramtypes", [String, String]),
|
|
489
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
490
|
-
], FileSystem.prototype, "createFolder", null);
|
|
491
|
-
tslib_1.__decorate([
|
|
492
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
493
|
-
tslib_1.__metadata("design:type", Function),
|
|
494
|
-
tslib_1.__metadata("design:paramtypes", [String, Boolean]),
|
|
495
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
496
|
-
], FileSystem.prototype, "deleteFile", null);
|
|
497
|
-
tslib_1.__decorate([
|
|
498
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
499
|
-
tslib_1.__metadata("design:type", Function),
|
|
500
|
-
tslib_1.__metadata("design:paramtypes", [String, Object, Number]),
|
|
501
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
502
|
-
], FileSystem.prototype, "downloadFile", null);
|
|
503
|
-
tslib_1.__decorate([
|
|
504
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
505
|
-
tslib_1.__metadata("design:type", Function),
|
|
506
|
-
tslib_1.__metadata("design:paramtypes", [String, Object]),
|
|
507
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
508
|
-
], FileSystem.prototype, "downloadFileStream", null);
|
|
509
|
-
tslib_1.__decorate([
|
|
510
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
511
|
-
tslib_1.__metadata("design:type", Function),
|
|
512
|
-
tslib_1.__metadata("design:paramtypes", [Array, Number]),
|
|
513
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
514
|
-
], FileSystem.prototype, "downloadFiles", null);
|
|
515
|
-
tslib_1.__decorate([
|
|
516
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
517
|
-
tslib_1.__metadata("design:type", Function),
|
|
518
|
-
tslib_1.__metadata("design:paramtypes", [String, String]),
|
|
519
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
520
|
-
], FileSystem.prototype, "findFiles", null);
|
|
521
|
-
tslib_1.__decorate([
|
|
522
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
523
|
-
tslib_1.__metadata("design:type", Function),
|
|
524
|
-
tslib_1.__metadata("design:paramtypes", [String]),
|
|
525
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
526
|
-
], FileSystem.prototype, "getFileDetails", null);
|
|
527
|
-
tslib_1.__decorate([
|
|
528
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
529
|
-
tslib_1.__metadata("design:type", Function),
|
|
530
|
-
tslib_1.__metadata("design:paramtypes", [String]),
|
|
531
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
532
|
-
], FileSystem.prototype, "listFiles", null);
|
|
533
|
-
tslib_1.__decorate([
|
|
534
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
535
|
-
tslib_1.__metadata("design:type", Function),
|
|
536
|
-
tslib_1.__metadata("design:paramtypes", [String, String]),
|
|
537
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
538
|
-
], FileSystem.prototype, "moveFiles", null);
|
|
539
|
-
tslib_1.__decorate([
|
|
540
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
541
|
-
tslib_1.__metadata("design:type", Function),
|
|
542
|
-
tslib_1.__metadata("design:paramtypes", [Array, String, String]),
|
|
543
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
544
|
-
], FileSystem.prototype, "replaceInFiles", null);
|
|
545
|
-
tslib_1.__decorate([
|
|
546
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
547
|
-
tslib_1.__metadata("design:type", Function),
|
|
548
|
-
tslib_1.__metadata("design:paramtypes", [String, String]),
|
|
549
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
550
|
-
], FileSystem.prototype, "searchFiles", null);
|
|
551
|
-
tslib_1.__decorate([
|
|
552
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
553
|
-
tslib_1.__metadata("design:type", Function),
|
|
554
|
-
tslib_1.__metadata("design:paramtypes", [String, Object]),
|
|
555
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
556
|
-
], FileSystem.prototype, "setFilePermissions", null);
|
|
557
|
-
tslib_1.__decorate([
|
|
558
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
559
|
-
tslib_1.__metadata("design:type", Function),
|
|
560
|
-
tslib_1.__metadata("design:paramtypes", [Object, String, Number]),
|
|
561
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
562
|
-
], FileSystem.prototype, "uploadFile", null);
|
|
563
|
-
tslib_1.__decorate([
|
|
564
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
565
|
-
tslib_1.__metadata("design:type", Function),
|
|
566
|
-
tslib_1.__metadata("design:paramtypes", [Object, String, Object]),
|
|
567
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
568
|
-
], FileSystem.prototype, "uploadFileStream", null);
|
|
569
|
-
tslib_1.__decorate([
|
|
570
|
-
(0, otel_decorator_1.WithInstrumentation)(),
|
|
571
|
-
tslib_1.__metadata("design:type", Function),
|
|
572
|
-
tslib_1.__metadata("design:paramtypes", [Array, Number]),
|
|
573
|
-
tslib_1.__metadata("design:returntype", Promise)
|
|
574
|
-
], FileSystem.prototype, "uploadFiles", null);
|
|
575
545
|
//# sourceMappingURL=FileSystem.js.map
|