@xyo-network/diviner-stateful 3.8.0 → 3.8.1

package/dist/neutral/index.mjs

@@ -78,7 +78,7 @@ var StatefulDiviner = class extends AbstractDiviner {
     if (this._lastState) return this._lastState;
     let hash = "";
     const diviner = await this.getBoundWitnessDivinerForStateStore();
-    const query = await new PayloadBuilder({ schema: BoundWitnessDivinerQuerySchema }).fields({
+    const query = new PayloadBuilder({ schema: BoundWitnessDivinerQuerySchema }).fields({
       address: this.account.address,
       limit: 1,
       cursor: SequenceConstants.minLocalSequence,
@@ -135,7 +135,7 @@ var StatefulModuleMixin = (ModuleBase) => {
       if (toJson2(nextState.state) === toJson2(this._lastState?.state)) return;
       this._lastState = nextState;
       const archivist = await this.getArchivistForStore();
-      const [bw] = await (await new BoundWitnessBuilder2().payload(nextState)).build();
+      const [bw] = await new BoundWitnessBuilder2().payload(nextState).build();
       await archivist.insert([bw, nextState]);
     }
     /**
@@ -182,7 +182,7 @@ var StatefulModuleMixin = (ModuleBase) => {
       if (this._lastState) return this._lastState;
       let hash = "";
       const diviner = await this.getBoundWitnessDivinerForStore();
-      const query = await new PayloadBuilder2({ schema: BoundWitnessDivinerQuerySchema2 }).fields({
+      const query = new PayloadBuilder2({ schema: BoundWitnessDivinerQuerySchema2 }).fields({
         // address: this.account.address,
         limit: 1,
         cursor: SequenceConstants2.minLocalSequence,

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/Schema.ts","../../src/Config.ts","../../src/Diviner.ts","../../src/DivinerMixin.ts"],"sourcesContent":["export const StatefulDivinerSchema = 'network.xyo.diviner.stateful' as const\nexport type StatefulDivinerSchema = typeof StatefulDivinerSchema\n","import type { DivinerConfig } from '@xyo-network/diviner-model'\nimport type { ModuleIdentifier } from '@xyo-network/module-model'\n\nimport { StatefulDivinerSchema } from './Schema.ts'\n\n/**\n * The schema for a Stateful Diviner config\n */\nexport const StatefulDivinerConfigSchema = `${StatefulDivinerSchema}.config` as const\n/**\n * The schema for a Stateful Diviner config\n */\nexport type StatefulDivinerConfigSchema = typeof StatefulDivinerConfigSchema\n\n/**\n * The config for a Stateful Diviner\n */\nexport type StatefulDivinerConfig = DivinerConfig<{\n  schema: StatefulDivinerConfigSchema\n  stateStore: {\n    archivist: ModuleIdentifier\n    boundWitnessDiviner: ModuleIdentifier\n    payloadDiviner: ModuleIdentifier\n  }\n}>\n","import { assertEx } from '@xylabs/assert'\nimport type { Hash } from '@xylabs/hex'\nimport { toJson } from '@xylabs/object'\nimport { ArchivistWrapper } from '@xyo-network/archivist-wrapper'\nimport { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'\nimport { isBoundWitness } from '@xyo-network/boundwitness-model'\nimport { AbstractDiviner } from '@xyo-network/diviner-abstract'\nimport type { BoundWitnessDivinerQueryPayload } from '@xyo-network/diviner-boundwitness-model'\nimport { BoundWitnessDivinerQuerySchema } from '@xyo-network/diviner-boundwitness-model'\nimport type { DivinerInstance, DivinerModuleEventData } from '@xyo-network/diviner-model'\nimport { DivinerWrapper } from '@xyo-network/diviner-wrapper'\nimport type { ModuleState, StateDictionary } from '@xyo-network/module-model'\nimport { isModuleState, ModuleStateSchema } from '@xyo-network/module-model'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport {\n  type Payload, type Schema, SequenceConstants,\n  type WithStorageMeta,\n} from '@xyo-network/payload-model'\n\nimport { StatefulDivinerConfigSchema } from './Config.ts'\nimport type { StatefulDivinerParams } from './Params.ts'\n\nconst moduleName = 'StatefulDiviner'\n\n/**\n * A Diviner that maintains state\n */\nexport abstract class StatefulDiviner<\n  TParams extends StatefulDivinerParams = StatefulDivinerParams,\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  TState extends StateDictionary = StateDictionary,\n> extends AbstractDiviner<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, StatefulDivinerConfigSchema]\n  static override readonly defaultConfigSchema: Schema = StatefulDivinerConfigSchema\n\n  /**\n   * The last state\n   */\n  protected _lastState?: ModuleState<TState>\n\n  /**\n   * Commit the internal state of the Diviner process. This is similar\n   * to a transaction completion in a database and should only be called\n   * when results have been successfully persisted to the appropriate\n   * external stores.\n   * @param nextState The state to commit\n   */\n  protected async commitState(nextState: ModuleState<TState>) {\n    // Don't commit state if no state has changed\n    if (toJson(nextState.state) === toJson(this._lastState?.state)) return\n    this._lastState = nextState\n    const archivist = await this.getArchivistForStateStore()\n    const [bw] = await new BoundWitnessBuilder().payload(nextState).signer(this.account).build()\n    await archivist.insert([bw, nextState])\n  }\n\n  /**\n   * Retrieves the archivist for the specified store\n   * @param store The store to retrieve the archivist for\n   * @returns The archivist for the specified store\n   */\n  protected async getArchivistForStateStore() {\n    const name = assertEx(this.config?.stateStore.archivist, () => `${moduleName}: Config for stateStore.archivist not specified`)\n    const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.archivist`)\n    return ArchivistWrapper.wrap(mod, this.account)\n  }\n\n  /**\n   * Retrieves the BoundWitness Diviner for the specified store\n   * @param store The store to retrieve the BoundWitness Diviner for\n   * @returns The BoundWitness Diviner for the specified store\n   */\n  protected async getBoundWitnessDivinerForStateStore() {\n    const name = assertEx(this.config?.stateStore.boundWitnessDiviner, () => `${moduleName}: Config for stateStore.boundWitnessDiviner not specified`)\n    const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.boundWitnessDiviner`)\n    return DivinerWrapper.wrap(mod, this.account)\n  }\n\n  /**\n   * Retrieves the Payload Diviner for the specified store\n   * @param store The store to retrieve the Payload Diviner for\n   * @returns The Payload Diviner for the specified store\n   */\n  protected async getPayloadDivinerForStateStore() {\n    const name = assertEx(this.config?.stateStore?.payloadDiviner, () => `${moduleName}: Config for stateStore.payloadDiviner not specified`)\n    const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.payloadDiviner`)\n    return DivinerWrapper.wrap(mod, this.account)\n  }\n\n  /**\n   * Retrieves the last state of the Diviner process. Used to recover state after\n   * preemptions, reboots, etc.\n   */\n  protected async retrieveState(): Promise<ModuleState<TState> | undefined> {\n    if (this._lastState) return this._lastState\n    let hash: Hash = ''\n    const diviner = await this.getBoundWitnessDivinerForStateStore()\n    const query = await new PayloadBuilder<BoundWitnessDivinerQueryPayload>({ schema: BoundWitnessDivinerQuerySchema })\n      .fields({\n        address: this.account.address,\n        limit: 1,\n        cursor: SequenceConstants.minLocalSequence,\n        order: 'desc',\n        payload_schemas: [ModuleStateSchema],\n      })\n      .build()\n    const boundWitnesses = await diviner.divine([query])\n    if (boundWitnesses.length > 0) {\n      const boundWitness = boundWitnesses[0]\n      if (isBoundWitness(boundWitness)) {\n        // Find the index for this address in the BoundWitness that is a ModuleState\n        hash = boundWitness.addresses\n          .map((address, index) => ({ address, index }))\n          .filter(({ address }) => address === this.account.address)\n          // eslint-disable-next-line unicorn/no-array-reduce\n          .reduce(\n            (prev, curr) => (boundWitness.payload_schemas?.[curr?.index] === ModuleStateSchema ? boundWitness.payload_hashes[curr?.index] : prev),\n            '' as Hash,\n          )\n      }\n    }\n\n    // If we able to located the last state\n    if (hash) {\n      // Get last state\n      const archivist = await this.getArchivistForStateStore()\n      const payload = (await archivist.get([hash])).find(isModuleState<TState>)\n      if (payload) {\n        return payload as WithStorageMeta<ModuleState<TState>>\n      }\n    }\n    return undefined\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport type { Hash } from '@xylabs/hex'\nimport { toJson } from '@xylabs/object'\nimport { asArchivistInstance } from '@xyo-network/archivist-model'\nimport { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'\nimport { isBoundWitness } from '@xyo-network/boundwitness-model'\nimport type { BoundWitnessDivinerQueryPayload } from '@xyo-network/diviner-boundwitness-model'\nimport { BoundWitnessDivinerQuerySchema } from '@xyo-network/diviner-boundwitness-model'\nimport { asDivinerInstance } from '@xyo-network/diviner-model'\nimport type {\n  AnyConfigSchema,\n  ModuleInstance,\n  ModuleParams,\n  ModuleState,\n  StateDictionary,\n} from '@xyo-network/module-model'\nimport {\n  isModuleState,\n  ModuleStateSchema,\n} from '@xyo-network/module-model'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport { SequenceConstants, type WithStorageMeta } from '@xyo-network/payload-model'\n\nimport type { StatefulDivinerConfig } from './Config.ts'\n\nexport type StatefulModuleParams = ModuleParams<AnyConfigSchema<StatefulDivinerConfig>>\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyModule<TParams extends StatefulModuleParams = StatefulModuleParams> = new (...args: any[]) => ModuleInstance<TParams>\n\nconst moduleName = 'StatefulModuleMixin'\n\n/**\n * @ignore Inherit from StatefulDiviner instead\n * @param ModuleBase\n * @returns\n */\nexport const StatefulModuleMixin = <\n  TParams extends StatefulModuleParams = StatefulModuleParams,\n  TModule extends AnyModule<TParams> = AnyModule<TParams>,\n  TState extends StateDictionary = StateDictionary,\n>(\n  ModuleBase: TModule,\n) => {\n  abstract class StatefulModuleBase extends ModuleBase {\n    _lastState?: ModuleState<TState>\n\n    /**\n     * Commit the internal state of the Diviner process. This is similar\n     * to a transaction completion in a database and should only be called\n     * when results have been successfully persisted to the appropriate\n     * external stores.\n     * @param nextState The state to commit\n     */\n    async commitState(nextState: ModuleState<TState>) {\n      // Don't commit state if no state has changed\n      if (toJson(nextState.state) === toJson(this._lastState?.state)) return\n      this._lastState = nextState\n      const archivist = await this.getArchivistForStore()\n      // const [bw] = await new BoundWitnessBuilder().payload(nextState).signer(this.account).build()\n      const [bw] = await (await new BoundWitnessBuilder().payload(nextState)).build()\n      await archivist.insert([bw, nextState])\n    }\n\n    /**\n     * Retrieves the archivist for the specified store\n     * @param store The store to retrieve the archivist for\n     * @returns The archivist for the specified store\n     */\n    async getArchivistForStore() {\n      const name = assertEx(this.config?.stateStore?.archivist, () => `${moduleName}: Config for stateStore.archivist not specified`)\n      const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.archivist`)\n      // return ArchivistWrapper.wrap(mod, this.account)\n      const instance = asArchivistInstance(mod)\n      return assertEx(instance, () => `${moduleName}: Failed to wrap archivist instance`)\n    }\n\n    /**\n     * Retrieves the BoundWitness Diviner for the specified store\n     * @param store The store to retrieve the BoundWitness Diviner for\n     * @returns The BoundWitness Diviner for the specified store\n     */\n    async getBoundWitnessDivinerForStore() {\n      const name = assertEx(\n        this.config?.stateStore?.boundWitnessDiviner,\n        () => `${moduleName}: Config for stateStore.boundWitnessDiviner not specified`,\n      )\n      const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.boundWitnessDiviner`)\n      // return DivinerWrapper.wrap(mod, this.account)\n      const instance = asDivinerInstance(mod)\n      return assertEx(instance, () => `${moduleName}: Failed to wrap diviner instance`)\n    }\n\n    /**\n     * Retrieves the Payload Diviner for the specified store\n     * @param store The store to retrieve the Payload Diviner for\n     * @returns The Payload Diviner for the specified store\n     */\n    async getPayloadDivinerForStateStore() {\n      const name = assertEx(this.config?.stateStore?.payloadDiviner, () => `${moduleName}: Config for stateStore.payloadDiviner not specified`)\n      const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.payloadDiviner`)\n      // return DivinerWrapper.wrap(mod, this.account)\n      const instance = asDivinerInstance(mod)\n      return assertEx(instance, () => `${moduleName}: Failed to wrap diviner instance`)\n    }\n\n    /**\n     * Retrieves the last state of the Diviner process. Used to recover state after\n     * preemptions, reboots, etc.\n     */\n    async retrieveState(): Promise<ModuleState<TState> | undefined> {\n      if (this._lastState) return this._lastState\n      let hash: Hash = ''\n      const diviner = await this.getBoundWitnessDivinerForStore()\n      const query = await new PayloadBuilder<BoundWitnessDivinerQueryPayload>({ schema: BoundWitnessDivinerQuerySchema })\n        .fields({\n          // address: this.account.address,\n          limit: 1,\n          cursor: SequenceConstants.minLocalSequence,\n          order: 'desc',\n          payload_schemas: [ModuleStateSchema],\n        })\n        .build()\n      const boundWitnesses = await diviner.divine([query])\n      if (boundWitnesses.length > 0) {\n        const boundWitness = boundWitnesses[0]\n        if (isBoundWitness(boundWitness)) {\n          // Find the index for this address in the BoundWitness that is a ModuleState\n          hash = boundWitness.addresses\n            .map((address, index) => ({ address, index }))\n            // .filter(({ address }) => address === this.account.address)\n            // eslint-disable-next-line unicorn/no-array-reduce\n            .reduce(\n              (prev, curr) => (boundWitness.payload_schemas?.[curr?.index] === ModuleStateSchema ? boundWitness.payload_hashes[curr?.index] : prev),\n              '' as Hash,\n            )\n        }\n      }\n\n      // If we able to located the last state\n      if (hash) {\n        // Get last state\n        const archivist = await this.getArchivistForStore()\n        const payload = (await archivist.get([hash])).find(isModuleState<TState>)\n        if (payload) {\n          return payload as WithStorageMeta<ModuleState<TState>>\n        }\n      }\n      return undefined\n    }\n  }\n  return StatefulModuleBase\n}\n"],"mappings":"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","names":["assertEx","toJson","BoundWitnessBuilder","isBoundWitness","BoundWitnessDivinerQuerySchema","isModuleState","ModuleStateSchema","PayloadBuilder","SequenceConstants","moduleName"]}
+{"version":3,"sources":["../../src/Schema.ts","../../src/Config.ts","../../src/Diviner.ts","../../src/DivinerMixin.ts"],"sourcesContent":["export const StatefulDivinerSchema = 'network.xyo.diviner.stateful' as const\nexport type StatefulDivinerSchema = typeof StatefulDivinerSchema\n","import type { DivinerConfig } from '@xyo-network/diviner-model'\nimport type { ModuleIdentifier } from '@xyo-network/module-model'\n\nimport { StatefulDivinerSchema } from './Schema.ts'\n\n/**\n * The schema for a Stateful Diviner config\n */\nexport const StatefulDivinerConfigSchema = `${StatefulDivinerSchema}.config` as const\n/**\n * The schema for a Stateful Diviner config\n */\nexport type StatefulDivinerConfigSchema = typeof StatefulDivinerConfigSchema\n\n/**\n * The config for a Stateful Diviner\n */\nexport type StatefulDivinerConfig = DivinerConfig<{\n  schema: StatefulDivinerConfigSchema\n  stateStore: {\n    archivist: ModuleIdentifier\n    boundWitnessDiviner: ModuleIdentifier\n    payloadDiviner: ModuleIdentifier\n  }\n}>\n","import { assertEx } from '@xylabs/assert'\nimport type { Hash } from '@xylabs/hex'\nimport { toJson } from '@xylabs/object'\nimport { ArchivistWrapper } from '@xyo-network/archivist-wrapper'\nimport { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'\nimport { isBoundWitness } from '@xyo-network/boundwitness-model'\nimport { AbstractDiviner } from '@xyo-network/diviner-abstract'\nimport type { BoundWitnessDivinerQueryPayload } from '@xyo-network/diviner-boundwitness-model'\nimport { BoundWitnessDivinerQuerySchema } from '@xyo-network/diviner-boundwitness-model'\nimport type { DivinerInstance, DivinerModuleEventData } from '@xyo-network/diviner-model'\nimport { DivinerWrapper } from '@xyo-network/diviner-wrapper'\nimport type { ModuleState, StateDictionary } from '@xyo-network/module-model'\nimport { isModuleState, ModuleStateSchema } from '@xyo-network/module-model'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport {\n  type Payload, type Schema, SequenceConstants,\n  type WithStorageMeta,\n} from '@xyo-network/payload-model'\n\nimport { StatefulDivinerConfigSchema } from './Config.ts'\nimport type { StatefulDivinerParams } from './Params.ts'\n\nconst moduleName = 'StatefulDiviner'\n\n/**\n * A Diviner that maintains state\n */\nexport abstract class StatefulDiviner<\n  TParams extends StatefulDivinerParams = StatefulDivinerParams,\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  TState extends StateDictionary = StateDictionary,\n> extends AbstractDiviner<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: Schema[] = [...super.configSchemas, StatefulDivinerConfigSchema]\n  static override readonly defaultConfigSchema: Schema = StatefulDivinerConfigSchema\n\n  /**\n   * The last state\n   */\n  protected _lastState?: ModuleState<TState>\n\n  /**\n   * Commit the internal state of the Diviner process. This is similar\n   * to a transaction completion in a database and should only be called\n   * when results have been successfully persisted to the appropriate\n   * external stores.\n   * @param nextState The state to commit\n   */\n  protected async commitState(nextState: ModuleState<TState>) {\n    // Don't commit state if no state has changed\n    if (toJson(nextState.state) === toJson(this._lastState?.state)) return\n    this._lastState = nextState\n    const archivist = await this.getArchivistForStateStore()\n    const [bw] = await new BoundWitnessBuilder().payload(nextState).signer(this.account).build()\n    await archivist.insert([bw, nextState])\n  }\n\n  /**\n   * Retrieves the archivist for the specified store\n   * @param store The store to retrieve the archivist for\n   * @returns The archivist for the specified store\n   */\n  protected async getArchivistForStateStore() {\n    const name = assertEx(this.config?.stateStore.archivist, () => `${moduleName}: Config for stateStore.archivist not specified`)\n    const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.archivist`)\n    return ArchivistWrapper.wrap(mod, this.account)\n  }\n\n  /**\n   * Retrieves the BoundWitness Diviner for the specified store\n   * @param store The store to retrieve the BoundWitness Diviner for\n   * @returns The BoundWitness Diviner for the specified store\n   */\n  protected async getBoundWitnessDivinerForStateStore() {\n    const name = assertEx(this.config?.stateStore.boundWitnessDiviner, () => `${moduleName}: Config for stateStore.boundWitnessDiviner not specified`)\n    const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.boundWitnessDiviner`)\n    return DivinerWrapper.wrap(mod, this.account)\n  }\n\n  /**\n   * Retrieves the Payload Diviner for the specified store\n   * @param store The store to retrieve the Payload Diviner for\n   * @returns The Payload Diviner for the specified store\n   */\n  protected async getPayloadDivinerForStateStore() {\n    const name = assertEx(this.config?.stateStore?.payloadDiviner, () => `${moduleName}: Config for stateStore.payloadDiviner not specified`)\n    const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.payloadDiviner`)\n    return DivinerWrapper.wrap(mod, this.account)\n  }\n\n  /**\n   * Retrieves the last state of the Diviner process. Used to recover state after\n   * preemptions, reboots, etc.\n   */\n  protected async retrieveState(): Promise<ModuleState<TState> | undefined> {\n    if (this._lastState) return this._lastState\n    let hash: Hash = ''\n    const diviner = await this.getBoundWitnessDivinerForStateStore()\n    const query = new PayloadBuilder<BoundWitnessDivinerQueryPayload>({ schema: BoundWitnessDivinerQuerySchema })\n      .fields({\n        address: this.account.address,\n        limit: 1,\n        cursor: SequenceConstants.minLocalSequence,\n        order: 'desc',\n        payload_schemas: [ModuleStateSchema],\n      })\n      .build()\n    const boundWitnesses = await diviner.divine([query])\n    if (boundWitnesses.length > 0) {\n      const boundWitness = boundWitnesses[0]\n      if (isBoundWitness(boundWitness)) {\n        // Find the index for this address in the BoundWitness that is a ModuleState\n        hash = boundWitness.addresses\n          .map((address, index) => ({ address, index }))\n          .filter(({ address }) => address === this.account.address)\n          // eslint-disable-next-line unicorn/no-array-reduce\n          .reduce(\n            (prev, curr) => (boundWitness.payload_schemas?.[curr?.index] === ModuleStateSchema ? boundWitness.payload_hashes[curr?.index] : prev),\n            '' as Hash,\n          )\n      }\n    }\n\n    // If we able to located the last state\n    if (hash) {\n      // Get last state\n      const archivist = await this.getArchivistForStateStore()\n      const payload = (await archivist.get([hash])).find(isModuleState<TState>)\n      if (payload) {\n        return payload as WithStorageMeta<ModuleState<TState>>\n      }\n    }\n    return undefined\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport type { Hash } from '@xylabs/hex'\nimport { toJson } from '@xylabs/object'\nimport { asArchivistInstance } from '@xyo-network/archivist-model'\nimport { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'\nimport { isBoundWitness } from '@xyo-network/boundwitness-model'\nimport type { BoundWitnessDivinerQueryPayload } from '@xyo-network/diviner-boundwitness-model'\nimport { BoundWitnessDivinerQuerySchema } from '@xyo-network/diviner-boundwitness-model'\nimport { asDivinerInstance } from '@xyo-network/diviner-model'\nimport type {\n  AnyConfigSchema,\n  ModuleInstance,\n  ModuleParams,\n  ModuleState,\n  StateDictionary,\n} from '@xyo-network/module-model'\nimport {\n  isModuleState,\n  ModuleStateSchema,\n} from '@xyo-network/module-model'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport { SequenceConstants, type WithStorageMeta } from '@xyo-network/payload-model'\n\nimport type { StatefulDivinerConfig } from './Config.ts'\n\nexport type StatefulModuleParams = ModuleParams<AnyConfigSchema<StatefulDivinerConfig>>\n\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport type AnyModule<TParams extends StatefulModuleParams = StatefulModuleParams> = new (...args: any[]) => ModuleInstance<TParams>\n\nconst moduleName = 'StatefulModuleMixin'\n\n/**\n * @ignore Inherit from StatefulDiviner instead\n * @param ModuleBase\n * @returns\n */\nexport const StatefulModuleMixin = <\n  TParams extends StatefulModuleParams = StatefulModuleParams,\n  TModule extends AnyModule<TParams> = AnyModule<TParams>,\n  TState extends StateDictionary = StateDictionary,\n>(\n  ModuleBase: TModule,\n) => {\n  abstract class StatefulModuleBase extends ModuleBase {\n    _lastState?: ModuleState<TState>\n\n    /**\n     * Commit the internal state of the Diviner process. This is similar\n     * to a transaction completion in a database and should only be called\n     * when results have been successfully persisted to the appropriate\n     * external stores.\n     * @param nextState The state to commit\n     */\n    async commitState(nextState: ModuleState<TState>) {\n      // Don't commit state if no state has changed\n      if (toJson(nextState.state) === toJson(this._lastState?.state)) return\n      this._lastState = nextState\n      const archivist = await this.getArchivistForStore()\n      // const [bw] = await new BoundWitnessBuilder().payload(nextState).signer(this.account).build()\n      const [bw] = await new BoundWitnessBuilder().payload(nextState).build()\n      await archivist.insert([bw, nextState])\n    }\n\n    /**\n     * Retrieves the archivist for the specified store\n     * @param store The store to retrieve the archivist for\n     * @returns The archivist for the specified store\n     */\n    async getArchivistForStore() {\n      const name = assertEx(this.config?.stateStore?.archivist, () => `${moduleName}: Config for stateStore.archivist not specified`)\n      const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.archivist`)\n      // return ArchivistWrapper.wrap(mod, this.account)\n      const instance = asArchivistInstance(mod)\n      return assertEx(instance, () => `${moduleName}: Failed to wrap archivist instance`)\n    }\n\n    /**\n     * Retrieves the BoundWitness Diviner for the specified store\n     * @param store The store to retrieve the BoundWitness Diviner for\n     * @returns The BoundWitness Diviner for the specified store\n     */\n    async getBoundWitnessDivinerForStore() {\n      const name = assertEx(\n        this.config?.stateStore?.boundWitnessDiviner,\n        () => `${moduleName}: Config for stateStore.boundWitnessDiviner not specified`,\n      )\n      const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.boundWitnessDiviner`)\n      // return DivinerWrapper.wrap(mod, this.account)\n      const instance = asDivinerInstance(mod)\n      return assertEx(instance, () => `${moduleName}: Failed to wrap diviner instance`)\n    }\n\n    /**\n     * Retrieves the Payload Diviner for the specified store\n     * @param store The store to retrieve the Payload Diviner for\n     * @returns The Payload Diviner for the specified store\n     */\n    async getPayloadDivinerForStateStore() {\n      const name = assertEx(this.config?.stateStore?.payloadDiviner, () => `${moduleName}: Config for stateStore.payloadDiviner not specified`)\n      const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.payloadDiviner`)\n      // return DivinerWrapper.wrap(mod, this.account)\n      const instance = asDivinerInstance(mod)\n      return assertEx(instance, () => `${moduleName}: Failed to wrap diviner instance`)\n    }\n\n    /**\n     * Retrieves the last state of the Diviner process. Used to recover state after\n     * preemptions, reboots, etc.\n     */\n    async retrieveState(): Promise<ModuleState<TState> | undefined> {\n      if (this._lastState) return this._lastState\n      let hash: Hash = ''\n      const diviner = await this.getBoundWitnessDivinerForStore()\n      const query = new PayloadBuilder<BoundWitnessDivinerQueryPayload>({ schema: BoundWitnessDivinerQuerySchema })\n        .fields({\n          // address: this.account.address,\n          limit: 1,\n          cursor: SequenceConstants.minLocalSequence,\n          order: 'desc',\n          payload_schemas: [ModuleStateSchema],\n        })\n        .build()\n      const boundWitnesses = await diviner.divine([query])\n      if (boundWitnesses.length > 0) {\n        const boundWitness = boundWitnesses[0]\n        if (isBoundWitness(boundWitness)) {\n          // Find the index for this address in the BoundWitness that is a ModuleState\n          hash = boundWitness.addresses\n            .map((address, index) => ({ address, index }))\n            // .filter(({ address }) => address === this.account.address)\n            // eslint-disable-next-line unicorn/no-array-reduce\n            .reduce(\n              (prev, curr) => (boundWitness.payload_schemas?.[curr?.index] === ModuleStateSchema ? boundWitness.payload_hashes[curr?.index] : prev),\n              '' as Hash,\n            )\n        }\n      }\n\n      // If we able to located the last state\n      if (hash) {\n        // Get last state\n        const archivist = await this.getArchivistForStore()\n        const payload = (await archivist.get([hash])).find(isModuleState<TState>)\n        if (payload) {\n          return payload as WithStorageMeta<ModuleState<TState>>\n        }\n      }\n      return undefined\n    }\n  }\n  return StatefulModuleBase\n}\n"],"mappings":";AAAO,IAAM,wBAAwB;;;ACQ9B,IAAM,8BAA8B,GAAG,qBAAqB;;;ACRnE,SAAS,gBAAgB;AAEzB,SAAS,cAAc;AACvB,SAAS,wBAAwB;AACjC,SAAS,2BAA2B;AACpC,SAAS,sBAAsB;AAC/B,SAAS,uBAAuB;AAEhC,SAAS,sCAAsC;AAE/C,SAAS,sBAAsB;AAE/B,SAAS,eAAe,yBAAyB;AACjD,SAAS,sBAAsB;AAC/B;AAAA,EAC6B;AAAA,OAEtB;AAKP,IAAM,aAAa;AAKZ,IAAe,kBAAf,cAUG,gBAAgD;AAAA,EACxD,OAAyB,gBAA0B,CAAC,GAAG,MAAM,eAAe,2BAA2B;AAAA,EACvG,OAAyB,sBAA8B;AAAA;AAAA;AAAA;AAAA,EAK7C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASV,MAAgB,YAAY,WAAgC;AAE1D,QAAI,OAAO,UAAU,KAAK,MAAM,OAAO,KAAK,YAAY,KAAK,EAAG;AAChE,SAAK,aAAa;AAClB,UAAM,YAAY,MAAM,KAAK,0BAA0B;AACvD,UAAM,CAAC,EAAE,IAAI,MAAM,IAAI,oBAAoB,EAAE,QAAQ,SAAS,EAAE,OAAO,KAAK,OAAO,EAAE,MAAM;AAC3F,UAAM,UAAU,OAAO,CAAC,IAAI,SAAS,CAAC;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAgB,4BAA4B;AAC1C,UAAM,OAAO,SAAS,KAAK,QAAQ,WAAW,WAAW,MAAM,GAAG,UAAU,iDAAiD;AAC7H,UAAM,MAAM,SAAS,MAAM,KAAK,QAAQ,IAAI,GAAG,MAAM,GAAG,UAAU,0CAA0C;AAC5G,WAAO,iBAAiB,KAAK,KAAK,KAAK,OAAO;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAgB,sCAAsC;AACpD,UAAM,OAAO,SAAS,KAAK,QAAQ,WAAW,qBAAqB,MAAM,GAAG,UAAU,2DAA2D;AACjJ,UAAM,MAAM,SAAS,MAAM,KAAK,QAAQ,IAAI,GAAG,MAAM,GAAG,UAAU,oDAAoD;AACtH,WAAO,eAAe,KAAK,KAAK,KAAK,OAAO;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAgB,iCAAiC;AAC/C,UAAM,OAAO,SAAS,KAAK,QAAQ,YAAY,gBAAgB,MAAM,GAAG,UAAU,sDAAsD;AACxI,UAAM,MAAM,SAAS,MAAM,KAAK,QAAQ,IAAI,GAAG,MAAM,GAAG,UAAU,+CAA+C;AACjH,WAAO,eAAe,KAAK,KAAK,KAAK,OAAO;AAAA,EAC9C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAgB,gBAA0D;AACxE,QAAI,KAAK,WAAY,QAAO,KAAK;AACjC,QAAI,OAAa;AACjB,UAAM,UAAU,MAAM,KAAK,oCAAoC;AAC/D,UAAM,QAAQ,IAAI,eAAgD,EAAE,QAAQ,+BAA+B,CAAC,EACzG,OAAO;AAAA,MACN,SAAS,KAAK,QAAQ;AAAA,MACtB,OAAO;AAAA,MACP,QAAQ,kBAAkB;AAAA,MAC1B,OAAO;AAAA,MACP,iBAAiB,CAAC,iBAAiB;AAAA,IACrC,CAAC,EACA,MAAM;AACT,UAAM,iBAAiB,MAAM,QAAQ,OAAO,CAAC,KAAK,CAAC;AACnD,QAAI,eAAe,SAAS,GAAG;AAC7B,YAAM,eAAe,eAAe,CAAC;AACrC,UAAI,eAAe,YAAY,GAAG;AAEhC,eAAO,aAAa,UACjB,IAAI,CAAC,SAAS,WAAW,EAAE,SAAS,MAAM,EAAE,EAC5C,OAAO,CAAC,EAAE,QAAQ,MAAM,YAAY,KAAK,QAAQ,OAAO,EAExD;AAAA,UACC,CAAC,MAAM,SAAU,aAAa,kBAAkB,MAAM,KAAK,MAAM,oBAAoB,aAAa,eAAe,MAAM,KAAK,IAAI;AAAA,UAChI;AAAA,QACF;AAAA,MACJ;AAAA,IACF;AAGA,QAAI,MAAM;AAER,YAAM,YAAY,MAAM,KAAK,0BAA0B;AACvD,YAAM,WAAW,MAAM,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,KAAK,aAAqB;AACxE,UAAI,SAAS;AACX,eAAO;AAAA,MACT;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACF;;;AC3IA,SAAS,YAAAA,iBAAgB;AAEzB,SAAS,UAAAC,eAAc;AACvB,SAAS,2BAA2B;AACpC,SAAS,uBAAAC,4BAA2B;AACpC,SAAS,kBAAAC,uBAAsB;AAE/B,SAAS,kCAAAC,uCAAsC;AAC/C,SAAS,yBAAyB;AAQlC;AAAA,EACE,iBAAAC;AAAA,EACA,qBAAAC;AAAA,OACK;AACP,SAAS,kBAAAC,uBAAsB;AAC/B,SAAS,qBAAAC,0BAA+C;AASxD,IAAMC,cAAa;AAOZ,IAAM,sBAAsB,CAKjC,eACG;AAAA,EACH,MAAe,2BAA2B,WAAW;AAAA,IACnD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IASA,MAAM,YAAY,WAAgC;AAEhD,UAAIR,QAAO,UAAU,KAAK,MAAMA,QAAO,KAAK,YAAY,KAAK,EAAG;AAChE,WAAK,aAAa;AAClB,YAAM,YAAY,MAAM,KAAK,qBAAqB;AAElD,YAAM,CAAC,EAAE,IAAI,MAAM,IAAIC,qBAAoB,EAAE,QAAQ,SAAS,EAAE,MAAM;AACtE,YAAM,UAAU,OAAO,CAAC,IAAI,SAAS,CAAC;AAAA,IACxC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,MAAM,uBAAuB;AAC3B,YAAM,OAAOF,UAAS,KAAK,QAAQ,YAAY,WAAW,MAAM,GAAGS,WAAU,iDAAiD;AAC9H,YAAM,MAAMT,UAAS,MAAM,KAAK,QAAQ,IAAI,GAAG,MAAM,GAAGS,WAAU,0CAA0C;AAE5G,YAAM,WAAW,oBAAoB,GAAG;AACxC,aAAOT,UAAS,UAAU,MAAM,GAAGS,WAAU,qCAAqC;AAAA,IACpF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,MAAM,iCAAiC;AACrC,YAAM,OAAOT;AAAA,QACX,KAAK,QAAQ,YAAY;AAAA,QACzB,MAAM,GAAGS,WAAU;AAAA,MACrB;AACA,YAAM,MAAMT,UAAS,MAAM,KAAK,QAAQ,IAAI,GAAG,MAAM,GAAGS,WAAU,oDAAoD;AAEtH,YAAM,WAAW,kBAAkB,GAAG;AACtC,aAAOT,UAAS,UAAU,MAAM,GAAGS,WAAU,mCAAmC;AAAA,IAClF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAOA,MAAM,iCAAiC;AACrC,YAAM,OAAOT,UAAS,KAAK,QAAQ,YAAY,gBAAgB,MAAM,GAAGS,WAAU,sDAAsD;AACxI,YAAM,MAAMT,UAAS,MAAM,KAAK,QAAQ,IAAI,GAAG,MAAM,GAAGS,WAAU,+CAA+C;AAEjH,YAAM,WAAW,kBAAkB,GAAG;AACtC,aAAOT,UAAS,UAAU,MAAM,GAAGS,WAAU,mCAAmC;AAAA,IAClF;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,MAAM,gBAA0D;AAC9D,UAAI,KAAK,WAAY,QAAO,KAAK;AACjC,UAAI,OAAa;AACjB,YAAM,UAAU,MAAM,KAAK,+BAA+B;AAC1D,YAAM,QAAQ,IAAIF,gBAAgD,EAAE,QAAQH,gCAA+B,CAAC,EACzG,OAAO;AAAA;AAAA,QAEN,OAAO;AAAA,QACP,QAAQI,mBAAkB;AAAA,QAC1B,OAAO;AAAA,QACP,iBAAiB,CAACF,kBAAiB;AAAA,MACrC,CAAC,EACA,MAAM;AACT,YAAM,iBAAiB,MAAM,QAAQ,OAAO,CAAC,KAAK,CAAC;AACnD,UAAI,eAAe,SAAS,GAAG;AAC7B,cAAM,eAAe,eAAe,CAAC;AACrC,YAAIH,gBAAe,YAAY,GAAG;AAEhC,iBAAO,aAAa,UACjB,IAAI,CAAC,SAAS,WAAW,EAAE,SAAS,MAAM,EAAE,EAG5C;AAAA,YACC,CAAC,MAAM,SAAU,aAAa,kBAAkB,MAAM,KAAK,MAAMG,qBAAoB,aAAa,eAAe,MAAM,KAAK,IAAI;AAAA,YAChI;AAAA,UACF;AAAA,QACJ;AAAA,MACF;AAGA,UAAI,MAAM;AAER,cAAM,YAAY,MAAM,KAAK,qBAAqB;AAClD,cAAM,WAAW,MAAM,UAAU,IAAI,CAAC,IAAI,CAAC,GAAG,KAAKD,cAAqB;AACxE,YAAI,SAAS;AACX,iBAAO;AAAA,QACT;AAAA,MACF;AACA,aAAO;AAAA,IACT;AAAA,EACF;AACA,SAAO;AACT;","names":["assertEx","toJson","BoundWitnessBuilder","isBoundWitness","BoundWitnessDivinerQuerySchema","isModuleState","ModuleStateSchema","PayloadBuilder","SequenceConstants","moduleName"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/diviner-stateful",
-  "version": "3.8.0",
+  "version": "3.8.1",
   "description": "Primary SDK for using XYO Protocol 2.0",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -32,31 +32,31 @@
     "@xylabs/assert": "^4.5.1",
     "@xylabs/hex": "^4.5.1",
     "@xylabs/object": "^4.5.1",
-    "@xyo-network/archivist-model": "^3.8.0",
-    "@xyo-network/archivist-wrapper": "^3.8.0",
-    "@xyo-network/boundwitness-builder": "^3.8.0",
-    "@xyo-network/boundwitness-model": "^3.8.0",
-    "@xyo-network/diviner-abstract": "^3.8.0",
-    "@xyo-network/diviner-boundwitness-model": "^3.8.0",
-    "@xyo-network/diviner-model": "^3.8.0",
-    "@xyo-network/diviner-wrapper": "^3.8.0",
-    "@xyo-network/module-model": "^3.8.0",
-    "@xyo-network/payload-builder": "^3.8.0",
-    "@xyo-network/payload-model": "^3.8.0"
+    "@xyo-network/archivist-model": "^3.8.1",
+    "@xyo-network/archivist-wrapper": "^3.8.1",
+    "@xyo-network/boundwitness-builder": "^3.8.1",
+    "@xyo-network/boundwitness-model": "^3.8.1",
+    "@xyo-network/diviner-abstract": "^3.8.1",
+    "@xyo-network/diviner-boundwitness-model": "^3.8.1",
+    "@xyo-network/diviner-model": "^3.8.1",
+    "@xyo-network/diviner-wrapper": "^3.8.1",
+    "@xyo-network/module-model": "^3.8.1",
+    "@xyo-network/payload-builder": "^3.8.1",
+    "@xyo-network/payload-model": "^3.8.1"
   },
   "devDependencies": {
-    "@xylabs/ts-scripts-yarn3": "^4.2.6",
-    "@xylabs/tsconfig": "^4.2.6",
+    "@xylabs/ts-scripts-yarn3": "^5.0.22",
+    "@xylabs/tsconfig": "^5.0.22",
     "@xylabs/vitest-extended": "^4.5.1",
-    "@xyo-network/account": "^3.8.0",
-    "@xyo-network/archivist-memory": "^3.8.0",
-    "@xyo-network/diviner-boundwitness-memory": "^3.8.0",
-    "@xyo-network/diviner-payload-memory": "^3.8.0",
-    "@xyo-network/manifest": "^3.8.0",
-    "@xyo-network/module-factory-locator": "^3.8.0",
-    "@xyo-network/node-memory": "^3.8.0",
+    "@xyo-network/account": "^3.8.1",
+    "@xyo-network/archivist-memory": "^3.8.1",
+    "@xyo-network/diviner-boundwitness-memory": "^3.8.1",
+    "@xyo-network/diviner-payload-memory": "^3.8.1",
+    "@xyo-network/manifest": "^3.8.1",
+    "@xyo-network/module-factory-locator": "^3.8.1",
+    "@xyo-network/node-memory": "^3.8.1",
     "typescript": "^5.7.3",
-    "vitest": "^3.0.4"
+    "vitest": "^3.0.5"
   },
   "publishConfig": {
     "access": "public"

package/src/Diviner.ts

@@ -101,7 +101,7 @@ export abstract class StatefulDiviner<
     if (this._lastState) return this._lastState
     let hash: Hash = ''
     const diviner = await this.getBoundWitnessDivinerForStateStore()
-    const query = await new PayloadBuilder<BoundWitnessDivinerQueryPayload>({ schema: BoundWitnessDivinerQuerySchema })
+    const query = new PayloadBuilder<BoundWitnessDivinerQueryPayload>({ schema: BoundWitnessDivinerQuerySchema })
       .fields({
         address: this.account.address,
         limit: 1,

package/src/DivinerMixin.ts

@@ -58,7 +58,7 @@ export const StatefulModuleMixin = <
       this._lastState = nextState
       const archivist = await this.getArchivistForStore()
       // const [bw] = await new BoundWitnessBuilder().payload(nextState).signer(this.account).build()
-      const [bw] = await (await new BoundWitnessBuilder().payload(nextState)).build()
+      const [bw] = await new BoundWitnessBuilder().payload(nextState).build()
       await archivist.insert([bw, nextState])
     }
 
@@ -112,7 +112,7 @@ export const StatefulModuleMixin = <
       if (this._lastState) return this._lastState
       let hash: Hash = ''
       const diviner = await this.getBoundWitnessDivinerForStore()
-      const query = await new PayloadBuilder<BoundWitnessDivinerQueryPayload>({ schema: BoundWitnessDivinerQuerySchema })
+      const query = new PayloadBuilder<BoundWitnessDivinerQueryPayload>({ schema: BoundWitnessDivinerQuerySchema })
         .fields({
           // address: this.account.address,
           limit: 1,

package/dist/neutral/Config.d.ts

@@ -1,22 +0,0 @@
-import type { DivinerConfig } from '@xyo-network/diviner-model';
-import type { ModuleIdentifier } from '@xyo-network/module-model';
-/**
- * The schema for a Stateful Diviner config
- */
-export declare const StatefulDivinerConfigSchema: "network.xyo.diviner.stateful.config";
-/**
- * The schema for a Stateful Diviner config
- */
-export type StatefulDivinerConfigSchema = typeof StatefulDivinerConfigSchema;
-/**
- * The config for a Stateful Diviner
- */
-export type StatefulDivinerConfig = DivinerConfig<{
-    schema: StatefulDivinerConfigSchema;
-    stateStore: {
-        archivist: ModuleIdentifier;
-        boundWitnessDiviner: ModuleIdentifier;
-        payloadDiviner: ModuleIdentifier;
-    };
-}>;
-//# sourceMappingURL=Config.d.ts.map

package/dist/neutral/Config.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../src/Config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAA;AAIjE;;GAEG;AACH,eAAO,MAAM,2BAA2B,uCAA6C,CAAA;AACrF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,OAAO,2BAA2B,CAAA;AAE5E;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC;IAChD,MAAM,EAAE,2BAA2B,CAAA;IACnC,UAAU,EAAE;QACV,SAAS,EAAE,gBAAgB,CAAA;QAC3B,mBAAmB,EAAE,gBAAgB,CAAA;QACrC,cAAc,EAAE,gBAAgB,CAAA;KACjC,CAAA;CACF,CAAC,CAAA"}

package/dist/neutral/Diviner.d.ts

@@ -1,204 +0,0 @@
-import { ArchivistWrapper } from '@xyo-network/archivist-wrapper';
-import { AbstractDiviner } from '@xyo-network/diviner-abstract';
-import type { DivinerInstance, DivinerModuleEventData } from '@xyo-network/diviner-model';
-import { DivinerWrapper } from '@xyo-network/diviner-wrapper';
-import type { ModuleState, StateDictionary } from '@xyo-network/module-model';
-import { type Payload, type Schema } from '@xyo-network/payload-model';
-import type { StatefulDivinerParams } from './Params.ts';
-/**
- * A Diviner that maintains state
- */
-export declare abstract class StatefulDiviner<TParams extends StatefulDivinerParams = StatefulDivinerParams, TIn extends Payload = Payload, TOut extends Payload = Payload, TEventData extends DivinerModuleEventData<DivinerInstance<TParams, TIn, TOut>, TIn, TOut> = DivinerModuleEventData<DivinerInstance<TParams, TIn, TOut>, TIn, TOut>, TState extends StateDictionary = StateDictionary> extends AbstractDiviner<TParams, TIn, TOut, TEventData> {
-    static readonly configSchemas: Schema[];
-    static readonly defaultConfigSchema: Schema;
-    /**
-     * The last state
-     */
-    protected _lastState?: ModuleState<TState>;
-    /**
-     * Commit the internal state of the Diviner process. This is similar
-     * to a transaction completion in a database and should only be called
-     * when results have been successfully persisted to the appropriate
-     * external stores.
-     * @param nextState The state to commit
-     */
-    protected commitState(nextState: ModuleState<TState>): Promise<void>;
-    /**
-     * Retrieves the archivist for the specified store
-     * @param store The store to retrieve the archivist for
-     * @returns The archivist for the specified store
-     */
-    protected getArchivistForStateStore(): Promise<ArchivistWrapper<import("@xyo-network/archivist-model").ArchivistModule<import("@xylabs/object").BaseParamsFields & {
-        account?: import("@xyo-network/account-model").AccountInstance | "random";
-        addToResolvers?: boolean;
-        additionalSigners?: import("@xyo-network/account-model").AccountInstance[];
-        allowNameResolution?: boolean;
-        config: import("@xylabs/object").DeepRestrictToStringKeys<{
-            schema: Schema;
-            readonly archiving?: {
-                readonly archivists?: string[] | undefined;
-                readonly queries?: string[] | undefined;
-            } | undefined;
-            readonly allowedQueries?: string[] | undefined;
-            readonly archivist?: import("@xyo-network/module-model").ModuleIdentifier | undefined;
-            readonly consoleLogger?: import("@xylabs/logger").LogLevel | undefined;
-            readonly labels?: {
-                [x: string]: string | undefined;
-            } | undefined;
-            readonly name?: import("@xyo-network/module-model").ModuleName | undefined;
-            readonly paging?: {
-                [x: string]: {
-                    size?: number | undefined;
-                };
-            } | undefined;
-            readonly retry?: {
-                backoff?: number | undefined;
-                interval?: number | undefined;
-                retries?: number | undefined;
-            } | undefined;
-            readonly security?: {
-                readonly allowAnonymous?: boolean | undefined;
-                readonly allowed?: {
-                    [x: string]: (Lowercase<string> | Lowercase<string>[])[];
-                } | undefined;
-                readonly disallowed?: {
-                    [x: string]: Lowercase<string>[];
-                } | undefined;
-            } | undefined;
-            readonly sign?: boolean | undefined;
-            readonly storeQueries?: boolean | undefined;
-            readonly timestamp?: boolean | undefined;
-            parents?: {
-                commit?: string[] | undefined;
-                read?: string[] | undefined;
-                write?: string[] | undefined;
-            } | undefined;
-            requireAllParents?: boolean | undefined;
-            storage?: {
-                indexes?: {
-                    key: {
-                        [x: string]: import("@xyo-network/archivist-model").IndexDirection;
-                    };
-                    multiEntry?: boolean | undefined;
-                    name?: string | undefined;
-                    unique?: boolean | undefined;
-                }[] | undefined;
-            } | undefined;
-            storeParentReads?: boolean | undefined;
-        }>;
-        ephemeralQueryAccountEnabled?: boolean;
-        moduleIdentifierTransformers?: import("@xyo-network/module-model").ModuleIdentifierTransformer[];
-    }, import("@xyo-network/archivist-model").ArchivistModuleEventData>>>;
-    /**
-     * Retrieves the BoundWitness Diviner for the specified store
-     * @param store The store to retrieve the BoundWitness Diviner for
-     * @returns The BoundWitness Diviner for the specified store
-     */
-    protected getBoundWitnessDivinerForStateStore(): Promise<DivinerWrapper<import("@xyo-network/diviner-model").DivinerModule<import("@xylabs/object").BaseParamsFields & {
-        account?: import("@xyo-network/account-model").AccountInstance | "random";
-        addToResolvers?: boolean;
-        additionalSigners?: import("@xyo-network/account-model").AccountInstance[];
-        allowNameResolution?: boolean;
-        config: import("@xylabs/object").DeepRestrictToStringKeys<{
-            schema: Schema;
-            readonly archiving?: {
-                readonly archivists?: string[] | undefined;
-                readonly queries?: string[] | undefined;
-            } | undefined;
-            readonly allowedQueries?: string[] | undefined;
-            readonly archivist?: import("@xyo-network/module-model").ModuleIdentifier | undefined;
-            readonly consoleLogger?: import("@xylabs/logger").LogLevel | undefined;
-            readonly labels?: {
-                [x: string]: string | undefined;
-            } | undefined;
-            readonly name?: import("@xyo-network/module-model").ModuleName | undefined;
-            readonly paging?: {
-                [x: string]: {
-                    size?: number | undefined;
-                };
-            } | undefined;
-            readonly retry?: {
-                backoff?: number | undefined;
-                interval?: number | undefined;
-                retries?: number | undefined;
-            } | undefined;
-            readonly security?: {
-                readonly allowAnonymous?: boolean | undefined;
-                readonly allowed?: {
-                    [x: string]: (Lowercase<string> | Lowercase<string>[])[];
-                } | undefined;
-                readonly disallowed?: {
-                    [x: string]: Lowercase<string>[];
-                } | undefined;
-            } | undefined;
-            readonly sign?: boolean | undefined;
-            readonly storeQueries?: boolean | undefined;
-            readonly timestamp?: boolean | undefined;
-        }>;
-        ephemeralQueryAccountEnabled?: boolean;
-        moduleIdentifierTransformers?: import("@xyo-network/module-model").ModuleIdentifierTransformer[];
-    }, DivinerModuleEventData>, import("@xylabs/object").DeepRestrictToStringKeys<{
-        schema: Schema;
-    }>, import("@xylabs/object").DeepRestrictToStringKeys<{
-        schema: Schema;
-    }>>>;
-    /**
-     * Retrieves the Payload Diviner for the specified store
-     * @param store The store to retrieve the Payload Diviner for
-     * @returns The Payload Diviner for the specified store
-     */
-    protected getPayloadDivinerForStateStore(): Promise<DivinerWrapper<import("@xyo-network/diviner-model").DivinerModule<import("@xylabs/object").BaseParamsFields & {
-        account?: import("@xyo-network/account-model").AccountInstance | "random";
-        addToResolvers?: boolean;
-        additionalSigners?: import("@xyo-network/account-model").AccountInstance[];
-        allowNameResolution?: boolean;
-        config: import("@xylabs/object").DeepRestrictToStringKeys<{
-            schema: Schema;
-            readonly archiving?: {
-                readonly archivists?: string[] | undefined;
-                readonly queries?: string[] | undefined;
-            } | undefined;
-            readonly allowedQueries?: string[] | undefined;
-            readonly archivist?: import("@xyo-network/module-model").ModuleIdentifier | undefined;
-            readonly consoleLogger?: import("@xylabs/logger").LogLevel | undefined;
-            readonly labels?: {
-                [x: string]: string | undefined;
-            } | undefined;
-            readonly name?: import("@xyo-network/module-model").ModuleName | undefined;
-            readonly paging?: {
-                [x: string]: {
-                    size?: number | undefined;
-                };
-            } | undefined;
-            readonly retry?: {
-                backoff?: number | undefined;
-                interval?: number | undefined;
-                retries?: number | undefined;
-            } | undefined;
-            readonly security?: {
-                readonly allowAnonymous?: boolean | undefined;
-                readonly allowed?: {
-                    [x: string]: (Lowercase<string> | Lowercase<string>[])[];
-                } | undefined;
-                readonly disallowed?: {
-                    [x: string]: Lowercase<string>[];
-                } | undefined;
-            } | undefined;
-            readonly sign?: boolean | undefined;
-            readonly storeQueries?: boolean | undefined;
-            readonly timestamp?: boolean | undefined;
-        }>;
-        ephemeralQueryAccountEnabled?: boolean;
-        moduleIdentifierTransformers?: import("@xyo-network/module-model").ModuleIdentifierTransformer[];
-    }, DivinerModuleEventData>, import("@xylabs/object").DeepRestrictToStringKeys<{
-        schema: Schema;
-    }>, import("@xylabs/object").DeepRestrictToStringKeys<{
-        schema: Schema;
-    }>>>;
-    /**
-     * Retrieves the last state of the Diviner process. Used to recover state after
-     * preemptions, reboots, etc.
-     */
-    protected retrieveState(): Promise<ModuleState<TState> | undefined>;
-}
-//# sourceMappingURL=Diviner.d.ts.map

package/dist/neutral/Diviner.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Diviner.d.ts","sourceRoot":"","sources":["../../src/Diviner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAGjE,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAA;AAG/D,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACzF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAA;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAG7E,OAAO,EACL,KAAK,OAAO,EAAE,KAAK,MAAM,EAE1B,MAAM,4BAA4B,CAAA;AAGnC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AAIxD;;GAEG;AACH,8BAAsB,eAAe,CACnC,OAAO,SAAS,qBAAqB,GAAG,qBAAqB,EAC7D,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,EACD,MAAM,SAAS,eAAe,GAAG,eAAe,CAChD,SAAQ,eAAe,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,CAAC;IACvD,gBAAyB,aAAa,EAAE,MAAM,EAAE,CAAwD;IACxG,gBAAyB,mBAAmB,EAAE,MAAM,CAA8B;IAElF;;OAEG;IACH,SAAS,CAAC,UAAU,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IAE1C;;;;;;OAMG;cACa,WAAW,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,CAAC;IAS1D;;;;OAIG;cACa,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMzC;;;;OAIG;cACa,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAMnD;;;;OAIG;cACa,8BAA8B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAM9C;;;OAGG;cACa,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CAwC1E"}