@truenas/api-client 2.0.0 → 3.0.0

package/dist/index.js

@@ -2519,7 +2519,6 @@ __export(v26_0_0_exports, {
   Aclmode: () => Aclmode,
   Acltype: () => Acltype,
   Advpowermgmt: () => Advpowermgmt,
-  Algorithm: () => Algorithm,
   AppContainerDetailsState: () => AppContainerDetailsState,
   AppContainerDetailsStateInput: () => AppContainerDetailsStateInput,
   Atime: () => Atime,
@@ -2657,11 +2656,13 @@ var ContainerNICDeviceTypeInput = {
 };
 var ContainerStatusState = {
   Running: "RUNNING",
-  Stopped: "STOPPED"
+  Stopped: "STOPPED",
+  Suspended: "SUSPENDED"
 };
 var ContainerStatusStateInput = {
   Running: "RUNNING",
-  Stopped: "STOPPED"
+  Stopped: "STOPPED",
+  Suspended: "SUSPENDED"
 };
 var Feature2 = {
   Apps: "APPS",
@@ -2741,7 +2742,6 @@ __export(v27_0_0_exports, {
   Aclmode: () => Aclmode,
   Acltype: () => Acltype,
   Advpowermgmt: () => Advpowermgmt,
-  Algorithm: () => Algorithm,
   AppContainerDetailsState: () => AppContainerDetailsState,
   AppContainerDetailsStateInput: () => AppContainerDetailsStateInput,
   Atime: () => Atime,
@@ -3064,6 +3064,10 @@ var AppState = /* @__PURE__ */ ((AppState2) => {
   AppState2["Stopped"] = "STOPPED";
   AppState2["Stopping"] = "STOPPING";
   AppState2["Deploying"] = "DEPLOYING";
+  AppState2["Suspended"] = "SUSPENDED";
+  AppState2["Suspending"] = "SUSPENDING";
+  AppState2["Error"] = "ERROR";
+  AppState2["Unknown"] = "UNKNOWN";
   return AppState2;
 })(AppState || {});
 
@@ -3074,7 +3078,10 @@ function toAppState(state) {
       return "RUNNING" /* Running */;
     case "STOPPED":
       return "STOPPED" /* Stopped */;
+    // `ABORTING` is v25.10 only: the instance is being forced down, which ends
+    // at `STOPPED` and is what `Stopping` already means.
     case "STOPPING":
+    case "ABORTING":
       return "STOPPING" /* Stopping */;
     // `STARTING` is v25.10 `virt.instance` only, and folding it into `Stopped`
     // told callers a container that is coming up is at rest — enough for a UI
@@ -3083,8 +3090,35 @@ function toAppState(state) {
     case "STARTING":
     case "DEPLOYING":
       return "DEPLOYING" /* Deploying */;
+    // v25.10's freezer states are the same idea as v26's `SUSPENDED`: the
+    // processes are paused, not exited. `FROZEN` is that pause completed, so it
+    // and `SUSPENDED` are the same answer.
+    case "SUSPENDED":
+    case "FROZEN":
+      return "SUSPENDED" /* Suspended */;
+    // `FREEZING` is on the way there and not there yet. It used to answer
+    // `Suspended`, defended by analogy with `STARTING` — but `STARTING` maps to
+    // `Deploying`, which is itself an in-progress word, so the analogy ran the
+    // wrong way. Answering `Suspended` tells a caller polling for "the memory
+    // is quiesced" that it is, one poll before it is true: the same false
+    // claim this mapping was rewritten to stop making, one state along.
+    // `ABORTING` had `Stopping` to land on; the freeze path needed its own.
+    case "FREEZING":
+      return "SUSPENDING" /* Suspending */;
+    // `THAWED` is the freezer lifted: the processes are scheduled again, so
+    // this is `RUNNING` reported through the transition rather than a state a
+    // caller should act on differently.
+    case "THAWED":
+      return "RUNNING" /* Running */;
+    case "ERROR":
+      return "ERROR" /* Error */;
+    // `UNKNOWN` is middleware's own word for it, and anything unrecognised is
+    // the same situation: a state this mapping has no word for. Neither is
+    // evidence the container is stopped.
+    case "UNKNOWN":
+      return "UNKNOWN" /* Unknown */;
     default:
-      return "STOPPED" /* Stopped */;
+      return "UNKNOWN" /* Unknown */;
   }
 }
 
@@ -3304,7 +3338,7 @@ var VersionDiscovery = class {
       map$1((versionStrings) => this.selectVersion(hostname, versionStrings)),
       catchError((error) => {
         this.versionCache.delete(hostname);
-        this.logger.error("Version discovery failed", { hostname, error });
+        this.logger.warn("Version discovery failed", { hostname, error });
         return throwError(() => this.classify(error, hostname));
       }),
       shareReplay(1)
@@ -3375,7 +3409,7 @@ var VersionDiscovery = class {
     });
     const parsedVersions = versionStrings.map(parseApiVersion).filter((v) => v !== null);
     if (parsedVersions.length === 0) {
-      this.logger.error("No valid versions in response", {
+      this.logger.warn("No valid versions in response", {
         hostname,
         versionStrings
       });
@@ -3477,29 +3511,34 @@ async function createTrueNasClient(opts) {
       `Cannot create client for system ${uuid}: hostnames array is empty`
     );
   }
-  const primaryHostname = hostnames[0];
   const versionDiscovery = new VersionDiscovery(logger);
   logger.info("Creating versioned API client", {
     uuid: uuid.slice(0, 8),
-    hostname: primaryHostname,
+    hostnames: hostnames.join(", "),
     systemName
   });
   let version;
   try {
-    version = await firstValueFrom(
-      versionDiscovery.discoverVersion(primaryHostname)
+    const winner = await discoverVersionFromAnyHostname(
+      hostnames,
+      versionDiscovery
     );
+    version = winner.version;
     logger.info("API version discovered, instantiating client", {
       uuid: uuid.slice(0, 8),
+      // Which hostname answered is log context only. The client is built with
+      // the full hostname list regardless — the websocket connection races all
+      // of them anyway.
+      hostname: winner.hostname,
       version: version.version,
       websocketPath: version.websocketPath
     });
   } catch (error) {
     const errorMessage = errorMessageOrDefault(error, "Unknown error");
     if (!(error instanceof VersionDiscoveryNetworkError)) {
-      logger.error("Version discovery failed", {
+      logger.error("Version discovery failed on every hostname", {
         uuid: uuid.slice(0, 8),
-        hostname: primaryHostname,
+        hostnames: hostnames.join(", "),
         error: errorMessage,
         errorType: error instanceof Error ? error.constructor.name : typeof error
       });
@@ -3510,7 +3549,7 @@ async function createTrueNasClient(opts) {
     if (!fallbackVersion) {
       logger.error("Invalid fallback version configuration", {
         uuid: uuid.slice(0, 8),
-        hostname: primaryHostname,
+        hostnames: hostnames.join(", "),
         fallbackVersion: fallbackVersionString
       });
       throw error;
@@ -3519,7 +3558,7 @@ async function createTrueNasClient(opts) {
       "Version discovery failed with a network error (possible CORS or network issue), falling back to assumed version",
       {
         uuid: uuid.slice(0, 8),
-        hostname: primaryHostname,
+        hostnames: hostnames.join(", "),
         fallbackVersion: fallbackVersionString,
         originalError: errorMessage,
         warning: "A network error has multiple causes (CORS, network down, DNS failure). The connection may still fail during the WebSocket handshake."
@@ -3529,6 +3568,27 @@ async function createTrueNasClient(opts) {
   }
   return instantiateClientForVersion(version, opts, logger);
 }
+async function discoverVersionFromAnyHostname(hostnames, versionDiscovery) {
+  const attempts = hostnames.map(
+    (hostname) => firstValueFrom(versionDiscovery.discoverVersion(hostname)).then(
+      (version) => ({ hostname, version })
+    )
+  );
+  try {
+    return await Promise.any(attempts);
+  } catch (error) {
+    const failures = error instanceof AggregateError ? error.errors : [error];
+    throw selectRepresentativeFailure(failures);
+  }
+}
+function selectRepresentativeFailure(failures) {
+  const isVersionError = (error) => (
+    // cases: valid response, but the given versions won't work for us
+    error instanceof VersionTooOldError || error instanceof VersionTooNewError || error instanceof NoCompatibleVersionsError || error instanceof VersionEndpointNotFoundError
+  );
+  const isNetworkError = (error) => error instanceof VersionDiscoveryNetworkError;
+  return failures.find(isVersionError) ?? failures.find(isNetworkError) ?? failures[0];
+}
 var CLIENT_BY_VERSION_KEY = {
   "25.10": TrueNasApiClientV2510,
   "26": TrueNasApiClientV26