feat: add support for shutdownAfterInactiveSeconds parameter

Author: Copilot

src/connection.test.ts

@@ -213,6 +213,37 @@ describe("Connection.connect, when passed connection options", () => {
       sessionType: "multi",
     });
   });
+
+  test("can be set with shutdownAfterInactiveSeconds", async () => {
+    simulateImmediatelyReadySession(fetchMock);
+    simulateImmediatelyOpenSocket(MockWebSocket);
+    Connection.connect(
+      {
+        apiKey: testApiKey,
+        runtime: Runtime.TINY,
+        shutdownAfterInactiveSeconds: 3600,
+      },
+      testHarness,
+    );
+    vi.runAllTimersAsync();
+    expectMatchingSessionCreateBody(fetchMock, {
+      shutdownAfterInactiveSeconds: 3600,
+    });
+  });
+
+  test("rejects if shutdownAfterInactiveSeconds is invalid", async () => {
+    const connection = Connection.connect(
+      {
+        apiKey: testApiKey,
+        runtime: Runtime.TINY,
+        shutdownAfterInactiveSeconds: -100,
+      },
+      testHarness,
+    );
+    vi.runAllTimersAsync();
+    await expect(connection).rejects.toBeInstanceOf(Error);
+    expect(fetchMock).not.toHaveBeenCalled();
+  });
 });
 
 describe("Connection.connect, when establishing SQL session", () => {

src/connection.ts

@@ -137,6 +137,8 @@ export class Connection {
               runtimeId: this.options.runtime,
               version: this.options.version,
               sessionType: this.options.sessionType,
+              shutdownAfterInactiveSeconds:
+                this.options.shutdownAfterInactiveSeconds,
             }),
             ...this.fetchOptions,
             signal: combineAbortSignals(signal, this.fetchOptions.signal),

src/schemas.ts

@@ -26,6 +26,7 @@ const ConnectionOptionsSchema = z.object({
   dataCompression: z.literal(DataCompression.BROTLI).optional(),
   geometryRepresentation: z.nativeEnum(GeometryRepresentation).optional(),
   sessionType: z.nativeEnum(SessionType).optional(),
+  shutdownAfterInactiveSeconds: z.number().int().positive().optional(),
 });
 
 export type ConnectionOptions = z.infer<typeof ConnectionOptionsSchema>;