@xyo-network/module-abstract 2.92.6 → 2.92.8

package/dist/node/index.js

@@ -21,7 +21,7 @@ import { BoundWitnessBuilder, QueryBoundWitnessBuilder } from "@xyo-network/boun
 import { QueryBoundWitnessWrapper as QueryBoundWitnessWrapper3 } from "@xyo-network/boundwitness-wrapper";
 import { ConfigSchema } from "@xyo-network/config-payload-plugin";
 import { ModuleManifestPayloadSchema } from "@xyo-network/manifest-model";
-import { AddressPreviousHashSchema, duplicateModules, isModuleName, ModuleAddressQuerySchema, ModuleDescribeQuerySchema, ModuleDescriptionSchema, ModuleDiscoverQuerySchema, ModuleFactory, ModuleManifestQuerySchema, ModuleStateQuerySchema, ModuleSubscribeQuerySchema, serializableField } from "@xyo-network/module-model";
+import { AddressPreviousHashSchema, DeadModuleError, duplicateModules, isModuleName, ModuleAddressQuerySchema, ModuleDescribeQuerySchema, ModuleDescriptionSchema, ModuleDiscoverQuerySchema, ModuleFactory, ModuleManifestQuerySchema, ModuleStateQuerySchema, ModuleSubscribeQuerySchema, serializableField } from "@xyo-network/module-model";
 import { CompositeModuleResolver } from "@xyo-network/module-resolver";
 import { PayloadBuilder as PayloadBuilder2 } from "@xyo-network/payload-builder";
 import { QuerySchema } from "@xyo-network/query-payload-plugin";
@@ -72,7 +72,7 @@ var BaseEmitter = _BaseEmitter;
 import { assertEx } from "@xylabs/assert";
 import { Account } from "@xyo-network/account";
 var isDetermineAccountFromAccountParams = /* @__PURE__ */ __name((params) => {
-  assertEx(!params.accountPath, "accountPath may not be provided when account is provided");
+  assertEx(!params.accountPath, () => "accountPath may not be provided when account is provided");
   return !!params.account;
 }, "isDetermineAccountFromAccountParams");
 var isDetermineAccountFromWalletParams = /* @__PURE__ */ __name((params) => {
@@ -81,13 +81,13 @@ var isDetermineAccountFromWalletParams = /* @__PURE__ */ __name((params) => {
 async function determineAccount(params, allowRandomAccount = true) {
   if (isDetermineAccountFromAccountParams(params)) {
     if (params.account === "random") {
-      assertEx(allowRandomAccount, "Random address not allowed");
+      assertEx(allowRandomAccount, () => "Random address not allowed");
       return Account.randomSync();
     }
     return params.account;
   }
   if (isDetermineAccountFromWalletParams(params)) {
-    return assertEx(params.accountPath ? await params.wallet.derivePath(params.accountPath) : params.wallet, "Failed to derive account from path");
+    return assertEx(params.accountPath ? await params.wallet.derivePath(params.accountPath) : params.wallet, () => "Failed to derive account from path");
   }
   console.warn("AbstractModule.determineAccount: No account or wallet provided - Creating Random account");
   return Account.randomSync();
@@ -235,6 +235,7 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
     [ModuleStateQuerySchema]: "6",
     [ModuleSubscribeQuerySchema]: "3"
   };
+  _lastError;
   _queryAccounts = {
     [ModuleAddressQuerySchema]: void 0,
     [ModuleDescribeQuerySchema]: void 0,
@@ -248,8 +249,9 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
   moduleConfigQueryValidator;
   supportedQueryValidator;
   _busyCount = 0;
+  _status = "stopped";
   constructor(privateConstructorKey, params, account) {
-    assertEx2(_AbstractModule.privateConstructorKey === privateConstructorKey, "Use create function instead of constructor");
+    assertEx2(_AbstractModule.privateConstructorKey === privateConstructorKey, () => "Use create function instead of constructor");
     const mutatedParams = {
       ...params
     };
@@ -262,7 +264,7 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
     return this.configSchemas[0];
   }
   get account() {
-    return assertEx2(this._account, "Missing account");
+    return assertEx2(this._account, () => "Missing account");
   }
   get address() {
     return this.account.address;
@@ -274,6 +276,9 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
   get config() {
     return this.params.config;
   }
+  get dead() {
+    return this.status === "dead";
+  }
   get ephemeralQueryAccountEnabled() {
     return !!this.params.ephemeralQueryAccountEnabled;
   }
@@ -299,6 +304,9 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
   get queryAccounts() {
     return this._queryAccounts;
   }
+  get status() {
+    return this._status;
+  }
   get timestamp() {
     return this.config.timestamp ?? false;
   }
@@ -309,6 +317,11 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
     var _a;
     return ((_a = this.params) == null ? void 0 : _a.logger) ?? _AbstractModule.defaultLogger ?? Base2.defaultLogger;
   }
+  set status(value) {
+    if (this._status !== "dead") {
+      this._status = value;
+    }
+  }
   static _getRootFunction(funcName) {
     let anyThis = this;
     while (anyThis.__proto__[funcName]) {
@@ -319,24 +332,27 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
   static _noOverride(functionName) {
     const thisFunc = this[functionName];
     const rootFunc = this._getRootFunction(functionName);
-    assertEx2(thisFunc === rootFunc, `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
+    assertEx2(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
   }
   static async create(params) {
-    var _a, _b, _c, _d, _e, _f;
+    var _a, _b, _c, _d, _e;
     this._noOverride("create");
     if (!this.configSchemas || this.configSchemas.length === 0) {
       throw new Error(`Missing configSchema [${(_a = params == null ? void 0 : params.config) == null ? void 0 : _a.schema}][${this.name}]`);
     }
-    assertEx2(((_b = params == null ? void 0 : params.config) == null ? void 0 : _b.name) === void 0 || isModuleName(params.config.name), `Invalid module name: ${(_c = params == null ? void 0 : params.config) == null ? void 0 : _c.name}`);
+    assertEx2(((_b = params == null ? void 0 : params.config) == null ? void 0 : _b.name) === void 0 || isModuleName(params.config.name), () => {
+      var _a2;
+      return `Invalid module name: ${(_a2 = params == null ? void 0 : params.config) == null ? void 0 : _a2.name}`;
+    });
     const { account } = params ?? {};
-    const schema = ((_d = params == null ? void 0 : params.config) == null ? void 0 : _d.schema) ?? this.configSchema;
+    const schema = ((_c = params == null ? void 0 : params.config) == null ? void 0 : _c.schema) ?? this.configSchema;
     const allowedSchemas = this.configSchemas;
     assertEx2(allowedSchemas.includes(schema), () => `Bad Config Schema [Received ${schema}] [Expected ${JSON.stringify(allowedSchemas)}]`);
     const mutatedConfig = {
       ...params == null ? void 0 : params.config,
       schema
     };
-    (_e = params == null ? void 0 : params.logger) == null ? void 0 : _e.debug(`config: ${JSON.stringify(mutatedConfig, null, 2)}`);
+    (_d = params == null ? void 0 : params.logger) == null ? void 0 : _d.debug(`config: ${JSON.stringify(mutatedConfig, null, 2)}`);
     const mutatedParams = {
       ...params,
       config: mutatedConfig
@@ -349,7 +365,7 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
     mutatedParams.logger = activeLogger ? new IdLogger(activeLogger, () => `0x${address}`) : void 0;
     const newModule = new this(_AbstractModule.privateConstructorKey, mutatedParams, generatedAccount);
     if (!_AbstractModule.enableLazyLoad) {
-      await ((_f = newModule.start) == null ? void 0 : _f.call(newModule));
+      await ((_e = newModule.start) == null ? void 0 : _e.call(newModule));
     }
     return newModule;
   }
@@ -366,11 +382,6 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
     }
     return anyThis[funcName];
   }
-  _noOverride(functionName) {
-    const thisFunc = this[functionName];
-    const rootFunc = this._getRootFunction(functionName);
-    assertEx2(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
-  }
   async busy(closure) {
     if (this._busyCount <= 0) {
       this._busyCount = 0;
@@ -399,11 +410,13 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
     return super.emit(eventName, eventArgs);
   }
   previousHash() {
+    this._checkDead();
     return this.account.previousHash;
   }
   async query(query, payloads, queryConfig) {
+    this._checkDead();
     this._noOverride("query");
-    const sourceQuery = await PayloadBuilder2.build(assertEx2(QueryBoundWitnessWrapper3.unwrap(query), "Invalid query"));
+    const sourceQuery = await PayloadBuilder2.build(assertEx2(QueryBoundWitnessWrapper3.unwrap(query), () => "Invalid query"));
     return await this.busy(async () => {
       const resultPayloads = [];
       const errorPayloads = [];
@@ -413,9 +426,14 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
         if (!this.allowAnonymous && query.addresses.length === 0) {
           throw new Error(`Anonymous Queries not allowed, but running anyway [${this.config.name}], [${this.address}]`);
         }
+        if (queryConfig == null ? void 0 : queryConfig.allowedQueries) {
+          assertEx2(queryConfig == null ? void 0 : queryConfig.allowedQueries.includes(sourceQuery.schema), () => `Query not allowed [${sourceQuery.schema}]`);
+        }
         resultPayloads.push(...await this.queryHandler(sourceQuery, payloads, queryConfig));
       } catch (ex) {
         await handleErrorAsync(ex, async (error) => {
+          this._lastError = error;
+          this.status = "dead";
           errorPayloads.push(await new ModuleErrorBuilder().sources([
             sourceQuery.$hash
           ]).name(this.config.name ?? "<Unknown>").query(sourceQuery.schema).message(error.message).build());
@@ -442,6 +460,9 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
     });
   }
   async queryable(query, payloads, queryConfig) {
+    if (this.dead) {
+      return false;
+    }
     if (!await this.started("warn"))
       return false;
     const configValidator = queryConfig ? new ModuleConfigQueryValidator(Object.assign({}, this.config, queryConfig)).queryable : this.moduleConfigQueryValidator;
@@ -451,7 +472,7 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
     ];
     return validators.every((validator) => validator(query, payloads));
   }
-  async resolve(idOrFilter, { required = "log", ...options } = {}) {
+  async resolve(idOrFilter = "*", { required = "log", ...options } = {}) {
     const childOptions = {
       ...options,
       required: false
@@ -460,41 +481,44 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
     const up = direction === "up" || direction === "all";
     const down = direction === "down" || direction === "all";
     let result;
-    switch (typeof idOrFilter) {
-      case "string": {
-        result = (down ? await this.downResolver.resolve(idOrFilter, childOptions) : void 0) ?? (up ? await this.upResolver.resolve(idOrFilter, childOptions) : void 0);
-        break;
-      }
-      default: {
-        const filter = idOrFilter;
-        result = [
-          ...down ? await this.downResolver.resolve(filter, childOptions) : [],
-          ...up ? await this.upResolver.resolve(filter, childOptions) : []
-        ].filter(duplicateModules);
-        break;
+    if (idOrFilter === "*") {
+      if (this.dead) {
+        return [];
       }
-    }
-    if (required && (result === void 0 || Array.isArray(result) && result.length > 0)) {
-      switch (required) {
-        case "warn": {
-          this.logger.warn("resolve failed", idOrFilter);
-          break;
-        }
-        case "log": {
-          this.logger.log("resolve failed", idOrFilter);
+      return [
+        ...down ? await this.downResolver.resolve("*", childOptions) : [],
+        ...up ? await this.upResolver.resolve("*", childOptions) : []
+      ].filter(duplicateModules);
+    } else {
+      switch (typeof idOrFilter) {
+        case "string": {
+          if (this.dead) {
+            return void 0;
+          }
+          result = (down ? await this.downResolver.resolve(idOrFilter, childOptions) : void 0) ?? (up ? await this.upResolver.resolve(idOrFilter, childOptions) : void 0);
           break;
         }
         default: {
-          this.logger.error("resolve failed", idOrFilter);
+          if (this.dead) {
+            return [];
+          }
+          const filter = idOrFilter;
+          result = [
+            ...down ? await this.downResolver.resolve(filter, childOptions) : [],
+            ...up ? await this.upResolver.resolve(filter, childOptions) : []
+          ].filter(duplicateModules);
           break;
         }
       }
     }
+    this.validateRequiredResolve(required, result, idOrFilter);
     return result;
   }
   start(_timeout) {
     this._startPromise = this._startPromise ?? this.startHandler();
-    return this._startPromise;
+    const result = this._startPromise;
+    this.status = result ? "started" : "dead";
+    return result;
   }
   async started(notStartedAction = "log", tryStart = true) {
     const started = await this._started;
@@ -549,9 +573,20 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
       const result = await this.stopHandler();
       this._started = void 0;
       this._startPromise = void 0;
+      this.status = result ? "stopped" : "dead";
       return result;
     });
   }
+  _checkDead() {
+    if (this.dead) {
+      throw new DeadModuleError(this.id, this._lastError);
+    }
+  }
+  _noOverride(functionName) {
+    const thisFunc = this[functionName];
+    const rootFunc = this._getRootFunction(functionName);
+    assertEx2(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
+  }
   bindHashes(hashes, schema, account) {
     const promise = new PromiseEx((resolve) => {
       const result = this.bindHashesInternal(hashes, schema, account);
@@ -836,6 +871,24 @@ var _AbstractModule = class _AbstractModule extends BaseEmitter {
       }
     }, true);
   }
+  validateRequiredResolve(required, result, idOrFilter) {
+    if (required && (result === void 0 || Array.isArray(result) && result.length > 0)) {
+      switch (required) {
+        case "warn": {
+          this.logger.warn("resolve failed", idOrFilter);
+          break;
+        }
+        case "log": {
+          this.logger.log("resolve failed", idOrFilter);
+          break;
+        }
+        default: {
+          this.logger.error("resolve failed", idOrFilter);
+          break;
+        }
+      }
+    }
+  }
 };
 __name(_AbstractModule, "AbstractModule");
 __publicField(_AbstractModule, "allowRandomAccount", true);
@@ -849,7 +902,7 @@ var AbstractModule = _AbstractModule;
 import { assertEx as assertEx3 } from "@xylabs/assert";
 var _AbstractModuleInstance = class _AbstractModuleInstance extends AbstractModule {
   constructor(privateConstructorKey, params, account) {
-    assertEx3(AbstractModule.privateConstructorKey === privateConstructorKey, "Use create function instead of constructor");
+    assertEx3(AbstractModule.privateConstructorKey === privateConstructorKey, () => "Use create function instead of constructor");
     const mutatedParams = {
       ...params
     };
@@ -858,31 +911,37 @@ var _AbstractModuleInstance = class _AbstractModuleInstance extends AbstractModu
     this.downResolver.add(this);
   }
   describe() {
+    this._checkDead();
     return this.busy(async () => {
       return await this.describeHandler();
     });
   }
   discover() {
+    this._checkDead();
     return this.busy(async () => {
       return await this.discoverHandler();
     });
   }
   manifest(maxDepth, ignoreAddresses) {
+    this._checkDead();
     return this.busy(async () => {
       return await this.manifestHandler(maxDepth, ignoreAddresses);
     });
   }
   moduleAddress() {
+    this._checkDead();
     return this.busy(async () => {
       return await this.moduleAddressHandler();
     });
   }
   state() {
+    this._checkDead();
     return this.busy(async () => {
       return await this.stateHandler();
     });
   }
   subscribe(_queryAccount) {
+    this._checkDead();
     return this.subscribeHandler();
   }
 };