Add getTimeout methods to the SDKs

packages/js-sdk/src/sandbox/index.ts

@@ -317,6 +317,22 @@ export class Sandbox extends SandboxApi {
     await Sandbox.kill(this.sandboxId, { ...this.connectionConfig, ...opts })
   }
 
+  /**
+   * Get the timeout of the sandbox.
+   *
+   * @param opts connection options.
+   *
+   * @returns timeout of the sandbox.
+   */
+  async getTimeout(opts?: Pick<SandboxOpts, 'requestTimeoutMs'>) {
+    const { endAt } = await Sandbox.get(this.sandboxId, {
+      ...this.connectionConfig,
+      ...opts,
+    })
+
+    return endAt
+  }
+
   /**
    * Get the URL to upload a file to the sandbox.
    *

packages/js-sdk/src/sandbox/sandboxApi.ts

@@ -39,6 +39,11 @@ export interface SandboxInfo {
    * Sandbox start time.
    */
   startedAt: Date
+
+  /**
+   * Sandbox end time.
+   */
+  endAt: Date
 }
 
 export class SandboxApi {
@@ -80,6 +85,52 @@ export class SandboxApi {
     return true
   }
 
+  /**
+   * Get running sandbox.
+   *
+   * @param sandboxId sandbox ID.
+   * @param opts connection options.
+   *
+   * @returns running sandbox.
+   */
+  static async get(
+    sandboxId: string,
+    opts?: SandboxApiOpts
+  ): Promise<SandboxInfo> {
+    const config = new ConnectionConfig(opts)
+    const client = new ApiClient(config)
+
+    const res = await client.api.GET('/sandboxes/{sandboxID}', {
+      params: {
+        path: {
+          sandboxID: sandboxId,
+        },
+      },
+      signal: config.getSignal(opts?.requestTimeoutMs),
+    })
+
+    const err = handleApiError(res)
+    if (err) {
+      throw err
+    }
+
+    if (!res.data) {
+      throw new Error('Sandbox not found')
+    }
+
+    return {
+      sandboxId: this.getSandboxId({
+        sandboxId: res.data.sandboxID,
+        clientId: res.data.clientID,
+      }),
+      templateId: res.data.templateID,
+      ...(res.data.alias && { name: res.data.alias }),
+      metadata: res.data.metadata ?? {},
+      startedAt: new Date(res.data.startedAt),
+      endAt: new Date(res.data.endAt),
+    }
+  }
+
   /**
    * List all running sandboxes.
    *
@@ -110,6 +161,7 @@ export class SandboxApi {
         ...(sandbox.alias && { name: sandbox.alias }),
         metadata: sandbox.metadata ?? {},
         startedAt: new Date(sandbox.startedAt),
+        endAt: new Date(sandbox.endAt),
       })) ?? []
     )
   }

packages/js-sdk/tests/sandbox/timeout.test.ts

@@ -10,14 +10,22 @@ sandboxTest.skipIf(isDebug)('shorten timeout', async ({ sandbox }) => {
   expect(await sandbox.isRunning({ requestTimeoutMs: 1000 })).toBeFalsy()
 })
 
-sandboxTest.skipIf(isDebug)('shorten then lenghten timeout', async ({ sandbox }) => {
-  await sandbox.setTimeout(5000)
+sandboxTest.skipIf(isDebug)(
+  'shorten then lenghten timeout',
+  async ({ sandbox }) => {
+    await sandbox.setTimeout(5000)
 
-  await wait(1000)
+    await wait(1000)
 
-  await sandbox.setTimeout(10000)
+    await sandbox.setTimeout(10000)
 
-  await wait(6000)
+    await wait(6000)
+
+    await sandbox.isRunning()
+  }
+)
 
-  await sandbox.isRunning()
+sandboxTest.skipIf(isDebug)('get sandbox timeout', async ({ sandbox }) => {
+  const timeout = await sandbox.getTimeout()
+  expect(timeout).toBeInstanceOf(Date)
 })