@krovacloud/sdk 0.3.10 → 0.3.11

package/README.md

@@ -49,6 +49,14 @@ const cube = await krova.cubes.create("space_123", {
 console.log(`Created cube ${cube.id} (${cube.state})`);
 console.log(`  ${cube.resources.vcpu} vCPU / ${cube.resources.ramGb} GB RAM, image ${cube.image}`);
 
+// Everything needed to SSH in — including WHICH USER to log in as.
+// Read `user`; do not derive it from `image`. It is "ubuntu" or "debian" on
+// Cubes from images that ship a default user (both with passwordless sudo)
+// and "root" on Cubes created before that change, so the image id cannot
+// tell you. `cube.sshUser` on the Cube object carries the same value.
+const ssh = await krova.cubes.ssh("space_123", cube.id);
+console.log(`ssh ${ssh.user}@${ssh.host} -p ${ssh.port}`);
+
 // Power it off, then start it again
 await krova.cubes.powerOff("space_123", cube.id);
 await krova.cubes.wake("space_123", cube.id);

package/dist/index.d.cts

@@ -366,7 +366,7 @@ interface paths {
                             ramGb: number;
                             diskGb: number;
                         };
-                        /** @description SSH public key written to /root/.ssh/authorized_keys at boot. Must start with ssh-ed25519, ssh-rsa, ecdsa-sha2-*, ssh-dss, or sk-*@openssh.com. */
+                        /** @description SSH public key written to the Cube login user's authorized_keys at boot (~/.ssh/authorized_keys for the ubuntu or debian user; /root/.ssh/authorized_keys on Cubes created before the default-user change). GET /cubes/{cubeId}/ssh reports the login user for a given Cube. Must start with ssh-ed25519, ssh-rsa, ecdsa-sha2-*, ssh-dss, or sk-*@openssh.com. */
                         sshPublicKey: string;
                         /** @description Region slug from /v1/regions (optional). */
                         region?: string;
@@ -654,7 +654,7 @@ interface paths {
         };
         /**
          * Get a Cube's SSH connection info
-         * @description Host (server public IPv4), host SSH port, login user, and any captured SSH host public keys. `hostKeys` is empty until Krova captures cube host keys — clients fall back to trust-on-first-use until then.
+         * @description Host (server public IPv4), host SSH port, login user, and the Cube's captured SSH host public keys. **Use `user` rather than assuming a username** — it is `ubuntu` or `debian` on Cubes created from images that ship a default user, and `root` on Cubes created before that change or imported from a rootfs without one. `hostKeys` is empty only until the reachability cron makes its first capture; clients fall back to trust-on-first-use until then, and pin strictly afterwards.
          */
         get: {
             parameters: {
@@ -1323,10 +1323,12 @@ interface paths {
                         name: string;
                         fileSizeBytes: number;
                         /**
+                         * @description What to do with SSH access on the imported rootfs. `replace` (default) writes `sshPublicKey` to the login user's authorized_keys and requires `sshPublicKey` to be set. `keep` leaves the image's own authorized_keys and sshd configuration completely untouched — nothing is written — so you must already hold a private key that the image accepts, or you will not be able to log in.
                          * @default replace
                          * @enum {string}
                          */
                         sshKeyMode?: "replace" | "keep";
+                        /** @description Public key to install when `sshKeyMode` is `replace`. Written to the login user's `~/.ssh/authorized_keys` — which user that is comes from the imported rootfs itself, so an image without a Krova default user keeps logging in as root. Ignored when `sshKeyMode` is `keep`. */
                         sshPublicKey?: string | null;
                         region?: string | null;
                         vcpusOverride?: number | null;
@@ -1766,6 +1768,7 @@ interface components {
                 diskGb: number;
             };
             image: string;
+            sshUser: string;
             costPerHour: number;
             /** Format: date-time */
             createdAt: string;
@@ -1788,6 +1791,7 @@ interface components {
             name: string;
             version: string;
             description: string;
+            defaultUser: string;
         };
         PricingTier: {
             minVcpus: number;
@@ -2038,6 +2042,7 @@ declare class KrovaClient {
                     diskGb: number;
                 };
                 image: string;
+                sshUser: string;
                 costPerHour: number;
                 createdAt: string;
                 updatedAt: string;
@@ -2229,6 +2234,7 @@ declare class KrovaClient {
                 name: string;
                 version: string;
                 description: string;
+                defaultUser: string;
             }[];
         }>;
         /** Per-resource hourly rates and volume pricing tiers. */

package/dist/index.d.ts

@@ -366,7 +366,7 @@ interface paths {
                             ramGb: number;
                             diskGb: number;
                         };
-                        /** @description SSH public key written to /root/.ssh/authorized_keys at boot. Must start with ssh-ed25519, ssh-rsa, ecdsa-sha2-*, ssh-dss, or sk-*@openssh.com. */
+                        /** @description SSH public key written to the Cube login user's authorized_keys at boot (~/.ssh/authorized_keys for the ubuntu or debian user; /root/.ssh/authorized_keys on Cubes created before the default-user change). GET /cubes/{cubeId}/ssh reports the login user for a given Cube. Must start with ssh-ed25519, ssh-rsa, ecdsa-sha2-*, ssh-dss, or sk-*@openssh.com. */
                         sshPublicKey: string;
                         /** @description Region slug from /v1/regions (optional). */
                         region?: string;
@@ -654,7 +654,7 @@ interface paths {
         };
         /**
          * Get a Cube's SSH connection info
-         * @description Host (server public IPv4), host SSH port, login user, and any captured SSH host public keys. `hostKeys` is empty until Krova captures cube host keys — clients fall back to trust-on-first-use until then.
+         * @description Host (server public IPv4), host SSH port, login user, and the Cube's captured SSH host public keys. **Use `user` rather than assuming a username** — it is `ubuntu` or `debian` on Cubes created from images that ship a default user, and `root` on Cubes created before that change or imported from a rootfs without one. `hostKeys` is empty only until the reachability cron makes its first capture; clients fall back to trust-on-first-use until then, and pin strictly afterwards.
          */
         get: {
             parameters: {
@@ -1323,10 +1323,12 @@ interface paths {
                         name: string;
                         fileSizeBytes: number;
                         /**
+                         * @description What to do with SSH access on the imported rootfs. `replace` (default) writes `sshPublicKey` to the login user's authorized_keys and requires `sshPublicKey` to be set. `keep` leaves the image's own authorized_keys and sshd configuration completely untouched — nothing is written — so you must already hold a private key that the image accepts, or you will not be able to log in.
                          * @default replace
                          * @enum {string}
                          */
                         sshKeyMode?: "replace" | "keep";
+                        /** @description Public key to install when `sshKeyMode` is `replace`. Written to the login user's `~/.ssh/authorized_keys` — which user that is comes from the imported rootfs itself, so an image without a Krova default user keeps logging in as root. Ignored when `sshKeyMode` is `keep`. */
                         sshPublicKey?: string | null;
                         region?: string | null;
                         vcpusOverride?: number | null;
@@ -1766,6 +1768,7 @@ interface components {
                 diskGb: number;
             };
             image: string;
+            sshUser: string;
             costPerHour: number;
             /** Format: date-time */
             createdAt: string;
@@ -1788,6 +1791,7 @@ interface components {
             name: string;
             version: string;
             description: string;
+            defaultUser: string;
         };
         PricingTier: {
             minVcpus: number;
@@ -2038,6 +2042,7 @@ declare class KrovaClient {
                     diskGb: number;
                 };
                 image: string;
+                sshUser: string;
                 costPerHour: number;
                 createdAt: string;
                 updatedAt: string;
@@ -2229,6 +2234,7 @@ declare class KrovaClient {
                 name: string;
                 version: string;
                 description: string;
+                defaultUser: string;
             }[];
         }>;
         /** Per-resource hourly rates and volume pricing tiers. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krovacloud/sdk",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "Official TypeScript SDK for Krova Cloud — a typed client for provisioning and managing Cubes (Firecracker microVMs) with dedicated resources.",
   "license": "MIT",
   "type": "module",
@@ -61,7 +61,7 @@
     "openapi-fetch": "^0.17.0"
   },
   "devDependencies": {
-    "@types/node": "^26.1.1",
+    "@types/node": "^26.1.2",
     "openapi-typescript": "^7.13.0",
     "tsup": "^8.5.1",
     "tsx": "^4.23.1",