@emuanalytics/flow-rdf-core 1.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,17 @@
+@emuanalytics/flow-rdf-core:build: cache hit, replaying output f26a819889be528a
+@emuanalytics/flow-rdf-core:build: 
+@emuanalytics/flow-rdf-core:build: > @emuanalytics/flow-rdf-core@1.1.0 build /Users/robin/Projects/flow-rdfv3/packages/flow-rdf-core
+@emuanalytics/flow-rdf-core:build: > pnpm run clean && pnpm run build.cjs && pnpm run build.esm
+@emuanalytics/flow-rdf-core:build: 
+@emuanalytics/flow-rdf-core:build: 
+@emuanalytics/flow-rdf-core:build: > @emuanalytics/flow-rdf-core@1.1.0 clean /Users/robin/Projects/flow-rdfv3/packages/flow-rdf-core
+@emuanalytics/flow-rdf-core:build: > rimraf dist
+@emuanalytics/flow-rdf-core:build: 
+@emuanalytics/flow-rdf-core:build: 
+@emuanalytics/flow-rdf-core:build: > @emuanalytics/flow-rdf-core@1.1.0 build.cjs /Users/robin/Projects/flow-rdfv3/packages/flow-rdf-core
+@emuanalytics/flow-rdf-core:build: > tsc -p tsconfig.build.json --module commonjs --outdir dist/cjs
+@emuanalytics/flow-rdf-core:build: 
+@emuanalytics/flow-rdf-core:build: 
+@emuanalytics/flow-rdf-core:build: > @emuanalytics/flow-rdf-core@1.1.0 build.esm /Users/robin/Projects/flow-rdfv3/packages/flow-rdf-core
+@emuanalytics/flow-rdf-core:build: > tsc -p tsconfig.build.json --module es2020 --outdir dist/esm
+@emuanalytics/flow-rdf-core:build: 

package/CHANGELOG.md

@@ -0,0 +1,13 @@
+# @emuanalytics/flow-rdf-core
+
+## 1.1.0
+
+### Minor Changes
+
+- 50193dbf: Update to flow-engine-client v1.3.35
+
+## 1.1.0-alpha.0
+
+### Minor Changes
+
+- 50193dbf: Update to flow-engine-client v1.3.35

package/dist/cjs/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./lib/flow-query"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AACA,mDAAiC"}

package/dist/cjs/lib/async-committer.js

@@ -0,0 +1,47 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AsyncCommitter = void 0;
+class AsyncCommitter {
+    constructor() {
+        Object.defineProperty(this, "requestId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "commitId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+    }
+    resolve(promise) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.requestId += 1;
+            const currentRequestId = this.requestId;
+            const value = yield promise;
+            if (currentRequestId <= this.commitId) {
+                return { succeeded: false };
+            }
+            this.commitId = currentRequestId;
+            return { succeeded: true, value };
+        });
+    }
+    run(asyncFunction) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.resolve(asyncFunction());
+        });
+    }
+}
+exports.AsyncCommitter = AsyncCommitter;
+//# sourceMappingURL=async-committer.js.map

package/dist/cjs/lib/async-committer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-committer.js","sourceRoot":"","sources":["../../../src/lib/async-committer.ts"],"names":[],"mappings":";;;;;;;;;;;;AAIA,MAAa,cAAc;IAA3B;QACE;;;;mBAAY,CAAC;WAAC;QACd;;;;mBAAW,CAAC;WAAC;IAgBf,CAAC;IAfO,OAAO,CACX,OAA+C;;YAE/C,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACpB,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC;YACxC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC;YAC5B,IAAI,gBAAgB,IAAI,IAAI,CAAC,QAAQ,EAAE;gBACrC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;aAC7B;YACD,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC;YACjC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC;KAAA;IACK,GAAG,CAAC,aAA+B;;YACvC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QACvC,CAAC;KAAA;CACF;AAlBD,wCAkBC"}

package/dist/cjs/lib/flow-query.js

@@ -0,0 +1,183 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flowQueryOne = exports.flowQueryMany = exports.flowQuery = exports.FlowQuery = void 0;
+const mobx_1 = require("mobx");
+const debug_1 = __importDefault(require("debug"));
+const async_committer_1 = require("./async-committer");
+const debug = (0, debug_1.default)('flow:flow-query');
+class FlowQuery {
+    constructor(queryFn, transformFn) {
+        Object.defineProperty(this, "queryFn", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: queryFn
+        });
+        Object.defineProperty(this, "committer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new async_committer_1.AsyncCommitter()
+        });
+        Object.defineProperty(this, "disposer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "store", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "transformFn", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (results) => results
+        });
+        Object.defineProperty(this, "flowClient", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "results", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "busy", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "error", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        (0, mobx_1.makeObservable)(this, {
+            results: mobx_1.observable.ref,
+            busy: mobx_1.observable,
+            error: mobx_1.observable.ref
+        }, {
+            name: 'flowQuery'
+        });
+        (0, mobx_1.onBecomeObserved)(this, 'results', this.wake.bind(this));
+        (0, mobx_1.onBecomeUnobserved)(this, 'results', this.sleep.bind(this));
+        if (transformFn) {
+            this.transformFn = transformFn;
+        }
+        this.flowClient = FlowQuery.defaultFlowClient;
+    }
+    static setFlowClient(flowClient) {
+        this.defaultFlowClient = flowClient;
+    }
+    bind(store) {
+        this.store = store;
+        return this;
+    }
+    runImmediately() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryDefinition = this.queryFn.call(this.store);
+            yield this.runQuery(queryDefinition);
+            if (this.error) {
+                throw this.error;
+            }
+            return this.results;
+        });
+    }
+    wake() {
+        debug('waking up');
+        this.sleep();
+        this.disposer = (0, mobx_1.reaction)(() => this.queryFn.call(this.store), (queryDefinition) => {
+            this.runQuery(queryDefinition);
+        }, { fireImmediately: true, delay: 500 });
+    }
+    sleep() {
+        if (this.disposer) {
+            const disposer = this.disposer;
+            this.disposer = null;
+            disposer();
+            debug('sleeping');
+        }
+    }
+    runQuery(queryDefinition) {
+        return __awaiter(this, void 0, void 0, function* () {
+            debug(`running query:`, queryDefinition);
+            try {
+                if (queryDefinition === null) {
+                    (0, mobx_1.runInAction)(() => {
+                        this.results = null;
+                        this.error = null;
+                        this.busy = false;
+                    });
+                }
+                else {
+                    (0, mobx_1.runInAction)(() => {
+                        this.busy = true;
+                        this.error = null;
+                    });
+                    if (!this.flowClient) {
+                        throw new Error('No Flo.w client to execute query');
+                    }
+                    const response = yield this.committer.run(() => this.flowClient.datasets.query(queryDefinition));
+                    if (response.succeeded) {
+                        (0, mobx_1.runInAction)(() => {
+                            this.results = this.transformFn(response.value);
+                            this.busy = false;
+                        });
+                    }
+                }
+            }
+            catch (e) {
+                (0, mobx_1.runInAction)(() => {
+                    this.results = null;
+                    this.error = e;
+                    this.busy = false;
+                });
+            }
+        });
+    }
+}
+exports.FlowQuery = FlowQuery;
+function flowQuery(queryFn, transformFn, flowClient) {
+    return new FlowQuery(queryFn, transformFn);
+}
+exports.flowQuery = flowQuery;
+function flowQueryMany(queryFn, transformFn, flowClient) {
+    return flowQuery(queryFn, transformFn, flowClient);
+}
+exports.flowQueryMany = flowQueryMany;
+function flowQueryOne(queryFn, transformFn, flowClient) {
+    const oneTransform = (results) => {
+        let oneResult = null;
+        if (results === null || results === void 0 ? void 0 : results.length) {
+            oneResult = results[0];
+        }
+        if (transformFn) {
+            oneResult = transformFn(oneResult);
+        }
+        return oneResult;
+    };
+    return flowQuery(queryFn, oneTransform, flowClient);
+}
+exports.flowQueryOne = flowQueryOne;
+//# sourceMappingURL=flow-query.js.map

package/dist/cjs/lib/flow-query.js.map

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

package/dist/esm/index.js

@@ -0,0 +1,2 @@
+export * from './lib/flow-query';
+//# 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":"AACA,cAAc,kBAAkB,CAAC"}

package/dist/esm/lib/async-committer.js

@@ -0,0 +1,43 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+export class AsyncCommitter {
+    constructor() {
+        Object.defineProperty(this, "requestId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+        Object.defineProperty(this, "commitId", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: 0
+        });
+    }
+    resolve(promise) {
+        return __awaiter(this, void 0, void 0, function* () {
+            this.requestId += 1;
+            const currentRequestId = this.requestId;
+            const value = yield promise;
+            if (currentRequestId <= this.commitId) {
+                return { succeeded: false };
+            }
+            this.commitId = currentRequestId;
+            return { succeeded: true, value };
+        });
+    }
+    run(asyncFunction) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.resolve(asyncFunction());
+        });
+    }
+}
+//# sourceMappingURL=async-committer.js.map

package/dist/esm/lib/async-committer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-committer.js","sourceRoot":"","sources":["../../../src/lib/async-committer.ts"],"names":[],"mappings":";;;;;;;;;AAIA,MAAM,OAAO,cAAc;IAA3B;QACE;;;;mBAAY,CAAC;WAAC;QACd;;;;mBAAW,CAAC;WAAC;IAgBf,CAAC;IAfO,OAAO,CACX,OAA+C;;YAE/C,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC;YACpB,MAAM,gBAAgB,GAAG,IAAI,CAAC,SAAS,CAAC;YACxC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC;YAC5B,IAAI,gBAAgB,IAAI,IAAI,CAAC,QAAQ,EAAE;gBACrC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;aAC7B;YACD,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC;YACjC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;QACpC,CAAC;KAAA;IACK,GAAG,CAAC,aAA+B;;YACvC,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,CAAC;QACvC,CAAC;KAAA;CACF"}

package/dist/esm/lib/flow-query.js

@@ -0,0 +1,173 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { makeObservable, observable, onBecomeObserved, onBecomeUnobserved, reaction, runInAction } from 'mobx';
+import Debug from 'debug';
+import { AsyncCommitter } from './async-committer';
+const debug = Debug('flow:flow-query');
+export class FlowQuery {
+    constructor(queryFn, transformFn) {
+        Object.defineProperty(this, "queryFn", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: queryFn
+        });
+        Object.defineProperty(this, "committer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: new AsyncCommitter()
+        });
+        Object.defineProperty(this, "disposer", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "store", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "transformFn", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: (results) => results
+        });
+        Object.defineProperty(this, "flowClient", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: void 0
+        });
+        Object.defineProperty(this, "results", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        Object.defineProperty(this, "busy", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: false
+        });
+        Object.defineProperty(this, "error", {
+            enumerable: true,
+            configurable: true,
+            writable: true,
+            value: null
+        });
+        makeObservable(this, {
+            results: observable.ref,
+            busy: observable,
+            error: observable.ref
+        }, {
+            name: 'flowQuery'
+        });
+        onBecomeObserved(this, 'results', this.wake.bind(this));
+        onBecomeUnobserved(this, 'results', this.sleep.bind(this));
+        if (transformFn) {
+            this.transformFn = transformFn;
+        }
+        this.flowClient = FlowQuery.defaultFlowClient;
+    }
+    static setFlowClient(flowClient) {
+        this.defaultFlowClient = flowClient;
+    }
+    bind(store) {
+        this.store = store;
+        return this;
+    }
+    runImmediately() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const queryDefinition = this.queryFn.call(this.store);
+            yield this.runQuery(queryDefinition);
+            if (this.error) {
+                throw this.error;
+            }
+            return this.results;
+        });
+    }
+    wake() {
+        debug('waking up');
+        this.sleep();
+        this.disposer = reaction(() => this.queryFn.call(this.store), (queryDefinition) => {
+            this.runQuery(queryDefinition);
+        }, { fireImmediately: true, delay: 500 });
+    }
+    sleep() {
+        if (this.disposer) {
+            const disposer = this.disposer;
+            this.disposer = null;
+            disposer();
+            debug('sleeping');
+        }
+    }
+    runQuery(queryDefinition) {
+        return __awaiter(this, void 0, void 0, function* () {
+            debug(`running query:`, queryDefinition);
+            try {
+                if (queryDefinition === null) {
+                    runInAction(() => {
+                        this.results = null;
+                        this.error = null;
+                        this.busy = false;
+                    });
+                }
+                else {
+                    runInAction(() => {
+                        this.busy = true;
+                        this.error = null;
+                    });
+                    if (!this.flowClient) {
+                        throw new Error('No Flo.w client to execute query');
+                    }
+                    const response = yield this.committer.run(() => this.flowClient.datasets.query(queryDefinition));
+                    if (response.succeeded) {
+                        runInAction(() => {
+                            this.results = this.transformFn(response.value);
+                            this.busy = false;
+                        });
+                    }
+                }
+            }
+            catch (e) {
+                runInAction(() => {
+                    this.results = null;
+                    this.error = e;
+                    this.busy = false;
+                });
+            }
+        });
+    }
+}
+export function flowQuery(queryFn, transformFn, flowClient) {
+    return new FlowQuery(queryFn, transformFn);
+}
+export function flowQueryMany(queryFn, transformFn, flowClient) {
+    return flowQuery(queryFn, transformFn, flowClient);
+}
+export function flowQueryOne(queryFn, transformFn, flowClient) {
+    const oneTransform = (results) => {
+        let oneResult = null;
+        if (results === null || results === void 0 ? void 0 : results.length) {
+            oneResult = results[0];
+        }
+        if (transformFn) {
+            oneResult = transformFn(oneResult);
+        }
+        return oneResult;
+    };
+    return flowQuery(queryFn, oneTransform, flowClient);
+}
+//# sourceMappingURL=flow-query.js.map

package/dist/esm/lib/flow-query.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export * from './lib/flow-query';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC"}

package/dist/types/lib/async-committer.d.ts

@@ -0,0 +1,15 @@
+declare type AsyncCommitterResult<T> = {
+    succeeded: false;
+    value?: undefined;
+} | {
+    succeeded: true;
+    value: T | undefined;
+};
+export declare class AsyncCommitter<T> {
+    requestId: number;
+    commitId: number;
+    resolve(promise: Promise<T | undefined> | T | undefined): Promise<AsyncCommitterResult<T>>;
+    run(asyncFunction: () => Promise<T>): Promise<AsyncCommitterResult<T>>;
+}
+export {};
+//# sourceMappingURL=async-committer.d.ts.map

package/dist/types/lib/async-committer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-committer.d.ts","sourceRoot":"","sources":["../../../src/lib/async-committer.ts"],"names":[],"mappings":"AAAA,aAAK,oBAAoB,CAAC,CAAC,IACvB;IAAE,SAAS,EAAE,KAAK,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAA;CAAE,GACvC;IAAE,SAAS,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,GAAG,SAAS,CAAA;CAAE,CAAC;AAE9C,qBAAa,cAAc,CAAC,CAAC;IAC3B,SAAS,SAAK;IACd,QAAQ,SAAK;IACP,OAAO,CACX,OAAO,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,GAC9C,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAU7B,GAAG,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;CAG7E"}

package/dist/types/lib/flow-query.d.ts

@@ -0,0 +1,89 @@
+import { StateStore } from '@emuanalytics/flow-state-store';
+import { Client as FlowClient } from '@emuanalytics/flow-engine-client';
+/** Result format of a [[FlowQuery]]. */
+export declare type FlowQueryResultFormat = 'json' | 'geojson' | 'csv';
+/** [[FlowQueryDefinition]] 'attributes' entry. */
+export declare type FlowQueryAttribute = string | [any, string];
+/**
+ * [[FlowQueryDefinition]] 'where' clauses.
+ */
+export interface FlowQueryWhereClauses {
+    [attribute: string]: any;
+}
+/**
+ * [[FlowQueryDefinition]] extra parameters.
+ */
+export interface FlowQueryExtraParams {
+    [key: string]: string | number;
+}
+/**
+ * [[FlowQueryDefinition]] 'order' clause.
+ *
+ * A field name or [field, asc/desc] tuple.
+ */
+export declare type FlowQueryOrderClause = string | number | [string | number, 'asc' | 'desc'];
+export interface FlowQuerySampleOptions {
+    percentage: number;
+    method?: 'system' | 'bernoulli';
+    seed?: number;
+}
+/**
+ * Definition of a Flo.w reactive dataset query.
+ */
+export interface FlowQueryDefinition {
+    /** ID of dataset to query. */
+    datasetId: string;
+    /** Attributes to return in results. */
+    attributes?: FlowQueryAttribute[];
+    /** DISTINCT ON attributes */
+    distinct?: string | string[];
+    /** Filter results using 'where' clauses. */
+    where?: FlowQueryWhereClauses;
+    /** Sort results by attributes. */
+    order?: FlowQueryOrderClause[];
+    /** Group results by attributes. */
+    group?: (string | number)[];
+    /** Limit number of returned results */
+    limit?: number;
+    /** Format of returned data. */
+    format?: FlowQueryResultFormat;
+    /** Additional query parameters. */
+    params?: FlowQueryExtraParams;
+    /** Sampling options. */
+    sample?: FlowQuerySampleOptions;
+}
+/**
+ * [[FlowQuery]] query definition function.
+ *
+ * @typeParam TState  Type of application state.
+ */
+export declare type FlowQueryDefinitionFn<TState> = (this: TState) => FlowQueryDefinition | Promise<FlowQueryDefinition> | null;
+/**
+ * [[FlowQuery]] result transform function.
+ *
+ * @typeParam T  Type of transformed query results.
+ */
+export declare type FlowQueryResultTransformFn<T = any> = (results: any) => T | null;
+export declare class FlowQuery<TResults, TState extends StateStore = any> {
+    private queryFn;
+    private static defaultFlowClient;
+    private committer;
+    private disposer;
+    private store;
+    private transformFn;
+    flowClient: FlowClient;
+    results: TResults | null;
+    busy: boolean;
+    error: Error | null;
+    static setFlowClient(flowClient: any): void;
+    constructor(queryFn: FlowQueryDefinitionFn<TState | null>, transformFn?: FlowQueryResultTransformFn<TResults>);
+    bind(store: TState): this;
+    runImmediately(): Promise<TResults | null>;
+    private wake;
+    private sleep;
+    private runQuery;
+}
+export declare function flowQuery<TResult = any, TState extends StateStore = any>(queryFn: FlowQueryDefinitionFn<TState>, transformFn?: FlowQueryResultTransformFn<TResult>, flowClient?: FlowClient): FlowQuery<TResult, TState>;
+export declare function flowQueryMany<TResult = any, TState extends StateStore = any>(queryFn: FlowQueryDefinitionFn<TState>, transformFn?: FlowQueryResultTransformFn<TResult[]>, flowClient?: FlowClient): FlowQuery<TResult[], TState>;
+export declare function flowQueryOne<TResult = any, TState extends StateStore = any>(queryFn: FlowQueryDefinitionFn<TState>, transformFn?: FlowQueryResultTransformFn<TResult>, flowClient?: FlowClient): FlowQuery<TResult, TState>;
+//# sourceMappingURL=flow-query.d.ts.map

package/dist/types/lib/flow-query.d.ts.map

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

package/jest.config.js

@@ -0,0 +1,3 @@
+module.exports = {
+  ...require("../../jest.config"),
+};

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@emuanalytics/flow-rdf-core",
+  "version": "1.1.0",
+  "description": "",
+  "main": "dist/cjs/index.js",
+  "module": "dist/esm/index.js",
+  "types": "dist/types/index.d.ts",
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@emuanalytics/flow-engine-client": "^1.3.35",
+    "@emuanalytics/flow-state-store": "^1.0.0",
+    "debug": "^4.3.4"
+  },
+  "devDependencies": {
+    "@types/debug": "^4.1.7",
+    "@types/jest": "^28.1.6",
+    "esbuild": "^0.14.54",
+    "esbuild-jest": "^0.5.0",
+    "jest": "^28.1.3",
+    "jest-cli": "^28.1.3",
+    "jest-mock": "^28.1.3",
+    "jest-module-name-mapper": "^0.1.5",
+    "mobx": "^6.6.1",
+    "mobx-utils": "^6.0.5",
+    "rimraf": "^3.0.2",
+    "typescript": "^4.7.4"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build.cjs": "tsc -p tsconfig.build.json --module commonjs --outdir dist/cjs",
+    "build.esm": "tsc -p tsconfig.build.json --module es2020 --outdir dist/esm",
+    "build": "pnpm run clean && pnpm run build.cjs && pnpm run build.esm",
+    "test": "jest  --silent"
+  }
+}

package/src/__tests__/test.spec.ts

@@ -0,0 +1,116 @@
+import { mocked } from 'jest-mock';
+import { when } from 'mobx';
+import * as flow from '@emuanalytics/flow-engine-client';
+import { flowQuery, FlowQuery } from '../index';
+
+jest.mock('@emuanalytics/flow-engine-client', () => {
+  return {
+    Client: jest.fn().mockImplementation(() => {
+      return {
+        baseUrl: 'baseUrl',
+        apiKey: 'apikey',
+        datasets: {
+          query: jest.fn()
+        }
+      };
+    })
+  };
+});
+
+describe('flow-rdf-core', () => {
+  const flowClient = new flow.Client('baseUrl', 'apiKey');
+  const MockedFlowClient = mocked(flow.Client, true);
+  const mockedDatasetQuery = jest.mocked(flowClient.datasets.query);
+
+  beforeAll(() => {
+    FlowQuery.setFlowClient(flowClient);
+  });
+
+  beforeEach(() => {
+    // Clears the record of calls to the mocks
+    MockedFlowClient.mockClear();
+    mockedDatasetQuery.mockReset();
+  });
+
+  it('should provide mocked flow client', async() => {
+    expect(flowClient.baseUrl).toBe('baseUrl');
+    expect(flowClient.apiKey).toBe('apikey');
+
+    mockedDatasetQuery.mockResolvedValue([1, 2, 3]);
+    const results = await flowClient.datasets.query({});
+    expect(results).toStrictEqual([1, 2, 3]);
+    expect(mockedDatasetQuery).toHaveBeenCalledTimes(1);
+  });
+
+  it('should exist', () => {
+    const query = flowQuery(function () {
+      return { datasetId: 'airquality' };
+    });
+    expect(query).toBeDefined();
+  });
+
+  it('should have initial values', () => {
+    const query = flowQuery(function () {
+      return { datasetId: 'airquality' };
+    });
+    expect(query.results).toBeNull();
+    expect(query.busy).toBe(false);
+    expect(query.error).toBeNull();
+  });
+
+  it('should error if no flowClient to run query', async () => {
+    const query = flowQuery(function () {
+      return { datasetId: 'airquality' };
+    });
+
+    (query.flowClient as any) = undefined;
+
+    await when(() => query.results || query.error);
+    expect(query.results).toBeNull();
+    expect(query.error).toBeInstanceOf(Error);
+    expect(query.error!.message).toMatch('No Flo.w client');
+  });
+
+  it('should run query immediately', async () => {
+    mockedDatasetQuery.mockResolvedValueOnce([1, 2, 3]);
+
+    const query = flowQuery(function () {
+      return { datasetId: 'airquality' };
+    });
+
+    const results = await query.runImmediately();
+    expect(results).toEqual([1, 2, 3]);
+    expect(query.busy).toBe(false);
+    expect(query.error).toBeNull();
+  });
+
+  it('should fail immediately', async () => {
+    const query = flowQuery(function () {
+      return { datasetId: 'airquality' };
+    });
+    (query.flowClient as any) = null;
+
+    expect.assertions(2);
+    try {
+      await query.runImmediately();
+    } catch (e: any) {
+      expect(e).toBeInstanceOf(Error);
+      expect(e.message).toMatch('No Flo.w client');
+    }
+  });
+
+  it('should run observable query', async () => {
+
+    const query = flowQuery<number[]>(function () {
+      return { datasetId: 'airquality' };
+    });
+
+    query.flowClient.datasets.query = jest.fn().mockResolvedValue([1,2]);
+    const m = jest.mocked(query.flowClient.datasets.query);
+
+    await when(() => !!query.results || !!query.error);
+    expect(m).toHaveBeenCalled();
+    expect(query.error).toBeNull();
+    expect(query.results).toEqual([1, 2]);
+  });
+});

package/src/index.ts

@@ -0,0 +1,2 @@
+
+export * from './lib/flow-query';

package/src/lib/async-committer.ts

@@ -0,0 +1,23 @@
+type AsyncCommitterResult<T> =
+  | { succeeded: false; value?: undefined }
+  | { succeeded: true; value: T | undefined };
+
+export class AsyncCommitter<T> {
+  requestId = 0;
+  commitId = 0;
+  async resolve(
+    promise: Promise<T | undefined> | T | undefined
+  ): Promise<AsyncCommitterResult<T>> {
+    this.requestId += 1;
+    const currentRequestId = this.requestId;
+    const value = await promise;
+    if (currentRequestId <= this.commitId) {
+      return { succeeded: false };
+    }
+    this.commitId = currentRequestId;
+    return { succeeded: true, value };
+  }
+  async run(asyncFunction: () => Promise<T>): Promise<AsyncCommitterResult<T>> {
+    return this.resolve(asyncFunction());
+  }
+}

package/src/lib/flow-query.ts

@@ -0,0 +1,244 @@
+import {
+  IReactionDisposer,
+  makeObservable,
+  observable,
+  onBecomeObserved,
+  onBecomeUnobserved,
+  reaction,
+  runInAction
+} from 'mobx';
+import Debug from 'debug';
+import { AsyncCommitter } from './async-committer';
+import { StateStore } from '@emuanalytics/flow-state-store';
+import { Client as FlowClient } from '@emuanalytics/flow-engine-client';
+import { DatasetQuery } from '@emuanalytics/flow-engine-client/dist/types/lib/dataset.endpoints';
+
+const debug = Debug('flow:flow-query');
+
+/** Result format of a [[FlowQuery]]. */
+export type FlowQueryResultFormat = 'json' | 'geojson' | 'csv';
+
+/** [[FlowQueryDefinition]] 'attributes' entry. */
+export type FlowQueryAttribute = string | [any, string];
+
+/**
+ * [[FlowQueryDefinition]] 'where' clauses.
+ */
+export interface FlowQueryWhereClauses {
+  [attribute: string]: any;
+}
+
+/**
+ * [[FlowQueryDefinition]] extra parameters.
+ */
+export interface FlowQueryExtraParams {
+  [key: string]: string | number;
+}
+
+/**
+ * [[FlowQueryDefinition]] 'order' clause.
+ *
+ * A field name or [field, asc/desc] tuple.
+ */
+export type FlowQueryOrderClause = string | number | [string | number, 'asc' | 'desc'];
+
+export interface FlowQuerySampleOptions {
+  percentage: number;
+  method?: 'system' | 'bernoulli';
+  seed?: number;
+}
+
+/**
+ * Definition of a Flo.w reactive dataset query.
+ */
+export interface FlowQueryDefinition {
+  /** ID of dataset to query. */
+  datasetId: string;
+  /** Attributes to return in results. */
+  attributes?: FlowQueryAttribute[];
+  /** DISTINCT ON attributes */
+  distinct?: string | string[];
+  /** Filter results using 'where' clauses. */
+  where?: FlowQueryWhereClauses;
+  /** Sort results by attributes. */
+  order?: FlowQueryOrderClause[];
+  /** Group results by attributes. */
+  group?: (string | number)[];
+  /** Limit number of returned results */
+  limit?: number;
+  /** Format of returned data. */
+  format?: FlowQueryResultFormat;
+  /** Additional query parameters. */
+  params?: FlowQueryExtraParams;
+  /** Sampling options. */
+  sample?: FlowQuerySampleOptions;
+}
+
+/**
+ * [[FlowQuery]] query definition function.
+ *
+ * @typeParam TState  Type of application state.
+ */
+export type FlowQueryDefinitionFn<TState> = (this: TState) => FlowQueryDefinition | Promise<FlowQueryDefinition> | null;
+
+/**
+ * [[FlowQuery]] result transform function.
+ *
+ * @typeParam T  Type of transformed query results.
+ */
+export type FlowQueryResultTransformFn<T = any> = (results: any) => T | null;
+
+export class FlowQuery<TResults, TState extends StateStore = any> {
+  private static defaultFlowClient: FlowClient;
+
+  private committer = new AsyncCommitter<any>();
+  private disposer: IReactionDisposer | null = null;
+  private store: TState | null = null;
+  private transformFn: FlowQueryResultTransformFn<TResults> = (results) => results;
+
+  flowClient: FlowClient;
+  results: TResults | null = null;
+  busy: boolean = false;
+  error: Error | null = null;
+
+  static setFlowClient(flowClient: any) {
+    this.defaultFlowClient = flowClient;
+  }
+
+  constructor(
+    private queryFn: FlowQueryDefinitionFn<TState | null>,
+    transformFn?: FlowQueryResultTransformFn<TResults>
+  ) {
+    makeObservable(
+      this,
+      {
+        results: observable.ref,
+        busy: observable,
+        error: observable.ref
+      },
+      {
+        name: 'flowQuery'
+      }
+    );
+
+    onBecomeObserved(this, 'results', this.wake.bind(this));
+    onBecomeUnobserved(this, 'results', this.sleep.bind(this));
+
+    if (transformFn) {
+      this.transformFn = transformFn;
+    }
+
+    this.flowClient = FlowQuery.defaultFlowClient;
+  }
+
+  bind(store: TState) {
+    this.store = store;
+    return this;
+  }
+
+  async runImmediately() {
+    const queryDefinition = this.queryFn.call(this.store);
+    await this.runQuery(queryDefinition);
+    if (this.error) {
+      throw this.error;
+    }
+
+    return this.results;
+  }
+
+  private wake() {
+    debug('waking up');
+    this.sleep();
+    this.disposer = reaction(
+      () => this.queryFn.call(this.store),
+      (queryDefinition: any) => {
+        this.runQuery(queryDefinition);
+      },
+      { fireImmediately: true, delay: 500 }
+    );
+  }
+
+  private sleep() {
+    if (this.disposer) {
+      const disposer = this.disposer;
+      this.disposer = null;
+      disposer();
+      debug('sleeping');
+    }
+  }
+
+  private async runQuery(queryDefinition: DatasetQuery | null) {
+    debug(`running query:`, queryDefinition);
+
+    try {
+      if (queryDefinition === null) {
+        runInAction(() => {
+          this.results = null;
+          this.error = null;
+          this.busy = false;
+        });
+      } else {
+        runInAction(() => {
+          this.busy = true;
+          this.error = null;
+        });
+
+        if (!this.flowClient) {
+          throw new Error('No Flo.w client to execute query');
+        }
+
+        const response = await this.committer.run(() => this.flowClient.datasets.query(queryDefinition));
+
+        if (response.succeeded) {
+          runInAction(() => {
+            this.results = this.transformFn(response.value);
+            this.busy = false;
+          });
+        }
+      }
+    } catch (e: any) {
+      runInAction(() => {
+        this.results = null;
+        this.error = e;
+        this.busy = false;
+      });
+    }
+  }
+}
+
+export function flowQuery<TResult = any, TState extends StateStore = any>(
+  queryFn: FlowQueryDefinitionFn<TState>,
+  transformFn?: FlowQueryResultTransformFn<TResult>,
+  flowClient?: FlowClient
+): FlowQuery<TResult, TState> {
+  return new FlowQuery<TResult>(queryFn, transformFn);
+}
+
+export function flowQueryMany<TResult = any, TState extends StateStore = any>(
+  queryFn: FlowQueryDefinitionFn<TState>,
+  transformFn?: FlowQueryResultTransformFn<TResult[]>,
+  flowClient?: FlowClient
+): FlowQuery<TResult[], TState> {
+  return flowQuery<TResult[]>(queryFn, transformFn, flowClient);
+}
+
+export function flowQueryOne<TResult = any, TState extends StateStore = any>(
+  queryFn: FlowQueryDefinitionFn<TState>,
+  transformFn?: FlowQueryResultTransformFn<TResult>,
+  flowClient?: FlowClient
+): FlowQuery<TResult, TState> {
+  const oneTransform = (results: any[]): TResult | null => {
+    let oneResult: TResult | null = null;
+    if (results?.length) {
+      oneResult = results[0];
+    }
+
+    if (transformFn) {
+      oneResult = transformFn(oneResult);
+    }
+
+    return oneResult;
+  };
+
+  return flowQuery<TResult>(queryFn, oneTransform, flowClient);
+}

package/tsconfig.build.json

@@ -0,0 +1,12 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "declarationDir": "./dist/types",
+    "types": []
+  },
+  "exclude": [
+    "src/**/*.spec.ts",
+    "**/__tests__/**/*"
+  ]
+}

package/tsconfig.json

@@ -0,0 +1,103 @@
+{
+  "compilerOptions": {
+    /* Visit https://aka.ms/tsconfig to read more about this file */
+
+    /* Projects */
+    // "incremental": true,                              /* Save .tsbuildinfo files to allow for incremental compilation of projects. */
+    // "composite": true,                                /* Enable constraints that allow a TypeScript project to be used with project references. */
+    // "tsBuildInfoFile": "./.tsbuildinfo",              /* Specify the path to .tsbuildinfo incremental compilation file. */
+    // "disableSourceOfProjectReferenceRedirect": true,  /* Disable preferring source files instead of declaration files when referencing composite projects. */
+    // "disableSolutionSearching": true,                 /* Opt a project out of multi-project reference checking when editing. */
+    // "disableReferencedProjectLoad": true,             /* Reduce the number of projects loaded automatically by TypeScript. */
+
+    /* Language and Environment */
+    "target": "es2016",                                  /* Set the JavaScript language version for emitted JavaScript and include compatible library declarations. */
+    "experimentalDecorators": true,                   /* Enable experimental support for TC39 stage 2 draft decorators. */
+    // "emitDecoratorMetadata": true,                    /* Emit design-type metadata for decorated declarations in source files. */
+    // "jsxFactory": "",                                 /* Specify the JSX factory function used when targeting React JSX emit, e.g. 'React.createElement' or 'h'. */
+    // "jsxFragmentFactory": "",                         /* Specify the JSX Fragment reference used for fragments when targeting React JSX emit e.g. 'React.Fragment' or 'Fragment'. */
+    // "jsxImportSource": "",                            /* Specify module specifier used to import the JSX factory functions when using 'jsx: react-jsx*'. */
+    // "reactNamespace": "",                             /* Specify the object invoked for 'createElement'. This only applies when targeting 'react' JSX emit. */
+    // "noLib": true,                                    /* Disable including any library files, including the default lib.d.ts. */
+    "useDefineForClassFields": true,                  /* Emit ECMAScript-standard-compliant class fields. */
+    // "moduleDetection": "auto",                        /* Control what method is used to detect module-format JS files. */
+
+    /* Modules */
+    "module": "ES2020",                                /* Specify what module code is generated. */
+    //"rootDir": "./src",                                  /* Specify the root folder within your source files. */
+    "moduleResolution": "node",                       /* Specify how TypeScript looks up a file from a given module specifier. */
+    "baseUrl": "./",                                  /* Specify the base directory to resolve non-relative module names. */
+    // "paths": {},                                      /* Specify a set of entries that re-map imports to additional lookup locations. */
+    // "rootDirs": [],                                   /* Allow multiple folders to be treated as one when resolving modules. */
+    // "typeRoots": [],                                  /* Specify multiple folders that act like './node_modules/@types'. */
+    // "types": [],                                      /* Specify type package names to be included without being referenced in a source file. */
+    // "allowUmdGlobalAccess": true,                     /* Allow accessing UMD globals from modules. */
+    // "moduleSuffixes": [],                             /* List of file name suffixes to search when resolving a module. */
+    // "resolveJsonModule": true,                        /* Enable importing .json files. */
+    // "noResolve": true,                                /* Disallow 'import's, 'require's or '<reference>'s from expanding the number of files TypeScript should add to a project. */
+
+    /* JavaScript Support */
+    // "allowJs": true,                                  /* Allow JavaScript files to be a part of your program. Use the 'checkJS' option to get errors from these files. */
+    // "checkJs": true,                                  /* Enable error reporting in type-checked JavaScript files. */
+    // "maxNodeModuleJsDepth": 1,                        /* Specify the maximum folder depth used for checking JavaScript files from 'node_modules'. Only applicable with 'allowJs'. */
+
+    /* Emit */
+    "declaration": true,                              /* Generate .d.ts files from TypeScript and JavaScript files in your project. */
+    "declarationMap": true,                           /* Create sourcemaps for d.ts files. */
+    // "emitDeclarationOnly": true,                      /* Only output d.ts files and not JavaScript files. */
+    "sourceMap": true,                                /* Create source map files for emitted JavaScript files. */
+    // "outFile": "./",                                  /* Specify a file that bundles all outputs into one JavaScript file. If 'declaration' is true, also designates a file that bundles all .d.ts output. */
+    // "outDir": "./dist",                                   /* Specify an output folder for all emitted files. */
+    // "removeComments": true,                           /* Disable emitting comments. */
+    // "noEmit": true,                                   /* Disable emitting files from a compilation. */
+    // "importHelpers": true,                            /* Allow importing helper functions from tslib once per project, instead of including them per-file. */
+    // "importsNotUsedAsValues": "remove",               /* Specify emit/checking behavior for imports that are only used for types. */
+    // "downlevelIteration": true,                       /* Emit more compliant, but verbose and less performant JavaScript for iteration. */
+    // "sourceRoot": "",                                 /* Specify the root path for debuggers to find the reference source code. */
+    // "mapRoot": "",                                    /* Specify the location where debugger should locate map files instead of generated locations. */
+    // "inlineSourceMap": true,                          /* Include sourcemap files inside the emitted JavaScript. */
+    // "inlineSources": true,                            /* Include source code in the sourcemaps inside the emitted JavaScript. */
+    // "emitBOM": true,                                  /* Emit a UTF-8 Byte Order Mark (BOM) in the beginning of output files. */
+    // "newLine": "crlf",                                /* Set the newline character for emitting files. */
+    // "stripInternal": true,                            /* Disable emitting declarations that have '@internal' in their JSDoc comments. */
+    // "noEmitHelpers": true,                            /* Disable generating custom helper functions like '__extends' in compiled output. */
+    // "noEmitOnError": true,                            /* Disable emitting files if any type checking errors are reported. */
+    // "preserveConstEnums": true,                       /* Disable erasing 'const enum' declarations in generated code. */
+    // "declarationDir": "./",                           /* Specify the output directory for generated declaration files. */
+    // "preserveValueImports": true,                     /* Preserve unused imported values in the JavaScript output that would otherwise be removed. */
+
+    /* Interop Constraints */
+    // "isolatedModules": true,                          /* Ensure that each file can be safely transpiled without relying on other imports. */
+    // "allowSyntheticDefaultImports": true,             /* Allow 'import x from y' when a module doesn't have a default export. */
+    "esModuleInterop": true,                             /* Emit additional JavaScript to ease support for importing CommonJS modules. This enables 'allowSyntheticDefaultImports' for type compatibility. */
+    // "preserveSymlinks": true,                         /* Disable resolving symlinks to their realpath. This correlates to the same flag in node. */
+    "forceConsistentCasingInFileNames": true,            /* Ensure that casing is correct in imports. */
+
+    /* Type Checking */
+    "strict": true,                                      /* Enable all strict type-checking options. */
+    // "noImplicitAny": true,                            /* Enable error reporting for expressions and declarations with an implied 'any' type. */
+    "strictNullChecks": true,                            /* When type checking, take into account 'null' and 'undefined'. */
+    // "strictFunctionTypes": true,                      /* When assigning functions, check to ensure parameters and the return values are subtype-compatible. */
+    // "strictBindCallApply": true,                      /* Check that the arguments for 'bind', 'call', and 'apply' methods match the original function. */
+    // "strictPropertyInitialization": true,             /* Check for class properties that are declared but not set in the constructor. */
+    // "noImplicitThis": true,                           /* Enable error reporting when 'this' is given the type 'any'. */
+    // "useUnknownInCatchVariables": true,               /* Default catch clause variables as 'unknown' instead of 'any'. */
+    // "alwaysStrict": true,                             /* Ensure 'use strict' is always emitted. */
+    // "noUnusedLocals": true,                           /* Enable error reporting when local variables aren't read. */
+    // "noUnusedParameters": true,                       /* Raise an error when a function parameter isn't read. */
+    // "exactOptionalPropertyTypes": true,               /* Interpret optional property types as written, rather than adding 'undefined'. */
+    // "noImplicitReturns": true,                        /* Enable error reporting for codepaths that do not explicitly return in a function. */
+    // "noFallthroughCasesInSwitch": true,               /* Enable error reporting for fallthrough cases in switch statements. */
+    // "noUncheckedIndexedAccess": true,                 /* Add 'undefined' to a type when accessed using an index. */
+    // "noImplicitOverride": true,                       /* Ensure overriding members in derived classes are marked with an override modifier. */
+    // "noPropertyAccessFromIndexSignature": true,       /* Enforces using indexed accessors for keys declared using an indexed type. */
+    // "allowUnusedLabels": true,                        /* Disable error reporting for unused labels. */
+    // "allowUnreachableCode": true,                     /* Disable error reporting for unreachable code. */
+
+    /* Completeness */
+    // "skipDefaultLibCheck": true,                      /* Skip type checking .d.ts files that are included with TypeScript. */
+    "skipLibCheck": true                                 /* Skip type checking all .d.ts files. */
+  },
+  "include": ["./src/**/*.ts"],
+  "types": ["jest"]
+}