@unicitylabs/sphere-sdk 0.8.0-dev.4 → 0.8.0-dev.5

package/dist/impl/nodejs/index.d.cts

@@ -1465,13 +1465,19 @@ declare abstract class BaseTrustBaseLoader implements TrustBaseLoader {
  */
 declare class NodeTrustBaseLoader extends BaseTrustBaseLoader {
     private filePath?;
-    constructor(filePathOrNetwork?: string | NetworkType);
+    /**
+     * @param filePathOrNetwork - a NetworkType, or a file path to load the trust base from
+     * @param fallbackNetwork - network used for the embedded fallback when a file path is
+     *   supplied (and the file is missing/unreadable). Required when filePathOrNetwork is a
+     *   path — we must never silently fall back to testnet on a different network.
+     */
+    constructor(filePathOrNetwork?: string | NetworkType, fallbackNetwork?: NetworkType);
     protected loadFromExternal(): Promise<unknown | null>;
 }
 /**
  * Create Node.js TrustBase loader
  */
-declare function createNodeTrustBaseLoader(filePathOrNetwork?: string | NetworkType): TrustBaseLoader$1;
+declare function createNodeTrustBaseLoader(filePathOrNetwork?: string | NetworkType, fallbackNetwork?: NetworkType): TrustBaseLoader$1;
 /**
  * Create UnicityAggregatorProvider with Node.js TrustBase loader
  */

package/dist/impl/nodejs/index.d.ts

@@ -1465,13 +1465,19 @@ declare abstract class BaseTrustBaseLoader implements TrustBaseLoader {
  */
 declare class NodeTrustBaseLoader extends BaseTrustBaseLoader {
     private filePath?;
-    constructor(filePathOrNetwork?: string | NetworkType);
+    /**
+     * @param filePathOrNetwork - a NetworkType, or a file path to load the trust base from
+     * @param fallbackNetwork - network used for the embedded fallback when a file path is
+     *   supplied (and the file is missing/unreadable). Required when filePathOrNetwork is a
+     *   path — we must never silently fall back to testnet on a different network.
+     */
+    constructor(filePathOrNetwork?: string | NetworkType, fallbackNetwork?: NetworkType);
     protected loadFromExternal(): Promise<unknown | null>;
 }
 /**
  * Create Node.js TrustBase loader
  */
-declare function createNodeTrustBaseLoader(filePathOrNetwork?: string | NetworkType): TrustBaseLoader$1;
+declare function createNodeTrustBaseLoader(filePathOrNetwork?: string | NetworkType, fallbackNetwork?: NetworkType): TrustBaseLoader$1;
 /**
  * Create UnicityAggregatorProvider with Node.js TrustBase loader
  */

package/dist/impl/nodejs/index.js

@@ -26871,7 +26871,7 @@ function getEmbeddedTrustBase(network) {
     case "dev":
       return TRUSTBASE_DEV;
     default:
-      return TRUSTBASE_TESTNET;
+      throw new SphereError(`getEmbeddedTrustBase: unknown network "${network}"`, "INVALID_CONFIG");
   }
 }
 var BaseTrustBaseLoader = class {
@@ -26891,11 +26891,23 @@ var BaseTrustBaseLoader = class {
 // impl/nodejs/oracle/index.ts
 var NodeTrustBaseLoader = class extends BaseTrustBaseLoader {
   filePath;
-  constructor(filePathOrNetwork) {
+  /**
+   * @param filePathOrNetwork - a NetworkType, or a file path to load the trust base from
+   * @param fallbackNetwork - network used for the embedded fallback when a file path is
+   *   supplied (and the file is missing/unreadable). Required when filePathOrNetwork is a
+   *   path — we must never silently fall back to testnet on a different network.
+   */
+  constructor(filePathOrNetwork, fallbackNetwork) {
     if (!filePathOrNetwork) {
-      super("testnet");
+      throw new SphereError("NodeTrustBaseLoader: network or trustBasePath is required.", "INVALID_CONFIG");
     } else if (filePathOrNetwork.includes("/") || filePathOrNetwork.includes(".")) {
-      super("testnet");
+      if (!fallbackNetwork) {
+        throw new SphereError(
+          "NodeTrustBaseLoader: fallbackNetwork is required when a trustBasePath is supplied.",
+          "INVALID_CONFIG"
+        );
+      }
+      super(fallbackNetwork);
       this.filePath = filePathOrNetwork;
     } else {
       super(filePathOrNetwork);
@@ -26913,14 +26925,21 @@ var NodeTrustBaseLoader = class extends BaseTrustBaseLoader {
     return null;
   }
 };
-function createNodeTrustBaseLoader(filePathOrNetwork) {
-  return new NodeTrustBaseLoader(filePathOrNetwork);
+function createNodeTrustBaseLoader(filePathOrNetwork, fallbackNetwork) {
+  return new NodeTrustBaseLoader(filePathOrNetwork, fallbackNetwork);
 }
 function createUnicityAggregatorProvider(config) {
   const { trustBasePath, network, ...restConfig } = config;
+  if (!trustBasePath && !network) {
+    throw new SphereError(
+      "createUnicityAggregatorProvider: network or trustBaseUrl required.",
+      "INVALID_CONFIG"
+    );
+  }
   return new UnicityAggregatorProvider({
     ...restConfig,
-    trustBaseLoader: createNodeTrustBaseLoader(trustBasePath ?? network ?? "testnet")
+    // When a path is supplied, `network` (if any) is the embedded-fallback network.
+    trustBaseLoader: createNodeTrustBaseLoader(trustBasePath ?? network, network)
   });
 }
 var createUnicityOracleProvider = createUnicityAggregatorProvider;
@@ -29687,7 +29706,10 @@ function createNodeProviders(config) {
       );
     }
   }
-  const network = config?.network ?? "mainnet";
+  if (!config?.network) {
+    throw new SphereError("createNodeProviders: config.network is required.", "INVALID_CONFIG");
+  }
+  const network = config.network;
   const globalDebug = config?.debug ?? false;
   logger.configure({ debug: globalDebug });
   if (config?.transport?.debug) logger.setTagDebug("Nostr", true);