@krovacloud/sdk 0.4.6 → 0.4.7

package/README.md

@@ -211,6 +211,11 @@ const mapping = await krova.tcpMappings.create("space_123", "cube_123", {
   cubePort: 5432,
   whitelistedIps: ["203.0.113.4/32"],
 });
+// `mapping.host` is where to connect — the Cube's OWN stable hostname, which
+// survives migration to another server. Use it rather than the Cube's
+// `serverDomain`, which is the current physical host and changes when the
+// Cube moves. Null only when the Cube has no server assigned.
+console.log(`psql -h ${mapping.host} -p ${mapping.hostPort}`);
 await krova.tcpMappings.list("space_123", "cube_123");
 await krova.tcpMappings.delete("space_123", "cube_123", mapping.id);
 ```

package/dist/index.d.cts

@@ -1947,6 +1947,8 @@ interface components {
       id: string;
       cubeId: string;
       cubePort: number;
+      /** @description Where to connect for this mapping: `host:hostPort`. The Cube's own stable hostname, which survives migration to another server, falling back to the server's public IP when the Cube has no DNS record yet. Identical to `host` from GET .../ssh, and the same value for every mapping on a Cube. Null only when the Cube has no server assigned, in which case there is nowhere to connect. Do NOT use `serverDomain` from the Cube object — that is the current physical host and changes when the Cube moves. */
+      host: string | null;
       hostPort: number;
       label: string | null;
       status: string;

package/dist/index.d.ts

@@ -1947,6 +1947,8 @@ interface components {
       id: string;
       cubeId: string;
       cubePort: number;
+      /** @description Where to connect for this mapping: `host:hostPort`. The Cube's own stable hostname, which survives migration to another server, falling back to the server's public IP when the Cube has no DNS record yet. Identical to `host` from GET .../ssh, and the same value for every mapping on a Cube. Null only when the Cube has no server assigned, in which case there is nowhere to connect. Do NOT use `serverDomain` from the Cube object — that is the current physical host and changes when the Cube moves. */
+      host: string | null;
       hostPort: number;
       label: string | null;
       status: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krovacloud/sdk",
-  "version": "0.4.6",
+  "version": "0.4.7",
   "description": "Official TypeScript SDK for Krova Cloud — a typed client for provisioning and managing Cubes (Firecracker microVMs) with dedicated resources.",
   "license": "MIT",
   "type": "module",