@xyo-network/sentinel-memory 2.85.5

package/dist/node/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/index.ts","../../src/MemorySentinel.ts","../../src/SentinelRunner.ts","../../src/SentinelIntervalAutomationWrapper.ts"],"sourcesContent":["export * from './MemorySentinel'\n","import { Address } from '@xylabs/hex'\nimport { fulfilled, rejected } from '@xylabs/promise'\nimport { asDivinerInstance } from '@xyo-network/diviner-model'\nimport { AnyConfigSchema } from '@xyo-network/module-model'\nimport { Payload } from '@xyo-network/payload-model'\nimport { AbstractSentinel } from '@xyo-network/sentinel-abstract'\nimport {\n  asSentinelInstance,\n  ResolvedTask,\n  SentinelConfig,\n  SentinelConfigSchema,\n  SentinelInstance,\n  SentinelModuleEventData,\n  SentinelParams,\n} from '@xyo-network/sentinel-model'\nimport { asWitnessInstance } from '@xyo-network/witness-model'\n\nimport { SentinelRunner } from './SentinelRunner'\n\nexport type MemorySentinelParams<TConfig extends AnyConfigSchema<SentinelConfig> = AnyConfigSchema<SentinelConfig>> = SentinelParams<TConfig>\n\nexport class MemorySentinel<\n  TParams extends MemorySentinelParams = MemorySentinelParams,\n  TEventData extends SentinelModuleEventData<SentinelInstance<TParams>> = SentinelModuleEventData<SentinelInstance<TParams>>,\n> extends AbstractSentinel<TParams, TEventData> {\n  static override configSchemas = [SentinelConfigSchema]\n\n  private runner?: SentinelRunner\n\n  async reportHandler(inPayloads: Payload[] = []): Promise<Payload[]> {\n    await this.started('throw')\n    this.logger?.debug(`reportHandler:in: ${JSON.stringify(inPayloads)}`)\n    const job = await this.jobPromise\n\n    let index = 0\n    let previousResults: Record<Address, Payload[]> = {}\n    while (index < job.tasks.length) {\n      const generatedPayloads = await this.generateResults(job.tasks[index], previousResults, inPayloads)\n      previousResults = generatedPayloads\n      index++\n    }\n    const result = Object.values(previousResults).flat()\n    this.logger?.debug(`reportHandler:out: ${JSON.stringify(result)}`)\n    return result\n  }\n\n  override async start(timeout?: number | undefined): Promise<boolean> {\n    if (await super.start(timeout)) {\n      if ((this.config.automations?.length ?? 0) > 0) {\n        this.runner = new SentinelRunner(this, this.config.automations)\n        await this.runner.start()\n      }\n      return true\n    }\n    return false\n  }\n\n  override async stop(timeout?: number | undefined): Promise<boolean> {\n    if (this.runner) {\n      this.runner.stop()\n      this.runner = undefined\n    }\n    return await super.stop(timeout)\n  }\n\n  private async generateResults(\n    tasks: ResolvedTask[],\n    previousResults: Record<Address, Payload[]>,\n    inPayloads?: Payload[],\n  ): Promise<Record<Address, Payload[]>> {\n    this.logger?.debug(`generateResults:tasks: ${JSON.stringify(tasks.length)}`)\n    this.logger?.debug(`generateResults:previous: ${JSON.stringify(previousResults)}`)\n    this.logger?.debug(`generateResults:in: ${JSON.stringify(inPayloads)}`)\n    const results: PromiseSettledResult<[Address, Payload[]]>[] = await Promise.allSettled(\n      tasks?.map(async (task) => {\n        const input = task.input ?? false\n        const inPayloadsFound =\n          input === true ? inPayloads : input === false ? [] : this.processPreviousResults(previousResults, await this.inputAddresses(input))\n        const witness = asWitnessInstance(task.module)\n        if (witness) {\n          const observed = await witness.observe(inPayloadsFound)\n          this.logger?.debug(`observed [${witness.id}]: ${JSON.stringify(observed)}`)\n          return [witness.address, observed]\n        }\n        const diviner = asDivinerInstance(task.module)\n        if (diviner) {\n          const divined = await diviner.divine(inPayloadsFound)\n          this.logger?.debug(`divined [${diviner.id}]: ${JSON.stringify(divined)}`)\n          return [diviner.address, divined]\n        }\n        const sentinel = asSentinelInstance(task.module)\n        if (sentinel) {\n          const reported = await sentinel.report(inPayloadsFound)\n          this.logger?.debug(`reported [${sentinel.id}]: ${JSON.stringify(reported)}`)\n          return [sentinel.address, reported]\n        }\n        throw new Error('Unsupported module type')\n      }),\n    )\n    const finalResult: Record<Address, Payload[]> = {}\n    for (const result of results.filter(fulfilled)) {\n      const [address, payloads] = result.value\n      finalResult[address] = finalResult[address] ?? []\n      finalResult[address].push(...payloads)\n    }\n    if (this.throwErrors) {\n      const errors = results.filter(rejected).map((result) => result.reason)\n      if (errors.length > 0) {\n        throw new Error('At least one module failed')\n      }\n    }\n    this.logger?.debug(`generateResults:out: ${JSON.stringify(finalResult)}`)\n    return finalResult\n  }\n\n  private async inputAddresses(input: string | string[]): Promise<string[]> {\n    if (Array.isArray(input)) {\n      return (await Promise.all(input.map(async (inputItem) => await this.inputAddresses(inputItem)))).flat()\n    } else {\n      const resolved = await this.resolve(input)\n      return resolved ? [resolved.address] : []\n    }\n  }\n\n  private processPreviousResults(payloads: Record<string, Payload[]>, inputs: string[]) {\n    return inputs.flatMap((input) => payloads[input] ?? [])\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Payload } from '@xyo-network/payload-model'\nimport { PayloadWrapper } from '@xyo-network/payload-wrapper'\nimport {\n  isSentinelIntervalAutomation,\n  SentinelAutomationPayload,\n  SentinelInstance,\n  SentinelIntervalAutomationPayload,\n} from '@xyo-network/sentinel-model'\n\nimport { SentinelIntervalAutomationWrapper } from './SentinelIntervalAutomationWrapper'\n\nexport type OnSentinelRunnerTriggerResult = (result: Payload[]) => void\n\nexport class SentinelRunner {\n  protected _automations: Record<string, SentinelAutomationPayload> = {}\n  protected onTriggerResult: OnSentinelRunnerTriggerResult | undefined\n  protected sentinel: SentinelInstance\n  protected timeoutId?: NodeJS.Timeout | string | number\n\n  constructor(sentinel: SentinelInstance, automations?: SentinelAutomationPayload[], onTriggerResult?: OnSentinelRunnerTriggerResult) {\n    this.sentinel = sentinel\n    this.onTriggerResult = onTriggerResult\n    if (automations) for (const automation of automations) this.add(automation)\n  }\n\n  get automations() {\n    return this._automations\n  }\n\n  private get next() {\n    // eslint-disable-next-line unicorn/no-array-reduce\n    return Object.values(this._automations).reduce<SentinelAutomationPayload | undefined>((previous, current) => {\n      if (isSentinelIntervalAutomation(current) && isSentinelIntervalAutomation(previous)) {\n        return current.start < (previous?.start ?? Number.POSITIVE_INFINITY) ? current : previous\n      }\n      return current\n      // eslint-disable-next-line unicorn/no-useless-undefined\n    }, undefined)\n  }\n\n  async add(automation: SentinelAutomationPayload, restart = true) {\n    const hash = await PayloadWrapper.hashAsync(automation)\n    this._automations[hash] = automation\n    if (restart) await this.restart()\n    return hash\n  }\n\n  find(hash: string) {\n    Object.entries(this._automations).find(([key]) => key === hash)\n  }\n\n  async remove(hash: string, restart = true) {\n    delete this._automations[hash]\n    if (restart) await this.restart()\n  }\n\n  removeAll() {\n    this.stop()\n    this._automations = {}\n  }\n\n  async restart() {\n    this.stop()\n    await this.start()\n  }\n\n  async start() {\n    // NOTE: Keep async to match module start signature\n    await Promise.resolve()\n    assertEx(this.timeoutId === undefined, 'Already started')\n    const automation = this.next\n    if (isSentinelIntervalAutomation(automation)) {\n      const now = Date.now()\n      const start = Math.max(automation.start ?? now, now)\n      const delay = Math.max(start - now, 0)\n      if (delay < Number.POSITIVE_INFINITY) {\n        this.timeoutId = setTimeout(async () => {\n          try {\n            // Run the automation\n            await this.trigger(automation)\n            this.stop()\n          } finally {\n            // No matter what start the next automation\n            await this.start()\n          }\n        }, delay)\n      }\n    }\n  }\n\n  stop() {\n    if (this.timeoutId) {\n      clearTimeout(this.timeoutId)\n      this.timeoutId = undefined\n    }\n  }\n\n  async update(hash: string, automation: SentinelAutomationPayload, restart = true) {\n    await this.remove(hash, false)\n    await this.add(automation, false)\n    if (restart) await this.restart()\n  }\n\n  private async trigger(automation: SentinelIntervalAutomationPayload) {\n    const wrapper = new SentinelIntervalAutomationWrapper(automation)\n    await this.remove(await wrapper.hashAsync(), false)\n    wrapper.next()\n    await this.add(wrapper.jsonPayload(), false)\n    const triggerResult = await this.sentinel.report()\n    this.onTriggerResult?.(triggerResult)\n    // await this.start()\n  }\n}\n","import { PayloadWrapper } from '@xyo-network/payload-wrapper'\nimport { SentinelIntervalAutomationPayload } from '@xyo-network/sentinel-model'\n\nexport class SentinelIntervalAutomationWrapper<\n  T extends SentinelIntervalAutomationPayload = SentinelIntervalAutomationPayload,\n> extends PayloadWrapper<T> {\n  constructor(payload: T) {\n    super(payload)\n  }\n\n  protected get frequencyMillis() {\n    const frequency = this.jsonPayload().frequency\n    if (frequency === undefined) return Number.POSITIVE_INFINITY\n    const frequencyUnits = this.jsonPayload().frequencyUnits\n    switch (frequencyUnits ?? 'hour') {\n      case 'second': {\n        return frequency * 1000\n      }\n      case 'minute': {\n        return frequency * 60 * 1000\n      }\n      case 'hour': {\n        return frequency * 60 * 60 * 1000\n      }\n      case 'day': {\n        return frequency * 24 * 60 * 60 * 1000\n      }\n      default: {\n        return Number.POSITIVE_INFINITY\n      }\n    }\n  }\n\n  protected get remaining() {\n    return this.jsonPayload().remaining ?? Number.POSITIVE_INFINITY\n  }\n\n  next() {\n    const now = Date.now()\n    const previousStart = this.jsonPayload()?.start ?? now\n    const start = Math.max(previousStart, now)\n    const nextStart = start + this.frequencyMillis\n    this.setStart(nextStart)\n    this.consumeRemaining()\n    this.checkEnd()\n    return this\n  }\n\n  protected checkEnd() {\n    if (this.jsonPayload().start > (this.jsonPayload().end ?? Number.POSITIVE_INFINITY)) {\n      this.setStart(Number.POSITIVE_INFINITY)\n    }\n  }\n\n  protected consumeRemaining(count = 1) {\n    const remaining = Math.max(this.remaining - count, 0)\n    this.setRemaining(remaining)\n    if (remaining <= 0) this.setStart(Number.POSITIVE_INFINITY)\n  }\n\n  /**\n   * Sets the remaining of the wrapped automation\n   * @param remaining The remaining time in milliseconds\n   */\n  protected setRemaining(remaining: number) {\n    this.obj.remaining = remaining\n  }\n\n  /**\n   * Sets the start of the wrapped automation\n   * @param start The start time in milliseconds\n   */\n  protected setStart(start: number) {\n    this.obj.start = start\n  }\n}\n"],"mappings":"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","names":["import_sentinel_model","import_payload_wrapper","SentinelIntervalAutomationWrapper","PayloadWrapper","constructor","payload","frequencyMillis","frequency","jsonPayload","undefined","Number","POSITIVE_INFINITY","frequencyUnits","remaining","next","now","Date","previousStart","start","Math","max","nextStart","setStart","consumeRemaining","checkEnd","end","count","setRemaining","obj","SentinelRunner","_automations","onTriggerResult","sentinel","timeoutId","constructor","automations","automation","add","next","Object","values","reduce","previous","current","isSentinelIntervalAutomation","start","Number","POSITIVE_INFINITY","undefined","restart","hash","PayloadWrapper","hashAsync","find","entries","key","remove","removeAll","stop","Promise","resolve","assertEx","now","Date","Math","max","delay","setTimeout","trigger","clearTimeout","update","wrapper","SentinelIntervalAutomationWrapper","jsonPayload","triggerResult","report","MemorySentinel","AbstractSentinel","runner","reportHandler","inPayloads","started","logger","debug","JSON","stringify","job","jobPromise","index","previousResults","tasks","length","generatedPayloads","generateResults","result","Object","values","flat","start","timeout","config","automations","SentinelRunner","stop","undefined","results","Promise","allSettled","map","task","_a","_b","_c","input","inPayloadsFound","processPreviousResults","inputAddresses","witness","asWitnessInstance","module","observed","observe","id","address","diviner","asDivinerInstance","divined","divine","sentinel","asSentinelInstance","reported","report","Error","finalResult","filter","fulfilled","payloads","value","push","throwErrors","errors","rejected","reason","Array","isArray","all","inputItem","resolved","resolve","inputs","flatMap","configSchemas","SentinelConfigSchema"]}

package/dist/node/index.d.cts

@@ -0,0 +1,2 @@
+export * from './MemorySentinel';
+//# 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,kBAAkB,CAAA"}

package/dist/node/index.d.mts

@@ -0,0 +1,2 @@
+export * from './MemorySentinel';
+//# 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,kBAAkB,CAAA"}

package/dist/node/index.d.ts

@@ -0,0 +1,2 @@
+export * from './MemorySentinel';
+//# 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,kBAAkB,CAAA"}

package/dist/node/index.js

@@ -0,0 +1,297 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __publicField = (obj, key, value) => {
+  __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+  return value;
+};
+
+// src/MemorySentinel.ts
+import { fulfilled, rejected } from "@xylabs/promise";
+import { asDivinerInstance } from "@xyo-network/diviner-model";
+import { AbstractSentinel } from "@xyo-network/sentinel-abstract";
+import { asSentinelInstance, SentinelConfigSchema } from "@xyo-network/sentinel-model";
+import { asWitnessInstance } from "@xyo-network/witness-model";
+
+// src/SentinelRunner.ts
+import { assertEx } from "@xylabs/assert";
+import { PayloadWrapper as PayloadWrapper2 } from "@xyo-network/payload-wrapper";
+import { isSentinelIntervalAutomation } from "@xyo-network/sentinel-model";
+
+// src/SentinelIntervalAutomationWrapper.ts
+import { PayloadWrapper } from "@xyo-network/payload-wrapper";
+var _SentinelIntervalAutomationWrapper = class _SentinelIntervalAutomationWrapper extends PayloadWrapper {
+  constructor(payload) {
+    super(payload);
+  }
+  get frequencyMillis() {
+    const frequency = this.jsonPayload().frequency;
+    if (frequency === void 0)
+      return Number.POSITIVE_INFINITY;
+    const frequencyUnits = this.jsonPayload().frequencyUnits;
+    switch (frequencyUnits ?? "hour") {
+      case "second": {
+        return frequency * 1e3;
+      }
+      case "minute": {
+        return frequency * 60 * 1e3;
+      }
+      case "hour": {
+        return frequency * 60 * 60 * 1e3;
+      }
+      case "day": {
+        return frequency * 24 * 60 * 60 * 1e3;
+      }
+      default: {
+        return Number.POSITIVE_INFINITY;
+      }
+    }
+  }
+  get remaining() {
+    return this.jsonPayload().remaining ?? Number.POSITIVE_INFINITY;
+  }
+  next() {
+    var _a;
+    const now = Date.now();
+    const previousStart = ((_a = this.jsonPayload()) == null ? void 0 : _a.start) ?? now;
+    const start = Math.max(previousStart, now);
+    const nextStart = start + this.frequencyMillis;
+    this.setStart(nextStart);
+    this.consumeRemaining();
+    this.checkEnd();
+    return this;
+  }
+  checkEnd() {
+    if (this.jsonPayload().start > (this.jsonPayload().end ?? Number.POSITIVE_INFINITY)) {
+      this.setStart(Number.POSITIVE_INFINITY);
+    }
+  }
+  consumeRemaining(count = 1) {
+    const remaining = Math.max(this.remaining - count, 0);
+    this.setRemaining(remaining);
+    if (remaining <= 0)
+      this.setStart(Number.POSITIVE_INFINITY);
+  }
+  /**
+  * Sets the remaining of the wrapped automation
+  * @param remaining The remaining time in milliseconds
+  */
+  setRemaining(remaining) {
+    this.obj.remaining = remaining;
+  }
+  /**
+  * Sets the start of the wrapped automation
+  * @param start The start time in milliseconds
+  */
+  setStart(start) {
+    this.obj.start = start;
+  }
+};
+__name(_SentinelIntervalAutomationWrapper, "SentinelIntervalAutomationWrapper");
+var SentinelIntervalAutomationWrapper = _SentinelIntervalAutomationWrapper;
+
+// src/SentinelRunner.ts
+var _SentinelRunner = class _SentinelRunner {
+  _automations = {};
+  onTriggerResult;
+  sentinel;
+  timeoutId;
+  constructor(sentinel, automations, onTriggerResult) {
+    this.sentinel = sentinel;
+    this.onTriggerResult = onTriggerResult;
+    if (automations)
+      for (const automation of automations)
+        this.add(automation);
+  }
+  get automations() {
+    return this._automations;
+  }
+  get next() {
+    return Object.values(this._automations).reduce((previous, current) => {
+      if (isSentinelIntervalAutomation(current) && isSentinelIntervalAutomation(previous)) {
+        return current.start < ((previous == null ? void 0 : previous.start) ?? Number.POSITIVE_INFINITY) ? current : previous;
+      }
+      return current;
+    }, void 0);
+  }
+  async add(automation, restart = true) {
+    const hash = await PayloadWrapper2.hashAsync(automation);
+    this._automations[hash] = automation;
+    if (restart)
+      await this.restart();
+    return hash;
+  }
+  find(hash) {
+    Object.entries(this._automations).find(([key]) => key === hash);
+  }
+  async remove(hash, restart = true) {
+    delete this._automations[hash];
+    if (restart)
+      await this.restart();
+  }
+  removeAll() {
+    this.stop();
+    this._automations = {};
+  }
+  async restart() {
+    this.stop();
+    await this.start();
+  }
+  async start() {
+    await Promise.resolve();
+    assertEx(this.timeoutId === void 0, "Already started");
+    const automation = this.next;
+    if (isSentinelIntervalAutomation(automation)) {
+      const now = Date.now();
+      const start = Math.max(automation.start ?? now, now);
+      const delay = Math.max(start - now, 0);
+      if (delay < Number.POSITIVE_INFINITY) {
+        this.timeoutId = setTimeout(async () => {
+          try {
+            await this.trigger(automation);
+            this.stop();
+          } finally {
+            await this.start();
+          }
+        }, delay);
+      }
+    }
+  }
+  stop() {
+    if (this.timeoutId) {
+      clearTimeout(this.timeoutId);
+      this.timeoutId = void 0;
+    }
+  }
+  async update(hash, automation, restart = true) {
+    await this.remove(hash, false);
+    await this.add(automation, false);
+    if (restart)
+      await this.restart();
+  }
+  async trigger(automation) {
+    var _a;
+    const wrapper = new SentinelIntervalAutomationWrapper(automation);
+    await this.remove(await wrapper.hashAsync(), false);
+    wrapper.next();
+    await this.add(wrapper.jsonPayload(), false);
+    const triggerResult = await this.sentinel.report();
+    (_a = this.onTriggerResult) == null ? void 0 : _a.call(this, triggerResult);
+  }
+};
+__name(_SentinelRunner, "SentinelRunner");
+var SentinelRunner = _SentinelRunner;
+
+// src/MemorySentinel.ts
+var _MemorySentinel = class _MemorySentinel extends AbstractSentinel {
+  runner;
+  async reportHandler(inPayloads = []) {
+    var _a, _b;
+    await this.started("throw");
+    (_a = this.logger) == null ? void 0 : _a.debug(`reportHandler:in: ${JSON.stringify(inPayloads)}`);
+    const job = await this.jobPromise;
+    let index = 0;
+    let previousResults = {};
+    while (index < job.tasks.length) {
+      const generatedPayloads = await this.generateResults(job.tasks[index], previousResults, inPayloads);
+      previousResults = generatedPayloads;
+      index++;
+    }
+    const result = Object.values(previousResults).flat();
+    (_b = this.logger) == null ? void 0 : _b.debug(`reportHandler:out: ${JSON.stringify(result)}`);
+    return result;
+  }
+  async start(timeout) {
+    var _a;
+    if (await super.start(timeout)) {
+      if ((((_a = this.config.automations) == null ? void 0 : _a.length) ?? 0) > 0) {
+        this.runner = new SentinelRunner(this, this.config.automations);
+        await this.runner.start();
+      }
+      return true;
+    }
+    return false;
+  }
+  async stop(timeout) {
+    if (this.runner) {
+      this.runner.stop();
+      this.runner = void 0;
+    }
+    return await super.stop(timeout);
+  }
+  async generateResults(tasks, previousResults, inPayloads) {
+    var _a, _b, _c, _d;
+    (_a = this.logger) == null ? void 0 : _a.debug(`generateResults:tasks: ${JSON.stringify(tasks.length)}`);
+    (_b = this.logger) == null ? void 0 : _b.debug(`generateResults:previous: ${JSON.stringify(previousResults)}`);
+    (_c = this.logger) == null ? void 0 : _c.debug(`generateResults:in: ${JSON.stringify(inPayloads)}`);
+    const results = await Promise.allSettled(tasks == null ? void 0 : tasks.map(async (task) => {
+      var _a2, _b2, _c2;
+      const input = task.input ?? false;
+      const inPayloadsFound = input === true ? inPayloads : input === false ? [] : this.processPreviousResults(previousResults, await this.inputAddresses(input));
+      const witness = asWitnessInstance(task.module);
+      if (witness) {
+        const observed = await witness.observe(inPayloadsFound);
+        (_a2 = this.logger) == null ? void 0 : _a2.debug(`observed [${witness.id}]: ${JSON.stringify(observed)}`);
+        return [
+          witness.address,
+          observed
+        ];
+      }
+      const diviner = asDivinerInstance(task.module);
+      if (diviner) {
+        const divined = await diviner.divine(inPayloadsFound);
+        (_b2 = this.logger) == null ? void 0 : _b2.debug(`divined [${diviner.id}]: ${JSON.stringify(divined)}`);
+        return [
+          diviner.address,
+          divined
+        ];
+      }
+      const sentinel = asSentinelInstance(task.module);
+      if (sentinel) {
+        const reported = await sentinel.report(inPayloadsFound);
+        (_c2 = this.logger) == null ? void 0 : _c2.debug(`reported [${sentinel.id}]: ${JSON.stringify(reported)}`);
+        return [
+          sentinel.address,
+          reported
+        ];
+      }
+      throw new Error("Unsupported module type");
+    }));
+    const finalResult = {};
+    for (const result of results.filter(fulfilled)) {
+      const [address, payloads] = result.value;
+      finalResult[address] = finalResult[address] ?? [];
+      finalResult[address].push(...payloads);
+    }
+    if (this.throwErrors) {
+      const errors = results.filter(rejected).map((result) => result.reason);
+      if (errors.length > 0) {
+        throw new Error("At least one module failed");
+      }
+    }
+    (_d = this.logger) == null ? void 0 : _d.debug(`generateResults:out: ${JSON.stringify(finalResult)}`);
+    return finalResult;
+  }
+  async inputAddresses(input) {
+    if (Array.isArray(input)) {
+      return (await Promise.all(input.map(async (inputItem) => await this.inputAddresses(inputItem)))).flat();
+    } else {
+      const resolved = await this.resolve(input);
+      return resolved ? [
+        resolved.address
+      ] : [];
+    }
+  }
+  processPreviousResults(payloads, inputs) {
+    return inputs.flatMap((input) => payloads[input] ?? []);
+  }
+};
+__name(_MemorySentinel, "MemorySentinel");
+__publicField(_MemorySentinel, "configSchemas", [
+  SentinelConfigSchema
+]);
+var MemorySentinel = _MemorySentinel;
+export {
+  MemorySentinel
+};
+//# sourceMappingURL=index.js.map

package/dist/node/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/MemorySentinel.ts","../../src/SentinelRunner.ts","../../src/SentinelIntervalAutomationWrapper.ts"],"sourcesContent":["import { Address } from '@xylabs/hex'\nimport { fulfilled, rejected } from '@xylabs/promise'\nimport { asDivinerInstance } from '@xyo-network/diviner-model'\nimport { AnyConfigSchema } from '@xyo-network/module-model'\nimport { Payload } from '@xyo-network/payload-model'\nimport { AbstractSentinel } from '@xyo-network/sentinel-abstract'\nimport {\n  asSentinelInstance,\n  ResolvedTask,\n  SentinelConfig,\n  SentinelConfigSchema,\n  SentinelInstance,\n  SentinelModuleEventData,\n  SentinelParams,\n} from '@xyo-network/sentinel-model'\nimport { asWitnessInstance } from '@xyo-network/witness-model'\n\nimport { SentinelRunner } from './SentinelRunner'\n\nexport type MemorySentinelParams<TConfig extends AnyConfigSchema<SentinelConfig> = AnyConfigSchema<SentinelConfig>> = SentinelParams<TConfig>\n\nexport class MemorySentinel<\n  TParams extends MemorySentinelParams = MemorySentinelParams,\n  TEventData extends SentinelModuleEventData<SentinelInstance<TParams>> = SentinelModuleEventData<SentinelInstance<TParams>>,\n> extends AbstractSentinel<TParams, TEventData> {\n  static override configSchemas = [SentinelConfigSchema]\n\n  private runner?: SentinelRunner\n\n  async reportHandler(inPayloads: Payload[] = []): Promise<Payload[]> {\n    await this.started('throw')\n    this.logger?.debug(`reportHandler:in: ${JSON.stringify(inPayloads)}`)\n    const job = await this.jobPromise\n\n    let index = 0\n    let previousResults: Record<Address, Payload[]> = {}\n    while (index < job.tasks.length) {\n      const generatedPayloads = await this.generateResults(job.tasks[index], previousResults, inPayloads)\n      previousResults = generatedPayloads\n      index++\n    }\n    const result = Object.values(previousResults).flat()\n    this.logger?.debug(`reportHandler:out: ${JSON.stringify(result)}`)\n    return result\n  }\n\n  override async start(timeout?: number | undefined): Promise<boolean> {\n    if (await super.start(timeout)) {\n      if ((this.config.automations?.length ?? 0) > 0) {\n        this.runner = new SentinelRunner(this, this.config.automations)\n        await this.runner.start()\n      }\n      return true\n    }\n    return false\n  }\n\n  override async stop(timeout?: number | undefined): Promise<boolean> {\n    if (this.runner) {\n      this.runner.stop()\n      this.runner = undefined\n    }\n    return await super.stop(timeout)\n  }\n\n  private async generateResults(\n    tasks: ResolvedTask[],\n    previousResults: Record<Address, Payload[]>,\n    inPayloads?: Payload[],\n  ): Promise<Record<Address, Payload[]>> {\n    this.logger?.debug(`generateResults:tasks: ${JSON.stringify(tasks.length)}`)\n    this.logger?.debug(`generateResults:previous: ${JSON.stringify(previousResults)}`)\n    this.logger?.debug(`generateResults:in: ${JSON.stringify(inPayloads)}`)\n    const results: PromiseSettledResult<[Address, Payload[]]>[] = await Promise.allSettled(\n      tasks?.map(async (task) => {\n        const input = task.input ?? false\n        const inPayloadsFound =\n          input === true ? inPayloads : input === false ? [] : this.processPreviousResults(previousResults, await this.inputAddresses(input))\n        const witness = asWitnessInstance(task.module)\n        if (witness) {\n          const observed = await witness.observe(inPayloadsFound)\n          this.logger?.debug(`observed [${witness.id}]: ${JSON.stringify(observed)}`)\n          return [witness.address, observed]\n        }\n        const diviner = asDivinerInstance(task.module)\n        if (diviner) {\n          const divined = await diviner.divine(inPayloadsFound)\n          this.logger?.debug(`divined [${diviner.id}]: ${JSON.stringify(divined)}`)\n          return [diviner.address, divined]\n        }\n        const sentinel = asSentinelInstance(task.module)\n        if (sentinel) {\n          const reported = await sentinel.report(inPayloadsFound)\n          this.logger?.debug(`reported [${sentinel.id}]: ${JSON.stringify(reported)}`)\n          return [sentinel.address, reported]\n        }\n        throw new Error('Unsupported module type')\n      }),\n    )\n    const finalResult: Record<Address, Payload[]> = {}\n    for (const result of results.filter(fulfilled)) {\n      const [address, payloads] = result.value\n      finalResult[address] = finalResult[address] ?? []\n      finalResult[address].push(...payloads)\n    }\n    if (this.throwErrors) {\n      const errors = results.filter(rejected).map((result) => result.reason)\n      if (errors.length > 0) {\n        throw new Error('At least one module failed')\n      }\n    }\n    this.logger?.debug(`generateResults:out: ${JSON.stringify(finalResult)}`)\n    return finalResult\n  }\n\n  private async inputAddresses(input: string | string[]): Promise<string[]> {\n    if (Array.isArray(input)) {\n      return (await Promise.all(input.map(async (inputItem) => await this.inputAddresses(inputItem)))).flat()\n    } else {\n      const resolved = await this.resolve(input)\n      return resolved ? [resolved.address] : []\n    }\n  }\n\n  private processPreviousResults(payloads: Record<string, Payload[]>, inputs: string[]) {\n    return inputs.flatMap((input) => payloads[input] ?? [])\n  }\n}\n","import { assertEx } from '@xylabs/assert'\nimport { Payload } from '@xyo-network/payload-model'\nimport { PayloadWrapper } from '@xyo-network/payload-wrapper'\nimport {\n  isSentinelIntervalAutomation,\n  SentinelAutomationPayload,\n  SentinelInstance,\n  SentinelIntervalAutomationPayload,\n} from '@xyo-network/sentinel-model'\n\nimport { SentinelIntervalAutomationWrapper } from './SentinelIntervalAutomationWrapper'\n\nexport type OnSentinelRunnerTriggerResult = (result: Payload[]) => void\n\nexport class SentinelRunner {\n  protected _automations: Record<string, SentinelAutomationPayload> = {}\n  protected onTriggerResult: OnSentinelRunnerTriggerResult | undefined\n  protected sentinel: SentinelInstance\n  protected timeoutId?: NodeJS.Timeout | string | number\n\n  constructor(sentinel: SentinelInstance, automations?: SentinelAutomationPayload[], onTriggerResult?: OnSentinelRunnerTriggerResult) {\n    this.sentinel = sentinel\n    this.onTriggerResult = onTriggerResult\n    if (automations) for (const automation of automations) this.add(automation)\n  }\n\n  get automations() {\n    return this._automations\n  }\n\n  private get next() {\n    // eslint-disable-next-line unicorn/no-array-reduce\n    return Object.values(this._automations).reduce<SentinelAutomationPayload | undefined>((previous, current) => {\n      if (isSentinelIntervalAutomation(current) && isSentinelIntervalAutomation(previous)) {\n        return current.start < (previous?.start ?? Number.POSITIVE_INFINITY) ? current : previous\n      }\n      return current\n      // eslint-disable-next-line unicorn/no-useless-undefined\n    }, undefined)\n  }\n\n  async add(automation: SentinelAutomationPayload, restart = true) {\n    const hash = await PayloadWrapper.hashAsync(automation)\n    this._automations[hash] = automation\n    if (restart) await this.restart()\n    return hash\n  }\n\n  find(hash: string) {\n    Object.entries(this._automations).find(([key]) => key === hash)\n  }\n\n  async remove(hash: string, restart = true) {\n    delete this._automations[hash]\n    if (restart) await this.restart()\n  }\n\n  removeAll() {\n    this.stop()\n    this._automations = {}\n  }\n\n  async restart() {\n    this.stop()\n    await this.start()\n  }\n\n  async start() {\n    // NOTE: Keep async to match module start signature\n    await Promise.resolve()\n    assertEx(this.timeoutId === undefined, 'Already started')\n    const automation = this.next\n    if (isSentinelIntervalAutomation(automation)) {\n      const now = Date.now()\n      const start = Math.max(automation.start ?? now, now)\n      const delay = Math.max(start - now, 0)\n      if (delay < Number.POSITIVE_INFINITY) {\n        this.timeoutId = setTimeout(async () => {\n          try {\n            // Run the automation\n            await this.trigger(automation)\n            this.stop()\n          } finally {\n            // No matter what start the next automation\n            await this.start()\n          }\n        }, delay)\n      }\n    }\n  }\n\n  stop() {\n    if (this.timeoutId) {\n      clearTimeout(this.timeoutId)\n      this.timeoutId = undefined\n    }\n  }\n\n  async update(hash: string, automation: SentinelAutomationPayload, restart = true) {\n    await this.remove(hash, false)\n    await this.add(automation, false)\n    if (restart) await this.restart()\n  }\n\n  private async trigger(automation: SentinelIntervalAutomationPayload) {\n    const wrapper = new SentinelIntervalAutomationWrapper(automation)\n    await this.remove(await wrapper.hashAsync(), false)\n    wrapper.next()\n    await this.add(wrapper.jsonPayload(), false)\n    const triggerResult = await this.sentinel.report()\n    this.onTriggerResult?.(triggerResult)\n    // await this.start()\n  }\n}\n","import { PayloadWrapper } from '@xyo-network/payload-wrapper'\nimport { SentinelIntervalAutomationPayload } from '@xyo-network/sentinel-model'\n\nexport class SentinelIntervalAutomationWrapper<\n  T extends SentinelIntervalAutomationPayload = SentinelIntervalAutomationPayload,\n> extends PayloadWrapper<T> {\n  constructor(payload: T) {\n    super(payload)\n  }\n\n  protected get frequencyMillis() {\n    const frequency = this.jsonPayload().frequency\n    if (frequency === undefined) return Number.POSITIVE_INFINITY\n    const frequencyUnits = this.jsonPayload().frequencyUnits\n    switch (frequencyUnits ?? 'hour') {\n      case 'second': {\n        return frequency * 1000\n      }\n      case 'minute': {\n        return frequency * 60 * 1000\n      }\n      case 'hour': {\n        return frequency * 60 * 60 * 1000\n      }\n      case 'day': {\n        return frequency * 24 * 60 * 60 * 1000\n      }\n      default: {\n        return Number.POSITIVE_INFINITY\n      }\n    }\n  }\n\n  protected get remaining() {\n    return this.jsonPayload().remaining ?? Number.POSITIVE_INFINITY\n  }\n\n  next() {\n    const now = Date.now()\n    const previousStart = this.jsonPayload()?.start ?? now\n    const start = Math.max(previousStart, now)\n    const nextStart = start + this.frequencyMillis\n    this.setStart(nextStart)\n    this.consumeRemaining()\n    this.checkEnd()\n    return this\n  }\n\n  protected checkEnd() {\n    if (this.jsonPayload().start > (this.jsonPayload().end ?? Number.POSITIVE_INFINITY)) {\n      this.setStart(Number.POSITIVE_INFINITY)\n    }\n  }\n\n  protected consumeRemaining(count = 1) {\n    const remaining = Math.max(this.remaining - count, 0)\n    this.setRemaining(remaining)\n    if (remaining <= 0) this.setStart(Number.POSITIVE_INFINITY)\n  }\n\n  /**\n   * Sets the remaining of the wrapped automation\n   * @param remaining The remaining time in milliseconds\n   */\n  protected setRemaining(remaining: number) {\n    this.obj.remaining = remaining\n  }\n\n  /**\n   * Sets the start of the wrapped automation\n   * @param start The start time in milliseconds\n   */\n  protected setStart(start: number) {\n    this.obj.start = start\n  }\n}\n"],"mappings":"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","names":["fulfilled","rejected","asDivinerInstance","AbstractSentinel","asSentinelInstance","SentinelConfigSchema","asWitnessInstance","assertEx","PayloadWrapper","isSentinelIntervalAutomation","PayloadWrapper","SentinelIntervalAutomationWrapper","PayloadWrapper","constructor","payload","frequencyMillis","frequency","jsonPayload","undefined","Number","POSITIVE_INFINITY","frequencyUnits","remaining","next","now","Date","previousStart","start","Math","max","nextStart","setStart","consumeRemaining","checkEnd","end","count","setRemaining","obj","SentinelRunner","_automations","onTriggerResult","sentinel","timeoutId","constructor","automations","automation","add","next","Object","values","reduce","previous","current","isSentinelIntervalAutomation","start","Number","POSITIVE_INFINITY","undefined","restart","hash","PayloadWrapper","hashAsync","find","entries","key","remove","removeAll","stop","Promise","resolve","assertEx","now","Date","Math","max","delay","setTimeout","trigger","clearTimeout","update","wrapper","SentinelIntervalAutomationWrapper","jsonPayload","triggerResult","report","MemorySentinel","AbstractSentinel","runner","reportHandler","inPayloads","started","logger","debug","JSON","stringify","job","jobPromise","index","previousResults","tasks","length","generatedPayloads","generateResults","result","Object","values","flat","start","timeout","config","automations","SentinelRunner","stop","undefined","results","Promise","allSettled","map","task","_a","_b","_c","input","inPayloadsFound","processPreviousResults","inputAddresses","witness","asWitnessInstance","module","observed","observe","id","address","diviner","asDivinerInstance","divined","divine","sentinel","asSentinelInstance","reported","report","Error","finalResult","filter","fulfilled","payloads","value","push","throwErrors","errors","rejected","reason","Array","isArray","all","inputItem","resolved","resolve","inputs","flatMap","configSchemas","SentinelConfigSchema"]}

package/package.json

@@ -0,0 +1,77 @@
+{
+  "name": "@xyo-network/sentinel-memory",
+  "author": {
+    "email": "support@xyo.network",
+    "name": "XYO Development Team",
+    "url": "https://xyo.network"
+  },
+  "bugs": {
+    "email": "support@xyo.network",
+    "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js/issues"
+  },
+  "dependencies": {
+    "@xylabs/assert": "^2.13.23",
+    "@xylabs/hex": "^2.13.23",
+    "@xylabs/promise": "^2.13.23",
+    "@xyo-network/diviner-model": "~2.85.5",
+    "@xyo-network/module-model": "~2.85.5",
+    "@xyo-network/payload-model": "~2.85.5",
+    "@xyo-network/payload-wrapper": "~2.85.5",
+    "@xyo-network/sentinel-abstract": "~2.85.5",
+    "@xyo-network/sentinel-model": "~2.85.5",
+    "@xyo-network/witness-model": "~2.85.5"
+  },
+  "description": "Primary SDK for using XYO Protocol 2.0",
+  "devDependencies": {
+    "@xylabs/delay": "^2.13.23",
+    "@xylabs/ts-scripts-yarn3": "^3.2.25",
+    "@xylabs/tsconfig": "^3.2.25",
+    "@xyo-network/abstract-witness": "~2.85.5",
+    "@xyo-network/account": "~2.85.5",
+    "@xyo-network/archivist-memory": "~2.85.5",
+    "@xyo-network/id-payload-plugin": "~2.85.5",
+    "@xyo-network/node-memory": "~2.85.5",
+    "@xyo-network/witness-adhoc": "~2.85.5",
+    "typescript": "^5.3.3"
+  },
+  "types": "dist/node/index.d.ts",
+  "exports": {
+    ".": {
+      "browser": {
+        "require": {
+          "types": "./dist/browser/index.d.cts",
+          "default": "./dist/browser/index.cjs"
+        },
+        "import": {
+          "types": "./dist/browser/index.d.mts",
+          "default": "./dist/browser/index.js"
+        }
+      },
+      "node": {
+        "require": {
+          "types": "./dist/node/index.d.cts",
+          "default": "./dist/node/index.cjs"
+        },
+        "import": {
+          "types": "./dist/node/index.d.mts",
+          "default": "./dist/node/index.js"
+        }
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/node/index.cjs",
+  "module": "dist/node/index.js",
+  "homepage": "https://xyo.network",
+  "license": "LGPL-3.0-only",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/XYOracleNetwork/sdk-xyo-client-js.git"
+  },
+  "sideEffects": false,
+  "version": "2.85.5",
+  "type": "module"
+}

package/src/MemorySentinel.ts

@@ -0,0 +1,128 @@
+import { Address } from '@xylabs/hex'
+import { fulfilled, rejected } from '@xylabs/promise'
+import { asDivinerInstance } from '@xyo-network/diviner-model'
+import { AnyConfigSchema } from '@xyo-network/module-model'
+import { Payload } from '@xyo-network/payload-model'
+import { AbstractSentinel } from '@xyo-network/sentinel-abstract'
+import {
+  asSentinelInstance,
+  ResolvedTask,
+  SentinelConfig,
+  SentinelConfigSchema,
+  SentinelInstance,
+  SentinelModuleEventData,
+  SentinelParams,
+} from '@xyo-network/sentinel-model'
+import { asWitnessInstance } from '@xyo-network/witness-model'
+
+import { SentinelRunner } from './SentinelRunner'
+
+export type MemorySentinelParams<TConfig extends AnyConfigSchema<SentinelConfig> = AnyConfigSchema<SentinelConfig>> = SentinelParams<TConfig>
+
+export class MemorySentinel<
+  TParams extends MemorySentinelParams = MemorySentinelParams,
+  TEventData extends SentinelModuleEventData<SentinelInstance<TParams>> = SentinelModuleEventData<SentinelInstance<TParams>>,
+> extends AbstractSentinel<TParams, TEventData> {
+  static override configSchemas = [SentinelConfigSchema]
+
+  private runner?: SentinelRunner
+
+  async reportHandler(inPayloads: Payload[] = []): Promise<Payload[]> {
+    await this.started('throw')
+    this.logger?.debug(`reportHandler:in: ${JSON.stringify(inPayloads)}`)
+    const job = await this.jobPromise
+
+    let index = 0
+    let previousResults: Record<Address, Payload[]> = {}
+    while (index < job.tasks.length) {
+      const generatedPayloads = await this.generateResults(job.tasks[index], previousResults, inPayloads)
+      previousResults = generatedPayloads
+      index++
+    }
+    const result = Object.values(previousResults).flat()
+    this.logger?.debug(`reportHandler:out: ${JSON.stringify(result)}`)
+    return result
+  }
+
+  override async start(timeout?: number | undefined): Promise<boolean> {
+    if (await super.start(timeout)) {
+      if ((this.config.automations?.length ?? 0) > 0) {
+        this.runner = new SentinelRunner(this, this.config.automations)
+        await this.runner.start()
+      }
+      return true
+    }
+    return false
+  }
+
+  override async stop(timeout?: number | undefined): Promise<boolean> {
+    if (this.runner) {
+      this.runner.stop()
+      this.runner = undefined
+    }
+    return await super.stop(timeout)
+  }
+
+  private async generateResults(
+    tasks: ResolvedTask[],
+    previousResults: Record<Address, Payload[]>,
+    inPayloads?: Payload[],
+  ): Promise<Record<Address, Payload[]>> {
+    this.logger?.debug(`generateResults:tasks: ${JSON.stringify(tasks.length)}`)
+    this.logger?.debug(`generateResults:previous: ${JSON.stringify(previousResults)}`)
+    this.logger?.debug(`generateResults:in: ${JSON.stringify(inPayloads)}`)
+    const results: PromiseSettledResult<[Address, Payload[]]>[] = await Promise.allSettled(
+      tasks?.map(async (task) => {
+        const input = task.input ?? false
+        const inPayloadsFound =
+          input === true ? inPayloads : input === false ? [] : this.processPreviousResults(previousResults, await this.inputAddresses(input))
+        const witness = asWitnessInstance(task.module)
+        if (witness) {
+          const observed = await witness.observe(inPayloadsFound)
+          this.logger?.debug(`observed [${witness.id}]: ${JSON.stringify(observed)}`)
+          return [witness.address, observed]
+        }
+        const diviner = asDivinerInstance(task.module)
+        if (diviner) {
+          const divined = await diviner.divine(inPayloadsFound)
+          this.logger?.debug(`divined [${diviner.id}]: ${JSON.stringify(divined)}`)
+          return [diviner.address, divined]
+        }
+        const sentinel = asSentinelInstance(task.module)
+        if (sentinel) {
+          const reported = await sentinel.report(inPayloadsFound)
+          this.logger?.debug(`reported [${sentinel.id}]: ${JSON.stringify(reported)}`)
+          return [sentinel.address, reported]
+        }
+        throw new Error('Unsupported module type')
+      }),
+    )
+    const finalResult: Record<Address, Payload[]> = {}
+    for (const result of results.filter(fulfilled)) {
+      const [address, payloads] = result.value
+      finalResult[address] = finalResult[address] ?? []
+      finalResult[address].push(...payloads)
+    }
+    if (this.throwErrors) {
+      const errors = results.filter(rejected).map((result) => result.reason)
+      if (errors.length > 0) {
+        throw new Error('At least one module failed')
+      }
+    }
+    this.logger?.debug(`generateResults:out: ${JSON.stringify(finalResult)}`)
+    return finalResult
+  }
+
+  private async inputAddresses(input: string | string[]): Promise<string[]> {
+    if (Array.isArray(input)) {
+      return (await Promise.all(input.map(async (inputItem) => await this.inputAddresses(inputItem)))).flat()
+    } else {
+      const resolved = await this.resolve(input)
+      return resolved ? [resolved.address] : []
+    }
+  }
+
+  private processPreviousResults(payloads: Record<string, Payload[]>, inputs: string[]) {
+    return inputs.flatMap((input) => payloads[input] ?? [])
+  }
+}