inferred-types 0.25.0 → 0.27.0

package/dist/index.js

@@ -23,12 +23,14 @@ __export(src_exports, {
   Configurator: () => Configurator,
   ExplicitFunction: () => ExplicitFunction,
   FluentConfigurator: () => FluentConfigurator,
+  MapDirection: () => MapDirection,
   Model: () => Model,
   MutationIdentity: () => MutationIdentity,
   and: () => and,
   api: () => api,
   arrayToKeyLookup: () => arrayToKeyLookup,
   arrayToObject: () => arrayToObject,
+  asArray: () => asArray,
   condition: () => condition,
   createFnWithProps: () => createFnWithProps,
   createMutationFunction: () => createMutationFunction,
@@ -38,10 +40,9 @@ __export(src_exports, {
   dictToKv: () => dictToKv,
   dictionaryTransform: () => dictionaryTransform,
   entries: () => entries,
-  equals: () => equals,
+  filter: () => filter,
   filterDictArray: () => filterDictArray,
   fnWithProps: () => fnWithProps,
-  greater: () => greater,
   groupBy: () => groupBy,
   idLiteral: () => idLiteral,
   idTypeGuard: () => idTypeGuard,
@@ -51,8 +52,10 @@ __export(src_exports, {
   isBoolean: () => isBoolean,
   isFalse: () => isFalse,
   isFunction: () => isFunction,
+  isNotFilter: () => isNotFilter,
   isNull: () => isNull,
   isNumber: () => isNumber,
+  isNumericFilter: () => isNumericFilter,
   isObject: () => isObject,
   isString: () => isString,
   isSymbol: () => isSymbol,
@@ -63,11 +66,13 @@ __export(src_exports, {
   kindLiteral: () => kindLiteral,
   kv: () => kv,
   kvToDict: () => kvToDict,
-  less: () => less,
   literal: () => literal,
   mapTo: () => mapTo,
+  mapToDict: () => mapToDict,
+  mapToFn: () => mapToFn,
   mapValues: () => mapValues,
   nameLiteral: () => nameLiteral,
+  not: () => not,
   or: () => or,
   randomString: () => randomString,
   readonlyFnWithProps: () => readonlyFnWithProps,
@@ -124,6 +129,14 @@ var valueTypes = {
   literalArray: (arr) => [arr, true]
 };
 
+// src/types/dictionary/MapTo.ts
+var MapDirection = /* @__PURE__ */ ((MapDirection2) => {
+  MapDirection2["OneToMany"] = "I -> O[]";
+  MapDirection2["OneToOne"] = "I -> O";
+  MapDirection2["ManyToOne"] = "I[] -> O";
+  return MapDirection2;
+})(MapDirection || {});
+
 // src/utility/keys.ts
 function keys(obj, ...without) {
   const v = without.length > 0 ? Object.keys(obj).filter((k) => !without.includes(k)) : Object.keys(obj);
@@ -167,6 +180,333 @@ var api = (priv) => (pub) => {
   return surface;
 };
 
+// src/utility/boolean-logic/and.ts
+var and = (...ops) => {
+  const fn = (...args) => {
+    return [...ops].every((i) => i(...args));
+  };
+  return fn;
+};
+
+// src/utility/boolean-logic/or.ts
+var or = (...ops) => {
+  const fn = (...args) => {
+    return [...ops].some((i) => i(...args));
+  };
+  return fn;
+};
+
+// src/utility/boolean-logic/not.ts
+var not = (op) => {
+  const fn = (...args) => {
+    return !op(...args);
+  };
+  return fn;
+};
+
+// src/utility/runtime/condition.ts
+var condition = (c, input) => {
+  return c(input);
+};
+
+// src/utility/runtime/ifTypeOf.ts
+function runtimeExtendsCheck(val, base, narrow = false) {
+  if (typeof val !== typeof base) {
+    return false;
+  }
+  switch (typeof val) {
+    case "boolean":
+    case "string":
+    case "number":
+    case "symbol":
+    case "bigint":
+      return narrow ? val === base : true;
+    case "undefined":
+      return true;
+    case "function":
+      if (narrow) {
+        throw new Error(`Use of narrowlyExtends with a function is not possible!`);
+      }
+      return true;
+    case "object":
+      if (val === null && base === null) {
+        return true;
+      } else {
+        return keys(base).every(
+          (i) => runtimeExtendsCheck(val[i], base[i], narrow)
+        );
+      }
+  }
+}
+var ifTypeOf = (val) => ({
+  extends: (base) => {
+    const valid = runtimeExtendsCheck(val, base, false);
+    const trueFalse = valid ? true : false;
+    return {
+      then: (then) => ({
+        else: (elseVal) => {
+          return valid ? typeof then === "undefined" ? val : then : elseVal;
+        }
+      }),
+      else: (elseVal) => valid ? val : elseVal
+    } && trueFalse;
+  },
+  narrowlyExtends: (base) => {
+    const valid = runtimeExtendsCheck(val, base, true);
+    const trueFalse = valid ? true : false;
+    return {
+      then: (then) => ({
+        else: (elseVal) => {
+          return valid ? typeof then === "undefined" ? val : then : elseVal;
+        }
+      }),
+      else: (elseVal) => valid ? val : elseVal
+    } && trueFalse;
+  }
+});
+
+// src/utility/runtime/conditions/isArray.ts
+function isArray(i) {
+  return Array.isArray(i) === true;
+}
+
+// src/utility/runtime/conditions/isBoolean.ts
+function isBoolean(i) {
+  return typeof i === "boolean";
+}
+
+// src/utility/runtime/conditions/isFalse.ts
+function isFalse(i) {
+  return typeof i === "boolean" && !i;
+}
+
+// src/utility/runtime/conditions/isFunction.ts
+function isFunction(input) {
+  return typeof input === "function";
+}
+
+// src/utility/runtime/conditions/isNull.ts
+function isNull(i) {
+  return i === null;
+}
+
+// src/utility/runtime/conditions/isNumber.ts
+function isNumber(i) {
+  return typeof i === "number";
+}
+
+// src/utility/runtime/conditions/isObject.ts
+function isObject(i) {
+  return typeof i === "object" && i !== null && Array.isArray(i) === false;
+}
+
+// src/utility/runtime/conditions/isString.ts
+function isString(i) {
+  return typeof i === "string";
+}
+
+// src/utility/runtime/conditions/isSymbol.ts
+function isSymbol(i) {
+  return typeof i === "symbol";
+}
+
+// src/utility/runtime/conditions/isTrue.ts
+function isTrue(i) {
+  return typeof i === "boolean" && i;
+}
+
+// src/utility/runtime/conditions/isUndefined.ts
+function isUndefined(i) {
+  return typeof i === "undefined";
+}
+
+// src/utility/runtime/type.ts
+var typeApi = () => ({
+  string: {
+    name: "string",
+    type: "",
+    typeGuard: (v) => isString(v),
+    is: isString
+  },
+  boolean: {
+    name: "boolean",
+    type: true,
+    typeGuard: (v) => isBoolean(v),
+    is: isBoolean
+  },
+  number: {
+    name: "number",
+    type: 1,
+    typeGuard: (v) => isNumber(v),
+    is: isNumber
+  },
+  function: {
+    name: "function",
+    type: Function,
+    typeGuard: (v) => isFunction(v),
+    is: isFunction
+  },
+  null: {
+    name: "null",
+    type: null,
+    typeGuard: (v) => isNull(v),
+    is: isNull
+  },
+  symbol: {
+    name: "symbol",
+    type: Symbol(),
+    typeGuard: (v) => isSymbol(v),
+    is: isSymbol
+  },
+  undefined: {
+    name: "undefined",
+    type: void 0,
+    typeGuard: (v) => isUndefined(v),
+    is: isUndefined
+  },
+  true: {
+    name: "true",
+    type: true,
+    typeGuard: (v) => isTrue(v),
+    is: isTrue
+  },
+  false: {
+    name: "false",
+    type: false,
+    typeGuard: (v) => isFalse(v),
+    is: isFalse
+  },
+  object: {
+    name: "object",
+    type: {},
+    typeGuard: (v) => isObject(v),
+    is: isObject
+  },
+  array: {
+    name: "array",
+    type: {},
+    typeGuard: (v) => isArray(v),
+    is: isObject
+  }
+});
+function isType(t) {
+  return typeof t === "object" && ["name", "type", "is"].every((i) => Object.keys(t).includes(i));
+}
+function type(fn) {
+  const result = fn(typeApi());
+  if (!isType(result)) {
+    throw new Error(
+      `When using type(), the callback passed in returned an invalid type! Value returned was: ${result}`
+    );
+  }
+  return result;
+}
+
+// src/utility/dictionary/entries.ts
+function entries(obj) {
+  const iterable = {
+    *[Symbol.iterator]() {
+      for (const k of keys(obj)) {
+        yield [k, obj[k]];
+      }
+    }
+  };
+  return iterable;
+}
+
+// src/utility/runtime/withValue.ts
+function withValue(td) {
+  return (obj) => {
+    const t = type(td);
+    return Object.fromEntries(
+      [...entries(obj)].filter(([_key, value]) => {
+        return t.typeGuard(value);
+      })
+    );
+  };
+}
+
+// src/utility/lists/asArray.ts
+var asArray = (thing, _widen) => {
+  return isArray(thing) ? thing : typeof thing === "undefined" ? [] : [thing];
+};
+
+// src/utility/boolean-logic/filter.ts
+function isNotFilter(f) {
+  return typeof f === "object" && "not" in f;
+}
+function isNumericFilter(filter2) {
+  return "equals" in filter2 || "notEqual" in filter2 || "greaterThan" in filter2 || "lessThan" in filter2 ? true : false;
+}
+var numericOps = (config, boolLogic) => {
+  const equals = (n) => {
+    const f = asArray(n);
+    return f.length === 0 ? [] : [(input) => f.some((i) => i === input)];
+  };
+  const notEqual = (n) => {
+    const f = asArray(n);
+    return f.length === 0 ? [] : [(input) => f.every((i) => i !== input)];
+  };
+  const greaterThan = (n) => {
+    const val = [(input) => input !== void 0 && input > n];
+    return val;
+  };
+  const lessThan = (n) => {
+    const val = [(input) => input !== void 0 && input < n];
+    return val;
+  };
+  const conditions = [
+    ..."equals" in config ? equals(config.equals) : [],
+    ..."notEqual" in config ? notEqual(config.notEqual) : [],
+    ..."greaterThan" in config ? greaterThan(config.greaterThan) : [],
+    ..."lessThan" in config ? lessThan(config.lessThan) : []
+  ];
+  const combined = boolLogic === "AND" ? (input) => conditions.every((c) => c(input)) : (input) => conditions.some((c) => c(input));
+  return combined;
+};
+var stringOps = (config, boolLogic) => {
+  const startsWith = (n) => {
+    const f = asArray(n);
+    return f.length === 0 ? [] : [(input) => f.some((i) => input == null ? void 0 : input.startsWith(i))];
+  };
+  const endsWith = (n) => {
+    const f = asArray(n);
+    return f.length === 0 ? [] : [(input) => f.some((i) => input == null ? void 0 : input.endsWith(i))];
+  };
+  const contains = (n) => {
+    const f = asArray(n);
+    return f.length === 0 ? [] : [(input) => f.some((i) => input == null ? void 0 : input.includes(i))];
+  };
+  const conditions = [
+    ..."startsWith" in config ? startsWith(config.startsWith) : [],
+    ..."endsWith" in config ? endsWith(config.endsWith) : [],
+    ..."contains" in config ? contains(config.contains) : []
+  ];
+  const combined = boolLogic === "AND" ? (input) => conditions.every((c) => c(input)) : (input) => conditions.some((c) => c(input));
+  return combined;
+};
+var filterFn = (defn, logicCombinator, ifUndefined = "no-impact") => {
+  const config = isNotFilter(defn) ? defn["not"] : defn;
+  const filter2 = (input) => {
+    const undefValue = ifUndefined === "no-impact" ? logicCombinator === "AND" ? true : false : ifUndefined;
+    let flag;
+    if (typeof input === "undefined") {
+      flag = undefValue;
+    } else if (isNumericFilter(config)) {
+      const fn = numericOps(config, logicCombinator);
+      flag = isNotFilter(defn) ? !fn(input) : fn(input);
+    } else {
+      const fn = stringOps(config, logicCombinator);
+      flag = isNotFilter(defn) ? !fn(input) : fn(input);
+    }
+    return flag;
+  };
+  return filter2;
+};
+var filter = (config, logicCombinator = "AND", ifUndefined = "no-impact") => {
+  return filterFn(config, logicCombinator, ifUndefined);
+};
+
 // src/utility/dictionary/arrayToKeyLookup.ts
 function arrayToKeyLookup(...keys2) {
   const obj = {};
@@ -242,18 +582,6 @@ var dictArr = (...dicts) => {
   return api2;
 };
 
-// src/utility/dictionary/entries.ts
-function entries(obj) {
-  const iterable = {
-    *[Symbol.iterator]() {
-      for (const k of keys(obj)) {
-        yield [k, obj[k]];
-      }
-    }
-  };
-  return iterable;
-}
-
 // src/utility/dictionary/mapValues.ts
 function mapValues(obj, valueMapper) {
   return Object.fromEntries(
@@ -262,14 +590,34 @@ function mapValues(obj, valueMapper) {
 }
 
 // src/utility/dictionary/mapTo.ts
-var mapTo = (cb) => (source) => {
-  if (Array.isArray(source)) {
-    return source.flatMap((i) => cb(i)).filter((i) => i !== null);
-  } else {
-    const result = cb(source);
-    return result ? result : [];
-  }
+var mapper = (config = {}) => (map) => {
+  config = {
+    input: "req",
+    output: "opt",
+    direction: "I -> O[]",
+    ...config
+  };
+  const fn = (source) => {
+    const isArray2 = config.direction === "I -> O[]" && Array.isArray(source) ? true : config.direction === "I[] -> O" && Array.isArray(source) && Array.isArray(source[0]) ? true : false;
+    if (isArray2) {
+      return source.flatMap(map);
+    } else {
+      return map(source);
+    }
+  };
+  return fn;
 };
+var mapToFn = (map) => {
+  return mapper()(map);
+};
+var mapToDict = {
+  config: (c = { input: "req", output: "opt", direction: "I -> O[]" }) => ({
+    map(map) {
+      return mapper(c)(map);
+    }
+  })
+};
+var mapTo = createFnWithProps(mapToFn, mapToDict);
 
 // src/utility/dictionary/strArrayToDict.ts
 function strArrayToDict(...strings) {
@@ -415,33 +763,6 @@ function literal(obj) {
   return obj;
 }
 
-// src/utility/map-reduce/filter.ts
-var equals = (field, val) => ({
-  kind: "Equals",
-  field,
-  val
-});
-var greater = (field, val) => ({
-  kind: "Greater",
-  field,
-  val
-});
-var less = (field, val) => ({
-  kind: "Less",
-  field,
-  val
-});
-var and = (a, b) => ({
-  kind: "And",
-  a,
-  b
-});
-var or = (a, b) => ({
-  kind: "Or",
-  a,
-  b
-});
-
 // src/utility/modelling/Model.ts
 function Model(name) {
   return {
@@ -459,227 +780,19 @@ function Model(name) {
     }
   };
 }
-
-// src/utility/runtime/condition.ts
-var condition = (c, input) => {
-  return c(input);
-};
-
-// src/utility/runtime/ifTypeOf.ts
-function runtimeExtendsCheck(val, base, narrow = false) {
-  if (typeof val !== typeof base) {
-    return false;
-  }
-  switch (typeof val) {
-    case "boolean":
-    case "string":
-    case "number":
-    case "symbol":
-    case "bigint":
-      return narrow ? val === base : true;
-    case "undefined":
-      return true;
-    case "function":
-      if (narrow) {
-        throw new Error(`Use of narrowlyExtends with a function is not possible!`);
-      }
-      return true;
-    case "object":
-      if (val === null && base === null) {
-        return true;
-      } else {
-        return keys(base).every(
-          (i) => runtimeExtendsCheck(val[i], base[i], narrow)
-        );
-      }
-  }
-}
-var ifTypeOf = (val) => ({
-  extends: (base) => {
-    const valid = runtimeExtendsCheck(val, base, false);
-    const trueFalse = valid ? true : false;
-    return {
-      then: (then) => ({
-        else: (elseVal) => {
-          return valid ? typeof then === "undefined" ? val : then : elseVal;
-        }
-      }),
-      else: (elseVal) => valid ? val : elseVal
-    } && trueFalse;
-  },
-  narrowlyExtends: (base) => {
-    const valid = runtimeExtendsCheck(val, base, true);
-    const trueFalse = valid ? true : false;
-    return {
-      then: (then) => ({
-        else: (elseVal) => {
-          return valid ? typeof then === "undefined" ? val : then : elseVal;
-        }
-      }),
-      else: (elseVal) => valid ? val : elseVal
-    } && trueFalse;
-  }
-});
-
-// src/utility/runtime/conditions/isArray.ts
-function isArray(i) {
-  return Array.isArray(i) === true;
-}
-
-// src/utility/runtime/conditions/isBoolean.ts
-function isBoolean(i) {
-  return typeof i === "boolean";
-}
-
-// src/utility/runtime/conditions/isFalse.ts
-function isFalse(i) {
-  return typeof i === "boolean" && !i;
-}
-
-// src/utility/runtime/conditions/isFunction.ts
-function isFunction(input) {
-  return typeof input === "function";
-}
-
-// src/utility/runtime/conditions/isNull.ts
-function isNull(i) {
-  return i === null;
-}
-
-// src/utility/runtime/conditions/isNumber.ts
-function isNumber(i) {
-  return typeof i === "number";
-}
-
-// src/utility/runtime/conditions/isObject.ts
-function isObject(i) {
-  return typeof i === "object" && i !== null && Array.isArray(i) === false;
-}
-
-// src/utility/runtime/conditions/isString.ts
-function isString(i) {
-  return typeof i === "string";
-}
-
-// src/utility/runtime/conditions/isSymbol.ts
-function isSymbol(i) {
-  return typeof i === "symbol";
-}
-
-// src/utility/runtime/conditions/isTrue.ts
-function isTrue(i) {
-  return typeof i === "boolean" && i;
-}
-
-// src/utility/runtime/conditions/isUndefined.ts
-function isUndefined(i) {
-  return typeof i === "undefined";
-}
-
-// src/utility/runtime/type.ts
-var typeApi = () => ({
-  string: {
-    name: "string",
-    type: "",
-    typeGuard: (v) => isString(v),
-    is: isString
-  },
-  boolean: {
-    name: "boolean",
-    type: true,
-    typeGuard: (v) => isBoolean(v),
-    is: isBoolean
-  },
-  number: {
-    name: "number",
-    type: 1,
-    typeGuard: (v) => isNumber(v),
-    is: isNumber
-  },
-  function: {
-    name: "function",
-    type: Function,
-    typeGuard: (v) => isFunction(v),
-    is: isFunction
-  },
-  null: {
-    name: "null",
-    type: null,
-    typeGuard: (v) => isNull(v),
-    is: isNull
-  },
-  symbol: {
-    name: "symbol",
-    type: Symbol(),
-    typeGuard: (v) => isSymbol(v),
-    is: isSymbol
-  },
-  undefined: {
-    name: "undefined",
-    type: void 0,
-    typeGuard: (v) => isUndefined(v),
-    is: isUndefined
-  },
-  true: {
-    name: "true",
-    type: true,
-    typeGuard: (v) => isTrue(v),
-    is: isTrue
-  },
-  false: {
-    name: "false",
-    type: false,
-    typeGuard: (v) => isFalse(v),
-    is: isFalse
-  },
-  object: {
-    name: "object",
-    type: {},
-    typeGuard: (v) => isObject(v),
-    is: isObject
-  },
-  array: {
-    name: "array",
-    type: {},
-    typeGuard: (v) => isArray(v),
-    is: isObject
-  }
-});
-function isType(t) {
-  return typeof t === "object" && ["name", "type", "is"].every((i) => Object.keys(t).includes(i));
-}
-function type(fn) {
-  const result = fn(typeApi());
-  if (!isType(result)) {
-    throw new Error(
-      `When using type(), the callback passed in returned an invalid type! Value returned was: ${result}`
-    );
-  }
-  return result;
-}
-
-// src/utility/runtime/withValue.ts
-function withValue(td) {
-  return (obj) => {
-    const t = type(td);
-    return Object.fromEntries(
-      [...entries(obj)].filter(([_key, value]) => {
-        return t.typeGuard(value);
-      })
-    );
-  };
-}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Configurator,
   ExplicitFunction,
   FluentConfigurator,
+  MapDirection,
   Model,
   MutationIdentity,
   and,
   api,
   arrayToKeyLookup,
   arrayToObject,
+  asArray,
   condition,
   createFnWithProps,
   createMutationFunction,
@@ -689,10 +802,9 @@ function withValue(td) {
   dictToKv,
   dictionaryTransform,
   entries,
-  equals,
+  filter,
   filterDictArray,
   fnWithProps,
-  greater,
   groupBy,
   idLiteral,
   idTypeGuard,
@@ -702,8 +814,10 @@ function withValue(td) {
   isBoolean,
   isFalse,
   isFunction,
+  isNotFilter,
   isNull,
   isNumber,
+  isNumericFilter,
   isObject,
   isString,
   isSymbol,
@@ -714,11 +828,13 @@ function withValue(td) {
   kindLiteral,
   kv,
   kvToDict,
-  less,
   literal,
   mapTo,
+  mapToDict,
+  mapToFn,
   mapValues,
   nameLiteral,
+  not,
   or,
   randomString,
   readonlyFnWithProps,