@krovacloud/sdk 0.4.1 → 0.4.2

package/CHANGELOG.md

@@ -5,6 +5,23 @@ All notable changes to `@krovacloud/sdk` are documented here. This project adher
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) format.
 
 
+## 0.4.2
+
+### Changed
+
+- Docs-only republish: the `domains.create()` example now destructures the
+  `{ domain, records }` result (the 0.4.0 shape), and `domains.records()` plus
+  the `DnsRecord`/`DnsRecordStatus` types are documented in the README. No code
+  change.
+
+## 0.4.1
+
+### Changed
+
+- Automated patch republish (2026-08-27, PR #46): the package is now built with
+  **tsdown** (replacing the unmaintained tsup) and formatted with **oxfmt**
+  (replacing Prettier). No API change.
+
 ## 0.4.0
 
 ### Changed

package/README.md

@@ -181,12 +181,15 @@ const pricing = await krova.catalog.pricing(); // per-resource hourly rates + vo
 Typed helpers for a Cube's attached resources — each unwraps the response and throws `KrovaError` on failure.
 
 ```ts
-// Custom domains
+// Custom domains — create() resolves to { domain, records } (BREAKING in 0.4.0).
+// The records are the DNS entries you must publish for the domain to work, so
+// you can create them in the same run: a wildcard needs three, an exact host one.
 const domains = await krova.domains.list("space_123", "cube_123");
-const domain = await krova.domains.create("space_123", "cube_123", {
+const { domain, records } = await krova.domains.create("space_123", "cube_123", {
   domain: "app.example.com",
   port: 8080,
 });
+for (const r of records) console.log(`${r.type} ${r.host} → ${r.value}`);
 await krova.domains.update("space_123", "cube_123", domain.id, { responseCompression: true });
 await krova.domains.delete("space_123", "cube_123", domain.id);
 
@@ -207,6 +210,31 @@ await krova.tcpMappings.delete("space_123", "cube_123", mapping.id);
 
 `Domain`, `Snapshot`, and `TcpMapping` are exported for your own signatures.
 
+### `domains.records` — the DNS records a domain needs
+
+The same records `domains.create()` returns, but each one **checked against live
+DNS**. Poll it after publishing them — `summary.complete` turns true only once
+every record is `found`. Each call performs real DNS lookups and is rate
+limited, so poll on an interval rather than in a tight loop.
+
+```ts
+const status = await krova.domains.records("space_123", "cube_123", domain.id);
+// { domain, isWildcard, records: DnsRecordStatus[], summary: { found, total, complete }, checkedAt }
+for (const r of status.records) console.log(`${r.host}: ${r.state}`); // found | missing | mismatch | unknown
+if (status.summary.complete) console.log("all records resolve — the domain can go live");
+```
+
+Two record states are worth knowing before you alert on them: `missing` means
+NOT PUBLISHED YET — the expected state before the records are created, never an
+error — and `unknown` means the lookup itself could not complete, which says
+nothing about your DNS. Each record also carries `mustBeGrey` and `proxyOk`:
+the routing record may sit behind Cloudflare's proxy, the `_acme-challenge`
+record must not — automation needs both flags, one alone would let you
+orange-cloud the single record that has to stay grey.
+
+`DnsRecord` (what `create` returns) and `DnsRecordStatus` (the checked variant,
+adding `state`, `detail`, `observed`) are exported for your own signatures.
+
 ### Imports & backups
 
 Move `.cube` archives in and out. `imports.create` returns a multipart upload target; upload the archive to the presigned parts, then call `imports.complete`.

package/dist/index.d.cts

@@ -2320,27 +2320,27 @@ declare class KrovaClient {
      * archive to those URLs, then call {@link imports.complete}.
      */
     create: (spaceId: string, body: NonNullable<paths["/spaces/{spaceId}/cubes/imports"]["post"]["requestBody"]>["content"]["application/json"]) => Promise<{
-      importId?: string | undefined;
-      uploadId?: string | undefined;
-      key?: string | undefined;
-      chunkSizeBytes?: number | undefined;
+      importId?: string;
+      uploadId?: string;
+      key?: string;
+      chunkSizeBytes?: number;
       parts?: {
-        partNumber?: number | undefined;
-        url?: string | undefined;
+        partNumber?: number;
+        url?: string;
       }[] | undefined;
-      expiresAt?: string | undefined;
+      expiresAt?: string;
     } | undefined>;
     /** Get an in-progress or completed import by id. */
     get: (spaceId: string, importId: string) => Promise<{
       import?: {
-        id?: string | undefined;
-        name?: string | undefined;
-        status?: "uploading" | "finalizing" | "provisioning" | "complete" | "failed" | "expired" | undefined;
-        cubeId?: string | null | undefined;
-        error?: string | null | undefined;
-        createdAt?: string | undefined;
-        updatedAt?: string | undefined;
-        completedAt?: string | null | undefined;
+        id?: string;
+        name?: string;
+        status?: "uploading" | "finalizing" | "provisioning" | "complete" | "failed" | "expired";
+        cubeId?: string | null;
+        error?: string | null;
+        createdAt?: string;
+        updatedAt?: string;
+        completedAt?: string | null;
       } | undefined;
     }>;
     /**
@@ -2349,9 +2349,9 @@ declare class KrovaClient {
      * `config`.
      */
     complete: (spaceId: string, importId: string, body: NonNullable<paths["/spaces/{spaceId}/cubes/imports/{importId}/complete"]["post"]["requestBody"]>["content"]["application/json"]) => Promise<{
-      importId?: string | undefined;
-      cubeId?: string | undefined;
-      status?: "provisioning" | undefined;
+      importId?: string;
+      cubeId?: string;
+      status?: "provisioning";
     } | undefined>;
     /** Cancel an in-progress import. */
     cancel: (spaceId: string, importId: string) => Promise<{
@@ -2361,10 +2361,10 @@ declare class KrovaClient {
   readonly backups: {
     /** Get a time-limited download URL for a backup `.cube` archive. */
     download: (spaceId: string, backupId: string) => Promise<{
-      url?: string | undefined;
-      filename?: string | undefined;
-      sizeBytes?: number | null | undefined;
-      expiresAt?: string | undefined;
+      url?: string;
+      filename?: string;
+      sizeBytes?: number | null;
+      expiresAt?: string;
     } | undefined>;
   };
   readonly catalog: {

package/dist/index.d.ts

@@ -2320,27 +2320,27 @@ declare class KrovaClient {
      * archive to those URLs, then call {@link imports.complete}.
      */
     create: (spaceId: string, body: NonNullable<paths["/spaces/{spaceId}/cubes/imports"]["post"]["requestBody"]>["content"]["application/json"]) => Promise<{
-      importId?: string | undefined;
-      uploadId?: string | undefined;
-      key?: string | undefined;
-      chunkSizeBytes?: number | undefined;
+      importId?: string;
+      uploadId?: string;
+      key?: string;
+      chunkSizeBytes?: number;
       parts?: {
-        partNumber?: number | undefined;
-        url?: string | undefined;
+        partNumber?: number;
+        url?: string;
       }[] | undefined;
-      expiresAt?: string | undefined;
+      expiresAt?: string;
     } | undefined>;
     /** Get an in-progress or completed import by id. */
     get: (spaceId: string, importId: string) => Promise<{
       import?: {
-        id?: string | undefined;
-        name?: string | undefined;
-        status?: "uploading" | "finalizing" | "provisioning" | "complete" | "failed" | "expired" | undefined;
-        cubeId?: string | null | undefined;
-        error?: string | null | undefined;
-        createdAt?: string | undefined;
-        updatedAt?: string | undefined;
-        completedAt?: string | null | undefined;
+        id?: string;
+        name?: string;
+        status?: "uploading" | "finalizing" | "provisioning" | "complete" | "failed" | "expired";
+        cubeId?: string | null;
+        error?: string | null;
+        createdAt?: string;
+        updatedAt?: string;
+        completedAt?: string | null;
       } | undefined;
     }>;
     /**
@@ -2349,9 +2349,9 @@ declare class KrovaClient {
      * `config`.
      */
     complete: (spaceId: string, importId: string, body: NonNullable<paths["/spaces/{spaceId}/cubes/imports/{importId}/complete"]["post"]["requestBody"]>["content"]["application/json"]) => Promise<{
-      importId?: string | undefined;
-      cubeId?: string | undefined;
-      status?: "provisioning" | undefined;
+      importId?: string;
+      cubeId?: string;
+      status?: "provisioning";
     } | undefined>;
     /** Cancel an in-progress import. */
     cancel: (spaceId: string, importId: string) => Promise<{
@@ -2361,10 +2361,10 @@ declare class KrovaClient {
   readonly backups: {
     /** Get a time-limited download URL for a backup `.cube` archive. */
     download: (spaceId: string, backupId: string) => Promise<{
-      url?: string | undefined;
-      filename?: string | undefined;
-      sizeBytes?: number | null | undefined;
-      expiresAt?: string | undefined;
+      url?: string;
+      filename?: string;
+      sizeBytes?: number | null;
+      expiresAt?: string;
     } | undefined>;
   };
   readonly catalog: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@krovacloud/sdk",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Official TypeScript SDK for Krova Cloud — a typed client for provisioning and managing Cubes (Firecracker microVMs) with dedicated resources.",
   "license": "MIT",
   "type": "module",
@@ -65,7 +65,7 @@
     "openapi-typescript": "^7.13.0",
     "tsdown": "0.22.14",
     "tsx": "^4.23.12",
-    "typescript": "^6.0.3"
+    "typescript": "^7.0.2"
   },
   "scripts": {
     "gen": "openapi-typescript openapi.json -o src/generated/types.ts",