@finalai/sandbox-router-daytona 0.2.0 → 0.2.2

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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../../../../src/client/types.ts"],
4
- "sourcesContent": ["// A client of Daytona's public API (https://www.daytona.io/docs): the control\n// plane at `https://app.daytona.io/api` and each sandbox's toolbox behind its\n// `toolboxProxyUrl`. Every call authenticates with the organization's own\n// Daytona API key. Functions return results and never throw.\n\nexport interface ResultOkIface<T> {\n ok: true;\n data: T;\n}\n\nexport interface ResultErrIface<E extends string = string> {\n ok: false;\n error: E;\n statusCode?: number;\n details?: Array<{ message?: string }>;\n}\n\nexport type ResultIface<T, E extends string = string> = ResultOkIface<T> | ResultErrIface<E>;\n\nexport enum DaytonaErrorCode {\n BadRequest = 'bad_request',\n Unauthorized = 'unauthorized',\n Forbidden = 'forbidden',\n NotFound = 'not_found',\n Conflict = 'conflict',\n RateLimited = 'rate_limited',\n Unavailable = 'unavailable',\n InvalidResponse = 'invalid_response',\n Aborted = 'aborted',\n Timeout = 'timeout',\n Failed = 'failed',\n}\n\nexport type DaytonaResultIface<T> = ResultIface<T, DaytonaErrorCode>;\n\nexport const ok = <T>(data: T): ResultOkIface<T> => ({ ok: true, data });\n\nexport const failure = (\n error: DaytonaErrorCode,\n message: string,\n statusCode?: number,\n): ResultErrIface<DaytonaErrorCode> => ({\n ok: false,\n error,\n statusCode,\n details: [{ message }],\n});\n\nexport const failureMessage = (result: ResultErrIface<DaytonaErrorCode>): string =>\n result.details?.[0]?.message ?? result.error;\n\nexport interface DaytonaFetchIface {\n (input: string, init: RequestInit): Promise<Response>;\n}\n\nexport type DaytonaWebSocketData = ArrayBuffer | ArrayBufferView | string | Blob;\n\n// Opens the log-stream WebSocket (Node's global WebSocket by default); frames\n// arrive as ArrayBuffer, string or Blob.\nexport interface DaytonaWebSocketFactoryIface {\n (args: {\n url: string;\n headers: Record<string, string>;\n protocols?: string[];\n onMessage: (data: DaytonaWebSocketData) => void;\n onClose: (code: number, reason: string) => void;\n }): { close(): void; send(data: Uint8Array | string): void };\n}\n\nexport interface DaytonaClientConfigIface {\n apiKey: string;\n // For API keys that can reach several organizations.\n organizationId?: string;\n // Defaults to https://app.daytona.io/api.\n apiUrl?: string;\n fetch?: DaytonaFetchIface;\n webSocket?: DaytonaWebSocketFactoryIface;\n now?: () => number;\n sleep?: (ms: number) => Promise<void>;\n}\n\n// Lifecycle states the provider acts on; anything else reads as Other.\nexport enum DaytonaSandboxState {\n Creating = 'creating',\n Restoring = 'restoring',\n Started = 'started',\n Starting = 'starting',\n Stopped = 'stopped',\n Stopping = 'stopping',\n Archived = 'archived',\n Archiving = 'archiving',\n Paused = 'paused',\n Pausing = 'pausing',\n Resuming = 'resuming',\n Destroying = 'destroying',\n Destroyed = 'destroyed',\n Error = 'error',\n BuildFailed = 'build_failed',\n PendingBuild = 'pending_build',\n BuildingSnapshot = 'building_snapshot',\n PullingSnapshot = 'pulling_snapshot',\n Resizing = 'resizing',\n Snapshotting = 'snapshotting',\n Forking = 'forking',\n Unknown = 'unknown',\n Other = 'other',\n}\n\nexport interface DaytonaSandboxIface {\n id: string;\n name: string;\n state: DaytonaSandboxState;\n // The state as Daytona reported it.\n nativeState: string;\n errorReason: string | null;\n // Daytona's region, such as `us` or `eu`.\n target: string;\n user: string;\n snapshot: string | null;\n toolboxProxyUrl: string;\n labels: Record<string, string>;\n cpu: number | null;\n // GiB.\n memory: number | null;\n disk: number | null;\n createdAt: string | null;\n networkBlockAll?: boolean;\n networkPolicyComplete?: boolean;\n networkAllowList?: string;\n domainAllowList?: string;\n}\n\nexport interface DaytonaCreateSandboxBodyIface {\n name: string;\n snapshot?: string;\n target?: string;\n user?: string;\n env?: Record<string, string>;\n labels?: Record<string, string>;\n public?: boolean;\n networkBlockAll?: boolean;\n networkAllowList?: string;\n domainAllowList?: string;\n autoStopInterval?: number;\n autoArchiveInterval?: number;\n autoDeleteInterval?: number;\n ttlMinutes?: number;\n cpu?: number;\n // GiB.\n memory?: number;\n disk?: number;\n buildInfo?: { dockerfileContent: string; contextHashes?: string[] };\n}\n\nexport interface DaytonaNetworkSettingsIface {\n networkBlockAll?: boolean;\n // Comma-separated CIDR blocks.\n networkAllowList?: string;\n // Comma-separated domains.\n domainAllowList?: string;\n}\n\nexport enum DaytonaSnapshotState {\n Building = 'building',\n Pending = 'pending',\n Pulling = 'pulling',\n Snapshotting = 'snapshotting',\n Active = 'active',\n Inactive = 'inactive',\n Error = 'error',\n BuildFailed = 'build_failed',\n Removing = 'removing',\n Other = 'other',\n}\n\nexport interface DaytonaSnapshotIface {\n id: string;\n name: string;\n state: DaytonaSnapshotState;\n errorReason: string | null;\n}\n\nexport interface DaytonaCreateSnapshotBodyIface {\n name: string;\n imageName: string;\n cpu?: number;\n memory?: number;\n disk?: number;\n regionId?: string;\n}\n\nexport interface DaytonaPreviewIface {\n url: string;\n // Sent as `X-Daytona-Preview-Token` when the sandbox is not public.\n token: string;\n}\n\nexport interface DaytonaFileInfoIface {\n name: string;\n path: string | null;\n isDir: boolean;\n size: number;\n modifiedAt: string | null;\n // Octal permission bits, such as 0o644.\n mode: number | null;\n}\n\n// A sandbox's toolbox address, as the control plane reports it.\nexport interface DaytonaToolboxRefIface {\n sandboxId: string;\n toolboxProxyUrl: string;\n}\n\nexport interface DaytonaSpawnOptionsIface {\n command: string;\n args: string[];\n // Through `bash -lc` instead of exec'ing the program.\n shell: boolean;\n cwd: string;\n env: Record<string, string>;\n // Keep stdin open for `write`; otherwise it reads from /dev/null.\n stdin: boolean;\n // Keep the session after the handle goes away and after exit; `signal` then\n // detaches instead of killing.\n durable?: boolean;\n // Enforced inside the sandbox by `timeout` (exit 124).\n timeoutMs?: number | null;\n signal?: AbortSignal;\n}\n\nexport interface DaytonaProcessIface {\n readonly id: string;\n // A durable process's ref for `attach`; null otherwise.\n readonly ref: string | null;\n readonly stdout: ReadableStream<Uint8Array>;\n readonly stderr: ReadableStream<Uint8Array>;\n write(data: Uint8Array): Promise<DaytonaResultIface<void>>;\n closeStdin(): Promise<DaytonaResultIface<void>>;\n kill(): Promise<DaytonaResultIface<void>>;\n // Resolves when the process ended; 137 when killed.\n wait(): Promise<DaytonaResultIface<{ exitCode: number }>>;\n}\n\nexport interface DaytonaToolboxIface {\n workDir(): Promise<DaytonaResultIface<string>>;\n // Null when the file does not exist.\n download(args: {\n path: string;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<ReadableStream<Uint8Array> | null>>;\n // Overwrites. Create the parent first with createFolder.\n upload(args: {\n path: string;\n content: ReadableStream<Uint8Array> | Uint8Array;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<void>>;\n // Creates the directory and any missing parents; succeeds when it exists.\n createFolder(args: { path: string; signal?: AbortSignal }): Promise<DaytonaResultIface<void>>;\n info(args: {\n path: string;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<DaytonaFileInfoIface | null>>;\n list(args: {\n path: string;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<DaytonaFileInfoIface[] | null>>;\n // False when nothing was there.\n remove(args: {\n path: string;\n recursive: boolean;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<boolean>>;\n setMode(args: { path: string; mode: number }): Promise<DaytonaResultIface<void>>;\n spawn(options: DaytonaSpawnOptionsIface): Promise<DaytonaResultIface<DaytonaProcessIface>>;\n createPty(args: DaytonaPtyCreateIface): Promise<DaytonaResultIface<void>>;\n // Streams the terminal's output until it exits.\n connectPty(args: {\n id: string;\n onData: (bytes: Uint8Array) => void;\n onExit: (exit: { exitCode: number | null; reason: string | null }) => void;\n }): Promise<DaytonaResultIface<DaytonaPtyConnectionIface>>;\n resizePty(args: { id: string; cols: number; rows: number }): Promise<DaytonaResultIface<void>>;\n // Succeeds when the terminal is already gone.\n deletePty(id: string): Promise<DaytonaResultIface<void>>;\n // A durable process again, its streams after the given offsets; null when\n // the sandbox no longer has it. Aborting `signal` detaches.\n attach(args: {\n ref: string;\n stdoutOffset: number;\n stderrOffset: number;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<DaytonaAttachedProcessIface | null>>;\n}\n\nexport type DaytonaAttachedProcessIface = Pick<\n DaytonaProcessIface,\n 'stdout' | 'stderr' | 'kill' | 'wait'\n>;\n\nexport interface DaytonaClientIface {\n createSandbox(\n body: DaytonaCreateSandboxBodyIface,\n ): Promise<DaytonaResultIface<DaytonaSandboxIface>>;\n // By id or name; null when Daytona has no such sandbox.\n getSandbox(idOrName: string): Promise<DaytonaResultIface<DaytonaSandboxIface | null>>;\n // Sandboxes carrying every given label.\n listSandboxes(labels: Record<string, string>): Promise<DaytonaResultIface<DaytonaSandboxIface[]>>;\n setAutoStop(idOrName: string, minutes: number): Promise<DaytonaResultIface<void>>;\n setAutoDelete(idOrName: string, minutes: number): Promise<DaytonaResultIface<void>>;\n setTtl(idOrName: string, minutes: number): Promise<DaytonaResultIface<void>>;\n // Captures the sandbox's filesystem as a snapshot with this name.\n snapshotSandbox(idOrName: string, name: string): Promise<DaytonaResultIface<void>>;\n startSandbox(idOrName: string): Promise<DaytonaResultIface<DaytonaSandboxIface>>;\n stopSandbox(idOrName: string): Promise<DaytonaResultIface<DaytonaSandboxIface>>;\n archiveSandbox(idOrName: string): Promise<DaytonaResultIface<DaytonaSandboxIface>>;\n // Succeeds when the sandbox is already gone.\n deleteSandbox(idOrName: string): Promise<DaytonaResultIface<void>>;\n updateNetworkSettings(\n idOrName: string,\n settings: DaytonaNetworkSettingsIface,\n ): Promise<DaytonaResultIface<void>>;\n previewUrl(idOrName: string, port: number): Promise<DaytonaResultIface<DaytonaPreviewIface>>;\n // A URL that works without headers until it expires.\n signedPreviewUrl(\n idOrName: string,\n port: number,\n expiresInSeconds: number,\n ): Promise<DaytonaResultIface<string>>;\n // By name; null when the organization has no such snapshot.\n getSnapshot(name: string): Promise<DaytonaResultIface<DaytonaSnapshotIface | null>>;\n createSnapshot(\n body: DaytonaCreateSnapshotBodyIface,\n ): Promise<DaytonaResultIface<DaytonaSnapshotIface>>;\n // Succeeds when the snapshot is already gone.\n deleteSnapshot(id: string): Promise<DaytonaResultIface<void>>;\n toolbox(ref: DaytonaToolboxRefIface): DaytonaToolboxIface;\n}\n\nexport interface DaytonaPtyCreateIface {\n id: string;\n cols: number;\n rows: number;\n cwd?: string;\n envs?: Record<string, string>;\n}\n\nexport interface DaytonaPtyConnectionIface {\n send(data: Uint8Array): void;\n close(): void;\n}\n"],
5
- "mappings": "AAmBO,IAAK,mBAAL,kBAAKA,sBAAL;AACL,EAAAA,kBAAA,gBAAa;AACb,EAAAA,kBAAA,kBAAe;AACf,EAAAA,kBAAA,eAAY;AACZ,EAAAA,kBAAA,cAAW;AACX,EAAAA,kBAAA,cAAW;AACX,EAAAA,kBAAA,iBAAc;AACd,EAAAA,kBAAA,iBAAc;AACd,EAAAA,kBAAA,qBAAkB;AAClB,EAAAA,kBAAA,aAAU;AACV,EAAAA,kBAAA,aAAU;AACV,EAAAA,kBAAA,YAAS;AAXC,SAAAA;AAAA,GAAA;AAgBL,MAAM,KAAK,CAAI,UAA+B,EAAE,IAAI,MAAM,KAAK;AAE/D,MAAM,UAAU,CACrB,OACA,SACA,gBACsC;AAAA,EACtC,IAAI;AAAA,EACJ;AAAA,EACA;AAAA,EACA,SAAS,CAAC,EAAE,QAAQ,CAAC;AACvB;AAEO,MAAM,iBAAiB,CAAC,WAC7B,OAAO,UAAU,CAAC,GAAG,WAAW,OAAO;AAiClC,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,YAAS;AACT,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,gBAAa;AACb,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,WAAQ;AACR,EAAAA,qBAAA,iBAAc;AACd,EAAAA,qBAAA,kBAAe;AACf,EAAAA,qBAAA,sBAAmB;AACnB,EAAAA,qBAAA,qBAAkB;AAClB,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,kBAAe;AACf,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,WAAQ;AAvBE,SAAAA;AAAA,GAAA;AAgFL,IAAK,uBAAL,kBAAKC,0BAAL;AACL,EAAAA,sBAAA,cAAW;AACX,EAAAA,sBAAA,aAAU;AACV,EAAAA,sBAAA,aAAU;AACV,EAAAA,sBAAA,kBAAe;AACf,EAAAA,sBAAA,YAAS;AACT,EAAAA,sBAAA,cAAW;AACX,EAAAA,sBAAA,WAAQ;AACR,EAAAA,sBAAA,iBAAc;AACd,EAAAA,sBAAA,cAAW;AACX,EAAAA,sBAAA,WAAQ;AAVE,SAAAA;AAAA,GAAA;",
6
- "names": ["DaytonaErrorCode", "DaytonaSandboxState", "DaytonaSnapshotState"]
4
+ "sourcesContent": ["// A client of Daytona's public API (https://www.daytona.io/docs): the control\n// plane at `https://app.daytona.io/api` and each sandbox's toolbox behind its\n// `toolboxProxyUrl`. Every call authenticates with the organization's own\n// Daytona API key. Functions return results and never throw.\n\nexport interface ResultOkIface<T> {\n ok: true;\n data: T;\n}\n\nexport interface ResultErrIface<E extends string = string> {\n ok: false;\n error: E;\n statusCode?: number;\n details?: Array<{ message?: string }>;\n}\n\nexport type ResultIface<T, E extends string = string> = ResultOkIface<T> | ResultErrIface<E>;\n\nexport enum DaytonaErrorCode {\n BadRequest = 'bad_request',\n Unauthorized = 'unauthorized',\n Forbidden = 'forbidden',\n NotFound = 'not_found',\n Conflict = 'conflict',\n RateLimited = 'rate_limited',\n Unavailable = 'unavailable',\n InvalidResponse = 'invalid_response',\n Aborted = 'aborted',\n Timeout = 'timeout',\n Failed = 'failed',\n}\n\nexport type DaytonaResultIface<T> = ResultIface<T, DaytonaErrorCode>;\n\nexport const ok = <T>(data: T): ResultOkIface<T> => ({ ok: true, data });\n\nexport const failure = (\n error: DaytonaErrorCode,\n message: string,\n statusCode?: number,\n): ResultErrIface<DaytonaErrorCode> => ({\n ok: false,\n error,\n statusCode,\n details: [{ message }],\n});\n\nexport const failureMessage = (result: ResultErrIface<DaytonaErrorCode>): string =>\n result.details?.[0]?.message ?? result.error;\n\nexport interface DaytonaFetchIface {\n (input: string, init: RequestInit): Promise<Response>;\n}\n\nexport type DaytonaWebSocketData = ArrayBuffer | ArrayBufferView | string | Blob;\n\n// Opens the log-stream WebSocket (Node's global WebSocket by default); frames\n// arrive as ArrayBuffer, string or Blob.\nexport interface DaytonaWebSocketFactoryIface {\n (args: {\n url: string;\n headers: Record<string, string>;\n protocols?: string[];\n onMessage: (data: DaytonaWebSocketData) => void;\n onClose: (code: number, reason: string) => void;\n }): { close(): void; send(data: Uint8Array | string): void };\n}\n\nexport interface DaytonaClientConfigIface {\n apiKey: string;\n // For API keys that can reach several organizations.\n organizationId?: string;\n // Defaults to https://app.daytona.io/api.\n apiUrl?: string;\n fetch?: DaytonaFetchIface;\n webSocket?: DaytonaWebSocketFactoryIface;\n now?: () => number;\n sleep?: (ms: number) => Promise<void>;\n}\n\n// Lifecycle states the provider acts on; anything else reads as Other.\nexport enum DaytonaSandboxState {\n Creating = 'creating',\n Restoring = 'restoring',\n Started = 'started',\n Starting = 'starting',\n Stopped = 'stopped',\n Stopping = 'stopping',\n Archived = 'archived',\n Archiving = 'archiving',\n Paused = 'paused',\n Pausing = 'pausing',\n Resuming = 'resuming',\n Destroying = 'destroying',\n Destroyed = 'destroyed',\n Error = 'error',\n BuildFailed = 'build_failed',\n PendingBuild = 'pending_build',\n BuildingSnapshot = 'building_snapshot',\n PullingSnapshot = 'pulling_snapshot',\n Resizing = 'resizing',\n Snapshotting = 'snapshotting',\n Forking = 'forking',\n Unknown = 'unknown',\n Other = 'other',\n}\n\nexport interface DaytonaSandboxIface {\n id: string;\n name: string;\n organizationId: string | null;\n // Set when the sandbox waited too long for a runner and its create was cancelled.\n queueTimedOutAt: string | null;\n state: DaytonaSandboxState;\n // The state as Daytona reported it.\n nativeState: string;\n errorReason: string | null;\n // Daytona's region, such as `us` or `eu`.\n target: string;\n user: string;\n snapshot: string | null;\n toolboxProxyUrl: string;\n labels: Record<string, string>;\n // Every port's preview answers without a token.\n public: boolean;\n cpu: number | null;\n // GiB.\n memory: number | null;\n disk: number | null;\n createdAt: string | null;\n // Minutes; 0 disables auto-stop.\n autoStopInterval: number | null;\n // Minutes after a stop; negative disables it.\n autoDeleteInterval: number | null;\n // When the time to live deletes the sandbox.\n autoDestroyAt: string | null;\n networkBlockAll?: boolean;\n networkPolicyComplete?: boolean;\n networkAllowList?: string;\n domainAllowList?: string;\n}\n\nexport interface DaytonaCreateSandboxBodyIface {\n name: string;\n snapshot?: string;\n target?: string;\n user?: string;\n env?: Record<string, string>;\n labels?: Record<string, string>;\n public?: boolean;\n networkBlockAll?: boolean;\n networkAllowList?: string;\n domainAllowList?: string;\n autoStopInterval?: number;\n autoArchiveInterval?: number;\n autoDeleteInterval?: number;\n ttlMinutes?: number;\n cpu?: number;\n // GiB.\n memory?: number;\n disk?: number;\n volumes?: { volumeId: string; mountPath: string }[];\n buildInfo?: { dockerfileContent: string; contextHashes?: string[] };\n}\n\nexport interface DaytonaNetworkSettingsIface {\n networkBlockAll?: boolean;\n // Comma-separated CIDR blocks.\n networkAllowList?: string;\n // Comma-separated domains.\n domainAllowList?: string;\n}\n\nexport enum DaytonaSnapshotState {\n Building = 'building',\n Pending = 'pending',\n Pulling = 'pulling',\n Snapshotting = 'snapshotting',\n Active = 'active',\n Inactive = 'inactive',\n Error = 'error',\n BuildFailed = 'build_failed',\n Removing = 'removing',\n Other = 'other',\n}\n\nexport interface DaytonaSnapshotIface {\n id: string;\n name: string;\n state: DaytonaSnapshotState;\n errorReason: string | null;\n sizeGb: number | null;\n createdAt: string | null;\n // The sandbox it was taken from; null for snapshots built from an image.\n sourceSandboxId: string | null;\n}\n\nexport enum DaytonaVolumeState {\n PendingCreate = 'pending_create',\n Creating = 'creating',\n Ready = 'ready',\n PendingDelete = 'pending_delete',\n Deleting = 'deleting',\n Deleted = 'deleted',\n Error = 'error',\n Other = 'other',\n}\n\nexport interface DaytonaVolumeIface {\n id: string;\n name: string;\n state: DaytonaVolumeState;\n nativeState: string;\n errorReason: string | null;\n}\n\nexport interface DaytonaCreateSnapshotBodyIface {\n name: string;\n imageName: string;\n cpu?: number;\n memory?: number;\n disk?: number;\n regionId?: string;\n}\n\nexport interface DaytonaPreviewIface {\n url: string;\n // Sent as `X-Daytona-Preview-Token` when the sandbox is not public.\n token: string;\n}\n\nexport interface DaytonaAuditEventIface {\n id: string;\n action: string;\n statusCode: number | null;\n errorMessage: string | null;\n createdAt: string;\n}\n\nexport interface DaytonaSshAccessIface {\n token: string;\n expiresAt: string;\n // The command that logs in with `token`.\n sshCommand: string;\n}\n\n// A process started through `spawn` with `durable`, as the sandbox lists it.\nexport interface DaytonaListedProcessIface {\n ref: string;\n // The command as given to `spawn`, run as `user` when `asUser` wrapped it.\n command: string;\n cwd: string | null;\n user: string | null;\n running: boolean;\n exitCode: number | null;\n startedAt: string | null;\n}\n\nexport interface DaytonaFileInfoIface {\n name: string;\n path: string | null;\n isDir: boolean;\n size: number;\n modifiedAt: string | null;\n // Octal permission bits, such as 0o644.\n mode: number | null;\n}\n\n// A sandbox's toolbox address, as the control plane reports it.\nexport interface DaytonaToolboxRefIface {\n sandboxId: string;\n toolboxProxyUrl: string;\n}\n\nexport interface DaytonaSpawnOptionsIface {\n command: string;\n args: string[];\n // Through `bash -lc` instead of exec'ing the program.\n shell: boolean;\n cwd: string;\n env: Record<string, string>;\n // Keep stdin open for `write`; otherwise it reads from /dev/null.\n stdin: boolean;\n // Keep the session after the handle goes away and after exit; `signal` then\n // detaches instead of killing.\n durable?: boolean;\n // Enforced inside the sandbox by `timeout` (exit 124).\n timeoutMs?: number | null;\n signal?: AbortSignal;\n}\n\nexport interface DaytonaProcessIface {\n readonly id: string;\n // A durable process's ref for `attach`; null otherwise.\n readonly ref: string | null;\n readonly stdout: ReadableStream<Uint8Array>;\n readonly stderr: ReadableStream<Uint8Array>;\n write(data: Uint8Array): Promise<DaytonaResultIface<void>>;\n closeStdin(): Promise<DaytonaResultIface<void>>;\n kill(): Promise<DaytonaResultIface<void>>;\n // Resolves when the process ended; 137 when killed.\n wait(): Promise<DaytonaResultIface<{ exitCode: number }>>;\n}\n\nexport interface DaytonaToolboxIface {\n workDir(): Promise<DaytonaResultIface<string>>;\n // Null when the file does not exist.\n download(args: {\n path: string;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<ReadableStream<Uint8Array> | null>>;\n // Overwrites. Create the parent first with createFolder.\n upload(args: {\n path: string;\n content: ReadableStream<Uint8Array> | Uint8Array;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<void>>;\n // Creates the directory and any missing parents; succeeds when it exists.\n createFolder(args: { path: string; signal?: AbortSignal }): Promise<DaytonaResultIface<void>>;\n info(args: {\n path: string;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<DaytonaFileInfoIface | null>>;\n list(args: {\n path: string;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<DaytonaFileInfoIface[] | null>>;\n // False when nothing was there.\n remove(args: {\n path: string;\n recursive: boolean;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<boolean>>;\n setMode(args: { path: string; mode: number }): Promise<DaytonaResultIface<void>>;\n spawn(options: DaytonaSpawnOptionsIface): Promise<DaytonaResultIface<DaytonaProcessIface>>;\n // Ports something in the sandbox listens on.\n openPorts(): Promise<DaytonaResultIface<number[]>>;\n // The computer-use desktop: `active` once every part runs.\n computerUseStatus(): Promise<DaytonaResultIface<string>>;\n // POSTs a computer-use action (`start`, `stop`, `mouse/move`, ...).\n computerUse(action: string, body?: unknown): Promise<DaytonaResultIface<void>>;\n displaySize(): Promise<DaytonaResultIface<{ width: number; height: number } | null>>;\n // A PNG of the desktop.\n screenshot(): Promise<DaytonaResultIface<Uint8Array>>;\n // Durable processes the sandbox still has, running or exited.\n listProcesses(): Promise<DaytonaResultIface<DaytonaListedProcessIface[]>>;\n createPty(args: DaytonaPtyCreateIface): Promise<DaytonaResultIface<void>>;\n // Streams the terminal's output until it exits.\n connectPty(args: {\n id: string;\n onData: (bytes: Uint8Array) => void;\n onExit: (exit: { exitCode: number | null; reason: string | null }) => void;\n }): Promise<DaytonaResultIface<DaytonaPtyConnectionIface>>;\n resizePty(args: { id: string; cols: number; rows: number }): Promise<DaytonaResultIface<void>>;\n // Succeeds when the terminal is already gone.\n deletePty(id: string): Promise<DaytonaResultIface<void>>;\n // A durable process again, its streams after the given offsets; null when\n // the sandbox no longer has it. Aborting `signal` detaches.\n attach(args: {\n ref: string;\n stdoutOffset: number;\n stderrOffset: number;\n signal?: AbortSignal;\n }): Promise<DaytonaResultIface<DaytonaAttachedProcessIface | null>>;\n}\n\nexport type DaytonaAttachedProcessIface = Pick<\n DaytonaProcessIface,\n 'stdout' | 'stderr' | 'kill' | 'wait'\n>;\n\nexport interface DaytonaClientIface {\n createSandbox(\n body: DaytonaCreateSandboxBodyIface,\n ): Promise<DaytonaResultIface<DaytonaSandboxIface>>;\n // By id or name; null when Daytona has no such sandbox.\n getSandbox(idOrName: string): Promise<DaytonaResultIface<DaytonaSandboxIface | null>>;\n // Sandboxes carrying every given label.\n // Regions this organization can create sandboxes in.\n listRegions(): Promise<DaytonaResultIface<string[]>>;\n listSandboxes(labels: Record<string, string>): Promise<DaytonaResultIface<DaytonaSandboxIface[]>>;\n setAutoStop(idOrName: string, minutes: number): Promise<DaytonaResultIface<void>>;\n setAutoDelete(idOrName: string, minutes: number): Promise<DaytonaResultIface<void>>;\n setTtl(idOrName: string, minutes: number): Promise<DaytonaResultIface<void>>;\n // Captures the sandbox's filesystem as a snapshot with this name.\n snapshotSandbox(idOrName: string, name: string): Promise<DaytonaResultIface<void>>;\n startSandbox(idOrName: string): Promise<DaytonaResultIface<DaytonaSandboxIface>>;\n stopSandbox(idOrName: string): Promise<DaytonaResultIface<DaytonaSandboxIface>>;\n archiveSandbox(idOrName: string): Promise<DaytonaResultIface<DaytonaSandboxIface>>;\n // Succeeds when the sandbox is already gone.\n deleteSandbox(idOrName: string): Promise<DaytonaResultIface<void>>;\n updateNetworkSettings(\n idOrName: string,\n settings: DaytonaNetworkSettingsIface,\n ): Promise<DaytonaResultIface<void>>;\n previewUrl(idOrName: string, port: number): Promise<DaytonaResultIface<DaytonaPreviewIface>>;\n // A URL that works without headers until it expires; `token` is the part of it that does.\n signedPreviewUrl(\n idOrName: string,\n port: number,\n expiresInSeconds: number,\n ): Promise<DaytonaResultIface<{ url: string; token: string }>>;\n // Replaces every label; resolves to the sandbox's id.\n replaceLabels(\n idOrName: string,\n labels: Record<string, string>,\n ): Promise<DaytonaResultIface<string>>;\n // API actions on a sandbox from the organization's audit log, newest first.\n auditEvents(args: {\n organizationId: string;\n sandboxId: string;\n before?: string;\n limit: number;\n }): Promise<DaytonaResultIface<DaytonaAuditEventIface[]>>;\n // An SSH login to the sandbox that expires.\n createSshAccess(\n idOrName: string,\n expiresInMinutes: number,\n ): Promise<DaytonaResultIface<DaytonaSshAccessIface>>;\n // By name; null when the organization has no such snapshot.\n getSnapshot(name: string): Promise<DaytonaResultIface<DaytonaSnapshotIface | null>>;\n createSnapshot(\n body: DaytonaCreateSnapshotBodyIface,\n ): Promise<DaytonaResultIface<DaytonaSnapshotIface>>;\n // Succeeds when the snapshot is already gone.\n deleteSnapshot(id: string): Promise<DaytonaResultIface<void>>;\n // Makes a snapshot Daytona deactivated for disuse usable again.\n activateSnapshot(id: string): Promise<DaytonaResultIface<void>>;\n listSnapshots(): Promise<DaytonaResultIface<DaytonaSnapshotIface[]>>;\n createVolume(name: string): Promise<DaytonaResultIface<DaytonaVolumeIface>>;\n // By id; null when the organization has no such volume.\n getVolume(id: string): Promise<DaytonaResultIface<DaytonaVolumeIface | null>>;\n getVolumeByName(name: string): Promise<DaytonaResultIface<DaytonaVolumeIface | null>>;\n listVolumes(): Promise<DaytonaResultIface<DaytonaVolumeIface[]>>;\n // Succeeds when the volume is already gone.\n deleteVolume(id: string): Promise<DaytonaResultIface<void>>;\n toolbox(ref: DaytonaToolboxRefIface): DaytonaToolboxIface;\n}\n\nexport interface DaytonaPtyCreateIface {\n id: string;\n cols: number;\n rows: number;\n cwd?: string;\n envs?: Record<string, string>;\n}\n\nexport interface DaytonaPtyConnectionIface {\n send(data: Uint8Array): void;\n close(): void;\n}\n"],
5
+ "mappings": "AAmBO,IAAK,mBAAL,kBAAKA,sBAAL;AACL,EAAAA,kBAAA,gBAAa;AACb,EAAAA,kBAAA,kBAAe;AACf,EAAAA,kBAAA,eAAY;AACZ,EAAAA,kBAAA,cAAW;AACX,EAAAA,kBAAA,cAAW;AACX,EAAAA,kBAAA,iBAAc;AACd,EAAAA,kBAAA,iBAAc;AACd,EAAAA,kBAAA,qBAAkB;AAClB,EAAAA,kBAAA,aAAU;AACV,EAAAA,kBAAA,aAAU;AACV,EAAAA,kBAAA,YAAS;AAXC,SAAAA;AAAA,GAAA;AAgBL,MAAM,KAAK,CAAI,UAA+B,EAAE,IAAI,MAAM,KAAK;AAE/D,MAAM,UAAU,CACrB,OACA,SACA,gBACsC;AAAA,EACtC,IAAI;AAAA,EACJ;AAAA,EACA;AAAA,EACA,SAAS,CAAC,EAAE,QAAQ,CAAC;AACvB;AAEO,MAAM,iBAAiB,CAAC,WAC7B,OAAO,UAAU,CAAC,GAAG,WAAW,OAAO;AAiClC,IAAK,sBAAL,kBAAKC,yBAAL;AACL,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,YAAS;AACT,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,gBAAa;AACb,EAAAA,qBAAA,eAAY;AACZ,EAAAA,qBAAA,WAAQ;AACR,EAAAA,qBAAA,iBAAc;AACd,EAAAA,qBAAA,kBAAe;AACf,EAAAA,qBAAA,sBAAmB;AACnB,EAAAA,qBAAA,qBAAkB;AAClB,EAAAA,qBAAA,cAAW;AACX,EAAAA,qBAAA,kBAAe;AACf,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,aAAU;AACV,EAAAA,qBAAA,WAAQ;AAvBE,SAAAA;AAAA,GAAA;AA4FL,IAAK,uBAAL,kBAAKC,0BAAL;AACL,EAAAA,sBAAA,cAAW;AACX,EAAAA,sBAAA,aAAU;AACV,EAAAA,sBAAA,aAAU;AACV,EAAAA,sBAAA,kBAAe;AACf,EAAAA,sBAAA,YAAS;AACT,EAAAA,sBAAA,cAAW;AACX,EAAAA,sBAAA,WAAQ;AACR,EAAAA,sBAAA,iBAAc;AACd,EAAAA,sBAAA,cAAW;AACX,EAAAA,sBAAA,WAAQ;AAVE,SAAAA;AAAA,GAAA;AAwBL,IAAK,qBAAL,kBAAKC,wBAAL;AACL,EAAAA,oBAAA,mBAAgB;AAChB,EAAAA,oBAAA,cAAW;AACX,EAAAA,oBAAA,WAAQ;AACR,EAAAA,oBAAA,mBAAgB;AAChB,EAAAA,oBAAA,cAAW;AACX,EAAAA,oBAAA,aAAU;AACV,EAAAA,oBAAA,WAAQ;AACR,EAAAA,oBAAA,WAAQ;AARE,SAAAA;AAAA,GAAA;",
6
+ "names": ["DaytonaErrorCode", "DaytonaSandboxState", "DaytonaSnapshotState", "DaytonaVolumeState"]
7
7
  }
@@ -0,0 +1,7 @@
1
+ import type { DaytonaHttpIface } from "./request.mjs";
2
+ import { type DaytonaClientIface } from "./types.mjs";
3
+ export type DaytonaVolumesGroupIface = Pick<DaytonaClientIface, 'createVolume' | 'getVolume' | 'getVolumeByName' | 'listVolumes' | 'deleteVolume'>;
4
+ export declare const createVolumesGroup: (args: {
5
+ http: DaytonaHttpIface;
6
+ apiUrl: string;
7
+ }) => DaytonaVolumesGroupIface;
@@ -0,0 +1,68 @@
1
+ import * as z from "zod";
2
+ import {
3
+ DaytonaErrorCode,
4
+ DaytonaVolumeState,
5
+ ok
6
+ } from "./types.mjs";
7
+ const states = new Set(Object.values(DaytonaVolumeState));
8
+ const volumeSchema = z.object({
9
+ id: z.string(),
10
+ name: z.string(),
11
+ state: z.string(),
12
+ errorReason: z.string().nullish()
13
+ }).transform(
14
+ (raw) => ({
15
+ id: raw.id,
16
+ name: raw.name,
17
+ state: states.has(raw.state) ? z.nativeEnum(DaytonaVolumeState).parse(raw.state) : DaytonaVolumeState.Other,
18
+ nativeState: raw.state,
19
+ errorReason: raw.errorReason ?? null
20
+ })
21
+ );
22
+ const createVolumesGroup = (args) => {
23
+ const { http } = args;
24
+ const missingIsNull = (result) => !result.ok && result.error === DaytonaErrorCode.NotFound ? ok(null) : result;
25
+ return {
26
+ createVolume: (name) => http.json({
27
+ method: "POST",
28
+ url: `${args.apiUrl}/volumes`,
29
+ what: `create volume ${name}`,
30
+ json: { name },
31
+ schema: volumeSchema
32
+ }),
33
+ getVolume: async (id) => missingIsNull(
34
+ await http.json({
35
+ method: "GET",
36
+ url: `${args.apiUrl}/volumes/${encodeURIComponent(id)}`,
37
+ what: `get volume ${id}`,
38
+ schema: volumeSchema
39
+ })
40
+ ),
41
+ getVolumeByName: async (name) => missingIsNull(
42
+ await http.json({
43
+ method: "GET",
44
+ url: `${args.apiUrl}/volumes/by-name/${encodeURIComponent(name)}`,
45
+ what: `get volume ${name}`,
46
+ schema: volumeSchema
47
+ })
48
+ ),
49
+ listVolumes: () => http.json({
50
+ method: "GET",
51
+ url: `${args.apiUrl}/volumes`,
52
+ what: "list volumes",
53
+ schema: z.array(volumeSchema)
54
+ }),
55
+ deleteVolume: async (id) => {
56
+ const result = await http.empty({
57
+ method: "DELETE",
58
+ url: `${args.apiUrl}/volumes/${encodeURIComponent(id)}`,
59
+ what: `delete volume ${id}`
60
+ });
61
+ return !result.ok && result.error === DaytonaErrorCode.NotFound ? ok(void 0) : result;
62
+ }
63
+ };
64
+ };
65
+ export {
66
+ createVolumesGroup
67
+ };
68
+ //# sourceMappingURL=volumes.mjs.map
@@ -0,0 +1,7 @@
1
+ {
2
+ "version": 3,
3
+ "sources": ["../../../../../src/client/volumes.ts"],
4
+ "sourcesContent": ["import * as z from 'zod';\nimport type { DaytonaHttpIface } from \"./request.mjs\";\nimport {\n DaytonaErrorCode,\n DaytonaVolumeState,\n ok,\n type DaytonaClientIface,\n type DaytonaVolumeIface,\n} from \"./types.mjs\";\n\n// Daytona's volume endpoints (`/volumes`): storage sandboxes mount by id, kept until deleted.\n\nconst states = new Set<string>(Object.values(DaytonaVolumeState));\n\nconst volumeSchema = z\n .object({\n id: z.string(),\n name: z.string(),\n state: z.string(),\n errorReason: z.string().nullish(),\n })\n .transform(\n (raw): DaytonaVolumeIface => ({\n id: raw.id,\n name: raw.name,\n state: states.has(raw.state)\n ? z.nativeEnum(DaytonaVolumeState).parse(raw.state)\n : DaytonaVolumeState.Other,\n nativeState: raw.state,\n errorReason: raw.errorReason ?? null,\n }),\n );\n\nexport type DaytonaVolumesGroupIface = Pick<\n DaytonaClientIface,\n 'createVolume' | 'getVolume' | 'getVolumeByName' | 'listVolumes' | 'deleteVolume'\n>;\n\nexport const createVolumesGroup = (args: {\n http: DaytonaHttpIface;\n apiUrl: string;\n}): DaytonaVolumesGroupIface => {\n const { http } = args;\n const missingIsNull = <T>(result: Awaited<ReturnType<typeof http.json<T>>>) =>\n !result.ok && result.error === DaytonaErrorCode.NotFound ? ok(null) : result;\n return {\n createVolume: (name) =>\n http.json({\n method: 'POST',\n url: `${args.apiUrl}/volumes`,\n what: `create volume ${name}`,\n json: { name },\n schema: volumeSchema,\n }),\n getVolume: async (id) =>\n missingIsNull(\n await http.json({\n method: 'GET',\n url: `${args.apiUrl}/volumes/${encodeURIComponent(id)}`,\n what: `get volume ${id}`,\n schema: volumeSchema,\n }),\n ),\n getVolumeByName: async (name) =>\n missingIsNull(\n await http.json({\n method: 'GET',\n url: `${args.apiUrl}/volumes/by-name/${encodeURIComponent(name)}`,\n what: `get volume ${name}`,\n schema: volumeSchema,\n }),\n ),\n listVolumes: () =>\n http.json({\n method: 'GET',\n url: `${args.apiUrl}/volumes`,\n what: 'list volumes',\n schema: z.array(volumeSchema),\n }),\n deleteVolume: async (id) => {\n const result = await http.empty({\n method: 'DELETE',\n url: `${args.apiUrl}/volumes/${encodeURIComponent(id)}`,\n what: `delete volume ${id}`,\n });\n return !result.ok && result.error === DaytonaErrorCode.NotFound ? ok(undefined) : result;\n },\n };\n};\n"],
5
+ "mappings": "AAAA,YAAY,OAAO;AAEnB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAGK;AAIP,MAAM,SAAS,IAAI,IAAY,OAAO,OAAO,kBAAkB,CAAC;AAEhE,MAAM,eAAe,EAClB,OAAO;AAAA,EACN,IAAI,EAAE,OAAO;AAAA,EACb,MAAM,EAAE,OAAO;AAAA,EACf,OAAO,EAAE,OAAO;AAAA,EAChB,aAAa,EAAE,OAAO,EAAE,QAAQ;AAClC,CAAC,EACA;AAAA,EACC,CAAC,SAA6B;AAAA,IAC5B,IAAI,IAAI;AAAA,IACR,MAAM,IAAI;AAAA,IACV,OAAO,OAAO,IAAI,IAAI,KAAK,IACvB,EAAE,WAAW,kBAAkB,EAAE,MAAM,IAAI,KAAK,IAChD,mBAAmB;AAAA,IACvB,aAAa,IAAI;AAAA,IACjB,aAAa,IAAI,eAAe;AAAA,EAClC;AACF;AAOK,MAAM,qBAAqB,CAAC,SAGH;AAC9B,QAAM,EAAE,KAAK,IAAI;AACjB,QAAM,gBAAgB,CAAI,WACxB,CAAC,OAAO,MAAM,OAAO,UAAU,iBAAiB,WAAW,GAAG,IAAI,IAAI;AACxE,SAAO;AAAA,IACL,cAAc,CAAC,SACb,KAAK,KAAK;AAAA,MACR,QAAQ;AAAA,MACR,KAAK,GAAG,KAAK,MAAM;AAAA,MACnB,MAAM,iBAAiB,IAAI;AAAA,MAC3B,MAAM,EAAE,KAAK;AAAA,MACb,QAAQ;AAAA,IACV,CAAC;AAAA,IACH,WAAW,OAAO,OAChB;AAAA,MACE,MAAM,KAAK,KAAK;AAAA,QACd,QAAQ;AAAA,QACR,KAAK,GAAG,KAAK,MAAM,YAAY,mBAAmB,EAAE,CAAC;AAAA,QACrD,MAAM,cAAc,EAAE;AAAA,QACtB,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,IACF,iBAAiB,OAAO,SACtB;AAAA,MACE,MAAM,KAAK,KAAK;AAAA,QACd,QAAQ;AAAA,QACR,KAAK,GAAG,KAAK,MAAM,oBAAoB,mBAAmB,IAAI,CAAC;AAAA,QAC/D,MAAM,cAAc,IAAI;AAAA,QACxB,QAAQ;AAAA,MACV,CAAC;AAAA,IACH;AAAA,IACF,aAAa,MACX,KAAK,KAAK;AAAA,MACR,QAAQ;AAAA,MACR,KAAK,GAAG,KAAK,MAAM;AAAA,MACnB,MAAM;AAAA,MACN,QAAQ,EAAE,MAAM,YAAY;AAAA,IAC9B,CAAC;AAAA,IACH,cAAc,OAAO,OAAO;AAC1B,YAAM,SAAS,MAAM,KAAK,MAAM;AAAA,QAC9B,QAAQ;AAAA,QACR,KAAK,GAAG,KAAK,MAAM,YAAY,mBAAmB,EAAE,CAAC;AAAA,QACrD,MAAM,iBAAiB,EAAE;AAAA,MAC3B,CAAC;AACD,aAAO,CAAC,OAAO,MAAM,OAAO,UAAU,iBAAiB,WAAW,GAAG,MAAS,IAAI;AAAA,IACpF;AAAA,EACF;AACF;",
6
+ "names": []
7
+ }
@@ -13,6 +13,8 @@ export interface DaytonaOptionsIface {
13
13
  target?: string;
14
14
  operationTimeoutMs?: number;
15
15
  portUrlTtlS?: number;
16
+ defaultAutoStopMinutes?: number;
17
+ connectTtlS?: number;
16
18
  }
17
19
  export declare const daytonaOptionsSchema: z.ZodObject<{
18
20
  snapshot: z.ZodOptional<z.ZodString>;