chainflow 0.1.0

package/dist/core/inputNode.js

@@ -0,0 +1,228 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _InputNode_instances, _InputNode_isKvObject, _InputNode_default, _InputNode_required, _InputNode_sources, _InputNode_valuePool, _InputNode_valuePoolSelect, _InputNode_generator, _InputNode_matchSourceHash, _InputNode_accessSource, _InputNode_getSingleSourceNodeValue, _InputNode_getMultiSourceNodeValues, _InputNode_selectValue;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InputNode = exports.NodeValue = exports.VALUE_POOL_SELECT = void 0;
+const symbols_1 = require("./utils/symbols");
+/** @experimental How a value pool should choose its values. */
+var VALUE_POOL_SELECT;
+(function (VALUE_POOL_SELECT) {
+    VALUE_POOL_SELECT[VALUE_POOL_SELECT["UNIFORM"] = 0] = "UNIFORM";
+})(VALUE_POOL_SELECT || (exports.VALUE_POOL_SELECT = VALUE_POOL_SELECT = {}));
+var NodeValue;
+(function (NodeValue) {
+    NodeValue[NodeValue["ValuePool"] = 0] = "ValuePool";
+    NodeValue[NodeValue["Generator"] = 1] = "Generator";
+    NodeValue[NodeValue["Required"] = 2] = "Required";
+    NodeValue[NodeValue["Source"] = 3] = "Source";
+    NodeValue[NodeValue["SourceWithCallback"] = 4] = "SourceWithCallback";
+    NodeValue[NodeValue["Sources"] = 5] = "Sources";
+})(NodeValue || (exports.NodeValue = NodeValue = {}));
+/** A data node for constructing an input object. */
+class InputNode {
+    constructor(val) {
+        _InputNode_instances.add(this);
+        /** Determines if this is a key-value object that needs to be built further. */
+        _InputNode_isKvObject.set(this, false);
+        /** Default value of this node */
+        _InputNode_default.set(this, void 0);
+        /** Whether this node requires a value from a source object. */
+        _InputNode_required.set(this, false);
+        /** Stores what source node values can be passed into this node. */
+        _InputNode_sources.set(this, {});
+        /** @experimental Stores possible values this node can take. */
+        _InputNode_valuePool.set(this, []);
+        /** @experimental Determines what strategy to select from pool of values */
+        _InputNode_valuePoolSelect.set(this, VALUE_POOL_SELECT.UNIFORM);
+        /** Generator function to generate values on demand for this node. */
+        _InputNode_generator.set(this, void 0);
+        if (val == null) {
+            __classPrivateFieldSet(this, _InputNode_default, val, "f");
+            return;
+        }
+        switch (val[symbols_1.nodeValueIdentifier]) {
+            case NodeValue.ValuePool:
+                __classPrivateFieldSet(this, _InputNode_valuePool, val.valuePool, "f");
+                return;
+            case NodeValue.Generator:
+                __classPrivateFieldSet(this, _InputNode_generator, val.generator, "f");
+                return;
+            case NodeValue.Required:
+                __classPrivateFieldSet(this, _InputNode_required, true, "f");
+                return;
+            case NodeValue.Source:
+                this[symbols_1.setSource](val);
+                return;
+            case NodeValue.SourceWithCallback: // TODO: explore refactoring here
+                this[symbols_1.setSource](val.source, val.callback);
+                return;
+            case NodeValue.Sources:
+                // TODO: validation here
+                val.sources.forEach((source) => {
+                    this[symbols_1.setSource](source, val.callback);
+                });
+                return;
+        }
+        switch (typeof val) {
+            case 'object':
+                if (Array.isArray(val)) {
+                    // this means you can't put a source node into an array
+                    __classPrivateFieldSet(this, _InputNode_default, val, "f");
+                    break;
+                }
+                __classPrivateFieldSet(this, _InputNode_isKvObject, true, "f");
+                Object.entries(val).forEach(([key, val]) => {
+                    this[key] = new InputNode(val);
+                });
+                break;
+            default:
+                __classPrivateFieldSet(this, _InputNode_default, val, "f");
+                break;
+        }
+    }
+    /** Sets a source node for this input node. */
+    [(_InputNode_isKvObject = new WeakMap(), _InputNode_default = new WeakMap(), _InputNode_required = new WeakMap(), _InputNode_sources = new WeakMap(), _InputNode_valuePool = new WeakMap(), _InputNode_valuePoolSelect = new WeakMap(), _InputNode_generator = new WeakMap(), _InputNode_instances = new WeakSet(), symbols_1.setSource)](source, callback) {
+        __classPrivateFieldGet(this, _InputNode_sources, "f")[source[symbols_1.nodeHash]] = {
+            path: source[symbols_1.nodePath],
+            undefinedAllowed: source[symbols_1.undefinedAllowed],
+            callback,
+        };
+    }
+    /** Sets multiple source nodes to be combined into a single value for this input node */
+    [symbols_1.setSources](sources, callback) {
+        const hashes = new Set();
+        const accessInfo = Object.entries(sources).map(([key, source]) => {
+            const hash = source[symbols_1.nodeHash];
+            hashes.add(hash);
+            return {
+                path: source[symbols_1.nodePath],
+                undefinedAllowed: source[symbols_1.undefinedAllowed],
+                hash,
+                key,
+            };
+        });
+        __classPrivateFieldGet(this, _InputNode_sources, "f")[new Array(...hashes).sort().join('|')] = {
+            accessInfo,
+            callback,
+        };
+    }
+    /** Sets the pool of values for this input node. */
+    [symbols_1.setValuePool](valuePool) {
+        __classPrivateFieldSet(this, _InputNode_valuePool, valuePool, "f");
+    }
+    /** Retrieve value of a node. */
+    [symbols_1.getNodeValue](sourceValues, missingValues, currentPath) {
+        const usedSources = []; // stores sourceValues that are already tried
+        // attempt to get value from any source nodes available
+        let sourceHash = __classPrivateFieldGet(this, _InputNode_instances, "m", _InputNode_matchSourceHash).call(this, sourceValues, usedSources);
+        while (sourceHash) {
+            const source = __classPrivateFieldGet(this, _InputNode_sources, "f")[sourceHash];
+            let sourceVal;
+            if ('accessInfo' in source) {
+                sourceVal = __classPrivateFieldGet(this, _InputNode_instances, "m", _InputNode_getMultiSourceNodeValues).call(this, source, sourceValues);
+            }
+            else {
+                sourceVal = __classPrivateFieldGet(this, _InputNode_instances, "m", _InputNode_getSingleSourceNodeValue).call(this, sourceHash, source.path, sourceValues, source.undefinedAllowed);
+            }
+            if (sourceVal !== undefined || ('undefinedAllowed' in source && source.undefinedAllowed)) {
+                return source.callback ? source.callback(sourceVal) : sourceVal;
+            }
+            usedSources.push(...sourceHash.split('|'));
+            sourceHash = __classPrivateFieldGet(this, _InputNode_instances, "m", _InputNode_matchSourceHash).call(this, sourceValues, usedSources);
+        }
+        // attempt to get value from generator function
+        if (__classPrivateFieldGet(this, _InputNode_generator, "f")) {
+            return __classPrivateFieldGet(this, _InputNode_generator, "f").call(this);
+        }
+        // attempt to get value from value pool
+        if (__classPrivateFieldGet(this, _InputNode_valuePool, "f").length > 0) {
+            return __classPrivateFieldGet(this, _InputNode_instances, "m", _InputNode_selectValue).call(this);
+        }
+        if (__classPrivateFieldGet(this, _InputNode_isKvObject, "f")) {
+            return this.buildKvObject(currentPath, missingValues, sourceValues);
+        }
+        // default will only be undefined for objects that need to be built further
+        if (__classPrivateFieldGet(this, _InputNode_default, "f") === undefined && __classPrivateFieldGet(this, _InputNode_required, "f")) {
+            missingValues.push(currentPath);
+            return;
+        }
+        // if other options are exhausted, revert to default
+        return __classPrivateFieldGet(this, _InputNode_default, "f");
+    }
+    /**
+     * Builds a key-value object from input node values and
+     * any available linked sources.
+     */
+    buildKvObject(currentPath, missingValues, sourceValues) {
+        return Object.entries(this).reduce((acc, [key, val]) => {
+            const nextPath = [...currentPath, key];
+            acc[key] = val[symbols_1.getNodeValue](sourceValues, missingValues, nextPath);
+            return acc;
+        }, {});
+    }
+}
+exports.InputNode = InputNode;
+_InputNode_matchSourceHash = function _InputNode_matchSourceHash(sourceValues, usedSources) {
+    const sourceHashes = Object.keys(__classPrivateFieldGet(this, _InputNode_sources, "f"));
+    const availSourceHashes = Object.keys(sourceValues);
+    return sourceHashes.find((hash) => {
+        if (hash.includes('|')) {
+            // handle combined hash for multi-node source
+            const hashes = hash.split('|');
+            if (
+            // if every source is available
+            hashes.every((hash) => availSourceHashes.includes(hash) && !usedSources.includes(hash))) {
+                return hash;
+            }
+        }
+        return availSourceHashes.includes(hash) && !usedSources.includes(hash);
+    });
+}, _InputNode_accessSource = function _InputNode_accessSource(payload, path, undefinedAllowed) {
+    let sourceVal = payload;
+    let i = 0;
+    while (i < path.length) {
+        // recall that `typeof null` returns 'object'
+        if (sourceVal == null || typeof sourceVal !== 'object') {
+            if (undefinedAllowed)
+                return undefined;
+            return;
+        }
+        const accessor = path[i];
+        sourceVal = sourceVal[accessor];
+        i += 1;
+    }
+    return sourceVal;
+}, _InputNode_getSingleSourceNodeValue = function _InputNode_getSingleSourceNodeValue(hash, path, sourceValues, undefinedAllowed) {
+    const sourceObject = sourceValues[hash][0];
+    // get value from a linked source
+    return __classPrivateFieldGet(this, _InputNode_instances, "m", _InputNode_accessSource).call(this, sourceObject, path, undefinedAllowed);
+}, _InputNode_getMultiSourceNodeValues = function _InputNode_getMultiSourceNodeValues(sources, sourceValues) {
+    const sourceVals = {};
+    for (const info of sources.accessInfo) {
+        const sourceVal = __classPrivateFieldGet(this, _InputNode_instances, "m", _InputNode_getSingleSourceNodeValue).call(this, info.hash, info.path, sourceValues);
+        // if one value is unavailable, stop constructing multi-source value
+        if (sourceVal === undefined)
+            return undefined;
+        sourceVals[info.key] = sourceVal;
+    }
+    return sourceVals;
+}, _InputNode_selectValue = function _InputNode_selectValue() {
+    if (__classPrivateFieldGet(this, _InputNode_valuePool, "f").length === 0)
+        return;
+    switch (__classPrivateFieldGet(this, _InputNode_valuePoolSelect, "f")) {
+        case VALUE_POOL_SELECT.UNIFORM:
+        default:
+            return __classPrivateFieldGet(this, _InputNode_valuePool, "f")[Math.floor(Math.random() * __classPrivateFieldGet(this, _InputNode_valuePool, "f").length)];
+    }
+};
+//# sourceMappingURL=inputNode.js.map

package/dist/core/inputNode.js.map

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

package/dist/core/logger.d.ts

@@ -0,0 +1,3 @@
+import debug from 'debug';
+export declare const log: debug.Debugger;
+export declare const warn: debug.Debugger;

package/dist/core/logger.js

@@ -0,0 +1,15 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.warn = exports.log = void 0;
+/* istanbul ignore file */
+const debug_1 = __importDefault(require("debug"));
+exports.log = (0, debug_1.default)('chainflow:core');
+exports.warn = (0, debug_1.default)('chainflow:core:error');
+if (process.env.ENABLE_CHAINFLOW_LOGS === 'true') {
+    exports.log.enabled = true;
+    exports.warn.enabled = true;
+}
+//# sourceMappingURL=logger.js.map

package/dist/core/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/core/logger.ts"],"names":[],"mappings":";;;;;;AAAA,0BAA0B;AAC1B,kDAA0B;AAEb,QAAA,GAAG,GAAG,IAAA,eAAK,EAAC,gBAAgB,CAAC,CAAC;AAC9B,QAAA,IAAI,GAAG,IAAA,eAAK,EAAC,sBAAsB,CAAC,CAAC;AAElD,IAAI,OAAO,CAAC,GAAG,CAAC,qBAAqB,KAAK,MAAM,EAAE,CAAC;IACjD,WAAG,CAAC,OAAO,GAAG,IAAI,CAAC;IACnB,YAAI,CAAC,OAAO,GAAG,IAAI,CAAC;AACtB,CAAC"}

package/dist/core/sourceNode.d.ts

@@ -0,0 +1,24 @@
+import { NodeValue } from './inputNode';
+import { nodeHash, nodePath, nodeValueIdentifier, undefinedAllowed } from './utils/symbols';
+/** Creates a new Source Node with the given hash. */
+export declare const sourceNode: (hash: string) => SourceNode;
+/** Describes a value in a source node e.g. the output of an endpoint call. */
+export interface SourceNode {
+    [nodeHash]: string;
+    [nodePath]: string[];
+    [undefinedAllowed]?: boolean;
+    [nodeValueIdentifier]: NodeValue;
+    [key: string]: any;
+}
+/** An intermediate object used to contain information on the SourceNode being built. */
+interface RawSourceNode {
+    path: string[];
+    hash: string;
+    undefinedAllowed?: boolean;
+}
+/** Generates proxies recursively to handle nested property access of a source signature. */
+export declare const SourceNodeHandler: {
+    get(obj: RawSourceNode, prop: any): any;
+    set(obj: RawSourceNode, prop: any, val: any): any;
+};
+export {};

package/dist/core/sourceNode.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SourceNodeHandler = exports.sourceNode = void 0;
+const inputNode_1 = require("./inputNode");
+const symbols_1 = require("./utils/symbols");
+/** Creates a new Source Node with the given hash. */
+const sourceNode = (hash) => new Proxy({ path: [], hash }, exports.SourceNodeHandler);
+exports.sourceNode = sourceNode;
+/** Generates proxies recursively to handle nested property access of a source signature. */
+exports.SourceNodeHandler = {
+    get(obj, prop) {
+        switch (prop) {
+            case symbols_1.nodePath:
+                return obj.path;
+            case symbols_1.nodeHash:
+                return obj.hash;
+            case symbols_1.undefinedAllowed:
+                return obj.undefinedAllowed;
+            case symbols_1.nodeValueIdentifier:
+                return inputNode_1.NodeValue.Source;
+            default: {
+                const newPath = [...obj.path];
+                newPath.push(prop);
+                return new Proxy({
+                    path: newPath,
+                    hash: obj.hash,
+                    undefinedAllowed: obj.undefinedAllowed,
+                }, exports.SourceNodeHandler);
+            }
+        }
+    },
+    set(obj, prop, val) {
+        if (prop === symbols_1.undefinedAllowed)
+            return (obj.undefinedAllowed = val);
+    },
+};
+//# sourceMappingURL=sourceNode.js.map

package/dist/core/sourceNode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourceNode.js","sourceRoot":"","sources":["../../src/core/sourceNode.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AACxC,6CAA4F;AAE5F,qDAAqD;AAC9C,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,EAAE,CACzC,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,yBAAiB,CAA0B,CAAC;AAD/D,QAAA,UAAU,cACqD;AAkB5E,4FAA4F;AAC/E,QAAA,iBAAiB,GAAG;IAC/B,GAAG,CAAC,GAAkB,EAAE,IAAS;QAC/B,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,kBAAQ;gBACX,OAAO,GAAG,CAAC,IAAI,CAAC;YAClB,KAAK,kBAAQ;gBACX,OAAO,GAAG,CAAC,IAAI,CAAC;YAClB,KAAK,0BAAgB;gBACnB,OAAO,GAAG,CAAC,gBAAgB,CAAC;YAC9B,KAAK,6BAAmB;gBACtB,OAAO,qBAAS,CAAC,MAAM,CAAC;YAC1B,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,OAAO,GAAG,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;gBAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,OAAO,IAAI,KAAK,CACd;oBACE,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,GAAG,CAAC,IAAI;oBACd,gBAAgB,EAAE,GAAG,CAAC,gBAAgB;iBACvC,EACD,yBAAiB,CACO,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IACD,GAAG,CAAC,GAAkB,EAAE,IAAS,EAAE,GAAQ;QACzC,IAAI,IAAI,KAAK,0BAAgB;YAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB,GAAG,GAAG,CAAC,CAAC;IACrE,CAAC;CACF,CAAC"}

package/dist/core/store.d.ts

@@ -0,0 +1,14 @@
+import { CallResult } from './chainflow';
+import { SourceNode } from './sourceNode';
+export type StoreValue<T> = IStore<T> | T;
+export interface IStore<T> {
+    [key: string]: StoreValue<T>;
+}
+/** Manages the storing of values for an endpoint. */
+export declare class Store {
+    #private;
+    /** Definition of values to be stored from responses to this endpoint. */
+    def: IStore<SourceNode>;
+    /** Assigns values to be put in the chainflow's store. */
+    storeValues(resp: unknown): CallResult;
+}

package/dist/core/store.js

@@ -0,0 +1,91 @@
+"use strict";
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var _Store_instances, _Store_store, _Store_getStoreValue, _Store_accessRespValue, _Store_putInStore;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Store = void 0;
+const symbols_1 = require("./utils/symbols");
+/** Manages the storing of values for an endpoint. */
+class Store {
+    constructor() {
+        _Store_instances.add(this);
+        /** Definition of values to be stored from responses to this endpoint. */
+        this.def = {};
+        /** Actual store of values received */
+        _Store_store.set(this, {});
+    }
+    /** Assigns values to be put in the chainflow's store. */
+    storeValues(resp) {
+        Object.entries(this.def).map(([key, val]) => {
+            if (val[symbols_1.nodePath]) {
+                // SourceNode
+                const { found, value, storePath } = __classPrivateFieldGet(this, _Store_instances, "m", _Store_accessRespValue).call(this, resp, [key], val);
+                if (found && storePath)
+                    __classPrivateFieldGet(this, _Store_instances, "m", _Store_putInStore).call(this, storePath, value);
+            }
+            else {
+                // a nested store value
+                __classPrivateFieldGet(this, _Store_instances, "m", _Store_getStoreValue).call(this, resp, [key], val);
+            }
+        });
+        const store = __classPrivateFieldGet(this, _Store_store, "f");
+        __classPrivateFieldSet(this, _Store_store, {}, "f"); // resets the store
+        return { resp: resp, store };
+    }
+}
+exports.Store = Store;
+_Store_store = new WeakMap(), _Store_instances = new WeakSet(), _Store_getStoreValue = function _Store_getStoreValue(resp, currentPath, storeDef) {
+    Object.entries(storeDef).map(([key, val]) => {
+        if (val[symbols_1.nodePath]) {
+            // SourceNode
+            const { found, value, storePath } = __classPrivateFieldGet(this, _Store_instances, "m", _Store_accessRespValue).call(this, resp, [...currentPath, key], val);
+            if (found && storePath)
+                __classPrivateFieldGet(this, _Store_instances, "m", _Store_putInStore).call(this, storePath, value);
+        }
+        else {
+            // a nested store value
+            __classPrivateFieldGet(this, _Store_instances, "m", _Store_getStoreValue).call(this, resp, [...currentPath, key], val);
+        }
+    });
+}, _Store_accessRespValue = function _Store_accessRespValue(resp, storePath, source) {
+    const sourcePath = source[symbols_1.nodePath];
+    let sourceVal = resp;
+    let i = 0;
+    while (i < sourcePath.length) {
+        // recall that `typeof null` returns 'object'
+        if (sourceVal == null || typeof sourceVal !== 'object') {
+            if (source[symbols_1.undefinedAllowed])
+                return { found: true, value: sourceVal, storePath };
+            return { found: false };
+        }
+        const accessor = sourcePath[i];
+        sourceVal = sourceVal[accessor];
+        i += 1;
+    }
+    return { found: true, value: sourceVal, storePath };
+}, _Store_putInStore = function _Store_putInStore(storePath, value) {
+    let storeNode = __classPrivateFieldGet(this, _Store_store, "f");
+    let accessor;
+    for (let i = 0; i < storePath.length; i++) {
+        accessor = storePath[i];
+        if (i === storePath.length - 1) {
+            // reached final node
+            storeNode[accessor] = value;
+            break;
+        }
+        if (storeNode[accessor] === undefined) {
+            storeNode[accessor] = {};
+        }
+        storeNode = storeNode[accessor];
+    }
+};
+//# sourceMappingURL=store.js.map

package/dist/core/store.js.map

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

package/dist/core/utils/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const SEED_HASH = "seed";
+export declare const STORE_HASH = "store";

package/dist/core/utils/constants.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.STORE_HASH = exports.SEED_HASH = void 0;
+exports.SEED_HASH = 'seed';
+exports.STORE_HASH = 'store';
+//# sourceMappingURL=constants.js.map

package/dist/core/utils/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/core/utils/constants.ts"],"names":[],"mappings":";;;AAAa,QAAA,SAAS,GAAG,MAAM,CAAC;AACnB,QAAA,UAAU,GAAG,OAAO,CAAC"}

package/dist/core/utils/initializers.d.ts

@@ -0,0 +1,17 @@
+import { NodeValue } from '../inputNode';
+import { nodeValueIdentifier } from './symbols';
+/** Defines a set of values to choose from when constructing an input. */
+export declare const pool: (valuePool: any[]) => {
+    valuePool: any[];
+    [nodeValueIdentifier]: NodeValue;
+};
+/** Provides a generator function to produce a value for an input. */
+export declare const gen: (generator: () => any) => {
+    generator: () => any;
+    [nodeValueIdentifier]: NodeValue;
+};
+/** Used to mark a param without a default value
+ * as required to be taken from another source. */
+export declare const required: () => {
+    [nodeValueIdentifier]: NodeValue;
+};

package/dist/core/utils/initializers.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.required = exports.gen = exports.pool = void 0;
+const inputNode_1 = require("../inputNode");
+const symbols_1 = require("./symbols");
+/** Defines a set of values to choose from when constructing an input. */
+const pool = (valuePool) => ({
+    valuePool,
+    [symbols_1.nodeValueIdentifier]: inputNode_1.NodeValue.ValuePool,
+});
+exports.pool = pool;
+/** Provides a generator function to produce a value for an input. */
+const gen = (generator) => ({
+    generator,
+    [symbols_1.nodeValueIdentifier]: inputNode_1.NodeValue.Generator,
+});
+exports.gen = gen;
+/** Used to mark a param without a default value
+ * as required to be taken from another source. */
+const required = () => ({
+    [symbols_1.nodeValueIdentifier]: inputNode_1.NodeValue.Required,
+});
+exports.required = required;
+//# sourceMappingURL=initializers.js.map

package/dist/core/utils/initializers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"initializers.js","sourceRoot":"","sources":["../../../src/core/utils/initializers.ts"],"names":[],"mappings":";;;AAAA,4CAAyC;AACzC,uCAAgD;AAEhD,yEAAyE;AAClE,MAAM,IAAI,GAAG,CAAC,SAAgB,EAAE,EAAE,CAAC,CAAC;IACzC,SAAS;IACT,CAAC,6BAAmB,CAAC,EAAE,qBAAS,CAAC,SAAS;CAC3C,CAAC,CAAC;AAHU,QAAA,IAAI,QAGd;AAEH,qEAAqE;AAC9D,MAAM,GAAG,GAAG,CAAC,SAAoB,EAAE,EAAE,CAAC,CAAC;IAC5C,SAAS;IACT,CAAC,6BAAmB,CAAC,EAAE,qBAAS,CAAC,SAAS;CAC3C,CAAC,CAAC;AAHU,QAAA,GAAG,OAGb;AAEH;kDACkD;AAC3C,MAAM,QAAQ,GAAG,GAAG,EAAE,CAAC,CAAC;IAC7B,CAAC,6BAAmB,CAAC,EAAE,qBAAS,CAAC,QAAQ;CAC1C,CAAC,CAAC;AAFU,QAAA,QAAQ,YAElB"}

package/dist/core/utils/link.d.ts

@@ -0,0 +1,24 @@
+import { InputNode } from '../inputNode';
+import { SourceNode } from '../sourceNode';
+/**
+ * Link a Source node to a Input node.
+ * @param dest the input node that should take a value from a source.
+ * @param source the source node that will provide the value for a input.
+ * @param callback an optional function that is called on the source source value.
+ */
+export declare const link: (dest: InputNode, source: SourceNode, callback?: ((val: any) => any) | undefined) => void;
+/**
+ * Links multiple Source nodes to a Input node via a callback.
+ * @param dest the input node that should take a value from the callback.
+ * @param sources an array of source nodes that will be passed into the callback.
+ * @param callback a function to merge the sources into a single source for the dest.
+ */
+export declare const linkMany: (dest: InputNode, sources: {
+    [key: string]: SourceNode;
+}, callback: (val: any) => any) => void;
+/**
+ * Modifier function that allows a SourceNode to return `undefined` values to an input node.
+ * Note that doing so will make it such that this SourceNode will ALWAYS be used to retrieve
+ * a value for any linked input node, unless there is another SourceNode with higher priority.
+ */
+export declare const allowUndefined: (source: SourceNode) => SourceNode;

package/dist/core/utils/link.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.allowUndefined = exports.linkMany = exports.link = void 0;
+const symbols_1 = require("./symbols");
+/**
+ * Link a Source node to a Input node.
+ * @param dest the input node that should take a value from a source.
+ * @param source the source node that will provide the value for a input.
+ * @param callback an optional function that is called on the source source value.
+ */
+const link = (dest, source, callback) => {
+    dest[symbols_1.setSource](source, callback);
+};
+exports.link = link;
+/**
+ * Links multiple Source nodes to a Input node via a callback.
+ * @param dest the input node that should take a value from the callback.
+ * @param sources an array of source nodes that will be passed into the callback.
+ * @param callback a function to merge the sources into a single source for the dest.
+ */
+const linkMany = (dest, sources, callback) => {
+    dest[symbols_1.setSources](sources, callback);
+};
+exports.linkMany = linkMany;
+/**
+ * Modifier function that allows a SourceNode to return `undefined` values to an input node.
+ * Note that doing so will make it such that this SourceNode will ALWAYS be used to retrieve
+ * a value for any linked input node, unless there is another SourceNode with higher priority.
+ */
+const allowUndefined = (source) => {
+    source[symbols_1.undefinedAllowed] = true;
+    return source;
+};
+exports.allowUndefined = allowUndefined;
+//# sourceMappingURL=link.js.map

package/dist/core/utils/link.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link.js","sourceRoot":"","sources":["../../../src/core/utils/link.ts"],"names":[],"mappings":";;;AACA,uCAAoE;AAGpE;;;;;GAKG;AACI,MAAM,IAAI,GAAG,CAAC,IAAe,EAAE,MAAkB,EAAE,QAA4B,EAAE,EAAE;IACxF,IAAI,CAAC,mBAAS,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC,CAAC;AAFW,QAAA,IAAI,QAEf;AAEF;;;;;GAKG;AACI,MAAM,QAAQ,GAAG,CACtB,IAAe,EACf,OAAsC,EACtC,QAA2B,EAC3B,EAAE;IACF,IAAI,CAAC,oBAAU,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACtC,CAAC,CAAC;AANW,QAAA,QAAQ,YAMnB;AAEF;;;;GAIG;AACI,MAAM,cAAc,GAAG,CAAC,MAAkB,EAAE,EAAE;IACnD,MAAM,CAAC,0BAAgB,CAAC,GAAG,IAAI,CAAC;IAChC,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAHW,QAAA,cAAc,kBAGzB"}

package/dist/core/utils/source.d.ts

@@ -0,0 +1,13 @@
+import { NodeValue } from '../inputNode';
+import { SourceNode } from '../sourceNode';
+import { nodeValueIdentifier } from './symbols';
+export declare const source: (source: SourceNode, callback?: ((val: any) => any) | undefined) => {
+    [nodeValueIdentifier]: NodeValue;
+    source: SourceNode;
+    callback: ((val: any) => any) | undefined;
+};
+export declare const sources: (sources: SourceNode[], callback?: ((val: any) => any) | undefined) => {
+    [nodeValueIdentifier]: NodeValue;
+    sources: SourceNode[];
+    callback: ((val: any) => any) | undefined;
+};

package/dist/core/utils/source.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sources = exports.source = void 0;
+const inputNode_1 = require("../inputNode");
+const symbols_1 = require("./symbols");
+const source = (source, callback) => ({
+    [symbols_1.nodeValueIdentifier]: inputNode_1.NodeValue.SourceWithCallback,
+    source,
+    callback,
+});
+exports.source = source;
+const sources = (sources, callback) => ({
+    [symbols_1.nodeValueIdentifier]: inputNode_1.NodeValue.Sources,
+    sources,
+    callback,
+});
+exports.sources = sources;
+//# sourceMappingURL=source.js.map

package/dist/core/utils/source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.js","sourceRoot":"","sources":["../../../src/core/utils/source.ts"],"names":[],"mappings":";;;AAAA,4CAAyC;AAEzC,uCAAgD;AAEzC,MAAM,MAAM,GAAG,CAAC,MAAkB,EAAE,QAA4B,EAAE,EAAE,CAAC,CAAC;IAC3E,CAAC,6BAAmB,CAAC,EAAE,qBAAS,CAAC,kBAAkB;IACnD,MAAM;IACN,QAAQ;CACT,CAAC,CAAC;AAJU,QAAA,MAAM,UAIhB;AAEI,MAAM,OAAO,GAAG,CAAC,OAAqB,EAAE,QAA4B,EAAE,EAAE,CAAC,CAAC;IAC/E,CAAC,6BAAmB,CAAC,EAAE,qBAAS,CAAC,OAAO;IACxC,OAAO;IACP,QAAQ;CACT,CAAC,CAAC;AAJU,QAAA,OAAO,WAIjB"}

package/dist/core/utils/symbols.d.ts

@@ -0,0 +1,8 @@
+export declare const setSource: unique symbol;
+export declare const setSources: unique symbol;
+export declare const setValuePool: unique symbol;
+export declare const getNodeValue: unique symbol;
+export declare const nodeHash: unique symbol;
+export declare const nodePath: unique symbol;
+export declare const nodeValueIdentifier: unique symbol;
+export declare const undefinedAllowed: unique symbol;

package/dist/core/utils/symbols.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.undefinedAllowed = exports.nodeValueIdentifier = exports.nodePath = exports.nodeHash = exports.getNodeValue = exports.setValuePool = exports.setSources = exports.setSource = void 0;
+exports.setSource = Symbol('setSource');
+exports.setSources = Symbol('setSources');
+exports.setValuePool = Symbol('setValuePool');
+exports.getNodeValue = Symbol('getNodeValue');
+exports.nodeHash = Symbol('nodeHash');
+exports.nodePath = Symbol('nodePath');
+exports.nodeValueIdentifier = Symbol('nodeValueIdentifier');
+exports.undefinedAllowed = Symbol('undefinedAllowed');
+//# sourceMappingURL=symbols.js.map