@xyo-network/module-abstract 2.92.6 → 2.92.8

package/dist/browser/index.cjs

@@ -98,7 +98,7 @@ var BaseEmitter = class extends import_object.Base {
 var import_assert = require("@xylabs/assert");
 var import_account = require("@xyo-network/account");
 var isDetermineAccountFromAccountParams = /* @__PURE__ */ __name((params) => {
-  (0, import_assert.assertEx)(!params.accountPath, "accountPath may not be provided when account is provided");
+  (0, import_assert.assertEx)(!params.accountPath, () => "accountPath may not be provided when account is provided");
   return !!params.account;
 }, "isDetermineAccountFromAccountParams");
 var isDetermineAccountFromWalletParams = /* @__PURE__ */ __name((params) => {
@@ -107,13 +107,13 @@ var isDetermineAccountFromWalletParams = /* @__PURE__ */ __name((params) => {
 async function determineAccount(params, allowRandomAccount = true) {
   if (isDetermineAccountFromAccountParams(params)) {
     if (params.account === "random") {
-      (0, import_assert.assertEx)(allowRandomAccount, "Random address not allowed");
+      (0, import_assert.assertEx)(allowRandomAccount, () => "Random address not allowed");
       return import_account.Account.randomSync();
     }
     return params.account;
   }
   if (isDetermineAccountFromWalletParams(params)) {
-    return (0, import_assert.assertEx)(params.accountPath ? await params.wallet.derivePath(params.accountPath) : params.wallet, "Failed to derive account from path");
+    return (0, import_assert.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 import_account.Account.randomSync();
@@ -264,6 +264,7 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
     [import_module_model.ModuleStateQuerySchema]: "6",
     [import_module_model.ModuleSubscribeQuerySchema]: "3"
   };
+  _lastError;
   _queryAccounts = {
     [import_module_model.ModuleAddressQuerySchema]: void 0,
     [import_module_model.ModuleDescribeQuerySchema]: void 0,
@@ -277,8 +278,9 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
   moduleConfigQueryValidator;
   supportedQueryValidator;
   _busyCount = 0;
+  _status = "stopped";
   constructor(privateConstructorKey, params, account) {
-    (0, import_assert2.assertEx)(_AbstractModule.privateConstructorKey === privateConstructorKey, "Use create function instead of constructor");
+    (0, import_assert2.assertEx)(_AbstractModule.privateConstructorKey === privateConstructorKey, () => "Use create function instead of constructor");
     const mutatedParams = {
       ...params
     };
@@ -291,7 +293,7 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
     return this.configSchemas[0];
   }
   get account() {
-    return (0, import_assert2.assertEx)(this._account, "Missing account");
+    return (0, import_assert2.assertEx)(this._account, () => "Missing account");
   }
   get address() {
     return this.account.address;
@@ -302,6 +304,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;
   }
@@ -327,6 +332,9 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
   get queryAccounts() {
     return this._queryAccounts;
   }
+  get status() {
+    return this._status;
+  }
   get timestamp() {
     return this.config.timestamp ?? false;
   }
@@ -336,6 +344,11 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
   get logger() {
     return this.params?.logger ?? _AbstractModule.defaultLogger ?? import_object2.Base.defaultLogger;
   }
+  set status(value) {
+    if (this._status !== "dead") {
+      this._status = value;
+    }
+  }
   static _getRootFunction(funcName) {
     let anyThis = this;
     while (anyThis.__proto__[funcName]) {
@@ -346,14 +359,14 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
   static _noOverride(functionName) {
     const thisFunc = this[functionName];
     const rootFunc = this._getRootFunction(functionName);
-    (0, import_assert2.assertEx)(thisFunc === rootFunc, `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
+    (0, import_assert2.assertEx)(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
   }
   static async create(params) {
     this._noOverride("create");
     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_model.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;
@@ -392,11 +405,6 @@ var AbstractModule = class _AbstractModule extends BaseEmitter {
     }
     return anyThis[funcName];
   }
-  _noOverride(functionName) {
-    const thisFunc = this[functionName];
-    const rootFunc = this._getRootFunction(functionName);
-    (0, import_assert2.assertEx)(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
-  }
   async busy(closure) {
     if (this._busyCount <= 0) {
       this._busyCount = 0;
@@ -425,11 +433,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 import_payload_builder2.PayloadBuilder.build((0, import_assert2.assertEx)(import_boundwitness_wrapper3.QueryBoundWitnessWrapper.unwrap(query), "Invalid query"));
+    const sourceQuery = await import_payload_builder2.PayloadBuilder.build((0, import_assert2.assertEx)(import_boundwitness_wrapper3.QueryBoundWitnessWrapper.unwrap(query), () => "Invalid query"));
     return await this.busy(async () => {
       const resultPayloads = [];
       const errorPayloads = [];
@@ -439,9 +449,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?.allowedQueries) {
+          (0, import_assert2.assertEx)(queryConfig?.allowedQueries.includes(sourceQuery.schema), () => `Query not allowed [${sourceQuery.schema}]`);
+        }
         resultPayloads.push(...await this.queryHandler(sourceQuery, payloads, queryConfig));
       } catch (ex) {
         await (0, import_error.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());
@@ -468,6 +483,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;
@@ -477,7 +495,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
@@ -486,41 +504,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;
+    if (idOrFilter === "*") {
+      if (this.dead) {
+        return [];
       }
-      default: {
-        const filter = idOrFilter;
-        result = [
-          ...down ? await this.downResolver.resolve(filter, childOptions) : [],
-          ...up ? await this.upResolver.resolve(filter, childOptions) : []
-        ].filter(import_module_model.duplicateModules);
-        break;
-      }
-    }
-    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(import_module_model.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(import_module_model.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;
@@ -573,9 +594,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 import_module_model.DeadModuleError(this.id, this._lastError);
+    }
+  }
+  _noOverride(functionName) {
+    const thisFunc = this[functionName];
+    const rootFunc = this._getRootFunction(functionName);
+    (0, import_assert2.assertEx)(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
+  }
   bindHashes(hashes, schema, account) {
     const promise = new import_promise.PromiseEx((resolve) => {
       const result = this.bindHashesInternal(hashes, schema, account);
@@ -849,6 +881,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;
+        }
+      }
+    }
+  }
 };
 
 // src/AbstractModuleInstance.ts
@@ -858,7 +908,7 @@ var AbstractModuleInstance = class extends AbstractModule {
     __name(this, "AbstractModuleInstance");
   }
   constructor(privateConstructorKey, params, account) {
-    (0, import_assert3.assertEx)(AbstractModule.privateConstructorKey === privateConstructorKey, "Use create function instead of constructor");
+    (0, import_assert3.assertEx)(AbstractModule.privateConstructorKey === privateConstructorKey, () => "Use create function instead of constructor");
     const mutatedParams = {
       ...params
     };
@@ -867,31 +917,37 @@ var AbstractModuleInstance = class extends AbstractModule {
     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();
   }
 };