@xyo-network/diviner-stateful 2.84.1

package/dist/node/DivinerMixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DivinerMixin.d.ts","sourceRoot":"","sources":["../../src/DivinerMixin.ts"],"names":[],"mappings":"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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;YA0CN,CAAA"}

package/dist/node/Params.d.cts

@@ -0,0 +1,8 @@
+import { DivinerParams } from '@xyo-network/diviner-model';
+import { AnyConfigSchema } from '@xyo-network/module-model';
+import { StatefulDivinerConfig } from './Config';
+/**
+ * The parameters for a Stateful Diviner
+ */
+export type StatefulDivinerParams = DivinerParams<AnyConfigSchema<StatefulDivinerConfig>>;
+//# sourceMappingURL=Params.d.ts.map

package/dist/node/Params.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Params.d.ts","sourceRoot":"","sources":["../../src/Params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAEhD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC,CAAA"}

package/dist/node/Params.d.mts

@@ -0,0 +1,8 @@
+import { DivinerParams } from '@xyo-network/diviner-model';
+import { AnyConfigSchema } from '@xyo-network/module-model';
+import { StatefulDivinerConfig } from './Config';
+/**
+ * The parameters for a Stateful Diviner
+ */
+export type StatefulDivinerParams = DivinerParams<AnyConfigSchema<StatefulDivinerConfig>>;
+//# sourceMappingURL=Params.d.ts.map

package/dist/node/Params.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Params.d.ts","sourceRoot":"","sources":["../../src/Params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAEhD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC,CAAA"}

package/dist/node/Params.d.ts

@@ -0,0 +1,8 @@
+import { DivinerParams } from '@xyo-network/diviner-model';
+import { AnyConfigSchema } from '@xyo-network/module-model';
+import { StatefulDivinerConfig } from './Config';
+/**
+ * The parameters for a Stateful Diviner
+ */
+export type StatefulDivinerParams = DivinerParams<AnyConfigSchema<StatefulDivinerConfig>>;
+//# sourceMappingURL=Params.d.ts.map

package/dist/node/Params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Params.d.ts","sourceRoot":"","sources":["../../src/Params.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA;AAE3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAA;AAEhD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,aAAa,CAAC,eAAe,CAAC,qBAAqB,CAAC,CAAC,CAAA"}

package/dist/node/Schema.d.cts

@@ -0,0 +1,3 @@
+export declare const StatefulDivinerSchema: "network.xyo.diviner.stateful";
+export type StatefulDivinerSchema = typeof StatefulDivinerSchema;
+//# sourceMappingURL=Schema.d.ts.map

package/dist/node/Schema.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../src/Schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,gCAA0C,CAAA;AAC5E,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAA"}

package/dist/node/Schema.d.mts

@@ -0,0 +1,3 @@
+export declare const StatefulDivinerSchema: "network.xyo.diviner.stateful";
+export type StatefulDivinerSchema = typeof StatefulDivinerSchema;
+//# sourceMappingURL=Schema.d.ts.map

package/dist/node/Schema.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../src/Schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,gCAA0C,CAAA;AAC5E,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAA"}

package/dist/node/Schema.d.ts

@@ -0,0 +1,3 @@
+export declare const StatefulDivinerSchema: "network.xyo.diviner.stateful";
+export type StatefulDivinerSchema = typeof StatefulDivinerSchema;
+//# sourceMappingURL=Schema.d.ts.map

package/dist/node/Schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../src/Schema.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,gCAA0C,CAAA;AAC5E,MAAM,MAAM,qBAAqB,GAAG,OAAO,qBAAqB,CAAA"}

package/dist/node/index.d.cts

@@ -0,0 +1,6 @@
+export * from './Config';
+export * from './Diviner';
+export * from './DivinerMixin';
+export * from './Params';
+export * from './Schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA"}

package/dist/node/index.d.mts

@@ -0,0 +1,6 @@
+export * from './Config';
+export * from './Diviner';
+export * from './DivinerMixin';
+export * from './Params';
+export * from './Schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA"}

package/dist/node/index.d.ts

@@ -0,0 +1,6 @@
+export * from './Config';
+export * from './Diviner';
+export * from './DivinerMixin';
+export * from './Params';
+export * from './Schema';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAA;AACxB,cAAc,WAAW,CAAA;AACzB,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,UAAU,CAAA"}

package/dist/node/index.js

@@ -0,0 +1,259 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  StatefulDiviner: () => StatefulDiviner,
+  StatefulDivinerConfigSchema: () => StatefulDivinerConfigSchema,
+  StatefulDivinerSchema: () => StatefulDivinerSchema,
+  StatefulModuleMixin: () => StatefulModuleMixin
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/Schema.ts
+var StatefulDivinerSchema = "network.xyo.diviner.stateful";
+
+// src/Config.ts
+var StatefulDivinerConfigSchema = `${StatefulDivinerSchema}.config`;
+
+// src/Diviner.ts
+var import_assert = require("@xylabs/assert");
+var import_abstract_diviner = require("@xyo-network/abstract-diviner");
+var import_archivist_wrapper = require("@xyo-network/archivist-wrapper");
+var import_boundwitness_builder = require("@xyo-network/boundwitness-builder");
+var import_boundwitness_model = require("@xyo-network/boundwitness-model");
+var import_diviner_boundwitness_model = require("@xyo-network/diviner-boundwitness-model");
+var import_diviner_model = require("@xyo-network/diviner-model");
+var import_diviner_wrapper = require("@xyo-network/diviner-wrapper");
+var import_module_model = require("@xyo-network/module-model");
+var import_payload_builder = require("@xyo-network/payload-builder");
+var moduleName = "StatefulDiviner";
+var StatefulDiviner = class extends import_abstract_diviner.AbstractDiviner {
+  static configSchemas = [import_diviner_model.DivinerConfigSchema, StatefulDivinerConfigSchema];
+  /**
+   * The last state
+   */
+  _lastState;
+  /**
+   * 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
+   */
+  async commitState(nextState) {
+    var _a;
+    if (nextState.state.offset === ((_a = this._lastState) == null ? void 0 : _a.state.offset))
+      return;
+    this._lastState = nextState;
+    const archivist = await this.getArchivistForStateStore();
+    const [bw] = await new import_boundwitness_builder.BoundWitnessBuilder().payload(nextState).witness(this.account).build();
+    await archivist.insert([bw, nextState]);
+  }
+  /**
+   * Retrieves the archivist for the specified store
+   * @param store The store to retrieve the archivist for
+   * @returns The archivist for the specified store
+   */
+  async getArchivistForStateStore() {
+    var _a;
+    const name = (0, import_assert.assertEx)((_a = this.config) == null ? void 0 : _a.stateStore.archivist, () => `${moduleName}: Config for stateStore.archivist not specified`);
+    const mod = (0, import_assert.assertEx)(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.archivist`);
+    return import_archivist_wrapper.ArchivistWrapper.wrap(mod, this.account);
+  }
+  /**
+   * 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
+   */
+  async getBoundWitnessDivinerForStateStore() {
+    var _a;
+    const name = (0, import_assert.assertEx)((_a = this.config) == null ? void 0 : _a.stateStore.boundWitnessDiviner, () => `${moduleName}: Config for stateStore.boundWitnessDiviner not specified`);
+    const mod = (0, import_assert.assertEx)(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.boundWitnessDiviner`);
+    return import_diviner_wrapper.DivinerWrapper.wrap(mod, this.account);
+  }
+  /**
+   * 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
+   */
+  async getPayloadDivinerForStateStore() {
+    var _a, _b;
+    const name = (0, import_assert.assertEx)((_b = (_a = this.config) == null ? void 0 : _a.stateStore) == null ? void 0 : _b.payloadDiviner, () => `${moduleName}: Config for stateStore.payloadDiviner not specified`);
+    const mod = (0, import_assert.assertEx)(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.payloadDiviner`);
+    return import_diviner_wrapper.DivinerWrapper.wrap(mod, this.account);
+  }
+  /**
+   * Retrieves the last state of the Diviner process. Used to recover state after
+   * preemptions, reboots, etc.
+   */
+  async retrieveState() {
+    if (this._lastState)
+      return this._lastState;
+    let hash = "";
+    const diviner = await this.getBoundWitnessDivinerForStateStore();
+    const query = await new import_payload_builder.PayloadBuilder({ schema: import_diviner_boundwitness_model.BoundWitnessDivinerQuerySchema }).fields({
+      address: this.account.address,
+      limit: 1,
+      offset: 0,
+      order: "desc",
+      payload_schemas: [import_module_model.ModuleStateSchema]
+    }).build();
+    const boundWitnesses = await diviner.divine([query]);
+    if (boundWitnesses.length > 0) {
+      const boundWitness = boundWitnesses[0];
+      if ((0, import_boundwitness_model.isBoundWitness)(boundWitness)) {
+        hash = boundWitness.addresses.map((address, index) => ({ address, index })).filter(({ address }) => address === this.account.address).reduce(
+          (prev, curr) => {
+            var _a;
+            return ((_a = boundWitness.payload_schemas) == null ? void 0 : _a[curr == null ? void 0 : curr.index]) === import_module_model.ModuleStateSchema ? boundWitness.payload_hashes[curr == null ? void 0 : curr.index] : prev;
+          },
+          ""
+        );
+      }
+    }
+    if (hash) {
+      const archivist = await this.getArchivistForStateStore();
+      const payload = (await archivist.get([hash])).find(import_module_model.isModuleState);
+      if (payload) {
+        return payload;
+      }
+    }
+    return void 0;
+  }
+};
+
+// src/DivinerMixin.ts
+var import_assert2 = require("@xylabs/assert");
+var import_archivist = require("@xyo-network/archivist");
+var import_boundwitness_builder2 = require("@xyo-network/boundwitness-builder");
+var import_boundwitness_model2 = require("@xyo-network/boundwitness-model");
+var import_diviner_boundwitness_model2 = require("@xyo-network/diviner-boundwitness-model");
+var import_diviner_model2 = require("@xyo-network/diviner-model");
+var import_module_model2 = require("@xyo-network/module-model");
+var import_payload_builder2 = require("@xyo-network/payload-builder");
+var moduleName2 = "StatefulModuleMixin";
+var StatefulModuleMixin = (ModuleBase) => {
+  class StatefulModuleBase extends ModuleBase {
+    _lastState;
+    /**
+     * 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
+     */
+    async commitState(nextState) {
+      var _a;
+      if (nextState.state.offset === ((_a = this._lastState) == null ? void 0 : _a.state.offset))
+        return;
+      this._lastState = nextState;
+      const archivist = await this.getArchivistForStore();
+      const [bw] = await new import_boundwitness_builder2.BoundWitnessBuilder().payload(nextState).build();
+      await archivist.insert([bw, nextState]);
+    }
+    /**
+     * Retrieves the archivist for the specified store
+     * @param store The store to retrieve the archivist for
+     * @returns The archivist for the specified store
+     */
+    async getArchivistForStore() {
+      var _a, _b;
+      const name = (0, import_assert2.assertEx)((_b = (_a = this.config) == null ? void 0 : _a.stateStore) == null ? void 0 : _b.archivist, () => `${moduleName2}: Config for stateStore.archivist not specified`);
+      const mod = (0, import_assert2.assertEx)(await this.resolve(name), () => `${moduleName2}: Failed to resolve stateStore.archivist`);
+      const instance = (0, import_archivist.asArchivistInstance)(mod);
+      return (0, import_assert2.assertEx)(instance, () => `${moduleName2}: Failed to wrap archivist instance`);
+    }
+    /**
+     * 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
+     */
+    async getBoundWitnessDivinerForStore() {
+      var _a, _b;
+      const name = (0, import_assert2.assertEx)(
+        (_b = (_a = this.config) == null ? void 0 : _a.stateStore) == null ? void 0 : _b.boundWitnessDiviner,
+        () => `${moduleName2}: Config for stateStore.boundWitnessDiviner not specified`
+      );
+      const mod = (0, import_assert2.assertEx)(await this.resolve(name), () => `${moduleName2}: Failed to resolve stateStore.boundWitnessDiviner`);
+      const instance = (0, import_diviner_model2.asDivinerInstance)(mod);
+      return (0, import_assert2.assertEx)(instance, () => `${moduleName2}: Failed to wrap diviner instance`);
+    }
+    /**
+     * 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
+     */
+    async getPayloadDivinerForStateStore() {
+      var _a, _b;
+      const name = (0, import_assert2.assertEx)((_b = (_a = this.config) == null ? void 0 : _a.stateStore) == null ? void 0 : _b.payloadDiviner, () => `${moduleName2}: Config for stateStore.payloadDiviner not specified`);
+      const mod = (0, import_assert2.assertEx)(await this.resolve(name), () => `${moduleName2}: Failed to resolve stateStore.payloadDiviner`);
+      const instance = (0, import_diviner_model2.asDivinerInstance)(mod);
+      return (0, import_assert2.assertEx)(instance, () => `${moduleName2}: Failed to wrap diviner instance`);
+    }
+    /**
+     * Retrieves the last state of the Diviner process. Used to recover state after
+     * preemptions, reboots, etc.
+     */
+    async retrieveState() {
+      if (this._lastState)
+        return this._lastState;
+      let hash = "";
+      const diviner = await this.getBoundWitnessDivinerForStore();
+      const query = await new import_payload_builder2.PayloadBuilder({ schema: import_diviner_boundwitness_model2.BoundWitnessDivinerQuerySchema }).fields({
+        // address: this.account.address,
+        limit: 1,
+        offset: 0,
+        order: "desc",
+        payload_schemas: [import_module_model2.ModuleStateSchema]
+      }).build();
+      const boundWitnesses = await diviner.divine([query]);
+      if (boundWitnesses.length > 0) {
+        const boundWitness = boundWitnesses[0];
+        if ((0, import_boundwitness_model2.isBoundWitness)(boundWitness)) {
+          hash = boundWitness.addresses.map((address, index) => ({ address, index })).reduce(
+            (prev, curr) => {
+              var _a;
+              return ((_a = boundWitness.payload_schemas) == null ? void 0 : _a[curr == null ? void 0 : curr.index]) === import_module_model2.ModuleStateSchema ? boundWitness.payload_hashes[curr == null ? void 0 : curr.index] : prev;
+            },
+            ""
+          );
+        }
+      }
+      if (hash) {
+        const archivist = await this.getArchivistForStore();
+        const payload = (await archivist.get([hash])).find(import_module_model2.isModuleState);
+        if (payload) {
+          return payload;
+        }
+      }
+      return void 0;
+    }
+  }
+  return StatefulModuleBase;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  StatefulDiviner,
+  StatefulDivinerConfigSchema,
+  StatefulDivinerSchema,
+  StatefulModuleMixin
+});
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/index.ts","../../src/Schema.ts","../../src/Config.ts","../../src/Diviner.ts","../../src/DivinerMixin.ts"],"sourcesContent":["export * from './Config'\nexport * from './Diviner'\nexport * from './DivinerMixin'\nexport * from './Params'\nexport * from './Schema'\n","export const StatefulDivinerSchema = 'network.xyo.diviner.stateful' as const\nexport type StatefulDivinerSchema = typeof StatefulDivinerSchema\n","import { DivinerConfig } from '@xyo-network/diviner-model'\n\nimport { StatefulDivinerSchema } from './Schema'\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: string\n    boundWitnessDiviner: string\n    payloadDiviner: string\n  }\n}>\n","import { assertEx } from '@xylabs/assert'\nimport { AbstractDiviner } from '@xyo-network/abstract-diviner'\nimport { ArchivistWrapper } from '@xyo-network/archivist-wrapper'\nimport { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'\nimport { isBoundWitness } from '@xyo-network/boundwitness-model'\nimport { BoundWitnessDivinerQueryPayload, BoundWitnessDivinerQuerySchema } from '@xyo-network/diviner-boundwitness-model'\nimport { DivinerConfigSchema, DivinerModule, DivinerModuleEventData } from '@xyo-network/diviner-model'\nimport { DivinerWrapper } from '@xyo-network/diviner-wrapper'\nimport { isModuleState, ModuleState, ModuleStateSchema, StateDictionary } from '@xyo-network/module-model'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\nimport { Payload } from '@xyo-network/payload-model'\n\nimport { StatefulDivinerConfigSchema } from './Config'\nimport { StatefulDivinerParams } from './Params'\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<DivinerModule<TParams>, TIn, TOut> = DivinerModuleEventData<DivinerModule<TParams>, TIn, TOut>,\n  TState extends StateDictionary = StateDictionary,\n> extends AbstractDiviner<TParams, TIn, TOut, TEventData> {\n  static override readonly configSchemas: string[] = [DivinerConfigSchema, 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 (nextState.state.offset === this._lastState?.state.offset) return\n    this._lastState = nextState\n    const archivist = await this.getArchivistForStateStore()\n    const [bw] = await new BoundWitnessBuilder().payload(nextState).witness(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: string = ''\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        offset: 0,\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          .reduce(\n            (prev, curr) => (boundWitness.payload_schemas?.[curr?.index] === ModuleStateSchema ? boundWitness.payload_hashes[curr?.index] : prev),\n            '',\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\n      }\n    }\n    return undefined\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { asArchivistInstance } from '@xyo-network/archivist'\nimport { BoundWitnessBuilder } from '@xyo-network/boundwitness-builder'\nimport { isBoundWitness } from '@xyo-network/boundwitness-model'\nimport { BoundWitnessDivinerQueryPayload, BoundWitnessDivinerQuerySchema } from '@xyo-network/diviner-boundwitness-model'\nimport { asDivinerInstance } from '@xyo-network/diviner-model'\nimport {\n  AnyConfigSchema,\n  isModuleState,\n  ModuleInstance,\n  ModuleParams,\n  ModuleState,\n  ModuleStateSchema,\n  StateDictionary,\n} from '@xyo-network/module-model'\nimport { PayloadBuilder } from '@xyo-network/payload-builder'\n\nimport { StatefulDivinerConfig } from './Config'\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 (nextState.state.offset === this._lastState?.state.offset) return\n      this._lastState = nextState\n      const archivist = await this.getArchivistForStore()\n      // const [bw] = await new BoundWitnessBuilder().payload(nextState).witness(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     * 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     * 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: string = ''\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          offset: 0,\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            .reduce(\n              (prev, curr) => (boundWitness.payload_schemas?.[curr?.index] === ModuleStateSchema ? boundWitness.payload_hashes[curr?.index] : prev),\n              '',\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\n        }\n      }\n      return undefined\n    }\n  }\n  return StatefulModuleBase\n}\n"],"mappings":"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","names":["import_assert","import_boundwitness_builder","import_boundwitness_model","import_diviner_boundwitness_model","import_diviner_model","import_module_model","import_payload_builder","moduleName"]}

package/dist/node/index.mjs

@@ -0,0 +1,232 @@
+// src/Schema.ts
+var StatefulDivinerSchema = "network.xyo.diviner.stateful";
+
+// src/Config.ts
+var StatefulDivinerConfigSchema = `${StatefulDivinerSchema}.config`;
+
+// src/Diviner.ts
+import { assertEx } from "@xylabs/assert";
+import { AbstractDiviner } from "@xyo-network/abstract-diviner";
+import { ArchivistWrapper } from "@xyo-network/archivist-wrapper";
+import { BoundWitnessBuilder } from "@xyo-network/boundwitness-builder";
+import { isBoundWitness } from "@xyo-network/boundwitness-model";
+import { BoundWitnessDivinerQuerySchema } from "@xyo-network/diviner-boundwitness-model";
+import { DivinerConfigSchema } from "@xyo-network/diviner-model";
+import { DivinerWrapper } from "@xyo-network/diviner-wrapper";
+import { isModuleState, ModuleStateSchema } from "@xyo-network/module-model";
+import { PayloadBuilder } from "@xyo-network/payload-builder";
+var moduleName = "StatefulDiviner";
+var StatefulDiviner = class extends AbstractDiviner {
+  static configSchemas = [DivinerConfigSchema, StatefulDivinerConfigSchema];
+  /**
+   * The last state
+   */
+  _lastState;
+  /**
+   * 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
+   */
+  async commitState(nextState) {
+    var _a;
+    if (nextState.state.offset === ((_a = this._lastState) == null ? void 0 : _a.state.offset))
+      return;
+    this._lastState = nextState;
+    const archivist = await this.getArchivistForStateStore();
+    const [bw] = await new BoundWitnessBuilder().payload(nextState).witness(this.account).build();
+    await archivist.insert([bw, nextState]);
+  }
+  /**
+   * Retrieves the archivist for the specified store
+   * @param store The store to retrieve the archivist for
+   * @returns The archivist for the specified store
+   */
+  async getArchivistForStateStore() {
+    var _a;
+    const name = assertEx((_a = this.config) == null ? void 0 : _a.stateStore.archivist, () => `${moduleName}: Config for stateStore.archivist not specified`);
+    const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.archivist`);
+    return ArchivistWrapper.wrap(mod, this.account);
+  }
+  /**
+   * 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
+   */
+  async getBoundWitnessDivinerForStateStore() {
+    var _a;
+    const name = assertEx((_a = this.config) == null ? void 0 : _a.stateStore.boundWitnessDiviner, () => `${moduleName}: Config for stateStore.boundWitnessDiviner not specified`);
+    const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.boundWitnessDiviner`);
+    return DivinerWrapper.wrap(mod, this.account);
+  }
+  /**
+   * 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
+   */
+  async getPayloadDivinerForStateStore() {
+    var _a, _b;
+    const name = assertEx((_b = (_a = this.config) == null ? void 0 : _a.stateStore) == null ? void 0 : _b.payloadDiviner, () => `${moduleName}: Config for stateStore.payloadDiviner not specified`);
+    const mod = assertEx(await this.resolve(name), () => `${moduleName}: Failed to resolve stateStore.payloadDiviner`);
+    return DivinerWrapper.wrap(mod, this.account);
+  }
+  /**
+   * Retrieves the last state of the Diviner process. Used to recover state after
+   * preemptions, reboots, etc.
+   */
+  async retrieveState() {
+    if (this._lastState)
+      return this._lastState;
+    let hash = "";
+    const diviner = await this.getBoundWitnessDivinerForStateStore();
+    const query = await new PayloadBuilder({ schema: BoundWitnessDivinerQuerySchema }).fields({
+      address: this.account.address,
+      limit: 1,
+      offset: 0,
+      order: "desc",
+      payload_schemas: [ModuleStateSchema]
+    }).build();
+    const boundWitnesses = await diviner.divine([query]);
+    if (boundWitnesses.length > 0) {
+      const boundWitness = boundWitnesses[0];
+      if (isBoundWitness(boundWitness)) {
+        hash = boundWitness.addresses.map((address, index) => ({ address, index })).filter(({ address }) => address === this.account.address).reduce(
+          (prev, curr) => {
+            var _a;
+            return ((_a = boundWitness.payload_schemas) == null ? void 0 : _a[curr == null ? void 0 : curr.index]) === ModuleStateSchema ? boundWitness.payload_hashes[curr == null ? void 0 : curr.index] : prev;
+          },
+          ""
+        );
+      }
+    }
+    if (hash) {
+      const archivist = await this.getArchivistForStateStore();
+      const payload = (await archivist.get([hash])).find(isModuleState);
+      if (payload) {
+        return payload;
+      }
+    }
+    return void 0;
+  }
+};
+
+// src/DivinerMixin.ts
+import { assertEx as assertEx2 } from "@xylabs/assert";
+import { asArchivistInstance } from "@xyo-network/archivist";
+import { BoundWitnessBuilder as BoundWitnessBuilder2 } from "@xyo-network/boundwitness-builder";
+import { isBoundWitness as isBoundWitness2 } from "@xyo-network/boundwitness-model";
+import { BoundWitnessDivinerQuerySchema as BoundWitnessDivinerQuerySchema2 } from "@xyo-network/diviner-boundwitness-model";
+import { asDivinerInstance } from "@xyo-network/diviner-model";
+import {
+  isModuleState as isModuleState2,
+  ModuleStateSchema as ModuleStateSchema2
+} from "@xyo-network/module-model";
+import { PayloadBuilder as PayloadBuilder2 } from "@xyo-network/payload-builder";
+var moduleName2 = "StatefulModuleMixin";
+var StatefulModuleMixin = (ModuleBase) => {
+  class StatefulModuleBase extends ModuleBase {
+    _lastState;
+    /**
+     * 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
+     */
+    async commitState(nextState) {
+      var _a;
+      if (nextState.state.offset === ((_a = this._lastState) == null ? void 0 : _a.state.offset))
+        return;
+      this._lastState = nextState;
+      const archivist = await this.getArchivistForStore();
+      const [bw] = await new BoundWitnessBuilder2().payload(nextState).build();
+      await archivist.insert([bw, nextState]);
+    }
+    /**
+     * Retrieves the archivist for the specified store
+     * @param store The store to retrieve the archivist for
+     * @returns The archivist for the specified store
+     */
+    async getArchivistForStore() {
+      var _a, _b;
+      const name = assertEx2((_b = (_a = this.config) == null ? void 0 : _a.stateStore) == null ? void 0 : _b.archivist, () => `${moduleName2}: Config for stateStore.archivist not specified`);
+      const mod = assertEx2(await this.resolve(name), () => `${moduleName2}: Failed to resolve stateStore.archivist`);
+      const instance = asArchivistInstance(mod);
+      return assertEx2(instance, () => `${moduleName2}: Failed to wrap archivist instance`);
+    }
+    /**
+     * 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
+     */
+    async getBoundWitnessDivinerForStore() {
+      var _a, _b;
+      const name = assertEx2(
+        (_b = (_a = this.config) == null ? void 0 : _a.stateStore) == null ? void 0 : _b.boundWitnessDiviner,
+        () => `${moduleName2}: Config for stateStore.boundWitnessDiviner not specified`
+      );
+      const mod = assertEx2(await this.resolve(name), () => `${moduleName2}: Failed to resolve stateStore.boundWitnessDiviner`);
+      const instance = asDivinerInstance(mod);
+      return assertEx2(instance, () => `${moduleName2}: Failed to wrap diviner instance`);
+    }
+    /**
+     * 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
+     */
+    async getPayloadDivinerForStateStore() {
+      var _a, _b;
+      const name = assertEx2((_b = (_a = this.config) == null ? void 0 : _a.stateStore) == null ? void 0 : _b.payloadDiviner, () => `${moduleName2}: Config for stateStore.payloadDiviner not specified`);
+      const mod = assertEx2(await this.resolve(name), () => `${moduleName2}: Failed to resolve stateStore.payloadDiviner`);
+      const instance = asDivinerInstance(mod);
+      return assertEx2(instance, () => `${moduleName2}: Failed to wrap diviner instance`);
+    }
+    /**
+     * Retrieves the last state of the Diviner process. Used to recover state after
+     * preemptions, reboots, etc.
+     */
+    async retrieveState() {
+      if (this._lastState)
+        return this._lastState;
+      let hash = "";
+      const diviner = await this.getBoundWitnessDivinerForStore();
+      const query = await new PayloadBuilder2({ schema: BoundWitnessDivinerQuerySchema2 }).fields({
+        // address: this.account.address,
+        limit: 1,
+        offset: 0,
+        order: "desc",
+        payload_schemas: [ModuleStateSchema2]
+      }).build();
+      const boundWitnesses = await diviner.divine([query]);
+      if (boundWitnesses.length > 0) {
+        const boundWitness = boundWitnesses[0];
+        if (isBoundWitness2(boundWitness)) {
+          hash = boundWitness.addresses.map((address, index) => ({ address, index })).reduce(
+            (prev, curr) => {
+              var _a;
+              return ((_a = boundWitness.payload_schemas) == null ? void 0 : _a[curr == null ? void 0 : curr.index]) === ModuleStateSchema2 ? boundWitness.payload_hashes[curr == null ? void 0 : curr.index] : prev;
+            },
+            ""
+          );
+        }
+      }
+      if (hash) {
+        const archivist = await this.getArchivistForStore();
+        const payload = (await archivist.get([hash])).find(isModuleState2);
+        if (payload) {
+          return payload;
+        }
+      }
+      return void 0;
+    }
+  }
+  return StatefulModuleBase;
+};
+export {
+  StatefulDiviner,
+  StatefulDivinerConfigSchema,
+  StatefulDivinerSchema,
+  StatefulModuleMixin
+};
+//# sourceMappingURL=index.mjs.map