Copy a file into a cloud sandbox

Send project files, scripts, or input data to a running sandbox. Use its file collection instead of putting large file contents into command arguments.
You need a sandbox handle from your first sandbox and an absolute destination path. The paths in these examples are inside the sandbox, not on your computer.
Create the destination directory {#1-create-the-destination-directory}
Create the destination directory with the desired permission mode. The example also creates missing parent directories.
Choose the narrowest permissions the workload needs. Remember that a file's contents and its executable permission are separate settings.
{{< tabs >}}
{{< tab name="TypeScript" >}}
await sandbox.files.mkdir(path, { mode, parents: true });
Complete TypeScript example: upload/mkdir.ts
import type { Sandbox } from '@docker/sandboxes';
export async function makeDirectory(
  sandbox: Sandbox,
  path: string,
  mode: number,
) {
  await sandbox.files.mkdir(path, { mode, parents: true });
}
{{< /tab >}}
{{< /tabs >}}
Write a small text file {#2-write-a-small-text-file}
Use the write helper for a configuration file or short script already held as a string. Pass its destination path and content. For binary data or streamed transfers, use upload instead.
{{< tabs >}}
{{< tab name="TypeScript" >}}
return sandbox.files.write(path, content);
Complete TypeScript example: upload/write.ts
import type { Sandbox } from '@docker/sandboxes';
export async function writeFile(
  sandbox: Sandbox,
  path: string,
  content: string,
) {
  return sandbox.files.write(path, content);
}
{{< /tab >}}
{{< /tabs >}}
Upload file content {#3-upload-file-content}
Upload bytes to the destination and read its metadata afterward. The example accepts content from your application; read a local file first if that is your source.
Choose a file mode explicitly when executable or restricted permissions matter. A failed upload may have written some data. Inspect the destination before retrying if replacing its contents would be unsafe.
Next, run a command that reads the file, or read it back to verify the content.
{{< tabs >}}
{{< tab name="TypeScript" >}}
await sandbox.files.upload(path, content, { mode });
return (await sandbox.files.stat(path)).info;
Complete TypeScript example: upload/upload.ts
import type { Sandbox } from '@docker/sandboxes';
export async function uploadFile(
  sandbox: Sandbox,
  path: string,
  content: Uint8Array,
  mode: number,
) {
  await sandbox.files.upload(path, content, { mode });
  return (await sandbox.files.stat(path)).info;
}
{{< /tab >}}
{{< /tabs >}}