@xyo-network/module-abstract 2.75.0 → 2.75.1

package/dist/node/AbstractModule.mjs

@@ -1,32 +1,201 @@
 var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+
+// src/AbstractModule.ts
 import { assertEx } from "@xylabs/assert";
 import { exists } from "@xylabs/exists";
 import { compact } from "@xylabs/lodash";
 import { HDWallet } from "@xyo-network/account";
 import { AddressSchema } from "@xyo-network/address-payload-plugin";
 import { asArchivistInstance } from "@xyo-network/archivist-model";
-import { BoundWitnessBuilder, QueryBoundWitnessBuilder, QueryBoundWitnessWrapper } from "@xyo-network/boundwitness-builder";
+import { BoundWitnessBuilder, QueryBoundWitnessBuilder, QueryBoundWitnessWrapper as QueryBoundWitnessWrapper3 } from "@xyo-network/boundwitness-builder";
 import { ConfigSchema } from "@xyo-network/config-payload-plugin";
 import { PayloadHasher } from "@xyo-network/core";
 import { handleError, handleErrorAsync } from "@xyo-network/error";
 import { ModuleManifestPayloadSchema } from "@xyo-network/manifest-model";
 import { AddressPreviousHashSchema, duplicateModules, ModuleAddressQuerySchema, ModuleDescribeQuerySchema, ModuleDescriptionSchema, ModuleDiscoverQuerySchema, ModuleFactory, ModuleManifestQuerySchema, ModuleSubscribeQuerySchema, serializableField } from "@xyo-network/module-model";
 import { CompositeModuleResolver } from "@xyo-network/module-resolver";
-import { PayloadBuilder } from "@xyo-network/payload-builder";
+import { PayloadBuilder as PayloadBuilder2 } from "@xyo-network/payload-builder";
 import { PromiseEx } from "@xyo-network/promise";
 import { QuerySchema } from "@xyo-network/query-payload-plugin";
 import { IdLogger } from "@xyo-network/shared";
-import { BaseEmitter } from "./BaseEmitter";
-import { ModuleErrorBuilder } from "./Error";
-import { ModuleConfigQueryValidator, SupportedQueryValidator } from "./QueryValidator";
-class AbstractModule extends BaseEmitter {
-  static {
-    __name(this, "AbstractModule");
-  }
-  static configSchemas;
-  static enableLazyLoad = false;
-  static privateConstructorKey = Date.now().toString();
+
+// src/BaseEmitter.ts
+import { Base } from "@xyo-network/core";
+import { Events } from "@xyo-network/module-events";
+var _BaseEmitter = class _BaseEmitter extends Base {
+  //just here to query types
+  eventData = {};
+  events;
+  constructor(params) {
+    super(params);
+    this.events = new Events();
+  }
+  clearListeners(eventNames) {
+    return this.events.clearListeners(eventNames);
+  }
+  emit(eventName, eventArgs) {
+    return this.events.emit(eventName, eventArgs);
+  }
+  emitSerial(eventName, eventArgs) {
+    return this.events.emitSerial(eventName, eventArgs);
+  }
+  listenerCount(eventNames) {
+    return this.events.listenerCount(eventNames);
+  }
+  off(eventNames, listener) {
+    return this.events.off(eventNames, listener);
+  }
+  offAny(listener) {
+    return this.events.offAny(listener);
+  }
+  on(eventNames, listener) {
+    return this.events.on(eventNames, listener);
+  }
+  onAny(listener) {
+    return this.events.onAny(listener);
+  }
+  once(eventName, listener) {
+    return this.events.once(eventName, listener);
+  }
+};
+__name(_BaseEmitter, "BaseEmitter");
+var BaseEmitter = _BaseEmitter;
+
+// src/Error.ts
+import { PayloadBuilder } from "@xyo-network/payload-builder";
+import { ModuleErrorSchema } from "@xyo-network/payload-model";
+var _ModuleErrorBuilder = class _ModuleErrorBuilder extends PayloadBuilder {
+  _message;
+  _name;
+  _query;
+  _sources;
+  constructor() {
+    super({
+      schema: ModuleErrorSchema
+    });
+  }
+  build() {
+    return {
+      message: this._message,
+      name: this._name,
+      query: this._query,
+      schema: ModuleErrorSchema,
+      sources: this._sources
+    };
+  }
+  message(message) {
+    this._message = message;
+    return this;
+  }
+  name(name) {
+    this._name = name;
+    return this;
+  }
+  query(query) {
+    this._query = query;
+    return this;
+  }
+  sources(sources) {
+    this._sources = sources;
+    return this;
+  }
+};
+__name(_ModuleErrorBuilder, "ModuleErrorBuilder");
+var ModuleErrorBuilder = _ModuleErrorBuilder;
+
+// src/QueryValidator/ModuleConfigQueryValidator.ts
+import { QueryBoundWitnessWrapper } from "@xyo-network/boundwitness-builder";
+var delimiter = "";
+var _ModuleConfigQueryValidator = class _ModuleConfigQueryValidator {
+  allowed = {};
+  disallowed = {};
+  hasAllowedRules;
+  hasDisallowedRules;
+  hasRules;
+  constructor(config) {
+    var _a, _b, _c, _d;
+    if ((_a = config == null ? void 0 : config.security) == null ? void 0 : _a.allowed) {
+      Object.entries((_b = config.security) == null ? void 0 : _b.allowed).forEach(([schema, addresses]) => {
+        this.allowed[schema] = addresses.map(toAddressesString);
+      });
+    }
+    if ((_c = config == null ? void 0 : config.security) == null ? void 0 : _c.disallowed) {
+      Object.entries((_d = config.security) == null ? void 0 : _d.disallowed).forEach(([schema, addresses]) => {
+        this.disallowed[schema] = addresses.map(toAddressesString);
+      });
+    }
+    this.hasAllowedRules = Object.keys(this.allowed).length > 0;
+    this.hasDisallowedRules = Object.keys(this.disallowed).length > 0;
+    this.hasRules = this.hasAllowedRules || this.hasDisallowedRules;
+  }
+  queryable = async (query, payloads) => {
+    if (!this.hasRules)
+      return true;
+    const addresses = query.addresses;
+    if (!addresses.length)
+      return false;
+    const wrapper = QueryBoundWitnessWrapper.parseQuery(query, payloads);
+    const schema = (await wrapper.getQuery()).schema;
+    return this.queryAllowed(schema, addresses) && !this.queryDisallowed(schema, addresses);
+  };
+  queryAllowed = (schema, addresses) => {
+    var _a, _b;
+    if (!this.hasAllowedRules)
+      return true;
+    if (addresses.length > 1) {
+      const signatories = toAddressesString(addresses);
+      const validCosigners = (_b = (_a = this.allowed) == null ? void 0 : _a[schema]) == null ? void 0 : _b.includes(signatories);
+      if (validCosigners)
+        return true;
+    }
+    return addresses.every((address) => {
+      var _a2, _b2;
+      return ((_b2 = (_a2 = this.allowed) == null ? void 0 : _a2[schema]) == null ? void 0 : _b2.includes(address)) || false;
+    });
+  };
+  queryDisallowed = (schema, addresses) => {
+    if (!this.hasDisallowedRules)
+      return false;
+    return addresses.some((address) => {
+      var _a, _b;
+      return (_b = (_a = this.disallowed) == null ? void 0 : _a[schema]) == null ? void 0 : _b.includes(address);
+    });
+  };
+};
+__name(_ModuleConfigQueryValidator, "ModuleConfigQueryValidator");
+var ModuleConfigQueryValidator = _ModuleConfigQueryValidator;
+var toAddressesString = /* @__PURE__ */ __name((addresses) => {
+  return Array.isArray(addresses) ? addresses.sort().map((address) => address.toLowerCase()).join(delimiter) : addresses.toLowerCase();
+}, "toAddressesString");
+
+// src/QueryValidator/SupportedQueryValidator.ts
+import { QueryBoundWitnessWrapper as QueryBoundWitnessWrapper2 } from "@xyo-network/boundwitness-builder";
+var isQuerySupportedByModule = /* @__PURE__ */ __name(async (mod, query, payloads) => {
+  const wrapper = QueryBoundWitnessWrapper2.parseQuery(query, payloads);
+  const schema = (await wrapper.getQuery()).schema;
+  return mod.queries.includes(schema);
+}, "isQuerySupportedByModule");
+var _SupportedQueryValidator = class _SupportedQueryValidator {
+  mod;
+  constructor(mod) {
+    this.mod = mod;
+    this.queryable = (query, payloads) => {
+      return isQuerySupportedByModule(this.mod, query, payloads);
+    };
+  }
+  queryable;
+};
+__name(_SupportedQueryValidator, "SupportedQueryValidator");
+var SupportedQueryValidator = _SupportedQueryValidator;
+
+// src/AbstractModule.ts
+var _AbstractModule = class _AbstractModule extends BaseEmitter {
   downResolver = new CompositeModuleResolver();
   upResolver = new CompositeModuleResolver();
   _account = void 0;
@@ -50,14 +219,14 @@ class AbstractModule extends BaseEmitter {
   supportedQueryValidator;
   _busyCount = 0;
   constructor(privateConstructorKey, params, account) {
-    assertEx(AbstractModule.privateConstructorKey === privateConstructorKey, "Use create function instead of constructor");
+    assertEx(_AbstractModule.privateConstructorKey === privateConstructorKey, "Use create function instead of constructor");
     const mutatedParams = {
       ...params
     };
     super(mutatedParams);
     this._account = account;
     this.supportedQueryValidator = new SupportedQueryValidator(this).queryable;
-    this.moduleConfigQueryValidator = new ModuleConfigQueryValidator(mutatedParams?.config).queryable;
+    this.moduleConfigQueryValidator = new ModuleConfigQueryValidator(mutatedParams == null ? void 0 : mutatedParams.config).queryable;
   }
   static get configSchema() {
     return this.configSchemas[0];
@@ -69,7 +238,8 @@ class AbstractModule extends BaseEmitter {
     return this.account.address;
   }
   get allowAnonymous() {
-    return !!this.config.security?.allowAnonymous;
+    var _a;
+    return !!((_a = this.config.security) == null ? void 0 : _a.allowAnonymous);
   }
   get config() {
     return this.params.config;
@@ -111,36 +281,37 @@ class AbstractModule extends BaseEmitter {
     assertEx(thisFunc === rootFunc, `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
   }
   static async create(params) {
+    var _a, _b, _c, _d;
     this._noOverride("create");
     if (!this.configSchemas || this.configSchemas.length === 0) {
-      throw Error(`Missing configSchema [${params?.config?.schema}][${this.name}]`);
+      throw Error(`Missing configSchema [${(_a = params == null ? void 0 : params.config) == null ? void 0 : _a.schema}][${this.name}]`);
     }
     const { account, config, wallet } = params ?? {};
     const { accountDerivationPath } = config ?? {};
-    assertEx(!(!!account && !!wallet), `Specifying both {account} and {wallet} are not allowed [${config?.schema}] [${account === "random" ? "random" : account?.address}, ${wallet?.address}]`);
-    const schema = params?.config?.schema ?? this.configSchema;
+    assertEx(!(!!account && !!wallet), `Specifying both {account} and {wallet} are not allowed [${config == null ? void 0 : config.schema}] [${account === "random" ? "random" : account == null ? void 0 : account.address}, ${wallet == null ? void 0 : wallet.address}]`);
+    const schema = ((_b = params == null ? void 0 : params.config) == null ? void 0 : _b.schema) ?? this.configSchema;
     const allowedSchemas = this.configSchemas;
     assertEx(allowedSchemas.filter((allowedSchema) => allowedSchema === schema).length > 0, `Bad Config Schema [Received ${schema}] [Expected ${JSON.stringify(allowedSchemas)}]`);
     const mutatedConfig = {
-      ...params?.config,
+      ...params == null ? void 0 : params.config,
       schema
     };
-    params?.logger?.debug(`config: ${JSON.stringify(mutatedConfig, null, 2)}`);
+    (_c = params == null ? void 0 : params.logger) == null ? void 0 : _c.debug(`config: ${JSON.stringify(mutatedConfig, null, 2)}`);
     const mutatedParams = {
       ...params,
       config: mutatedConfig
     };
-    const activeLogger = params?.logger ?? AbstractModule.defaultLogger;
-    const generatedAccount = await AbstractModule.determineAccount({
+    const activeLogger = (params == null ? void 0 : params.logger) ?? _AbstractModule.defaultLogger;
+    const generatedAccount = await _AbstractModule.determineAccount({
       account,
       accountDerivationPath,
       wallet
     });
     const address = generatedAccount.address;
     mutatedParams.logger = activeLogger ? new IdLogger(activeLogger, () => `0x${address}`) : void 0;
-    const newModule = new this(AbstractModule.privateConstructorKey, mutatedParams, generatedAccount);
-    if (!AbstractModule.enableLazyLoad) {
-      await newModule.start?.();
+    const newModule = new this(_AbstractModule.privateConstructorKey, mutatedParams, generatedAccount);
+    if (!_AbstractModule.enableLazyLoad) {
+      await ((_d = newModule.start) == null ? void 0 : _d.call(newModule));
     }
     return newModule;
   }
@@ -214,7 +385,7 @@ class AbstractModule extends BaseEmitter {
             throw Error(`Anonymous Queries not allowed, but running anyway [${this.config.name}], [${this.address}]`);
           }
         }
-        resultPayloads.push(...await this.queryHandler(assertEx(QueryBoundWitnessWrapper.unwrap(query)), payloads, queryConfig));
+        resultPayloads.push(...await this.queryHandler(assertEx(QueryBoundWitnessWrapper3.unwrap(query)), payloads, queryConfig));
       } catch (ex) {
         await handleErrorAsync(ex, async (error) => {
           errorPayloads.push(new ModuleErrorBuilder().sources([
@@ -253,7 +424,7 @@ class AbstractModule extends BaseEmitter {
     return validators.every((validator) => validator(query, payloads));
   }
   async resolve(nameOrAddressOrFilter, options) {
-    const direction = options?.direction ?? "all";
+    const direction = (options == null ? void 0 : options.direction) ?? "all";
     const up = direction === "up" || direction === "all";
     const down = direction === "down" || direction === "all";
     switch (typeof nameOrAddressOrFilter) {
@@ -280,13 +451,15 @@ class AbstractModule extends BaseEmitter {
     }
     if (!started) {
       this._started = (async () => {
+        var _a, _b, _c;
         if (tryStart) {
           try {
             await this.start();
             return true;
           } catch (ex) {
             handleError(ex, (error) => {
-              this.logger?.warn(`Autostart of Module Failed: ${error.message})`);
+              var _a2;
+              (_a2 = this.logger) == null ? void 0 : _a2.warn(`Autostart of Module Failed: ${error.message})`);
               this._started = void 0;
             });
           }
@@ -295,16 +468,16 @@ class AbstractModule extends BaseEmitter {
           case "throw":
             throw Error(`Module not Started [${this.address}]`);
           case "warn":
-            this.logger?.warn("Module not started");
+            (_a = this.logger) == null ? void 0 : _a.warn("Module not started");
             break;
           case "error":
-            this.logger?.error("Module not started");
+            (_b = this.logger) == null ? void 0 : _b.error("Module not started");
             break;
           case "none":
             break;
           case "log":
           default: {
-            this.logger?.log("Module not started");
+            (_c = this.logger) == null ? void 0 : _c.log("Module not started");
             break;
           }
         }
@@ -327,21 +500,22 @@ class AbstractModule extends BaseEmitter {
   bindHashes(hashes, schema, account) {
     const promise = new PromiseEx((resolve) => {
       const result = this.bindHashesInternal(hashes, schema, account);
-      resolve?.(result);
+      resolve == null ? void 0 : resolve(result);
       return result;
     }, account);
     return promise;
   }
   async bindHashesInternal(hashes, schema, account) {
+    var _a;
     const builder = new BoundWitnessBuilder().hashes(hashes, schema).witness(this.account);
     const result = (await (account ? builder.witness(account) : builder).build())[0];
-    this.logger?.debug(`result: ${JSON.stringify(result, null, 2)}`);
+    (_a = this.logger) == null ? void 0 : _a.debug(`result: ${JSON.stringify(result, null, 2)}`);
     return result;
   }
   bindQuery(query, payloads, account) {
     const promise = new PromiseEx(async (resolve) => {
       const result = await this.bindQueryInternal(query, payloads, account);
-      resolve?.(result);
+      resolve == null ? void 0 : resolve(result);
       return result;
     }, account);
     return promise;
@@ -369,31 +543,33 @@ class AbstractModule extends BaseEmitter {
   }
   commitArchivist = () => this.getArchivist("commit");
   async describeHandler() {
+    var _a;
     const description = {
       address: this.address,
       queries: this.queries,
       schema: ModuleDescriptionSchema
     };
-    if (this.config?.name) {
+    if ((_a = this.config) == null ? void 0 : _a.name) {
       description.name = this.config.name;
     }
     const discover = await this.discoverHandler();
-    description.children = compact(discover?.map((payload) => {
+    description.children = compact((discover == null ? void 0 : discover.map((payload) => {
       const address = payload.schema === AddressSchema ? payload.address : void 0;
       return address != this.address ? address : void 0;
-    }) ?? []);
+    })) ?? []);
     return description;
   }
   discoverHandler() {
+    var _a;
     const config = this.config;
-    const address = new PayloadBuilder({
+    const address = new PayloadBuilder2({
       schema: AddressSchema
     }).fields({
       address: this.address,
-      name: this.config?.name
+      name: (_a = this.config) == null ? void 0 : _a.name
     }).build();
     const queries = this.queries.map((query) => {
-      return new PayloadBuilder({
+      return new PayloadBuilder2({
         schema: QuerySchema
       }).fields({
         query
@@ -411,24 +587,26 @@ class AbstractModule extends BaseEmitter {
     ]);
   }
   async getArchivist(kind) {
+    var _a, _b;
     if (!this.config.archivist)
       return void 0;
-    const filter = typeof this.config.archivist === "string" || this.config.archivist instanceof String ? this.config.archivist : this.config?.archivist?.[kind];
+    const filter = typeof this.config.archivist === "string" || this.config.archivist instanceof String ? this.config.archivist : (_b = (_a = this.config) == null ? void 0 : _a.archivist) == null ? void 0 : _b[kind];
     const resolved = await this.upResolver.resolve(filter);
     return asArchivistInstance(resolved);
   }
   async initializeQueryAccounts() {
+    var _a, _b;
     const paths = Object.values(this.queryAccountPaths).filter(exists);
     const distinctPaths = new Set(paths);
-    assertEx(distinctPaths.size === paths.length, `${this.config?.name ? this.config.name + ": " : ""}Duplicate query account paths`);
+    assertEx(distinctPaths.size === paths.length, `${((_a = this.config) == null ? void 0 : _a.name) ? this.config.name + ": " : ""}Duplicate query account paths`);
     const wallet = this.account;
-    if (wallet?.derivePath) {
+    if (wallet == null ? void 0 : wallet.derivePath) {
       for (const key in this.queryAccountPaths) {
         if (Object.prototype.hasOwnProperty.call(this.queryAccountPaths, key)) {
           const query = key;
           const queryAccountPath = this.queryAccountPaths[query];
           if (queryAccountPath) {
-            this._queryAccounts[query] = await wallet.derivePath?.(queryAccountPath);
+            this._queryAccounts[query] = await ((_b = wallet.derivePath) == null ? void 0 : _b.call(wallet, queryAccountPath));
           }
         }
       }
@@ -490,7 +668,7 @@ class AbstractModule extends BaseEmitter {
   }
   async queryHandler(query, payloads, queryConfig) {
     await this.started("throw");
-    const wrapper = QueryBoundWitnessWrapper.parseQuery(query, payloads);
+    const wrapper = QueryBoundWitnessWrapper3.parseQuery(query, payloads);
     const queryPayload = await wrapper.getQuery();
     assertEx(this.queryable(query, payloads, queryConfig));
     const resultPayloads = [];
@@ -536,9 +714,10 @@ class AbstractModule extends BaseEmitter {
   }
   validateConfig(config, parents = []) {
     return Object.entries(config ?? this.config ?? {}).reduce((valid, [key, value]) => {
+      var _a, _b;
       switch (typeof value) {
         case "function":
-          this.logger?.warn(`Fields of type function not allowed in config [${parents?.join(".")}.${key}]`);
+          (_a = this.logger) == null ? void 0 : _a.warn(`Fields of type function not allowed in config [${parents == null ? void 0 : parents.join(".")}.${key}]`);
           return false;
         case "object": {
           if (Array.isArray(value)) {
@@ -550,7 +729,7 @@ class AbstractModule extends BaseEmitter {
             }, true) && valid;
           }
           if (!serializableField(value)) {
-            this.logger?.warn(`Fields that are not serializable to JSON are not allowed in config [${parents?.join(".")}.${key}]`);
+            (_b = this.logger) == null ? void 0 : _b.warn(`Fields that are not serializable to JSON are not allowed in config [${parents == null ? void 0 : parents.join(".")}.${key}]`);
             return false;
           }
           return value ? this.validateConfig(value, [
@@ -564,7 +743,12 @@ class AbstractModule extends BaseEmitter {
     }, true);
   }
   writeArchivist = () => this.getArchivist("write");
-}
+};
+__name(_AbstractModule, "AbstractModule");
+__publicField(_AbstractModule, "configSchemas");
+__publicField(_AbstractModule, "enableLazyLoad", false);
+__publicField(_AbstractModule, "privateConstructorKey", Date.now().toString());
+var AbstractModule = _AbstractModule;
 export {
   AbstractModule
 };