@xyo-network/module-abstract 2.74.4 → 2.75.0

package/dist/node/AbstractModule.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/AbstractModule.ts"],"sourcesContent":["/* eslint-disable max-lines */\nimport { assertEx } from '@xylabs/assert'\nimport { exists } from '@xylabs/exists'\nimport { compact } from '@xylabs/lodash'\nimport { HDWallet } from '@xyo-network/account'\nimport { AccountInstance } from '@xyo-network/account-model'\nimport { AddressPayload, AddressSchema } from '@xyo-network/address-payload-plugin'\nimport { ArchivistInstance, asArchivistInstance } from '@xyo-network/archivist-model'\nimport { BoundWitnessBuilder, QueryBoundWitness, QueryBoundWitnessBuilder, QueryBoundWitnessWrapper } from '@xyo-network/boundwitness-builder'\nimport { BoundWitness } from '@xyo-network/boundwitness-model'\nimport { ConfigPayload, ConfigSchema } from '@xyo-network/config-payload-plugin'\nimport { PayloadHasher } from '@xyo-network/core'\nimport { handleError, handleErrorAsync } from '@xyo-network/error'\nimport { ModuleManifestPayload, ModuleManifestPayloadSchema } from '@xyo-network/manifest-model'\nimport {\n  AddressPreviousHashPayload,\n  AddressPreviousHashSchema,\n  CreatableModule,\n  CreatableModuleFactory,\n  duplicateModules,\n  IndividualArchivistConfig,\n  Module,\n  ModuleAddressQuerySchema,\n  ModuleBusyEventArgs,\n  ModuleConfig,\n  ModuleDescribeQuerySchema,\n  ModuleDescriptionPayload,\n  ModuleDescriptionSchema,\n  ModuleDiscoverQuerySchema,\n  ModuleEventData,\n  ModuleFactory,\n  ModuleFilter,\n  ModuleFilterOptions,\n  ModuleInstance,\n  ModuleManifestQuerySchema,\n  ModuleParams,\n  ModuleQueriedEventArgs,\n  ModuleQuery,\n  ModuleQueryBase,\n  ModuleQueryHandlerResult,\n  ModuleQueryResult,\n  ModuleSubscribeQuerySchema,\n  SchemaString,\n  serializableField,\n} from '@xyo-network/module-model'\nimport { CompositeModuleResolver } from '@xyo-network/module-resolver'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport { ModuleError, Payload, Query } from '@xyo-network/payload-model'\nimport { Promisable, PromiseEx } from '@xyo-network/promise'\nimport { QueryPayload, QuerySchema } from '@xyo-network/query-payload-plugin'\nimport { IdLogger } from '@xyo-network/shared'\nimport { WalletInstance } from '@xyo-network/wallet-model'\n\nimport { BaseEmitter } from './BaseEmitter'\nimport { ModuleErrorBuilder } from './Error'\nimport { ModuleConfigQueryValidator, Queryable, SupportedQueryValidator } from './QueryValidator'\n\nexport abstract class AbstractModule<TParams extends ModuleParams = ModuleParams, TEventData extends ModuleEventData = ModuleEventData>\n  extends BaseEmitter<TParams, TEventData>\n  implements Module<TParams, TEventData>\n{\n  static configSchemas: string[]\n  static enableLazyLoad = false\n\n  protected static privateConstructorKey = Date.now().toString()\n\n  readonly downResolver: Omit<CompositeModuleResolver, 'resolve'> = new CompositeModuleResolver()\n  readonly upResolver: Omit<CompositeModuleResolver, 'resolve>'> = new CompositeModuleResolver()\n\n  protected _account: AccountInstance | undefined = undefined\n  protected readonly _baseModuleQueryAccountPaths: Record<ModuleQueryBase['schema'], string> = {\n    [ModuleAddressQuerySchema]: '1',\n    [ModuleDescribeQuerySchema]: '4',\n    [ModuleDiscoverQuerySchema]: '2',\n    [ModuleManifestQuerySchema]: '5',\n    [ModuleSubscribeQuerySchema]: '3',\n  }\n  protected readonly _queryAccounts: Record<ModuleQueryBase['schema'], AccountInstance | undefined> = {\n    [ModuleAddressQuerySchema]: undefined,\n    [ModuleDescribeQuerySchema]: undefined,\n    [ModuleDiscoverQuerySchema]: undefined,\n    [ModuleManifestQuerySchema]: undefined,\n    [ModuleSubscribeQuerySchema]: undefined,\n  }\n  protected _startPromise: Promisable<boolean> | undefined = undefined\n  protected _started: Promisable<boolean> | undefined = undefined\n  protected readonly moduleConfigQueryValidator: Queryable\n  protected readonly supportedQueryValidator: Queryable\n\n  private _busyCount = 0\n\n  constructor(privateConstructorKey: string, params: TParams, account: AccountInstance) {\n    assertEx(AbstractModule.privateConstructorKey === privateConstructorKey, 'Use create function instead of constructor')\n    // Clone params to prevent mutation of the incoming object\n    const mutatedParams = { ...params } as TParams\n    super(mutatedParams)\n\n    this._account = account\n\n    this.supportedQueryValidator = new SupportedQueryValidator(this as Module).queryable\n    this.moduleConfigQueryValidator = new ModuleConfigQueryValidator(mutatedParams?.config).queryable\n  }\n\n  static get configSchema(): string {\n    return this.configSchemas[0]\n  }\n\n  get account() {\n    return assertEx(this._account, 'Missing account')\n  }\n\n  get address() {\n    return this.account.address\n  }\n\n  get allowAnonymous() {\n    return !!this.config.security?.allowAnonymous\n  }\n\n  get config(): TParams['config'] {\n    return this.params.config\n  }\n\n  get ephemeralQueryAccountEnabled(): boolean {\n    return !!this.params.ephemeralQueryAccountEnabled\n  }\n\n  get queries(): string[] {\n    return [ModuleDiscoverQuerySchema, ModuleAddressQuerySchema, ModuleSubscribeQuerySchema, ModuleDescribeQuerySchema, ModuleManifestQuerySchema]\n  }\n\n  get queryAccountPaths(): Readonly<Record<Query['schema'], string | undefined>> {\n    return { ...this._baseModuleQueryAccountPaths, ...this._queryAccountPaths }\n  }\n\n  get queryAccounts(): Readonly<Record<Query['schema'], AccountInstance | undefined>> {\n    return this._queryAccounts\n  }\n\n  get timestamp() {\n    return this.config.timestamp ?? false\n  }\n\n  protected abstract get _queryAccountPaths(): Record<Query['schema'], string>\n\n  static _getRootFunction(funcName: string) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    let anyThis = this as any\n    while (anyThis.__proto__[funcName]) {\n      anyThis = anyThis.__proto__\n    }\n    return anyThis[funcName]\n  }\n\n  static _noOverride(functionName: string) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const thisFunc = (this as any)[functionName]\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const rootFunc = this._getRootFunction(functionName)\n    assertEx(thisFunc === rootFunc, `Override not allowed for [${functionName}] - override ${functionName}Handler instead`)\n  }\n\n  static async create<TModule extends ModuleInstance>(\n    this: CreatableModule<TModule>,\n    params?: Omit<TModule['params'], 'config'> & { config?: TModule['params']['config'] },\n  ) {\n    this._noOverride('create')\n    if (!this.configSchemas || this.configSchemas.length === 0) {\n      throw Error(`Missing configSchema [${params?.config?.schema}][${this.name}]`)\n    }\n\n    const { account, config, wallet } = params ?? {}\n    const { accountDerivationPath } = config ?? {}\n\n    assertEx(\n      !(!!account && !!wallet),\n      `Specifying both {account} and {wallet} are not allowed [${config?.schema}] [${\n        account === 'random' ? 'random' : account?.address\n      }, ${wallet?.address}]`,\n    )\n\n    const schema: string = params?.config?.schema ?? this.configSchema\n    const allowedSchemas: string[] = this.configSchemas\n\n    assertEx(\n      allowedSchemas.filter((allowedSchema) => allowedSchema === schema).length > 0,\n      `Bad Config Schema [Received ${schema}] [Expected ${JSON.stringify(allowedSchemas)}]`,\n    )\n    const mutatedConfig: TModule['params']['config'] = { ...params?.config, schema } as TModule['params']['config']\n    params?.logger?.debug(`config: ${JSON.stringify(mutatedConfig, null, 2)}`)\n    const mutatedParams: TModule['params'] = { ...params, config: mutatedConfig } as TModule['params']\n\n    const activeLogger = params?.logger ?? AbstractModule.defaultLogger\n    const generatedAccount = await AbstractModule.determineAccount({ account, accountDerivationPath, wallet })\n    const address = generatedAccount.address\n    mutatedParams.logger = activeLogger ? new IdLogger(activeLogger, () => `0x${address}`) : undefined\n\n    const newModule = new this(AbstractModule.privateConstructorKey, mutatedParams, generatedAccount)\n\n    if (!AbstractModule.enableLazyLoad) {\n      await newModule.start?.()\n    }\n    return newModule\n  }\n\n  static async determineAccount({\n    account,\n    accountDerivationPath,\n    wallet,\n  }: {\n    account?: AccountInstance | 'random'\n    accountDerivationPath?: string\n    wallet?: WalletInstance\n  }): Promise<AccountInstance> {\n    if (wallet) {\n      return assertEx(accountDerivationPath ? await wallet.derivePath(accountDerivationPath) : wallet, 'Failed to derive account from path')\n    } else if (account === 'random') {\n      return await HDWallet.random()\n    } else if (account) {\n      return account\n    } else {\n      //this should eventually be removed/thrown\n      console.warn('AbstractModule.determineAccount: No account provided - Creating Random account')\n      return await HDWallet.random()\n    }\n  }\n\n  static factory<TModule extends ModuleInstance>(\n    this: CreatableModule<TModule>,\n    params?: Omit<TModule['params'], 'config'> & { config?: TModule['params']['config'] },\n  ): CreatableModuleFactory<TModule> {\n    return ModuleFactory.withParams(this, params)\n  }\n\n  _getRootFunction(funcName: string) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    let anyThis = this as any\n    while (anyThis.__proto__[funcName]) {\n      anyThis = anyThis.__proto__\n    }\n    return anyThis[funcName]\n  }\n\n  _noOverride(functionName: string) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const thisFunc = (this as any)[functionName]\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const rootFunc = this._getRootFunction(functionName)\n    assertEx(thisFunc === rootFunc, `Override not allowed for [${functionName}] - override ${functionName}Handler instead`)\n  }\n\n  async busy<R>(closure: () => Promise<R>) {\n    if (this._busyCount <= 0) {\n      this._busyCount = 0\n      const args: ModuleBusyEventArgs = { busy: true, module: this }\n      await this.emit('moduleBusy', args)\n    }\n    this._busyCount++\n    try {\n      return await closure()\n    } finally {\n      this._busyCount--\n      if (this._busyCount <= 0) {\n        this._busyCount = 0\n        const args: ModuleBusyEventArgs = { busy: false, module: this }\n        await this.emit('moduleBusy', args)\n      }\n    }\n  }\n\n  override emit<TEventName extends keyof TEventData = keyof TEventData, TEventArgs extends TEventData[TEventName] = TEventData[TEventName]>(\n    eventName: TEventName,\n    eventArgs: TEventArgs,\n  ) {\n    return super.emit(eventName, eventArgs)\n  }\n\n  previousHash(): Promisable<string | undefined> {\n    return this.account.previousHash\n  }\n\n  async query<T extends QueryBoundWitness = QueryBoundWitness, TConfig extends ModuleConfig = ModuleConfig>(\n    query: T,\n    payloads?: Payload[],\n    queryConfig?: TConfig,\n  ): Promise<ModuleQueryResult> {\n    this._noOverride('query')\n    return await this.busy(async () => {\n      const resultPayloads: Payload[] = []\n      const errorPayloads: ModuleError[] = []\n      const queryAccount = this.ephemeralQueryAccountEnabled ? await HDWallet.random() : undefined\n      try {\n        await this.started('throw')\n        if (!this.allowAnonymous) {\n          if (query.addresses.length === 0) {\n            throw Error(`Anonymous Queries not allowed, but running anyway [${this.config.name}], [${this.address}]`)\n          }\n        }\n        resultPayloads.push(...(await this.queryHandler(assertEx(QueryBoundWitnessWrapper.unwrap(query)), payloads, queryConfig)))\n      } catch (ex) {\n        await handleErrorAsync(ex, async (error) => {\n          errorPayloads.push(\n            new ModuleErrorBuilder()\n              .sources([await PayloadHasher.hashAsync(query)])\n              .name(this.config.name ?? '<Unknown>')\n              .query(query.schema)\n              .message(error.message)\n              .build(),\n          )\n        })\n      }\n      if (this.timestamp) {\n        const timestamp = { schema: 'network.xyo.timestamp', timestamp: Date.now() }\n        resultPayloads.push(timestamp)\n      }\n      const result = await this.bindQueryResult(query, resultPayloads, queryAccount ? [queryAccount] : [], errorPayloads)\n      const args: ModuleQueriedEventArgs = { module: this, payloads, query, result }\n      await this.emit('moduleQueried', args)\n      return result\n    })\n  }\n\n  queryable<T extends QueryBoundWitness = QueryBoundWitness, TConfig extends ModuleConfig = ModuleConfig>(\n    query: T,\n    payloads?: Payload[],\n    queryConfig?: TConfig,\n  ): boolean {\n    if (!this.started('warn')) return false\n    const configValidator = queryConfig\n      ? new ModuleConfigQueryValidator(Object.assign({}, this.config, queryConfig)).queryable\n      : this.moduleConfigQueryValidator\n    const validators = [this.supportedQueryValidator, configValidator]\n\n    return validators.every((validator) => validator(query, payloads))\n  }\n\n  async resolve<T extends ModuleInstance = ModuleInstance>(filter?: ModuleFilter, options?: ModuleFilterOptions<T>): Promise<T[]>\n  async resolve<T extends ModuleInstance = ModuleInstance>(nameOrAddress: string, options?: ModuleFilterOptions<T>): Promise<T | undefined>\n  async resolve<T extends ModuleInstance = ModuleInstance>(\n    nameOrAddressOrFilter?: ModuleFilter<T> | string,\n    options?: ModuleFilterOptions<T>,\n  ): Promise<T | T[] | undefined> {\n    const direction = options?.direction ?? 'all'\n    const up = direction === 'up' || direction === 'all'\n    const down = direction === 'down' || direction === 'all'\n    switch (typeof nameOrAddressOrFilter) {\n      case 'string': {\n        return (\n          (down ? await (this.downResolver as CompositeModuleResolver).resolve<T>(nameOrAddressOrFilter, options) : undefined) ??\n          (up ? await (this.upResolver as CompositeModuleResolver).resolve<T>(nameOrAddressOrFilter, options) : undefined)\n        )\n      }\n      default: {\n        const filter: ModuleFilter<T> | undefined = nameOrAddressOrFilter\n        return [\n          ...(down ? await (this.downResolver as CompositeModuleResolver).resolve<T>(filter, options) : []),\n          ...(up ? await (this.upResolver as CompositeModuleResolver).resolve<T>(filter, options) : []),\n        ].filter(duplicateModules)\n      }\n    }\n  }\n\n  start(_timeout?: number): Promisable<boolean> {\n    //using promise as mutex\n    this._startPromise = this._startPromise ?? this.startHandler()\n    return this._startPromise\n  }\n\n  async started(notStartedAction: 'error' | 'throw' | 'warn' | 'log' | 'none' = 'log', tryStart = true): Promise<boolean> {\n    const started = await this._started\n    if (started === true) {\n      return true\n    }\n    if (!started) {\n      //using promise as mutex\n      this._started = (async () => {\n        if (tryStart) {\n          try {\n            await this.start()\n            return true\n          } catch (ex) {\n            handleError(ex, (error) => {\n              this.logger?.warn(`Autostart of Module Failed: ${error.message})`)\n              this._started = undefined\n            })\n          }\n        }\n        switch (notStartedAction) {\n          case 'throw':\n            throw Error(`Module not Started [${this.address}]`)\n          case 'warn':\n            this.logger?.warn('Module not started')\n            break\n          case 'error':\n            this.logger?.error('Module not started')\n            break\n          case 'none':\n            break\n          case 'log':\n          default: {\n            this.logger?.log('Module not started')\n            break\n          }\n        }\n        return false\n      })()\n    }\n    if (!this._started) {\n      throw 'Failed to create start promise'\n    }\n    return await this._started\n  }\n\n  async stop(_timeout?: number): Promise<boolean> {\n    return await this.busy(async () => {\n      const result = await this.stopHandler()\n      this._started = undefined\n      this._startPromise = undefined\n      return result\n    })\n  }\n\n  protected bindHashes(hashes: string[], schema: SchemaString[], account?: AccountInstance) {\n    const promise = new PromiseEx((resolve) => {\n      const result = this.bindHashesInternal(hashes, schema, account)\n      resolve?.(result)\n      return result\n    }, account)\n    return promise\n  }\n\n  protected async bindHashesInternal(hashes: string[], schema: SchemaString[], account?: AccountInstance): Promise<BoundWitness> {\n    const builder = new BoundWitnessBuilder().hashes(hashes, schema).witness(this.account)\n    const result = (await (account ? builder.witness(account) : builder).build())[0]\n    this.logger?.debug(`result: ${JSON.stringify(result, null, 2)}`)\n    return result\n  }\n\n  protected bindQuery<T extends Query>(\n    query: T,\n    payloads?: Payload[],\n    account?: AccountInstance,\n  ): PromiseEx<[QueryBoundWitness, Payload[], Payload[]], AccountInstance> {\n    const promise = new PromiseEx<[QueryBoundWitness, Payload[], Payload[]], AccountInstance>(async (resolve) => {\n      const result = await this.bindQueryInternal(query, payloads, account)\n      resolve?.(result)\n      return result\n    }, account)\n    return promise\n  }\n\n  protected async bindQueryInternal<T extends Query>(\n    query: T,\n    payloads?: Payload[],\n    account?: AccountInstance,\n  ): Promise<[QueryBoundWitness, Payload[], Payload[]]> {\n    const builder = new QueryBoundWitnessBuilder().payloads(payloads).witness(this.account).query(query)\n    const result = await (account ? builder.witness(account) : builder).build()\n    return result\n  }\n\n  protected async bindQueryResult<T extends Query>(\n    query: T,\n    payloads: Payload[],\n    additionalWitnesses: AccountInstance[] = [],\n    errors?: ModuleError[],\n  ): Promise<ModuleQueryResult> {\n    const builder = new BoundWitnessBuilder().payloads(payloads).errors(errors)\n    const queryWitnessAccount = this.queryAccounts[query.schema as ModuleQueryBase['schema']]\n    const witnesses = [this.account, queryWitnessAccount, ...additionalWitnesses].filter(exists)\n    builder.witnesses(witnesses)\n    const result: ModuleQueryResult = [(await builder.build())[0], payloads, errors ?? []]\n    return result\n  }\n\n  protected commitArchivist = () => this.getArchivist('commit')\n\n  protected async describeHandler(): Promise<ModuleDescriptionPayload> {\n    const description: ModuleDescriptionPayload = {\n      address: this.address,\n      queries: this.queries,\n      schema: ModuleDescriptionSchema,\n    }\n    if (this.config?.name) {\n      description.name = this.config.name\n    }\n\n    const discover = await this.discoverHandler()\n\n    description.children = compact(\n      discover?.map((payload) => {\n        const address = payload.schema === AddressSchema ? (payload as AddressPayload).address : undefined\n        return address != this.address ? address : undefined\n      }) ?? [],\n    )\n\n    return description\n  }\n\n  protected discoverHandler(): Promisable<Payload[]> {\n    const config = this.config\n    const address = new PayloadBuilder<AddressPayload>({ schema: AddressSchema }).fields({ address: this.address, name: this.config?.name }).build()\n    const queries = this.queries.map((query) => {\n      return new PayloadBuilder<QueryPayload>({ schema: QuerySchema }).fields({ query }).build()\n    })\n    const configSchema: ConfigPayload = {\n      config: config.schema,\n      schema: ConfigSchema,\n    }\n    return compact([config, configSchema, address, ...queries])\n  }\n\n  protected async getArchivist(kind: keyof IndividualArchivistConfig): Promise<ArchivistInstance | undefined> {\n    if (!this.config.archivist) return undefined\n    const filter =\n      typeof this.config.archivist === 'string' || this.config.archivist instanceof String\n        ? (this.config.archivist as string)\n        : (this.config?.archivist?.[kind] as string)\n    const resolved = await this.upResolver.resolve(filter)\n    return asArchivistInstance(resolved)\n  }\n\n  protected async initializeQueryAccounts() {\n    // Ensure distinct/unique wallet paths\n    const paths = Object.values(this.queryAccountPaths).filter(exists)\n    const distinctPaths = new Set<string>(paths)\n    assertEx(distinctPaths.size === paths.length, `${this.config?.name ? this.config.name + ': ' : ''}Duplicate query account paths`)\n    // Create an account for query this module supports\n    const wallet = this.account as unknown as HDWallet\n    if (wallet?.derivePath) {\n      for (const key in this.queryAccountPaths) {\n        if (Object.prototype.hasOwnProperty.call(this.queryAccountPaths, key)) {\n          const query = key as ModuleQueryBase['schema']\n          const queryAccountPath = this.queryAccountPaths[query]\n          if (queryAccountPath) {\n            this._queryAccounts[query] = await wallet.derivePath?.(queryAccountPath)\n          }\n        }\n      }\n    }\n  }\n\n  protected manifestHandler(_ignoreAddresses?: string[]): Promisable<ModuleManifestPayload> {\n    const name = this.config.name ?? 'Anonymous'\n    return { config: { name, ...this.config }, schema: ModuleManifestPayloadSchema }\n  }\n\n  protected moduleAddressHandler(): Promisable<AddressPreviousHashPayload[]> {\n    // Return array of all addresses and their previous hash\n    const queryAccounts = Object.entries(this.queryAccounts)\n      .filter((value): value is [string, AccountInstance] => {\n        return exists(value[1])\n      })\n      .map(([name, account]) => {\n        const address = account.address\n        const previousHash = account.previousHash\n        return [\n          { address, name, schema: AddressSchema },\n          { address, previousHash, schema: AddressPreviousHashSchema },\n        ]\n      })\n    const address = this.address\n    const name = this.config.name\n    const previousHash = this.address\n    const moduleAccount = name ? { address, name, schema: AddressSchema } : { address, schema: AddressSchema }\n    const moduleAccountPreviousHash = previousHash\n      ? { address, previousHash, schema: AddressPreviousHashSchema }\n      : { address, schema: AddressPreviousHashSchema }\n    return [moduleAccount, moduleAccountPreviousHash, ...queryAccounts].flat()\n  }\n\n  protected async queryHandler<T extends QueryBoundWitness = QueryBoundWitness, TConfig extends ModuleConfig = ModuleConfig>(\n    query: T,\n    payloads?: Payload[],\n    queryConfig?: TConfig,\n  ): Promise<ModuleQueryHandlerResult> {\n    await this.started('throw')\n    const wrapper = QueryBoundWitnessWrapper.parseQuery<ModuleQuery>(query, payloads)\n    const queryPayload = await wrapper.getQuery()\n    assertEx(this.queryable(query, payloads, queryConfig))\n    const resultPayloads: Payload[] = []\n    switch (queryPayload.schema) {\n      case ModuleManifestQuerySchema: {\n        resultPayloads.push(await this.manifestHandler())\n        break\n      }\n      case ModuleDiscoverQuerySchema: {\n        resultPayloads.push(...(await this.discoverHandler()))\n        break\n      }\n      case ModuleDescribeQuerySchema: {\n        resultPayloads.push(await this.describeHandler())\n        break\n      }\n      case ModuleAddressQuerySchema: {\n        resultPayloads.push(...(await this.moduleAddressHandler()))\n        break\n      }\n      case ModuleSubscribeQuerySchema: {\n        this.subscribeHandler()\n        break\n      }\n      default:\n        throw Error(`Unsupported Query [${(queryPayload as Payload).schema}]`)\n    }\n    return resultPayloads\n  }\n\n  protected readArchivist = () => this.getArchivist('read')\n\n  protected async startHandler(): Promise<boolean> {\n    this.validateConfig()\n    await this.initializeQueryAccounts()\n    this._started = true\n    return true\n  }\n\n  protected stopHandler(_timeout?: number): Promisable<boolean> {\n    this._started = undefined\n    return true\n  }\n\n  protected subscribeHandler() {\n    return\n  }\n\n  protected validateConfig(config?: unknown, parents: string[] = []): boolean {\n    return Object.entries(config ?? this.config ?? {}).reduce((valid, [key, value]) => {\n      switch (typeof value) {\n        case 'function':\n          this.logger?.warn(`Fields of type function not allowed in config [${parents?.join('.')}.${key}]`)\n          return false\n        case 'object': {\n          if (Array.isArray(value)) {\n            return (\n              value.reduce((valid, value) => {\n                return this.validateConfig(value, [...parents, key]) && valid\n              }, true) && valid\n            )\n          }\n\n          if (!serializableField(value)) {\n            this.logger?.warn(`Fields that are not serializable to JSON are not allowed in config [${parents?.join('.')}.${key}]`)\n            return false\n          }\n          return value ? this.validateConfig(value, [...parents, key]) && valid : true\n        }\n        default:\n          return valid\n      }\n    }, true)\n  }\n\n  protected writeArchivist = () => this.getArchivist('write')\n}\n"],"mappings":"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","names":["AbstractModule","BaseEmitter","configSchemas","enableLazyLoad","privateConstructorKey","Date","now","toString","downResolver","CompositeModuleResolver","upResolver","_account","undefined","_baseModuleQueryAccountPaths","ModuleAddressQuerySchema","ModuleDescribeQuerySchema","ModuleDiscoverQuerySchema","ModuleManifestQuerySchema","ModuleSubscribeQuerySchema","_queryAccounts","_startPromise","_started","moduleConfigQueryValidator","supportedQueryValidator","_busyCount","constructor","params","account","assertEx","mutatedParams","SupportedQueryValidator","queryable","ModuleConfigQueryValidator","config","configSchema","address","allowAnonymous","security","ephemeralQueryAccountEnabled","queries","queryAccountPaths","_queryAccountPaths","queryAccounts","timestamp","_getRootFunction","funcName","anyThis","__proto__","_noOverride","functionName","thisFunc","rootFunc","create","length","Error","schema","name","wallet","accountDerivationPath","allowedSchemas","filter","allowedSchema","JSON","stringify","mutatedConfig","logger","debug","activeLogger","defaultLogger","generatedAccount","determineAccount","IdLogger","newModule","start","derivePath","HDWallet","random","console","warn","factory","ModuleFactory","withParams","busy","closure","args","module","emit","eventName","eventArgs","previousHash","query","payloads","queryConfig","resultPayloads","errorPayloads","queryAccount","started","addresses","push","queryHandler","QueryBoundWitnessWrapper","unwrap","ex","handleErrorAsync","error","ModuleErrorBuilder","sources","PayloadHasher","hashAsync","message","build","result","bindQueryResult","configValidator","Object","assign","validators","every","validator","resolve","nameOrAddressOrFilter","options","direction","up","down","duplicateModules","_timeout","startHandler","notStartedAction","tryStart","handleError","log","stop","stopHandler","bindHashes","hashes","promise","PromiseEx","bindHashesInternal","builder","BoundWitnessBuilder","witness","bindQuery","bindQueryInternal","QueryBoundWitnessBuilder","additionalWitnesses","errors","queryWitnessAccount","witnesses","exists","commitArchivist","getArchivist","describeHandler","description","ModuleDescriptionSchema","discover","discoverHandler","children","compact","map","payload","AddressSchema","PayloadBuilder","fields","QuerySchema","ConfigSchema","kind","archivist","String","resolved","asArchivistInstance","initializeQueryAccounts","paths","values","distinctPaths","Set","size","key","prototype","hasOwnProperty","call","queryAccountPath","manifestHandler","_ignoreAddresses","ModuleManifestPayloadSchema","moduleAddressHandler","entries","value","AddressPreviousHashSchema","moduleAccount","moduleAccountPreviousHash","flat","wrapper","parseQuery","queryPayload","getQuery","subscribeHandler","readArchivist","validateConfig","parents","reduce","valid","join","Array","isArray","serializableField","writeArchivist"]}

package/dist/node/AbstractModule.mjs

@@ -0,0 +1,571 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+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 { 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 { 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();
+  downResolver = new CompositeModuleResolver();
+  upResolver = new CompositeModuleResolver();
+  _account = void 0;
+  _baseModuleQueryAccountPaths = {
+    [ModuleAddressQuerySchema]: "1",
+    [ModuleDescribeQuerySchema]: "4",
+    [ModuleDiscoverQuerySchema]: "2",
+    [ModuleManifestQuerySchema]: "5",
+    [ModuleSubscribeQuerySchema]: "3"
+  };
+  _queryAccounts = {
+    [ModuleAddressQuerySchema]: void 0,
+    [ModuleDescribeQuerySchema]: void 0,
+    [ModuleDiscoverQuerySchema]: void 0,
+    [ModuleManifestQuerySchema]: void 0,
+    [ModuleSubscribeQuerySchema]: void 0
+  };
+  _startPromise = void 0;
+  _started = void 0;
+  moduleConfigQueryValidator;
+  supportedQueryValidator;
+  _busyCount = 0;
+  constructor(privateConstructorKey, params, account) {
+    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;
+  }
+  static get configSchema() {
+    return this.configSchemas[0];
+  }
+  get account() {
+    return assertEx(this._account, "Missing account");
+  }
+  get address() {
+    return this.account.address;
+  }
+  get allowAnonymous() {
+    return !!this.config.security?.allowAnonymous;
+  }
+  get config() {
+    return this.params.config;
+  }
+  get ephemeralQueryAccountEnabled() {
+    return !!this.params.ephemeralQueryAccountEnabled;
+  }
+  get queries() {
+    return [
+      ModuleDiscoverQuerySchema,
+      ModuleAddressQuerySchema,
+      ModuleSubscribeQuerySchema,
+      ModuleDescribeQuerySchema,
+      ModuleManifestQuerySchema
+    ];
+  }
+  get queryAccountPaths() {
+    return {
+      ...this._baseModuleQueryAccountPaths,
+      ...this._queryAccountPaths
+    };
+  }
+  get queryAccounts() {
+    return this._queryAccounts;
+  }
+  get timestamp() {
+    return this.config.timestamp ?? false;
+  }
+  static _getRootFunction(funcName) {
+    let anyThis = this;
+    while (anyThis.__proto__[funcName]) {
+      anyThis = anyThis.__proto__;
+    }
+    return anyThis[funcName];
+  }
+  static _noOverride(functionName) {
+    const thisFunc = this[functionName];
+    const rootFunc = this._getRootFunction(functionName);
+    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 Error(`Missing configSchema [${params?.config?.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;
+    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,
+      schema
+    };
+    params?.logger?.debug(`config: ${JSON.stringify(mutatedConfig, null, 2)}`);
+    const mutatedParams = {
+      ...params,
+      config: mutatedConfig
+    };
+    const activeLogger = 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?.();
+    }
+    return newModule;
+  }
+  static async determineAccount({ account, accountDerivationPath, wallet }) {
+    if (wallet) {
+      return assertEx(accountDerivationPath ? await wallet.derivePath(accountDerivationPath) : wallet, "Failed to derive account from path");
+    } else if (account === "random") {
+      return await HDWallet.random();
+    } else if (account) {
+      return account;
+    } else {
+      console.warn("AbstractModule.determineAccount: No account provided - Creating Random account");
+      return await HDWallet.random();
+    }
+  }
+  static factory(params) {
+    return ModuleFactory.withParams(this, params);
+  }
+  _getRootFunction(funcName) {
+    let anyThis = this;
+    while (anyThis.__proto__[funcName]) {
+      anyThis = anyThis.__proto__;
+    }
+    return anyThis[funcName];
+  }
+  _noOverride(functionName) {
+    const thisFunc = this[functionName];
+    const rootFunc = this._getRootFunction(functionName);
+    assertEx(thisFunc === rootFunc, `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
+  }
+  async busy(closure) {
+    if (this._busyCount <= 0) {
+      this._busyCount = 0;
+      const args = {
+        busy: true,
+        module: this
+      };
+      await this.emit("moduleBusy", args);
+    }
+    this._busyCount++;
+    try {
+      return await closure();
+    } finally {
+      this._busyCount--;
+      if (this._busyCount <= 0) {
+        this._busyCount = 0;
+        const args = {
+          busy: false,
+          module: this
+        };
+        await this.emit("moduleBusy", args);
+      }
+    }
+  }
+  emit(eventName, eventArgs) {
+    return super.emit(eventName, eventArgs);
+  }
+  previousHash() {
+    return this.account.previousHash;
+  }
+  async query(query, payloads, queryConfig) {
+    this._noOverride("query");
+    return await this.busy(async () => {
+      const resultPayloads = [];
+      const errorPayloads = [];
+      const queryAccount = this.ephemeralQueryAccountEnabled ? await HDWallet.random() : void 0;
+      try {
+        await this.started("throw");
+        if (!this.allowAnonymous) {
+          if (query.addresses.length === 0) {
+            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));
+      } catch (ex) {
+        await handleErrorAsync(ex, async (error) => {
+          errorPayloads.push(new ModuleErrorBuilder().sources([
+            await PayloadHasher.hashAsync(query)
+          ]).name(this.config.name ?? "<Unknown>").query(query.schema).message(error.message).build());
+        });
+      }
+      if (this.timestamp) {
+        const timestamp = {
+          schema: "network.xyo.timestamp",
+          timestamp: Date.now()
+        };
+        resultPayloads.push(timestamp);
+      }
+      const result = await this.bindQueryResult(query, resultPayloads, queryAccount ? [
+        queryAccount
+      ] : [], errorPayloads);
+      const args = {
+        module: this,
+        payloads,
+        query,
+        result
+      };
+      await this.emit("moduleQueried", args);
+      return result;
+    });
+  }
+  queryable(query, payloads, queryConfig) {
+    if (!this.started("warn"))
+      return false;
+    const configValidator = queryConfig ? new ModuleConfigQueryValidator(Object.assign({}, this.config, queryConfig)).queryable : this.moduleConfigQueryValidator;
+    const validators = [
+      this.supportedQueryValidator,
+      configValidator
+    ];
+    return validators.every((validator) => validator(query, payloads));
+  }
+  async resolve(nameOrAddressOrFilter, options) {
+    const direction = options?.direction ?? "all";
+    const up = direction === "up" || direction === "all";
+    const down = direction === "down" || direction === "all";
+    switch (typeof nameOrAddressOrFilter) {
+      case "string": {
+        return (down ? await this.downResolver.resolve(nameOrAddressOrFilter, options) : void 0) ?? (up ? await this.upResolver.resolve(nameOrAddressOrFilter, options) : void 0);
+      }
+      default: {
+        const filter = nameOrAddressOrFilter;
+        return [
+          ...down ? await this.downResolver.resolve(filter, options) : [],
+          ...up ? await this.upResolver.resolve(filter, options) : []
+        ].filter(duplicateModules);
+      }
+    }
+  }
+  start(_timeout) {
+    this._startPromise = this._startPromise ?? this.startHandler();
+    return this._startPromise;
+  }
+  async started(notStartedAction = "log", tryStart = true) {
+    const started = await this._started;
+    if (started === true) {
+      return true;
+    }
+    if (!started) {
+      this._started = (async () => {
+        if (tryStart) {
+          try {
+            await this.start();
+            return true;
+          } catch (ex) {
+            handleError(ex, (error) => {
+              this.logger?.warn(`Autostart of Module Failed: ${error.message})`);
+              this._started = void 0;
+            });
+          }
+        }
+        switch (notStartedAction) {
+          case "throw":
+            throw Error(`Module not Started [${this.address}]`);
+          case "warn":
+            this.logger?.warn("Module not started");
+            break;
+          case "error":
+            this.logger?.error("Module not started");
+            break;
+          case "none":
+            break;
+          case "log":
+          default: {
+            this.logger?.log("Module not started");
+            break;
+          }
+        }
+        return false;
+      })();
+    }
+    if (!this._started) {
+      throw "Failed to create start promise";
+    }
+    return await this._started;
+  }
+  async stop(_timeout) {
+    return await this.busy(async () => {
+      const result = await this.stopHandler();
+      this._started = void 0;
+      this._startPromise = void 0;
+      return result;
+    });
+  }
+  bindHashes(hashes, schema, account) {
+    const promise = new PromiseEx((resolve) => {
+      const result = this.bindHashesInternal(hashes, schema, account);
+      resolve?.(result);
+      return result;
+    }, account);
+    return promise;
+  }
+  async bindHashesInternal(hashes, schema, account) {
+    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)}`);
+    return result;
+  }
+  bindQuery(query, payloads, account) {
+    const promise = new PromiseEx(async (resolve) => {
+      const result = await this.bindQueryInternal(query, payloads, account);
+      resolve?.(result);
+      return result;
+    }, account);
+    return promise;
+  }
+  async bindQueryInternal(query, payloads, account) {
+    const builder = new QueryBoundWitnessBuilder().payloads(payloads).witness(this.account).query(query);
+    const result = await (account ? builder.witness(account) : builder).build();
+    return result;
+  }
+  async bindQueryResult(query, payloads, additionalWitnesses = [], errors) {
+    const builder = new BoundWitnessBuilder().payloads(payloads).errors(errors);
+    const queryWitnessAccount = this.queryAccounts[query.schema];
+    const witnesses = [
+      this.account,
+      queryWitnessAccount,
+      ...additionalWitnesses
+    ].filter(exists);
+    builder.witnesses(witnesses);
+    const result = [
+      (await builder.build())[0],
+      payloads,
+      errors ?? []
+    ];
+    return result;
+  }
+  commitArchivist = () => this.getArchivist("commit");
+  async describeHandler() {
+    const description = {
+      address: this.address,
+      queries: this.queries,
+      schema: ModuleDescriptionSchema
+    };
+    if (this.config?.name) {
+      description.name = this.config.name;
+    }
+    const discover = await this.discoverHandler();
+    description.children = compact(discover?.map((payload) => {
+      const address = payload.schema === AddressSchema ? payload.address : void 0;
+      return address != this.address ? address : void 0;
+    }) ?? []);
+    return description;
+  }
+  discoverHandler() {
+    const config = this.config;
+    const address = new PayloadBuilder({
+      schema: AddressSchema
+    }).fields({
+      address: this.address,
+      name: this.config?.name
+    }).build();
+    const queries = this.queries.map((query) => {
+      return new PayloadBuilder({
+        schema: QuerySchema
+      }).fields({
+        query
+      }).build();
+    });
+    const configSchema = {
+      config: config.schema,
+      schema: ConfigSchema
+    };
+    return compact([
+      config,
+      configSchema,
+      address,
+      ...queries
+    ]);
+  }
+  async getArchivist(kind) {
+    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 resolved = await this.upResolver.resolve(filter);
+    return asArchivistInstance(resolved);
+  }
+  async initializeQueryAccounts() {
+    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`);
+    const wallet = this.account;
+    if (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);
+          }
+        }
+      }
+    }
+  }
+  manifestHandler(_ignoreAddresses) {
+    const name = this.config.name ?? "Anonymous";
+    return {
+      config: {
+        name,
+        ...this.config
+      },
+      schema: ModuleManifestPayloadSchema
+    };
+  }
+  moduleAddressHandler() {
+    const queryAccounts = Object.entries(this.queryAccounts).filter((value) => {
+      return exists(value[1]);
+    }).map(([name2, account]) => {
+      const address2 = account.address;
+      const previousHash2 = account.previousHash;
+      return [
+        {
+          address: address2,
+          name: name2,
+          schema: AddressSchema
+        },
+        {
+          address: address2,
+          previousHash: previousHash2,
+          schema: AddressPreviousHashSchema
+        }
+      ];
+    });
+    const address = this.address;
+    const name = this.config.name;
+    const previousHash = this.address;
+    const moduleAccount = name ? {
+      address,
+      name,
+      schema: AddressSchema
+    } : {
+      address,
+      schema: AddressSchema
+    };
+    const moduleAccountPreviousHash = previousHash ? {
+      address,
+      previousHash,
+      schema: AddressPreviousHashSchema
+    } : {
+      address,
+      schema: AddressPreviousHashSchema
+    };
+    return [
+      moduleAccount,
+      moduleAccountPreviousHash,
+      ...queryAccounts
+    ].flat();
+  }
+  async queryHandler(query, payloads, queryConfig) {
+    await this.started("throw");
+    const wrapper = QueryBoundWitnessWrapper.parseQuery(query, payloads);
+    const queryPayload = await wrapper.getQuery();
+    assertEx(this.queryable(query, payloads, queryConfig));
+    const resultPayloads = [];
+    switch (queryPayload.schema) {
+      case ModuleManifestQuerySchema: {
+        resultPayloads.push(await this.manifestHandler());
+        break;
+      }
+      case ModuleDiscoverQuerySchema: {
+        resultPayloads.push(...await this.discoverHandler());
+        break;
+      }
+      case ModuleDescribeQuerySchema: {
+        resultPayloads.push(await this.describeHandler());
+        break;
+      }
+      case ModuleAddressQuerySchema: {
+        resultPayloads.push(...await this.moduleAddressHandler());
+        break;
+      }
+      case ModuleSubscribeQuerySchema: {
+        this.subscribeHandler();
+        break;
+      }
+      default:
+        throw Error(`Unsupported Query [${queryPayload.schema}]`);
+    }
+    return resultPayloads;
+  }
+  readArchivist = () => this.getArchivist("read");
+  async startHandler() {
+    this.validateConfig();
+    await this.initializeQueryAccounts();
+    this._started = true;
+    return true;
+  }
+  stopHandler(_timeout) {
+    this._started = void 0;
+    return true;
+  }
+  subscribeHandler() {
+    return;
+  }
+  validateConfig(config, parents = []) {
+    return Object.entries(config ?? this.config ?? {}).reduce((valid, [key, value]) => {
+      switch (typeof value) {
+        case "function":
+          this.logger?.warn(`Fields of type function not allowed in config [${parents?.join(".")}.${key}]`);
+          return false;
+        case "object": {
+          if (Array.isArray(value)) {
+            return value.reduce((valid2, value2) => {
+              return this.validateConfig(value2, [
+                ...parents,
+                key
+              ]) && valid2;
+            }, true) && valid;
+          }
+          if (!serializableField(value)) {
+            this.logger?.warn(`Fields that are not serializable to JSON are not allowed in config [${parents?.join(".")}.${key}]`);
+            return false;
+          }
+          return value ? this.validateConfig(value, [
+            ...parents,
+            key
+          ]) && valid : true;
+        }
+        default:
+          return valid;
+      }
+    }, true);
+  }
+  writeArchivist = () => this.getArchivist("write");
+}
+export {
+  AbstractModule
+};
+//# sourceMappingURL=AbstractModule.mjs.map