feat: add Client::updateAutosaveTimestamp()

.github/workflows/build.yml

@@ -4,7 +4,6 @@ concurrency: ci-pipeline
 env:
   KBC_STORAGE_TOKEN: '${{ secrets.KBC_STORAGE_TOKEN }}'
   KBC_MANAGE_TOKEN: '${{ secrets.KBC_MANAGE_TOKEN }}'
-  KBC_MANAGE_NOTIFY_TOKEN: '${{ secrets.KBC_MANAGE_NOTIFY_TOKEN }}'
 
   # Azure
   AZURE_CLIENT_ID: 233328da-9afe-423b-82c1-915d8c539f71

docker-compose.yml

@@ -14,7 +14,6 @@ services:
       KBC_URL: https://connection.keboola.com
       KBC_STORAGE_TOKEN:
       KBC_MANAGE_TOKEN:
-      KBC_MANAGE_NOTIFY_TOKEN:
       DYNAMO_ENDPOINT: http://localstack:4566
       DYNAMO_TABLE_SANDBOXES: sandboxes
       DYNAMO_TABLE_ML_DEPLOYMENTS: ml-deployments

src/Client.php

@@ -35,6 +35,13 @@ public function update(Sandbox $sandbox): Sandbox
         return Sandbox::fromArray($this->sendRequest($request));
     }
 
+    public function updateAutosaveTimestamp(string $id, string $timestamp): Sandbox
+    {
+        $jobData = json_encode(['lastAutosaveTimestamp' => $timestamp]);
+        $request = new Request('PATCH', "sandboxes/{$id}", [], $jobData);
+        return Sandbox::fromArray($this->sendRequest($request));
+    }
+
     public function deactivate(string $id, bool $skipBillingReport = false): Sandbox
     {
         $query = [];

tests/ClientFunctionalTest.php

@@ -348,6 +348,30 @@ public function testProjectPersistentStorage(): void
         self::assertNull($persistentStorage->getK8sStorageClassName());
     }
 
+    public function testUpdateAutosaveTimestamp(): void
+    {
+        // 1. Create sandbox
+        $sandbox = (new Sandbox())
+            ->setType('python')
+            ->setActive(true);
+
+        $createdSandbox = $this->client->create($sandbox);
+        $sandboxId = $createdSandbox->getId();
+        $this->assertNotEmpty($sandboxId);
+
+        // 2. Update autosave timestamp
+        $timestamp = date('c');
+        $updatedSandbox = $this->client->updateAutosaveTimestamp($sandboxId, $timestamp);
+        $this->assertSame($timestamp, $updatedSandbox->getLastAutosaveTimestamp());
+
+        // 3. Verify persistence by getting the sandbox again
+        $retrievedSandbox = $this->client->get($sandboxId);
+        $this->assertSame($timestamp, $retrievedSandbox->getLastAutosaveTimestamp());
+
+        // 4. Clean up
+        $this->client->delete($sandboxId);
+    }
+
     protected function tearDown(): void
     {
         $this->componentsClient->deleteConfiguration('transformation', $this->configurationId);

tests/ClientUnitTest.php

@@ -184,4 +184,55 @@ public function testDelete(string $sandboxId, bool $skipBillingReport, string $e
         ));
         self::assertSame('', (string) $request->getBody());
     }
+
+    public function testUpdateAutosaveTimestamp(): void
+    {
+        $requestsLog = [];
+        $sandboxId = '123';
+        $timestamp = '2025-01-18T10:30:00+00:00';
+        $responseData = [
+            'id' => $sandboxId,
+            'projectId' => 'project-id',
+            'tokenId' => 'token-id',
+            'type' => 'python',
+            'active' => true,
+            'createdTimestamp' => '2021-01-01T00:00:00+00:00',
+            'lastAutosaveTimestamp' => $timestamp,
+        ];
+
+        $mockedResponses = [
+            new Response(200, [], (string) json_encode($responseData)),
+        ];
+
+        $handlerStack = HandlerStack::create(new MockHandler($mockedResponses));
+        $handlerStack->push(Middleware::history($requestsLog));
+
+        $client = new Client((string) getenv('API_URL'), (string) getenv('KBC_STORAGE_TOKEN'), [
+            'handler' => $handlerStack,
+        ]);
+
+        $result = $client->updateAutosaveTimestamp($sandboxId, $timestamp);
+
+        self::assertEquals(Sandbox::fromArray($responseData), $result);
+        self::assertEquals($timestamp, $result->getLastAutosaveTimestamp());
+
+        self::assertCount(1, $requestsLog);
+
+        $request = $requestsLog[0]['request'];
+        self::assertInstanceOf(Request::class, $request);
+
+        self::assertSame('PATCH', $request->getMethod());
+        self::assertSame('/sandboxes/123', Uri::composeComponents(
+            '',
+            '',
+            $request->getUri()->getPath(),
+            $request->getUri()->getQuery(),
+            '',
+        ));
+
+        $requestBody = json_decode((string) $request->getBody(), true);
+        self::assertIsArray($requestBody);
+        self::assertArrayHasKey('lastAutosaveTimestamp', $requestBody);
+        self::assertSame($timestamp, $requestBody['lastAutosaveTimestamp']);
+    }
 }

tests/bootstrap.php

@@ -26,7 +26,7 @@
 if (file_exists(__DIR__ . '/../.env')) {
     $dotenv->load();
 }
-$dotenv->required(['API_URL', 'KBC_MANAGE_TOKEN', 'KBC_MANAGE_NOTIFY_TOKEN', 'KBC_STORAGE_TOKEN', 'KBC_URL']);
+$dotenv->required(['API_URL', 'KBC_MANAGE_TOKEN', 'KBC_STORAGE_TOKEN', 'KBC_URL']);
 
 $tokenEnvs = [
     'KBC_STORAGE_TOKEN',
@@ -69,7 +69,6 @@
 
 $tokenEnvs = [
     'KBC_MANAGE_TOKEN',
-    'KBC_MANAGE_NOTIFY_TOKEN',
 ];
 
 foreach ($tokenEnvs as $tokenEnv) {