@tinycloud/sdk-core 2.11.0-beta.3 → 2.11.0-beta.4

package/dist/index.d.cts

@@ -2776,7 +2776,7 @@ interface LocationRecord extends LocationRecordPayload {
 type LocationSource = "explicit" | "local-loopback" | "local-link" | "blockchain" | "centralized" | "fallback";
 declare const DEFAULT_TINYCLOUD_LOCATION_REGISTRY_URL = "https://registry.tinycloud.xyz";
 declare const DEFAULT_TINYCLOUD_FALLBACK_HOST = "https://node.tinycloud.xyz";
-/** Default local loopback node URL probed before registry/fallback resolution. */
+/** Conventional local loopback node URL. Probed only when explicitly configured. */
 declare const DEFAULT_LOCAL_NODE_URL = "http://127.0.0.1:8000";
 /** Probe timeout for the local loopback candidate. No retries. */
 declare const LOCAL_LOOPBACK_PROBE_TIMEOUT_MS = 250;
@@ -2863,7 +2863,7 @@ interface DiscoverLocalTinyCloudNodeOptions {
     subject?: string;
     /** Enable local-node auto-discovery. Default true. */
     autoDiscoverLocalNode?: boolean;
-    /** Local loopback node URL to probe. Default http://127.0.0.1:8000. */
+    /** Local loopback node URL to probe. Omit to avoid probing loopback. */
     localNodeUrl?: string;
     /** Known `*.local.tinycloud.link` subdomain name, probed directly. */
     localLinkName?: string;
@@ -2897,12 +2897,12 @@ interface ResolveTinyCloudHostsOptions {
     /** Verify centralized/blockchain record signatures. Default true. */
     verifyRecords?: boolean;
     /**
-     * Probe for a locally-running TinyCloud node before falling back to
-     * registry/hosted resolution. Default true. Setting false restores the
-     * exact pre-TC-106 resolution order (registry → fallback).
+     * Probe configured and registered local TinyCloud node endpoints before
+     * falling back to registry/hosted resolution. Default true. The loopback
+     * URL is probed only when `localNodeUrl` is explicitly configured.
      */
     autoDiscoverLocalNode?: boolean;
-    /** Local loopback node URL to probe. Default http://127.0.0.1:8000. */
+    /** Local loopback node URL to probe. Omit to avoid probing loopback. */
     localNodeUrl?: string;
     /** Known `*.local.tinycloud.link` subdomain name, probed directly. */
     localLinkName?: string;

package/dist/index.d.ts

@@ -2776,7 +2776,7 @@ interface LocationRecord extends LocationRecordPayload {
 type LocationSource = "explicit" | "local-loopback" | "local-link" | "blockchain" | "centralized" | "fallback";
 declare const DEFAULT_TINYCLOUD_LOCATION_REGISTRY_URL = "https://registry.tinycloud.xyz";
 declare const DEFAULT_TINYCLOUD_FALLBACK_HOST = "https://node.tinycloud.xyz";
-/** Default local loopback node URL probed before registry/fallback resolution. */
+/** Conventional local loopback node URL. Probed only when explicitly configured. */
 declare const DEFAULT_LOCAL_NODE_URL = "http://127.0.0.1:8000";
 /** Probe timeout for the local loopback candidate. No retries. */
 declare const LOCAL_LOOPBACK_PROBE_TIMEOUT_MS = 250;
@@ -2863,7 +2863,7 @@ interface DiscoverLocalTinyCloudNodeOptions {
     subject?: string;
     /** Enable local-node auto-discovery. Default true. */
     autoDiscoverLocalNode?: boolean;
-    /** Local loopback node URL to probe. Default http://127.0.0.1:8000. */
+    /** Local loopback node URL to probe. Omit to avoid probing loopback. */
     localNodeUrl?: string;
     /** Known `*.local.tinycloud.link` subdomain name, probed directly. */
     localLinkName?: string;
@@ -2897,12 +2897,12 @@ interface ResolveTinyCloudHostsOptions {
     /** Verify centralized/blockchain record signatures. Default true. */
     verifyRecords?: boolean;
     /**
-     * Probe for a locally-running TinyCloud node before falling back to
-     * registry/hosted resolution. Default true. Setting false restores the
-     * exact pre-TC-106 resolution order (registry → fallback).
+     * Probe configured and registered local TinyCloud node endpoints before
+     * falling back to registry/hosted resolution. Default true. The loopback
+     * URL is probed only when `localNodeUrl` is explicitly configured.
      */
     autoDiscoverLocalNode?: boolean;
-    /** Local loopback node URL to probe. Default http://127.0.0.1:8000. */
+    /** Local loopback node URL to probe. Omit to avoid probing loopback. */
     localNodeUrl?: string;
     /** Known `*.local.tinycloud.link` subdomain name, probed directly. */
     localLinkName?: string;

package/dist/index.js

@@ -15132,13 +15132,14 @@ async function discoverLocalTinyCloudNode(options2 = {}) {
   }
   const fetchFn = options2.fetch ?? globalThis.fetch;
   const identityStore = options2.identityStore ?? defaultLocalNodeIdentityStore;
-  const staticCandidates = [
-    {
+  const staticCandidates = [];
+  if (options2.localNodeUrl) {
+    staticCandidates.push({
       source: "local-loopback",
-      url: options2.localNodeUrl ?? DEFAULT_LOCAL_NODE_URL,
+      url: options2.localNodeUrl,
       timeoutMs: LOCAL_LOOPBACK_PROBE_TIMEOUT_MS
-    }
-  ];
+    });
+  }
   if (options2.localLinkName) {
     if (isValidDnsLabel(options2.localLinkName)) {
       staticCandidates.push({