@xyo-network/diviner-abstract 4.0.2 → 4.1.0

package/{dist/types → build/neutral}/AbstractDiviner.d.ts

@@ -4,7 +4,7 @@ import type { AccountInstance } from '@xyo-network/account-model';
 import type { QueryBoundWitness } from '@xyo-network/boundwitness-model';
 import type { AttachableDivinerInstance, DivinerDivineResult, DivinerInstance, DivinerModuleEventData, DivinerParams } from '@xyo-network/diviner-model';
 import { AbstractModuleInstance } from '@xyo-network/module-abstract';
-import type { ModuleConfig, ModuleQueryHandlerResult, ModuleQueryResult } from '@xyo-network/module-model';
+import { type ModuleConfig, type ModuleQueryHandlerResult, type ModuleQueryResult } from '@xyo-network/module-model';
 import type { Payload, Schema } from '@xyo-network/payload-model';
 export declare abstract class AbstractDiviner<TParams extends DivinerParams = DivinerParams, TIn extends Payload = Payload, TOut extends Payload = Payload, TEventData extends DivinerModuleEventData<DivinerInstance<TParams, TIn, TOut>, TIn, TOut> = DivinerModuleEventData<DivinerInstance<TParams, TIn, TOut>, TIn, TOut>> extends AbstractModuleInstance<TParams, TEventData> implements AttachableDivinerInstance<TParams, TIn, TOut, TEventData> {
     static readonly configSchemas: Schema[];

package/build/neutral/AbstractDiviner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractDiviner.d.ts","sourceRoot":"","sources":["../../src/AbstractDiviner.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAMzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAEjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAExE,OAAO,KAAK,EACV,yBAAyB,EAEzB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,aAAa,EAEd,MAAM,4BAA4B,CAAA;AAKnC,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,EAEL,KAAK,YAAY,EAA8C,KAAK,wBAAwB,EAAE,KAAK,iBAAiB,EACrH,MAAM,2BAA2B,CAAA;AAElC,OAAO,KAAK,EACV,OAAO,EAAE,MAAM,EAChB,MAAM,4BAA4B,CAAA;AA0BnC,8BAAsB,eAAe,CACnC,OAAO,SAAS,aAAa,GAAG,aAAa,EAC7C,GAAG,SAAS,OAAO,GAAG,OAAO,EAC7B,IAAI,SAAS,OAAO,GAAG,OAAO,EAC9B,UAAU,SAAS,sBAAsB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,sBAAsB,CAChH,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EACnC,GAAG,EACH,IAAI,CACL,CAED,SAAQ,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAClD,YAAW,yBAAyB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC;IACpE,gBAAyB,aAAa,EAAE,MAAM,EAAE,CAAgD;IAChG,gBAAyB,mBAAmB,EAAE,MAAM,CAAsB;IAC1E,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IACpC,gBAAyB,UAAU,SAA4D;IAE/F,OAAO,CAAC,0BAA0B,CAAiC;IAEnE,IAAa,OAAO,IAAI,MAAM,EAAE,CAE/B;IAED,sJAAsJ;IAChJ,MAAM,CAAC,QAAQ,GAAE,GAAG,EAAO,EAAE,aAAa,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;IAmC3G,WAAW,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAMtH,uGAAuG;cAC9E,YAAY,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,EAAE,OAAO,SAAS,YAAY,GAAG,YAAY,EAChI,KAAK,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,OAAO,EAAE,EACpB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,wBAAwB,CAAC;cAmBX,YAAY;cAmDZ,WAAW;IASpC,6FAA6F;IAC7F,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;CACvE"}

package/dist/neutral/index.d.ts

@@ -0,0 +1,28 @@
+import { Promisable } from '@xylabs/promise';
+import { RetryConfigWithComplete, RetryConfig } from '@xylabs/retry';
+import { AccountInstance } from '@xyo-network/account-model';
+import { QueryBoundWitness } from '@xyo-network/boundwitness-model';
+import { DivinerParams, DivinerModuleEventData, DivinerInstance, AttachableDivinerInstance, DivinerDivineResult } from '@xyo-network/diviner-model';
+import { AbstractModuleInstance } from '@xyo-network/module-abstract';
+import { ModuleQueryResult, ModuleConfig, ModuleQueryHandlerResult } from '@xyo-network/module-model';
+import { Payload, Schema } from '@xyo-network/payload-model';
+
+declare abstract class AbstractDiviner<TParams extends DivinerParams = DivinerParams, TIn extends Payload = Payload, TOut extends Payload = Payload, TEventData extends DivinerModuleEventData<DivinerInstance<TParams, TIn, TOut>, TIn, TOut> = DivinerModuleEventData<DivinerInstance<TParams, TIn, TOut>, TIn, TOut>> extends AbstractModuleInstance<TParams, TEventData> implements AttachableDivinerInstance<TParams, TIn, TOut, TEventData> {
+    static readonly configSchemas: Schema[];
+    static readonly defaultConfigSchema: Schema;
+    static readonly targetSchema: string;
+    static readonly uniqueName: string;
+    private _eventUnsubscribeFunctions;
+    get queries(): string[];
+    /** @function divine The main entry point for a diviner.  Do not override this function.  Implement/override divineHandler for custom functionality */
+    divine(payloads?: TIn[], retryConfigIn?: RetryConfigWithComplete): Promise<DivinerDivineResult<TOut>[]>;
+    divineQuery(payloads?: TIn[], account?: AccountInstance, _retry?: RetryConfig): Promise<ModuleQueryResult<TOut>>;
+    /** @function queryHandler Calls divine for a divine query.  Override to support additional queries. */
+    protected queryHandler<T extends QueryBoundWitness = QueryBoundWitness, TConfig extends ModuleConfig = ModuleConfig>(query: T, payloads?: Payload[], queryConfig?: TConfig): Promise<ModuleQueryHandlerResult>;
+    protected startHandler(): Promise<void>;
+    protected stopHandler(): Promise<void>;
+    /** @function divineHandler Implement or override to add custom functionality to a diviner */
+    protected abstract divineHandler(payloads?: TIn[]): Promisable<TOut[]>;
+}
+
+export { AbstractDiviner };

package/dist/neutral/index.mjs

@@ -18,13 +18,16 @@ import {
   isDivinerInstance
 } from "@xyo-network/diviner-model";
 import { AbstractModuleInstance } from "@xyo-network/module-abstract";
+import {
+  asModuleInstance
+} from "@xyo-network/module-model";
 import { PayloadBuilder } from "@xyo-network/payload-builder";
 import { isWitnessInstance } from "@xyo-network/witness-model";
-var delayedResolve = async (parent, id, closure, timeout = 3e4, logger) => {
+var delayedResolve = async (parent, id, closure, as = asModuleInstance, timeout = 3e4, logger) => {
   const start = Date.now();
   let result;
   while (isUndefined(result)) {
-    result = await parent.resolve(id);
+    result = as(await parent.resolve(id));
     if (isDefined(result)) {
       closure(result);
       break;
@@ -150,7 +153,7 @@ var AbstractDiviner = class _AbstractDiviner extends AbstractModuleInstance {
               }
             }
           }
-        }, void 0, this.logger));
+        }, asModuleInstance, void 0, this.logger));
       }
     }
     return await super.startHandler();

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/AbstractDiviner.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { globallyUnique } from '@xylabs/base'\nimport { delay } from '@xylabs/delay'\nimport type { EventUnsubscribeFunction } from '@xylabs/events'\nimport { forget } from '@xylabs/forget'\nimport type { Logger } from '@xylabs/logger'\nimport type { Promisable } from '@xylabs/promise'\nimport type { RetryConfig, RetryConfigWithComplete } from '@xylabs/retry'\nimport { retry } from '@xylabs/retry'\nimport { spanAsync } from '@xylabs/telemetry'\nimport {\n  isDefined, isNull, isUndefined,\n} from '@xylabs/typeof'\nimport type { AccountInstance } from '@xyo-network/account-model'\nimport { isArchivistInstance } from '@xyo-network/archivist-model'\nimport type { QueryBoundWitness } from '@xyo-network/boundwitness-model'\nimport { QueryBoundWitnessWrapper } from '@xyo-network/boundwitness-wrapper'\nimport type {\n  AttachableDivinerInstance,\n  DivinerDivineQuery,\n  DivinerDivineResult,\n  DivinerInstance,\n  DivinerModuleEventData,\n  DivinerParams,\n  DivinerQueries,\n} from '@xyo-network/diviner-model'\nimport {\n  DivinerConfigSchema, DivinerDivineQuerySchema, isDivinerInstance,\n} from '@xyo-network/diviner-model'\nimport { AbstractModuleInstance } from '@xyo-network/module-abstract'\nimport type {\n  ModuleConfig, ModuleIdentifier, ModuleInstance, ModuleQueryHandlerResult, ModuleQueryResult,\n} from '@xyo-network/module-model'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport type {\n  Payload, Schema, WithoutPrivateStorageMeta,\n} from '@xyo-network/payload-model'\nimport { isWitnessInstance } from '@xyo-network/witness-model'\n\nconst delayedResolve = async (\n  parent: ModuleInstance,\n  id: ModuleIdentifier,\n  closure: (mod: ModuleInstance | null) => void,\n  timeout = 30_000,\n  logger?: Logger,\n) => {\n  const start = Date.now()\n  let result: ModuleInstance | undefined\n  while (isUndefined(result)) {\n    result = await parent.resolve(id)\n    if (isDefined(result)) {\n      closure(result)\n      break\n    } else if (Date.now() - start > timeout) {\n      logger?.error(`Timed out waiting for ${id} to resolve`)\n      closure(null)\n    }\n    await delay(500)\n  }\n}\n\nexport abstract class AbstractDiviner<\n  TParams extends DivinerParams = DivinerParams,\n  TIn extends Payload = Payload,\n  TOut extends Payload = Payload,\n  TEventData extends DivinerModuleEventData<DivinerInstance<TParams, TIn, TOut>, TIn, TOut> = DivinerModuleEventData<\n    DivinerInstance<TParams, TIn, TOut>,\n    TIn,\n    TOut\n  >,\n>\n  extends AbstractModuleInstance<TParams, TEventData>\n  implements AttachableDivinerInstance<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, DivinerConfigSchema]\n  static override readonly defaultConfigSchema: Schema = DivinerConfigSchema\n  static readonly targetSchema: string\n  static override readonly uniqueName = globallyUnique('AbstractDiviner', AbstractDiviner, 'xyo')\n\n  private _eventUnsubscribeFunctions: EventUnsubscribeFunction[] = []\n\n  override get queries(): string[] {\n    return [DivinerDivineQuerySchema, ...super.queries]\n  }\n\n  /** @function divine The main entry point for a diviner.  Do not override this function.  Implement/override divineHandler for custom functionality */\n  async divine(payloads: TIn[] = [], retryConfigIn?: RetryConfigWithComplete): Promise<DivinerDivineResult<TOut>[]> {\n    this._noOverride('divine')\n    this.isSupportedQuery(DivinerDivineQuerySchema, 'divine')\n    return await spanAsync('divine', async () => {\n      if (this.reentrancy?.scope === 'global' && this.reentrancy.action === 'skip' && this.globalReentrancyMutex?.isLocked()) {\n        return []\n      }\n      try {\n        await this.globalReentrancyMutex?.acquire()\n        return await this.busy(async () => {\n          const retryConfig = retryConfigIn ?? this.config.retry\n          await this.started('throw')\n          await this.emit('divineStart', { inPayloads: payloads, mod: this })\n          let outPayloads: TOut[] = []\n          let errors: Error[] = []\n          try {\n            outPayloads = (retryConfig ? await retry(() => this.divineHandler(payloads), retryConfig) : await this.divineHandler(payloads)) ?? []\n          } catch (ex) {\n            errors.push(ex as Error)\n            this.logger?.error(`Error in divineHandler: ${ex}`)\n          }\n          await this.emit('divineEnd', {\n            errors, inPayloads: payloads, mod: this, outPayloads,\n          })\n          if (errors.length > 0) {\n            throw new Error(`Divine failed with ${errors.length} errors: ${errors.map(e => e.message).join(', ')}`)\n          }\n          return PayloadBuilder.omitPrivateStorageMeta(outPayloads)\n        })\n      } finally {\n        this.globalReentrancyMutex?.release()\n      }\n    }, this.tracer)\n  }\n\n  async divineQuery(payloads?: TIn[], account?: AccountInstance, _retry?: RetryConfig): Promise<ModuleQueryResult<TOut>> {\n    this._noOverride('divineQuery')\n    const queryPayload: DivinerDivineQuery = { schema: DivinerDivineQuerySchema }\n    return await this.sendQueryRaw(queryPayload, payloads, account)\n  }\n\n  /** @function queryHandler Calls divine for a divine query.  Override to support additional queries. */\n  protected override async queryHandler<T extends QueryBoundWitness = QueryBoundWitness, TConfig extends ModuleConfig = ModuleConfig>(\n    query: T,\n    payloads?: Payload[],\n    queryConfig?: TConfig,\n  ): Promise<ModuleQueryHandlerResult> {\n    const wrapper = QueryBoundWitnessWrapper.parseQuery<DivinerQueries>(query, payloads)\n    // remove the query payload\n    const cleanPayloads = await PayloadBuilder.filterExclude(payloads, query.query)\n    const queryPayload = await wrapper.getQuery()\n    assertEx(await this.queryable(query, payloads, queryConfig))\n    const resultPayloads: WithoutPrivateStorageMeta<Payload>[] = []\n    switch (queryPayload.schema) {\n      case DivinerDivineQuerySchema: {\n        resultPayloads.push(...(await this.divine(cleanPayloads as TIn[])))\n        break\n      }\n      default: {\n        return super.queryHandler(query, payloads)\n      }\n    }\n    return PayloadBuilder.omitPrivateStorageMeta(resultPayloads)\n  }\n\n  protected override async startHandler() {\n    const { eventSubscriptions = [] } = this.config\n\n    for (const subscription of eventSubscriptions) {\n      const {\n        sourceEvent, sourceModule, targetModuleFunction,\n      } = subscription\n      if (targetModuleFunction === 'divine') {\n        forget(delayedResolve(this, sourceModule, (sourceModuleInstance: ModuleInstance | null) => {\n          if (isNull(sourceModuleInstance)) {\n            this.logger?.error(`Failed to resolve ${sourceModule} for ${this.modName}`)\n          } else {\n            if (isArchivistInstance(sourceModuleInstance)) {\n              if (sourceEvent === 'inserted') {\n                this._eventUnsubscribeFunctions.push(\n                  sourceModuleInstance.on(sourceEvent, async ({ outPayloads, payloads }) => {\n                    await this.divine((outPayloads ?? payloads) as Payload[] as TIn[])\n                  }),\n                )\n              } else {\n                this.logger?.warn(`Unsupported sourceEvent ${sourceEvent} for ${sourceModuleInstance.modName}`)\n              }\n            } else if (isDivinerInstance(sourceModuleInstance)) {\n              if (sourceEvent === 'divineEnd') {\n                this._eventUnsubscribeFunctions.push(\n                  sourceModuleInstance.on(sourceEvent, async ({ outPayloads }) => {\n                    await this.divine(outPayloads as Payload[] as TIn[])\n                  }),\n                )\n              } else {\n                this.logger?.warn(`Unsupported sourceEvent ${sourceEvent} for ${sourceModuleInstance.modName}`)\n              }\n            } else if (isWitnessInstance(sourceModuleInstance)) {\n              if (sourceEvent === 'observeEnd') {\n                this._eventUnsubscribeFunctions.push(\n                  sourceModuleInstance.on(sourceEvent, async ({ outPayloads }) => {\n                    await this.divine(outPayloads as Payload[] as TIn[])\n                  }),\n                )\n              } else {\n                this.logger?.warn(`Unsupported sourceEvent ${sourceEvent} for ${sourceModuleInstance.modName}`)\n              }\n            }\n          }\n        }, undefined, this.logger))\n      }\n    }\n\n    return await super.startHandler()\n  }\n\n  protected override async stopHandler() {\n    for (const unsubscribe of this._eventUnsubscribeFunctions) {\n      unsubscribe()\n    }\n    this._eventUnsubscribeFunctions = []\n    this._eventUnsubscribeFunctions = []\n    return await super.stopHandler()\n  }\n\n  /** @function divineHandler Implement or override to add custom functionality to a diviner */\n  protected abstract divineHandler(payloads?: TIn[]): Promisable<TOut[]>\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/AbstractDiviner.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport { globallyUnique } from '@xylabs/base'\nimport { delay } from '@xylabs/delay'\nimport type { EventUnsubscribeFunction } from '@xylabs/events'\nimport { forget } from '@xylabs/forget'\nimport type { Logger } from '@xylabs/logger'\nimport type { AsTypeFunction } from '@xylabs/object'\nimport type { Promisable } from '@xylabs/promise'\nimport type { RetryConfig, RetryConfigWithComplete } from '@xylabs/retry'\nimport { retry } from '@xylabs/retry'\nimport { spanAsync } from '@xylabs/telemetry'\nimport {\n  isDefined, isNull, isUndefined,\n} from '@xylabs/typeof'\nimport type { AccountInstance } from '@xyo-network/account-model'\nimport { asArchivistInstance, isArchivistInstance } from '@xyo-network/archivist-model'\nimport type { QueryBoundWitness } from '@xyo-network/boundwitness-model'\nimport { QueryBoundWitnessWrapper } from '@xyo-network/boundwitness-wrapper'\nimport type {\n  AttachableDivinerInstance,\n  DivinerDivineQuery,\n  DivinerDivineResult,\n  DivinerInstance,\n  DivinerModuleEventData,\n  DivinerParams,\n  DivinerQueries,\n} from '@xyo-network/diviner-model'\nimport {\n  asDivinerInstance,\n  DivinerConfigSchema, DivinerDivineQuerySchema, isDivinerInstance,\n} from '@xyo-network/diviner-model'\nimport { AbstractModuleInstance } from '@xyo-network/module-abstract'\nimport {\n  asModuleInstance,\n  type ModuleConfig, type ModuleIdentifier, type ModuleInstance, type ModuleQueryHandlerResult, type ModuleQueryResult,\n} from '@xyo-network/module-model'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport type {\n  Payload, Schema, WithoutPrivateStorageMeta,\n} from '@xyo-network/payload-model'\nimport { isWitnessInstance } from '@xyo-network/witness-model'\n\nconst delayedResolve = async <T extends ModuleInstance>(\n  parent: ModuleInstance,\n  id: ModuleIdentifier,\n  closure: (mod: T | null) => void,\n  as: AsTypeFunction<T> = asModuleInstance,\n  timeout = 30_000,\n  logger?: Logger,\n) => {\n  const start = Date.now()\n  let result: T | undefined\n  while (isUndefined(result)) {\n    result = as(await parent.resolve(id))\n    if (isDefined(result)) {\n      closure(result)\n      break\n    } else if (Date.now() - start > timeout) {\n      logger?.error(`Timed out waiting for ${id} to resolve`)\n      closure(null)\n    }\n    await delay(500)\n  }\n}\n\nexport abstract class AbstractDiviner<\n  TParams extends DivinerParams = DivinerParams,\n  TIn extends Payload = Payload,\n  TOut extends Payload = Payload,\n  TEventData extends DivinerModuleEventData<DivinerInstance<TParams, TIn, TOut>, TIn, TOut> = DivinerModuleEventData<\n    DivinerInstance<TParams, TIn, TOut>,\n    TIn,\n    TOut\n  >,\n>\n  extends AbstractModuleInstance<TParams, TEventData>\n  implements AttachableDivinerInstance<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, DivinerConfigSchema]\n  static override readonly defaultConfigSchema: Schema = DivinerConfigSchema\n  static readonly targetSchema: string\n  static override readonly uniqueName = globallyUnique('AbstractDiviner', AbstractDiviner, 'xyo')\n\n  private _eventUnsubscribeFunctions: EventUnsubscribeFunction[] = []\n\n  override get queries(): string[] {\n    return [DivinerDivineQuerySchema, ...super.queries]\n  }\n\n  /** @function divine The main entry point for a diviner.  Do not override this function.  Implement/override divineHandler for custom functionality */\n  async divine(payloads: TIn[] = [], retryConfigIn?: RetryConfigWithComplete): Promise<DivinerDivineResult<TOut>[]> {\n    this._noOverride('divine')\n    this.isSupportedQuery(DivinerDivineQuerySchema, 'divine')\n    return await spanAsync('divine', async () => {\n      if (this.reentrancy?.scope === 'global' && this.reentrancy.action === 'skip' && this.globalReentrancyMutex?.isLocked()) {\n        return []\n      }\n      try {\n        await this.globalReentrancyMutex?.acquire()\n        return await this.busy(async () => {\n          const retryConfig = retryConfigIn ?? this.config.retry\n          await this.started('throw')\n          await this.emit('divineStart', { inPayloads: payloads, mod: this })\n          let outPayloads: TOut[] = []\n          let errors: Error[] = []\n          try {\n            outPayloads = (retryConfig ? await retry(() => this.divineHandler(payloads), retryConfig) : await this.divineHandler(payloads)) ?? []\n          } catch (ex) {\n            errors.push(ex as Error)\n            this.logger?.error(`Error in divineHandler: ${ex}`)\n          }\n          await this.emit('divineEnd', {\n            errors, inPayloads: payloads, mod: this, outPayloads,\n          })\n          if (errors.length > 0) {\n            throw new Error(`Divine failed with ${errors.length} errors: ${errors.map(e => e.message).join(', ')}`)\n          }\n          return PayloadBuilder.omitPrivateStorageMeta(outPayloads)\n        })\n      } finally {\n        this.globalReentrancyMutex?.release()\n      }\n    }, this.tracer)\n  }\n\n  async divineQuery(payloads?: TIn[], account?: AccountInstance, _retry?: RetryConfig): Promise<ModuleQueryResult<TOut>> {\n    this._noOverride('divineQuery')\n    const queryPayload: DivinerDivineQuery = { schema: DivinerDivineQuerySchema }\n    return await this.sendQueryRaw(queryPayload, payloads, account)\n  }\n\n  /** @function queryHandler Calls divine for a divine query.  Override to support additional queries. */\n  protected override async queryHandler<T extends QueryBoundWitness = QueryBoundWitness, TConfig extends ModuleConfig = ModuleConfig>(\n    query: T,\n    payloads?: Payload[],\n    queryConfig?: TConfig,\n  ): Promise<ModuleQueryHandlerResult> {\n    const wrapper = QueryBoundWitnessWrapper.parseQuery<DivinerQueries>(query, payloads)\n    // remove the query payload\n    const cleanPayloads = await PayloadBuilder.filterExclude(payloads, query.query)\n    const queryPayload = await wrapper.getQuery()\n    assertEx(await this.queryable(query, payloads, queryConfig))\n    const resultPayloads: WithoutPrivateStorageMeta<Payload>[] = []\n    switch (queryPayload.schema) {\n      case DivinerDivineQuerySchema: {\n        resultPayloads.push(...(await this.divine(cleanPayloads as TIn[])))\n        break\n      }\n      default: {\n        return super.queryHandler(query, payloads)\n      }\n    }\n    return PayloadBuilder.omitPrivateStorageMeta(resultPayloads)\n  }\n\n  protected override async startHandler() {\n    const { eventSubscriptions = [] } = this.config\n\n    for (const subscription of eventSubscriptions) {\n      const {\n        sourceEvent, sourceModule, targetModuleFunction,\n      } = subscription\n      if (targetModuleFunction === 'divine') {\n        forget(delayedResolve(this, sourceModule, (sourceModuleInstance: ModuleInstance | null) => {\n          if (isNull(sourceModuleInstance)) {\n            this.logger?.error(`Failed to resolve ${sourceModule} for ${this.modName}`)\n          } else {\n            if (isArchivistInstance(sourceModuleInstance)) {\n              if (sourceEvent === 'inserted') {\n                this._eventUnsubscribeFunctions.push(\n                  sourceModuleInstance.on(sourceEvent, async ({ outPayloads, payloads }) => {\n                    await this.divine((outPayloads ?? payloads) as Payload[] as TIn[])\n                  }),\n                )\n              } else {\n                this.logger?.warn(`Unsupported sourceEvent ${sourceEvent} for ${sourceModuleInstance.modName}`)\n              }\n            } else if (isDivinerInstance(sourceModuleInstance)) {\n              if (sourceEvent === 'divineEnd') {\n                this._eventUnsubscribeFunctions.push(\n                  sourceModuleInstance.on(sourceEvent, async ({ outPayloads }) => {\n                    await this.divine(outPayloads as Payload[] as TIn[])\n                  }),\n                )\n              } else {\n                this.logger?.warn(`Unsupported sourceEvent ${sourceEvent} for ${sourceModuleInstance.modName}`)\n              }\n            } else if (isWitnessInstance(sourceModuleInstance)) {\n              if (sourceEvent === 'observeEnd') {\n                this._eventUnsubscribeFunctions.push(\n                  sourceModuleInstance.on(sourceEvent, async ({ outPayloads }) => {\n                    await this.divine(outPayloads as Payload[] as TIn[])\n                  }),\n                )\n              } else {\n                this.logger?.warn(`Unsupported sourceEvent ${sourceEvent} for ${sourceModuleInstance.modName}`)\n              }\n            }\n          }\n        }, asModuleInstance, undefined, this.logger))\n      }\n    }\n\n    return await super.startHandler()\n  }\n\n  protected override async stopHandler() {\n    for (const unsubscribe of this._eventUnsubscribeFunctions) {\n      unsubscribe()\n    }\n    this._eventUnsubscribeFunctions = []\n    this._eventUnsubscribeFunctions = []\n    return await super.stopHandler()\n  }\n\n  /** @function divineHandler Implement or override to add custom functionality to a diviner */\n  protected abstract divineHandler(payloads?: TIn[]): Promisable<TOut[]>\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/diviner-abstract",
-  "version": "4.0.2",
+  "version": "4.1.0",
   "description": "Primary SDK for using XYO Protocol 2.0",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -21,39 +21,40 @@
   "type": "module",
   "exports": {
     ".": {
-      "types": "./dist/types/index.d.ts",
+      "types": "./dist/neutral/index.d.ts",
       "default": "./dist/neutral/index.mjs"
     },
     "./package.json": "./package.json"
   },
   "module": "dist/neutral/index.mjs",
-  "types": "dist/types/index.d.ts",
+  "types": "dist/neutral/index.d.ts",
   "dependencies": {
-    "@xylabs/assert": "^4.12.33",
-    "@xylabs/base": "^4.12.33",
-    "@xylabs/delay": "^4.12.33",
-    "@xylabs/forget": "^4.12.33",
-    "@xylabs/promise": "^4.12.33",
-    "@xylabs/retry": "^4.12.33",
-    "@xylabs/telemetry": "^4.12.33",
-    "@xylabs/typeof": "^4.12.33",
-    "@xyo-network/account-model": "^4.0.2",
-    "@xyo-network/archivist-model": "^4.0.2",
-    "@xyo-network/boundwitness-model": "^4.0.2",
-    "@xyo-network/boundwitness-wrapper": "^4.0.2",
-    "@xyo-network/diviner-model": "^4.0.2",
-    "@xyo-network/module-abstract": "^4.0.2",
-    "@xyo-network/module-model": "^4.0.2",
-    "@xyo-network/payload-builder": "^4.0.2",
-    "@xyo-network/payload-model": "^4.0.2",
-    "@xyo-network/witness-model": "^4.0.2"
+    "@xylabs/assert": "^4.13.15",
+    "@xylabs/base": "^4.13.15",
+    "@xylabs/delay": "^4.13.15",
+    "@xylabs/forget": "^4.13.15",
+    "@xylabs/object": "^4.13.15",
+    "@xylabs/promise": "^4.13.15",
+    "@xylabs/retry": "^4.13.15",
+    "@xylabs/telemetry": "^4.13.15",
+    "@xylabs/typeof": "^4.13.15",
+    "@xyo-network/account-model": "^4.1.0",
+    "@xyo-network/archivist-model": "^4.1.0",
+    "@xyo-network/boundwitness-model": "^4.1.0",
+    "@xyo-network/boundwitness-wrapper": "^4.1.0",
+    "@xyo-network/diviner-model": "^4.1.0",
+    "@xyo-network/module-abstract": "^4.1.0",
+    "@xyo-network/module-model": "^4.1.0",
+    "@xyo-network/payload-builder": "^4.1.0",
+    "@xyo-network/payload-model": "^4.1.0",
+    "@xyo-network/witness-model": "^4.1.0"
   },
   "devDependencies": {
-    "@xylabs/events": "^4.12.33",
-    "@xylabs/logger": "^4.12.33",
-    "@xylabs/ts-scripts-yarn3": "^6.5.12",
-    "@xylabs/tsconfig": "^6.5.12",
-    "@xyo-network/module-events": "^4.0.2",
+    "@xylabs/events": "^4.13.15",
+    "@xylabs/logger": "^4.13.15",
+    "@xylabs/ts-scripts-yarn3": "^7.0.0-rc.20",
+    "@xylabs/tsconfig": "^7.0.0-rc.20",
+    "@xyo-network/module-events": "^4.1.0",
     "typescript": "^5.8.3"
   },
   "publishConfig": {

package/src/AbstractDiviner.ts

@@ -4,6 +4,7 @@ import { delay } from '@xylabs/delay'
 import type { EventUnsubscribeFunction } from '@xylabs/events'
 import { forget } from '@xylabs/forget'
 import type { Logger } from '@xylabs/logger'
+import type { AsTypeFunction } from '@xylabs/object'
 import type { Promisable } from '@xylabs/promise'
 import type { RetryConfig, RetryConfigWithComplete } from '@xylabs/retry'
 import { retry } from '@xylabs/retry'
@@ -12,7 +13,7 @@ import {
   isDefined, isNull, isUndefined,
 } from '@xylabs/typeof'
 import type { AccountInstance } from '@xyo-network/account-model'
-import { isArchivistInstance } from '@xyo-network/archivist-model'
+import { asArchivistInstance, isArchivistInstance } from '@xyo-network/archivist-model'
 import type { QueryBoundWitness } from '@xyo-network/boundwitness-model'
 import { QueryBoundWitnessWrapper } from '@xyo-network/boundwitness-wrapper'
 import type {
@@ -25,11 +26,13 @@ import type {
   DivinerQueries,
 } from '@xyo-network/diviner-model'
 import {
+  asDivinerInstance,
   DivinerConfigSchema, DivinerDivineQuerySchema, isDivinerInstance,
 } from '@xyo-network/diviner-model'
 import { AbstractModuleInstance } from '@xyo-network/module-abstract'
-import type {
-  ModuleConfig, ModuleIdentifier, ModuleInstance, ModuleQueryHandlerResult, ModuleQueryResult,
+import {
+  asModuleInstance,
+  type ModuleConfig, type ModuleIdentifier, type ModuleInstance, type ModuleQueryHandlerResult, type ModuleQueryResult,
 } from '@xyo-network/module-model'
 import { PayloadBuilder } from '@xyo-network/payload-builder'
 import type {
@@ -37,17 +40,18 @@ import type {
 } from '@xyo-network/payload-model'
 import { isWitnessInstance } from '@xyo-network/witness-model'
 
-const delayedResolve = async (
+const delayedResolve = async <T extends ModuleInstance>(
   parent: ModuleInstance,
   id: ModuleIdentifier,
-  closure: (mod: ModuleInstance | null) => void,
+  closure: (mod: T | null) => void,
+  as: AsTypeFunction<T> = asModuleInstance,
   timeout = 30_000,
   logger?: Logger,
 ) => {
   const start = Date.now()
-  let result: ModuleInstance | undefined
+  let result: T | undefined
   while (isUndefined(result)) {
-    result = await parent.resolve(id)
+    result = as(await parent.resolve(id))
     if (isDefined(result)) {
       closure(result)
       break
@@ -192,7 +196,7 @@ export abstract class AbstractDiviner<
               }
             }
           }
-        }, undefined, this.logger))
+        }, asModuleInstance, undefined, this.logger))
       }
     }
 

package/dist/types/AbstractDiviner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"AbstractDiviner.d.ts","sourceRoot":"","sources":["../../src/AbstractDiviner.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAMzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAA;AAEjE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAA;AAExE,OAAO,KAAK,EACV,yBAAyB,EAEzB,mBAAmB,EACnB,eAAe,EACf,sBAAsB,EACtB,aAAa,EAEd,MAAM,4BAA4B,CAAA;AAInC,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EACV,YAAY,EAAoC,wBAAwB,EAAE,iBAAiB,EAC5F,MAAM,2BAA2B,CAAA;AAElC,OAAO,KAAK,EACV,OAAO,EAAE,MAAM,EAChB,MAAM,4BAA4B,CAAA;AAyBnC,8BAAsB,eAAe,CACnC,OAAO,SAAS,aAAa,GAAG,aAAa,EAC7C,GAAG,SAAS,OAAO,GAAG,OAAO,EAC7B,IAAI,SAAS,OAAO,GAAG,OAAO,EAC9B,UAAU,SAAS,sBAAsB,CAAC,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,sBAAsB,CAChH,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EACnC,GAAG,EACH,IAAI,CACL,CAED,SAAQ,sBAAsB,CAAC,OAAO,EAAE,UAAU,CAClD,YAAW,yBAAyB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC;IACpE,gBAAyB,aAAa,EAAE,MAAM,EAAE,CAAgD;IAChG,gBAAyB,mBAAmB,EAAE,MAAM,CAAsB;IAC1E,MAAM,CAAC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAA;IACpC,gBAAyB,UAAU,SAA4D;IAE/F,OAAO,CAAC,0BAA0B,CAAiC;IAEnE,IAAa,OAAO,IAAI,MAAM,EAAE,CAE/B;IAED,sJAAsJ;IAChJ,MAAM,CAAC,QAAQ,GAAE,GAAG,EAAO,EAAE,aAAa,CAAC,EAAE,uBAAuB,GAAG,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE,CAAC;IAmC3G,WAAW,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,EAAE,OAAO,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAMtH,uGAAuG;cAC9E,YAAY,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,EAAE,OAAO,SAAS,YAAY,GAAG,YAAY,EAChI,KAAK,EAAE,CAAC,EACR,QAAQ,CAAC,EAAE,OAAO,EAAE,EACpB,WAAW,CAAC,EAAE,OAAO,GACpB,OAAO,CAAC,wBAAwB,CAAC;cAmBX,YAAY;cAmDZ,WAAW;IASpC,6FAA6F;IAC7F,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;CACvE"}