feat(kotlin): expose snapshot imageUri in the Kotlin SDK

Add imageUri to the domain SnapshotInfo and map it in SandboxModelConverter; the lifecycle client regenerates from the spec at build time. SnapshotInfo keeps a binary-compatibility constructor (with a default on name) so the pre-imageUri JVM constructor and its $default synthetic are preserved for already-compiled callers.

Author: Ferran Pons Serra

sdks/sandbox/kotlin/sandbox/src/main/kotlin/com/alibaba/opensandbox/sandbox/domain/models/sandboxes/SandboxModels.kt

@@ -794,7 +794,29 @@ class SnapshotInfo(
     val name: String? = null,
     val status: SnapshotStatus,
     val createdAt: OffsetDateTime,
-)
+    /**
+     * Portable OCI image reference for a Ready snapshot, usable to restore a sandbox (e.g. across
+     * clusters). Populated once the snapshot reaches [SnapshotState.READY]; null otherwise.
+     */
+    val imageUri: String? = null,
+) {
+    /**
+     * Binary-compatibility constructor preserving the pre-`imageUri` JVM signatures for
+     * already-compiled callers; delegates [imageUri] to null.
+     *
+     * The default on [name] is deliberate: it makes the compiler emit the old
+     * `(String, String, String?, SnapshotStatus, OffsetDateTime, int, DefaultConstructorMarker)`
+     * synthetic `$default` constructor, so Kotlin call sites compiled against the previous
+     * `SnapshotInfo` that omitted `name` keep resolving instead of hitting `NoSuchMethodError`.
+     */
+    constructor(
+        id: String,
+        sandboxId: String,
+        name: String? = null,
+        status: SnapshotStatus,
+        createdAt: OffsetDateTime,
+    ) : this(id, sandboxId, name, status, createdAt, null)
+}
 
 class SnapshotFilter private constructor(
     val sandboxId: String?,

sdks/sandbox/kotlin/sandbox/src/main/kotlin/com/alibaba/opensandbox/sandbox/infrastructure/adapters/converter/SandboxModelConverter.kt

@@ -410,6 +410,7 @@ internal object SandboxModelConverter {
                     lastTransitionAt = this.status.lastTransitionAt,
                 ),
             createdAt = this.createdAt,
+            imageUri = this.imageUri,
         )
     }
 

sdks/sandbox/kotlin/sandbox/src/test/kotlin/com/alibaba/opensandbox/sandbox/infrastructure/adapters/service/SandboxesAdapterTest.kt

@@ -369,7 +369,8 @@ class SandboxesAdapterTest {
                     "message": null,
                     "lastTransitionAt": "2023-01-01T10:00:00Z"
                 },
-                "createdAt": "2023-01-01T10:00:00Z"
+                "createdAt": "2023-01-01T10:00:00Z",
+                "imageUri": "registry.example.com/snapshots/snap-123:latest"
             }
             """.trimIndent()
         mockWebServer.enqueue(MockResponse().setBody(responseBody).setResponseCode(200))
@@ -378,6 +379,7 @@ class SandboxesAdapterTest {
 
         assertEquals(snapshotId, result.id)
         assertEquals("sandbox-123", result.sandboxId)
+        assertEquals("registry.example.com/snapshots/snap-123:latest", result.imageUri)
 
         val request = mockWebServer.takeRequest()
         assertEquals("GET", request.method)