@xyo-network/location-certainty-plugin 2.42.0

package/dist/esm/Diviner/Config.d.ts

@@ -0,0 +1,10 @@
+import { DivinerConfig } from '@xyo-network/diviner';
+import { LocationCertaintyPayload, LocationCertaintySchema } from '@xyo-network/location-certainty-payload-plugin';
+import { XyoPayload } from '@xyo-network/payload';
+export type LocationCertaintyDivinerConfigSchema = 'network.xyo.location.elevation.diviner.config';
+export declare const LocationCertaintyDivinerConfigSchema: LocationCertaintyDivinerConfigSchema;
+export type LocationCertaintyDivinerConfig<TConfig extends XyoPayload = XyoPayload> = DivinerConfig<LocationCertaintyPayload, TConfig & {
+    schema: LocationCertaintyDivinerConfigSchema;
+    targetSchema: LocationCertaintySchema;
+}>;
+//# sourceMappingURL=Config.d.ts.map

package/dist/esm/Diviner/Config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.d.ts","sourceRoot":"","sources":["../../../src/Diviner/Config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAA;AAClH,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAEjD,MAAM,MAAM,oCAAoC,GAAG,+CAA+C,CAAA;AAClG,eAAO,MAAM,oCAAoC,EAAE,oCAAsF,CAAA;AAEzI,MAAM,MAAM,8BAA8B,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,IAAI,aAAa,CACjG,wBAAwB,EACxB,OAAO,GAAG;IACR,MAAM,EAAE,oCAAoC,CAAA;IAC5C,YAAY,EAAE,uBAAuB,CAAA;CACtC,CACF,CAAA"}

package/dist/esm/Diviner/Config.js

@@ -0,0 +1,2 @@
+export const LocationCertaintyDivinerConfigSchema = 'network.xyo.location.elevation.diviner.config';
+//# sourceMappingURL=Config.js.map

package/dist/esm/Diviner/Config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Config.js","sourceRoot":"","sources":["../../../src/Diviner/Config.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,MAAM,oCAAoC,GAAyC,+CAA+C,CAAA"}

package/dist/esm/Diviner/Diviner.d.ts

@@ -0,0 +1,18 @@
+import { AbstractDiviner } from '@xyo-network/diviner';
+import { XyoModuleParams } from '@xyo-network/module';
+import { XyoPayloads } from '@xyo-network/payload';
+import { Job, JobProvider } from '@xyo-network/shared';
+import { LocationCertaintyDivinerConfig } from './Config';
+export declare class LocationCertaintyDiviner extends AbstractDiviner<LocationCertaintyDivinerConfig> implements LocationCertaintyDiviner, JobProvider {
+    static configSchema: "network.xyo.location.elevation.diviner.config";
+    static targetSchema: "network.xyo.location.certainty";
+    get jobs(): Job[];
+    static create(params?: XyoModuleParams<LocationCertaintyDivinerConfig>): Promise<LocationCertaintyDiviner>;
+    private static calcHeuristic;
+    private static locationsToHeuristics;
+    /** @description Given a set of locations, get the expected elevations (witness if needed), and return score/variance */
+    divine(payloads?: XyoPayloads): Promise<XyoPayloads>;
+    /** @description Is the goal here to prime/index the diviner? */
+    private divineElevationBatch;
+}
+//# sourceMappingURL=Diviner.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Diviner.d.ts","sourceRoot":"","sources":["../../../src/Diviner/Diviner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAKtD,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AACrD,OAAO,EAAqB,WAAW,EAAE,MAAM,sBAAsB,CAAA;AACrE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAEtD,OAAO,EAAE,8BAA8B,EAAwC,MAAM,UAAU,CAAA;AAE/F,qBAAa,wBAAyB,SAAQ,eAAe,CAAC,8BAA8B,CAAE,YAAW,wBAAwB,EAAE,WAAW;IAC5I,OAAgB,YAAY,kDAAuC;IACnE,OAAgB,YAAY,mCAA0B;IAEtD,IAAI,IAAI,IAAI,GAAG,EAAE,CAQhB;WAEqB,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC,8BAA8B,CAAC;IAKrF,OAAO,CAAC,MAAM,CAAC,aAAa;IAqB5B,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAkBpC,wHAAwH;IAC3G,MAAM,CAAC,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IA4BjE,gEAAgE;IAChE,OAAO,CAAC,oBAAoB,CAK3B;CACF"}

package/dist/esm/Diviner/Diviner.js

@@ -0,0 +1,87 @@
+import { AbstractDiviner } from '@xyo-network/diviner';
+import { ElevationWitness, ElevationWitnessConfigSchema } from '@xyo-network/elevation-plugin';
+import { LocationCertaintySchema } from '@xyo-network/location-certainty-payload-plugin';
+import { LocationSchema } from '@xyo-network/location-payload-plugin';
+import { XyoPayloadBuilder } from '@xyo-network/payload';
+import { LocationCertaintyDivinerConfigSchema } from './Config';
+export class LocationCertaintyDiviner extends AbstractDiviner {
+    static configSchema = LocationCertaintyDivinerConfigSchema;
+    static targetSchema = LocationCertaintySchema;
+    get jobs() {
+        return [
+            {
+                name: 'LocationCertaintyDiviner.DivineElevationBatch',
+                schedule: '10 minute',
+                task: async () => await this.divineElevationBatch(),
+            },
+        ];
+    }
+    static async create(params) {
+        return (await super.create(params));
+    }
+    /* Given an array of numbers, find the min/max/mean */
+    static calcHeuristic(heuristic) {
+        return {
+            max: heuristic.reduce((prev, value) => {
+                return value !== null ? (value > prev ? value : prev) : prev;
+            }, -Infinity),
+            mean: (() => {
+                const values = heuristic.reduce((prev, value) => {
+                    return value !== null ? [value + prev[0], prev[1] + 1] : prev;
+                }, [0, 0]);
+                return values[0] / values[1];
+            })(),
+            min: heuristic.reduce((prev, value) => {
+                return value !== null ? (value < prev ? value : prev) : prev;
+            }, Infinity),
+        };
+    }
+    /* Given elevation and location payloads, generate heuristic arrays */
+    static locationsToHeuristics(elevations, locations) {
+        const heuristics = elevations.reduce((prev, elev, index) => {
+            const elevation = elev.elevation;
+            if (elevation === undefined || elevation === null) {
+                throw Error('Invalid Elevation');
+            }
+            const altitude = locations[index].altitude;
+            prev.altitude.push(altitude ?? null);
+            prev.elevation.push(elevation);
+            prev.variance.push(altitude !== undefined && altitude !== null ? altitude - elevation : null);
+            return prev;
+        }, { altitude: [], elevation: [], variance: [] });
+        return heuristics;
+    }
+    /** @description Given a set of locations, get the expected elevations (witness if needed), and return score/variance */
+    async divine(payloads) {
+        const locations = payloads?.filter((payload) => payload?.schema === LocationSchema);
+        // If this is a query we support
+        if (locations && locations?.length > 0) {
+            const elevationWitness = await ElevationWitness.create({
+                config: {
+                    locations,
+                    schema: ElevationWitnessConfigSchema,
+                },
+            });
+            const elevations = (await elevationWitness.observe());
+            const heuristics = LocationCertaintyDiviner.locationsToHeuristics(elevations, locations);
+            const result = new XyoPayloadBuilder({ schema: LocationCertaintySchema })
+                .fields({
+                altitude: LocationCertaintyDiviner.calcHeuristic(heuristics.altitude),
+                elevation: LocationCertaintyDiviner.calcHeuristic(heuristics.elevation),
+                variance: LocationCertaintyDiviner.calcHeuristic(heuristics.variance),
+            })
+                .build();
+            this.logger?.log('LocationCertaintyDiviner.Divine: Processed query');
+            return [result];
+        }
+        return [];
+    }
+    /** @description Is the goal here to prime/index the diviner? */
+    divineElevationBatch = async () => {
+        this.logger?.log('LocationCertaintyDiviner.DivineElevationBatch: Divining elevations for batch');
+        // TODO: Any background/batch processing here
+        await Promise.resolve();
+        this.logger?.log('LocationCertaintyDiviner.DivineElevationBatch: Divined elevations for batch');
+    };
+}
+//# sourceMappingURL=Diviner.js.map

package/dist/esm/Diviner/Diviner.js.map

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

package/dist/esm/Diviner/index.d.ts

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

package/dist/esm/Diviner/index.d.ts.map

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

package/dist/esm/Diviner/index.js

@@ -0,0 +1,3 @@
+export * from './Config';
+export * from './Diviner';
+//# sourceMappingURL=index.js.map

package/dist/esm/Diviner/index.js.map

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

package/dist/esm/Plugin.d.ts

@@ -0,0 +1,16 @@
+import { XyoModuleParams } from '@xyo-network/module';
+import { PayloadSetDivinerPlugin } from '@xyo-network/payloadset-plugin';
+export declare const LocationCertaintyPlugin: () => PayloadSetDivinerPlugin<XyoModuleParams<import("@xyo-network/payload").SchemaFields & import("@xyo-network/payload").PayloadFields & {
+    security?: {
+        allowed?: Record<string, string[][]> | undefined;
+        disallowed?: Record<string, string[]> | undefined;
+    } | undefined;
+} & {
+    targetSchema?: "network.xyo.location.certainty" | undefined;
+} & {
+    schema: string;
+} & {
+    schema: "network.xyo.location.elevation.diviner.config";
+    targetSchema: "network.xyo.location.certainty";
+}>>;
+//# sourceMappingURL=Plugin.d.ts.map

package/dist/esm/Plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.d.ts","sourceRoot":"","sources":["../../src/Plugin.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAA;AAErD,OAAO,EAA0B,uBAAuB,EAAE,MAAM,gCAAgC,CAAA;AAIhG,eAAO,MAAM,uBAAuB;;;;;;;;;;;;GAQjC,CAAA"}

package/dist/esm/Plugin.js

@@ -0,0 +1,10 @@
+import { LocationCertaintySchema } from '@xyo-network/location-certainty-payload-plugin';
+import { PayloadSetSchema } from '@xyo-network/payload';
+import { createPayloadSetPlugin } from '@xyo-network/payloadset-plugin';
+import { LocationCertaintyDiviner } from './Diviner';
+export const LocationCertaintyPlugin = () => createPayloadSetPlugin({ required: { [LocationCertaintySchema]: 1 }, schema: PayloadSetSchema }, {
+    diviner: async (params) => {
+        return await LocationCertaintyDiviner.create(params);
+    },
+});
+//# sourceMappingURL=Plugin.js.map

package/dist/esm/Plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Plugin.js","sourceRoot":"","sources":["../../src/Plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,gDAAgD,CAAA;AAExF,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AACvD,OAAO,EAAE,sBAAsB,EAA2B,MAAM,gCAAgC,CAAA;AAEhG,OAAO,EAAE,wBAAwB,EAAkC,MAAM,WAAW,CAAA;AAEpF,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,EAAE,CAC1C,sBAAsB,CACpB,EAAE,QAAQ,EAAE,EAAE,CAAC,uBAAuB,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,gBAAgB,EAAE,EACxE;IACE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QACxB,OAAO,MAAM,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACtD,CAAC;CACF,CACF,CAAA"}

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+import { LocationCertaintyPlugin } from './Plugin';
+export * from './Diviner';
+export { LocationCertaintyPlugin };
+export default LocationCertaintyPlugin;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAElD,cAAc,WAAW,CAAA;AAEzB,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAGlC,eAAe,uBAAuB,CAAA"}

package/dist/esm/index.js

@@ -0,0 +1,6 @@
+import { LocationCertaintyPlugin } from './Plugin';
+export * from './Diviner';
+export { LocationCertaintyPlugin };
+// eslint-disable-next-line import/no-default-export
+export default LocationCertaintyPlugin;
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAA;AAElD,cAAc,WAAW,CAAA;AAEzB,OAAO,EAAE,uBAAuB,EAAE,CAAA;AAElC,oDAAoD;AACpD,eAAe,uBAAuB,CAAA"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@xyo-network/location-certainty-plugin",
+  "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": {
+    "@xyo-network/diviner": "^2.42.0",
+    "@xyo-network/elevation-payload-plugin": "^2.42.0",
+    "@xyo-network/elevation-plugin": "^2.42.0",
+    "@xyo-network/location-certainty-payload-plugin": "^2.42.0",
+    "@xyo-network/location-payload-plugin": "^2.42.0",
+    "@xyo-network/module": "^2.42.0",
+    "@xyo-network/payload": "^2.42.0",
+    "@xyo-network/payloadset-plugin": "^2.42.0",
+    "@xyo-network/shared": "^2.42.0",
+    "tslib": "^2.4.1"
+  },
+  "devDependencies": {
+    "axios": "~1.2.1",
+    "pako": "^2.1.0"
+  },
+  "peerDependencies": {
+    "axios": "~1.2.1",
+    "pako": "^2.1.0"
+  },
+  "description": "Primary SDK for using XYO Protocol 2.0",
+  "browser": "dist/esm/index.js",
+  "docs": "dist/docs.json",
+  "exports": {
+    ".": {
+      "node": {
+        "import": "./dist/esm/index.js",
+        "require": "./dist/cjs/index.js"
+      },
+      "browser": {
+        "import": "./dist/esm/index.js",
+        "require": "./dist/cjs/index.js"
+      },
+      "default": "./dist/esm/index.js"
+    },
+    "./dist/docs.json": {
+      "default": "./dist/docs.json"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/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,
+  "types": "dist/esm/index.d.ts",
+  "version": "2.42.0"
+}

package/src/Diviner/Config.ts

@@ -0,0 +1,14 @@
+import { DivinerConfig } from '@xyo-network/diviner'
+import { LocationCertaintyPayload, LocationCertaintySchema } from '@xyo-network/location-certainty-payload-plugin'
+import { XyoPayload } from '@xyo-network/payload'
+
+export type LocationCertaintyDivinerConfigSchema = 'network.xyo.location.elevation.diviner.config'
+export const LocationCertaintyDivinerConfigSchema: LocationCertaintyDivinerConfigSchema = 'network.xyo.location.elevation.diviner.config'
+
+export type LocationCertaintyDivinerConfig<TConfig extends XyoPayload = XyoPayload> = DivinerConfig<
+  LocationCertaintyPayload,
+  TConfig & {
+    schema: LocationCertaintyDivinerConfigSchema
+    targetSchema: LocationCertaintySchema
+  }
+>

package/src/Diviner/Diviner.spec.ts

@@ -0,0 +1,128 @@
+import { AbstractArchivist, MemoryArchivist } from '@xyo-network/archivist'
+import { LocationCertaintyPayload, LocationCertaintySchema } from '@xyo-network/location-certainty-payload-plugin'
+import { LocationPayload, LocationSchema } from '@xyo-network/location-payload-plugin'
+import { XyoModuleResolver } from '@xyo-network/module'
+
+import { LocationCertaintyDivinerConfigSchema } from './Config'
+import { LocationCertaintyDiviner } from './Diviner'
+
+const sample1: LocationPayload[] = [
+  {
+    altitude: -5,
+    latitude: 32.71664,
+    longitude: -117.12033,
+    schema: LocationSchema,
+  },
+  {
+    altitude: -9,
+    latitude: 32.7174,
+    longitude: -117.11674,
+    schema: LocationSchema,
+  },
+  {
+    altitude: -11,
+    latitude: 32.71788,
+    longitude: -117.11377,
+    schema: LocationSchema,
+  },
+]
+
+const sample2: LocationPayload[] = [
+  {
+    altitude: 50,
+    latitude: 32.71664,
+    longitude: -117.12033,
+    schema: LocationSchema,
+  },
+  {
+    altitude: 53,
+    latitude: 32.7174,
+    longitude: -117.11674,
+    schema: LocationSchema,
+  },
+  {
+    altitude: 55,
+    latitude: 32.71788,
+    longitude: -117.11377,
+    schema: LocationSchema,
+  },
+]
+
+const sample3: LocationPayload[] = [
+  {
+    altitude: 151,
+    latitude: 32.71664,
+    longitude: -117.12033,
+    schema: LocationSchema,
+  },
+  {
+    altitude: 163,
+    latitude: 32.7174,
+    longitude: -117.11674,
+    schema: LocationSchema,
+  },
+  {
+    altitude: 168,
+    latitude: 32.71788,
+    longitude: -117.11377,
+    schema: LocationSchema,
+  },
+]
+
+describe('MongoDBLocationCertaintyDiviner', () => {
+  let payloadsArchivist: AbstractArchivist
+  let sut: LocationCertaintyDiviner
+  beforeEach(async () => {
+    payloadsArchivist = await MemoryArchivist.create()
+    const params = {
+      config: {
+        schema: LocationCertaintyDivinerConfigSchema,
+        targetSchema: LocationCertaintySchema,
+      },
+      resolver: new XyoModuleResolver().add(payloadsArchivist),
+    }
+    sut = await LocationCertaintyDiviner.create(params)
+  })
+  describe('divine', () => {
+    describe('with valid query', () => {
+      it('divines', async () => {
+        const noLocations: LocationPayload[] = []
+        const noLocationsResult = await sut.divine(noLocations)
+        expect(noLocationsResult).toBeArrayOfSize(0)
+        const locations: LocationPayload[] = [
+          { altitude: 5, quadkey: '0203', schema: LocationSchema },
+          { altitude: 300, quadkey: '0102', schema: LocationSchema },
+        ]
+        const locationsResult = await sut.divine(locations)
+        expect(locationsResult).toBeArrayOfSize(1)
+        const actual = locationsResult[0] as LocationCertaintyPayload
+        expect(actual).toBeObject()
+        expect(actual.schema).toBe(LocationCertaintySchema)
+
+        const locationsResult1 = (await sut.divine(sample1)) as LocationCertaintyPayload[]
+        const locationsResult2 = (await sut.divine(sample2)) as LocationCertaintyPayload[]
+        const locationsResult3 = (await sut.divine(sample3)) as LocationCertaintyPayload[]
+        ;[locationsResult1, locationsResult2, locationsResult3].map(validateLocationResult)
+      })
+    })
+  })
+})
+
+const validateLocationResult = (results: LocationCertaintyPayload[]) => {
+  expect(results).toBeArrayOfSize(1)
+  const [result] = results
+  expect(result).toBeObject()
+  expect(result.schema).toBe(LocationCertaintySchema)
+  expect(result.altitude).toBeObject()
+  expect(result.altitude.max).toBeNumber()
+  expect(result.altitude.mean).toBeNumber()
+  expect(result.altitude.min).toBeNumber()
+  expect(result.elevation).toBeObject()
+  expect(result.elevation.max).toBeNumber()
+  expect(result.elevation.mean).toBeNumber()
+  expect(result.elevation.min).toBeNumber()
+  expect(result.variance).toBeObject()
+  expect(result.variance.max).toBeNumber()
+  expect(result.variance.mean).toBeNumber()
+  expect(result.variance.min).toBeNumber()
+}

package/src/Diviner/Diviner.ts

@@ -0,0 +1,106 @@
+import { AbstractDiviner } from '@xyo-network/diviner'
+import { ElevationPayload } from '@xyo-network/elevation-payload-plugin'
+import { ElevationWitness, ElevationWitnessConfigSchema } from '@xyo-network/elevation-plugin'
+import { LocationCertaintyHeuristic, LocationCertaintyPayload, LocationCertaintySchema } from '@xyo-network/location-certainty-payload-plugin'
+import { LocationPayload, LocationSchema } from '@xyo-network/location-payload-plugin'
+import { XyoModuleParams } from '@xyo-network/module'
+import { XyoPayloadBuilder, XyoPayloads } from '@xyo-network/payload'
+import { Job, JobProvider } from '@xyo-network/shared'
+
+import { LocationCertaintyDivinerConfig, LocationCertaintyDivinerConfigSchema } from './Config'
+
+export class LocationCertaintyDiviner extends AbstractDiviner<LocationCertaintyDivinerConfig> implements LocationCertaintyDiviner, JobProvider {
+  static override configSchema = LocationCertaintyDivinerConfigSchema
+  static override targetSchema = LocationCertaintySchema
+
+  get jobs(): Job[] {
+    return [
+      {
+        name: 'LocationCertaintyDiviner.DivineElevationBatch',
+        schedule: '10 minute',
+        task: async () => await this.divineElevationBatch(),
+      },
+    ]
+  }
+
+  static override async create(params?: XyoModuleParams<LocationCertaintyDivinerConfig>) {
+    return (await super.create(params)) as LocationCertaintyDiviner
+  }
+
+  /* Given an array of numbers, find the min/max/mean */
+  private static calcHeuristic(heuristic: (number | null)[]): LocationCertaintyHeuristic {
+    return {
+      max: heuristic.reduce<number>((prev, value) => {
+        return value !== null ? (value > prev ? value : prev) : prev
+      }, -Infinity),
+      mean: (() => {
+        const values = heuristic.reduce<number[]>(
+          (prev, value) => {
+            return value !== null ? [value + prev[0], prev[1] + 1] : prev
+          },
+          [0, 0],
+        )
+        return values[0] / values[1]
+      })(),
+      min: heuristic.reduce<number>((prev, value) => {
+        return value !== null ? (value < prev ? value : prev) : prev
+      }, Infinity),
+    }
+  }
+
+  /* Given elevation and location payloads, generate heuristic arrays */
+  private static locationsToHeuristics(elevations: ElevationPayload[], locations: LocationPayload[]) {
+    const heuristics = elevations.reduce<{ altitude: (number | null)[]; elevation: number[]; variance: (number | null)[] }>(
+      (prev, elev, index) => {
+        const elevation = elev.elevation
+        if (elevation === undefined || elevation === null) {
+          throw Error('Invalid Elevation')
+        }
+        const altitude = locations[index].altitude
+        prev.altitude.push(altitude ?? null)
+        prev.elevation.push(elevation)
+        prev.variance.push(altitude !== undefined && altitude !== null ? altitude - elevation : null)
+        return prev
+      },
+      { altitude: [], elevation: [], variance: [] },
+    )
+    return heuristics
+  }
+
+  /** @description Given a set of locations, get the expected elevations (witness if needed), and return score/variance */
+  public async divine(payloads?: XyoPayloads): Promise<XyoPayloads> {
+    const locations = payloads?.filter<LocationPayload>((payload): payload is LocationPayload => payload?.schema === LocationSchema)
+    // If this is a query we support
+    if (locations && locations?.length > 0) {
+      const elevationWitness = await ElevationWitness.create({
+        config: {
+          locations,
+          schema: ElevationWitnessConfigSchema,
+        },
+      })
+      const elevations = (await elevationWitness.observe()) as ElevationPayload[]
+
+      const heuristics = LocationCertaintyDiviner.locationsToHeuristics(elevations, locations)
+
+      const result = new XyoPayloadBuilder<LocationCertaintyPayload>({ schema: LocationCertaintySchema })
+        .fields({
+          altitude: LocationCertaintyDiviner.calcHeuristic(heuristics.altitude),
+          elevation: LocationCertaintyDiviner.calcHeuristic(heuristics.elevation),
+          variance: LocationCertaintyDiviner.calcHeuristic(heuristics.variance),
+        })
+        .build()
+
+      this.logger?.log('LocationCertaintyDiviner.Divine: Processed query')
+      return [result]
+    }
+    return []
+  }
+
+  /** @description Is the goal here to prime/index the diviner? */
+  private divineElevationBatch = async () => {
+    this.logger?.log('LocationCertaintyDiviner.DivineElevationBatch: Divining elevations for batch')
+    // TODO: Any background/batch processing here
+    await Promise.resolve()
+    this.logger?.log('LocationCertaintyDiviner.DivineElevationBatch: Divined elevations for batch')
+  }
+}

package/src/Diviner/index.ts

@@ -0,0 +1,2 @@
+export * from './Config'
+export * from './Diviner'

package/src/Plugin.spec.ts

@@ -0,0 +1,20 @@
+/**
+ * @jest-environment jsdom
+ */
+
+import { LocationCertaintySchema } from '@xyo-network/location-certainty-payload-plugin'
+import { PayloadSetPluginResolver } from '@xyo-network/payloadset-plugin'
+
+import { LocationCertaintyDivinerConfigSchema } from './Diviner'
+import { LocationCertaintyPlugin } from './Plugin'
+
+describe('LocationCertaintyPlugin', () => {
+  test('Add to Resolver', () => {
+    const plugin = LocationCertaintyPlugin()
+    const resolver = new PayloadSetPluginResolver().register(plugin, {
+      diviner: { config: { schema: LocationCertaintyDivinerConfigSchema, targetSchema: LocationCertaintySchema } },
+    })
+    expect(resolver.resolve(plugin.set)).toBeObject()
+    expect(resolver.diviner(LocationCertaintySchema)).toBeObject()
+  })
+})

package/src/Plugin.ts

@@ -0,0 +1,16 @@
+import { LocationCertaintySchema } from '@xyo-network/location-certainty-payload-plugin'
+import { XyoModuleParams } from '@xyo-network/module'
+import { PayloadSetSchema } from '@xyo-network/payload'
+import { createPayloadSetPlugin, PayloadSetDivinerPlugin } from '@xyo-network/payloadset-plugin'
+
+import { LocationCertaintyDiviner, LocationCertaintyDivinerConfig } from './Diviner'
+
+export const LocationCertaintyPlugin = () =>
+  createPayloadSetPlugin<PayloadSetDivinerPlugin<XyoModuleParams<LocationCertaintyDivinerConfig>>>(
+    { required: { [LocationCertaintySchema]: 1 }, schema: PayloadSetSchema },
+    {
+      diviner: async (params) => {
+        return await LocationCertaintyDiviner.create(params)
+      },
+    },
+  )

package/src/index.ts

@@ -0,0 +1,8 @@
+import { LocationCertaintyPlugin } from './Plugin'
+
+export * from './Diviner'
+
+export { LocationCertaintyPlugin }
+
+// eslint-disable-next-line import/no-default-export
+export default LocationCertaintyPlugin