@terrygonguet/utils 0.0.12 → 0.0.13

package/dist/functional.js

@@ -1,13 +1,13 @@
-var d = Object.defineProperty;
-var S = (r, e, t) => e in r ? d(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
-var u = (r, e, t) => (S(r, typeof e != "symbol" ? e + "" : e, t), t);
-const a = "@terrygonguet/utils/functional/result", l = "@terrygonguet/utils/functional/result/Success", w = "@terrygonguet/utils/functional/result/Failure";
-class f {
+var S = Object.defineProperty;
+var v = (r, e, t) => e in r ? S(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
+var u = (r, e, t) => (v(r, typeof e != "symbol" ? e + "" : e, t), t);
+const a = "@terrygonguet/utils/functional/result", f = "@terrygonguet/utils/functional/result/Success", w = "@terrygonguet/utils/functional/result/Failure";
+class l {
   constructor(e) {
     u(this, "value");
     Object.defineProperties(this, {
       $_kind: { value: a, enumerable: !1, writable: !1 },
-      $_variant: { value: l, enumerable: !1, writable: !1 },
+      $_variant: { value: f, enumerable: !1, writable: !1 },
       value: { value: e, writable: !1 }
     });
   }
@@ -24,13 +24,13 @@ class f {
     return e(this.value);
   }
   map(e) {
-    return new f(e(this.value));
+    return new l(e(this.value));
   }
   flatMap(e) {
     return e(this.value);
   }
   toJSON() {
-    return { $_kind: a, $_variant: l, value: this.value };
+    return { $_kind: a, $_variant: f, value: this.value };
   }
 }
 class g {
@@ -38,7 +38,7 @@ class g {
     u(this, "reason");
     Object.defineProperties(this, {
       $_kind: { value: a, enumerable: !1, writable: !1 },
-      $_variant: { value: l, enumerable: !1, writable: !1 },
+      $_variant: { value: f, enumerable: !1, writable: !1 },
       reason: { value: e, writable: !1 }
     });
   }
@@ -64,18 +64,18 @@ class g {
     return { $_kind: a, $_variant: w, reason: this.reason };
   }
 }
-function v(r, e) {
+function y(r, e) {
   return e ? r.toResult(e) : r.toResult();
 }
 const c = {
   Success(r) {
-    return new f(r);
+    return new l(r);
   },
   Failure(r) {
     return new g(r);
   },
   try(r) {
-    return new y(r);
+    return new d(r);
   },
   fromPromise(r, e, t) {
     return r.then(
@@ -83,20 +83,20 @@ const c = {
       b(t, this.Failure)
     );
   },
-  fromMaybe: v,
+  fromMaybe: y,
   JSONReviver(r, e) {
     if ((e == null ? void 0 : e.$_kind) == a) {
       const t = e == null ? void 0 : e.$_variant;
-      return t == l ? new f(e == null ? void 0 : e.value) : t == w ? new g(e == null ? void 0 : e.reason) : e;
+      return t == f ? new l(e == null ? void 0 : e.value) : t == w ? new g(e == null ? void 0 : e.reason) : e;
     } else
       return e;
   }
 };
-class y {
+class d {
   constructor(e) {
     u(this, "tryFn");
     u(this, "catchFn");
-    this.tryFn = e, this.catchFn = p;
+    this.tryFn = e, this.catchFn = $;
   }
   catch(e) {
     return this.catchFn = e, this;
@@ -111,8 +111,8 @@ class y {
     }
   }
 }
-const h = "@terrygonguet/utils/functional/maybe", _ = "@terrygonguet/utils/functional/maybe/Some", $ = "@terrygonguet/utils/functional/maybe/None";
-class o {
+const h = "@terrygonguet/utils/functional/maybe", _ = "@terrygonguet/utils/functional/maybe/Some", p = "@terrygonguet/utils/functional/maybe/None";
+class i {
   constructor(e) {
     u(this, "value");
     Object.defineProperties(this, {
@@ -131,7 +131,7 @@ class o {
     return this.value;
   }
   map(e) {
-    return new o(e(this.value));
+    return new i(e(this.value));
   }
   flatMap(e) {
     return e(this.value);
@@ -165,12 +165,12 @@ class k {
     return e ? c.Failure(e == null ? void 0 : e()) : c.Failure(void 0);
   }
   toJSON() {
-    return { $_kind: h, $_variant: $ };
+    return { $_kind: h, $_variant: p };
   }
 }
 const N = new k(), s = {
   Some(r) {
-    return new o(r);
+    return new i(r);
   },
   None() {
     return N;
@@ -181,20 +181,20 @@ const N = new k(), s = {
       case void 0:
         return this.None();
       default:
-        return new o(r);
+        return new i(r);
     }
   },
   /**
    * CAUTION: this method swallows errors and simply returns None!
    * Use `Result.fromPromise()` if you need error details.
    */
-  fromPromise(r, e = p) {
+  fromPromise(r, e = $) {
     return r.then(b(e, s.from), M(this.None()));
   },
   JSONReviver(r, e) {
     if ((e == null ? void 0 : e.$_kind) == h) {
       const t = e == null ? void 0 : e.$_variant;
-      return t == _ ? new o(e == null ? void 0 : e.value) : t == $ ? s.None() : e;
+      return t == _ ? new i(e == null ? void 0 : e.value) : t == p ? s.None() : e;
     } else
       return e;
   }
@@ -207,7 +207,7 @@ function F(r, e) {
     );
   var t = arguments;
   return function() {
-    for (var n = t[0].apply(this, arguments), i = t.length, m = 1; m < i; m++)
+    for (var n = t[0].apply(this, arguments), o = t.length, m = 1; m < o; m++)
       n = t[m].call(this, n);
     return n;
   };
@@ -220,11 +220,11 @@ function x(r, ...e) {
     throw new Error(
       "expected at least one (and probably more) function arguments"
     );
-  for (var t = e[0](r), n = e.length, i = 1; i < n; i++)
-    t = e[i](t);
+  for (var t = e[0](r), n = e.length, o = 1; o < n; o++)
+    t = e[o](t);
   return t;
 }
-function p(r) {
+function $(r) {
   return r;
 }
 function M(r) {
@@ -247,6 +247,11 @@ function O(r, e) {
     return t == -1 ? s.None() : s.Some(t);
   }
 }
+function C(r, ...e) {
+  for (const t of e)
+    r = r == null ? void 0 : r[t];
+  return s.from(r);
+}
 export {
   s as Maybe,
   c as Result,
@@ -255,6 +260,7 @@ export {
   M as constant,
   E as find,
   O as findIndex,
-  p as identity,
-  J as pipe
+  $ as identity,
+  J as pipe,
+  C as prop
 };

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@terrygonguet/utils",
-	"version": "0.0.12",
+	"version": "0.0.13",
 	"type": "module",
 	"module": "./dist/index.js",
 	"author": {

package/src/functional/index.ts

@@ -43,3 +43,38 @@ export function findIndex<T>(dataOrPredicate: T[] | Predicate<T>, predicate?: Pr
 		return idx == -1 ? Maybe.None<number>() : Maybe.Some(idx)
 	}
 }
+
+export function prop<T extends {}, K1 extends keyof T = keyof T>(data: T, key1: K1): Maybe<T[K1]>
+export function prop<
+	T extends {},
+	K1 extends keyof T = keyof T,
+	K2 extends keyof T[K1] = keyof T[K1],
+>(data: T, key1: K1, key2: K2): Maybe<T[K1][K2]>
+export function prop<
+	T extends {},
+	K1 extends keyof T = keyof T,
+	K2 extends keyof T[K1] = keyof T[K1],
+	K3 extends keyof T[K1][K2] = keyof T[K1][K2],
+>(data: T, key1: K1, key2: K2, key: K3): Maybe<T[K1][K2][K3]>
+export function prop<
+	T extends {},
+	K1 extends keyof T = keyof T,
+	K2 extends keyof T[K1] = keyof T[K1],
+	K3 extends keyof T[K1][K2] = keyof T[K1][K2],
+	K4 extends keyof T[K1][K2][K3] = keyof T[K1][K2][K3],
+>(data: T, key1: K1, key2: K2, key: K3, key4: K4): Maybe<T[K1][K2][K3][K4]>
+export function prop<
+	T extends {},
+	K1 extends keyof T = keyof T,
+	K2 extends keyof T[K1] = keyof T[K1],
+	K3 extends keyof T[K1][K2] = keyof T[K1][K2],
+	K4 extends keyof T[K1][K2][K3] = keyof T[K1][K2][K3],
+	K5 extends keyof T[K1][K2][K3][K4] = keyof T[K1][K2][K3][K4],
+>(data: T, key1: K1, key2: K2, key: K3, key4: K4, key5: K5): Maybe<T[K1][K2][K3][K4][K5]>
+
+export function prop(data: any, ...path: string[]) {
+	for (const key of path) {
+		data = data?.[key]
+	}
+	return Maybe.from(data)
+}

package/types/functional/index.d.ts

@@ -12,3 +12,8 @@ export declare function find<T>(predicate: Predicate<T>): (data: T[]) => Maybe<T
 export declare function find<T>(data: T[], predicate: Predicate<T>): Maybe<T>;
 export declare function findIndex<T>(predicate: Predicate<T>): (data: T[]) => Maybe<number>;
 export declare function findIndex<T>(data: T[], predicate: Predicate<T>): Maybe<number>;
+export declare function prop<T extends {}, K1 extends keyof T = keyof T>(data: T, key1: K1): Maybe<T[K1]>;
+export declare function prop<T extends {}, K1 extends keyof T = keyof T, K2 extends keyof T[K1] = keyof T[K1]>(data: T, key1: K1, key2: K2): Maybe<T[K1][K2]>;
+export declare function prop<T extends {}, K1 extends keyof T = keyof T, K2 extends keyof T[K1] = keyof T[K1], K3 extends keyof T[K1][K2] = keyof T[K1][K2]>(data: T, key1: K1, key2: K2, key: K3): Maybe<T[K1][K2][K3]>;
+export declare function prop<T extends {}, K1 extends keyof T = keyof T, K2 extends keyof T[K1] = keyof T[K1], K3 extends keyof T[K1][K2] = keyof T[K1][K2], K4 extends keyof T[K1][K2][K3] = keyof T[K1][K2][K3]>(data: T, key1: K1, key2: K2, key: K3, key4: K4): Maybe<T[K1][K2][K3][K4]>;
+export declare function prop<T extends {}, K1 extends keyof T = keyof T, K2 extends keyof T[K1] = keyof T[K1], K3 extends keyof T[K1][K2] = keyof T[K1][K2], K4 extends keyof T[K1][K2][K3] = keyof T[K1][K2][K3], K5 extends keyof T[K1][K2][K3][K4] = keyof T[K1][K2][K3][K4]>(data: T, key1: K1, key2: K2, key: K3, key4: K4, key5: K5): Maybe<T[K1][K2][K3][K4][K5]>;