@xyo-network/module-abstract 2.93.0-rc.1 → 2.93.0

package/dist/browser/index.cjs

@@ -47,7 +47,7 @@ var import_boundwitness_builder = require("@xyo-network/boundwitness-builder");
 var import_boundwitness_wrapper3 = require("@xyo-network/boundwitness-wrapper");
 var import_config_payload_plugin = require("@xyo-network/config-payload-plugin");
 var import_manifest_model = require("@xyo-network/manifest-model");
-var import_module_model2 = require("@xyo-network/module-model");
+var import_module_model = require("@xyo-network/module-model");
 var import_module_resolver = require("@xyo-network/module-resolver");
 var import_payload_builder2 = require("@xyo-network/payload-builder");
 var import_query_payload_plugin = require("@xyo-network/query-payload-plugin");
@@ -244,75 +244,6 @@ var SupportedQueryValidator = class {
   queryable;
 };
 
-// src/ResolveHelper.ts
-var import_module_model = require("@xyo-network/module-model");
-var ResolveHelper = class {
-  static {
-    __name(this, "ResolveHelper");
-  }
-  static async resolve(config, idOrFilter = "*", { required = "log", ...options } = {}) {
-    const { dead = false, upResolver, downResolver } = config;
-    const childOptions = {
-      ...options,
-      required: false
-    };
-    const direction = options?.direction ?? "all";
-    const up = direction === "up" || direction === "all";
-    const down = direction === "down" || direction === "all";
-    let result;
-    if (idOrFilter === "*") {
-      if (dead) {
-        return [];
-      }
-      return [
-        ...down ? await downResolver.resolve("*", childOptions) : [],
-        ...up ? await upResolver.resolve("*", childOptions) : []
-      ].filter(import_module_model.duplicateModules);
-    } else {
-      switch (typeof idOrFilter) {
-        case "string": {
-          if (dead) {
-            return void 0;
-          }
-          result = (down ? await downResolver.resolve(idOrFilter, childOptions) : void 0) ?? (up ? await upResolver.resolve(idOrFilter, childOptions) : void 0);
-          break;
-        }
-        default: {
-          if (dead) {
-            return [];
-          }
-          const filter = idOrFilter;
-          result = [
-            ...down ? await downResolver.resolve(filter, childOptions) : [],
-            ...up ? await upResolver.resolve(filter, childOptions) : []
-          ].filter(import_module_model.duplicateModules);
-          break;
-        }
-      }
-    }
-    this.validateRequiredResolve(required, result, idOrFilter);
-    return result;
-  }
-  static validateRequiredResolve(required, result, idOrFilter, logger) {
-    if (required && (result === void 0 || Array.isArray(result) && result.length > 0)) {
-      switch (required) {
-        case "warn": {
-          logger?.warn("resolve failed", idOrFilter);
-          break;
-        }
-        case "log": {
-          logger?.log("resolve failed", idOrFilter);
-          break;
-        }
-        default: {
-          logger?.error("resolve failed", idOrFilter);
-          break;
-        }
-      }
-    }
-  }
-};
-
 // src/AbstractModule.ts
 var AbstractModule = class _AbstractModule extends BaseEmitter {
   static {
@@ -320,28 +251,28 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
   }
   static allowRandomAccount = true;
   static configSchemas;
-  static defaultLogger = new import_logger.ConsoleLogger(import_logger.LogLevel.log);
+  static defaultLogger = new import_logger.ConsoleLogger(import_logger.LogLevel.warn);
   static enableLazyLoad = false;
   static privateConstructorKey = Date.now().toString();
   downResolver = new import_module_resolver.CompositeModuleResolver();
   upResolver = new import_module_resolver.CompositeModuleResolver();
   _account = void 0;
   _baseModuleQueryAccountPaths = {
-    [import_module_model2.ModuleAddressQuerySchema]: "1",
-    [import_module_model2.ModuleDescribeQuerySchema]: "4",
-    [import_module_model2.ModuleDiscoverQuerySchema]: "2",
-    [import_module_model2.ModuleManifestQuerySchema]: "5",
-    [import_module_model2.ModuleStateQuerySchema]: "6",
-    [import_module_model2.ModuleSubscribeQuerySchema]: "3"
+    [import_module_model.ModuleAddressQuerySchema]: "1",
+    [import_module_model.ModuleDescribeQuerySchema]: "4",
+    [import_module_model.ModuleDiscoverQuerySchema]: "2",
+    [import_module_model.ModuleManifestQuerySchema]: "5",
+    [import_module_model.ModuleStateQuerySchema]: "6",
+    [import_module_model.ModuleSubscribeQuerySchema]: "3"
   };
   _lastError;
   _queryAccounts = {
-    [import_module_model2.ModuleAddressQuerySchema]: void 0,
-    [import_module_model2.ModuleDescribeQuerySchema]: void 0,
-    [import_module_model2.ModuleDiscoverQuerySchema]: void 0,
-    [import_module_model2.ModuleManifestQuerySchema]: void 0,
-    [import_module_model2.ModuleStateQuerySchema]: void 0,
-    [import_module_model2.ModuleSubscribeQuerySchema]: void 0
+    [import_module_model.ModuleAddressQuerySchema]: void 0,
+    [import_module_model.ModuleDescribeQuerySchema]: void 0,
+    [import_module_model.ModuleDiscoverQuerySchema]: void 0,
+    [import_module_model.ModuleManifestQuerySchema]: void 0,
+    [import_module_model.ModuleStateQuerySchema]: void 0,
+    [import_module_model.ModuleSubscribeQuerySchema]: void 0
   };
   _startPromise = void 0;
   _started = void 0;
@@ -371,6 +302,9 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
   get allowAnonymous() {
     return !!this.config.security?.allowAnonymous;
   }
+  get archiving() {
+    return this.config.archiving;
+  }
   get config() {
     return this.params.config;
   }
@@ -385,12 +319,12 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
   }
   get queries() {
     return [
-      import_module_model2.ModuleDiscoverQuerySchema,
-      import_module_model2.ModuleAddressQuerySchema,
-      import_module_model2.ModuleSubscribeQuerySchema,
-      import_module_model2.ModuleDescribeQuerySchema,
-      import_module_model2.ModuleManifestQuerySchema,
-      import_module_model2.ModuleStateQuerySchema
+      import_module_model.ModuleDiscoverQuerySchema,
+      import_module_model.ModuleAddressQuerySchema,
+      import_module_model.ModuleSubscribeQuerySchema,
+      import_module_model.ModuleDescribeQuerySchema,
+      import_module_model.ModuleManifestQuerySchema,
+      import_module_model.ModuleStateQuerySchema
     ];
   }
   get queryAccountPaths() {
@@ -436,7 +370,7 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
     if (!this.configSchemas || this.configSchemas.length === 0) {
       throw new Error(`Missing configSchema [${params?.config?.schema}][${this.name}]`);
     }
-    (0, import_assert2.assertEx)(params?.config?.name === void 0 || (0, import_module_model2.isModuleName)(params.config.name), () => `Invalid module name: ${params?.config?.name}`);
+    (0, import_assert2.assertEx)(params?.config?.name === void 0 || (0, import_module_model.isModuleName)(params.config.name), () => `Invalid module name: ${params?.config?.name}`);
     const { account } = params ?? {};
     const schema = params?.config?.schema ?? this.configSchema;
     const allowedSchemas = this.configSchemas;
@@ -466,7 +400,7 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
     return await determineAccount(params, this.allowRandomAccount);
   }
   static factory(params) {
-    return import_module_model2.ModuleFactory.withParams(this, params);
+    return import_module_model.ModuleFactory.withParams(this, params);
   }
   _getRootFunction(funcName) {
     let anyThis = this;
@@ -565,31 +499,6 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
     ];
     return validators.every((validator) => validator(query, payloads));
   }
-  async resolve(idOrFilter = "*", options = {}) {
-    switch (typeof idOrFilter) {
-      case "string": {
-        return await ResolveHelper.resolve({
-          dead: this.dead,
-          downResolver: this.downResolver,
-          upResolver: this.upResolver
-        }, idOrFilter, options);
-      }
-      case "object": {
-        return await ResolveHelper.resolve({
-          dead: this.dead,
-          downResolver: this.downResolver,
-          upResolver: this.upResolver
-        }, idOrFilter, options);
-      }
-      default: {
-        return await ResolveHelper.resolve({
-          dead: this.dead,
-          downResolver: this.downResolver,
-          upResolver: this.upResolver
-        }, idOrFilter, options);
-      }
-    }
-  }
   start(_timeout) {
     this._startPromise = this._startPromise ?? this.startHandler();
     const result = this._startPromise;
@@ -653,7 +562,7 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
   }
   _checkDead() {
     if (this.dead) {
-      throw new import_module_model2.DeadModuleError(this.id, this._lastError);
+      throw new import_module_model.DeadModuleError(this.id, this._lastError);
     }
   }
   _noOverride(functionName) {
@@ -702,7 +611,7 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
       await Promise.all(payloads.map((payload) => import_payload_builder2.PayloadBuilder.build(payload))),
       await Promise.all((errors ?? [])?.map((error) => import_payload_builder2.PayloadBuilder.build(error)))
     ];
-    if (this.config.archiving) {
+    if (this.archiving) {
       await this.storeToArchivists(result.flat());
     }
     return result;
@@ -711,7 +620,7 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
     const description = {
       address: this.address,
       queries: this.queries,
-      schema: import_module_model2.ModuleDescriptionSchema
+      schema: import_module_model.ModuleDescriptionSchema
     };
     if (this.config?.name) {
       description.name = this.config.name;
@@ -772,11 +681,11 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
       }
     }
   }
-  async manifestHandler(_depth, _ignoreAddresses) {
+  async manifestHandler(maxDepth = 1, _ignoreAddresses = []) {
     const name = this.config.name ?? "Anonymous";
     const children = await this.downResolver.resolve("*", {
       direction: "down",
-      maxDepth: 1
+      maxDepth
     });
     const childAddressToName = {};
     for (const child of children) {
@@ -811,7 +720,7 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
         {
           address: address2,
           previousHash: previousHash2,
-          schema: import_module_model2.AddressPreviousHashSchema
+          schema: import_module_model.AddressPreviousHashSchema
         }
       ];
     });
@@ -829,10 +738,10 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
     const moduleAccountPreviousHash = previousHash ? {
       address,
       previousHash,
-      schema: import_module_model2.AddressPreviousHashSchema
+      schema: import_module_model.AddressPreviousHashSchema
     } : {
       address,
-      schema: import_module_model2.AddressPreviousHashSchema
+      schema: import_module_model.AddressPreviousHashSchema
     };
     return [
       moduleAccount,
@@ -847,28 +756,28 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
     (0, import_assert2.assertEx)(await this.queryable(query, payloads, queryConfig));
     const resultPayloads = [];
     switch (queryPayload.schema) {
-      case import_module_model2.ModuleManifestQuerySchema: {
+      case import_module_model.ModuleManifestQuerySchema: {
         resultPayloads.push(await this.manifestHandler(queryPayload.maxDepth));
         break;
       }
-      case import_module_model2.ModuleDiscoverQuerySchema: {
+      case import_module_model.ModuleDiscoverQuerySchema: {
         const { maxDepth } = queryPayload;
         resultPayloads.push(...await this.discoverHandler(maxDepth));
         break;
       }
-      case import_module_model2.ModuleDescribeQuerySchema: {
+      case import_module_model.ModuleDescribeQuerySchema: {
         resultPayloads.push(await this.describeHandler());
         break;
       }
-      case import_module_model2.ModuleAddressQuerySchema: {
+      case import_module_model.ModuleAddressQuerySchema: {
         resultPayloads.push(...await this.moduleAddressHandler());
         break;
       }
-      case import_module_model2.ModuleStateQuerySchema: {
+      case import_module_model.ModuleStateQuerySchema: {
         resultPayloads.push(...await this.stateHandler());
         break;
       }
-      case import_module_model2.ModuleSubscribeQuerySchema: {
+      case import_module_model.ModuleSubscribeQuerySchema: {
         this.subscribeHandler();
         break;
       }
@@ -878,13 +787,6 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
     }
     return resultPayloads;
   }
-  async resolveArchivingArchivists() {
-    const archivists = this.config.archiving?.archivists;
-    if (!archivists)
-      return [];
-    const resolved = await Promise.all(archivists.map((archivist) => this.resolve(archivist)));
-    return (0, import_lodash.compact)(resolved.map((mod) => (0, import_archivist_model.asArchivistInstance)(mod)));
-  }
   async startHandler() {
     this.validateConfig();
     await this.initializeQueryAccounts();
@@ -902,12 +804,6 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
     this._started = void 0;
     return true;
   }
-  async storeToArchivists(payloads) {
-    const archivists = await this.resolveArchivingArchivists();
-    return (await Promise.all(archivists.map((archivist) => {
-      return archivist.insert?.(payloads);
-    }))).map(([bw]) => bw);
-  }
   subscribeHandler() {
     return;
   }
@@ -930,7 +826,7 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
               }, true) && valid
             );
           }
-          if (!(0, import_module_model2.serializableField)(value)) {
+          if (!(0, import_module_model.serializableField)(value)) {
             this.logger?.warn(`Fields that are not serializable to JSON are not allowed in config [${parents?.join(".")}.${key}]`);
             return false;
           }
@@ -949,6 +845,101 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
 
 // src/AbstractModuleInstance.ts
 var import_assert3 = require("@xylabs/assert");
+var import_lodash2 = require("@xylabs/lodash");
+var import_archivist_model2 = require("@xyo-network/archivist-model");
+
+// src/ResolveHelper.ts
+var import_logger2 = require("@xylabs/logger");
+var import_object3 = require("@xylabs/object");
+var import_module_model2 = require("@xyo-network/module-model");
+var ResolveHelper = class {
+  static {
+    __name(this, "ResolveHelper");
+  }
+  static defaultLogger;
+  static async resolve(config, idOrFilter = "*", { visibility, maxDepth = 5, required = "log", ...options } = {}) {
+    const { module: module2, logger = this.defaultLogger, dead = false, upResolver, downResolver } = config;
+    const log = logger ? new import_logger2.IdLogger(logger, () => `ResolveHelper [${module2.id}][${idOrFilter}][${visibility}]`) : void 0;
+    const childOptions = {
+      ...options,
+      direction: "down",
+      maxDepth: maxDepth - 1,
+      required: false,
+      visibility
+    };
+    const direction = options?.direction ?? "all";
+    const up = direction === "up" || direction === "all";
+    const down = direction === "down" || direction === "all";
+    let result;
+    log?.debug("start", idOrFilter, maxDepth);
+    if (idOrFilter === "*") {
+      if (dead) {
+        log?.warn("failed [dead]", idOrFilter);
+        return [];
+      }
+      const modules = [
+        ...down ? await downResolver.resolve("*", childOptions) : [],
+        ...up ? await upResolver.resolve("*", childOptions) : []
+      ].filter(import_module_model2.duplicateModules).filter((module3) => module3.address !== config.address);
+      if (modules.length > 0) {
+        log?.log("modules [count]", modules.length);
+        log?.debug("modules", (0, import_object3.toJsonString)(modules, 4));
+      }
+      if (maxDepth === 0) {
+        return modules;
+      }
+      const childModules = (await Promise.all(modules.map(async (module3) => await module3.resolve("*", childOptions)))).flat().filter(import_module_model2.duplicateModules);
+      return [
+        module2,
+        ...modules,
+        ...childModules
+      ].filter(import_module_model2.duplicateModules);
+    } else {
+      switch (typeof idOrFilter) {
+        case "string": {
+          if (dead) {
+            return void 0;
+          }
+          result = (down ? await downResolver.resolve(idOrFilter, childOptions) : void 0) ?? (up ? await upResolver.resolve(idOrFilter, childOptions) : void 0);
+          break;
+        }
+        default: {
+          if (dead) {
+            return [];
+          }
+          const filter = idOrFilter;
+          result = [
+            ...down ? await downResolver.resolve(filter, childOptions) : [],
+            ...up ? await upResolver.resolve(filter, childOptions) : []
+          ].filter(import_module_model2.duplicateModules);
+          break;
+        }
+      }
+    }
+    this.validateRequiredResolve(required, result, idOrFilter, logger);
+    return result;
+  }
+  static validateRequiredResolve(required, result, idOrFilter, logger = this.defaultLogger) {
+    const log = logger ? new import_logger2.IdLogger(logger, () => `validateRequiredResolve [${idOrFilter}][${result}]`) : void 0;
+    if (required && (result === void 0 || Array.isArray(result) && result.length > 0)) {
+      switch (required) {
+        case "warn": {
+          log?.warn("resolve failed", idOrFilter);
+          break;
+        }
+        case "log": {
+          log?.log("resolve failed", idOrFilter);
+          break;
+        }
+        default: {
+          throw new Error(`resolve failed [${idOrFilter}]`);
+        }
+      }
+    }
+  }
+};
+
+// src/AbstractModuleInstance.ts
 var AbstractModuleInstance = class extends AbstractModule {
   static {
     __name(this, "AbstractModuleInstance");
@@ -968,10 +959,10 @@ var AbstractModuleInstance = class extends AbstractModule {
       return await this.describeHandler();
     });
   }
-  discover() {
+  discover(maxDepth = 5) {
     this._checkDead();
     return this.busy(async () => {
-      return await this.discoverHandler();
+      return await this.discoverHandler(maxDepth);
     });
   }
   manifest(maxDepth, ignoreAddresses) {
@@ -986,6 +977,30 @@ var AbstractModuleInstance = class extends AbstractModule {
       return await this.moduleAddressHandler();
     });
   }
+  async resolve(idOrFilter = "*", options = {}) {
+    const config = {
+      address: this.address,
+      dead: this.dead,
+      downResolver: this.downResolver,
+      logger: this.logger,
+      module: this,
+      upResolver: this.upResolver
+    };
+    if (idOrFilter === "*") {
+      return await ResolveHelper.resolve(config, idOrFilter, options);
+    }
+    switch (typeof idOrFilter) {
+      case "string": {
+        return await ResolveHelper.resolve(config, idOrFilter, options);
+      }
+      case "object": {
+        return await ResolveHelper.resolve(config, idOrFilter, options);
+      }
+      default: {
+        return await ResolveHelper.resolve(config, idOrFilter, options);
+      }
+    }
+  }
   state() {
     this._checkDead();
     return this.busy(async () => {
@@ -996,5 +1011,18 @@ var AbstractModuleInstance = class extends AbstractModule {
     this._checkDead();
     return this.subscribeHandler();
   }
+  async resolveArchivingArchivists() {
+    const archivists = this.config.archiving?.archivists;
+    if (!archivists)
+      return [];
+    const resolved = await Promise.all(archivists.map((archivist) => this.resolve(archivist)));
+    return (0, import_lodash2.compact)(resolved.map((mod) => (0, import_archivist_model2.asArchivistInstance)(mod)));
+  }
+  async storeToArchivists(payloads) {
+    const archivists = await this.resolveArchivingArchivists();
+    return (await Promise.all(archivists.map((archivist) => {
+      return archivist.insert?.(payloads);
+    }))).map(([bw]) => bw);
+  }
 };
 //# sourceMappingURL=index.cjs.map