@truenas/api-client 3.0.3 → 3.0.4

package/dist/index.d.cts

@@ -12460,6 +12460,16 @@ declare class TrueNasSocket {
     complete(): void;
 }
 
+/**
+ * The scheme used to reach the appliance, in `location.protocol` form.
+ *
+ * Colon included, so a caller served *by the appliance* can pass
+ * `location.protocol` unchanged. That equivalence only holds same-origin: this
+ * value is spliced onto the hostname the client connects to, so a page served
+ * from somewhere else must say what the appliance uses, not what it uses.
+ */
+type ApplianceProtocol = 'http:' | 'https:';
+
 interface ActiveConnection {
     ws: TrueNasSocket;
     hostname: string;
@@ -12482,6 +12492,7 @@ declare class TrueNasConnection {
     readonly retryDelay: number;
     readonly maxRetry: number;
     readonly logger: Logger;
+    readonly protocol: ApplianceProtocol;
     opened: BehaviorSubject<boolean>;
     closed: Subject<void>;
     hostname: BehaviorSubject<string>;
@@ -12544,7 +12555,7 @@ declare class TrueNasConnection {
      * observable which always emits messages from the current socket.
      */
     messages$: Observable<TrueNasMessage>;
-    constructor(initialEnabled: boolean, hostnames: string[], systemUuid: string, websocketPath: string, systemName?: string | undefined, retryDelay?: number, maxRetry?: number, logger?: Logger);
+    constructor(initialEnabled: boolean, hostnames: string[], systemUuid: string, websocketPath: string, systemName?: string | undefined, retryDelay?: number, maxRetry?: number, logger?: Logger, protocol?: ApplianceProtocol);
     /**
      * whether the connection has exhausted its retries — the **cumulative** snapshot, read
      * synchronously. (Formerly `hasConnectionError()`; renamed to disambiguate it from the
@@ -13192,7 +13203,8 @@ declare abstract class TrueNasApiClient<D extends ApiDirectoryShape = BaseApiDir
     protected readonly systemName: string | undefined;
     /** Logger forwarded to the connection (defaults to a no-op). */
     protected readonly logger: Logger;
-    constructor(uuid: string, hostnames: string[], version: ApiVersion, enabled: boolean, systemName?: string, logger?: Logger);
+    protected readonly protocol: ApplianceProtocol;
+    constructor(uuid: string, hostnames: string[], version: ApiVersion, enabled: boolean, systemName?: string, logger?: Logger, protocol?: ApplianceProtocol);
     /**
      * Get current connection status.
      * @returns true if WebSocket is connected
@@ -27604,6 +27616,28 @@ interface CreateClientOptions {
      * without the caller asserting it through a type parameter.
      */
     version?: SupportedApiVersion;
+    /**
+     * The scheme to reach the appliance on, in `location.protocol` form.
+     *
+     * Selects both halves of the transport: `https:` gives `https` discovery and
+     * a `wss` socket, `http:` gives `http` and `ws`. Defaults to `https:`, which
+     * is what an appliance serves and what Connect uses.
+     *
+     * This describes the *appliance*, not the page. Passing
+     * `location.protocol` is correct when the appliance serves the page — the
+     * same-origin case this exists for — and wrong otherwise. A page on
+     * `http://localhost:5173` talking to an https appliance gets both halves
+     * wrong, but only one of them says so: `fetch` follows the redirect and
+     * discovery appears to work, while the WebSocket has no such tolerance and
+     * fails the handshake without naming the scheme.
+     *
+     * Omitting it against a plaintext appliance is the quieter failure and the
+     * likelier one, since it is the case this option exists for. Discovery tries
+     * `https`, `fetch` rejects, and that is indistinguishable from the CORS block
+     * v25.10.0 has on `/api/versions` — so the fallback fires and the caller gets
+     * a client pinned to v25.10.0, warned about only in the log.
+     */
+    protocol?: ApplianceProtocol;
 }
 /**
  * Creates a version-specific TrueNAS API client.
@@ -27883,12 +27917,14 @@ declare class TrueNasApiClientV27 extends TrueNasApiClient<ApiDirectory> {
  */
 declare class VersionDiscovery {
     private readonly logger;
+    private readonly protocol;
     private versionCache;
-    constructor(logger?: Logger);
+    constructor(logger?: Logger, protocol?: ApplianceProtocol);
+    private versionsUrl;
     /**
      * Discovers the API version for a given hostname.
      *
-     * Makes a GET request to `https://{hostname}/api/versions` and returns the latest
+     * Makes a GET request to `{protocol}//{hostname}/api/versions` and returns the latest
      * compatible version. Results are cached per hostname; the cache entry is removed
      * on failure so the next call retries.
      *
@@ -28067,4 +28103,4 @@ type ApiError = JsonRpcError | TrueNasError;
  */
 declare function getApiErrorMessage(error: unknown, fallback?: string): string;
 
-export { type ApiCallDirectory$7 as ApiCallDirectoryV25_10_0, type ApiCallDirectory$6 as ApiCallDirectoryV25_10_1, type ApiCallDirectory$5 as ApiCallDirectoryV25_10_2, type ApiCallDirectory$4 as ApiCallDirectoryV25_10_3, type ApiCallDirectory$3 as ApiCallDirectoryV25_10_4, type ApiCallDirectory$2 as ApiCallDirectoryV25_10_5, type ApiCallDirectory$1 as ApiCallDirectoryV26_0_0, type ApiCallDirectory as ApiCallDirectoryV27_0_0, type ApiDirectoryByVersion, type ApiDirectoryShape, type ApiDirectory$7 as ApiDirectoryV25_10_0, type ApiDirectory$6 as ApiDirectoryV25_10_1, type ApiDirectory$5 as ApiDirectoryV25_10_2, type ApiDirectory$4 as ApiDirectoryV25_10_3, type ApiDirectory$3 as ApiDirectoryV25_10_4, type ApiDirectory$2 as ApiDirectoryV25_10_5, type ApiDirectory$1 as ApiDirectoryV26_0_0, type ApiDirectory as ApiDirectoryV27_0_0, type ApiError, type ApiEventDirectory$7 as ApiEventDirectoryV25_10_0, type ApiEventDirectory$6 as ApiEventDirectoryV25_10_1, type ApiEventDirectory$5 as ApiEventDirectoryV25_10_2, type ApiEventDirectory$4 as ApiEventDirectoryV25_10_3, type ApiEventDirectory$3 as ApiEventDirectoryV25_10_4, type ApiEventDirectory$2 as ApiEventDirectoryV25_10_5, type ApiEventDirectory$1 as ApiEventDirectoryV26_0_0, type ApiEventDirectory as ApiEventDirectoryV27_0_0, type ApiJobDirectory$7 as ApiJobDirectoryV25_10_0, type ApiJobDirectory$6 as ApiJobDirectoryV25_10_1, type ApiJobDirectory$5 as ApiJobDirectoryV25_10_2, type ApiJobDirectory$4 as ApiJobDirectoryV25_10_3, type ApiJobDirectory$3 as ApiJobDirectoryV25_10_4, type ApiJobDirectory$2 as ApiJobDirectoryV25_10_5, type ApiJobDirectory$1 as ApiJobDirectoryV26_0_0, type ApiJobDirectory as ApiJobDirectoryV27_0_0, type ApiKeyCreate, type ApiVersion, type ApiVersionResponse, AppState, type ArgsOf, AuthError, AuthErrorCode, type AuthResponse, type BaseApiDirectory, type CallMethod, type CallParams, type CallResponse, type Container, type CreateClientOptions, type DefaultApiDirectory, type EventKind, type EventName, type EventUnion, InvalidVersionResponseError, type Job, type JobMethod, type JobParams, type JobProgress, type JobResult, JobState, type Logger, NoCompatibleVersionsError, type OperationMappings, type QueryDirectory, type QueryEntity, type QueryListOptions, type QueryMethod, type QuerySingleOptions, SUPPORTED_API_VERSIONS, type SupportedApiVersion, TrueNasApiClient, TrueNasApiClientV2510, TrueNasApiClientV26, TrueNasApiClientV27, TrueNasAuthMechanism, type TrueNasDate, VersionCompatibility, VersionDiscovery, VersionDiscoveryError, VersionDiscoveryNetworkError, VersionDiscoveryTimeoutError, VersionEndpointNotFoundError, VersionTooNewError, VersionTooOldError, consoleLogger, createTrueNasClient, getApiErrorMessage, isJobFinished, noopLogger, index$7 as v25_10_0, index$6 as v25_10_1, index$5 as v25_10_2, index$4 as v25_10_3, index$3 as v25_10_4, index$2 as v25_10_5, index$1 as v26_0_0, index as v27_0_0 };
+export { type ApiCallDirectory$7 as ApiCallDirectoryV25_10_0, type ApiCallDirectory$6 as ApiCallDirectoryV25_10_1, type ApiCallDirectory$5 as ApiCallDirectoryV25_10_2, type ApiCallDirectory$4 as ApiCallDirectoryV25_10_3, type ApiCallDirectory$3 as ApiCallDirectoryV25_10_4, type ApiCallDirectory$2 as ApiCallDirectoryV25_10_5, type ApiCallDirectory$1 as ApiCallDirectoryV26_0_0, type ApiCallDirectory as ApiCallDirectoryV27_0_0, type ApiDirectoryByVersion, type ApiDirectoryShape, type ApiDirectory$7 as ApiDirectoryV25_10_0, type ApiDirectory$6 as ApiDirectoryV25_10_1, type ApiDirectory$5 as ApiDirectoryV25_10_2, type ApiDirectory$4 as ApiDirectoryV25_10_3, type ApiDirectory$3 as ApiDirectoryV25_10_4, type ApiDirectory$2 as ApiDirectoryV25_10_5, type ApiDirectory$1 as ApiDirectoryV26_0_0, type ApiDirectory as ApiDirectoryV27_0_0, type ApiError, type ApiEventDirectory$7 as ApiEventDirectoryV25_10_0, type ApiEventDirectory$6 as ApiEventDirectoryV25_10_1, type ApiEventDirectory$5 as ApiEventDirectoryV25_10_2, type ApiEventDirectory$4 as ApiEventDirectoryV25_10_3, type ApiEventDirectory$3 as ApiEventDirectoryV25_10_4, type ApiEventDirectory$2 as ApiEventDirectoryV25_10_5, type ApiEventDirectory$1 as ApiEventDirectoryV26_0_0, type ApiEventDirectory as ApiEventDirectoryV27_0_0, type ApiJobDirectory$7 as ApiJobDirectoryV25_10_0, type ApiJobDirectory$6 as ApiJobDirectoryV25_10_1, type ApiJobDirectory$5 as ApiJobDirectoryV25_10_2, type ApiJobDirectory$4 as ApiJobDirectoryV25_10_3, type ApiJobDirectory$3 as ApiJobDirectoryV25_10_4, type ApiJobDirectory$2 as ApiJobDirectoryV25_10_5, type ApiJobDirectory$1 as ApiJobDirectoryV26_0_0, type ApiJobDirectory as ApiJobDirectoryV27_0_0, type ApiKeyCreate, type ApiVersion, type ApiVersionResponse, AppState, type ApplianceProtocol, type ArgsOf, AuthError, AuthErrorCode, type AuthResponse, type BaseApiDirectory, type CallMethod, type CallParams, type CallResponse, type Container, type CreateClientOptions, type DefaultApiDirectory, type EventKind, type EventName, type EventUnion, InvalidVersionResponseError, type Job, type JobMethod, type JobParams, type JobProgress, type JobResult, JobState, type Logger, NoCompatibleVersionsError, type OperationMappings, type QueryDirectory, type QueryEntity, type QueryListOptions, type QueryMethod, type QuerySingleOptions, SUPPORTED_API_VERSIONS, type SupportedApiVersion, TrueNasApiClient, TrueNasApiClientV2510, TrueNasApiClientV26, TrueNasApiClientV27, TrueNasAuthMechanism, type TrueNasDate, VersionCompatibility, VersionDiscovery, VersionDiscoveryError, VersionDiscoveryNetworkError, VersionDiscoveryTimeoutError, VersionEndpointNotFoundError, VersionTooNewError, VersionTooOldError, consoleLogger, createTrueNasClient, getApiErrorMessage, isJobFinished, noopLogger, index$7 as v25_10_0, index$6 as v25_10_1, index$5 as v25_10_2, index$4 as v25_10_3, index$3 as v25_10_4, index$2 as v25_10_5, index$1 as v26_0_0, index as v27_0_0 };

package/dist/index.d.ts

@@ -12460,6 +12460,16 @@ declare class TrueNasSocket {
     complete(): void;
 }
 
+/**
+ * The scheme used to reach the appliance, in `location.protocol` form.
+ *
+ * Colon included, so a caller served *by the appliance* can pass
+ * `location.protocol` unchanged. That equivalence only holds same-origin: this
+ * value is spliced onto the hostname the client connects to, so a page served
+ * from somewhere else must say what the appliance uses, not what it uses.
+ */
+type ApplianceProtocol = 'http:' | 'https:';
+
 interface ActiveConnection {
     ws: TrueNasSocket;
     hostname: string;
@@ -12482,6 +12492,7 @@ declare class TrueNasConnection {
     readonly retryDelay: number;
     readonly maxRetry: number;
     readonly logger: Logger;
+    readonly protocol: ApplianceProtocol;
     opened: BehaviorSubject<boolean>;
     closed: Subject<void>;
     hostname: BehaviorSubject<string>;
@@ -12544,7 +12555,7 @@ declare class TrueNasConnection {
      * observable which always emits messages from the current socket.
      */
     messages$: Observable<TrueNasMessage>;
-    constructor(initialEnabled: boolean, hostnames: string[], systemUuid: string, websocketPath: string, systemName?: string | undefined, retryDelay?: number, maxRetry?: number, logger?: Logger);
+    constructor(initialEnabled: boolean, hostnames: string[], systemUuid: string, websocketPath: string, systemName?: string | undefined, retryDelay?: number, maxRetry?: number, logger?: Logger, protocol?: ApplianceProtocol);
     /**
      * whether the connection has exhausted its retries — the **cumulative** snapshot, read
      * synchronously. (Formerly `hasConnectionError()`; renamed to disambiguate it from the
@@ -13192,7 +13203,8 @@ declare abstract class TrueNasApiClient<D extends ApiDirectoryShape = BaseApiDir
     protected readonly systemName: string | undefined;
     /** Logger forwarded to the connection (defaults to a no-op). */
     protected readonly logger: Logger;
-    constructor(uuid: string, hostnames: string[], version: ApiVersion, enabled: boolean, systemName?: string, logger?: Logger);
+    protected readonly protocol: ApplianceProtocol;
+    constructor(uuid: string, hostnames: string[], version: ApiVersion, enabled: boolean, systemName?: string, logger?: Logger, protocol?: ApplianceProtocol);
     /**
      * Get current connection status.
      * @returns true if WebSocket is connected
@@ -27604,6 +27616,28 @@ interface CreateClientOptions {
      * without the caller asserting it through a type parameter.
      */
     version?: SupportedApiVersion;
+    /**
+     * The scheme to reach the appliance on, in `location.protocol` form.
+     *
+     * Selects both halves of the transport: `https:` gives `https` discovery and
+     * a `wss` socket, `http:` gives `http` and `ws`. Defaults to `https:`, which
+     * is what an appliance serves and what Connect uses.
+     *
+     * This describes the *appliance*, not the page. Passing
+     * `location.protocol` is correct when the appliance serves the page — the
+     * same-origin case this exists for — and wrong otherwise. A page on
+     * `http://localhost:5173` talking to an https appliance gets both halves
+     * wrong, but only one of them says so: `fetch` follows the redirect and
+     * discovery appears to work, while the WebSocket has no such tolerance and
+     * fails the handshake without naming the scheme.
+     *
+     * Omitting it against a plaintext appliance is the quieter failure and the
+     * likelier one, since it is the case this option exists for. Discovery tries
+     * `https`, `fetch` rejects, and that is indistinguishable from the CORS block
+     * v25.10.0 has on `/api/versions` — so the fallback fires and the caller gets
+     * a client pinned to v25.10.0, warned about only in the log.
+     */
+    protocol?: ApplianceProtocol;
 }
 /**
  * Creates a version-specific TrueNAS API client.
@@ -27883,12 +27917,14 @@ declare class TrueNasApiClientV27 extends TrueNasApiClient<ApiDirectory> {
  */
 declare class VersionDiscovery {
     private readonly logger;
+    private readonly protocol;
     private versionCache;
-    constructor(logger?: Logger);
+    constructor(logger?: Logger, protocol?: ApplianceProtocol);
+    private versionsUrl;
     /**
      * Discovers the API version for a given hostname.
      *
-     * Makes a GET request to `https://{hostname}/api/versions` and returns the latest
+     * Makes a GET request to `{protocol}//{hostname}/api/versions` and returns the latest
      * compatible version. Results are cached per hostname; the cache entry is removed
      * on failure so the next call retries.
      *
@@ -28067,4 +28103,4 @@ type ApiError = JsonRpcError | TrueNasError;
  */
 declare function getApiErrorMessage(error: unknown, fallback?: string): string;
 
-export { type ApiCallDirectory$7 as ApiCallDirectoryV25_10_0, type ApiCallDirectory$6 as ApiCallDirectoryV25_10_1, type ApiCallDirectory$5 as ApiCallDirectoryV25_10_2, type ApiCallDirectory$4 as ApiCallDirectoryV25_10_3, type ApiCallDirectory$3 as ApiCallDirectoryV25_10_4, type ApiCallDirectory$2 as ApiCallDirectoryV25_10_5, type ApiCallDirectory$1 as ApiCallDirectoryV26_0_0, type ApiCallDirectory as ApiCallDirectoryV27_0_0, type ApiDirectoryByVersion, type ApiDirectoryShape, type ApiDirectory$7 as ApiDirectoryV25_10_0, type ApiDirectory$6 as ApiDirectoryV25_10_1, type ApiDirectory$5 as ApiDirectoryV25_10_2, type ApiDirectory$4 as ApiDirectoryV25_10_3, type ApiDirectory$3 as ApiDirectoryV25_10_4, type ApiDirectory$2 as ApiDirectoryV25_10_5, type ApiDirectory$1 as ApiDirectoryV26_0_0, type ApiDirectory as ApiDirectoryV27_0_0, type ApiError, type ApiEventDirectory$7 as ApiEventDirectoryV25_10_0, type ApiEventDirectory$6 as ApiEventDirectoryV25_10_1, type ApiEventDirectory$5 as ApiEventDirectoryV25_10_2, type ApiEventDirectory$4 as ApiEventDirectoryV25_10_3, type ApiEventDirectory$3 as ApiEventDirectoryV25_10_4, type ApiEventDirectory$2 as ApiEventDirectoryV25_10_5, type ApiEventDirectory$1 as ApiEventDirectoryV26_0_0, type ApiEventDirectory as ApiEventDirectoryV27_0_0, type ApiJobDirectory$7 as ApiJobDirectoryV25_10_0, type ApiJobDirectory$6 as ApiJobDirectoryV25_10_1, type ApiJobDirectory$5 as ApiJobDirectoryV25_10_2, type ApiJobDirectory$4 as ApiJobDirectoryV25_10_3, type ApiJobDirectory$3 as ApiJobDirectoryV25_10_4, type ApiJobDirectory$2 as ApiJobDirectoryV25_10_5, type ApiJobDirectory$1 as ApiJobDirectoryV26_0_0, type ApiJobDirectory as ApiJobDirectoryV27_0_0, type ApiKeyCreate, type ApiVersion, type ApiVersionResponse, AppState, type ArgsOf, AuthError, AuthErrorCode, type AuthResponse, type BaseApiDirectory, type CallMethod, type CallParams, type CallResponse, type Container, type CreateClientOptions, type DefaultApiDirectory, type EventKind, type EventName, type EventUnion, InvalidVersionResponseError, type Job, type JobMethod, type JobParams, type JobProgress, type JobResult, JobState, type Logger, NoCompatibleVersionsError, type OperationMappings, type QueryDirectory, type QueryEntity, type QueryListOptions, type QueryMethod, type QuerySingleOptions, SUPPORTED_API_VERSIONS, type SupportedApiVersion, TrueNasApiClient, TrueNasApiClientV2510, TrueNasApiClientV26, TrueNasApiClientV27, TrueNasAuthMechanism, type TrueNasDate, VersionCompatibility, VersionDiscovery, VersionDiscoveryError, VersionDiscoveryNetworkError, VersionDiscoveryTimeoutError, VersionEndpointNotFoundError, VersionTooNewError, VersionTooOldError, consoleLogger, createTrueNasClient, getApiErrorMessage, isJobFinished, noopLogger, index$7 as v25_10_0, index$6 as v25_10_1, index$5 as v25_10_2, index$4 as v25_10_3, index$3 as v25_10_4, index$2 as v25_10_5, index$1 as v26_0_0, index as v27_0_0 };
+export { type ApiCallDirectory$7 as ApiCallDirectoryV25_10_0, type ApiCallDirectory$6 as ApiCallDirectoryV25_10_1, type ApiCallDirectory$5 as ApiCallDirectoryV25_10_2, type ApiCallDirectory$4 as ApiCallDirectoryV25_10_3, type ApiCallDirectory$3 as ApiCallDirectoryV25_10_4, type ApiCallDirectory$2 as ApiCallDirectoryV25_10_5, type ApiCallDirectory$1 as ApiCallDirectoryV26_0_0, type ApiCallDirectory as ApiCallDirectoryV27_0_0, type ApiDirectoryByVersion, type ApiDirectoryShape, type ApiDirectory$7 as ApiDirectoryV25_10_0, type ApiDirectory$6 as ApiDirectoryV25_10_1, type ApiDirectory$5 as ApiDirectoryV25_10_2, type ApiDirectory$4 as ApiDirectoryV25_10_3, type ApiDirectory$3 as ApiDirectoryV25_10_4, type ApiDirectory$2 as ApiDirectoryV25_10_5, type ApiDirectory$1 as ApiDirectoryV26_0_0, type ApiDirectory as ApiDirectoryV27_0_0, type ApiError, type ApiEventDirectory$7 as ApiEventDirectoryV25_10_0, type ApiEventDirectory$6 as ApiEventDirectoryV25_10_1, type ApiEventDirectory$5 as ApiEventDirectoryV25_10_2, type ApiEventDirectory$4 as ApiEventDirectoryV25_10_3, type ApiEventDirectory$3 as ApiEventDirectoryV25_10_4, type ApiEventDirectory$2 as ApiEventDirectoryV25_10_5, type ApiEventDirectory$1 as ApiEventDirectoryV26_0_0, type ApiEventDirectory as ApiEventDirectoryV27_0_0, type ApiJobDirectory$7 as ApiJobDirectoryV25_10_0, type ApiJobDirectory$6 as ApiJobDirectoryV25_10_1, type ApiJobDirectory$5 as ApiJobDirectoryV25_10_2, type ApiJobDirectory$4 as ApiJobDirectoryV25_10_3, type ApiJobDirectory$3 as ApiJobDirectoryV25_10_4, type ApiJobDirectory$2 as ApiJobDirectoryV25_10_5, type ApiJobDirectory$1 as ApiJobDirectoryV26_0_0, type ApiJobDirectory as ApiJobDirectoryV27_0_0, type ApiKeyCreate, type ApiVersion, type ApiVersionResponse, AppState, type ApplianceProtocol, type ArgsOf, AuthError, AuthErrorCode, type AuthResponse, type BaseApiDirectory, type CallMethod, type CallParams, type CallResponse, type Container, type CreateClientOptions, type DefaultApiDirectory, type EventKind, type EventName, type EventUnion, InvalidVersionResponseError, type Job, type JobMethod, type JobParams, type JobProgress, type JobResult, JobState, type Logger, NoCompatibleVersionsError, type OperationMappings, type QueryDirectory, type QueryEntity, type QueryListOptions, type QueryMethod, type QuerySingleOptions, SUPPORTED_API_VERSIONS, type SupportedApiVersion, TrueNasApiClient, TrueNasApiClientV2510, TrueNasApiClientV26, TrueNasApiClientV27, TrueNasAuthMechanism, type TrueNasDate, VersionCompatibility, VersionDiscovery, VersionDiscoveryError, VersionDiscoveryNetworkError, VersionDiscoveryTimeoutError, VersionEndpointNotFoundError, VersionTooNewError, VersionTooOldError, consoleLogger, createTrueNasClient, getApiErrorMessage, isJobFinished, noopLogger, index$7 as v25_10_0, index$6 as v25_10_1, index$5 as v25_10_2, index$4 as v25_10_3, index$3 as v25_10_4, index$2 as v25_10_5, index$1 as v26_0_0, index as v27_0_0 };

package/dist/index.js

@@ -692,11 +692,19 @@ var TrueNasSocket = class {
   }
 };
 
+// src/types/transport.type.ts
+function httpScheme(protocol) {
+  return protocol === "http:" ? "http:" : "https:";
+}
+function socketScheme(protocol) {
+  return protocol === "http:" ? "ws:" : "wss:";
+}
+
 // src/connection/truenas-connection.ts
 var tenSeconds = 10 * 1e3;
 var twentySeconds = 20 * 1e3;
 var TrueNasConnection = class {
-  constructor(initialEnabled, hostnames, systemUuid, websocketPath, systemName, retryDelay = tenSeconds, maxRetry = 3, logger = noopLogger) {
+  constructor(initialEnabled, hostnames, systemUuid, websocketPath, systemName, retryDelay = tenSeconds, maxRetry = 3, logger = noopLogger, protocol = "https:") {
     this.hostnames = hostnames;
     this.systemUuid = systemUuid;
     this.websocketPath = websocketPath;
@@ -704,6 +712,7 @@ var TrueNasConnection = class {
     this.retryDelay = retryDelay;
     this.maxRetry = maxRetry;
     this.logger = logger;
+    this.protocol = protocol;
     // compatibility properties
     this.opened = new BehaviorSubject(false);
     this.closed = new Subject();
@@ -900,7 +909,7 @@ var TrueNasConnection = class {
    * error if the connection is never established and will not complete until unsubscribed from or closed.
    */
   createSocket(hostname) {
-    const url = `wss://${hostname}${this.websocketPath}`;
+    const url = `${socketScheme(this.protocol)}//${hostname}${this.websocketPath}`;
     let hasOpened = false;
     return new Observable((subscriber) => {
       const ws = new TrueNasSocket({
@@ -2999,13 +3008,14 @@ function getWebSocketPath(version) {
 
 // src/client/truenas-api-client.ts
 var TrueNasApiClient = class {
-  constructor(uuid, hostnames, version, enabled, systemName, logger = noopLogger) {
+  constructor(uuid, hostnames, version, enabled, systemName, logger = noopLogger, protocol = "https:") {
     this.uuid = uuid;
     this.hostnames = hostnames;
     this.version = version;
     this.enabled = enabled;
     this.systemName = systemName;
     this.logger = logger;
+    this.protocol = protocol;
     this.connection = this.createConnection();
     this.authenticator = this.createAuthenticator();
     this.api = this.createApi();
@@ -3048,7 +3058,8 @@ var TrueNasApiClient = class {
       // retryDelay (use default)
       void 0,
       // maxRetry (use default)
-      this.logger
+      this.logger,
+      this.protocol
     );
   }
   /**
@@ -3442,14 +3453,18 @@ function hasErrorName(error, expected) {
   return typeof error === "object" && error !== null && "name" in error && error.name === expected;
 }
 var VersionDiscovery = class {
-  constructor(logger = noopLogger) {
+  constructor(logger = noopLogger, protocol = "https:") {
     this.logger = logger;
+    this.protocol = protocol;
     this.versionCache = /* @__PURE__ */ new Map();
   }
+  versionsUrl(hostname) {
+    return `${httpScheme(this.protocol)}//${hostname}/api/versions`;
+  }
   /**
    * Discovers the API version for a given hostname.
    *
-   * Makes a GET request to `https://{hostname}/api/versions` and returns the latest
+   * Makes a GET request to `{protocol}//{hostname}/api/versions` and returns the latest
    * compatible version. Results are cached per hostname; the cache entry is removed
    * on failure so the next call retries.
    *
@@ -3463,8 +3478,10 @@ var VersionDiscovery = class {
       this.logger.info("Version discovery cache hit", { hostname });
       return cached;
     }
-    const url = `https://${hostname}/api/versions`;
-    this.logger.info("Starting version discovery", { hostname, url });
+    this.logger.info("Starting version discovery", {
+      hostname,
+      url: this.versionsUrl(hostname)
+    });
     const discovery$ = defer(() => from(this.fetchVersions(hostname))).pipe(
       map$1((versionStrings) => this.selectVersion(hostname, versionStrings)),
       catchError((error) => {
@@ -3502,7 +3519,7 @@ var VersionDiscovery = class {
    * misfile as a network error. Validating here keeps it an `InvalidVersionResponseError`.
    */
   async fetchVersions(hostname) {
-    const url = `https://${hostname}/api/versions`;
+    const url = this.versionsUrl(hostname);
     const controller = new AbortController();
     const timer2 = setTimeout(() => controller.abort(), discoveryTimeoutMs);
     try {
@@ -3675,7 +3692,7 @@ async function createTrueNasClient(opts) {
     });
     return instantiateClientForVersion(known, opts, logger);
   }
-  const versionDiscovery = new VersionDiscovery(logger);
+  const versionDiscovery = new VersionDiscovery(logger, opts.protocol);
   let version;
   try {
     const winner = await discoverVersionFromAnyHostname(
@@ -3784,7 +3801,8 @@ function instantiateClientForVersion(version, opts, logger) {
     version,
     enabled,
     systemName,
-    logger
+    logger,
+    opts.protocol
   );
 }
 function errorMessageOrDefault(error, fallback) {