@xyo-network/diviner-stateful 5.0.7 → 5.1.0

package/dist/neutral/index.mjs

@@ -74,7 +74,7 @@ var StatefulDiviner = class extends AbstractDiviner {
    */
   async retrieveState() {
     if (this._lastState) return this._lastState;
-    let hash = "";
+    let hash = null;
     const diviner = await this.getBoundWitnessDivinerForStateStore();
     const query = new PayloadBuilder({ schema: BoundWitnessDivinerQuerySchema }).fields({
       address: this.account.address,
@@ -89,11 +89,11 @@ var StatefulDiviner = class extends AbstractDiviner {
       if (isBoundWitness(boundWitness)) {
         hash = boundWitness.addresses.map((address, index) => ({ address, index })).filter(({ address }) => address === this.account.address).reduce(
           (prev, curr) => boundWitness.payload_schemas?.[curr?.index] === ModuleStateSchema ? boundWitness.payload_hashes[curr?.index] : prev,
-          ""
+          null
         );
       }
     }
-    if (hash) {
+    if (hash !== null) {
       const archivist = await this.getArchivistForStateStore();
       const payload = (await archivist.get([hash])).find(isModuleState);
       if (payload) {
@@ -178,7 +178,7 @@ var StatefulModuleMixin = (ModuleBase) => {
      */
     async retrieveState() {
       if (this._lastState) return this._lastState;
-      let hash = "";
+      let hash = null;
       const diviner = await this.getBoundWitnessDivinerForStore();
       const query = new PayloadBuilder2({ schema: BoundWitnessDivinerQuerySchema2 }).fields({
         // address: this.account.address,
@@ -193,11 +193,11 @@ var StatefulModuleMixin = (ModuleBase) => {
         if (isBoundWitness2(boundWitness)) {
           hash = boundWitness.addresses.map((address, index) => ({ address, index })).reduce(
             (prev, curr) => boundWitness.payload_schemas?.[curr?.index] === ModuleStateSchema2 ? boundWitness.payload_hashes[curr?.index] : prev,
-            ""
+            null
           );
         }
       }
-      if (hash) {
+      if (hash !== null) {
         const archivist = await this.getArchivistForStore();
         const payload = (await archivist.get([hash])).find(isModuleState2);
         if (payload) {

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 { toSafeJson } 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 type {\n  Payload, Schema,\n  WithStorageMeta,\n} from '@xyo-network/payload-model'\nimport { SequenceConstants } 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 (toSafeJson(nextState.state) === toSafeJson(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 = '' as 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 { toSafeJson } 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 type { WithStorageMeta } from '@xyo-network/payload-model'\nimport { SequenceConstants } 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 * @internal\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 (toSafeJson(nextState.state) === toSafeJson(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 = '' as 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":"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","names":["assertEx","toSafeJson","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 { toSafeJson } 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 type {\n  Payload, Schema,\n  WithStorageMeta,\n} from '@xyo-network/payload-model'\nimport { SequenceConstants } 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 (toSafeJson(nextState.state) === toSafeJson(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 | null = null\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            null as Hash | null,\n          )\n      }\n    }\n\n    // If we able to located the last state\n    if (hash !== null) {\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 { toSafeJson } 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 type { WithStorageMeta } from '@xyo-network/payload-model'\nimport { SequenceConstants } 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 * @internal\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 (toSafeJson(nextState.state) === toSafeJson(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 | null = null\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              null as Hash | null,\n            )\n        }\n      }\n\n      // If we able to located the last state\n      if (hash !== null) {\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,kBAAkB;AAC3B,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;AAK/B,SAAS,yBAAyB;AAKlC,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,WAAW,UAAU,KAAK,MAAM,WAAW,KAAK,YAAY,KAAK,EAAG;AACxE,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,YAAY,WAAW,MAAM,GAAG,UAAU,iDAAiD;AAC9H,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,YAAY,qBAAqB,MAAM,GAAG,UAAU,2DAA2D;AAClJ,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,OAAoB;AACxB,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,SAAS,MAAM;AAEjB,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;;;AC5IA,SAAS,YAAAA,iBAAgB;AAEzB,SAAS,cAAAC,mBAAkB;AAC3B,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;AAE/B,SAAS,qBAAAC,0BAAyB;AASlC,IAAMC,cAAa;AAQZ,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,YAAW,UAAU,KAAK,MAAMA,YAAW,KAAK,YAAY,KAAK,EAAG;AACxE,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,OAAoB;AACxB,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,SAAS,MAAM;AAEjB,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","toSafeJson","BoundWitnessBuilder","isBoundWitness","BoundWitnessDivinerQuerySchema","isModuleState","ModuleStateSchema","PayloadBuilder","SequenceConstants","moduleName"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/diviner-stateful",
-  "version": "5.0.7",
+  "version": "5.1.0",
   "description": "Primary SDK for using XYO Protocol 2.0",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -33,34 +33,34 @@
     "src"
   ],
   "dependencies": {
-    "@xylabs/assert": "~5.0.10",
-    "@xylabs/object": "~5.0.10",
-    "@xyo-network/archivist-model": "~5.0.7",
-    "@xyo-network/archivist-wrapper": "~5.0.7",
-    "@xyo-network/boundwitness-builder": "~5.0.7",
-    "@xyo-network/boundwitness-model": "~5.0.7",
-    "@xyo-network/diviner-abstract": "~5.0.7",
-    "@xyo-network/diviner-boundwitness-model": "~5.0.7",
-    "@xyo-network/diviner-model": "~5.0.7",
-    "@xyo-network/diviner-wrapper": "~5.0.7",
-    "@xyo-network/module-model": "~5.0.7",
-    "@xyo-network/payload-builder": "~5.0.7",
-    "@xyo-network/payload-model": "~5.0.7"
+    "@xylabs/assert": "~5.0.11",
+    "@xylabs/object": "~5.0.11",
+    "@xyo-network/archivist-model": "~5.1.0",
+    "@xyo-network/archivist-wrapper": "~5.1.0",
+    "@xyo-network/boundwitness-builder": "~5.1.0",
+    "@xyo-network/boundwitness-model": "~5.1.0",
+    "@xyo-network/diviner-abstract": "~5.1.0",
+    "@xyo-network/diviner-boundwitness-model": "~5.1.0",
+    "@xyo-network/diviner-model": "~5.1.0",
+    "@xyo-network/diviner-wrapper": "~5.1.0",
+    "@xyo-network/module-model": "~5.1.0",
+    "@xyo-network/payload-builder": "~5.1.0",
+    "@xyo-network/payload-model": "~5.1.0"
   },
   "devDependencies": {
-    "@xylabs/hex": "~5.0.10",
-    "@xylabs/ts-scripts-yarn3": "~7.1.3",
-    "@xylabs/tsconfig": "~7.1.3",
-    "@xylabs/vitest-extended": "~5.0.10",
-    "@xyo-network/account": "~5.0.7",
-    "@xyo-network/archivist-memory": "~5.0.7",
-    "@xyo-network/diviner-boundwitness-memory": "~5.0.7",
-    "@xyo-network/diviner-payload-generic": "~5.0.7",
-    "@xyo-network/diviner-payload-memory": "~5.0.7",
-    "@xyo-network/manifest": "~5.0.7",
-    "@xyo-network/module-factory-locator": "~5.0.7",
-    "@xyo-network/node-memory": "~5.0.7",
-    "@xyo-network/wallet": "~5.0.7",
+    "@xylabs/hex": "~5.0.11",
+    "@xylabs/ts-scripts-yarn3": "~7.1.7",
+    "@xylabs/tsconfig": "~7.1.7",
+    "@xylabs/vitest-extended": "~5.0.11",
+    "@xyo-network/account": "~5.1.0",
+    "@xyo-network/archivist-memory": "~5.1.0",
+    "@xyo-network/diviner-boundwitness-memory": "~5.1.0",
+    "@xyo-network/diviner-payload-generic": "~5.1.0",
+    "@xyo-network/diviner-payload-memory": "~5.1.0",
+    "@xyo-network/manifest": "~5.1.0",
+    "@xyo-network/module-factory-locator": "~5.1.0",
+    "@xyo-network/node-memory": "~5.1.0",
+    "@xyo-network/wallet": "~5.1.0",
     "typescript": "~5.9.2",
     "vitest": "~3.2.4"
   },

package/src/Diviner.ts

@@ -100,7 +100,7 @@ export abstract class StatefulDiviner<
    */
   protected async retrieveState(): Promise<ModuleState<TState> | undefined> {
     if (this._lastState) return this._lastState
-    let hash = '' as Hash
+    let hash: Hash | null = null
     const diviner = await this.getBoundWitnessDivinerForStateStore()
     const query = new PayloadBuilder<BoundWitnessDivinerQueryPayload>({ schema: BoundWitnessDivinerQuerySchema })
       .fields({
@@ -122,13 +122,13 @@ export abstract class StatefulDiviner<
           // eslint-disable-next-line unicorn/no-array-reduce
           .reduce(
             (prev, curr) => (boundWitness.payload_schemas?.[curr?.index] === ModuleStateSchema ? boundWitness.payload_hashes[curr?.index] : prev),
-            '' as Hash,
+            null as Hash | null,
           )
       }
     }
 
     // If we able to located the last state
-    if (hash) {
+    if (hash !== null) {
       // Get last state
       const archivist = await this.getArchivistForStateStore()
       const payload = (await archivist.get([hash])).find(isModuleState<TState>)

package/src/DivinerMixin.ts

@@ -112,7 +112,7 @@ export const StatefulModuleMixin = <
      */
     async retrieveState(): Promise<ModuleState<TState> | undefined> {
       if (this._lastState) return this._lastState
-      let hash = '' as Hash
+      let hash: Hash | null = null
       const diviner = await this.getBoundWitnessDivinerForStore()
       const query = new PayloadBuilder<BoundWitnessDivinerQueryPayload>({ schema: BoundWitnessDivinerQuerySchema })
         .fields({
@@ -134,13 +134,13 @@ export const StatefulModuleMixin = <
             // eslint-disable-next-line unicorn/no-array-reduce
             .reduce(
               (prev, curr) => (boundWitness.payload_schemas?.[curr?.index] === ModuleStateSchema ? boundWitness.payload_hashes[curr?.index] : prev),
-              '' as Hash,
+              null as Hash | null,
             )
         }
       }
 
       // If we able to located the last state
-      if (hash) {
+      if (hash !== null) {
         // Get last state
         const archivist = await this.getArchivistForStore()
         const payload = (await archivist.get([hash])).find(isModuleState<TState>)